@replanejs/sdk 0.9.4 → 1.0.0

package/dist/index.d.ts

@@ -14,20 +14,20 @@ interface SegmentationCondition {
 }
 interface AndCondition {
   operator: "and";
-  conditions: RenderedCondition[];
+  conditions: Condition[];
 }
 interface OrCondition {
   operator: "or";
-  conditions: RenderedCondition[];
+  conditions: Condition[];
 }
 interface NotCondition {
   operator: "not";
-  condition: RenderedCondition;
+  condition: Condition;
 }
-type RenderedCondition = PropertyCondition | SegmentationCondition | AndCondition | OrCondition | NotCondition;
-interface RenderedOverride {
+type Condition = PropertyCondition | SegmentationCondition | AndCondition | OrCondition | NotCondition;
+interface Override {
   name: string;
-  conditions: RenderedCondition[];
+  conditions: Condition[];
   value: unknown;
 }
 //#endregion
@@ -73,7 +73,7 @@ interface ReplaneSnapshot<_T extends object = object> {
   configs: Array<{
     name: string;
     value: unknown;
-    overrides: RenderedOverride[];
+    overrides: Override[];
   }>;
 }
 /**
@@ -278,7 +278,163 @@ declare function getReplaneSnapshot<T extends object>(options: GetReplaneSnapsho
  * Clears the client cache used by getReplaneSnapshot.
  * Useful for testing or when you need to force re-initialization.
  */
-
 //#endregion
-export { type ConnectOptions, type GetConfigOptions, type GetReplaneSnapshotOptions, Replane, type ReplaneContext, ReplaneError, ReplaneErrorCode, type ReplaneLogger, type ReplaneOptions, type ReplaneSnapshot, getReplaneSnapshot };
+//#region src/in-memory.d.ts
+/**
+ * Options for setting a config with overrides.
+ */
+interface SetConfigOptions {
+  /** Override rules for context-based value selection */
+  overrides?: Override[];
+}
+/**
+ * Options for InMemoryReplaneClient constructor.
+ */
+interface InMemoryReplaneClientOptions<T extends object> {
+  /**
+   * Optional logger (defaults to console).
+   */
+  logger?: ReplaneLogger;
+  /**
+   * Default context for all config evaluations.
+   * Can be overridden per-request in `client.get()`.
+   */
+  context?: ReplaneContext;
+  /**
+   * Initial config values.
+   * @example
+   * {
+   *   defaults: {
+   *     "feature-enabled": true,
+   *     "rate-limit": 100,
+   *   },
+   * }
+   */
+  defaults?: { [K in keyof T]?: T[K] };
+}
+/**
+ * An in-memory Replane client for testing.
+ *
+ * This client provides the same interface as `Replane` but stores
+ * all configs in memory. It's useful for unit tests where you don't want
+ * to connect to a real Replane server.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const client = new InMemoryReplaneClient({
+ *   defaults: { "feature-enabled": true, "rate-limit": 100 },
+ * });
+ * expect(client.get("feature-enabled")).toBe(true);
+ *
+ * // Update config at runtime
+ * client.set("feature-enabled", false);
+ * expect(client.get("feature-enabled")).toBe(false);
+ *
+ * // With overrides
+ * client.setConfig("rate-limit", 100, {
+ *   overrides: [{
+ *     name: "premium-users",
+ *     conditions: [{ operator: "equals", property: "plan", value: "premium" }],
+ *     value: 1000,
+ *   }],
+ * });
+ * expect(client.get("rate-limit")).toBe(100);
+ * expect(client.get("rate-limit", { context: { plan: "premium" } })).toBe(1000);
+ * ```
+ *
+ * @typeParam T - Type definition for config keys and values
+ */
+declare class InMemoryReplaneClient<T extends object = Record<string, unknown>> {
+  constructor(options?: InMemoryReplaneClientOptions<T>);
+  /**
+   * Get a config value by name.
+   *
+   * Evaluates any overrides based on the client context and per-call context.
+   *
+   * @param configName - The name of the config to retrieve
+   * @param options - Optional settings for this call
+   * @returns The config value
+   * @throws {ReplaneError} If config not found and no default provided
+   */
+  get<K extends keyof T>(configName: K, options?: GetConfigOptions<T[K]>): T[K];
+  /**
+   * Subscribe to a specific config's changes.
+   *
+   * @param configName - The config to watch
+   * @param callback - Function called when the config changes
+   * @returns Unsubscribe function
+   */
+  subscribe<K extends keyof T>(configName: K, callback: (config: {
+    name: K;
+    value: T[K];
+  }) => void): () => void;
+  /**
+   * Get a serializable snapshot of the current client state.
+   *
+   * @returns Snapshot object that can be serialized to JSON
+   */
+  getSnapshot(): ReplaneSnapshot<T>;
+  /**
+   * Set a config value (simple form without overrides).
+   *
+   * @param name - Config name
+   * @param value - Config value
+   *
+   * @example
+   * ```typescript
+   * client.set("feature-enabled", true);
+   * client.set("rate-limit", 500);
+   * ```
+   */
+  set<K extends keyof T>(name: K, value: T[K]): void;
+  /**
+   * Set a config with optional overrides.
+   *
+   * @param name - Config name
+   * @param value - Base config value
+   * @param options - Optional settings including overrides
+   *
+   * @example
+   * ```typescript
+   * client.setConfig("rate-limit", 100, {
+   *   overrides: [{
+   *     name: "premium-users",
+   *     conditions: [
+   *       { operator: "in", property: "plan", value: ["pro", "enterprise"] }
+   *     ],
+   *     value: 1000,
+   *   }],
+   * });
+   * ```
+   */
+  setConfig<K extends keyof T>(name: K, value: T[K], options?: SetConfigOptions): void;
+  /**
+   * Delete a config.
+   *
+   * @param name - Config name to delete
+   * @returns True if config was deleted, false if it didn't exist
+   */
+  delete<K extends keyof T>(name: K): boolean;
+  /**
+   * Clear all configs.
+   */
+  clear(): void;
+  /**
+   * Check if a config exists.
+   *
+   * @param name - Config name to check
+   * @returns True if config exists
+   */
+  has<K extends keyof T>(name: K): boolean;
+  /**
+   * Get all config names.
+   *
+   * @returns Array of config names
+   */
+  keys(): (keyof T)[];
+}
+//# sourceMappingURL=in-memory.d.ts.map
+//#endregion
+export { type Condition, type ConnectOptions, type GetConfigOptions, type GetReplaneSnapshotOptions, InMemoryReplaneClient, type InMemoryReplaneClientOptions, type Override, Replane, type ReplaneContext, ReplaneError, ReplaneErrorCode, type ReplaneLogger, type ReplaneOptions, type ReplaneSnapshot, type SetConfigOptions, getReplaneSnapshot };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/client-types.ts","../src/client.ts","../src/error.ts","../src/snapshot.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/client-types.ts","../src/client.ts","../src/error.ts","../src/snapshot.ts","../src/in-memory.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js

@@ -30,6 +30,20 @@ var ReplaneError = class extends Error {
 //#endregion
 //#region src/utils.ts
 /**
+* Generates a random UUID using the Web Crypto API.
+* Falls back to a simple implementation if crypto.randomUUID is not available.
+*
+* @returns A random UUID string
+*/
+function generateClientId() {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+	return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+		const r = Math.random() * 16 | 0;
+		const v = c === "x" ? r : r & 3 | 8;
+		return v.toString(16);
+	});
+}
+/**
 * Returns a promise that resolves after the specified delay
 *
 * @param ms - Delay in milliseconds
@@ -481,11 +495,17 @@ function castToContextType(expectedValue, contextValue) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.4";
+const VERSION = "1.0.0";
 const DEFAULT_AGENT = `replane-js-sdk/${VERSION}`;
 
 //#endregion
 //#region src/client.ts
+/**
+* The context key for the auto-generated client ID.
+* This key is automatically set by the SDK and can be used for segmentation.
+* User-provided values for this key take precedence over the auto-generated value.
+*/
+const REPLANE_CLIENT_ID_KEY = "replaneClientId";
 function asReplaneHandle(replane) {
 	return replane;
 }
