@deeptracer/core 0.4.1 → 0.4.2

package/README.md

@@ -47,11 +47,10 @@ The package ships as both ESM and CJS with full TypeScript declarations. Zero ru
 import { createLogger } from "@deeptracer/core"
 
 const logger = createLogger({
-  product: "my-app",
   service: "api",
   environment: "production",
   endpoint: "https://your-deeptracer.example.com",
-  apiKey: "dt_live_xxx",
+  secretKey: "dt_secret_xxx",
 })
 
 // Structured logging (batched -- sent in groups of 50 or every 5 seconds)
@@ -85,11 +84,10 @@ Pass a `LoggerConfig` object to `createLogger()`:
 ```ts
 const logger = createLogger({
   // Required
-  product: "spotbeam",           // Product name for grouping in the dashboard
   service: "api",                // Service name within the product
   environment: "production",     // "production" or "staging"
   endpoint: "https://dt.co",     // DeepTracer ingestion endpoint URL
-  apiKey: "dt_live_xxx",         // API key for authentication
+  secretKey: "dt_secret_xxx",    // Server-side API key for authentication
 
   // Optional
   batchSize: 50,                 // Logs to buffer before sending (default: 50)
@@ -100,11 +98,11 @@ const logger = createLogger({
 
 | Field | Type | Required | Default | Description |
 |-------|------|----------|---------|-------------|
-| `product` | `string` | Yes | -- | Product name (e.g., `"spotbeam"`, `"macro"`) |
 | `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 | -- | DeepTracer API key |
+| `secretKey` | `string` | Yes | -- | Server-side API key (prefix: `dt_secret_`) |
+| `publicKey` | `string` | No | -- | Client-side API key (prefix: `dt_public_`) |
 | `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 |
@@ -119,11 +117,10 @@ Create a new `Logger` instance. This is the main entry point.
 import { createLogger } from "@deeptracer/core"
 
 const logger = createLogger({
-  product: "my-app",
   service: "api",
   environment: "production",
   endpoint: "https://your-deeptracer.example.com",
-  apiKey: "dt_live_xxx",
+  secretKey: "dt_secret_xxx",
 })
 ```
 
