stratal 0.0.21 → 0.0.23

package/dist/index-DBd_2wv8.d.mts

@@ -1,263 +0,0 @@
-//#region src/logger/logger.tokens.d.ts
-/**
- * Dependency Injection Tokens for Logger Module
- *
- * Symbol-based tokens ensure type-safe dependency injection
- * and prevent naming collisions.
- */
-declare const LOGGER_TOKENS: {
-  /**
-   * Main logger service facade
-   */
-  readonly LoggerService: symbol;
-  /**
-   * Log formatter (JSON or Pretty)
-   */
-  readonly Formatter: symbol;
-  /**
-   * Array of active transports
-   */
-  readonly Transports: symbol;
-  /**
-   * Individual transport tokens (for factory registration)
-   */
-  readonly ConsoleTransport: symbol;
-  /**
-   * Configured log level for filtering
-   */
-  readonly LogLevelOptions: symbol;
-};
-//#endregion
-//#region src/logger/contracts/log-level.d.ts
-/**
- * Log severity levels
- * Ordered from least to most severe
- */
-declare enum LogLevel {
-  DEBUG = "debug",
-  INFO = "info",
-  WARN = "warn",
-  ERROR = "error"
-}
-/**
- * Map log levels to numeric priorities (for filtering)
- * Higher numbers = more severe = higher priority
- */
-declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
-//#endregion
-//#region src/logger/contracts/log-context.d.ts
-/**
- * Structured metadata attached to log entries
- * Supports arbitrary key-value pairs for context enrichment
- */
-type LogContext = Record<string, unknown>;
-/**
- * Internal context automatically added by LoggerService
- * Contains request metadata, etc.
- */
-interface InternalLogContext extends LogContext {
-  userId?: string;
-  timestamp: number;
-}
-//#endregion
-//#region src/logger/contracts/log-entry.d.ts
-/**
- * Complete log entry structure passed to transports
- * Combines message, level, and enriched context
- */
-interface LogEntry {
-  level: LogLevel;
-  message: string;
-  context: InternalLogContext;
-  error?: {
-    message: string;
-    stack?: string;
-    name?: string;
-  };
-}
-//#endregion
-//#region src/logger/formatters/formatter.interface.d.ts
-/**
- * Formatter contract
- * Transforms LogEntry into string representation for transport output
- */
-interface ILogFormatter {
-  /**
-   * Format log entry into string
-   * @param entry - Complete log entry with context
-   * @returns Formatted string ready for transport
-   */
-  format(entry: LogEntry): string;
-}
-//#endregion
-//#region src/logger/transports/transport.interface.d.ts
-/**
- * Transport contract
- * Handles delivery of formatted log entries to destinations
- */
-interface ILogTransport {
-  /**
-   * Transport name for identification
-   */
-  readonly name: string;
-  /**
-   * Write log entry to destination
-   * Must be async to support waitUntil pattern
-   *
-   * @param entry - Complete log entry
-   * @param formatted - Pre-formatted string from formatter
-   * @returns Promise that resolves when log is written
-   */
-  write(entry: LogEntry, formatted: string): Promise<void>;
-}
-//#endregion
-//#region src/logger/services/logger.service.d.ts
-/**
- * Logger Service
- *
- * Main logging facade.
- *
- * **Features:**
- * - Async logging via ctx.waitUntil() for non-blocking performance
- * - Multi-transport support (console, future Sentry/Cloudflare Analytics)
- * - Configurable formatters (JSON production, Pretty development)
- * - Log level filtering based on environment
- *
- * **Architecture:**
- * - Transports and formatters injected via DI
- *
- * @example Basic usage
- * ```typescript
- * @Transient()
- * export class UserService {
- *   constructor(
- *     @inject(LOGGER_TOKENS.LoggerService)
- *     private readonly logger: LoggerService
- *   ) {}
- *
- *   async createUser(input: CreateUserInput) {
- *     this.logger.info('Creating user', { email: input.email })
- *   }
- * }
- * ```
- */
-declare class LoggerService {
-  private readonly logLevel;
-  private readonly executionContext;
-  private readonly formatter;
-  private readonly transports;
-  constructor(logLevel: LogLevel, executionContext: globalThis.ExecutionContext, formatter: ILogFormatter, transports: ILogTransport[]);
-  /**
-   * Log debug message (development only)
-   */
-  debug(message: string, context?: LogContext): void;
-  /**
-   * Log info message
-   */
-  info(message: string, context?: LogContext): void;
-  /**
-   * Log warning message
-   */
-  warn(message: string, context?: LogContext): void;
-  /**
-   * Log error message
-   * Accepts Error object or custom context
-   */
-  error(message: string, contextOrError?: LogContext | Error): void;
-  /**
-   * Core logging implementation
-   * Enriches context, formats message, dispatches to transports
-   * Uses ctx.waitUntil() for async non-blocking processing
-   */
-  private log;
-  /**
-   * Enrich log context with request info and timestamp
-   * Context enrichment can be extended by application modules
-   */
-  private enrichContext;
-  /**
-   * Serialize Error object for transport
-   */
-  private serializeError;
-}
-//#endregion
-//#region src/logger/formatters/json-formatter.d.ts
-/**
- * JSON Formatter
- *
- * Produces structured JSON logs for production environments.
- * Optimized for log aggregation systems (Cloudflare Analytics, Datadog, etc.)
- *
- * Output format:
- * {
- *   "level": "info",
- *   "message": "User logged in",
- *   "timestamp": 1234567890,
- *   "userId": "user_456",
- *   "error": { "message": "...", "stack": "..." }
- * }
- */
-declare class JsonFormatter implements ILogFormatter {
-  format(entry: LogEntry): string;
-}
-//#endregion
-//#region src/logger/formatters/pretty-formatter.d.ts
-/**
- * Pretty Formatter
- *
- * Human-readable colored output for development environments.
- * Uses ANSI color codes for terminal output.
- *
- * Output format:
- * [2024-01-15 10:30:45] INFO: User logged in
- *   userId: user_456
- */
-declare class PrettyFormatter implements ILogFormatter {
-  private readonly colors;
-  private readonly reset;
-  format(entry: LogEntry): string;
-}
-//#endregion
-//#region src/logger/transports/base-transport.d.ts
-/**
- * Base Transport
- *
- * Abstract base class providing shared transport logic.
- * Reduces code duplication across transport implementations.
- */
-declare abstract class BaseTransport implements ILogTransport {
-  abstract readonly name: string;
-  /**
-   * Write log entry - must be implemented by concrete transports
-   */
-  abstract write(entry: LogEntry, formatted: string): Promise<void>;
-  /**
-   * Handle transport errors gracefully
-   * Logs to console.error as fallback to prevent log loss
-   *
-   * @param error - Error that occurred during write
-   * @param entry - Log entry that failed
-   */
-  protected handleError(error: unknown, entry: LogEntry): void;
-}
-//#endregion
-//#region src/logger/transports/console-transport.d.ts
-/**
- * Console Transport
- *
- * Writes logs to console using appropriate console methods.
- * Maps log levels to console.debug, console.info, console.warn, console.error.
- *
- * Thread-safe for Cloudflare Workers environment.
- */
-declare class ConsoleTransport extends BaseTransport {
-  readonly name = "console";
-  write(entry: LogEntry, formatted: string): Promise<void>;
-  /**
-   * Map log level to console method
-   */
-  private getConsoleMethod;
-}
-//#endregion
-export { LogEntry as a, LOG_LEVEL_PRIORITY as c, LoggerService as i, LogLevel as l, PrettyFormatter as n, InternalLogContext as o, JsonFormatter as r, LogContext as s, ConsoleTransport as t, LOGGER_TOKENS as u };
-//# sourceMappingURL=index-DBd_2wv8.d.mts.map

