@lssm/lib.feature-flags 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

package/dist/entities/index.js

@@ -1,11 +1,10 @@
-import { defineEntity, defineEntityEnum, field, index } from "../schema/dist/entity/defineEntity.js";
-import "../schema/dist/index.js";
+import { L5, Z5, _5, b5 } from "../schema/dist/index.js";
 
 //#region src/entities/index.ts
 /**
 * Feature flag status enum.
 */
-const FlagStatusEnum = defineEntityEnum({
+const FlagStatusEnum = Z5({
 	name: "FlagStatus",
 	values: [
 		"OFF",
@@ -18,7 +17,7 @@ const FlagStatusEnum = defineEntityEnum({
 /**
 * Targeting rule operator enum.
 */
-const RuleOperatorEnum = defineEntityEnum({
+const RuleOperatorEnum = Z5({
 	name: "RuleOperator",
 	values: [
 		"EQ",
@@ -39,7 +38,7 @@ const RuleOperatorEnum = defineEntityEnum({
 /**
 * Experiment status enum.
 */
-const ExperimentStatusEnum = defineEntityEnum({
+const ExperimentStatusEnum = Z5({
 	name: "ExperimentStatus",
 	values: [
 		"DRAFT",
@@ -54,248 +53,248 @@ const ExperimentStatusEnum = defineEntityEnum({
 /**
 * FeatureFlag entity - defines a feature flag.
 */
-const FeatureFlagEntity = defineEntity({
+const FeatureFlagEntity = L5({
 	name: "FeatureFlag",
 	description: "A feature flag for controlling feature availability.",
 	schema: "lssm_feature_flags",
 	map: "feature_flag",
 	fields: {
-		id: field.id({ description: "Unique flag identifier" }),
-		key: field.string({
+		id: _5.id({ description: "Unique flag identifier" }),
+		key: _5.string({
 			isUnique: true,
 			description: "Flag key (e.g., new_dashboard)"
 		}),
-		name: field.string({ description: "Human-readable name" }),
-		description: field.string({
+		name: _5.string({ description: "Human-readable name" }),
+		description: _5.string({
 			isOptional: true,
 			description: "Description of the flag"
 		}),
-		status: field.enum("FlagStatus", {
+		status: _5.enum("FlagStatus", {
 			default: "OFF",
 			description: "Flag status"
 		}),
-		defaultValue: field.boolean({
+		defaultValue: _5.boolean({
 			default: false,
 			description: "Default value when no rules match"
 		}),
-		variants: field.json({
+		variants: _5.json({
 			isOptional: true,
 			description: "Variant definitions for multivariate flags"
 		}),
-		orgId: field.string({
+		orgId: _5.string({
 			isOptional: true,
 			description: "Organization scope (null = global)"
 		}),
-		tags: field.json({
+		tags: _5.json({
 			isOptional: true,
 			description: "Tags for categorization"
 		}),
-		metadata: field.json({
+		metadata: _5.json({
 			isOptional: true,
 			description: "Additional metadata"
 		}),
-		createdAt: field.createdAt(),
-		updatedAt: field.updatedAt(),
-		targetingRules: field.hasMany("FlagTargetingRule"),
-		experiments: field.hasMany("Experiment"),
-		evaluations: field.hasMany("FlagEvaluation")
+		createdAt: _5.createdAt(),
+		updatedAt: _5.updatedAt(),
+		targetingRules: _5.hasMany("FlagTargetingRule"),
+		experiments: _5.hasMany("Experiment"),
+		evaluations: _5.hasMany("FlagEvaluation")
 	},
-	indexes: [index.on(["orgId", "key"]), index.on(["status"])],
+	indexes: [b5.on(["orgId", "key"]), b5.on(["status"])],
 	enums: [FlagStatusEnum]
 });
 /**
 * FlagTargetingRule entity - conditions for targeting.
 */
-const FlagTargetingRuleEntity = defineEntity({
+const FlagTargetingRuleEntity = L5({
 	name: "FlagTargetingRule",
 	description: "A targeting rule for conditional flag evaluation.",
 	schema: "lssm_feature_flags",
 	map: "flag_targeting_rule",
 	fields: {
-		id: field.id({ description: "Unique rule identifier" }),
-		flagId: field.foreignKey({ description: "Parent feature flag" }),
-		name: field.string({
+		id: _5.id({ description: "Unique rule identifier" }),
+		flagId: _5.foreignKey({ description: "Parent feature flag" }),
+		name: _5.string({
 			isOptional: true,
 			description: "Rule name for debugging"
 		}),
-		priority: field.int({
+		priority: _5.int({
 			default: 0,
 			description: "Rule priority (lower = higher priority)"
 		}),
-		enabled: field.boolean({
+		enabled: _5.boolean({
 			default: true,
 			description: "Whether rule is active"
 		}),
-		attribute: field.string({ description: "Target attribute (userId, orgId, plan, segment, etc.)" }),
-		operator: field.enum("RuleOperator", { description: "Comparison operator" }),
-		value: field.json({ description: "Target value(s)" }),
-		rolloutPercentage: field.int({
+		attribute: _5.string({ description: "Target attribute (userId, orgId, plan, segment, etc.)" }),
+		operator: _5.enum("RuleOperator", { description: "Comparison operator" }),
+		value: _5.json({ description: "Target value(s)" }),
+		rolloutPercentage: _5.int({
 			isOptional: true,
 			description: "Percentage for gradual rollout (0-100)"
 		}),
-		serveValue: field.boolean({
+		serveValue: _5.boolean({
 			isOptional: true,
 			description: "Boolean value to serve"
 		}),
-		serveVariant: field.string({
+		serveVariant: _5.string({
 			isOptional: true,
 			description: "Variant key to serve (for multivariate)"
 		}),
-		createdAt: field.createdAt(),
-		updatedAt: field.updatedAt(),
-		flag: field.belongsTo("FeatureFlag", ["flagId"], ["id"], { onDelete: "Cascade" })
+		createdAt: _5.createdAt(),
+		updatedAt: _5.updatedAt(),
+		flag: _5.belongsTo("FeatureFlag", ["flagId"], ["id"], { onDelete: "Cascade" })
 	},
-	indexes: [index.on(["flagId", "priority"]), index.on(["attribute"])],
+	indexes: [b5.on(["flagId", "priority"]), b5.on(["attribute"])],
 	enums: [RuleOperatorEnum]
 });
 /**
 * Experiment entity - A/B test configuration.
 */
-const ExperimentEntity = defineEntity({
+const ExperimentEntity = L5({
 	name: "Experiment",
 	description: "An A/B test experiment.",
 	schema: "lssm_feature_flags",
 	map: "experiment",
 	fields: {
-		id: field.id({ description: "Unique experiment identifier" }),
-		key: field.string({
+		id: _5.id({ description: "Unique experiment identifier" }),
+		key: _5.string({
 			isUnique: true,
 			description: "Experiment key"
 		}),
-		name: field.string({ description: "Human-readable name" }),
-		description: field.string({
+		name: _5.string({ description: "Human-readable name" }),
+		description: _5.string({
 			isOptional: true,
 			description: "Experiment description"
 		}),
-		hypothesis: field.string({
+		hypothesis: _5.string({
 			isOptional: true,
 			description: "Experiment hypothesis"
 		}),
-		flagId: field.foreignKey({ description: "Associated feature flag" }),
-		status: field.enum("ExperimentStatus", {
+		flagId: _5.foreignKey({ description: "Associated feature flag" }),
+		status: _5.enum("ExperimentStatus", {
 			default: "DRAFT",
 			description: "Experiment status"
 		}),
-		variants: field.json({ description: "Variant definitions with split ratios" }),
-		metrics: field.json({
+		variants: _5.json({ description: "Variant definitions with split ratios" }),
+		metrics: _5.json({
 			isOptional: true,
 			description: "Metrics to track"
 		}),
-		audiencePercentage: field.int({
+		audiencePercentage: _5.int({
 			default: 100,
 			description: "Percentage of audience to include"
 		}),
-		audienceFilter: field.json({
+		audienceFilter: _5.json({
 			isOptional: true,
 			description: "Audience filter criteria"
 		}),
-		scheduledStartAt: field.dateTime({
+		scheduledStartAt: _5.dateTime({
 			isOptional: true,
 			description: "Scheduled start time"
 		}),
-		scheduledEndAt: field.dateTime({
+		scheduledEndAt: _5.dateTime({
 			isOptional: true,
 			description: "Scheduled end time"
 		}),
-		startedAt: field.dateTime({
+		startedAt: _5.dateTime({
 			isOptional: true,
 			description: "Actual start time"
 		}),
-		endedAt: field.dateTime({
+		endedAt: _5.dateTime({
 			isOptional: true,
 			description: "Actual end time"
 		}),
-		winningVariant: field.string({
+		winningVariant: _5.string({
 			isOptional: true,
 			description: "Declared winning variant"
 		}),
-		results: field.json({
+		results: _5.json({
 			isOptional: true,
 			description: "Experiment results summary"
 		}),
-		orgId: field.string({
+		orgId: _5.string({
 			isOptional: true,
 			description: "Organization scope"
 		}),
-		createdAt: field.createdAt(),
-		updatedAt: field.updatedAt(),
-		flag: field.belongsTo("FeatureFlag", ["flagId"], ["id"], { onDelete: "Cascade" }),
-		assignments: field.hasMany("ExperimentAssignment")
+		createdAt: _5.createdAt(),
+		updatedAt: _5.updatedAt(),
+		flag: _5.belongsTo("FeatureFlag", ["flagId"], ["id"], { onDelete: "Cascade" }),
+		assignments: _5.hasMany("ExperimentAssignment")
 	},
 	indexes: [
-		index.on(["status"]),
-		index.on(["orgId", "status"]),
-		index.on(["flagId"])
+		b5.on(["status"]),
+		b5.on(["orgId", "status"]),
+		b5.on(["flagId"])
 	],
 	enums: [ExperimentStatusEnum]
 });
 /**
 * ExperimentAssignment entity - tracks which variant a subject is assigned to.
 */
-const ExperimentAssignmentEntity = defineEntity({
+const ExperimentAssignmentEntity = L5({
 	name: "ExperimentAssignment",
 	description: "Tracks experiment variant assignments.",
 	schema: "lssm_feature_flags",
 	map: "experiment_assignment",
 	fields: {
-		id: field.id({ description: "Unique assignment identifier" }),
-		experimentId: field.foreignKey({ description: "Parent experiment" }),
-		subjectType: field.string({ description: "Subject type (user, org, session)" }),
-		subjectId: field.string({ description: "Subject identifier" }),
-		variant: field.string({ description: "Assigned variant key" }),
-		bucket: field.int({ description: "Hash bucket (0-99)" }),
-		context: field.json({
+		id: _5.id({ description: "Unique assignment identifier" }),
+		experimentId: _5.foreignKey({ description: "Parent experiment" }),
+		subjectType: _5.string({ description: "Subject type (user, org, session)" }),
+		subjectId: _5.string({ description: "Subject identifier" }),
+		variant: _5.string({ description: "Assigned variant key" }),
+		bucket: _5.int({ description: "Hash bucket (0-99)" }),
+		context: _5.json({
 			isOptional: true,
 			description: "Context at assignment time"
 		}),
-		assignedAt: field.dateTime({ description: "Assignment timestamp" }),
-		experiment: field.belongsTo("Experiment", ["experimentId"], ["id"], { onDelete: "Cascade" })
+		assignedAt: _5.dateTime({ description: "Assignment timestamp" }),
+		experiment: _5.belongsTo("Experiment", ["experimentId"], ["id"], { onDelete: "Cascade" })
 	},
-	indexes: [index.unique([
+	indexes: [b5.unique([
 		"experimentId",
 		"subjectType",
 		"subjectId"
-	], { name: "experiment_assignment_unique" }), index.on(["subjectType", "subjectId"])]
+	], { name: "experiment_assignment_unique" }), b5.on(["subjectType", "subjectId"])]
 });
 /**
 * FlagEvaluation entity - evaluation log for analytics.
 */
-const FlagEvaluationEntity = defineEntity({
+const FlagEvaluationEntity = L5({
 	name: "FlagEvaluation",
 	description: "Log of flag evaluations for debugging and analytics.",
 	schema: "lssm_feature_flags",
 	map: "flag_evaluation",
 	fields: {
-		id: field.id({ description: "Unique evaluation identifier" }),
-		flagId: field.foreignKey({ description: "Evaluated flag" }),
-		flagKey: field.string({ description: "Flag key (denormalized for queries)" }),
-		subjectType: field.string({ description: "Subject type (user, org, anonymous)" }),
-		subjectId: field.string({ description: "Subject identifier" }),
-		result: field.boolean({ description: "Evaluation result" }),
-		variant: field.string({
+		id: _5.id({ description: "Unique evaluation identifier" }),
+		flagId: _5.foreignKey({ description: "Evaluated flag" }),
+		flagKey: _5.string({ description: "Flag key (denormalized for queries)" }),
+		subjectType: _5.string({ description: "Subject type (user, org, anonymous)" }),
+		subjectId: _5.string({ description: "Subject identifier" }),
+		result: _5.boolean({ description: "Evaluation result" }),
+		variant: _5.string({
 			isOptional: true,
 			description: "Served variant (for multivariate)"
 		}),
-		matchedRuleId: field.string({
+		matchedRuleId: _5.string({
 			isOptional: true,
 			description: "Rule that matched (if any)"
 		}),
-		reason: field.string({ description: "Evaluation reason (default, rule, experiment, etc.)" }),
-		context: field.json({
+		reason: _5.string({ description: "Evaluation reason (default, rule, experiment, etc.)" }),
+		context: _5.json({
 			isOptional: true,
 			description: "Evaluation context"
 		}),
-		evaluatedAt: field.dateTime({ description: "Evaluation timestamp" }),
-		flag: field.belongsTo("FeatureFlag", ["flagId"], ["id"], { onDelete: "Cascade" })
+		evaluatedAt: _5.dateTime({ description: "Evaluation timestamp" }),
+		flag: _5.belongsTo("FeatureFlag", ["flagId"], ["id"], { onDelete: "Cascade" })
 	},
 	indexes: [
-		index.on(["flagKey", "evaluatedAt"]),
-		index.on([
+		b5.on(["flagKey", "evaluatedAt"]),
+		b5.on([
 			"subjectType",
 			"subjectId",
 			"evaluatedAt"
 		]),
-		index.on(["flagId", "evaluatedAt"])
+		b5.on(["flagId", "evaluatedAt"])
 	]
 });
 /**
@@ -322,4 +321,5 @@ const featureFlagsSchemaContribution = {
 };
 
 //#endregion
-export { ExperimentAssignmentEntity, ExperimentEntity, ExperimentStatusEnum, FeatureFlagEntity, FlagEvaluationEntity, FlagStatusEnum, FlagTargetingRuleEntity, RuleOperatorEnum, featureFlagEntities, featureFlagsSchemaContribution };
+export { ExperimentAssignmentEntity, ExperimentEntity, ExperimentStatusEnum, FeatureFlagEntity, FlagEvaluationEntity, FlagStatusEnum, FlagTargetingRuleEntity, RuleOperatorEnum, featureFlagEntities, featureFlagsSchemaContribution };
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["defineEntityEnum","defineEntity","field","index","featureFlagsSchemaContribution: ModuleSchemaContribution"],"sources":["../../src/entities/index.ts"],"sourcesContent":["import { defineEntity, defineEntityEnum, field, index } from '@lssm/lib.schema';\nimport type { ModuleSchemaContribution } from '@lssm/lib.schema';\n\n/**\n * Feature flag status enum.\n */\nexport const FlagStatusEnum = defineEntityEnum({\n  name: 'FlagStatus',\n  values: ['OFF', 'ON', 'GRADUAL'] as const,\n  schema: 'lssm_feature_flags',\n  description: 'Status of a feature flag.',\n});\n\n/**\n * Targeting rule operator enum.\n */\nexport const RuleOperatorEnum = defineEntityEnum({\n  name: 'RuleOperator',\n  values: [\n    'EQ',\n    'NEQ',\n    'IN',\n    'NIN',\n    'CONTAINS',\n    'NOT_CONTAINS',\n    'GT',\n    'GTE',\n    'LT',\n    'LTE',\n    'PERCENTAGE',\n  ] as const,\n  schema: 'lssm_feature_flags',\n  description: 'Operator for targeting rule conditions.',\n});\n\n/**\n * Experiment status enum.\n */\nexport const ExperimentStatusEnum = defineEntityEnum({\n  name: 'ExperimentStatus',\n  values: ['DRAFT', 'RUNNING', 'PAUSED', 'COMPLETED', 'CANCELLED'] as const,\n  schema: 'lssm_feature_flags',\n  description: 'Status of an experiment.',\n});\n\n/**\n * FeatureFlag entity - defines a feature flag.\n */\nexport const FeatureFlagEntity = defineEntity({\n  name: 'FeatureFlag',\n  description: 'A feature flag for controlling feature availability.',\n  schema: 'lssm_feature_flags',\n  map: 'feature_flag',\n  fields: {\n    id: field.id({ description: 'Unique flag identifier' }),\n    key: field.string({\n      isUnique: true,\n      description: 'Flag key (e.g., new_dashboard)',\n    }),\n    name: field.string({ description: 'Human-readable name' }),\n    description: field.string({\n      isOptional: true,\n      description: 'Description of the flag',\n    }),\n\n    // Status and default value\n    status: field.enum('FlagStatus', {\n      default: 'OFF',\n      description: 'Flag status',\n    }),\n    defaultValue: field.boolean({\n      default: false,\n      description: 'Default value when no rules match',\n    }),\n\n    // Multivariate support\n    variants: field.json({\n      isOptional: true,\n      description: 'Variant definitions for multivariate flags',\n    }),\n\n    // Scope\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope (null = global)',\n    }),\n\n    // Metadata\n    tags: field.json({\n      isOptional: true,\n      description: 'Tags for categorization',\n    }),\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional metadata',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    targetingRules: field.hasMany('FlagTargetingRule'),\n    experiments: field.hasMany('Experiment'),\n    evaluations: field.hasMany('FlagEvaluation'),\n  },\n  indexes: [index.on(['orgId', 'key']), index.on(['status'])],\n  enums: [FlagStatusEnum],\n});\n\n/**\n * FlagTargetingRule entity - conditions for targeting.\n */\nexport const FlagTargetingRuleEntity = defineEntity({\n  name: 'FlagTargetingRule',\n  description: 'A targeting rule for conditional flag evaluation.',\n  schema: 'lssm_feature_flags',\n  map: 'flag_targeting_rule',\n  fields: {\n    id: field.id({ description: 'Unique rule identifier' }),\n    flagId: field.foreignKey({ description: 'Parent feature flag' }),\n\n    // Rule definition\n    name: field.string({\n      isOptional: true,\n      description: 'Rule name for debugging',\n    }),\n    priority: field.int({\n      default: 0,\n      description: 'Rule priority (lower = higher priority)',\n    }),\n    enabled: field.boolean({\n      default: true,\n      description: 'Whether rule is active',\n    }),\n\n    // Condition\n    attribute: field.string({\n      description: 'Target attribute (userId, orgId, plan, segment, etc.)',\n    }),\n    operator: field.enum('RuleOperator', {\n      description: 'Comparison operator',\n    }),\n    value: field.json({ description: 'Target value(s)' }),\n\n    // Result\n    rolloutPercentage: field.int({\n      isOptional: true,\n      description: 'Percentage for gradual rollout (0-100)',\n    }),\n    serveValue: field.boolean({\n      isOptional: true,\n      description: 'Boolean value to serve',\n    }),\n    serveVariant: field.string({\n      isOptional: true,\n      description: 'Variant key to serve (for multivariate)',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    flag: field.belongsTo('FeatureFlag', ['flagId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [index.on(['flagId', 'priority']), index.on(['attribute'])],\n  enums: [RuleOperatorEnum],\n});\n\n/**\n * Experiment entity - A/B test configuration.\n */\nexport const ExperimentEntity = defineEntity({\n  name: 'Experiment',\n  description: 'An A/B test experiment.',\n  schema: 'lssm_feature_flags',\n  map: 'experiment',\n  fields: {\n    id: field.id({ description: 'Unique experiment identifier' }),\n    key: field.string({ isUnique: true, description: 'Experiment key' }),\n    name: field.string({ description: 'Human-readable name' }),\n    description: field.string({\n      isOptional: true,\n      description: 'Experiment description',\n    }),\n    hypothesis: field.string({\n      isOptional: true,\n      description: 'Experiment hypothesis',\n    }),\n\n    // Associated flag\n    flagId: field.foreignKey({ description: 'Associated feature flag' }),\n\n    // Configuration\n    status: field.enum('ExperimentStatus', {\n      default: 'DRAFT',\n      description: 'Experiment status',\n    }),\n    variants: field.json({\n      description: 'Variant definitions with split ratios',\n    }),\n    metrics: field.json({ isOptional: true, description: 'Metrics to track' }),\n\n    // Targeting\n    audiencePercentage: field.int({\n      default: 100,\n      description: 'Percentage of audience to include',\n    }),\n    audienceFilter: field.json({\n      isOptional: true,\n      description: 'Audience filter criteria',\n    }),\n\n    // Timeline\n    scheduledStartAt: field.dateTime({\n      isOptional: true,\n      description: 'Scheduled start time',\n    }),\n    scheduledEndAt: field.dateTime({\n      isOptional: true,\n      description: 'Scheduled end time',\n    }),\n    startedAt: field.dateTime({\n      isOptional: true,\n      description: 'Actual start time',\n    }),\n    endedAt: field.dateTime({\n      isOptional: true,\n      description: 'Actual end time',\n    }),\n\n    // Results\n    winningVariant: field.string({\n      isOptional: true,\n      description: 'Declared winning variant',\n    }),\n    results: field.json({\n      isOptional: true,\n      description: 'Experiment results summary',\n    }),\n\n    // Scope\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    flag: field.belongsTo('FeatureFlag', ['flagId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n    assignments: field.hasMany('ExperimentAssignment'),\n  },\n  indexes: [\n    index.on(['status']),\n    index.on(['orgId', 'status']),\n    index.on(['flagId']),\n  ],\n  enums: [ExperimentStatusEnum],\n});\n\n/**\n * ExperimentAssignment entity - tracks which variant a subject is assigned to.\n */\nexport const ExperimentAssignmentEntity = defineEntity({\n  name: 'ExperimentAssignment',\n  description: 'Tracks experiment variant assignments.',\n  schema: 'lssm_feature_flags',\n  map: 'experiment_assignment',\n  fields: {\n    id: field.id({ description: 'Unique assignment identifier' }),\n    experimentId: field.foreignKey({ description: 'Parent experiment' }),\n\n    // Subject\n    subjectType: field.string({\n      description: 'Subject type (user, org, session)',\n    }),\n    subjectId: field.string({ description: 'Subject identifier' }),\n\n    // Assignment\n    variant: field.string({ description: 'Assigned variant key' }),\n    bucket: field.int({ description: 'Hash bucket (0-99)' }),\n\n    // Context\n    context: field.json({\n      isOptional: true,\n      description: 'Context at assignment time',\n    }),\n\n    // Timestamps\n    assignedAt: field.dateTime({ description: 'Assignment timestamp' }),\n\n    // Relations\n    experiment: field.belongsTo('Experiment', ['experimentId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.unique(['experimentId', 'subjectType', 'subjectId'], {\n      name: 'experiment_assignment_unique',\n    }),\n    index.on(['subjectType', 'subjectId']),\n  ],\n});\n\n/**\n * FlagEvaluation entity - evaluation log for analytics.\n */\nexport const FlagEvaluationEntity = defineEntity({\n  name: 'FlagEvaluation',\n  description: 'Log of flag evaluations for debugging and analytics.',\n  schema: 'lssm_feature_flags',\n  map: 'flag_evaluation',\n  fields: {\n    id: field.id({ description: 'Unique evaluation identifier' }),\n    flagId: field.foreignKey({ description: 'Evaluated flag' }),\n    flagKey: field.string({\n      description: 'Flag key (denormalized for queries)',\n    }),\n\n    // Subject\n    subjectType: field.string({\n      description: 'Subject type (user, org, anonymous)',\n    }),\n    subjectId: field.string({ description: 'Subject identifier' }),\n\n    // Result\n    result: field.boolean({ description: 'Evaluation result' }),\n    variant: field.string({\n      isOptional: true,\n      description: 'Served variant (for multivariate)',\n    }),\n\n    // Match info\n    matchedRuleId: field.string({\n      isOptional: true,\n      description: 'Rule that matched (if any)',\n    }),\n    reason: field.string({\n      description: 'Evaluation reason (default, rule, experiment, etc.)',\n    }),\n\n    // Context\n    context: field.json({\n      isOptional: true,\n      description: 'Evaluation context',\n    }),\n\n    // Timestamps\n    evaluatedAt: field.dateTime({ description: 'Evaluation timestamp' }),\n\n    // Relations\n    flag: field.belongsTo('FeatureFlag', ['flagId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.on(['flagKey', 'evaluatedAt']),\n    index.on(['subjectType', 'subjectId', 'evaluatedAt']),\n    index.on(['flagId', 'evaluatedAt']),\n  ],\n});\n\n/**\n * All feature flag entities for schema composition.\n */\nexport const featureFlagEntities = [\n  FeatureFlagEntity,\n  FlagTargetingRuleEntity,\n  ExperimentEntity,\n  ExperimentAssignmentEntity,\n  FlagEvaluationEntity,\n];\n\n/**\n * Module schema contribution for feature flags.\n */\nexport const featureFlagsSchemaContribution: ModuleSchemaContribution = {\n  moduleId: '@lssm/lib.feature-flags',\n  entities: featureFlagEntities,\n  enums: [FlagStatusEnum, RuleOperatorEnum, ExperimentStatusEnum],\n};\n"],"mappings":"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"}

package/dist/evaluation/index.d.ts

@@ -159,4 +159,5 @@ declare class InMemoryFlagRepository implements FlagRepository {
   clear(): void;
 }
 //#endregion
-export { EvaluationContext, EvaluationLogger, EvaluationReason, EvaluationResult, Experiment, ExperimentVariant, FeatureFlag, FlagEvaluator, FlagEvaluatorOptions, FlagRepository, InMemoryFlagRepository, RuleOperator, TargetingRule, VariantConfig, evaluateRuleCondition, getSubjectId, hashToBucket };
+export { EvaluationContext, EvaluationLogger, EvaluationReason, EvaluationResult, Experiment, ExperimentVariant, FeatureFlag, FlagEvaluator, FlagEvaluatorOptions, FlagRepository, InMemoryFlagRepository, RuleOperator, TargetingRule, VariantConfig, evaluateRuleCondition, getSubjectId, hashToBucket };
+//# sourceMappingURL=index.d.ts.map

package/dist/evaluation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/evaluation/index.ts"],"sourcesContent":[],"mappings":";;AASA;AAeA;AAQA;AAYA;AASA;AAOiB,UAnDA,iBAAA,CAmDiB;EAMjB;EAQL,MAAA,CAAA,EAAA,MAAA;EASA;EAmBI,KAAA,CAAA,EAAA,MAAA;EAeA;EASA,IAAA,CAAA,EAAA,MAAA;EAuFC;EAC+B,OAAA,CAAA,EAAA,MAAA;EAAR;EACJ,SAAA,CAAA,EAAA,MAAA;EAAR;EACmB,UAAA,CAAA,EAnMhC,MAmMgC,CAAA,MAAA,EAAA,OAAA,CAAA;;AAK1C,UArMY,WAAA,CAqMZ;EAOA,EAAA,EAAA,MAAA;EAAO,GAAA,EAAA,MAAA;EAGK,MAAA,EAAA,KAAA,GAAA,IAAgB,GAAA,SAWnB;EAIG,YAAA,EAAA,OAAA;EAgBJ,QAAA,CAAA,EAzOA,aAyOa,EAAA;;AAgBb,UAtPI,aAAA,CAsPJ;EACA,EAAA,EAAA,MAAA;EAAR,QAAA,EAAA,MAAA;EAAO,OAAA,EAAA,OAAA;EAsMC,SAAA,EAAA,MAAA;EAMG,QAAA,EA9bJ,YA8bI;EAIgB,KAAA,EAAA,OAAA;EAMJ,iBAAA,CAAA,EAAA,MAAA;EAIU,UAAA,CAAA,EAAA,OAAA;EAAR,YAAA,CAAA,EAAA,MAAA;;AAII,UAzcjB,UAAA,CAyciB;EAImB,EAAA,EAAA,MAAA;EAAR,GAAA,EAAA,MAAA;EAQxC,MAAA,EAAA,OAAA,GAAA,SAAA,GAAA,QAAA,GAAA,WAAA,GAAA,WAAA;EAUA,QAAA,EA3dO,iBA2dP,EAAA;EA9C0C,kBAAA,EAAA,MAAA;EAAc,cAAA,CAAA,EA3a1C,MA2a0C,CAAA,MAAA,EAAA,OAAA,CAAA;;UAxa5C,aAAA;;;;;;UAOA,iBAAA;;;;;UAMA,gBAAA;;;UAGP;;;;KAKE,gBAAA;KASA,YAAA;;;;;iBAmBI,YAAA;;;;iBAeA,YAAA,UAAsB;;;;iBAStB,qBAAA,OACR,wBACG;UAqFM,cAAA;wCACuB,QAAQ;4BACpB,QAAQ;uCACG,QAAQ;yFAK1C;2HAOA;;UAGY,gBAAA;;;;;;;;;;;cAWH;;;UAIG,oBAAA;cACH;WACH;;;;;;;;;;;;;cAcE,aAAA;;;;uBAKU;;;;iCAWV,oBACR,QAAQ;;;;;;;;;;;;;;;;;;;;;cAsMA,sBAAA,YAAkC;;;;;gBAM/B;gCAIgB;4BAMJ;wBAIE,QAAQ;4BAIJ,QAAQ;uCAIG,QAAQ;yFAQhD;2GAUA"}

package/dist/evaluation/index.js

@@ -217,4 +217,5 @@ var InMemoryFlagRepository = class {
 };
 
 //#endregion
-export { FlagEvaluator, InMemoryFlagRepository, evaluateRuleCondition, getSubjectId, hashToBucket };
+export { FlagEvaluator, InMemoryFlagRepository, evaluateRuleCondition, getSubjectId, hashToBucket };
+//# sourceMappingURL=index.js.map

package/dist/evaluation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/evaluation/index.ts"],"sourcesContent":["/**\n * Feature flag evaluation engine.\n *\n * Provides deterministic evaluation of feature flags based on targeting rules\n * and experiment assignments.\n */\n\n// ============ Types ============\n\nexport interface EvaluationContext {\n  /** User identifier */\n  userId?: string;\n  /** Organization identifier */\n  orgId?: string;\n  /** User's plan (free, pro, enterprise, etc.) */\n  plan?: string;\n  /** User segment or cohort */\n  segment?: string;\n  /** Session identifier for anonymous users */\n  sessionId?: string;\n  /** Additional custom attributes */\n  attributes?: Record<string, unknown>;\n}\n\nexport interface FeatureFlag {\n  id: string;\n  key: string;\n  status: 'OFF' | 'ON' | 'GRADUAL';\n  defaultValue: boolean;\n  variants?: VariantConfig[];\n}\n\nexport interface TargetingRule {\n  id: string;\n  priority: number;\n  enabled: boolean;\n  attribute: string;\n  operator: RuleOperator;\n  value: unknown;\n  rolloutPercentage?: number;\n  serveValue?: boolean;\n  serveVariant?: string;\n}\n\nexport interface Experiment {\n  id: string;\n  key: string;\n  status: 'DRAFT' | 'RUNNING' | 'PAUSED' | 'COMPLETED' | 'CANCELLED';\n  variants: ExperimentVariant[];\n  audiencePercentage: number;\n  audienceFilter?: Record<string, unknown>;\n}\n\nexport interface VariantConfig {\n  key: string;\n  name: string;\n  description?: string;\n  weight?: number;\n}\n\nexport interface ExperimentVariant {\n  key: string;\n  name: string;\n  percentage: number;\n}\n\nexport interface EvaluationResult {\n  enabled: boolean;\n  variant?: string;\n  reason: EvaluationReason;\n  ruleId?: string;\n  experimentId?: string;\n}\n\nexport type EvaluationReason =\n  | 'FLAG_OFF'\n  | 'FLAG_ON'\n  | 'DEFAULT_VALUE'\n  | 'RULE_MATCH'\n  | 'PERCENTAGE_ROLLOUT'\n  | 'EXPERIMENT_VARIANT'\n  | 'FLAG_NOT_FOUND';\n\nexport type RuleOperator =\n  | 'EQ'\n  | 'NEQ'\n  | 'IN'\n  | 'NIN'\n  | 'CONTAINS'\n  | 'NOT_CONTAINS'\n  | 'GT'\n  | 'GTE'\n  | 'LT'\n  | 'LTE'\n  | 'PERCENTAGE';\n\n// ============ Hashing ============\n\n/**\n * Simple hash function for consistent bucketing.\n * Uses a deterministic algorithm so the same input always produces the same bucket.\n */\nexport function hashToBucket(value: string, seed = ''): number {\n  const input = `${seed}:${value}`;\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    const char = input.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  // Return a number between 0 and 99\n  return Math.abs(hash % 100);\n}\n\n/**\n * Get subject identifier from context for consistent hashing.\n */\nexport function getSubjectId(context: EvaluationContext): string {\n  return context.userId || context.sessionId || context.orgId || 'anonymous';\n}\n\n// ============ Rule Evaluation ============\n\n/**\n * Evaluate a single targeting rule condition.\n */\nexport function evaluateRuleCondition(\n  rule: TargetingRule,\n  context: EvaluationContext\n): boolean {\n  const attributeValue = getAttributeValue(rule.attribute, context);\n\n  switch (rule.operator) {\n    case 'EQ':\n      return attributeValue === rule.value;\n\n    case 'NEQ':\n      return attributeValue !== rule.value;\n\n    case 'IN':\n      if (!Array.isArray(rule.value)) return false;\n      return rule.value.includes(attributeValue);\n\n    case 'NIN':\n      if (!Array.isArray(rule.value)) return true;\n      return !rule.value.includes(attributeValue);\n\n    case 'CONTAINS':\n      if (typeof attributeValue !== 'string' || typeof rule.value !== 'string')\n        return false;\n      return attributeValue.includes(rule.value);\n\n    case 'NOT_CONTAINS':\n      if (typeof attributeValue !== 'string' || typeof rule.value !== 'string')\n        return true;\n      return !attributeValue.includes(rule.value);\n\n    case 'GT':\n      if (typeof attributeValue !== 'number' || typeof rule.value !== 'number')\n        return false;\n      return attributeValue > rule.value;\n\n    case 'GTE':\n      if (typeof attributeValue !== 'number' || typeof rule.value !== 'number')\n        return false;\n      return attributeValue >= rule.value;\n\n    case 'LT':\n      if (typeof attributeValue !== 'number' || typeof rule.value !== 'number')\n        return false;\n      return attributeValue < rule.value;\n\n    case 'LTE':\n      if (typeof attributeValue !== 'number' || typeof rule.value !== 'number')\n        return false;\n      return attributeValue <= rule.value;\n\n    case 'PERCENTAGE':\n      // Percentage-based targeting uses consistent hashing\n      const bucket = hashToBucket(getSubjectId(context), rule.attribute);\n      const percentage = typeof rule.value === 'number' ? rule.value : 0;\n      return bucket < percentage;\n\n    default:\n      return false;\n  }\n}\n\n/**\n * Get attribute value from context.\n */\nfunction getAttributeValue(\n  attribute: string,\n  context: EvaluationContext\n): unknown {\n  switch (attribute) {\n    case 'userId':\n      return context.userId;\n    case 'orgId':\n      return context.orgId;\n    case 'plan':\n      return context.plan;\n    case 'segment':\n      return context.segment;\n    case 'sessionId':\n      return context.sessionId;\n    default:\n      return context.attributes?.[attribute];\n  }\n}\n\n// ============ Flag Evaluator ============\n\nexport interface FlagRepository {\n  getFlag(key: string, orgId?: string): Promise<FeatureFlag | null>;\n  getRules(flagId: string): Promise<TargetingRule[]>;\n  getActiveExperiment(flagId: string): Promise<Experiment | null>;\n  getExperimentAssignment(\n    experimentId: string,\n    subjectType: string,\n    subjectId: string\n  ): Promise<string | null>;\n  saveExperimentAssignment(\n    experimentId: string,\n    subjectType: string,\n    subjectId: string,\n    variant: string,\n    bucket: number\n  ): Promise<void>;\n}\n\nexport interface EvaluationLogger {\n  log(evaluation: {\n    flagId: string;\n    flagKey: string;\n    subjectType: string;\n    subjectId: string;\n    result: boolean;\n    variant?: string;\n    reason: string;\n    ruleId?: string;\n    experimentId?: string;\n    context?: EvaluationContext;\n  }): void;\n}\n\nexport interface FlagEvaluatorOptions {\n  repository: FlagRepository;\n  logger?: EvaluationLogger;\n  /** Whether to log evaluations (default: false for performance) */\n  logEvaluations?: boolean;\n}\n\n/**\n * Feature flag evaluator.\n *\n * Evaluates flags based on:\n * 1. Flag status (OFF/ON/GRADUAL)\n * 2. Targeting rules (in priority order)\n * 3. Experiments (if running)\n * 4. Default value (fallback)\n */\nexport class FlagEvaluator {\n  private repository: FlagRepository;\n  private logger?: EvaluationLogger;\n  private logEvaluations: boolean;\n\n  constructor(options: FlagEvaluatorOptions) {\n    this.repository = options.repository;\n    this.logger = options.logger;\n    this.logEvaluations = options.logEvaluations ?? false;\n  }\n\n  /**\n   * Evaluate a feature flag.\n   */\n  async evaluate(\n    key: string,\n    context: EvaluationContext\n  ): Promise<EvaluationResult> {\n    const orgId = context.orgId;\n    const flag = await this.repository.getFlag(key, orgId);\n\n    if (!flag) {\n      return this.makeResult(false, 'FLAG_NOT_FOUND');\n    }\n\n    // Check flag status\n    if (flag.status === 'OFF') {\n      return this.logAndReturn(\n        flag,\n        context,\n        this.makeResult(false, 'FLAG_OFF')\n      );\n    }\n\n    if (flag.status === 'ON') {\n      return this.logAndReturn(flag, context, this.makeResult(true, 'FLAG_ON'));\n    }\n\n    // Status is GRADUAL - evaluate rules and experiments\n    const rules = await this.repository.getRules(flag.id);\n\n    // Sort rules by priority (lower = higher priority)\n    const sortedRules = [...rules]\n      .filter((r) => r.enabled)\n      .sort((a, b) => a.priority - b.priority);\n\n    // Evaluate rules in order\n    for (const rule of sortedRules) {\n      if (evaluateRuleCondition(rule, context)) {\n        // Rule matched - check for percentage rollout\n        if (\n          rule.rolloutPercentage !== undefined &&\n          rule.rolloutPercentage !== null\n        ) {\n          const bucket = hashToBucket(getSubjectId(context), flag.key);\n          if (bucket >= rule.rolloutPercentage) {\n            continue; // User not in rollout percentage, try next rule\n          }\n        }\n\n        const enabled = rule.serveValue ?? true;\n        return this.logAndReturn(\n          flag,\n          context,\n          this.makeResult(enabled, 'RULE_MATCH', rule.serveVariant, rule.id)\n        );\n      }\n    }\n\n    // Check for active experiment\n    const experiment = await this.repository.getActiveExperiment(flag.id);\n    if (experiment && experiment.status === 'RUNNING') {\n      const result = await this.evaluateExperiment(experiment, context);\n      if (result) {\n        return this.logAndReturn(flag, context, result);\n      }\n    }\n\n    // Fall back to default value\n    return this.logAndReturn(\n      flag,\n      context,\n      this.makeResult(flag.defaultValue, 'DEFAULT_VALUE')\n    );\n  }\n\n  /**\n   * Evaluate experiment and assign variant.\n   */\n  private async evaluateExperiment(\n    experiment: Experiment,\n    context: EvaluationContext\n  ): Promise<EvaluationResult | null> {\n    const subjectId = getSubjectId(context);\n    const subjectType = context.userId\n      ? 'user'\n      : context.orgId\n        ? 'org'\n        : 'session';\n\n    // Check audience percentage\n    const audienceBucket = hashToBucket(\n      subjectId,\n      `${experiment.key}:audience`\n    );\n    if (audienceBucket >= experiment.audiencePercentage) {\n      return null; // User not in experiment audience\n    }\n\n    // Check for existing assignment\n    let variant = await this.repository.getExperimentAssignment(\n      experiment.id,\n      subjectType,\n      subjectId\n    );\n\n    if (!variant) {\n      // Assign to variant based on consistent hashing\n      const variantBucket = hashToBucket(subjectId, experiment.key);\n      variant = this.assignVariant(experiment.variants, variantBucket);\n\n      // Save assignment\n      await this.repository.saveExperimentAssignment(\n        experiment.id,\n        subjectType,\n        subjectId,\n        variant,\n        variantBucket\n      );\n    }\n\n    // Control variant typically means feature is off\n    const enabled = variant !== 'control';\n\n    return this.makeResult(\n      enabled,\n      'EXPERIMENT_VARIANT',\n      variant,\n      undefined,\n      experiment.id\n    );\n  }\n\n  /**\n   * Assign a variant based on bucket and variant percentages.\n   */\n  private assignVariant(variants: ExperimentVariant[], bucket: number): string {\n    let cumulative = 0;\n    for (const variant of variants) {\n      cumulative += variant.percentage;\n      if (bucket < cumulative) {\n        return variant.key;\n      }\n    }\n    // Fallback to last variant (shouldn't happen if percentages sum to 100)\n    return variants[variants.length - 1]?.key ?? 'control';\n  }\n\n  /**\n   * Create evaluation result.\n   */\n  private makeResult(\n    enabled: boolean,\n    reason: EvaluationReason,\n    variant?: string,\n    ruleId?: string,\n    experimentId?: string\n  ): EvaluationResult {\n    return {\n      enabled,\n      variant,\n      reason,\n      ruleId,\n      experimentId,\n    };\n  }\n\n  /**\n   * Log evaluation and return result.\n   */\n  private logAndReturn(\n    flag: FeatureFlag,\n    context: EvaluationContext,\n    result: EvaluationResult\n  ): EvaluationResult {\n    if (this.logEvaluations && this.logger) {\n      const subjectId = getSubjectId(context);\n      const subjectType = context.userId\n        ? 'user'\n        : context.orgId\n          ? 'org'\n          : 'session';\n\n      this.logger.log({\n        flagId: flag.id,\n        flagKey: flag.key,\n        subjectType,\n        subjectId,\n        result: result.enabled,\n        variant: result.variant,\n        reason: result.reason,\n        ruleId: result.ruleId,\n        experimentId: result.experimentId,\n        context,\n      });\n    }\n    return result;\n  }\n}\n\n// ============ In-Memory Repository ============\n\n/**\n * In-memory flag repository for testing and development.\n */\nexport class InMemoryFlagRepository implements FlagRepository {\n  private flags = new Map<string, FeatureFlag>();\n  private rules = new Map<string, TargetingRule[]>();\n  private experiments = new Map<string, Experiment>();\n  private assignments = new Map<string, string>();\n\n  addFlag(flag: FeatureFlag): void {\n    this.flags.set(flag.key, flag);\n  }\n\n  addRule(flagId: string, rule: TargetingRule): void {\n    const existing = this.rules.get(flagId) || [];\n    existing.push(rule);\n    this.rules.set(flagId, existing);\n  }\n\n  addExperiment(experiment: Experiment, flagId: string): void {\n    this.experiments.set(flagId, experiment);\n  }\n\n  async getFlag(key: string): Promise<FeatureFlag | null> {\n    return this.flags.get(key) || null;\n  }\n\n  async getRules(flagId: string): Promise<TargetingRule[]> {\n    return this.rules.get(flagId) || [];\n  }\n\n  async getActiveExperiment(flagId: string): Promise<Experiment | null> {\n    return this.experiments.get(flagId) || null;\n  }\n\n  async getExperimentAssignment(\n    experimentId: string,\n    subjectType: string,\n    subjectId: string\n  ): Promise<string | null> {\n    const key = `${experimentId}:${subjectType}:${subjectId}`;\n    return this.assignments.get(key) || null;\n  }\n\n  async saveExperimentAssignment(\n    experimentId: string,\n    subjectType: string,\n    subjectId: string,\n    variant: string\n  ): Promise<void> {\n    const key = `${experimentId}:${subjectType}:${subjectId}`;\n    this.assignments.set(key, variant);\n  }\n\n  clear(): void {\n    this.flags.clear();\n    this.rules.clear();\n    this.experiments.clear();\n    this.assignments.clear();\n  }\n}\n"],"mappings":"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"}

package/dist/events.d.ts

@@ -621,4 +621,5 @@ declare const FeatureFlagEvents: {
   }>>;
 };
 //#endregion
-export { ExperimentCreatedEvent, ExperimentStartedEvent, ExperimentStoppedEvent, FeatureFlagEvents, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagToggledEvent, FlagUpdatedEvent, RuleCreatedEvent, RuleDeletedEvent, VariantAssignedEvent };
+export { ExperimentCreatedEvent, ExperimentStartedEvent, ExperimentStoppedEvent, FeatureFlagEvents, FlagCreatedEvent, FlagDeletedEvent, FlagEvaluatedEvent, FlagToggledEvent, FlagUpdatedEvent, RuleCreatedEvent, RuleDeletedEvent, VariantAssignedEvent };
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;;;;cAsKa,kBAAgB,oBAAA,CAAA,4BAAA;EAAhB,MAAA,EAAA;IAKX,IAAA,EAAA,iBAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;qCAL2B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAUhB,MAAA,EAAA;IAKX,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EAL2B,SAAA,EAAA;IAAA,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAUhB,UAAA,EAAA,IAKX;EAAA,CAAA;;;;;;;;AAKF;AAKE,cAzBW,gBAyBX,EAzB2B,oBAAA,CAAA,SAyB3B,mBAzB2B,WAyB3B,CAAA;;UApBA,iBAAA,CAAA;;;;;gBAe2B,KAAA;EAAA,CAAA;EAAA,OAAA,EAAA;IAUhB,IAAA,6BAKX,CAAA,OAAA,EAAA,OAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;qCAL2B,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;AAU7B,CAAA,CAAA,CAAA;;;;cA9Ba,kBAAgB,oBAAA,CAAA,4BAAA;;UAK3B,iBAAA,CAAA,SAyB2B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAUhB,GAAA,EAAA;IAKX,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;qCALiC,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;AAUnC,CAAA,CAAA,CAAA;;;;cAxCa,kBAAgB,oBAAA,CAAA,4BAAA;;UAK3B,iBAAA,CAAA;;;;IAmCiC,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAUtB,CAAA;EAKX,cAAA,EAAA;;;;;;;;EALiC,SAAA,EAAA;IAAA,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAUtB,UAAA,EAAA,IAAA;EAKX,CAAA;;;;;;;;;cAvDW,gBAkDkB,EAlDF,oBAAA,CAAA,SAkDE,mBAlDF,WAkDE,CAAA;EAAA,MAAA,EAAA;IAAA,IAAA,EA7C7B,iBAAA,CAAA,SA6C6B,CAAA,MAAA,EAAA,MAAA,CAAA;IAUlB,UAAA,EAAA,KAAA;EAKX,CAAA;;;;;;;;;EAL+B,SAAA,EAAA;IAAA,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAUpB,UAAA,EAAA,KAYZ;EAAA,CAAA;;;;;;;;;;;;;cAxEY,kBAAgB,oBAAA,CAAA,4BAAA;;UAK3B,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;cAKW,wBAAsB,oBAAA,CAAA,4BAAA;;UAKjC,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,wBAAsB,oBAAA,CAAA,4BAAA;;UAKjC,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,wBAAsB,oBAAA,CAAA,4BAAA;;UAKjC,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,oBAAkB,oBAAA,CAAA,4BAAA;;UAK7B,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,sBAAoB,oBAAA,CAAA,4BAAA;;UAK/B,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW;;;YAYZ,iBAAA,CAAA"}