@withgateway/sdk 0.1.3

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 (40) hide show
  1. package/README.md +229 -0
  2. package/dist/context/index.d.mts +225 -0
  3. package/dist/context/index.d.ts +225 -0
  4. package/dist/context/index.js +440 -0
  5. package/dist/context/index.js.map +1 -0
  6. package/dist/context/index.mjs +411 -0
  7. package/dist/context/index.mjs.map +1 -0
  8. package/dist/experiments/index.d.mts +260 -0
  9. package/dist/experiments/index.d.ts +260 -0
  10. package/dist/experiments/index.js +407 -0
  11. package/dist/experiments/index.js.map +1 -0
  12. package/dist/experiments/index.mjs +374 -0
  13. package/dist/experiments/index.mjs.map +1 -0
  14. package/dist/index-Caw3XVub.d.mts +193 -0
  15. package/dist/index-Caw3XVub.d.ts +193 -0
  16. package/dist/index.d.mts +20 -0
  17. package/dist/index.d.ts +20 -0
  18. package/dist/index.js +1476 -0
  19. package/dist/index.js.map +1 -0
  20. package/dist/index.mjs +1434 -0
  21. package/dist/index.mjs.map +1 -0
  22. package/dist/memory/index.d.mts +124 -0
  23. package/dist/memory/index.d.ts +124 -0
  24. package/dist/memory/index.js +192 -0
  25. package/dist/memory/index.js.map +1 -0
  26. package/dist/memory/index.mjs +164 -0
  27. package/dist/memory/index.mjs.map +1 -0
  28. package/dist/security/index.d.mts +114 -0
  29. package/dist/security/index.d.ts +114 -0
  30. package/dist/security/index.js +297 -0
  31. package/dist/security/index.js.map +1 -0
  32. package/dist/security/index.mjs +275 -0
  33. package/dist/security/index.mjs.map +1 -0
  34. package/dist/tracing/index.d.mts +1 -0
  35. package/dist/tracing/index.d.ts +1 -0
  36. package/dist/tracing/index.js +226 -0
  37. package/dist/tracing/index.js.map +1 -0
  38. package/dist/tracing/index.mjs +202 -0
  39. package/dist/tracing/index.mjs.map +1 -0
  40. package/package.json +112 -0
