prompt-flags 0.1.0

package/README.md

@@ -0,0 +1,154 @@
+# prompt-flags
+
+AI-native feature flags for prompt variants and model selection. Deterministic bucketing via murmurhash3, targeting rules with 13 operators, and 4 flag types (`prompt`, `model`, `config`, `boolean`).
+
+## Install
+
+```bash
+npm install prompt-flags
+```
+
+## Quick Start
+
+```typescript
+import { createClient, FlagConfiguration } from 'prompt-flags'
+
+const config: FlagConfiguration = {
+  flags: [
+    {
+      key: 'system-prompt',
+      type: 'prompt',
+      enabled: true,
+      variants: [
+        { key: 'v1', value: 'You are a helpful assistant.' },
+        { key: 'v2', value: 'You are a concise assistant.' },
+      ],
+      defaultVariant: 'v1',
+      rules: [
+        {
+          conditions: [{ attribute: 'plan', operator: 'equals', value: 'pro' }],
+          serve: { variant: 'v2' },
+        },
+      ],
+    },
+    {
+      key: 'model-select',
+      type: 'model',
+      enabled: true,
+      variants: [
+        { key: 'fast', value: { model: 'gpt-3.5-turbo', temperature: 0.7 } },
+        { key: 'smart', value: { model: 'gpt-4o', temperature: 0.3 } },
+      ],
+      defaultVariant: 'fast',
+      rules: [
+        {
+          serve: { rollout: [{ variant: 'smart', weight: 20 }, { variant: 'fast', weight: 80 }] },
+        },
+      ],
+    },
+    {
+      key: 'new-ui',
+      type: 'boolean',
+      enabled: true,
+      variants: [
+        { key: 'on', value: true },
+        { key: 'off', value: false },
+      ],
+      defaultVariant: 'off',
+    },
+  ],
+}
+
+const client = createClient({ config })
+
+const ctx = { key: 'user-123', plan: 'pro' }
+
+// Prompt flag
+const prompt = client.getPrompt('system-prompt', ctx)  // 'You are a concise assistant.'
+
+// Model flag (deterministic rollout)
+const model = client.getModel('model-select', ctx)     // { model: 'gpt-3.5-turbo', temperature: 0.7 }
+
+// Boolean flag
+const enabled = client.isEnabled('new-ui', ctx)        // false
+```
+
+## Flag Types
+
+| Type      | Getter         | Value type   |
+|-----------|----------------|--------------|
+| `prompt`  | `getPrompt`    | `string`     |
+| `model`   | `getModel`     | `ModelConfig`|
+| `config`  | `getConfig<T>` | `T`          |
+| `boolean` | `isEnabled`    | `boolean`    |
+
+## Targeting Rules
+
+Rules are evaluated in order. The first matching rule wins. All conditions within a rule use AND logic.
+
+### Supported operators
+
+| Operator               | Description                          |
+|------------------------|--------------------------------------|
+| `equals`               | Strict string equality               |
+| `notEquals`            | Strict string inequality             |
+| `in`                   | Value is in `values` array           |
+| `notIn`                | Value is not in `values` array       |
+| `contains`             | String contains substring            |
+| `startsWith`           | String starts with value             |
+| `endsWith`             | String ends with value               |
+| `greaterThan`          | Numeric `>`                          |
+| `lessThan`             | Numeric `<`                          |
+| `greaterThanOrEqual`   | Numeric `>=`                         |
+| `lessThanOrEqual`      | Numeric `<=`                         |
+| `matches`              | Regex test (value is pattern string) |
+| `exists`               | Attribute is not null/undefined      |
+| `notExists`            | Attribute is null/undefined          |
+
+Set `negate: true` on any condition to invert it.
+
+### Context attributes
+
+Built-in: `key`, `plan`, `region`, `email`, `role`.
+Custom attributes: prefix with `custom.` (e.g., `custom.betaTester`).
+
+## Percentage Rollouts
+
+```typescript
+rules: [
+  {
+    serve: {
+      rollout: [
+        { variant: 'treatment', weight: 20 },
+        { variant: 'control', weight: 80 },
+      ],
+    },
+  },
+]
+```
+
+Weights are percentages (sum to 100). Bucketing is deterministic: the same `ctx.key` always resolves to the same variant for a given flag.
+
+## Test Overrides
+
+```typescript
+client.overrideForTest('new-ui', 'on')
+client.isEnabled('new-ui', ctx)  // true, reason: 'override'
+
+client.clearOverride('new-ui')
+client.clearAllOverrides()
+```
+
+## Callbacks
+
+```typescript
+const client = createClient({
+  config,
+  onEvaluation: (result) => console.log(result),
+  onError: (err) => console.error(err),
+})
+```
+
+## License
+
+MIT

package/dist/__tests__/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/__tests__/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/client.test.js

