@adcp/client 2.5.0 → 2.5.1

package/dist/lib/utils/logger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Logger utility for AdCP Client
+ *
+ * Provides structured logging with levels and contextual metadata.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LoggerConfig {
+    /** Minimum log level to output (default: 'info') */
+    level?: LogLevel;
+    /** Enable/disable logging globally (default: true) */
+    enabled?: boolean;
+    /** Custom log handler (default: console) */
+    handler?: {
+        debug: (message: string, meta?: any) => void;
+        info: (message: string, meta?: any) => void;
+        warn: (message: string, meta?: any) => void;
+        error: (message: string, meta?: any) => void;
+    };
+}
+declare class Logger {
+    private config;
+    constructor(config?: LoggerConfig);
+    private shouldLog;
+    /**
+     * Log debug message (development/troubleshooting)
+     */
+    debug(message: string, meta?: any): void;
+    /**
+     * Log info message (general information)
+     */
+    info(message: string, meta?: any): void;
+    /**
+     * Log warning message (non-critical issues)
+     */
+    warn(message: string, meta?: any): void;
+    /**
+     * Log error message (critical issues)
+     */
+    error(message: string, meta?: any): void;
+    /**
+     * Create a child logger with contextual prefix
+     */
+    child(context: string): Logger;
+    /**
+     * Update logger configuration
+     */
+    configure(config: Partial<LoggerConfig>): void;
+}
+export declare const logger: Logger;
+/**
+ * Create a new logger instance with custom configuration
+ */
+export declare function createLogger(config?: LoggerConfig): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC5C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC5C,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;KAC9C,CAAC;CACH;AASD,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,GAAE,YAAiB;IAarC,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMxC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMxC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAG/C;AAGD,eAAO,MAAM,MAAM,QAGjB,CAAC;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAE1D"}

package/dist/lib/utils/logger.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Logger utility for AdCP Client
+ *
+ * Provides structured logging with levels and contextual metadata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.createLogger = createLogger;
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+class Logger {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            level: config.level || 'info',
+            enabled: config.enabled !== false,
+            handler: config.handler || {
+                debug: (msg, meta) => console.log(msg, meta ? meta : ''),
+                info: (msg, meta) => console.log(msg, meta ? meta : ''),
+                warn: (msg, meta) => console.warn(msg, meta ? meta : ''),
+                error: (msg, meta) => console.error(msg, meta ? meta : '')
+            }
+        };
+    }
+    shouldLog(level) {
+        if (!this.config.enabled)
+            return false;
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+    }
+    /**
+     * Log debug message (development/troubleshooting)
+     */
+    debug(message, meta) {
+        if (this.shouldLog('debug')) {
+            this.config.handler.debug(message, meta);
+        }
+    }
+    /**
+     * Log info message (general information)
+     */
+    info(message, meta) {
+        if (this.shouldLog('info')) {
+            this.config.handler.info(message, meta);
+        }
+    }
+    /**
+     * Log warning message (non-critical issues)
+     */
+    warn(message, meta) {
+        if (this.shouldLog('warn')) {
+            this.config.handler.warn(message, meta);
+        }
+    }
+    /**
+     * Log error message (critical issues)
+     */
+    error(message, meta) {
+        if (this.shouldLog('error')) {
+            this.config.handler.error(message, meta);
+        }
+    }
+    /**
+     * Create a child logger with contextual prefix
+     */
+    child(context) {
+        const parentHandler = this.config.handler;
+        return new Logger({
+            ...this.config,
+            handler: {
+                debug: (msg, meta) => parentHandler.debug(`[${context}] ${msg}`, meta),
+                info: (msg, meta) => parentHandler.info(`[${context}] ${msg}`, meta),
+                warn: (msg, meta) => parentHandler.warn(`[${context}] ${msg}`, meta),
+                error: (msg, meta) => parentHandler.error(`[${context}] ${msg}`, meta)
+            }
+        });
+    }
+    /**
+     * Update logger configuration
+     */
+    configure(config) {
+        Object.assign(this.config, config);
+    }
+}
+// Default global logger instance
+exports.logger = new Logger({
+    level: process.env.LOG_LEVEL || 'info',
+    enabled: process.env.LOG_ENABLED !== 'false'
+});
+/**
+ * Create a new logger instance with custom configuration
+ */
+function createLogger(config) {
+    return new Logger(config);
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/utils/logger.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/client",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "AdCP client library with protocol support for MCP and A2A, includes testing framework",
   "main": "dist/lib/index.js",
   "types": "dist/lib/index.d.ts",