@akai_80percent/traceai-sdk 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TraceAI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,91 @@
-# Temporary Holding Version
+# @akai_80percent/traceai-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A standalone TypeScript client for best-effort, privacy-first AI operation telemetry.
+It preserves operation results/errors, batches events, and bounds memory and delivery attempts.
+
+## Installation
+
+Use the public SDK package in your server-side application:
+
+```sh
+bun add @akai_80percent/traceai-sdk
+# Or: npm install @akai_80percent/traceai-sdk
+```
+
+For the current registry release status and verified version, see the
+[publication guide](https://github.com/Metricra-code/traceai/blob/main/docs/npm.md).
+An install command requires an available registry release; packing alone is not publication.
+For local development, build the repository workspace or install a locally packed tarball.
+From the repository root:
+
+```sh
+bun install --frozen-lockfile
+bun run --filter @akai_80percent/traceai-sdk build
+mkdir -p .local
+(cd packages/sdk && bun pm pack --filename ../../.local/traceai-sdk.tgz --ignore-scripts)
+```
+
+In a separate consumer project, use `bun add /absolute/path/to/traceai/.local/traceai-sdk.tgz`
+(or `npm install` with the same file path). Packing is not publishing; generated artifacts stay in
+ignored `.local/`. Repository examples already resolve the workspace package after it is built.
+
+## Usage
+
+```ts
+import { TraceAI } from '@akai_80percent/traceai-sdk';
+
+const telemetry = new TraceAI({
+  apiKey: process.env.TRACEAI_API_KEY!,
+  endpoint: process.env.TRACEAI_ENDPOINT!,
+});
+
+try {
+  const result = await telemetry.trace(
+    { name: 'summarize', provider: 'example', model: 'my-model' },
+    async (span) => {
+      const response = await callModel();
+      span.setUsage({ inputTokens: response.inputTokens, outputTokens: response.outputTokens });
+      return response;
+    },
+  );
+} finally {
+  await telemetry.shutdown();
+}
+```
+
+**Server-side only:** ingestion keys must never be included in a browser bundle.
+Bun 1.4+ or Node.js 22+ provides the required Fetch, Web Crypto and performance APIs; the SDK has no Bun-specific dependencies.
+Only explicit scalar metadata is sent; prompts, results and raw error messages are never collected by default.
+Failure-only `TraceOptions.errorSummary(error)` is a deliberate opt-in for a safe summary, not automatic
+`.message` capture. Known-secret redaction is best effort, not an all-PII guarantee; invalid/oversized
+summaries and callback failures are omitted while the original application error is rethrown.
+Treat custom metadata as potentially sensitive.
+
+Default limits: batch 50, UTF-8 payload 256 KiB, metadata 8 KiB, 1,000 queued/in-flight events,
+5-second flush/timeout, 3 delivery attempts. Constructor rejects unsafe configuration with a fixed error.
+HTTPS is required except localhost/127.0.0.1/::1 development endpoints.
+
+`trace()` never awaits upload. `flush()` shares concurrent drains and resolves after bounded attempts;
+it is **not** a durable delivery acknowledgment. Observe sanitized `onDiagnostic` codes for loss.
+`shutdown()` stops new telemetry, waits for previously started operations and drains their events.
+Operations must have their own deadlines; never await shutdown from inside a traced operation.
+
+Retry: only network failures, timeouts, HTTP 408/429/5xx; exponential full jitter and bounded Retry-After.
+Permanent failures and retry exhaustion drop the batch. Queue overflow drops the newest event.
+The queue is in memory: process crashes, abrupt termination and serverless suspension can lose it.
+
+`record(completedEvent)` validates/snapshots an already-ended operation and returns an actual
+HTTP-acknowledged `delivered` or explicit `dropped` receipt. Do not mistake fulfillment of
+best-effort `flush()` for acceptance. Call `flush()` before awaiting a short-lived process's receipt.
+The optional `@traceai/opentelemetry` package uses this path; the core SDK has no OTel dependency.
+
+The repository's workspace builds and Bun-packed tarballs are independently checked. Its
+`bun run test:packages` verifies isolated public types, MIT license files, and Bun + Node 22 runtime
+consumers. It does not publish anything.
+
+Full integration, tuning, testing and benchmark guidance:
+[SDK guide](https://github.com/Metricra-code/traceai/blob/main/docs/sdk.md).
+For optional real-provider usage, see the
+[Gemini integration guide](https://github.com/Metricra-code/traceai/blob/main/docs/gemini.md).
+Gemini requires your own server-side provider credentials; free-tier/model availability and quotas
+depend on your account and may change. The mock examples do not call or bill an AI provider.

package/dist/index.d.ts

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+
+/** Best-effort known-pattern redaction, not a guarantee that arbitrary summaries contain no PII. */
+declare function sanitizeErrorSummary(value: string): string | undefined;
+
+declare const traceEventSchema: z.ZodObject<{
+    traceId: z.ZodString;
+    name: z.ZodString;
+    provider: z.ZodString;
+    model: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        success: "success";
+    }>;
+    startedAt: z.ZodISODateTime;
+    endedAt: z.ZodISODateTime;
+    durationMs: z.ZodNumber;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    errorType: z.ZodOptional<z.ZodEnum<{
+        timeout: "timeout";
+        rate_limit: "rate_limit";
+        network: "network";
+        application: "application";
+        unknown: "unknown";
+    }>>;
+    errorSummary: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+}, z.core.$strict>;
+type TraceEvent = z.infer<typeof traceEventSchema>;
+
+/** Only explicitly supplied scalar metadata is captured. Never put secrets here. */
+type TraceMetadata = Record<string, string | number | boolean | null>;
+interface Usage {
+    inputTokens: number;
+    outputTokens: number;
+}
+interface TraceOptions {
+    name: string;
+    provider: string;
+    model: string;
+    metadata?: TraceMetadata;
+    /** Explicit opt-in only. Known secrets are redacted; arbitrary PII is your responsibility. */
+    errorSummary?: (error: unknown) => string | undefined;
+}
+interface TraceSpan {
+    /** Invalid usage is ignored; the last valid report wins. Closed spans ignore reports. */
+    setUsage(usage: Usage): void;
+}
+interface Diagnostic {
+    code: 'invalid_event' | 'invalid_metadata' | 'invalid_usage' | 'invalid_error_summary' | 'queue_full' | 'delivery_retry' | 'delivery_failed' | 'client_closed';
+    count: number;
+    attempt?: number;
+    httpStatus?: number;
+}
+interface TraceAIConfig {
+    apiKey: string;
+    /** API base URL or full /v1/events/batch URL. HTTPS except loopback development. */
+    endpoint: string;
+    enabled?: boolean;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    requestTimeoutMs?: number;
+    maxQueueSize?: number;
+    /** Includes the initial attempt. */
+    maxAttempts?: number;
+    retryBaseMs?: number;
+    /** Upper bound for exponential backoff and Retry-After. */
+    retryMaxMs?: number;
+    /** A lightweight callback receiving sanitized codes only. Exceptions are ignored. */
+    onDiagnostic?: (diagnostic: Readonly<Diagnostic>) => void;
+    /** Optional transport override for testing or a compatible platform fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+/** An already-ended operation, e.g. a server-side OpenTelemetry span. */
+type CompletedTrace = TraceEvent;
+/** Acknowledged by HTTP, not merely queued. Delivery is best effort, never exactly-once. */
+type DeliveryResult = {
+    status: 'delivered';
+} | {
+    status: 'dropped';
+    reason: 'disabled' | 'client_closed' | 'invalid_event' | 'queue_full' | 'delivery_failed';
+};
+
+/** Snapshots valid plain scalar metadata; never serializes arbitrary objects or array indices. */
+declare const snapshotTraceMetadata: (value: unknown) => TraceMetadata | undefined;
+
+/** A best-effort in-memory telemetry client; operation results and errors always win. */
+declare class TraceAI {
+    private readonly config;
+    private readonly report;
+    private readonly transport;
+    private readonly interval?;
+    private queue;
+    private inFlightCount;
+    private drainPromise?;
+    private drainAllRequested;
+    private shutdownPromise?;
+    private acceptingTraces;
+    private activeCount;
+    private activeBarrier?;
+    private resolveActiveBarrier?;
+    constructor(config: TraceAIConfig);
+    trace<T>(options: TraceOptions, operation: (span: TraceSpan) => Promise<T>): Promise<T>;
+    /** Validate and snapshot an already-completed event. Resolves only on delivery or explicit drop. */
+    record(event: CompletedTrace): Promise<DeliveryResult>;
+    /** Singleflight best-effort drain. Use record() receipts when acknowledged delivery matters. */
+    flush(): Promise<void>;
+    /** Stops new telemetry, awaits already-started operations, then drains. Idempotent. */
+    shutdown(): Promise<void>;
+    private waitForActiveOperations;
+    private finishActiveOperation;
+    private completeSafely;
+    private enqueue;
+    private startDrain;
+    private shouldDrain;
+    private drainQueue;
+    private sendNextBatch;
+}
+
+export { type CompletedTrace, type DeliveryResult, type Diagnostic, TraceAI, type TraceAIConfig, type TraceMetadata, type TraceOptions, type TraceSpan, type Usage, sanitizeErrorSummary, snapshotTraceMetadata };

package/dist/index.js

@@ -0,0 +1,521 @@
+// ../shared/src/index.ts
+import { z as z2 } from "zod";
+
+// ../shared/src/error-summary.ts
+import { z } from "zod";
+var MAX_ERROR_SUMMARY_CHARS = 1e3;
+var MAX_ERROR_SUMMARY_BYTES = 4 * 1024;
+var errorSummarySchema = z.string().min(1).max(MAX_ERROR_SUMMARY_CHARS).refine((value) => new TextEncoder().encode(value).length <= MAX_ERROR_SUMMARY_BYTES);
+function stripControlCharacters(value) {
+  return Array.from(value, (character) => {
+    const code = character.charCodeAt(0);
+    return code < 32 || code === 127 ? " " : character;
+  }).join("");
+}
+function sanitizeErrorSummary(value) {
+  if (!errorSummarySchema.safeParse(value).success) return void 0;
+  const sanitized = stripControlCharacters(value).replace(/(https?:\/\/)[^\s/@]+@/gi, "$1[redacted]@").replace(
+    /\b(?:authorization|proxy-authorization)["']?\s*[:=]\s*["']?(?:bearer\s+|basic\s+)?[^\s,;"'}]+/gi,
+    "authorization: [redacted]"
+  ).replace(/\b(?:bearer|basic)\s+[a-z0-9._~+/=-]+/gi, "[redacted-auth]").replace(/\btai_[a-f0-9]{32}_[a-f0-9]{64}\b/gi, "[redacted-key]").replace(
+    /\b(?:sk|sess|ghp|gho|github_pat|xox[baprs])[-_][a-z0-9_-]{12,}\b/gi,
+    "[redacted-token]"
+  ).replace(/\beyJ[a-z0-9_-]+\.[a-z0-9_-]+\.[a-z0-9_-]+\b/gi, "[redacted-token]").replace(
+    /\b(api[_-]?key|access[_-]?token|refresh[_-]?token|token|secret|password|passwd|signature)["']?\s*[:=]\s*(?:"[^"]*"|'[^']*'|[^\s,;&]+)/gi,
+    "$1=[redacted]"
+  ).replace(/\b[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}\b/gi, "[redacted-email]").trim();
+  return sanitized && errorSummarySchema.safeParse(sanitized).success ? sanitized : void 0;
+}
+
+// ../shared/src/index.ts
+var MAX_BATCH_SIZE = 50;
+var MAX_PAYLOAD_BYTES = 256 * 1024;
+var MAX_METADATA_BYTES = 8 * 1024;
+var MAX_WINDOW_MS = 31 * 24 * 60 * 60 * 1e3;
+var label = z2.string().trim().min(1).max(120);
+var timestamp = z2.iso.datetime();
+var utcTimestampParts = (value) => {
+  const [whole, fraction = ""] = value.slice(0, -1).split(".");
+  return { second: Date.parse(`${whole}Z`), fraction };
+};
+var timestampsOrdered = (startedAt, endedAt) => {
+  const start = utcTimestampParts(startedAt);
+  const end = utcTimestampParts(endedAt);
+  if (start.second !== end.second) return start.second < end.second;
+  const precision = Math.max(start.fraction.length, end.fraction.length);
+  return start.fraction.padEnd(precision, "0") <= end.fraction.padEnd(precision, "0");
+};
+var tokenCount = z2.number().int().min(0).max(1e7);
+var usageSchema = z2.object({ inputTokens: tokenCount, outputTokens: tokenCount }).strict();
+var metadataSchema = z2.record(
+  z2.string().max(100),
+  z2.union([z2.string().max(2e3), z2.number().finite(), z2.boolean(), z2.null()])
+).refine(
+  (value) => new TextEncoder().encode(JSON.stringify(value)).length <= MAX_METADATA_BYTES,
+  "Metadata exceeds 8 KiB"
+);
+var traceEventSchema = z2.object({
+  traceId: z2.string().min(1).max(128).regex(/^[a-zA-Z0-9_-]+$/),
+  name: label,
+  provider: label,
+  model: label,
+  status: z2.enum(["success", "error"]),
+  startedAt: timestamp,
+  endedAt: timestamp,
+  durationMs: z2.number().finite().min(0).max(864e5),
+  inputTokens: tokenCount.optional(),
+  outputTokens: tokenCount.optional(),
+  errorType: z2.enum(["timeout", "rate_limit", "network", "application", "unknown"]).optional(),
+  errorSummary: errorSummarySchema.optional(),
+  metadata: metadataSchema.optional()
+}).strict().refine((event) => timestampsOrdered(event.startedAt, event.endedAt), {
+  message: "End timestamp must not precede start"
+}).refine((event) => event.errorSummary === void 0 || event.status === "error", {
+  message: "An explicit error summary is only permitted on failed operations"
+});
+var batchSchema = z2.object({ events: z2.array(traceEventSchema).min(1).max(MAX_BATCH_SIZE) }).strict();
+var projectSchema = z2.object({
+  name: z2.string().trim().min(1).max(80),
+  description: z2.string().trim().max(500).default("")
+}).strict();
+var credentialsSchema = z2.object({
+  email: z2.email().max(254).transform((value) => value.toLowerCase()),
+  password: z2.string().min(12).max(128)
+}).strict();
+var pricingProvenanceSchema = z2.object({
+  version: z2.string().min(1).max(120),
+  provider: label,
+  model: label,
+  currency: z2.string().min(1).max(10),
+  inputNanoUsdPerMillion: z2.string().regex(/^\d{1,20}$/),
+  outputNanoUsdPerMillion: z2.string().regex(/^\d{1,20}$/),
+  effectiveFrom: timestamp,
+  effectiveTo: timestamp.nullable(),
+  sourceUrl: z2.url().max(2048).refine((value) => {
+    const url = new URL(value);
+    return url.protocol === "https:" && !url.username && !url.password;
+  }),
+  simulated: z2.boolean(),
+  verifiedAt: timestamp.nullable(),
+  billingBasis: z2.string().max(100).nullable()
+}).strict();
+
+// src/events.ts
+var snapshotTraceMetadata = (value) => {
+  try {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) return void 0;
+    return metadataSchema.parse(value);
+  } catch {
+    return void 0;
+  }
+};
+var snapshotOptions = (options, report) => {
+  const labels = { name: options.name, provider: options.provider, model: options.model };
+  if (options.metadata === void 0) return labels;
+  const metadata = snapshotTraceMetadata(options.metadata);
+  if (metadata) return { ...labels, metadata };
+  report({ code: "invalid_metadata", count: 1 });
+  return labels;
+};
+var captureErrorSummary = (options, report) => {
+  let callback;
+  try {
+    callback = options.errorSummary;
+  } catch {
+    report({ code: "invalid_error_summary", count: 1 });
+  }
+  return (error) => {
+    if (callback === void 0) return void 0;
+    try {
+      const value = callback(error);
+      if (value === void 0) return void 0;
+      if (typeof value === "string") {
+        const sanitized = sanitizeErrorSummary(value);
+        if (sanitized !== void 0) return sanitized;
+      } else {
+        void Promise.resolve(value).catch(() => void 0);
+      }
+    } catch {
+    }
+    report({ code: "invalid_error_summary", count: 1 });
+    return void 0;
+  };
+};
+var snapshotCompletedEvent = (value) => {
+  try {
+    const parsed = traceEventSchema.safeParse(value);
+    if (!parsed.success) return void 0;
+    const { errorSummary, ...event } = parsed.data;
+    const sanitized = errorSummary === void 0 ? void 0 : sanitizeErrorSummary(errorSummary);
+    return sanitized === void 0 ? event : { ...event, errorSummary: sanitized };
+  } catch {
+    return void 0;
+  }
+};
+var classifyError = (error) => {
+  try {
+    if (typeof error !== "object" || error === null) return "unknown";
+    const classified = error;
+    if (classified.name === "AbortError" || classified.name === "TimeoutError" || classified.code === "ETIMEDOUT")
+      return "timeout";
+    if (classified.status === 429) return "rate_limit";
+    if (classified.name === "NetworkError" || typeof classified.code === "string" && ["ECONNRESET", "ENOTFOUND", "ECONNREFUSED"].includes(classified.code))
+      return "network";
+    return error instanceof Error ? "application" : "unknown";
+  } catch {
+    return "unknown";
+  }
+};
+var captureOperation = (options, report) => {
+  try {
+    const labels = snapshotOptions(options, report);
+    const summarizeError = captureErrorSummary(options, report);
+    const traceId = globalThis.crypto.randomUUID();
+    const startedAtMs = Date.now();
+    const monotonicStart = performance.now();
+    let usage;
+    let closed = false;
+    const span = {
+      setUsage(value) {
+        if (closed) return;
+        try {
+          usage = usageSchema.parse(value);
+        } catch {
+          report({ code: "invalid_usage", count: 1 });
+        }
+      }
+    };
+    return {
+      span,
+      summarizeError,
+      complete(errorType, errorSummary) {
+        closed = true;
+        const event = traceEventSchema.safeParse({
+          ...labels,
+          traceId,
+          status: errorType === void 0 ? "success" : "error",
+          startedAt: new Date(startedAtMs).toISOString(),
+          endedAt: new Date(Math.max(startedAtMs, Date.now())).toISOString(),
+          durationMs: Math.max(0, performance.now() - monotonicStart),
+          ...usage,
+          ...errorSummary === void 0 ? {} : { errorSummary },
+          ...errorType === void 0 ? {} : { errorType }
+        });
+        if (event.success) return event.data;
+        report({ code: "invalid_event", count: 1 });
+        return void 0;
+      }
+    };
+  } catch {
+    report({ code: "invalid_event", count: 1 });
+    return void 0;
+  }
+};
+
+// src/batching.ts
+var createBatch = (queue, batchSize) => {
+  let events = [];
+  let body = "";
+  for (const event of queue.slice(0, batchSize)) {
+    const candidate = [...events, event];
+    const encoded = JSON.stringify({ events: candidate });
+    if (new TextEncoder().encode(encoded).length > MAX_PAYLOAD_BYTES) break;
+    events = candidate;
+    body = encoded;
+  }
+  return { events, body };
+};
+
+// src/config.ts
+import { z as z3 } from "zod";
+var milliseconds = z3.number().int().min(1).max(36e5);
+var configSchema = z3.object({
+  apiKey: z3.string().min(1).max(4096).regex(/^[\x21-\x7e]+$/),
+  endpoint: z3.string().max(2048),
+  enabled: z3.boolean().default(true),
+  batchSize: z3.number().int().min(1).max(MAX_BATCH_SIZE).default(MAX_BATCH_SIZE),
+  flushIntervalMs: milliseconds.default(5e3),
+  requestTimeoutMs: milliseconds.default(5e3),
+  maxQueueSize: z3.number().int().min(1).max(1e5).default(1e3),
+  maxAttempts: z3.number().int().min(1).max(10).default(3),
+  retryBaseMs: z3.number().int().min(0).max(6e4).default(250),
+  retryMaxMs: z3.number().int().min(0).max(6e4).default(3e4),
+  onDiagnostic: z3.custom((value) => typeof value === "function").optional(),
+  fetch: z3.custom((value) => typeof value === "function").optional()
+}).strict();
+var resolveEndpoint = (endpoint) => {
+  const url = new URL(endpoint);
+  const loopback = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+  if (url.username || url.password || url.search || url.hash) throw new TypeError();
+  if (url.protocol !== "https:" && !(url.protocol === "http:" && loopback)) throw new TypeError();
+  const base = url.pathname.replace(/\/+$/, "");
+  url.pathname = base.endsWith("/v1/events/batch") ? base : `${base}/v1/events/batch`;
+  return url.toString();
+};
+var resolveConfig = (config) => {
+  try {
+    const parsed = configSchema.parse(config);
+    const fetch = parsed.fetch ?? globalThis.fetch;
+    if (typeof fetch !== "function") throw new TypeError();
+    return Object.freeze({ ...parsed, endpoint: resolveEndpoint(parsed.endpoint), fetch });
+  } catch {
+    throw new TypeError("Invalid TraceAI configuration");
+  }
+};
+
+// src/diagnostics.ts
+var createDiagnosticReporter = (callback) => (diagnostic) => {
+  try {
+    const returned = callback?.(Object.freeze({ ...diagnostic }));
+    if (returned !== void 0) void Promise.resolve(returned).catch(() => void 0);
+  } catch {
+  }
+};
+
+// src/transport.ts
+var retryAfterDelay = (header, maximum) => {
+  if (!header) return 0;
+  const seconds = Number(header);
+  const duration = Number.isFinite(seconds) ? seconds * 1e3 : Date.parse(header) - Date.now();
+  return Number.isFinite(duration) ? Math.min(maximum, Math.max(0, duration)) : 0;
+};
+var waitForRetry = (result, attempt, config) => {
+  const exponentialCap = Math.min(config.retryMaxMs, config.retryBaseMs * 2 ** (attempt - 1));
+  const jitter = Math.floor(Math.random() * exponentialCap);
+  const delay = Math.max(jitter, result.retryAfterMs ?? 0);
+  return delay > 0 ? new Promise((resolve) => setTimeout(resolve, delay)) : Promise.resolve();
+};
+var BatchTransport = class {
+  constructor(config, report) {
+    this.config = config;
+    this.report = report;
+  }
+  config;
+  report;
+  async send(body, count) {
+    for (let attempt = 1; attempt <= this.config.maxAttempts; attempt++) {
+      const result = await this.sendAttempt(body);
+      if (result.successful) return true;
+      const detail = {
+        count,
+        attempt,
+        ...result.httpStatus === void 0 ? {} : { httpStatus: result.httpStatus }
+      };
+      if (!result.retryable || attempt === this.config.maxAttempts) {
+        this.report({ code: "delivery_failed", ...detail });
+        return false;
+      }
+      this.report({ code: "delivery_retry", ...detail });
+      await waitForRetry(result, attempt, this.config);
+    }
+    return false;
+  }
+  async sendAttempt(body) {
+    const controller = new AbortController();
+    let timer;
+    try {
+      const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+          controller.abort();
+          reject(new Error("Telemetry request timed out"));
+        }, this.config.requestTimeoutMs);
+      });
+      const request = this.config.fetch(this.config.endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.config.apiKey}`
+        },
+        body,
+        signal: controller.signal,
+        redirect: "error"
+      });
+      const response = await Promise.race([request, timeout]);
+      void response.body?.cancel().catch(() => void 0);
+      return {
+        successful: response.ok,
+        retryable: response.status === 408 || response.status === 429 || response.status >= 500 && response.status <= 599,
+        httpStatus: response.status,
+        retryAfterMs: retryAfterDelay(response.headers.get("Retry-After"), this.config.retryMaxMs)
+      };
+    } catch {
+      return { successful: false, retryable: true };
+    } finally {
+      if (timer !== void 0) clearTimeout(timer);
+    }
+  }
+};
+
+// src/index.ts
+var inactiveSpan = Object.freeze({ setUsage: () => void 0 });
+var delivered = Object.freeze({ status: "delivered" });
+var deliveryFailed = Object.freeze({
+  status: "dropped",
+  reason: "delivery_failed"
+});
+var TraceAI = class {
+  config;
+  report;
+  transport;
+  interval;
+  queue = [];
+  inFlightCount = 0;
+  drainPromise;
+  drainAllRequested = false;
+  shutdownPromise;
+  acceptingTraces = true;
+  activeCount = 0;
+  activeBarrier;
+  resolveActiveBarrier;
+  constructor(config) {
+    this.config = resolveConfig(config);
+    this.report = createDiagnosticReporter(this.config.onDiagnostic);
+    this.transport = new BatchTransport(this.config, this.report);
+    if (this.config.enabled) {
+      this.interval = setInterval(() => {
+        void this.flush();
+      }, this.config.flushIntervalMs);
+      if (typeof this.interval === "object" && "unref" in this.interval) this.interval.unref();
+    }
+  }
+  async trace(options, operation) {
+    if (!this.config.enabled) return operation(inactiveSpan);
+    if (!this.acceptingTraces) {
+      this.report({ code: "client_closed", count: 1 });
+      return operation(inactiveSpan);
+    }
+    this.activeCount++;
+    const capture = captureOperation(options, this.report);
+    let errorType;
+    let errorSummary;
+    try {
+      return await operation(capture?.span ?? inactiveSpan);
+    } catch (error) {
+      errorType = classifyError(error);
+      errorSummary = capture?.summarizeError(error);
+      throw error;
+    } finally {
+      this.completeSafely(() => capture?.complete(errorType, errorSummary));
+      this.finishActiveOperation();
+    }
+  }
+  /** Validate and snapshot an already-completed event. Resolves only on delivery or explicit drop. */
+  record(event) {
+    if (!this.config.enabled) return Promise.resolve({ status: "dropped", reason: "disabled" });
+    if (!this.acceptingTraces) {
+      this.report({ code: "client_closed", count: 1 });
+      return Promise.resolve({ status: "dropped", reason: "client_closed" });
+    }
+    const snapshot = snapshotCompletedEvent(event);
+    if (!snapshot) {
+      this.report({ code: "invalid_event", count: 1 });
+      return Promise.resolve({ status: "dropped", reason: "invalid_event" });
+    }
+    return new Promise((settle) => this.enqueue({ event: snapshot, settle }));
+  }
+  /** Singleflight best-effort drain. Use record() receipts when acknowledged delivery matters. */
+  flush() {
+    if (!this.queue.length && !this.drainPromise) return Promise.resolve();
+    this.drainAllRequested = true;
+    return this.startDrain();
+  }
+  /** Stops new telemetry, awaits already-started operations, then drains. Idempotent. */
+  shutdown() {
+    if (this.shutdownPromise) return this.shutdownPromise;
+    this.acceptingTraces = false;
+    if (this.interval !== void 0) clearInterval(this.interval);
+    this.shutdownPromise = this.waitForActiveOperations().then(async () => {
+      await this.flush();
+      while (this.queue.length) await this.flush();
+    });
+    return this.shutdownPromise;
+  }
+  waitForActiveOperations() {
+    if (!this.activeCount) return Promise.resolve();
+    this.activeBarrier ??= new Promise((resolve) => {
+      this.resolveActiveBarrier = resolve;
+    });
+    return this.activeBarrier;
+  }
+  finishActiveOperation() {
+    this.activeCount--;
+    if (this.activeCount === 0) this.resolveActiveBarrier?.();
+  }
+  completeSafely(complete) {
+    try {
+      const event = complete();
+      if (event) this.enqueue({ event });
+    } catch {
+      this.report({ code: "invalid_event", count: 1 });
+    }
+  }
+  enqueue(entry) {
+    if (this.queue.length + this.inFlightCount >= this.config.maxQueueSize) {
+      this.report({ code: "queue_full", count: 1 });
+      entry.settle?.({ status: "dropped", reason: "queue_full" });
+      return;
+    }
+    this.queue = [...this.queue, entry];
+    if (this.queue.length >= this.config.batchSize)
+      queueMicrotask(() => {
+        void this.startDrain();
+      });
+  }
+  startDrain() {
+    if (this.drainPromise) return this.drainPromise;
+    if (!this.shouldDrain()) return Promise.resolve();
+    let finish;
+    const draining = new Promise((resolve) => {
+      finish = resolve;
+    });
+    this.drainPromise = draining;
+    void this.drainQueue(finish);
+    return draining;
+  }
+  shouldDrain() {
+    return this.queue.length > 0 && (this.drainAllRequested || this.queue.length >= this.config.batchSize);
+  }
+  async drainQueue(finish) {
+    try {
+      while (this.shouldDrain()) await this.sendNextBatch();
+    } catch {
+      this.report({ code: "delivery_failed", count: this.queue.length });
+      for (const entry of this.queue) entry.settle?.(deliveryFailed);
+      this.queue = [];
+    } finally {
+      this.drainPromise = void 0;
+      this.drainAllRequested = false;
+      finish();
+    }
+  }
+  async sendNextBatch() {
+    const { events, body } = createBatch(
+      this.queue.slice(0, this.config.batchSize).map(({ event }) => event),
+      this.config.batchSize
+    );
+    if (!events.length) {
+      this.queue[0]?.settle?.({ status: "dropped", reason: "invalid_event" });
+      this.queue = this.queue.slice(1);
+      this.report({ code: "invalid_event", count: 1 });
+      return;
+    }
+    const entries = this.queue.slice(0, events.length);
+    this.queue = this.queue.slice(events.length);
+    this.inFlightCount = entries.length;
+    let result = deliveryFailed;
+    try {
+      if (await this.transport.send(body, entries.length)) result = delivered;
+    } finally {
+      this.inFlightCount = 0;
+      for (const entry of entries) entry.settle?.(result);
+    }
+  }
+};
+export {
+  TraceAI,
+  sanitizeErrorSummary,
+  snapshotTraceMetadata
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../shared/src/index.ts","../../shared/src/error-summary.ts","../src/events.ts","../src/batching.ts","../src/config.ts","../src/diagnostics.ts","../src/transport.ts","../src/index.ts"],"sourcesContent":["import { z } from 'zod';\nimport { errorSummarySchema } from './error-summary';\nexport {\n  ERROR_CAPTURE_POLICY,\n  MAX_ERROR_SUMMARY_CHARS,\n  MAX_ERROR_SUMMARY_BYTES,\n  errorSummarySchema,\n  sanitizeErrorSummary,\n} from './error-summary';\nexport const MAX_BATCH_SIZE = 50;\nexport const MAX_PAYLOAD_BYTES = 256 * 1024;\nexport const MAX_METADATA_BYTES = 8 * 1024;\nexport const MAX_WINDOW_MS = 31 * 24 * 60 * 60 * 1000;\nconst label = z.string().trim().min(1).max(120);\nconst timestamp = z.iso.datetime();\nconst utcTimestampParts = (value: string) => {\n  const [whole, fraction = ''] = value.slice(0, -1).split('.');\n  return { second: Date.parse(`${whole}Z`), fraction };\n};\nconst timestampsOrdered = (startedAt: string, endedAt: string): boolean => {\n  const start = utcTimestampParts(startedAt);\n  const end = utcTimestampParts(endedAt);\n  if (start.second !== end.second) return start.second < end.second;\n  // Date.parse truncates sub-millisecond digits; compare exact decimal fractions before normalization.\n  const precision = Math.max(start.fraction.length, end.fraction.length);\n  return start.fraction.padEnd(precision, '0') <= end.fraction.padEnd(precision, '0');\n};\nconst tokenCount = z.number().int().min(0).max(10_000_000);\nexport const usageSchema = z.object({ inputTokens: tokenCount, outputTokens: tokenCount }).strict();\nexport const metadataSchema = z\n  .record(\n    z.string().max(100),\n    z.union([z.string().max(2000), z.number().finite(), z.boolean(), z.null()]),\n  )\n  .refine(\n    (value) => new TextEncoder().encode(JSON.stringify(value)).length <= MAX_METADATA_BYTES,\n    'Metadata exceeds 8 KiB',\n  );\nexport const traceEventSchema = z\n  .object({\n    traceId: z\n      .string()\n      .min(1)\n      .max(128)\n      .regex(/^[a-zA-Z0-9_-]+$/),\n    name: label,\n    provider: label,\n    model: label,\n    status: z.enum(['success', 'error']),\n    startedAt: timestamp,\n    endedAt: timestamp,\n    durationMs: z.number().finite().min(0).max(86_400_000),\n    inputTokens: tokenCount.optional(),\n    outputTokens: tokenCount.optional(),\n    errorType: z.enum(['timeout', 'rate_limit', 'network', 'application', 'unknown']).optional(),\n    errorSummary: errorSummarySchema.optional(),\n    metadata: metadataSchema.optional(),\n  })\n  .strict()\n  .refine((event) => timestampsOrdered(event.startedAt, event.endedAt), {\n    message: 'End timestamp must not precede start',\n  })\n  .refine((event) => event.errorSummary === undefined || event.status === 'error', {\n    message: 'An explicit error summary is only permitted on failed operations',\n  });\nexport const batchSchema = z\n  .object({ events: z.array(traceEventSchema).min(1).max(MAX_BATCH_SIZE) })\n  .strict();\nexport type TraceEvent = z.infer<typeof traceEventSchema>;\nexport type Usage = z.infer<typeof usageSchema>;\nexport type TraceMetadata = z.infer<typeof metadataSchema>;\nexport const projectSchema = z\n  .object({\n    name: z.string().trim().min(1).max(80),\n    description: z.string().trim().max(500).default(''),\n  })\n  .strict();\nexport const credentialsSchema = z\n  .object({\n    email: z\n      .email()\n      .max(254)\n      .transform((value) => value.toLowerCase()),\n    password: z.string().min(12).max(128),\n  })\n  .strict();\n\nexport interface Trace extends TraceEvent {\n  projectId: string;\n  estimatedCostNanoUsd: string | null;\n  pricingVersion: string | null;\n  createdAt: string;\n  pricing?: PricingProvenance;\n}\nexport interface PricingProvenance {\n  version: string;\n  provider: string;\n  model: string;\n  currency: string;\n  inputNanoUsdPerMillion: string;\n  outputNanoUsdPerMillion: string;\n  effectiveFrom: string;\n  effectiveTo: string | null;\n  sourceUrl: string;\n  simulated: boolean;\n  verifiedAt: string | null;\n  billingBasis: string | null;\n}\nexport const pricingProvenanceSchema = z\n  .object({\n    version: z.string().min(1).max(120),\n    provider: label,\n    model: label,\n    currency: z.string().min(1).max(10),\n    inputNanoUsdPerMillion: z.string().regex(/^\\d{1,20}$/),\n    outputNanoUsdPerMillion: z.string().regex(/^\\d{1,20}$/),\n    effectiveFrom: timestamp,\n    effectiveTo: timestamp.nullable(),\n    sourceUrl: z\n      .url()\n      .max(2048)\n      .refine((value) => {\n        const url = new URL(value);\n        return url.protocol === 'https:' && !url.username && !url.password;\n      }),\n    simulated: z.boolean(),\n    verifiedAt: timestamp.nullable(),\n    billingBasis: z.string().max(100).nullable(),\n  })\n  .strict();\nexport interface Overview {\n  totalRequests: number;\n  successfulRequests: number;\n  failedRequests: number;\n  errorRate: number;\n  averageLatencyMs: number;\n  p50LatencyMs: number;\n  p95LatencyMs: number;\n  p99LatencyMs: number;\n  inputTokens: number;\n  outputTokens: number;\n  estimatedCostNanoUsd: string | null;\n  /** Sum of priced requests only, never a complete total if unpricedRequests > 0. */\n  knownEstimatedCostNanoUsd: string | null;\n  pricedRequests: number;\n  unpricedRequests: number;\n}\nexport interface MetricBucket extends Overview {\n  timestamp: string;\n}\nexport interface ModelComparison extends Overview {\n  provider: string;\n  model: string;\n}\nexport interface TracePage {\n  items: Trace[];\n  nextCursor: string | null;\n}\nexport interface Project {\n  id: string;\n  name: string;\n  description: string;\n  createdAt: string;\n  updatedAt: string;\n}\nexport interface ApiKey {\n  id: string;\n  keyPrefix: string;\n  createdAt: string;\n  lastUsedAt: string | null;\n  revokedAt: string | null;\n}\nexport interface QueryFilters {\n  from: string;\n  to: string;\n  provider?: string;\n  model?: string;\n  status?: 'success' | 'error';\n  traceId?: string;\n  limit?: number;\n  cursor?: string;\n  sort?: 'newest' | 'oldest';\n}\nexport const percentile = (sortedValues: readonly number[], percentileValue: number): number => {\n  if (!sortedValues.length) return 0;\n  // Nearest-rank: rank = ceil(p * n), one-based; stable for ties and singleton sets.\n  return sortedValues[Math.max(0, Math.ceil(percentileValue * sortedValues.length) - 1)] ?? 0;\n};\nexport const estimateCostNanoUsd = (\n  usage: Usage,\n  pricing: { inputNanoUsdPerMillion: string; outputNanoUsdPerMillion: string },\n): string => {\n  const numerator =\n    BigInt(usage.inputTokens) * BigInt(pricing.inputNanoUsdPerMillion) +\n    BigInt(usage.outputTokens) * BigInt(pricing.outputNanoUsdPerMillion);\n  // Round half up ONCE after adding input and output costs. Never use floats for money.\n  return ((numerator + 500_000n) / 1_000_000n).toString();\n};\n","import { z } from 'zod';\n\nexport const MAX_ERROR_SUMMARY_CHARS = 1000;\nexport const MAX_ERROR_SUMMARY_BYTES = 4 * 1024;\nexport const ERROR_CAPTURE_POLICY = 'explicit-summary-v1';\nexport const errorSummarySchema = z\n  .string()\n  .min(1)\n  .max(MAX_ERROR_SUMMARY_CHARS)\n  .refine((value) => new TextEncoder().encode(value).length <= MAX_ERROR_SUMMARY_BYTES);\n\nfunction stripControlCharacters(value: string): string {\n  return Array.from(value, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  }).join('');\n}\n\n/** Best-effort known-pattern redaction, not a guarantee that arbitrary summaries contain no PII. */\nexport function sanitizeErrorSummary(value: string): string | undefined {\n  if (!errorSummarySchema.safeParse(value).success) return undefined;\n  const sanitized = stripControlCharacters(value)\n    .replace(/(https?:\\/\\/)[^\\s/@]+@/gi, '$1[redacted]@')\n    .replace(\n      /\\b(?:authorization|proxy-authorization)[\"']?\\s*[:=]\\s*[\"']?(?:bearer\\s+|basic\\s+)?[^\\s,;\"'}]+/gi,\n      'authorization: [redacted]',\n    )\n    .replace(/\\b(?:bearer|basic)\\s+[a-z0-9._~+/=-]+/gi, '[redacted-auth]')\n    .replace(/\\btai_[a-f0-9]{32}_[a-f0-9]{64}\\b/gi, '[redacted-key]')\n    .replace(\n      /\\b(?:sk|sess|ghp|gho|github_pat|xox[baprs])[-_][a-z0-9_-]{12,}\\b/gi,\n      '[redacted-token]',\n    )\n    .replace(/\\beyJ[a-z0-9_-]+\\.[a-z0-9_-]+\\.[a-z0-9_-]+\\b/gi, '[redacted-token]')\n    .replace(\n      /\\b(api[_-]?key|access[_-]?token|refresh[_-]?token|token|secret|password|passwd|signature)[\"']?\\s*[:=]\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s,;&]+)/gi,\n      '$1=[redacted]',\n    )\n    .replace(/\\b[a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,}\\b/gi, '[redacted-email]')\n    .trim();\n  return sanitized && errorSummarySchema.safeParse(sanitized).success ? sanitized : undefined;\n}\n","import {\n  metadataSchema,\n  sanitizeErrorSummary,\n  traceEventSchema,\n  usageSchema,\n  type TraceEvent,\n} from '@traceai/shared';\nimport type { ReportDiagnostic } from './diagnostics';\nimport type { TraceMetadata, TraceOptions, TraceSpan, Usage } from './types';\n\nexport interface OperationCapture {\n  span: TraceSpan;\n  summarizeError(error: unknown): string | undefined;\n  complete(errorType?: TraceEvent['errorType'], errorSummary?: string): TraceEvent | undefined;\n}\n\n/** Snapshots valid plain scalar metadata; never serializes arbitrary objects or array indices. */\nexport const snapshotTraceMetadata = (value: unknown): TraceMetadata | undefined => {\n  try {\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n    const prototype: unknown = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) return undefined;\n    return metadataSchema.parse(value);\n  } catch {\n    return undefined;\n  }\n};\nconst snapshotOptions = (options: TraceOptions, report: ReportDiagnostic) => {\n  const labels = { name: options.name, provider: options.provider, model: options.model };\n  if (options.metadata === undefined) return labels;\n  const metadata = snapshotTraceMetadata(options.metadata);\n  if (metadata) return { ...labels, metadata };\n  report({ code: 'invalid_metadata', count: 1 });\n  return labels;\n};\n\nconst captureErrorSummary = (options: TraceOptions, report: ReportDiagnostic) => {\n  let callback: TraceOptions['errorSummary'];\n  try {\n    callback = options.errorSummary;\n  } catch {\n    report({ code: 'invalid_error_summary', count: 1 });\n  }\n  return (error: unknown): string | undefined => {\n    if (callback === undefined) return undefined;\n    try {\n      const value: unknown = callback(error);\n      if (value === undefined) return undefined;\n      if (typeof value === 'string') {\n        const sanitized = sanitizeErrorSummary(value);\n        if (sanitized !== undefined) return sanitized;\n      } else {\n        // A mistakenly async callback must not create an unhandled rejection.\n        void Promise.resolve(value).catch(() => undefined);\n      }\n    } catch {\n      // Callback failures must never mask the application's original exception.\n    }\n    report({ code: 'invalid_error_summary', count: 1 });\n    return undefined;\n  };\n};\n\nexport const snapshotCompletedEvent = (value: unknown): TraceEvent | undefined => {\n  try {\n    const parsed = traceEventSchema.safeParse(value);\n    if (!parsed.success) return undefined;\n    const { errorSummary, ...event } = parsed.data;\n    const sanitized = errorSummary === undefined ? undefined : sanitizeErrorSummary(errorSummary);\n    return sanitized === undefined ? event : { ...event, errorSummary: sanitized };\n  } catch {\n    return undefined;\n  }\n};\n\nexport const classifyError = (error: unknown): NonNullable<TraceEvent['errorType']> => {\n  try {\n    if (typeof error !== 'object' || error === null) return 'unknown';\n    const classified = error as { name?: unknown; status?: unknown; code?: unknown };\n    if (\n      classified.name === 'AbortError' ||\n      classified.name === 'TimeoutError' ||\n      classified.code === 'ETIMEDOUT'\n    )\n      return 'timeout';\n    if (classified.status === 429) return 'rate_limit';\n    if (\n      classified.name === 'NetworkError' ||\n      (typeof classified.code === 'string' &&\n        ['ECONNRESET', 'ENOTFOUND', 'ECONNREFUSED'].includes(classified.code))\n    )\n      return 'network';\n    return error instanceof Error ? 'application' : 'unknown';\n  } catch {\n    return 'unknown';\n  }\n};\n\nexport const captureOperation = (\n  options: TraceOptions,\n  report: ReportDiagnostic,\n): OperationCapture | undefined => {\n  try {\n    const labels = snapshotOptions(options, report);\n    const summarizeError = captureErrorSummary(options, report);\n    const traceId = globalThis.crypto.randomUUID();\n    const startedAtMs = Date.now();\n    const monotonicStart = performance.now();\n    let usage: Usage | undefined;\n    let closed = false;\n    const span: TraceSpan = {\n      setUsage(value) {\n        if (closed) return;\n        try {\n          usage = usageSchema.parse(value);\n        } catch {\n          report({ code: 'invalid_usage', count: 1 });\n        }\n      },\n    };\n    return {\n      span,\n      summarizeError,\n      complete(errorType, errorSummary) {\n        closed = true;\n        const event = traceEventSchema.safeParse({\n          ...labels,\n          traceId,\n          status: errorType === undefined ? 'success' : 'error',\n          startedAt: new Date(startedAtMs).toISOString(),\n          endedAt: new Date(Math.max(startedAtMs, Date.now())).toISOString(),\n          durationMs: Math.max(0, performance.now() - monotonicStart),\n          ...usage,\n          ...(errorSummary === undefined ? {} : { errorSummary }),\n          ...(errorType === undefined ? {} : { errorType }),\n        });\n        if (event.success) return event.data;\n        report({ code: 'invalid_event', count: 1 });\n        return undefined;\n      },\n    };\n  } catch {\n    report({ code: 'invalid_event', count: 1 });\n    return undefined;\n  }\n};\n","import { MAX_PAYLOAD_BYTES, type TraceEvent } from '@traceai/shared';\n\nexport const createBatch = (queue: readonly TraceEvent[], batchSize: number) => {\n  let events: readonly TraceEvent[] = [];\n  let body = '';\n  for (const event of queue.slice(0, batchSize)) {\n    const candidate = [...events, event];\n    const encoded = JSON.stringify({ events: candidate });\n    if (new TextEncoder().encode(encoded).length > MAX_PAYLOAD_BYTES) break;\n    events = candidate;\n    body = encoded;\n  }\n  return { events, body };\n};\n","import { z } from 'zod';\nimport { MAX_BATCH_SIZE } from '@traceai/shared';\nimport type { TraceAIConfig } from './types';\n\nconst milliseconds = z.number().int().min(1).max(3_600_000);\nconst configSchema = z\n  .object({\n    apiKey: z\n      .string()\n      .min(1)\n      .max(4096)\n      .regex(/^[\\x21-\\x7e]+$/),\n    endpoint: z.string().max(2048),\n    enabled: z.boolean().default(true),\n    batchSize: z.number().int().min(1).max(MAX_BATCH_SIZE).default(MAX_BATCH_SIZE),\n    flushIntervalMs: milliseconds.default(5000),\n    requestTimeoutMs: milliseconds.default(5000),\n    maxQueueSize: z.number().int().min(1).max(100_000).default(1000),\n    maxAttempts: z.number().int().min(1).max(10).default(3),\n    retryBaseMs: z.number().int().min(0).max(60_000).default(250),\n    retryMaxMs: z.number().int().min(0).max(60_000).default(30_000),\n    onDiagnostic: z\n      .custom<NonNullable<TraceAIConfig['onDiagnostic']>>((value) => typeof value === 'function')\n      .optional(),\n    fetch: z.custom<typeof globalThis.fetch>((value) => typeof value === 'function').optional(),\n  })\n  .strict();\n\nexport type ResolvedConfig = ReturnType<typeof resolveConfig>;\n\nconst resolveEndpoint = (endpoint: string): string => {\n  const url = new URL(endpoint);\n  const loopback = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);\n  if (url.username || url.password || url.search || url.hash) throw new TypeError();\n  if (url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) throw new TypeError();\n  const base = url.pathname.replace(/\\/+$/, '');\n  url.pathname = base.endsWith('/v1/events/batch') ? base : `${base}/v1/events/batch`;\n  return url.toString();\n};\n\nexport const resolveConfig = (config: TraceAIConfig) => {\n  try {\n    const parsed = configSchema.parse(config);\n    const fetch = parsed.fetch ?? globalThis.fetch;\n    if (typeof fetch !== 'function') throw new TypeError();\n    return Object.freeze({ ...parsed, endpoint: resolveEndpoint(parsed.endpoint), fetch });\n  } catch {\n    // Do not expose Zod issues: rejected values may contain credentials.\n    throw new TypeError('Invalid TraceAI configuration');\n  }\n};\n","import type { Diagnostic, TraceAIConfig } from './types';\n\nexport type ReportDiagnostic = (diagnostic: Diagnostic) => void;\n\nexport const createDiagnosticReporter =\n  (callback?: TraceAIConfig['onDiagnostic']): ReportDiagnostic =>\n  (diagnostic) => {\n    try {\n      const returned: unknown = callback?.(Object.freeze({ ...diagnostic }));\n      // TypeScript permits async callbacks where void is expected. Swallow those too.\n      if (returned !== undefined) void Promise.resolve(returned).catch(() => undefined);\n    } catch {\n      // An optional observer must never become part of the application's error path.\n    }\n  };\n","import type { ResolvedConfig } from './config';\nimport type { ReportDiagnostic } from './diagnostics';\n\ninterface AttemptResult {\n  successful: boolean;\n  retryable: boolean;\n  httpStatus?: number;\n  retryAfterMs?: number;\n}\n\nconst retryAfterDelay = (header: string | null, maximum: number): number => {\n  if (!header) return 0;\n  const seconds = Number(header);\n  const duration = Number.isFinite(seconds) ? seconds * 1000 : Date.parse(header) - Date.now();\n  return Number.isFinite(duration) ? Math.min(maximum, Math.max(0, duration)) : 0;\n};\n\nconst waitForRetry = (\n  result: AttemptResult,\n  attempt: number,\n  config: ResolvedConfig,\n): Promise<void> => {\n  const exponentialCap = Math.min(config.retryMaxMs, config.retryBaseMs * 2 ** (attempt - 1));\n  const jitter = Math.floor(Math.random() * exponentialCap);\n  const delay = Math.max(jitter, result.retryAfterMs ?? 0);\n  return delay > 0 ? new Promise((resolve) => setTimeout(resolve, delay)) : Promise.resolve();\n};\n\nexport class BatchTransport {\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly report: ReportDiagnostic,\n  ) {}\n\n  async send(body: string, count: number): Promise<boolean> {\n    for (let attempt = 1; attempt <= this.config.maxAttempts; attempt++) {\n      const result = await this.sendAttempt(body);\n      if (result.successful) return true;\n      const detail = {\n        count,\n        attempt,\n        ...(result.httpStatus === undefined ? {} : { httpStatus: result.httpStatus }),\n      };\n      if (!result.retryable || attempt === this.config.maxAttempts) {\n        this.report({ code: 'delivery_failed', ...detail });\n        return false;\n      }\n      this.report({ code: 'delivery_retry', ...detail });\n      await waitForRetry(result, attempt, this.config);\n    }\n    return false;\n  }\n\n  private async sendAttempt(body: string): Promise<AttemptResult> {\n    const controller = new AbortController();\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    try {\n      const timeout = new Promise<never>((_resolve, reject) => {\n        timer = setTimeout(() => {\n          controller.abort();\n          reject(new Error('Telemetry request timed out'));\n        }, this.config.requestTimeoutMs);\n      });\n      const request = this.config.fetch(this.config.endpoint, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${this.config.apiKey}`,\n        },\n        body,\n        signal: controller.signal,\n        redirect: 'error',\n      });\n      const response = await Promise.race([request, timeout]);\n      // No response/error body is read: it may contain server or credential details.\n      void response.body?.cancel().catch(() => undefined);\n      return {\n        successful: response.ok,\n        retryable:\n          response.status === 408 ||\n          response.status === 429 ||\n          (response.status >= 500 && response.status <= 599),\n        httpStatus: response.status,\n        retryAfterMs: retryAfterDelay(response.headers.get('Retry-After'), this.config.retryMaxMs),\n      };\n    } catch {\n      return { successful: false, retryable: true };\n    } finally {\n      if (timer !== undefined) clearTimeout(timer);\n    }\n  }\n}\n","import type { TraceEvent } from '@traceai/shared';\nexport { sanitizeErrorSummary } from '@traceai/shared';\nexport { snapshotTraceMetadata } from './events';\nimport { createBatch } from './batching';\nimport { resolveConfig, type ResolvedConfig } from './config';\nimport { createDiagnosticReporter, type ReportDiagnostic } from './diagnostics';\nimport { captureOperation, classifyError, snapshotCompletedEvent } from './events';\nimport { BatchTransport } from './transport';\nimport type {\n  CompletedTrace,\n  DeliveryResult,\n  TraceAIConfig,\n  TraceOptions,\n  TraceSpan,\n} from './types';\n\nexport type {\n  CompletedTrace,\n  DeliveryResult,\n  Diagnostic,\n  TraceAIConfig,\n  TraceMetadata,\n  TraceOptions,\n  TraceSpan,\n  Usage,\n} from './types';\n\ninterface QueuedEvent {\n  readonly event: TraceEvent;\n  readonly settle?: (result: DeliveryResult) => void;\n}\nconst inactiveSpan: TraceSpan = Object.freeze({ setUsage: () => undefined });\nconst delivered: DeliveryResult = Object.freeze({ status: 'delivered' });\nconst deliveryFailed: DeliveryResult = Object.freeze({\n  status: 'dropped',\n  reason: 'delivery_failed',\n});\n\n/** A best-effort in-memory telemetry client; operation results and errors always win. */\nexport class TraceAI {\n  private readonly config: ResolvedConfig;\n  private readonly report: ReportDiagnostic;\n  private readonly transport: BatchTransport;\n  private readonly interval?: ReturnType<typeof setInterval>;\n  private queue: readonly QueuedEvent[] = [];\n  private inFlightCount = 0;\n  private drainPromise?: Promise<void>;\n  private drainAllRequested = false;\n  private shutdownPromise?: Promise<void>;\n  private acceptingTraces = true;\n  private activeCount = 0;\n  private activeBarrier?: Promise<void>;\n  private resolveActiveBarrier?: () => void;\n\n  constructor(config: TraceAIConfig) {\n    this.config = resolveConfig(config);\n    this.report = createDiagnosticReporter(this.config.onDiagnostic);\n    this.transport = new BatchTransport(this.config, this.report);\n    if (this.config.enabled) {\n      this.interval = setInterval(() => {\n        void this.flush();\n      }, this.config.flushIntervalMs);\n      // Node applications must opt in to draining; background timers must not keep them alive.\n      if (typeof this.interval === 'object' && 'unref' in this.interval) this.interval.unref();\n    }\n  }\n\n  async trace<T>(options: TraceOptions, operation: (span: TraceSpan) => Promise<T>): Promise<T> {\n    if (!this.config.enabled) return operation(inactiveSpan);\n    if (!this.acceptingTraces) {\n      this.report({ code: 'client_closed', count: 1 });\n      return operation(inactiveSpan);\n    }\n    // Constant state, independent of callback concurrency. Register before reentrant diagnostics.\n    this.activeCount++;\n    const capture = captureOperation(options, this.report);\n    let errorType: TraceEvent['errorType'];\n    let errorSummary: string | undefined;\n    try {\n      return await operation(capture?.span ?? inactiveSpan);\n    } catch (error) {\n      errorType = classifyError(error);\n      errorSummary = capture?.summarizeError(error);\n      throw error;\n    } finally {\n      this.completeSafely(() => capture?.complete(errorType, errorSummary));\n      this.finishActiveOperation();\n    }\n  }\n\n  /** Validate and snapshot an already-completed event. Resolves only on delivery or explicit drop. */\n  record(event: CompletedTrace): Promise<DeliveryResult> {\n    if (!this.config.enabled) return Promise.resolve({ status: 'dropped', reason: 'disabled' });\n    if (!this.acceptingTraces) {\n      this.report({ code: 'client_closed', count: 1 });\n      return Promise.resolve({ status: 'dropped', reason: 'client_closed' });\n    }\n    const snapshot = snapshotCompletedEvent(event);\n    if (!snapshot) {\n      this.report({ code: 'invalid_event', count: 1 });\n      return Promise.resolve({ status: 'dropped', reason: 'invalid_event' });\n    }\n    return new Promise((settle) => this.enqueue({ event: snapshot, settle }));\n  }\n\n  /** Singleflight best-effort drain. Use record() receipts when acknowledged delivery matters. */\n  flush(): Promise<void> {\n    if (!this.queue.length && !this.drainPromise) return Promise.resolve();\n    this.drainAllRequested = true;\n    return this.startDrain();\n  }\n\n  /** Stops new telemetry, awaits already-started operations, then drains. Idempotent. */\n  shutdown(): Promise<void> {\n    if (this.shutdownPromise) return this.shutdownPromise;\n    this.acceptingTraces = false;\n    if (this.interval !== undefined) clearInterval(this.interval);\n    this.shutdownPromise = this.waitForActiveOperations().then(async () => {\n      await this.flush();\n      // An older drain may have observed an empty queue just before the active barrier.\n      while (this.queue.length) await this.flush();\n    });\n    return this.shutdownPromise;\n  }\n\n  private waitForActiveOperations(): Promise<void> {\n    if (!this.activeCount) return Promise.resolve();\n    this.activeBarrier ??= new Promise((resolve) => {\n      this.resolveActiveBarrier = resolve;\n    });\n    return this.activeBarrier;\n  }\n\n  private finishActiveOperation(): void {\n    this.activeCount--;\n    if (this.activeCount === 0) this.resolveActiveBarrier?.();\n  }\n\n  private completeSafely(complete: () => TraceEvent | undefined): void {\n    try {\n      const event = complete();\n      if (event) this.enqueue({ event });\n    } catch {\n      this.report({ code: 'invalid_event', count: 1 });\n    }\n  }\n\n  private enqueue(entry: QueuedEvent): void {\n    if (this.queue.length + this.inFlightCount >= this.config.maxQueueSize) {\n      this.report({ code: 'queue_full', count: 1 });\n      entry.settle?.({ status: 'dropped', reason: 'queue_full' });\n      return;\n    }\n    this.queue = [...this.queue, entry];\n    if (this.queue.length >= this.config.batchSize)\n      queueMicrotask(() => {\n        void this.startDrain();\n      });\n  }\n\n  private startDrain(): Promise<void> {\n    if (this.drainPromise) return this.drainPromise;\n    if (!this.shouldDrain()) return Promise.resolve();\n    let finish!: () => void;\n    const draining = new Promise<void>((resolve) => {\n      finish = resolve;\n    });\n    this.drainPromise = draining;\n    void this.drainQueue(finish);\n    return draining;\n  }\n\n  private shouldDrain(): boolean {\n    return (\n      this.queue.length > 0 &&\n      (this.drainAllRequested || this.queue.length >= this.config.batchSize)\n    );\n  }\n\n  private async drainQueue(finish: () => void): Promise<void> {\n    try {\n      while (this.shouldDrain()) await this.sendNextBatch();\n    } catch {\n      this.report({ code: 'delivery_failed', count: this.queue.length });\n      for (const entry of this.queue) entry.settle?.(deliveryFailed);\n      this.queue = [];\n    } finally {\n      // Clear state and resolve atomically, without promise-chain gaps that strand new events.\n      this.drainPromise = undefined;\n      this.drainAllRequested = false;\n      finish();\n    }\n  }\n\n  private async sendNextBatch(): Promise<void> {\n    const { events, body } = createBatch(\n      this.queue.slice(0, this.config.batchSize).map(({ event }) => event),\n      this.config.batchSize,\n    );\n    if (!events.length) {\n      this.queue[0]?.settle?.({ status: 'dropped', reason: 'invalid_event' });\n      this.queue = this.queue.slice(1);\n      this.report({ code: 'invalid_event', count: 1 });\n      return;\n    }\n    const entries = this.queue.slice(0, events.length);\n    this.queue = this.queue.slice(events.length);\n    this.inFlightCount = entries.length;\n    let result = deliveryFailed;\n    try {\n      if (await this.transport.send(body, entries.length)) result = delivered;\n    } finally {\n      this.inFlightCount = 0;\n      for (const entry of entries) entry.settle?.(result);\n    }\n  }\n}\n"],"mappings":"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","names":["z","z","z","z"]}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@akai_80percent/traceai-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Non-blocking, privacy-first telemetry for asynchronous AI operations",
+  "private": false,
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Metricra-code/traceai.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/Metricra-code/traceai/blob/main/docs/sdk.md",
+  "bugs": {
+    "url": "https://github.com/Metricra-code/traceai/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsup --config tsup.config.ts"
+  },
+  "dependencies": {
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@traceai/shared": "0.1.0"
+  }
+}