@x12i/logxer 4.0.0

package/dist/trails/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/trails/headers.ts"],"names":[],"mappings":"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"}

package/dist/trails/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * AsyncLocalStorage-based trails module for operation and thread tracking
+ */
+import type { OperationCtx, ThreadContext } from '../types';
+/**
+ * Operation scope for managing operation lifecycle
+ */
+export declare class OperationScope {
+    private readonly operationId;
+    private readonly parentOperationId?;
+    private readonly operationName;
+    private readonly operationPath;
+    private readonly operationStep;
+    private readonly traceId;
+    private readonly spanId;
+    private ended;
+    constructor(operationId: string, parentOperationId: string | undefined, operationName: string, operationPath: string, operationStep: number, traceId: string, spanId: string);
+    /**
+     * End the operation scope
+     */
+    end(_resultAttrs?: Record<string, any>): void;
+    /**
+     * Execute a function within this operation scope
+     */
+    with<T>(fn: () => T | Promise<T>): Promise<T>;
+}
+/**
+ * Start a new operation scope
+ */
+export declare function startOperation(name: string, _attrs?: Record<string, any>): OperationScope;
+/**
+ * Create a child operation scope
+ */
+export declare function childOperation(name: string, _attrs?: Record<string, any>): OperationScope;
+/**
+ * Get the current operation context
+ */
+export declare function getCurrentOperation(): OperationCtx | null;
+/**
+ * Create a new thread context
+ */
+export declare function newThread(init?: Partial<ThreadContext>): ThreadContext;
+/**
+ * Continue an existing thread context
+ */
+export declare function continueThread(ctx: Partial<ThreadContext>): ThreadContext;
+/**
+ * Generate the next event ID and increment sequence
+ */
+export declare function nextEventId(): string;
+/**
+ * Get the current thread context
+ */
+export declare function getCurrentThread(): ThreadContext | null;
+/**
+ * Clear all contexts (for testing)
+ */
+export declare function clearAllContexts(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/trails/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trails/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAM5D;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAS;gBAGpB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAWhB;;OAEG;IACH,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAU7C;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAapD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,cAAc,CAmChB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,cAAc,CAoChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAkBtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAmBzE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAqBpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/trails/index.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * AsyncLocalStorage-based trails module for operation and thread tracking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationScope = void 0;
+exports.startOperation = startOperation;
+exports.childOperation = childOperation;
+exports.getCurrentOperation = getCurrentOperation;
+exports.newThread = newThread;
+exports.continueThread = continueThread;
+exports.nextEventId = nextEventId;
+exports.getCurrentThread = getCurrentThread;
+exports.clearAllContexts = clearAllContexts;
+const async_hooks_1 = require("async_hooks");
+const nanoid_1 = require("nanoid");
+// AsyncLocalStorage stores for context preservation
+const operationStore = new async_hooks_1.AsyncLocalStorage();
+const threadStore = new async_hooks_1.AsyncLocalStorage();
+/**
+ * Operation scope for managing operation lifecycle
+ */
+class OperationScope {
+    constructor(operationId, parentOperationId, operationName, operationPath, operationStep, traceId, spanId) {
+        this.ended = false;
+        this.operationId = operationId;
+        this.parentOperationId = parentOperationId || undefined;
+        this.operationName = operationName;
+        this.operationPath = operationPath;
+        this.operationStep = operationStep;
+        this.traceId = traceId;
+        this.spanId = spanId;
+    }
+    /**
+     * End the operation scope
+     */
+    end(_resultAttrs) {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        // Clear the operation context by setting it to null
+        operationStore.enterWith(null);
+    }
+    /**
+     * Execute a function within this operation scope
+     */
+    async with(fn) {
+        const context = {
+            operationId: this.operationId,
+            parentOperationId: this.parentOperationId,
+            operationName: this.operationName,
+            operationPath: this.operationPath,
+            operationStep: this.operationStep,
+            traceId: this.traceId,
+            spanId: this.spanId
+        };
+        return operationStore.run(context, fn);
+    }
+}
+exports.OperationScope = OperationScope;
+/**
+ * Start a new operation scope
+ */
+function startOperation(name, _attrs) {
+    const parentCtx = getCurrentOperation();
+    const operationId = (0, nanoid_1.nanoid)(12);
+    const traceId = parentCtx?.traceId || (0, nanoid_1.nanoid)(16);
+    const spanId = (0, nanoid_1.nanoid)(12);
+    const operationPath = parentCtx
+        ? `${parentCtx.operationPath}.${name}`
+        : name;
+    const operationStep = 0; // Root operations start at step 0
+    const scope = new OperationScope(operationId, parentCtx?.operationId, name, operationPath, operationStep, traceId, spanId);
+    // Set the context immediately
+    const context = {
+        operationId,
+        parentOperationId: parentCtx?.operationId,
+        operationName: name,
+        operationPath,
+        operationStep,
+        traceId,
+        spanId
+    };
+    operationStore.enterWith(context);
+    return scope;
+}
+/**
+ * Create a child operation scope
+ */
+function childOperation(name, _attrs) {
+    const parentCtx = getCurrentOperation();
+    if (!parentCtx) {
+        throw new Error('No parent operation context available. Call startOperation() first.');
+    }
+    const operationId = (0, nanoid_1.nanoid)(12);
+    const traceId = parentCtx.traceId;
+    const spanId = (0, nanoid_1.nanoid)(12);
+    const operationPath = `${parentCtx.operationPath}.${name}`;
+    const operationStep = parentCtx.operationStep + 1;
+    const scope = new OperationScope(operationId, parentCtx.operationId, name, operationPath, operationStep, traceId, spanId);
+    // Set the context immediately
+    const context = {
+        operationId,
+        parentOperationId: parentCtx.operationId,
+        operationName: name,
+        operationPath,
+        operationStep,
+        traceId,
+        spanId
+    };
+    operationStore.enterWith(context);
+    return scope;
+}
+/**
+ * Get the current operation context
+ */
+function getCurrentOperation() {
+    return operationStore.getStore() || null;
+}
+/**
+ * Create a new thread context
+ */
+function newThread(init) {
+    const threadId = init?.threadId || (0, nanoid_1.nanoid)(12);
+    const eventId = (0, nanoid_1.nanoid)(12);
+    const sequenceNo = init?.sequenceNo || 0;
+    const context = {
+        threadId,
+        eventId,
+        causationId: init?.causationId,
+        sequenceNo,
+        partitionKey: init?.partitionKey,
+        attempt: init?.attempt,
+        shardId: init?.shardId,
+        workerId: init?.workerId
+    };
+    threadStore.enterWith(context);
+    return context;
+}
+/**
+ * Continue an existing thread context
+ */
+function continueThread(ctx) {
+    const currentThread = getCurrentThread();
+    const threadId = ctx.threadId || currentThread?.threadId || (0, nanoid_1.nanoid)(12);
+    const eventId = (0, nanoid_1.nanoid)(12);
+    const sequenceNo = ctx.sequenceNo ?? (currentThread?.sequenceNo ?? 0);
+    const context = {
+        threadId,
+        eventId,
+        causationId: ctx.causationId || currentThread?.causationId,
+        sequenceNo,
+        partitionKey: ctx.partitionKey || currentThread?.partitionKey,
+        attempt: ctx.attempt || currentThread?.attempt,
+        shardId: ctx.shardId || currentThread?.shardId,
+        workerId: ctx.workerId || currentThread?.workerId
+    };
+    threadStore.enterWith(context);
+    return context;
+}
+/**
+ * Generate the next event ID and increment sequence
+ */
+function nextEventId() {
+    const currentThread = getCurrentThread();
+    if (!currentThread) {
+        throw new Error('No thread context available. Call newThread() or continueThread() first.');
+    }
+    const eventId = `evt_${(0, nanoid_1.nanoid)(12)}`;
+    const newSequenceNo = currentThread.sequenceNo + 1;
+    // Update the current thread context with new event and sequence
+    const updatedContext = {
+        ...currentThread,
+        eventId,
+        sequenceNo: newSequenceNo,
+        causationId: currentThread.eventId
+            ? [...(Array.isArray(currentThread.causationId) ? currentThread.causationId : (currentThread.causationId ? [currentThread.causationId] : [])), currentThread.eventId]
+            : currentThread.causationId
+    };
+    threadStore.enterWith(updatedContext);
+    return eventId;
+}
+/**
+ * Get the current thread context
+ */
+function getCurrentThread() {
+    return threadStore.getStore() || null;
+}
+/**
+ * Clear all contexts (for testing)
+ */
+function clearAllContexts() {
+    operationStore.enterWith(null);
+    threadStore.enterWith(null);
+}
+//# sourceMappingURL=index.js.map

package/dist/trails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trails/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,411 @@
+/**
+ * logxer - TypeScript Type Definitions
+ *
+ * This file contains all TypeScript interfaces and types for the logxer package.
+ */
+/**
+ * Supported log levels in order of priority
+ */
+export type LogLevel = 'verbose' | 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Output format options for log entries
+ */
+export type LogFormat = 'text' | 'json' | 'yaml' | 'table';
+/**
+ * Configuration for PII/credentials sanitization
+ */
+export interface SanitizationConfig {
+    /** Enable sanitization (default: false) */
+    enabled?: boolean;
+    /** Detector toggles (all default true when enabled) */
+    detectEmails?: boolean;
+    detectIPs?: boolean;
+    detectPhoneNumbers?: boolean;
+    detectJWTs?: boolean;
+    detectAPIKeys?: boolean;
+    detectAWSCreds?: boolean;
+    detectAzureKeys?: boolean;
+    detectGCPKeys?: boolean;
+    detectPasswords?: boolean;
+    detectCreditCards?: boolean;
+    /** Behavior settings */
+    maskWith?: string;
+    partialMaskRatio?: number;
+    maxDepth?: number;
+    keysDenylist?: string[];
+    keysAllowlist?: string[];
+    fieldsHashInsteadOfMask?: string[];
+}
+/**
+ * Configuration for logging behavior
+ */
+export interface LoggingConfig {
+    /** Enable console output (default: true) */
+    logToConsole?: boolean;
+    /** Enable file output (default: false) */
+    logToFile?: boolean;
+    /** File path for logs (required if logToFile is true) */
+    logFilePath?: string;
+    /** Minimum log level to output (default: 'info') */
+    logLevel?: LogLevel;
+    /** Output format: 'text' or 'json' (default: 'text') */
+    logFormat?: LogFormat;
+    /** Show full ISO timestamp in console logs (default: false) */
+    showFullTimestamp?: boolean;
+    /** Console package filtering: only show logs from these packages (comma-separated, console only) */
+    consolePackagesShow?: string[];
+    /** Console package filtering: hide logs from these packages (comma-separated, console only) */
+    consolePackagesHide?: string[];
+    /** Custom logxer implementation (advanced use) */
+    customLogger?: CustomLogxer;
+    /** Enable unified-logger output (default: false) */
+    enableUnifiedLogger?: boolean;
+    /** Unified logger configuration */
+    unifiedLogger?: UnifiedLoggerConfig;
+    /** Default source for logs emitted by this logger if not provided per-call */
+    defaultSource?: string;
+    /** PII/credentials sanitization configuration */
+    sanitization?: SanitizationConfig;
+    /** Transport configuration */
+    transports?: TransportsConfig;
+    /** Tracing configuration */
+    tracing?: TracingConfig;
+    /** Trails configuration */
+    trails?: TrailsConfig;
+    /** Schema validation configuration */
+    schemaCheck?: {
+        enabled?: boolean;
+    };
+    /** Shadow logging configuration */
+    shadow?: ShadowConfig;
+    /** Debug scoping configuration (from logxer-debug.json) */
+    debugScoping?: DebugScopingConfig;
+}
+/**
+ * Between rule for stateful range-based filtering
+ */
+export interface BetweenRule {
+    /** Action to take when range is active */
+    action: 'include' | 'exclude';
+    /** If true: exact match (case sensitive), if false: partial match (case insensitive). Default: false */
+    exactMatch?: boolean;
+    /** If true: search entire log (message, identity, all meta fields), if false: only identity. Default: false */
+    searchLog?: boolean;
+    /** Identity patterns that start the range. Empty array means range starts from beginning. */
+    startIdentities: string[];
+    /** Identity patterns that end the range. Empty array means range never ends. */
+    endIdentities: string[];
+}
+/**
+ * Debug scoping configuration loaded from logxer-debug.json
+ */
+export interface DebugScopingConfig {
+    scoping: {
+        /** Enable or disable runtime filtering */
+        status: 'enabled' | 'disabled';
+        /** Filter logs by identity (file:function format) */
+        filterIdentities?: string[];
+        /** Filter logs by application name */
+        filteredApplications?: string[];
+        /** Stateful range-based filtering rules */
+        between?: BetweenRule[];
+    };
+}
+/**
+ * Custom logxer interface for injecting external logxers (Winston, Pino, etc.)
+ */
+export interface CustomLogxer {
+    verbose: (message: string, data?: any) => void;
+    debug: (message: string, data?: any) => void;
+    info: (message: string, data?: any) => void;
+    warn: (message: string, data?: any) => void;
+    error: (message: string, data?: any) => void;
+    success: (message: string, data?: any) => void;
+}
+/**
+ * Package identification configuration
+ */
+export interface LogxerPackageConfig {
+    /** Display name in logs (e.g., 'MY_APP', 'DATABASE_SERVICE') */
+    packageName: string;
+    /** Environment variable prefix (e.g., 'MY_APP', 'DB_SERVICE') */
+    envPrefix: string;
+    /** Debug namespace for DEBUG env var (e.g., 'my-app', 'db-service') */
+    debugNamespace?: string;
+}
+/**
+ * Structured log entry (used for JSON format)
+ */
+export interface LogEntry {
+    timestamp: string;
+    package: string;
+    level: string;
+    message: string;
+    data?: any;
+    /** Consuming application name (auto-detected from package.json) */
+    appName?: string;
+    /** Consuming application version (auto-detected from package.json) */
+    appVersion?: string;
+}
+/**
+ * Routing metadata for controlling log output destinations
+ */
+export interface RoutingMeta {
+    /** Allowed output destinations (e.g., ['unified-logger', 'console']) */
+    allowedOutputs?: string[];
+    /** Blocked output destinations (e.g., ['unified-logger', 'file']) */
+    blockOutputs?: string[];
+    /** Debugging aid for why routing rules were applied */
+    reason?: string;
+    /** Optional hints for routing decisions */
+    tags?: string[];
+}
+/**
+ * Log metadata that can be attached to log entries
+ */
+export interface LogMeta {
+    /** Backward-compatible payload - any additional data */
+    [key: string]: any;
+    /** Source identifier for the log entry */
+    source?: string;
+    /** Identity identifier for the log entry (unique based on code location, auto-generated if not provided) */
+    identity?: string;
+    /** Correlation ID for tracing related log entries */
+    correlationId?: string;
+    /** Routing metadata for controlling output destinations */
+    _routing?: RoutingMeta;
+    /** Shadow logging override metadata */
+    _shadow?: {
+        /** Override runId for shadow capture */
+        runId?: string;
+    };
+}
+/**
+ * Unified logger transport configuration
+ */
+export interface UnifiedLoggerTransports {
+    /** Enable console output via unified-logger */
+    console?: boolean;
+    /** Enable Papertrail output via unified-logger */
+    papertrail?: boolean;
+    /** Enable UDP relay output via unified-logger */
+    udpRelay?: boolean;
+}
+/**
+ * Unified logger configuration
+ */
+export interface UnifiedLoggerConfig {
+    /** Path to logger.json config file */
+    configPath?: string;
+    /** Inline @x-developer/unified-logger ILoggerConfig */
+    configInline?: any;
+    /** Simple overrides */
+    service?: string;
+    env?: string;
+    level?: 'verbose' | 'debug' | 'info' | 'warn' | 'error';
+    transports?: UnifiedLoggerTransports;
+    /** Optional level filter for this output */
+    levels?: LogLevel[];
+}
+/**
+ * Internal configuration type with all required fields
+ */
+export type InternalLoggingConfig = Required<Omit<LoggingConfig, 'customLogger' | 'unifiedLogger' | 'transports' | 'tracing' | 'trails' | 'schemaCheck' | 'shadow' | 'consolePackagesShow' | 'consolePackagesHide' | 'debugScoping'>> & {
+    customLogger?: CustomLogxer;
+    unifiedLogger?: UnifiedLoggerConfig;
+    /** When true, package diagnostics are suppressed regardless of DEBUG or sinks (see resolvePackageLogsLevel). */
+    packageLogsDisabled: boolean;
+    packageName: string;
+    transports?: TransportsConfig;
+    tracing?: TracingConfig;
+    trails?: TrailsConfig;
+    schemaCheck?: {
+        enabled?: boolean;
+    };
+    shadow?: ShadowConfig;
+    consolePackagesShow?: string[] | undefined;
+    consolePackagesHide?: string[] | undefined;
+    debugScoping?: DebugScopingConfig;
+};
+/**
+ * Trails configuration for operation and thread tracking
+ */
+export interface TrailsConfig {
+    /** Enable depth/operation trail tracking */
+    enableDepthTrail?: boolean;
+    /** Enable thread/causal trail tracking */
+    enableThreadTrail?: boolean;
+    /** Inject trail headers on outbound requests */
+    injectHeaders?: boolean;
+    /** Extract trail headers from inbound requests */
+    extractHeaders?: boolean;
+    /** Maximum sequence number window for thread tracking */
+    sequenceWindow?: number;
+}
+/**
+ * Shadow logging configuration for per-run debug capture
+ */
+export interface ShadowConfig {
+    /** Enable shadow logging (default: false) */
+    enabled?: boolean;
+    /** Output format for shadow files (default: 'json') */
+    format?: 'json' | 'yaml';
+    /** Directory for shadow files (default: './logs/shadow') */
+    directory?: string;
+    /** Time-to-live in milliseconds (default: 86400000 = 1 day) */
+    ttlMs?: number;
+    /** Respect routing blockOutputs metadata (default: true) */
+    respectRoutingBlocks?: boolean;
+    /** Rolling buffer for after-the-fact capture */
+    rollingBuffer?: {
+        /** Maximum number of entries to buffer (default: 0 = disabled) */
+        maxEntries?: number;
+        /** Maximum age of buffered entries in ms (default: 0 = disabled) */
+        maxAgeMs?: number;
+    };
+}
+/**
+ * Shadow controller interface for runtime management
+ */
+export interface ShadowController {
+    /** Enable shadow capture for a specific runId */
+    enable(runId: string, opts?: Partial<ShadowConfig>): void;
+    /** Disable shadow capture for a specific runId */
+    disable(runId: string): void;
+    /** Check if shadow capture is enabled for a runId */
+    isEnabled(runId: string): boolean;
+    /** List all active shadow captures */
+    listActive(): {
+        runId: string;
+        since: string;
+        format: 'json' | 'yaml';
+    }[];
+    /** Export shadow file to a destination path */
+    export(runId: string, outPath?: string): Promise<string>;
+    /** Clean up expired shadow files based on TTL */
+    cleanupExpired(now?: number): Promise<number>;
+}
+/**
+ * Transport configuration options
+ */
+export interface TransportsConfig {
+    /** Core logging transport: pino (high-perf) or builtin (fallback) */
+    core?: 'pino' | 'builtin';
+    /** File rotation strategy: winston (daily), rfs (size/interval), or none */
+    fileRotation?: 'winston' | 'rfs' | 'none';
+    /** Enable pretty output in development */
+    devPretty?: boolean;
+}
+/**
+ * Tracing configuration for OpenTelemetry integration
+ */
+export interface TracingConfig {
+    /** Enable OpenTelemetry context integration (no-op if @opentelemetry/api not available) */
+    enableOtelContext?: boolean;
+}
+/**
+ * Operation context for depth trail tracking
+ */
+export interface OperationCtx {
+    /** Unique operation identifier */
+    operationId: string;
+    /** Parent operation identifier */
+    parentOperationId?: string | undefined;
+    /** Human-readable operation name */
+    operationName: string;
+    /** Hierarchical operation path */
+    operationPath: string;
+    /** Step number within operation */
+    operationStep: number;
+    /** Trace identifier */
+    traceId: string;
+    /** Span identifier */
+    spanId: string;
+}
+/**
+ * Thread context for causal trail tracking
+ */
+export interface ThreadContext {
+    /** Unique thread identifier */
+    threadId: string;
+    /** Current event identifier */
+    eventId: string;
+    /** Causation chain (events that caused this one) */
+    causationId?: string | string[] | undefined;
+    /** Sequence number within thread */
+    sequenceNo: number;
+    /** Partition key for distributed processing */
+    partitionKey?: string | undefined;
+    /** Retry attempt number */
+    attempt?: number | undefined;
+    /** Shard identifier */
+    shardId?: string | undefined;
+    /** Worker identifier */
+    workerId?: string | undefined;
+}
+/**
+ * Normalized log envelope structure
+ */
+export interface LogEnvelope {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Package name */
+    package: string;
+    /** Log level */
+    level: string;
+    /** Log message */
+    message: string;
+    /** Source identifier */
+    source: string;
+    /** Sanitized payload data */
+    data?: any;
+    /** Consuming application name (auto-detected from package.json) */
+    appName?: string;
+    /** Consuming application version (auto-detected from package.json) */
+    appVersion?: string;
+    /** Correlation identifier */
+    correlationId?: string;
+    /** Job identifier */
+    jobId?: string;
+    /** Run identifier */
+    runId?: string;
+    /** Session identifier */
+    sessionId?: string;
+    /** Operation identifier */
+    operationId?: string;
+    /** Parent operation identifier */
+    parentOperationId?: string;
+    /** Operation name */
+    operationName?: string;
+    /** Operation path */
+    operationPath?: string;
+    /** Operation step */
+    operationStep?: number;
+    /** Thread identifier */
+    threadId?: string;
+    /** Event identifier */
+    eventId?: string;
+    /** Causation identifier(s) */
+    causationId?: string | string[];
+    /** Sequence number */
+    sequenceNo?: number;
+    /** Partition key */
+    partitionKey?: string;
+    /** Attempt number */
+    attempt?: number;
+    /** Shard identifier */
+    shardId?: string;
+    /** Worker identifier */
+    workerId?: string;
+    /** Trace identifier */
+    traceId?: string;
+    /** Span identifier */
+    spanId?: string;
+    /** Identity identifier for the log entry (unique based on code location) */
+    identity?: string;
+    /** Routing metadata */
+    _routing?: RoutingMeta;
+    /** Free-form tags */
+    tags?: string[];
+}
+//# sourceMappingURL=types.d.ts.map