@reflag/node-sdk 1.0.0-alpha.1

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

@@ -0,0 +1,20 @@
+export declare const API_BASE_URL = "https://front.reflag.com";
+export declare const SDK_VERSION_HEADER_NAME = "reflag-sdk-version";
+export declare const SDK_VERSION: string;
+export declare const API_TIMEOUT_MS = 10000;
+export declare const END_FLUSH_TIMEOUT_MS = 5000;
+export declare const REFLAG_LOG_PREFIX = "[Reflag]";
+export declare const FLAG_EVENT_RATE_LIMITER_WINDOW_SIZE_MS: number;
+export declare const FLAGS_REFETCH_MS: number;
+export declare const BATCH_MAX_SIZE = 100;
+export declare const BATCH_INTERVAL_MS: number;
+export declare function loadConfig(file?: string): {
+    secretKey: string | undefined;
+    logLevel: string | undefined;
+    offline: boolean | undefined;
+    apiBaseUrl: any;
+    flagOverrides: {
+        [x: string]: any;
+    };
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AACvD,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,WAAW,QAAwB,CAAC;AACjD,eAAO,MAAM,cAAc,QAAQ,CAAC;AACpC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,eAAO,MAAM,sCAAsC,QAAY,CAAC;AAEhE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,iBAAiB,QAAY,CAAC;AA4G3C,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM;;;;;;;;EAkBvC"}

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

@@ -0,0 +1,25 @@
+import { ReflagClient } from "./client";
+import { ClientOptions } from "./types";
+export type EdgeClientOptions = Omit<ClientOptions, "cacheStrategy" | "flushIntervalMs" | "batchOptions">;
+/**
+ * The EdgeClient is ReflagClient pre-configured to be used in edge runtimes, like
+ * Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * // set the REFLAG_SECRET_KEY environment variable or pass the secret key in the constructor
+ * const client = new EdgeClient();
+ *
+ * // evaluate a flag
+ * const context = {
+ *   user: { id: "user-id" },
+ *   company: { id: "company-id" },
+ * }
+ * const { isEnabled } = client.getFlag(context, "flag-key");
+ *
+ * ```
+ */
+export declare class EdgeClient extends ReflagClient {
+    constructor(options?: EdgeClientOptions);
+}
+//# sourceMappingURL=edgeClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edgeClient.d.ts","sourceRoot":"","sources":["../../../src/edgeClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,aAAa,EACb,eAAe,GAAG,iBAAiB,GAAG,cAAc,CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,GAAE,iBAAsB;CAU5C"}

package/dist/types/src/fetch-http-client.d.ts

@@ -0,0 +1,20 @@
+import { HttpClient } from "./types";
+/**
+ * The default HTTP client implementation.
+ *
+ * @remarks
+ * This implementation uses the `fetch` API to send HTTP requests.
+ **/
+declare const fetchClient: HttpClient;
+/**
+ * Implements exponential backoff retry logic for async functions.
+ *
+ * @param fn - The async function to retry.
+ * @param maxRetries - Maximum number of retry attempts.
+ * @param baseDelay - Base delay in milliseconds before retrying.
+ * @param maxDelay - Maximum delay in milliseconds.
+ * @returns The result of the function call or throws an error if all retries fail.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, onFailedTry: () => void, maxRetries: number, baseDelay: number, maxDelay: number): Promise<T>;
+export default fetchClient;
+//# sourceMappingURL=fetch-http-client.d.ts.map

package/dist/types/src/fetch-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-http-client.d.ts","sourceRoot":"","sources":["../../../src/fetch-http-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;IAKI;AACJ,QAAA,MAAM,WAAW,EAAE,UA8ClB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,EAAE,MAAM,IAAI,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CA0BZ;AAED,eAAe,WAAW,CAAC"}

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

@@ -0,0 +1,4 @@
+type Callback = () => Promise<void>;
+export declare function subscribe(callback: Callback, timeout?: number): void;
+export {};
+//# sourceMappingURL=flusher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flusher.d.ts","sourceRoot":"","sources":["../../../src/flusher.ts"],"names":[],"mappings":"AAKA,KAAK,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAIpC,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,MAA6B,QAkDvC"}

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

@@ -0,0 +1,7 @@
+import { Logger } from "./types";
+export default function inRequestCache<T>(ttl: number, logger: Logger | undefined, fn: () => Promise<T | undefined>): {
+    get(): T | undefined;
+    refresh(): Promise<T | undefined>;
+    waitRefresh: () => Promise<void>;
+};
+//# sourceMappingURL=inRequestCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inRequestCache.d.ts","sourceRoot":"","sources":["../../../src/inRequestCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,CAAC,EACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAkCvB,CAAC,GAAG,SAAS;eAgBH,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;;EAK1C"}

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

@@ -0,0 +1,4 @@
+export { BoundReflagClient, ReflagClient } from "./client";
+export { EdgeClient, EdgeClientOptions } from "./edgeClient";
+export type { Attributes, BatchBufferOptions, CacheStrategy, ClientOptions, Context, ContextWithTracking, EmptyFlagRemoteConfig, Flag, FlagConfigVariant, FlagDefinition, FlagOverride, FlagOverrides, FlagOverridesFn, FlagRemoteConfig, Flags, FlagType, HttpClient, HttpClientResponse, IdType, LOG_LEVELS, Logger, LogLevel, RawFlag, RawFlagRemoteConfig, TrackingMeta, TrackOptions, TypedFlagKey, TypedFlags, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,OAAO,EACP,mBAAmB,EACnB,qBAAqB,EACrB,IAAI,EACJ,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,KAAK,EACL,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,16 @@
+import { Cache, Logger } from "./types";
+/**
+ * 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.
+ **/
+export default function periodicallyUpdatingCache<T>(ttl: number, staleTtl: number, logger: Logger | undefined, fn: () => Promise<T | undefined>): Cache<T>;
+//# sourceMappingURL=periodicallyUpdatingCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"periodicallyUpdatingCache.d.ts","sourceRoot":"","sources":["../../../src/periodicallyUpdatingCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;IAYI;AACJ,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,CAAC,EACjD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAC/B,KAAK,CAAC,CAAC,CAAC,CA2DV"}

package/dist/types/src/rate-limiter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Creates a new rate limiter.
+ *
+ * @typeparam TKey - The type of the key.
+ * @param windowSizeMs - The length of the time window in milliseconds.
+ *
+ * @returns The rate limiter.
+ **/
+export declare function newRateLimiter(windowSizeMs: number): {
+    clearStale: (all?: boolean) => void;
+    isAllowed: (key: string) => boolean;
+    cacheSize: () => number;
+};
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/types/src/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/rate-limiter.ts"],"names":[],"mappings":"AAEA;;;;;;;IAOI;AACJ,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM;uBAQxB,OAAO,KAAW,IAAI;qBAoBvB,MAAM,KAAG,OAAO;;EAyBzC"}