@contractspec/lib.feature-flags 1.56.1 → 1.58.0

package/dist/contracts/src/versioning/refs.d.ts

@@ -1,47 +0,0 @@
-//#region ../contracts/src/versioning/refs.d.ts
-/**
- * Base reference types for ContractSpec versioning.
- *
- * Provides canonical reference types for linking between specs.
- * Domain-specific refs (OpRef, EventRef, etc.) should alias these
- * base types for consistency and maintainability.
- *
- * @module versioning/refs
- */
-/**
- * Base reference type for versioned specs.
- * Used to reference any spec by its key and version.
- *
- * @example
- * ```typescript
- * const opRef: VersionedSpecRef = { key: 'auth.login', version: '1.0.0' };
- * ```
- */
-interface VersionedSpecRef {
-  /** Unique key identifying the spec (e.g., "auth.login", "user.created"). */
-  key: string;
-  /** Semantic version of the spec (e.g., "1.0.0", "2.1.0"). */
-  version: string;
-}
-/**
- * Base reference type for specs with optional version.
- * When version is omitted, typically refers to the latest version.
- *
- * @example
- * ```typescript
- * // Reference to latest version
- * const latestRef: OptionalVersionedSpecRef = { key: 'auth.login' };
- *
- * // Reference to specific version
- * const specificRef: OptionalVersionedSpecRef = { key: 'auth.login', version: '1.0.0' };
- * ```
- */
-interface OptionalVersionedSpecRef {
-  /** Unique key identifying the spec. */
-  key: string;
-  /** Optional semantic version. When omitted, refers to the latest version. */
-  version?: string;
-}
-//#endregion
-export { OptionalVersionedSpecRef, VersionedSpecRef };
-//# sourceMappingURL=refs.d.ts.map

package/dist/contracts/src/versioning/refs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"refs.d.ts","names":[],"sources":["../../../../../contracts/src/versioning/refs.ts"],"sourcesContent":[],"mappings":";;AAuBA;AAoBA;;;;;;;;;;;;;;;;UApBiB,gBAAA;;;;;;;;;;;;;;;;;;;UAoBA,wBAAA"}

package/dist/contracts/src/workflow/adapters/db-adapter.d.ts

@@ -1 +0,0 @@
-import "../state.js";

package/dist/contracts/src/workflow/adapters/file-adapter.d.ts

@@ -1 +0,0 @@
-import "../state.js";

package/dist/contracts/src/workflow/adapters/index.d.ts

@@ -1,3 +0,0 @@
-import "./memory-store.js";
-import "./db-adapter.js";
-import "./file-adapter.js";

package/dist/contracts/src/workflow/adapters/memory-store.d.ts

@@ -1 +0,0 @@
-import "../state.js";

package/dist/contracts/src/workflow/context.d.ts

@@ -1,2 +0,0 @@
-import "./spec.js";
-import "./state.js";

package/dist/contracts/src/workflow/index.d.ts

@@ -1,8 +0,0 @@
-import { FormRef } from "../features/types.js";
-import "./spec.js";
-import "./validation.js";
-import "./state.js";
-import "./runner.js";
-import "./adapters/index.js";
-import "./context.js";
-import "./sla-monitor.js";

package/dist/contracts/src/workflow/overview.docblock.d.ts

@@ -1 +0,0 @@
-import "../docs/index.js";

package/dist/contracts/src/workflow/runner.d.ts

@@ -1,5 +0,0 @@
-import "../features/index.js";
-import "./spec.js";
-import "../app-config/runtime.js";
-import "../types.js";
-import "./state.js";

package/dist/contracts/src/workflow/sla-monitor.d.ts

@@ -1,2 +0,0 @@
-import "./spec.js";
-import "./state.js";

package/dist/contracts/src/workflow/spec.d.ts

@@ -1,6 +0,0 @@
-import "../registry.js";
-import "../capabilities/index.js";
-import "../experiments/spec.js";
-import { FormRef } from "../features/types.js";
-import "../features/index.js";
-import "../ownership.js";

package/dist/contracts/src/workflow/state.d.ts

@@ -1 +0,0 @@
-import "./spec.js";

package/dist/contracts/src/workflow/validation.d.ts

@@ -1,5 +0,0 @@
-import "../capabilities/capabilities.js";
-import "./spec.js";
-import "../operations/registry.js";
-import "../forms/index.js";
-import "../events.js";

package/dist/contracts/src/workspace-config/contractsrc-schema.d.ts

@@ -1 +0,0 @@
-import "zod";

package/dist/contracts/src/workspace-config/index.d.ts

@@ -1 +0,0 @@
-import "./contractsrc-schema.js";