@@ -563,7 +583,11 @@ var ReplaneImpl = class {
 	*/
 	constructor(options = {}) {
 		this.logger = options.logger ?? console;
-		this.context = { ...options.context ?? {} };
+		const autoGeneratedContext = { [REPLANE_CLIENT_ID_KEY]: generateClientId() };
+		this.context = {
+			...autoGeneratedContext,
+			...options.context ?? {}
+		};
 		const initialConfigs = [];
 		if (options.snapshot) for (const config of options.snapshot.configs) initialConfigs.push({
 			name: config.name,
@@ -744,8 +768,13 @@ var ReplaneImpl = class {
 				})
 			});
 			for await (const event of replicationStream) {
-				const updatedConfigs = event.type === "config_change" ? [event.config] : event.configs;
-				this.processConfigUpdates(updatedConfigs);
+				if (event.type === "init") {
+					this.processConfigUpdates(event.configs);
+					this.logger.info(`Replane: initialized with ${event.configs.length} config(s)`);
+				} else {
+					this.processConfigUpdates([event.config]);
+					this.logger.info(`Replane: config "${event.config.name}" updated`);
+				}
 				clientReady.resolve();
 			}
 		} catch (error) {
@@ -853,5 +882,248 @@ async function getReplaneSnapshot(options) {
 }
 
 //#endregion
-export { Replane, ReplaneError, ReplaneErrorCode, getReplaneSnapshot };
+//#region src/in-memory.ts
+function asHandle(client) {
+	return client;
+}
+/**
+* An in-memory Replane client for testing.
+*
+* This client provides the same interface as `Replane` but stores
+* all configs in memory. It's useful for unit tests where you don't want
+* to connect to a real Replane server.
+*
+* @example
+* ```typescript
+* // Basic usage
+* const client = new InMemoryReplaneClient({
+*   defaults: { "feature-enabled": true, "rate-limit": 100 },
+* });
+* expect(client.get("feature-enabled")).toBe(true);
+*
+* // Update config at runtime
+* client.set("feature-enabled", false);
+* expect(client.get("feature-enabled")).toBe(false);
+*
+* // With overrides
+* client.setConfig("rate-limit", 100, {
+*   overrides: [{
+*     name: "premium-users",
+*     conditions: [{ operator: "equals", property: "plan", value: "premium" }],
+*     value: 1000,
+*   }],
+* });
+* expect(client.get("rate-limit")).toBe(100);
+* expect(client.get("rate-limit", { context: { plan: "premium" } })).toBe(1000);
+* ```
+*
+* @typeParam T - Type definition for config keys and values
+*/
+var InMemoryReplaneClient = class {
+	constructor(options = {}) {
+		asHandle(this)._impl = new InMemoryReplaneClientImpl(options);
+	}
+	/**
+	* Get a config value by name.
+	*
+	* Evaluates any overrides based on the client context and per-call context.
+	*
+	* @param configName - The name of the config to retrieve
+	* @param options - Optional settings for this call
+	* @returns The config value
+	* @throws {ReplaneError} If config not found and no default provided
+	*/
+	get(configName, options) {
+		return asHandle(this)._impl.get(configName, options);
+	}
+	/**
+	* Subscribe to a specific config's changes.
+	*
+	* @param configName - The config to watch
+	* @param callback - Function called when the config changes
+	* @returns Unsubscribe function
+	*/
+	subscribe(configName, callback) {
+		return asHandle(this)._impl.subscribe(configName, callback);
+	}
+	/**
+	* Get a serializable snapshot of the current client state.
+	*
+	* @returns Snapshot object that can be serialized to JSON
+	*/
+	getSnapshot() {
+		return asHandle(this)._impl.getSnapshot();
+	}
+	/**
+	* Set a config value (simple form without overrides).
+	*
+	* @param name - Config name
+	* @param value - Config value
+	*
+	* @example
+	* ```typescript
+	* client.set("feature-enabled", true);
+	* client.set("rate-limit", 500);
+	* ```
+	*/
+	set(name, value) {
+		asHandle(this)._impl.set(name, value);
+	}
+	/**
+	* Set a config with optional overrides.
+	*
+	* @param name - Config name
+	* @param value - Base config value
+	* @param options - Optional settings including overrides
+	*
+	* @example
+	* ```typescript
+	* client.setConfig("rate-limit", 100, {
+	*   overrides: [{
+	*     name: "premium-users",
+	*     conditions: [
+	*       { operator: "in", property: "plan", value: ["pro", "enterprise"] }
+	*     ],
+	*     value: 1000,
+	*   }],
+	* });
+	* ```
+	*/
+	setConfig(name, value, options) {
+		asHandle(this)._impl.setConfig(name, value, options);
+	}
+	/**
+	* Delete a config.
+	*
+	* @param name - Config name to delete
+	* @returns True if config was deleted, false if it didn't exist
+	*/
+	delete(name) {
+		return asHandle(this)._impl.delete(name);
+	}
+	/**
+	* Clear all configs.
+	*/
+	clear() {
+		asHandle(this)._impl.clear();
+	}
+	/**
+	* Check if a config exists.
+	*
+	* @param name - Config name to check
+	* @returns True if config exists
+	*/
+	has(name) {
+		return asHandle(this)._impl.has(name);
+	}
+	/**
+	* Get all config names.
+	*
+	* @returns Array of config names
+	*/
+	keys() {
+		return asHandle(this)._impl.keys();
+	}
+};
+var InMemoryReplaneClientImpl = class {
+	configs;
+	context;
+	logger;
+	configSubscriptions = new Map();
+	constructor(options = {}) {
+		this.logger = options.logger ?? console;
+		this.context = options.context ?? {};
+		const initialConfigs = [];
+		if (options.defaults) {
+			for (const [name, value] of Object.entries(options.defaults)) if (value !== void 0) initialConfigs.push({
+				name,
+				value,
+				overrides: []
+			});
+		}
+		this.configs = new Map(initialConfigs.map((config) => [config.name, config]));
+	}
+	get(configName, options = {}) {
+		const config = this.configs.get(String(configName));
+		if (config === void 0) {
+			if ("default" in options) return options.default;
+			throw new ReplaneError({
+				message: `Config not found: ${String(configName)}`,
+				code: ReplaneErrorCode.NotFound
+			});
+		}
+		try {
+			return evaluateOverrides(config.value, config.overrides, {
+				...this.context,
+				...options?.context ?? {}
+			}, this.logger);
+		} catch (error) {
+			this.logger.error(`Replane: error evaluating overrides for config ${String(configName)}:`, error);
+			return config.value;
+		}
+	}
+	subscribe(configName, callback) {
+		const wrappedCallback = (config) => {
+			callback(config);
+		};
+		if (!this.configSubscriptions.has(configName)) this.configSubscriptions.set(configName, new Set());
+		this.configSubscriptions.get(configName).add(wrappedCallback);
+		return () => {
+			this.configSubscriptions.get(configName)?.delete(wrappedCallback);
+			if (this.configSubscriptions.get(configName)?.size === 0) this.configSubscriptions.delete(configName);
+		};
+	}
+	getSnapshot() {
+		return { configs: [...this.configs.values()].map((config) => ({
+			name: config.name,
+			value: config.value,
+			overrides: config.overrides.map((override) => ({
+				name: override.name,
+				conditions: override.conditions,
+				value: override.value
+			}))
+		})) };
+	}
+	set(name, value) {
+		this.setConfig(name, value);
+	}
+	setConfig(name, value, options) {
+		const overrides = options?.overrides ?? [];
+		const config = {
+			name: String(name),
+			value,
+			overrides
+		};
+		this.configs.set(String(name), config);
+		this.notifySubscribers(name, value);
+	}
+	delete(name) {
+		const existed = this.configs.has(String(name));
+		this.configs.delete(String(name));
+		return existed;
+	}
+	clear() {
+		this.configs.clear();
+	}
+	has(name) {
+		return this.configs.has(String(name));
+	}
+	keys() {
+		return [...this.configs.keys()];
+	}
+	notifySubscribers(name, value) {
+		const change = {
+			name,
+			value
+		};
+		for (const callback of this.configSubscriptions.get(name) ?? []) try {
+			callback(change);
+		} catch (error) {
+			this.logger.error(`Replane: error in subscription callback for ${String(name)}:`, error);
+		}
+	}
+};
+
+//#endregion
+export { InMemoryReplaneClient, Replane, ReplaneError, ReplaneErrorCode, getReplaneSnapshot };
 //# sourceMappingURL=index.js.map