unleash-server
Version:
Unleash is an enterprise ready feature flag service. It provides different strategies for handling feature flags.
351 lines • 22.4 kB
TypeScript
import type { FromSchema } from 'json-schema-to-ts';
export declare const environmentProjectSchema: {
readonly $id: "#/components/schemas/environmentProjectSchema";
readonly type: "object";
readonly additionalProperties: false;
readonly required: readonly ["name", "type", "enabled", "protected", "sortOrder"];
readonly description: "Describes a project's configuration in a given environment.";
readonly properties: {
readonly name: {
readonly type: "string";
readonly example: "development";
readonly description: "The name of the environment";
};
readonly type: {
readonly type: "string";
readonly example: "production";
readonly description: "The [type of environment](https://docs.getunleash.io/concepts/environments#environment-types).";
};
readonly enabled: {
readonly type: "boolean";
readonly example: true;
readonly description: "`true` if the environment is enabled for the project, otherwise `false`";
};
readonly protected: {
readonly type: "boolean";
readonly example: false;
readonly description: "`true` if the environment is protected, otherwise `false`. A *protected* environment can not be deleted.";
};
readonly sortOrder: {
readonly type: "integer";
readonly example: 1;
readonly description: "Priority of the environment in a list of environments, the lower the value, the higher up in the list the environment will appear";
};
readonly projectApiTokenCount: {
readonly type: "integer";
readonly minimum: 0;
readonly example: 5;
readonly description: "The number of client and front-end API tokens that have access to this project";
};
readonly projectEnabledToggleCount: {
readonly type: "integer";
readonly minimum: 0;
readonly example: 7;
readonly description: "The number of features enabled in this environment for this project";
};
readonly defaultStrategy: {
readonly description: "The strategy configuration to add when enabling a feature environment by default";
readonly $ref: "#/components/schemas/featureStrategySchema";
};
readonly visible: {
readonly type: "boolean";
readonly example: true;
readonly description: "Indicates whether the environment can be enabled for feature flags in the project";
};
readonly requiredApprovals: {
readonly type: "integer";
readonly nullable: true;
readonly description: "Experimental field. The number of approvals required before a change request can be applied in this environment.";
readonly minimum: 1;
readonly example: 3;
};
};
readonly components: {
readonly schemas: {
readonly featureStrategySchema: {
readonly $id: "#/components/schemas/featureStrategySchema";
readonly description: "A single activation strategy configuration schema for a feature";
readonly type: "object";
readonly additionalProperties: false;
readonly required: readonly ["name"];
readonly properties: {
readonly id: {
readonly type: "string";
readonly description: "A uuid for the feature strategy";
readonly example: "6b5157cb-343a-41e7-bfa3-7b4ec3044840";
};
readonly name: {
readonly type: "string";
readonly description: "The name or type of strategy";
readonly example: "flexibleRollout";
};
readonly title: {
readonly type: "string";
readonly description: "A descriptive title for the strategy";
readonly example: "Gradual Rollout 25-Prod";
readonly nullable: true;
};
readonly disabled: {
readonly type: "boolean";
readonly description: "A toggle to disable the strategy. defaults to false. Disabled strategies are not evaluated or returned to the SDKs";
readonly example: false;
readonly nullable: true;
};
readonly featureName: {
readonly type: "string";
readonly description: "The name or feature the strategy is attached to";
readonly example: "myAwesomeFeature";
};
readonly sortOrder: {
readonly type: "number";
readonly description: "The order of the strategy in the list";
readonly example: 9999;
};
readonly segments: {
readonly type: "array";
readonly description: "A list of segment ids attached to the strategy";
readonly example: readonly [1, 2];
readonly items: {
readonly type: "number";
};
};
readonly constraints: {
readonly type: "array";
readonly description: "A list of the constraints attached to the strategy. See https://docs.getunleash.io/concepts/activation-strategies#constraints";
readonly items: {
readonly $ref: "#/components/schemas/constraintSchema";
};
};
readonly variants: {
readonly type: "array";
readonly description: "Strategy level variants";
readonly items: {
readonly $ref: "#/components/schemas/strategyVariantSchema";
};
};
readonly parameters: {
readonly $ref: "#/components/schemas/parametersSchema";
};
};
readonly components: {
readonly schemas: {
readonly constraintSchema: {
readonly type: "object";
readonly required: readonly ["contextName", "operator"];
readonly description: "A strategy constraint. For more information, refer to [the strategy constraint reference documentation](https://docs.getunleash.io/concepts/activation-strategies#constraints)";
readonly properties: {
readonly contextName: {
readonly description: "The name of the context field that this constraint should apply to.";
readonly example: "appName";
readonly type: "string";
};
readonly operator: {
readonly description: "The operator to use when evaluating this constraint. For more information about the various operators, refer to [the strategy constraint operator documentation](https://docs.getunleash.io/concepts/activation-strategies#constraint-operators).";
readonly type: "string";
readonly enum: readonly ["NOT_IN", "IN", "STR_ENDS_WITH", "STR_STARTS_WITH", "STR_CONTAINS", "NUM_EQ", "NUM_GT", "NUM_GTE", "NUM_LT", "NUM_LTE", "DATE_AFTER", "DATE_BEFORE", "SEMVER_EQ", "SEMVER_GT", "SEMVER_LT"];
readonly example: "IN";
};
readonly caseInsensitive: {
readonly description: "Whether the operator should be case sensitive or not. Defaults to `false` (being case sensitive).";
readonly type: "boolean";
readonly default: false;
};
readonly inverted: {
readonly description: "Whether the result should be negated or not. If `true`, will turn a `true` result into a `false` result and vice versa.";
readonly type: "boolean";
readonly default: false;
};
readonly values: {
readonly type: "array";
readonly description: "The context values that should be used for constraint evaluation. Use this property instead of `value` for properties that accept multiple values.";
readonly items: {
readonly type: "string";
};
readonly example: readonly ["my-app", "my-other-app"];
};
readonly value: {
readonly description: "The context value that should be used for constraint evaluation. Use this property instead of `values` for properties that only accept single values.";
readonly type: "string";
readonly example: "my-app";
};
};
readonly components: {};
readonly $id: "#/components/schemas/constraintSchema";
readonly additionalProperties: false;
};
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 strategyVariantSchema: {
readonly $id: "#/components/schemas/strategyVariantSchema";
readonly type: "object";
readonly additionalProperties: false;
readonly description: "This is an experimental property. It may change or be removed as we work on it. Please don't depend on it yet. A strategy variant allows you to attach any data to strategies instead of only returning `true`/`false`. Strategy variants take precedence over feature variants.";
readonly required: readonly ["name", "weight", "weightType", "stickiness"];
readonly properties: {
readonly name: {
readonly type: "string";
readonly description: "The variant name. Must be unique for this feature flag";
readonly example: "blue_group";
};
readonly weight: {
readonly type: "integer";
readonly description: "The weight is the likelihood of any one user getting this variant. It is an integer between 0 and 1000. See the section on [variant weights](https://docs.getunleash.io/concepts/feature-flag-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. Refer to the [variant weight documentation](https://docs.getunleash.io/concepts/feature-flag-variants#variant-weight).";
readonly type: "string";
readonly example: "fix";
readonly enum: readonly ["variable", "fix"];
};
readonly stickiness: {
readonly type: "string";
readonly description: "The [stickiness](https://docs.getunleash.io/concepts/feature-flag-variants#variant-stickiness) to use for distribution of this 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 description: "The type of the value. Commonly used types are string, number, json and csv.";
readonly type: "string";
readonly enum: readonly ["json", "csv", "string", "number"];
};
readonly value: {
readonly description: "The actual value of payload";
readonly type: "string";
};
};
readonly example: {
readonly type: "json";
readonly value: "{\"color\": \"red\"}";
};
};
};
readonly components: {};
};
};
};
};
readonly strategyVariantSchema: {
readonly $id: "#/components/schemas/strategyVariantSchema";
readonly type: "object";
readonly additionalProperties: false;
readonly description: "This is an experimental property. It may change or be removed as we work on it. Please don't depend on it yet. A strategy variant allows you to attach any data to strategies instead of only returning `true`/`false`. Strategy variants take precedence over feature variants.";
readonly required: readonly ["name", "weight", "weightType", "stickiness"];
readonly properties: {
readonly name: {
readonly type: "string";
readonly description: "The variant name. Must be unique for this feature flag";
readonly example: "blue_group";
};
readonly weight: {
readonly type: "integer";
readonly description: "The weight is the likelihood of any one user getting this variant. It is an integer between 0 and 1000. See the section on [variant weights](https://docs.getunleash.io/concepts/feature-flag-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. Refer to the [variant weight documentation](https://docs.getunleash.io/concepts/feature-flag-variants#variant-weight).";
readonly type: "string";
readonly example: "fix";
readonly enum: readonly ["variable", "fix"];
};
readonly stickiness: {
readonly type: "string";
readonly description: "The [stickiness](https://docs.getunleash.io/concepts/feature-flag-variants#variant-stickiness) to use for distribution of this 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 description: "The type of the value. Commonly used types are string, number, json and csv.";
readonly type: "string";
readonly enum: readonly ["json", "csv", "string", "number"];
};
readonly value: {
readonly description: "The actual value of payload";
readonly type: "string";
};
};
readonly example: {
readonly type: "json";
readonly value: "{\"color\": \"red\"}";
};
};
};
readonly components: {};
};
readonly constraintSchema: {
readonly type: "object";
readonly required: readonly ["contextName", "operator"];
readonly description: "A strategy constraint. For more information, refer to [the strategy constraint reference documentation](https://docs.getunleash.io/concepts/activation-strategies#constraints)";
readonly properties: {
readonly contextName: {
readonly description: "The name of the context field that this constraint should apply to.";
readonly example: "appName";
readonly type: "string";
};
readonly operator: {
readonly description: "The operator to use when evaluating this constraint. For more information about the various operators, refer to [the strategy constraint operator documentation](https://docs.getunleash.io/concepts/activation-strategies#constraint-operators).";
readonly type: "string";
readonly enum: readonly ["NOT_IN", "IN", "STR_ENDS_WITH", "STR_STARTS_WITH", "STR_CONTAINS", "NUM_EQ", "NUM_GT", "NUM_GTE", "NUM_LT", "NUM_LTE", "DATE_AFTER", "DATE_BEFORE", "SEMVER_EQ", "SEMVER_GT", "SEMVER_LT"];
readonly example: "IN";
};
readonly caseInsensitive: {
readonly description: "Whether the operator should be case sensitive or not. Defaults to `false` (being case sensitive).";
readonly type: "boolean";
readonly default: false;
};
readonly inverted: {
readonly description: "Whether the result should be negated or not. If `true`, will turn a `true` result into a `false` result and vice versa.";
readonly type: "boolean";
readonly default: false;
};
readonly values: {
readonly type: "array";
readonly description: "The context values that should be used for constraint evaluation. Use this property instead of `value` for properties that accept multiple values.";
readonly items: {
readonly type: "string";
};
readonly example: readonly ["my-app", "my-other-app"];
};
readonly value: {
readonly description: "The context value that should be used for constraint evaluation. Use this property instead of `values` for properties that only accept single values.";
readonly type: "string";
readonly example: "my-app";
};
};
readonly components: {};
readonly $id: "#/components/schemas/constraintSchema";
readonly additionalProperties: false;
};
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: {};
};
};
};
};
export type EnvironmentProjectSchema = FromSchema<typeof environmentProjectSchema, {
keepDefaultedPropertiesOptional: true;
}>;
//# sourceMappingURL=environment-project-schema.d.ts.map