@contractspec/lib.feature-flags 1.57.0 → 1.58.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.feature-flags",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "description": "Feature flags and experiments module for ContractSpec applications",
   "keywords": [
     "contractspec",
@@ -14,36 +14,41 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src"
+    "lint:check": "eslint src",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "1.57.0",
-    "@contractspec/lib.contracts": "1.57.0",
+    "@contractspec/lib.schema": "1.58.0",
+    "@contractspec/lib.contracts": "1.58.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "1.57.0",
-    "@contractspec/tool.tsdown": "1.57.0",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "exports": {
-    ".": "./dist/index.js",
-    "./contracts": "./dist/contracts/index.js",
-    "./docs": "./dist/docs/index.js",
-    "./docs/feature-flags.docblock": "./dist/docs/feature-flags.docblock.js",
-    "./entities": "./dist/entities/index.js",
-    "./evaluation": "./dist/evaluation/index.js",
-    "./events": "./dist/events.js",
-    "./feature-flags.capability": "./dist/feature-flags.capability.js",
-    "./feature-flags.feature": "./dist/feature-flags.feature.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./contracts": "./src/contracts/index.ts",
+    "./contracts/index": "./src/contracts/index.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/feature-flags.docblock": "./src/docs/feature-flags.docblock.ts",
+    "./docs/index": "./src/docs/index.ts",
+    "./entities": "./src/entities/index.ts",
+    "./entities/index": "./src/entities/index.ts",
+    "./evaluation": "./src/evaluation/index.ts",
+    "./evaluation/index": "./src/evaluation/index.ts",
+    "./events": "./src/events.ts",
+    "./feature-flags.capability": "./src/feature-flags.capability.ts",
+    "./feature-flags.feature": "./src/feature-flags.feature.ts"
   },
   "files": [
     "dist",
@@ -52,15 +57,97 @@
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./contracts": "./dist/contracts/index.js",
-      "./docs": "./dist/docs/index.js",
-      "./docs/feature-flags.docblock": "./dist/docs/feature-flags.docblock.js",
-      "./entities": "./dist/entities/index.js",
-      "./evaluation": "./dist/evaluation/index.js",
-      "./events": "./dist/events.js",
-      "./feature-flags.feature": "./dist/feature-flags.feature.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "browser": "./dist/browser/index.js",
+        "default": "./dist/index.js"
+      },
+      "./contracts": {
+        "types": "./dist/contracts/index.d.ts",
+        "bun": "./dist/contracts/index.js",
+        "node": "./dist/node/contracts/index.mjs",
+        "browser": "./dist/browser/contracts/index.js",
+        "default": "./dist/contracts/index.js"
+      },
+      "./contracts/index": {
+        "types": "./dist/contracts/index.d.ts",
+        "bun": "./dist/contracts/index.js",
+        "node": "./dist/node/contracts/index.mjs",
+        "browser": "./dist/browser/contracts/index.js",
+        "default": "./dist/contracts/index.js"
+      },
+      "./docs": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./docs/feature-flags.docblock": {
+        "types": "./dist/docs/feature-flags.docblock.d.ts",
+        "bun": "./dist/docs/feature-flags.docblock.js",
+        "node": "./dist/node/docs/feature-flags.docblock.mjs",
+        "browser": "./dist/browser/docs/feature-flags.docblock.js",
+        "default": "./dist/docs/feature-flags.docblock.js"
+      },
+      "./docs/index": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./entities": {
+        "types": "./dist/entities/index.d.ts",
+        "bun": "./dist/entities/index.js",
+        "node": "./dist/node/entities/index.mjs",
+        "browser": "./dist/browser/entities/index.js",
+        "default": "./dist/entities/index.js"
+      },
+      "./entities/index": {
+        "types": "./dist/entities/index.d.ts",
+        "bun": "./dist/entities/index.js",
+        "node": "./dist/node/entities/index.mjs",
+        "browser": "./dist/browser/entities/index.js",
+        "default": "./dist/entities/index.js"
+      },
+      "./evaluation": {
+        "types": "./dist/evaluation/index.d.ts",
+        "bun": "./dist/evaluation/index.js",
+        "node": "./dist/node/evaluation/index.mjs",
+        "browser": "./dist/browser/evaluation/index.js",
+        "default": "./dist/evaluation/index.js"
+      },
+      "./evaluation/index": {
+        "types": "./dist/evaluation/index.d.ts",
+        "bun": "./dist/evaluation/index.js",
+        "node": "./dist/node/evaluation/index.mjs",
+        "browser": "./dist/browser/evaluation/index.js",
+        "default": "./dist/evaluation/index.js"
+      },
+      "./events": {
+        "types": "./dist/events.d.ts",
+        "bun": "./dist/events.js",
+        "node": "./dist/node/events.mjs",
+        "browser": "./dist/browser/events.js",
+        "default": "./dist/events.js"
+      },
+      "./feature-flags.capability": {
+        "types": "./dist/feature-flags.capability.d.ts",
+        "bun": "./dist/feature-flags.capability.js",
+        "node": "./dist/node/feature-flags.capability.mjs",
+        "browser": "./dist/browser/feature-flags.capability.js",
+        "default": "./dist/feature-flags.capability.js"
+      },
+      "./feature-flags.feature": {
+        "types": "./dist/feature-flags.feature.d.ts",
+        "bun": "./dist/feature-flags.feature.js",
+        "node": "./dist/node/feature-flags.feature.mjs",
+        "browser": "./dist/browser/feature-flags.feature.js",
+        "default": "./dist/feature-flags.feature.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/dist/contracts/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/contracts/index.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport { defineCommand, defineQuery } from '@contractspec/lib.contracts';\n\nconst OWNERS = ['platform.feature-flags'] as const;\n\n// ============ Schema Models ============\n\nexport const FeatureFlagModel = defineSchemaModel({\n  name: 'FeatureFlag',\n  description: 'Represents a feature flag',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    defaultValue: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const TargetingRuleModel = defineSchemaModel({\n  name: 'TargetingRule',\n  description: 'Represents a targeting rule',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    priority: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    enabled: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    attribute: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    operator: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    value: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    rolloutPercentage: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    serveValue: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    serveVariant: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const ExperimentModel = defineSchemaModel({\n  name: 'Experiment',\n  description: 'Represents an experiment',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    hypothesis: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    metrics: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    audiencePercentage: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    endedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    winningVariant: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    results: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const EvaluationResultModel = defineSchemaModel({\n  name: 'EvaluationResult',\n  description: 'Result of flag evaluation',\n  fields: {\n    enabled: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    variant: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n// ============ Input/Output Models ============\n\nconst CreateFlagInput = defineSchemaModel({\n  name: 'CreateFlagInput',\n  description: 'Input for creating a feature flag',\n  fields: {\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    defaultValue: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\nconst UpdateFlagInput = defineSchemaModel({\n  name: 'UpdateFlagInput',\n  description: 'Input for updating a feature flag',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    defaultValue: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\nconst DeleteFlagInput = defineSchemaModel({\n  name: 'DeleteFlagInput',\n  description: 'Input for deleting a feature flag',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst ToggleFlagInput = defineSchemaModel({\n  name: 'ToggleFlagInput',\n  description: 'Input for toggling a feature flag',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst GetFlagInput = defineSchemaModel({\n  name: 'GetFlagInput',\n  description: 'Input for getting a feature flag',\n  fields: {\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst ListFlagsInput = defineSchemaModel({\n  name: 'ListFlagsInput',\n  description: 'Input for listing feature flags',\n  fields: {\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    offset: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nconst ListFlagsOutput = defineSchemaModel({\n  name: 'ListFlagsOutput',\n  description: 'Output for listing feature flags',\n  fields: {\n    flags: { type: FeatureFlagModel, isArray: true, isOptional: false },\n    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n  },\n});\n\nconst EvaluateFlagInput = defineSchemaModel({\n  name: 'EvaluateFlagInput',\n  description: 'Input for evaluating a feature flag',\n  fields: {\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    context: { type: ScalarTypeEnum.JSON(), isOptional: false },\n  },\n});\n\nconst CreateRuleInput = defineSchemaModel({\n  name: 'CreateRuleInput',\n  description: 'Input for creating a targeting rule',\n  fields: {\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    priority: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    attribute: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    operator: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    value: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    rolloutPercentage: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    serveValue: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    serveVariant: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst DeleteRuleInput = defineSchemaModel({\n  name: 'DeleteRuleInput',\n  description: 'Input for deleting a targeting rule',\n  fields: {\n    ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst CreateExperimentInput = defineSchemaModel({\n  name: 'CreateExperimentInput',\n  description: 'Input for creating an experiment',\n  fields: {\n    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    hypothesis: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    flagId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    variants: { type: ScalarTypeEnum.JSON(), isOptional: false },\n    metrics: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    audiencePercentage: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    scheduledStartAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    scheduledEndAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst StartExperimentInput = defineSchemaModel({\n  name: 'StartExperimentInput',\n  description: 'Input for starting an experiment',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst StopExperimentInput = defineSchemaModel({\n  name: 'StopExperimentInput',\n  description: 'Input for stopping an experiment',\n  fields: {\n    experimentId: { 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  },\n});\n\nconst GetExperimentInput = defineSchemaModel({\n  name: 'GetExperimentInput',\n  description: 'Input for getting an experiment',\n  fields: {\n    experimentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst SuccessOutput = defineSchemaModel({\n  name: 'SuccessOutput',\n  description: 'Generic success output',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n  },\n});\n\n// ============ Contracts ============\n\n/**\n * Create a feature flag.\n */\nexport const CreateFlagContract = defineCommand({\n  meta: {\n    key: 'flag.create',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'create'],\n    description: 'Create a new feature flag.',\n    goal: 'Define a new feature flag for toggling features.',\n    context: 'Called when setting up a new feature flag.',\n  },\n  io: {\n    input: CreateFlagInput,\n    output: FeatureFlagModel,\n    errors: {\n      KEY_ALREADY_EXISTS: {\n        description: 'Flag key already exists',\n        http: 409,\n        gqlCode: 'FLAG_KEY_EXISTS',\n        when: 'A flag with this key already exists',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Update a feature flag.\n */\nexport const UpdateFlagContract = defineCommand({\n  meta: {\n    key: 'flag.update',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'update'],\n    description: 'Update an existing feature flag.',\n    goal: 'Modify flag configuration.',\n    context: 'Called when adjusting flag settings.',\n  },\n  io: {\n    input: UpdateFlagInput,\n    output: FeatureFlagModel,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Delete a feature flag.\n */\nexport const DeleteFlagContract = defineCommand({\n  meta: {\n    key: 'flag.delete',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'delete'],\n    description: 'Delete a feature flag.',\n    goal: 'Remove a feature flag and all its rules.',\n    context: 'Called when a flag is no longer needed.',\n  },\n  io: {\n    input: DeleteFlagInput,\n    output: SuccessOutput,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag ID is invalid',\n      },\n      FLAG_HAS_ACTIVE_EXPERIMENT: {\n        description: 'Flag has an active experiment',\n        http: 409,\n        gqlCode: 'FLAG_HAS_ACTIVE_EXPERIMENT',\n        when: 'Cannot delete flag with running experiment',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Toggle a feature flag status.\n */\nexport const ToggleFlagContract = defineCommand({\n  meta: {\n    key: 'flag.toggle',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'toggle'],\n    description: 'Toggle a feature flag status.',\n    goal: 'Quickly enable or disable a feature.',\n    context: 'Called when turning a feature on or off.',\n  },\n  io: {\n    input: ToggleFlagInput,\n    output: FeatureFlagModel,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag ID is invalid',\n      },\n      INVALID_STATUS: {\n        description: 'Invalid status value',\n        http: 400,\n        gqlCode: 'INVALID_STATUS',\n        when: 'Status must be OFF, ON, or GRADUAL',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Get a feature flag by key.\n */\nexport const GetFlagContract = defineQuery({\n  meta: {\n    key: 'flag.get',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'get'],\n    description: 'Get a feature flag by key.',\n    goal: 'Retrieve flag configuration.',\n    context: 'Called to inspect flag details.',\n  },\n  io: {\n    input: GetFlagInput,\n    output: FeatureFlagModel,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag key is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * List feature flags.\n */\nexport const ListFlagsContract = defineQuery({\n  meta: {\n    key: 'flag.list',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'list'],\n    description: 'List all feature flags.',\n    goal: 'View all configured flags.',\n    context: 'Admin dashboard.',\n  },\n  io: {\n    input: ListFlagsInput,\n    output: ListFlagsOutput,\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Evaluate a feature flag.\n */\nexport const EvaluateFlagContract = defineQuery({\n  meta: {\n    key: 'flag.evaluate',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'evaluate'],\n    description: 'Evaluate a feature flag for a given context.',\n    goal: 'Determine if a feature should be enabled.',\n    context: 'Called at runtime to check feature availability.',\n  },\n  io: {\n    input: EvaluateFlagInput,\n    output: EvaluationResultModel,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag key is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'anonymous',\n  },\n});\n\n/**\n * Create a targeting rule.\n */\nexport const CreateRuleContract = defineCommand({\n  meta: {\n    key: 'flag.rule.create',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'rule', 'create'],\n    description: 'Create a targeting rule for a flag.',\n    goal: 'Add conditional targeting to a flag.',\n    context: 'Called when setting up targeting.',\n  },\n  io: {\n    input: CreateRuleInput,\n    output: TargetingRuleModel,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag ID is invalid',\n      },\n      INVALID_OPERATOR: {\n        description: 'Invalid operator',\n        http: 400,\n        gqlCode: 'INVALID_OPERATOR',\n        when: 'Operator is not supported',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Delete a targeting rule.\n */\nexport const DeleteRuleContract = defineCommand({\n  meta: {\n    key: 'flag.rule.delete',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'rule', 'delete'],\n    description: 'Delete a targeting rule.',\n    goal: 'Remove a targeting rule from a flag.',\n    context: 'Called when removing targeting conditions.',\n  },\n  io: {\n    input: DeleteRuleInput,\n    output: SuccessOutput,\n    errors: {\n      RULE_NOT_FOUND: {\n        description: 'Rule does not exist',\n        http: 404,\n        gqlCode: 'RULE_NOT_FOUND',\n        when: 'Rule ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Create an experiment.\n */\nexport const CreateExperimentContract = defineCommand({\n  meta: {\n    key: 'experiment.create',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'experiment', 'create'],\n    description: 'Create an A/B test experiment.',\n    goal: 'Set up an experiment with variants.',\n    context: 'Called when setting up A/B testing.',\n  },\n  io: {\n    input: CreateExperimentInput,\n    output: ExperimentModel,\n    errors: {\n      FLAG_NOT_FOUND: {\n        description: 'Flag does not exist',\n        http: 404,\n        gqlCode: 'FLAG_NOT_FOUND',\n        when: 'Flag ID is invalid',\n      },\n      EXPERIMENT_KEY_EXISTS: {\n        description: 'Experiment key already exists',\n        http: 409,\n        gqlCode: 'EXPERIMENT_KEY_EXISTS',\n        when: 'An experiment with this key already exists',\n      },\n      INVALID_VARIANTS: {\n        description: 'Invalid variant configuration',\n        http: 400,\n        gqlCode: 'INVALID_VARIANTS',\n        when: 'Variant percentages must sum to 100',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Start an experiment.\n */\nexport const StartExperimentContract = defineCommand({\n  meta: {\n    key: 'experiment.start',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'experiment', 'start'],\n    description: 'Start an experiment.',\n    goal: 'Begin collecting data for an experiment.',\n    context: 'Called when ready to run an A/B test.',\n  },\n  io: {\n    input: StartExperimentInput,\n    output: ExperimentModel,\n    errors: {\n      EXPERIMENT_NOT_FOUND: {\n        description: 'Experiment does not exist',\n        http: 404,\n        gqlCode: 'EXPERIMENT_NOT_FOUND',\n        when: 'Experiment ID is invalid',\n      },\n      EXPERIMENT_ALREADY_RUNNING: {\n        description: 'Experiment is already running',\n        http: 409,\n        gqlCode: 'EXPERIMENT_ALREADY_RUNNING',\n        when: 'Cannot start an experiment that is already running',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Stop an experiment.\n */\nexport const StopExperimentContract = defineCommand({\n  meta: {\n    key: 'experiment.stop',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'experiment', 'stop'],\n    description: 'Stop an experiment.',\n    goal: 'End an experiment and optionally declare a winner.',\n    context: 'Called when concluding an A/B test.',\n  },\n  io: {\n    input: StopExperimentInput,\n    output: ExperimentModel,\n    errors: {\n      EXPERIMENT_NOT_FOUND: {\n        description: 'Experiment does not exist',\n        http: 404,\n        gqlCode: 'EXPERIMENT_NOT_FOUND',\n        when: 'Experiment ID is invalid',\n      },\n      EXPERIMENT_NOT_RUNNING: {\n        description: 'Experiment is not running',\n        http: 409,\n        gqlCode: 'EXPERIMENT_NOT_RUNNING',\n        when: 'Cannot stop an experiment that is not running',\n      },\n    },\n  },\n  policy: {\n    auth: 'admin',\n  },\n});\n\n/**\n * Get an experiment.\n */\nexport const GetExperimentContract = defineQuery({\n  meta: {\n    key: 'experiment.get',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['feature-flags', 'experiment', 'get'],\n    description: 'Get experiment details.',\n    goal: 'View experiment configuration and results.',\n    context: 'Called to inspect experiment status.',\n  },\n  io: {\n    input: GetExperimentInput,\n    output: ExperimentModel,\n    errors: {\n      EXPERIMENT_NOT_FOUND: {\n        description: 'Experiment does not exist',\n        http: 404,\n        gqlCode: 'EXPERIMENT_NOT_FOUND',\n        when: 'Experiment ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n"],"mappings":"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"}

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"}