feat(api): feature flags (#7356)

* feat(api): feature API proto definitions

* update proto based on discussion with @livio-a

* cleanup old feature flag stuff

* authz instance queries

* align defaults

* projection definitions

* define commands and event reducers

* implement system and instance setter APIs

* api getter implementation

* unit test repository package

* command unit tests

* unit test Get queries

* grpc converter unit tests

* migrate the V1 features

* migrate oidc to dynamic features

* projection unit test

* fix instance by host

* fix instance by id data type in sql

* fix linting errors

* add system projection test

* fix behavior inversion

* resolve proto file comments

* rename SystemDefaultLoginInstanceEventType to SystemLoginDefaultOrgEventType so it's consistent with the instance level event

* use write models and conditional set events

* system features integration tests

* instance features integration tests

* error on empty request

* documentation entry

* typo in feature.proto

* fix start unit tests

* solve linting error on key case switch

* remove system defaults after discussion with @eliobischof

* fix system feature projection

* resolve comments in defaults.yaml

---------

Co-authored-by: Livio Spring <livio.a@gmail.com>

docs/docusaurus.config.js

@@ -311,6 +311,13 @@ module.exports = {
                 groupPathsBy: "tag",
             },
           },
+          feature_v2: {
+            specPath: ".artifacts/openapi/zitadel/feature/v2beta/feature_service.swagger.json",
+            outputDir: "docs/apis/resources/feature_service_v2",
+            sidebarOptions: {
+                groupPathsBy: "tag",
+            },
+          },
         },
       },
     ],

docs/sidebars.js

@@ -694,6 +694,20 @@ module.exports = {
               },
               items: require("./docs/apis/resources/settings_service/sidebar.js"),
             },
+            {
+              type: "category",
+              label: "Feature Lifecycle (Beta)",
+              link: {
+                type: "generated-index",
+                title: "Feature Service API (Beta)",
+                slug: "/apis/resources/feature_service",
+                description:
+                  "This API is intended to manage features for ZITADEL. Feature settings that are available on multiple \"levels\", such as instance and organization. The higher level instance acts as a default for the lower level. When a feature is set on multiple levels, the lower level takes precedence. Features can be experimental where ZITADEL will assume a sane default, such as disabled. When over time confidence in such a feature grows, ZITADEL can default to enabling the feature. As a final step we might choose to always enable a feature and remove the setting from this API, reserving the proto field number. Such removal is not considered a breaking change. Setting a removed field will effectively result in a no-op.\n" +
+                  "\n" +
+                  "This project is in beta state. It can AND will continue breaking until a stable version is released.",
+              },
+              items: require("./docs/apis/resources/feature_service_v2/sidebar.js"),
+            },
           ]
         },
         {