@deeptracer/core 0.5.1 → 0.6.1

package/README.md

@@ -83,11 +83,10 @@ Pass a `LoggerConfig` object to `createLogger()`:
 
 ```ts
 const logger = createLogger({
-  // Required
-  service: "api",                // Service name within the product
-  environment: "production",     // "production" or "staging"
-  endpoint: "https://dt.co",     // DeepTracer ingestion endpoint URL
-  apiKey: "dt_xxx",    // API key for authentication
+  apiKey: "dt_xxx",              // API key (reads DEEPTRACER_KEY env var if omitted)
+  endpoint: "https://dt.co",     // Ingestion endpoint (reads DEEPTRACER_ENDPOINT if omitted)
+  service: "api",                // Service name (default: "server")
+  environment: "production",     // Deployment environment (default: NODE_ENV or "production")
 
   // Optional
   batchSize: 50,                 // Logs to buffer before sending (default: 50)
@@ -96,15 +95,17 @@ const logger = createLogger({
 })
 ```
 
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `service` | `string` | Yes | -- | Service name (e.g., `"api"`, `"worker"`, `"web"`) |
-| `environment` | `"production" \| "staging"` | Yes | -- | Deployment environment |
-| `endpoint` | `string` | Yes | -- | DeepTracer ingestion endpoint URL |
-| `apiKey` | `string` | Yes | -- | API key (prefix: `dt_`) |
-| `batchSize` | `number` | No | `50` | Number of log entries to buffer before flushing |
-| `flushIntervalMs` | `number` | No | `5000` | Milliseconds between automatic flushes |
-| `debug` | `boolean` | No | `false` | When `true`, all log calls also print to the console |
+> **Graceful degradation:** If `apiKey` or `endpoint` is missing, `createLogger()` prints a warning and runs in local-only mode — all methods work but no data is sent. The SDK never throws on missing config.
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `apiKey` | `string` | `DEEPTRACER_KEY` env var | API key (prefix: `dt_`). If missing, runs in local-only mode (no data sent). |
+| `endpoint` | `string` | `DEEPTRACER_ENDPOINT` env var | DeepTracer ingestion endpoint URL. If missing, runs in local-only mode. |
+| `service` | `string` | `"server"` | Service name (e.g., `"api"`, `"worker"`, `"web"`) |
+| `environment` | `string` | `NODE_ENV` / `"production"` | Deployment environment |
+| `batchSize` | `number` | `50` | Number of log entries to buffer before flushing |
+| `flushIntervalMs` | `number` | `5000` | Milliseconds between automatic flushes |
+| `debug` | `boolean` | `false` | When `true`, all log calls also print to the console |
 
 ## API Reference
 

