@getflaggy/sdk 0.1.0

package/dist/chunk-HBGNXCEV.mjs

@@ -0,0 +1,281 @@
+// src/sse.ts
+var SSEManager = class {
+  constructor(options) {
+    this.abortController = null;
+    this.retryCount = 0;
+    this.retryTimeout = null;
+    this.destroyed = false;
+    this.url = options.url;
+    this.apiKey = options.apiKey;
+    this.onEvent = options.onEvent;
+    this.onError = options.onError;
+    this.retryDelay = options.retryDelay ?? 1e3;
+    this.maxRetryDelay = options.maxRetryDelay ?? 3e4;
+  }
+  connect() {
+    if (this.destroyed) return;
+    this.abortController = new AbortController();
+    fetch(this.url, {
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "text/event-stream"
+      },
+      signal: this.abortController.signal
+    }).then((response) => {
+      if (!response.ok) {
+        throw new Error(`SSE connection failed: ${response.status}`);
+      }
+      if (!response.body) {
+        throw new Error("SSE response has no body");
+      }
+      this.retryCount = 0;
+      this.readStream(response.body);
+    }).catch((err) => {
+      if (this.destroyed) return;
+      if (err instanceof Error && err.name === "AbortError") return;
+      this.onError(err instanceof Error ? err : new Error(String(err)));
+      this.reconnect();
+    });
+  }
+  destroy() {
+    this.destroyed = true;
+    this.abortController?.abort();
+    this.abortController = null;
+    if (this.retryTimeout) {
+      clearTimeout(this.retryTimeout);
+      this.retryTimeout = null;
+    }
+  }
+  async readStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let currentEvent = "";
+    let currentData = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (line.startsWith("event:")) {
+            currentEvent = line.slice(6).trim();
+          } else if (line.startsWith("data:")) {
+            currentData = line.slice(5).trim();
+          } else if (line === "") {
+            if (currentData) {
+              this.handleEvent(currentEvent, currentData);
+            }
+            currentEvent = "";
+            currentData = "";
+          }
+        }
+      }
+    } catch (err) {
+      if (this.destroyed) return;
+      if (err instanceof Error && err.name === "AbortError") return;
+      this.onError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      reader.releaseLock();
+    }
+    if (!this.destroyed) {
+      this.reconnect();
+    }
+  }
+  handleEvent(eventType, data) {
+    try {
+      const parsed = JSON.parse(data);
+      if (eventType && !parsed.type) {
+        parsed.type = eventType;
+      }
+      this.onEvent(parsed);
+    } catch {
+    }
+  }
+  reconnect() {
+    if (this.destroyed) return;
+    const delay = this.getBackoffDelay();
+    this.retryCount++;
+    this.retryTimeout = setTimeout(() => {
+      this.retryTimeout = null;
+      this.connect();
+    }, delay);
+  }
+  getBackoffDelay() {
+    const delay = this.retryDelay * Math.pow(2, this.retryCount);
+    const jitter = delay * 0.25 * (Math.random() * 2 - 1);
+    return Math.min(delay + jitter, this.maxRetryDelay);
+  }
+};
+
+// src/client.ts
+var FlaggyClient = class {
+  constructor(options) {
+    this.cache = /* @__PURE__ */ new Map();
+    this._ready = false;
+    this._error = null;
+    this.sseManager = null;
+    this.contextAbortController = null;
+    this.listeners = {
+      change: /* @__PURE__ */ new Set(),
+      ready: /* @__PURE__ */ new Set(),
+      error: /* @__PURE__ */ new Set()
+    };
+    this.serverUrl = options.serverUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.context = options.context ?? {};
+    this.enableStreaming = options.enableStreaming ?? true;
+    this.sseRetryDelay = options.sseRetryDelay ?? 1e3;
+    this.sseMaxRetryDelay = options.sseMaxRetryDelay ?? 3e4;
+  }
+  get ready() {
+    return this._ready;
+  }
+  get error() {
+    return this._error;
+  }
+  async initialize() {
+    try {
+      const response = await this.fetchApi(
+        "/api/v1/evaluate/batch",
+        { context: this.context }
+      );
+      this.applyBatchResult(response);
+      this._ready = true;
+      this.emit("ready");
+    } catch (err) {
+      this._error = err instanceof Error ? err : new Error(String(err));
+      this.emit("error", this._error);
+    }
+    if (this.enableStreaming) {
+      this.startSSE();
+    }
+  }
+  getFlag(key, defaultValue) {
+    if (!this._ready || !this.cache.has(key)) {
+      return defaultValue;
+    }
+    return this.cache.get(key);
+  }
+  async setContext(context) {
+    this.context = context;
+    this.contextAbortController?.abort();
+    const controller = new AbortController();
+    this.contextAbortController = controller;
+    try {
+      const response = await this.fetchApi(
+        "/api/v1/evaluate/batch",
+        { context },
+        controller.signal
+      );
+      if (controller.signal.aborted) return;
+      this.applyBatchResult(response);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") return;
+      this._error = err instanceof Error ? err : new Error(String(err));
+      this.emit("error", this._error);
+    }
+  }
+  on(event, listener) {
+    this.listeners[event].add(listener);
+    return () => {
+      this.listeners[event].delete(listener);
+    };
+  }
+  destroy() {
+    this.sseManager?.destroy();
+    this.sseManager = null;
+    this.contextAbortController?.abort();
+    this.contextAbortController = null;
+    this.listeners.change.clear();
+    this.listeners.ready.clear();
+    this.listeners.error.clear();
+  }
+  startSSE() {
+    this.sseManager = new SSEManager({
+      url: `${this.serverUrl}/api/v1/stream`,
+      apiKey: this.apiKey,
+      onEvent: (event) => this.handleSSEEvent(event),
+      onError: (err) => this.emit("error", err),
+      retryDelay: this.sseRetryDelay,
+      maxRetryDelay: this.sseMaxRetryDelay
+    });
+    this.sseManager.connect();
+  }
+  async handleSSEEvent(event) {
+    if (event.type === "flag_deleted") {
+      if (this.cache.has(event.key)) {
+        this.cache.delete(event.key);
+        this.emit("change", event.key, void 0);
+      }
+      return;
+    }
+    try {
+      const response = await this.fetchApi(
+        "/api/v1/evaluate",
+        { flag_key: event.key, context: this.context }
+      );
+      const oldValue = this.cache.get(event.key);
+      this.cache.set(event.key, response.value);
+      if (oldValue !== response.value) {
+        this.emit("change", event.key, response.value);
+      }
+    } catch {
+    }
+  }
+  applyBatchResult(response) {
+    const newCache = /* @__PURE__ */ new Map();
+    for (const flag of response.results) {
+      newCache.set(flag.flag_key, flag.value);
+    }
+    for (const [key, newValue] of newCache) {
+      const oldValue = this.cache.get(key);
+      if (oldValue !== newValue) {
+        this.emit("change", key, newValue);
+      }
+    }
+    for (const key of this.cache.keys()) {
+      if (!newCache.has(key)) {
+        this.emit("change", key, void 0);
+      }
+    }
+    this.cache = newCache;
+  }
+  emit(event, ...args) {
+    if (event === "change") {
+      for (const listener of this.listeners.change) {
+        listener(args[0], args[1]);
+      }
+    } else if (event === "ready") {
+      for (const listener of this.listeners.ready) {
+        listener();
+      }
+    } else if (event === "error") {
+      for (const listener of this.listeners.error) {
+        listener(args[0]);
+      }
+    }
+  }
+  async fetchApi(path, body, signal) {
+    const response = await fetch(`${this.serverUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!response.ok) {
+      throw new Error(`Flaggy API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+};
+
+export {
+  FlaggyClient
+};
+//# sourceMappingURL=chunk-HBGNXCEV.mjs.map

package/dist/chunk-HBGNXCEV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sse.ts","../src/client.ts"],"sourcesContent":["import type { FlagChangeEvent } from './types';\n\nexport interface SSEManagerOptions {\n  url: string;\n  apiKey: string;\n  onEvent: (event: FlagChangeEvent) => void;\n  onError: (error: Error) => void;\n  retryDelay?: number;\n  maxRetryDelay?: number;\n}\n\nexport class SSEManager {\n  private abortController: AbortController | null = null;\n  private retryCount = 0;\n  private retryTimeout: ReturnType<typeof setTimeout> | null = null;\n  private destroyed = false;\n\n  private readonly url: string;\n  private readonly apiKey: string;\n  private readonly onEvent: (event: FlagChangeEvent) => void;\n  private readonly onError: (error: Error) => void;\n  private readonly retryDelay: number;\n  private readonly maxRetryDelay: number;\n\n  constructor(options: SSEManagerOptions) {\n    this.url = options.url;\n    this.apiKey = options.apiKey;\n    this.onEvent = options.onEvent;\n    this.onError = options.onError;\n    this.retryDelay = options.retryDelay ?? 1000;\n    this.maxRetryDelay = options.maxRetryDelay ?? 30_000;\n  }\n\n  connect(): void {\n    if (this.destroyed) return;\n\n    this.abortController = new AbortController();\n\n    fetch(this.url, {\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        Accept: 'text/event-stream',\n      },\n      signal: this.abortController.signal,\n    })\n      .then((response) => {\n        if (!response.ok) {\n          throw new Error(`SSE connection failed: ${response.status}`);\n        }\n        if (!response.body) {\n          throw new Error('SSE response has no body');\n        }\n\n        this.retryCount = 0;\n        this.readStream(response.body);\n      })\n      .catch((err: unknown) => {\n        if (this.destroyed) return;\n        if (err instanceof Error && err.name === 'AbortError') return;\n\n        this.onError(err instanceof Error ? err : new Error(String(err)));\n        this.reconnect();\n      });\n  }\n\n  destroy(): void {\n    this.destroyed = true;\n    this.abortController?.abort();\n    this.abortController = null;\n    if (this.retryTimeout) {\n      clearTimeout(this.retryTimeout);\n      this.retryTimeout = null;\n    }\n  }\n\n  private async readStream(body: ReadableStream<Uint8Array>): Promise<void> {\n    const reader = body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let currentEvent = '';\n    let currentData = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n\n        const lines = buffer.split('\\n');\n        // Keep the last incomplete line in the buffer\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('event:')) {\n            currentEvent = line.slice(6).trim();\n          } else if (line.startsWith('data:')) {\n            currentData = line.slice(5).trim();\n          } else if (line === '') {\n            // Empty line = end of event\n            if (currentData) {\n              this.handleEvent(currentEvent, currentData);\n            }\n            currentEvent = '';\n            currentData = '';\n          }\n        }\n      }\n    } catch (err: unknown) {\n      if (this.destroyed) return;\n      if (err instanceof Error && err.name === 'AbortError') return;\n\n      this.onError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      reader.releaseLock();\n    }\n\n    // Stream ended — reconnect if not destroyed\n    if (!this.destroyed) {\n      this.reconnect();\n    }\n  }\n\n  private handleEvent(eventType: string, data: string): void {\n    try {\n      const parsed = JSON.parse(data) as FlagChangeEvent;\n      // Use the event type from the SSE field if present, otherwise from data\n      if (eventType && !parsed.type) {\n        parsed.type = eventType as FlagChangeEvent['type'];\n      }\n      this.onEvent(parsed);\n    } catch {\n      // Malformed event data, skip\n    }\n  }\n\n  private reconnect(): void {\n    if (this.destroyed) return;\n\n    const delay = this.getBackoffDelay();\n    this.retryCount++;\n    this.retryTimeout = setTimeout(() => {\n      this.retryTimeout = null;\n      this.connect();\n    }, delay);\n  }\n\n  private getBackoffDelay(): number {\n    const delay = this.retryDelay * Math.pow(2, this.retryCount);\n    const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n    return Math.min(delay + jitter, this.maxRetryDelay);\n  }\n}\n","import { SSEManager } from './sse';\nimport type {\n  FlagValue,\n  FlaggyContext,\n  FlaggyClientOptions,\n  EvaluateResponse,\n  BatchEvaluateResponse,\n  FlagChangeEvent,\n  FlagChangeListener,\n  ReadyListener,\n  ErrorListener,\n} from './types';\n\ntype EventMap = {\n  change: FlagChangeListener;\n  ready: ReadyListener;\n  error: ErrorListener;\n};\n\nexport class FlaggyClient {\n  private readonly serverUrl: string;\n  private readonly apiKey: string;\n  private readonly enableStreaming: boolean;\n  private readonly sseRetryDelay: number;\n  private readonly sseMaxRetryDelay: number;\n\n  private context: FlaggyContext;\n  private cache = new Map<string, FlagValue>();\n  private _ready = false;\n  private _error: Error | null = null;\n  private sseManager: SSEManager | null = null;\n  private contextAbortController: AbortController | null = null;\n\n  private listeners: {\n    change: Set<FlagChangeListener>;\n    ready: Set<ReadyListener>;\n    error: Set<ErrorListener>;\n  } = {\n    change: new Set(),\n    ready: new Set(),\n    error: new Set(),\n  };\n\n  constructor(options: FlaggyClientOptions) {\n    this.serverUrl = options.serverUrl.replace(/\\/$/, '');\n    this.apiKey = options.apiKey;\n    this.context = options.context ?? {};\n    this.enableStreaming = options.enableStreaming ?? true;\n    this.sseRetryDelay = options.sseRetryDelay ?? 1000;\n    this.sseMaxRetryDelay = options.sseMaxRetryDelay ?? 30_000;\n  }\n\n  get ready(): boolean {\n    return this._ready;\n  }\n\n  get error(): Error | null {\n    return this._error;\n  }\n\n  async initialize(): Promise<void> {\n    try {\n      const response = await this.fetchApi<BatchEvaluateResponse>(\n        '/api/v1/evaluate/batch',\n        { context: this.context },\n      );\n      this.applyBatchResult(response);\n      this._ready = true;\n      this.emit('ready');\n    } catch (err: unknown) {\n      this._error = err instanceof Error ? err : new Error(String(err));\n      this.emit('error', this._error);\n    }\n\n    if (this.enableStreaming) {\n      this.startSSE();\n    }\n  }\n\n  getFlag<T extends FlagValue>(key: string, defaultValue: T): T {\n    if (!this._ready || !this.cache.has(key)) {\n      return defaultValue;\n    }\n    return this.cache.get(key) as T;\n  }\n\n  async setContext(context: FlaggyContext): Promise<void> {\n    this.context = context;\n    this.contextAbortController?.abort();\n    const controller = new AbortController();\n    this.contextAbortController = controller;\n\n    try {\n      const response = await this.fetchApi<BatchEvaluateResponse>(\n        '/api/v1/evaluate/batch',\n        { context },\n        controller.signal,\n      );\n      if (controller.signal.aborted) return;\n      this.applyBatchResult(response);\n    } catch (err: unknown) {\n      if (err instanceof Error && err.name === 'AbortError') return;\n      this._error = err instanceof Error ? err : new Error(String(err));\n      this.emit('error', this._error);\n    }\n  }\n\n  on<E extends keyof EventMap>(event: E, listener: EventMap[E]): () => void {\n    (this.listeners[event] as Set<EventMap[E]>).add(listener);\n    return () => {\n      (this.listeners[event] as Set<EventMap[E]>).delete(listener);\n    };\n  }\n\n  destroy(): void {\n    this.sseManager?.destroy();\n    this.sseManager = null;\n    this.contextAbortController?.abort();\n    this.contextAbortController = null;\n    this.listeners.change.clear();\n    this.listeners.ready.clear();\n    this.listeners.error.clear();\n  }\n\n  private startSSE(): void {\n    this.sseManager = new SSEManager({\n      url: `${this.serverUrl}/api/v1/stream`,\n      apiKey: this.apiKey,\n      onEvent: (event) => this.handleSSEEvent(event),\n      onError: (err) => this.emit('error', err),\n      retryDelay: this.sseRetryDelay,\n      maxRetryDelay: this.sseMaxRetryDelay,\n    });\n    this.sseManager.connect();\n  }\n\n  private async handleSSEEvent(event: FlagChangeEvent): Promise<void> {\n    if (event.type === 'flag_deleted') {\n      if (this.cache.has(event.key)) {\n        this.cache.delete(event.key);\n        this.emit('change', event.key, undefined as unknown as FlagValue);\n      }\n      return;\n    }\n\n    // flag_updated or flag_created — re-evaluate this flag\n    try {\n      const response = await this.fetchApi<EvaluateResponse>(\n        '/api/v1/evaluate',\n        { flag_key: event.key, context: this.context },\n      );\n      const oldValue = this.cache.get(event.key);\n      this.cache.set(event.key, response.value);\n      if (oldValue !== response.value) {\n        this.emit('change', event.key, response.value);\n      }\n    } catch {\n      // Failed to re-evaluate, keep previous cached value\n    }\n  }\n\n  private applyBatchResult(response: BatchEvaluateResponse): void {\n    const newCache = new Map<string, FlagValue>();\n    for (const flag of response.results) {\n      newCache.set(flag.flag_key, flag.value);\n    }\n\n    // Emit changes for any values that differ\n    for (const [key, newValue] of newCache) {\n      const oldValue = this.cache.get(key);\n      if (oldValue !== newValue) {\n        this.emit('change', key, newValue);\n      }\n    }\n\n    // Emit changes for keys that were removed\n    for (const key of this.cache.keys()) {\n      if (!newCache.has(key)) {\n        this.emit('change', key, undefined as unknown as FlagValue);\n      }\n    }\n\n    this.cache = newCache;\n  }\n\n  private emit(event: 'change', key: string, value: FlagValue): void;\n  private emit(event: 'ready'): void;\n  private emit(event: 'error', error: Error): void;\n  private emit(event: keyof EventMap, ...args: unknown[]): void {\n    if (event === 'change') {\n      for (const listener of this.listeners.change) {\n        listener(args[0] as string, args[1] as FlagValue);\n      }\n    } else if (event === 'ready') {\n      for (const listener of this.listeners.ready) {\n        listener();\n      }\n    } else if (event === 'error') {\n      for (const listener of this.listeners.error) {\n        listener(args[0] as Error);\n      }\n    }\n  }\n\n  private async fetchApi<T>(\n    path: string,\n    body: unknown,\n    signal?: AbortSignal,\n  ): Promise<T> {\n    const response = await fetch(`${this.serverUrl}${path}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(body),\n      signal,\n    });\n    if (!response.ok) {\n      throw new Error(`Flaggy API error: ${response.status} ${response.statusText}`);\n    }\n    return response.json() as Promise<T>;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -0,0 +1,307 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  FlaggyClient: () => FlaggyClient
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/sse.ts
+var SSEManager = class {
+  constructor(options) {
+    this.abortController = null;
+    this.retryCount = 0;
+    this.retryTimeout = null;
+    this.destroyed = false;
+    this.url = options.url;
+    this.apiKey = options.apiKey;
+    this.onEvent = options.onEvent;
+    this.onError = options.onError;
+    this.retryDelay = options.retryDelay ?? 1e3;
+    this.maxRetryDelay = options.maxRetryDelay ?? 3e4;
+  }
+  connect() {
+    if (this.destroyed) return;
+    this.abortController = new AbortController();
+    fetch(this.url, {
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "text/event-stream"
+      },
+      signal: this.abortController.signal
+    }).then((response) => {
+      if (!response.ok) {
+        throw new Error(`SSE connection failed: ${response.status}`);
+      }
+      if (!response.body) {
+        throw new Error("SSE response has no body");
+      }
+      this.retryCount = 0;
+      this.readStream(response.body);
+    }).catch((err) => {
+      if (this.destroyed) return;
+      if (err instanceof Error && err.name === "AbortError") return;
+      this.onError(err instanceof Error ? err : new Error(String(err)));
+      this.reconnect();
+    });
+  }
+  destroy() {
+    this.destroyed = true;
+    this.abortController?.abort();
+    this.abortController = null;
+    if (this.retryTimeout) {
+      clearTimeout(this.retryTimeout);
+      this.retryTimeout = null;
+    }
+  }
+  async readStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let currentEvent = "";
+    let currentData = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (line.startsWith("event:")) {
+            currentEvent = line.slice(6).trim();
+          } else if (line.startsWith("data:")) {
+            currentData = line.slice(5).trim();
+          } else if (line === "") {
+            if (currentData) {
+              this.handleEvent(currentEvent, currentData);
+            }
+            currentEvent = "";
+            currentData = "";
+          }
+        }
+      }
+    } catch (err) {
+      if (this.destroyed) return;
+      if (err instanceof Error && err.name === "AbortError") return;
+      this.onError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      reader.releaseLock();
+    }
+    if (!this.destroyed) {
+      this.reconnect();
+    }
+  }
+  handleEvent(eventType, data) {
+    try {
+      const parsed = JSON.parse(data);
+      if (eventType && !parsed.type) {
+        parsed.type = eventType;
+      }
+      this.onEvent(parsed);
+    } catch {
+    }
+  }
+  reconnect() {
+    if (this.destroyed) return;
+    const delay = this.getBackoffDelay();
+    this.retryCount++;
+    this.retryTimeout = setTimeout(() => {
+      this.retryTimeout = null;
+      this.connect();
+    }, delay);
+  }
+  getBackoffDelay() {
+    const delay = this.retryDelay * Math.pow(2, this.retryCount);
+    const jitter = delay * 0.25 * (Math.random() * 2 - 1);
+    return Math.min(delay + jitter, this.maxRetryDelay);
+  }
+};
+
+// src/client.ts
+var FlaggyClient = class {
+  constructor(options) {
+    this.cache = /* @__PURE__ */ new Map();
+    this._ready = false;
+    this._error = null;
+    this.sseManager = null;
+    this.contextAbortController = null;
+    this.listeners = {
+      change: /* @__PURE__ */ new Set(),
+      ready: /* @__PURE__ */ new Set(),
+      error: /* @__PURE__ */ new Set()
+    };
+    this.serverUrl = options.serverUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.context = options.context ?? {};
+    this.enableStreaming = options.enableStreaming ?? true;
+    this.sseRetryDelay = options.sseRetryDelay ?? 1e3;
+    this.sseMaxRetryDelay = options.sseMaxRetryDelay ?? 3e4;
+  }
+  get ready() {
+    return this._ready;
+  }
+  get error() {
+    return this._error;
+  }
+  async initialize() {
+    try {
+      const response = await this.fetchApi(
+        "/api/v1/evaluate/batch",
+        { context: this.context }
+      );
+      this.applyBatchResult(response);
+      this._ready = true;
+      this.emit("ready");
+    } catch (err) {
+      this._error = err instanceof Error ? err : new Error(String(err));
+      this.emit("error", this._error);
+    }
+    if (this.enableStreaming) {
+      this.startSSE();
+    }
+  }
+  getFlag(key, defaultValue) {
+    if (!this._ready || !this.cache.has(key)) {
+      return defaultValue;
+    }
+    return this.cache.get(key);
+  }
+  async setContext(context) {
+    this.context = context;
+    this.contextAbortController?.abort();
+    const controller = new AbortController();
+    this.contextAbortController = controller;
+    try {
+      const response = await this.fetchApi(
+        "/api/v1/evaluate/batch",
+        { context },
+        controller.signal
+      );
+      if (controller.signal.aborted) return;
+      this.applyBatchResult(response);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") return;
+      this._error = err instanceof Error ? err : new Error(String(err));
+      this.emit("error", this._error);
+    }
+  }
+  on(event, listener) {
+    this.listeners[event].add(listener);
+    return () => {
+      this.listeners[event].delete(listener);
+    };
+  }
+  destroy() {
+    this.sseManager?.destroy();
+    this.sseManager = null;
+    this.contextAbortController?.abort();
+    this.contextAbortController = null;
+    this.listeners.change.clear();
+    this.listeners.ready.clear();
+    this.listeners.error.clear();
+  }
+  startSSE() {
+    this.sseManager = new SSEManager({
+      url: `${this.serverUrl}/api/v1/stream`,
+      apiKey: this.apiKey,
+      onEvent: (event) => this.handleSSEEvent(event),
+      onError: (err) => this.emit("error", err),
+      retryDelay: this.sseRetryDelay,
+      maxRetryDelay: this.sseMaxRetryDelay
+    });
+    this.sseManager.connect();
+  }
+  async handleSSEEvent(event) {
+    if (event.type === "flag_deleted") {
+      if (this.cache.has(event.key)) {
+        this.cache.delete(event.key);
+        this.emit("change", event.key, void 0);
+      }
+      return;
+    }
+    try {
+      const response = await this.fetchApi(
+        "/api/v1/evaluate",
+        { flag_key: event.key, context: this.context }
+      );
+      const oldValue = this.cache.get(event.key);
+      this.cache.set(event.key, response.value);
+      if (oldValue !== response.value) {
+        this.emit("change", event.key, response.value);
+      }
+    } catch {
+    }
+  }
+  applyBatchResult(response) {
+    const newCache = /* @__PURE__ */ new Map();
+    for (const flag of response.results) {
+      newCache.set(flag.flag_key, flag.value);
+    }
+    for (const [key, newValue] of newCache) {
+      const oldValue = this.cache.get(key);
+      if (oldValue !== newValue) {
+        this.emit("change", key, newValue);
+      }
+    }
+    for (const key of this.cache.keys()) {
+      if (!newCache.has(key)) {
+        this.emit("change", key, void 0);
+      }
+    }
+    this.cache = newCache;
+  }
+  emit(event, ...args) {
+    if (event === "change") {
+      for (const listener of this.listeners.change) {
+        listener(args[0], args[1]);
+      }
+    } else if (event === "ready") {
+      for (const listener of this.listeners.ready) {
+        listener();
+      }
+    } else if (event === "error") {
+      for (const listener of this.listeners.error) {
+        listener(args[0]);
+      }
+    }
+  }
+  async fetchApi(path, body, signal) {
+    const response = await fetch(`${this.serverUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!response.ok) {
+      throw new Error(`Flaggy API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlaggyClient
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["export { FlaggyClient } from './client';\nexport type {\n  FlagValue,\n  FlaggyContext,\n  FlaggyClientOptions,\n  EvaluatedFlag,\n  EvaluateResponse,\n  BatchEvaluateResponse,\n  FlagChangeEvent,\n  FlagChangeListener,\n  ReadyListener,\n  ErrorListener,\n} from './types';\n","import type { FlagChangeEvent } from './types';\n\nexport interface SSEManagerOptions {\n  url: string;\n  apiKey: string;\n  onEvent: (event: FlagChangeEvent) => void;\n  onError: (error: Error) => void;\n  retryDelay?: number;\n  maxRetryDelay?: number;\n}\n\nexport class SSEManager {\n  private abortController: AbortController | null = null;\n  private retryCount = 0;\n  private retryTimeout: ReturnType<typeof setTimeout> | null = null;\n  private destroyed = false;\n\n  private readonly url: string;\n  private readonly apiKey: string;\n  private readonly onEvent: (event: FlagChangeEvent) => void;\n  private readonly onError: (error: Error) => void;\n  private readonly retryDelay: number;\n  private readonly maxRetryDelay: number;\n\n  constructor(options: SSEManagerOptions) {\n    this.url = options.url;\n    this.apiKey = options.apiKey;\n    this.onEvent = options.onEvent;\n    this.onError = options.onError;\n    this.retryDelay = options.retryDelay ?? 1000;\n    this.maxRetryDelay = options.maxRetryDelay ?? 30_000;\n  }\n\n  connect(): void {\n    if (this.destroyed) return;\n\n    this.abortController = new AbortController();\n\n    fetch(this.url, {\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        Accept: 'text/event-stream',\n      },\n      signal: this.abortController.signal,\n    })\n      .then((response) => {\n        if (!response.ok) {\n          throw new Error(`SSE connection failed: ${response.status}`);\n        }\n        if (!response.body) {\n          throw new Error('SSE response has no body');\n        }\n\n        this.retryCount = 0;\n        this.readStream(response.body);\n      })\n      .catch((err: unknown) => {\n        if (this.destroyed) return;\n        if (err instanceof Error && err.name === 'AbortError') return;\n\n        this.onError(err instanceof Error ? err : new Error(String(err)));\n        this.reconnect();\n      });\n  }\n\n  destroy(): void {\n    this.destroyed = true;\n    this.abortController?.abort();\n    this.abortController = null;\n    if (this.retryTimeout) {\n      clearTimeout(this.retryTimeout);\n      this.retryTimeout = null;\n    }\n  }\n\n  private async readStream(body: ReadableStream<Uint8Array>): Promise<void> {\n    const reader = body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let currentEvent = '';\n    let currentData = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n\n        const lines = buffer.split('\\n');\n        // Keep the last incomplete line in the buffer\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('event:')) {\n            currentEvent = line.slice(6).trim();\n          } else if (line.startsWith('data:')) {\n            currentData = line.slice(5).trim();\n          } else if (line === '') {\n            // Empty line = end of event\n            if (currentData) {\n              this.handleEvent(currentEvent, currentData);\n            }\n            currentEvent = '';\n            currentData = '';\n          }\n        }\n      }\n    } catch (err: unknown) {\n      if (this.destroyed) return;\n      if (err instanceof Error && err.name === 'AbortError') return;\n\n      this.onError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      reader.releaseLock();\n    }\n\n    // Stream ended — reconnect if not destroyed\n    if (!this.destroyed) {\n      this.reconnect();\n    }\n  }\n\n  private handleEvent(eventType: string, data: string): void {\n    try {\n      const parsed = JSON.parse(data) as FlagChangeEvent;\n      // Use the event type from the SSE field if present, otherwise from data\n      if (eventType && !parsed.type) {\n        parsed.type = eventType as FlagChangeEvent['type'];\n      }\n      this.onEvent(parsed);\n    } catch {\n      // Malformed event data, skip\n    }\n  }\n\n  private reconnect(): void {\n    if (this.destroyed) return;\n\n    const delay = this.getBackoffDelay();\n    this.retryCount++;\n    this.retryTimeout = setTimeout(() => {\n      this.retryTimeout = null;\n      this.connect();\n    }, delay);\n  }\n\n  private getBackoffDelay(): number {\n    const delay = this.retryDelay * Math.pow(2, this.retryCount);\n    const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n    return Math.min(delay + jitter, this.maxRetryDelay);\n  }\n}\n","import { SSEManager } from './sse';\nimport type {\n  FlagValue,\n  FlaggyContext,\n  FlaggyClientOptions,\n  EvaluateResponse,\n  BatchEvaluateResponse,\n  FlagChangeEvent,\n  FlagChangeListener,\n  ReadyListener,\n  ErrorListener,\n} from './types';\n\ntype EventMap = {\n  change: FlagChangeListener;\n  ready: ReadyListener;\n  error: ErrorListener;\n};\n\nexport class FlaggyClient {\n  private readonly serverUrl: string;\n  private readonly apiKey: string;\n  private readonly enableStreaming: boolean;\n  private readonly sseRetryDelay: number;\n  private readonly sseMaxRetryDelay: number;\n\n  private context: FlaggyContext;\n  private cache = new Map<string, FlagValue>();\n  private _ready = false;\n  private _error: Error | null = null;\n  private sseManager: SSEManager | null = null;\n  private contextAbortController: AbortController | null = null;\n\n  private listeners: {\n    change: Set<FlagChangeListener>;\n    ready: Set<ReadyListener>;\n    error: Set<ErrorListener>;\n  } = {\n    change: new Set(),\n    ready: new Set(),\n    error: new Set(),\n  };\n\n  constructor(options: FlaggyClientOptions) {\n    this.serverUrl = options.serverUrl.replace(/\\/$/, '');\n    this.apiKey = options.apiKey;\n    this.context = options.context ?? {};\n    this.enableStreaming = options.enableStreaming ?? true;\n    this.sseRetryDelay = options.sseRetryDelay ?? 1000;\n    this.sseMaxRetryDelay = options.sseMaxRetryDelay ?? 30_000;\n  }\n\n  get ready(): boolean {\n    return this._ready;\n  }\n\n  get error(): Error | null {\n    return this._error;\n  }\n\n  async initialize(): Promise<void> {\n    try {\n      const response = await this.fetchApi<BatchEvaluateResponse>(\n        '/api/v1/evaluate/batch',\n        { context: this.context },\n      );\n      this.applyBatchResult(response);\n      this._ready = true;\n      this.emit('ready');\n    } catch (err: unknown) {\n      this._error = err instanceof Error ? err : new Error(String(err));\n      this.emit('error', this._error);\n    }\n\n    if (this.enableStreaming) {\n      this.startSSE();\n    }\n  }\n\n  getFlag<T extends FlagValue>(key: string, defaultValue: T): T {\n    if (!this._ready || !this.cache.has(key)) {\n      return defaultValue;\n    }\n    return this.cache.get(key) as T;\n  }\n\n  async setContext(context: FlaggyContext): Promise<void> {\n    this.context = context;\n    this.contextAbortController?.abort();\n    const controller = new AbortController();\n    this.contextAbortController = controller;\n\n    try {\n      const response = await this.fetchApi<BatchEvaluateResponse>(\n        '/api/v1/evaluate/batch',\n        { context },\n        controller.signal,\n      );\n      if (controller.signal.aborted) return;\n      this.applyBatchResult(response);\n    } catch (err: unknown) {\n      if (err instanceof Error && err.name === 'AbortError') return;\n      this._error = err instanceof Error ? err : new Error(String(err));\n      this.emit('error', this._error);\n    }\n  }\n\n  on<E extends keyof EventMap>(event: E, listener: EventMap[E]): () => void {\n    (this.listeners[event] as Set<EventMap[E]>).add(listener);\n    return () => {\n      (this.listeners[event] as Set<EventMap[E]>).delete(listener);\n    };\n  }\n\n  destroy(): void {\n    this.sseManager?.destroy();\n    this.sseManager = null;\n    this.contextAbortController?.abort();\n    this.contextAbortController = null;\n    this.listeners.change.clear();\n    this.listeners.ready.clear();\n    this.listeners.error.clear();\n  }\n\n  private startSSE(): void {\n    this.sseManager = new SSEManager({\n      url: `${this.serverUrl}/api/v1/stream`,\n      apiKey: this.apiKey,\n      onEvent: (event) => this.handleSSEEvent(event),\n      onError: (err) => this.emit('error', err),\n      retryDelay: this.sseRetryDelay,\n      maxRetryDelay: this.sseMaxRetryDelay,\n    });\n    this.sseManager.connect();\n  }\n\n  private async handleSSEEvent(event: FlagChangeEvent): Promise<void> {\n    if (event.type === 'flag_deleted') {\n      if (this.cache.has(event.key)) {\n        this.cache.delete(event.key);\n        this.emit('change', event.key, undefined as unknown as FlagValue);\n      }\n      return;\n    }\n\n    // flag_updated or flag_created — re-evaluate this flag\n    try {\n      const response = await this.fetchApi<EvaluateResponse>(\n        '/api/v1/evaluate',\n        { flag_key: event.key, context: this.context },\n      );\n      const oldValue = this.cache.get(event.key);\n      this.cache.set(event.key, response.value);\n      if (oldValue !== response.value) {\n        this.emit('change', event.key, response.value);\n      }\n    } catch {\n      // Failed to re-evaluate, keep previous cached value\n    }\n  }\n\n  private applyBatchResult(response: BatchEvaluateResponse): void {\n    const newCache = new Map<string, FlagValue>();\n    for (const flag of response.results) {\n      newCache.set(flag.flag_key, flag.value);\n    }\n\n    // Emit changes for any values that differ\n    for (const [key, newValue] of newCache) {\n      const oldValue = this.cache.get(key);\n      if (oldValue !== newValue) {\n        this.emit('change', key, newValue);\n      }\n    }\n\n    // Emit changes for keys that were removed\n    for (const key of this.cache.keys()) {\n      if (!newCache.has(key)) {\n        this.emit('change', key, undefined as unknown as FlagValue);\n      }\n    }\n\n    this.cache = newCache;\n  }\n\n  private emit(event: 'change', key: string, value: FlagValue): void;\n  private emit(event: 'ready'): void;\n  private emit(event: 'error', error: Error): void;\n  private emit(event: keyof EventMap, ...args: unknown[]): void {\n    if (event === 'change') {\n      for (const listener of this.listeners.change) {\n        listener(args[0] as string, args[1] as FlagValue);\n      }\n    } else if (event === 'ready') {\n      for (const listener of this.listeners.ready) {\n        listener();\n      }\n    } else if (event === 'error') {\n      for (const listener of this.listeners.error) {\n        listener(args[0] as Error);\n      }\n    }\n  }\n\n  private async fetchApi<T>(\n    path: string,\n    body: unknown,\n    signal?: AbortSignal,\n  ): Promise<T> {\n    const response = await fetch(`${this.serverUrl}${path}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(body),\n      signal,\n    });\n    if (!response.ok) {\n      throw new Error(`Flaggy API error: ${response.status} ${response.statusText}`);\n    }\n    return response.json() as Promise<T>;\n  }\n}\n"],"mappings":"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","names":[]}