@tracelayer/sdk 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -2
- package/dist/index.cjs +190 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +75 -0
- package/dist/index.d.ts +75 -0
- package/dist/index.js +162 -0
- package/dist/index.js.map +1 -0
- package/package.json +57 -3
package/README.md
CHANGED
|
@@ -1,3 +1,74 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @tracelayer/sdk
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Lightweight TypeScript SDK for [TraceLayer](https://YOUR-DASHBOARD-URL), an observability dashboard for AI calls.
|
|
4
|
+
|
|
5
|
+
Your AI requests still go straight to your provider. TraceLayer only receives telemetry: duration, status, model, tokens, and (optionally) input/output.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @tracelayer/sdk
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Quick start
|
|
14
|
+
|
|
15
|
+
Create a project in the dashboard, copy its API key, and keep it **server-side** only:
|
|
16
|
+
|
|
17
|
+
```env
|
|
18
|
+
TRACELAYER_API_KEY=tl_live_xxxxxxxx
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
```ts
|
|
22
|
+
import { TraceLayer } from "@tracelayer/sdk";
|
|
23
|
+
|
|
24
|
+
const tracer = new TraceLayer({ apiKey: process.env.TRACELAYER_API_KEY! });
|
|
25
|
+
|
|
26
|
+
const response = await tracer.trace("customer-chat", async (span) => {
|
|
27
|
+
const res = await openai.chat.completions.create({
|
|
28
|
+
model: "gpt-4o-mini",
|
|
29
|
+
messages: [{ role: "user", content: "Hello!" }],
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
span
|
|
33
|
+
.setModel(res.model)
|
|
34
|
+
.setInput("Hello!")
|
|
35
|
+
.setOutput(res.choices[0]?.message.content)
|
|
36
|
+
.setUsage({
|
|
37
|
+
inputTokens: res.usage?.prompt_tokens ?? 0,
|
|
38
|
+
outputTokens: res.usage?.completion_tokens ?? 0,
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
return res;
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
// serverless (Vercel, Workers): wait for delivery before responding
|
|
45
|
+
await tracer.flush();
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Duration and success/failure are captured automatically. Model, input, output, and token usage are set explicitly through the span.
|
|
49
|
+
|
|
50
|
+
## Options
|
|
51
|
+
|
|
52
|
+
| Option | Default | Description |
|
|
53
|
+
|---|---|---|
|
|
54
|
+
| `apiKey` | required | Project API key |
|
|
55
|
+
| `baseUrl` | TraceLayer API | Override for self-hosting or local development |
|
|
56
|
+
| `timeoutMs` | `3000` | Per-request timeout |
|
|
57
|
+
| `enabled` | `true` | Set `false` to send nothing (tests, local) |
|
|
58
|
+
| `captureContent` | `true` | `false` = never send input/output |
|
|
59
|
+
| `redact` | none | `(text) => text` applied before anything is sent |
|
|
60
|
+
| `onError` | none | Called when telemetry fails |
|
|
61
|
+
|
|
62
|
+
## Reliability
|
|
63
|
+
|
|
64
|
+
- Telemetry never throws into your app.
|
|
65
|
+
- Your function's result is returned unchanged, and its errors are rethrown unchanged.
|
|
66
|
+
- Sends are non-blocking with a timeout.
|
|
67
|
+
|
|
68
|
+
## Privacy
|
|
69
|
+
|
|
70
|
+
Prompts and outputs may contain sensitive data. Use `captureContent: false` or `redact` to control what leaves your app. Your AI provider keys are never sent to TraceLayer.
|
|
71
|
+
|
|
72
|
+
## License
|
|
73
|
+
|
|
74
|
+
MIT
|
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,190 @@
|
|
|
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/index.ts
|
|
21
|
+
var index_exports = {};
|
|
22
|
+
__export(index_exports, {
|
|
23
|
+
Span: () => Span,
|
|
24
|
+
TraceLayer: () => TraceLayer
|
|
25
|
+
});
|
|
26
|
+
module.exports = __toCommonJS(index_exports);
|
|
27
|
+
|
|
28
|
+
// src/trace.ts
|
|
29
|
+
function toText(value) {
|
|
30
|
+
if (typeof value === "string") return value;
|
|
31
|
+
try {
|
|
32
|
+
return JSON.stringify(value) ?? String(value);
|
|
33
|
+
} catch {
|
|
34
|
+
return String(value);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
var Span = class {
|
|
38
|
+
constructor() {
|
|
39
|
+
this.data = { metadata: {} };
|
|
40
|
+
}
|
|
41
|
+
setModel(model) {
|
|
42
|
+
this.data.model = model;
|
|
43
|
+
return this;
|
|
44
|
+
}
|
|
45
|
+
setInput(input) {
|
|
46
|
+
this.data.input = toText(input);
|
|
47
|
+
return this;
|
|
48
|
+
}
|
|
49
|
+
setOutput(output) {
|
|
50
|
+
this.data.output = toText(output);
|
|
51
|
+
return this;
|
|
52
|
+
}
|
|
53
|
+
setUsage(usage) {
|
|
54
|
+
this.data.usage = usage;
|
|
55
|
+
return this;
|
|
56
|
+
}
|
|
57
|
+
setMetadata(metadata) {
|
|
58
|
+
Object.assign(this.data.metadata, metadata);
|
|
59
|
+
return this;
|
|
60
|
+
}
|
|
61
|
+
/** Used internally by the client. */
|
|
62
|
+
snapshot() {
|
|
63
|
+
return { ...this.data, metadata: { ...this.data.metadata } };
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
|
|
67
|
+
// src/transport.ts
|
|
68
|
+
var Transport = class {
|
|
69
|
+
constructor(options) {
|
|
70
|
+
this.options = options;
|
|
71
|
+
this.pending = /* @__PURE__ */ new Set();
|
|
72
|
+
}
|
|
73
|
+
/** Fire-and-forget. Never throws, never blocks the caller. */
|
|
74
|
+
send(payload) {
|
|
75
|
+
const task = this.post(payload).finally(() => this.pending.delete(task));
|
|
76
|
+
this.pending.add(task);
|
|
77
|
+
}
|
|
78
|
+
/** Wait for in-flight sends (needed on serverless before returning). */
|
|
79
|
+
async flush() {
|
|
80
|
+
await Promise.allSettled([...this.pending]);
|
|
81
|
+
}
|
|
82
|
+
async post(payload) {
|
|
83
|
+
const controller = new AbortController();
|
|
84
|
+
const timer = setTimeout(() => controller.abort(), this.options.timeoutMs);
|
|
85
|
+
try {
|
|
86
|
+
const res = await fetch(`${this.options.baseUrl}/v1/traces`, {
|
|
87
|
+
method: "POST",
|
|
88
|
+
headers: {
|
|
89
|
+
"Content-Type": "application/json",
|
|
90
|
+
Authorization: `Bearer ${this.options.apiKey}`
|
|
91
|
+
},
|
|
92
|
+
body: JSON.stringify(payload),
|
|
93
|
+
signal: controller.signal
|
|
94
|
+
});
|
|
95
|
+
if (!res.ok) {
|
|
96
|
+
throw new Error(`TraceLayer ingestion failed with status ${res.status}`);
|
|
97
|
+
}
|
|
98
|
+
} catch (error) {
|
|
99
|
+
this.options.onError(error);
|
|
100
|
+
} finally {
|
|
101
|
+
clearTimeout(timer);
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
};
|
|
105
|
+
|
|
106
|
+
// src/client.ts
|
|
107
|
+
var DEFAULT_BASE_URL = "https://server.unainraza7.workers.dev";
|
|
108
|
+
var DEFAULT_TIMEOUT_MS = 3e3;
|
|
109
|
+
var MAX_TEXT_LENGTH = 5e4;
|
|
110
|
+
var errorMessage = (error) => error instanceof Error ? error.message : String(error);
|
|
111
|
+
var TraceLayer = class {
|
|
112
|
+
constructor(options) {
|
|
113
|
+
this.report = (error) => {
|
|
114
|
+
try {
|
|
115
|
+
this.onError?.(error);
|
|
116
|
+
} catch {
|
|
117
|
+
}
|
|
118
|
+
};
|
|
119
|
+
this.captureContent = options.captureContent ?? true;
|
|
120
|
+
this.redact = options.redact;
|
|
121
|
+
this.onError = options.onError;
|
|
122
|
+
const hasKey = Boolean(options.apiKey);
|
|
123
|
+
if (!hasKey && options.enabled !== false) {
|
|
124
|
+
console.warn("[tracelayer] No apiKey provided. Telemetry is disabled.");
|
|
125
|
+
}
|
|
126
|
+
this.enabled = (options.enabled ?? true) && hasKey;
|
|
127
|
+
this.transport = new Transport({
|
|
128
|
+
apiKey: options.apiKey,
|
|
129
|
+
baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ""),
|
|
130
|
+
timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
|
|
131
|
+
onError: this.report
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Runs `fn`, measures it, and reports the result.
|
|
136
|
+
* Returns fn's result unchanged; rethrows fn's error unchanged.
|
|
137
|
+
*/
|
|
138
|
+
async trace(name, fn) {
|
|
139
|
+
const span = new Span();
|
|
140
|
+
const startedAt = /* @__PURE__ */ new Date();
|
|
141
|
+
const startMark = performance.now();
|
|
142
|
+
try {
|
|
143
|
+
const result = await fn(span);
|
|
144
|
+
this.record({ name, status: "success", span, startedAt, startMark });
|
|
145
|
+
return result;
|
|
146
|
+
} catch (error) {
|
|
147
|
+
this.record({ name, status: "error", span, startedAt, startMark, error });
|
|
148
|
+
throw error;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
/** Await before returning on serverless (Vercel, Workers) so sends aren't killed. */
|
|
152
|
+
flush() {
|
|
153
|
+
return this.transport.flush();
|
|
154
|
+
}
|
|
155
|
+
record(input) {
|
|
156
|
+
if (!this.enabled) return;
|
|
157
|
+
try {
|
|
158
|
+
this.transport.send(this.buildPayload(input));
|
|
159
|
+
} catch (error) {
|
|
160
|
+
this.report(error);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
buildPayload(input) {
|
|
164
|
+
const { name, status, span, startedAt, startMark, error } = input;
|
|
165
|
+
const data = span.snapshot();
|
|
166
|
+
const content = (text) => text !== void 0 && this.captureContent ? this.sanitize(text) : void 0;
|
|
167
|
+
return {
|
|
168
|
+
name,
|
|
169
|
+
status,
|
|
170
|
+
startedAt: startedAt.toISOString(),
|
|
171
|
+
duration: Math.round(performance.now() - startMark),
|
|
172
|
+
model: data.model,
|
|
173
|
+
input: content(data.input),
|
|
174
|
+
output: content(data.output),
|
|
175
|
+
usage: data.usage,
|
|
176
|
+
error: status === "error" ? this.sanitize(errorMessage(error)) : void 0,
|
|
177
|
+
metadata: Object.keys(data.metadata).length > 0 ? data.metadata : void 0
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
sanitize(text) {
|
|
181
|
+
const redacted = this.redact ? this.redact(text) : text;
|
|
182
|
+
return redacted.length > MAX_TEXT_LENGTH ? redacted.slice(0, MAX_TEXT_LENGTH) : redacted;
|
|
183
|
+
}
|
|
184
|
+
};
|
|
185
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
186
|
+
0 && (module.exports = {
|
|
187
|
+
Span,
|
|
188
|
+
TraceLayer
|
|
189
|
+
});
|
|
190
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/trace.ts","../src/transport.ts","../src/client.ts"],"sourcesContent":["export { TraceLayer } from \"./client\";\nexport { Span } from \"./trace\";\nexport type { TraceLayerOptions, TracePayload, TokenUsage, TraceStatus } from \"./types\";","import type { TokenUsage } from \"./types\";\n\nexport interface SpanData {\n model?: string;\n input?: string;\n output?: string;\n usage?: TokenUsage;\n metadata: Record<string, unknown>;\n}\n\nfunction toText(value: unknown): string {\n if (typeof value === \"string\") return value;\n try {\n return JSON.stringify(value) ?? String(value);\n } catch {\n return String(value); // circular structures etc.\n }\n}\n\nexport class Span {\n private data: SpanData = { metadata: {} };\n\n setModel(model: string): this {\n this.data.model = model;\n return this;\n }\n\n setInput(input: unknown): this {\n this.data.input = toText(input);\n return this;\n }\n\n setOutput(output: unknown): this {\n this.data.output = toText(output);\n return this;\n }\n\n setUsage(usage: TokenUsage): this {\n this.data.usage = usage;\n return this;\n }\n\n setMetadata(metadata: Record<string, unknown>): this {\n Object.assign(this.data.metadata, metadata);\n return this;\n }\n\n /** Used internally by the client. */\n snapshot(): SpanData {\n return { ...this.data, metadata: { ...this.data.metadata } };\n }\n}","import type { TracePayload } from \"./types\";\n\ninterface TransportOptions {\n apiKey: string;\n baseUrl: string;\n timeoutMs: number;\n onError: (error: unknown) => void;\n}\n\nexport class Transport {\n private pending = new Set<Promise<void>>();\n\n constructor(private readonly options: TransportOptions) {}\n\n /** Fire-and-forget. Never throws, never blocks the caller. */\n send(payload: TracePayload): void {\n const task = this.post(payload).finally(() => this.pending.delete(task));\n this.pending.add(task);\n }\n\n /** Wait for in-flight sends (needed on serverless before returning). */\n async flush(): Promise<void> {\n await Promise.allSettled([...this.pending]);\n }\n\n private async post(payload: TracePayload): Promise<void> {\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), this.options.timeoutMs);\n try {\n const res = await fetch(`${this.options.baseUrl}/v1/traces`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${this.options.apiKey}`,\n },\n body: JSON.stringify(payload),\n signal: controller.signal,\n });\n if (!res.ok) {\n throw new Error(`TraceLayer ingestion failed with status ${res.status}`);\n }\n } catch (error) {\n this.options.onError(error);\n } finally {\n clearTimeout(timer);\n }\n }\n}","import { Span } from \"./trace\";\nimport { Transport } from \"./transport\";\nimport type { TraceLayerOptions, TracePayload, TraceStatus } from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://server.unainraza7.workers.dev\"; // TODO: your deployed API URL\nconst DEFAULT_TIMEOUT_MS = 3000;\n// Server accepts 100k chars; staying under it means we never get rejected for size.\nconst MAX_TEXT_LENGTH = 50_000;\n\ninterface RecordInput {\n name: string;\n status: TraceStatus;\n span: Span;\n startedAt: Date;\n startMark: number;\n error?: unknown;\n}\n\nconst errorMessage = (error: unknown) =>\n error instanceof Error ? error.message : String(error);\n\nexport class TraceLayer {\n private readonly transport: Transport;\n private readonly enabled: boolean;\n private readonly captureContent: boolean;\n private readonly redact?: (text: string) => string;\n private readonly onError?: (error: unknown) => void;\n\n constructor(options: TraceLayerOptions) {\n this.captureContent = options.captureContent ?? true;\n this.redact = options.redact;\n this.onError = options.onError;\n\n const hasKey = Boolean(options.apiKey);\n if (!hasKey && options.enabled !== false) {\n console.warn(\"[tracelayer] No apiKey provided. Telemetry is disabled.\");\n }\n this.enabled = (options.enabled ?? true) && hasKey;\n\n this.transport = new Transport({\n apiKey: options.apiKey,\n baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\"),\n timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n onError: this.report,\n });\n }\n\n /**\n * Runs `fn`, measures it, and reports the result.\n * Returns fn's result unchanged; rethrows fn's error unchanged.\n */\n async trace<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T> {\n const span = new Span();\n const startedAt = new Date();\n const startMark = performance.now();\n\n try {\n const result = await fn(span);\n this.record({ name, status: \"success\", span, startedAt, startMark });\n return result;\n } catch (error) {\n this.record({ name, status: \"error\", span, startedAt, startMark, error });\n throw error; // the app's own error is never swallowed or altered\n }\n }\n\n /** Await before returning on serverless (Vercel, Workers) so sends aren't killed. */\n flush(): Promise<void> {\n return this.transport.flush();\n }\n\n private record(input: RecordInput): void {\n if (!this.enabled) return;\n try {\n this.transport.send(this.buildPayload(input));\n } catch (error) {\n this.report(error); // telemetry must never break the app\n }\n }\n\n private buildPayload(input: RecordInput): TracePayload {\n const { name, status, span, startedAt, startMark, error } = input;\n const data = span.snapshot();\n const content = (text?: string) =>\n text !== undefined && this.captureContent ? this.sanitize(text) : undefined;\n\n return {\n name,\n status,\n startedAt: startedAt.toISOString(),\n duration: Math.round(performance.now() - startMark),\n model: data.model,\n input: content(data.input),\n output: content(data.output),\n usage: data.usage,\n error: status === \"error\" ? this.sanitize(errorMessage(error)) : undefined,\n metadata: Object.keys(data.metadata).length > 0 ? data.metadata : undefined,\n };\n }\n\n private sanitize(text: string): string {\n const redacted = this.redact ? this.redact(text) : text;\n return redacted.length > MAX_TEXT_LENGTH ? redacted.slice(0, MAX_TEXT_LENGTH) : redacted;\n }\n\n private report = (error: unknown): void => {\n try {\n this.onError?.(error);\n } catch {\n /* a broken onError must not break the app either */\n }\n };\n}"],"mappings":"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","names":[]}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
type TraceStatus = "success" | "error";
|
|
2
|
+
interface TokenUsage {
|
|
3
|
+
inputTokens: number;
|
|
4
|
+
outputTokens: number;
|
|
5
|
+
}
|
|
6
|
+
/** The exact JSON body sent to POST /v1/traces. */
|
|
7
|
+
interface TracePayload {
|
|
8
|
+
name: string;
|
|
9
|
+
status: TraceStatus;
|
|
10
|
+
startedAt: string;
|
|
11
|
+
duration: number;
|
|
12
|
+
model?: string;
|
|
13
|
+
input?: string;
|
|
14
|
+
output?: string;
|
|
15
|
+
usage?: TokenUsage;
|
|
16
|
+
error?: string;
|
|
17
|
+
metadata?: Record<string, unknown>;
|
|
18
|
+
}
|
|
19
|
+
interface TraceLayerOptions {
|
|
20
|
+
/** Project API key (tl_live_...). Keep it server-side. */
|
|
21
|
+
apiKey: string;
|
|
22
|
+
/** Override for self-hosting / local dev. */
|
|
23
|
+
baseUrl?: string;
|
|
24
|
+
/** Per-request timeout. Default 3000ms. */
|
|
25
|
+
timeoutMs?: number;
|
|
26
|
+
/** Master switch. Set false in tests/local to send nothing. */
|
|
27
|
+
enabled?: boolean;
|
|
28
|
+
/** false = never send input/output (privacy mode). Default true. */
|
|
29
|
+
captureContent?: boolean;
|
|
30
|
+
/** Runs on input/output/error text before it leaves the app. */
|
|
31
|
+
redact?: (text: string) => string;
|
|
32
|
+
/** Called when telemetry fails. Telemetry never throws into your app. */
|
|
33
|
+
onError?: (error: unknown) => void;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
interface SpanData {
|
|
37
|
+
model?: string;
|
|
38
|
+
input?: string;
|
|
39
|
+
output?: string;
|
|
40
|
+
usage?: TokenUsage;
|
|
41
|
+
metadata: Record<string, unknown>;
|
|
42
|
+
}
|
|
43
|
+
declare class Span {
|
|
44
|
+
private data;
|
|
45
|
+
setModel(model: string): this;
|
|
46
|
+
setInput(input: unknown): this;
|
|
47
|
+
setOutput(output: unknown): this;
|
|
48
|
+
setUsage(usage: TokenUsage): this;
|
|
49
|
+
setMetadata(metadata: Record<string, unknown>): this;
|
|
50
|
+
/** Used internally by the client. */
|
|
51
|
+
snapshot(): SpanData;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
declare class TraceLayer {
|
|
55
|
+
private readonly transport;
|
|
56
|
+
private readonly enabled;
|
|
57
|
+
private readonly captureContent;
|
|
58
|
+
private readonly redact?;
|
|
59
|
+
private readonly onError?;
|
|
60
|
+
constructor(options: TraceLayerOptions);
|
|
61
|
+
/**
|
|
62
|
+
* Runs `fn`, measures it, and reports the result.
|
|
63
|
+
* Returns fn's result unchanged; rethrows fn's error unchanged.
|
|
64
|
+
*/
|
|
65
|
+
trace<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T>;
|
|
66
|
+
/** Await before returning on serverless (Vercel, Workers) so sends aren't killed. */
|
|
67
|
+
flush(): Promise<void>;
|
|
68
|
+
private record;
|
|
69
|
+
private buildPayload;
|
|
70
|
+
private sanitize;
|
|
71
|
+
private report;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export { Span, TraceLayer };
|
|
75
|
+
export type { TokenUsage, TraceLayerOptions, TracePayload, TraceStatus };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
type TraceStatus = "success" | "error";
|
|
2
|
+
interface TokenUsage {
|
|
3
|
+
inputTokens: number;
|
|
4
|
+
outputTokens: number;
|
|
5
|
+
}
|
|
6
|
+
/** The exact JSON body sent to POST /v1/traces. */
|
|
7
|
+
interface TracePayload {
|
|
8
|
+
name: string;
|
|
9
|
+
status: TraceStatus;
|
|
10
|
+
startedAt: string;
|
|
11
|
+
duration: number;
|
|
12
|
+
model?: string;
|
|
13
|
+
input?: string;
|
|
14
|
+
output?: string;
|
|
15
|
+
usage?: TokenUsage;
|
|
16
|
+
error?: string;
|
|
17
|
+
metadata?: Record<string, unknown>;
|
|
18
|
+
}
|
|
19
|
+
interface TraceLayerOptions {
|
|
20
|
+
/** Project API key (tl_live_...). Keep it server-side. */
|
|
21
|
+
apiKey: string;
|
|
22
|
+
/** Override for self-hosting / local dev. */
|
|
23
|
+
baseUrl?: string;
|
|
24
|
+
/** Per-request timeout. Default 3000ms. */
|
|
25
|
+
timeoutMs?: number;
|
|
26
|
+
/** Master switch. Set false in tests/local to send nothing. */
|
|
27
|
+
enabled?: boolean;
|
|
28
|
+
/** false = never send input/output (privacy mode). Default true. */
|
|
29
|
+
captureContent?: boolean;
|
|
30
|
+
/** Runs on input/output/error text before it leaves the app. */
|
|
31
|
+
redact?: (text: string) => string;
|
|
32
|
+
/** Called when telemetry fails. Telemetry never throws into your app. */
|
|
33
|
+
onError?: (error: unknown) => void;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
interface SpanData {
|
|
37
|
+
model?: string;
|
|
38
|
+
input?: string;
|
|
39
|
+
output?: string;
|
|
40
|
+
usage?: TokenUsage;
|
|
41
|
+
metadata: Record<string, unknown>;
|
|
42
|
+
}
|
|
43
|
+
declare class Span {
|
|
44
|
+
private data;
|
|
45
|
+
setModel(model: string): this;
|
|
46
|
+
setInput(input: unknown): this;
|
|
47
|
+
setOutput(output: unknown): this;
|
|
48
|
+
setUsage(usage: TokenUsage): this;
|
|
49
|
+
setMetadata(metadata: Record<string, unknown>): this;
|
|
50
|
+
/** Used internally by the client. */
|
|
51
|
+
snapshot(): SpanData;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
declare class TraceLayer {
|
|
55
|
+
private readonly transport;
|
|
56
|
+
private readonly enabled;
|
|
57
|
+
private readonly captureContent;
|
|
58
|
+
private readonly redact?;
|
|
59
|
+
private readonly onError?;
|
|
60
|
+
constructor(options: TraceLayerOptions);
|
|
61
|
+
/**
|
|
62
|
+
* Runs `fn`, measures it, and reports the result.
|
|
63
|
+
* Returns fn's result unchanged; rethrows fn's error unchanged.
|
|
64
|
+
*/
|
|
65
|
+
trace<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T>;
|
|
66
|
+
/** Await before returning on serverless (Vercel, Workers) so sends aren't killed. */
|
|
67
|
+
flush(): Promise<void>;
|
|
68
|
+
private record;
|
|
69
|
+
private buildPayload;
|
|
70
|
+
private sanitize;
|
|
71
|
+
private report;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export { Span, TraceLayer };
|
|
75
|
+
export type { TokenUsage, TraceLayerOptions, TracePayload, TraceStatus };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
// src/trace.ts
|
|
2
|
+
function toText(value) {
|
|
3
|
+
if (typeof value === "string") return value;
|
|
4
|
+
try {
|
|
5
|
+
return JSON.stringify(value) ?? String(value);
|
|
6
|
+
} catch {
|
|
7
|
+
return String(value);
|
|
8
|
+
}
|
|
9
|
+
}
|
|
10
|
+
var Span = class {
|
|
11
|
+
constructor() {
|
|
12
|
+
this.data = { metadata: {} };
|
|
13
|
+
}
|
|
14
|
+
setModel(model) {
|
|
15
|
+
this.data.model = model;
|
|
16
|
+
return this;
|
|
17
|
+
}
|
|
18
|
+
setInput(input) {
|
|
19
|
+
this.data.input = toText(input);
|
|
20
|
+
return this;
|
|
21
|
+
}
|
|
22
|
+
setOutput(output) {
|
|
23
|
+
this.data.output = toText(output);
|
|
24
|
+
return this;
|
|
25
|
+
}
|
|
26
|
+
setUsage(usage) {
|
|
27
|
+
this.data.usage = usage;
|
|
28
|
+
return this;
|
|
29
|
+
}
|
|
30
|
+
setMetadata(metadata) {
|
|
31
|
+
Object.assign(this.data.metadata, metadata);
|
|
32
|
+
return this;
|
|
33
|
+
}
|
|
34
|
+
/** Used internally by the client. */
|
|
35
|
+
snapshot() {
|
|
36
|
+
return { ...this.data, metadata: { ...this.data.metadata } };
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
|
|
40
|
+
// src/transport.ts
|
|
41
|
+
var Transport = class {
|
|
42
|
+
constructor(options) {
|
|
43
|
+
this.options = options;
|
|
44
|
+
this.pending = /* @__PURE__ */ new Set();
|
|
45
|
+
}
|
|
46
|
+
/** Fire-and-forget. Never throws, never blocks the caller. */
|
|
47
|
+
send(payload) {
|
|
48
|
+
const task = this.post(payload).finally(() => this.pending.delete(task));
|
|
49
|
+
this.pending.add(task);
|
|
50
|
+
}
|
|
51
|
+
/** Wait for in-flight sends (needed on serverless before returning). */
|
|
52
|
+
async flush() {
|
|
53
|
+
await Promise.allSettled([...this.pending]);
|
|
54
|
+
}
|
|
55
|
+
async post(payload) {
|
|
56
|
+
const controller = new AbortController();
|
|
57
|
+
const timer = setTimeout(() => controller.abort(), this.options.timeoutMs);
|
|
58
|
+
try {
|
|
59
|
+
const res = await fetch(`${this.options.baseUrl}/v1/traces`, {
|
|
60
|
+
method: "POST",
|
|
61
|
+
headers: {
|
|
62
|
+
"Content-Type": "application/json",
|
|
63
|
+
Authorization: `Bearer ${this.options.apiKey}`
|
|
64
|
+
},
|
|
65
|
+
body: JSON.stringify(payload),
|
|
66
|
+
signal: controller.signal
|
|
67
|
+
});
|
|
68
|
+
if (!res.ok) {
|
|
69
|
+
throw new Error(`TraceLayer ingestion failed with status ${res.status}`);
|
|
70
|
+
}
|
|
71
|
+
} catch (error) {
|
|
72
|
+
this.options.onError(error);
|
|
73
|
+
} finally {
|
|
74
|
+
clearTimeout(timer);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
// src/client.ts
|
|
80
|
+
var DEFAULT_BASE_URL = "https://server.unainraza7.workers.dev";
|
|
81
|
+
var DEFAULT_TIMEOUT_MS = 3e3;
|
|
82
|
+
var MAX_TEXT_LENGTH = 5e4;
|
|
83
|
+
var errorMessage = (error) => error instanceof Error ? error.message : String(error);
|
|
84
|
+
var TraceLayer = class {
|
|
85
|
+
constructor(options) {
|
|
86
|
+
this.report = (error) => {
|
|
87
|
+
try {
|
|
88
|
+
this.onError?.(error);
|
|
89
|
+
} catch {
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
this.captureContent = options.captureContent ?? true;
|
|
93
|
+
this.redact = options.redact;
|
|
94
|
+
this.onError = options.onError;
|
|
95
|
+
const hasKey = Boolean(options.apiKey);
|
|
96
|
+
if (!hasKey && options.enabled !== false) {
|
|
97
|
+
console.warn("[tracelayer] No apiKey provided. Telemetry is disabled.");
|
|
98
|
+
}
|
|
99
|
+
this.enabled = (options.enabled ?? true) && hasKey;
|
|
100
|
+
this.transport = new Transport({
|
|
101
|
+
apiKey: options.apiKey,
|
|
102
|
+
baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ""),
|
|
103
|
+
timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
|
|
104
|
+
onError: this.report
|
|
105
|
+
});
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Runs `fn`, measures it, and reports the result.
|
|
109
|
+
* Returns fn's result unchanged; rethrows fn's error unchanged.
|
|
110
|
+
*/
|
|
111
|
+
async trace(name, fn) {
|
|
112
|
+
const span = new Span();
|
|
113
|
+
const startedAt = /* @__PURE__ */ new Date();
|
|
114
|
+
const startMark = performance.now();
|
|
115
|
+
try {
|
|
116
|
+
const result = await fn(span);
|
|
117
|
+
this.record({ name, status: "success", span, startedAt, startMark });
|
|
118
|
+
return result;
|
|
119
|
+
} catch (error) {
|
|
120
|
+
this.record({ name, status: "error", span, startedAt, startMark, error });
|
|
121
|
+
throw error;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
/** Await before returning on serverless (Vercel, Workers) so sends aren't killed. */
|
|
125
|
+
flush() {
|
|
126
|
+
return this.transport.flush();
|
|
127
|
+
}
|
|
128
|
+
record(input) {
|
|
129
|
+
if (!this.enabled) return;
|
|
130
|
+
try {
|
|
131
|
+
this.transport.send(this.buildPayload(input));
|
|
132
|
+
} catch (error) {
|
|
133
|
+
this.report(error);
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
buildPayload(input) {
|
|
137
|
+
const { name, status, span, startedAt, startMark, error } = input;
|
|
138
|
+
const data = span.snapshot();
|
|
139
|
+
const content = (text) => text !== void 0 && this.captureContent ? this.sanitize(text) : void 0;
|
|
140
|
+
return {
|
|
141
|
+
name,
|
|
142
|
+
status,
|
|
143
|
+
startedAt: startedAt.toISOString(),
|
|
144
|
+
duration: Math.round(performance.now() - startMark),
|
|
145
|
+
model: data.model,
|
|
146
|
+
input: content(data.input),
|
|
147
|
+
output: content(data.output),
|
|
148
|
+
usage: data.usage,
|
|
149
|
+
error: status === "error" ? this.sanitize(errorMessage(error)) : void 0,
|
|
150
|
+
metadata: Object.keys(data.metadata).length > 0 ? data.metadata : void 0
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
sanitize(text) {
|
|
154
|
+
const redacted = this.redact ? this.redact(text) : text;
|
|
155
|
+
return redacted.length > MAX_TEXT_LENGTH ? redacted.slice(0, MAX_TEXT_LENGTH) : redacted;
|
|
156
|
+
}
|
|
157
|
+
};
|
|
158
|
+
export {
|
|
159
|
+
Span,
|
|
160
|
+
TraceLayer
|
|
161
|
+
};
|
|
162
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/trace.ts","../src/transport.ts","../src/client.ts"],"sourcesContent":["import type { TokenUsage } from \"./types\";\n\nexport interface SpanData {\n model?: string;\n input?: string;\n output?: string;\n usage?: TokenUsage;\n metadata: Record<string, unknown>;\n}\n\nfunction toText(value: unknown): string {\n if (typeof value === \"string\") return value;\n try {\n return JSON.stringify(value) ?? String(value);\n } catch {\n return String(value); // circular structures etc.\n }\n}\n\nexport class Span {\n private data: SpanData = { metadata: {} };\n\n setModel(model: string): this {\n this.data.model = model;\n return this;\n }\n\n setInput(input: unknown): this {\n this.data.input = toText(input);\n return this;\n }\n\n setOutput(output: unknown): this {\n this.data.output = toText(output);\n return this;\n }\n\n setUsage(usage: TokenUsage): this {\n this.data.usage = usage;\n return this;\n }\n\n setMetadata(metadata: Record<string, unknown>): this {\n Object.assign(this.data.metadata, metadata);\n return this;\n }\n\n /** Used internally by the client. */\n snapshot(): SpanData {\n return { ...this.data, metadata: { ...this.data.metadata } };\n }\n}","import type { TracePayload } from \"./types\";\n\ninterface TransportOptions {\n apiKey: string;\n baseUrl: string;\n timeoutMs: number;\n onError: (error: unknown) => void;\n}\n\nexport class Transport {\n private pending = new Set<Promise<void>>();\n\n constructor(private readonly options: TransportOptions) {}\n\n /** Fire-and-forget. Never throws, never blocks the caller. */\n send(payload: TracePayload): void {\n const task = this.post(payload).finally(() => this.pending.delete(task));\n this.pending.add(task);\n }\n\n /** Wait for in-flight sends (needed on serverless before returning). */\n async flush(): Promise<void> {\n await Promise.allSettled([...this.pending]);\n }\n\n private async post(payload: TracePayload): Promise<void> {\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), this.options.timeoutMs);\n try {\n const res = await fetch(`${this.options.baseUrl}/v1/traces`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${this.options.apiKey}`,\n },\n body: JSON.stringify(payload),\n signal: controller.signal,\n });\n if (!res.ok) {\n throw new Error(`TraceLayer ingestion failed with status ${res.status}`);\n }\n } catch (error) {\n this.options.onError(error);\n } finally {\n clearTimeout(timer);\n }\n }\n}","import { Span } from \"./trace\";\nimport { Transport } from \"./transport\";\nimport type { TraceLayerOptions, TracePayload, TraceStatus } from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://server.unainraza7.workers.dev\"; // TODO: your deployed API URL\nconst DEFAULT_TIMEOUT_MS = 3000;\n// Server accepts 100k chars; staying under it means we never get rejected for size.\nconst MAX_TEXT_LENGTH = 50_000;\n\ninterface RecordInput {\n name: string;\n status: TraceStatus;\n span: Span;\n startedAt: Date;\n startMark: number;\n error?: unknown;\n}\n\nconst errorMessage = (error: unknown) =>\n error instanceof Error ? error.message : String(error);\n\nexport class TraceLayer {\n private readonly transport: Transport;\n private readonly enabled: boolean;\n private readonly captureContent: boolean;\n private readonly redact?: (text: string) => string;\n private readonly onError?: (error: unknown) => void;\n\n constructor(options: TraceLayerOptions) {\n this.captureContent = options.captureContent ?? true;\n this.redact = options.redact;\n this.onError = options.onError;\n\n const hasKey = Boolean(options.apiKey);\n if (!hasKey && options.enabled !== false) {\n console.warn(\"[tracelayer] No apiKey provided. Telemetry is disabled.\");\n }\n this.enabled = (options.enabled ?? true) && hasKey;\n\n this.transport = new Transport({\n apiKey: options.apiKey,\n baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\"),\n timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n onError: this.report,\n });\n }\n\n /**\n * Runs `fn`, measures it, and reports the result.\n * Returns fn's result unchanged; rethrows fn's error unchanged.\n */\n async trace<T>(name: string, fn: (span: Span) => Promise<T> | T): Promise<T> {\n const span = new Span();\n const startedAt = new Date();\n const startMark = performance.now();\n\n try {\n const result = await fn(span);\n this.record({ name, status: \"success\", span, startedAt, startMark });\n return result;\n } catch (error) {\n this.record({ name, status: \"error\", span, startedAt, startMark, error });\n throw error; // the app's own error is never swallowed or altered\n }\n }\n\n /** Await before returning on serverless (Vercel, Workers) so sends aren't killed. */\n flush(): Promise<void> {\n return this.transport.flush();\n }\n\n private record(input: RecordInput): void {\n if (!this.enabled) return;\n try {\n this.transport.send(this.buildPayload(input));\n } catch (error) {\n this.report(error); // telemetry must never break the app\n }\n }\n\n private buildPayload(input: RecordInput): TracePayload {\n const { name, status, span, startedAt, startMark, error } = input;\n const data = span.snapshot();\n const content = (text?: string) =>\n text !== undefined && this.captureContent ? this.sanitize(text) : undefined;\n\n return {\n name,\n status,\n startedAt: startedAt.toISOString(),\n duration: Math.round(performance.now() - startMark),\n model: data.model,\n input: content(data.input),\n output: content(data.output),\n usage: data.usage,\n error: status === \"error\" ? this.sanitize(errorMessage(error)) : undefined,\n metadata: Object.keys(data.metadata).length > 0 ? data.metadata : undefined,\n };\n }\n\n private sanitize(text: string): string {\n const redacted = this.redact ? this.redact(text) : text;\n return redacted.length > MAX_TEXT_LENGTH ? redacted.slice(0, MAX_TEXT_LENGTH) : redacted;\n }\n\n private report = (error: unknown): void => {\n try {\n this.onError?.(error);\n } catch {\n /* a broken onError must not break the app either */\n }\n };\n}"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,60 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tracelayer/sdk",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Lightweight telemetry SDK for TraceLayer AI observability",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"keywords": [
|
|
8
|
+
"observability",
|
|
9
|
+
"llm",
|
|
10
|
+
"ai",
|
|
11
|
+
"tracing",
|
|
12
|
+
"telemetry",
|
|
13
|
+
"openai",
|
|
14
|
+
"monitoring"
|
|
15
|
+
],
|
|
16
|
+
"repository": {
|
|
17
|
+
"type": "git",
|
|
18
|
+
"url": "git+https://github.com/unainr/project-files.git",
|
|
19
|
+
"directory": "packages/sdk"
|
|
20
|
+
},
|
|
21
|
+
"homepage": "https://<your-dashboard-url>",
|
|
22
|
+
"bugs": {
|
|
23
|
+
"url": "https://github.com/unainr/project-files/issues"
|
|
24
|
+
},
|
|
25
|
+
"sideEffects": false,
|
|
26
|
+
"main": "./dist/index.cjs",
|
|
27
|
+
"module": "./dist/index.js",
|
|
28
|
+
"types": "./dist/index.d.ts",
|
|
29
|
+
"exports": {
|
|
30
|
+
".": {
|
|
31
|
+
"import": {
|
|
32
|
+
"types": "./dist/index.d.ts",
|
|
33
|
+
"default": "./dist/index.js"
|
|
34
|
+
},
|
|
35
|
+
"require": {
|
|
36
|
+
"types": "./dist/index.d.cts",
|
|
37
|
+
"default": "./dist/index.cjs"
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
"files": [
|
|
42
|
+
"dist",
|
|
43
|
+
"README.md"
|
|
44
|
+
],
|
|
45
|
+
"engines": {
|
|
46
|
+
"node": ">=18"
|
|
47
|
+
},
|
|
48
|
+
"publishConfig": {
|
|
49
|
+
"access": "public"
|
|
50
|
+
},
|
|
51
|
+
"devDependencies": {
|
|
52
|
+
"tsup": "^9.0.0",
|
|
53
|
+
"typescript": "^6.0.3"
|
|
54
|
+
},
|
|
55
|
+
"scripts": {
|
|
56
|
+
"build": "tsup",
|
|
57
|
+
"dev": "tsup --watch",
|
|
58
|
+
"typecheck": "tsc --noEmit"
|
|
59
|
+
}
|
|
6
60
|
}
|