@reflag/node-sdk 1.3.0 → 1.4.0

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

@@ -309,6 +309,46 @@ export type FlagsAPIResponse = {
      */
     features: FlagAPIResponse[];
 };
+/**
+ * Snapshot of flag definitions used for fallback initialization.
+ */
+export type FlagsFallbackSnapshot = {
+    /**
+     * Snapshot schema version.
+     */
+    version: 1;
+    /**
+     * ISO timestamp indicating when the snapshot was saved.
+     */
+    savedAt: string;
+    /**
+     * Raw flag definitions as returned by the API.
+     */
+    flags: FlagAPIResponse[];
+};
+/**
+ * Non-secret context passed to fallback providers so they can derive
+ * storage keys without access to the raw secret key.
+ */
+export type FlagsFallbackProviderContext = {
+    /**
+     * Deterministic hash of the configured secret key.
+     */
+    secretKeyHash: string;
+};
+/**
+ * Provider used to load and save raw flag definition snapshots.
+ */
+export interface FlagsFallbackProvider {
+    /**
+     * Load a previously saved snapshot.
+     */
+    load(context: FlagsFallbackProviderContext): Promise<FlagsFallbackSnapshot | undefined>;
+    /**
+     * Persist a snapshot after a successful live fetch.
+     */
+    save(context: FlagsFallbackProviderContext, snapshot: FlagsFallbackSnapshot): Promise<void>;
+}
 /**
  * (Internal) Flag definitions with the addition of a pre-prepared
  * evaluators functions for the rules.
@@ -511,8 +551,15 @@ export type ClientOptions = {
      *
      * If a record is supplied instead of array, the values of each key are either the
      * configuration values or the boolean value `true`.
+     *
+     * @deprecated Use `flagsFallbackProvider` instead.
      **/
     fallbackFlags?: TypedFlagKey[] | Record<TypedFlagKey, Exclude<FlagOverride, false>>;
+    /**
+     * Optional provider used to load and save raw flag definitions for fallback startup.
+     * Ignored in offline mode.
+     */
+    flagsFallbackProvider?: FlagsFallbackProvider;
     /**
      * The HTTP client to use for sending requests (optional). Default is the built-in fetch client.
      **/
