@deeptracer/core 0.2.0 → 0.3.1

package/dist/index.d.cts

@@ -1,221 +1,7 @@
-/**
- * Configuration for creating a DeepTracer logger instance.
- *
- * @example
- * ```ts
- * const config: LoggerConfig = {
- *   product: "my-app",
- *   service: "api-server",
- *   environment: "production",
- *   endpoint: "https://deeptracer.example.com",
- *   apiKey: "dt_live_xxx",
- * }
- * ```
- */
-interface LoggerConfig {
-    /** Product name (e.g., "spotbeam", "macro") */
-    product: string;
-    /** Service name (e.g., "api", "worker", "web") */
-    service: string;
-    /** Deployment environment */
-    environment: "production" | "staging";
-    /** DeepTracer ingestion endpoint URL */
-    endpoint: string;
-    /** DeepTracer API key for authentication */
-    apiKey: string;
-    /** Number of log entries to batch before sending. Default: 50 */
-    batchSize?: number;
-    /** Milliseconds between automatic batch flushes. Default: 5000 */
-    flushIntervalMs?: number;
-    /** Enable console output for all log calls (useful for local development) */
-    debug?: boolean;
-}
-/** Log severity level */
-type LogLevel = "debug" | "info" | "warn" | "error";
-/**
- * A single log entry sent to the DeepTracer backend.
- * Created internally by the Logger — you don't construct these manually.
- */
-interface LogEntry {
-    timestamp: string;
-    level: LogLevel;
-    message: string;
-    metadata?: Record<string, unknown>;
-    trace_id?: string;
-    span_id?: string;
-    request_id?: string;
-    vercel_id?: string;
-    context?: string;
-}
-/**
- * Error report sent to DeepTracer for tracking and alerting.
- */
-interface ErrorReport {
-    error_message: string;
-    stack_trace: string;
-    severity: "low" | "medium" | "high" | "critical";
-    context?: Record<string, unknown>;
-    trace_id?: string;
-    user_id?: string;
-    breadcrumbs?: Array<{
-        type: string;
-        message: string;
-        timestamp: string;
-    }>;
-}
-/**
- * LLM usage report for tracking AI costs and performance.
- */
-interface LLMUsageReport {
-    model: string;
-    provider: string;
-    operation: string;
-    inputTokens: number;
-    outputTokens: number;
-    latencyMs: number;
-    costUsd?: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Raw span data sent to the DeepTracer backend.
- */
-interface SpanData {
-    trace_id: string;
-    span_id: string;
-    parent_span_id: string;
-    operation: string;
-    start_time: string;
-    duration_ms: number;
-    status: "ok" | "error";
-    metadata?: Record<string, unknown>;
-}
-/**
- * A span representing a unit of work within a trace.
- * Returned by the callback-based `startSpan()` — lifecycle is managed automatically.
- */
-interface Span {
-    /** Trace ID linking all spans in a distributed trace */
-    traceId: string;
-    /** Unique ID for this span */
-    spanId: string;
-    /** ID of the parent span (empty string if root span) */
-    parentSpanId: string;
-    /** Operation name (e.g., "db-query", "fetch-user") */
-    operation: string;
-    /** Returns headers for propagating trace context to downstream services */
-    getHeaders(): Record<string, string>;
-}
-/**
- * A span with manual lifecycle control. You must call `.end()` when done.
- */
-interface InactiveSpan extends Span {
-    /** End the span and send timing data to DeepTracer */
-    end(options?: {
-        status?: "ok" | "error";
-        metadata?: Record<string, unknown>;
-    }): void;
-    /** Create a child span with callback-based lifecycle (auto-ends) */
-    startSpan<T>(operation: string, fn: (span: Span) => T): T;
-    /** Create a child span with manual lifecycle (you must call .end()) */
-    startInactiveSpan(operation: string): InactiveSpan;
-}
-/**
- * Options for HTTP middleware (Hono, Express).
- */
-interface MiddlewareOptions {
-    /** Custom function to generate the span operation name. Default: "{METHOD} {path}" */
-    operationName?: (method: string, path: string) => string;
-    /** Paths to exclude from tracing (e.g., ["/health", "/ready"]) */
-    ignorePaths?: string[];
-}
+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 './internal-DdKQRgCs.cjs';
 
-/**
- * Original console methods, preserved before any interception.
- * Used internally by the Logger's debug output to avoid infinite loops
- * when captureConsole() is active.
- *
- * @internal Exported for use by @deeptracer/node and @deeptracer/browser.
- */
-declare const _originalConsole: {
-    log: (...data: any[]) => void;
-    info: (...data: any[]) => void;
-    warn: (...data: any[]) => void;
-    error: (...data: any[]) => void;
-    debug: (...data: any[]) => void;
-};
-/**
- * DeepTracer Logger — lightweight observability SDK for logging, errors, tracing, and LLM usage.
- *
- * @example
- * ```ts
- * import { createLogger } from "@deeptracer/core"
- *
- * const logger = createLogger({
- *   product: "my-app",
- *   service: "api",
- *   environment: "production",
- *   endpoint: "https://deeptracer.example.com",
- *   apiKey: "dt_live_xxx",
- * })
- *
- * logger.info("Server started", { port: 3000 })
- * ```
- */
-declare class Logger {
-    private batcher;
-    private transport;
-    protected contextName?: string;
-    protected config: LoggerConfig;
-    protected requestMeta?: {
-        trace_id?: string;
-        span_id?: string;
-        request_id?: string;
-        vercel_id?: string;
-    };
-    constructor(config: LoggerConfig, contextName?: string, requestMeta?: {
-        trace_id?: string;
-        span_id?: string;
-        request_id?: string;
-        vercel_id?: string;
-    });
-    private log;
-    /** Log a debug message. */
-    debug(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Log an informational message. */
-    info(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Log a warning. */
-    warn(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Log an error. */
-    error(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Create a context-scoped logger. All logs include the context name. */
-    withContext(name: string): Logger;
-    /** Create a request-scoped logger that extracts trace context from headers. */
-    forRequest(request: Request): Logger;
-    /** Capture and report an error immediately (not batched). */
-    captureError(error: Error | unknown, context?: {
-        severity?: "low" | "medium" | "high" | "critical";
-        userId?: string;
-        context?: Record<string, unknown>;
-        breadcrumbs?: Array<{
-            type: string;
-            message: string;
-            timestamp: string;
-        }>;
-    }): void;
-    /** Track LLM usage. Sends to /ingest/llm and logs for visibility. */
-    llmUsage(report: LLMUsageReport): void;
-    /** Start a span with automatic lifecycle (callback-based, recommended). */
-    startSpan<T>(operation: string, fn: (span: Span) => T): T;
-    /** Start a span with manual lifecycle. You must call span.end(). */
-    startInactiveSpan(operation: string): InactiveSpan;
-    /** Wrap a function with automatic tracing and error capture. */
-    wrap<TArgs extends unknown[], TReturn>(operation: string, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-    /** Immediately flush all batched log entries. */
-    flush(): void;
-    /** Stop the batch timer and flush remaining logs. */
-    destroy(): void;
-}
-/** Create a new DeepTracer logger instance. */
-declare function createLogger(config: LoggerConfig): Logger;
+/** SDK version. Update on each release. */
+declare const SDK_VERSION = "0.3.1";
+declare const SDK_NAME = "core";
 
-export { type ErrorReport, type InactiveSpan, type LLMUsageReport, type LogEntry, type LogLevel, Logger, type LoggerConfig, type MiddlewareOptions, type Span, type SpanData, _originalConsole as _, createLogger };
+export { SDK_NAME, SDK_VERSION };

package/dist/index.d.ts

@@ -1,221 +1,7 @@
-/**
- * Configuration for creating a DeepTracer logger instance.
- *
- * @example
- * ```ts
- * const config: LoggerConfig = {
- *   product: "my-app",
- *   service: "api-server",
- *   environment: "production",
- *   endpoint: "https://deeptracer.example.com",
- *   apiKey: "dt_live_xxx",
- * }
- * ```
- */
-interface LoggerConfig {
-    /** Product name (e.g., "spotbeam", "macro") */
-    product: string;
-    /** Service name (e.g., "api", "worker", "web") */
-    service: string;
-    /** Deployment environment */
-    environment: "production" | "staging";
-    /** DeepTracer ingestion endpoint URL */
-    endpoint: string;
-    /** DeepTracer API key for authentication */
-    apiKey: string;
-    /** Number of log entries to batch before sending. Default: 50 */
-    batchSize?: number;
-    /** Milliseconds between automatic batch flushes. Default: 5000 */
-    flushIntervalMs?: number;
-    /** Enable console output for all log calls (useful for local development) */
-    debug?: boolean;
-}
-/** Log severity level */
-type LogLevel = "debug" | "info" | "warn" | "error";
-/**
- * A single log entry sent to the DeepTracer backend.
- * Created internally by the Logger — you don't construct these manually.
- */
-interface LogEntry {
-    timestamp: string;
-    level: LogLevel;
-    message: string;
-    metadata?: Record<string, unknown>;
-    trace_id?: string;
-    span_id?: string;
-    request_id?: string;
-    vercel_id?: string;
-    context?: string;
-}
-/**
- * Error report sent to DeepTracer for tracking and alerting.
- */
-interface ErrorReport {
-    error_message: string;
-    stack_trace: string;
-    severity: "low" | "medium" | "high" | "critical";
-    context?: Record<string, unknown>;
-    trace_id?: string;
-    user_id?: string;
-    breadcrumbs?: Array<{
-        type: string;
-        message: string;
-        timestamp: string;
-    }>;
-}
-/**
- * LLM usage report for tracking AI costs and performance.
- */
-interface LLMUsageReport {
-    model: string;
-    provider: string;
-    operation: string;
-    inputTokens: number;
-    outputTokens: number;
-    latencyMs: number;
-    costUsd?: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Raw span data sent to the DeepTracer backend.
- */
-interface SpanData {
-    trace_id: string;
-    span_id: string;
-    parent_span_id: string;
-    operation: string;
-    start_time: string;
-    duration_ms: number;
-    status: "ok" | "error";
-    metadata?: Record<string, unknown>;
-}
-/**
- * A span representing a unit of work within a trace.
- * Returned by the callback-based `startSpan()` — lifecycle is managed automatically.
- */
-interface Span {
-    /** Trace ID linking all spans in a distributed trace */
-    traceId: string;
-    /** Unique ID for this span */
-    spanId: string;
-    /** ID of the parent span (empty string if root span) */
-    parentSpanId: string;
-    /** Operation name (e.g., "db-query", "fetch-user") */
-    operation: string;
-    /** Returns headers for propagating trace context to downstream services */
-    getHeaders(): Record<string, string>;
-}
-/**
- * A span with manual lifecycle control. You must call `.end()` when done.
- */
-interface InactiveSpan extends Span {
-    /** End the span and send timing data to DeepTracer */
-    end(options?: {
-        status?: "ok" | "error";
-        metadata?: Record<string, unknown>;
-    }): void;
-    /** Create a child span with callback-based lifecycle (auto-ends) */
-    startSpan<T>(operation: string, fn: (span: Span) => T): T;
-    /** Create a child span with manual lifecycle (you must call .end()) */
-    startInactiveSpan(operation: string): InactiveSpan;
-}
-/**
- * Options for HTTP middleware (Hono, Express).
- */
-interface MiddlewareOptions {
-    /** Custom function to generate the span operation name. Default: "{METHOD} {path}" */
-    operationName?: (method: string, path: string) => string;
-    /** Paths to exclude from tracing (e.g., ["/health", "/ready"]) */
-    ignorePaths?: string[];
-}
+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 './internal-DdKQRgCs.js';
 
-/**
- * Original console methods, preserved before any interception.
- * Used internally by the Logger's debug output to avoid infinite loops
- * when captureConsole() is active.
- *
- * @internal Exported for use by @deeptracer/node and @deeptracer/browser.
- */
-declare const _originalConsole: {
-    log: (...data: any[]) => void;
-    info: (...data: any[]) => void;
-    warn: (...data: any[]) => void;
-    error: (...data: any[]) => void;
-    debug: (...data: any[]) => void;
-};
-/**
- * DeepTracer Logger — lightweight observability SDK for logging, errors, tracing, and LLM usage.
- *
- * @example
- * ```ts
- * import { createLogger } from "@deeptracer/core"
- *
- * const logger = createLogger({
- *   product: "my-app",
- *   service: "api",
- *   environment: "production",
- *   endpoint: "https://deeptracer.example.com",
- *   apiKey: "dt_live_xxx",
- * })
- *
- * logger.info("Server started", { port: 3000 })
- * ```
- */
-declare class Logger {
-    private batcher;
-    private transport;
-    protected contextName?: string;
-    protected config: LoggerConfig;
-    protected requestMeta?: {
-        trace_id?: string;
-        span_id?: string;
-        request_id?: string;
-        vercel_id?: string;
-    };
-    constructor(config: LoggerConfig, contextName?: string, requestMeta?: {
-        trace_id?: string;
-        span_id?: string;
-        request_id?: string;
-        vercel_id?: string;
-    });
-    private log;
-    /** Log a debug message. */
-    debug(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Log an informational message. */
-    info(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Log a warning. */
-    warn(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Log an error. */
-    error(message: string, dataOrError?: Record<string, unknown> | unknown, error?: unknown): void;
-    /** Create a context-scoped logger. All logs include the context name. */
-    withContext(name: string): Logger;
-    /** Create a request-scoped logger that extracts trace context from headers. */
-    forRequest(request: Request): Logger;
-    /** Capture and report an error immediately (not batched). */
-    captureError(error: Error | unknown, context?: {
-        severity?: "low" | "medium" | "high" | "critical";
-        userId?: string;
-        context?: Record<string, unknown>;
-        breadcrumbs?: Array<{
-            type: string;
-            message: string;
-            timestamp: string;
-        }>;
-    }): void;
-    /** Track LLM usage. Sends to /ingest/llm and logs for visibility. */
-    llmUsage(report: LLMUsageReport): void;
-    /** Start a span with automatic lifecycle (callback-based, recommended). */
-    startSpan<T>(operation: string, fn: (span: Span) => T): T;
-    /** Start a span with manual lifecycle. You must call span.end(). */
-    startInactiveSpan(operation: string): InactiveSpan;
-    /** Wrap a function with automatic tracing and error capture. */
-    wrap<TArgs extends unknown[], TReturn>(operation: string, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-    /** Immediately flush all batched log entries. */
-    flush(): void;
-    /** Stop the batch timer and flush remaining logs. */
-    destroy(): void;
-}
-/** Create a new DeepTracer logger instance. */
-declare function createLogger(config: LoggerConfig): Logger;
+/** SDK version. Update on each release. */
+declare const SDK_VERSION = "0.3.1";
+declare const SDK_NAME = "core";
 
-export { type ErrorReport, type InactiveSpan, type LLMUsageReport, type LogEntry, type LogLevel, Logger, type LoggerConfig, type MiddlewareOptions, type Span, type SpanData, _originalConsole as _, createLogger };
+export { SDK_NAME, SDK_VERSION };

package/dist/index.js

@@ -1,8 +1,12 @@
 import {
   Logger,
+  SDK_NAME,
+  SDK_VERSION,
   createLogger
-} from "./chunk-LSMMIS4A.js";
+} from "./chunk-XVDM75HZ.js";
 export {
   Logger,
+  SDK_NAME,
+  SDK_VERSION,
   createLogger
 };