unleash-server 5.2.8 → 5.3.0

package/dist/lib/openapi/spec/playground-strategy-schema.d.ts

@@ -40,6 +40,53 @@ export declare const strategyEvaluationResults: {
                 readonly type: "boolean";
                 readonly description: "Whether this strategy evaluates to true or not.";
             };
+            readonly variant: {
+                readonly description: "The feature variant you receive based on the provided context or the _disabled\n                          variant_. If a feature is disabled or doesn't have any\n                          variants, you would get the _disabled variant_.\n                          Otherwise, you'll get one of the feature's defined variants.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name", "enabled"];
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly description: "The variant's name. If there is no variant or if the toggle is disabled, this will be `disabled`";
+                        readonly example: "red-variant";
+                    };
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the variant is enabled or not. If the feature is disabled or if it doesn't have variants, this property will be `false`";
+                    };
+                    readonly payload: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["type", "value"];
+                        readonly description: "An optional payload attached to the variant.";
+                        readonly properties: {
+                            readonly type: {
+                                readonly description: "The format of the payload.";
+                                readonly type: "string";
+                                readonly enum: readonly ["json", "csv", "string"];
+                            };
+                            readonly value: {
+                                readonly type: "string";
+                                readonly description: "The payload value stringified.";
+                                readonly example: "{\"property\": \"value\"}";
+                            };
+                        };
+                    };
+                };
+                readonly nullable: true;
+                readonly example: {
+                    readonly name: "green";
+                    readonly enabled: true;
+                };
+            };
+            readonly variants: {
+                readonly type: "array";
+                readonly description: "The feature variants.";
+                readonly items: {
+                    readonly $ref: "#/components/schemas/variantSchema";
+                };
+            };
         };
     }];
 };
@@ -99,6 +146,53 @@ export declare const playgroundStrategySchema: {
                         readonly type: "boolean";
                         readonly description: "Whether this strategy evaluates to true or not.";
                     };
+                    readonly variant: {
+                        readonly description: "The feature variant you receive based on the provided context or the _disabled\n                          variant_. If a feature is disabled or doesn't have any\n                          variants, you would get the _disabled variant_.\n                          Otherwise, you'll get one of the feature's defined variants.";
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["name", "enabled"];
+                        readonly properties: {
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "The variant's name. If there is no variant or if the toggle is disabled, this will be `disabled`";
+                                readonly example: "red-variant";
+                            };
+                            readonly enabled: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the variant is enabled or not. If the feature is disabled or if it doesn't have variants, this property will be `false`";
+                            };
+                            readonly payload: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["type", "value"];
+                                readonly description: "An optional payload attached to the variant.";
+                                readonly properties: {
+                                    readonly type: {
+                                        readonly description: "The format of the payload.";
+                                        readonly type: "string";
+                                        readonly enum: readonly ["json", "csv", "string"];
+                                    };
+                                    readonly value: {
+                                        readonly type: "string";
+                                        readonly description: "The payload value stringified.";
+                                        readonly example: "{\"property\": \"value\"}";
+                                    };
+                                };
+                            };
+                        };
+                        readonly nullable: true;
+                        readonly example: {
+                            readonly name: "green";
+                            readonly enabled: true;
+                        };
+                    };
+                    readonly variants: {
+                        readonly type: "array";
+                        readonly description: "The feature variants.";
+                        readonly items: {
+                            readonly $ref: "#/components/schemas/variantSchema";
+                        };
+                    };
                 };
             }];
             readonly description: "The strategy's evaluation result. If the strategy is a custom strategy that Unleash can't evaluate, `evaluationStatus` will be `unknown`. Otherwise, it will be `true` or `false`";
@@ -275,11 +369,121 @@ export declare const playgroundStrategySchema: {
             readonly parametersSchema: {
                 readonly $id: "#/components/schemas/parametersSchema";
                 readonly type: "object";
+                readonly description: "A list of parameters for a strategy";
                 readonly additionalProperties: {
                     readonly type: "string";
                 };
                 readonly components: {};
             };
+            readonly variantSchema: {
+                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: "variable";
+                        readonly enum: readonly ["variable", "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 additionalProperties: false;
+                        readonly properties: {
+                            readonly type: {
+                                readonly description: "The type of the value. Commonly used types are string, json and csv.";
+                                readonly type: "string";
+                                readonly enum: readonly ["json", "csv", "string"];
+                            };
+                            readonly value: {
+                                readonly description: "The actual value of payload";
+                                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";
+                        };
+                    };
+                };
+                readonly components: {
+                    readonly schemas: {
+                        readonly overrideSchema: {
+                            readonly $id: "#/components/schemas/overrideSchema";
+                            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: {};
+                        };
+                    };
+                };
+            };
+            readonly overrideSchema: {
+                readonly $id: "#/components/schemas/overrideSchema";
+                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: {};
+            };
         };
     };
 };

