@nx-ddd/logging 19.51.0 → 19.80.0

package/types/nx-ddd-logging-http.d.ts

@@ -0,0 +1,51 @@
+import { Provider } from '@angular/core';
+import { LogLevel, BaseLogger, LogContext } from '@nx-ddd/logging/base';
+
+interface HttpLogRecord {
+    id: string;
+    timestamp: number;
+    peer_id: string;
+    process_id: number;
+    level: string;
+    component: string;
+    message: string;
+    context: string | null;
+    error: string | null;
+}
+interface HttpLoggerOptions {
+    resolveEndpoint: () => string | null;
+    peerId?: string | (() => string);
+    minLevel?: LogLevel;
+    flushIntervalMs?: number;
+    maxBatch?: number;
+    maxBuffer?: number;
+    fetchFn?: typeof fetch;
+}
+declare const DEFAULT_HTTP_FLUSH_INTERVAL_MS = 1000;
+declare const DEFAULT_HTTP_MAX_BATCH = 200;
+declare const DEFAULT_HTTP_MAX_BUFFER = 5000;
+declare class HttpLogger extends BaseLogger {
+    private readonly resolveEndpoint;
+    private readonly peerId;
+    private readonly minLevel;
+    private readonly maxBatch;
+    private readonly maxBuffer;
+    private readonly fetchFn;
+    private readonly buffer;
+    private timer;
+    private inflight;
+    private closed;
+    private seq;
+    private warnedOnce;
+    constructor(options: HttpLoggerOptions);
+    log(level: LogLevel, message: string, context?: LogContext, error?: Error): void;
+    close(): void;
+    private toRecord;
+    private flush;
+    private safeResolveEndpoint;
+}
+declare function provideHttpLogger(options: HttpLoggerOptions): Provider;
+
+export { DEFAULT_HTTP_FLUSH_INTERVAL_MS, DEFAULT_HTTP_MAX_BATCH, DEFAULT_HTTP_MAX_BUFFER, HttpLogger, provideHttpLogger };
+export type { HttpLogRecord, HttpLoggerOptions };
+//# sourceMappingURL=nx-ddd-logging-http.d.ts.map

package/types/nx-ddd-logging-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nx-ddd-logging-http.d.ts","sources":["../../../../../packages/@nx-ddd/logging/src/lib/http/http.logger.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;AAWE;AACA;AACD;;AAGC;;;;;;AAMA;AACD;AAED;AACA;AACA;AAEA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;;;;;;AAOY;AAYZ;AAMA;AASA;;AAwCA;AAOD;AAED;;;"}

package/types/nx-ddd-logging-tee.d.ts

@@ -3,16 +3,6 @@ import * as i0 from '@angular/core';
 import { Provider } from '@angular/core';
 import * as fs from 'fs';
 
