unleash-server 5.1.9 → 5.2.0

package/dist/lib/openapi/spec/health-report-schema.d.ts

@@ -713,7 +713,7 @@ export declare const healthReportSchema: {
                                     };
                                     readonly featureStrategySchema: {
                                         readonly $id: "#/components/schemas/featureStrategySchema";
-                                        readonly description: "A singles activation strategy configuration schema for a feature";
+                                        readonly description: "A single activation strategy configuration schema for a feature";
                                         readonly type: "object";
                                         readonly additionalProperties: false;
                                         readonly required: readonly ["name"];
@@ -830,23 +830,34 @@ export declare const healthReportSchema: {
                                         readonly $id: "#/components/schemas/variantSchema";
                                         readonly type: "object";
                                         readonly additionalProperties: false;
+                                        readonly description: "A variant allows for further separation of users into segments. See [our excellent documentation](https://docs.getunleash.io/reference/feature-toggle-variants#what-are-variants) for a more detailed description";
                                         readonly required: readonly ["name", "weight"];
                                         readonly properties: {
                                             readonly name: {
                                                 readonly type: "string";
+                                                readonly description: "The variants name. Is unique for this feature toggle";
+                                                readonly example: "blue_group";
                                             };
                                             readonly weight: {
                                                 readonly type: "number";
+                                                readonly description: "The weight is the likelihood of any one user getting this variant. It is a number between 0 and 1000. See the section on [variant weights](https://docs.getunleash.io/reference/feature-toggle-variants#variant-weight) for more information";
+                                                readonly minimum: 0;
+                                                readonly maximum: 1000;
                                             };
                                             readonly weightType: {
+                                                readonly description: "Set to fix if this variant must have exactly the weight allocated to it. If the type is variable, the weight will adjust so that the total weight of all variants adds up to 1000";
                                                 readonly type: "string";
+                                                readonly example: "fix";
                                             };
                                             readonly stickiness: {
                                                 readonly type: "string";
+                                                readonly description: "[Stickiness](https://docs.getunleash.io/reference/feature-toggle-variants#variant-stickiness) is how Unleash guarantees that the same user gets the same variant every time";
+                                                readonly example: "custom.context.field";
                                             };
                                             readonly payload: {
                                                 readonly type: "object";
                                                 readonly required: readonly ["type", "value"];
+                                                readonly description: "Extra data configured for this variant";
                                                 readonly properties: {
                                                     readonly type: {
                                                         readonly type: "string";
@@ -855,8 +866,13 @@ export declare const healthReportSchema: {
                                                         readonly type: "string";
                                                     };
                                                 };
+                                                readonly example: {
+                                                    readonly type: "json";
+                                                    readonly value: "{color: red}";
+                                                };
                                             };
                                             readonly overrides: {
+                                                readonly description: "Overrides assigning specific variants to specific users. The weighting system automatically assigns users to specific groups for you, but any overrides in this list will take precedence.";
                                                 readonly type: "array";
                                                 readonly items: {
                                                     readonly $ref: "#/components/schemas/overrideSchema";
@@ -870,15 +886,20 @@ export declare const healthReportSchema: {
                                                     readonly type: "object";
                                                     readonly additionalProperties: false;
                                                     readonly required: readonly ["contextName", "values"];
+                                                    readonly description: "An override for deciding which variant should be assigned to a user based on the context name";
                                                     readonly properties: {
                                                         readonly contextName: {
+                                                            readonly description: "The name of the context field used to determine overrides";
                                                             readonly type: "string";
+                                                            readonly example: "userId";
                                                         };
                                                         readonly values: {
+                                                            readonly description: "Which values that should be overriden";
                                                             readonly type: "array";
                                                             readonly items: {
                                                                 readonly type: "string";
                                                             };
+                                                            readonly example: readonly ["red", "blue"];
                                                         };
                                                     };
                                                     readonly components: {};
@@ -891,7 +912,7 @@ export declare const healthReportSchema: {
                         };
                         readonly featureStrategySchema: {
                             readonly $id: "#/components/schemas/featureStrategySchema";
-                            readonly description: "A singles activation strategy configuration schema for a feature";
+                            readonly description: "A single activation strategy configuration schema for a feature";
                             readonly type: "object";
                             readonly additionalProperties: false;
                             readonly required: readonly ["name"];
@@ -1009,15 +1030,20 @@ export declare const healthReportSchema: {
                             readonly type: "object";
                             readonly additionalProperties: false;
                             readonly required: readonly ["contextName", "values"];
+                            readonly description: "An override for deciding which variant should be assigned to a user based on the context name";
                             readonly properties: {
                                 readonly contextName: {
+                                    readonly description: "The name of the context field used to determine overrides";
                                     readonly type: "string";
+                                    readonly example: "userId";
                                 };
                                 readonly values: {
+                                    readonly description: "Which values that should be overriden";
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
                                     };
+                                    readonly example: readonly ["red", "blue"];
                                 };
                             };
                             readonly components: {};
@@ -1034,23 +1060,34 @@ export declare const healthReportSchema: {
                             readonly $id: "#/components/schemas/variantSchema";
                             readonly type: "object";
                             readonly additionalProperties: false;
+                            readonly description: "A variant allows for further separation of users into segments. See [our excellent documentation](https://docs.getunleash.io/reference/feature-toggle-variants#what-are-variants) for a more detailed description";
                             readonly required: readonly ["name", "weight"];
                             readonly properties: {
                                 readonly name: {
                                     readonly type: "string";
+                                    readonly description: "The variants name. Is unique for this feature toggle";
+                                    readonly example: "blue_group";
                                 };
                                 readonly weight: {
                                     readonly type: "number";
+                                    readonly description: "The weight is the likelihood of any one user getting this variant. It is a number between 0 and 1000. See the section on [variant weights](https://docs.getunleash.io/reference/feature-toggle-variants#variant-weight) for more information";
+                                    readonly minimum: 0;
+                                    readonly maximum: 1000;
                                 };
                                 readonly weightType: {
+                                    readonly description: "Set to fix if this variant must have exactly the weight allocated to it. If the type is variable, the weight will adjust so that the total weight of all variants adds up to 1000";
                                     readonly type: "string";
+                                    readonly example: "fix";
                                 };
                                 readonly stickiness: {
                                     readonly type: "string";
+                                    readonly description: "[Stickiness](https://docs.getunleash.io/reference/feature-toggle-variants#variant-stickiness) is how Unleash guarantees that the same user gets the same variant every time";
+                                    readonly example: "custom.context.field";
                                 };
                                 readonly payload: {
                                     readonly type: "object";
                                     readonly required: readonly ["type", "value"];
+                                    readonly description: "Extra data configured for this variant";
                                     readonly properties: {
                                         readonly type: {
                                             readonly type: "string";
@@ -1059,8 +1096,13 @@ export declare const healthReportSchema: {
                                             readonly type: "string";
                                         };
                                     };
+                                    readonly example: {
+                                        readonly type: "json";
+                                        readonly value: "{color: red}";
+                                    };
                                 };
                                 readonly overrides: {
+                                    readonly description: "Overrides assigning specific variants to specific users. The weighting system automatically assigns users to specific groups for you, but any overrides in this list will take precedence.";
                                     readonly type: "array";
                                     readonly items: {
                                         readonly $ref: "#/components/schemas/overrideSchema";
@@ -1074,15 +1116,20 @@ export declare const healthReportSchema: {
                                         readonly type: "object";
                                         readonly additionalProperties: false;
                                         readonly required: readonly ["contextName", "values"];
+                                        readonly description: "An override for deciding which variant should be assigned to a user based on the context name";
                                         readonly properties: {
                                             readonly contextName: {
+                                                readonly description: "The name of the context field used to determine overrides";
                                                 readonly type: "string";
+                                                readonly example: "userId";
                                             };
                                             readonly values: {
+                                                readonly description: "Which values that should be overriden";
                                                 readonly type: "array";
                                                 readonly items: {
                                                     readonly type: "string";
                                                 };
+                                                readonly example: readonly ["red", "blue"];
                                             };
                                         };
                                         readonly components: {};
@@ -1226,7 +1273,7 @@ export declare const healthReportSchema: {
                         };
                         readonly featureStrategySchema: {
                             readonly $id: "#/components/schemas/featureStrategySchema";
-                            readonly description: "A singles activation strategy configuration schema for a feature";
+                            readonly description: "A single activation strategy configuration schema for a feature";
                             readonly type: "object";
                             readonly additionalProperties: false;
                             readonly required: readonly ["name"];
@@ -1343,23 +1390,34 @@ export declare const healthReportSchema: {
                             readonly $id: "#/components/schemas/variantSchema";
                             readonly type: "object";
                             readonly additionalProperties: false;
+                            readonly description: "A variant allows for further separation of users into segments. See [our excellent documentation](https://docs.getunleash.io/reference/feature-toggle-variants#what-are-variants) for a more detailed description";
                             readonly required: readonly ["name", "weight"];
                             readonly properties: {
                                 readonly name: {
                                     readonly type: "string";
+                                    readonly description: "The variants name. Is unique for this feature toggle";
+                                    readonly example: "blue_group";
                                 };
                                 readonly weight: {
                                     readonly type: "number";
+                                    readonly description: "The weight is the likelihood of any one user getting this variant. It is a number between 0 and 1000. See the section on [variant weights](https://docs.getunleash.io/reference/feature-toggle-variants#variant-weight) for more information";
+                                    readonly minimum: 0;
+                                    readonly maximum: 1000;
                                 };
                                 readonly weightType: {
+                                    readonly description: "Set to fix if this variant must have exactly the weight allocated to it. If the type is variable, the weight will adjust so that the total weight of all variants adds up to 1000";
                                     readonly type: "string";
+                                    readonly example: "fix";
                                 };
                                 readonly stickiness: {
                                     readonly type: "string";
+                                    readonly description: "[Stickiness](https://docs.getunleash.io/reference/feature-toggle-variants#variant-stickiness) is how Unleash guarantees that the same user gets the same variant every time";
+                                    readonly example: "custom.context.field";
                                 };
                                 readonly payload: {
                                     readonly type: "object";
                                     readonly required: readonly ["type", "value"];
+                                    readonly description: "Extra data configured for this variant";
                                     readonly properties: {
                                         readonly type: {
                                             readonly type: "string";
@@ -1368,8 +1426,13 @@ export declare const healthReportSchema: {
                                             readonly type: "string";
                                         };
                                     };
+                                    readonly example: {
+                                        readonly type: "json";
+                                        readonly value: "{color: red}";
+                                    };
                                 };
                                 readonly overrides: {
+                                    readonly description: "Overrides assigning specific variants to specific users. The weighting system automatically assigns users to specific groups for you, but any overrides in this list will take precedence.";
                                     readonly type: "array";
                                     readonly items: {
                                         readonly $ref: "#/components/schemas/overrideSchema";
@@ -1383,15 +1446,20 @@ export declare const healthReportSchema: {
                                         readonly type: "object";
                                         readonly additionalProperties: false;
                                         readonly required: readonly ["contextName", "values"];
+                                        readonly description: "An override for deciding which variant should be assigned to a user based on the context name";
                                         readonly properties: {
                                             readonly contextName: {
+                                                readonly description: "The name of the context field used to determine overrides";
                                                 readonly type: "string";
+                                                readonly example: "userId";
                                             };
                                             readonly values: {
+                                                readonly description: "Which values that should be overriden";
                                                 readonly type: "array";
                                                 readonly items: {
                                                     readonly type: "string";
                                                 };
+                                                readonly example: readonly ["red", "blue"];
                                             };
                                         };
                                         readonly components: {};
@@ -1407,15 +1475,20 @@ export declare const healthReportSchema: {
                 readonly type: "object";
                 readonly additionalProperties: false;
                 readonly required: readonly ["contextName", "values"];
+                readonly description: "An override for deciding which variant should be assigned to a user based on the context name";
                 readonly properties: {
                     readonly contextName: {
+                        readonly description: "The name of the context field used to determine overrides";
                         readonly type: "string";
+                        readonly example: "userId";
                     };
                     readonly values: {
+                        readonly description: "Which values that should be overriden";
                         readonly type: "array";
                         readonly items: {
                             readonly type: "string";
                         };
+                        readonly example: readonly ["red", "blue"];
                     };
                 };
                 readonly components: {};
@@ -1430,7 +1503,7 @@ export declare const healthReportSchema: {
             };
             readonly featureStrategySchema: {
                 readonly $id: "#/components/schemas/featureStrategySchema";
-                readonly description: "A singles activation strategy configuration schema for a feature";
+                readonly description: "A single activation strategy configuration schema for a feature";
                 readonly type: "object";
                 readonly additionalProperties: false;
                 readonly required: readonly ["name"];
@@ -1547,23 +1620,34 @@ export declare const healthReportSchema: {
                 readonly $id: "#/components/schemas/variantSchema";
                 readonly type: "object";
                 readonly additionalProperties: false;
+                readonly description: "A variant allows for further separation of users into segments. See [our excellent documentation](https://docs.getunleash.io/reference/feature-toggle-variants#what-are-variants) for a more detailed description";
                 readonly required: readonly ["name", "weight"];
                 readonly properties: {
                     readonly name: {
                         readonly type: "string";
+                        readonly description: "The variants name. Is unique for this feature toggle";
+                        readonly example: "blue_group";
                     };
                     readonly weight: {
                         readonly type: "number";
+                        readonly description: "The weight is the likelihood of any one user getting this variant. It is a number between 0 and 1000. See the section on [variant weights](https://docs.getunleash.io/reference/feature-toggle-variants#variant-weight) for more information";
+                        readonly minimum: 0;
+                        readonly maximum: 1000;
                     };
                     readonly weightType: {
+                        readonly description: "Set to fix if this variant must have exactly the weight allocated to it. If the type is variable, the weight will adjust so that the total weight of all variants adds up to 1000";
                         readonly type: "string";
+                        readonly example: "fix";
                     };
                     readonly stickiness: {
                         readonly type: "string";
+                        readonly description: "[Stickiness](https://docs.getunleash.io/reference/feature-toggle-variants#variant-stickiness) is how Unleash guarantees that the same user gets the same variant every time";
+                        readonly example: "custom.context.field";
                     };
                     readonly payload: {
                         readonly type: "object";
                         readonly required: readonly ["type", "value"];
+                        readonly description: "Extra data configured for this variant";
                         readonly properties: {
                             readonly type: {
                                 readonly type: "string";
@@ -1572,8 +1656,13 @@ export declare const healthReportSchema: {
                                 readonly type: "string";
                             };
                         };
+                        readonly example: {
+                            readonly type: "json";
+                            readonly value: "{color: red}";
+                        };
                     };
                     readonly overrides: {
+                        readonly description: "Overrides assigning specific variants to specific users. The weighting system automatically assigns users to specific groups for you, but any overrides in this list will take precedence.";
                         readonly type: "array";
                         readonly items: {
                             readonly $ref: "#/components/schemas/overrideSchema";
@@ -1587,15 +1676,20 @@ export declare const healthReportSchema: {
                             readonly type: "object";
                             readonly additionalProperties: false;
                             readonly required: readonly ["contextName", "values"];
+                            readonly description: "An override for deciding which variant should be assigned to a user based on the context name";
                             readonly properties: {
                                 readonly contextName: {
+                                    readonly description: "The name of the context field used to determine overrides";
                                     readonly type: "string";
+                                    readonly example: "userId";
                                 };
                                 readonly values: {
+                                    readonly description: "Which values that should be overriden";
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
                                     };
+                                    readonly example: readonly ["red", "blue"];
                                 };
                             };
                             readonly components: {};