@deeptracer/core 0.6.3 → 0.7.0

package/README.md

@@ -74,7 +74,7 @@ const result = await logger.startSpan("fetch-user", async (span) => {
 })
 
 // Flush before shutdown
-logger.destroy()
+await logger.destroy()
 ```
 
 ## Configuration
@@ -424,8 +424,8 @@ await logger.flush()
 Stop the internal batch timer and flush any remaining log entries. Call this during graceful shutdown.
 
 ```ts
-process.on("SIGTERM", () => {
-  logger.destroy()
+process.on("SIGTERM", async () => {
+  await logger.destroy()
   process.exit(0)
 })
 ```
@@ -580,7 +580,7 @@ In serverless functions, the execution context may freeze immediately after the
 - **Auto-detected interval**: When `VERCEL` or `AWS_LAMBDA_FUNCTION_NAME` is set, the default `flushIntervalMs` drops to 200ms.
 - **Explicit flush**: Call `await logger.flush()` before returning a response to guarantee delivery.
 
-For third-party route handlers you can't wrap (e.g. Auth.js, Stripe webhooks), use Vercel's `waitUntil` to extend the function lifetime:
+For **`@deeptracer/nextjs`** users, `withRouteHandler` works with any handler function including third-party ones (Auth.js, Better Auth, Stripe webhooks) — just wrap the exported handler. Only use `waitUntil` if the library doesn't export individual `GET`/`POST` functions:
 
 ```ts
 import { waitUntil } from "@vercel/functions"
@@ -608,7 +608,7 @@ All requests include:
 - `Content-Type: application/json` header
 - `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.
+If a request fails with a network error or a 5xx response, the SDK retries up to **3 times** with exponential backoff (1s → 2s → 4s, +20% jitter). 4xx errors (bad auth, invalid payload) are not retried. After all retries are exhausted, a single warning is logged to the console — subsequent failures for the same endpoint are suppressed to avoid console spam. The SDK never throws on transport errors.
 
 ## Monorepo
 

package/dist/{chunk-W62R346F.js → chunk-POYXPAC5.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var SDK_VERSION = "0.6.3";
+var SDK_VERSION = "0.7.0";
 var SDK_NAME = "core";
 
 // src/transport.ts
@@ -99,6 +99,7 @@ var Transport = class {
   track(promise) {
     this.inFlightRequests.add(promise);
     promise.finally(() => this.inFlightRequests.delete(promise));
+    this.config.waitUntil?.(promise);
   }
   async sendLogs(logs) {
     const p = this.sendWithRetry(

package/dist/index.cjs

@@ -64,7 +64,7 @@ var Batcher = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.6.3";
+var SDK_VERSION = "0.7.0";
 var SDK_NAME = "core";
 
 // src/transport.ts
@@ -164,6 +164,7 @@ var Transport = class {
   track(promise) {
     this.inFlightRequests.add(promise);
     promise.finally(() => this.inFlightRequests.delete(promise));
+    this.config.waitUntil?.(promise);
   }
   async sendLogs(logs) {
     const p = this.sendWithRetry(

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { L as Logger } from './logger-DyJENLNA.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-DyJENLNA.cjs';
+import { L as Logger } from './logger-DnaUqfFI.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-DnaUqfFI.cjs';
 
 /**
  * A Logger-compatible object where every method is a silent no-op.
@@ -18,7 +18,7 @@ export { B as BeforeSendEvent, a as Breadcrumb, E as ErrorReport, I as InactiveS
 declare const noopLogger: Logger;
 
 /** SDK version. Update on each release. */
-declare const SDK_VERSION = "0.6.3";
+declare const SDK_VERSION = "0.7.0";
 declare const SDK_NAME = "core";
 
 export { Logger, SDK_NAME, SDK_VERSION, noopLogger };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { L as Logger } from './logger-DyJENLNA.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-DyJENLNA.js';
+import { L as Logger } from './logger-DnaUqfFI.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-DnaUqfFI.js';
 
 /**
  * A Logger-compatible object where every method is a silent no-op.
@@ -18,7 +18,7 @@ export { B as BeforeSendEvent, a as Breadcrumb, E as ErrorReport, I as InactiveS
 declare const noopLogger: Logger;
 
 /** SDK version. Update on each release. */
-declare const SDK_VERSION = "0.6.3";
+declare const SDK_VERSION = "0.7.0";
 declare const SDK_NAME = "core";
 
 export { Logger, SDK_NAME, SDK_VERSION, noopLogger };

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   SDK_NAME,
   SDK_VERSION,
   createLogger
-} from "./chunk-W62R346F.js";
+} from "./chunk-POYXPAC5.js";
 
 // src/noop-logger.ts
 var NOOP_INACTIVE_SPAN = {

package/dist/internal.cjs

@@ -64,7 +64,7 @@ var Batcher = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.6.3";
+var SDK_VERSION = "0.7.0";
 var SDK_NAME = "core";
 
 // src/transport.ts
@@ -164,6 +164,7 @@ var Transport = class {
   track(promise) {
     this.inFlightRequests.add(promise);
     promise.finally(() => this.inFlightRequests.delete(promise));
+    this.config.waitUntil?.(promise);
   }
   async sendLogs(logs) {
     const p = this.sendWithRetry(

package/dist/internal.d.cts

@@ -1,4 +1,4 @@
-export { L as Logger, e as LoggerConfig, h as LoggerState, M as MiddlewareOptions, T as Transport, _ as _originalConsole, p as parseTraceparent } from './logger-DyJENLNA.cjs';
+export { L as Logger, e as LoggerConfig, h as LoggerState, M as MiddlewareOptions, T as Transport, _ as _originalConsole, p as parseTraceparent } from './logger-DnaUqfFI.cjs';
 
 /**
  * Parse console.log/info/warn/error arguments into a structured `{ message, metadata }` pair.

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-export { L as Logger, e as LoggerConfig, h as LoggerState, M as MiddlewareOptions, T as Transport, _ as _originalConsole, p as parseTraceparent } from './logger-DyJENLNA.js';
+export { L as Logger, e as LoggerConfig, h as LoggerState, M as MiddlewareOptions, T as Transport, _ as _originalConsole, p as parseTraceparent } from './logger-DnaUqfFI.js';
 
 /**
  * Parse console.log/info/warn/error arguments into a structured `{ message, metadata }` pair.

package/dist/internal.js

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

package/dist/{logger-DyJENLNA.d.cts → logger-DnaUqfFI.d.cts}

@@ -63,6 +63,28 @@ interface LoggerConfig {
      * ```
      */
     beforeSend?: (event: BeforeSendEvent) => BeforeSendEvent | null;
+    /**
+     * Called with each outgoing HTTP request promise when the transport sends data.
+     * Use this to keep a serverless function alive until all in-flight requests
+     * complete — even for logs written after the HTTP response has been returned
+     * (e.g., from Better Auth background task callbacks or other post-response work).
+     *
+     * On Vercel this is wired up automatically by `@deeptracer/nextjs`.
+     * On Cloudflare Workers, pass `ctx.waitUntil.bind(ctx)` when creating the logger.
+     * On persistent servers (Railway, Fly, Docker) you don't need this — the process
+     * stays alive and the timer-based flush handles it.
+     *
+     * @example Cloudflare Workers
+     * ```ts
+     * export default {
+     *   async fetch(request, env, ctx) {
+     *     const logger = createLogger({ waitUntil: ctx.waitUntil.bind(ctx), ... })
+     *     // logs are now kept alive past the response
+     *   }
+     * }
+     * ```
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 /** Log severity level */
 type LogLevel = "debug" | "info" | "warn" | "error";
@@ -254,7 +276,7 @@ declare class Transport {
      * (e.g., when the ingestion endpoint is unreachable during development).
      */
     private warnedLabels;
-    constructor(config: Pick<LoggerConfig, "endpoint" | "apiKey" | "service" | "environment">);
+    constructor(config: Pick<LoggerConfig, "endpoint" | "apiKey" | "service" | "environment" | "waitUntil">);
     private get authKey();
     /**
      * Send a request with automatic retry and exponential backoff.

package/dist/{logger-DyJENLNA.d.ts → logger-DnaUqfFI.d.ts}

@@ -63,6 +63,28 @@ interface LoggerConfig {
      * ```
      */
     beforeSend?: (event: BeforeSendEvent) => BeforeSendEvent | null;
+    /**
+     * Called with each outgoing HTTP request promise when the transport sends data.
+     * Use this to keep a serverless function alive until all in-flight requests
+     * complete — even for logs written after the HTTP response has been returned
+     * (e.g., from Better Auth background task callbacks or other post-response work).
+     *
+     * On Vercel this is wired up automatically by `@deeptracer/nextjs`.
+     * On Cloudflare Workers, pass `ctx.waitUntil.bind(ctx)` when creating the logger.
+     * On persistent servers (Railway, Fly, Docker) you don't need this — the process
+     * stays alive and the timer-based flush handles it.
+     *
+     * @example Cloudflare Workers
+     * ```ts
+     * export default {
+     *   async fetch(request, env, ctx) {
+     *     const logger = createLogger({ waitUntil: ctx.waitUntil.bind(ctx), ... })
+     *     // logs are now kept alive past the response
+     *   }
+     * }
+     * ```
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 /** Log severity level */
 type LogLevel = "debug" | "info" | "warn" | "error";
@@ -254,7 +276,7 @@ declare class Transport {
      * (e.g., when the ingestion endpoint is unreachable during development).
      */
     private warnedLabels;
-    constructor(config: Pick<LoggerConfig, "endpoint" | "apiKey" | "service" | "environment">);
+    constructor(config: Pick<LoggerConfig, "endpoint" | "apiKey" | "service" | "environment" | "waitUntil">);
     private get authKey();
     /**
      * Send a request with automatic retry and exponential backoff.

package/package.json

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