@withgateway/sdk 0.1.3 → 0.1.5

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.
Files changed (49) hide show
  1. package/dist/context/index.mjs +3 -0
  2. package/dist/context/index.mjs.map +1 -1
  3. package/dist/experiments/index.mjs +2 -0
  4. package/dist/experiments/index.mjs.map +1 -1
  5. package/dist/index-DnowA8MG.d.mts +447 -0
  6. package/dist/index-DnowA8MG.d.ts +447 -0
  7. package/dist/index.d.mts +6 -1
  8. package/dist/index.d.ts +6 -1
  9. package/dist/index.js +1715 -20
  10. package/dist/index.js.map +1 -1
  11. package/dist/index.mjs +1686 -19
  12. package/dist/index.mjs.map +1 -1
  13. package/dist/memory/index.mjs +3 -0
  14. package/dist/memory/index.mjs.map +1 -1
  15. package/dist/personas/index.d.mts +102 -0
  16. package/dist/personas/index.d.ts +102 -0
  17. package/dist/personas/index.js +205 -0
  18. package/dist/personas/index.js.map +1 -0
  19. package/dist/personas/index.mjs +180 -0
  20. package/dist/personas/index.mjs.map +1 -0
  21. package/dist/replay/index.d.mts +351 -0
  22. package/dist/replay/index.d.ts +351 -0
  23. package/dist/replay/index.js +1094 -0
  24. package/dist/replay/index.js.map +1 -0
  25. package/dist/replay/index.mjs +1057 -0
  26. package/dist/replay/index.mjs.map +1 -0
  27. package/dist/security/index.mjs +2 -0
  28. package/dist/security/index.mjs.map +1 -1
  29. package/dist/sessions/index.d.mts +143 -0
  30. package/dist/sessions/index.d.ts +143 -0
  31. package/dist/sessions/index.js +320 -0
  32. package/dist/sessions/index.js.map +1 -0
  33. package/dist/sessions/index.mjs +288 -0
  34. package/dist/sessions/index.mjs.map +1 -0
  35. package/dist/tracing/index.d.mts +3 -1
  36. package/dist/tracing/index.d.ts +3 -1
  37. package/dist/tracing/index.js +435 -8
  38. package/dist/tracing/index.js.map +1 -1
  39. package/dist/tracing/index.mjs +431 -8
  40. package/dist/tracing/index.mjs.map +1 -1
  41. package/dist/users/index.d.mts +81 -0
  42. package/dist/users/index.d.ts +81 -0
  43. package/dist/users/index.js +168 -0
  44. package/dist/users/index.js.map +1 -0
  45. package/dist/users/index.mjs +144 -0
  46. package/dist/users/index.mjs.map +1 -0
  47. package/package.json +25 -1
  48. package/dist/index-Caw3XVub.d.mts +0 -193
  49. package/dist/index-Caw3XVub.d.ts +0 -193
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/tracing/index.ts","../../src/tracing/init.ts"],"sourcesContent":["/**\n * Tracing module for GatewaySDK TypeScript SDK.\n *\n * Provides a simple init() function that configures OpenTelemetry with\n * Gateway, mirroring the Python SDK's tracing.init() experience.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Initialize with environment variables\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * });\n *\n * // Ensure cleanup on shutdown\n * process.on(\"SIGTERM\", () => tracing.shutdown());\n * ```\n */\n\nexport type { TracingConfig, TracingState } from \"./types\";\n\nexport {\n init,\n shutdown,\n flush,\n isInitialized,\n isGatewayConfigured,\n} from \"./init\";\n","/**\n * Initialization and lifecycle management for GatewaySDK tracing.\n *\n * This module provides the core init(), shutdown(), and flush() functions\n * for managing the OpenTelemetry TracerProvider lifecycle.\n *\n * Mirrors the Python SDK's tracing.init() for a consistent developer experience.\n */\n\nimport type { TracingConfig, TracingState } from \"./types\";\n\n// Environment variable names (support both GATEWAY_* and GATEWAY_* prefixes)\nconst ENV_VARS = {\n HOST: [\"GATEWAY_HOST\", \"GATEWAY_HOST\"],\n PUBLIC_KEY: [\"GATEWAY_PUBLIC_KEY\", \"GATEWAY_PUBLIC_KEY\"],\n SECRET_KEY: [\"GATEWAY_SECRET_KEY\", \"GATEWAY_SECRET_KEY\"],\n ENDPOINT: [\"GATEWAY_OTLP_ENDPOINT\", \"GATEWAY_OTLP_ENDPOINT\"],\n} as const;\n\nconst DEFAULT_OTLP_PATH = \"/api/public/otel/v1/traces\";\n\n// Module-level state\nconst state: TracingState & { debug?: boolean } = {\n initialized: false,\n provider: null,\n};\n\nfunction getEnv(keys: readonly string[]): string | undefined {\n for (const key of keys) {\n const value = process.env[key];\n if (value) return value;\n }\n return undefined;\n}\n\nfunction log(message: string, ...args: unknown[]): void {\n if (state.debug) {\n console.log(`[gatewaysdk.tracing] ${message}`, ...args);\n }\n}\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\n/**\n * Initialize GatewaySDK tracing with automatic OpenTelemetry configuration.\n *\n * This function configures OpenTelemetry with a connection to Gateway\n * and sets up the ExperimentSpanProcessor for automatic experiment tagging.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Using environment variables (GATEWAY_HOST, GATEWAY_PUBLIC_KEY, GATEWAY_SECRET_KEY)\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * serviceName: \"my-agent\",\n * environment: \"production\",\n * });\n * ```\n */\nexport function init(config: TracingConfig = {}): void {\n if (state.initialized) {\n log(\"Tracing already initialized. Call shutdown() first to reinitialize.\");\n return;\n }\n\n // Store debug flag in state for log() function\n state.debug = config.debug ?? false;\n\n // Resolve configuration from params or environment\n const host = config.host ?? getEnv(ENV_VARS.HOST);\n const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);\n const endpoint =\n config.endpoint ??\n getEnv(ENV_VARS.ENDPOINT) ??\n (host ? `${host.replace(/\\/$/, \"\")}${DEFAULT_OTLP_PATH}` : undefined);\n\n // Validate required configuration\n const missing: string[] = [];\n if (!host) missing.push(\"host (or GATEWAY_HOST env var)\");\n if (!publicKey) missing.push(\"publicKey (or GATEWAY_PUBLIC_KEY env var)\");\n if (!secretKey) missing.push(\"secretKey (or GATEWAY_SECRET_KEY env var)\");\n\n if (missing.length > 0) {\n throw new Error(\n `Missing required Gateway configuration: ${missing.join(\", \")}. ` +\n \"Provide these values via init() parameters or environment variables.\",\n );\n }\n\n // Dynamically import OpenTelemetry modules (they're peer dependencies)\n // Using 'any' to avoid version conflicts between OTel packages\n /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n let NodeTracerProvider: any;\n let BatchSpanProcessor: any;\n let OTLPTraceExporter: any;\n let createResource: (attrs: Record<string, string>) => any;\n let ATTR_SERVICE_NAME: string;\n\n try {\n const traceNode = require(\"@opentelemetry/sdk-trace-node\");\n const traceBase = require(\"@opentelemetry/sdk-trace-base\");\n const otlpHttp = require(\"@opentelemetry/exporter-trace-otlp-http\");\n const resources = require(\"@opentelemetry/resources\");\n\n NodeTracerProvider = traceNode.NodeTracerProvider;\n BatchSpanProcessor = traceBase.BatchSpanProcessor;\n OTLPTraceExporter = otlpHttp.OTLPTraceExporter;\n\n // Handle both old (Resource class) and new (resourceFromAttributes function) APIs\n if (resources.Resource) {\n createResource = (attrs) => new resources.Resource(attrs);\n } else if (resources.resourceFromAttributes) {\n createResource = resources.resourceFromAttributes;\n } else {\n createResource = () => resources.defaultResource();\n }\n\n // Try semantic conventions, fall back to string literal\n try {\n const semconv = require(\"@opentelemetry/semantic-conventions\");\n ATTR_SERVICE_NAME =\n semconv.ATTR_SERVICE_NAME ?? semconv.SEMRESATTRS_SERVICE_NAME ?? \"service.name\";\n } catch {\n ATTR_SERVICE_NAME = \"service.name\";\n }\n } catch {\n throw new Error(\n \"OpenTelemetry packages not found. Install them with:\\n\" +\n \"npm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base \" +\n \"@opentelemetry/exporter-trace-otlp-http @opentelemetry/resources\",\n );\n }\n\n // Build resource attributes\n const resourceAttrs: Record<string, string> = {\n [ATTR_SERVICE_NAME]: config.serviceName ?? \"gatewaysdk-tracing\",\n };\n if (config.environment) {\n resourceAttrs[\"gateway.environment\"] = config.environment;\n }\n if (config.version) {\n resourceAttrs[\"gateway.version\"] = config.version;\n }\n\n // Security check: block insecure HTTP (except localhost/127.0.0.1)\n let isLocalhost = false;\n if (endpoint) {\n try {\n const parsed = new URL(endpoint);\n isLocalhost =\n parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\";\n } catch {\n isLocalhost = false;\n }\n }\n if (endpoint && !endpoint.startsWith(\"https://\") && !isLocalhost) {\n throw new Error(\n `Refusing to send credentials over insecure HTTP to ${endpoint}. ` +\n \"Use HTTPS or localhost for development.\",\n );\n }\n\n // Construct Basic Auth header\n const credentials = `${publicKey}:${secretKey}`;\n const encoded = Buffer.from(credentials).toString(\"base64\");\n const authHeader = `Basic ${encoded}`;\n\n // Create OTLP exporter\n const exporter = new OTLPTraceExporter({\n url: endpoint,\n headers: {\n Authorization: authHeader,\n },\n });\n\n log(\"Configured Gateway exporter: endpoint=%s\", endpoint);\n\n // Build span processors — custom processors go first (before the BatchSpanProcessor)\n const spanProcessors: any[] = [];\n\n if (config.customSpanProcessors) {\n for (const sp of config.customSpanProcessors) {\n spanProcessors.push(sp);\n log(\n \"Added custom span processor: %s\",\n (sp as { constructor?: { name?: string } }).constructor?.name ??\n \"unknown\",\n );\n }\n }\n\n // Add BatchSpanProcessor with exporter\n const batchConfig: Record<string, number> = {};\n if (config.batch?.maxQueueSize) {\n batchConfig.maxQueueSize = config.batch.maxQueueSize;\n }\n if (config.batch?.scheduledDelayMillis) {\n batchConfig.scheduledDelayMillis = config.batch.scheduledDelayMillis;\n }\n if (config.batch?.maxExportBatchSize) {\n batchConfig.maxExportBatchSize = config.batch.maxExportBatchSize;\n }\n\n spanProcessors.push(new BatchSpanProcessor(exporter, batchConfig));\n\n // Create provider — detect v1 vs v2 API via runtime feature check.\n // v1 has addSpanProcessor(); v2 removed it and requires spanProcessors in constructor.\n let provider: any = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n });\n\n if (typeof provider.addSpanProcessor === \"function\") {\n // v1 API: register each processor individually\n for (const sp of spanProcessors) {\n provider.addSpanProcessor(sp);\n }\n } else {\n // v2 API: must pass spanProcessors in constructor — recreate\n provider = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n spanProcessors,\n });\n }\n\n provider.register();\n\n state.provider = provider;\n state.initialized = true;\n /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\n log(\n \"GatewaySDK tracing initialized successfully (service=%s)\",\n config.serviceName ?? \"gatewaysdk-tracing\",\n );\n}\n\n/**\n * Force flush all pending spans without shutting down.\n *\n * Useful for ensuring spans are exported at specific points\n * (e.g., after completing a batch of work) without ending the tracing session.\n *\n * @returns Promise that resolves when flush completes\n */\nexport async function flush(): Promise<void> {\n if (!state.provider) {\n log(\"No provider to flush\");\n return;\n }\n\n try {\n await (state.provider as { forceFlush: () => Promise<void> }).forceFlush();\n log(\"Flush completed successfully\");\n } catch (e) {\n warn(\"Error during flush:\", e);\n }\n}\n\n/**\n * Force flush all pending spans and shutdown the tracer provider.\n *\n * This function should be called before process exit to ensure all spans\n * are exported. It is safe to call multiple times.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * tracing.init();\n *\n * // On shutdown\n * process.on(\"SIGTERM\", async () => {\n * await tracing.shutdown();\n * process.exit(0);\n * });\n * ```\n */\nexport async function shutdown(): Promise<void> {\n if (!state.initialized || !state.provider) {\n log(\"Tracing not initialized, nothing to shutdown\");\n return;\n }\n\n try {\n await (state.provider as { shutdown: () => Promise<void> }).shutdown();\n log(\"Shutdown complete\");\n } catch (e) {\n warn(\"Error during shutdown:\", e);\n }\n\n state.provider = null;\n state.initialized = false;\n}\n\n/**\n * Check if tracing has been initialized.\n */\nexport function isInitialized(): boolean {\n return state.initialized;\n}\n\n/**\n * Check if Gateway is configured via environment variables.\n */\nexport function isGatewayConfigured(): boolean {\n const host = getEnv(ENV_VARS.HOST);\n const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = getEnv(ENV_VARS.SECRET_KEY);\n return !!(host && publicKey && secretKey);\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/tracing/index.ts","../../src/tracing/identity.ts","../../src/users/index.ts","../../src/tracing/init.ts","../../src/tracing/observe.ts","../../src/tracing/instrument.ts","../../src/tracing/claude.ts"],"sourcesContent":["/**\n * Tracing module for GatewaySDK TypeScript SDK.\n *\n * Provides a simple init() function that configures OpenTelemetry with\n * Gateway, mirroring the Python SDK's tracing.init() experience.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Initialize with environment variables\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * });\n *\n * // Ensure cleanup on shutdown\n * process.on(\"SIGTERM\", () => tracing.shutdown());\n * ```\n */\n\nexport type { TracingConfig, TracingState } from \"./types\";\n\nexport {\n init,\n initIsolated,\n shutdown,\n flush,\n isInitialized,\n isGatewayConfigured,\n} from \"./init\";\nexport type { TracingHandle } from \"./init\";\n\nexport {\n identify,\n resolveUserId,\n resetAmbientUser,\n IdentitySpanProcessor,\n USER_ID_ATTRIBUTE,\n} from \"./identity\";\nexport type { IdentifyOptions } from \"./identity\";\n\nexport { observe } from \"./observe\";\nexport type { ObserveOptions, ObservationKind } from \"./observe\";\n\nexport { observeOpenAI, observeAnthropic } from \"./instrument\";\n\nexport { observeClaude } from \"./claude\";\nexport type { ObserveClaudeOptions } from \"./claude\";\n","/**\n * End-user identity for GatewaySDK tracing.\n *\n * Mirrors the Python SDK's `gatewaysdk.tracing.identity` user half:\n *\n * - The ambient user is set via `identify()` and stored in an\n * AsyncLocalStorage (the TS analogue of Python's ContextVar), so\n * concurrent requests serving different users never bleed into each other.\n * - `IdentitySpanProcessor` (registered by `tracing.init()`) stamps the\n * ambient user on every span at start, so everything traced after\n * `identify()` is attributed automatically — the same seam as Python's\n * `TracingContextSpanProcessor` and this SDK's `ExperimentSpanProcessor`.\n * - `identify()` also stamps the currently open span directly, because\n * ingestion treats `gateway.user.id` on ANY span as a trace-level update —\n * the in-flight trace is attributed immediately.\n */\n\nimport { AsyncLocalStorage } from \"async_hooks\";\nimport { isSpanContextValid, trace } from \"@opentelemetry/api\";\nimport type { Context } from \"@opentelemetry/api\";\nimport type {\n ReadableSpan,\n Span,\n SpanProcessor,\n} from \"@opentelemetry/sdk-trace-base\";\nimport { UsersClient } from \"../users/index\";\n\nexport const USER_ID_ATTRIBUTE = \"gateway.user.id\";\n\n// Per-async-context user identity set via identify() — AsyncLocalStorage so\n// concurrent requests serving different users never bleed into each other.\nconst currentUserStorage = new AsyncLocalStorage<string>();\n\n/**\n * The active end-user id: identify() context > GATEWAY_USER_ID env.\n *\n * Per-request user attribution (e.g. from auth middleware) can also override\n * per span by setting the `gateway.user.id` attribute directly — explicit\n * set wins over the ambient default stamped at span start.\n */\nexport function resolveUserId(): string | undefined {\n const contextual = currentUserStorage.getStore();\n if (contextual) return contextual;\n const envUser = process.env.GATEWAY_USER_ID?.trim();\n return envUser ? envUser : undefined;\n}\n\nexport interface IdentifyOptions {\n /** Profile attributes to merge into the user's stored profile. */\n attributes?: Record<string, string | number | boolean>;\n displayName?: string;\n email?: string;\n}\n\n/**\n * Attribute everything that follows (and the current trace) to a user.\n *\n * - Sets the user for all spans started in this async context, and stamps\n * the currently open span so the in-flight trace is attributed immediately.\n * - When `attributes`/`displayName`/`email` are given, the user's platform\n * profile is updated in the background (attributes merge with what's\n * stored — ideal for incremental ROI facts like plan or account_value).\n * Requires GATEWAY_HOST/GATEWAY_PUBLIC_KEY/GATEWAY_SECRET_KEY for the\n * profile update; tracing attribution works without them. Failures are\n * swallowed (debug-logged) and never produce unhandled rejections.\n *\n * @example\n * ```typescript\n * import { identify } from \"@withgateway/sdk\";\n *\n * identify(\"user-123\", {\n * attributes: { plan: \"enterprise\", account_value: \"48000\" },\n * });\n * ```\n */\nexport function identify(userId: string, options: IdentifyOptions = {}): void {\n const cleaned = userId.trim();\n if (!cleaned) return;\n\n currentUserStorage.enterWith(cleaned);\n\n // Stamp the open span so the in-flight trace is upserted with the user —\n // ingestion treats user.id on ANY span as a trace-level update.\n try {\n const span = trace.getActiveSpan();\n if (span && isSpanContextValid(span.spanContext())) {\n span.setAttribute(USER_ID_ATTRIBUTE, cleaned);\n }\n } catch (error) {\n debugLog(\"identify(): no active span to stamp\", error);\n }\n\n if (options.attributes || options.displayName || options.email) {\n void pushProfile(cleaned, options);\n }\n}\n\nasync function pushProfile(\n userId: string,\n options: IdentifyOptions,\n): Promise<void> {\n try {\n const attributes: Record<string, string> = {};\n for (const [key, value] of Object.entries(options.attributes ?? {})) {\n attributes[key] = String(value);\n }\n await UsersClient.fromEnv().update(userId, {\n ...(options.displayName !== undefined\n ? { displayName: options.displayName }\n : {}),\n ...(options.email !== undefined ? { email: options.email } : {}),\n attributes,\n });\n } catch (error) {\n debugLog(\"identify(): profile update failed\", error);\n }\n}\n\n/** Testing hook: clear the ambient user for the current async context. */\nexport function resetAmbientUser(): void {\n currentUserStorage.enterWith(undefined as unknown as string);\n}\n\n/**\n * Stamps the ambient end-user identity (identify() context or\n * GATEWAY_USER_ID env) on every span at start. Registered automatically by\n * `tracing.init()`. Explicit `setAttribute` calls after span start win over\n * this ambient default.\n */\nexport class IdentitySpanProcessor implements SpanProcessor {\n onStart(span: Span, _parentContext: Context): void {\n const userId = resolveUserId();\n if (userId) {\n span.setAttribute(USER_ID_ATTRIBUTE, userId);\n }\n }\n\n onEnd(_span: ReadableSpan): void {}\n\n async shutdown(): Promise<void> {}\n\n async forceFlush(): Promise<void> {}\n}\n\nfunction debugLog(message: string, ...args: unknown[]): void {\n if (process.env.GATEWAY_DEBUG) {\n console.debug(`[gatewaysdk.tracing] ${message}`, ...args);\n }\n}\n","/**\n * End-user profiles — attribute usage and ROI to the real people behind\n * your agent's traffic.\n *\n * Profiles pair with the platform's per-user usage metrics (traces, tokens,\n * lifetime cost) on the Users page. Attributes merge by default, so pushing\n * an incremental ROI fact is one call:\n *\n * ```typescript\n * import { UsersClient } from \"@withgateway/sdk/users\";\n *\n * const users = UsersClient.fromEnv();\n * await users.update(\"user-123\", {\n * displayName: \"Acme Corp — Jane D.\",\n * attributes: { plan: \"enterprise\", account_value: \"48000\" },\n * });\n * ```\n *\n * Tip: `identify(\"user-123\", { attributes: {...} })` does this in the\n * background AND attributes the current trace/session to the user.\n *\n * Mirrors the Python SDK's `gatewaysdk.users` module.\n */\n\ntype UserProfile = {\n userId: string;\n displayName: string | null;\n email: string | null;\n attributes: Record<string, string>;\n notes: string | null;\n};\n\ntype UserProfileUpdate = {\n displayName?: string;\n email?: string;\n attributes?: Record<string, string>;\n notes?: string;\n /**\n * Attributes merge with the stored set by default. Set `merge: false`\n * to replace the stored attributes wholesale.\n */\n merge?: boolean;\n};\n\ntype UsersClientConfig = {\n host: string;\n publicKey: string;\n secretKey: string;\n timeoutSeconds?: number;\n debug?: boolean;\n};\n\ntype UsersClientFromEnvConfig = Partial<UsersClientConfig>;\n\n/** Raised when the Gateway user-profiles API cannot complete a request. */\nexport class UserProfileError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = \"UserProfileError\";\n this.cause = options?.cause;\n }\n}\n\n/** Client for Gateway's end-user profile endpoints (Basic project keys). */\nexport class UsersClient {\n private readonly host: string;\n private readonly publicKey: string;\n private readonly secretKey: string;\n private readonly timeoutSeconds: number;\n private readonly debug: boolean;\n\n constructor(config: UsersClientConfig) {\n this.host = config.host.replace(/\\/$/, \"\");\n this.publicKey = config.publicKey;\n this.secretKey = config.secretKey;\n this.timeoutSeconds = config.timeoutSeconds ?? 15;\n this.debug = config.debug ?? false;\n }\n\n /** Create a client from GATEWAY_HOST / GATEWAY_PUBLIC_KEY / GATEWAY_SECRET_KEY. */\n static fromEnv(config: UsersClientFromEnvConfig = {}) {\n const host = config.host ?? process.env.GATEWAY_HOST;\n const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;\n const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;\n\n const missing = [\n [\"host\", host],\n [\"publicKey\", publicKey],\n [\"secretKey\", secretKey],\n ]\n .filter(([, value]) => !value)\n .map(([name]) => name);\n\n if (missing.length > 0) {\n throw new UserProfileError(\n `Missing Gateway user-profile configuration: ${missing.join(\", \")}`,\n );\n }\n\n return new UsersClient({\n ...config,\n host: host!,\n publicKey: publicKey!,\n secretKey: secretKey!,\n });\n }\n\n /** Fetch a user's stored profile. */\n async get(userId: string): Promise<UserProfile> {\n return parseProfile(\n await this.requestJson(\n \"GET\",\n `/api/public/user-profiles/${encodeURIComponent(userId)}`,\n ),\n );\n }\n\n /**\n * Upsert a user's profile. `attributes` merge with the stored set unless\n * `merge: false` (which replaces it).\n */\n async update(\n userId: string,\n update: UserProfileUpdate = {},\n ): Promise<UserProfile> {\n const body: Record<string, unknown> = {\n userId,\n attributes: update.attributes ?? {},\n mergeAttributes: update.merge ?? true,\n ...(update.displayName !== undefined\n ? { displayName: update.displayName }\n : {}),\n ...(update.email !== undefined ? { email: update.email } : {}),\n ...(update.notes !== undefined ? { notes: update.notes } : {}),\n };\n return parseProfile(\n await this.requestJson(\"POST\", \"/api/public/user-profiles\", body),\n );\n }\n\n private async requestJson(\n method: \"GET\" | \"POST\",\n path: string,\n payload?: Record<string, unknown>,\n ): Promise<Record<string, unknown>> {\n let response: Response;\n try {\n response = await fetch(`${this.host}${path}`, {\n method,\n headers: {\n Authorization: this.authHeader(),\n \"Content-Type\": \"application/json\",\n },\n ...(payload ? { body: JSON.stringify(payload) } : {}),\n signal: AbortSignal.timeout(this.timeoutSeconds * 1000),\n });\n } catch (error) {\n throw new UserProfileError(\n `${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`,\n { cause: error },\n );\n }\n\n const text = await response.text();\n if (!response.ok) {\n throw new UserProfileError(\n `${method} ${path} failed (${response.status}): ${text.slice(0, 500)}`,\n );\n }\n\n this.log(\"%s %s -> %s\", method, path, response.status);\n return safeJson(text);\n }\n\n private authHeader() {\n return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(\n \"base64\",\n )}`;\n }\n\n private log(message: string, ...args: unknown[]) {\n if (this.debug) {\n console.log(`[gateway.users] ${message}`, ...args);\n }\n }\n}\n\nfunction parseProfile(payload: Record<string, unknown>): UserProfile {\n return {\n userId: String(payload.userId ?? \"\"),\n displayName:\n typeof payload.displayName === \"string\" ? payload.displayName : null,\n email: typeof payload.email === \"string\" ? payload.email : null,\n attributes: parseAttributes(payload.attributes),\n notes: typeof payload.notes === \"string\" ? payload.notes : null,\n };\n}\n\nfunction parseAttributes(value: unknown): Record<string, string> {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return {};\n const attributes: Record<string, string> = {};\n for (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n attributes[key] = String(entry);\n }\n return attributes;\n}\n\nfunction safeJson(value: string): Record<string, unknown> {\n try {\n const parsed = JSON.parse(value);\n return parsed && typeof parsed === \"object\" && !Array.isArray(parsed)\n ? (parsed as Record<string, unknown>)\n : {};\n } catch {\n return {};\n }\n}\n\nexport const users = {\n fromEnv: UsersClient.fromEnv,\n};\n\nexport type {\n UserProfile,\n UserProfileUpdate,\n UsersClientConfig,\n UsersClientFromEnvConfig,\n};\n","/**\n * Initialization and lifecycle management for GatewaySDK tracing.\n *\n * This module provides the core init(), shutdown(), and flush() functions\n * for managing the OpenTelemetry TracerProvider lifecycle, plus\n * initIsolated() for creating additional self-contained providers (e.g. one\n * process exporting different agents to different Gateway projects).\n *\n * Mirrors the Python SDK's tracing.init() for a consistent developer experience.\n */\n\nimport type { Tracer } from \"@opentelemetry/api\";\nimport type { TracingConfig, TracingState } from \"./types\";\nimport { IdentitySpanProcessor } from \"./identity\";\n\n// Environment variable names (support both GATEWAY_* and GATEWAY_* prefixes)\nconst ENV_VARS = {\n HOST: [\"GATEWAY_HOST\", \"GATEWAY_HOST\"],\n PUBLIC_KEY: [\"GATEWAY_PUBLIC_KEY\", \"GATEWAY_PUBLIC_KEY\"],\n SECRET_KEY: [\"GATEWAY_SECRET_KEY\", \"GATEWAY_SECRET_KEY\"],\n ENDPOINT: [\"GATEWAY_OTLP_ENDPOINT\", \"GATEWAY_OTLP_ENDPOINT\"],\n} as const;\n\nconst DEFAULT_OTLP_PATH = \"/api/public/otel/v1/traces\";\n\n// Module-level state\nconst state: TracingState & { debug?: boolean } = {\n initialized: false,\n provider: null,\n};\n\nfunction getEnv(keys: readonly string[]): string | undefined {\n for (const key of keys) {\n const value = process.env[key];\n if (value) return value;\n }\n return undefined;\n}\n\nfunction log(message: string, ...args: unknown[]): void {\n if (state.debug) {\n console.log(`[gatewaysdk.tracing] ${message}`, ...args);\n }\n}\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\ntype LogFn = (message: string, ...args: unknown[]) => void;\n\n/**\n * Handle to an isolated tracing provider created by initIsolated().\n * Spans started from `tracer` export to that provider's Gateway project;\n * the global tracer (from init()) is untouched.\n */\nexport interface TracingHandle {\n tracer: Tracer;\n /** Force-flush pending spans for this provider only. */\n flush(): Promise<void>;\n /** Flush and shut down this provider only. */\n shutdown(): Promise<void>;\n}\n\n/**\n * Build a fully-configured NodeTracerProvider from config + env. Shared by\n * init() (which registers it globally) and initIsolated() (which does not).\n */\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\nfunction buildProvider(config: TracingConfig, logFn: LogFn): any {\n // Resolve configuration from params or environment\n const host = config.host ?? getEnv(ENV_VARS.HOST);\n const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);\n const endpoint =\n config.endpoint ??\n getEnv(ENV_VARS.ENDPOINT) ??\n (host ? `${host.replace(/\\/$/, \"\")}${DEFAULT_OTLP_PATH}` : undefined);\n\n // Validate required configuration\n const missing: string[] = [];\n if (!host) missing.push(\"host (or GATEWAY_HOST env var)\");\n if (!publicKey) missing.push(\"publicKey (or GATEWAY_PUBLIC_KEY env var)\");\n if (!secretKey) missing.push(\"secretKey (or GATEWAY_SECRET_KEY env var)\");\n\n if (missing.length > 0) {\n throw new Error(\n `Missing required Gateway configuration: ${missing.join(\", \")}. ` +\n \"Provide these values via init() parameters or environment variables.\",\n );\n }\n\n // Dynamically import OpenTelemetry modules (they're peer dependencies)\n // Using 'any' to avoid version conflicts between OTel packages\n let NodeTracerProvider: any;\n let BatchSpanProcessor: any;\n let OTLPTraceExporter: any;\n let createResource: (attrs: Record<string, string>) => any;\n let ATTR_SERVICE_NAME: string;\n\n try {\n const traceNode = require(\"@opentelemetry/sdk-trace-node\");\n const traceBase = require(\"@opentelemetry/sdk-trace-base\");\n const otlpHttp = require(\"@opentelemetry/exporter-trace-otlp-http\");\n const resources = require(\"@opentelemetry/resources\");\n\n NodeTracerProvider = traceNode.NodeTracerProvider;\n BatchSpanProcessor = traceBase.BatchSpanProcessor;\n OTLPTraceExporter = otlpHttp.OTLPTraceExporter;\n\n // Handle both old (Resource class) and new (resourceFromAttributes function) APIs\n if (resources.Resource) {\n createResource = (attrs) => new resources.Resource(attrs);\n } else if (resources.resourceFromAttributes) {\n createResource = resources.resourceFromAttributes;\n } else {\n createResource = () => resources.defaultResource();\n }\n\n // Try semantic conventions, fall back to string literal\n try {\n const semconv = require(\"@opentelemetry/semantic-conventions\");\n ATTR_SERVICE_NAME =\n semconv.ATTR_SERVICE_NAME ?? semconv.SEMRESATTRS_SERVICE_NAME ?? \"service.name\";\n } catch {\n ATTR_SERVICE_NAME = \"service.name\";\n }\n } catch {\n throw new Error(\n \"OpenTelemetry packages not found. Install them with:\\n\" +\n \"npm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base \" +\n \"@opentelemetry/exporter-trace-otlp-http @opentelemetry/resources\",\n );\n }\n\n // Build resource attributes\n const resourceAttrs: Record<string, string> = {\n [ATTR_SERVICE_NAME]: config.serviceName ?? \"gatewaysdk-tracing\",\n };\n if (config.environment) {\n resourceAttrs[\"gateway.environment\"] = config.environment;\n }\n if (config.version) {\n resourceAttrs[\"gateway.version\"] = config.version;\n }\n\n // Security check: block insecure HTTP (except localhost/127.0.0.1)\n let isLocalhost = false;\n if (endpoint) {\n try {\n const parsed = new URL(endpoint);\n isLocalhost =\n parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\";\n } catch {\n isLocalhost = false;\n }\n }\n if (endpoint && !endpoint.startsWith(\"https://\") && !isLocalhost) {\n throw new Error(\n `Refusing to send credentials over insecure HTTP to ${endpoint}. ` +\n \"Use HTTPS or localhost for development.\",\n );\n }\n\n // Construct Basic Auth header\n const credentials = `${publicKey}:${secretKey}`;\n const encoded = Buffer.from(credentials).toString(\"base64\");\n const authHeader = `Basic ${encoded}`;\n\n // Create OTLP exporter\n const exporter = new OTLPTraceExporter({\n url: endpoint,\n headers: {\n Authorization: authHeader,\n },\n });\n\n logFn(\"Configured Gateway exporter: endpoint=%s\", endpoint);\n\n // Build span processors — custom processors go first (before the BatchSpanProcessor)\n const spanProcessors: any[] = [];\n\n if (config.customSpanProcessors) {\n for (const sp of config.customSpanProcessors) {\n spanProcessors.push(sp);\n logFn(\n \"Added custom span processor: %s\",\n (sp as { constructor?: { name?: string } }).constructor?.name ??\n \"unknown\",\n );\n }\n }\n\n // Stamp the ambient end-user identity (identify() / GATEWAY_USER_ID) on\n // every span at start — mirrors the Python SDK's TracingContextSpanProcessor.\n spanProcessors.push(new IdentitySpanProcessor());\n\n // Add BatchSpanProcessor with exporter\n const batchConfig: Record<string, number> = {};\n if (config.batch?.maxQueueSize) {\n batchConfig.maxQueueSize = config.batch.maxQueueSize;\n }\n if (config.batch?.scheduledDelayMillis) {\n batchConfig.scheduledDelayMillis = config.batch.scheduledDelayMillis;\n }\n if (config.batch?.maxExportBatchSize) {\n batchConfig.maxExportBatchSize = config.batch.maxExportBatchSize;\n }\n\n spanProcessors.push(new BatchSpanProcessor(exporter, batchConfig));\n\n // Create provider — detect v1 vs v2 API via runtime feature check.\n // v1 has addSpanProcessor(); v2 removed it and requires spanProcessors in constructor.\n let provider: any = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n });\n\n if (typeof provider.addSpanProcessor === \"function\") {\n // v1 API: register each processor individually\n for (const sp of spanProcessors) {\n provider.addSpanProcessor(sp);\n }\n } else {\n // v2 API: must pass spanProcessors in constructor — recreate\n provider = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n spanProcessors,\n });\n }\n\n return provider;\n}\n/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\n/**\n * Initialize GatewaySDK tracing with automatic OpenTelemetry configuration.\n *\n * This function configures OpenTelemetry with a connection to Gateway\n * and sets up the ExperimentSpanProcessor for automatic experiment tagging.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Using environment variables (GATEWAY_HOST, GATEWAY_PUBLIC_KEY, GATEWAY_SECRET_KEY)\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * serviceName: \"my-agent\",\n * environment: \"production\",\n * });\n * ```\n */\nexport function init(config: TracingConfig = {}): void {\n if (state.initialized) {\n log(\"Tracing already initialized. Call shutdown() first to reinitialize.\");\n return;\n }\n\n // Store debug flag in state for log() function\n state.debug = config.debug ?? false;\n\n const provider = buildProvider(config, log);\n provider.register();\n\n state.provider = provider;\n state.initialized = true;\n\n log(\n \"GatewaySDK tracing initialized successfully (service=%s)\",\n config.serviceName ?? \"gatewaysdk-tracing\",\n );\n}\n\n/**\n * Create an ISOLATED tracing provider that is NOT registered globally.\n *\n * Use this when one process must export different work to different Gateway\n * projects (e.g. a server hosting several agents, each with its own project\n * keys), or when the process already has its own global OpenTelemetry\n * provider that must not be replaced.\n *\n * Spans only reach the isolated provider when started from its `tracer` —\n * pass it explicitly to observe()/observeClaude() via their `tracer` option,\n * or to a framework's telemetry hook (e.g. the Vercel AI SDK's\n * `experimental_telemetry.tracer`). Context propagation still works across\n * providers, so nesting behaves exactly as with init().\n *\n * Can be called any number of times; each handle has its own exporter,\n * batch queue, and lifecycle.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * const support = tracing.initIsolated({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-support...\",\n * secretKey: \"sk-lf-support...\",\n * serviceName: \"support-agent\",\n * });\n *\n * await tracing.observe(\"support.run\", run, { tracer: support.tracer });\n * await support.flush();\n * ```\n */\nexport function initIsolated(config: TracingConfig = {}): TracingHandle {\n const debugLog: LogFn = config.debug\n ? (message, ...args) =>\n console.log(`[gatewaysdk.tracing:isolated] ${message}`, ...args)\n : () => {};\n\n const provider = buildProvider(config, debugLog);\n const tracer = provider.getTracer(\"@withgateway/sdk\") as Tracer;\n\n debugLog(\n \"Isolated tracing provider created (service=%s)\",\n config.serviceName ?? \"gatewaysdk-tracing\",\n );\n\n return {\n tracer,\n async flush() {\n try {\n await (provider as { forceFlush: () => Promise<void> }).forceFlush();\n } catch (e) {\n warn(\"Error during isolated flush:\", e);\n }\n },\n async shutdown() {\n try {\n await (provider as { shutdown: () => Promise<void> }).shutdown();\n } catch (e) {\n warn(\"Error during isolated shutdown:\", e);\n }\n },\n };\n}\n\n/**\n * Force flush all pending spans without shutting down.\n *\n * Useful for ensuring spans are exported at specific points\n * (e.g., after completing a batch of work) without ending the tracing session.\n *\n * @returns Promise that resolves when flush completes\n */\nexport async function flush(): Promise<void> {\n if (!state.provider) {\n log(\"No provider to flush\");\n return;\n }\n\n try {\n await (state.provider as { forceFlush: () => Promise<void> }).forceFlush();\n log(\"Flush completed successfully\");\n } catch (e) {\n warn(\"Error during flush:\", e);\n }\n}\n\n/**\n * Force flush all pending spans and shutdown the tracer provider.\n *\n * This function should be called before process exit to ensure all spans\n * are exported. It is safe to call multiple times.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * tracing.init();\n *\n * // On shutdown\n * process.on(\"SIGTERM\", async () => {\n * await tracing.shutdown();\n * process.exit(0);\n * });\n * ```\n */\nexport async function shutdown(): Promise<void> {\n if (!state.initialized || !state.provider) {\n log(\"Tracing not initialized, nothing to shutdown\");\n return;\n }\n\n try {\n await (state.provider as { shutdown: () => Promise<void> }).shutdown();\n log(\"Shutdown complete\");\n } catch (e) {\n warn(\"Error during shutdown:\", e);\n }\n\n state.provider = null;\n state.initialized = false;\n}\n\n/**\n * Check if tracing has been initialized.\n */\nexport function isInitialized(): boolean {\n return state.initialized;\n}\n\n/**\n * Check if Gateway is configured via environment variables.\n */\nexport function isGatewayConfigured(): boolean {\n const host = getEnv(ENV_VARS.HOST);\n const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = getEnv(ENV_VARS.SECRET_KEY);\n return !!(host && publicKey && secretKey);\n}\n","/**\n * observe() — group a unit of work (an agent run, a tool call) into a single\n * span so nested LLM/tool spans attach to it and the whole thing is one trace.\n *\n * Mirrors Langfuse's `observe()` / `startActiveObservation()`. This is what an\n * app uses to define a trace boundary when it drives a raw client loop (which\n * has no framework root span of its own): the callback runs inside the span's\n * OpenTelemetry context, so any auto-instrumented calls (see observeOpenAI) and\n * any nested observe() calls become children of it.\n *\n * The span carries OpenInference attributes (openinference.span.kind, input.value,\n * output.value), and Gateway maps a root span's input.value/output.value to the\n * trace-level input/output — so the trace shows the user input and final output.\n */\nimport { trace, context, SpanStatusCode } from \"@opentelemetry/api\";\nimport type { Tracer } from \"@opentelemetry/api\";\n\nexport type ObservationKind = \"AGENT\" | \"CHAIN\" | \"TOOL\" | \"LLM\" | \"RETRIEVER\";\n\nexport interface ObserveOptions {\n /** Recorded as input.value on the span (JSON-stringified if not a string). */\n input?: unknown;\n /** OpenInference span kind. Defaults to \"AGENT\" for the outer run. */\n kind?: ObservationKind;\n /**\n * When true (default), the callback's return value is recorded as\n * output.value. Set false if the return value is large/uninteresting.\n */\n captureOutput?: boolean;\n /**\n * Tracer to start the span from. Defaults to the GLOBAL tracer (set up by\n * tracing.init()). Pass an initIsolated() handle's tracer to route this\n * observation to that handle's Gateway project instead.\n */\n tracer?: Tracer;\n /**\n * Extra attributes for the span — e.g. gateway.session.id /\n * gateway.user.id to group runs into a session and attribute them to a user.\n */\n attributes?: Record<string, string>;\n}\n\nfunction asAttr(value: unknown): string {\n return typeof value === \"string\" ? value : JSON.stringify(value);\n}\n\n/**\n * Run `fn` inside a span named `name`. Anything traced inside (auto-instrumented\n * client calls, nested observe() calls) nests under it, forming one trace.\n *\n * @example\n * ```ts\n * const result = await observe(\"my-agent.run\", async () => {\n * // client.chat.completions.create(...) here becomes a child GENERATION\n * return finalText;\n * }, { input: prompt });\n * ```\n */\nexport async function observe<T>(\n name: string,\n fn: () => Promise<T>,\n options: ObserveOptions = {},\n): Promise<T> {\n const tracer = options.tracer ?? trace.getTracer(\"@withgateway/sdk\");\n const span = tracer.startSpan(name, {\n attributes: {\n \"openinference.span.kind\": options.kind ?? \"AGENT\",\n ...(options.input !== undefined\n ? { \"input.value\": asAttr(options.input) }\n : {}),\n ...(options.attributes ?? {}),\n },\n });\n\n try {\n const result = await context.with(\n trace.setSpan(context.active(), span),\n fn,\n );\n if (options.captureOutput !== false && result !== undefined) {\n span.setAttribute(\"output.value\", asAttr(result));\n }\n span.setStatus({ code: SpanStatusCode.OK });\n return result;\n } catch (error) {\n span.setStatus({\n code: SpanStatusCode.ERROR,\n message: error instanceof Error ? error.message : String(error),\n });\n throw error;\n } finally {\n span.end();\n }\n}\n","/**\n * Client wrappers that turn an SDK's calls into spans on the Gateway provider.\n *\n * Node ESM can't retroactively patch a module the app already imported, so — as\n * Langfuse does with `observeOpenAI` — the app hands us the client and we\n * instrument it explicitly. One SDK call, no OpenTelemetry in the app.\n *\n * The OpenInference instrumentations are bundled optional deps of this package;\n * we load them with require() (the ESM build injects a real createRequire).\n */\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\n/**\n * Instrument an OpenAI client so its requests become GENERATION spans on the\n * Gateway provider. Returns the same client (its class prototype is patched, so\n * this and every other instance of that client are traced).\n *\n * @example\n * ```ts\n * import OpenAI from \"openai\";\n * import { init, observeOpenAI } from \"@withgateway/sdk/tracing\";\n * init();\n * const client = observeOpenAI(new OpenAI());\n * ```\n */\nexport function observeOpenAI<T extends object>(client: T): T {\n try {\n const {\n OpenAIInstrumentation,\n } = require(\"@arizeai/openinference-instrumentation-openai\");\n // OpenInference patches `module.OpenAI.Chat.Completions.prototype`, so it\n // needs an object shaped like the openai module. Reconstruct it from the\n // instance's class (client.constructor === the OpenAI class).\n const OpenAIClass = (client as { constructor: unknown }).constructor;\n new OpenAIInstrumentation().manuallyInstrument({ OpenAI: OpenAIClass });\n } catch (error) {\n warn(\n \"observeOpenAI: could not load @arizeai/openinference-instrumentation-openai — OpenAI calls will not be traced.\",\n error,\n );\n }\n return client;\n}\n\n/**\n * Instrument an Anthropic client so its requests become GENERATION spans.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import { init, observeAnthropic } from \"@withgateway/sdk/tracing\";\n * init();\n * const client = observeAnthropic(new Anthropic());\n * ```\n */\nexport function observeAnthropic<T extends object>(client: T): T {\n try {\n const {\n AnthropicInstrumentation,\n } = require(\"@arizeai/openinference-instrumentation-anthropic\");\n // The instrumentor patches `module.Messages.prototype.create`, so it wants\n // an object whose `Messages` is the Anthropic client's Messages class (a\n // static on the class). `client.messages` resolves `create` through that\n // prototype, so patching it traces this client and every other instance.\n const AnthropicClass = (client as { constructor: { Messages?: unknown } })\n .constructor;\n new AnthropicInstrumentation().manuallyInstrument({\n Messages: AnthropicClass.Messages,\n });\n } catch (error) {\n warn(\n \"observeAnthropic: could not load @arizeai/openinference-instrumentation-anthropic — Anthropic calls will not be traced.\",\n error,\n );\n }\n return client;\n}\n","/**\n * observeClaude() — trace a Claude Agent SDK run.\n *\n * The Claude Agent SDK runs the agent in a separate `claude` CLI subprocess, so\n * there's nothing in-process to patch. What the app has is the message stream it\n * iterates. Wrap that stream with observeClaude() and it yields the same\n * messages unchanged while emitting spans on the Gateway provider:\n *\n * AGENT (root)\n * ├─ GENERATION per assistant turn (with per-turn token usage)\n * └─ TOOL per tool call (input from tool_use, output from the\n * matching tool_result, matched by id)\n *\n * The TS equivalent of the Python SDK's claude-agent-sdk instrumentor.\n *\n * @example\n * ```ts\n * const stream = query({ prompt, options });\n * for await (const message of observeClaude(stream, { name, input: prompt })) {\n * // ...consume messages as usual\n * }\n * ```\n */\nimport {\n trace,\n context,\n SpanStatusCode,\n type Span,\n type Context,\n type Tracer,\n} from \"@opentelemetry/api\";\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface ObserveClaudeOptions {\n /** Root span name (becomes the trace name). */\n name: string;\n /** Recorded as input.value on the root span → trace-level input. */\n input?: string;\n /** Model label for the generation spans. */\n model?: string;\n /**\n * Tracer to start spans from. Defaults to the GLOBAL tracer (set up by\n * tracing.init()). Pass an initIsolated() handle's tracer to route this\n * run to that handle's Gateway project instead.\n */\n tracer?: Tracer;\n /**\n * Extra attributes for the ROOT span — e.g. gateway.session.id /\n * gateway.user.id to group runs into a session and attribute them to a user.\n */\n attributes?: Record<string, string>;\n}\n\n/** Strip the `mcp__<server>__` prefix so tool names read cleanly. */\nfunction cleanToolName(name: string): string {\n return name.replace(/^mcp__[^_]+__/, \"\");\n}\n\nfunction toolResultText(content: unknown): string {\n if (typeof content === \"string\") return content;\n if (Array.isArray(content))\n return content\n .map((b) =>\n b && typeof b === \"object\" && \"text\" in b\n ? String((b as { text: unknown }).text)\n : JSON.stringify(b),\n )\n .join(\"\");\n return JSON.stringify(content ?? \"\");\n}\n\nexport async function* observeClaude(\n stream: AsyncIterable<any>,\n options: ObserveClaudeOptions,\n): AsyncGenerator<any> {\n const tracer = options.tracer ?? trace.getTracer(\"@withgateway/sdk\");\n const root: Span = tracer.startSpan(options.name, {\n attributes: {\n \"openinference.span.kind\": \"AGENT\",\n ...(options.input !== undefined ? { \"input.value\": options.input } : {}),\n ...(options.attributes ?? {}),\n },\n });\n const rootCtx: Context = trace.setSpan(context.active(), root);\n const openTools = new Map<string, Span>();\n const model = options.model ?? \"claude\";\n let finalText = \"\";\n\n try {\n for await (const message of stream) {\n if (message?.type === \"assistant\") {\n let turnText = \"\";\n const toolUses: Array<{ id: string; name: string; input: unknown }> = [];\n for (const block of message.message?.content ?? []) {\n if (block?.type === \"text\") {\n finalText += block.text;\n turnText += block.text;\n }\n if (block?.type === \"tool_use\") {\n toolUses.push({ id: block.id, name: block.name, input: block.input });\n }\n }\n const gen = tracer.startSpan(\n \"assistant\",\n {\n attributes: {\n \"openinference.span.kind\": \"LLM\",\n \"llm.model_name\": model,\n \"llm.provider\": \"anthropic\",\n \"output.value\":\n turnText ||\n toolUses.map((t) => `→ ${cleanToolName(t.name)}`).join(\", \"),\n },\n },\n rootCtx,\n );\n const usage = message.message?.usage;\n if (usage?.input_tokens != null)\n gen.setAttribute(\"llm.token_count.prompt\", usage.input_tokens);\n if (usage?.output_tokens != null)\n gen.setAttribute(\"llm.token_count.completion\", usage.output_tokens);\n gen.end();\n\n for (const t of toolUses) {\n const span = tracer.startSpan(\n `tool.${cleanToolName(t.name)}`,\n {\n attributes: {\n \"openinference.span.kind\": \"TOOL\",\n \"tool.name\": cleanToolName(t.name),\n \"input.value\": JSON.stringify(t.input),\n },\n },\n rootCtx,\n );\n openTools.set(t.id, span);\n }\n }\n\n // tool_result (in a `user` message) closes the matching TOOL span.\n if (message?.type === \"user\") {\n const content = message.message?.content;\n if (Array.isArray(content)) {\n for (const block of content) {\n if (block?.type === \"tool_result\") {\n const span = openTools.get(block.tool_use_id);\n if (span) {\n span.setAttribute(\"output.value\", toolResultText(block.content));\n span.setStatus({ code: SpanStatusCode.OK });\n span.end();\n openTools.delete(block.tool_use_id);\n }\n }\n }\n }\n }\n\n yield message;\n }\n } finally {\n for (const span of openTools.values()) span.end();\n openTools.clear();\n root.setAttribute(\"output.value\", finalText);\n root.setStatus({ code: SpanStatusCode.OK });\n root.end();\n }\n}\n"],"mappings":"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","names":["debugLog","import_api","warn","import_api"]}
@@ -1,3 +1,5 @@
1
+ import { createRequire as __gatewayCreateRequire } from "module";
2
+ const require = __gatewayCreateRequire(import.meta.url);
1
3
  var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
