@nexussdk/sdk 0.0.1 → 0.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +162 -0
- package/dist/index.cjs +2 -2
- package/dist/index.d.mts +41 -45
- package/dist/index.d.ts +41 -45
- package/dist/index.global.js +4 -4
- package/dist/index.mjs +2 -2
- package/dist/react.cjs +2 -2
- package/dist/react.d.mts +111 -76
- package/dist/react.d.ts +111 -76
- package/dist/react.mjs +2 -2
- package/dist/vue.cjs +2 -0
- package/dist/vue.d.mts +234 -0
- package/dist/vue.d.ts +234 -0
- package/dist/vue.mjs +2 -0
- package/package.json +62 -9
- package/.turbo/turbo-build.log +0 -45
- package/dist/index.cjs.map +0 -1
- package/dist/index.global.js.map +0 -1
- package/dist/index.mjs.map +0 -1
- package/dist/react.cjs.map +0 -1
- package/dist/react.mjs.map +0 -1
- package/src/index.ts +0 -27
- package/src/nexus.ts +0 -208
- package/src/react.tsx +0 -204
- package/tsconfig.json +0 -10
- package/tsup.config.ts +0 -40
package/dist/index.global.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../core/src/http-client.ts","../../core/src/ring-buffer.ts","../../core/src/env-resolver.ts","../../core/src/safe-json.ts","../../sdk-flags/src/evaluator.ts","../../sdk-flags/src/sse-manager.ts","../../sdk-flags/src/storage.ts","../../sdk-flags/src/client.ts","../../sdk-tracker/src/sanitizer.ts","../../sdk-tracker/src/fingerprint.ts","../../sdk-tracker/src/breadcrumbs.ts","../../sdk-tracker/src/transport.ts","../../sdk-tracker/src/listeners.ts","../../sdk-tracker/src/client.ts","../src/nexus.ts"],"names":["computeBackoffMs","attempt","baseMs","maxMs","exponential","capped","sleep","ms","signal","resolve","reject","timer","isRetryableStatus","status","fetchWithRetry","options","url","method","headers","body","timeoutMs","maxRetries","retryBaseMs","retryMaxMs","externalSignal","lastError","controller","timeoutId","requestInit","response","delay","errorBody","err","RingBuffer","capacity","item","result","i","lastIndex","readProcessEnv","key","proc","readViteEnv","meta","dynamicMeta","readWindowGlobal","resolveApiKey","directValue","resolved","resolveBaseUrl","defaultUrl","sanitizeForSerialization","value","seen","depth","maxDepth","propValue","safeStringify","sanitized","murmur3","seed","h","c1","c2","length4","k","k2","rem","computeRolloutBucket","userId","flagKey","hashInput","compareSemver","a","b","partsA","partsB","diff","resolveAttribute","ctx","attributePath","parts","current","part","evaluateSingleRule","rule","userCtx","userValue","targets","evaluateFlag","flag","SSEManager","evt","data","event","STORAGE_KEY_PREFIX","ANON_ID_KEY","FlagStorage","apiKeyPrefix","flags","id","testKey","raw","parsed","NexusFlagsClient","defaultValue","cached","variantKey","user","callback","flagDef","cb","evaluated","SENSITIVE_KEY_PATTERN","CREDIT_CARD_PATTERN","EMAIL_PATTERN","SENSITIVE_QUERY_PARAM_PATTERN","sanitizeString","sanitizeObject","val","sanitizeUrl","parseStackTrace","stack","frames","lines","line","trimmed","v8Match","geckoMatch","computeFingerprint","errorType","errorMessage","topFrame","fileName","lineNumber","signature","hash","BreadcrumbManager","maxBreadcrumbs","breadcrumb","sanitizedData","target","description","el","original","args","Transport","payload","blob","r","attachGlobalListeners","client","errorHandler","error","rejectionHandler","NexusTrackerClient","baseUrl","extra","normalized","stackFrames","fingerprint","existing","finalPayload","entry","aggregated","isBrowser","Nexus","_Nexus","apiKey","environment","tags","autoCapture","flagsOpts","trackerOpts","d","instance"],"mappings":"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","file":"index.global.js","sourcesContent":["/**\n * @fileoverview Resilient HTTP client with exponential backoff and jitter.\n * Zero external dependencies — uses only native browser fetch and AbortController.\n * @module @nexus/core/http-client\n */\n\n/**\n * Options for configuring a single HTTP request with retry behaviour.\n *\n * @example\n * const opts: HttpClientOptions = {\n * url: 'https://api.nexus.dev/api/v1/flags/eval',\n * method: 'GET',\n * headers: { Authorization: 'Bearer pk_live_...' },\n * timeoutMs: 3000,\n * maxRetries: 3,\n * };\n */\nexport interface HttpClientOptions {\n /** Request URL. */\n url: string;\n /** HTTP method. Defaults to 'GET'. */\n method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n /** Request headers. */\n headers?: Record<string, string>;\n /** Request body (will be JSON-serialized if object). */\n body?: unknown;\n /** Request timeout in milliseconds. Defaults to 5000ms. */\n timeoutMs?: number;\n /** Maximum retry attempts on 5xx / network errors. Defaults to 3. */\n maxRetries?: number;\n /** Base delay in milliseconds for exponential backoff. Defaults to 1000ms. */\n retryBaseMs?: number;\n /** Maximum backoff delay in milliseconds. Defaults to 30000ms. */\n retryMaxMs?: number;\n /** Optional AbortSignal for external cancellation. */\n signal?: AbortSignal;\n}\n\n/**\n * Result of a successful HTTP fetch.\n *\n * @template T The expected response body type.\n */\nexport interface HttpClientResult<T> {\n /** Parsed response body. */\n data: T;\n /** HTTP status code. */\n status: number;\n /** Response headers. */\n headers: Headers;\n}\n\n/**\n * Computes the exponential backoff sleep duration with full random jitter.\n * Formula: sleep = random(0, min(maxMs, baseMs * 2^attempt))\n *\n * @param attempt - Zero-based retry attempt index.\n * @param baseMs - Base delay in milliseconds.\n * @param maxMs - Maximum delay cap in milliseconds.\n * @returns Sleep duration in milliseconds.\n *\n * @example\n * const delay = computeBackoffMs(2, 1000, 30000); // ~0-4000ms\n */\nexport function computeBackoffMs(attempt: number, baseMs = 1000, maxMs = 30_000): number {\n const exponential = baseMs * Math.pow(2, attempt);\n const capped = Math.min(maxMs, exponential);\n // Full jitter: random value in [0, capped]\n return Math.random() * capped;\n}\n\n/**\n * Sleeps for the given number of milliseconds.\n *\n * @param ms - Delay in milliseconds.\n * @param signal - Optional AbortSignal to cancel the sleep.\n * @returns Promise that resolves after delay, or rejects if aborted.\n */\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n reject(new DOMException('Aborted', 'AbortError'));\n return;\n }\n const timer = setTimeout(resolve, ms);\n signal?.addEventListener('abort', () => {\n clearTimeout(timer);\n reject(new DOMException('Aborted', 'AbortError'));\n });\n });\n}\n\n/**\n * Determines if an HTTP response status warrants a retry attempt.\n *\n * @param status - HTTP status code.\n * @returns `true` if the request should be retried.\n */\nfunction isRetryableStatus(status: number): boolean {\n return status >= 500 || status === 429;\n}\n\n/**\n * Performs a resilient HTTP fetch with exponential backoff and jitter.\n * Automatically retries on network failures and 5xx/429 responses.\n *\n * @template T The expected response body type.\n * @param options - Request configuration options.\n * @returns Promise resolving to {@link HttpClientResult}.\n * @throws {Error} When all retry attempts are exhausted or request is aborted.\n *\n * @example\n * const result = await fetchWithRetry<BatchFlagEvaluation>({\n * url: 'https://api.nexus.dev/api/v1/flags/eval',\n * method: 'GET',\n * headers: { Authorization: 'Bearer pk_live_...' },\n * timeoutMs: 3000,\n * maxRetries: 3,\n * });\n * console.log(result.data); // { checkout_v2: { enabled: true, ... } }\n */\nexport async function fetchWithRetry<T = unknown>(\n options: HttpClientOptions,\n): Promise<HttpClientResult<T>> {\n const {\n url,\n method = 'GET',\n headers = {},\n body,\n timeoutMs = 5_000,\n maxRetries = 3,\n retryBaseMs = 1_000,\n retryMaxMs = 30_000,\n signal: externalSignal,\n } = options;\n\n let lastError: Error = new Error('Request failed');\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n // Abort if external signal is already triggered\n if (externalSignal?.aborted) {\n throw new DOMException('Request aborted by caller.', 'AbortError');\n }\n\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n // Merge external abort signal\n externalSignal?.addEventListener('abort', () => controller.abort());\n\n try {\n const requestInit: RequestInit = {\n method,\n headers: {\n 'Content-Type': 'application/json',\n ...headers,\n },\n signal: controller.signal,\n };\n\n if (body !== undefined) {\n requestInit.body = typeof body === 'string' ? body : JSON.stringify(body);\n }\n\n const response = await fetch(url, requestInit);\n clearTimeout(timeoutId);\n\n if (response.ok) {\n const data = (await response.json()) as T;\n return { data, status: response.status, headers: response.headers };\n }\n\n // Non-ok response: check if retryable\n if (isRetryableStatus(response.status) && attempt < maxRetries) {\n lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);\n const delay = computeBackoffMs(attempt, retryBaseMs, retryMaxMs);\n await sleep(delay, externalSignal);\n continue;\n }\n\n // Non-retryable error (400, 401, 403, 404, etc.)\n const errorBody = await response.text().catch(() => '');\n throw new Error(`HTTP ${response.status}: ${errorBody}`);\n } catch (err) {\n clearTimeout(timeoutId);\n\n if (err instanceof DOMException && err.name === 'AbortError') {\n throw err; // Propagate abort without retry\n }\n\n lastError = err instanceof Error ? err : new Error(String(err));\n\n if (attempt < maxRetries) {\n const delay = computeBackoffMs(attempt, retryBaseMs, retryMaxMs);\n await sleep(delay, externalSignal);\n }\n }\n }\n\n throw lastError;\n}\n","/**\n * @fileoverview Fixed-capacity ring buffer with FIFO eviction under pressure.\n * Used by SDK Tracker for bounded breadcrumb and telemetry event storage.\n * @module @nexus/core/ring-buffer\n */\n\n/**\n * A fixed-capacity circular buffer that drops the oldest entry when full.\n * Never causes memory leaks or starvation of host applications.\n *\n * @template T The type of items stored in the buffer.\n *\n * @example\n * const buffer = new RingBuffer<string>(3);\n * buffer.push('a'); // [a]\n * buffer.push('b'); // [a, b]\n * buffer.push('c'); // [a, b, c]\n * buffer.push('d'); // [b, c, d] — 'a' evicted (FIFO)\n * buffer.toArray(); // ['b', 'c', 'd']\n */\nexport class RingBuffer<T> {\n private readonly capacity: number;\n private readonly buffer: Array<T | undefined>;\n private head = 0; // Points to the next write position\n private count = 0; // Current number of items\n\n /**\n * Creates a new RingBuffer with the given capacity.\n *\n * @param capacity - Maximum number of items to retain. Must be >= 1.\n * @throws {RangeError} If capacity is less than 1.\n *\n * @example\n * const breadcrumbBuffer = new RingBuffer<Breadcrumb>(20);\n */\n constructor(capacity: number) {\n if (capacity < 1) {\n throw new RangeError(`RingBuffer capacity must be >= 1, got ${capacity}`);\n }\n this.capacity = capacity;\n this.buffer = new Array<T | undefined>(capacity).fill(undefined);\n }\n\n /**\n * Appends an item to the buffer.\n * If the buffer is at capacity, the oldest item is silently dropped.\n *\n * @param item - The item to insert.\n *\n * @example\n * buffer.push({ timestamp: Date.now(), category: 'ui.click', message: 'Clicked #btn' });\n */\n push(item: T): void {\n this.buffer[this.head] = item;\n this.head = (this.head + 1) % this.capacity;\n if (this.count < this.capacity) {\n this.count++;\n }\n }\n\n /**\n * Returns all stored items in chronological order (oldest first).\n *\n * @returns Ordered array of stored items.\n *\n * @example\n * const breadcrumbs = buffer.toArray(); // [{...}, {...}]\n */\n toArray(): T[] {\n if (this.count === 0) return [];\n\n const result: T[] = [];\n if (this.count < this.capacity) {\n // Buffer not yet full — read from index 0 to head-1\n for (let i = 0; i < this.count; i++) {\n result.push(this.buffer[i] as T);\n }\n } else {\n // Buffer full — oldest item is at `head`\n for (let i = 0; i < this.capacity; i++) {\n result.push(this.buffer[(this.head + i) % this.capacity] as T);\n }\n }\n return result;\n }\n\n /**\n * Returns the current number of items in the buffer.\n *\n * @returns Item count (0 to capacity).\n *\n * @example\n * console.log(buffer.size); // 3\n */\n get size(): number {\n return this.count;\n }\n\n /**\n * Returns the maximum capacity of the buffer.\n *\n * @returns Buffer capacity.\n *\n * @example\n * console.log(buffer.maxCapacity); // 20\n */\n get maxCapacity(): number {\n return this.capacity;\n }\n\n /**\n * Checks if the buffer is currently at full capacity.\n *\n * @returns `true` if the buffer is full.\n *\n * @example\n * if (buffer.isFull) console.log('Oldest breadcrumb will be evicted on next push.');\n */\n get isFull(): boolean {\n return this.count === this.capacity;\n }\n\n /**\n * Removes all items from the buffer and resets internal state.\n *\n * @example\n * buffer.clear(); // buffer is now empty\n */\n clear(): void {\n this.buffer.fill(undefined);\n this.head = 0;\n this.count = 0;\n }\n\n /**\n * Peeks at the most recently added item without removing it.\n *\n * @returns The last item pushed, or `undefined` if empty.\n *\n * @example\n * const last = buffer.peek(); // most recent item\n */\n peek(): T | undefined {\n if (this.count === 0) return undefined;\n const lastIndex = (this.head - 1 + this.capacity) % this.capacity;\n return this.buffer[lastIndex];\n }\n}\n","/**\n * @fileoverview Universal API key resolver across all JavaScript runtimes.\n * Supports: Browser globals, Node.js process.env, Vite, Next.js, and Nuxt.\n * @module @nexus/core/env-resolver\n */\n\n/**\n * Resolution priority for API key lookup.\n * 1. Direct parameter passed into init options\n * 2. Browser global: window.__NEXUS_API_KEY__\n * 3. Node/Next.js: process.env.NEXUS_API_KEY\n * 4. Next.js client bundler: process.env.NEXT_PUBLIC_NEXUS_API_KEY\n * 5. Vite bundler: import.meta.env.VITE_NEXUS_API_KEY\n * 6. Nuxt: process.env.NUXT_PUBLIC_NEXUS_API_KEY\n */\n\n// Augment global types for browser injection\ndeclare global {\n interface Window {\n /** Browser-injected API key for Nexus SDK. */\n __NEXUS_API_KEY__?: string;\n }\n}\n\n/**\n * Safely reads an environment variable from process.env without throwing.\n *\n * @param key - The environment variable name.\n * @returns The value or `undefined`.\n */\nfunction readProcessEnv(key: string): string | undefined {\n try {\n const proc = (globalThis as unknown as { process?: { env?: Record<string, string | undefined> } }).process;\n if (typeof proc !== 'undefined' && proc && proc.env) {\n return proc.env[key] ?? undefined;\n }\n } catch {\n // process is not defined in pure browser environments\n }\n return undefined;\n}\n\n/**\n * Safely reads a Vite environment variable from import.meta.env.\n *\n * @param key - The Vite env variable name (VITE_* prefix required by Vite).\n * @returns The value or `undefined`.\n */\nfunction readViteEnv(key: string): string | undefined {\n try {\n const meta = typeof globalThis !== 'undefined' && (globalThis as unknown as { __import_meta__?: { env?: Record<string, string | undefined> } }).__import_meta__;\n if (meta && meta.env) {\n return meta.env[key] ?? undefined;\n }\n // Safe dynamic evaluation avoiding CJS compile-time import.meta error\n const dynamicMeta = new Function('try { return import.meta; } catch(e) { return undefined; }')() as { env?: Record<string, string | undefined> } | undefined;\n if (dynamicMeta && dynamicMeta.env) {\n return dynamicMeta.env[key] ?? undefined;\n }\n } catch {\n // Not a Vite runtime\n }\n return undefined;\n}\n\n/**\n * Safely reads the browser window global injection.\n *\n * @returns The window-injected API key or `undefined`.\n */\nfunction readWindowGlobal(): string | undefined {\n try {\n if (typeof window !== 'undefined' && window.__NEXUS_API_KEY__) {\n return window.__NEXUS_API_KEY__;\n }\n } catch {\n // window is not accessible (SSR/Worker context)\n }\n return undefined;\n}\n\n/**\n * Resolves the Nexus API key from the environment using a prioritized lookup chain.\n *\n * Resolution order:\n * 1. `directValue` — Parameter passed directly into SDK init options\n * 2. `window.__NEXUS_API_KEY__` — Browser global injection (CDN/script embed use cases)\n * 3. `process.env.NEXUS_API_KEY` — Node.js / Docker / CI environments\n * 4. `process.env.NEXT_PUBLIC_NEXUS_API_KEY` — Next.js client-side bundling\n * 5. `import.meta.env.VITE_NEXUS_API_KEY` — Vite / Vitest bundling\n * 6. `process.env.NUXT_PUBLIC_NEXUS_API_KEY` — Nuxt 3 public runtime config\n *\n * @param directValue - Explicitly provided API key (highest priority).\n * @returns The resolved API key string.\n * @throws {Error} If no API key can be resolved from any source.\n *\n * @example\n * // In a Next.js application:\n * // process.env.NEXT_PUBLIC_NEXUS_API_KEY = 'pk_live_abc123'\n * const key = resolveApiKey(); // 'pk_live_abc123'\n *\n * @example\n * // Passing directly (overrides all env vars):\n * const key = resolveApiKey('pk_live_directkey'); // 'pk_live_directkey'\n */\nexport function resolveApiKey(directValue?: string): string {\n const resolved =\n directValue ||\n readWindowGlobal() ||\n readProcessEnv('NEXUS_API_KEY') ||\n readProcessEnv('NEXT_PUBLIC_NEXUS_API_KEY') ||\n readViteEnv('VITE_NEXUS_API_KEY') ||\n readProcessEnv('NUXT_PUBLIC_NEXUS_API_KEY');\n\n if (!resolved || resolved.trim() === '') {\n throw new Error(\n '[Nexus SDK] No API key found. ' +\n 'Please provide one via:\\n' +\n ' 1. Nexus.init({ apiKey: \"pk_live_...\" })\\n' +\n ' 2. window.__NEXUS_API_KEY__ = \"pk_live_...\"\\n' +\n ' 3. NEXUS_API_KEY env var\\n' +\n ' 4. NEXT_PUBLIC_NEXUS_API_KEY (Next.js)\\n' +\n ' 5. VITE_NEXUS_API_KEY (Vite)\\n' +\n ' 6. NUXT_PUBLIC_NEXUS_API_KEY (Nuxt)',\n );\n }\n\n return resolved.trim();\n}\n\n/**\n * Resolves the Nexus base URL from configuration or environment variables.\n *\n * @param directValue - Explicitly provided base URL.\n * @param defaultUrl - Default URL if no env var is found.\n * @returns The resolved base URL string (trailing slash stripped).\n *\n * @example\n * // Resolves to http://localhost:8080 in development\n * const url = resolveBaseUrl(undefined, 'https://api.nexus.dev');\n */\nexport function resolveBaseUrl(\n directValue?: string,\n defaultUrl = 'https://api.nexus.dev',\n): string {\n const resolved =\n directValue ||\n readProcessEnv('NEXT_PUBLIC_NEXUS_URL') ||\n readViteEnv('VITE_NEXUS_URL') ||\n defaultUrl;\n\n return resolved.replace(/\\/$/, '');\n}\n","/**\n * @fileoverview Circular-reference-safe JSON serializer using WeakSet tracking.\n * Prevents TypeError crashes when serializing objects with circular references.\n * @module @nexus/core/safe-json\n */\n\n/**\n * Recursively sanitizes an object for JSON serialization by replacing\n * circular references with the string \"[Circular]\".\n *\n * @param value - The value to sanitize.\n * @param seen - WeakSet tracking visited objects (used internally for recursion).\n * @param depth - Current recursion depth.\n * @param maxDepth - Maximum allowed recursion depth.\n * @returns A serialization-safe copy of the value.\n */\nfunction sanitizeForSerialization(\n value: unknown,\n seen: WeakSet<object>,\n depth: number,\n maxDepth: number,\n): unknown {\n if (depth > maxDepth) {\n return '[MaxDepthExceeded]';\n }\n\n if (value === null || value === undefined) {\n return value;\n }\n\n if (typeof value !== 'object' && typeof value !== 'function') {\n // Primitive value: string, number, boolean, bigint, symbol\n if (typeof value === 'bigint') {\n return value.toString(); // JSON cannot handle BigInt natively\n }\n if (typeof value === 'symbol') {\n return value.toString();\n }\n if (typeof value === 'function') {\n return '[Function]';\n }\n return value;\n }\n\n // Handle Error objects specially — preserve message and stack\n if (value instanceof Error) {\n return {\n name: value.name,\n message: value.message,\n stack: value.stack,\n };\n }\n\n // Circular reference detection\n if (seen.has(value as object)) {\n return '[Circular]';\n }\n seen.add(value as object);\n\n // Handle Arrays\n if (Array.isArray(value)) {\n const result = value.map((item) =>\n sanitizeForSerialization(item, seen, depth + 1, maxDepth),\n );\n seen.delete(value as object);\n return result;\n }\n\n // Handle plain Objects\n const result: Record<string, unknown> = {};\n for (const key of Object.keys(value as object)) {\n const propValue = (value as Record<string, unknown>)[key];\n result[key] = sanitizeForSerialization(propValue, seen, depth + 1, maxDepth);\n }\n seen.delete(value as object);\n return result;\n}\n\n/**\n * Serializes a value to a JSON string, gracefully handling:\n * - Circular references (replaced with \"[Circular]\")\n * - BigInt values (converted to string)\n * - Symbol values (converted to string)\n * - Function values (replaced with \"[Function]\")\n * - Deep nesting (capped at maxDepth, replaced with \"[MaxDepthExceeded]\")\n *\n * @param value - Any value to serialize.\n * @param maxDepth - Maximum recursion depth. Defaults to 8.\n * @returns JSON string representation of the value.\n *\n * @example\n * const obj: Record<string, unknown> = { name: 'test' };\n * obj['self'] = obj; // circular reference\n * const json = safeStringify(obj);\n * // '{\"name\":\"test\",\"self\":\"[Circular]\"}'\n *\n * @example\n * const err = new Error('Something failed');\n * const json = safeStringify({ error: err, code: 500 });\n * // '{\"error\":{\"name\":\"Error\",\"message\":\"Something failed\",\"stack\":\"...\"},\"code\":500}'\n */\nexport function safeStringify(value: unknown, maxDepth = 8): string {\n const seen = new WeakSet<object>();\n const sanitized = sanitizeForSerialization(value, seen, 0, maxDepth);\n try {\n return JSON.stringify(sanitized);\n } catch {\n // Absolute last resort fallback\n return JSON.stringify({ error: '[SerializationFailed]' });\n }\n}\n\n/**\n * Safely parses a JSON string without throwing on invalid input.\n *\n * @param input - The JSON string to parse.\n * @param fallback - Value to return if parsing fails. Defaults to `null`.\n * @returns Parsed value or fallback.\n *\n * @example\n * const data = safeParse<{ id: string }>('{\"id\":\"123\"}');\n * // { id: '123' }\n *\n * @example\n * const data = safeParse<unknown>('{{invalid json}}', null);\n * // null\n */\nexport function safeParse<T = unknown>(input: string, fallback: T | null = null): T | null {\n try {\n return JSON.parse(input) as T;\n } catch {\n return fallback;\n }\n}\n","/**\n * @fileoverview MurmurHash3 32-bit implementation and ABAC rule evaluator.\n * Pure TypeScript — no external dependencies. Implements deterministic rollout bucketing.\n * @module @nexus/sdk-flags/evaluator\n */\n\nimport type { FeatureFlag, FlagEvaluationResult, TargetingRule, UserContext } from '@nexussdk/contracts';\n\n// ---------------------------------------------------------------------------\n// MurmurHash3 32-bit Implementation (Pure TypeScript)\n// Used for deterministic user-to-bucket mapping without server round-trips.\n// ---------------------------------------------------------------------------\n\n/**\n * Converts a string to a Uint32 MurmurHash3 hash.\n * Implements the MurmurHash3 32-bit algorithm (x86 variant).\n *\n * @param key - Input string to hash.\n * @param seed - Optional seed value. Defaults to 0.\n * @returns Unsigned 32-bit integer hash value.\n *\n * @example\n * const hash = murmur3('user123:checkout_v2', 0);\n * const bucket = hash % 100; // 0-99 deterministic bucket\n */\nexport function murmur3(key: string, seed = 0): number {\n let h = seed >>> 0;\n const c1 = 0xcc9e2d51;\n const c2 = 0x1b873593;\n\n let i = 0;\n // Process 4-byte chunks\n const length4 = Math.floor(key.length / 4) * 4;\n while (i < length4) {\n let k =\n ((key.charCodeAt(i) & 0xff)) |\n ((key.charCodeAt(i + 1) & 0xff) << 8) |\n ((key.charCodeAt(i + 2) & 0xff) << 16) |\n ((key.charCodeAt(i + 3) & 0xff) << 24);\n\n k = Math.imul(k, c1);\n k = (k << 15) | (k >>> 17);\n k = Math.imul(k, c2);\n\n h ^= k;\n h = (h << 13) | (h >>> 19);\n h = (Math.imul(h, 5) + 0xe6546b64) >>> 0;\n i += 4;\n }\n\n // Process remaining bytes\n let k2 = 0;\n const rem = key.length & 3;\n if (rem >= 3) k2 ^= (key.charCodeAt(i + 2) & 0xff) << 16;\n if (rem >= 2) k2 ^= (key.charCodeAt(i + 1) & 0xff) << 8;\n if (rem >= 1) {\n k2 ^= key.charCodeAt(i) & 0xff;\n k2 = Math.imul(k2, c1);\n k2 = (k2 << 15) | (k2 >>> 17);\n k2 = Math.imul(k2, c2);\n h ^= k2;\n }\n\n // Finalization mix\n h ^= key.length;\n h ^= h >>> 16;\n h = Math.imul(h, 0x85ebca6b);\n h ^= h >>> 13;\n h = Math.imul(h, 0xc2b2ae35);\n h ^= h >>> 16;\n\n return h >>> 0; // Ensure unsigned\n}\n\n/**\n * Computes the deterministic rollout bucket (0-99) for a given user+flag combination.\n * Uses MurmurHash3 for even distribution without server state.\n *\n * @param userId - User's unique identifier (anonymous ID if not authenticated).\n * @param flagKey - Flag programmatic key.\n * @returns Bucket value between 0 and 99 (inclusive).\n *\n * @example\n * const bucket = computeRolloutBucket('usr_12345', 'checkout_v2');\n * // isEnabled = bucket < flag.rolloutPercentage\n */\nexport function computeRolloutBucket(userId: string, flagKey: string): number {\n const hashInput = `${userId}:${flagKey}`;\n return murmur3(hashInput) % 100;\n}\n\n// ---------------------------------------------------------------------------\n// ABAC Rule Evaluator\n// ---------------------------------------------------------------------------\n\n/**\n * Performs a simple semantic version comparison.\n * Compares two semver strings in \"MAJOR.MINOR.PATCH\" format.\n *\n * @param a - First version string.\n * @param b - Second version string.\n * @returns Positive if a > b, negative if a < b, 0 if equal.\n */\nfunction compareSemver(a: string, b: string): number {\n const partsA = a.replace(/^v/, '').split('.').map(Number);\n const partsB = b.replace(/^v/, '').split('.').map(Number);\n for (let i = 0; i < 3; i++) {\n const diff = (partsA[i] ?? 0) - (partsB[i] ?? 0);\n if (diff !== 0) return diff;\n }\n return 0;\n}\n\n/**\n * Extracts a nested attribute value from the UserContext by dot-notation path.\n *\n * @param ctx - UserContext object.\n * @param attributePath - Dot-separated path (e.g. \"custom.tier\", \"country\").\n * @returns The attribute value or `undefined` if not found.\n */\nfunction resolveAttribute(ctx: UserContext, attributePath: string): unknown {\n const parts = attributePath.split('.');\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n let current: any = ctx;\n for (const part of parts) {\n if (current == null || typeof current !== 'object') return undefined;\n current = current[part];\n }\n return current;\n}\n\n/**\n * Evaluates a single targeting rule against the user context.\n *\n * @param rule - The ABAC targeting rule to evaluate.\n * @param userCtx - The current user context.\n * @returns `true` if the rule passes for this user.\n */\nfunction evaluateSingleRule(rule: TargetingRule, userCtx: UserContext): boolean {\n const userValue = resolveAttribute(userCtx, rule.attribute);\n const targets = rule.values;\n\n switch (rule.operator) {\n case 'EQUALS':\n return userValue === targets[0];\n case 'NOT_EQUALS':\n return userValue !== targets[0];\n case 'IN':\n return targets.includes(userValue as string | number | boolean);\n case 'NOT_IN':\n return !targets.includes(userValue as string | number | boolean);\n case 'CONTAINS':\n return typeof userValue === 'string' && userValue.includes(String(targets[0]));\n case 'NOT_CONTAINS':\n return typeof userValue === 'string' && !userValue.includes(String(targets[0]));\n case 'STARTS_WITH':\n return typeof userValue === 'string' && userValue.startsWith(String(targets[0]));\n case 'ENDS_WITH':\n return typeof userValue === 'string' && userValue.endsWith(String(targets[0]));\n case 'GREATER_THAN':\n return typeof userValue === 'number' && userValue > Number(targets[0]);\n case 'LESS_THAN':\n return typeof userValue === 'number' && userValue < Number(targets[0]);\n case 'SEMVER_GTE':\n return (\n typeof userValue === 'string' &&\n typeof targets[0] === 'string' &&\n compareSemver(userValue, String(targets[0])) >= 0\n );\n case 'SEMVER_LTE':\n return (\n typeof userValue === 'string' &&\n typeof targets[0] === 'string' &&\n compareSemver(userValue, String(targets[0])) <= 0\n );\n default:\n return false;\n }\n}\n\n/**\n * Evaluates a FeatureFlag against a UserContext using the full ABAC + rollout engine.\n *\n * Evaluation Order:\n * 1. Kill-switch check (`isEnabled === false` → KILL_SWITCH)\n * 2. All targeting rules must pass (ABAC evaluation)\n * 3. Percentage rollout via MurmurHash3 bucketing\n * 4. Default enabled state\n *\n * @param flag - The feature flag definition from the cache.\n * @param userCtx - Current user context for targeting evaluation.\n * @returns Full {@link FlagEvaluationResult} with reason explanation.\n *\n * @example\n * const result = evaluateFlag(flag, { id: 'usr_12345', country: 'VN' });\n * if (result.enabled) {\n * console.log(result.variants.discount_rate); // 20\n * }\n */\nexport function evaluateFlag(flag: FeatureFlag, userCtx: UserContext): FlagEvaluationResult {\n // Step 1: Kill-switch\n if (!flag.isEnabled) {\n return {\n key: flag.key,\n enabled: false,\n variants: {},\n reason: 'KILL_SWITCH',\n version: flag.version,\n };\n }\n\n // Step 2: ABAC targeting rules — all must pass (AND logic)\n if (flag.targetingRules.length > 0) {\n const allRulesPass = flag.targetingRules.every((rule) =>\n evaluateSingleRule(rule, userCtx),\n );\n if (!allRulesPass) {\n return {\n key: flag.key,\n enabled: false,\n variants: {},\n reason: 'FALLBACK',\n version: flag.version,\n };\n }\n // All targeting rules matched\n if (flag.rolloutPercentage >= 100) {\n return {\n key: flag.key,\n enabled: true,\n variants: flag.variants,\n reason: 'TARGETING_MATCH',\n version: flag.version,\n };\n }\n }\n\n // Step 3: Percentage rollout (MurmurHash3)\n if (flag.rolloutPercentage > 0) {\n const userId = userCtx.id ?? 'anon';\n const bucket = computeRolloutBucket(userId, flag.key);\n if (bucket < flag.rolloutPercentage) {\n return {\n key: flag.key,\n enabled: true,\n variants: flag.variants,\n reason: flag.targetingRules.length > 0 ? 'TARGETING_MATCH' : 'ROLLOUT_MATCH',\n version: flag.version,\n };\n }\n return {\n key: flag.key,\n enabled: false,\n variants: {},\n reason: 'FALLBACK',\n version: flag.version,\n };\n }\n\n // Step 4: Full kill-switch off (rolloutPercentage === 0 with no rules)\n return {\n key: flag.key,\n enabled: false,\n variants: {},\n reason: 'KILL_SWITCH',\n version: flag.version,\n };\n}\n","/**\n * @fileoverview Singleton SSE Manager with ref-counting and auto-reconnect.\n * Ensures exactly one EventSource connection per API key across all flag subscribers.\n * @module @nexus/sdk-flags/sse-manager\n */\n\nimport type { FlagStreamEvent } from '@nexussdk/contracts';\nimport { computeBackoffMs } from '@nexussdk/core';\n\n/**\n * Options for creating an SSE connection.\n */\nexport interface SSEManagerOptions {\n /** Full SSE stream URL (e.g. \"http://localhost:8080/api/v1/flags/stream\"). */\n url: string;\n /** Public API key for authentication. */\n apiKey: string;\n /** Callback invoked for each received flag stream event. */\n onEvent: (event: FlagStreamEvent) => void;\n /** Callback invoked on connection state changes (optional). */\n onStateChange?: (connected: boolean) => void;\n /** Maximum reconnect attempts. Defaults to Infinity. */\n maxReconnects?: number;\n}\n\n/**\n * Ref-counted Singleton SSE Manager.\n *\n * Multiple consumers sharing the same `apiKey` receive updates\n * from a single shared SSE connection. Connection is torn down when all\n * consumers have called `disconnect()`.\n *\n * Connection lifecycle:\n * 1. `connect()` → opens EventSource or streaming fetch\n * 2. On disconnect: exponential backoff reconnect (max 30s)\n * 3. `disconnect()` → decrements ref count; tears down on 0\n *\n * @example\n * const manager = new SSEManager({\n * url: 'http://localhost:8080/api/v1/flags/stream',\n * apiKey: 'pk_live_...',\n * onEvent: (event) => updateCache(event),\n * });\n * manager.connect();\n * // Later:\n * manager.disconnect();\n */\nexport class SSEManager {\n private readonly options: SSEManagerOptions;\n private eventSource: EventSource | null = null;\n private connected = false;\n private destroyed = false;\n private reconnectAttempt = 0;\n private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n private readonly maxReconnects: number;\n\n constructor(options: SSEManagerOptions) {\n this.options = options;\n this.maxReconnects = options.maxReconnects ?? Infinity;\n }\n\n /**\n * Returns whether the SSE connection is currently active.\n *\n * @returns `true` if EventSource is open and receiving events.\n */\n get isConnected(): boolean {\n return this.connected;\n }\n\n /**\n * Opens the SSE connection to the Go-Gin stream endpoint.\n * Safe to call multiple times — no-op if already connected.\n *\n * @example\n * manager.connect();\n */\n connect(): void {\n if (this.destroyed || this.connected || this.eventSource) return;\n this.openConnection();\n }\n\n /**\n * Closes the SSE connection and cancels any pending reconnect timers.\n *\n * @example\n * manager.disconnect();\n */\n disconnect(): void {\n this.destroyed = true;\n this.cleanup();\n }\n\n private openConnection(): void {\n if (this.destroyed) return;\n\n try {\n // Append API key as query parameter for SSE (EventSource doesn't support custom headers)\n const url = new URL(this.options.url);\n url.searchParams.set('apiKey', this.options.apiKey);\n\n this.eventSource = new EventSource(url.toString());\n\n this.eventSource.addEventListener('open', () => {\n this.connected = true;\n this.reconnectAttempt = 0;\n this.options.onStateChange?.(true);\n });\n\n this.eventSource.addEventListener('message', (evt: MessageEvent<string>) => {\n this.handleMessage(evt.data);\n });\n\n // Go-Gin sends events with event type 'message' by default\n // Also listen for explicitly typed events\n this.eventSource.addEventListener('flag_update', (evt: MessageEvent<string>) => {\n this.handleMessage(evt.data);\n });\n\n this.eventSource.addEventListener('error', () => {\n this.connected = false;\n this.options.onStateChange?.(false);\n this.cleanup();\n this.scheduleReconnect();\n });\n } catch {\n this.scheduleReconnect();\n }\n }\n\n private handleMessage(data: string): void {\n try {\n const event = JSON.parse(data) as FlagStreamEvent;\n this.options.onEvent(event);\n } catch {\n // Ignore malformed SSE payloads — never crash the host application\n }\n }\n\n private cleanup(): void {\n if (this.eventSource) {\n this.eventSource.close();\n this.eventSource = null;\n }\n if (this.reconnectTimer !== null) {\n clearTimeout(this.reconnectTimer);\n this.reconnectTimer = null;\n }\n }\n\n private scheduleReconnect(): void {\n if (this.destroyed) return;\n if (this.reconnectAttempt >= this.maxReconnects) return;\n\n const delay = computeBackoffMs(this.reconnectAttempt, 1000, 30_000);\n this.reconnectAttempt++;\n\n this.reconnectTimer = setTimeout(() => {\n this.reconnectTimer = null;\n if (!this.destroyed) {\n this.openConnection();\n }\n }, delay);\n }\n}\n","/**\n * @fileoverview In-memory flag storage with LocalStorage sync and incognito fallback.\n * @module @nexus/sdk-flags/storage\n */\n\nimport type { FlagEvaluationResult } from '@nexussdk/contracts';\n\nconst STORAGE_KEY_PREFIX = 'nexus_flags_';\nconst ANON_ID_KEY = 'nexus_anon_id';\n\n/**\n * In-memory flag cache with optional LocalStorage persistence.\n * Falls back to pure in-memory storage in SSR / Incognito / Worker contexts.\n *\n * @example\n * const store = new FlagStorage('pk_live_abc123');\n * store.set('checkout_v2', { key: 'checkout_v2', enabled: true, variants: {}, reason: 'ROLLOUT_MATCH', version: 3 });\n * const result = store.get('checkout_v2');\n */\nexport class FlagStorage {\n private readonly memory = new Map<string, FlagEvaluationResult>();\n private readonly storageKey: string;\n private readonly localStorageAvailable: boolean;\n private broadcastChannel: BroadcastChannel | null = null;\n\n constructor(apiKeyPrefix: string) {\n this.storageKey = `${STORAGE_KEY_PREFIX}${apiKeyPrefix}`;\n this.localStorageAvailable = this.testLocalStorage();\n this.hydrate();\n this.setupBroadcastChannel();\n }\n\n /**\n * Stores a flag evaluation result in memory (and localStorage if available).\n *\n * @param key - Flag programmatic key.\n * @param result - Evaluation result to persist.\n */\n set(key: string, result: FlagEvaluationResult): void {\n this.memory.set(key, result);\n this.persist();\n this.broadcastUpdate(key, result);\n }\n\n /**\n * Retrieves a flag evaluation result by key.\n *\n * @param key - Flag programmatic key.\n * @returns The cached evaluation result or `undefined`.\n */\n get(key: string): FlagEvaluationResult | undefined {\n return this.memory.get(key);\n }\n\n /**\n * Bulk-sets multiple flag results (e.g. after a batch fetch).\n *\n * @param flags - Record of flag key → evaluation result.\n */\n setAll(flags: Record<string, FlagEvaluationResult>): void {\n for (const [key, value] of Object.entries(flags)) {\n this.memory.set(key, value);\n }\n this.persist();\n }\n\n /**\n * Removes a single flag from storage (e.g. on FLAG_DELETE SSE event).\n *\n * @param key - Flag programmatic key.\n */\n delete(key: string): void {\n this.memory.delete(key);\n this.persist();\n }\n\n /**\n * Returns all cached flag results.\n *\n * @returns All stored flag results as a record.\n */\n getAll(): Record<string, FlagEvaluationResult> {\n return Object.fromEntries(this.memory.entries());\n }\n\n /**\n * Clears all cached flags from memory and localStorage.\n */\n clear(): void {\n this.memory.clear();\n if (this.localStorageAvailable) {\n try {\n window.localStorage.removeItem(this.storageKey);\n } catch {\n // Storage access denied\n }\n }\n this.broadcastChannel?.close();\n }\n\n /**\n * Retrieves or creates a persistent anonymous user ID.\n *\n * @returns Anonymous ID string (e.g. \"anon_xyz123abc\").\n */\n getOrCreateAnonymousId(): string {\n if (typeof window === 'undefined') return 'anon-ssr-node';\n\n if (this.localStorageAvailable) {\n try {\n let id = window.localStorage.getItem(ANON_ID_KEY);\n if (!id) {\n id = `anon_${Math.random().toString(36).substring(2, 11)}`;\n window.localStorage.setItem(ANON_ID_KEY, id);\n }\n return id;\n } catch {\n // Incognito / locked storage\n }\n }\n\n return `anon_${Math.random().toString(36).substring(2, 11)}`;\n }\n\n private testLocalStorage(): boolean {\n try {\n if (typeof window === 'undefined') return false;\n const testKey = '__nexus_test__';\n window.localStorage.setItem(testKey, '1');\n window.localStorage.removeItem(testKey);\n return true;\n } catch {\n return false;\n }\n }\n\n private hydrate(): void {\n if (!this.localStorageAvailable) return;\n try {\n const raw = window.localStorage.getItem(this.storageKey);\n if (raw) {\n const parsed = JSON.parse(raw) as Record<string, FlagEvaluationResult>;\n for (const [key, value] of Object.entries(parsed)) {\n this.memory.set(key, value);\n }\n }\n } catch {\n // Corrupt storage — start fresh\n }\n }\n\n private persist(): void {\n if (!this.localStorageAvailable) return;\n try {\n window.localStorage.setItem(\n this.storageKey,\n JSON.stringify(Object.fromEntries(this.memory.entries())),\n );\n } catch {\n // Storage quota exceeded — in-memory only\n }\n }\n\n private setupBroadcastChannel(): void {\n try {\n if (typeof BroadcastChannel !== 'undefined') {\n this.broadcastChannel = new BroadcastChannel(`nexus_flags_${this.storageKey}`);\n this.broadcastChannel.onmessage = (evt: MessageEvent<{ key: string; result: FlagEvaluationResult }>) => {\n // Sync updates from other tabs into local memory cache\n if (evt.data?.key && evt.data?.result) {\n this.memory.set(evt.data.key, evt.data.result);\n }\n };\n }\n } catch {\n // BroadcastChannel unavailable (e.g. Worker context)\n }\n }\n\n private broadcastUpdate(key: string, result: FlagEvaluationResult): void {\n try {\n this.broadcastChannel?.postMessage({ key, result });\n } catch {\n // Broadcast failed — no-op\n }\n }\n}\n","/**\n * @fileoverview NexusFlagsClient — Full-featured feature flags SDK client.\n * In-memory evaluation, SSE real-time sync, ABAC targeting, and MurmurHash3 rollout.\n * @module @nexus/sdk-flags/client\n */\n\nimport type {\n FlagEvaluationResult,\n FlagVariants,\n FeatureFlag,\n UserContext,\n} from '@nexussdk/contracts';\nimport { resolveApiKey, resolveBaseUrl, fetchWithRetry } from '@nexussdk/core';\nimport { evaluateFlag } from './evaluator.js';\nimport { SSEManager } from './sse-manager.js';\nimport { FlagStorage } from './storage.js';\n\n/**\n * Options for initializing the NexusFlagsClient.\n *\n * @example\n * const client = new NexusFlagsClient({\n * apiKey: 'pk_live_...',\n * baseUrl: 'http://localhost:8080',\n * user: { id: 'usr_12345', country: 'VN' },\n * realtime: true,\n * });\n */\nexport interface NexusFlagsOptions {\n /**\n * Public API Key ('pk_live_...' or 'pk_test_...').\n * If omitted, resolved automatically via env variables.\n */\n apiKey?: string;\n /**\n * Base ingestion URL. Defaults to 'https://api.nexus.dev'.\n */\n baseUrl?: string;\n /**\n * Initial user identity context for targeting and percentage rollouts.\n */\n user?: UserContext;\n /**\n * Pre-hydrated flags evaluated on the server (SSR) to prevent client-side UI flicker.\n */\n bootstrap?: Record<string, FlagEvaluationResult>;\n /**\n * Toggle real-time SSE updates. Defaults to true.\n */\n realtime?: boolean;\n /**\n * Network timeout in milliseconds for evaluation fetch. Defaults to 3000ms.\n */\n timeoutMs?: number;\n}\n\n/**\n * Public interface for the NexusFlagsClient.\n */\nexport interface INexusFlagsClient {\n /**\n * Synchronously checks if a flag is active for the current user.\n *\n * @param key - Unique flag identifier.\n * @param defaultValue - Fallback returned if flag is absent or evaluating.\n * @returns `true` if the flag is enabled.\n *\n * @example\n * const showBanner = client.isEnabled('promo_banner_v2', false);\n */\n isEnabled(key: string, defaultValue?: boolean): boolean;\n\n /**\n * Synchronously retrieves a specific dynamic configuration variant.\n *\n * @param key - Unique flag identifier.\n * @param variantKey - Property inside the variant object.\n * @param defaultValue - Fallback returned if flag/variant is missing.\n * @returns The variant value cast to type T.\n *\n * @example\n * const rate = client.getVariant<number>('promo_banner_v2', 'discount_rate', 10);\n */\n getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T;\n\n /**\n * Updates current user context and re-evaluates all flags.\n *\n * @param user - New user context to apply.\n * @returns Promise that resolves after flags are refreshed.\n *\n * @example\n * await client.identify({ id: 'usr_99', country: 'SG' });\n */\n identify(user: UserContext): Promise<void>;\n\n /**\n * Resets user context to an anonymous persistent device identifier.\n *\n * @example\n * client.reset(); // called on logout\n */\n reset(): void;\n\n /**\n * Subscribes to runtime flag changes triggered by SSE updates.\n *\n * @param key - Flag key to observe.\n * @param callback - Called with new evaluation result when the flag changes.\n * @returns Unsubscribe function — call to remove the listener.\n *\n * @example\n * const unsub = client.onFlagChange('checkout_v2', (result) => {\n * setCheckoutEnabled(result.enabled);\n * });\n * // On component unmount:\n * unsub();\n */\n onFlagChange(key: string, callback: (result: FlagEvaluationResult) => void): () => void;\n\n /**\n * Gracefully shuts down active SSE connections and observers.\n *\n * @example\n * client.destroy();\n */\n destroy(): void;\n}\n\n/**\n * Feature Flags Client — the primary SDK entry point for flag evaluation.\n *\n * @implements {INexusFlagsClient}\n *\n * @example\n * const client = new NexusFlagsClient({ apiKey: 'pk_live_...' });\n * const enabled = client.isEnabled('new_checkout', false);\n */\nexport class NexusFlagsClient implements INexusFlagsClient {\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly timeoutMs: number;\n private user: UserContext;\n private readonly storage: FlagStorage;\n private readonly listeners = new Map<string, Set<(res: FlagEvaluationResult) => void>>();\n private sseManager?: SSEManager;\n private flagDefinitions = new Map<string, FeatureFlag>();\n\n constructor(options: NexusFlagsOptions = {}) {\n this.apiKey = resolveApiKey(options.apiKey);\n this.baseUrl = resolveBaseUrl(options.baseUrl);\n this.timeoutMs = options.timeoutMs ?? 3_000;\n this.storage = new FlagStorage(this.apiKey.substring(0, 16));\n this.user = options.user ?? { id: this.storage.getOrCreateAnonymousId() };\n\n // Hydrate bootstrap flags (SSR pre-evaluation)\n if (options.bootstrap) {\n this.storage.setAll(options.bootstrap);\n }\n\n if (options.realtime !== false) {\n this.initRealtimeSync();\n }\n\n // Prefetch flags asynchronously on init\n void this.refreshFlags();\n }\n\n /**\n * Evaluates whether a given feature flag is enabled for the current context.\n */\n public isEnabled(key: string, defaultValue = false): boolean {\n const cached = this.storage.get(key);\n return cached !== undefined ? cached.enabled : defaultValue;\n }\n\n /**\n * Retrieves a typed variant configuration for an active feature flag.\n */\n public getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T {\n const cached = this.storage.get(key);\n if (!cached?.enabled || !cached.variants) {\n return defaultValue as T;\n }\n const value = (cached.variants as FlagVariants)[variantKey];\n return value !== undefined ? (value as T) : (defaultValue as T);\n }\n\n /**\n * Identifies an authenticated user and triggers a flag evaluation refresh.\n */\n public async identify(user: UserContext): Promise<void> {\n this.user = { ...this.user, ...user };\n await this.refreshFlags();\n }\n\n /**\n * Resets the active user context to a new anonymous identifier.\n */\n public reset(): void {\n this.user = { id: this.storage.getOrCreateAnonymousId() };\n void this.refreshFlags();\n }\n\n /**\n * Registers a listener callback invoked when a flag's evaluation state changes.\n */\n public onFlagChange(key: string, callback: (result: FlagEvaluationResult) => void): () => void {\n if (!this.listeners.has(key)) {\n this.listeners.set(key, new Set());\n }\n this.listeners.get(key)!.add(callback);\n return () => this.listeners.get(key)?.delete(callback);\n }\n\n /**\n * Destroys the client, terminating SSE connections and clearing listeners.\n */\n public destroy(): void {\n this.sseManager?.disconnect();\n this.listeners.clear();\n this.storage.clear();\n }\n\n private initRealtimeSync(): void {\n this.sseManager = new SSEManager({\n url: `${this.baseUrl}/api/v1/flags/stream`,\n apiKey: this.apiKey,\n onEvent: (event) => {\n if (event.type === 'FLAG_UPDATE' && event.data) {\n // Use locally evaluated result if we have the flag definition\n const flagDef = this.flagDefinitions.get(event.key);\n const result = flagDef\n ? evaluateFlag(flagDef, this.user)\n : event.data;\n\n this.storage.set(event.key, result);\n this.listeners.get(event.key)?.forEach((cb) => cb(result));\n } else if (event.type === 'FLAG_DELETE') {\n this.storage.delete(event.key);\n this.flagDefinitions.delete(event.key);\n }\n },\n });\n this.sseManager.connect();\n }\n\n private async refreshFlags(): Promise<void> {\n try {\n const result = await fetchWithRetry<Record<string, FeatureFlag>>({\n url: `${this.baseUrl}/api/v1/flags/eval`,\n method: 'GET',\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n 'X-Nexus-User-Id': this.user.id ?? 'anon',\n 'X-Nexus-Country': this.user.country ?? '',\n },\n timeoutMs: this.timeoutMs,\n maxRetries: 2,\n });\n\n for (const [key, flag] of Object.entries(result.data)) {\n this.flagDefinitions.set(key, flag);\n const evaluated = evaluateFlag(flag, this.user);\n this.storage.set(key, evaluated);\n this.listeners.get(key)?.forEach((cb) => cb(evaluated));\n }\n } catch {\n // Offline fallback: retain existing in-memory cache silently\n // Never throw from a background refresh — host app must not be affected\n }\n }\n}\n","/**\n * @fileoverview PII sanitization engine for safe error payload transmission.\n * Recursively redacts sensitive fields before any data leaves the client device.\n * @module @nexus/sdk-tracker/sanitizer\n */\n\n/** Maximum object recursion depth to prevent stack overflows on deep structures. */\nconst MAX_DEPTH = 5;\n\n/**\n * Regex matching sensitive key names that should be redacted.\n * Matches exact key names (case-insensitive) for password, token, secret, etc.\n */\nconst SENSITIVE_KEY_PATTERN =\n /^(password|passwd|token|secret|authorization|bearer|auth|credit_?card|cvv|cvc|ssn|api_?key|access_?token|refresh_?token)$/i;\n\n/**\n * Regex matching credit card number patterns (13-16 digit sequences).\n * Covers common formats with spaces or dashes between groups.\n */\nconst CREDIT_CARD_PATTERN = /\\b(?:\\d[ -]*?){13,16}\\b/g;\n\n/**\n * Regex matching email addresses in string values.\n * Only the domain portion is retained for limited diagnostic context.\n */\nconst EMAIL_PATTERN = /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}/g;\n\n/**\n * Regex matching URL query parameters containing sensitive tokens.\n * Strips values for: token, auth, key, secret, password, api_key.\n */\nconst SENSITIVE_QUERY_PARAM_PATTERN =\n /([?&](token|auth|key|secret|password|api_key|access_token|refresh_token)=)[^&]*/gi;\n\n/**\n * Sanitizes a string value by removing credit card numbers and email addresses.\n *\n * @param value - The string to sanitize.\n * @returns Sanitized string with sensitive patterns replaced.\n */\nfunction sanitizeString(value: string): string {\n return value\n .replace(CREDIT_CARD_PATTERN, '[CARD_REDACTED]')\n .replace(EMAIL_PATTERN, '[EMAIL_REDACTED]')\n .replace(SENSITIVE_QUERY_PARAM_PATTERN, '$1[REDACTED]');\n}\n\n/**\n * Recursively sanitizes an object, redacting sensitive key-value pairs.\n * Handles nested objects, arrays, and string values.\n *\n * @param value - The value to sanitize (any type).\n * @param depth - Current recursion depth (internal, starts at 0).\n * @returns A sanitized deep copy of the input.\n *\n * @example\n * const payload = {\n * user: { email: 'john@example.com', password: 'secret123' },\n * token: 'Bearer abc123',\n * creditCard: '4111 1111 1111 1111',\n * };\n * const safe = sanitizeObject(payload);\n * // { user: { email: '[EMAIL_REDACTED]', password: '[REDACTED]' },\n * // token: '[REDACTED]', creditCard: '[REDACTED]' }\n */\nexport function sanitizeObject(value: unknown, depth = 0): unknown {\n if (depth > MAX_DEPTH) return '[MaxDepthExceeded]';\n\n if (value === null || value === undefined) return value;\n\n if (typeof value === 'string') {\n return sanitizeString(value);\n }\n\n if (typeof value !== 'object') {\n return value; // number, boolean, etc.\n }\n\n if (Array.isArray(value)) {\n return value.map((item) => sanitizeObject(item, depth + 1));\n }\n\n const sanitized: Record<string, unknown> = {};\n for (const [key, val] of Object.entries(value as Record<string, unknown>)) {\n if (SENSITIVE_KEY_PATTERN.test(key)) {\n sanitized[key] = '[REDACTED]';\n } else {\n sanitized[key] = sanitizeObject(val, depth + 1);\n }\n }\n return sanitized;\n}\n\n/**\n * Sanitizes a URL by stripping sensitive query parameters.\n *\n * @param url - URL string to sanitize.\n * @returns URL with sensitive query values replaced with [REDACTED].\n *\n * @example\n * sanitizeUrl('https://app.com/auth?token=abc123&redirect=/home');\n * // 'https://app.com/auth?token=[REDACTED]&redirect=/home'\n */\nexport function sanitizeUrl(url: string): string {\n return url.replace(SENSITIVE_QUERY_PARAM_PATTERN, '$1[REDACTED]');\n}\n","/**\n * @fileoverview Error fingerprinting and stack trace parsing utilities.\n * Generates deterministic SHA-256-based fingerprints for error deduplication.\n * @module @nexus/sdk-tracker/fingerprint\n */\n\nimport type { StackFrame } from '@nexussdk/contracts';\n\n/**\n * Parses a JavaScript error stack string into structured StackFrame objects.\n * Supports V8 (Chrome/Node), SpiderMonkey (Firefox), and JavaScriptCore (Safari) formats.\n *\n * @param stack - Raw stack trace string from an Error object.\n * @returns Array of parsed {@link StackFrame} objects (innermost first).\n *\n * @example\n * const frames = parseStackTrace(new TypeError('test').stack);\n * // [{ functionName: 'processPayment', fileName: 'chunk.js', lineNumber: 1, columnNumber: 400 }]\n */\nexport function parseStackTrace(stack?: string): StackFrame[] {\n if (!stack) return [];\n\n const frames: StackFrame[] = [];\n const lines = stack.split('\\n');\n\n for (const line of lines) {\n const trimmed = line.trim();\n\n // V8 format: \" at FunctionName (file.js:line:col)\"\n // V8 anonymous: \" at file.js:line:col\"\n const v8Match =\n trimmed.match(/^at\\s+(.+?)\\s+\\((.+?):(\\d+):(\\d+)\\)$/) ||\n trimmed.match(/^at\\s+(.+?):(\\d+):(\\d+)$/) ||\n trimmed.match(/^at\\s+\\((.+?):(\\d+):(\\d+)\\)$/);\n\n if (v8Match) {\n if (v8Match.length === 5) {\n // Named function\n frames.push({\n functionName: v8Match[1] ?? '<anonymous>',\n fileName: v8Match[2] ?? '<unknown>',\n lineNumber: parseInt(v8Match[3] ?? '0', 10),\n columnNumber: parseInt(v8Match[4] ?? '0', 10),\n });\n } else if (v8Match.length === 4) {\n // Anonymous or \"at (file:line:col)\"\n frames.push({\n functionName: '<anonymous>',\n fileName: v8Match[1] ?? '<unknown>',\n lineNumber: parseInt(v8Match[2] ?? '0', 10),\n columnNumber: parseInt(v8Match[3] ?? '0', 10),\n });\n }\n continue;\n }\n\n // Firefox/Safari format: \"functionName@file.js:line:col\"\n const geckoMatch = trimmed.match(/^(.+?)@(.+?):(\\d+):(\\d+)$/);\n if (geckoMatch) {\n frames.push({\n functionName: geckoMatch[1] ?? '<anonymous>',\n fileName: geckoMatch[2] ?? '<unknown>',\n lineNumber: parseInt(geckoMatch[3] ?? '0', 10),\n columnNumber: parseInt(geckoMatch[4] ?? '0', 10),\n });\n }\n }\n\n return frames;\n}\n\n/**\n * Computes a fast non-cryptographic fingerprint string for error deduplication.\n * Uses a djb2-style hash over the signature components to avoid SubtleCrypto async API.\n *\n * Format: hash(errorType + \":\" + errorMessage + \":\" + topFileName + \":\" + topLineNumber)\n *\n * @param errorType - JavaScript error type (e.g. \"TypeError\").\n * @param errorMessage - Primary error message.\n * @param topFrame - Innermost (first) stack frame, or undefined if stack is empty.\n * @returns Hex-like fingerprint string for deduplication grouping.\n *\n * @example\n * const fp = computeFingerprint(\n * 'TypeError',\n * \"Cannot read properties of undefined (reading 'map')\",\n * { functionName: 'render', fileName: 'chunk.js', lineNumber: 1, columnNumber: 400 }\n * );\n * // 'fp_a3f9b2c1d4...'\n */\nexport function computeFingerprint(\n errorType: string,\n errorMessage: string,\n topFrame?: StackFrame,\n): string {\n const fileName = topFrame?.fileName ?? 'unknown';\n const lineNumber = topFrame?.lineNumber ?? 0;\n const signature = `${errorType}:${errorMessage}:${fileName}:${lineNumber}`;\n\n // djb2 hash algorithm — fast, no async, no external deps\n let hash = 5381;\n for (let i = 0; i < signature.length; i++) {\n hash = ((hash << 5) + hash + signature.charCodeAt(i)) >>> 0;\n }\n\n return `fp_${hash.toString(16).padStart(8, '0')}`;\n}\n","/**\n * @fileoverview Breadcrumb ring buffer manager for recording user activity trails.\n * Automatically captures DOM clicks, navigation events, and console calls.\n * @module @nexus/sdk-tracker/breadcrumbs\n */\n\nimport type { Breadcrumb, BreadcrumbCategory } from '@nexussdk/contracts';\nimport { RingBuffer } from '@nexussdk/core';\nimport { sanitizeObject, sanitizeUrl } from './sanitizer.js';\n\n/**\n * Manages the breadcrumb ring buffer and attaches automatic DOM/navigation listeners.\n *\n * @example\n * const manager = new BreadcrumbManager(20);\n * manager.attachListeners();\n * manager.push({ category: 'custom', message: 'User entered checkout flow', level: 'info' });\n * const trail = manager.getAll(); // Array of last 20 breadcrumbs\n */\nexport class BreadcrumbManager {\n private readonly buffer: RingBuffer<Breadcrumb>;\n private listenersAttached = false;\n private readonly clickHandler: (evt: MouseEvent) => void;\n private readonly popStateHandler: () => void;\n\n constructor(maxBreadcrumbs: number) {\n this.buffer = new RingBuffer<Breadcrumb>(maxBreadcrumbs);\n\n // Bind handlers once to enable proper removeEventListener\n this.clickHandler = this.handleClick.bind(this);\n this.popStateHandler = this.handleNavigation.bind(this);\n }\n\n /**\n * Adds a breadcrumb to the ring buffer, sanitizing any PII in the data.\n *\n * @param breadcrumb - Breadcrumb data (timestamp will be auto-injected).\n *\n * @example\n * manager.push({ category: 'http', message: 'POST /api/checkout', level: 'info', data: { status: 200 } });\n */\n push(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void {\n const sanitizedData = breadcrumb.data\n ? (sanitizeObject(breadcrumb.data) as Record<string, unknown>)\n : undefined;\n\n this.buffer.push({\n ...breadcrumb,\n data: sanitizedData,\n timestamp: Date.now(),\n });\n }\n\n /**\n * Returns all breadcrumbs in chronological order (oldest first).\n *\n * @returns Ordered array of breadcrumbs for inclusion in error payloads.\n */\n getAll(): Breadcrumb[] {\n return this.buffer.toArray();\n }\n\n /**\n * Clears all stored breadcrumbs.\n */\n clear(): void {\n this.buffer.clear();\n }\n\n /**\n * Attaches automatic event listeners for DOM clicks and navigation changes.\n * Safe to call multiple times — idempotent.\n *\n * @example\n * manager.attachListeners(); // called during SDK init\n */\n attachListeners(): void {\n if (this.listenersAttached || typeof window === 'undefined') return;\n this.listenersAttached = true;\n\n // DOM click breadcrumbs\n document.addEventListener('click', this.clickHandler, { capture: true, passive: true });\n\n // Browser navigation breadcrumbs (popstate = back/forward)\n window.addEventListener('popstate', this.popStateHandler, { passive: true });\n\n // Intercept console.error for breadcrumb recording\n this.interceptConsoleError();\n }\n\n /**\n * Removes all attached event listeners.\n *\n * @example\n * manager.detachListeners(); // called during SDK destroy\n */\n detachListeners(): void {\n if (!this.listenersAttached || typeof window === 'undefined') return;\n document.removeEventListener('click', this.clickHandler, { capture: true });\n window.removeEventListener('popstate', this.popStateHandler);\n this.listenersAttached = false;\n }\n\n private handleClick(evt: MouseEvent): void {\n const target = evt.target as HTMLElement | null;\n if (!target) return;\n\n // Mask password fields and data-nexus-mask elements\n if (\n target instanceof HTMLInputElement &&\n (target.type === 'password' || target.hasAttribute('data-nexus-mask'))\n ) {\n return; // Skip masked fields entirely\n }\n\n const description = this.describeElement(target);\n this.push({\n category: 'ui.click' as BreadcrumbCategory,\n message: `Clicked ${description}`,\n level: 'info',\n data: {\n elementTag: target.tagName.toLowerCase(),\n elementId: target.id || undefined,\n elementClass: target.className || undefined,\n },\n });\n }\n\n private handleNavigation(): void {\n this.push({\n category: 'navigation' as BreadcrumbCategory,\n message: `Navigated to ${sanitizeUrl(window.location.href)}`,\n level: 'info',\n data: { url: sanitizeUrl(window.location.href) },\n });\n }\n\n private describeElement(el: HTMLElement): string {\n const parts: string[] = [el.tagName.toLowerCase()];\n if (el.id) parts.push(`#${el.id}`);\n if (el.getAttribute('aria-label')) parts.push(`[aria-label=\"${el.getAttribute('aria-label')}\"]`);\n return parts.join('');\n }\n\n private interceptConsoleError(): void {\n const original = console.error.bind(console);\n console.error = (...args: unknown[]) => {\n this.push({\n category: 'console' as BreadcrumbCategory,\n message: args.map(String).join(' ').substring(0, 500),\n level: 'error',\n });\n original(...args);\n };\n }\n}\n","/**\n * @fileoverview Hybrid transport dispatcher for error payload delivery.\n * Prefers fetch with keepalive; falls back to navigator.sendBeacon during page unload.\n * @module @nexus/sdk-tracker/transport\n */\n\nimport type { ErrorEventPayload } from '@nexussdk/contracts';\nimport { safeStringify, computeBackoffMs } from '@nexussdk/core';\n\n/**\n * Options for configuring the transport dispatcher.\n */\nexport interface TransportOptions {\n /** Go-Gin ingestion endpoint URL. */\n endpoint: string;\n /** Public API key for Authorization header. */\n apiKey: string;\n /** Maximum retry attempts on network failures. Defaults to 2. */\n maxRetries?: number;\n}\n\n/**\n * Hybrid transport dispatcher that intelligently selects the delivery mechanism:\n * - **Normal execution**: `fetch(url, { keepalive: true })` with retry\n * - **Page teardown** (`visibilityState === 'hidden'` or `pagehide`): `navigator.sendBeacon`\n *\n * @example\n * const transport = new Transport({\n * endpoint: 'http://localhost:8080/api/v1/telemetry/errors',\n * apiKey: 'pk_live_...',\n * });\n * transport.send(errorPayload);\n */\nexport class Transport {\n private readonly options: TransportOptions;\n private readonly maxRetries: number;\n private isPageHiding = false;\n\n constructor(options: TransportOptions) {\n this.options = options;\n this.maxRetries = options.maxRetries ?? 2;\n\n // Detect page teardown events to switch to sendBeacon\n if (typeof document !== 'undefined') {\n document.addEventListener('visibilitychange', () => {\n if (document.visibilityState === 'hidden') {\n this.isPageHiding = true;\n }\n });\n }\n if (typeof window !== 'undefined') {\n window.addEventListener('pagehide', () => {\n this.isPageHiding = true;\n });\n }\n }\n\n /**\n * Dispatches an error payload to the Go-Gin ingestion endpoint.\n * Automatically selects fetch or sendBeacon based on page lifecycle state.\n *\n * @param payload - The sanitized {@link ErrorEventPayload} to transmit.\n *\n * @example\n * transport.send({\n * fingerprint: 'fp_abc123',\n * errorType: 'TypeError',\n * errorMessage: \"Cannot read property 'map' of undefined\",\n * // ...\n * });\n */\n send(payload: ErrorEventPayload): void {\n const body = safeStringify(payload);\n\n // Use sendBeacon during page teardown — prevents cancelled fetch requests\n if (\n this.isPageHiding &&\n typeof navigator !== 'undefined' &&\n typeof navigator.sendBeacon === 'function'\n ) {\n const blob = new Blob([body], { type: 'application/json' });\n navigator.sendBeacon(this.options.endpoint, blob);\n return;\n }\n\n // Normal execution: fetch with keepalive and exponential backoff retry\n void this.sendWithRetry(body, 0);\n }\n\n /**\n * Forces immediate flush of all pending events using sendBeacon.\n * Called during manual flush or SDK destroy lifecycle.\n *\n * @param payload - The error payload to flush.\n * @returns Promise that resolves when the beacon is dispatched.\n */\n async flush(payload: ErrorEventPayload): Promise<void> {\n const body = safeStringify(payload);\n if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {\n const blob = new Blob([body], { type: 'application/json' });\n navigator.sendBeacon(this.options.endpoint, blob);\n return;\n }\n await this.sendWithRetry(body, 0);\n }\n\n private async sendWithRetry(body: string, attempt: number): Promise<void> {\n try {\n const response = await fetch(this.options.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n Authorization: `Bearer ${this.options.apiKey}`,\n },\n body,\n keepalive: true,\n });\n\n if (response.ok) return;\n\n // Retry on 5xx\n if (response.status >= 500 && attempt < this.maxRetries) {\n const delay = computeBackoffMs(attempt, 1000, 30_000);\n await new Promise((r) => setTimeout(r, delay));\n await this.sendWithRetry(body, attempt + 1);\n }\n } catch {\n // Network failure — retry with backoff\n if (attempt < this.maxRetries) {\n const delay = computeBackoffMs(attempt, 1000, 30_000);\n await new Promise((r) => setTimeout(r, delay));\n await this.sendWithRetry(body, attempt + 1);\n }\n // All retries exhausted — silently drop to prevent host app instability\n }\n }\n}\n","/**\n * @fileoverview Global error and unhandled rejection listeners.\n * Attaches window-level hooks without interfering with native browser behavior.\n * @module @nexus/sdk-tracker/listeners\n */\n\nimport type { NexusTrackerClient } from './client.js';\n\n/**\n * Attaches global error event listeners to the browser window.\n * Captures:\n * - `window.onerror` — synchronous uncaught exceptions\n * - `window.onunhandledrejection` — unhandled Promise rejections\n *\n * CRITICAL: Neither handler calls `event.preventDefault()`.\n * Native browser behavior (console.error, DevTools display) is preserved.\n *\n * @param client - The NexusTrackerClient instance to forward errors to.\n * @returns Cleanup function that removes all attached listeners.\n *\n * @example\n * const cleanup = attachGlobalListeners(trackerClient);\n * // On SDK destroy:\n * cleanup();\n */\nexport function attachGlobalListeners(client: NexusTrackerClient): () => void {\n if (typeof window === 'undefined') {\n return () => void 0; // No-op in SSR contexts\n }\n\n const errorHandler = (event: ErrorEvent): void => {\n // Do NOT call event.preventDefault() — preserve native browser behavior\n const error = event.error instanceof Error ? event.error : new Error(event.message);\n client.captureError(error);\n };\n\n const rejectionHandler = (event: PromiseRejectionEvent): void => {\n // Do NOT call event.preventDefault()\n client.captureError(event.reason);\n };\n\n window.addEventListener('error', errorHandler);\n window.addEventListener('unhandledrejection', rejectionHandler);\n\n return () => {\n window.removeEventListener('error', errorHandler);\n window.removeEventListener('unhandledrejection', rejectionHandler);\n };\n}\n","/**\n * @fileoverview NexusTrackerClient — Full-featured crash ingestion and telemetry SDK.\n * Automated global error capture, PII sanitization, deduplication, and hybrid transport.\n * @module @nexus/sdk-tracker/client\n */\n\nimport type { Breadcrumb, DeviceContext, ErrorEventPayload, UserContext } from '@nexussdk/contracts';\nimport { resolveApiKey, resolveBaseUrl } from '@nexussdk/core';\nimport { sanitizeObject } from './sanitizer.js';\nimport { computeFingerprint, parseStackTrace } from './fingerprint.js';\nimport { BreadcrumbManager } from './breadcrumbs.js';\nimport { Transport } from './transport.js';\nimport { attachGlobalListeners } from './listeners.js';\n\n/**\n * Options for initializing the NexusTrackerClient.\n *\n * @example\n * const tracker = new NexusTrackerClient({\n * apiKey: 'pk_live_...',\n * environment: 'production',\n * autoCapture: true,\n * maxBreadcrumbs: 20,\n * });\n */\nexport interface NexusTrackerOptions {\n /**\n * Public API Key ('pk_live_...' or 'pk_test_...').\n * If omitted, resolved automatically via env variables.\n */\n apiKey?: string;\n /**\n * Centralized Go-Gin Ingestion URL. Defaults to 'https://api.nexus.dev'.\n */\n baseUrl?: string;\n /**\n * Target deployment environment ('production' | 'staging' | 'development').\n */\n environment?: string;\n /**\n * Max breadcrumbs retained in ring buffer. Defaults to 20 (max 50).\n */\n maxBreadcrumbs?: number;\n /**\n * Global tags attached to every captured telemetry event.\n */\n tags?: Record<string, string>;\n /**\n * Toggle automated capturing of uncaught exceptions. Defaults to true.\n */\n autoCapture?: boolean;\n /**\n * Callback hook to inspect, mutate, or drop an event before dispatch.\n * Return null to drop the event completely.\n */\n beforeSend?: (event: ErrorEventPayload) => ErrorEventPayload | null;\n}\n\n/** Internal deduplication entry. */\ninterface DedupeEntry {\n timer: ReturnType<typeof setTimeout>;\n count: number;\n lastPayload: ErrorEventPayload;\n}\n\n/**\n * Public interface contract for NexusTrackerClient.\n */\nexport interface INexusTrackerClient {\n /**\n * Manually captures an exception or custom error instance.\n *\n * @param error - Error object, string message, or unknown rejection value.\n * @param extra - Optional custom metadata tags.\n *\n * @example\n * tracker.captureError(new TypeError('Payment failed'), { checkoutStep: 'payment' });\n */\n captureError(error: unknown, extra?: Record<string, unknown>): void;\n\n /**\n * Records a user activity step into the chronological breadcrumb ring buffer.\n *\n * @param breadcrumb - Breadcrumb data without timestamp (auto-injected).\n *\n * @example\n * tracker.addBreadcrumb({ category: 'navigation', message: 'Navigated to /checkout', level: 'info' });\n */\n addBreadcrumb(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void;\n\n /**\n * Attaches end-user context to subsequent error payloads.\n *\n * @param user - User context or null to clear.\n *\n * @example\n * tracker.setUser({ id: 'usr_12345', email: 'john@example.com' });\n */\n setUser(user: UserContext | null): void;\n\n /**\n * Dynamically sets or updates a persistent search tag.\n *\n * @param key - Tag key name.\n * @param value - Tag value string.\n *\n * @example\n * tracker.setTag('app_version', '2.4.1');\n */\n setTag(key: string, value: string): void;\n\n /**\n * Flushes any buffered events immediately via navigator.sendBeacon or fetch.\n *\n * @returns Promise that resolves when all events are dispatched.\n *\n * @example\n * await tracker.flush();\n */\n flush(): Promise<void>;\n\n /**\n * Detaches global window listeners and clears in-memory ring buffers.\n *\n * @example\n * tracker.destroy();\n */\n destroy(): void;\n}\n\n/**\n * NexusTrackerClient — resilient browser crash ingestion agent.\n *\n * @implements {INexusTrackerClient}\n *\n * @example\n * const tracker = new NexusTrackerClient({ apiKey: 'pk_live_...' });\n * tracker.captureError(new Error('Checkout failed'));\n */\nexport class NexusTrackerClient implements INexusTrackerClient {\n private readonly apiKey: string;\n private readonly environment: string;\n private readonly tags: Record<string, string>;\n private readonly beforeSend?: (event: ErrorEventPayload) => ErrorEventPayload | null;\n private readonly breadcrumbManager: BreadcrumbManager;\n private readonly transport: Transport;\n private userContext?: UserContext;\n private readonly dedupeMap = new Map<string, DedupeEntry>();\n private cleanupListeners?: () => void;\n\n constructor(options: NexusTrackerOptions = {}) {\n this.apiKey = resolveApiKey(options.apiKey);\n const baseUrl = resolveBaseUrl(options.baseUrl);\n this.environment = options.environment ?? 'production';\n this.tags = { ...options.tags };\n this.beforeSend = options.beforeSend;\n\n this.breadcrumbManager = new BreadcrumbManager(Math.min(options.maxBreadcrumbs ?? 20, 50));\n this.transport = new Transport({\n endpoint: `${baseUrl}/api/v1/telemetry/errors`,\n apiKey: this.apiKey,\n });\n\n if (options.autoCapture !== false && typeof window !== 'undefined') {\n this.breadcrumbManager.attachListeners();\n this.cleanupListeners = attachGlobalListeners(this);\n }\n }\n\n /**\n * Captures an error exception, generates fingerprint, scrubs PII, and enqueues transmission.\n */\n public captureError(error: unknown, extra?: Record<string, unknown>): void {\n const normalized = this.normalizeError(error);\n const stackFrames = parseStackTrace(normalized.stack);\n const fingerprint = computeFingerprint(normalized.type, normalized.message, stackFrames[0]);\n\n // Client-side 10-second sliding window deduplication\n const existing = this.dedupeMap.get(fingerprint);\n if (existing) {\n existing.count += 1;\n return;\n }\n\n const payload: ErrorEventPayload = {\n fingerprint,\n errorType: normalized.type,\n errorMessage: normalized.message,\n stackTrace: stackFrames,\n breadcrumbs: this.breadcrumbManager.getAll(),\n userContext: this.userContext,\n deviceContext: this.getDeviceContext(),\n tags: { environment: this.environment, ...this.tags, ...(extra as Record<string, string> | undefined) },\n occurrenceCount: 1,\n clientTimestamp: Date.now(),\n };\n\n // Apply PII sanitization before transmission\n const sanitized = sanitizeObject(payload) as ErrorEventPayload;\n const finalPayload = this.beforeSend ? this.beforeSend(sanitized) : sanitized;\n if (!finalPayload) return;\n\n this.transport.send(finalPayload);\n\n // Track duplicate window — send aggregated event after 10 seconds\n const timer = setTimeout(() => {\n const entry = this.dedupeMap.get(fingerprint);\n if (entry && entry.count > 1) {\n const aggregated = { ...entry.lastPayload, occurrenceCount: entry.count, clientTimestamp: Date.now() };\n this.transport.send(aggregated);\n }\n this.dedupeMap.delete(fingerprint);\n }, 10_000);\n\n this.dedupeMap.set(fingerprint, { timer, count: 1, lastPayload: finalPayload });\n }\n\n /**\n * Records a contextual breadcrumb in the ring buffer.\n */\n public addBreadcrumb(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void {\n this.breadcrumbManager.push(breadcrumb);\n }\n\n /**\n * Sets or clears the active user context for error telemetry.\n */\n public setUser(user: UserContext | null): void {\n this.userContext = user ?? undefined;\n }\n\n /**\n * Sets a custom tag associated with error events.\n */\n public setTag(key: string, value: string): void {\n this.tags[key] = value;\n }\n\n /**\n * Flushes all pending deduplication queues and dispatches queued payloads immediately.\n */\n public async flush(): Promise<void> {\n // Flush all pending deduplication timers immediately\n for (const [fingerprint, entry] of this.dedupeMap.entries()) {\n clearTimeout(entry.timer);\n if (entry.count > 0) {\n const aggregated = { ...entry.lastPayload, occurrenceCount: entry.count, clientTimestamp: Date.now() };\n await this.transport.flush(aggregated);\n }\n this.dedupeMap.delete(fingerprint);\n }\n }\n\n /**\n * Tears down global event listeners, flushes queues, and releases resources.\n */\n public destroy(): void {\n this.cleanupListeners?.();\n this.breadcrumbManager.detachListeners();\n this.breadcrumbManager.clear();\n this.dedupeMap.forEach((entry) => clearTimeout(entry.timer));\n this.dedupeMap.clear();\n }\n\n private normalizeError(err: unknown): { type: string; message: string; stack?: string } {\n if (err instanceof Error) {\n return { type: err.name || 'Error', message: err.message, stack: err.stack };\n }\n if (typeof err === 'string') {\n return { type: 'UnhandledException', message: err };\n }\n // Unknown rejection value (non-Error thrown)\n return { type: 'NonErrorRejection', message: String(err) };\n }\n\n private getDeviceContext(): DeviceContext {\n const isBrowser = typeof window !== 'undefined' && typeof navigator !== 'undefined';\n return {\n userAgent: isBrowser ? navigator.userAgent : 'Node/SSR',\n currentUrl: isBrowser ? window.location.href : '',\n viewport: isBrowser ? `${window.innerWidth}x${window.innerHeight}` : undefined,\n timezone: Intl?.DateTimeFormat()?.resolvedOptions()?.timeZone,\n networkStatus:\n isBrowser && 'connection' in navigator\n ? ((navigator as { connection?: { effectiveType?: string } }).connection?.effectiveType ?? 'unknown')\n : undefined,\n };\n }\n}\n","/**\n * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.\n * @module @nexus/sdk/nexus\n */\n\nimport { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusFlagsOptions } from '@nexussdk/flags';\nimport { NexusTrackerClient } from '@nexussdk/tracker';\nimport type { NexusTrackerOptions } from '@nexussdk/tracker';\nimport type { UserContext } from '@nexussdk/contracts';\n\n/**\n * Unified initialization options for the Nexus SDK umbrella.\n *\n * @example\n * Nexus.init({\n * apiKey: 'pk_live_...',\n * baseUrl: 'http://localhost:8080',\n * user: { id: 'usr_12345', country: 'VN' },\n * environment: 'production',\n * autoCapture: true,\n * });\n */\nexport interface NexusInitOptions {\n /** Public API key. Resolved from env if omitted. */\n apiKey?: string;\n /** Base URL for all API calls. */\n baseUrl?: string;\n /** Initial user context for flag targeting and error attribution. */\n user?: UserContext;\n /** Target environment for telemetry routing. Defaults to 'production'. */\n environment?: string;\n /** Global tags attached to all telemetry events. */\n tags?: Record<string, string>;\n /** Toggle automated global error capture. Defaults to true. */\n autoCapture?: boolean;\n /** Additional flags-specific options. */\n flags?: Partial<NexusFlagsOptions>;\n /** Additional tracker-specific options. */\n tracker?: Partial<NexusTrackerOptions>;\n}\n\n/**\n * The Nexus singleton class — the primary unified entry point for the SDK.\n *\n * Provides access to both the feature flags client and the error tracker client.\n * Initialize once, then use throughout your application.\n *\n * @example\n * // Initialize (call once at app startup)\n * Nexus.init({ apiKey: 'pk_live_...' });\n *\n * // Feature flags\n * const showBanner = Nexus.isEnabled('promo_banner_v2', false);\n *\n * // Error tracking\n * Nexus.captureError(new Error('Something went wrong'));\n *\n * // Update user context\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\nexport class Nexus {\n private static instance: Nexus | null = null;\n\n /** The underlying feature flags client instance. */\n public readonly flags: NexusFlagsClient;\n /** The underlying error tracker client instance. */\n public readonly tracker: NexusTrackerClient;\n\n private constructor(options: NexusInitOptions = {}) {\n const { apiKey, baseUrl, user, environment, tags, autoCapture, flags: flagsOpts, tracker: trackerOpts } = options;\n\n this.flags = new NexusFlagsClient({\n apiKey,\n baseUrl,\n user,\n ...flagsOpts,\n });\n\n this.tracker = new NexusTrackerClient({\n apiKey,\n baseUrl,\n environment,\n tags,\n autoCapture,\n ...trackerOpts,\n });\n }\n\n /**\n * Initializes the Nexus SDK singleton.\n * Must be called before any other SDK methods.\n * Safe to call multiple times — returns existing instance after first init.\n *\n * @param options - SDK configuration options.\n * @returns The initialized Nexus singleton instance.\n *\n * @example\n * const nexus = Nexus.init({ apiKey: 'pk_live_...' });\n */\n public static init(options: NexusInitOptions = {}): Nexus {\n if (!Nexus.instance) {\n Nexus.instance = new Nexus(options);\n }\n return Nexus.instance;\n }\n\n /**\n * Returns the current Nexus singleton instance.\n *\n * @returns The active Nexus instance.\n * @throws {Error} If `Nexus.init()` has not been called yet.\n *\n * @example\n * const nexus = Nexus.getInstance();\n * nexus.flags.isEnabled('checkout_v2');\n */\n public static getInstance(): Nexus {\n if (!Nexus.instance) {\n throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: \"...\" }) first.');\n }\n return Nexus.instance;\n }\n\n /**\n * Convenience method: Check if a feature flag is enabled.\n *\n * @param key - Flag identifier.\n * @param defaultValue - Fallback if flag is missing.\n * @returns Boolean enabled state.\n *\n * @example\n * if (Nexus.isEnabled('checkout_redesign')) { ... }\n */\n public static isEnabled(key: string, defaultValue = false): boolean {\n return Nexus.getInstance().flags.isEnabled(key, defaultValue);\n }\n\n /**\n * Convenience method: Get a flag variant value.\n *\n * @param key - Flag identifier.\n * @param variantKey - Variant property name.\n * @param defaultValue - Fallback value.\n * @returns Variant value cast to type T.\n *\n * @example\n * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);\n */\n public static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T {\n return Nexus.getInstance().flags.getVariant<T>(key, variantKey, defaultValue);\n }\n\n /**\n * Convenience method: Capture an error manually.\n *\n * @param error - Error instance, string, or unknown value.\n * @param extra - Optional metadata tags.\n *\n * @example\n * Nexus.captureError(new TypeError('Cannot read properties of null'));\n */\n public static captureError(error: unknown, extra?: Record<string, unknown>): void {\n Nexus.getInstance().tracker.captureError(error, extra);\n }\n\n /**\n * Convenience method: Update user context for both flags and tracker.\n *\n * @param user - New user context (merged with existing).\n * @returns Promise resolving after flags refresh.\n *\n * @example\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\n public static async identify(user: UserContext): Promise<void> {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(user);\n await instance.flags.identify(user);\n }\n\n /**\n * Resets user context to anonymous state (e.g. on logout).\n *\n * @example\n * Nexus.reset(); // called on user logout\n */\n public static reset(): void {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(null);\n instance.flags.reset();\n }\n\n /**\n * Gracefully tears down both clients, closing SSE connections and flushing pending events.\n *\n * @example\n * await Nexus.destroy();\n */\n public static async destroy(): Promise<void> {\n if (Nexus.instance) {\n await Nexus.instance.tracker.flush();\n Nexus.instance.tracker.destroy();\n Nexus.instance.flags.destroy();\n Nexus.instance = null;\n }\n }\n}\n"]}
|
package/dist/index.mjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/nexus.ts"],"names":["Nexus","_Nexus","options","apiKey","baseUrl","user","environment","tags","autoCapture","flagsOpts","trackerOpts","NexusFlagsClient","NexusTrackerClient","key","defaultValue","variantKey","error","extra","instance"],"mappings":"kMA6DO,IAAMA,CAAAA,CAAN,MAAMC,CAAM,CACjB,OAAe,QAAA,CAAyB,IAAA,CAGxB,KAAA,CAEA,OAAA,CAER,WAAA,CAAYC,CAAAA,CAA4B,EAAC,CAAG,CAClD,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,OAAA,CAAAC,EAAS,IAAA,CAAAC,CAAAA,CAAM,WAAA,CAAAC,CAAAA,CAAa,IAAA,CAAAC,CAAAA,CAAM,YAAAC,CAAAA,CAAa,KAAA,CAAOC,CAAAA,CAAW,OAAA,CAASC,CAAY,CAAA,CAAIR,EAE1G,IAAA,CAAK,KAAA,CAAQ,IAAIS,gBAAAA,CAAiB,CAChC,MAAA,CAAAR,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,IAAA,CAAAC,CAAAA,CACA,GAAGI,CACL,CAAC,EAED,IAAA,CAAK,OAAA,CAAU,IAAIG,kBAAAA,CAAmB,CACpC,MAAA,CAAAT,EACA,OAAA,CAAAC,CAAAA,CACA,WAAA,CAAAE,CAAAA,CACA,IAAA,CAAAC,CAAAA,CACA,YAAAC,CAAAA,CACA,GAAGE,CACL,CAAC,EACH,CAaA,OAAc,IAAA,CAAKR,CAAAA,CAA4B,EAAC,CAAU,CACxD,OAAKD,CAAAA,CAAM,WACTA,CAAAA,CAAM,QAAA,CAAW,IAAIA,CAAAA,CAAMC,CAAO,CAAA,CAAA,CAE7BD,EAAM,QACf,CAYA,OAAc,WAAA,EAAqB,CACjC,GAAI,CAACA,CAAAA,CAAM,QAAA,CACT,MAAM,IAAI,KAAA,CAAM,wEAAwE,CAAA,CAE1F,OAAOA,CAAAA,CAAM,QACf,CAYA,OAAc,SAAA,CAAUY,CAAAA,CAAaC,EAAe,KAAA,CAAgB,CAClE,OAAOb,CAAAA,CAAM,WAAA,EAAY,CAAE,MAAM,SAAA,CAAUY,CAAAA,CAAKC,CAAY,CAC9D,CAaA,OAAc,WAAwBD,CAAAA,CAAaE,CAAAA,CAAoBD,CAAAA,CAAqB,CAC1F,OAAOb,CAAAA,CAAM,WAAA,EAAY,CAAE,KAAA,CAAM,UAAA,CAAcY,CAAAA,CAAKE,CAAAA,CAAYD,CAAY,CAC9E,CAWA,OAAc,YAAA,CAAaE,CAAAA,CAAgBC,CAAAA,CAAuC,CAChFhB,CAAAA,CAAM,aAAY,CAAE,OAAA,CAAQ,YAAA,CAAae,CAAAA,CAAOC,CAAK,EACvD,CAWA,aAAoB,QAAA,CAASZ,CAAAA,CAAkC,CAC7D,IAAMa,CAAAA,CAAWjB,CAAAA,CAAM,WAAA,EAAY,CACnCiB,CAAAA,CAAS,OAAA,CAAQ,OAAA,CAAQb,CAAI,CAAA,CAC7B,MAAMa,CAAAA,CAAS,KAAA,CAAM,QAAA,CAASb,CAAI,EACpC,CAQA,OAAc,KAAA,EAAc,CAC1B,IAAMa,CAAAA,CAAWjB,CAAAA,CAAM,WAAA,GACvBiB,CAAAA,CAAS,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,CAC7BA,CAAAA,CAAS,KAAA,CAAM,KAAA,GACjB,CAQA,aAAoB,OAAA,EAAyB,CACvCjB,CAAAA,CAAM,WACR,MAAMA,CAAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,KAAA,EAAM,CACnCA,CAAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,OAAA,EAAQ,CAC/BA,CAAAA,CAAM,QAAA,CAAS,KAAA,CAAM,SAAQ,CAC7BA,CAAAA,CAAM,QAAA,CAAW,IAAA,EAErB,CACF","file":"index.mjs","sourcesContent":["/**\n * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.\n * @module @nexus/sdk/nexus\n */\n\nimport { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusFlagsOptions } from '@nexussdk/flags';\nimport { NexusTrackerClient } from '@nexussdk/tracker';\nimport type { NexusTrackerOptions } from '@nexussdk/tracker';\nimport type { UserContext } from '@nexussdk/contracts';\n\n/**\n * Unified initialization options for the Nexus SDK umbrella.\n *\n * @example\n * Nexus.init({\n * apiKey: 'pk_live_...',\n * baseUrl: 'http://localhost:8080',\n * user: { id: 'usr_12345', country: 'VN' },\n * environment: 'production',\n * autoCapture: true,\n * });\n */\nexport interface NexusInitOptions {\n /** Public API key. Resolved from env if omitted. */\n apiKey?: string;\n /** Base URL for all API calls. */\n baseUrl?: string;\n /** Initial user context for flag targeting and error attribution. */\n user?: UserContext;\n /** Target environment for telemetry routing. Defaults to 'production'. */\n environment?: string;\n /** Global tags attached to all telemetry events. */\n tags?: Record<string, string>;\n /** Toggle automated global error capture. Defaults to true. */\n autoCapture?: boolean;\n /** Additional flags-specific options. */\n flags?: Partial<NexusFlagsOptions>;\n /** Additional tracker-specific options. */\n tracker?: Partial<NexusTrackerOptions>;\n}\n\n/**\n * The Nexus singleton class — the primary unified entry point for the SDK.\n *\n * Provides access to both the feature flags client and the error tracker client.\n * Initialize once, then use throughout your application.\n *\n * @example\n * // Initialize (call once at app startup)\n * Nexus.init({ apiKey: 'pk_live_...' });\n *\n * // Feature flags\n * const showBanner = Nexus.isEnabled('promo_banner_v2', false);\n *\n * // Error tracking\n * Nexus.captureError(new Error('Something went wrong'));\n *\n * // Update user context\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\nexport class Nexus {\n private static instance: Nexus | null = null;\n\n /** The underlying feature flags client instance. */\n public readonly flags: NexusFlagsClient;\n /** The underlying error tracker client instance. */\n public readonly tracker: NexusTrackerClient;\n\n private constructor(options: NexusInitOptions = {}) {\n const { apiKey, baseUrl, user, environment, tags, autoCapture, flags: flagsOpts, tracker: trackerOpts } = options;\n\n this.flags = new NexusFlagsClient({\n apiKey,\n baseUrl,\n user,\n ...flagsOpts,\n });\n\n this.tracker = new NexusTrackerClient({\n apiKey,\n baseUrl,\n environment,\n tags,\n autoCapture,\n ...trackerOpts,\n });\n }\n\n /**\n * Initializes the Nexus SDK singleton.\n * Must be called before any other SDK methods.\n * Safe to call multiple times — returns existing instance after first init.\n *\n * @param options - SDK configuration options.\n * @returns The initialized Nexus singleton instance.\n *\n * @example\n * const nexus = Nexus.init({ apiKey: 'pk_live_...' });\n */\n public static init(options: NexusInitOptions = {}): Nexus {\n if (!Nexus.instance) {\n Nexus.instance = new Nexus(options);\n }\n return Nexus.instance;\n }\n\n /**\n * Returns the current Nexus singleton instance.\n *\n * @returns The active Nexus instance.\n * @throws {Error} If `Nexus.init()` has not been called yet.\n *\n * @example\n * const nexus = Nexus.getInstance();\n * nexus.flags.isEnabled('checkout_v2');\n */\n public static getInstance(): Nexus {\n if (!Nexus.instance) {\n throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: \"...\" }) first.');\n }\n return Nexus.instance;\n }\n\n /**\n * Convenience method: Check if a feature flag is enabled.\n *\n * @param key - Flag identifier.\n * @param defaultValue - Fallback if flag is missing.\n * @returns Boolean enabled state.\n *\n * @example\n * if (Nexus.isEnabled('checkout_redesign')) { ... }\n */\n public static isEnabled(key: string, defaultValue = false): boolean {\n return Nexus.getInstance().flags.isEnabled(key, defaultValue);\n }\n\n /**\n * Convenience method: Get a flag variant value.\n *\n * @param key - Flag identifier.\n * @param variantKey - Variant property name.\n * @param defaultValue - Fallback value.\n * @returns Variant value cast to type T.\n *\n * @example\n * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);\n */\n public static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T {\n return Nexus.getInstance().flags.getVariant<T>(key, variantKey, defaultValue);\n }\n\n /**\n * Convenience method: Capture an error manually.\n *\n * @param error - Error instance, string, or unknown value.\n * @param extra - Optional metadata tags.\n *\n * @example\n * Nexus.captureError(new TypeError('Cannot read properties of null'));\n */\n public static captureError(error: unknown, extra?: Record<string, unknown>): void {\n Nexus.getInstance().tracker.captureError(error, extra);\n }\n\n /**\n * Convenience method: Update user context for both flags and tracker.\n *\n * @param user - New user context (merged with existing).\n * @returns Promise resolving after flags refresh.\n *\n * @example\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\n public static async identify(user: UserContext): Promise<void> {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(user);\n await instance.flags.identify(user);\n }\n\n /**\n * Resets user context to anonymous state (e.g. on logout).\n *\n * @example\n * Nexus.reset(); // called on user logout\n */\n public static reset(): void {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(null);\n instance.flags.reset();\n }\n\n /**\n * Gracefully tears down both clients, closing SSE connections and flushing pending events.\n *\n * @example\n * await Nexus.destroy();\n */\n public static async destroy(): Promise<void> {\n if (Nexus.instance) {\n await Nexus.instance.tracker.flush();\n Nexus.instance.tracker.destroy();\n Nexus.instance.flags.destroy();\n Nexus.instance = null;\n }\n }\n}\n"]}
|
package/dist/react.cjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/nexus.ts","../src/react.tsx"],"names":["Nexus","_Nexus","options","apiKey","baseUrl","user","environment","tags","autoCapture","flagsOpts","trackerOpts","NexusFlagsClient","NexusTrackerClient","key","defaultValue","variantKey","error","extra","instance","NexusContext","createContext","NexusProvider","children","initOptions","nexusRef","useRef","contextValue","useMemo","useEffect","React","useNexus","ctx","useContext","useFlag","defaultEnabled","flags","result","setResult","useState","currentEnabled","newResult","def"],"mappings":"0NA6DO,IAAMA,CAAAA,CAAN,MAAMC,CAAM,CACjB,OAAe,QAAA,CAAyB,IAAA,CAGxB,KAAA,CAEA,OAAA,CAER,WAAA,CAAYC,EAA4B,EAAC,CAAG,CAClD,GAAM,CAAE,MAAA,CAAAC,EAAQ,OAAA,CAAAC,CAAAA,CAAS,IAAA,CAAAC,CAAAA,CAAM,WAAA,CAAAC,CAAAA,CAAa,KAAAC,CAAAA,CAAM,WAAA,CAAAC,CAAAA,CAAa,KAAA,CAAOC,CAAAA,CAAW,OAAA,CAASC,CAAY,CAAA,CAAIR,CAAAA,CAE1G,IAAA,CAAK,KAAA,CAAQ,IAAIS,sBAAAA,CAAiB,CAChC,MAAA,CAAAR,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,IAAA,CAAAC,CAAAA,CACA,GAAGI,CACL,CAAC,CAAA,CAED,IAAA,CAAK,OAAA,CAAU,IAAIG,2BAAmB,CACpC,MAAA,CAAAT,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,WAAA,CAAAE,EACA,IAAA,CAAAC,CAAAA,CACA,WAAA,CAAAC,CAAAA,CACA,GAAGE,CACL,CAAC,EACH,CAaA,OAAc,IAAA,CAAKR,CAAAA,CAA4B,GAAW,CACxD,OAAKD,CAAAA,CAAM,QAAA,GACTA,CAAAA,CAAM,QAAA,CAAW,IAAIA,CAAAA,CAAMC,CAAO,CAAA,CAAA,CAE7BD,CAAAA,CAAM,QACf,CAYA,OAAc,WAAA,EAAqB,CACjC,GAAI,CAACA,CAAAA,CAAM,QAAA,CACT,MAAM,IAAI,KAAA,CAAM,wEAAwE,CAAA,CAE1F,OAAOA,CAAAA,CAAM,QACf,CAYA,OAAc,SAAA,CAAUY,CAAAA,CAAaC,CAAAA,CAAe,KAAA,CAAgB,CAClE,OAAOb,CAAAA,CAAM,WAAA,EAAY,CAAE,KAAA,CAAM,SAAA,CAAUY,EAAKC,CAAY,CAC9D,CAaA,OAAc,UAAA,CAAwBD,CAAAA,CAAaE,EAAoBD,CAAAA,CAAqB,CAC1F,OAAOb,CAAAA,CAAM,WAAA,EAAY,CAAE,MAAM,UAAA,CAAcY,CAAAA,CAAKE,CAAAA,CAAYD,CAAY,CAC9E,CAWA,OAAc,YAAA,CAAaE,CAAAA,CAAgBC,CAAAA,CAAuC,CAChFhB,CAAAA,CAAM,WAAA,GAAc,OAAA,CAAQ,YAAA,CAAae,CAAAA,CAAOC,CAAK,EACvD,CAWA,aAAoB,QAAA,CAASZ,CAAAA,CAAkC,CAC7D,IAAMa,CAAAA,CAAWjB,CAAAA,CAAM,aAAY,CACnCiB,CAAAA,CAAS,OAAA,CAAQ,OAAA,CAAQb,CAAI,CAAA,CAC7B,MAAMa,CAAAA,CAAS,KAAA,CAAM,QAAA,CAASb,CAAI,EACpC,CAQA,OAAc,KAAA,EAAc,CAC1B,IAAMa,CAAAA,CAAWjB,CAAAA,CAAM,WAAA,GACvBiB,CAAAA,CAAS,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,CAC7BA,CAAAA,CAAS,MAAM,KAAA,GACjB,CAQA,aAAoB,OAAA,EAAyB,CACvCjB,EAAM,QAAA,GACR,MAAMA,CAAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,KAAA,GAC7BA,CAAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,OAAA,EAAQ,CAC/BA,CAAAA,CAAM,SAAS,KAAA,CAAM,OAAA,EAAQ,CAC7BA,CAAAA,CAAM,QAAA,CAAW,IAAA,EAErB,CACF,CAAA,CChLA,IAAMkB,CAAAA,CAAeC,eAAAA,CAAwC,IAAI,CAAA,CAuC1D,SAASC,CAAAA,CAAc,CAAE,QAAA,CAAAC,CAAAA,CAAU,GAAGC,CAAY,EAA2C,CAClG,IAAMC,CAAAA,CAAWC,QAAAA,CAAqB,IAAI,CAAA,CAErCD,EAAS,OAAA,GACZA,CAAAA,CAAS,OAAA,CAAUxB,CAAAA,CAAM,IAAA,CAAKuB,CAAW,GAG3C,IAAMG,CAAAA,CAAeC,SAAAA,CACnB,KAAO,CACL,KAAA,CAAOH,EAAS,OAAA,CAAS,KAAA,CACzB,OAAA,CAASA,CAAAA,CAAS,OAAA,CAAS,OAAA,CAC3B,MAAOA,CAAAA,CAAS,OAClB,CAAA,CAAA,CACA,EACF,CAAA,CAEA,OAAAI,WAAAA,CAAU,IACD,IAAM,CACN5B,CAAAA,CAAM,OAAA,GACb,CAAA,CACC,EAAE,CAAA,CAEE6B,kBAAAA,CAAM,aAAA,CAAcV,EAAa,QAAA,CAAU,CAAE,KAAA,CAAOO,CAAa,CAAA,CAAGJ,CAAQ,CACrF,CAiBO,SAASQ,CAAAA,EAA8B,CAC5C,IAAMC,CAAAA,CAAMC,aAAWb,CAAY,CAAA,CACnC,GAAI,CAACY,CAAAA,CACH,MAAM,IAAI,KAAA,CAAM,iEAAiE,CAAA,CAEnF,OAAOA,CACT,CA8CO,SAASE,CAAAA,CAAQpB,CAAAA,CAAaqB,CAAAA,CAAiB,KAAA,CAAsB,CAC1E,GAAM,CAAE,KAAA,CAAAC,CAAM,CAAA,CAAIL,CAAAA,EAAS,CAErB,CAACM,EAAQC,CAAS,CAAA,CAAIC,UAAAA,CAAsC,IACjDH,CAAAA,CAAM,SAAA,CAAUtB,CAAG,CAAA,GAAMqB,CAAAA,CACpC,CAAE,GAAA,CAAArB,CAAAA,CAAK,OAAA,CAASsB,EAAM,SAAA,CAAUtB,CAAG,CAAA,CAAG,QAAA,CAAU,EAAC,CAAG,OAAQ,iBAAA,CAA4B,OAAA,CAAS,CAAE,CAAA,CACnG,IAEL,CAAA,CAED,OAAAe,WAAAA,CAAU,IAAM,CAEd,IAAMW,CAAAA,CAAiBJ,CAAAA,CAAM,UAAUtB,CAAAA,CAAKqB,CAAc,CAAA,CAC1D,OAAIK,CAAAA,IAAoBH,CAAAA,EAAQ,SAAWF,CAAAA,CAAAA,EACzCG,CAAAA,CAAU,CACR,GAAA,CAAAxB,CAAAA,CACA,OAAA,CAAS0B,EACT,QAAA,CAAU,EAAC,CACX,MAAA,CAAQ,iBAAA,CACR,OAAA,CAAS,CACX,CAAC,CAAA,CAIiBJ,CAAAA,CAAM,YAAA,CAAatB,CAAAA,CAAM2B,CAAAA,EAAc,CACzDH,CAAAA,CAAUG,CAAS,EACrB,CAAC,CAIH,CAAA,CAAG,CAAC3B,CAAG,CAAC,CAAA,CAEDc,SAAAA,CACL,KAAO,CACL,QAASS,CAAAA,EAAQ,OAAA,EAAWD,CAAAA,CAAM,SAAA,CAAUtB,CAAAA,CAAKqB,CAAc,EAC/D,UAAA,CAAY,CAAcnB,CAAAA,CAAoB0B,CAAAA,GAC5CN,CAAAA,CAAM,UAAA,CAActB,EAAKE,CAAAA,CAAY0B,CAAG,CAAA,CAC1C,MAAA,CAAAL,CACF,CAAA,CAAA,CACA,CAACA,CAAAA,CAAQvB,CAAAA,CAAKsB,CAAAA,CAAOD,CAAc,CACrC,CACF","file":"react.cjs","sourcesContent":["/**\n * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.\n * @module @nexus/sdk/nexus\n */\n\nimport { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusFlagsOptions } from '@nexussdk/flags';\nimport { NexusTrackerClient } from '@nexussdk/tracker';\nimport type { NexusTrackerOptions } from '@nexussdk/tracker';\nimport type { UserContext } from '@nexussdk/contracts';\n\n/**\n * Unified initialization options for the Nexus SDK umbrella.\n *\n * @example\n * Nexus.init({\n * apiKey: 'pk_live_...',\n * baseUrl: 'http://localhost:8080',\n * user: { id: 'usr_12345', country: 'VN' },\n * environment: 'production',\n * autoCapture: true,\n * });\n */\nexport interface NexusInitOptions {\n /** Public API key. Resolved from env if omitted. */\n apiKey?: string;\n /** Base URL for all API calls. */\n baseUrl?: string;\n /** Initial user context for flag targeting and error attribution. */\n user?: UserContext;\n /** Target environment for telemetry routing. Defaults to 'production'. */\n environment?: string;\n /** Global tags attached to all telemetry events. */\n tags?: Record<string, string>;\n /** Toggle automated global error capture. Defaults to true. */\n autoCapture?: boolean;\n /** Additional flags-specific options. */\n flags?: Partial<NexusFlagsOptions>;\n /** Additional tracker-specific options. */\n tracker?: Partial<NexusTrackerOptions>;\n}\n\n/**\n * The Nexus singleton class — the primary unified entry point for the SDK.\n *\n * Provides access to both the feature flags client and the error tracker client.\n * Initialize once, then use throughout your application.\n *\n * @example\n * // Initialize (call once at app startup)\n * Nexus.init({ apiKey: 'pk_live_...' });\n *\n * // Feature flags\n * const showBanner = Nexus.isEnabled('promo_banner_v2', false);\n *\n * // Error tracking\n * Nexus.captureError(new Error('Something went wrong'));\n *\n * // Update user context\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\nexport class Nexus {\n private static instance: Nexus | null = null;\n\n /** The underlying feature flags client instance. */\n public readonly flags: NexusFlagsClient;\n /** The underlying error tracker client instance. */\n public readonly tracker: NexusTrackerClient;\n\n private constructor(options: NexusInitOptions = {}) {\n const { apiKey, baseUrl, user, environment, tags, autoCapture, flags: flagsOpts, tracker: trackerOpts } = options;\n\n this.flags = new NexusFlagsClient({\n apiKey,\n baseUrl,\n user,\n ...flagsOpts,\n });\n\n this.tracker = new NexusTrackerClient({\n apiKey,\n baseUrl,\n environment,\n tags,\n autoCapture,\n ...trackerOpts,\n });\n }\n\n /**\n * Initializes the Nexus SDK singleton.\n * Must be called before any other SDK methods.\n * Safe to call multiple times — returns existing instance after first init.\n *\n * @param options - SDK configuration options.\n * @returns The initialized Nexus singleton instance.\n *\n * @example\n * const nexus = Nexus.init({ apiKey: 'pk_live_...' });\n */\n public static init(options: NexusInitOptions = {}): Nexus {\n if (!Nexus.instance) {\n Nexus.instance = new Nexus(options);\n }\n return Nexus.instance;\n }\n\n /**\n * Returns the current Nexus singleton instance.\n *\n * @returns The active Nexus instance.\n * @throws {Error} If `Nexus.init()` has not been called yet.\n *\n * @example\n * const nexus = Nexus.getInstance();\n * nexus.flags.isEnabled('checkout_v2');\n */\n public static getInstance(): Nexus {\n if (!Nexus.instance) {\n throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: \"...\" }) first.');\n }\n return Nexus.instance;\n }\n\n /**\n * Convenience method: Check if a feature flag is enabled.\n *\n * @param key - Flag identifier.\n * @param defaultValue - Fallback if flag is missing.\n * @returns Boolean enabled state.\n *\n * @example\n * if (Nexus.isEnabled('checkout_redesign')) { ... }\n */\n public static isEnabled(key: string, defaultValue = false): boolean {\n return Nexus.getInstance().flags.isEnabled(key, defaultValue);\n }\n\n /**\n * Convenience method: Get a flag variant value.\n *\n * @param key - Flag identifier.\n * @param variantKey - Variant property name.\n * @param defaultValue - Fallback value.\n * @returns Variant value cast to type T.\n *\n * @example\n * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);\n */\n public static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T {\n return Nexus.getInstance().flags.getVariant<T>(key, variantKey, defaultValue);\n }\n\n /**\n * Convenience method: Capture an error manually.\n *\n * @param error - Error instance, string, or unknown value.\n * @param extra - Optional metadata tags.\n *\n * @example\n * Nexus.captureError(new TypeError('Cannot read properties of null'));\n */\n public static captureError(error: unknown, extra?: Record<string, unknown>): void {\n Nexus.getInstance().tracker.captureError(error, extra);\n }\n\n /**\n * Convenience method: Update user context for both flags and tracker.\n *\n * @param user - New user context (merged with existing).\n * @returns Promise resolving after flags refresh.\n *\n * @example\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\n public static async identify(user: UserContext): Promise<void> {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(user);\n await instance.flags.identify(user);\n }\n\n /**\n * Resets user context to anonymous state (e.g. on logout).\n *\n * @example\n * Nexus.reset(); // called on user logout\n */\n public static reset(): void {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(null);\n instance.flags.reset();\n }\n\n /**\n * Gracefully tears down both clients, closing SSE connections and flushing pending events.\n *\n * @example\n * await Nexus.destroy();\n */\n public static async destroy(): Promise<void> {\n if (Nexus.instance) {\n await Nexus.instance.tracker.flush();\n Nexus.instance.tracker.destroy();\n Nexus.instance.flags.destroy();\n Nexus.instance = null;\n }\n }\n}\n","'use client';\n\n/**\n * @fileoverview React Context Provider and hooks for the Nexus SDK umbrella.\n * @module @nexus/sdk/react\n */\n\nimport React, {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n} from 'react';\nimport { Nexus } from './nexus.js';\nimport type { NexusInitOptions } from './nexus.js';\nimport type { FlagEvaluationResult } from '@nexussdk/contracts';\nimport type { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusTrackerClient } from '@nexussdk/tracker';\n\n// ---------------------------------------------------------------------------\n// Context Definition\n// ---------------------------------------------------------------------------\n\ninterface NexusContextValue {\n flags: NexusFlagsClient;\n tracker: NexusTrackerClient;\n nexus: Nexus;\n}\n\nconst NexusContext = createContext<NexusContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\n/**\n * Props for the NexusProvider component.\n */\nexport interface NexusProviderProps extends NexusInitOptions {\n /** Child components that will have access to Nexus context. */\n children?: React.ReactNode | any;\n}\n\n/**\n * React Context Provider that initializes the Nexus SDK and makes it available\n * to all descendant components via `useFlag` and `useNexus` hooks.\n *\n * Mount once at the root of your application (e.g. in `layout.tsx`).\n *\n * @param props - Provider configuration options (see {@link NexusProviderProps}).\n * @returns Provider-wrapped children.\n *\n * @example\n * // app/layout.tsx\n * import { NexusProvider } from '@nexussdk/sdk/react';\n *\n * export default function RootLayout({ children }) {\n * return (\n * <html>\n * <body>\n * <NexusProvider apiKey={process.env.NEXT_PUBLIC_NEXUS_API_KEY}>\n * {children}\n * </NexusProvider>\n * </body>\n * </html>\n * );\n * }\n */\nexport function NexusProvider({ children, ...initOptions }: NexusProviderProps): React.ReactElement {\n const nexusRef = useRef<Nexus | null>(null);\n\n if (!nexusRef.current) {\n nexusRef.current = Nexus.init(initOptions);\n }\n\n const contextValue = useMemo<NexusContextValue>(\n () => ({\n flags: nexusRef.current!.flags,\n tracker: nexusRef.current!.tracker,\n nexus: nexusRef.current!,\n }),\n [],\n );\n\n useEffect(() => {\n return () => {\n void Nexus.destroy();\n };\n }, []);\n\n return React.createElement(NexusContext.Provider, { value: contextValue }, children);\n}\n\n// ---------------------------------------------------------------------------\n// Hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Returns the full Nexus SDK instance from context.\n *\n * @returns Object with `flags`, `tracker`, and `nexus` properties.\n * @throws {Error} If called outside of a `NexusProvider`.\n *\n * @example\n * const { flags, tracker } = useNexus();\n * const enabled = flags.isEnabled('checkout_v2');\n * tracker.captureError(new Error('something failed'));\n */\nexport function useNexus(): NexusContextValue {\n const ctx = useContext(NexusContext);\n if (!ctx) {\n throw new Error('[Nexus SDK] useNexus() must be called inside a <NexusProvider>.');\n }\n return ctx;\n}\n\n/**\n * Return value of the `useFlag` hook.\n */\nexport interface UseFlagResult {\n /** Whether the flag is currently enabled for the current user. */\n enabled: boolean;\n /**\n * Retrieves a specific variant value from this flag.\n *\n * @param variantKey - Property name inside the variants object.\n * @param defaultValue - Fallback if variant is not found.\n * @returns Typed variant value.\n *\n * @example\n * const { enabled, getVariant } = useFlag('promo_banner_v2');\n * const rate = getVariant<number>('discount_rate', 10);\n */\n getVariant: <T = unknown>(variantKey: string, defaultValue?: T) => T;\n /** Full evaluation result including reason and version. */\n result: FlagEvaluationResult | null;\n}\n\n/**\n * React hook for subscribing to a feature flag's real-time state.\n *\n * Automatically re-renders when the flag changes via SSE updates.\n * Returns a stable result without triggering additional re-renders if unchanged.\n *\n * @param key - Flag programmatic identifier.\n * @param defaultEnabled - Fallback boolean if flag is not yet evaluated. Defaults to false.\n * @returns {@link UseFlagResult} with `enabled`, `getVariant`, and `result`.\n *\n * @example\n * function CheckoutButton() {\n * const { enabled, getVariant } = useFlag('checkout_redesign');\n * const theme = getVariant<string>('theme', 'default');\n *\n * return (\n * <button className={enabled ? `btn-${theme}` : 'btn-default'}>\n * {enabled ? 'New Checkout' : 'Checkout'}\n * </button>\n * );\n * }\n */\nexport function useFlag(key: string, defaultEnabled = false): UseFlagResult {\n const { flags } = useNexus();\n\n const [result, setResult] = useState<FlagEvaluationResult | null>(() => {\n const cached = flags.isEnabled(key) !== defaultEnabled\n ? { key, enabled: flags.isEnabled(key), variants: {}, reason: 'DEFAULT_ENABLED' as const, version: 0 }\n : null;\n return cached;\n });\n\n useEffect(() => {\n // Get current state immediately\n const currentEnabled = flags.isEnabled(key, defaultEnabled);\n if (currentEnabled !== (result?.enabled ?? defaultEnabled)) {\n setResult({\n key,\n enabled: currentEnabled,\n variants: {},\n reason: 'DEFAULT_ENABLED',\n version: 0,\n });\n }\n\n // Subscribe to real-time updates\n const unsubscribe = flags.onFlagChange(key, (newResult) => {\n setResult(newResult);\n });\n\n return unsubscribe;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [key]);\n\n return useMemo(\n () => ({\n enabled: result?.enabled ?? flags.isEnabled(key, defaultEnabled),\n getVariant: <T = unknown>(variantKey: string, def?: T): T =>\n flags.getVariant<T>(key, variantKey, def),\n result,\n }),\n [result, key, flags, defaultEnabled],\n );\n}\n"]}
|
package/dist/react.mjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/nexus.ts","../src/react.tsx"],"names":["Nexus","_Nexus","options","apiKey","baseUrl","user","environment","tags","autoCapture","flagsOpts","trackerOpts","NexusFlagsClient","NexusTrackerClient","key","defaultValue","variantKey","error","extra","instance","NexusContext","createContext","NexusProvider","children","initOptions","nexusRef","useRef","contextValue","useMemo","useEffect","React","useNexus","ctx","useContext","useFlag","defaultEnabled","flags","result","setResult","useState","currentEnabled","newResult","def"],"mappings":"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","file":"react.mjs","sourcesContent":["/**\n * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.\n * @module @nexus/sdk/nexus\n */\n\nimport { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusFlagsOptions } from '@nexussdk/flags';\nimport { NexusTrackerClient } from '@nexussdk/tracker';\nimport type { NexusTrackerOptions } from '@nexussdk/tracker';\nimport type { UserContext } from '@nexussdk/contracts';\n\n/**\n * Unified initialization options for the Nexus SDK umbrella.\n *\n * @example\n * Nexus.init({\n * apiKey: 'pk_live_...',\n * baseUrl: 'http://localhost:8080',\n * user: { id: 'usr_12345', country: 'VN' },\n * environment: 'production',\n * autoCapture: true,\n * });\n */\nexport interface NexusInitOptions {\n /** Public API key. Resolved from env if omitted. */\n apiKey?: string;\n /** Base URL for all API calls. */\n baseUrl?: string;\n /** Initial user context for flag targeting and error attribution. */\n user?: UserContext;\n /** Target environment for telemetry routing. Defaults to 'production'. */\n environment?: string;\n /** Global tags attached to all telemetry events. */\n tags?: Record<string, string>;\n /** Toggle automated global error capture. Defaults to true. */\n autoCapture?: boolean;\n /** Additional flags-specific options. */\n flags?: Partial<NexusFlagsOptions>;\n /** Additional tracker-specific options. */\n tracker?: Partial<NexusTrackerOptions>;\n}\n\n/**\n * The Nexus singleton class — the primary unified entry point for the SDK.\n *\n * Provides access to both the feature flags client and the error tracker client.\n * Initialize once, then use throughout your application.\n *\n * @example\n * // Initialize (call once at app startup)\n * Nexus.init({ apiKey: 'pk_live_...' });\n *\n * // Feature flags\n * const showBanner = Nexus.isEnabled('promo_banner_v2', false);\n *\n * // Error tracking\n * Nexus.captureError(new Error('Something went wrong'));\n *\n * // Update user context\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\nexport class Nexus {\n private static instance: Nexus | null = null;\n\n /** The underlying feature flags client instance. */\n public readonly flags: NexusFlagsClient;\n /** The underlying error tracker client instance. */\n public readonly tracker: NexusTrackerClient;\n\n private constructor(options: NexusInitOptions = {}) {\n const { apiKey, baseUrl, user, environment, tags, autoCapture, flags: flagsOpts, tracker: trackerOpts } = options;\n\n this.flags = new NexusFlagsClient({\n apiKey,\n baseUrl,\n user,\n ...flagsOpts,\n });\n\n this.tracker = new NexusTrackerClient({\n apiKey,\n baseUrl,\n environment,\n tags,\n autoCapture,\n ...trackerOpts,\n });\n }\n\n /**\n * Initializes the Nexus SDK singleton.\n * Must be called before any other SDK methods.\n * Safe to call multiple times — returns existing instance after first init.\n *\n * @param options - SDK configuration options.\n * @returns The initialized Nexus singleton instance.\n *\n * @example\n * const nexus = Nexus.init({ apiKey: 'pk_live_...' });\n */\n public static init(options: NexusInitOptions = {}): Nexus {\n if (!Nexus.instance) {\n Nexus.instance = new Nexus(options);\n }\n return Nexus.instance;\n }\n\n /**\n * Returns the current Nexus singleton instance.\n *\n * @returns The active Nexus instance.\n * @throws {Error} If `Nexus.init()` has not been called yet.\n *\n * @example\n * const nexus = Nexus.getInstance();\n * nexus.flags.isEnabled('checkout_v2');\n */\n public static getInstance(): Nexus {\n if (!Nexus.instance) {\n throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: \"...\" }) first.');\n }\n return Nexus.instance;\n }\n\n /**\n * Convenience method: Check if a feature flag is enabled.\n *\n * @param key - Flag identifier.\n * @param defaultValue - Fallback if flag is missing.\n * @returns Boolean enabled state.\n *\n * @example\n * if (Nexus.isEnabled('checkout_redesign')) { ... }\n */\n public static isEnabled(key: string, defaultValue = false): boolean {\n return Nexus.getInstance().flags.isEnabled(key, defaultValue);\n }\n\n /**\n * Convenience method: Get a flag variant value.\n *\n * @param key - Flag identifier.\n * @param variantKey - Variant property name.\n * @param defaultValue - Fallback value.\n * @returns Variant value cast to type T.\n *\n * @example\n * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);\n */\n public static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T {\n return Nexus.getInstance().flags.getVariant<T>(key, variantKey, defaultValue);\n }\n\n /**\n * Convenience method: Capture an error manually.\n *\n * @param error - Error instance, string, or unknown value.\n * @param extra - Optional metadata tags.\n *\n * @example\n * Nexus.captureError(new TypeError('Cannot read properties of null'));\n */\n public static captureError(error: unknown, extra?: Record<string, unknown>): void {\n Nexus.getInstance().tracker.captureError(error, extra);\n }\n\n /**\n * Convenience method: Update user context for both flags and tracker.\n *\n * @param user - New user context (merged with existing).\n * @returns Promise resolving after flags refresh.\n *\n * @example\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\n public static async identify(user: UserContext): Promise<void> {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(user);\n await instance.flags.identify(user);\n }\n\n /**\n * Resets user context to anonymous state (e.g. on logout).\n *\n * @example\n * Nexus.reset(); // called on user logout\n */\n public static reset(): void {\n const instance = Nexus.getInstance();\n instance.tracker.setUser(null);\n instance.flags.reset();\n }\n\n /**\n * Gracefully tears down both clients, closing SSE connections and flushing pending events.\n *\n * @example\n * await Nexus.destroy();\n */\n public static async destroy(): Promise<void> {\n if (Nexus.instance) {\n await Nexus.instance.tracker.flush();\n Nexus.instance.tracker.destroy();\n Nexus.instance.flags.destroy();\n Nexus.instance = null;\n }\n }\n}\n","'use client';\n\n/**\n * @fileoverview React Context Provider and hooks for the Nexus SDK umbrella.\n * @module @nexus/sdk/react\n */\n\nimport React, {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n} from 'react';\nimport { Nexus } from './nexus.js';\nimport type { NexusInitOptions } from './nexus.js';\nimport type { FlagEvaluationResult } from '@nexussdk/contracts';\nimport type { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusTrackerClient } from '@nexussdk/tracker';\n\n// ---------------------------------------------------------------------------\n// Context Definition\n// ---------------------------------------------------------------------------\n\ninterface NexusContextValue {\n flags: NexusFlagsClient;\n tracker: NexusTrackerClient;\n nexus: Nexus;\n}\n\nconst NexusContext = createContext<NexusContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\n/**\n * Props for the NexusProvider component.\n */\nexport interface NexusProviderProps extends NexusInitOptions {\n /** Child components that will have access to Nexus context. */\n children?: React.ReactNode | any;\n}\n\n/**\n * React Context Provider that initializes the Nexus SDK and makes it available\n * to all descendant components via `useFlag` and `useNexus` hooks.\n *\n * Mount once at the root of your application (e.g. in `layout.tsx`).\n *\n * @param props - Provider configuration options (see {@link NexusProviderProps}).\n * @returns Provider-wrapped children.\n *\n * @example\n * // app/layout.tsx\n * import { NexusProvider } from '@nexussdk/sdk/react';\n *\n * export default function RootLayout({ children }) {\n * return (\n * <html>\n * <body>\n * <NexusProvider apiKey={process.env.NEXT_PUBLIC_NEXUS_API_KEY}>\n * {children}\n * </NexusProvider>\n * </body>\n * </html>\n * );\n * }\n */\nexport function NexusProvider({ children, ...initOptions }: NexusProviderProps): React.ReactElement {\n const nexusRef = useRef<Nexus | null>(null);\n\n if (!nexusRef.current) {\n nexusRef.current = Nexus.init(initOptions);\n }\n\n const contextValue = useMemo<NexusContextValue>(\n () => ({\n flags: nexusRef.current!.flags,\n tracker: nexusRef.current!.tracker,\n nexus: nexusRef.current!,\n }),\n [],\n );\n\n useEffect(() => {\n return () => {\n void Nexus.destroy();\n };\n }, []);\n\n return React.createElement(NexusContext.Provider, { value: contextValue }, children);\n}\n\n// ---------------------------------------------------------------------------\n// Hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Returns the full Nexus SDK instance from context.\n *\n * @returns Object with `flags`, `tracker`, and `nexus` properties.\n * @throws {Error} If called outside of a `NexusProvider`.\n *\n * @example\n * const { flags, tracker } = useNexus();\n * const enabled = flags.isEnabled('checkout_v2');\n * tracker.captureError(new Error('something failed'));\n */\nexport function useNexus(): NexusContextValue {\n const ctx = useContext(NexusContext);\n if (!ctx) {\n throw new Error('[Nexus SDK] useNexus() must be called inside a <NexusProvider>.');\n }\n return ctx;\n}\n\n/**\n * Return value of the `useFlag` hook.\n */\nexport interface UseFlagResult {\n /** Whether the flag is currently enabled for the current user. */\n enabled: boolean;\n /**\n * Retrieves a specific variant value from this flag.\n *\n * @param variantKey - Property name inside the variants object.\n * @param defaultValue - Fallback if variant is not found.\n * @returns Typed variant value.\n *\n * @example\n * const { enabled, getVariant } = useFlag('promo_banner_v2');\n * const rate = getVariant<number>('discount_rate', 10);\n */\n getVariant: <T = unknown>(variantKey: string, defaultValue?: T) => T;\n /** Full evaluation result including reason and version. */\n result: FlagEvaluationResult | null;\n}\n\n/**\n * React hook for subscribing to a feature flag's real-time state.\n *\n * Automatically re-renders when the flag changes via SSE updates.\n * Returns a stable result without triggering additional re-renders if unchanged.\n *\n * @param key - Flag programmatic identifier.\n * @param defaultEnabled - Fallback boolean if flag is not yet evaluated. Defaults to false.\n * @returns {@link UseFlagResult} with `enabled`, `getVariant`, and `result`.\n *\n * @example\n * function CheckoutButton() {\n * const { enabled, getVariant } = useFlag('checkout_redesign');\n * const theme = getVariant<string>('theme', 'default');\n *\n * return (\n * <button className={enabled ? `btn-${theme}` : 'btn-default'}>\n * {enabled ? 'New Checkout' : 'Checkout'}\n * </button>\n * );\n * }\n */\nexport function useFlag(key: string, defaultEnabled = false): UseFlagResult {\n const { flags } = useNexus();\n\n const [result, setResult] = useState<FlagEvaluationResult | null>(() => {\n const cached = flags.isEnabled(key) !== defaultEnabled\n ? { key, enabled: flags.isEnabled(key), variants: {}, reason: 'DEFAULT_ENABLED' as const, version: 0 }\n : null;\n return cached;\n });\n\n useEffect(() => {\n // Get current state immediately\n const currentEnabled = flags.isEnabled(key, defaultEnabled);\n if (currentEnabled !== (result?.enabled ?? defaultEnabled)) {\n setResult({\n key,\n enabled: currentEnabled,\n variants: {},\n reason: 'DEFAULT_ENABLED',\n version: 0,\n });\n }\n\n // Subscribe to real-time updates\n const unsubscribe = flags.onFlagChange(key, (newResult) => {\n setResult(newResult);\n });\n\n return unsubscribe;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [key]);\n\n return useMemo(\n () => ({\n enabled: result?.enabled ?? flags.isEnabled(key, defaultEnabled),\n getVariant: <T = unknown>(variantKey: string, def?: T): T =>\n flags.getVariant<T>(key, variantKey, def),\n result,\n }),\n [result, key, flags, defaultEnabled],\n );\n}\n"]}
|
package/src/index.ts
DELETED
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @fileoverview Main entry point for @nexussdk/sdk umbrella package.
|
|
3
|
-
* Exports the unified Nexus singleton and all sub-package types.
|
|
4
|
-
*
|
|
5
|
-
* @example
|
|
6
|
-
* import { Nexus } from '@nexussdk/sdk';
|
|
7
|
-
* import { NexusProvider, useFlag } from '@nexussdk/sdk/react';
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
export { Nexus } from './nexus.js';
|
|
11
|
-
export type { NexusInitOptions } from './nexus.js';
|
|
12
|
-
|
|
13
|
-
// Re-export SDK sub-packages for direct access
|
|
14
|
-
export { NexusFlagsClient } from '@nexussdk/flags';
|
|
15
|
-
export type { NexusFlagsOptions, INexusFlagsClient } from '@nexussdk/flags';
|
|
16
|
-
|
|
17
|
-
export { NexusTrackerClient } from '@nexussdk/tracker';
|
|
18
|
-
export type { NexusTrackerOptions, INexusTrackerClient } from '@nexussdk/tracker';
|
|
19
|
-
|
|
20
|
-
// Re-export core contracts for consumer convenience
|
|
21
|
-
export type {
|
|
22
|
-
FeatureFlag,
|
|
23
|
-
FlagEvaluationResult,
|
|
24
|
-
UserContext,
|
|
25
|
-
ErrorEventPayload,
|
|
26
|
-
ProblemDetails,
|
|
27
|
-
} from '@nexussdk/contracts';
|