@reflag/node-sdk 1.2.0 → 1.4.0

package/dist/src/flagsFallbackProvider.js

@@ -0,0 +1,307 @@
+"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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFlagsFallbackSnapshot = isFlagsFallbackSnapshot;
+exports.createStaticFallbackProvider = createStaticFallbackProvider;
+exports.createFileFallbackProvider = createFileFallbackProvider;
+exports.createS3FallbackProvider = createS3FallbackProvider;
+exports.createGCSFallbackProvider = createGCSFallbackProvider;
+exports.createRedisFallbackProvider = createRedisFallbackProvider;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("./utils");
+function defaultSnapshotName(secretKeyHash) {
+    return `flags-fallback-${secretKeyHash.slice(0, 16)}.json`;
+}
+function snapshotFilePath(context, directory = path_1.default.join(process.cwd(), ".reflag")) {
+    return path_1.default.join(directory, defaultSnapshotName(context.secretKeyHash));
+}
+function trimTrailingCharacter(value, character) {
+    let endIndex = value.length;
+    while (endIndex > 0 && value[endIndex - 1] === character) {
+        endIndex -= 1;
+    }
+    return value.slice(0, endIndex);
+}
+function snapshotObjectKey(context, keyPrefix = "reflag/flags-fallback") {
+    return `${trimTrailingCharacter(keyPrefix, "/")}/${defaultSnapshotName(context.secretKeyHash)}`;
+}
+function snapshotRedisKey(context, keyPrefix = "reflag:flags-fallback") {
+    return `${trimTrailingCharacter(keyPrefix, ":")}:${context.secretKeyHash.slice(0, 16)}`;
+}
+function isFlagsFallbackSnapshot(value) {
+    return ((0, utils_1.isObject)(value) &&
+        value.version === 1 &&
+        typeof value.savedAt === "string" &&
+        Array.isArray(value.flags) &&
+        value.flags.every(isFlagApiResponse));
+}
+function isFlagApiResponse(value) {
+    return ((0, utils_1.isObject)(value) &&
+        typeof value.key === "string" &&
+        typeof value.description !== "undefined" &&
+        (0, utils_1.isObject)(value.targeting) &&
+        typeof value.targeting.version === "number" &&
+        Array.isArray(value.targeting.rules) &&
+        (value.config === undefined ||
+            ((0, utils_1.isObject)(value.config) &&
+                typeof value.config.version === "number" &&
+                Array.isArray(value.config.variants))));
+}
+function readBodyAsString(body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (typeof body === "string")
+            return body;
+        if (body instanceof Uint8Array)
+            return Buffer.from(body).toString("utf-8");
+        if (body && typeof body === "object") {
+            if ("transformToString" in body &&
+                typeof body.transformToString === "function") {
+                return yield body.transformToString();
+            }
+        }
+        return undefined;
+    });
+}
+function parseSnapshot(raw) {
+    const parsed = JSON.parse(raw);
+    return isFlagsFallbackSnapshot(parsed) ? parsed : undefined;
+}
+function staticFlagApiResponse(key, isEnabled) {
+    return {
+        key,
+        description: null,
+        targeting: {
+            version: 1,
+            rules: [
+                {
+                    filter: {
+                        type: "constant",
+                        value: isEnabled,
+                    },
+                },
+            ],
+        },
+    };
+}
+function createDefaultS3Client() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { S3Client } = yield Promise.resolve().then(() => __importStar(require("@aws-sdk/client-s3")));
+        return new S3Client({});
+    });
+}
+function createDefaultGCSClient() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { Storage } = yield Promise.resolve().then(() => __importStar(require("@google-cloud/storage")));
+        return new Storage();
+    });
+}
+function createStaticFallbackProvider({ flags, }) {
+    return {
+        load() {
+            return __awaiter(this, void 0, void 0, function* () {
+                return {
+                    version: 1,
+                    savedAt: new Date().toISOString(),
+                    flags: Object.entries(flags).map(([key, isEnabled]) => staticFlagApiResponse(key, isEnabled)),
+                };
+            });
+        },
+        save() {
+            return __awaiter(this, void 0, void 0, function* () {
+                // no-op
+            });
+        },
+    };
+}
+function createFileFallbackProvider({ directory, } = {}) {
+    return {
+        load(context) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const resolvedPath = snapshotFilePath(context, directory);
+                try {
+                    const fileContents = yield fs_1.promises.readFile(resolvedPath, "utf-8");
+                    return parseSnapshot(fileContents);
+                }
+                catch (error) {
+                    if ((error === null || error === void 0 ? void 0 : error.code) === "ENOENT") {
+                        return undefined;
+                    }
+                    throw error;
+                }
+            });
+        },
+        save(context, snapshot) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const resolvedPath = snapshotFilePath(context, directory);
+                yield fs_1.promises.mkdir(path_1.default.dirname(resolvedPath), { recursive: true });
+                const tempPath = `${resolvedPath}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+                yield fs_1.promises.writeFile(tempPath, JSON.stringify(snapshot), "utf-8");
+                yield fs_1.promises.rename(tempPath, resolvedPath);
+            });
+        },
+    };
+}
+function createS3FallbackProvider({ bucket, client, keyPrefix, }) {
+    let defaultClient;
+    const getClient = () => __awaiter(this, void 0, void 0, function* () {
+        defaultClient !== null && defaultClient !== void 0 ? defaultClient : (defaultClient = client !== null && client !== void 0 ? client : (yield createDefaultS3Client()));
+        return defaultClient;
+    });
+    return {
+        load(context) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                const s3 = yield getClient();
+                const { GetObjectCommand } = yield Promise.resolve().then(() => __importStar(require("@aws-sdk/client-s3")));
+                try {
+                    const response = yield s3.send(new GetObjectCommand({
+                        Bucket: bucket,
+                        Key: snapshotObjectKey(context, keyPrefix),
+                    }));
+                    const body = yield readBodyAsString(response.Body);
+                    if (!body)
+                        return undefined;
+                    return parseSnapshot(body);
+                }
+                catch (error) {
+                    if ((error === null || error === void 0 ? void 0 : error.name) === "NoSuchKey" ||
+                        ((_a = error === null || error === void 0 ? void 0 : error.$metadata) === null || _a === void 0 ? void 0 : _a.httpStatusCode) === 404) {
+                        return undefined;
+                    }
+                    throw error;
+                }
+            });
+        },
+        save(context, snapshot) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const s3 = yield getClient();
+                const { PutObjectCommand } = yield Promise.resolve().then(() => __importStar(require("@aws-sdk/client-s3")));
+                yield s3.send(new PutObjectCommand({
+                    Bucket: bucket,
+                    Key: snapshotObjectKey(context, keyPrefix),
+                    Body: JSON.stringify(snapshot),
+                    ContentType: "application/json",
+                }));
+            });
+        },
+    };
+}
+function createGCSFallbackProvider({ bucket, client, keyPrefix, }) {
+    let defaultClient;
+    const getClient = () => __awaiter(this, void 0, void 0, function* () {
+        defaultClient !== null && defaultClient !== void 0 ? defaultClient : (defaultClient = client !== null && client !== void 0 ? client : (yield createDefaultGCSClient()));
+        return defaultClient;
+    });
+    return {
+        load(context) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const storage = yield getClient();
+                const file = storage
+                    .bucket(bucket)
+                    .file(snapshotObjectKey(context, keyPrefix));
+                const [exists] = yield file.exists();
+                if (!exists) {
+                    return undefined;
+                }
+                const [contents] = yield file.download();
+                return parseSnapshot(Buffer.from(contents).toString("utf-8"));
+            });
+        },
+        save(context, snapshot) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const storage = yield getClient();
+                yield storage
+                    .bucket(bucket)
+                    .file(snapshotObjectKey(context, keyPrefix))
+                    .save(JSON.stringify(snapshot), {
+                    contentType: "application/json",
+                });
+            });
+        },
+    };
+}
+function createRedisFallbackProvider({ client, keyPrefix, } = {}) {
+    let defaultClient;
+    let connectPromise;
+    const getClient = () => __awaiter(this, void 0, void 0, function* () {
+        if (client) {
+            return client;
+        }
+        if (!process.env.REDIS_URL) {
+            throw new Error("fallbackProviders.redis() requires REDIS_URL to be set when no client is provided");
+        }
+        if (!defaultClient) {
+            const { createClient } = yield Promise.resolve().then(() => __importStar(require("@redis/client")));
+            defaultClient = createClient({ url: process.env.REDIS_URL });
+        }
+        if (!defaultClient.isOpen) {
+            connectPromise !== null && connectPromise !== void 0 ? connectPromise : (connectPromise = defaultClient.connect());
+            yield connectPromise;
+        }
+        return defaultClient;
+    });
+    return {
+        load(context) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const redis = yield getClient();
+                const raw = yield redis.get(snapshotRedisKey(context, keyPrefix));
+                if (!raw) {
+                    return undefined;
+                }
+                return parseSnapshot(raw);
+            });
+        },
+        save(context, snapshot) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const redis = yield getClient();
+                yield redis.set(snapshotRedisKey(context, keyPrefix), JSON.stringify(snapshot));
+            });
+        },
+    };
+}
+//# sourceMappingURL=flagsFallbackProvider.js.map

package/dist/src/flagsFallbackProvider.js.map

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

package/dist/src/index.js

@@ -1,9 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EdgeClient = exports.ReflagClient = exports.BoundReflagClient = void 0;
+exports.fallbackProviders = exports.EdgeClient = exports.ReflagClient = exports.BoundReflagClient = void 0;
+const flagsFallbackProvider_1 = require("./flagsFallbackProvider");
 var client_1 = require("./client");
 Object.defineProperty(exports, "BoundReflagClient", { enumerable: true, get: function () { return client_1.BoundReflagClient; } });
 Object.defineProperty(exports, "ReflagClient", { enumerable: true, get: function () { return client_1.ReflagClient; } });
 var edgeClient_1 = require("./edgeClient");
 Object.defineProperty(exports, "EdgeClient", { enumerable: true, get: function () { return edgeClient_1.EdgeClient; } });
+exports.fallbackProviders = {
+    static: flagsFallbackProvider_1.createStaticFallbackProvider,
+    file: flagsFallbackProvider_1.createFileFallbackProvider,
+    redis: flagsFallbackProvider_1.createRedisFallbackProvider,
+    s3: flagsFallbackProvider_1.createS3FallbackProvider,
+    gcs: flagsFallbackProvider_1.createGCSFallbackProvider,
+};
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA2D;AAAlD,2GAAA,iBAAiB,OAAA;AAAE,sGAAA,YAAY,OAAA;AACxC,2CAA6D;AAApD,wGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mEAMiC;AAEjC,mCAA2D;AAAlD,2GAAA,iBAAiB,OAAA;AAAE,sGAAA,YAAY,OAAA;AACxC,2CAA6D;AAApD,wGAAA,UAAU,OAAA;AASN,QAAA,iBAAiB,GAAG;IAC/B,MAAM,EAAE,oDAA4B;IACpC,IAAI,EAAE,kDAA0B;IAChC,KAAK,EAAE,mDAA2B;IAClC,EAAE,EAAE,gDAAwB;IAC5B,GAAG,EAAE,iDAAyB;CAC/B,CAAC"}

package/dist/src/periodicallyUpdatingCache.js

@@ -14,18 +14,15 @@ exports.default = periodicallyUpdatingCache;
  * Create a cached function that updates the value asynchronously.
  *
  * The value is updated every `ttl` milliseconds.
- * If the value is older than `staleTtl` milliseconds, a warning is logged.
  *
  * @typeParam T - The type of the value.
  * @param ttl - The time-to-live in milliseconds.
- * @param staleTtl - The time-to-live after which a warning is logged.
  * @param logger - The logger to use.
  * @param fn - The function to call to get the value.
  * @returns The cache object.
  **/
-function periodicallyUpdatingCache(ttl, staleTtl, logger, fn) {
+function periodicallyUpdatingCache(ttl, logger, fn) {
     let cachedValue;
-    let lastUpdate;
     let timeoutId;
     let refreshPromise;
     const update = () => __awaiter(this, void 0, void 0, function* () {
@@ -39,7 +36,6 @@ function periodicallyUpdatingCache(ttl, staleTtl, logger, fn) {
             }
             logger === null || logger === void 0 ? void 0 : logger.info("refreshed flag definitions");
             cachedValue = newValue;
-            lastUpdate = Date.now();
             logger === null || logger === void 0 ? void 0 : logger.debug("updated cached value", cachedValue);
         }
         catch (e) {
@@ -51,12 +47,6 @@ function periodicallyUpdatingCache(ttl, staleTtl, logger, fn) {
         }
     });
     const get = () => {
-        if (lastUpdate !== undefined) {
-            const age = Date.now() - lastUpdate;
-            if (age > staleTtl) {
-                logger === null || logger === void 0 ? void 0 : logger.warn("cached value is stale", { age, cachedValue });
-            }
-        }
         return cachedValue;
     };
     const refresh = () => __awaiter(this, void 0, void 0, function* () {

package/dist/src/periodicallyUpdatingCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"periodicallyUpdatingCache.js","sourceRoot":"","sources":["../../src/periodicallyUpdatingCache.ts"],"names":[],"mappings":";;;;;;;;;;;AAeA,4CAyEC;AAtFD;;;;;;;;;;;;IAYI;AACJ,SAAwB,yBAAyB,CAC/C,GAAW,EACX,QAAgB,EAChB,MAA0B,EAC1B,EAAgC;IAEhC,IAAI,WAA0B,CAAC;IAC/B,IAAI,UAA8B,CAAC;IACnC,IAAI,SAAqC,CAAC;IAC1C,IAAI,cAAyC,CAAC;IAE9C,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAC;YAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAE3C,WAAW,GAAG,QAAQ,CAAC;YAEvB,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAExB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;gBAAS,CAAC;YACT,cAAc,GAAG,SAAS,CAAC;YAC3B,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC,CAAA,CAAC;IAEF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAW,CAAC;YACrC,IAAI,GAAG,GAAG,QAAQ,EAAE,CAAC;gBACnB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,MAAM,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,cAAc,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC;IACf,CAAC,CAAA,CAAC;IAEF,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,QAAQ;IACV,CAAC,CAAA,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,cAAc,GAAG,SAAS,CAAC;IAC7B,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;QACH,OAAO;QACP,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"periodicallyUpdatingCache.js","sourceRoot":"","sources":["../../src/periodicallyUpdatingCache.ts"],"names":[],"mappings":";;;;;;;;;;;AAaA,4CA8DC;AAzED;;;;;;;;;;IAUI;AACJ,SAAwB,yBAAyB,CAC/C,GAAW,EACX,MAA0B,EAC1B,EAAgC;IAEhC,IAAI,WAA0B,CAAC;IAC/B,IAAI,SAAqC,CAAC;IAC1C,IAAI,cAAyC,CAAC;IAE9C,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAC;YAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAE3C,WAAW,GAAG,QAAQ,CAAC;YAEvB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;gBAAS,CAAC;YACT,cAAc,GAAG,SAAS,CAAC;YAC3B,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC,CAAA,CAAC;IAEF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,MAAM,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,cAAc,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC;IACf,CAAC,CAAA,CAAC;IAEF,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,QAAQ;IACV,CAAC,CAAA,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,cAAc,GAAG,SAAS,CAAC;IAC7B,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;QACH,OAAO;QACP,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,4DAA4D;;;AA4wB/C,QAAA,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,4DAA4D;;;AAo0B/C,QAAA,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC"}

package/dist/src/utils.js

@@ -9,6 +9,7 @@ exports.applyLogLevel = applyLogLevel;
 exports.decorateLogger = decorateLogger;
 exports.mergeSkipUndefined = mergeSkipUndefined;
 exports.hashObject = hashObject;
+exports.hashString = hashString;
 exports.once = once;
 exports.withTimeout = withTimeout;
 const crypto_1 = require("crypto");
@@ -157,6 +158,16 @@ function hashObject(obj) {
     updateSha1Hash(hash, obj);
     return hash.digest("base64");
 }
+/**
+ * Hash a string using SHA256 and return a hex digest.
+ *
+ * @param value - The string to hash.
+ * @returns The SHA256 hash.
+ */
+function hashString(value) {
+    ok(typeof value === "string", "value must be a string");
+    return (0, crypto_1.createHash)("sha256").update(value).digest("hex");
+}
 function once(fn) {
     let called = false;
     let returned;

package/dist/src/utils.js.map

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

package/dist/types/src/client.d.ts

@@ -25,11 +25,15 @@ export declare class ReflagClient {
     private flagsCache;
     private batchBuffer;
     private rateLimiter;
+    private baseFlagOverrides;
+    private flagOverrideLayers;
+    private nextFlagOverrideLayerId;
     /**
      * Gets the logger associated with the client.
      */
     readonly logger: Logger;
     private initializationFinished;
+    private canLoadFlagsFallbackProvider;
     private _initialize;
     /**
      * Creates a new SDK client.
@@ -53,38 +57,70 @@ export declare class ReflagClient {
      * @throws An error if the options are invalid.
      **/
     constructor(options?: ClientOptions);
+    private loadFlagsFallbackDefinitions;
+    private saveFlagsFallbackDefinitions;
     /**
-     * Sets the flag overrides.
+     * Replaces the base flag overrides used by the client.
      *
      * @param overrides - The flag overrides.
      *
      * @remarks
-     * The flag overrides are used to override the flag definitions.
-     * This is useful for testing or development.
+     * Base overrides are always applied before any temporary layers added through
+     * `pushFlagOverrides()`.
      *
      * @example
      * ```ts
