@glasstrace/sdk 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -1,8 +1,126 @@
-import { SdkDiagnosticCode, GlasstraceEnvVars, GlasstraceOptions, SessionId, AnonApiKey, CaptureConfig, SdkInitResponse, ImportGraphPayload, SdkHealthReport, SourceMapUploadResponse } from '@glasstrace/protocol';
+import * as z from './v4/classic/external.cjs';
 import { Context } from '@opentelemetry/api';
 import { SpanProcessor, Span, ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
 import { ExportResult } from '@opentelemetry/core';
 
+/** Anonymous API key: `gt_anon_` + 48 hex chars. */
+declare const AnonApiKeySchema: z.core.$ZodBranded<z.ZodString, "AnonApiKey", "out">;
+type AnonApiKey = z.infer<typeof AnonApiKeySchema>;
+/** Session ID: 16 hex chars (deterministic, derived from API key + time window). */
+declare const SessionIdSchema: z.core.$ZodBranded<z.ZodString, "SessionId", "out">;
+type SessionId = z.infer<typeof SessionIdSchema>;
+
+/**
+ * SDK-specific enums.
+ */
+
+/** Diagnostic codes the SDK can report during health checks. */
+declare const SdkDiagnosticCodeSchema: z.ZodEnum<{
+    ingestion_unreachable: "ingestion_unreachable";
+    ingestion_auth_failed: "ingestion_auth_failed";
+    ingestion_rate_limited: "ingestion_rate_limited";
+    config_sync_failed: "config_sync_failed";
+    source_map_upload_failed: "source_map_upload_failed";
+}>;
+type SdkDiagnosticCode = z.infer<typeof SdkDiagnosticCodeSchema>;
+
+/**
+ * SDK configuration types.
+ */
+
+/** SDK capture configuration: which events to capture. */
+declare const CaptureConfigSchema: z.ZodObject<{
+    requestBodies: z.ZodBoolean;
+    queryParamValues: z.ZodBoolean;
+    envVarValues: z.ZodBoolean;
+    fullConsoleOutput: z.ZodBoolean;
+    importGraph: z.ZodBoolean;
+    consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type CaptureConfig = z.infer<typeof CaptureConfigSchema>;
+/** Developer-facing config for registerGlasstrace(). */
+declare const GlasstraceOptionsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    forceEnable: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type GlasstraceOptions = z.infer<typeof GlasstraceOptionsSchema>;
+/** All recognized SDK environment variables. */
+declare const GlasstraceEnvVarsSchema: z.ZodObject<{
+    GLASSTRACE_API_KEY: z.ZodOptional<z.ZodString>;
+    GLASSTRACE_FORCE_ENABLE: z.ZodOptional<z.ZodString>;
+    GLASSTRACE_ENV: z.ZodOptional<z.ZodString>;
+    GLASSTRACE_COVERAGE_MAP: z.ZodOptional<z.ZodString>;
+    NODE_ENV: z.ZodOptional<z.ZodString>;
+    VERCEL_ENV: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GlasstraceEnvVars = z.infer<typeof GlasstraceEnvVarsSchema>;
+
+/**
+ * Wire format types for SDK ↔ backend communication.
+ *
+ * These schemas define the request/response shapes for:
+ * - SDK initialization (POST /v1/sdk/init)
+ * - SDK health diagnostics (embedded in init requests)
+ * - Discovery endpoint (GET /__glasstrace/config)
+ * - Source map upload (POST /v1/source-maps)
+ */
+
+/** Test file import relationships, embedded in SDK init request. */
+declare const ImportGraphPayloadSchema: z.ZodObject<{
+    buildHash: z.core.$ZodBranded<z.ZodString, "BuildHash", "out">;
+    graph: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type ImportGraphPayload = z.infer<typeof ImportGraphPayloadSchema>;
+/** SDK health diagnostics included in init requests. */
+declare const SdkHealthReportSchema: z.ZodObject<{
+    tracesExportedSinceLastInit: z.ZodNumber;
+    tracesDropped: z.ZodNumber;
+    initFailures: z.ZodNumber;
+    configAge: z.ZodNumber;
+    sdkVersion: z.ZodString;
+}, z.core.$strip>;
+type SdkHealthReport = z.infer<typeof SdkHealthReportSchema>;
+/**
+ * Response from POST /v1/sdk/init.
+ *
+ * Note: SdkInitRequest is intentionally NOT in the protocol package.
+ * The request schema includes backend-specific types (TierLimits,
+ * SubscriptionStatus) that are not part of the public contract.
+ * The backend owns the request validation; the SDK only needs to
+ * understand the response.
+ */
+declare const SdkInitResponseSchema: z.ZodObject<{
+    config: z.ZodObject<{
+        requestBodies: z.ZodBoolean;
+        queryParamValues: z.ZodBoolean;
+        envVarValues: z.ZodBoolean;
+        fullConsoleOutput: z.ZodBoolean;
+        importGraph: z.ZodBoolean;
+        consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    subscriptionStatus: z.ZodString;
+    linkedAccountId: z.ZodOptional<z.ZodString>;
+    minimumSdkVersion: z.ZodString;
+    apiVersion: z.ZodString;
+    tierLimits: z.ZodObject<{
+        tracesPerMinute: z.ZodNumber;
+        storageTtlHours: z.ZodNumber;
+        maxTraceSizeBytes: z.ZodNumber;
+        maxConcurrentSessions: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type SdkInitResponse = z.infer<typeof SdkInitResponseSchema>;
+/** Response from POST /v1/source-maps. */
+declare const SourceMapUploadResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    buildHash: z.core.$ZodBranded<z.ZodString, "BuildHash", "out">;
+    fileCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+type SourceMapUploadResponse = z.infer<typeof SourceMapUploadResponseSchema>;
+
 /**
  * Internal SDK error class with a typed diagnostic code.
  * Caught at the boundary and converted to a log message + diagnostic entry.

package/dist/index.d.ts

@@ -1,8 +1,126 @@
-import { SdkDiagnosticCode, GlasstraceEnvVars, GlasstraceOptions, SessionId, AnonApiKey, CaptureConfig, SdkInitResponse, ImportGraphPayload, SdkHealthReport, SourceMapUploadResponse } from '@glasstrace/protocol';
+import * as z from './v4/classic/external.cjs';
 import { Context } from '@opentelemetry/api';
 import { SpanProcessor, Span, ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
 import { ExportResult } from '@opentelemetry/core';
 
+/** Anonymous API key: `gt_anon_` + 48 hex chars. */
+declare const AnonApiKeySchema: z.core.$ZodBranded<z.ZodString, "AnonApiKey", "out">;
+type AnonApiKey = z.infer<typeof AnonApiKeySchema>;
+/** Session ID: 16 hex chars (deterministic, derived from API key + time window). */
+declare const SessionIdSchema: z.core.$ZodBranded<z.ZodString, "SessionId", "out">;
+type SessionId = z.infer<typeof SessionIdSchema>;
+
+/**
+ * SDK-specific enums.
+ */
+
+/** Diagnostic codes the SDK can report during health checks. */
+declare const SdkDiagnosticCodeSchema: z.ZodEnum<{
+    ingestion_unreachable: "ingestion_unreachable";
+    ingestion_auth_failed: "ingestion_auth_failed";
+    ingestion_rate_limited: "ingestion_rate_limited";
+    config_sync_failed: "config_sync_failed";
+    source_map_upload_failed: "source_map_upload_failed";
+}>;
+type SdkDiagnosticCode = z.infer<typeof SdkDiagnosticCodeSchema>;
+
+/**
+ * SDK configuration types.
+ */
+
+/** SDK capture configuration: which events to capture. */
+declare const CaptureConfigSchema: z.ZodObject<{
+    requestBodies: z.ZodBoolean;
+    queryParamValues: z.ZodBoolean;
+    envVarValues: z.ZodBoolean;
+    fullConsoleOutput: z.ZodBoolean;
+    importGraph: z.ZodBoolean;
+    consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type CaptureConfig = z.infer<typeof CaptureConfigSchema>;
+/** Developer-facing config for registerGlasstrace(). */
+declare const GlasstraceOptionsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    forceEnable: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type GlasstraceOptions = z.infer<typeof GlasstraceOptionsSchema>;
+/** All recognized SDK environment variables. */
+declare const GlasstraceEnvVarsSchema: z.ZodObject<{
+    GLASSTRACE_API_KEY: z.ZodOptional<z.ZodString>;
+    GLASSTRACE_FORCE_ENABLE: z.ZodOptional<z.ZodString>;
+    GLASSTRACE_ENV: z.ZodOptional<z.ZodString>;
+    GLASSTRACE_COVERAGE_MAP: z.ZodOptional<z.ZodString>;
+    NODE_ENV: z.ZodOptional<z.ZodString>;
+    VERCEL_ENV: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GlasstraceEnvVars = z.infer<typeof GlasstraceEnvVarsSchema>;
+
+/**
+ * Wire format types for SDK ↔ backend communication.
+ *
+ * These schemas define the request/response shapes for:
+ * - SDK initialization (POST /v1/sdk/init)
+ * - SDK health diagnostics (embedded in init requests)
+ * - Discovery endpoint (GET /__glasstrace/config)
+ * - Source map upload (POST /v1/source-maps)
+ */
+
+/** Test file import relationships, embedded in SDK init request. */
+declare const ImportGraphPayloadSchema: z.ZodObject<{
+    buildHash: z.core.$ZodBranded<z.ZodString, "BuildHash", "out">;
+    graph: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type ImportGraphPayload = z.infer<typeof ImportGraphPayloadSchema>;
+/** SDK health diagnostics included in init requests. */
+declare const SdkHealthReportSchema: z.ZodObject<{
+    tracesExportedSinceLastInit: z.ZodNumber;
+    tracesDropped: z.ZodNumber;
+    initFailures: z.ZodNumber;
+    configAge: z.ZodNumber;
+    sdkVersion: z.ZodString;
+}, z.core.$strip>;
+type SdkHealthReport = z.infer<typeof SdkHealthReportSchema>;
+/**
+ * Response from POST /v1/sdk/init.
+ *
+ * Note: SdkInitRequest is intentionally NOT in the protocol package.
+ * The request schema includes backend-specific types (TierLimits,
+ * SubscriptionStatus) that are not part of the public contract.
+ * The backend owns the request validation; the SDK only needs to
+ * understand the response.
+ */
+declare const SdkInitResponseSchema: z.ZodObject<{
+    config: z.ZodObject<{
+        requestBodies: z.ZodBoolean;
+        queryParamValues: z.ZodBoolean;
+        envVarValues: z.ZodBoolean;
+        fullConsoleOutput: z.ZodBoolean;
+        importGraph: z.ZodBoolean;
+        consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    subscriptionStatus: z.ZodString;
+    linkedAccountId: z.ZodOptional<z.ZodString>;
+    minimumSdkVersion: z.ZodString;
+    apiVersion: z.ZodString;
+    tierLimits: z.ZodObject<{
+        tracesPerMinute: z.ZodNumber;
+        storageTtlHours: z.ZodNumber;
+        maxTraceSizeBytes: z.ZodNumber;
+        maxConcurrentSessions: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type SdkInitResponse = z.infer<typeof SdkInitResponseSchema>;
+/** Response from POST /v1/source-maps. */
+declare const SourceMapUploadResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    buildHash: z.core.$ZodBranded<z.ZodString, "BuildHash", "out">;
+    fileCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+type SourceMapUploadResponse = z.infer<typeof SourceMapUploadResponseSchema>;
+
 /**
  * Internal SDK error class with a typed diagnostic code.
  * Caught at the boundary and converted to a log message + diagnostic entry.

package/dist/index.js

@@ -1,8 +1,17 @@
 import {
+  AnonApiKeySchema,
+  DEFAULT_CAPTURE_CONFIG,
+  GLASSTRACE_ATTRIBUTE_NAMES,
+  SdkCachedConfigSchema,
+  SdkInitResponseSchema,
+  SessionIdSchema,
+  SourceMapUploadResponseSchema,
   buildImportGraph,
+  createAnonApiKey,
   discoverTestFiles,
   extractImports
-} from "./chunk-BKMITIEZ.js";
+} from "./chunk-CUFIV225.js";
+import "./chunk-PZ5AY32C.js";
 
 // src/errors.ts
 var SdkError = class extends Error {
@@ -66,7 +75,6 @@ function isAnonymousMode(config) {
 
 // src/session.ts
 import { createHash } from "crypto";
-import { SessionIdSchema } from "@glasstrace/protocol";
 var FOUR_HOURS_MS = 4 * 60 * 60 * 1e3;
 var cachedGlasstraceEnv = process.env.GLASSTRACE_ENV;
 var cachedPort = process.env.PORT ?? "3000";
@@ -160,7 +168,6 @@ function classifyFetchTarget(url) {
 // src/anon-key.ts
 import { readFile, writeFile, mkdir, chmod } from "fs/promises";
 import { join } from "path";
-import { AnonApiKeySchema, createAnonApiKey } from "@glasstrace/protocol";
 var GLASSTRACE_DIR = ".glasstrace";
 var ANON_KEY_FILE = "anon_key";
 var ephemeralKeyCache = /* @__PURE__ */ new Map();
@@ -211,11 +218,6 @@ async function getOrCreateAnonKey(projectRoot) {
 import { readFileSync } from "fs";
 import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
 import { join as join2 } from "path";
-import {
-  SdkInitResponseSchema,
-  SdkCachedConfigSchema,
-  DEFAULT_CAPTURE_CONFIG
-} from "@glasstrace/protocol";
 var GLASSTRACE_DIR2 = ".glasstrace";
 var CONFIG_FILE = "config";
 var TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1e3;
@@ -411,7 +413,6 @@ var GlasstraceSpanProcessor = class {
 
 // src/enriching-exporter.ts
 import { SpanKind } from "@opentelemetry/api";
-import { GLASSTRACE_ATTRIBUTE_NAMES } from "@glasstrace/protocol";
 var ATTR = GLASSTRACE_ATTRIBUTE_NAMES;
 var API_KEY_PENDING = "pending";
 var MAX_PENDING_SPANS = 1024;
@@ -1082,7 +1083,7 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.2.0");
+            await performInit(config, anonKey, "0.2.1");
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -1102,7 +1103,7 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.2.0");
+            await performInit(config, anonKey, "0.2.1");
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -1124,7 +1125,7 @@ function registerGlasstrace(options) {
           if (config.verbose) {
             console.info("[glasstrace] Background init firing.");
           }
-          await performInit(config, anonKeyForInit, "0.2.0");
+          await performInit(config, anonKeyForInit, "0.2.1");
           maybeInstallConsoleCapture();
         } catch (err) {
           console.warn(
@@ -1166,9 +1167,6 @@ import * as fs from "fs/promises";
 import * as path from "path";
 import * as crypto from "crypto";
 import { execSync } from "child_process";
-import {
-  SourceMapUploadResponseSchema
-} from "@glasstrace/protocol";
 async function collectSourceMaps(buildDir) {
   const results = [];
   try {