package/dist/index-DBd_2wv8.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-DBd_2wv8.d.mts","names":[],"sources":["../src/logger/logger.tokens.ts","../src/logger/contracts/log-level.ts","../src/logger/contracts/log-context.ts","../src/logger/contracts/log-entry.ts","../src/logger/formatters/formatter.interface.ts","../src/logger/transports/transport.interface.ts","../src/logger/services/logger.service.ts","../src/logger/formatters/json-formatter.ts","../src/logger/formatters/pretty-formatter.ts","../src/logger/transports/base-transport.ts","../src/logger/transports/console-transport.ts"],"mappings":";;AAMA;;;;;cAAa,aAAA;;;;;;;;;ECFD;;;EAAA;EACV;;;EAAA;EAGK;;AAOP;EAPO;;;;;ADFP;;;aCFY,QAAA;EACV,KAAA;EACA,IAAA;EACA,IAAA;EACA,KAAA;AAAA;;;;;cAOW,kBAAA,EAAoB,MAAA,CAAO,QAAA;;;;ADTxC;;;KEFY,UAAA,GAAa,MAAA;;;;;UAMR,kBAAA,SAA2B,UAAA;EAC1C,MAAA;EACA,SAAA;AAAA;;;;;;;UCLe,QAAA;EACf,KAAA,EAAO,QAAA;EACP,OAAA;EACA,OAAA,EAAS,kBAAA;EACT,KAAA;IACE,OAAA;IACA,KAAA;IACA,IAAA;EAAA;AAAA;;;AHRJ;;;;AAAA,UIAiB,aAAA;;;;;;EAMf,MAAA,CAAO,KAAA,EAAO,QAAA;AAAA;;;AJNhB;;;;AAAA,UKAiB,aAAA;;;;WAIN,IAAA;;;;;;AJNX;;;EIgBE,KAAA,CAAM,KAAA,EAAO,QAAA,EAAU,SAAA,WAAoB,OAAA;AAAA;;;;;;;;;;;;;;AJhB7C;;;;;;;;;;AAWA;;;;;;;;cKwBa,aAAA;EAAA,iBAGQ,QAAA;EAAA,iBAGA,gBAAA;EAAA,iBAGA,SAAA;EAAA,iBAGA,UAAA;cATA,QAAA,EAAU,QAAA,EAGV,gBAAA,EAAkB,UAAA,CAAW,gBAAA,EAG7B,SAAA,EAAW,aAAA,EAGX,UAAA,EAAY,aAAA;EJzCG;;;EI+ClC,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,UAAA;EJ9CjC;;;EIqDA,IAAA,CAAK,OAAA,UAAiB,OAAA,GAAU,UAAA;;;;EAOhC,IAAA,CAAK,OAAA,UAAiB,OAAA,GAAU,UAAA;EHhET;;;;EGwEvB,KAAA,CAAM,OAAA,UAAiB,cAAA,GAAiB,UAAA,GAAa,KAAA;EHtErD;;;;;EAAA,QGwFQ,GAAA;EHnFN;;;;EAAA,QGgIM,aAAA;;AFxIV;;UEkJU,cAAA;AAAA;;;;;;;;;;;;;;;;ALpJV;;cMca,aAAA,YAAyB,aAAA;EACpC,MAAA,CAAO,KAAA,EAAO,QAAA;AAAA;;;;;;;;;;;;;cCLH,eAAA,YAA2B,aAAA;EAAA,iBACrB,MAAA;EAAA,iBAOA,KAAA;EAEjB,MAAA,CAAO,KAAA,EAAO,QAAA;AAAA;;;;;;;;;uBCfM,aAAA,YAAyB,aAAA;EAAA,kBAC3B,IAAA;;;;WAKT,KAAA,CAAM,KAAA,EAAO,QAAA,EAAU,SAAA,WAAoB,OAAA;;ARXtD;;;;;;YQoBY,WAAA,CAAY,KAAA,WAAgB,KAAA,EAAO,QAAA;AAAA;;;;;;;;;;;cCTlC,gBAAA,SAAyB,aAAA;EAAA,SAC3B,IAAA;EAET,KAAA,CAAM,KAAA,EAAO,QAAA,EAAU,SAAA,WAAoB,OAAA;;;ATd7C;US4BU,gBAAA;AAAA"}