react-native-nitro-amplitude 0.1.0

package/lib/typescript/experiment/integration/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../src/experiment/integration/default.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAMvE,qBAAa,mBAAoB,YAAW,sBAAsB;IACzD,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACjD,UAAU,EAAE,cAAc,CAAM;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;gBAE1D,YAAY,GAAE,sBAAsB,GAAG,IAAW;IAQvD,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAInB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA6B9D,WAAW,IAAI,cAAc;IAavB,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IASxC,OAAO,CAAC,mBAAmB;CAM5B"}

package/lib/typescript/experiment/logger/ampLogger.d.ts

@@ -0,0 +1,47 @@
+import { Logger, LogLevel } from "../types/logger";
+/**
+ * Internal logger class that wraps a Logger implementation and handles log level filtering.
+ * This class provides a centralized logging mechanism for the Experiment client.
+ * @category Logging
+ */
+export declare class AmpLogger implements Logger {
+    private readonly logger;
+    private readonly logLevel;
+    /**
+     * Creates a new AmpLogger instance
+     * @param logger The underlying logger implementation to use
+     * @param logLevel The minimum log level to output. Messages below this level will be ignored.
+     */
+    constructor(logger: Logger, logLevel?: LogLevel);
+    /**
+     * Log an error message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    error(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a warning message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    warn(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log an informational message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    info(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a debug message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    debug(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a verbose message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    verbose(message?: any, ...optionalParams: any[]): void;
+}
+//# sourceMappingURL=ampLogger.d.ts.map

package/lib/typescript/experiment/logger/ampLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ampLogger.d.ts","sourceRoot":"","sources":["../../../../src/experiment/logger/ampLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,SAAU,YAAW,MAAM;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAyB;IAK/D;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAMpD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAMnD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAMnD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAMpD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;CAKvD"}

package/lib/typescript/experiment/logger/consoleLogger.d.ts

@@ -0,0 +1,40 @@
+import { Logger } from "../types/logger";
+/**
+ * Default console-based logger implementation.
+ * This logger uses the browser's console API to output log messages.
+ * Log level filtering is handled by the AmpLogger wrapper class.
+ * @category Logging
+ */
+export declare class ConsoleLogger implements Logger {
+    /**
+     * Log an error message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    error(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a warning message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    warn(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log an informational message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    info(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a debug message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    debug(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a verbose message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    verbose(message?: any, ...optionalParams: any[]): void;
+}
+//# sourceMappingURL=consoleLogger.d.ts.map

package/lib/typescript/experiment/logger/consoleLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleLogger.d.ts","sourceRoot":"","sources":["../../../../src/experiment/logger/consoleLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAIpD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAInD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAInD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAIpD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;CAGvD"}

package/lib/typescript/experiment/storage/cache.d.ts

@@ -0,0 +1,35 @@
+import { EvaluationFlag, GetVariantsOptions } from "@amplitude/experiment-core";
+import { Storage } from "../types/storage";
+import { Variant } from "../types/variant";
+export declare const getVariantStorage: (deploymentKey: string, instanceName: string, storage: Storage) => LoadStoreCache<Variant>;
+export declare const getFlagStorage: (deploymentKey: string, instanceName: string, storage: Storage) => LoadStoreCache<EvaluationFlag>;
+export declare const getVariantsOptionsStorage: (deploymentKey: string, instanceName: string, storage: Storage) => SingleValueStoreCache<GetVariantsOptions>;
+export declare class SingleValueStoreCache<V> {
+    private readonly namespace;
+    private readonly legacyNamespaces;
+    private readonly storage;
+    private value;
+    constructor(namespace: string, storage: Storage, legacyNamespaces?: string[]);
+    get(): V | undefined;
+    put(value: V): void;
+    load(): Promise<void>;
+    store(): Promise<void>;
+}
+export declare class LoadStoreCache<V> {
+    private readonly namespace;
+    private readonly legacyNamespaces;
+    private readonly storage;
+    private readonly transformer?;
+    private cache;
+    constructor(namespace: string, storage: Storage, transformer?: (value: unknown) => V | undefined, legacyNamespaces?: string[]);
+    get(key: string): V | undefined;
+    getAll(): Record<string, V>;
+    put(key: string, value: V): void;
+    putAll(values: Record<string, V>): void;
+    remove(key: string): void;
+    clear(): void;
+    load(initialValues?: Record<string, V>): Promise<void>;
+    store(values?: Record<string, V>): Promise<void>;
+}
+export declare const transformVariantFromStorage: (storageValue: unknown) => Variant | undefined;
+//# sourceMappingURL=cache.d.ts.map

package/lib/typescript/experiment/storage/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/experiment/storage/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,eAAO,MAAM,iBAAiB,GAC5B,eAAe,MAAM,EACrB,cAAc,MAAM,EACpB,SAAS,OAAO,KACf,cAAc,CAAC,OAAO,CASxB,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,eAAe,MAAM,EACrB,cAAc,MAAM,EACpB,SAAS,OAAO,KACf,cAAc,CAAC,cAAc,CAS/B,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,eAAe,MAAM,EACrB,cAAc,MAAM,EACpB,SAAS,OAAO,KACf,qBAAqB,CAAC,kBAAkB,CAY1C,CAAC;AAuBF,qBAAa,qBAAqB,CAAC,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,KAAK,CAAgB;gBAG3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,gBAAgB,GAAE,MAAM,EAAO;IAQ1B,GAAG,IAAI,CAAC,GAAG,SAAS;IAIpB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAIb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CASpC;AAED,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAoC;IACjE,OAAO,CAAC,KAAK,CAAyB;gBAGpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,SAAS,EAC/C,gBAAgB,GAAE,MAAM,EAAO;IAQ1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAI3B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIhC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI;IAMvC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAIP,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CtD,KAAK,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1E;AAED,eAAO,MAAM,2BAA2B,GACtC,cAAc,OAAO,KACpB,OAAO,GAAG,SA8CZ,CAAC"}

package/lib/typescript/experiment/storage/local-storage.d.ts

@@ -0,0 +1,11 @@
+import { Storage } from "../types/storage";
+export declare class MemoryStorage implements Storage {
+    private static readonly memoryStorage;
+    get(key: string): Promise<string | null>;
+    put(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    reset(): Promise<void>;
+}
+export declare class LocalStorage extends MemoryStorage {
+}
+//# sourceMappingURL=local-storage.d.ts.map

package/lib/typescript/experiment/storage/local-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../../src/experiment/storage/local-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,qBAAa,YAAa,SAAQ,aAAa;CAAG"}

package/lib/typescript/experiment/stubClient.d.ts

@@ -0,0 +1,21 @@
+import { Client, FetchOptions } from "./types/client";
+import { ExperimentUser, ExperimentUserProvider } from "./types/user";
+import { Variant, Variants } from "./types/variant";
+/**
+ * A stub {@link Client} implementation that does nothing for all methods
+ */
+export declare class StubExperimentClient implements Client {
+    getUser(): ExperimentUser;
+    start(_user?: ExperimentUser): Promise<void>;
+    stop(): void;
+    setUser(_user: ExperimentUser): void;
+    fetch(_user?: ExperimentUser, _options?: FetchOptions): Promise<StubExperimentClient>;
+    fetchOrThrow(_user?: ExperimentUser, _options?: FetchOptions): Promise<StubExperimentClient>;
+    getUserProvider(): ExperimentUserProvider;
+    setUserProvider(_userProvider: ExperimentUserProvider): StubExperimentClient;
+    variant(_key: string, _fallback?: string | Variant): Variant;
+    all(): Variants;
+    clear(): void;
+    exposure(_key: string): void;
+}
+//# sourceMappingURL=stubClient.d.ts.map

package/lib/typescript/experiment/stubClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubClient.d.ts","sourceRoot":"","sources":["../../../src/experiment/stubClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,qBAAa,oBAAqB,YAAW,MAAM;IAC1C,OAAO,IAAI,cAAc;IAInB,KAAK,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,IAAI,IAAI,IAAI;IAEZ,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAE9B,KAAK,CAChB,KAAK,CAAC,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAInB,YAAY,CACvB,KAAK,CAAC,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAIzB,eAAe,IAAI,sBAAsB;IAQzC,eAAe,CACpB,aAAa,EAAE,sBAAsB,GACpC,oBAAoB;IAIhB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAI5D,GAAG,IAAI,QAAQ;IAIf,KAAK,IAAI,IAAI;IAEb,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CACpC"}

package/lib/typescript/experiment/transport/http.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @packageDocumentation
+ * @internal
+ */
+import { HttpClient as CoreHttpClient, HttpRequest, HttpResponse } from "@amplitude/experiment-core";
+import { HttpClient } from "../types/transport";
+/**
+ * Wrap the exposed HttpClient in a CoreClient implementation to work with
+ * FlagsApi and EvaluationApi.
+ */
+export declare class WrapperClient implements CoreHttpClient {
+    private readonly client;
+    constructor(client: HttpClient);
+    request(request: HttpRequest): Promise<HttpResponse>;
+}
+export declare const FetchHttpClient: HttpClient;
+//# sourceMappingURL=http.d.ts.map

package/lib/typescript/experiment/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/experiment/transport/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,UAAU,IAAI,cAAc,EAC5B,WAAW,EACX,YAAY,EACb,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAsEhE;;;GAGG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBACxB,MAAM,EAAE,UAAU;IAIxB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAS3D;AAED,eAAO,MAAM,eAAe,EAAE,UAAkC,CAAC"}

package/lib/typescript/experiment/types/client.d.ts

@@ -0,0 +1,36 @@
+import { ExperimentUser, ExperimentUserProvider } from "./user";
+import { Variant, Variants } from "./variant";
+/**
+ * Interface for the main client.
+ * @category Core Usage
+ */
+export interface Client {
+    start(user?: ExperimentUser): Promise<void>;
+    stop(): void;
+    fetch(user?: ExperimentUser, options?: FetchOptions): Promise<Client>;
+    fetchOrThrow(user?: ExperimentUser, options?: FetchOptions): Promise<Client>;
+    variant(key: string, fallback?: string | Variant): Variant;
+    all(): Variants;
+    clear(): void;
+    exposure(key: string): void;
+    getUser(): ExperimentUser;
+    setUser(user: ExperimentUser): void;
+    /**
+     * @deprecated use ExperimentConfig.userProvider instead
+     */
+    getUserProvider(): ExperimentUserProvider;
+    /**
+     * @deprecated use ExperimentConfig.userProvider instead
+     */
+    setUserProvider(userProvider: ExperimentUserProvider): Client;
+}
+/**
+ * Options to modify the behavior of a remote evaluation fetch request.
+ */
+export type FetchOptions = {
+    /**
+     * Specific flag keys to evaluate and set variants for.
+     */
+    flagKeys?: string[];
+};
+//# sourceMappingURL=client.d.ts.map

package/lib/typescript/experiment/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/experiment/types/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,YAAY,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3D,GAAG,IAAI,QAAQ,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,IAAI,cAAc,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,eAAe,IAAI,sBAAsB,CAAC;IAC1C;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC"}

package/lib/typescript/experiment/types/config.d.ts

@@ -0,0 +1,164 @@
+import { ExposureTrackingProvider } from "./exposure";
+import { Logger, LogLevel } from "./logger";
+import { Source } from "./source";
+import { Storage } from "./storage";
+import { HttpClient } from "./transport";
+import { ExperimentUserProvider } from "./user";
+import { Variant, Variants } from "./variant";
+/**
+ * @category Configuration
+ */
+export interface ExperimentConfig {
+    /**
+     * Debug all assignment requests in the UI Debugger and log additional
+     * information to the console. This should be false for production builds.
+     * @deprecated Use logLevel instead. When debug is true, it sets logLevel to Debug.
+     */
+    debug?: boolean;
+    /**
+     * The minimum log level to output. Messages below this level will be ignored.
+     * Supported levels: Disable, Error, Warn, Info, Debug, Verbose.
+     * If the deprecated debug flag is set to true, this will be set to Debug.
+     */
+    logLevel?: LogLevel;
+    /**
+     * Custom logger implementation. If not provided, a default ConsoleLogger will be used.
+     * The logger must implement the Logger interface with methods for error, warn, info, debug, and verbose.
+     */
+    loggerProvider?: Logger | null;
+    /**
+     * The name of the instance being initialized. Used for initializing separate
+     * instances of experiment or linking the experiment SDK to a specific
+     * instance of the amplitude analytics SDK.
+     */
+    instanceName?: string;
+    /**
+     * The default fallback variant for all {@link ExperimentClient.variant}
+     * calls.
+     */
+    fallbackVariant?: Variant;
+    /**
+     * Initial values for variants. This is useful for bootstrapping the
+     * client with fallbacks and values evaluated from server-side rendering.
+     * @see Variants
+     */
+    initialVariants?: Variants;
+    /**
+     * Initial values for flags. This is useful for bootstrapping the
+     * client with fallbacks for flag configs.
+     */
+    initialFlags?: string;
+    /**
+     * Determines the primary source of variants and variants before falling back.
+     * @see Source
+     */
+    source?: Source;
+    /**
+     * The domain from which to request variants using remote evaluation.
+     */
+    serverUrl?: string;
+    /**
+     * The domain to request flag configurations used in local evaluation from.
+     */
+    flagsServerUrl?: string;
+    /**
+     * The amplitude data center to fetch flags and variants from. If set,
+     * automatically sets the {@link serverUrl} and {@link flagsServerUrl}
+     * configurations.
+     */
+    serverZone?: "US" | "EU";
+    /**
+     * The request timeout, in milliseconds, when fetching variants.
+     */
+    fetchTimeoutMillis?: number;
+    /**
+     * Set to true to retry fetch requests in the background if the initial
+     * requests fails or times out.
+     */
+    retryFetchOnFailure?: boolean;
+    /**
+     * If true, automatically tracks exposure events though the
+     * `ExperimentAnalyticsProvider`. If no analytics provider is set, this
+     * option does nothing.
+     */
+    automaticExposureTracking?: boolean;
+    /**
+     * Enable or disable local evaluation flag configuration polling on `start()`.
+     */
+    pollOnStart?: boolean;
+    /**
+     * Explicitly enable or disable calling {@link fetch()} on {@link start()}:
+     *
+     *  - `true`:      fetch will always be called on start.
+     *  - `false`:     fetch will never be called on start.
+     *  - `undefined`: fetch will always be called on start.
+     */
+    fetchOnStart?: boolean;
+    /**
+     * This config only matters if you are using the amplitude analytics SDK
+     * integration initialized by calling
+     * `Experiment.initializeWithAmplitudeAnalytics()`.
+     *
+     * If true, the `ExperimentClient` will automatically fetch variants when the
+     * user's identity changes. The user's identity includes user_id, device_id
+     * and any user properties which are `set`, `unset` or `clearAll`ed via a call
+     * to `identify()`.
+     *
+     * Note: Non-idempotent identify operations `setOnce`, `add`, `append`, and
+     * `prepend` are not counted towards the user identity changing.
+     */
+    automaticFetchOnAmplitudeIdentityChange?: boolean;
+    /**
+     * Sets a user provider that will inject identity information into the user
+     * for {@link fetch()} requests. The user provider will only set user fields
+     * in outgoing requests which are null or undefined.
+     *
+     * See {@link ExperimentUserProvider} for more details
+     */
+    userProvider?: ExperimentUserProvider | null;
+    /**
+     * Provides the ability to track exposure events through a 3rd party analytics
+     * implementation.
+     */
+    exposureTrackingProvider?: ExposureTrackingProvider | null;
+    /**
+     * (Advanced) Use your own http client.
+     */
+    httpClient?: HttpClient;
+    /**
+     * (Advanced) Use your own storage implementation.
+     * If not provided, the client will use the built-in shared memory storage implementation.
+     */
+    storage?: Storage | null;
+}
+/**
+ Defaults for Experiment Config options
+
+ | **Option**       | **Default**                       |
+ |------------------|-----------------------------------|
+ | **debug**        | `false`                           |
+ | **logLevel**     | `LogLevel.Error`                  |
+ | **logger**       | `null` (ConsoleLogger will be used) |
+ | **instanceName** | `$default_instance` |
+ | **fallbackVariant**         | `null`                 |
+ | **initialVariants**         | `null`                 |
+ | **initialFlags**         | `undefined`                 |
+ | **source** | `Source.LocalStorage` |
+ | **serverUrl**    | `"https://api.lab.amplitude.com"` |
+ | **flagsServerUrl**    | `"https://flag.lab.amplitude.com"` |
+ | **serverZone**    | `"US"` |
+ | **assignmentTimeoutMillis**    | `10000` |
+ | **retryFailedAssignment**    | `true` |
+ | **automaticExposureTracking** | `true` |
+ | **pollOnStart** | `true` |
+ | **fetchOnStart** | `true` |
+ | **automaticFetchOnAmplitudeIdentityChange** | `false` |
+ | **userProvider**    | `null` |
+ | **analyticsProvider**    | `null` |
+ | **exposureTrackingProvider**    | `null` |
+
+ *
+ * @category Configuration
+ */
+export declare const Defaults: ExperimentConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/typescript/experiment/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/experiment/types/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,uCAAuC,CAAC,EAAE,OAAO,CAAC;IAElD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,wBAAwB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,QAAQ,EAAE,gBAsBtB,CAAC"}

package/lib/typescript/experiment/types/exposure.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Event object for tracking exposures to Amplitude Experiment.
+ *
+ * This object contains all the required information to send an `$exposure`
+ * event through any SDK or CDP to experiment.
+ *
+ * The resulting exposure event must follow the following definition:
+ * ```
+ * {
+ *   "event_type": "$exposure",
+ *   "event_properties": {
+ *     "flag_key": "<flagKey>",
+ *     "variant": "<variant>",
+ *     "experiment_key": "<expKey>"
+ *   }
+ * }
+ * ```
+ *
+ * Where `<flagKey>`, `<variant>`, and `<expKey>` are the {@link flag_key},
+ * {@link variant}, and {@link experiment_key} variant members on this type:
+ *
+ * For example, if you're using Segment for analytics:
+ *
+ * ```
+ * analytics.track('$exposure', exposure)
+ * ```
+ */
+export type Exposure = {
+    /**
+     * (Required) The key for the flag the user was exposed to.
+     */
+    flag_key: string;
+    /**
+     * (Optional) The variant the user was exposed to. If null or missing, the
+     * event will not be persisted, and will unset the user property.
+     */
+    variant?: string;
+    /**
+     * (Optional) The experiment key used to differentiate between multiple
+     * experiments associated with the same flag.
+     */
+    experiment_key?: string;
+    /**
+     * (Optional) Flag, segment, and variant metadata produced as a result of
+     * evaluation for the user. Used for system purposes.
+     */
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Interface for enabling tracking {@link Exposure}s through the
+ * {@link ExperimentClient}.
+ *
+ * If you're using the Amplitude Analytics SDK for tracking you do not need
+ * to implement this interface. Simply initialize experiment using the
+ * {@link Experiment.initializeWithAmplitudeAnalytics} function.
+ *
+ * If you're using a 3rd party analytics implementation then you'll need to
+ * implement the sending of the analytics event yourself. The implementation
+ * should result in the following event getting sent to amplitude:
+ *
+ * ```
+ * {
+ *   "event_type": "$exposure",
+ *   "event_properties": {
+ *     "flag_key": "<flagKey>",
+ *     "variant": "<variant>",
+ *     "experiment_key": "<expKey>"
+ *   }
+ * }
+ * ```
+ *
+ * For example, if you're using Segment for analytics:
+ *
+ * ```
+ * analytics.track('$exposure', exposure)
+ * ```
+ */
+export interface ExposureTrackingProvider {
+    /**
+     * Called when the {@link ExperimentClient} intends to track an exposure event;
+     * either when {@link ExperimentClient.variant} serves a variant (and
+     * {@link ExperimentConfig.automaticExposureTracking} is `true`) or if
+     * {@link ExperimentClient.exposure} is called.
+     *
+     * The implementation should result in the following event getting sent to
+     * amplitude:
+     *
+     * ```
+     * {
+     *   "event_type": "$exposure",
+     *   "event_properties": {
+     *     "flag_key": "<flagKey>",
+     *     "variant": "<variant>",
+     *     "experiment_key": "<expKey>"
+     *   }
+     * }
+     * ```
+     *
+     * For example, if you're using Segment for analytics:
+     *
+     * ```
+     * analytics.track('$exposure', exposure)
+     * ```
+     */
+    track(exposure: Exposure): void;
+}
+//# sourceMappingURL=exposure.d.ts.map

package/lib/typescript/experiment/types/exposure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposure.d.ts","sourceRoot":"","sources":["../../../../src/experiment/types/exposure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC"}

package/lib/typescript/experiment/types/logger.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Log level enumeration for controlling logging verbosity.
+ * @category Logging
+ */
+export declare enum LogLevel {
+    /**
+     * Disable all logging
+     */
+    Disable = 0,
+    /**
+     * Error level logging - only critical errors
+     */
+    Error = 1,
+    /**
+     * Warning level logging - errors and warnings
+     */
+    Warn = 2,
+    /**
+     * Info level logging - errors, warnings, and informational messages
+     */
+    Info = 3,
+    /**
+     * Debug level logging - errors, warnings, info, and debug messages
+     */
+    Debug = 4,
+    /**
+     * Verbose level logging - all messages including verbose details
+     */
+    Verbose = 5
+}
+/**
+ * Logger interface that can be implemented to provide custom logging.
+ * @category Logging
+ */
+export interface Logger {
+    /**
+     * Log an error message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    error(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a warning message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    warn(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log an informational message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    info(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a debug message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    debug(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Log a verbose message
+     * @param message The message to log
+     * @param optionalParams Additional parameters to log
+     */
+    verbose(message?: any, ...optionalParams: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/lib/typescript/experiment/types/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/experiment/types/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,IAAI;IACX;;OAEG;IACH,KAAK,IAAI;IACT;;OAEG;IACH,IAAI,IAAI;IACR;;OAEG;IACH,IAAI,IAAI;IACR;;OAEG;IACH,KAAK,IAAI;IACT;;OAEG;IACH,OAAO,IAAI;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CACxD"}

package/lib/typescript/experiment/types/source.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Determines the primary source of variants before falling back.
+ *
+ * @category Source
+ */
+export declare enum Source {
+    /**
+     * The default way to source variants within your application. Before the
+     * assignments are fetched, `getVariant(s)` will fallback to local storage
+     * first, then `initialVariants` if local storage is empty. This option
+     * effectively falls back to an assignment fetched previously.
+     */
+    LocalStorage = "localStorage",
+    /**
+     * This bootstrap option is used primarily for servers-side rendering using an
+     * Experiment server SDK. This bootstrap option always prefers the config
+     * `initialVariants` over data in local storage, even if variants are fetched
+     * successfully and stored locally.
+     */
+    InitialVariants = "initialVariants"
+}
+/**
+ * Indicates from which source the variant() function determines the variant
+ *
+ * @category Source
+ */
+export declare enum VariantSource {
+    LocalStorage = "storage",
+    InitialVariants = "initial",
+    SecondaryLocalStorage = "secondary-storage",
+    SecondaryInitialVariants = "secondary-initial",
+    FallbackInline = "fallback-inline",
+    FallbackConfig = "fallback-config",
+    LocalEvaluation = "local-evaluation"
+}
+/**
+ * Returns true if the VariantSource is one of the fallbacks (inline or config)
+ *
+ * @param source a {@link VariantSource}
+ * @returns true if source is {@link VariantSource.FallbackInline} or {@link VariantSource.FallbackConfig}
+ */
+export declare const isFallback: (source: VariantSource | undefined) => boolean;
+//# sourceMappingURL=source.d.ts.map

package/lib/typescript/experiment/types/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/experiment/types/source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,MAAM;IAChB;;;;;OAKG;IACH,YAAY,iBAAiB;IAE7B;;;;;OAKG;IACH,eAAe,oBAAoB;CACpC;AAED;;;;GAIG;AACH,oBAAY,aAAa;IACvB,YAAY,YAAY;IACxB,eAAe,YAAY;IAC3B,qBAAqB,sBAAsB;IAC3C,wBAAwB,sBAAsB;IAC9C,cAAc,oBAAoB;IAClC,cAAc,oBAAoB;IAClC,eAAe,qBAAqB;CACrC;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,aAAa,GAAG,SAAS,KAAG,OAO9D,CAAC"}

package/lib/typescript/experiment/types/storage.d.ts

@@ -0,0 +1,7 @@
+export interface Storage {
+    get(key: string): Promise<string | null>;
+    put(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    reset?(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map