-/**
- * TeeLogger - ファイルとコンソール両方にログを出力（BaseLogger継承版）
- *
- * BaseLoggerを継承することでLoggingServiceのmulti-providerチェーンに統合可能。
- * console.logのオーバーライドを廃止し、正規のLoggingService経由でログレベルを保持する。
- *
- * - initialize() なし: コンソールのみ出力（ConsoleLogger と同等）
- * - initialize(logFile): コンソール + ファイル出力
- * - E2E 時は FileLogger を使用するため、TeeLogger は常にコンソール出力が有効
- */
 declare class TeeLogger extends BaseLogger {
     private logStream;
     private enableConsoleOutput;
@@ -30,13 +20,6 @@ declare class TeeLogger extends BaseLogger {
 declare function provideTeeLogger(): Provider[];
 
 type RestoreStdioFn = () => void;
-/**
- * `process.stdout` / `process.stderr` の write を wrap し、書き込み内容を
- * `stream` にも tee する。foreground 起動時に `console.log` 直書きを含む
- * 全 stdout/stderr 出力をログファイルへ流すために使う。
- *
- * 戻り値の `restore()` で元の write 関数に戻せる。
- */
 declare function pipeStdioToStream(stream: fs.WriteStream): RestoreStdioFn;
 
 export { TeeLogger, pipeStdioToStream, provideTeeLogger };

package/types/nx-ddd-logging-tee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nx-ddd-logging-tee.d.ts","sources":["../../../../../packages/@nx-ddd/logging/src/lib/tee/tee.logger.ts","../../../../../packages/@nx-ddd/logging/src/lib/tee/pipe-stdio.ts"],"sourcesContent":[null,null],"names":[],"mappings":";;;;;AAKA;;;;;;;;;AASG;AACH;;;;;;;;AAUsD;;AA6BpD;;;AAUD;AAED;;AChEM;AAIN;;;;;;AAMG;AACH;;;"}
+{"version":3,"file":"nx-ddd-logging-tee.d.ts","sources":["../../../../../packages/@nx-ddd/logging/src/lib/tee/tee.logger.ts","../../../../../packages/@nx-ddd/logging/src/lib/tee/pipe-stdio.ts"],"sourcesContent":[null,null],"names":[],"mappings":";;;;;AAOA;;;;;;;;AAUsD;;AA6BpD;;;AAUD;AAED;;ACxDM;AAKN;;;"}

package/types/nx-ddd-logging.d.ts

@@ -2,11 +2,6 @@ import * as i0 from '@angular/core';
 import { InjectionToken, Provider, EnvironmentProviders } from '@angular/core';
 import { ILoggingService as ILoggingService$1, LogLevel as LogLevel$1, LogContext as LogContext$1 } from '@nx-ddd/logging/base';
 
-/**
- * LoggingService interfaces
- *
- * Provides structured logging with different log levels and file output
- */
 declare enum LogLevel {
     DEBUG = 0,
     INFO = 1,
@@ -16,58 +11,25 @@ declare enum LogLevel {
 }
 interface LogContext {
     component?: string;
+    package?: string;
     sessionId?: string;
     clientId?: string;
     [key: string]: any;
 }
 interface ILoggingService {
-    /**
-     * Log debug message (for development/troubleshooting)
-     */
     debug(message: string, context?: LogContext): void;
-    /**
-     * Log informational message
-     */
     info(message: string, context?: LogContext): void;
-    /**
-     * Log warning message
-     */
     warn(message: string, context?: LogContext): void;
-    /**
-     * Log error message
-     */
     error(message: string, error?: Error, context?: LogContext): void;
-    /**
-     * Log fatal error message (application cannot continue)
-     */
     fatal(message: string, error?: Error, context?: LogContext): void;
-    /**
-     * Set log level filter
-     */
     setLogLevel(level: LogLevel): void;
-    /**
-     * Set component name for this logger
-     */
     setComponent(component: string): void;
-    /**
-     * Close logger and flush buffers
-     */
     close(): void;
 }
 
-/**
- * Base Logger class for multi-provider logging system
- */
-
 declare const LOGGER: InjectionToken<BaseLogger>;
 declare abstract class BaseLogger {
-    /**
-     * Main log method that all loggers must implement
-     */
     abstract log(level: LogLevel, message: string, context?: LogContext, error?: Error): void;
-    /**
-     * Close logger and flush buffers
-     */
     abstract close(): void;
     debug(message: string, context?: LogContext): void;
     info(message: string, context?: LogContext): void;
@@ -79,68 +41,15 @@ declare abstract class BaseLogger {
 }
 declare function provideLogger(useFactory: () => BaseLogger): Provider;
 
-/**
- * LogFilter - Simple function-based log filtering
- */
-
-/**
- * Log filter function type
- * @param level - The log level
- * @param context - Optional log context (component name, etc.)
- * @returns true if the log should be output, false to suppress
- */
 type LogFilterFn = (level: LogLevel, context?: LogContext) => boolean;
 declare const LOG_FILTER: InjectionToken<LogFilterFn>;
 
-/**
- * Provider functions for log filtering
- */
-
-/**
- * Provide a log filter function
- *
- * @example
- * // Filter by log level
- * provideLogFilter((level) => level >= LogLevel.WARN)
- *
- * @example
- * // Filter by component
- * provideLogFilter((level, context) => context?.component?.startsWith('My'))
- *
- * @example
- * // Allow all logs
- * provideLogFilter(() => true)
- */
 declare function provideLogFilter(filter: LogFilterFn): Provider;
-/**
- * Configuration for log filtering
- */
 interface LogFilterConfig {
     minLevel?: LogLevel;
     componentPattern?: string;
 }
-/**
- * Provide a log filter with explicit configuration
- * @param config - Filter configuration (minLevel defaults to WARN)
- */
 declare function provideLogFilterWithConfig(config?: LogFilterConfig): Provider;
-/**
- * @deprecated Use provideLogFilterWithConfig() instead.
- * This function directly accesses process.env which violates the rule
- * that packages should not access environment variables directly.
- *
- * Migration example:
- * ```typescript
- * // Before (in packages)
- * provideLogFilterFromEnv()
- *
- * // After (in application layer)
- * provideLogFilterWithConfig({
- *   minLevel: process.env['LOG_LEVEL'] ? LogLevel[process.env['LOG_LEVEL'].toUpperCase()] : undefined,
- *   componentPattern: process.env['LOG_COMPONENTS']
- * })
- * ```
- */
 declare function provideLogFilterFromEnv(): Provider;
 
 declare const LOGGING_SERVICE: InjectionToken<ILoggingService$1>;
@@ -150,11 +59,15 @@ interface Logger {
     info: (...args: Parameters<typeof console['info']>) => void;
     warn: (...args: Parameters<typeof console['warn']>) => void;
     error: (...args: Parameters<typeof console['error']>) => void;
+    child: (segment: string) => Logger;
+}
+interface LoggerMeta {
+    package?: string;
 }
 declare class LoggingService implements ILoggingService$1 {
     private loggers;
     private filter;
-    getLogger(name: string): Logger;
+    getLogger(name: string, meta?: LoggerMeta): Logger;
     log(level: LogLevel$1, message: string, context?: LogContext$1, error?: Error): void;
     close(): void;
     debug(message: string, context?: LogContext$1): void;
@@ -173,9 +86,9 @@ declare let globalLogging: LoggingService | null;
 declare function setGlobalLogging(logging: LoggingService): void;
 declare function getGlobalLogging(): LoggingService | null;
 declare function createLogger(name: any): ILoggingService$1 | null;
-declare function getLogger(name: string): Logger;
+declare function getLogger(name: string, meta?: LoggerMeta): Logger;
 declare function provideGlobalLogging(): EnvironmentProviders;
 
 export { BaseLogger, LOGGER, LOGGING_SERVICE, LOG_FILTER, LogLevel, LoggingService, createLogger, getGlobalLogging, getLogger, globalLogging as logging, provideGlobalLogging, provideLogFilter, provideLogFilterFromEnv, provideLogFilterWithConfig, provideLogger, setGlobalLogging };
-export type { ILoggingService, LogContext, LogFilterConfig, LogFilterFn, Logger };
+export type { ILoggingService, LogContext, LogFilterConfig, LogFilterFn, Logger, LoggerMeta };
 //# sourceMappingURL=nx-ddd-logging.d.ts.map

package/types/nx-ddd-logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nx-ddd-logging.d.ts","sources":["../../../../../packages/@nx-ddd/logging/src/lib/base/interfaces.ts","../../../../../packages/@nx-ddd/logging/src/lib/base/base.logger.ts","../../../../../packages/@nx-ddd/logging/src/lib/base/log-filter.ts","../../../../../packages/@nx-ddd/logging/src/lib/base/providers.ts","../../../../../packages/@nx-ddd/logging/src/lib/logging.service.ts","../../../../../packages/@nx-ddd/logging/src/lib/global-logging.ts"],"sourcesContent":[null,null,null,null,null,null],"names":[],"mappings":";;;;AAAA;;;;AAIG;AAEH;AACE;AACA;AACA;AACA;AACA;AACD;;;;;AAMC;AACD;;AAGC;;AAEG;;AAGH;;AAEG;;AAGH;;AAEG;;AAGH;;AAEG;AACH;AAEA;;AAEG;AACH;AAEA;;AAEG;AACH;AAEA;;AAEG;AACH;AAEA;;AAEG;;AAEJ;;AC7DD;;AAEG;;AAKH;AAEA;AAEE;;AAEG;;AAQH;;AAEG;;;;;AAgBH;AAIA;;;AAGD;AAED;;AChDA;;AAEG;;AAKH;;;;;AAKG;AACG;AAEN;;ACfA;;AAEG;;AAMH;;;;;;;;;;;;;;AAcG;AACH;AAIA;;AAEG;;;;AAIF;AAED;;;AAGG;AACH;AAaA;;;;;;;;;;;;;;;;AAgBG;AACH;;AClEA;;AAGE;AACA;AACA;AACA;AACA;AACD;AAED;;;AAKE;AAsBA;AAOA;;;;AAgBA;AAIA;AAIA;AAIA;;;AAGD;;AC1ED;;AAGA;AAIA;AAIA;AAQA;AAIA;;;"}
+{"version":3,"file":"nx-ddd-logging.d.ts","sources":["../../../../../packages/@nx-ddd/logging/src/lib/base/interfaces.ts","../../../../../packages/@nx-ddd/logging/src/lib/base/base.logger.ts","../../../../../packages/@nx-ddd/logging/src/lib/base/log-filter.ts","../../../../../packages/@nx-ddd/logging/src/lib/base/providers.ts","../../../../../packages/@nx-ddd/logging/src/lib/logging.service.ts","../../../../../packages/@nx-ddd/logging/src/lib/global-logging.ts"],"sourcesContent":[null,null,null,null,null,null],"names":[],"mappings":";;;;AAEA;AACE;AACA;AACA;AACA;AACA;AACD;;;;;;AAOC;AACD;;;;;AAaC;AAGA;AAGA;AAGA;;AAID;;ACrCD;AAEA;;;;;;AA0BE;AAIA;;;AAGD;AAED;;ACpCM;AAEN;;ACDA;;;;AAQC;AAGD;AAcA;;AC7BA;;AAGE;AACA;AACA;AACA;AACA;AACA;AACD;;;AAIA;AAED;;;;AA6BE;AAOA;;;;AAgBA;AAIA;AAIA;AAIA;;;AAGD;;ACjFD;;AAGA;AAIA;AAIA;AAWA;AAIA;;;"}