@lssm/lib.feature-flags 0.0.0-canary-20251206160926

package/dist/contracts/index.js

@@ -0,0 +1 @@
+import{l as e}from"../schema/dist/ScalarTypeEnum.js";import{n as t}from"../schema/dist/SchemaModel.js";import"../schema/dist/index.js";import{n,t as r}from"./dist/spec.js";import"./dist/index.js";const i=[`platform.feature-flags`],a=t({name:`FeatureFlag`,description:`Represents a feature flag`,fields:{id:{type:e.String_unsecure(),isOptional:!1},key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},status:{type:e.String_unsecure(),isOptional:!1},defaultValue:{type:e.Boolean(),isOptional:!1},variants:{type:e.JSON(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!0},tags:{type:e.JSON(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`TargetingRule`,description:`Represents a targeting rule`,fields:{id:{type:e.String_unsecure(),isOptional:!1},flagId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},priority:{type:e.Int_unsecure(),isOptional:!1},enabled:{type:e.Boolean(),isOptional:!1},attribute:{type:e.String_unsecure(),isOptional:!1},operator:{type:e.String_unsecure(),isOptional:!1},value:{type:e.JSON(),isOptional:!1},rolloutPercentage:{type:e.Int_unsecure(),isOptional:!0},serveValue:{type:e.Boolean(),isOptional:!0},serveVariant:{type:e.String_unsecure(),isOptional:!0}}}),s=t({name:`Experiment`,description:`Represents an experiment`,fields:{id:{type:e.String_unsecure(),isOptional:!1},key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},hypothesis:{type:e.String_unsecure(),isOptional:!0},flagId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},variants:{type:e.JSON(),isOptional:!1},metrics:{type:e.JSON(),isOptional:!0},audiencePercentage:{type:e.Int_unsecure(),isOptional:!1},startedAt:{type:e.DateTime(),isOptional:!0},endedAt:{type:e.DateTime(),isOptional:!0},winningVariant:{type:e.String_unsecure(),isOptional:!0},results:{type:e.JSON(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),c=t({name:`EvaluationResult`,description:`Result of flag evaluation`,fields:{enabled:{type:e.Boolean(),isOptional:!1},variant:{type:e.String_unsecure(),isOptional:!0},reason:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!0},experimentId:{type:e.String_unsecure(),isOptional:!0}}}),l=t({name:`CreateFlagInput`,description:`Input for creating a feature flag`,fields:{key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},defaultValue:{type:e.Boolean(),isOptional:!0},variants:{type:e.JSON(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!0},tags:{type:e.JSON(),isOptional:!0}}}),u=t({name:`UpdateFlagInput`,description:`Input for updating a feature flag`,fields:{flagId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},description:{type:e.String_unsecure(),isOptional:!0},defaultValue:{type:e.Boolean(),isOptional:!0},variants:{type:e.JSON(),isOptional:!0},tags:{type:e.JSON(),isOptional:!0}}}),d=t({name:`DeleteFlagInput`,description:`Input for deleting a feature flag`,fields:{flagId:{type:e.String_unsecure(),isOptional:!1}}}),f=t({name:`ToggleFlagInput`,description:`Input for toggling a feature flag`,fields:{flagId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1}}}),p=t({name:`GetFlagInput`,description:`Input for getting a feature flag`,fields:{key:{type:e.String_unsecure(),isOptional:!1},orgId:{type:e.String_unsecure(),isOptional:!0}}}),m=t({name:`ListFlagsInput`,description:`Input for listing feature flags`,fields:{orgId:{type:e.String_unsecure(),isOptional:!0},status:{type:e.String_unsecure(),isOptional:!0},tags:{type:e.JSON(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0}}}),h=t({name:`ListFlagsOutput`,description:`Output for listing feature flags`,fields:{flags:{type:a,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1}}}),g=t({name:`EvaluateFlagInput`,description:`Input for evaluating a feature flag`,fields:{key:{type:e.String_unsecure(),isOptional:!1},context:{type:e.JSON(),isOptional:!1}}}),_=t({name:`CreateRuleInput`,description:`Input for creating a targeting rule`,fields:{flagId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},priority:{type:e.Int_unsecure(),isOptional:!0},attribute:{type:e.String_unsecure(),isOptional:!1},operator:{type:e.String_unsecure(),isOptional:!1},value:{type:e.JSON(),isOptional:!1},rolloutPercentage:{type:e.Int_unsecure(),isOptional:!0},serveValue:{type:e.Boolean(),isOptional:!0},serveVariant:{type:e.String_unsecure(),isOptional:!0}}}),v=t({name:`DeleteRuleInput`,description:`Input for deleting a targeting rule`,fields:{ruleId:{type:e.String_unsecure(),isOptional:!1}}}),y=t({name:`CreateExperimentInput`,description:`Input for creating an experiment`,fields:{key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},hypothesis:{type:e.String_unsecure(),isOptional:!0},flagId:{type:e.String_unsecure(),isOptional:!1},variants:{type:e.JSON(),isOptional:!1},metrics:{type:e.JSON(),isOptional:!0},audiencePercentage:{type:e.Int_unsecure(),isOptional:!0},scheduledStartAt:{type:e.DateTime(),isOptional:!0},scheduledEndAt:{type:e.DateTime(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!0}}}),b=t({name:`StartExperimentInput`,description:`Input for starting an experiment`,fields:{experimentId:{type:e.String_unsecure(),isOptional:!1}}}),x=t({name:`StopExperimentInput`,description:`Input for stopping an experiment`,fields:{experimentId:{type:e.String_unsecure(),isOptional:!1},reason:{type:e.String_unsecure(),isOptional:!1},winningVariant:{type:e.String_unsecure(),isOptional:!0}}}),S=t({name:`GetExperimentInput`,description:`Input for getting an experiment`,fields:{experimentId:{type:e.String_unsecure(),isOptional:!1}}}),C=t({name:`SuccessOutput`,description:`Generic success output`,fields:{success:{type:e.Boolean(),isOptional:!1}}}),w=r({meta:{name:`flag.create`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`create`],description:`Create a new feature flag.`,goal:`Define a new feature flag for toggling features.`,context:`Called when setting up a new feature flag.`},io:{input:l,output:a,errors:{KEY_ALREADY_EXISTS:{description:`Flag key already exists`,http:409,gqlCode:`FLAG_KEY_EXISTS`,when:`A flag with this key already exists`}}},policy:{auth:`admin`}}),T=r({meta:{name:`flag.update`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`update`],description:`Update an existing feature flag.`,goal:`Modify flag configuration.`,context:`Called when adjusting flag settings.`},io:{input:u,output:a,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag ID is invalid`}}},policy:{auth:`admin`}}),E=r({meta:{name:`flag.delete`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`delete`],description:`Delete a feature flag.`,goal:`Remove a feature flag and all its rules.`,context:`Called when a flag is no longer needed.`},io:{input:d,output:C,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag ID is invalid`},FLAG_HAS_ACTIVE_EXPERIMENT:{description:`Flag has an active experiment`,http:409,gqlCode:`FLAG_HAS_ACTIVE_EXPERIMENT`,when:`Cannot delete flag with running experiment`}}},policy:{auth:`admin`}}),D=r({meta:{name:`flag.toggle`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`toggle`],description:`Toggle a feature flag status.`,goal:`Quickly enable or disable a feature.`,context:`Called when turning a feature on or off.`},io:{input:f,output:a,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag ID is invalid`},INVALID_STATUS:{description:`Invalid status value`,http:400,gqlCode:`INVALID_STATUS`,when:`Status must be OFF, ON, or GRADUAL`}}},policy:{auth:`admin`}}),O=n({meta:{name:`flag.get`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`get`],description:`Get a feature flag by key.`,goal:`Retrieve flag configuration.`,context:`Called to inspect flag details.`},io:{input:p,output:a,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag key is invalid`}}},policy:{auth:`user`}}),k=n({meta:{name:`flag.list`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`list`],description:`List all feature flags.`,goal:`View all configured flags.`,context:`Admin dashboard.`},io:{input:m,output:h},policy:{auth:`admin`}}),A=n({meta:{name:`flag.evaluate`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`evaluate`],description:`Evaluate a feature flag for a given context.`,goal:`Determine if a feature should be enabled.`,context:`Called at runtime to check feature availability.`},io:{input:g,output:c,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag key is invalid`}}},policy:{auth:`anonymous`}}),j=r({meta:{name:`flag.rule.create`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`rule`,`create`],description:`Create a targeting rule for a flag.`,goal:`Add conditional targeting to a flag.`,context:`Called when setting up targeting.`},io:{input:_,output:o,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag ID is invalid`},INVALID_OPERATOR:{description:`Invalid operator`,http:400,gqlCode:`INVALID_OPERATOR`,when:`Operator is not supported`}}},policy:{auth:`admin`}}),M=r({meta:{name:`flag.rule.delete`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`rule`,`delete`],description:`Delete a targeting rule.`,goal:`Remove a targeting rule from a flag.`,context:`Called when removing targeting conditions.`},io:{input:v,output:C,errors:{RULE_NOT_FOUND:{description:`Rule does not exist`,http:404,gqlCode:`RULE_NOT_FOUND`,when:`Rule ID is invalid`}}},policy:{auth:`admin`}}),N=r({meta:{name:`experiment.create`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`experiment`,`create`],description:`Create an A/B test experiment.`,goal:`Set up an experiment with variants.`,context:`Called when setting up A/B testing.`},io:{input:y,output:s,errors:{FLAG_NOT_FOUND:{description:`Flag does not exist`,http:404,gqlCode:`FLAG_NOT_FOUND`,when:`Flag ID is invalid`},EXPERIMENT_KEY_EXISTS:{description:`Experiment key already exists`,http:409,gqlCode:`EXPERIMENT_KEY_EXISTS`,when:`An experiment with this key already exists`},INVALID_VARIANTS:{description:`Invalid variant configuration`,http:400,gqlCode:`INVALID_VARIANTS`,when:`Variant percentages must sum to 100`}}},policy:{auth:`admin`}}),P=r({meta:{name:`experiment.start`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`experiment`,`start`],description:`Start an experiment.`,goal:`Begin collecting data for an experiment.`,context:`Called when ready to run an A/B test.`},io:{input:b,output:s,errors:{EXPERIMENT_NOT_FOUND:{description:`Experiment does not exist`,http:404,gqlCode:`EXPERIMENT_NOT_FOUND`,when:`Experiment ID is invalid`},EXPERIMENT_ALREADY_RUNNING:{description:`Experiment is already running`,http:409,gqlCode:`EXPERIMENT_ALREADY_RUNNING`,when:`Cannot start an experiment that is already running`}}},policy:{auth:`admin`}}),F=r({meta:{name:`experiment.stop`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`experiment`,`stop`],description:`Stop an experiment.`,goal:`End an experiment and optionally declare a winner.`,context:`Called when concluding an A/B test.`},io:{input:x,output:s,errors:{EXPERIMENT_NOT_FOUND:{description:`Experiment does not exist`,http:404,gqlCode:`EXPERIMENT_NOT_FOUND`,when:`Experiment ID is invalid`},EXPERIMENT_NOT_RUNNING:{description:`Experiment is not running`,http:409,gqlCode:`EXPERIMENT_NOT_RUNNING`,when:`Cannot stop an experiment that is not running`}}},policy:{auth:`admin`}}),I=n({meta:{name:`experiment.get`,version:1,stability:`stable`,owners:[...i],tags:[`feature-flags`,`experiment`,`get`],description:`Get experiment details.`,goal:`View experiment configuration and results.`,context:`Called to inspect experiment status.`},io:{input:S,output:s,errors:{EXPERIMENT_NOT_FOUND:{description:`Experiment does not exist`,http:404,gqlCode:`EXPERIMENT_NOT_FOUND`,when:`Experiment ID is invalid`}}},policy:{auth:`user`}});export{N as CreateExperimentContract,w as CreateFlagContract,j as CreateRuleContract,E as DeleteFlagContract,M as DeleteRuleContract,A as EvaluateFlagContract,c as EvaluationResultModel,s as ExperimentModel,a as FeatureFlagModel,I as GetExperimentContract,O as GetFlagContract,k as ListFlagsContract,P as StartExperimentContract,F as StopExperimentContract,o as TargetingRuleModel,D as ToggleFlagContract,T as UpdateFlagContract};