package/dist/{chunk-HOUMS3SU.js → chunk-Y3RCGZ3H.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var SDK_VERSION = "0.5.1";
+var SDK_VERSION = "0.6.1";
 var SDK_NAME = "core";
 
 // src/transport.ts

package/dist/index.cjs

@@ -23,7 +23,8 @@ __export(index_exports, {
   Logger: () => Logger,
   SDK_NAME: () => SDK_NAME,
   SDK_VERSION: () => SDK_VERSION,
-  createLogger: () => createLogger
+  createLogger: () => createLogger,
+  noopLogger: () => noopLogger
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -62,7 +63,7 @@ var Batcher = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.5.1";
+var SDK_VERSION = "0.6.1";
 var SDK_NAME = "core";
 
 // src/transport.ts
@@ -720,10 +721,64 @@ var Logger = class _Logger {
 function createLogger(config) {
   return new Logger(config);
 }
+
+// src/noop-logger.ts
+var NOOP_INACTIVE_SPAN = {
+  traceId: "0".repeat(32),
+  spanId: "0".repeat(16),
+  parentSpanId: "",
+  operation: "noop",
+  end: () => {
+  },
+  getHeaders: () => ({}),
+  startSpan: (_operation, fn) => fn(NOOP_SPAN),
+  startInactiveSpan: () => NOOP_INACTIVE_SPAN
+};
+var NOOP_SPAN = {
+  traceId: NOOP_INACTIVE_SPAN.traceId,
+  spanId: NOOP_INACTIVE_SPAN.spanId,
+  parentSpanId: NOOP_INACTIVE_SPAN.parentSpanId,
+  operation: NOOP_INACTIVE_SPAN.operation,
+  getHeaders: () => ({})
+};
+var noop = () => {
+};
+var noopLogger = {
+  // Logging — silent
+  debug: noop,
+  info: noop,
+  warn: noop,
+  error: noop,
+  // User context — silent
+  setUser: noop,
+  clearUser: noop,
+  // Tags & context — silent
+  setTags: noop,
+  clearTags: noop,
+  setContext: noop,
+  clearContext: noop,
+  // Breadcrumbs — silent
+  addBreadcrumb: noop,
+  // Child loggers — return self
+  withContext: () => noopLogger,
+  forRequest: () => noopLogger,
+  // Error capture — silent
+  captureError: noop,
+  // LLM usage — silent
+  llmUsage: noop,
+  // Tracing — call the callback, return its result
+  startSpan: (_operation, fn) => fn(NOOP_SPAN),
+  startInactiveSpan: () => NOOP_INACTIVE_SPAN,
+  wrap: (_operation, fn) => fn,
+  // Lifecycle — resolve immediately
+  flush: noop,
+  destroy: () => Promise.resolve()
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Logger,
   SDK_NAME,
   SDK_VERSION,
-  createLogger
+  createLogger,
+  noopLogger
 });

package/dist/index.d.cts

@@ -1,7 +1,24 @@
-export { B as BeforeSendEvent, a as Breadcrumb, E as ErrorReport, I as InactiveSpan, L as LLMUsageReport, b as LogEntry, c as LogLevel, d as Logger, e as LoggerConfig, M as MiddlewareOptions, S as Span, f as SpanData, U as User, g as createLogger } from './logger-BzzHo1HP.cjs';
+import { L as Logger } from './logger-CzZg2_vM.cjs';
+export { B as BeforeSendEvent, a as Breadcrumb, E as ErrorReport, I as InactiveSpan, b as LLMUsageReport, c as LogEntry, d as LogLevel, e as LoggerConfig, M as MiddlewareOptions, S as Span, f as SpanData, U as User, g as createLogger } from './logger-CzZg2_vM.cjs';
+
+/**
+ * A Logger-compatible object where every method is a silent no-op.
+ *
+ * Returned by `init()` when API key or endpoint is missing, and by
+ * `useLogger()` when the DeepTracer provider hasn't initialized yet (SSR/SSG).
+ *
+ * This ensures the SDK never crashes your app — if config is missing,
+ * all logging calls silently do nothing.
+ *
+ * - No timers, no Transport, no network requests, no console output
+ * - `withContext()` and `forRequest()` return the same noopLogger
+ * - `startSpan(op, fn)` still calls `fn` and returns its result
+ * - `flush()` and `destroy()` resolve immediately
+ */
+declare const noopLogger: Logger;
 
 /** SDK version. Update on each release. */
-declare const SDK_VERSION = "0.5.1";
+declare const SDK_VERSION = "0.6.1";
 declare const SDK_NAME = "core";
 
-export { SDK_NAME, SDK_VERSION };
+export { Logger, SDK_NAME, SDK_VERSION, noopLogger };

package/dist/index.d.ts

@@ -1,7 +1,24 @@
-export { B as BeforeSendEvent, a as Breadcrumb, E as ErrorReport, I as InactiveSpan, L as LLMUsageReport, b as LogEntry, c as LogLevel, d as Logger, e as LoggerConfig, M as MiddlewareOptions, S as Span, f as SpanData, U as User, g as createLogger } from './logger-BzzHo1HP.js';
+import { L as Logger } from './logger-CzZg2_vM.js';
+export { B as BeforeSendEvent, a as Breadcrumb, E as ErrorReport, I as InactiveSpan, b as LLMUsageReport, c as LogEntry, d as LogLevel, e as LoggerConfig, M as MiddlewareOptions, S as Span, f as SpanData, U as User, g as createLogger } from './logger-CzZg2_vM.js';
+
+/**
+ * A Logger-compatible object where every method is a silent no-op.
+ *
+ * Returned by `init()` when API key or endpoint is missing, and by
+ * `useLogger()` when the DeepTracer provider hasn't initialized yet (SSR/SSG).
+ *
+ * This ensures the SDK never crashes your app — if config is missing,
+ * all logging calls silently do nothing.
+ *
+ * - No timers, no Transport, no network requests, no console output
+ * - `withContext()` and `forRequest()` return the same noopLogger
+ * - `startSpan(op, fn)` still calls `fn` and returns its result
+ * - `flush()` and `destroy()` resolve immediately
+ */
+declare const noopLogger: Logger;
 
 /** SDK version. Update on each release. */
-declare const SDK_VERSION = "0.5.1";
+declare const SDK_VERSION = "0.6.1";
 declare const SDK_NAME = "core";
 
-export { SDK_NAME, SDK_VERSION };
+export { Logger, SDK_NAME, SDK_VERSION, noopLogger };

package/dist/index.js

@@ -3,10 +3,64 @@ import {
   SDK_NAME,
   SDK_VERSION,
   createLogger
-} from "./chunk-HOUMS3SU.js";
+} from "./chunk-Y3RCGZ3H.js";
+
+// src/noop-logger.ts
+var NOOP_INACTIVE_SPAN = {
+  traceId: "0".repeat(32),
+  spanId: "0".repeat(16),
+  parentSpanId: "",
+  operation: "noop",
+  end: () => {
+  },
+  getHeaders: () => ({}),
+  startSpan: (_operation, fn) => fn(NOOP_SPAN),
+  startInactiveSpan: () => NOOP_INACTIVE_SPAN
+};
+var NOOP_SPAN = {
+  traceId: NOOP_INACTIVE_SPAN.traceId,
+  spanId: NOOP_INACTIVE_SPAN.spanId,
+  parentSpanId: NOOP_INACTIVE_SPAN.parentSpanId,
+  operation: NOOP_INACTIVE_SPAN.operation,
+  getHeaders: () => ({})
+};
+var noop = () => {
+};
+var noopLogger = {
+  // Logging — silent
+  debug: noop,
+  info: noop,
+  warn: noop,
+  error: noop,
+  // User context — silent
+  setUser: noop,
+  clearUser: noop,
+  // Tags & context — silent
+  setTags: noop,
+  clearTags: noop,
+  setContext: noop,
+  clearContext: noop,
+  // Breadcrumbs — silent
+  addBreadcrumb: noop,
+  // Child loggers — return self
+  withContext: () => noopLogger,
+  forRequest: () => noopLogger,
+  // Error capture — silent
+  captureError: noop,
+  // LLM usage — silent
+  llmUsage: noop,
+  // Tracing — call the callback, return its result
+  startSpan: (_operation, fn) => fn(NOOP_SPAN),
+  startInactiveSpan: () => NOOP_INACTIVE_SPAN,
+  wrap: (_operation, fn) => fn,
+  // Lifecycle — resolve immediately
+  flush: noop,
+  destroy: () => Promise.resolve()
+};
 export {
   Logger,
   SDK_NAME,
   SDK_VERSION,
-  createLogger
+  createLogger,
+  noopLogger
 };

package/dist/internal.cjs

@@ -63,7 +63,7 @@ var Batcher = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.5.1";
+var SDK_VERSION = "0.6.1";
 var SDK_NAME = "core";
 
 // src/transport.ts

package/dist/internal.d.cts

@@ -1,5 +1,5 @@
-import { e as LoggerConfig, b as LogEntry, E as ErrorReport, f as SpanData } from './logger-BzzHo1HP.cjs';
-export { d as Logger, h as LoggerState, M as MiddlewareOptions, _ as _originalConsole, p as parseTraceparent } from './logger-BzzHo1HP.cjs';
+import { e as LoggerConfig, c as LogEntry, E as ErrorReport, f as SpanData } from './logger-CzZg2_vM.cjs';
+export { L as Logger, h as LoggerState, M as MiddlewareOptions, _ as _originalConsole, p as parseTraceparent } from './logger-CzZg2_vM.cjs';
 
 /**
  * HTTP transport for sending data to the DeepTracer ingestion API.

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
-import { e as LoggerConfig, b as LogEntry, E as ErrorReport, f as SpanData } from './logger-BzzHo1HP.js';
-export { d as Logger, h as LoggerState, M as MiddlewareOptions, _ as _originalConsole, p as parseTraceparent } from './logger-BzzHo1HP.js';
+import { e as LoggerConfig, c as LogEntry, E as ErrorReport, f as SpanData } from './logger-CzZg2_vM.js';
+export { L as Logger, h as LoggerState, M as MiddlewareOptions, _ as _originalConsole, p as parseTraceparent } from './logger-CzZg2_vM.js';
 
 /**
  * HTTP transport for sending data to the DeepTracer ingestion API.

package/dist/internal.js

@@ -3,7 +3,7 @@ import {
   Transport,
   _originalConsole,
   parseTraceparent
-} from "./chunk-HOUMS3SU.js";
+} from "./chunk-Y3RCGZ3H.js";
 
 // src/internal.ts
 function safeStringify(value) {

package/dist/{logger-BzzHo1HP.d.cts → logger-CzZg2_vM.d.cts}

@@ -397,4 +397,4 @@ declare class Logger {
 /** Create a new DeepTracer logger instance. */
 declare function createLogger(config: LoggerConfig): Logger;
 
-export { type BeforeSendEvent as B, type ErrorReport as E, type InactiveSpan as I, type LLMUsageReport as L, type MiddlewareOptions as M, type Span as S, type User as U, _originalConsole as _, type Breadcrumb as a, type LogEntry as b, type LogLevel as c, Logger as d, type LoggerConfig as e, type SpanData as f, createLogger as g, type LoggerState as h, parseTraceparent as p };
+export { type BeforeSendEvent as B, type ErrorReport as E, type InactiveSpan as I, Logger as L, type MiddlewareOptions as M, type Span as S, type User as U, _originalConsole as _, type Breadcrumb as a, type LLMUsageReport as b, type LogEntry as c, type LogLevel as d, type LoggerConfig as e, type SpanData as f, createLogger as g, type LoggerState as h, parseTraceparent as p };

package/dist/{logger-BzzHo1HP.d.ts → logger-CzZg2_vM.d.ts}

@@ -397,4 +397,4 @@ declare class Logger {
 /** Create a new DeepTracer logger instance. */
 declare function createLogger(config: LoggerConfig): Logger;
 
-export { type BeforeSendEvent as B, type ErrorReport as E, type InactiveSpan as I, type LLMUsageReport as L, type MiddlewareOptions as M, type Span as S, type User as U, _originalConsole as _, type Breadcrumb as a, type LogEntry as b, type LogLevel as c, Logger as d, type LoggerConfig as e, type SpanData as f, createLogger as g, type LoggerState as h, parseTraceparent as p };
+export { type BeforeSendEvent as B, type ErrorReport as E, type InactiveSpan as I, Logger as L, type MiddlewareOptions as M, type Span as S, type User as U, _originalConsole as _, type Breadcrumb as a, type LLMUsageReport as b, type LogEntry as c, type LogLevel as d, type LoggerConfig as e, type SpanData as f, createLogger as g, type LoggerState as h, parseTraceparent as p };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeptracer/core",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "Core SDK for DeepTracer — Logger class, types, transport, batcher, tracing",
   "type": "module",
   "main": "dist/index.cjs",