flagdrop-stage 0.1.0

package/dist/cache.d.ts

@@ -0,0 +1,30 @@
+import type { ConfigFile } from './types';
+export interface CacheOptions {
+    /** TTL in ms — default 30000 */
+    ttlMs: number;
+    /** Async function to fetch fresh config */
+    fetcher: () => Promise<ConfigFile>;
+}
+/**
+ * In-memory config cache with TTL-based refresh.
+ * Serves stale data on fetch failure — never blocks evaluation.
+ */
+export declare class ConfigCache {
+    private config;
+    private refreshTimer;
+    private refreshing;
+    private readonly ttlMs;
+    private readonly fetcher;
+    constructor(options: CacheOptions);
+    /** Initial load — must succeed or throw */
+    initialize(): Promise<void>;
+    /** Start periodic background refresh */
+    private startRefreshTimer;
+    /** Lazy async refresh — serve stale on failure */
+    private refresh;
+    /** Get the current cached config (may be stale) */
+    getConfig(): ConfigFile | null;
+    /** Stop the refresh timer */
+    stop(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,OAAO,EAAE,YAAY;IAKjC,2CAA2C;IACrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,wCAAwC;IACxC,OAAO,CAAC,iBAAiB;IAUzB,kDAAkD;YACpC,OAAO;IAYrB,mDAAmD;IACnD,SAAS,IAAI,UAAU,GAAG,IAAI;IAI9B,6BAA6B;IAC7B,IAAI,IAAI,IAAI;CAMb"}

package/dist/cache.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigCache = void 0;
+/**
+ * In-memory config cache with TTL-based refresh.
+ * Serves stale data on fetch failure — never blocks evaluation.
+ */
+class ConfigCache {
+    constructor(options) {
+        this.config = null;
+        this.refreshTimer = null;
+        this.refreshing = false;
+        this.ttlMs = options.ttlMs;
+        this.fetcher = options.fetcher;
+    }
+    /** Initial load — must succeed or throw */
+    async initialize() {
+        this.config = await this.fetcher();
+        this.startRefreshTimer();
+    }
+    /** Start periodic background refresh */
+    startRefreshTimer() {
+        this.refreshTimer = setInterval(() => {
+            void this.refresh();
+        }, this.ttlMs);
+        // Unref so the timer doesn't prevent Node.js from exiting
+        if (this.refreshTimer && typeof this.refreshTimer === 'object' && 'unref' in this.refreshTimer) {
+            this.refreshTimer.unref();
+        }
+    }
+    /** Lazy async refresh — serve stale on failure */
+    async refresh() {
+        if (this.refreshing)
+            return;
+        this.refreshing = true;
+        try {
+            this.config = await this.fetcher();
+        }
+        catch {
+            // Serve stale — do not update config
+        }
+        finally {
+            this.refreshing = false;
+        }
+    }
+    /** Get the current cached config (may be stale) */
+    getConfig() {
+        return this.config;
+    }
+    /** Stop the refresh timer */
+    stop() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+    }
+}
+exports.ConfigCache = ConfigCache;
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":";;;AASA;;;GAGG;AACH,MAAa,WAAW;IAOtB,YAAY,OAAqB;QANzB,WAAM,GAAsB,IAAI,CAAC;QACjC,iBAAY,GAA0C,IAAI,CAAC;QAC3D,eAAU,GAAG,KAAK,CAAC;QAKzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,wCAAwC;IAChC,iBAAiB;QACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YACnC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,0DAA0D;QAC1D,IAAI,IAAI,CAAC,YAAY,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9F,IAAI,CAAC,YAA+B,CAAC,KAAK,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED,kDAAkD;IAC1C,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,6BAA6B;IAC7B,IAAI;QACF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAtDD,kCAsDC"}

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import type { FlagClientOptions, IFlagClient, EvaluationContext } from './types';
+/**
+ * FlagDrop backend SDK client.
+ *
+ * Fetches config from cloud storage, caches in-memory, evaluates flags locally.
+ */
+export declare class FlagClient implements IFlagClient {
+    private cache;
+    private telemetry;
+    private readonly options;
+    constructor(options: FlagClientOptions);
+    /**
+     * Initialize the client — fetches config and starts timers.
+     * Must be called before evaluating flags.
+     */
+    initialize(): Promise<void>;
+    getBool(key: string, defaultValue: boolean, context?: EvaluationContext): boolean;
+    getString(key: string, defaultValue: string, context?: EvaluationContext): string;
+    getNumber(key: string, defaultValue: number, context?: EvaluationContext): number;
+    getJSON<T = unknown>(key: string, defaultValue: T, context?: EvaluationContext): T;
+    close(): Promise<void>;
+    private evaluateFlag;
+    private createFetcher;
+}
+//# 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,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAQjB;;;;GAIG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,EAAE,iBAAiB;IAkBtC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,OAAO,CACL,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO;IAIV,SAAS,CACP,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM;IAIT,SAAS,CACP,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM;IAIT,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,CAAC;IAIE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;CActB"}

package/dist/client.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlagClient = void 0;
+const cache_1 = require("./cache");
+const telemetry_1 = require("./telemetry");
+const evaluator_1 = require("./evaluator");
+const s3_1 = require("./storage/s3");
+const gcs_1 = require("./storage/gcs");
+const azure_1 = require("./storage/azure");
+/**
+ * FlagDrop backend SDK client.
+ *
+ * Fetches config from cloud storage, caches in-memory, evaluates flags locally.
+ */
+class FlagClient {
+    constructor(options) {
+        this.telemetry = null;
+        this.options = options;
+        const fetcher = this.createFetcher();
+        this.cache = new cache_1.ConfigCache({
+            ttlMs: options.refreshTtlMs ?? 30000,
+            fetcher,
+        });
+        if (options.telemetryUrl) {
+            this.telemetry = new telemetry_1.TelemetryCollector({
+                telemetryUrl: options.telemetryUrl,
+                environment: options.environment,
+                intervalMs: options.telemetryIntervalMs ?? 60000,
+            });
+        }
+    }
+    /**
+     * Initialize the client — fetches config and starts timers.
+     * Must be called before evaluating flags.
+     */
+    async initialize() {
+        await this.cache.initialize();
+        this.telemetry?.start();
+    }
+    getBool(key, defaultValue, context) {
+        return this.evaluateFlag(key, defaultValue, context);
+    }
+    getString(key, defaultValue, context) {
+        return this.evaluateFlag(key, defaultValue, context);
+    }
+    getNumber(key, defaultValue, context) {
+        return this.evaluateFlag(key, defaultValue, context);
+    }
+    getJSON(key, defaultValue, context) {
+        return this.evaluateFlag(key, defaultValue, context);
+    }
+    async close() {
+        this.cache.stop();
+        if (this.telemetry) {
+            await this.telemetry.stop();
+        }
+    }
+    evaluateFlag(key, defaultValue, context) {
+        try {
+            const config = this.cache.getConfig();
+            const flag = config?.flags[key];
+            this.telemetry?.record(key);
+            return (0, evaluator_1.evaluate)(key, flag, defaultValue, context);
+        }
+        catch {
+            return defaultValue;
+        }
+    }
+    createFetcher() {
+        const { provider, bucket, region, environment } = this.options;
+        switch (provider) {
+            case 'aws':
+                return () => (0, s3_1.readFromS3)({ bucket, region }, environment);
+            case 'gcp':
+                return () => (0, gcs_1.readFromGCS)({ bucket }, environment);
+            case 'azure':
+                return () => (0, azure_1.readFromAzure)({ bucket }, environment);
+            default:
+                throw new Error(`Unsupported provider: ${provider}`);
+        }
+    }
+}
+exports.FlagClient = FlagClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAMA,mCAAsC;AACtC,2CAAiD;AACjD,2CAAuC;AACvC,qCAA0C;AAC1C,uCAA4C;AAC5C,2CAAgD;AAEhD;;;;GAIG;AACH,MAAa,UAAU;IAKrB,YAAY,OAA0B;QAH9B,cAAS,GAA8B,IAAI,CAAC;QAIlD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAW,CAAC;YAC3B,KAAK,EAAE,OAAO,CAAC,YAAY,IAAI,KAAM;YACrC,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,IAAI,8BAAkB,CAAC;gBACtC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,mBAAmB,IAAI,KAAM;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,CACL,GAAW,EACX,YAAqB,EACrB,OAA2B;QAE3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,SAAS,CACP,GAAW,EACX,YAAoB,EACpB,OAA2B;QAE3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,SAAS,CACP,GAAW,EACX,YAAoB,EACpB,OAA2B;QAE3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CACL,GAAW,EACX,YAAe,EACf,OAA2B;QAE3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,YAAY,CAClB,GAAW,EACX,YAAe,EACf,OAA2B;QAE3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,IAAA,oBAAQ,EAAC,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAE/D,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,KAAK;gBACR,OAAO,GAAG,EAAE,CAAC,IAAA,eAAU,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;YAC3D,KAAK,KAAK;gBACR,OAAO,GAAG,EAAE,CAAC,IAAA,iBAAW,EAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;YACpD,KAAK,OAAO;gBACV,OAAO,GAAG,EAAE,CAAC,IAAA,qBAAa,EAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;YACtD;gBACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AApGD,gCAoGC"}

package/dist/evaluator.d.ts

@@ -0,0 +1,16 @@
+import type { ConfigFlag, Rule, EvaluationContext } from './types';
+/**
+ * Evaluate a flag against the given context.
+ * Returns the resolved value, or `defaultValue` if the flag is missing/disabled/error.
+ */
+export declare function evaluate<T>(flagKey: string, flag: ConfigFlag | undefined, defaultValue: T, context?: EvaluationContext): T;
+/**
+ * Check whether a single rule matches the given context.
+ */
+export declare function matchesRule(rule: Rule, context: EvaluationContext): boolean;
+/**
+ * Deterministic bucketing via MurmurHash3.
+ * Returns a number 0-99 (inclusive).
+ */
+export declare function bucketUser(flagKey: string, attributeValue: string): number;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,iBAAsB,GAC9B,CAAC,CAgCH;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAwD3E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAG1E"}

package/dist/evaluator.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluate = evaluate;
+exports.matchesRule = matchesRule;
+exports.bucketUser = bucketUser;
+/**
+ * Rule evaluator — shared logic between Node and browser SDKs.
+ *
+ * CRITICAL: This module must produce IDENTICAL results in both environments.
+ * Same hash, same mod, same matching order. Never throws during evaluation.
+ */
+const murmurhash3js_1 = __importDefault(require("murmurhash3js"));
+/**
+ * Evaluate a flag against the given context.
+ * Returns the resolved value, or `defaultValue` if the flag is missing/disabled/error.
+ */
+function evaluate(flagKey, flag, defaultValue, context = {}) {
+    try {
+        if (!flag || !flag.enabled) {
+            return defaultValue;
+        }
+        // Evaluate rules in order — first match wins
+        for (const rule of flag.rules) {
+            if (matchesRule(rule, context)) {
+                return rule.serveValue;
+            }
+        }
+        // Rollout check — if a rollout is defined, use it to decide
+        if (flag.rollout && flag.rollout.attribute) {
+            const attrValue = context[flag.rollout.attribute] ?? '';
+            if (attrValue !== '') {
+                const bucket = bucketUser(flagKey, attrValue);
+                if (bucket < flag.rollout.percentage) {
+                    return flag.defaultValue;
+                }
+                // Outside rollout percentage — return caller default
+                return defaultValue;
+            }
+        }
+        // No rules matched, no rollout or missing attribute — return flag default
+        return flag.defaultValue;
+    }
+    catch {
+        // SDK NEVER throws during evaluation
+        return defaultValue;
+    }
+}
+/**
+ * Check whether a single rule matches the given context.
+ */
+function matchesRule(rule, context) {
+    try {
+        const attrValue = context[rule.attribute];
+        // If the attribute is not present in context, rule does not match
+        if (attrValue === undefined || attrValue === null) {
+            return false;
+        }
+        const { operator, value } = rule;
+        switch (operator) {
+            case 'eq':
+                return attrValue === String(value);
+            case 'neq':
+                return attrValue !== String(value);
+            case 'in':
+                if (Array.isArray(value)) {
+                    return value.some((v) => String(v) === attrValue);
+                }
+                return false;
+            case 'notIn':
+                if (Array.isArray(value)) {
+                    return !value.some((v) => String(v) === attrValue);
+                }
+                return true;
+            case 'lt': {
+                const numAttr = Number(attrValue);
+                const numVal = Number(value);
+                if (isNaN(numAttr) || isNaN(numVal))
+                    return false;
+                return numAttr < numVal;
+            }
+            case 'gt': {
+                const numAttr = Number(attrValue);
+                const numVal = Number(value);
+                if (isNaN(numAttr) || isNaN(numVal))
+                    return false;
+                return numAttr > numVal;
+            }
+            case 'startsWith':
+                return attrValue.startsWith(String(value));
+            case 'endsWith':
+                return attrValue.endsWith(String(value));
+            default:
+                return false;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Deterministic bucketing via MurmurHash3.
+ * Returns a number 0-99 (inclusive).
+ */
+function bucketUser(flagKey, attributeValue) {
+    const hash = murmurhash3js_1.default.x86.hash32(flagKey + attributeValue);
+    return Math.abs(hash) % 100;
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/evaluator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { FlagClient } from './client';
+export { evaluate, matchesRule, bucketUser } from './evaluator';
+export type { FlagClientOptions, BrowserFlagClientOptions, ConfigFile, ConfigFlag, Rule, Rollout, EvaluationContext, TelemetryBatch, IFlagClient, IBrowserFlagClient, } from './types';
+//# 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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,UAAU,EACV,UAAU,EACV,IAAI,EACJ,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bucketUser = exports.matchesRule = exports.evaluate = exports.FlagClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "FlagClient", { enumerable: true, get: function () { return client_1.FlagClient; } });
+var evaluator_1 = require("./evaluator");
+Object.defineProperty(exports, "evaluate", { enumerable: true, get: function () { return evaluator_1.evaluate; } });
+Object.defineProperty(exports, "matchesRule", { enumerable: true, get: function () { return evaluator_1.matchesRule; } });
+Object.defineProperty(exports, "bucketUser", { enumerable: true, get: function () { return evaluator_1.bucketUser; } });
+//# 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,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,yCAAgE;AAAvD,qGAAA,QAAQ,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,uGAAA,UAAU,OAAA"}

package/dist/storage/azure.d.ts

@@ -0,0 +1,8 @@
+import type { ConfigFile } from '../types';
+export interface AzureReaderOptions {
+    bucket: string;
+    /** Azure storage account connection string or URL */
+    connectionString?: string;
+}
+export declare function readFromAzure(options: AzureReaderOptions, environment: string, scope?: 'backend' | 'frontend'): Promise<ConfigFile>;
+//# sourceMappingURL=azure.d.ts.map

package/dist/storage/azure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure.d.ts","sourceRoot":"","sources":["../../src/storage/azure.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,SAAS,GAAG,UAAsB,GACxC,OAAO,CAAC,UAAU,CAAC,CAwBrB"}

package/dist/storage/azure.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFromAzure = readFromAzure;
+const storage_blob_1 = require("@azure/storage-blob");
+async function readFromAzure(options, environment, scope = 'backend') {
+    const blobName = `flags-${environment}-${scope}.json`;
+    let blobServiceClient;
+    if (options.connectionString) {
+        blobServiceClient = storage_blob_1.BlobServiceClient.fromConnectionString(options.connectionString);
+    }
+    else {
+        // Fall back to default Azure identity (env vars, managed identity, etc.)
+        blobServiceClient = storage_blob_1.BlobServiceClient.fromConnectionString(process.env.AZURE_STORAGE_CONNECTION_STRING ?? '');
+    }
+    const containerClient = blobServiceClient.getContainerClient(options.bucket);
+    const blobClient = containerClient.getBlobClient(blobName);
+    const downloadResponse = await blobClient.download(0);
+    const body = await streamToString(downloadResponse.readableStreamBody);
+    return JSON.parse(body);
+}
+async function streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+//# sourceMappingURL=azure.js.map

package/dist/storage/azure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure.js","sourceRoot":"","sources":["../../src/storage/azure.ts"],"names":[],"mappings":";;AAYA,sCA4BC;AAxCD,sDAG6B;AAStB,KAAK,UAAU,aAAa,CACjC,OAA2B,EAC3B,WAAmB,EACnB,QAAgC,SAAS;IAEzC,MAAM,QAAQ,GAAG,SAAS,WAAW,IAAI,KAAK,OAAO,CAAC;IAEtD,IAAI,iBAAoC,CAAC;IACzC,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,iBAAiB,GAAG,gCAAiB,CAAC,oBAAoB,CACxD,OAAO,CAAC,gBAAgB,CACzB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,yEAAyE;QACzE,iBAAiB,GAAG,gCAAiB,CAAC,oBAAoB,CACxD,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtD,MAAM,IAAI,GAAG,MAAM,cAAc,CAC/B,gBAAgB,CAAC,kBAA2C,CAC7D,CAAC;IAEF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAA6B;IACzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/storage/gcs.d.ts

@@ -0,0 +1,6 @@
+import type { ConfigFile } from '../types';
+export interface GCSReaderOptions {
+    bucket: string;
+}
+export declare function readFromGCS(options: GCSReaderOptions, environment: string, scope?: 'backend' | 'frontend'): Promise<ConfigFile>;
+//# sourceMappingURL=gcs.d.ts.map

package/dist/storage/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/storage/gcs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,SAAS,GAAG,UAAsB,GACxC,OAAO,CAAC,UAAU,CAAC,CAUrB"}

package/dist/storage/gcs.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFromGCS = readFromGCS;
+const storage_1 = require("@google-cloud/storage");
+async function readFromGCS(options, environment, scope = 'backend') {
+    const storage = new storage_1.Storage();
+    const fileName = `flags-${environment}-${scope}.json`;
+    const [contents] = await storage
+        .bucket(options.bucket)
+        .file(fileName)
+        .download();
+    return JSON.parse(contents.toString());
+}
+//# sourceMappingURL=gcs.js.map

package/dist/storage/gcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.js","sourceRoot":"","sources":["../../src/storage/gcs.ts"],"names":[],"mappings":";;AAOA,kCAcC;AArBD,mDAAgD;AAOzC,KAAK,UAAU,WAAW,CAC/B,OAAyB,EACzB,WAAmB,EACnB,QAAgC,SAAS;IAEzC,MAAM,OAAO,GAAG,IAAI,iBAAO,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,SAAS,WAAW,IAAI,KAAK,OAAO,CAAC;IAEtD,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,OAAO;SAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACtB,IAAI,CAAC,QAAQ,CAAC;SACd,QAAQ,EAAE,CAAC;IAEd,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAe,CAAC;AACvD,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+export { readFromS3, type S3ReaderOptions } from './s3';
+export { readFromGCS, type GCSReaderOptions } from './gcs';
+export { readFromAzure, type AzureReaderOptions } from './azure';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFromAzure = exports.readFromGCS = exports.readFromS3 = void 0;
+var s3_1 = require("./s3");
+Object.defineProperty(exports, "readFromS3", { enumerable: true, get: function () { return s3_1.readFromS3; } });
+var gcs_1 = require("./gcs");
+Object.defineProperty(exports, "readFromGCS", { enumerable: true, get: function () { return gcs_1.readFromGCS; } });
+var azure_1 = require("./azure");
+Object.defineProperty(exports, "readFromAzure", { enumerable: true, get: function () { return azure_1.readFromAzure; } });
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;AAAA,2BAAwD;AAA/C,gGAAA,UAAU,OAAA;AACnB,6BAA2D;AAAlD,kGAAA,WAAW,OAAA;AACpB,iCAAiE;AAAxD,sGAAA,aAAa,OAAA"}

package/dist/storage/s3.d.ts

@@ -0,0 +1,7 @@
+import type { ConfigFile } from '../types';
+export interface S3ReaderOptions {
+    bucket: string;
+    region: string;
+}
+export declare function readFromS3(options: S3ReaderOptions, environment: string, scope?: 'backend' | 'frontend'): Promise<ConfigFile>;
+//# sourceMappingURL=s3.d.ts.map

package/dist/storage/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/storage/s3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,SAAS,GAAG,UAAsB,GACxC,OAAO,CAAC,UAAU,CAAC,CAgBrB"}

package/dist/storage/s3.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFromS3 = readFromS3;
+const client_s3_1 = require("@aws-sdk/client-s3");
+async function readFromS3(options, environment, scope = 'backend') {
+    const client = new client_s3_1.S3Client({ region: options.region });
+    const key = `flags-${environment}-${scope}.json`;
+    const command = new client_s3_1.GetObjectCommand({
+        Bucket: options.bucket,
+        Key: key,
+    });
+    const response = await client.send(command);
+    const body = await response.Body?.transformToString();
+    if (!body) {
+        throw new Error(`Empty response from S3 for key: ${key}`);
+    }
+    return JSON.parse(body);
+}
+//# sourceMappingURL=s3.js.map

package/dist/storage/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/storage/s3.ts"],"names":[],"mappings":";;AAQA,gCAoBC;AA5BD,kDAAgE;AAQzD,KAAK,UAAU,UAAU,CAC9B,OAAwB,EACxB,WAAmB,EACnB,QAAgC,SAAS;IAEzC,MAAM,MAAM,GAAG,IAAI,oBAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,SAAS,WAAW,IAAI,KAAK,OAAO,CAAC;IAEjD,MAAM,OAAO,GAAG,IAAI,4BAAgB,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,GAAG;KACT,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;AACxC,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,30 @@
+export interface TelemetryOptions {
+    /** URL to POST telemetry batches to */
+    telemetryUrl: string;
+    /** Environment name */
+    environment: string;
+    /** Flush interval in ms — default 60000 */
+    intervalMs: number;
+}
+/**
+ * Opt-in telemetry: counts flag evaluations and flushes periodically.
+ * Fire-and-forget — never blocks evaluation.
+ */
+export declare class TelemetryCollector {
+    private counts;
+    private flushTimer;
+    private periodStart;
+    private readonly url;
+    private readonly environment;
+    private readonly intervalMs;
+    constructor(options: TelemetryOptions);
+    /** Start the periodic flush timer */
+    start(): void;
+    /** Record a flag evaluation */
+    record(flagKey: string): void;
+    /** Flush current counts — fire-and-forget */
+    flush(): Promise<void>;
+    /** Stop flushing and send final batch */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,gBAAgB;IAOrC,qCAAqC;IACrC,KAAK,IAAI,IAAI;IASb,+BAA+B;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,6CAA6C;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B,yCAAyC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/telemetry.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryCollector = void 0;
+/**
+ * Opt-in telemetry: counts flag evaluations and flushes periodically.
+ * Fire-and-forget — never blocks evaluation.
+ */
+class TelemetryCollector {
+    constructor(options) {
+        this.counts = new Map();
+        this.flushTimer = null;
+        this.url = options.telemetryUrl;
+        this.environment = options.environment;
+        this.intervalMs = options.intervalMs;
+        this.periodStart = new Date().toISOString();
+    }
+    /** Start the periodic flush timer */
+    start() {
+        this.flushTimer = setInterval(() => {
+            void this.flush();
+        }, this.intervalMs);
+        if (this.flushTimer && typeof this.flushTimer === 'object' && 'unref' in this.flushTimer) {
+            this.flushTimer.unref();
+        }
+    }
+    /** Record a flag evaluation */
+    record(flagKey) {
+        this.counts.set(flagKey, (this.counts.get(flagKey) ?? 0) + 1);
+    }
+    /** Flush current counts — fire-and-forget */
+    async flush() {
+        if (this.counts.size === 0)
+            return;
+        const countsSnapshot = Object.fromEntries(this.counts);
+        const periodEnd = new Date().toISOString();
+        const batch = {
+            projectId: '', // Filled by relay/backend from auth
+            environment: this.environment,
+            counts: countsSnapshot,
+            periodStart: this.periodStart,
+            periodEnd,
+        };
+        // Reset for next period
+        this.counts.clear();
+        this.periodStart = periodEnd;
+        try {
+            await fetch(this.url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(batch),
+            });
+        }
+        catch {
+            // Fire-and-forget — telemetry failures are silent
+        }
+    }
+    /** Stop flushing and send final batch */
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+}
+exports.TelemetryCollector = TelemetryCollector;
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":";;;AAWA;;;GAGG;AACH,MAAa,kBAAkB;IAQ7B,YAAY,OAAyB;QAP7B,WAAM,GAAwB,IAAI,GAAG,EAAE,CAAC;QACxC,eAAU,GAA0C,IAAI,CAAC;QAO/D,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC;IAED,qCAAqC;IACrC,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxF,IAAI,CAAC,UAA6B,CAAC,KAAK,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,OAAe;QACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAEnC,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAmB;YAC5B,SAAS,EAAE,EAAE,EAAE,oCAAoC;YACnD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS;SACV,CAAC;QAEF,wBAAwB;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACpB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAnED,gDAmEC"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @flagdrop/sdk — Shared type definitions
+ *
+ * These types are the contract between:
+ * - The Go config file generator (produces the JSON)
+ * - The Node.js backend SDK (reads the JSON)
+ * - The Python backend SDK (reads the JSON)
+ * - The browser SDK (reads the JSON via relay)
+ * - The OpenFeature provider (wraps the SDK)
+ */
+export interface FlagClientOptions {
+    /** Customer's storage bucket name */
+    bucket: string;
+    /** Environment name (e.g., 'prod', 'staging') */
+    environment: string;
+    /** Cloud provider: 'aws' | 'gcp' | 'azure' */
+    provider: 'aws' | 'gcp' | 'azure';
+    /** Cloud region (e.g., 'us-east-1') */
+    region: string;
+    /** Cache refresh interval in ms (default: 30000) */
+    refreshTtlMs?: number;
+    /** FlagDrop telemetry API URL (optional, opt-in) */
+    telemetryUrl?: string;
+    /** Telemetry flush interval in ms (default: 60000) */
+    telemetryIntervalMs?: number;
+}
+export interface BrowserFlagClientOptions {
+    /** URL of the Web Relay SSE endpoint */
+    relayUrl: string;
+    /** Environment name */
+    environment: string;
+    /** API key for relay authentication (optional) */
+    apiKey?: string;
+}
+export interface ConfigFile {
+    version: number;
+    updatedAt: string;
+    scope: 'backend' | 'frontend';
+    flags: Record<string, ConfigFlag>;
+}
+export interface ConfigFlag {
+    type: 'boolean' | 'string' | 'number' | 'json';
+    enabled: boolean;
+    defaultValue: unknown;
+    rules: Rule[];
+    rollout?: Rollout;
+    description?: string;
+}
+export interface Rule {
+    attribute: string;
+    operator: 'eq' | 'neq' | 'in' | 'notIn' | 'lt' | 'gt' | 'startsWith' | 'endsWith' | 'segment';
+    value: string | string[] | number;
+    serveValue: unknown;
+}
+export interface Rollout {
+    percentage: number;
+    attribute: string;
+}
+/** Arbitrary key-value pairs passed at eval time for targeting */
+export type EvaluationContext = Record<string, string>;
+export interface TelemetryBatch {
+    projectId: string;
+    environment: string;
+    counts: Record<string, number>;
+    periodStart: string;
+    periodEnd: string;
+}
+export interface IFlagClient {
+    getBool(key: string, defaultValue: boolean, context?: EvaluationContext): boolean;
+    getString(key: string, defaultValue: string, context?: EvaluationContext): string;
+    getNumber(key: string, defaultValue: number, context?: EvaluationContext): number;
+    getJSON<T = unknown>(key: string, defaultValue: T, context?: EvaluationContext): T;
+    close(): Promise<void>;
+}
+export interface IBrowserFlagClient extends IFlagClient {
+    on(event: 'change', handler: (flagKey: string, newValue: unknown) => void): void;
+    off(event: 'change', handler: (flagKey: string, newValue: unknown) => void): 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,13 @@
+"use strict";
+/**
+ * @flagdrop/sdk — Shared type definitions
+ *
+ * These types are the contract between:
+ * - The Go config file generator (produces the JSON)
+ * - The Node.js backend SDK (reads the JSON)
+ * - The Python backend SDK (reads the JSON)
+ * - The browser SDK (reads the JSON via relay)
+ * - The OpenFeature provider (wraps the SDK)
+ */
+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":";AAAA;;;;;;;;;GASG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "flagdrop-stage",
+  "version": "0.1.0",
+  "description": "FlagDrop backend SDK for Node.js — read feature flags from your cloud storage bucket",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["feature-flags", "flagdrop", "sdk"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flagdrop-io/sdk-node.git"
+  },
+  "dependencies": {
+    "murmurhash3js": "^3.0.1"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@google-cloud/storage": "^7.0.0",
+    "@azure/storage-blob": "^12.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": { "optional": true },
+    "@google-cloud/storage": { "optional": true },
+    "@azure/storage-blob": { "optional": true }
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.500.0",
+    "@google-cloud/storage": "^7.0.0",
+    "@azure/storage-blob": "^12.0.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.4.0"
+  }
+}