shield360 1.1.0 → 1.2.1

package/dist/flags/__tests__/flags.test.js

@@ -0,0 +1,301 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const api_1 = require("@opentelemetry/api");
+const config_1 = __importDefault(require("../../config"));
+const engine = __importStar(require("../engine"));
+const client_1 = require("../client");
+const index_1 = __importDefault(require("../../index"));
+/** Beside this SDK in the monorepo (sdk/flags-core), or inside the SDK's public mirror (flags-core/). */
+function flagsCore(...parts) {
+    const candidates = [path.resolve(__dirname, '../../../../flags-core', ...parts), path.resolve(__dirname, '../../../flags-core', ...parts)];
+    return candidates.find((p) => fs.existsSync(p)) ?? candidates[0];
+}
+const vectors = JSON.parse(fs.readFileSync(flagsCore('testdata', 'vectors.json'), 'utf8'));
+describe('the engine', () => {
+    it('is a byte-identical copy of sdk/flags-core', () => {
+        expect(fs.readFileSync(path.resolve(__dirname, '../engine.ts'), 'utf8')).toBe(fs.readFileSync(flagsCore('src', 'engine.ts'), 'utf8'));
+    });
+    for (const c of vectors.evaluations) {
+        it(`evaluates: ${c.name}`, () => {
+            expect(engine.evaluate(c.flag, c.context, c.segments)).toEqual(c.expect);
+        });
+    }
+    for (const c of vectors.segmentValidation) {
+        it(`validates segment: ${c.name}`, () => {
+            expect(engine.validateSegment(c.segment)).toEqual(c.errors);
+        });
+    }
+    for (const c of vectors.validation) {
+        it(`validates: ${c.name}`, () => {
+            expect(engine.validateFlag(c.flag)).toEqual(c.errors);
+        });
+    }
+    it('hashes and formats like every other SDK', () => {
+        for (const c of vectors.murmur3)
+            expect(engine.murmur3(c.input)).toBe(c.murmur3);
+        for (const c of vectors.text)
+            expect(engine.textOf(c.value)).toBe(c.text);
+    });
+});
+const FLAG = {
+    key: 'new-checkout',
+    type: 'boolean',
+    variations: [
+        { key: 'on', value: true },
+        { key: 'off', value: false },
+    ],
+    offVariation: 'off',
+    on: true,
+    rules: [{ id: 'pro', conditions: [{ attribute: 'plan', operator: 'equals', values: ['pro'] }], serve: { variation: 'on' } }],
+    fallthrough: { variation: 'off' },
+    salt: 's1',
+    version: 3,
+    appName: null,
+};
+const MODEL = {
+    key: 'model-choice',
+    type: 'string',
+    variations: [
+        { key: 'a', value: 'gpt-4o-mini' },
+        { key: 'b', value: 'claude-haiku' },
+    ],
+    offVariation: 'a',
+    on: true,
+    rules: [],
+    fallthrough: { variation: 'b' },
+    salt: 's2',
+    appName: 'checkout-api',
+};
+function fakeFetch(replies) {
+    const calls = [];
+    const fn = jest.fn(async (url, init) => {
+        calls.push({ url, headers: init.headers });
+        const reply = replies.length > 1 ? replies.shift() : replies[0];
+        if (reply instanceof Error)
+            throw reply;
+        return {
+            status: reply.status,
+            ok: reply.status >= 200 && reply.status < 300,
+            headers: { get: (name) => (name.toLowerCase() === 'etag' ? reply.etag ?? null : null) },
+            json: async () => reply.body,
+        };
+    });
+    return { fn: fn, calls };
+}
+const client = (replies, extra = {}) => {
+    const f = fakeFetch(replies);
+    const c = new client_1.FlagsClient({ url: 'https://s360.test/', apiKey: 'k1', applicationName: 'checkout-api', fetch: f.fn, ...extra });
+    return { c, calls: f.calls };
+};
+afterEach(() => jest.restoreAllMocks());
+describe('FlagsClient', () => {
+    it('serves defaults until rules arrive, then evaluates locally', async () => {
+        const { c, calls } = client([{ status: 200, body: { version: 'v1', flags: [FLAG, MODEL] }, etag: '"v1"' }]);
+        expect(c.isEnabled('new-checkout', { plan: 'pro' })).toBe(false);
+        expect(c.getFlagDetail('new-checkout', {}, false).reason.kind).toBe('NOT_READY');
+        expect(await c.ready(1000)).toBe(true);
+        expect(calls[0]).toEqual({ url: 'https://s360.test/api/flags/rules', headers: { Authorization: 'Bearer k1', Accept: 'application/json' } });
+        expect(c.isEnabled('new-checkout', { key: 'u1', plan: 'pro' })).toBe(true);
+        expect(c.isEnabled('new-checkout', { key: 'u1', plan: 'free' })).toBe(false);
+        const model = c.getFlag('model-choice', { key: 'u1' }, 'gpt-4o-mini');
+        expect(model).toBe('claude-haiku');
+        expect(c.getFlag('missing', {}, 'fallback')).toBe('fallback');
+        c.close();
+    });
+    it('sends the ETag back and keeps the rules on a 304', async () => {
+        const { c, calls } = client([
+            { status: 200, body: { version: 'v1', flags: [FLAG] }, etag: '"v1"' },
+            { status: 304, etag: '"v1"' },
+        ]);
+        await c.refresh();
+        await c.refresh();
+        expect(calls[1].headers['If-None-Match']).toBe('"v1"');
+        expect(c.isEnabled('new-checkout', { plan: 'pro' })).toBe(true);
+    });
+    it('keeps the last good rules through errors, and never throws', async () => {
+        const { c } = client([{ status: 200, body: { flags: [FLAG] }, etag: '"v1"' }, { status: 500 }, new Error('offline'), { status: 200, body: 'garbage' }]);
+        await c.refresh();
+        expect(await c.refresh()).toBe(false);
+        expect(await c.refresh()).toBe(false);
+        expect(await c.refresh()).toBe(false);
+        expect(c.isEnabled('new-checkout', { plan: 'pro' })).toBe(true);
+        expect(() => c.getFlag('new-checkout', null, true)).not.toThrow();
+    });
+    it('leaves out a flag that does not validate, and one for another app', async () => {
+        const broken = { ...FLAG, key: 'broken', offVariation: 'nope' };
+        const { c } = client([{ status: 200, body: { flags: [broken, MODEL] } }], { applicationName: 'billing' });
+        await c.refresh();
+        expect(c.getFlagDetail('broken', {}, true)).toEqual({ value: true, variation: null, reason: { kind: 'FLAG_NOT_FOUND' } });
+        expect(c.getFlagDetail('model-choice', {}, 'x').reason.kind).toBe('FLAG_NOT_FOUND');
+    });
+    it('returns the default when the flag is of another type', async () => {
+        const { c } = client([{ status: 200, body: { flags: [MODEL] } }]);
+        await c.refresh();
+        expect(c.getFlagDetail('model-choice', {}, 7)).toEqual({ value: 7, variation: null, reason: { kind: 'WRONG_TYPE' } });
+    });
+    it('stamps the served variation on the active span', async () => {
+        const setAttribute = jest.fn();
+        jest.spyOn(api_1.trace, 'getActiveSpan').mockReturnValue({ isRecording: () => true, setAttribute });
+        const { c } = client([{ status: 200, body: { flags: [FLAG] } }]);
+        await c.refresh();
+        c.isEnabled('new-checkout', { plan: 'pro' });
+        expect(setAttribute).toHaveBeenCalledWith('shield360.flag.new-checkout', 'on');
+        setAttribute.mockClear();
+        c.isEnabled('missing', {});
+        expect(setAttribute).not.toHaveBeenCalled();
+    });
+    it('does nothing without a URL and key, and uses init()\'s when it has them', async () => {
+        const f = fakeFetch([{ status: 200, body: { flags: [FLAG] } }]);
+        const saved = { url: config_1.default.shield360Url, key: config_1.default.shield360ApiKey, env: { ...process.env } };
+        delete process.env.SHIELD360_URL;
+        delete process.env.SHIELD360_API_KEY;
+        config_1.default.shield360Url = undefined;
+        config_1.default.shield360ApiKey = undefined;
+        try {
+            const c = new client_1.FlagsClient({ fetch: f.fn });
+            expect(await c.refresh()).toBe(false);
+            expect(f.calls).toHaveLength(0);
+            config_1.default.shield360Url = 'https://from-init.test';
+            config_1.default.shield360ApiKey = 'init-key';
+            expect(await c.refresh()).toBe(true);
+            expect(f.calls[0].url).toBe('https://from-init.test/api/flags/rules');
+        }
+        finally {
+            config_1.default.shield360Url = saved.url;
+            config_1.default.shield360ApiKey = saved.key;
+            process.env = saved.env;
+        }
+    });
+    it('polls on a timer that does not keep the process alive', async () => {
+        jest.useFakeTimers();
+        try {
+            const { c, calls } = client([{ status: 200, body: { flags: [FLAG] } }], { pollIntervalMs: 5000 });
+            c.start();
+            await jest.advanceTimersByTimeAsync(0);
+            expect(calls).toHaveLength(1);
+            await jest.advanceTimersByTimeAsync(5600);
+            expect(calls).toHaveLength(2);
+            c.close();
+            await jest.advanceTimersByTimeAsync(20000);
+            expect(calls).toHaveLength(2);
+        }
+        finally {
+            jest.useRealTimers();
+        }
+    });
+    it('is on the SDK as Shield360.flags', () => {
+        expect(index_1.default.flags).toBeInstanceOf(client_1.FlagsClient);
+    });
+});
+describe('segments and AI helpers', () => {
+    const SEGMENTED = {
+        ...MODEL,
+        key: 'support-model',
+        appName: null,
+        variations: [
+            { key: 'premium', value: 'openai/gpt-4o' },
+            { key: 'cheap', value: 'openai/gpt-4o-mini' },
+        ],
+        offVariation: 'cheap',
+        rules: [{ id: 'beta', conditions: [{ attribute: 'segment', operator: 'in_segment', values: ['beta-users'] }], serve: { variation: 'cheap' } }],
+        fallthrough: { variation: 'premium' },
+    };
+    const BETA = { key: 'beta-users', conditions: [{ attribute: 'groups', operator: 'in', values: ['beta'] }] };
+    const KILL = { ...FLAG, key: 'summaries', rules: [], fallthrough: { variation: 'on' } };
+    const PROMPT = {
+        key: 'support-prompt',
+        type: 'json',
+        variations: [
+            { key: 'v1', value: { name: 'support-reply', version: '1.0.0' } },
+            { key: 'v2', value: 'support-reply@2.0.0' },
+        ],
+        offVariation: 'v1',
+        on: true,
+        rules: [],
+        fallthrough: { variation: 'v2' },
+        salt: 's3',
+    };
+    it('evaluates rules that name segments from the feed, and drops invalid segments', async () => {
+        const { c } = client([{ status: 200, body: { version: 'v1', flags: [SEGMENTED], segments: [BETA, { key: 'bad', conditions: [] }] }, etag: '"v1"' }]);
+        await c.ready(1000);
+        expect(c.model('support-model', { key: 'u1', groups: ['beta'] }, 'x/y')).toBe('openai/gpt-4o-mini');
+        expect(c.model('support-model', { key: 'u1', groups: ['staff'] }, 'x/y')).toBe('openai/gpt-4o');
+        expect(c.model('missing', { key: 'u1' }, 'x/y')).toBe('x/y');
+        c.close();
+    });
+    it('engages a kill switch only when the flag says so', async () => {
+        const { c } = client([{ status: 200, body: { version: 'v1', flags: [KILL, { ...KILL, key: 'killed', on: false }] } }]);
+        expect(c.killSwitch('summaries')).toBe(false); // not ready: keep running
+        await c.ready(1000);
+        expect(c.killSwitch('summaries', { key: 'u1' })).toBe(false);
+        expect(c.killSwitch('killed', { key: 'u1' })).toBe(true);
+        expect(c.killSwitch('unknown', { key: 'u1' })).toBe(false);
+        c.close();
+    });
+    it('fetches the Prompt Hub version a prompt flag serves, and never rejects', async () => {
+        const { c } = client([{ status: 200, body: { version: 'v1', flags: [PROMPT] } }]);
+        await c.ready(1000);
+        const hub = jest.spyOn(globalThis, 'fetch').mockImplementation((async (_url, init) => ({
+            ok: true,
+            status: 200,
+            json: async () => ({ err: null, res: { name: JSON.parse(init.body).name, version: JSON.parse(init.body).version, prompt: 'Hello' } }),
+        })));
+        const served = await c.prompt('support-prompt', { key: 'u1' }, { name: 'fallback' });
+        expect(served).toMatchObject({ name: 'support-reply', version: '2.0.0', variation: 'v2', error: null, prompt: { version: '2.0.0' } });
+        const fallback = await c.prompt('missing', { key: 'u1' }, { name: 'fallback', version: '3' });
+        expect(fallback).toMatchObject({ name: 'fallback', version: '3', variation: null });
+        hub.mockImplementation((async () => {
+            throw new Error('down');
+        }));
+        const failed = await c.prompt('support-prompt', { key: 'u1' }, { name: 'fallback' });
+        expect(failed.prompt).toBeNull();
+        expect(failed.error).toContain('down');
+        c.close();
+    });
+    it('reads prompt references from objects and name@version text', () => {
+        expect((0, client_1.promptRefOf)('a@1.2')).toEqual({ name: 'a', version: '1.2' });
+        expect((0, client_1.promptRefOf)('a')).toEqual({ name: 'a' });
+        expect((0, client_1.promptRefOf)('@1')).toBeNull();
+        expect((0, client_1.promptRefOf)({ name: 'a', version: 2 })).toBeNull();
+        expect((0, client_1.promptRefOf)(5)).toBeNull();
+    });
+});
+//# sourceMappingURL=flags.test.js.map

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

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

