@jewel998/config 0.1.0

package/dist/management/memory-backend.js

@@ -0,0 +1,78 @@
+/**
+ * In-memory backend for testing and local development.
+ */
+export const createMemoryBackend = () => {
+    const projects = [];
+    const environments = [];
+    const versions = [];
+    let idCounter = 0;
+    const nextId = () => {
+        idCounter++;
+        return `mem-${idCounter.toString().padStart(4, "0")}`;
+    };
+    return {
+        createProject: async (name, ownerId) => {
+            const project = {
+                id: nextId(),
+                name,
+                ownerId,
+                authorizedUsers: [ownerId],
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            };
+            projects.push(project);
+            return project;
+        },
+        deleteProject: async (projectId) => {
+            const index = projects.findIndex((p) => p.id === projectId);
+            if (index >= 0) {
+                projects.splice(index, 1);
+            }
+        },
+        listProjects: async (ownerId) => projects.filter((p) => p.ownerId === ownerId || p.authorizedUsers.includes(ownerId)),
+        createEnvironment: async (projectId, name) => {
+            const environment = {
+                id: nextId(),
+                projectId,
+                name,
+                allowedDomains: [],
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            };
+            environments.push(environment);
+            return environment;
+        },
+        deleteEnvironment: async (_projectId, environmentId) => {
+            const index = environments.findIndex((e) => e.id === environmentId);
+            if (index >= 0) {
+                environments.splice(index, 1);
+            }
+        },
+        listEnvironments: async (projectId) => environments.filter((e) => e.projectId === projectId),
+        createVersion: async (projectId, version, payload, environmentId) => {
+            const record = {
+                id: nextId(),
+                projectId,
+                environmentId,
+                version,
+                payload,
+                publishedAt: undefined,
+            };
+            versions.push(record);
+            return record;
+        },
+        publishVersion: async (_projectId, versionId) => {
+            const record = versions.find((v) => v.id === versionId);
+            if (!record) {
+                throw new Error(`Version ${versionId} not found.`);
+            }
+            if (record.publishedAt) {
+                throw new Error(`Version ${versionId} is already published.`);
+            }
+            record.publishedAt = new Date().toISOString();
+            return record;
+        },
+        listVersions: async (projectId) => versions.filter((v) => v.projectId === projectId),
+    };
+};
+//# sourceMappingURL=memory-backend.js.map

package/dist/management/memory-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-backend.js","sourceRoot":"","sources":["../../src/management/memory-backend.ts"],"names":[],"mappings":"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"}

package/dist/plugins/evaluatePipeline.d.ts

@@ -0,0 +1,15 @@
+import type { ConfigFlagData } from "./models.js";
+import type { EvaluationContext, EvaluationPlugin, PipelineHelpers } from "./types.js";
+/**
+ * Evaluate a config flag through the plugin pipeline.
+ *
+ * 1. Builds a lookup map of stepId → plugin from the registered plugins.
+ * 2. Iterates through PIPELINE_ORDER (fixed order regardless of registration order).
+ * 3. For each step, if a plugin is registered, calls plugin.evaluate().
+ * 4. If a plugin returns { resolved: true, value }, returns that value immediately (short-circuit).
+ * 5. If no plugin resolves, returns the flag's default value (flag.value).
+ *
+ * Steps with no registered plugin are transparently skipped.
+ */
+export declare function evaluatePipeline(plugins: EvaluationPlugin[], flag: ConfigFlagData, context: EvaluationContext, helpers: PipelineHelpers): unknown;
+//# sourceMappingURL=evaluatePipeline.d.ts.map

package/dist/plugins/evaluatePipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluatePipeline.d.ts","sourceRoot":"","sources":["../../src/plugins/evaluatePipeline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CA0BT"}

package/dist/plugins/evaluatePipeline.js