package/dist/contracts/src/workspace-config/workspace-config.docblock.d.ts

@@ -1 +0,0 @@
-import "../docs/index.js";

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

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flags.docblock.js","names":[],"sources":["../../src/docs/feature-flags.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst featureFlagsDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.feature-flags.overview',\n    title: 'Feature Flags & Experiments',\n    summary:\n      'Reusable, spec-first feature flag and experiment module with targeting, gradual rollout, multivariate variants, and evaluation logging.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/feature-flags/overview',\n    tags: ['feature-flags', 'experiments', 'progressive-delivery'],\n    body: `## What this module provides\n\n- **Entities**: FeatureFlag, FlagTargetingRule, Experiment, ExperimentAssignment, FlagEvaluation.\n- **Contracts**: create/update/delete/toggle/list/get flags; create/delete rules; evaluate flags; create/start/stop/get experiments.\n- **Events**: flag.created/updated/deleted/toggled, rule.created/deleted, experiment.created/started/stopped, flag.evaluated, experiment.variant_assigned.\n- **Evaluation Engine**: Deterministic evaluator with gradual rollout, rule priority, audience filters, and experiment bucketing.\n\n## How to use\n\n1) Compose schema\n - Add \\`featureFlagsSchemaContribution\\` to your module composition.\n\n2) Register contracts/events\n - Import exports from \\`@contractspec/lib.feature-flags\\` into your spec registry.\n\n3) Evaluate at runtime\n - Instantiate \\`FlagEvaluator\\` with a repository implementation and optional logger.\n - Evaluate with context attributes (userId, orgId, plan, segment, sessionId, attributes).\n\n4) Wire observability\n - Emit audit trail on config changes; emit \\`flag.evaluated\\` for analytics.\n\n## Usage example\n\n${'```'}ts\nimport {\n  FlagEvaluator,\n  InMemoryFlagRepository,\n} from '@contractspec/lib.feature-flags';\n\nconst repo = new InMemoryFlagRepository();\nrepo.addFlag({\n  id: 'flag-1',\n  key: 'new_dashboard',\n  status: 'GRADUAL',\n  defaultValue: false,\n});\n\nconst evaluator = new FlagEvaluator({ repository: repo });\nconst result = await evaluator.evaluate('new_dashboard', {\n  userId: 'user-123',\n  orgId: 'org-456',\n  plan: 'pro',\n});\n\nif (result.enabled) {\n  // serve the new dashboard\n}\n${'```'},\n\n## Guardrails\n\n- Keep flag keys stable and human-readable; avoid PII in context.\n- Ensure experiments’ variant percentages sum to 100; default flag status to OFF.\n- Use org-scoped flags for multi-tenant isolation.\n- Log evaluations only when needed to control volume; prefer sampling for noisy paths.\n`,\n  },\n];\n\nregisterDocBlocks(featureFlagsDocBlocks);\n"],"mappings":";;;AAyEA,kBAtE0C,CACxC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAiB;EAAe;EAAuB;CAC9D,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDP,CACF,CAEuC"}

package/dist/entities/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/entities/index.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\nimport type { ModuleSchemaContribution } from '@contractspec/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: '@contractspec/lib.feature-flags',\n  entities: featureFlagEntities,\n  enums: [FlagStatusEnum, RuleOperatorEnum, ExperimentStatusEnum],\n};\n"],"mappings":"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"}

package/dist/evaluation/index.js.map