package/dist/lib/openapi/spec/playground-strategy-schema.js

@@ -4,6 +4,8 @@ exports.playgroundStrategySchema = exports.strategyEvaluationResults = exports.p
 const parameters_schema_1 = require("./parameters-schema");
 const playground_constraint_schema_1 = require("./playground-constraint-schema");
 const playground_segment_schema_1 = require("./playground-segment-schema");
+const variant_schema_1 = require("./variant-schema");
+const override_schema_1 = require("./override-schema");
 exports.playgroundStrategyEvaluation = {
     evaluationComplete: 'complete',
     evaluationIncomplete: 'incomplete',
@@ -47,6 +49,51 @@ exports.strategyEvaluationResults = {
                     type: 'boolean',
                     description: 'Whether this strategy evaluates to true or not.',
                 },
+                variant: {
+                    description: `The feature variant you receive based on the provided context or the _disabled
+                          variant_. If a feature is disabled or doesn't have any
+                          variants, you would get the _disabled variant_.
+                          Otherwise, you'll get one of the feature's defined variants.`,
+                    type: 'object',
+                    additionalProperties: false,
+                    required: ['name', 'enabled'],
+                    properties: {
+                        name: {
+                            type: 'string',
+                            description: "The variant's name. If there is no variant or if the toggle is disabled, this will be `disabled`",
+                            example: 'red-variant',
+                        },
+                        enabled: {
+                            type: 'boolean',
+                            description: "Whether the variant is enabled or not. If the feature is disabled or if it doesn't have variants, this property will be `false`",
+                        },
+                        payload: {
+                            type: 'object',
+                            additionalProperties: false,
+                            required: ['type', 'value'],
+                            description: 'An optional payload attached to the variant.',
+                            properties: {
+                                type: {
+                                    description: 'The format of the payload.',
+                                    type: 'string',
+                                    enum: ['json', 'csv', 'string'],
+                                },
+                                value: {
+                                    type: 'string',
+                                    description: 'The payload value stringified.',
+                                    example: '{"property": "value"}',
+                                },
+                            },
+                        },
+                    },
+                    nullable: true,
+                    example: { name: 'green', enabled: true },
+                },
+                variants: {
+                    type: 'array',
+                    description: 'The feature variants.',
+                    items: { $ref: variant_schema_1.variantSchema.$id },
+                },
             },
         },
     ],
@@ -128,6 +175,8 @@ exports.playgroundStrategySchema = {
             playgroundConstraintSchema: playground_constraint_schema_1.playgroundConstraintSchema,
             playgroundSegmentSchema: playground_segment_schema_1.playgroundSegmentSchema,
             parametersSchema: parameters_schema_1.parametersSchema,
+            variantSchema: variant_schema_1.variantSchema,
+            overrideSchema: override_schema_1.overrideSchema,
         },
     },
 };

