@lssm/lib.feature-flags 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/docs/feature-flags.docblock.js

@@ -1,4 +1,20 @@
-import{a as e}from"../contracts/dist/docs/registry.js";import"../contracts/dist/docs/index.js";e([{id:`docs.feature-flags.overview`,title:`Feature Flags & Experiments`,summary:`Reusable, spec-first feature flag and experiment module with targeting, gradual rollout, multivariate variants, and evaluation logging.`,kind:`reference`,visibility:`public`,route:`/docs/feature-flags/overview`,tags:[`feature-flags`,`experiments`,`progressive-delivery`],body:`## What this module provides
+import { registerDocBlocks } from "../contracts/dist/docs/registry.js";
+import "../contracts/dist/docs/index.js";
+
+//#region src/docs/feature-flags.docblock.ts
+registerDocBlocks([{
+	id: "docs.feature-flags.overview",
+	title: "Feature Flags & Experiments",
+	summary: "Reusable, spec-first feature flag and experiment module with targeting, gradual rollout, multivariate variants, and evaluation logging.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/feature-flags/overview",
+	tags: [
+		"feature-flags",
+		"experiments",
+		"progressive-delivery"
+	],
+	body: `## What this module provides
 
 - **Entities**: FeatureFlag, FlagTargetingRule, Experiment, ExperimentAssignment, FlagEvaluation.
 - **Contracts**: create/update/delete/toggle/list/get flags; create/delete rules; evaluate flags; create/start/stop/get experiments.
@@ -54,4 +70,7 @@ if (result.enabled) {
 - Ensure experiments’ variant percentages sum to 100; default flag status to OFF.
 - Use org-scoped flags for multi-tenant isolation.
 - Log evaluations only when needed to control volume; prefer sampling for noisy paths.
-`}]);
+`
+}]);
+
+//#endregion

package/dist/docs/index.js

@@ -1 +1 @@
-import"./feature-flags.docblock.js";
+import "./feature-flags.docblock.js";

package/dist/entities/index.d.ts

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