@@ -1 +0,0 @@
-{"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      return (\n        hashToBucket(getSubjectId(context), rule.attribute) <\n        (typeof rule.value === 'number' ? rule.value : 0)\n      );\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.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport { defineEvent } from '@contractspec/lib.contracts';\n\n// ============ Event Payloads ============\n\nconst FlagCreatedPayload = defineSchemaModel({\n  name: 'FlagCreatedEventPayload',\n  description: 'Payload when a feature flag is created',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagUpdatedPayload = defineSchemaModel({\n  name: 'FlagUpdatedEventPayload',\n  description: 'Payload when a feature flag is updated',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    changes: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    updatedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagDeletedPayload = defineSchemaModel({\n  name: 'FlagDeletedEventPayload',\n  description: 'Payload when a feature flag is deleted',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    deletedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    deletedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagToggledPayload = defineSchemaModel({\n  name: 'FlagToggledEventPayload',\n  description: 'Payload when a feature flag status is toggled',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    previousStatus: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    toggledBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    toggledAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst RuleCreatedPayload = defineSchemaModel({\n  name: 'RuleCreatedEventPayload',\n  description: 'Payload when a targeting rule is created',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    attribute: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    operator: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst RuleDeletedPayload = defineSchemaModel({\n  name: 'RuleDeletedEventPayload',\n  description: 'Payload when a targeting rule is deleted',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    deletedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst ExperimentCreatedPayload = defineSchemaModel({\n  name: 'ExperimentCreatedEventPayload',\n  description: 'Payload when an experiment is created',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst ExperimentStartedPayload = defineSchemaModel({\n  name: 'ExperimentStartedEventPayload',\n  description: 'Payload when an experiment starts',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    audiencePercentage: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n    startedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst ExperimentStoppedPayload = defineSchemaModel({\n  name: 'ExperimentStoppedEventPayload',\n  description: 'Payload when an experiment stops',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    winningVariant: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    stoppedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    stoppedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst FlagEvaluatedPayload = defineSchemaModel({\n  name: 'FlagEvaluatedEventPayload',\n  description: 'Payload when a flag is evaluated (for analytics)',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    subjectType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    subjectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    result: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    variant: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    evaluatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst VariantAssignedPayload = defineSchemaModel({\n  name: 'VariantAssignedEventPayload',\n  description: 'Payload when a subject is assigned to an experiment variant',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    experimentKey: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    subjectType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    subjectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variant: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    bucket: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    assignedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n// ============ Events ============\n\n/**\n * Emitted when a feature flag is created.\n */\nexport const FlagCreatedEvent = defineEvent({\n  meta: {\n    key: 'flag.created',\n    version: '1.0.0',\n    description: 'A feature flag has been created.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'create'],\n  },\n  payload: FlagCreatedPayload,\n});\n\n/**\n * Emitted when a feature flag is updated.\n */\nexport const FlagUpdatedEvent = defineEvent({\n  meta: {\n    key: 'flag.updated',\n    version: '1.0.0',\n    description: 'A feature flag has been updated.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'update'],\n  },\n  payload: FlagUpdatedPayload,\n});\n\n/**\n * Emitted when a feature flag is deleted.\n */\nexport const FlagDeletedEvent = defineEvent({\n  meta: {\n    key: 'flag.deleted',\n    version: '1.0.0',\n    description: 'A feature flag has been deleted.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'delete'],\n  },\n  payload: FlagDeletedPayload,\n});\n\n/**\n * Emitted when a feature flag status is toggled.\n */\nexport const FlagToggledEvent = defineEvent({\n  meta: {\n    key: 'flag.toggled',\n    version: '1.0.0',\n    description: 'A feature flag status has been toggled.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'toggle'],\n  },\n  payload: FlagToggledPayload,\n});\n\n/**\n * Emitted when a targeting rule is created.\n */\nexport const RuleCreatedEvent = defineEvent({\n  meta: {\n    key: 'flag.rule_created',\n    version: '1.0.0',\n    description: 'A targeting rule has been created.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'rule', 'create'],\n  },\n  payload: RuleCreatedPayload,\n});\n\n/**\n * Emitted when a targeting rule is deleted.\n */\nexport const RuleDeletedEvent = defineEvent({\n  meta: {\n    key: 'flag.rule_deleted',\n    version: '1.0.0',\n    description: 'A targeting rule has been deleted.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'rule', 'delete'],\n  },\n  payload: RuleDeletedPayload,\n});\n\n/**\n * Emitted when an experiment is created.\n */\nexport const ExperimentCreatedEvent = defineEvent({\n  meta: {\n    key: 'experiment.created',\n    version: '1.0.0',\n    description: 'An experiment has been created.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'create'],\n  },\n  payload: ExperimentCreatedPayload,\n});\n\n/**\n * Emitted when an experiment starts.\n */\nexport const ExperimentStartedEvent = defineEvent({\n  meta: {\n    key: 'experiment.started',\n    version: '1.0.0',\n    description: 'An experiment has started.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'start'],\n  },\n  payload: ExperimentStartedPayload,\n});\n\n/**\n * Emitted when an experiment stops.\n */\nexport const ExperimentStoppedEvent = defineEvent({\n  meta: {\n    key: 'experiment.stopped',\n    version: '1.0.0',\n    description: 'An experiment has stopped.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'stop'],\n  },\n  payload: ExperimentStoppedPayload,\n});\n\n/**\n * Emitted when a flag is evaluated (for analytics).\n */\nexport const FlagEvaluatedEvent = defineEvent({\n  meta: {\n    key: 'flag.evaluated',\n    version: '1.0.0',\n    description: 'A feature flag has been evaluated.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'evaluate'],\n  },\n  payload: FlagEvaluatedPayload,\n});\n\n/**\n * Emitted when a subject is assigned to an experiment variant.\n */\nexport const VariantAssignedEvent = defineEvent({\n  meta: {\n    key: 'experiment.variant_assigned',\n    version: '1.0.0',\n    description: 'A subject has been assigned to an experiment variant.',\n    stability: 'stable',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiment', 'variant'],\n  },\n  payload: VariantAssignedPayload,\n});\n\n/**\n * All feature flag events.\n */\nexport const FeatureFlagEvents = {\n  FlagCreatedEvent,\n  FlagUpdatedEvent,\n  FlagDeletedEvent,\n  FlagToggledEvent,\n  RuleCreatedEvent,\n  RuleDeletedEvent,\n  ExperimentCreatedEvent,\n  ExperimentStartedEvent,\n  ExperimentStoppedEvent,\n  FlagEvaluatedEvent,\n  VariantAssignedEvent,\n};\n"],"mappings":"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"}