package/dist/entities/index.d.ts

@@ -0,0 +1,200 @@
+import * as _lssm_lib_schema155 from "@lssm/lib.schema";
+import { ModuleSchemaContribution } from "@lssm/lib.schema";
+
+//#region src/entities/index.d.ts
+/**
+ * Feature flag status enum.
+ */
+declare const FlagStatusEnum: _lssm_lib_schema155.EntityEnumDef;
+/**
+ * Targeting rule operator enum.
+ */
+declare const RuleOperatorEnum: _lssm_lib_schema155.EntityEnumDef;
+/**
+ * Experiment status enum.
+ */
+declare const ExperimentStatusEnum: _lssm_lib_schema155.EntityEnumDef;
+/**
+ * FeatureFlag entity - defines a feature flag.
+ */
+declare const FeatureFlagEntity: _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  key: _lssm_lib_schema155.EntityScalarField;
+  name: _lssm_lib_schema155.EntityScalarField;
+  description: _lssm_lib_schema155.EntityScalarField;
+  status: _lssm_lib_schema155.EntityEnumField;
+  defaultValue: _lssm_lib_schema155.EntityScalarField;
+  variants: _lssm_lib_schema155.EntityScalarField;
+  orgId: _lssm_lib_schema155.EntityScalarField;
+  tags: _lssm_lib_schema155.EntityScalarField;
+  metadata: _lssm_lib_schema155.EntityScalarField;
+  createdAt: _lssm_lib_schema155.EntityScalarField;
+  updatedAt: _lssm_lib_schema155.EntityScalarField;
+  targetingRules: _lssm_lib_schema155.EntityRelationField;
+  experiments: _lssm_lib_schema155.EntityRelationField;
+  evaluations: _lssm_lib_schema155.EntityRelationField;
+}>;
+/**
+ * FlagTargetingRule entity - conditions for targeting.
+ */
+declare const FlagTargetingRuleEntity: _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  flagId: _lssm_lib_schema155.EntityScalarField;
+  name: _lssm_lib_schema155.EntityScalarField;
+  priority: _lssm_lib_schema155.EntityScalarField;
+  enabled: _lssm_lib_schema155.EntityScalarField;
+  attribute: _lssm_lib_schema155.EntityScalarField;
+  operator: _lssm_lib_schema155.EntityEnumField;
+  value: _lssm_lib_schema155.EntityScalarField;
+  rolloutPercentage: _lssm_lib_schema155.EntityScalarField;
+  serveValue: _lssm_lib_schema155.EntityScalarField;
+  serveVariant: _lssm_lib_schema155.EntityScalarField;
+  createdAt: _lssm_lib_schema155.EntityScalarField;
+  updatedAt: _lssm_lib_schema155.EntityScalarField;
+  flag: _lssm_lib_schema155.EntityRelationField;
+}>;
+/**
+ * Experiment entity - A/B test configuration.
+ */
+declare const ExperimentEntity: _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  key: _lssm_lib_schema155.EntityScalarField;
+  name: _lssm_lib_schema155.EntityScalarField;
+  description: _lssm_lib_schema155.EntityScalarField;
+  hypothesis: _lssm_lib_schema155.EntityScalarField;
+  flagId: _lssm_lib_schema155.EntityScalarField;
+  status: _lssm_lib_schema155.EntityEnumField;
+  variants: _lssm_lib_schema155.EntityScalarField;
+  metrics: _lssm_lib_schema155.EntityScalarField;
+  audiencePercentage: _lssm_lib_schema155.EntityScalarField;
+  audienceFilter: _lssm_lib_schema155.EntityScalarField;
+  scheduledStartAt: _lssm_lib_schema155.EntityScalarField;
+  scheduledEndAt: _lssm_lib_schema155.EntityScalarField;
+  startedAt: _lssm_lib_schema155.EntityScalarField;
+  endedAt: _lssm_lib_schema155.EntityScalarField;
+  winningVariant: _lssm_lib_schema155.EntityScalarField;
+  results: _lssm_lib_schema155.EntityScalarField;
+  orgId: _lssm_lib_schema155.EntityScalarField;
+  createdAt: _lssm_lib_schema155.EntityScalarField;
+  updatedAt: _lssm_lib_schema155.EntityScalarField;
+  flag: _lssm_lib_schema155.EntityRelationField;
+  assignments: _lssm_lib_schema155.EntityRelationField;
+}>;
+/**
+ * ExperimentAssignment entity - tracks which variant a subject is assigned to.
+ */
+declare const ExperimentAssignmentEntity: _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  experimentId: _lssm_lib_schema155.EntityScalarField;
+  subjectType: _lssm_lib_schema155.EntityScalarField;
+  subjectId: _lssm_lib_schema155.EntityScalarField;
+  variant: _lssm_lib_schema155.EntityScalarField;
+  bucket: _lssm_lib_schema155.EntityScalarField;
+  context: _lssm_lib_schema155.EntityScalarField;
+  assignedAt: _lssm_lib_schema155.EntityScalarField;
+  experiment: _lssm_lib_schema155.EntityRelationField;
+}>;
+/**
+ * FlagEvaluation entity - evaluation log for analytics.
+ */
+declare const FlagEvaluationEntity: _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  flagId: _lssm_lib_schema155.EntityScalarField;
+  flagKey: _lssm_lib_schema155.EntityScalarField;
+  subjectType: _lssm_lib_schema155.EntityScalarField;
+  subjectId: _lssm_lib_schema155.EntityScalarField;
+  result: _lssm_lib_schema155.EntityScalarField;
+  variant: _lssm_lib_schema155.EntityScalarField;
+  matchedRuleId: _lssm_lib_schema155.EntityScalarField;
+  reason: _lssm_lib_schema155.EntityScalarField;
+  context: _lssm_lib_schema155.EntityScalarField;
+  evaluatedAt: _lssm_lib_schema155.EntityScalarField;
+  flag: _lssm_lib_schema155.EntityRelationField;
+}>;
+/**
+ * All feature flag entities for schema composition.
+ */
+declare const featureFlagEntities: (_lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  key: _lssm_lib_schema155.EntityScalarField;
+  name: _lssm_lib_schema155.EntityScalarField;
+  description: _lssm_lib_schema155.EntityScalarField;
+  status: _lssm_lib_schema155.EntityEnumField;
+  defaultValue: _lssm_lib_schema155.EntityScalarField;
+  variants: _lssm_lib_schema155.EntityScalarField;
+  orgId: _lssm_lib_schema155.EntityScalarField;
+  tags: _lssm_lib_schema155.EntityScalarField;
+  metadata: _lssm_lib_schema155.EntityScalarField;
+  createdAt: _lssm_lib_schema155.EntityScalarField;
+  updatedAt: _lssm_lib_schema155.EntityScalarField;
+  targetingRules: _lssm_lib_schema155.EntityRelationField;
+  experiments: _lssm_lib_schema155.EntityRelationField;
+  evaluations: _lssm_lib_schema155.EntityRelationField;
+}> | _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  flagId: _lssm_lib_schema155.EntityScalarField;
+  name: _lssm_lib_schema155.EntityScalarField;
+  priority: _lssm_lib_schema155.EntityScalarField;
+  enabled: _lssm_lib_schema155.EntityScalarField;
+  attribute: _lssm_lib_schema155.EntityScalarField;
+  operator: _lssm_lib_schema155.EntityEnumField;
+  value: _lssm_lib_schema155.EntityScalarField;
+  rolloutPercentage: _lssm_lib_schema155.EntityScalarField;
+  serveValue: _lssm_lib_schema155.EntityScalarField;
+  serveVariant: _lssm_lib_schema155.EntityScalarField;
+  createdAt: _lssm_lib_schema155.EntityScalarField;
+  updatedAt: _lssm_lib_schema155.EntityScalarField;
+  flag: _lssm_lib_schema155.EntityRelationField;
+}> | _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  key: _lssm_lib_schema155.EntityScalarField;
+  name: _lssm_lib_schema155.EntityScalarField;
+  description: _lssm_lib_schema155.EntityScalarField;
+  hypothesis: _lssm_lib_schema155.EntityScalarField;
+  flagId: _lssm_lib_schema155.EntityScalarField;
+  status: _lssm_lib_schema155.EntityEnumField;
+  variants: _lssm_lib_schema155.EntityScalarField;
+  metrics: _lssm_lib_schema155.EntityScalarField;
+  audiencePercentage: _lssm_lib_schema155.EntityScalarField;
+  audienceFilter: _lssm_lib_schema155.EntityScalarField;
+  scheduledStartAt: _lssm_lib_schema155.EntityScalarField;
+  scheduledEndAt: _lssm_lib_schema155.EntityScalarField;
+  startedAt: _lssm_lib_schema155.EntityScalarField;
+  endedAt: _lssm_lib_schema155.EntityScalarField;
+  winningVariant: _lssm_lib_schema155.EntityScalarField;
+  results: _lssm_lib_schema155.EntityScalarField;
+  orgId: _lssm_lib_schema155.EntityScalarField;
+  createdAt: _lssm_lib_schema155.EntityScalarField;
+  updatedAt: _lssm_lib_schema155.EntityScalarField;
+  flag: _lssm_lib_schema155.EntityRelationField;
+  assignments: _lssm_lib_schema155.EntityRelationField;
+}> | _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  experimentId: _lssm_lib_schema155.EntityScalarField;
+  subjectType: _lssm_lib_schema155.EntityScalarField;
+  subjectId: _lssm_lib_schema155.EntityScalarField;
+  variant: _lssm_lib_schema155.EntityScalarField;
+  bucket: _lssm_lib_schema155.EntityScalarField;
+  context: _lssm_lib_schema155.EntityScalarField;
+  assignedAt: _lssm_lib_schema155.EntityScalarField;
+  experiment: _lssm_lib_schema155.EntityRelationField;
+}> | _lssm_lib_schema155.EntitySpec<{
+  id: _lssm_lib_schema155.EntityScalarField;
+  flagId: _lssm_lib_schema155.EntityScalarField;
+  flagKey: _lssm_lib_schema155.EntityScalarField;
+  subjectType: _lssm_lib_schema155.EntityScalarField;
+  subjectId: _lssm_lib_schema155.EntityScalarField;
+  result: _lssm_lib_schema155.EntityScalarField;
+  variant: _lssm_lib_schema155.EntityScalarField;
+  matchedRuleId: _lssm_lib_schema155.EntityScalarField;
+  reason: _lssm_lib_schema155.EntityScalarField;
+  context: _lssm_lib_schema155.EntityScalarField;
+  evaluatedAt: _lssm_lib_schema155.EntityScalarField;
+  flag: _lssm_lib_schema155.EntityRelationField;
+}>)[];
+/**
+ * Module schema contribution for feature flags.
+ */
+declare const featureFlagsSchemaContribution: ModuleSchemaContribution;
+//#endregion
+export { ExperimentAssignmentEntity, ExperimentEntity, ExperimentStatusEnum, FeatureFlagEntity, FlagEvaluationEntity, FlagStatusEnum, FlagTargetingRuleEntity, RuleOperatorEnum, featureFlagEntities, featureFlagsSchemaContribution };