@@ -0,0 +1,39 @@
+// ═══════════════════════════════════════════════════════════════
+// Pipeline Executor — Sorts plugins into fixed order, iterates,
+// short-circuits on first resolved result.
+// ═══════════════════════════════════════════════════════════════
+import { PIPELINE_ORDER } from "./types.js";
+/**
+ * Evaluate a config flag through the plugin pipeline.
+ *
+ * 1. Builds a lookup map of stepId → plugin from the registered plugins.
+ * 2. Iterates through PIPELINE_ORDER (fixed order regardless of registration order).
+ * 3. For each step, if a plugin is registered, calls plugin.evaluate().
+ * 4. If a plugin returns { resolved: true, value }, returns that value immediately (short-circuit).
+ * 5. If no plugin resolves, returns the flag's default value (flag.value).
+ *
+ * Steps with no registered plugin are transparently skipped.
+ */
+export function evaluatePipeline(plugins, flag, context, helpers) {
+    // Build a map from stepId → plugin (last registration wins if duplicates)
+    const pluginMap = new Map();
+    for (const plugin of plugins) {
+        pluginMap.set(plugin.stepId, plugin);
+    }
+    // Iterate through the fixed pipeline order
+    for (const stepId of PIPELINE_ORDER) {
+        const plugin = pluginMap.get(stepId);
+        // Skip steps with no registered plugin (Property 21)
+        if (!plugin) {
+            continue;
+        }
+        const result = plugin.evaluate(flag, context, helpers);
+        // Short-circuit on first resolved result (Requirement 11.2)
+        if (result.resolved) {
+            return result.value;
+        }
+    }
+    // No step resolved — return the flag's default value
+    return flag.value;
+}
+//# sourceMappingURL=evaluatePipeline.js.map

package/dist/plugins/evaluatePipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluatePipeline.js","sourceRoot":"","sources":["../../src/plugins/evaluatePipeline.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gEAAgE;AAChE,2CAA2C;AAC3C,kEAAkE;AASlE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA2B,EAC3B,IAAoB,EACpB,OAA0B,EAC1B,OAAwB;IAExB,0EAA0E;IAC1E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC9D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,2CAA2C;IAC3C,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErC,qDAAqD;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAEvD,4DAA4D;QAC5D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,5 @@
+export type { PipelineStepId, EvaluationContext, PipelineStepResult, EvaluationPlugin, PipelineHelpers, } from "./types.js";
+export { PIPELINE_ORDER } from "./types.js";
+export type { ConfigFlagData, TargetingRule, PredicateGroup, Predicate, PredicateOperator, Segment, } from "./models.js";
+export { evaluatePipeline } from "./evaluatePipeline.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,6 @@
+// ═══════════════════════════════════════════════════════════════
+// Plugin System — Barrel Export
+// ═══════════════════════════════════════════════════════════════
+export { PIPELINE_ORDER } from "./types.js";
+export { evaluatePipeline } from "./evaluatePipeline.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gCAAgC;AAChC,kEAAkE;AAUlE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAW5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/plugins/lifecycle/archivedPlugin.d.ts

@@ -0,0 +1,14 @@
+import type { EvaluationPlugin } from "../types.js";
+/**
+ * Factory function that creates the archived state evaluation plugin.
+ *
+ * Evaluation logic:
+ * - If `flag.lifecycleState === "archived"` → return `{ resolved: true, value: undefined }`
+ *   (archived flags always return undefined, regardless of other configuration)
+ * - Otherwise → return `{ resolved: false }` (let pipeline continue)
+ *
+ * This is the first step in the evaluation pipeline, ensuring archived flags
+ * short-circuit before any other evaluation logic runs.
+ */
+export declare function archivedPlugin(): EvaluationPlugin;
+//# sourceMappingURL=archivedPlugin.d.ts.map

package/dist/plugins/lifecycle/archivedPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivedPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/lifecycle/archivedPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAgBjD"}

package/dist/plugins/lifecycle/archivedPlugin.js

@@ -0,0 +1,26 @@
+// ═══════════════════════════════════════════════════════════════
+// Archived State Evaluation Plugin
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Factory function that creates the archived state evaluation plugin.
+ *
+ * Evaluation logic:
+ * - If `flag.lifecycleState === "archived"` → return `{ resolved: true, value: undefined }`
+ *   (archived flags always return undefined, regardless of other configuration)
+ * - Otherwise → return `{ resolved: false }` (let pipeline continue)
+ *
+ * This is the first step in the evaluation pipeline, ensuring archived flags
+ * short-circuit before any other evaluation logic runs.
+ */
+export function archivedPlugin() {
+    return {
+        stepId: "archived",
+        evaluate(flag, _context, _helpers) {
+            if (flag.lifecycleState === "archived") {
+                return { resolved: true, value: undefined };
+            }
+            return { resolved: false };
+        },
+    };
+}
+//# sourceMappingURL=archivedPlugin.js.map