@@ -0,0 +1,226 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/tracing/index.ts
21
+ var tracing_exports = {};
22
+ __export(tracing_exports, {
23
+ flush: () => flush,
24
+ init: () => init,
25
+ isGatewayConfigured: () => isGatewayConfigured,
26
+ isInitialized: () => isInitialized,
27
+ shutdown: () => shutdown
28
+ });
29
+ module.exports = __toCommonJS(tracing_exports);
30
+
31
+ // src/tracing/init.ts
32
+ var ENV_VARS = {
33
+ HOST: ["GATEWAY_HOST", "GATEWAY_HOST"],
34
+ PUBLIC_KEY: ["GATEWAY_PUBLIC_KEY", "GATEWAY_PUBLIC_KEY"],
35
+ SECRET_KEY: ["GATEWAY_SECRET_KEY", "GATEWAY_SECRET_KEY"],
36
+ ENDPOINT: ["GATEWAY_OTLP_ENDPOINT", "GATEWAY_OTLP_ENDPOINT"]
37
+ };
38
+ var DEFAULT_OTLP_PATH = "/api/public/otel/v1/traces";
39
+ var state = {
40
+ initialized: false,
41
+ provider: null
42
+ };
43
+ function getEnv(keys) {
44
+ for (const key of keys) {
45
+ const value = process.env[key];
46
+ if (value) return value;
47
+ }
48
+ return void 0;
49
+ }
50
+ function log(message, ...args) {
51
+ if (state.debug) {
52
+ console.log(`[gatewaysdk.tracing] ${message}`, ...args);
53
+ }
54
+ }
55
+ function warn(message, ...args) {
56
+ console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
57
+ }
58
+ function init(config = {}) {
59
+ if (state.initialized) {
60
+ log("Tracing already initialized. Call shutdown() first to reinitialize.");
61
+ return;
62
+ }
63
+ state.debug = config.debug ?? false;
64
+ const host = config.host ?? getEnv(ENV_VARS.HOST);
65
+ const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
66
+ const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
67
+ const endpoint = config.endpoint ?? getEnv(ENV_VARS.ENDPOINT) ?? (host ? `${host.replace(/\/$/, "")}${DEFAULT_OTLP_PATH}` : void 0);
68
+ const missing = [];
69
+ if (!host) missing.push("host (or GATEWAY_HOST env var)");
70
+ if (!publicKey) missing.push("publicKey (or GATEWAY_PUBLIC_KEY env var)");
71
+ if (!secretKey) missing.push("secretKey (or GATEWAY_SECRET_KEY env var)");
72
+ if (missing.length > 0) {
73
+ throw new Error(
74
+ `Missing required Gateway configuration: ${missing.join(", ")}. Provide these values via init() parameters or environment variables.`
75
+ );
76
+ }
77
+ let NodeTracerProvider;
78
+ let BatchSpanProcessor;
79
+ let OTLPTraceExporter;
80
+ let createResource;
81
+ let ATTR_SERVICE_NAME;
82
+ try {
83
+ const traceNode = require("@opentelemetry/sdk-trace-node");
84
+ const traceBase = require("@opentelemetry/sdk-trace-base");
85
+ const otlpHttp = require("@opentelemetry/exporter-trace-otlp-http");
86
+ const resources = require("@opentelemetry/resources");
87
+ NodeTracerProvider = traceNode.NodeTracerProvider;
88
+ BatchSpanProcessor = traceBase.BatchSpanProcessor;
89
+ OTLPTraceExporter = otlpHttp.OTLPTraceExporter;
90
+ if (resources.Resource) {
91
+ createResource = (attrs) => new resources.Resource(attrs);
92
+ } else if (resources.resourceFromAttributes) {
93
+ createResource = resources.resourceFromAttributes;
94
+ } else {
95
+ createResource = () => resources.defaultResource();
96
+ }
97
+ try {
98
+ const semconv = require("@opentelemetry/semantic-conventions");
99
+ ATTR_SERVICE_NAME = semconv.ATTR_SERVICE_NAME ?? semconv.SEMRESATTRS_SERVICE_NAME ?? "service.name";
100
+ } catch {
101
+ ATTR_SERVICE_NAME = "service.name";
102
+ }
103
+ } catch {
104
+ throw new Error(
105
+ "OpenTelemetry packages not found. Install them with:\nnpm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http @opentelemetry/resources"
106
+ );
107
+ }
108
+ const resourceAttrs = {
109
+ [ATTR_SERVICE_NAME]: config.serviceName ?? "gatewaysdk-tracing"
110
+ };
111
+ if (config.environment) {
112
+ resourceAttrs["gateway.environment"] = config.environment;
113
+ }
114
+ if (config.version) {
115
+ resourceAttrs["gateway.version"] = config.version;
116
+ }
117
+ let isLocalhost = false;
118
+ if (endpoint) {
119
+ try {
120
+ const parsed = new URL(endpoint);
121
+ isLocalhost = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
122
+ } catch {
123
+ isLocalhost = false;
124
+ }
125
+ }
126
+ if (endpoint && !endpoint.startsWith("https://") && !isLocalhost) {
127
+ throw new Error(
128
+ `Refusing to send credentials over insecure HTTP to ${endpoint}. Use HTTPS or localhost for development.`
129
+ );
130
+ }
131
+ const credentials = `${publicKey}:${secretKey}`;
132
+ const encoded = Buffer.from(credentials).toString("base64");
133
+ const authHeader = `Basic ${encoded}`;
134
+ const exporter = new OTLPTraceExporter({
135
+ url: endpoint,
136
+ headers: {
137
+ Authorization: authHeader
138
+ }
139
+ });
140
+ log("Configured Gateway exporter: endpoint=%s", endpoint);
141
+ const spanProcessors = [];
142
+ if (config.customSpanProcessors) {
143
+ for (const sp of config.customSpanProcessors) {
144
+ spanProcessors.push(sp);
145
+ log(
146
+ "Added custom span processor: %s",
147
+ sp.constructor?.name ?? "unknown"
148
+ );
149
+ }
150
+ }
151
+ const batchConfig = {};
152
+ if (config.batch?.maxQueueSize) {
153
+ batchConfig.maxQueueSize = config.batch.maxQueueSize;
154
+ }
155
+ if (config.batch?.scheduledDelayMillis) {
156
+ batchConfig.scheduledDelayMillis = config.batch.scheduledDelayMillis;
157
+ }
158
+ if (config.batch?.maxExportBatchSize) {
159
+ batchConfig.maxExportBatchSize = config.batch.maxExportBatchSize;
160
+ }
161
+ spanProcessors.push(new BatchSpanProcessor(exporter, batchConfig));
162
+ let provider = new NodeTracerProvider({
163
+ resource: createResource(resourceAttrs)
164
+ });
165
+ if (typeof provider.addSpanProcessor === "function") {
166
+ for (const sp of spanProcessors) {
167
+ provider.addSpanProcessor(sp);
168
+ }
169
+ } else {
170
+ provider = new NodeTracerProvider({
171
+ resource: createResource(resourceAttrs),
172
+ spanProcessors
173
+ });
174
+ }
175
+ provider.register();
176
+ state.provider = provider;
177
+ state.initialized = true;
178
+ log(
179
+ "GatewaySDK tracing initialized successfully (service=%s)",
180
+ config.serviceName ?? "gatewaysdk-tracing"
181
+ );
182
+ }
183
+ async function flush() {
184
+ if (!state.provider) {
185
+ log("No provider to flush");
186
+ return;
187
+ }
188
+ try {
189
+ await state.provider.forceFlush();
190
+ log("Flush completed successfully");
191
+ } catch (e) {
192
+ warn("Error during flush:", e);
193
+ }
194
+ }
195
+ async function shutdown() {
196
+ if (!state.initialized || !state.provider) {
197
+ log("Tracing not initialized, nothing to shutdown");
198
+ return;
199
+ }
200
+ try {
201
+ await state.provider.shutdown();
202
+ log("Shutdown complete");
203
+ } catch (e) {
204
+ warn("Error during shutdown:", e);
205
+ }
206
+ state.provider = null;
207
+ state.initialized = false;
208
+ }
209
+ function isInitialized() {
210
+ return state.initialized;
211
+ }
212
+ function isGatewayConfigured() {
213
+ const host = getEnv(ENV_VARS.HOST);
214
+ const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);
215
+ const secretKey = getEnv(ENV_VARS.SECRET_KEY);
216
+ return !!(host && publicKey && secretKey);
217
+ }
218
+ // Annotate the CommonJS export names for ESM import in node:
219
+ 0 && (module.exports = {
220
+ flush,
221
+ init,
222
+ isGatewayConfigured,
223
+ isInitialized,
224
+ shutdown
225
+ });
226
+ //# sourceMappingURL=index.js.map
@@ -0,0 +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":[]}
@@ -0,0 +1,202 @@
1
+ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
2
+ get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
3
+ }) : x)(function(x) {
4
+ if (typeof require !== "undefined") return require.apply(this, arguments);
5
+ throw Error('Dynamic require of "' + x + '" is not supported');
6
+ });
7
+
8
+ // src/tracing/init.ts
9
+ var ENV_VARS = {
10
+ HOST: ["GATEWAY_HOST", "GATEWAY_HOST"],
11
+ PUBLIC_KEY: ["GATEWAY_PUBLIC_KEY", "GATEWAY_PUBLIC_KEY"],
12
+ SECRET_KEY: ["GATEWAY_SECRET_KEY", "GATEWAY_SECRET_KEY"],
13
+ ENDPOINT: ["GATEWAY_OTLP_ENDPOINT", "GATEWAY_OTLP_ENDPOINT"]
14
+ };
15
+ var DEFAULT_OTLP_PATH = "/api/public/otel/v1/traces";
16
+ var state = {
17
+ initialized: false,
18
+ provider: null
19
+ };
20
+ function getEnv(keys) {
21
+ for (const key of keys) {
22
+ const value = process.env[key];
23
+ if (value) return value;
24
+ }
25
+ return void 0;
26
+ }
27
+ function log(message, ...args) {
28
+ if (state.debug) {
29
+ console.log(`[gatewaysdk.tracing] ${message}`, ...args);
30
+ }
31
+ }
32
+ function warn(message, ...args) {
33
+ console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
34
+ }
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;
41
+ const host = config.host ?? getEnv(ENV_VARS.HOST);
42
+ const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
43
+ const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
44
+ const endpoint = config.endpoint ?? getEnv(ENV_VARS.ENDPOINT) ?? (host ? `${host.replace(/\/$/, "")}${DEFAULT_OTLP_PATH}` : void 0);
45
+ const missing = [];
46
+ if (!host) missing.push("host (or GATEWAY_HOST env var)");
47
+ if (!publicKey) missing.push("publicKey (or GATEWAY_PUBLIC_KEY env var)");
48
+ if (!secretKey) missing.push("secretKey (or GATEWAY_SECRET_KEY env var)");
49
+ if (missing.length > 0) {
50
+ throw new Error(
51
+ `Missing required Gateway configuration: ${missing.join(", ")}. Provide these values via init() parameters or environment variables.`
52
+ );
53
+ }
54
+ let NodeTracerProvider;
55
+ let BatchSpanProcessor;
56
+ let OTLPTraceExporter;
57
+ let createResource;
58
+ let ATTR_SERVICE_NAME;
59
+ try {
60
+ const traceNode = __require("@opentelemetry/sdk-trace-node");
61
+ const traceBase = __require("@opentelemetry/sdk-trace-base");
62
+ const otlpHttp = __require("@opentelemetry/exporter-trace-otlp-http");
63
+ const resources = __require("@opentelemetry/resources");
64
+ NodeTracerProvider = traceNode.NodeTracerProvider;
65
+ BatchSpanProcessor = traceBase.BatchSpanProcessor;
66
+ OTLPTraceExporter = otlpHttp.OTLPTraceExporter;
67
+ if (resources.Resource) {
68
+ createResource = (attrs) => new resources.Resource(attrs);
69
+ } else if (resources.resourceFromAttributes) {
70
+ createResource = resources.resourceFromAttributes;
71
+ } else {
72
+ createResource = () => resources.defaultResource();
73
+ }
74
+ try {
75
+ const semconv = __require("@opentelemetry/semantic-conventions");
76
+ ATTR_SERVICE_NAME = semconv.ATTR_SERVICE_NAME ?? semconv.SEMRESATTRS_SERVICE_NAME ?? "service.name";
77
+ } catch {
78
+ ATTR_SERVICE_NAME = "service.name";
79
+ }
80
+ } catch {
81
+ throw new Error(
82
+ "OpenTelemetry packages not found. Install them with:\nnpm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http @opentelemetry/resources"
83
+ );
84
+ }
85
+ const resourceAttrs = {
86
+ [ATTR_SERVICE_NAME]: config.serviceName ?? "gatewaysdk-tracing"
87
+ };
88
+ if (config.environment) {
89
+ resourceAttrs["gateway.environment"] = config.environment;
90
+ }
91
+ if (config.version) {
92
+ resourceAttrs["gateway.version"] = config.version;
93
+ }
94
+ let isLocalhost = false;
95
+ if (endpoint) {
96
+ try {
97
+ const parsed = new URL(endpoint);
98
+ isLocalhost = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
99
+ } catch {
100
+ isLocalhost = false;
101
+ }
102
+ }
103
+ if (endpoint && !endpoint.startsWith("https://") && !isLocalhost) {
104
+ throw new Error(
105
+ `Refusing to send credentials over insecure HTTP to ${endpoint}. Use HTTPS or localhost for development.`
106
+ );
107
+ }
108
+ const credentials = `${publicKey}:${secretKey}`;
109
+ const encoded = Buffer.from(credentials).toString("base64");
110
+ const authHeader = `Basic ${encoded}`;
111
+ const exporter = new OTLPTraceExporter({
112
+ url: endpoint,
113
+ headers: {
114
+ Authorization: authHeader
115
+ }
116
+ });
117
+ log("Configured Gateway exporter: endpoint=%s", endpoint);
118
+ const spanProcessors = [];
119
+ if (config.customSpanProcessors) {
120
+ for (const sp of config.customSpanProcessors) {
121
+ spanProcessors.push(sp);
122
+ log(
123
+ "Added custom span processor: %s",
124
+ sp.constructor?.name ?? "unknown"
125
+ );
126
+ }
127
+ }
128
+ const batchConfig = {};
129
+ if (config.batch?.maxQueueSize) {
130
+ batchConfig.maxQueueSize = config.batch.maxQueueSize;
131
+ }
132
+ if (config.batch?.scheduledDelayMillis) {
133
+ batchConfig.scheduledDelayMillis = config.batch.scheduledDelayMillis;
134
+ }
135
+ if (config.batch?.maxExportBatchSize) {
136
+ batchConfig.maxExportBatchSize = config.batch.maxExportBatchSize;
137
+ }
138
+ spanProcessors.push(new BatchSpanProcessor(exporter, batchConfig));
139
+ let provider = new NodeTracerProvider({
140
+ resource: createResource(resourceAttrs)
141
+ });
142
+ if (typeof provider.addSpanProcessor === "function") {
143
+ for (const sp of spanProcessors) {
144
+ provider.addSpanProcessor(sp);
145
+ }
146
+ } else {
147
+ provider = new NodeTracerProvider({
148
+ resource: createResource(resourceAttrs),
149
+ spanProcessors
150
+ });
151
+ }
152
+ provider.register();
153
+ state.provider = provider;
154
+ state.initialized = true;
155
+ log(
156
+ "GatewaySDK tracing initialized successfully (service=%s)",
157
+ config.serviceName ?? "gatewaysdk-tracing"
158
+ );
159
+ }
160
+ async function flush() {
161
+ if (!state.provider) {
162
+ log("No provider to flush");
163
+ return;
164
+ }
165
+ try {
166
+ await state.provider.forceFlush();
167
+ log("Flush completed successfully");
168
+ } catch (e) {
169
+ warn("Error during flush:", e);
170
+ }
171
+ }
172
+ async function shutdown() {
173
+ if (!state.initialized || !state.provider) {
174
+ log("Tracing not initialized, nothing to shutdown");
175
+ return;
176
+ }
177
+ try {
178
+ await state.provider.shutdown();
179
+ log("Shutdown complete");
180
+ } catch (e) {
181
+ warn("Error during shutdown:", e);
182
+ }
183
+ state.provider = null;
184
+ state.initialized = false;
185
+ }
186
+ function isInitialized() {
187
+ return state.initialized;
188
+ }
189
+ function isGatewayConfigured() {
190
+ const host = getEnv(ENV_VARS.HOST);
191
+ const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);
192
+ const secretKey = getEnv(ENV_VARS.SECRET_KEY);
193
+ return !!(host && publicKey && secretKey);
194
+ }
195
+ export {
196
+ flush,
197
+ init,
198
+ isGatewayConfigured,
199
+ isInitialized,
200
+ shutdown
201
+ };
202
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/tracing/init.ts"],"sourcesContent":["/**\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":";;;;;;;;AAYA,IAAM,WAAW;AAAA,EACf,MAAM,CAAC,gBAAgB,cAAc;AAAA,EACrC,YAAY,CAAC,sBAAsB,oBAAoB;AAAA,EACvD,YAAY,CAAC,sBAAsB,oBAAoB;AAAA,EACvD,UAAU,CAAC,yBAAyB,uBAAuB;AAC7D;AAEA,IAAM,oBAAoB;AAG1B,IAAM,QAA4C;AAAA,EAChD,aAAa;AAAA,EACb,UAAU;AACZ;AAEA,SAAS,OAAO,MAA6C;AAC3D,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,QAAI,MAAO,QAAO;AAAA,EACpB;AACA,SAAO;AACT;AAEA,SAAS,IAAI,YAAoB,MAAuB;AACtD,MAAI,MAAM,OAAO;AACf,YAAQ,IAAI,wBAAwB,OAAO,IAAI,GAAG,IAAI;AAAA,EACxD;AACF;AAEA,SAAS,KAAK,YAAoB,MAAuB;AACvD,UAAQ,KAAK,wBAAwB,OAAO,IAAI,GAAG,IAAI;AACzD;AAyBO,SAAS,KAAK,SAAwB,CAAC,GAAS;AACrD,MAAI,MAAM,aAAa;AACrB,QAAI,qEAAqE;AACzE;AAAA,EACF;AAGA,QAAM,QAAQ,OAAO,SAAS;AAG9B,QAAM,OAAO,OAAO,QAAQ,OAAO,SAAS,IAAI;AAChD,QAAM,YAAY,OAAO,aAAa,OAAO,SAAS,UAAU;AAChE,QAAM,YAAY,OAAO,aAAa,OAAO,SAAS,UAAU;AAChE,QAAM,WACJ,OAAO,YACP,OAAO,SAAS,QAAQ,MACvB,OAAO,GAAG,KAAK,QAAQ,OAAO,EAAE,CAAC,GAAG,iBAAiB,KAAK;AAG7D,QAAM,UAAoB,CAAC;AAC3B,MAAI,CAAC,KAAM,SAAQ,KAAK,gCAAgC;AACxD,MAAI,CAAC,UAAW,SAAQ,KAAK,2CAA2C;AACxE,MAAI,CAAC,UAAW,SAAQ,KAAK,2CAA2C;AAExE,MAAI,QAAQ,SAAS,GAAG;AACtB,UAAM,IAAI;AAAA,MACR,2CAA2C,QAAQ,KAAK,IAAI,CAAC;AAAA,IAE/D;AAAA,EACF;AAKA,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,MAAI;AACF,UAAM,YAAY,UAAQ,+BAA+B;AACzD,UAAM,YAAY,UAAQ,+BAA+B;AACzD,UAAM,WAAW,UAAQ,yCAAyC;AAClE,UAAM,YAAY,UAAQ,0BAA0B;AAEpD,yBAAqB,UAAU;AAC/B,yBAAqB,UAAU;AAC/B,wBAAoB,SAAS;AAG7B,QAAI,UAAU,UAAU;AACtB,uBAAiB,CAAC,UAAU,IAAI,UAAU,SAAS,KAAK;AAAA,IAC1D,WAAW,UAAU,wBAAwB;AAC3C,uBAAiB,UAAU;AAAA,IAC7B,OAAO;AACL,uBAAiB,MAAM,UAAU,gBAAgB;AAAA,IACnD;AAGA,QAAI;AACF,YAAM,UAAU,UAAQ,qCAAqC;AAC7D,0BACE,QAAQ,qBAAqB,QAAQ,4BAA4B;AAAA,IACrE,QAAQ;AACN,0BAAoB;AAAA,IACtB;AAAA,EACF,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAGA,QAAM,gBAAwC;AAAA,IAC5C,CAAC,iBAAiB,GAAG,OAAO,eAAe;AAAA,EAC7C;AACA,MAAI,OAAO,aAAa;AACtB,kBAAc,qBAAqB,IAAI,OAAO;AAAA,EAChD;AACA,MAAI,OAAO,SAAS;AAClB,kBAAc,iBAAiB,IAAI,OAAO;AAAA,EAC5C;AAGA,MAAI,cAAc;AAClB,MAAI,UAAU;AACZ,QAAI;AACF,YAAM,SAAS,IAAI,IAAI,QAAQ;AAC/B,oBACE,OAAO,aAAa,eAAe,OAAO,aAAa;AAAA,IAC3D,QAAQ;AACN,oBAAc;AAAA,IAChB;AAAA,EACF;AACA,MAAI,YAAY,CAAC,SAAS,WAAW,UAAU,KAAK,CAAC,aAAa;AAChE,UAAM,IAAI;AAAA,MACR,sDAAsD,QAAQ;AAAA,IAEhE;AAAA,EACF;AAGA,QAAM,cAAc,GAAG,SAAS,IAAI,SAAS;AAC7C,QAAM,UAAU,OAAO,KAAK,WAAW,EAAE,SAAS,QAAQ;AAC1D,QAAM,aAAa,SAAS,OAAO;AAGnC,QAAM,WAAW,IAAI,kBAAkB;AAAA,IACrC,KAAK;AAAA,IACL,SAAS;AAAA,MACP,eAAe;AAAA,IACjB;AAAA,EACF,CAAC;AAED,MAAI,4CAA4C,QAAQ;AAGxD,QAAM,iBAAwB,CAAC;AAE/B,MAAI,OAAO,sBAAsB;AAC/B,eAAW,MAAM,OAAO,sBAAsB;AAC5C,qBAAe,KAAK,EAAE;AACtB;AAAA,QACE;AAAA,QACC,GAA2C,aAAa,QACvD;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAGA,QAAM,cAAsC,CAAC;AAC7C,MAAI,OAAO,OAAO,cAAc;AAC9B,gBAAY,eAAe,OAAO,MAAM;AAAA,EAC1C;AACA,MAAI,OAAO,OAAO,sBAAsB;AACtC,gBAAY,uBAAuB,OAAO,MAAM;AAAA,EAClD;AACA,MAAI,OAAO,OAAO,oBAAoB;AACpC,gBAAY,qBAAqB,OAAO,MAAM;AAAA,EAChD;AAEA,iBAAe,KAAK,IAAI,mBAAmB,UAAU,WAAW,CAAC;AAIjE,MAAI,WAAgB,IAAI,mBAAmB;AAAA,IACzC,UAAU,eAAe,aAAa;AAAA,EACxC,CAAC;AAED,MAAI,OAAO,SAAS,qBAAqB,YAAY;AAEnD,eAAW,MAAM,gBAAgB;AAC/B,eAAS,iBAAiB,EAAE;AAAA,IAC9B;AAAA,EACF,OAAO;AAEL,eAAW,IAAI,mBAAmB;AAAA,MAChC,UAAU,eAAe,aAAa;AAAA,MACtC;AAAA,IACF,CAAC;AAAA,EACH;AAEA,WAAS,SAAS;AAElB,QAAM,WAAW;AACjB,QAAM,cAAc;AAGpB;AAAA,IACE;AAAA,IACA,OAAO,eAAe;AAAA,EACxB;AACF;AAUA,eAAsB,QAAuB;AAC3C,MAAI,CAAC,MAAM,UAAU;AACnB,QAAI,sBAAsB;AAC1B;AAAA,EACF;AAEA,MAAI;AACF,UAAO,MAAM,SAAiD,WAAW;AACzE,QAAI,8BAA8B;AAAA,EACpC,SAAS,GAAG;AACV,SAAK,uBAAuB,CAAC;AAAA,EAC/B;AACF;AAqBA,eAAsB,WAA0B;AAC9C,MAAI,CAAC,MAAM,eAAe,CAAC,MAAM,UAAU;AACzC,QAAI,8CAA8C;AAClD;AAAA,EACF;AAEA,MAAI;AACF,UAAO,MAAM,SAA+C,SAAS;AACrE,QAAI,mBAAmB;AAAA,EACzB,SAAS,GAAG;AACV,SAAK,0BAA0B,CAAC;AAAA,EAClC;AAEA,QAAM,WAAW;AACjB,QAAM,cAAc;AACtB;AAKO,SAAS,gBAAyB;AACvC,SAAO,MAAM;AACf;AAKO,SAAS,sBAA+B;AAC7C,QAAM,OAAO,OAAO,SAAS,IAAI;AACjC,QAAM,YAAY,OAAO,SAAS,UAAU;AAC5C,QAAM,YAAY,OAAO,SAAS,UAAU;AAC5C,SAAO,CAAC,EAAE,QAAQ,aAAa;AACjC;","names":[]}
package/package.json ADDED
@@ -0,0 +1,112 @@
1
+ {
2
+ "name": "@withgateway/sdk",
3
+ "version": "0.1.3",
4
+ "description": "Gateway SDK for TypeScript - A/B experiments, tracing, and observability",
5
+ "main": "./dist/index.js",
6
+ "module": "./dist/index.mjs",
7
+ "types": "./dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "import": "./dist/index.mjs",
12
+ "require": "./dist/index.js"
13
+ },
14
+ "./experiments": {
15
+ "types": "./dist/experiments/index.d.ts",
16
+ "import": "./dist/experiments/index.mjs",
17
+ "require": "./dist/experiments/index.js"
18
+ },
19
+ "./context": {
20
+ "types": "./dist/context/index.d.ts",
21
+ "import": "./dist/context/index.mjs",
22
+ "require": "./dist/context/index.js"
23
+ },
24
+ "./memory": {
25
+ "types": "./dist/memory/index.d.ts",
26
+ "import": "./dist/memory/index.mjs",
27
+ "require": "./dist/memory/index.js"
28
+ },
29
+ "./tracing": {
30
+ "types": "./dist/tracing/index.d.ts",
31
+ "import": "./dist/tracing/index.mjs",
32
+ "require": "./dist/tracing/index.js"
33
+ },
34
+ "./security": {
35
+ "types": "./dist/security/index.d.ts",
36
+ "import": "./dist/security/index.mjs",
37
+ "require": "./dist/security/index.js"
38
+ }
39
+ },
40
+ "files": [
41
+ "dist",
42
+ "README.md"
43
+ ],
44
+ "publishConfig": {
45
+ "access": "public"
46
+ },
47
+ "scripts": {
48
+ "build": "tsup",
49
+ "dev": "tsup --watch",
50
+ "typecheck": "tsc --noEmit",
51
+ "test": "vitest",
52
+ "test:run": "vitest run",
53
+ "lint": "eslint src --ext .ts",
54
+ "clean": "rm -rf dist",
55
+ "example": "tsx examples/test-ab-experiment.ts",
56
+ "test:crm": "tsx examples/test-crm-ab-experiment.ts",
57
+ "test:crm:balanced": "tsx examples/test-crm-ab-experiment.ts --balanced",
58
+ "test:crm:full": "tsx examples/test-crm-ab-experiment.ts --users 12 --all-tasks --concurrency 3"
59
+ },
60
+ "keywords": [
61
+ "gateway",
62
+ "ab-testing",
63
+ "experiments",
64
+ "opentelemetry",
65
+ "tracing",
66
+ "observability",
67
+ "llm"
68
+ ],
69
+ "author": "Gateway Team",
70
+ "license": "MIT",
71
+ "engines": {
72
+ "node": ">=18.0.0"
73
+ },
74
+ "peerDependencies": {
75
+ "@opentelemetry/api": "^1.0.0",
76
+ "@opentelemetry/exporter-trace-otlp-http": ">=0.50.0",
77
+ "@opentelemetry/resources": ">=1.0.0",
78
+ "@opentelemetry/sdk-trace-base": ">=1.0.0",
79
+ "@opentelemetry/sdk-trace-node": ">=1.0.0"
80
+ },
81
+ "peerDependenciesMeta": {
82
+ "@opentelemetry/api": {
83
+ "optional": true
84
+ },
85
+ "@opentelemetry/sdk-trace-base": {
86
+ "optional": true
87
+ },
88
+ "@opentelemetry/sdk-trace-node": {
89
+ "optional": true
90
+ },
91
+ "@opentelemetry/exporter-trace-otlp-http": {
92
+ "optional": true
93
+ },
94
+ "@opentelemetry/resources": {
95
+ "optional": true
96
+ }
97
+ },
98
+ "devDependencies": {
99
+ "@anthropic-ai/sdk": "^0.79.0",
100
+ "@opentelemetry/api": "^1.9.0",
101
+ "@opentelemetry/exporter-trace-otlp-http": "^0.212.0",
102
+ "@opentelemetry/resources": "^2.6.0",
103
+ "@opentelemetry/sdk-trace-base": "^1.30.1",
104
+ "@opentelemetry/sdk-trace-node": "^2.6.0",
105
+ "@opentelemetry/semantic-conventions": "^1.40.0",
106
+ "@types/node": "^20.0.0",
107
+ "tsup": "^8.0.0",
108
+ "tsx": "^4.0.0",
109
+ "typescript": "^5.0.0",
110
+ "vitest": "^2.0.0"
111
+ }
112
+ }