@@ -540,7 +587,8 @@ export type ClientOptions = {
      **/
     flagOverrides?: FlagOverrides | ((context: Context) => FlagOverrides);
     /**
-     * In offline mode, no data is sent or fetched from the the Reflag API.
+     * In offline mode, no data is sent or fetched from the the Reflag API,
+     * and `flagsFallbackProvider` is not used.
      * This is useful for testing or development.
      */
     offline?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;IAEI;AACJ,MAAM,MAAM,YAAY,GAAG;IACzB;;QAEI;IACJ,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;IAEI;AACJ,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7C;;IAEI;AACJ,MAAM,MAAM,SAAS,GAAG;IACtB;;QAEI;IACJ,MAAM,EAAE,OAAO,GAAG,cAAc,CAAC;IAEjC;;QAEI;IACJ,GAAG,EAAE,MAAM,CAAC;IAEZ;;QAEI;IACJ,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC;;QAEI;IACJ,UAAU,EACN,OAAO,GACP;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,GAC7B;QAAE,GAAG,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC;IAE3C;;QAEI;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAElC;;QAEI;IACJ,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAE5B;;QAEI;IACJ,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC;IAElC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC;IAElC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IACE;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;CACd,GACD,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,IAAI,CACnB,OAAO,SAAS,QAAQ,CAAC,QAAQ,CAAC,GAAG,qBAAqB;IAE1D;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAKnB,MAAM,EACF,CAAC;QACC,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,GACZ,qBAAqB,CAAC;IAE1B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,GAAG,CAAC;KACd,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,CAAC,QAAQ,GAAG;IACV,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC,GACF,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE;QACJ;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,KAAK,EAAE;YACL;;eAEG;YACH,MAAM,EAAE,UAAU,CAAC;SACpB,EAAE,CAAC;KACL,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,KAAK;CAAG;AAEzB;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,KAAK,GAC9C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GACpB;KACG,OAAO,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,QAAQ,GACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC9B,IAAI;CACT,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CACjC,MAAM,KAAK,SAAS,KAAK,GACrB,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAC5B;KACG,OAAO,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,YAAY,GACzD,KAAK,CAAC,OAAO,CAAC,GACd,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC;CACpC,CACN,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,SAAS,EAAE;QACT;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,KAAK,EAAE;YACL;;eAEG;YACH,MAAM,EAAE,UAAU,CAAC;SACpB,EAAE,CAAC;KACL,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;IAE9C;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,4BAA4B,EACrC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG;IACnD,gBAAgB,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,eAAe,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,OAAO,EAAE,IAAI,CAAC;IAEd;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI;IAC1C;;QAEI;IACJ,MAAM,EAAE,MAAM,CAAC;IAEf;;QAEI;IACJ,EAAE,EAAE,OAAO,CAAC;IAEZ;;QAEI;IACJ,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF;;;;;;IAMI;AACJ,MAAM,WAAW,UAAU;IACzB;;;;;;;QAOI;IACJ,IAAI,CAAC,KAAK,EAAE,SAAS,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAE1C;;;;;;QAMI;IACJ,GAAG,CAAC,SAAS,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;OAKG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE7C;;;;;OAKG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAC9C;AAED;;;;IAII;AACJ,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI;IACrB;;;QAGI;IACJ,GAAG,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAEzB;;;;QAII;IACJ,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEtC;;;;QAII;IACJ,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAE7C;;QAEI;IACJ,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC;;QAEI;IACJ,YAAY,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;QAEI;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;QAII;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;QAKI;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,YAAY,CAAC;AAEjE;;;IAGI;AACJ,MAAM,MAAM,aAAa,GAAG;IAC1B;;QAEI;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;QAGI;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;QAEI;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;QAEI;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;QAEI;IACJ,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;;;;QAQI;IACJ,aAAa,CAAC,EACV,YAAY,EAAE,GACd,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAE9C;;QAEI;IACJ,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;QAGI;IACJ,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;QAGI;IACJ,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;QAGI;IACJ,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,QAAQ,CAAC,CAAC;IAExE;;;;;QAKI;IACJ,aAAa,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,CAAC,CAAC;IAEtE;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;QAEI;IACJ,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF;;;IAGI;AACJ,MAAM,MAAM,YAAY,GAAG;IACzB;;QAEI;IACJ,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;QAEI;IACJ,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF;;;IAGI;AACJ,MAAM,MAAM,OAAO,GAAG;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE;QACL;;WAEG;QACH,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QAEhC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAE1B;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAE3B;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAE5B;;WAEG;QACH,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;KAClB,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QAEhC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAE1B;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAE5B;;WAEG;QACH,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;KAClB,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC;AAEF;;IAEI;AACJ,MAAM,WAAW,mBAAoB,SAAQ,OAAO;IAClD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,eAAO,MAAM,UAAU,6CAA8C,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC"}

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

@@ -47,6 +47,13 @@ export declare function mergeSkipUndefined<T extends object, U extends object>(t
  * @returns The SHA1 hash of the object.
  **/
 export declare function hashObject(obj: Record<string, any>): string;
+/**
+ * Hash a string using SHA256 and return a hex digest.
+ *
+ * @param value - The string to hash.
+ * @returns The SHA256 hash.
+ */
+export declare function hashString(value: string): string;
 export declare function once<T extends () => ReturnType<T>>(fn: T): () => ReturnType<T>;
 export declare class TimeoutError extends Error {
     constructor(timeoutMs: number);

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;IAKI;AACJ,wBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAIzE;AACD;;IAEI;AACJ,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAK9C;AAED;;;;;IAKI;AACJ,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE/D;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAC9D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,KAAK,CAIzD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;;;;;EAiC/D;AAED;;;;;;IAMI;AACJ,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrE;AAED;;;;;IAKI;AACJ,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACnE,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,GACR,CAAC,GAAG,CAAC,CASP;AAoCD;;;;;IAKI;AACJ,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAO3D;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,UAAU,CAAC,CAAC,CAAC,EAChD,EAAE,EAAE,CAAC,GACJ,MAAM,UAAU,CAAC,CAAC,CAAC,CAWrB;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,SAAS,EAAE,MAAM;CAI9B;AAED;;;;;;;;;IASI;AACJ,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAmBZ"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;IAKI;AACJ,wBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAIzE;AACD;;IAEI;AACJ,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAK9C;AAED;;;;;IAKI;AACJ,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE/D;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAC9D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,KAAK,CAIzD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;;;;;EAiC/D;AAED;;;;;;IAMI;AACJ,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrE;AAED;;;;;IAKI;AACJ,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACnE,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,GACR,CAAC,GAAG,CAAC,CASP;AAoCD;;;;;IAKI;AACJ,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAO3D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,UAAU,CAAC,CAAC,CAAC,EAChD,EAAE,EAAE,CAAC,GACJ,MAAM,UAAU,CAAC,CAAC,CAAC,CAWrB;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,SAAS,EAAE,MAAM;CAI9B;AAED;;;;;;;;;IASI;AACJ,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reflag/node-sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -45,6 +45,9 @@
     "vitest": "~1.6.0"
   },
   "dependencies": {
+    "@aws-sdk/client-s3": "^3.888.0",
+    "@google-cloud/storage": "^7.19.0",
+    "@redis/client": "^5.11.0",
     "@reflag/flag-evaluation": "1.0.0"
   }
 }