package/dist/feature-flags.capability.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flags.capability.js","names":[],"sources":["../src/feature-flags.capability.ts"],"sourcesContent":["import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';\n\nexport const FeatureFlagsCapability = defineCapability({\n  meta: {\n    key: 'feature-flag',\n    version: '1.0.0',\n    kind: 'api',\n    stability: StabilityEnum.Experimental,\n    description: 'Feature flag management and evaluation',\n    owners: ['@platform.featureflags'],\n    tags: ['feature-flags', 'configuration'],\n  },\n});\n\nexport const ExperimentsCapability = defineCapability({\n  meta: {\n    key: 'experiments',\n    version: '1.0.0',\n    kind: 'api',\n    stability: StabilityEnum.Experimental,\n    description: 'A/B testing and experimentation platform',\n    owners: ['@platform.featureflags'],\n    tags: ['experiments', 'ab-testing'],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,yBAAyB,iBAAiB,EACrD,MAAM;CACJ,KAAK;CACL,SAAS;CACT,MAAM;CACN,WAAW,cAAc;CACzB,aAAa;CACb,QAAQ,CAAC,yBAAyB;CAClC,MAAM,CAAC,iBAAiB,gBAAgB;CACzC,EACF,CAAC;AAEF,MAAa,wBAAwB,iBAAiB,EACpD,MAAM;CACJ,KAAK;CACL,SAAS;CACT,MAAM;CACN,WAAW,cAAc;CACzB,aAAa;CACb,QAAQ,CAAC,yBAAyB;CAClC,MAAM,CAAC,eAAe,aAAa;CACpC,EACF,CAAC"}