package/dist/lib/openapi/spec/playground-strategy-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"playground-strategy-schema.js","sourceRoot":"","sources":["../../../../src/lib/openapi/spec/playground-strategy-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playground-strategy-schema.js","sourceRoot":"","sources":["../../../../src/lib/openapi/spec/playground-strategy-schema.ts"],"names":[],"mappings":";;;AACA,2DAAuD;AACvD,iFAA4E;AAC5E,2EAAsE;AACtE,qDAAiD;AACjD,uDAAmD;AAEtC,QAAA,4BAA4B,GAAG;IACxC,kBAAkB,EAAE,UAAU;IAC9B,oBAAoB,EAAE,YAAY;IAClC,aAAa,EAAE,SAAS;CAClB,CAAC;AAEE,QAAA,yBAAyB,GAAG;IACrC,KAAK,EAAE;QACH;YACI,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,QAAQ,EAAE,CAAC,kBAAkB,EAAE,SAAS,CAAC;YACzC,UAAU,EAAE;gBACR,gBAAgB,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EACP,gJAAgJ;oBACpJ,IAAI,EAAE,CAAC,oCAA4B,CAAC,oBAAoB,CAAC;iBAC5D;gBACD,OAAO,EAAE;oBACL,WAAW,EACP,uRAAuR;oBAC3R,KAAK,EAAE;wBACH,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;wBAClC;4BACI,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,oCAA4B,CAAC,aAAa,CAAC;yBACrD;qBACJ;iBACJ;aACJ;SACJ;QACD;YACI,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,QAAQ,EAAE,CAAC,kBAAkB,EAAE,SAAS,CAAC;YACzC,UAAU,EAAE;gBACR,gBAAgB,EAAE;oBACd,WAAW,EACP,wDAAwD;oBAC5D,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,CAAC;iBACrB;gBACD,OAAO,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EACP,iDAAiD;iBACxD;gBACD,OAAO,EAAE;oBACL,WAAW,EAAE;;;uFAGsD;oBACnE,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,KAAK;oBAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;oBAC7B,UAAU,EAAE;wBACR,IAAI,EAAE;4BACF,IAAI,EAAE,QAAQ;4BACd,WAAW,EACP,kGAAkG;4BACtG,OAAO,EAAE,aAAa;yBACzB;wBACD,OAAO,EAAE;4BACL,IAAI,EAAE,SAAS;4BACf,WAAW,EACP,iIAAiI;yBACxI;wBACD,OAAO,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE,KAAK;4BAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;4BAC3B,WAAW,EACP,8CAA8C;4BAClD,UAAU,EAAE;gCACR,IAAI,EAAE;oCACF,WAAW,EAAE,4BAA4B;oCACzC,IAAI,EAAE,QAAQ;oCACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;iCAClC;gCACD,KAAK,EAAE;oCACH,IAAI,EAAE,QAAQ;oCACd,WAAW,EACP,gCAAgC;oCACpC,OAAO,EAAE,uBAAuB;iCACnC;6BACJ;yBACJ;qBACJ;oBACD,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;iBAC5C;gBACD,QAAQ,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,uBAAuB;oBACpC,KAAK,EAAE,EAAE,IAAI,EAAE,8BAAa,CAAC,GAAG,EAAE;iBACrC;aACJ;SACJ;KACJ;CACK,CAAC;AAEE,QAAA,wBAAwB,GAAG;IACpC,GAAG,EAAE,+CAA+C;IACpD,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACN,IAAI;QACJ,MAAM;QACN,QAAQ;QACR,UAAU;QACV,aAAa;QACb,YAAY;QACZ,UAAU;QACV,OAAO;KACV;IACD,UAAU,EAAE;QACR,IAAI,EAAE;YACF,WAAW,EAAE,sBAAsB;YACnC,IAAI,EAAE,QAAQ;SACjB;QACD,KAAK,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,cAAc;YACvB,WAAW,EAAE,uCAAuC;SACvD;QACD,EAAE,EAAE;YACA,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,sCAAsC;SAClD;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,sIAAsI,oCAA4B,CAAC,aAAa,iDAAiD;YAC9O,GAAG,iCAAyB;SAC/B;QACD,QAAQ,EAAE;YACN,IAAI,EAAE,SAAS;YACf,WAAW,EACP,8DAA8D;YAClE,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,IAAI;SACjB;QACD,QAAQ,EAAE;YACN,IAAI,EAAE,OAAO;YACb,WAAW,EACP,uDAAuD;YAC3D,KAAK,EAAE;gBACH,IAAI,EAAE,mDAAuB,CAAC,GAAG;aACpC;SACJ;QACD,WAAW,EAAE;YACT,IAAI,EAAE,OAAO;YACb,WAAW,EACP,0DAA0D;YAC9D,KAAK,EAAE;gBACH,IAAI,EAAE,yDAA0B,CAAC,GAAG;aACvC;SACJ;QACD,UAAU,EAAE;YACR,WAAW,EACP,0DAA0D;YAC9D,OAAO,EAAE;gBACL,QAAQ,EAAE,aAAa;aAC1B;YACD,IAAI,EAAE,oCAAgB,CAAC,GAAG;SAC7B;QACD,KAAK,EAAE;YACH,WAAW,EACP,4DAA4D;YAChE,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,UAAU,EAAE;gBACR,IAAI,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,OAAO,EACH,sIAAsI;iBAC7I;aACJ;SACJ;KACJ;IACD,UAAU,EAAE;QACR,OAAO,EAAE;YACL,0BAA0B,EAA1B,yDAA0B;YAC1B,uBAAuB,EAAvB,mDAAuB;YACvB,gBAAgB,EAAhB,oCAAgB;YAChB,aAAa,EAAb,8BAAa;YACb,cAAc,EAAd,gCAAc;SACjB;KACJ;CACK,CAAC"}