package/dist/entities/index.js

@@ -0,0 +1 @@
+import{i as e,n as t,r as n,t as r}from"../schema/dist/entity/defineEntity.js";import"../schema/dist/index.js";const i=t({name:`FlagStatus`,values:[`OFF`,`ON`,`GRADUAL`],schema:`lssm_feature_flags`,description:`Status of a feature flag.`}),a=t({name:`RuleOperator`,values:[`EQ`,`NEQ`,`IN`,`NIN`,`CONTAINS`,`NOT_CONTAINS`,`GT`,`GTE`,`LT`,`LTE`,`PERCENTAGE`],schema:`lssm_feature_flags`,description:`Operator for targeting rule conditions.`}),o=t({name:`ExperimentStatus`,values:[`DRAFT`,`RUNNING`,`PAUSED`,`COMPLETED`,`CANCELLED`],schema:`lssm_feature_flags`,description:`Status of an experiment.`}),s=r({name:`FeatureFlag`,description:`A feature flag for controlling feature availability.`,schema:`lssm_feature_flags`,map:`feature_flag`,fields:{id:n.id({description:`Unique flag identifier`}),key:n.string({isUnique:!0,description:`Flag key (e.g., new_dashboard)`}),name:n.string({description:`Human-readable name`}),description:n.string({isOptional:!0,description:`Description of the flag`}),status:n.enum(`FlagStatus`,{default:`OFF`,description:`Flag status`}),defaultValue:n.boolean({default:!1,description:`Default value when no rules match`}),variants:n.json({isOptional:!0,description:`Variant definitions for multivariate flags`}),orgId:n.string({isOptional:!0,description:`Organization scope (null = global)`}),tags:n.json({isOptional:!0,description:`Tags for categorization`}),metadata:n.json({isOptional:!0,description:`Additional metadata`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),targetingRules:n.hasMany(`FlagTargetingRule`),experiments:n.hasMany(`Experiment`),evaluations:n.hasMany(`FlagEvaluation`)},indexes:[e.on([`orgId`,`key`]),e.on([`status`])],enums:[i]}),c=r({name:`FlagTargetingRule`,description:`A targeting rule for conditional flag evaluation.`,schema:`lssm_feature_flags`,map:`flag_targeting_rule`,fields:{id:n.id({description:`Unique rule identifier`}),flagId:n.foreignKey({description:`Parent feature flag`}),name:n.string({isOptional:!0,description:`Rule name for debugging`}),priority:n.int({default:0,description:`Rule priority (lower = higher priority)`}),enabled:n.boolean({default:!0,description:`Whether rule is active`}),attribute:n.string({description:`Target attribute (userId, orgId, plan, segment, etc.)`}),operator:n.enum(`RuleOperator`,{description:`Comparison operator`}),value:n.json({description:`Target value(s)`}),rolloutPercentage:n.int({isOptional:!0,description:`Percentage for gradual rollout (0-100)`}),serveValue:n.boolean({isOptional:!0,description:`Boolean value to serve`}),serveVariant:n.string({isOptional:!0,description:`Variant key to serve (for multivariate)`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),flag:n.belongsTo(`FeatureFlag`,[`flagId`],[`id`],{onDelete:`Cascade`})},indexes:[e.on([`flagId`,`priority`]),e.on([`attribute`])],enums:[a]}),l=r({name:`Experiment`,description:`An A/B test experiment.`,schema:`lssm_feature_flags`,map:`experiment`,fields:{id:n.id({description:`Unique experiment identifier`}),key:n.string({isUnique:!0,description:`Experiment key`}),name:n.string({description:`Human-readable name`}),description:n.string({isOptional:!0,description:`Experiment description`}),hypothesis:n.string({isOptional:!0,description:`Experiment hypothesis`}),flagId:n.foreignKey({description:`Associated feature flag`}),status:n.enum(`ExperimentStatus`,{default:`DRAFT`,description:`Experiment status`}),variants:n.json({description:`Variant definitions with split ratios`}),metrics:n.json({isOptional:!0,description:`Metrics to track`}),audiencePercentage:n.int({default:100,description:`Percentage of audience to include`}),audienceFilter:n.json({isOptional:!0,description:`Audience filter criteria`}),scheduledStartAt:n.dateTime({isOptional:!0,description:`Scheduled start time`}),scheduledEndAt:n.dateTime({isOptional:!0,description:`Scheduled end time`}),startedAt:n.dateTime({isOptional:!0,description:`Actual start time`}),endedAt:n.dateTime({isOptional:!0,description:`Actual end time`}),winningVariant:n.string({isOptional:!0,description:`Declared winning variant`}),results:n.json({isOptional:!0,description:`Experiment results summary`}),orgId:n.string({isOptional:!0,description:`Organization scope`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),flag:n.belongsTo(`FeatureFlag`,[`flagId`],[`id`],{onDelete:`Cascade`}),assignments:n.hasMany(`ExperimentAssignment`)},indexes:[e.on([`status`]),e.on([`orgId`,`status`]),e.on([`flagId`])],enums:[o]}),u=r({name:`ExperimentAssignment`,description:`Tracks experiment variant assignments.`,schema:`lssm_feature_flags`,map:`experiment_assignment`,fields:{id:n.id({description:`Unique assignment identifier`}),experimentId:n.foreignKey({description:`Parent experiment`}),subjectType:n.string({description:`Subject type (user, org, session)`}),subjectId:n.string({description:`Subject identifier`}),variant:n.string({description:`Assigned variant key`}),bucket:n.int({description:`Hash bucket (0-99)`}),context:n.json({isOptional:!0,description:`Context at assignment time`}),assignedAt:n.dateTime({description:`Assignment timestamp`}),experiment:n.belongsTo(`Experiment`,[`experimentId`],[`id`],{onDelete:`Cascade`})},indexes:[e.unique([`experimentId`,`subjectType`,`subjectId`],{name:`experiment_assignment_unique`}),e.on([`subjectType`,`subjectId`])]}),d=r({name:`FlagEvaluation`,description:`Log of flag evaluations for debugging and analytics.`,schema:`lssm_feature_flags`,map:`flag_evaluation`,fields:{id:n.id({description:`Unique evaluation identifier`}),flagId:n.foreignKey({description:`Evaluated flag`}),flagKey:n.string({description:`Flag key (denormalized for queries)`}),subjectType:n.string({description:`Subject type (user, org, anonymous)`}),subjectId:n.string({description:`Subject identifier`}),result:n.boolean({description:`Evaluation result`}),variant:n.string({isOptional:!0,description:`Served variant (for multivariate)`}),matchedRuleId:n.string({isOptional:!0,description:`Rule that matched (if any)`}),reason:n.string({description:`Evaluation reason (default, rule, experiment, etc.)`}),context:n.json({isOptional:!0,description:`Evaluation context`}),evaluatedAt:n.dateTime({description:`Evaluation timestamp`}),flag:n.belongsTo(`FeatureFlag`,[`flagId`],[`id`],{onDelete:`Cascade`})},indexes:[e.on([`flagKey`,`evaluatedAt`]),e.on([`subjectType`,`subjectId`,`evaluatedAt`]),e.on([`flagId`,`evaluatedAt`])]}),f=[s,c,l,u,d],p={moduleId:`@lssm/lib.feature-flags`,entities:f,enums:[i,a,o]};export{u as ExperimentAssignmentEntity,l as ExperimentEntity,o as ExperimentStatusEnum,s as FeatureFlagEntity,d as FlagEvaluationEntity,i as FlagStatusEnum,c as FlagTargetingRuleEntity,a as RuleOperatorEnum,f as featureFlagEntities,p as featureFlagsSchemaContribution};

package/dist/evaluation/index.d.ts

@@ -0,0 +1,162 @@
+//#region src/evaluation/index.d.ts
+/**
+ * Feature flag evaluation engine.
+ *
+ * Provides deterministic evaluation of feature flags based on targeting rules
+ * and experiment assignments.
+ */
+interface EvaluationContext {
+  /** User identifier */
+  userId?: string;
+  /** Organization identifier */
+  orgId?: string;
+  /** User's plan (free, pro, enterprise, etc.) */
+  plan?: string;
+  /** User segment or cohort */
+  segment?: string;
+  /** Session identifier for anonymous users */
+  sessionId?: string;
+  /** Additional custom attributes */
+  attributes?: Record<string, unknown>;
+}
+interface FeatureFlag {
+  id: string;
+  key: string;
+  status: 'OFF' | 'ON' | 'GRADUAL';
+  defaultValue: boolean;
+  variants?: VariantConfig[];
+}
+interface TargetingRule {
+  id: string;
+  priority: number;
+  enabled: boolean;
+  attribute: string;
+  operator: RuleOperator;
+  value: unknown;
+  rolloutPercentage?: number;
+  serveValue?: boolean;
+  serveVariant?: string;
+}
+interface Experiment {
+  id: string;
+  key: string;
+  status: 'DRAFT' | 'RUNNING' | 'PAUSED' | 'COMPLETED' | 'CANCELLED';
+  variants: ExperimentVariant[];
+  audiencePercentage: number;
+  audienceFilter?: Record<string, unknown>;
+}
+interface VariantConfig {
+  key: string;
+  name: string;
+  description?: string;
+  weight?: number;
+}
+interface ExperimentVariant {
+  key: string;
+  name: string;
+  percentage: number;
+}
+interface EvaluationResult {
+  enabled: boolean;
+  variant?: string;
+  reason: EvaluationReason;
+  ruleId?: string;
+  experimentId?: string;
+}
+type EvaluationReason = 'FLAG_OFF' | 'FLAG_ON' | 'DEFAULT_VALUE' | 'RULE_MATCH' | 'PERCENTAGE_ROLLOUT' | 'EXPERIMENT_VARIANT' | 'FLAG_NOT_FOUND';
+type RuleOperator = 'EQ' | 'NEQ' | 'IN' | 'NIN' | 'CONTAINS' | 'NOT_CONTAINS' | 'GT' | 'GTE' | 'LT' | 'LTE' | 'PERCENTAGE';
+/**
+ * Simple hash function for consistent bucketing.
+ * Uses a deterministic algorithm so the same input always produces the same bucket.
+ */
+declare function hashToBucket(value: string, seed?: string): number;
+/**
+ * Get subject identifier from context for consistent hashing.
+ */
+declare function getSubjectId(context: EvaluationContext): string;
+/**
+ * Evaluate a single targeting rule condition.
+ */
+declare function evaluateRuleCondition(rule: TargetingRule, context: EvaluationContext): boolean;
+interface FlagRepository {
+  getFlag(key: string, orgId?: string): Promise<FeatureFlag | null>;
+  getRules(flagId: string): Promise<TargetingRule[]>;
+  getActiveExperiment(flagId: string): Promise<Experiment | null>;
+  getExperimentAssignment(experimentId: string, subjectType: string, subjectId: string): Promise<string | null>;
+  saveExperimentAssignment(experimentId: string, subjectType: string, subjectId: string, variant: string, bucket: number): Promise<void>;
+}
+interface EvaluationLogger {
+  log(evaluation: {
+    flagId: string;
+    flagKey: string;
+    subjectType: string;
+    subjectId: string;
+    result: boolean;
+    variant?: string;
+    reason: string;
+    ruleId?: string;
+    experimentId?: string;
+    context?: EvaluationContext;
+  }): void;
+}
+interface FlagEvaluatorOptions {
+  repository: FlagRepository;
+  logger?: EvaluationLogger;
+  /** Whether to log evaluations (default: false for performance) */
+  logEvaluations?: boolean;
+}
+/**
+ * Feature flag evaluator.
+ *
+ * Evaluates flags based on:
+ * 1. Flag status (OFF/ON/GRADUAL)
+ * 2. Targeting rules (in priority order)
+ * 3. Experiments (if running)
+ * 4. Default value (fallback)
+ */
+declare class FlagEvaluator {
+  private repository;
+  private logger?;
+  private logEvaluations;
+  constructor(options: FlagEvaluatorOptions);
+  /**
+   * Evaluate a feature flag.
+   */
+  evaluate(key: string, context: EvaluationContext): Promise<EvaluationResult>;
+  /**
+   * Evaluate experiment and assign variant.
+   */
+  private evaluateExperiment;
+  /**
+   * Assign a variant based on bucket and variant percentages.
+   */
+  private assignVariant;
+  /**
+   * Create evaluation result.
+   */
+  private makeResult;
+  /**
+   * Log evaluation and return result.
+   */
+  private logAndReturn;
+}
+/**
+ * In-memory flag repository for testing and development.
+ */
+declare class InMemoryFlagRepository implements FlagRepository {
+  private flags;
+  private rules;
+  private experiments;
+  private assignments;
+  addFlag(flag: FeatureFlag): void;
+  addRule(flagId: string, rule: TargetingRule): void;
+  addExperiment(experiment: Experiment, flagId: string): void;
+  getFlag(key: string): Promise<FeatureFlag | null>;
+  getRules(flagId: string): Promise<TargetingRule[]>;
+  getActiveExperiment(flagId: string): Promise<Experiment | null>;
+  getExperimentAssignment(experimentId: string, subjectType: string, subjectId: string): Promise<string | null>;
+  saveExperimentAssignment(experimentId: string, subjectType: string, subjectId: string, variant: string): Promise<void>;
+  clear(): void;
+}
+//#endregion
+export { EvaluationContext, EvaluationLogger, EvaluationReason, EvaluationResult, Experiment, ExperimentVariant, FeatureFlag, FlagEvaluator, FlagEvaluatorOptions, FlagRepository, InMemoryFlagRepository, RuleOperator, TargetingRule, VariantConfig, evaluateRuleCondition, getSubjectId, hashToBucket };

package/dist/evaluation/index.js

@@ -0,0 +1 @@
+function e(e,t=``){let n=`${t}:${e}`,r=0;for(let e=0;e<n.length;e++){let t=n.charCodeAt(e);r=(r<<5)-r+t,r&=r}return Math.abs(r%100)}function t(e){return e.userId||e.sessionId||e.orgId||`anonymous`}function n(n,i){let a=r(n.attribute,i);switch(n.operator){case`EQ`:return a===n.value;case`NEQ`:return a!==n.value;case`IN`:return Array.isArray(n.value)?n.value.includes(a):!1;case`NIN`:return Array.isArray(n.value)?!n.value.includes(a):!0;case`CONTAINS`:return typeof a!=`string`||typeof n.value!=`string`?!1:a.includes(n.value);case`NOT_CONTAINS`:return typeof a!=`string`||typeof n.value!=`string`?!0:!a.includes(n.value);case`GT`:return typeof a!=`number`||typeof n.value!=`number`?!1:a>n.value;case`GTE`:return typeof a!=`number`||typeof n.value!=`number`?!1:a>=n.value;case`LT`:return typeof a!=`number`||typeof n.value!=`number`?!1:a<n.value;case`LTE`:return typeof a!=`number`||typeof n.value!=`number`?!1:a<=n.value;case`PERCENTAGE`:return e(t(i),n.attribute)<(typeof n.value==`number`?n.value:0);default:return!1}}function r(e,t){switch(e){case`userId`:return t.userId;case`orgId`:return t.orgId;case`plan`:return t.plan;case`segment`:return t.segment;case`sessionId`:return t.sessionId;default:return t.attributes?.[e]}}var i=class{repository;logger;logEvaluations;constructor(e){this.repository=e.repository,this.logger=e.logger,this.logEvaluations=e.logEvaluations??!1}async evaluate(r,i){let a=i.orgId,o=await this.repository.getFlag(r,a);if(!o)return this.makeResult(!1,`FLAG_NOT_FOUND`);if(o.status===`OFF`)return this.logAndReturn(o,i,this.makeResult(!1,`FLAG_OFF`));if(o.status===`ON`)return this.logAndReturn(o,i,this.makeResult(!0,`FLAG_ON`));let s=[...await this.repository.getRules(o.id)].filter(e=>e.enabled).sort((e,t)=>e.priority-t.priority);for(let r of s)if(n(r,i)){if(r.rolloutPercentage!==void 0&&r.rolloutPercentage!==null&&e(t(i),o.key)>=r.rolloutPercentage)continue;let n=r.serveValue??!0;return this.logAndReturn(o,i,this.makeResult(n,`RULE_MATCH`,r.serveVariant,r.id))}let c=await this.repository.getActiveExperiment(o.id);if(c&&c.status===`RUNNING`){let e=await this.evaluateExperiment(c,i);if(e)return this.logAndReturn(o,i,e)}return this.logAndReturn(o,i,this.makeResult(o.defaultValue,`DEFAULT_VALUE`))}async evaluateExperiment(n,r){let i=t(r),a=r.userId?`user`:r.orgId?`org`:`session`;if(e(i,`${n.key}:audience`)>=n.audiencePercentage)return null;let o=await this.repository.getExperimentAssignment(n.id,a,i);if(!o){let t=e(i,n.key);o=this.assignVariant(n.variants,t),await this.repository.saveExperimentAssignment(n.id,a,i,o,t)}let s=o!==`control`;return this.makeResult(s,`EXPERIMENT_VARIANT`,o,void 0,n.id)}assignVariant(e,t){let n=0;for(let r of e)if(n+=r.percentage,t<n)return r.key;return e[e.length-1]?.key??`control`}makeResult(e,t,n,r,i){return{enabled:e,variant:n,reason:t,ruleId:r,experimentId:i}}logAndReturn(e,n,r){if(this.logEvaluations&&this.logger){let i=t(n),a=n.userId?`user`:n.orgId?`org`:`session`;this.logger.log({flagId:e.id,flagKey:e.key,subjectType:a,subjectId:i,result:r.enabled,variant:r.variant,reason:r.reason,ruleId:r.ruleId,experimentId:r.experimentId,context:n})}return r}},a=class{flags=new Map;rules=new Map;experiments=new Map;assignments=new Map;addFlag(e){this.flags.set(e.key,e)}addRule(e,t){let n=this.rules.get(e)||[];n.push(t),this.rules.set(e,n)}addExperiment(e,t){this.experiments.set(t,e)}async getFlag(e){return this.flags.get(e)||null}async getRules(e){return this.rules.get(e)||[]}async getActiveExperiment(e){return this.experiments.get(e)||null}async getExperimentAssignment(e,t,n){let r=`${e}:${t}:${n}`;return this.assignments.get(r)||null}async saveExperimentAssignment(e,t,n,r){let i=`${e}:${t}:${n}`;this.assignments.set(i,r)}clear(){this.flags.clear(),this.rules.clear(),this.experiments.clear(),this.assignments.clear()}};export{i as FlagEvaluator,a as InMemoryFlagRepository,n as evaluateRuleCondition,t as getSubjectId,e as hashToBucket};