@@ -0,0 +1,313 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const client_1 = require("../client");
+const errors_1 = require("../errors");
+const baseCtx = { key: 'user-abc' };
+const config = {
+    flags: [
+        // Boolean flag
+        {
+            key: 'feature-x',
+            type: 'boolean',
+            enabled: true,
+            variants: [
+                { key: 'on', value: true },
+                { key: 'off', value: false },
+            ],
+            defaultVariant: 'off',
+        },
+        // Boolean flag that is disabled at the flag level
+        {
+            key: 'feature-disabled',
+            type: 'boolean',
+            enabled: false,
+            variants: [
+                { key: 'on', value: true },
+                { key: 'off', value: false },
+            ],
+            defaultVariant: 'off',
+        },
+        // Prompt flag
+        {
+            key: 'system-prompt',
+            type: 'prompt',
+            enabled: true,
+            variants: [
+                { key: 'v1', value: 'You are a helpful assistant.' },
+                { key: 'v2', value: 'You are a concise assistant.' },
+            ],
+            defaultVariant: 'v1',
+        },
+        // Model flag
+        {
+            key: 'model-select',
+            type: 'model',
+            enabled: true,
+            variants: [
+                { key: 'fast', value: { model: 'gpt-3.5-turbo', temperature: 0.7 } },
+                { key: 'smart', value: { model: 'gpt-4o', temperature: 0.3 } },
+            ],
+            defaultVariant: 'fast',
+        },
+        // Config flag
+        {
+            key: 'rate-limit',
+            type: 'config',
+            enabled: true,
+            variants: [
+                { key: 'low', value: { rpm: 10 } },
+                { key: 'high', value: { rpm: 100 } },
+            ],
+            defaultVariant: 'low',
+        },
+        // Boolean flag with equals targeting rule
+        {
+            key: 'pro-feature',
+            type: 'boolean',
+            enabled: true,
+            variants: [
+                { key: 'on', value: true },
+                { key: 'off', value: false },
+            ],
+            defaultVariant: 'off',
+            rules: [
+                {
+                    conditions: [{ attribute: 'plan', operator: 'equals', value: 'pro' }],
+                    serve: { variant: 'on' },
+                },
+            ],
+        },
+        // Boolean flag with 'in' targeting rule
+        {
+            key: 'beta-feature',
+            type: 'boolean',
+            enabled: true,
+            variants: [
+                { key: 'on', value: true },
+                { key: 'off', value: false },
+            ],
+            defaultVariant: 'off',
+            rules: [
+                {
+                    conditions: [
+                        { attribute: 'plan', operator: 'in', values: ['beta', 'enterprise'] },
+                    ],
+                    serve: { variant: 'on' },
+                },
+            ],
+        },
+        // Rollout flag (50/50)
+        {
+            key: 'rollout-flag',
+            type: 'boolean',
+            enabled: true,
+            variants: [
+                { key: 'on', value: true },
+                { key: 'off', value: false },
+            ],
+            defaultVariant: 'off',
+            rules: [
+                {
+                    serve: {
+                        rollout: [
+                            { variant: 'on', weight: 50 },
+                            { variant: 'off', weight: 50 },
+                        ],
+                    },
+                },
+            ],
+        },
+        // Prompt flag with contains condition
+        {
+            key: 'email-prompt',
+            type: 'prompt',
+            enabled: true,
+            variants: [
+                { key: 'enterprise', value: 'Enterprise prompt.' },
+                { key: 'default', value: 'Default prompt.' },
+            ],
+            defaultVariant: 'default',
+            rules: [
+                {
+                    conditions: [{ attribute: 'email', operator: 'endsWith', value: '@corp.com' }],
+                    serve: { variant: 'enterprise' },
+                },
+            ],
+        },
+    ],
+};
+(0, vitest_1.describe)('createClient', () => {
+    let client;
+    (0, vitest_1.beforeEach)(() => {
+        client = (0, client_1.createClient)({ config });
+    });
+    (0, vitest_1.describe)('boolean flag: isEnabled', () => {
+        (0, vitest_1.it)('returns false for default off variant', () => {
+            (0, vitest_1.expect)(client.isEnabled('feature-x', baseCtx)).toBe(false);
+        });
+        (0, vitest_1.it)('returns false when flag is disabled (reason: disabled)', () => {
+            (0, vitest_1.expect)(client.isEnabled('feature-disabled', baseCtx)).toBe(false);
+        });
+        (0, vitest_1.it)('evaluate returns reason=disabled when flag.enabled=false', () => {
+            const result = client.evaluate('feature-disabled', baseCtx);
+            (0, vitest_1.expect)(result.reason).toBe('disabled');
+            (0, vitest_1.expect)(result.flagEnabled).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('prompt flag: getPrompt', () => {
+        (0, vitest_1.it)('returns default variant string', () => {
+            const prompt = client.getPrompt('system-prompt', baseCtx);
+            (0, vitest_1.expect)(prompt).toBe('You are a helpful assistant.');
+        });
+        (0, vitest_1.it)('throws FlagTypeMismatchError when called on a boolean flag', () => {
+            (0, vitest_1.expect)(() => client.getPrompt('feature-x', baseCtx)).toThrow(errors_1.FlagTypeMismatchError);
+        });
+    });
+    (0, vitest_1.describe)('model flag: getModel', () => {
+        (0, vitest_1.it)('returns default ModelConfig', () => {
+            const model = client.getModel('model-select', baseCtx);
+            (0, vitest_1.expect)(model).toEqual({ model: 'gpt-3.5-turbo', temperature: 0.7 });
+        });
+        (0, vitest_1.it)('throws FlagTypeMismatchError when called on a boolean flag', () => {
+            (0, vitest_1.expect)(() => client.getModel('feature-x', baseCtx)).toThrow(errors_1.FlagTypeMismatchError);
+        });
+    });
+    (0, vitest_1.describe)('config flag: getConfig', () => {
+        (0, vitest_1.it)('returns typed config value', () => {
+            const cfg = client.getConfig('rate-limit', baseCtx);
+            (0, vitest_1.expect)(cfg.rpm).toBe(10);
+        });
+    });
+    (0, vitest_1.describe)('targeting rules: equals condition', () => {
+        (0, vitest_1.it)('matches pro plan user and enables feature', () => {
+            const proCtx = { key: 'user-pro', plan: 'pro' };
+            (0, vitest_1.expect)(client.isEnabled('pro-feature', proCtx)).toBe(true);
+        });
+        (0, vitest_1.it)('does not match free plan user', () => {
+            const freeCtx = { key: 'user-free', plan: 'free' };
+            (0, vitest_1.expect)(client.isEnabled('pro-feature', freeCtx)).toBe(false);
+        });
+        (0, vitest_1.it)('evaluate returns reason=rule_match for matching rule', () => {
+            const proCtx = { key: 'user-pro', plan: 'pro' };
+            const result = client.evaluate('pro-feature', proCtx);
+            (0, vitest_1.expect)(result.reason).toBe('rule_match');
+            (0, vitest_1.expect)(result.variantKey).toBe('on');
+        });
+    });
+    (0, vitest_1.describe)('targeting rules: in condition', () => {
+        (0, vitest_1.it)('matches beta plan user', () => {
+            const betaCtx = { key: 'user-beta', plan: 'beta' };
+            (0, vitest_1.expect)(client.isEnabled('beta-feature', betaCtx)).toBe(true);
+        });
+        (0, vitest_1.it)('matches enterprise plan user', () => {
+            const entCtx = { key: 'user-ent', plan: 'enterprise' };
+            (0, vitest_1.expect)(client.isEnabled('beta-feature', entCtx)).toBe(true);
+        });
+        (0, vitest_1.it)('does not match free plan user', () => {
+            const freeCtx = { key: 'user-free', plan: 'free' };
+            (0, vitest_1.expect)(client.isEnabled('beta-feature', freeCtx)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('targeting rules: endsWith condition', () => {
+        (0, vitest_1.it)('returns enterprise prompt for corp email', () => {
+            const ctx = { key: 'u1', email: 'alice@corp.com' };
+            (0, vitest_1.expect)(client.getPrompt('email-prompt', ctx)).toBe('Enterprise prompt.');
+        });
+        (0, vitest_1.it)('returns default prompt for non-corp email', () => {
+            const ctx = { key: 'u2', email: 'bob@gmail.com' };
+            (0, vitest_1.expect)(client.getPrompt('email-prompt', ctx)).toBe('Default prompt.');
+        });
+    });
+    (0, vitest_1.describe)('rollout: deterministic bucketing', () => {
+        (0, vitest_1.it)('same context key always returns the same variant', () => {
+            const ctx = { key: 'stable-user' };
+            const first = client.evaluate('rollout-flag', ctx);
+            const second = client.evaluate('rollout-flag', ctx);
+            (0, vitest_1.expect)(first.variantKey).toBe(second.variantKey);
+        });
+        (0, vitest_1.it)('distributes roughly 50/50 across many users', () => {
+            let onCount = 0;
+            const total = 1000;
+            for (let i = 0; i < total; i++) {
+                const ctx = { key: `user-${i}` };
+                const result = client.evaluate('rollout-flag', ctx);
+                if (result.variantKey === 'on')
+                    onCount++;
+            }
+            // Expect between 40% and 60% (deterministic hash, not truly random)
+            (0, vitest_1.expect)(onCount).toBeGreaterThan(350);
+            (0, vitest_1.expect)(onCount).toBeLessThan(650);
+        });
+    });
+    (0, vitest_1.describe)('test overrides', () => {
+        (0, vitest_1.it)('overrideForTest forces a specific variant', () => {
+            client.overrideForTest('feature-x', 'on');
+            (0, vitest_1.expect)(client.isEnabled('feature-x', baseCtx)).toBe(true);
+            const result = client.evaluate('feature-x', baseCtx);
+            (0, vitest_1.expect)(result.reason).toBe('override');
+        });
+        (0, vitest_1.it)('clearOverride removes the override', () => {
+            client.overrideForTest('feature-x', 'on');
+            client.clearOverride('feature-x');
+            (0, vitest_1.expect)(client.isEnabled('feature-x', baseCtx)).toBe(false);
+        });
+        (0, vitest_1.it)('clearAllOverrides removes all overrides', () => {
+            client.overrideForTest('feature-x', 'on');
+            client.overrideForTest('feature-disabled', 'on');
+            client.clearAllOverrides();
+            (0, vitest_1.expect)(client.isEnabled('feature-x', baseCtx)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)('error cases', () => {
+        (0, vitest_1.it)('throws FlagNotFoundError for unknown flag key', () => {
+            (0, vitest_1.expect)(() => client.evaluate('nonexistent', baseCtx)).toThrow(errors_1.FlagNotFoundError);
+        });
+        (0, vitest_1.it)('FlagNotFoundError has the correct flagKey', () => {
+            try {
+                client.evaluate('nonexistent', baseCtx);
+                vitest_1.expect.fail('should have thrown');
+            }
+            catch (err) {
+                (0, vitest_1.expect)(err).toBeInstanceOf(errors_1.FlagNotFoundError);
+                (0, vitest_1.expect)(err.flagKey).toBe('nonexistent');
+            }
+        });
+        (0, vitest_1.it)('FlagTypeMismatchError has the correct code', () => {
+            try {
+                client.getPrompt('feature-x', baseCtx);
+                vitest_1.expect.fail('should have thrown');
+            }
+            catch (err) {
+                (0, vitest_1.expect)(err).toBeInstanceOf(errors_1.FlagTypeMismatchError);
+                (0, vitest_1.expect)(err.code).toBe('FLAG_TYPE_MISMATCH');
+            }
+        });
+    });
+    (0, vitest_1.describe)('utility methods', () => {
+        (0, vitest_1.it)('getFlagKeys returns all flag keys', () => {
+            const keys = client.getFlagKeys();
+            (0, vitest_1.expect)(keys).toContain('feature-x');
+            (0, vitest_1.expect)(keys).toContain('system-prompt');
+            (0, vitest_1.expect)(keys.length).toBe(config.flags.length);
+        });
+        (0, vitest_1.it)('getFlag returns FlagDefinition for known key', () => {
+            const flag = client.getFlag('feature-x');
+            (0, vitest_1.expect)(flag).not.toBeNull();
+            (0, vitest_1.expect)(flag.type).toBe('boolean');
+        });
+        (0, vitest_1.it)('getFlag returns null for unknown key', () => {
+            (0, vitest_1.expect)(client.getFlag('nope')).toBeNull();
+        });
+    });
+    (0, vitest_1.describe)('onEvaluation callback', () => {
+        (0, vitest_1.it)('calls onEvaluation with the result', () => {
+            const cb = vitest_1.vi.fn();
+            const c = (0, client_1.createClient)({ config, onEvaluation: cb });
+            c.isEnabled('feature-x', baseCtx);
+            (0, vitest_1.expect)(cb).toHaveBeenCalledOnce();
+            (0, vitest_1.expect)(cb.mock.calls[0][0].flagKey).toBe('feature-x');
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/__tests__/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":";;AAAA,mCAA6D;AAC7D,sCAAwC;AAMxC,sCAGkB;AAElB,MAAM,OAAO,GAAsB,EAAE,GAAG,EAAE,UAAU,EAAE,CAAA;AAEtD,MAAM,MAAM,GAAsB;IAChC,KAAK,EAAE;QACL,eAAe;QACf;YACE,GAAG,EAAE,WAAW;YAChB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC1B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;aAC7B;YACD,cAAc,EAAE,KAAK;SACtB;QACD,kDAAkD;QAClD;YACE,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC1B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;aAC7B;YACD,cAAc,EAAE,KAAK;SACtB;QACD,cAAc;QACd;YACE,GAAG,EAAE,eAAe;YACpB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,8BAA8B,EAAE;gBACpD,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,8BAA8B,EAAE;aACrD;YACD,cAAc,EAAE,IAAI;SACrB;QACD,aAAa;QACb;YACE,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE;gBACpE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE;aAC/D;YACD,cAAc,EAAE,MAAM;SACvB;QACD,cAAc;QACd;YACE,GAAG,EAAE,YAAY;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;gBAClC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;aACrC;YACD,cAAc,EAAE,KAAK;SACtB;QACD,0CAA0C;QAC1C;YACE,GAAG,EAAE,aAAa;YAClB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC1B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;aAC7B;YACD,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE;gBACL;oBACE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;oBACrE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;iBACzB;aACF;SACF;QACD,wCAAwC;QACxC;YACE,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC1B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;aAC7B;YACD,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE;gBACL;oBACE,UAAU,EAAE;wBACV,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE;qBACtE;oBACD,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;iBACzB;aACF;SACF;QACD,uBAAuB;QACvB;YACE,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC1B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;aAC7B;YACD,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE;gBACL;oBACE,KAAK,EAAE;wBACL,OAAO,EAAE;4BACP,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;4BAC7B,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;yBAC/B;qBACF;iBACF;aACF;SACF;QACD,sCAAsC;QACtC;YACE,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,oBAAoB,EAAE;gBAClD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE;aAC7C;YACD,cAAc,EAAE,SAAS;YACzB,KAAK,EAAE;gBACL;oBACE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;oBAC9E,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE;iBACjC;aACF;SACF;KACF;CACF,CAAA;AAED,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,MAAkB,CAAA;IAEtB,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,IAAA,WAAE,EAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnE,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAA;YAC3D,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACtC,IAAA,eAAM,EAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;YACzD,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;QACrD,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,8BAAqB,CAAC,CAAA;QACrF,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;YACtD,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAA;QACrE,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,8BAAqB,CAAC,CAAA;QACpF,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAkB,YAAY,EAAE,OAAO,CAAC,CAAA;YACpE,IAAA,eAAM,EAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,mCAAmC,EAAE,GAAG,EAAE;QACjD,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,MAAM,GAAsB,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;YAClE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,OAAO,GAAsB,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;YACrE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,MAAM,GAAsB,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;YAClE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;YACrD,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YACxC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,OAAO,GAAsB,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;YACrE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,MAAM,GAAsB,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAA;YACzE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7D,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,OAAO,GAAsB,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;YACrE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,qCAAqC,EAAE,GAAG,EAAE;QACnD,IAAA,WAAE,EAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,GAAG,GAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAA;YACrE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC1E,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAA;YACpE,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QACvE,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,IAAA,WAAE,EAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,GAAG,GAAsB,EAAE,GAAG,EAAE,aAAa,EAAE,CAAA;YACrD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;YAClD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;YACnD,IAAA,eAAM,EAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAClD,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,MAAM,KAAK,GAAG,IAAI,CAAA;YAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAsB,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAA;gBACnD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAU,cAAc,EAAE,GAAG,CAAC,CAAA;gBAC5D,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;oBAAE,OAAO,EAAE,CAAA;YAC3C,CAAC;YACD,oEAAoE;YACpE,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;YACpC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;YACzC,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;YACpD,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACxC,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;YACzC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;YACjC,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;YACzC,MAAM,CAAC,eAAe,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAA;YAChD,MAAM,CAAC,iBAAiB,EAAE,CAAA;YAC1B,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,IAAA,WAAE,EAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,0BAAiB,CAAC,CAAA;QAClF,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;gBACvC,eAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YACnC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,cAAc,CAAC,0BAAiB,CAAC,CAAA;gBAC7C,IAAA,eAAM,EAAE,GAAyB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YAChE,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,IAAI,CAAC;gBACH,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;gBACtC,eAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YACnC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,cAAc,CAAC,8BAAqB,CAAC,CAAA;gBACjD,IAAA,eAAM,EAAE,GAA6B,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YACxE,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,IAAA,WAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;YACjC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YACnC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;YACvC,IAAA,eAAM,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;YACxC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;YAC3B,IAAA,eAAM,EAAC,IAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QAEF,IAAA,WAAE,EAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC3C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,EAAE,GAAG,WAAE,CAAC,EAAE,EAAE,CAAA;YAClB,MAAM,CAAC,GAAG,IAAA,qBAAY,EAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAA;YACpD,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;YACjC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAA;YACjC,IAAA,eAAM,EAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/bucket.d.ts

@@ -0,0 +1,6 @@
+export declare function getBucket(contextKey: string, flagKey: string): number;
+export declare function selectVariantByRollout(rollout: Array<{
+    variant: string;
+    weight: number;
+}>, bucket: number): string;
+//# sourceMappingURL=bucket.d.ts.map

package/dist/bucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket.d.ts","sourceRoot":"","sources":["../src/bucket.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACnD,MAAM,EAAE,MAAM,GACb,MAAM,CAQR"}

package/dist/bucket.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBucket = getBucket;
+exports.selectVariantByRollout = selectVariantByRollout;
+const murmurhash3js_1 = __importDefault(require("murmurhash3js"));
+function getBucket(contextKey, flagKey) {
+    const hash = murmurhash3js_1.default.x86.hash32(`${contextKey}:${flagKey}`, 0);
+    return Math.abs(hash) % 10000;
+}
+function selectVariantByRollout(rollout, bucket) {
+    const total = rollout.reduce((s, r) => s + r.weight, 0);
+    let cumulative = 0;
+    for (const r of rollout) {
+        cumulative += (r.weight / total) * 10000;
+        if (bucket < cumulative)
+            return r.variant;
+    }
+    return rollout[rollout.length - 1].variant;
+}
+//# sourceMappingURL=bucket.js.map

package/dist/bucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket.js","sourceRoot":"","sources":["../src/bucket.ts"],"names":[],"mappings":";;;;;AAEA,8BAGC;AAED,wDAWC;AAlBD,kEAAkC;AAElC,SAAgB,SAAS,CAAC,UAAkB,EAAE,OAAe;IAC3D,MAAM,IAAI,GAAG,uBAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,UAAU,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;AAC/B,CAAC;AAED,SAAgB,sBAAsB,CACpC,OAAmD,EACnD,MAAc;IAEd,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACvD,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,UAAU,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA;QACxC,IAAI,MAAM,GAAG,UAAU;YAAE,OAAO,CAAC,CAAC,OAAO,CAAA;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAA;AAC5C,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import { FlagClient, FlagClientConfig } from './types';
+export declare function createClient(config: FlagClientConfig): FlagClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,gBAAgB,EAKjB,MAAM,SAAS,CAAA;AAIhB,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAwFjE"}

package/dist/client.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+const errors_1 = require("./errors");
+const evaluate_1 = require("./evaluate");
+function createClient(config) {
+    const flagMap = new Map();
+    const overrides = new Map();
+    for (const flag of config.config.flags) {
+        flagMap.set(flag.key, flag);
+    }
+    function resolveFlag(key) {
+        const flag = flagMap.get(key);
+        if (!flag)
+            throw new errors_1.FlagNotFoundError(key);
+        return flag;
+    }
+    function runEvaluate(key, ctx) {
+        const flag = resolveFlag(key);
+        const mergedCtx = { ...config.defaultContext, ...ctx };
+        const result = (0, evaluate_1.evaluate)(flag, mergedCtx, overrides);
+        config.onEvaluation?.(result);
+        return result;
+    }
+    return {
+        evaluate(key, ctx) {
+            try {
+                return runEvaluate(key, ctx);
+            }
+            catch (err) {
+                config.onError?.(err);
+                throw err;
+            }
+        },
+        getPrompt(key, ctx) {
+            const flag = resolveFlag(key);
+            if (flag.type !== 'prompt') {
+                throw new errors_1.FlagTypeMismatchError(key, 'prompt', flag.type);
+            }
+            const result = runEvaluate(key, ctx);
+            return result.value;
+        },
+        getModel(key, ctx) {
+            const flag = resolveFlag(key);
+            if (flag.type !== 'model') {
+                throw new errors_1.FlagTypeMismatchError(key, 'model', flag.type);
+            }
+            const result = runEvaluate(key, ctx);
+            return result.value;
+        },
+        getConfig(key, ctx) {
+            const flag = resolveFlag(key);
+            if (flag.type !== 'config') {
+                throw new errors_1.FlagTypeMismatchError(key, 'config', flag.type);
+            }
+            const result = runEvaluate(key, ctx);
+            return result.value;
+        },
+        isEnabled(key, ctx) {
+            const flag = resolveFlag(key);
+            if (flag.type !== 'boolean') {
+                throw new errors_1.FlagTypeMismatchError(key, 'boolean', flag.type);
+            }
+            const result = runEvaluate(key, ctx);
+            return result.value;
+        },
+        getFlagKeys() {
+            return Array.from(flagMap.keys());
+        },
+        getFlag(key) {
+            return flagMap.get(key) ?? null;
+        },
+        overrideForTest(key, variantKey) {
+            overrides.set(key, variantKey);
+        },
+        clearOverride(key) {
+            overrides.delete(key);
+        },
+        clearAllOverrides() {
+            overrides.clear();
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/conditions.d.ts

@@ -0,0 +1,5 @@
+import { EvaluationContext, RuleCondition, TargetingRule } from './types';
+export declare function getAttributeValue(ctx: EvaluationContext, attribute: string): unknown;
+export declare function evaluateCondition(ctx: EvaluationContext, condition: RuleCondition): boolean;
+export declare function evaluateRule(ctx: EvaluationContext, rule: TargetingRule): boolean;
+//# sourceMappingURL=conditions.d.ts.map

package/dist/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../src/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEzE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAapF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAsD3F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAGjF"}

package/dist/conditions.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAttributeValue = getAttributeValue;
+exports.evaluateCondition = evaluateCondition;
+exports.evaluateRule = evaluateRule;
+function getAttributeValue(ctx, attribute) {
+    if (attribute.startsWith('custom.')) {
+        const subKey = attribute.slice('custom.'.length);
+        return ctx.custom?.[subKey];
+    }
+    switch (attribute) {
+        case 'key': return ctx.key;
+        case 'plan': return ctx.plan;
+        case 'region': return ctx.region;
+        case 'email': return ctx.email;
+        case 'role': return ctx.role;
+        default: return undefined;
+    }
+}
+function evaluateCondition(ctx, condition) {
+    const attrValue = getAttributeValue(ctx, condition.attribute);
+    const { operator, value, values, negate } = condition;
+    let result;
+    switch (operator) {
+        case 'equals':
+            result = String(attrValue) === String(value);
+            break;
+        case 'notEquals':
+            result = String(attrValue) !== String(value);
+            break;
+        case 'in':
+            result = (values ?? []).map(String).includes(String(attrValue));
+            break;
+        case 'notIn':
+            result = !(values ?? []).map(String).includes(String(attrValue));
+            break;
+        case 'contains':
+            result = typeof attrValue === 'string' && attrValue.includes(String(value));
+            break;
+        case 'startsWith':
+            result = typeof attrValue === 'string' && attrValue.startsWith(String(value));
+            break;
+        case 'endsWith':
+            result = typeof attrValue === 'string' && attrValue.endsWith(String(value));
+            break;
+        case 'greaterThan':
+            result = Number(attrValue) > Number(value);
+            break;
+        case 'lessThan':
+            result = Number(attrValue) < Number(value);
+            break;
+        case 'greaterThanOrEqual':
+            result = Number(attrValue) >= Number(value);
+            break;
+        case 'lessThanOrEqual':
+            result = Number(attrValue) <= Number(value);
+            break;
+        case 'matches':
+            result = typeof attrValue === 'string' && new RegExp(String(value)).test(attrValue);
+            break;
+        case 'exists':
+            result = attrValue !== undefined && attrValue !== null;
+            break;
+        case 'notExists':
+            result = attrValue === undefined || attrValue === null;
+            break;
+        default:
+            result = false;
+    }
+    return negate === true ? !result : result;
+}
+function evaluateRule(ctx, rule) {
+    if (!rule.conditions || rule.conditions.length === 0)
+        return true;
+    return rule.conditions.every((cond) => evaluateCondition(ctx, cond));
+}
+//# sourceMappingURL=conditions.js.map

package/dist/conditions.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+export declare class FlagError extends Error {
+    readonly code: string;
+    constructor(msg: string, code: string);
+}
+export declare class FlagNotFoundError extends FlagError {
+    readonly flagKey: string;
+    constructor(flagKey: string);
+}
+export declare class FlagTypeMismatchError extends FlagError {
+    readonly flagKey: string;
+    constructor(flagKey: string, expected: string, actual: string);
+}
+export declare class VariantNotFoundError extends FlagError {
+    readonly flagKey: string;
+    constructor(flagKey: string, variantKey: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;IACT,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAlC,GAAG,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM;CAI/C;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAIrC;AAED,qBAAa,qBAAsB,SAAQ,SAAS;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIvE;AAED,qBAAa,oBAAqB,SAAQ,SAAS;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIzD"}

package/dist/errors.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariantNotFoundError = exports.FlagTypeMismatchError = exports.FlagNotFoundError = exports.FlagError = void 0;
+class FlagError extends Error {
+    code;
+    constructor(msg, code) {
+        super(msg);
+        this.code = code;
+        this.name = 'FlagError';
+    }
+}
+exports.FlagError = FlagError;
+class FlagNotFoundError extends FlagError {
+    flagKey;
+    constructor(flagKey) {
+        super(`Flag not found: "${flagKey}"`, 'FLAG_NOT_FOUND');
+        this.flagKey = flagKey;
+        this.name = 'FlagNotFoundError';
+    }
+}
+exports.FlagNotFoundError = FlagNotFoundError;
+class FlagTypeMismatchError extends FlagError {
+    flagKey;
+    constructor(flagKey, expected, actual) {
+        super(`Type mismatch for "${flagKey}": expected ${expected}, got ${actual}`, 'FLAG_TYPE_MISMATCH');
+        this.flagKey = flagKey;
+        this.name = 'FlagTypeMismatchError';
+    }
+}
+exports.FlagTypeMismatchError = FlagTypeMismatchError;
+class VariantNotFoundError extends FlagError {
+    flagKey;
+    constructor(flagKey, variantKey) {
+        super(`Variant "${variantKey}" not found in flag "${flagKey}"`, 'VARIANT_NOT_FOUND');
+        this.flagKey = flagKey;
+        this.name = 'VariantNotFoundError';
+    }
+}
+exports.VariantNotFoundError = VariantNotFoundError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAU,SAAQ,KAAK;IACA;IAAlC,YAAY,GAAW,EAAW,IAAY;QAC5C,KAAK,CAAC,GAAG,CAAC,CAAA;QADsB,SAAI,GAAJ,IAAI,CAAQ;QAE5C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,CAAC;CACF;AALD,8BAKC;AAED,MAAa,iBAAkB,SAAQ,SAAS;IACzB;IAArB,YAAqB,OAAe;QAClC,KAAK,CAAC,oBAAoB,OAAO,GAAG,EAAE,gBAAgB,CAAC,CAAA;QADpC,YAAO,GAAP,OAAO,CAAQ;QAElC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AALD,8CAKC;AAED,MAAa,qBAAsB,SAAQ,SAAS;IAC7B;IAArB,YAAqB,OAAe,EAAE,QAAgB,EAAE,MAAc;QACpE,KAAK,CAAC,sBAAsB,OAAO,eAAe,QAAQ,SAAS,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAA;QAD/E,YAAO,GAAP,OAAO,CAAQ;QAElC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,oBAAqB,SAAQ,SAAS;IAC5B;IAArB,YAAqB,OAAe,EAAE,UAAkB;QACtD,KAAK,CAAC,YAAY,UAAU,wBAAwB,OAAO,GAAG,EAAE,mBAAmB,CAAC,CAAA;QADjE,YAAO,GAAP,OAAO,CAAQ;QAElC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AALD,oDAKC"}

package/dist/evaluate.d.ts

@@ -0,0 +1,4 @@
+import { FlagDefinition, EvaluationContext, EvaluationResult } from './types';
+export declare function getVariantValue(flag: FlagDefinition, variantKey: string): unknown;
+export declare function evaluate<T>(flag: FlagDefinition, ctx: EvaluationContext, overrides: Map<string, string>): EvaluationResult<T>;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAK7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAMjF;AAED,wBAAgB,QAAQ,CAAC,CAAC,EACxB,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,gBAAgB,CAAC,CAAC,CAAC,CA+DrB"}

package/dist/evaluate.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVariantValue = getVariantValue;
+exports.evaluate = evaluate;
+const errors_1 = require("./errors");
+const bucket_1 = require("./bucket");
+const conditions_1 = require("./conditions");
+function getVariantValue(flag, variantKey) {
+    const variant = flag.variants.find((v) => v.key === variantKey);
+    if (!variant) {
+        throw new errors_1.VariantNotFoundError(flag.key, variantKey);
+    }
+    return variant.value;
+}
+function evaluate(flag, ctx, overrides) {
+    const flagEnabled = flag.enabled !== false;
+    // 1. Check overrides
+    const overrideVariantKey = overrides.get(flag.key);
+    if (overrideVariantKey !== undefined) {
+        const value = getVariantValue(flag, overrideVariantKey);
+        return {
+            flagKey: flag.key,
+            variantKey: overrideVariantKey,
+            value,
+            reason: 'override',
+            flagEnabled,
+        };
+    }
+    // 2. If disabled, return default variant
+    if (!flagEnabled) {
+        const value = getVariantValue(flag, flag.defaultVariant);
+        return {
+            flagKey: flag.key,
+            variantKey: flag.defaultVariant,
+            value,
+            reason: 'disabled',
+            flagEnabled: false,
+        };
+    }
+    // 3. Evaluate targeting rules
+    for (const rule of flag.rules ?? []) {
+        if ((0, conditions_1.evaluateRule)(ctx, rule)) {
+            const serve = rule.serve;
+            let resolvedVariantKey;
+            if ('variant' in serve) {
+                resolvedVariantKey = serve.variant;
+            }
+            else {
+                const bucket = (0, bucket_1.getBucket)(ctx.key, flag.key);
+                resolvedVariantKey = (0, bucket_1.selectVariantByRollout)(serve.rollout, bucket);
+            }
+            const value = getVariantValue(flag, resolvedVariantKey);
+            return {
+                flagKey: flag.key,
+                variantKey: resolvedVariantKey,
+                value,
+                reason: 'rule_match',
+                flagEnabled: true,
+            };
+        }
+    }
+    // 4. No rule matched — return default
+    const value = getVariantValue(flag, flag.defaultVariant);
+    return {
+        flagKey: flag.key,
+        variantKey: flag.defaultVariant,
+        value,
+        reason: 'default',
+        flagEnabled: true,
+    };
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":";;AAKA,0CAMC;AAED,4BAmEC;AA/ED,qCAA+C;AAC/C,qCAA4D;AAC5D,6CAA2C;AAE3C,SAAgB,eAAe,CAAC,IAAoB,EAAE,UAAkB;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC,CAAA;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,6BAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAA;AACtB,CAAC;AAED,SAAgB,QAAQ,CACtB,IAAoB,EACpB,GAAsB,EACtB,SAA8B;IAE9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAA;IAE1C,qBAAqB;IACrB,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClD,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAM,CAAA;QAC5D,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,UAAU,EAAE,kBAAkB;YAC9B,KAAK;YACL,MAAM,EAAE,UAAU;YAClB,WAAW;SACZ,CAAA;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAM,CAAA;QAC7D,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,UAAU,EAAE,IAAI,CAAC,cAAc;YAC/B,KAAK;YACL,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,KAAK;SACnB,CAAA;IACH,CAAC;IAED,8BAA8B;IAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,IAAA,yBAAY,EAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAEwC,CAAA;YAE3D,IAAI,kBAA0B,CAAA;YAC9B,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;gBACvB,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAA;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC3C,kBAAkB,GAAG,IAAA,+BAAsB,EAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACpE,CAAC;YAED,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAM,CAAA;YAC5D,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,GAAG;gBACjB,UAAU,EAAE,kBAAkB;gBAC9B,KAAK;gBACL,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,IAAI;aAClB,CAAA;QACH,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAM,CAAA;IAC7D,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,UAAU,EAAE,IAAI,CAAC,cAAc;QAC/B,KAAK;QACL,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,IAAI;KAClB,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createClient } from './client';
+export type { FlagType, EvaluationReason, ComparisonOperator, EvaluationContext, ModelConfig, RuleCondition, TargetingRule, FlagVariant, FlagDefinition, FlagConfiguration, EvaluationResult, FlagClientConfig, FlagClient, } from './types';
+export { FlagError, FlagNotFoundError, FlagTypeMismatchError, VariantNotFoundError, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariantNotFoundError = exports.FlagTypeMismatchError = exports.FlagNotFoundError = exports.FlagError = exports.createClient = void 0;
+// prompt-flags - AI-native feature flags for prompt variants and model selection
+var client_1 = require("./client");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "FlagError", { enumerable: true, get: function () { return errors_1.FlagError; } });
+Object.defineProperty(exports, "FlagNotFoundError", { enumerable: true, get: function () { return errors_1.FlagNotFoundError; } });
+Object.defineProperty(exports, "FlagTypeMismatchError", { enumerable: true, get: function () { return errors_1.FlagTypeMismatchError; } });
+Object.defineProperty(exports, "VariantNotFoundError", { enumerable: true, get: function () { return errors_1.VariantNotFoundError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iFAAiF;AACjF,mCAAuC;AAA9B,sGAAA,YAAY,OAAA;AAgBrB,mCAKiB;AAJf,mGAAA,SAAS,OAAA;AACT,2GAAA,iBAAiB,OAAA;AACjB,+GAAA,qBAAqB,OAAA;AACrB,8GAAA,oBAAoB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export type FlagType = 'prompt' | 'model' | 'config' | 'boolean';
+export type EvaluationReason = 'rule_match' | 'default' | 'disabled' | 'error' | 'override';
+export type ComparisonOperator = 'equals' | 'notEquals' | 'in' | 'notIn' | 'contains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'matches' | 'exists' | 'notExists';
+export interface EvaluationContext {
+    key: string;
+    plan?: string;
+    region?: string;
+    email?: string;
+    role?: string;
+    custom?: Record<string, string | number | boolean | string[]>;
+}
+export interface ModelConfig {
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    [k: string]: unknown;
+}
+export interface RuleCondition {
+    attribute: string;
+    operator: ComparisonOperator;
+    value?: string | number | boolean;
+    values?: (string | number)[];
+    negate?: boolean;
+}
+export interface TargetingRule {
+    description?: string;
+    conditions?: RuleCondition[];
+    serve: {
+        variant: string;
+    } | {
+        rollout: Array<{
+            variant: string;
+            weight: number;
+        }>;
+    };
+}
+export interface FlagVariant {
+    key: string;
+    value: unknown;
+}
+export interface FlagDefinition {
+    key: string;
+    type: FlagType;
+    enabled?: boolean;
+    variants: FlagVariant[];
+    defaultVariant: string;
+    rules?: TargetingRule[];
+}
+export interface FlagConfiguration {
+    flags: FlagDefinition[];
+    segments?: Record<string, {
+        conditions: RuleCondition[];
+    }>;
+}
+export interface EvaluationResult<T = unknown> {
+    flagKey: string;
+    variantKey: string;
+    value: T;
+    reason: EvaluationReason;
+    flagEnabled: boolean;
+}
+export interface FlagClientConfig {
+    config: FlagConfiguration;
+    defaultContext?: Partial<EvaluationContext>;
+    onEvaluation?: (e: EvaluationResult<unknown>) => void;
+    onError?: (e: Error) => void;
+}
+export interface FlagClient {
+    getPrompt(key: string, ctx: EvaluationContext): string;
+    getModel(key: string, ctx: EvaluationContext): ModelConfig;
+    getConfig<T>(key: string, ctx: EvaluationContext): T;
+    isEnabled(key: string, ctx: EvaluationContext): boolean;
+    evaluate<T>(key: string, ctx: EvaluationContext): EvaluationResult<T>;
+    getFlagKeys(): string[];
+    getFlag(key: string): FlagDefinition | null;
+    overrideForTest(key: string, variantKey: string): void;
+    clearOverride(key: string): void;
+    clearAllOverrides(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "prompt-flags",
+  "version": "0.1.0",
+  "description": "AI-native feature flags for prompt variants and model selection",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "murmurhash3js": "^3.0.1"
+  },
+  "devDependencies": {
+    "@types/murmurhash3js": "^3.0.3",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.5.0"
+  }
+}