package/dist/plugins/lifecycle/archivedPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivedPlugin.js","sourceRoot":"","sources":["../../../src/plugins/lifecycle/archivedPlugin.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,mCAAmC;AACnC,kEAAkE;AAUlE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,MAAM,EAAE,UAAU;QAElB,QAAQ,CACN,IAAoB,EACpB,QAA2B,EAC3B,QAAyB;YAEzB,IAAI,IAAI,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;gBACvC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC9C,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/lifecycle/index.d.ts

@@ -0,0 +1,4 @@
+export { archivedPlugin } from "./archivedPlugin.js";
+export { validateStateTransition, VALID_TRANSITIONS, } from "./stateTransitions.js";
+export type { LifecycleState } from "./stateTransitions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/lifecycle/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/plugins/lifecycle/index.js

@@ -0,0 +1,6 @@
+// ═══════════════════════════════════════════════════════════════
+// Lifecycle Plugin — Public Barrel Export
+// ═══════════════════════════════════════════════════════════════
+export { archivedPlugin } from "./archivedPlugin.js";
+export { validateStateTransition, VALID_TRANSITIONS, } from "./stateTransitions.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/lifecycle/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,0CAA0C;AAC1C,kEAAkE;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/plugins/lifecycle/stateTransitions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Valid lifecycle states for a config flag.
+ */
+export type LifecycleState = "draft" | "active" | "stale" | "archived";
+/**
+ * Map of valid state transitions.
+ *
+ * Allowed transitions:
+ * - draft → active
+ * - active → stale
+ * - stale → archived
+ * - stale → active (reactivation)
+ * - archived → active (unarchive)
+ *
+ * All other transitions are rejected.
+ */
+export declare const VALID_TRANSITIONS: Record<LifecycleState, LifecycleState[]>;
+/**
+ * Validates whether a state transition from `current` to `target` is allowed
+ * by the lifecycle state machine.
+ *
+ * @param current - The current lifecycle state of the flag
+ * @param target - The desired target lifecycle state
+ * @returns `true` if the transition is valid, `false` otherwise
+ */
+export declare function validateStateTransition(current: LifecycleState, target: LifecycleState): boolean;
+//# sourceMappingURL=stateTransitions.d.ts.map

package/dist/plugins/lifecycle/stateTransitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTransitions.d.ts","sourceRoot":"","sources":["../../../src/plugins/lifecycle/stateTransitions.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,CAKtE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,GACrB,OAAO,CAET"}

package/dist/plugins/lifecycle/stateTransitions.js

@@ -0,0 +1,33 @@
+// ═══════════════════════════════════════════════════════════════
+// Lifecycle State Machine Validator
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Map of valid state transitions.
+ *
+ * Allowed transitions:
+ * - draft → active
+ * - active → stale
+ * - stale → archived
+ * - stale → active (reactivation)
+ * - archived → active (unarchive)
+ *
+ * All other transitions are rejected.
+ */
+export const VALID_TRANSITIONS = {
+    draft: ["active"],
+    active: ["stale"],
+    stale: ["archived", "active"],
+    archived: ["active"],
+};
+/**
+ * Validates whether a state transition from `current` to `target` is allowed
+ * by the lifecycle state machine.
+ *
+ * @param current - The current lifecycle state of the flag
+ * @param target - The desired target lifecycle state
+ * @returns `true` if the transition is valid, `false` otherwise
+ */
+export function validateStateTransition(current, target) {
+    return VALID_TRANSITIONS[current]?.includes(target) ?? false;
+}
+//# sourceMappingURL=stateTransitions.js.map

package/dist/plugins/lifecycle/stateTransitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTransitions.js","sourceRoot":"","sources":["../../../src/plugins/lifecycle/stateTransitions.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,oCAAoC;AACpC,kEAAkE;AAOlE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA6C;IACzE,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,MAAM,EAAE,CAAC,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC7B,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAuB,EACvB,MAAsB;IAEtB,OAAO,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;AAC/D,CAAC"}

package/dist/plugins/models.d.ts