2
4
  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
3
5
  }) : x)(function(x) {
@@ -5,6 +7,209 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
5
7
  throw Error('Dynamic require of "' + x + '" is not supported');
6
8
  });
7
9
 
10
+ // src/tracing/identity.ts
11
+ import { AsyncLocalStorage } from "async_hooks";
12
+ import { isSpanContextValid, trace } from "@opentelemetry/api";
13
+
14
+ // src/users/index.ts
15
+ var UserProfileError = class extends Error {
16
+ constructor(message, options) {
17
+ super(message);
18
+ this.name = "UserProfileError";
19
+ this.cause = options?.cause;
20
+ }
21
+ };
22
+ var UsersClient = class _UsersClient {
23
+ host;
24
+ publicKey;
25
+ secretKey;
26
+ timeoutSeconds;
27
+ debug;
28
+ constructor(config) {
29
+ this.host = config.host.replace(/\/$/, "");
30
+ this.publicKey = config.publicKey;
31
+ this.secretKey = config.secretKey;
32
+ this.timeoutSeconds = config.timeoutSeconds ?? 15;
33
+ this.debug = config.debug ?? false;
34
+ }
35
+ /** Create a client from GATEWAY_HOST / GATEWAY_PUBLIC_KEY / GATEWAY_SECRET_KEY. */
36
+ static fromEnv(config = {}) {
37
+ const host = config.host ?? process.env.GATEWAY_HOST;
38
+ const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;
39
+ const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;
40
+ const missing = [
41
+ ["host", host],
42
+ ["publicKey", publicKey],
43
+ ["secretKey", secretKey]
44
+ ].filter(([, value]) => !value).map(([name]) => name);
45
+ if (missing.length > 0) {
46
+ throw new UserProfileError(
47
+ `Missing Gateway user-profile configuration: ${missing.join(", ")}`
48
+ );
49
+ }
50
+ return new _UsersClient({
51
+ ...config,
52
+ host,
53
+ publicKey,
54
+ secretKey
55
+ });
56
+ }
57
+ /** Fetch a user's stored profile. */
58
+ async get(userId) {
59
+ return parseProfile(
60
+ await this.requestJson(
61
+ "GET",
62
+ `/api/public/user-profiles/${encodeURIComponent(userId)}`
63
+ )
64
+ );
65
+ }
66
+ /**
67
+ * Upsert a user's profile. `attributes` merge with the stored set unless
68
+ * `merge: false` (which replaces it).
69
+ */
70
+ async update(userId, update = {}) {
71
+ const body = {
72
+ userId,
73
+ attributes: update.attributes ?? {},
74
+ mergeAttributes: update.merge ?? true,
75
+ ...update.displayName !== void 0 ? { displayName: update.displayName } : {},
76
+ ...update.email !== void 0 ? { email: update.email } : {},
77
+ ...update.notes !== void 0 ? { notes: update.notes } : {}
78
+ };
79
+ return parseProfile(
80
+ await this.requestJson("POST", "/api/public/user-profiles", body)
81
+ );
82
+ }
83
+ async requestJson(method, path, payload) {
84
+ let response;
85
+ try {
86
+ response = await fetch(`${this.host}${path}`, {
87
+ method,
88
+ headers: {
89
+ Authorization: this.authHeader(),
90
+ "Content-Type": "application/json"
91
+ },
92
+ ...payload ? { body: JSON.stringify(payload) } : {},
93
+ signal: AbortSignal.timeout(this.timeoutSeconds * 1e3)
94
+ });
95
+ } catch (error) {
96
+ throw new UserProfileError(
97
+ `${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`,
98
+ { cause: error }
99
+ );
100
+ }
101
+ const text = await response.text();
102
+ if (!response.ok) {
103
+ throw new UserProfileError(
104
+ `${method} ${path} failed (${response.status}): ${text.slice(0, 500)}`
105
+ );
106
+ }
107
+ this.log("%s %s -> %s", method, path, response.status);
108
+ return safeJson(text);
109
+ }
110
+ authHeader() {
111
+ return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(
112
+ "base64"
113
+ )}`;
114
+ }
115
+ log(message, ...args) {
116
+ if (this.debug) {
117
+ console.log(`[gateway.users] ${message}`, ...args);
118
+ }
119
+ }
120
+ };
121
+ function parseProfile(payload) {
122
+ return {
123
+ userId: String(payload.userId ?? ""),
124
+ displayName: typeof payload.displayName === "string" ? payload.displayName : null,
125
+ email: typeof payload.email === "string" ? payload.email : null,
126
+ attributes: parseAttributes(payload.attributes),
127
+ notes: typeof payload.notes === "string" ? payload.notes : null
128
+ };
129
+ }
130
+ function parseAttributes(value) {
131
+ if (!value || typeof value !== "object" || Array.isArray(value)) return {};
132
+ const attributes = {};
133
+ for (const [key, entry] of Object.entries(value)) {
134
+ attributes[key] = String(entry);
135
+ }
136
+ return attributes;
137
+ }
138
+ function safeJson(value) {
139
+ try {
140
+ const parsed = JSON.parse(value);
141
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
142
+ } catch {
143
+ return {};
144
+ }
145
+ }
146
+ var users = {
147
+ fromEnv: UsersClient.fromEnv
148
+ };
149
+
150
+ // src/tracing/identity.ts
151
+ var USER_ID_ATTRIBUTE = "gateway.user.id";
152
+ var currentUserStorage = new AsyncLocalStorage();
153
+ function resolveUserId() {
154
+ const contextual = currentUserStorage.getStore();
155
+ if (contextual) return contextual;
156
+ const envUser = process.env.GATEWAY_USER_ID?.trim();
157
+ return envUser ? envUser : void 0;
158
+ }
159
+ function identify(userId, options = {}) {
160
+ const cleaned = userId.trim();
161
+ if (!cleaned) return;
162
+ currentUserStorage.enterWith(cleaned);
163
+ try {
164
+ const span = trace.getActiveSpan();
165
+ if (span && isSpanContextValid(span.spanContext())) {
166
+ span.setAttribute(USER_ID_ATTRIBUTE, cleaned);
167
+ }
168
+ } catch (error) {
169
+ debugLog("identify(): no active span to stamp", error);
170
+ }
171
+ if (options.attributes || options.displayName || options.email) {
172
+ void pushProfile(cleaned, options);
173
+ }
174
+ }
175
+ async function pushProfile(userId, options) {
176
+ try {
177
+ const attributes = {};
178
+ for (const [key, value] of Object.entries(options.attributes ?? {})) {
179
+ attributes[key] = String(value);
180
+ }
181
+ await UsersClient.fromEnv().update(userId, {
182
+ ...options.displayName !== void 0 ? { displayName: options.displayName } : {},
183
+ ...options.email !== void 0 ? { email: options.email } : {},
184
+ attributes
185
+ });
186
+ } catch (error) {
187
+ debugLog("identify(): profile update failed", error);
188
+ }
189
+ }
190
+ function resetAmbientUser() {
191
+ currentUserStorage.enterWith(void 0);
192
+ }
193
+ var IdentitySpanProcessor = class {
194
+ onStart(span, _parentContext) {
195
+ const userId = resolveUserId();
196
+ if (userId) {
197
+ span.setAttribute(USER_ID_ATTRIBUTE, userId);
198
+ }
199
+ }
200
+ onEnd(_span) {
201
+ }
202
+ async shutdown() {
203
+ }
204
+ async forceFlush() {
205
+ }
206
+ };
207
+ function debugLog(message, ...args) {
208
+ if (process.env.GATEWAY_DEBUG) {
209
+ console.debug(`[gatewaysdk.tracing] ${message}`, ...args);
210
+ }
211
+ }
212
+
8
213
  // src/tracing/init.ts
9
214
  var ENV_VARS = {
10
215
  HOST: ["GATEWAY_HOST", "GATEWAY_HOST"],
@@ -32,12 +237,7 @@ function log(message, ...args) {
32
237
  function warn(message, ...args) {
33
238
  console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
34
239
  }
35
- function init(config = {}) {
36
- if (state.initialized) {
37
- log("Tracing already initialized. Call shutdown() first to reinitialize.");
38
- return;
39
- }
40
- state.debug = config.debug ?? false;
240
+ function buildProvider(config, logFn) {
41
241
  const host = config.host ?? getEnv(ENV_VARS.HOST);
42
242
  const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
43
243
  const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
@@ -114,17 +314,18 @@ function init(config = {}) {
114
314
  Authorization: authHeader
115
315
  }
116
316
  });
117
- log("Configured Gateway exporter: endpoint=%s", endpoint);
317
+ logFn("Configured Gateway exporter: endpoint=%s", endpoint);
118
318
  const spanProcessors = [];
119
319
  if (config.customSpanProcessors) {
120
320
  for (const sp of config.customSpanProcessors) {
121
321
  spanProcessors.push(sp);
122
- log(
322
+ logFn(
123
323
  "Added custom span processor: %s",
124
324
  sp.constructor?.name ?? "unknown"
125
325
  );
126
326
  }
127
327
  }
328
+ spanProcessors.push(new IdentitySpanProcessor());
128
329
  const batchConfig = {};
129
330
  if (config.batch?.maxQueueSize) {
130
331
  batchConfig.maxQueueSize = config.batch.maxQueueSize;
@@ -149,6 +350,15 @@ function init(config = {}) {
149
350
  spanProcessors
150
351
  });
151
352
  }
353
+ return provider;
354
+ }
355
+ function init(config = {}) {
356
+ if (state.initialized) {
357
+ log("Tracing already initialized. Call shutdown() first to reinitialize.");
358
+ return;
359
+ }
360
+ state.debug = config.debug ?? false;
361
+ const provider = buildProvider(config, log);
152
362
  provider.register();
153
363
  state.provider = provider;
154
364
  state.initialized = true;
@@ -157,6 +367,33 @@ function init(config = {}) {
157
367
  config.serviceName ?? "gatewaysdk-tracing"
158
368
  );
159
369
  }
370
+ function initIsolated(config = {}) {
371
+ const debugLog2 = config.debug ? (message, ...args) => console.log(`[gatewaysdk.tracing:isolated] ${message}`, ...args) : () => {
372
+ };
373
+ const provider = buildProvider(config, debugLog2);
374
+ const tracer = provider.getTracer("@withgateway/sdk");
375
+ debugLog2(
376
+ "Isolated tracing provider created (service=%s)",
377
+ config.serviceName ?? "gatewaysdk-tracing"
378
+ );
379
+ return {
380
+ tracer,
381
+ async flush() {
382
+ try {
383
+ await provider.forceFlush();
384
+ } catch (e) {
385
+ warn("Error during isolated flush:", e);
386
+ }
387
+ },
388
+ async shutdown() {
389
+ try {
390
+ await provider.shutdown();
391
+ } catch (e) {
392
+ warn("Error during isolated shutdown:", e);
393
+ }
394
+ }
395
+ };
396
+ }
160
397
  async function flush() {
161
398
  if (!state.provider) {
162
399
  log("No provider to flush");
@@ -192,11 +429,197 @@ function isGatewayConfigured() {
192
429
  const secretKey = getEnv(ENV_VARS.SECRET_KEY);
193
430
  return !!(host && publicKey && secretKey);
194
431
  }
432
+
433
+ // src/tracing/observe.ts
434
+ import { trace as trace2, context, SpanStatusCode } from "@opentelemetry/api";
435
+ function asAttr(value) {
436
+ return typeof value === "string" ? value : JSON.stringify(value);
437
+ }
438
+ async function observe(name, fn, options = {}) {
439
+ const tracer = options.tracer ?? trace2.getTracer("@withgateway/sdk");
440
+ const span = tracer.startSpan(name, {
441
+ attributes: {
442
+ "openinference.span.kind": options.kind ?? "AGENT",
443
+ ...options.input !== void 0 ? { "input.value": asAttr(options.input) } : {},
444
+ ...options.attributes ?? {}
445
+ }
446
+ });
447
+ try {
448
+ const result = await context.with(
449
+ trace2.setSpan(context.active(), span),
450
+ fn
451
+ );
452
+ if (options.captureOutput !== false && result !== void 0) {
453
+ span.setAttribute("output.value", asAttr(result));
454
+ }
455
+ span.setStatus({ code: SpanStatusCode.OK });
456
+ return result;
457
+ } catch (error) {
458
+ span.setStatus({
459
+ code: SpanStatusCode.ERROR,
460
+ message: error instanceof Error ? error.message : String(error)
461
+ });
462
+ throw error;
463
+ } finally {
464
+ span.end();
465
+ }
466
+ }
467
+
468
+ // src/tracing/instrument.ts
469
+ function warn2(message, ...args) {
470
+ console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
471
+ }
472
+ function observeOpenAI(client) {
473
+ try {
474
+ const {
475
+ OpenAIInstrumentation
476
+ } = __require("@arizeai/openinference-instrumentation-openai");
477
+ const OpenAIClass = client.constructor;
478
+ new OpenAIInstrumentation().manuallyInstrument({ OpenAI: OpenAIClass });
479
+ } catch (error) {
480
+ warn2(
481
+ "observeOpenAI: could not load @arizeai/openinference-instrumentation-openai \u2014 OpenAI calls will not be traced.",
482
+ error
483
+ );
484
+ }
485
+ return client;
486
+ }
487
+ function observeAnthropic(client) {
488
+ try {
489
+ const {
490
+ AnthropicInstrumentation
491
+ } = __require("@arizeai/openinference-instrumentation-anthropic");
492
+ const AnthropicClass = client.constructor;
493
+ new AnthropicInstrumentation().manuallyInstrument({
494
+ Messages: AnthropicClass.Messages
495
+ });
496
+ } catch (error) {
497
+ warn2(
498
+ "observeAnthropic: could not load @arizeai/openinference-instrumentation-anthropic \u2014 Anthropic calls will not be traced.",
499
+ error
500
+ );
501
+ }
502
+ return client;
503
+ }
504
+
505
+ // src/tracing/claude.ts
506
+ import {
507
+ trace as trace3,
508
+ context as context2,
509
+ SpanStatusCode as SpanStatusCode2
510
+ } from "@opentelemetry/api";
511
+ function cleanToolName(name) {
512
+ return name.replace(/^mcp__[^_]+__/, "");
513
+ }
514
+ function toolResultText(content) {
515
+ if (typeof content === "string") return content;
516
+ if (Array.isArray(content))
517
+ return content.map(
518
+ (b) => b && typeof b === "object" && "text" in b ? String(b.text) : JSON.stringify(b)
519
+ ).join("");
520
+ return JSON.stringify(content ?? "");
521
+ }
522
+ async function* observeClaude(stream, options) {
523
+ const tracer = options.tracer ?? trace3.getTracer("@withgateway/sdk");
524
+ const root = tracer.startSpan(options.name, {
525
+ attributes: {
526
+ "openinference.span.kind": "AGENT",
527
+ ...options.input !== void 0 ? { "input.value": options.input } : {},
528
+ ...options.attributes ?? {}
529
+ }
530
+ });
531
+ const rootCtx = trace3.setSpan(context2.active(), root);
532
+ const openTools = /* @__PURE__ */ new Map();
533
+ const model = options.model ?? "claude";
534
+ let finalText = "";
535
+ try {
536
+ for await (const message of stream) {
537
+ if (message?.type === "assistant") {
538
+ let turnText = "";
539
+ const toolUses = [];
540
+ for (const block of message.message?.content ?? []) {
541
+ if (block?.type === "text") {
542
+ finalText += block.text;
543
+ turnText += block.text;
544
+ }
545
+ if (block?.type === "tool_use") {
546
+ toolUses.push({ id: block.id, name: block.name, input: block.input });
547
+ }
548
+ }
549
+ const gen = tracer.startSpan(
550
+ "assistant",
551
+ {
552
+ attributes: {
553
+ "openinference.span.kind": "LLM",
554
+ "llm.model_name": model,
555
+ "llm.provider": "anthropic",
556
+ "output.value": turnText || toolUses.map((t) => `\u2192 ${cleanToolName(t.name)}`).join(", ")
557
+ }
558
+ },
559
+ rootCtx
560
+ );
561
+ const usage = message.message?.usage;
562
+ if (usage?.input_tokens != null)
563
+ gen.setAttribute("llm.token_count.prompt", usage.input_tokens);
564
+ if (usage?.output_tokens != null)
565
+ gen.setAttribute("llm.token_count.completion", usage.output_tokens);
566
+ gen.end();
567
+ for (const t of toolUses) {
568
+ const span = tracer.startSpan(
569
+ `tool.${cleanToolName(t.name)}`,
570
+ {
571
+ attributes: {
572
+ "openinference.span.kind": "TOOL",
573
+ "tool.name": cleanToolName(t.name),
574
+ "input.value": JSON.stringify(t.input)
575
+ }
576
+ },
577
+ rootCtx
578
+ );
579
+ openTools.set(t.id, span);
580
+ }
581
+ }
582
+ if (message?.type === "user") {
583
+ const content = message.message?.content;
584
+ if (Array.isArray(content)) {
585
+ for (const block of content) {
586
+ if (block?.type === "tool_result") {
587
+ const span = openTools.get(block.tool_use_id);
588
+ if (span) {
589
+ span.setAttribute("output.value", toolResultText(block.content));
590
+ span.setStatus({ code: SpanStatusCode2.OK });
591
+ span.end();
592
+ openTools.delete(block.tool_use_id);
593
+ }
594
+ }
595
+ }
596
+ }
597
+ }
598
+ yield message;
599
+ }
600
+ } finally {
601
+ for (const span of openTools.values()) span.end();
602
+ openTools.clear();
603
+ root.setAttribute("output.value", finalText);
604
+ root.setStatus({ code: SpanStatusCode2.OK });
605
+ root.end();
606
+ }
607
+ }
195
608
  export {
609
+ IdentitySpanProcessor,
610
+ USER_ID_ATTRIBUTE,
196
611
  flush,
612
+ identify,
197
613
  init,
614
+ initIsolated,
198
615
  isGatewayConfigured,
199
616
  isInitialized,
617
+ observe,
618
+ observeAnthropic,
619
+ observeClaude,
620
+ observeOpenAI,
621
+ resetAmbientUser,
622
+ resolveUserId,
200
623
  shutdown
201
624
  };
202
625
  //# sourceMappingURL=index.mjs.map