package/dist/flags/client.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Shield360 feature flags for Node: fetch an environment's flags, evaluate
+ * them locally, and stamp the variation served on the active span.
+ *
+ *   import Shield360 from 'shield360';
+ *   Shield360.init({ applicationName: 'checkout-api' });  // or SHIELD360_URL / SHIELD360_API_KEY
+ *   if (Shield360.flags.isEnabled('new-checkout', { key: user.id, plan: user.plan })) { ... }
+ *   const model = Shield360.flags.getFlag('model-choice', { key: user.id }, 'gpt-4o-mini');
+ *
+ * The client polls GET /api/flags/rules (every 30 seconds by default, with
+ * jitter, sending the last ETag so an unchanged environment costs a 304),
+ * keeps the rules in memory and evaluates with the same engine as the server
+ * (./engine.ts, a byte-identical copy of sdk/flags-core). It never throws
+ * into the app: until rules arrive, for an unknown flag, or on any error, the
+ * caller's default is returned.
+ *
+ * Each evaluation sets `shield360.flag.<key>` = the served variation's key on
+ * the active span, so cost, latency and evals can be compared per variant.
+ */
+import { type Evaluation, type EvaluationContext, type FlagValue } from './engine';
+export declare const RULES_PATH = "/api/flags/rules";
+export declare const SPAN_ATTRIBUTE_PREFIX = "shield360.flag.";
+export declare const DEFAULT_POLL_INTERVAL_MS = 30000;
+export interface FlagsOptions {
+    /** Shield360's URL; defaults to init()'s shield360Url, then SHIELD360_URL. */
+    url?: string;
+    /** The environment's API key; defaults to init()'s shield360ApiKey, then SHIELD360_API_KEY. */
+    apiKey?: string;
+    /** service.name, for flags scoped to one app; defaults to init()'s applicationName. */
+    applicationName?: string;
+    /** How often to poll, in milliseconds (at least 5,000). Default 30,000. */
+    pollIntervalMs?: number;
+    /** Per-request timeout in milliseconds. Default 10,000. */
+    timeoutMs?: number;
+    /** Set `shield360.flag.<key>` on the active span. Default true. */
+    recordOnSpan?: boolean;
+    /** For tests: the fetch to use. */
+    fetch?: typeof fetch;
+}
+export type FlagDetail<T> = {
+    value: T;
+    /** The served variation's key; null when the caller's default was returned. */
+    variation: string | null;
+    reason: Evaluation['reason'] | {
+        kind: 'FLAG_NOT_FOUND' | 'NOT_READY' | 'WRONG_TYPE' | 'ERROR';
+    };
+};
+/** A Prompt Hub prompt a flag variation names: `{ name, version? }`, or the text `name` / `name@version`. */
+export type PromptRef = {
+    name: string;
+    version?: string;
+};
+export type PromptFlagOptions = {
+    /** Variables to compile the prompt with. */
+    variables?: Record<string, unknown>;
+    /** Compile the prompt with the variables. Default: true when variables are given. */
+    shouldCompile?: boolean;
+};
+export type PromptFlagResult = {
+    name: string;
+    version: string | null;
+    /** The served variation's key; null when the default reference was used. */
+    variation: string | null;
+    /** What Prompt Hub answered for it (its `res`), or null when it could not be fetched. */
+    prompt: unknown;
+    error: string | null;
+};
+/** The Prompt Hub reference a flag value names, or null. */
+export declare function promptRefOf(value: unknown): PromptRef | null;
+export declare class FlagsClient {
+    private options;
+    private flags;
+    private segments;
+    private etag;
+    private fetched;
+    private timer;
+    private started;
+    private inFlight;
+    private waiters;
+    private warned;
+    constructor(options?: FlagsOptions);
+    /** Changes the options; takes effect on the next fetch. */
+    configure(options: FlagsOptions): void;
+    private destination;
+    private applicationName;
+    /** Starts polling (once). Called on first use; call it at startup to fetch early. */
+    start(): void;
+    private schedule;
+    /** Stops polling. Rules already fetched keep being served. */
+    close(): void;
+    /** Whether rules have been fetched at least once. */
+    isReady(): boolean;
+    /** Resolves true once rules have been fetched, or false after `timeoutMs`. */
+    ready(timeoutMs?: number): Promise<boolean>;
+    /** Fetches the rules now. Resolves true when the rules are current; never rejects. */
+    refresh(): Promise<boolean>;
+    private fetchRules;
+    private markFetched;
+    /** The flag's value for this context, with the variation and why; never throws. */
+    getFlagDetail<T extends FlagValue | undefined>(key: string, context: EvaluationContext | undefined, defaultValue: T): FlagDetail<T>;
+    /** The flag's value for this context, or `defaultValue`; never throws. */
+    getFlag(key: string, context: EvaluationContext | undefined, defaultValue: boolean): boolean;
+    getFlag(key: string, context: EvaluationContext | undefined, defaultValue: string): string;
+    getFlag(key: string, context: EvaluationContext | undefined, defaultValue: number): number;
+    getFlag<T extends FlagValue | undefined>(key: string, context: EvaluationContext | undefined, defaultValue: T): T;
+    /** Whether a boolean flag is on for this context; false until rules arrive, for an unknown flag, or on error. */
+    isEnabled(key: string, context?: EvaluationContext): boolean;
+    /**
+     * AI: the model a model-switch flag serves this context — a string flag whose
+     * variations are provider/model ids such as `openai/gpt-4o-mini`. The default
+     * until rules arrive, for an unknown flag, or for an empty value.
+     */
+    model(key: string, context: EvaluationContext | undefined, defaultModel: string): string;
+    /**
+     * AI: whether a kill switch is engaged for this context — true means stop the
+     * feature. A kill switch is a boolean flag that serves true while the feature
+     * may run; switching it off (or serving false) engages it. Until rules
+     * arrive, or for an unknown flag, it is not engaged: the feature keeps running.
+     */
+    killSwitch(key: string, context?: EvaluationContext): boolean;
+    /**
+     * AI: the Prompt Hub prompt a prompt-version flag serves this context. The
+     * flag's variations name prompts (`{ "name": "support-reply", "version":
+     * "1.2.0" }` or `"support-reply@1.2.0"`); the one served is fetched from
+     * Prompt Hub with the SDK's own fetch. Never rejects: on any failure
+     * `prompt` is null and `error` says why.
+     */
+    prompt(key: string, context: EvaluationContext | undefined, defaultRef: PromptRef, options?: PromptFlagOptions): Promise<PromptFlagResult>;
+}
+/** The SDK's own client, behind `Shield360.flags`. It reads init()'s settings when it first fetches. */
+export declare const flags: FlagsClient;