@@ -0,0 +1,50 @@
+/** The full config flag document as fetched from Firestore */
+export interface ConfigFlagData {
+    key: string;
+    value: unknown;
+    valueType: "string" | "number" | "boolean" | "json";
+    version: string;
+    lifecycleState: "draft" | "active" | "stale" | "archived";
+    targetingRules?: TargetingRule[];
+    rolloutPercentage?: number;
+    rolloutValue?: unknown;
+    overrides?: Record<string, unknown>;
+    schedule?: {
+        targetValue: unknown;
+        activateAt: string;
+    };
+    prerequisites?: Array<{
+        flagKey: string;
+        requiredValue: unknown;
+    }>;
+}
+/** A single targeting rule */
+export interface TargetingRule {
+    id: string;
+    priority: number;
+    value: unknown;
+    conditions: PredicateGroup[];
+}
+/** A group of predicates combined with AND logic */
+export interface PredicateGroup {
+    predicates: Predicate[];
+}
+/** A single predicate */
+export interface Predicate {
+    attribute: string;
+    operator: PredicateOperator;
+    value: string | number | boolean | string[];
+}
+/** Supported predicate operators */
+export type PredicateOperator = "equals" | "not_equals" | "contains" | "starts_with" | "ends_with" | "in_list" | "not_in_list" | "greater_than" | "less_than" | "regex_match" | "in_segment" | "not_in_segment";
+/** A reusable audience segment */
+export interface Segment {
+    id: string;
+    name: string;
+    description: string;
+    conditions: PredicateGroup[];
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/plugins/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/plugins/models.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAG1D,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IAGjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGpC,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,yBAAyB;AACzB,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;CAC7C;AAED,oCAAoC;AACpC,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,aAAa,GACb,WAAW,GACX,SAAS,GACT,aAAa,GACb,cAAc,GACd,WAAW,GACX,aAAa,GACb,YAAY,GACZ,gBAAgB,CAAC;AAErB,kCAAkC;AAClC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/plugins/models.js

@@ -0,0 +1,5 @@
+// ═══════════════════════════════════════════════════════════════
+// Config Flag Data Models (SDK-side)
+// ═══════════════════════════════════════════════════════════════
+export {};
+//# sourceMappingURL=models.js.map

package/dist/plugins/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/plugins/models.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,qCAAqC;AACrC,kEAAkE"}

package/dist/plugins/overrides/index.d.ts

@@ -0,0 +1,2 @@
+export { overridesPlugin } from "./overridesPlugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/overrides/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/overrides/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/overrides/index.js

@@ -0,0 +1,5 @@
+// ═══════════════════════════════════════════════════════════════
+// Overrides Plugin — Public Barrel Export
+// ═══════════════════════════════════════════════════════════════
+export { overridesPlugin } from "./overridesPlugin.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/overrides/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/overrides/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,0CAA0C;AAC1C,kEAAkE;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/overrides/overridesPlugin.d.ts

@@ -0,0 +1,12 @@
+import type { EvaluationPlugin } from "../types.js";
+/**
+ * Factory function that creates the overrides evaluation plugin.
+ *
+ * Evaluation logic:
+ * - If no userId in context → skip (Req 4.5)
+ * - If `flag.overrides` is undefined/null → skip
+ * - If userId exists in overrides map AND value is not null/undefined → return override value (Req 4.3)
+ * - If userId not in overrides or value is null/undefined → skip (Req 4.4, 4.7)
+ */
+export declare function overridesPlugin(): EvaluationPlugin;
+//# sourceMappingURL=overridesPlugin.d.ts.map

package/dist/plugins/overrides/overridesPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overridesPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/overrides/overridesPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAmClD"}

package/dist/plugins/overrides/overridesPlugin.js

@@ -0,0 +1,40 @@
+// ═══════════════════════════════════════════════════════════════
+// Overrides Evaluation Plugin
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Factory function that creates the overrides evaluation plugin.
+ *
+ * Evaluation logic:
+ * - If no userId in context → skip (Req 4.5)
+ * - If `flag.overrides` is undefined/null → skip
+ * - If userId exists in overrides map AND value is not null/undefined → return override value (Req 4.3)
+ * - If userId not in overrides or value is null/undefined → skip (Req 4.4, 4.7)
+ */
+export function overridesPlugin() {
+    return {
+        stepId: "overrides",
+        evaluate(flag, context, _helpers) {
+            // No userId in context — skip override evaluation entirely (Req 4.5)
+            if (!context.userId) {
+                return { resolved: false };
+            }
+            // No overrides map configured on this flag — skip
+            if (flag.overrides == null) {
+                return { resolved: false };
+            }
+            // Check if userId exists in overrides map
+            const userId = context.userId;
+            if (!(userId in flag.overrides)) {
+                return { resolved: false };
+            }
+            // userId exists but value is null/undefined — skip (Req 4.7)
+            const overrideValue = flag.overrides[userId];
+            if (overrideValue == null) {
+                return { resolved: false };
+            }
+            // Override found with a non-null value — return immediately (Req 4.3)
+            return { resolved: true, value: overrideValue };
+        },
+    };
+}
+//# sourceMappingURL=overridesPlugin.js.map

package/dist/plugins/overrides/overridesPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overridesPlugin.js","sourceRoot":"","sources":["../../../src/plugins/overrides/overridesPlugin.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,8BAA8B;AAC9B,kEAAkE;AAUlE;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,MAAM,EAAE,WAAW;QAEnB,QAAQ,CACN,IAAoB,EACpB,OAA0B,EAC1B,QAAyB;YAEzB,qEAAqE;YACrE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAED,kDAAkD;YAClD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;gBAC3B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAED,0CAA0C;YAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAED,6DAA6D;YAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAC1B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAED,sEAAsE;YACtE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/prerequisites/index.d.ts

@@ -0,0 +1,3 @@
+export { prerequisitePlugin } from "./prerequisitePlugin.js";
+export type { PrerequisitePluginOptions } from "./prerequisitePlugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/prerequisites/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/prerequisites/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/plugins/prerequisites/index.js

@@ -0,0 +1,5 @@
+// ═══════════════════════════════════════════════════════════════
+// Prerequisites Plugin — Public Barrel Export
+// ═══════════════════════════════════════════════════════════════
+export { prerequisitePlugin } from "./prerequisitePlugin.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/prerequisites/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/prerequisites/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,8CAA8C;AAC9C,kEAAkE;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/plugins/prerequisites/prerequisitePlugin.d.ts

@@ -0,0 +1,24 @@
+import type { EvaluationPlugin } from "../types.js";
+/** Options for the prerequisite plugin */
+export interface PrerequisitePluginOptions {
+    /** Maximum recursion depth for prerequisite evaluation (default: 5) */
+    maxDepth?: number;
+}
+/**
+ * Factory function that creates the prerequisites evaluation plugin.
+ *
+ * Evaluation logic:
+ * - If `prerequisites` is undefined/empty → skip (resolved: false)
+ * - For each prerequisite:
+ *   - Check for circular dependency (flag already in evaluation stack)
+ *   - Check for depth exceeded (> maxDepth levels)
+ *   - Evaluate the prerequisite flag via helpers.evaluateFlag()
+ *   - If the resolved value !== requiredValue → prerequisite is unmet
+ * - If any prerequisite is unmet → return flag's default value
+ * - If all met → skip (resolved: false), let pipeline continue
+ *
+ * Circular dependency detection uses a module-level evaluation stack (Set)
+ * that tracks which flags are currently being evaluated for prerequisites.
+ */
+export declare function prerequisitePlugin(options?: PrerequisitePluginOptions): EvaluationPlugin;
+//# sourceMappingURL=prerequisitePlugin.d.ts.map

package/dist/plugins/prerequisites/prerequisitePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisitePlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/prerequisites/prerequisitePlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,yBAAyB,GAClC,gBAAgB,CA4DlB"}

package/dist/plugins/prerequisites/prerequisitePlugin.js

@@ -0,0 +1,62 @@
+// ═══════════════════════════════════════════════════════════════
+// Prerequisites Evaluation Plugin
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Factory function that creates the prerequisites evaluation plugin.
+ *
+ * Evaluation logic:
+ * - If `prerequisites` is undefined/empty → skip (resolved: false)
+ * - For each prerequisite:
+ *   - Check for circular dependency (flag already in evaluation stack)
+ *   - Check for depth exceeded (> maxDepth levels)
+ *   - Evaluate the prerequisite flag via helpers.evaluateFlag()
+ *   - If the resolved value !== requiredValue → prerequisite is unmet
+ * - If any prerequisite is unmet → return flag's default value
+ * - If all met → skip (resolved: false), let pipeline continue
+ *
+ * Circular dependency detection uses a module-level evaluation stack (Set)
+ * that tracks which flags are currently being evaluated for prerequisites.
+ */
+export function prerequisitePlugin(options) {
+    const maxDepth = options?.maxDepth ?? 5;
+    /** Tracks flags currently being evaluated for prerequisites (cycle detection) */
+    const evaluationStack = new Set();
+    return {
+        stepId: "prerequisites",
+        evaluate(flag, context, helpers) {
+            // No prerequisites configured — skip
+            if (!flag.prerequisites || flag.prerequisites.length === 0) {
+                return { resolved: false };
+            }
+            // Check for circular dependency: this flag is already being evaluated
+            if (evaluationStack.has(flag.key)) {
+                helpers.emitError(`Circular dependency detected: flag "${flag.key}" is already in the prerequisite evaluation chain`);
+                return { resolved: true, value: flag.value };
+            }
+            // Check depth: if we've exceeded the max depth, stop
+            if (evaluationStack.size >= maxDepth) {
+                helpers.emitError(`Prerequisite evaluation depth exceeded maximum of ${maxDepth} levels while evaluating flag "${flag.key}"`);
+                return { resolved: true, value: flag.value };
+            }
+            // Add current flag to the evaluation stack
+            evaluationStack.add(flag.key);
+            try {
+                // Evaluate each prerequisite
+                for (const prerequisite of flag.prerequisites) {
+                    const resolvedValue = helpers.evaluateFlag(prerequisite.flagKey, context);
+                    // Strict equality check — prerequisite is unmet if values don't match
+                    if (resolvedValue !== prerequisite.requiredValue) {
+                        return { resolved: true, value: flag.value };
+                    }
+                }
+                // All prerequisites met — let pipeline continue
+                return { resolved: false };
+            }
+            finally {
+                // Always remove current flag from the stack after evaluation
+                evaluationStack.delete(flag.key);
+            }
+        },
+    };
+}
+//# sourceMappingURL=prerequisitePlugin.js.map

package/dist/plugins/prerequisites/prerequisitePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisitePlugin.js","sourceRoot":"","sources":["../../../src/plugins/prerequisites/prerequisitePlugin.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,kCAAkC;AAClC,kEAAkE;AAgBlE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAmC;IAEnC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;IAExC,iFAAiF;IACjF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,OAAO;QACL,MAAM,EAAE,eAAe;QAEvB,QAAQ,CACN,IAAoB,EACpB,OAA0B,EAC1B,OAAwB;YAExB,qCAAqC;YACrC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YAED,sEAAsE;YACtE,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,SAAS,CACf,uCAAuC,IAAI,CAAC,GAAG,mDAAmD,CACnG,CAAC;gBACF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/C,CAAC;YAED,qDAAqD;YACrD,IAAI,eAAe,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;gBACrC,OAAO,CAAC,SAAS,CACf,qDAAqD,QAAQ,kCAAkC,IAAI,CAAC,GAAG,GAAG,CAC3G,CAAC;gBACF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/C,CAAC;YAED,2CAA2C;YAC3C,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,CAAC;gBACH,6BAA6B;gBAC7B,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CACxC,YAAY,CAAC,OAAO,EACpB,OAAO,CACR,CAAC;oBAEF,sEAAsE;oBACtE,IAAI,aAAa,KAAK,YAAY,CAAC,aAAa,EAAE,CAAC;wBACjD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC/C,CAAC;gBACH,CAAC;gBAED,gDAAgD;gBAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;oBAAS,CAAC;gBACT,6DAA6D;gBAC7D,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/rollout/computeBucket.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Compute the rollout bucket (0–99) for a given configKey and userId.
+ *
+ * Algorithm:
+ * 1. Concatenate: `${configKey}:${userId}`
+ * 2. Compute MurmurHash3_x86_32 with seed 0
+ * 3. Map to bucket: hash % 100
+ *
+ * Deterministic — same inputs always produce the same bucket.
+ */
+export declare function computeBucket(configKey: string, userId: string): number;
+//# sourceMappingURL=computeBucket.d.ts.map

package/dist/plugins/rollout/computeBucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeBucket.d.ts","sourceRoot":"","sources":["../../../src/plugins/rollout/computeBucket.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIvE"}

package/dist/plugins/rollout/computeBucket.js

@@ -0,0 +1,20 @@
+// ═══════════════════════════════════════════════════════════════
+// Rollout Bucket Computation
+// ═══════════════════════════════════════════════════════════════
+import { murmurhash3_32 } from "./murmurhash3.js";
+/**
+ * Compute the rollout bucket (0–99) for a given configKey and userId.
+ *
+ * Algorithm:
+ * 1. Concatenate: `${configKey}:${userId}`
+ * 2. Compute MurmurHash3_x86_32 with seed 0
+ * 3. Map to bucket: hash % 100
+ *
+ * Deterministic — same inputs always produce the same bucket.
+ */
+export function computeBucket(configKey, userId) {
+    const input = `${configKey}:${userId}`;
+    const hash = murmurhash3_32(input, 0);
+    return hash % 100;
+}
+//# sourceMappingURL=computeBucket.js.map