-     * client.flagOverrides = {
+     * client.setFlagOverrides({
      *   "flag-1": true,
      *   "flag-2": false,
-     * };
+     * });
      * ```
      **/
+    setFlagOverrides(overrides: FlagOverridesFn | FlagOverrides): void;
+    /**
+     * @deprecated
+     * Use `setFlagOverrides()` for replacing the base override set.
+     **/
     set flagOverrides(overrides: FlagOverridesFn | FlagOverrides);
     /**
-     * Clears the flag overrides.
+     * Temporarily layers flag overrides on top of the current overrides.
+     *
+     * @param overrides - The flag overrides to apply for the scoped period.
+     *
+     * @returns A remove function that removes only this override layer.
      *
      * @remarks
-     * This is useful for testing or development.
+     * This is intended for tests or other short-lived local overrides. The remove
+     * function is idempotent and can safely be called multiple times.
      *
      * @example
      * ```ts
-     * afterAll(() => {
-     *   client.clearFlagOverrides();
+     * let remove: (() => void) | undefined;
+     *
+     * beforeEach(() => {
+     *   remove = client.pushFlagOverrides({ "flag-1": true });
+     * });
+     *
+     * afterEach(() => {
+     *   remove?.();
+     *   remove = undefined;
      * });
      * ```
      **/
+    pushFlagOverrides(overrides: FlagOverridesFn | FlagOverrides): () => void;
+    /**
+     * Clears the base flag overrides.
+     *
+     * @remarks
+     * This does not affect temporary layers added with `pushFlagOverrides()`.
+     *
+     * @example
+     * ```ts
+     * client.clearFlagOverrides();
+     * ```
+     **/
     clearFlagOverrides(): void;
+    private syncFlagOverrides;
     /**
      * Returns a new BoundReflagClient with the user/company/otherContext
      * set to be used in subsequent calls.

package/dist/types/src/client.d.ts.map

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

package/dist/types/src/flagsFallbackProvider.d.ts

@@ -0,0 +1,81 @@
+import type { FlagsFallbackProvider, FlagsFallbackSnapshot } from "./types";
+export type FileFallbackProviderOptions = {
+    /**
+     * Directory where per-environment snapshots are stored.
+     *
+     * @defaultValue `path.join(process.cwd(), ".reflag")`
+     */
+    directory?: string;
+};
+export type S3FallbackProviderOptions = {
+    /**
+     * Bucket where snapshots are stored.
+     */
+    bucket: string;
+    /**
+     * Optional S3 client. A default client is created when omitted.
+     */
+    client?: {
+        send(command: unknown): Promise<any>;
+    };
+    /**
+     * Prefix for generated per-environment keys.
+     *
+     * @defaultValue `reflag/flags-fallback`
+     */
+    keyPrefix?: string;
+};
+export type GCSFallbackProviderOptions = {
+    /**
+     * Bucket where snapshots are stored.
+     */
+    bucket: string;
+    /**
+     * Optional GCS client. A default client is created when omitted.
+     */
+    client?: {
+        bucket(name: string): {
+            file(path: string): {
+                exists(): Promise<[boolean]>;
+                download(): Promise<[Uint8Array]>;
+                save(body: string, options: {
+                    contentType: string;
+                }): Promise<unknown>;
+            };
+        };
+    };
+    /**
+     * Prefix for generated per-environment keys.
+     *
+     * @defaultValue `reflag/flags-fallback`
+     */
+    keyPrefix?: string;
+};
+export type RedisFallbackProviderOptions = {
+    /**
+     * Optional Redis client. When omitted, a client is created using `REDIS_URL`.
+     */
+    client?: {
+        get(key: string): Promise<string | null | undefined>;
+        set(key: string, value: string): Promise<unknown>;
+    };
+    /**
+     * Prefix for generated per-environment keys.
+     *
+     * @defaultValue `reflag:flags-fallback`
+     */
+    keyPrefix?: string;
+};
+export type StaticFallbackProviderOptions = {
+    /**
+     * Static fallback flags keyed by flag key.
+     */
+    flags: Record<string, boolean>;
+};
+export declare function isFlagsFallbackSnapshot(value: unknown): value is FlagsFallbackSnapshot;
+export declare function createStaticFallbackProvider({ flags, }: StaticFallbackProviderOptions): FlagsFallbackProvider;
+export declare function createFileFallbackProvider({ directory, }?: FileFallbackProviderOptions): FlagsFallbackProvider;
+export declare function createS3FallbackProvider({ bucket, client, keyPrefix, }: S3FallbackProviderOptions): FlagsFallbackProvider;
+export declare function createGCSFallbackProvider({ bucket, client, keyPrefix, }: GCSFallbackProviderOptions): FlagsFallbackProvider;
+export declare function createRedisFallbackProvider({ client, keyPrefix, }?: RedisFallbackProviderOptions): FlagsFallbackProvider;
+//# sourceMappingURL=flagsFallbackProvider.d.ts.map

package/dist/types/src/flagsFallbackProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagsFallbackProvider.d.ts","sourceRoot":"","sources":["../../../src/flagsFallbackProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,qBAAqB,EAErB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;KACtC,CAAC;IAEF;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;YACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG;gBAClB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC7B,QAAQ,IAAI,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;oBAAE,WAAW,EAAE,MAAM,CAAA;iBAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;aACxE,CAAC;SACH,CAAC;KACH,CAAC;IAEF;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;QACrD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACnD,CAAC;IAEF;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAmCF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAQhC;AAmED,wBAAgB,4BAA4B,CAAC,EAC3C,KAAK,GACN,EAAE,6BAA6B,GAAG,qBAAqB,CAgBvD;AAED,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,GACV,GAAE,2BAAgC,GAAG,qBAAqB,CAuB1D;AAED,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,yBAAyB,GAAG,qBAAqB,CAsDnD;AAED,wBAAgB,yBAAyB,CAAC,EACxC,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,0BAA0B,GAAG,qBAAqB,CAiCpD;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,SAAS,GACV,GAAE,4BAAiC,GAAG,qBAAqB,CAsD3D"}