package/dist/feature-flags.feature.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flags.feature.js","names":[],"sources":["../src/feature-flags.feature.ts"],"sourcesContent":["/**\n * Feature Flags Feature Module Specification\n *\n * Defines the feature module for feature flag and experiment management.\n */\nimport { defineFeature } from '@contractspec/lib.contracts';\n\n/**\n * Feature Flags feature module that bundles flag management,\n * targeting rules, and A/B experiment capabilities.\n */\nexport const FeatureFlagsFeature = defineFeature({\n  meta: {\n    key: 'feature-flags',\n    version: '1.0.0',\n    title: 'Feature Flags',\n    description:\n      'Feature flag management with targeting rules and A/B experiments',\n    domain: 'platform',\n    owners: ['@platform.feature-flags'],\n    tags: ['feature-flags', 'experiments', 'targeting'],\n    stability: 'stable',\n  },\n\n  // All contract operations included in this feature\n  operations: [\n    // Flag CRUD operations\n    { key: 'flag.create', version: '1.0.0' },\n    { key: 'flag.update', version: '1.0.0' },\n    { key: 'flag.delete', version: '1.0.0' },\n    { key: 'flag.toggle', version: '1.0.0' },\n    { key: 'flag.get', version: '1.0.0' },\n    { key: 'flag.list', version: '1.0.0' },\n    { key: 'flag.evaluate', version: '1.0.0' },\n\n    // Targeting rule operations\n    { key: 'flag.rule.create', version: '1.0.0' },\n    { key: 'flag.rule.delete', version: '1.0.0' },\n\n    // Experiment operations\n    { key: 'experiment.create', version: '1.0.0' },\n    { key: 'experiment.start', version: '1.0.0' },\n    { key: 'experiment.stop', version: '1.0.0' },\n    { key: 'experiment.get', version: '1.0.0' },\n  ],\n\n  // Events emitted by this feature\n  events: [\n    // Flag events\n    { key: 'flag.created', version: '1.0.0' },\n    { key: 'flag.updated', version: '1.0.0' },\n    { key: 'flag.deleted', version: '1.0.0' },\n    { key: 'flag.toggled', version: '1.0.0' },\n    { key: 'flag.evaluated', version: '1.0.0' },\n\n    // Rule events\n    { key: 'flag.rule_created', version: '1.0.0' },\n    { key: 'flag.rule_deleted', version: '1.0.0' },\n\n    // Experiment events\n    { key: 'experiment.created', version: '1.0.0' },\n    { key: 'experiment.started', version: '1.0.0' },\n    { key: 'experiment.stopped', version: '1.0.0' },\n    { key: 'experiment.variant_assigned', version: '1.0.0' },\n  ],\n\n  // No presentations for this library feature\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n\n  // Capability definitions\n  capabilities: {\n    provides: [\n      { key: 'feature-flag', version: '1.0.0' },\n      { key: 'experiments', version: '1.0.0' },\n    ],\n    requires: [{ key: 'identity', version: '1.0.0' }],\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,sBAAsB,cAAc;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,0BAA0B;EACnC,MAAM;GAAC;GAAiB;GAAe;GAAY;EACnD,WAAW;EACZ;CAGD,YAAY;EAEV;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAa,SAAS;GAAS;EACtC;GAAE,KAAK;GAAiB,SAAS;GAAS;EAG1C;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC7C;GAAE,KAAK;GAAoB,SAAS;GAAS;EAG7C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC9C;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC7C;GAAE,KAAK;GAAmB,SAAS;GAAS;EAC5C;GAAE,KAAK;GAAkB,SAAS;GAAS;EAC5C;CAGD,QAAQ;EAEN;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAkB,SAAS;GAAS;EAG3C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC9C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAG9C;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAA+B,SAAS;GAAS;EACzD;CAGD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CAGxB,cAAc;EACZ,UAAU,CACR;GAAE,KAAK;GAAgB,SAAS;GAAS,EACzC;GAAE,KAAK;GAAe,SAAS;GAAS,CACzC;EACD,UAAU,CAAC;GAAE,KAAK;GAAY,SAAS;GAAS,CAAC;EAClD;CACF,CAAC"}

package/dist/schema/src/EnumType.d.ts

@@ -1,36 +0,0 @@
-import * as z from "zod";
-import { GraphQLEnumType } from "graphql";
-
-//#region ../schema/src/EnumType.d.ts
-
-/**
- * Strongly-typed string enum wrapper with one source of truth for zod, GraphQL, and JSON Schema.
- */
-declare class EnumType<T extends [string, ...string[]]> {
-  private readonly name;
-  private readonly values;
-  private readonly gqlEnum;
-  constructor(name: string, values: T);
-  /** Enum type name (used by GraphQL and JSON Schema). */
-  getName(): string;
-  /** Returns the literal tuple of allowed values. */
-  getEnumValues(): T;
-  /** GraphQL enum instance suitable for Pothos or vanilla GraphQL schemas. */
-  getPothos(): GraphQLEnumType;
-  /** zod schema representing this enum. */
-  getZod(): z.ZodEnum<{ [K in T[number]]: K }>;
-  /** Minimal JSON representation (alias of getJsonSchema). */
-  getJson(): {
-    type: 'string';
-    enum: T;
-  };
-  /** JSON Schema for this enum. */
-  getJsonSchema(): {
-    type: 'string';
-    enum: T;
-  };
-}
-type AnyEnumType = EnumType<[string, ...string[]]>;
-//#endregion
-export { AnyEnumType, EnumType };
-//# sourceMappingURL=EnumType.d.ts.map

package/dist/schema/src/EnumType.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EnumType.d.ts","names":[],"sources":["../../../../schema/src/EnumType.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAKoC,cALvB,QAKuB,CAAA,UAAA,CAAA,MAAA,EAAA,GAAA,MAAA,EAAA,CAAA,CAAA,CAAA;EAejB,iBAAA,IAAA;EAMJ,iBAAA,MAAA;EAKe,iBAAA,OAAA;EAAY,WAAA,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EA1BN,CA0BM;EAA5B;EAKuB,OAAA,CAAA,CAAA,EAAA,MAAA;EAKM;EAAC,aAAA,CAAA,CAAA,EArBzB,CAqByB;EAKhC;eApBG;;YAKH,CAAA,CAAE,gBAAgB,YAAY;;;;UAKL;;;;;UAKM;;;KAK/B,WAAA,GAAc"}

package/dist/schema/src/FieldType.d.ts

@@ -1,30 +0,0 @@
-import * as z from "zod";
-import { GraphQLScalarType, GraphQLScalarTypeConfig } from "graphql";
-
-//#region ../schema/src/FieldType.d.ts
-interface FieldTypeConfig<TInternal, TExternal = TInternal> extends GraphQLScalarTypeConfig<TInternal, TExternal> {
-  zod: z.ZodType<TInternal>;
-  jsonSchema: unknown | (() => unknown);
-}
-type AnyFieldType = FieldType<any, any>;
-/**
- * GraphQL scalar wrapper that carries zod and JSON Schema metadata.
- *
- * TInternal is the runtime representation; TExternal is the GraphQL output.
- */
-declare class FieldType<TInternal, TExternal = TInternal> extends GraphQLScalarType<TInternal, TExternal> {
-  private zodSchema;
-  private readonly jsonSchemaDef?;
-  constructor(config: FieldTypeConfig<TInternal, TExternal>);
-  /** Return the attached zod schema for validation. */
-  getZod(): z.ZodType<TInternal>;
-  /** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
-  getPothos(): GraphQLScalarType<TInternal, TExternal>;
-  /** Return the JSON Schema (evaluates factory if provided). */
-  getJson(): unknown;
-  getJsonSchemaDef(): unknown | (() => unknown);
-  getJsonSchema(): unknown;
-}
-//#endregion
-export { AnyFieldType, FieldType, FieldTypeConfig };
-//# sourceMappingURL=FieldType.d.ts.map

package/dist/schema/src/FieldType.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FieldType.d.ts","names":[],"sources":["../../../../schema/src/FieldType.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uCAEH,mBACJ,wBAAwB,WAAW;OACtC,CAAA,CAAE,QAAQ;EAJA,UAAA,EAAA,OAAe,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;;AAGE,KAMtB,YAAA,GAAe,SANO,CAAA,GAAA,EAAA,GAAA,CAAA;;;;;;AAMtB,cAOC,SAPW,CAAA,SAAG,EAAS,YAStB,SATsB,CAAA,SAU1B,iBAV0B,CAUR,SAVQ,EAUG,SAVH,CAAA,CAAA;EAOvB,QAAA,SAAS;EAER,iBAAA,aAAA;EACc,WAAA,CAAA,MAAA,EAIN,eAJM,CAIU,SAJV,EAIqB,SAJrB,CAAA;EAAW;EAID,MAAA,CAAA,CAAA,EAO1B,CAAA,CAAE,OAPwB,CAOhB,SAPgB,CAAA;EAAW;EAA3B,SAAA,CAAA,CAAA,EAYP,iBAZO,CAYW,SAZX,EAYsB,SAZtB,CAAA;EAOA;EAAR,OAAA,CAAA,CAAA,EAAA,OAAA;EAKmB,gBAAA,CAAA,CAAA,EAAA,OAAA,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;EAAW,aAAA,CAAA,CAAA,EAAA,OAAA"}

package/dist/schema/src/GraphQLSchemaType.d.ts

@@ -1,2 +0,0 @@
-import "./SchemaModelType.js";
-import "zod";

package/dist/schema/src/JsonSchemaType.d.ts

@@ -1,2 +0,0 @@
-import "./SchemaModelType.js";
-import "zod";

package/dist/schema/src/ScalarTypeEnum.d.ts

@@ -1 +0,0 @@
-import "./FieldType.js";

package/dist/schema/src/SchemaModel.d.ts

@@ -1,70 +0,0 @@
-import { AnyFieldType } from "./FieldType.js";
-import { AnyEnumType } from "./EnumType.js";
-import { SchemaModelType } from "./SchemaModelType.js";
-import * as z from "zod";
-import { Maybe } from "graphql/jsutils/Maybe";
-
-//#region ../schema/src/SchemaModel.d.ts
-
-/**
- * All types that can be used as field types in a SchemaModel.
- * Supports FieldType, EnumType, nested SchemaModel, or any SchemaType implementation.
- */
-type FieldLike = AnyFieldType | AnyEnumType | AnySchemaModel | SchemaModelType;
-/** Field configuration for a SchemaModel property. */
-interface SchemaFieldConfig<Type extends FieldLike = FieldLike> {
-  type: Type;
-  isOptional: boolean;
-  /** When present and true, the field is an array */
-  isArray?: true;
-}
-type SchemaModelFieldsAnyConfig<Type extends FieldLike = FieldLike> = Record<string, SchemaFieldConfig<Type>>;
-/** Model definition: name and fields. */
-interface SchemaModelConfig<Fields extends SchemaModelFieldsAnyConfig> {
-  name: string;
-  description?: Maybe<string>;
-  fields: Fields;
-}
-/**
- * Named object model built from FieldType/EnumType/SchemaModel fields.
- * Provides zod and GraphQL input helpers, and supports arrays/optional fields.
- */
-declare class SchemaModel<Fields extends SchemaModelFieldsAnyConfig> implements SchemaModelType {
-  readonly config: SchemaModelConfig<Fields>;
-  constructor(config: SchemaModelConfig<Fields>);
-  /**
-   * Build a typed ZodObject from the model fields, preserving each field's
-   * Zod schema and optionality at the type level when possible.
-   */
-  getZod(): TopLevelZodFromModel<Fields>;
-  /** Input object name for GraphQL builder adapters. */
-  getPothosInput(): string;
-}
-/**
- * Union of all types that can serve as a schema model.
- * This is the main type expected by OperationSpec, EventSpec, FormSpec, etc.
- *
- * Supports:
- * - SchemaModel instances (native ContractSpec types)
- * - Any SchemaType implementation (ZodSchemaType, JsonSchemaType, etc.)
- */
-type AnySchemaModel = SchemaModel<SchemaModelFieldsAnyConfig> | SchemaModelType;
-type InferZodFromType<T> = T extends SchemaModel<SchemaModelFieldsAnyConfig> ? z.ZodObject<z.ZodRawShape> : T extends AnyFieldType ? ReturnType<T['getZod']> : T extends AnyEnumType ? ReturnType<T['getZod']> : T extends SchemaModelType ? ReturnType<T['getZod']> : z.ZodUnknown;
-type MaybeArray<Z extends z.ZodType, A> = A extends true ? z.ZodArray<Z> : Z;
-type MaybeOptional<Z extends z.ZodType, O> = O extends true ? z.ZodOptional<Z> : Z;
-/**
- * Helper type: derive the Zod shape from the field config.
- * Supports nested SchemaModel and arrays, preserving optionality and list-ness.
- */
-type FieldIsArray<FC> = FC extends {
-  isArray: true;
-} ? true : false;
-type ZodShapeFromFields<F extends SchemaModelFieldsAnyConfig> = { [K in keyof F]: MaybeOptional<MaybeArray<InferZodFromType<F[K]['type']>, FieldIsArray<F[K]>>, F[K]['isOptional']> };
-/**
- * The top-level Zod schema returned by getZod():
- * either ZodObject<...> or ZodArray<ZodObject<...>> when config.isArray.
- */
-type TopLevelZodFromModel<F extends SchemaModelFieldsAnyConfig> = z.ZodObject<ZodShapeFromFields<F>>;
-//#endregion
-export { AnySchemaModel, SchemaFieldConfig, SchemaModel, SchemaModelConfig, SchemaModelFieldsAnyConfig, TopLevelZodFromModel, ZodShapeFromFields };
-//# sourceMappingURL=SchemaModel.d.ts.map

package/dist/schema/src/SchemaModel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SchemaModel.d.ts","names":[],"sources":["../../../../schema/src/SchemaModel.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAImD;;KAM9C,SAAA,GAAY,YAAe,GAAA,WAAA,GAAc,cAAd,GAA+B,eAA/B;;AAA+B,UAG9C,iBAH8C,CAAA,aAGf,SAHe,GAGH,SAHG,CAAA,CAAA;EAAe,IAAA,EAItE,IAJsE;EAG7D,UAAA,EAAA,OAAA;EAA+B;EAAY,OAAA,CAAA,EAAA,IAAA;;AAChD,KAMA,0BANA,CAAA,aAMwC,SANxC,GAMoD,SANpD,CAAA,GAOV,MAPU,CAAA,MAAA,EAOK,iBAPL,CAOuB,IAPvB,CAAA,CAAA;AAMZ;AAAoD,UAInC,iBAJmC,CAAA,eAIF,0BAJE,CAAA,CAAA;EAAY,IAAA,EAAA,MAAA;EAC7B,WAAA,CAAA,EAKnB,KALmB,CAAA,MAAA,CAAA;EAAlB,MAAA,EAMP,MANO;;;AAGjB;;;AAGU,cAOG,WAPH,CAAA,eAQO,0BARP,CAAA,YASG,eATH,CAAA;EAAM,SAAA,MAAA,EAUsB,iBAVtB,CAUwC,MAVxC,CAAA;EAOH,WAAA,CAAA,MAAW,EAGc,iBAHd,CAGgC,MAHhC,CAAA;EACP;;;;EAEqB,MAAA,CAAA,CAAA,EAM1B,oBAN0B,CAML,MANK,CAAA;EAML;EAArB,cAAA,CAAA,CAAA,EAAA,MAAA;;;AA8BZ;;;;;AAkCE;;AAGsB,KArCZ,cAAA,GACR,WAoCoB,CApCR,0BAoCQ,CAAA,GAnCpB,eAmCoB;AAQA,KATnB,gBAWU,CAAA,CAAA,CAAA,GAVb,CAUa,SAVH,WAUG,CAVS,0BAUT,CAAA,GATT,CAAA,CAAE,SASO,CATG,CAAA,CAAE,WASL,CAAA,GART,CAQS,SARC,YAQD,GAPP,UAOO,CAPI,CAOJ,CAAA,QAAA,CAAA,CAAA,GANP,CAMO,SANG,WAMH,GALL,UAKK,CALM,CAKN,CAAA,QAAA,CAAA,CAAA,GAJL,CAIK,SAJK,eAIL,GAHH,UAGG,CAHQ,CAGR,CAAA,QAAA,CAAA,CAAA,GAFH,CAAA,CAAE,UAEC;KAAV,UAAuB,CAAA,UAAF,CAAA,CAAE,OAAA,EAAA,CAAA,CAAA,GAAc,CAAd,SAAA,IAAA,GAA+B,CAAA,CAAE,QAAjC,CAA0C,CAA1C,CAAA,GAA+C,CAA/C;KACvB,aADqC,CAAA,UACb,CAAA,CAAE,OADW,EAAA,CAAA,CAAA,GACG,CADH,SAAA,IAAA,GAEtC,CAAA,CAAE,WAFoC,CAExB,CAFwB,CAAA,GAGtC,CAHsC;;;;;AAAkC,KASvE,YARA,CAAA,EAAa,CAAA,GAQM,EARN,SAAA;EAAa,OAAA,EAAA,IAAA;CAAc,GAAA,IAAA,GAAA,KAAA;AAC3B,KASN,kBATM,CAAA,UASuB,0BATvB,CAAA,GAAA,QAAZ,MAUQ,CAVR,GAUY,aAVZ,CAWF,UAXE,CAWS,gBAXT,CAW0B,CAX1B,CAW4B,CAX5B,CAAA,CAAA,MAAA,CAAA,CAAA,EAWyC,YAXzC,CAWsD,CAXtD,CAWwD,CAXxD,CAAA,CAAA,CAAA,EAYF,CAZE,CAYA,CAZA,CAAA,CAAA,YAAA,CAAA,CAAA,EACF;;AAAC;AAQL;;AACc,KAUF,oBAVE,CAAA,UAU6B,0BAV7B,CAAA,GAWZ,CAAA,CAAE,SAXU,CAWA,kBAXA,CAWmB,CAXnB,CAAA,CAAA"}

package/dist/schema/src/SchemaModelType.d.ts

@@ -1,38 +0,0 @@
-import * as z from "zod";
-
-//#region ../schema/src/SchemaModelType.d.ts
-
-/**
- * Unified interface for all schema-compatible types.
- * Any type used in ContractSpec schemas must implement this interface.
- *
- * @template T - The TypeScript type this schema represents
- *
- * @example
- * ```typescript
- * // All of these implement SchemaType:
- * const fieldType = ScalarTypeEnum.String_unsecure();
- * const schemaModel = new SchemaModel({ name: 'User', fields: {...} });
- * const zodWrapper = fromZod(z.object({ name: z.string() }));
- * ```
- */
-interface SchemaModelType<T = unknown> {
-  /**
-   * Return the Zod schema for runtime validation.
-   * This is the primary method - all schema types must provide Zod conversion.
-   */
-  getZod(): z.ZodType<T>;
-  /**
-   * Return GraphQL type info for Pothos/GraphQL integration.
-   * Optional - types without GraphQL representation return undefined.
-   */
-  getPothos?(): unknown;
-  /**
-   * Return JSON Schema representation.
-   * Optional - types without JSON Schema representation return undefined.
-   */
-  getJsonSchema?(): unknown;
-}
-//#endregion
-export { SchemaModelType };
-//# sourceMappingURL=SchemaModelType.d.ts.map

package/dist/schema/src/SchemaModelType.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SchemaModelType.d.ts","names":[],"sources":["../../../../schema/src/SchemaModelType.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA8BiB;;;;;YAKL,CAAA,CAAE,QAAQ"}

package/dist/schema/src/ZodSchemaType.d.ts

@@ -1,2 +0,0 @@
-import "./SchemaModelType.js";
-import "zod";

package/dist/schema/src/entity/defineEntity.d.ts

@@ -1 +0,0 @@
-import "./types.js";

package/dist/schema/src/entity/generator.d.ts

@@ -1 +0,0 @@
-import "./types.js";

package/dist/schema/src/entity/index.d.ts

@@ -1,3 +0,0 @@
-import { EntityEnumDef, EntityEnumField, EntityField, EntityIndex, EntityRelationField, EntityScalarField, EntitySpec, ModuleSchemaContribution, PrismaFieldModifiers, PrismaScalarType, RelationType } from "./types.js";
-import "./defineEntity.js";
-import "./generator.js";