@@ -439,11 +436,11 @@ process.on("SIGTERM", () => {
 
 ```ts
 interface LoggerConfig {
-  product: string
   service: string
   environment: "production" | "staging"
   endpoint: string
-  apiKey: string
+  secretKey: string
+  publicKey?: string
   batchSize?: number          // default: 50
   flushIntervalMs?: number    // default: 5000
   debug?: boolean             // default: false
@@ -587,9 +584,9 @@ The transport layer sends data to four DeepTracer ingestion endpoints:
 | `POST /ingest/llm` | Immediate | LLM usage reports |
 
 All requests include:
-- `Authorization: Bearer <apiKey>` header
+- `Authorization: Bearer <secretKey>` header
 - `Content-Type: application/json` header
-- `product`, `service`, and `environment` fields in the JSON body
+- `service` and `environment` fields in the JSON body
 
 If a request fails, a warning is logged to the console. The SDK does not retry failed requests -- it is designed to be non-blocking and never crash your application.
 

package/dist/{chunk-YBQXVNNR.js → chunk-IWPXOBZV.js}

@@ -1,11 +1,14 @@
 // src/version.ts
-var SDK_VERSION = "0.4.1";
+var SDK_VERSION = "0.4.2";
 var SDK_NAME = "core";
 
 // src/transport.ts
 var Transport = class {
   constructor(config) {
     this.config = config;
+    const hasKey = !!(config.secretKey || config.publicKey);
+    const hasEndpoint = !!config.endpoint;
+    this.disabled = !hasKey || !hasEndpoint;
     if (config.secretKey?.startsWith("dt_secret_") && typeof globalThis.window !== "undefined") {
       console.error(
         "[@deeptracer/core] WARNING: `secretKey` (dt_secret_...) detected in a browser bundle. This exposes your server key to end users. Use `publicKey` (dt_public_...) for client-side code."
@@ -13,6 +16,20 @@ var Transport = class {
     }
   }
   inFlightRequests = /* @__PURE__ */ new Set();
+  /**
+   * When true, all send methods become silent no-ops.
+   * Set automatically when no auth key or no endpoint is configured.
+   * This prevents pointless network requests and console noise during
+   * local development without API keys.
+   */
+  disabled;
+  /**
+   * Tracks which send types (logs, error, trace, LLM usage) have already
+   * logged a failure warning. After the first failure for a given type,
+   * subsequent failures are silently dropped to prevent console spam
+   * (e.g., when the ingestion endpoint is unreachable during development).
+   */
+  warnedLabels = /* @__PURE__ */ new Set();
   /** Resolve the auth key: prefer secretKey (server), fall back to publicKey (client). */
   get authKey() {
     return this.config.secretKey ?? this.config.publicKey ?? "";
@@ -21,8 +38,12 @@ var Transport = class {
    * Send a request with automatic retry and exponential backoff.
    * Retries up to `maxRetries` times on network errors and 5xx responses.
    * Does NOT retry on 4xx (client errors — bad payload, auth failure, etc.).
+   *
+   * After the first total failure for a given label, subsequent failures
+   * are silently dropped (no more console warnings).
    */
   async sendWithRetry(url, body, label, maxRetries = 3) {
+    if (this.disabled) return;
     const baseDelays = [1e3, 2e3, 4e3];
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -35,26 +56,40 @@ var Transport = class {
           },
           body: JSON.stringify(body)
         });
-        if (res.ok) return;
+        if (res.ok) {
+          this.warnedLabels.delete(label);
+          return;
+        }
         if (res.status >= 400 && res.status < 500) {
-          console.warn(
-            `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText}`
-          );
+          if (!this.warnedLabels.has(label)) {
+            this.warnedLabels.add(label);
+            console.warn(
+              `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText}`
+            );
+          }
           return;
         }
         if (attempt < maxRetries) {
           await this.sleep(this.jitter(baseDelays[attempt]));
           continue;
         }
-        console.warn(
-          `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText} (exhausted ${maxRetries} retries)`
-        );
+        if (!this.warnedLabels.has(label)) {
+          this.warnedLabels.add(label);
+          console.warn(
+            `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText} (exhausted ${maxRetries} retries). Suppressing further warnings.`
+          );
+        }
       } catch {
         if (attempt < maxRetries) {
           await this.sleep(this.jitter(baseDelays[attempt]));
           continue;
         }
-        console.warn(`[@deeptracer/core] Failed to send ${label} (exhausted ${maxRetries} retries)`);
+        if (!this.warnedLabels.has(label)) {
+          this.warnedLabels.add(label);
+          console.warn(
+            `[@deeptracer/core] Failed to send ${label} (exhausted ${maxRetries} retries). Suppressing further warnings.`
+          );
+        }
       }
     }
   }
@@ -186,9 +221,7 @@ function cloneState(state) {
   return {
     user: state.user ? { ...state.user } : null,
     tags: { ...state.tags },
-    contexts: Object.fromEntries(
-      Object.entries(state.contexts).map(([k, v]) => [k, { ...v }])
-    ),
+    contexts: Object.fromEntries(Object.entries(state.contexts).map(([k, v]) => [k, { ...v }])),
     breadcrumbs: [...state.breadcrumbs],
     maxBreadcrumbs: state.maxBreadcrumbs
   };
@@ -248,15 +281,18 @@ var Logger = class _Logger {
     this.contextName = contextName;
     this.requestMeta = requestMeta;
     this.state = state ?? createLoggerState(config.maxBreadcrumbs ?? 20);
-    if (!config.secretKey && !config.publicKey) {
-      _originalConsole.error(
-        "[@deeptracer/core] No `secretKey` or `publicKey` provided. Events will not be authenticated."
+    const hasKey = !!(config.secretKey || config.publicKey);
+    const hasEndpoint = !!config.endpoint;
+    if (!hasKey && !hasEndpoint) {
+      _originalConsole.warn(
+        "[@deeptracer/core] No API key or endpoint configured. Running in local-only mode (logging methods work, but events are not sent). Set DEEPTRACER_SECRET_KEY and DEEPTRACER_ENDPOINT to enable."
       );
-    }
-    if (!config.endpoint) {
-      _originalConsole.error(
-        "[@deeptracer/core] No `endpoint` provided. Events will not be sent."
+    } else if (!hasKey) {
+      _originalConsole.warn(
+        "[@deeptracer/core] No `secretKey` or `publicKey` provided. Events will not be sent."
       );
+    } else if (!hasEndpoint) {
+      _originalConsole.warn("[@deeptracer/core] No `endpoint` provided. Events will not be sent.");
     }
     this.effectiveLevel = LOG_LEVEL_VALUES[config.level ?? (config.environment === "production" ? "info" : "debug")];
     this.transport = new Transport(config);

package/dist/index.cjs

@@ -62,13 +62,16 @@ var Batcher = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.4.1";
+var SDK_VERSION = "0.4.2";
 var SDK_NAME = "core";
 
 // src/transport.ts
 var Transport = class {
   constructor(config) {
     this.config = config;
+    const hasKey = !!(config.secretKey || config.publicKey);
+    const hasEndpoint = !!config.endpoint;
+    this.disabled = !hasKey || !hasEndpoint;
     if (config.secretKey?.startsWith("dt_secret_") && typeof globalThis.window !== "undefined") {
       console.error(
         "[@deeptracer/core] WARNING: `secretKey` (dt_secret_...) detected in a browser bundle. This exposes your server key to end users. Use `publicKey` (dt_public_...) for client-side code."
@@ -76,6 +79,20 @@ var Transport = class {
     }
   }
   inFlightRequests = /* @__PURE__ */ new Set();
+  /**
+   * When true, all send methods become silent no-ops.
+   * Set automatically when no auth key or no endpoint is configured.
+   * This prevents pointless network requests and console noise during
+   * local development without API keys.
+   */
+  disabled;
+  /**
+   * Tracks which send types (logs, error, trace, LLM usage) have already
+   * logged a failure warning. After the first failure for a given type,
+   * subsequent failures are silently dropped to prevent console spam
+   * (e.g., when the ingestion endpoint is unreachable during development).
+   */
+  warnedLabels = /* @__PURE__ */ new Set();
   /** Resolve the auth key: prefer secretKey (server), fall back to publicKey (client). */
   get authKey() {
     return this.config.secretKey ?? this.config.publicKey ?? "";
@@ -84,8 +101,12 @@ var Transport = class {
    * Send a request with automatic retry and exponential backoff.
    * Retries up to `maxRetries` times on network errors and 5xx responses.
    * Does NOT retry on 4xx (client errors — bad payload, auth failure, etc.).
+   *
+   * After the first total failure for a given label, subsequent failures
+   * are silently dropped (no more console warnings).
    */
   async sendWithRetry(url, body, label, maxRetries = 3) {
+    if (this.disabled) return;
     const baseDelays = [1e3, 2e3, 4e3];
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -98,26 +119,40 @@ var Transport = class {
           },
           body: JSON.stringify(body)
         });
-        if (res.ok) return;
+        if (res.ok) {
+          this.warnedLabels.delete(label);
+          return;
+        }
         if (res.status >= 400 && res.status < 500) {
-          console.warn(
-            `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText}`
-          );
+          if (!this.warnedLabels.has(label)) {
+            this.warnedLabels.add(label);
+            console.warn(
+              `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText}`
+            );
+          }
           return;
         }
         if (attempt < maxRetries) {
           await this.sleep(this.jitter(baseDelays[attempt]));
           continue;
         }
-        console.warn(
-          `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText} (exhausted ${maxRetries} retries)`
-        );
+        if (!this.warnedLabels.has(label)) {
+          this.warnedLabels.add(label);
+          console.warn(
+            `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText} (exhausted ${maxRetries} retries). Suppressing further warnings.`
+          );
+        }
       } catch {
         if (attempt < maxRetries) {
           await this.sleep(this.jitter(baseDelays[attempt]));
           continue;
         }
-        console.warn(`[@deeptracer/core] Failed to send ${label} (exhausted ${maxRetries} retries)`);
+        if (!this.warnedLabels.has(label)) {
+          this.warnedLabels.add(label);
+          console.warn(
+            `[@deeptracer/core] Failed to send ${label} (exhausted ${maxRetries} retries). Suppressing further warnings.`
+          );
+        }
       }
     }
   }
@@ -215,9 +250,7 @@ function cloneState(state) {
   return {
     user: state.user ? { ...state.user } : null,
     tags: { ...state.tags },
-    contexts: Object.fromEntries(
-      Object.entries(state.contexts).map(([k, v]) => [k, { ...v }])
-    ),
+    contexts: Object.fromEntries(Object.entries(state.contexts).map(([k, v]) => [k, { ...v }])),
     breadcrumbs: [...state.breadcrumbs],
     maxBreadcrumbs: state.maxBreadcrumbs
   };
@@ -277,15 +310,18 @@ var Logger = class _Logger {
     this.contextName = contextName;
     this.requestMeta = requestMeta;
     this.state = state ?? createLoggerState(config.maxBreadcrumbs ?? 20);
-    if (!config.secretKey && !config.publicKey) {
-      _originalConsole.error(
-        "[@deeptracer/core] No `secretKey` or `publicKey` provided. Events will not be authenticated."
+    const hasKey = !!(config.secretKey || config.publicKey);
+    const hasEndpoint = !!config.endpoint;
+    if (!hasKey && !hasEndpoint) {
+      _originalConsole.warn(
+        "[@deeptracer/core] No API key or endpoint configured. Running in local-only mode (logging methods work, but events are not sent). Set DEEPTRACER_SECRET_KEY and DEEPTRACER_ENDPOINT to enable."
       );
-    }
-    if (!config.endpoint) {
-      _originalConsole.error(
-        "[@deeptracer/core] No `endpoint` provided. Events will not be sent."
+    } else if (!hasKey) {
+      _originalConsole.warn(
+        "[@deeptracer/core] No `secretKey` or `publicKey` provided. Events will not be sent."
       );
+    } else if (!hasEndpoint) {
+      _originalConsole.warn("[@deeptracer/core] No `endpoint` provided. Events will not be sent.");
     }
     this.effectiveLevel = LOG_LEVEL_VALUES[config.level ?? (config.environment === "production" ? "info" : "debug")];
     this.transport = new Transport(config);

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 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-BDTEt7Gi.cjs';
 
 /** SDK version. Update on each release. */
-declare const SDK_VERSION = "0.4.1";
+declare const SDK_VERSION = "0.4.2";
 declare const SDK_NAME = "core";
 
 export { SDK_NAME, SDK_VERSION };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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-BDTEt7Gi.js';
 
 /** SDK version. Update on each release. */
-declare const SDK_VERSION = "0.4.1";
+declare const SDK_VERSION = "0.4.2";
 declare const SDK_NAME = "core";
 
 export { SDK_NAME, SDK_VERSION };

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   SDK_NAME,
   SDK_VERSION,
   createLogger
-} from "./chunk-YBQXVNNR.js";
+} from "./chunk-IWPXOBZV.js";
 export {
   Logger,
   SDK_NAME,

package/dist/internal.cjs

@@ -63,13 +63,16 @@ var Batcher = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.4.1";
+var SDK_VERSION = "0.4.2";
 var SDK_NAME = "core";
 
 // src/transport.ts
 var Transport = class {
   constructor(config) {
     this.config = config;
+    const hasKey = !!(config.secretKey || config.publicKey);
+    const hasEndpoint = !!config.endpoint;
+    this.disabled = !hasKey || !hasEndpoint;
     if (config.secretKey?.startsWith("dt_secret_") && typeof globalThis.window !== "undefined") {
       console.error(
         "[@deeptracer/core] WARNING: `secretKey` (dt_secret_...) detected in a browser bundle. This exposes your server key to end users. Use `publicKey` (dt_public_...) for client-side code."
@@ -77,6 +80,20 @@ var Transport = class {
     }
   }
   inFlightRequests = /* @__PURE__ */ new Set();
+  /**
+   * When true, all send methods become silent no-ops.
+   * Set automatically when no auth key or no endpoint is configured.
+   * This prevents pointless network requests and console noise during
+   * local development without API keys.
+   */
+  disabled;
+  /**
+   * Tracks which send types (logs, error, trace, LLM usage) have already
+   * logged a failure warning. After the first failure for a given type,
+   * subsequent failures are silently dropped to prevent console spam
+   * (e.g., when the ingestion endpoint is unreachable during development).
+   */
+  warnedLabels = /* @__PURE__ */ new Set();
   /** Resolve the auth key: prefer secretKey (server), fall back to publicKey (client). */
   get authKey() {
     return this.config.secretKey ?? this.config.publicKey ?? "";
@@ -85,8 +102,12 @@ var Transport = class {
    * Send a request with automatic retry and exponential backoff.
    * Retries up to `maxRetries` times on network errors and 5xx responses.
    * Does NOT retry on 4xx (client errors — bad payload, auth failure, etc.).
+   *
+   * After the first total failure for a given label, subsequent failures
+   * are silently dropped (no more console warnings).
    */
   async sendWithRetry(url, body, label, maxRetries = 3) {
+    if (this.disabled) return;
     const baseDelays = [1e3, 2e3, 4e3];
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -99,26 +120,40 @@ var Transport = class {
           },
           body: JSON.stringify(body)
         });
-        if (res.ok) return;
+        if (res.ok) {
+          this.warnedLabels.delete(label);
+          return;
+        }
         if (res.status >= 400 && res.status < 500) {
-          console.warn(
-            `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText}`
-          );
+          if (!this.warnedLabels.has(label)) {
+            this.warnedLabels.add(label);
+            console.warn(
+              `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText}`
+            );
+          }
           return;
         }
         if (attempt < maxRetries) {
           await this.sleep(this.jitter(baseDelays[attempt]));
           continue;
         }
-        console.warn(
-          `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText} (exhausted ${maxRetries} retries)`
-        );
+        if (!this.warnedLabels.has(label)) {
+          this.warnedLabels.add(label);
+          console.warn(
+            `[@deeptracer/core] Failed to send ${label}: ${res.status} ${res.statusText} (exhausted ${maxRetries} retries). Suppressing further warnings.`
+          );
+        }
       } catch {
         if (attempt < maxRetries) {
           await this.sleep(this.jitter(baseDelays[attempt]));
           continue;
         }
-        console.warn(`[@deeptracer/core] Failed to send ${label} (exhausted ${maxRetries} retries)`);
+        if (!this.warnedLabels.has(label)) {
+          this.warnedLabels.add(label);
+          console.warn(
+            `[@deeptracer/core] Failed to send ${label} (exhausted ${maxRetries} retries). Suppressing further warnings.`
+          );
+        }
       }
     }
   }
@@ -216,9 +251,7 @@ function cloneState(state) {
   return {
     user: state.user ? { ...state.user } : null,
     tags: { ...state.tags },
-    contexts: Object.fromEntries(
-      Object.entries(state.contexts).map(([k, v]) => [k, { ...v }])
-    ),
+    contexts: Object.fromEntries(Object.entries(state.contexts).map(([k, v]) => [k, { ...v }])),
     breadcrumbs: [...state.breadcrumbs],
     maxBreadcrumbs: state.maxBreadcrumbs
   };
@@ -278,15 +311,18 @@ var Logger = class _Logger {
     this.contextName = contextName;
     this.requestMeta = requestMeta;
     this.state = state ?? createLoggerState(config.maxBreadcrumbs ?? 20);
-    if (!config.secretKey && !config.publicKey) {
-      _originalConsole.error(
-        "[@deeptracer/core] No `secretKey` or `publicKey` provided. Events will not be authenticated."
+    const hasKey = !!(config.secretKey || config.publicKey);
+    const hasEndpoint = !!config.endpoint;
+    if (!hasKey && !hasEndpoint) {
+      _originalConsole.warn(
+        "[@deeptracer/core] No API key or endpoint configured. Running in local-only mode (logging methods work, but events are not sent). Set DEEPTRACER_SECRET_KEY and DEEPTRACER_ENDPOINT to enable."
       );
-    }
-    if (!config.endpoint) {
-      _originalConsole.error(
-        "[@deeptracer/core] No `endpoint` provided. Events will not be sent."
+    } else if (!hasKey) {
+      _originalConsole.warn(
+        "[@deeptracer/core] No `secretKey` or `publicKey` provided. Events will not be sent."
       );
+    } else if (!hasEndpoint) {
+      _originalConsole.warn("[@deeptracer/core] No `endpoint` provided. Events will not be sent.");
     }
     this.effectiveLevel = LOG_LEVEL_VALUES[config.level ?? (config.environment === "production" ? "info" : "debug")];
     this.transport = new Transport(config);

package/dist/internal.d.cts

@@ -9,10 +9,27 @@ export { d as Logger, h as LoggerState, M as MiddlewareOptions, _ as _originalCo
  * - Only retries on network errors and 5xx (not 4xx client errors)
  * - SDK version header on every request (`x-deeptracer-sdk: core/0.3.0`)
  * - In-flight request tracking for graceful shutdown via `drain()`
+ * - Silent no-op when no API key or endpoint is configured (no retries, no console noise)
+ * - Warn-once per failure type — first failure for each send type (logs, error, trace)
+ *   logs a warning, subsequent identical failures are silently dropped
  */
 declare class Transport {
     private config;
     private inFlightRequests;
+    /**
+     * When true, all send methods become silent no-ops.
+     * Set automatically when no auth key or no endpoint is configured.
+     * This prevents pointless network requests and console noise during
+     * local development without API keys.
+     */
+    private readonly disabled;
+    /**
+     * Tracks which send types (logs, error, trace, LLM usage) have already
+     * logged a failure warning. After the first failure for a given type,
+     * subsequent failures are silently dropped to prevent console spam
+     * (e.g., when the ingestion endpoint is unreachable during development).
+     */
+    private warnedLabels;
     constructor(config: Pick<LoggerConfig, "endpoint" | "secretKey" | "publicKey" | "service" | "environment">);
     /** Resolve the auth key: prefer secretKey (server), fall back to publicKey (client). */
     private get authKey();
@@ -20,6 +37,9 @@ declare class Transport {
      * Send a request with automatic retry and exponential backoff.
      * Retries up to `maxRetries` times on network errors and 5xx responses.
      * Does NOT retry on 4xx (client errors — bad payload, auth failure, etc.).
+     *
+     * After the first total failure for a given label, subsequent failures
+     * are silently dropped (no more console warnings).
      */
     private sendWithRetry;
     /** Add +/- 20% jitter to a delay to prevent thundering herd. */

package/dist/internal.d.ts

@@ -9,10 +9,27 @@ export { d as Logger, h as LoggerState, M as MiddlewareOptions, _ as _originalCo
  * - Only retries on network errors and 5xx (not 4xx client errors)
  * - SDK version header on every request (`x-deeptracer-sdk: core/0.3.0`)
  * - In-flight request tracking for graceful shutdown via `drain()`
+ * - Silent no-op when no API key or endpoint is configured (no retries, no console noise)
+ * - Warn-once per failure type — first failure for each send type (logs, error, trace)
+ *   logs a warning, subsequent identical failures are silently dropped
  */
 declare class Transport {
     private config;
     private inFlightRequests;
+    /**
+     * When true, all send methods become silent no-ops.
+     * Set automatically when no auth key or no endpoint is configured.
+     * This prevents pointless network requests and console noise during
+     * local development without API keys.
+     */
+    private readonly disabled;
+    /**
+     * Tracks which send types (logs, error, trace, LLM usage) have already
+     * logged a failure warning. After the first failure for a given type,
+     * subsequent failures are silently dropped to prevent console spam
+     * (e.g., when the ingestion endpoint is unreachable during development).
+     */
+    private warnedLabels;
     constructor(config: Pick<LoggerConfig, "endpoint" | "secretKey" | "publicKey" | "service" | "environment">);
     /** Resolve the auth key: prefer secretKey (server), fall back to publicKey (client). */
     private get authKey();
@@ -20,6 +37,9 @@ declare class Transport {
      * Send a request with automatic retry and exponential backoff.
      * Retries up to `maxRetries` times on network errors and 5xx responses.
      * Does NOT retry on 4xx (client errors — bad payload, auth failure, etc.).
+     *
+     * After the first total failure for a given label, subsequent failures
+     * are silently dropped (no more console warnings).
      */
     private sendWithRetry;
     /** Add +/- 20% jitter to a delay to prevent thundering herd. */

package/dist/internal.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeptracer/core",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Core SDK for DeepTracer — Logger class, types, transport, batcher, tracing",
   "type": "module",
   "main": "dist/index.cjs",
@@ -35,6 +35,9 @@
     "directory": "packages/core"
   },
   "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch"