@geekmidas/telescope 0.0.1

package/dist/logger/console.mjs

@@ -0,0 +1,159 @@
+//#region src/logger/console.ts
+/**
+* A logger that sends logs to both Telescope and an optional underlying logger.
+* Implements the Logger interface from @geekmidas/logger.
+*
+* @example
+* ```typescript
+* import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+* import { TelescopeLogger } from '@geekmidas/telescope/logger/console';
+* import { ConsoleLogger } from '@geekmidas/logger/console';
+*
+* const telescope = new Telescope({ storage: new InMemoryStorage() });
+*
+* // With underlying logger (logs to both console and Telescope)
+* const logger = new TelescopeLogger({
+*   telescope,
+*   logger: new ConsoleLogger({ app: 'myApp' }),
+* });
+*
+* // Without underlying logger (logs only to Telescope)
+* const telescopeOnly = new TelescopeLogger({ telescope });
+*
+* // Usage
+* logger.info({ userId: '123' }, 'User logged in');
+* logger.error({ error: 'Something failed' }, 'Operation failed');
+* ```
+*/
+var TelescopeLogger = class TelescopeLogger {
+	telescope;
+	logger;
+	requestId;
+	context;
+	constructor(options) {
+		this.telescope = options.telescope;
+		this.logger = options.logger;
+		this.requestId = options.requestId;
+		this.context = options.context ?? {};
+	}
+	createLogFn(level) {
+		const fn = (objOrMsg, msg, ...args) => {
+			let context;
+			let message;
+			if (typeof objOrMsg === "string") {
+				context = { ...this.context };
+				message = objOrMsg;
+			} else {
+				context = {
+					...this.context,
+					...objOrMsg
+				};
+				message = msg ?? "";
+			}
+			if (this.logger) if (typeof objOrMsg === "string") this.logger[level](objOrMsg);
+			else this.logger[level](objOrMsg, msg, ...args);
+			this.telescope[level](message, context, this.requestId).catch(() => {});
+		};
+		return fn;
+	}
+	debug = this.createLogFn("debug");
+	info = this.createLogFn("info");
+	warn = this.createLogFn("warn");
+	error = this.createLogFn("error");
+	fatal = (objOrMsg, msg, ...args) => {
+		if (this.logger) if (typeof objOrMsg === "string") this.logger.fatal(objOrMsg);
+		else this.logger.fatal(objOrMsg, msg, ...args);
+		let context;
+		let message;
+		if (typeof objOrMsg === "string") {
+			context = {
+				...this.context,
+				level: "fatal"
+			};
+			message = objOrMsg;
+		} else {
+			context = {
+				...this.context,
+				...objOrMsg,
+				level: "fatal"
+			};
+			message = msg ?? "";
+		}
+		this.telescope.error(message, context, this.requestId).catch(() => {});
+	};
+	trace = (objOrMsg, msg, ...args) => {
+		if (this.logger) if (typeof objOrMsg === "string") this.logger.trace(objOrMsg);
+		else this.logger.trace(objOrMsg, msg, ...args);
+		let context;
+		let message;
+		if (typeof objOrMsg === "string") {
+			context = {
+				...this.context,
+				level: "trace"
+			};
+			message = objOrMsg;
+		} else {
+			context = {
+				...this.context,
+				...objOrMsg,
+				level: "trace"
+			};
+			message = msg ?? "";
+		}
+		this.telescope.debug(message, context, this.requestId).catch(() => {});
+	};
+	/**
+	* Creates a child logger with additional context.
+	* The child logger inherits all context from the parent.
+	*/
+	child(obj) {
+		return new TelescopeLogger({
+			telescope: this.telescope,
+			logger: this.logger?.child(obj),
+			requestId: this.requestId,
+			context: {
+				...this.context,
+				...obj
+			}
+		});
+	}
+	/**
+	* Create a child logger bound to a specific request ID.
+	* Useful for correlating logs with HTTP requests.
+	*/
+	withRequestId(requestId) {
+		return new TelescopeLogger({
+			telescope: this.telescope,
+			logger: this.logger,
+			requestId,
+			context: this.context
+		});
+	}
+};
+/**
+* Create a logger that sends logs to Telescope.
+* Convenience function for creating a TelescopeLogger.
+*
+* @example
+* ```typescript
+* import { createTelescopeLogger } from '@geekmidas/telescope/logger/console';
+* import { ConsoleLogger } from '@geekmidas/logger/console';
+*
+* const telescope = new Telescope({ storage: new InMemoryStorage() });
+* const baseLogger = new ConsoleLogger({ app: 'myApp' });
+*
+* const logger = createTelescopeLogger(telescope, baseLogger);
+* logger.info({ action: 'startup' }, 'Application started');
+* ```
+*/
+function createTelescopeLogger(telescope, logger, context) {
+	return new TelescopeLogger({
+		telescope,
+		logger,
+		context
+	});
+}
+
+//#endregion
+export { TelescopeLogger, createTelescopeLogger };
+//# sourceMappingURL=console.mjs.map

package/dist/logger/console.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.mjs","names":["options: TelescopeLoggerOptions","level: LogLevel","objOrMsg: T | string","msg?: string","context: Record<string, unknown>","message: string","objOrMsg: object | string","obj: object","requestId: string","telescope: Telescope","logger?: Logger","context?: Record<string, unknown>"],"sources":["../../src/logger/console.ts"],"sourcesContent":["import type { Telescope } from '../Telescope';\n\n/**\n * Logger interface matching @geekmidas/logger\n */\nexport interface Logger {\n  debug: LogFn;\n  info: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  fatal: LogFn;\n  trace: LogFn;\n  child: (obj: object) => Logger;\n}\n\nexport type LogFn = {\n  <T extends object>(obj: T, msg?: string, ...args: any[]): void;\n  (msg: string): void;\n};\n\nexport interface TelescopeLoggerOptions {\n  /**\n   * The Telescope instance to send logs to\n   */\n  telescope: Telescope;\n  /**\n   * Optional underlying logger to also forward logs to.\n   * If not provided, logs will only go to Telescope.\n   */\n  logger?: Logger;\n  /**\n   * Request ID to associate logs with a specific request.\n   */\n  requestId?: string;\n  /**\n   * Initial context data to include in all log messages\n   */\n  context?: Record<string, unknown>;\n}\n\ntype LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * A logger that sends logs to both Telescope and an optional underlying logger.\n * Implements the Logger interface from @geekmidas/logger.\n *\n * @example\n * ```typescript\n * import { Telescope, InMemoryStorage } from '@geekmidas/telescope';\n * import { TelescopeLogger } from '@geekmidas/telescope/logger/console';\n * import { ConsoleLogger } from '@geekmidas/logger/console';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * // With underlying logger (logs to both console and Telescope)\n * const logger = new TelescopeLogger({\n *   telescope,\n *   logger: new ConsoleLogger({ app: 'myApp' }),\n * });\n *\n * // Without underlying logger (logs only to Telescope)\n * const telescopeOnly = new TelescopeLogger({ telescope });\n *\n * // Usage\n * logger.info({ userId: '123' }, 'User logged in');\n * logger.error({ error: 'Something failed' }, 'Operation failed');\n * ```\n */\nexport class TelescopeLogger implements Logger {\n  private telescope: Telescope;\n  private logger?: Logger;\n  private requestId?: string;\n  private context: Record<string, unknown>;\n\n  constructor(options: TelescopeLoggerOptions) {\n    this.telescope = options.telescope;\n    this.logger = options.logger;\n    this.requestId = options.requestId;\n    this.context = options.context ?? {};\n  }\n\n  private createLogFn(level: LogLevel): LogFn {\n    const fn = <T extends object>(\n      objOrMsg: T | string,\n      msg?: string,\n      ...args: any[]\n    ): void => {\n      let context: Record<string, unknown>;\n      let message: string;\n\n      if (typeof objOrMsg === 'string') {\n        context = { ...this.context };\n        message = objOrMsg;\n      } else {\n        context = { ...this.context, ...objOrMsg };\n        message = msg ?? '';\n      }\n\n      // Forward to underlying logger if present\n      if (this.logger) {\n        if (typeof objOrMsg === 'string') {\n          this.logger[level](objOrMsg);\n        } else {\n          this.logger[level](objOrMsg as any, msg, ...args);\n        }\n      }\n\n      // Send to Telescope (fire and forget)\n      this.telescope[level](message, context, this.requestId).catch(() => {});\n    };\n\n    return fn as LogFn;\n  }\n\n  debug: LogFn = this.createLogFn('debug');\n  info: LogFn = this.createLogFn('info');\n  warn: LogFn = this.createLogFn('warn');\n  error: LogFn = this.createLogFn('error');\n\n  // Map fatal and trace to error and debug for Telescope\n  fatal: LogFn = ((\n    objOrMsg: object | string,\n    msg?: string,\n    ...args: any[]\n  ): void => {\n    // Forward to underlying logger if present\n    if (this.logger) {\n      if (typeof objOrMsg === 'string') {\n        this.logger.fatal(objOrMsg);\n      } else {\n        this.logger.fatal(objOrMsg as any, msg, ...args);\n      }\n    }\n\n    // Send to Telescope as error level\n    let context: Record<string, unknown>;\n    let message: string;\n\n    if (typeof objOrMsg === 'string') {\n      context = { ...this.context, level: 'fatal' };\n      message = objOrMsg;\n    } else {\n      context = { ...this.context, ...objOrMsg, level: 'fatal' };\n      message = msg ?? '';\n    }\n\n    this.telescope.error(message, context, this.requestId).catch(() => {});\n  }) as LogFn;\n\n  trace: LogFn = ((\n    objOrMsg: object | string,\n    msg?: string,\n    ...args: any[]\n  ): void => {\n    // Forward to underlying logger if present\n    if (this.logger) {\n      if (typeof objOrMsg === 'string') {\n        this.logger.trace(objOrMsg);\n      } else {\n        this.logger.trace(objOrMsg as any, msg, ...args);\n      }\n    }\n\n    // Send to Telescope as debug level\n    let context: Record<string, unknown>;\n    let message: string;\n\n    if (typeof objOrMsg === 'string') {\n      context = { ...this.context, level: 'trace' };\n      message = objOrMsg;\n    } else {\n      context = { ...this.context, ...objOrMsg, level: 'trace' };\n      message = msg ?? '';\n    }\n\n    this.telescope.debug(message, context, this.requestId).catch(() => {});\n  }) as LogFn;\n\n  /**\n   * Creates a child logger with additional context.\n   * The child logger inherits all context from the parent.\n   */\n  child(obj: object): Logger {\n    return new TelescopeLogger({\n      telescope: this.telescope,\n      logger: this.logger?.child(obj),\n      requestId: this.requestId,\n      context: { ...this.context, ...obj },\n    });\n  }\n\n  /**\n   * Create a child logger bound to a specific request ID.\n   * Useful for correlating logs with HTTP requests.\n   */\n  withRequestId(requestId: string): TelescopeLogger {\n    return new TelescopeLogger({\n      telescope: this.telescope,\n      logger: this.logger,\n      requestId,\n      context: this.context,\n    });\n  }\n}\n\n/**\n * Create a logger that sends logs to Telescope.\n * Convenience function for creating a TelescopeLogger.\n *\n * @example\n * ```typescript\n * import { createTelescopeLogger } from '@geekmidas/telescope/logger/console';\n * import { ConsoleLogger } from '@geekmidas/logger/console';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n * const baseLogger = new ConsoleLogger({ app: 'myApp' });\n *\n * const logger = createTelescopeLogger(telescope, baseLogger);\n * logger.info({ action: 'startup' }, 'Application started');\n * ```\n */\nexport function createTelescopeLogger(\n  telescope: Telescope,\n  logger?: Logger,\n  context?: Record<string, unknown>,\n): TelescopeLogger {\n  return new TelescopeLogger({ telescope, logger, context });\n}\n\nexport type { Telescope };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,IAAa,kBAAb,MAAa,gBAAkC;CAC7C,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAYA,SAAiC;AAC3C,OAAK,YAAY,QAAQ;AACzB,OAAK,SAAS,QAAQ;AACtB,OAAK,YAAY,QAAQ;AACzB,OAAK,UAAU,QAAQ,WAAW,CAAE;CACrC;CAED,AAAQ,YAAYC,OAAwB;EAC1C,MAAM,KAAK,CACTC,UACAC,KACA,GAAG,SACM;GACT,IAAIC;GACJ,IAAIC;AAEJ,cAAW,aAAa,UAAU;AAChC,cAAU,EAAE,GAAG,KAAK,QAAS;AAC7B,cAAU;GACX,OAAM;AACL,cAAU;KAAE,GAAG,KAAK;KAAS,GAAG;IAAU;AAC1C,cAAU,OAAO;GAClB;AAGD,OAAI,KAAK,OACP,YAAW,aAAa,SACtB,MAAK,OAAO,OAAO,SAAS;OAE5B,MAAK,OAAO,OAAO,UAAiB,KAAK,GAAG,KAAK;AAKrD,QAAK,UAAU,OAAO,SAAS,SAAS,KAAK,UAAU,CAAC,MAAM,MAAM,CAAE,EAAC;EACxE;AAED,SAAO;CACR;CAED,QAAe,KAAK,YAAY,QAAQ;CACxC,OAAc,KAAK,YAAY,OAAO;CACtC,OAAc,KAAK,YAAY,OAAO;CACtC,QAAe,KAAK,YAAY,QAAQ;CAGxC,QAAgB,CACdC,UACAH,KACA,GAAG,SACM;AAET,MAAI,KAAK,OACP,YAAW,aAAa,SACtB,MAAK,OAAO,MAAM,SAAS;MAE3B,MAAK,OAAO,MAAM,UAAiB,KAAK,GAAG,KAAK;EAKpD,IAAIC;EACJ,IAAIC;AAEJ,aAAW,aAAa,UAAU;AAChC,aAAU;IAAE,GAAG,KAAK;IAAS,OAAO;GAAS;AAC7C,aAAU;EACX,OAAM;AACL,aAAU;IAAE,GAAG,KAAK;IAAS,GAAG;IAAU,OAAO;GAAS;AAC1D,aAAU,OAAO;EAClB;AAED,OAAK,UAAU,MAAM,SAAS,SAAS,KAAK,UAAU,CAAC,MAAM,MAAM,CAAE,EAAC;CACvE;CAED,QAAgB,CACdC,UACAH,KACA,GAAG,SACM;AAET,MAAI,KAAK,OACP,YAAW,aAAa,SACtB,MAAK,OAAO,MAAM,SAAS;MAE3B,MAAK,OAAO,MAAM,UAAiB,KAAK,GAAG,KAAK;EAKpD,IAAIC;EACJ,IAAIC;AAEJ,aAAW,aAAa,UAAU;AAChC,aAAU;IAAE,GAAG,KAAK;IAAS,OAAO;GAAS;AAC7C,aAAU;EACX,OAAM;AACL,aAAU;IAAE,GAAG,KAAK;IAAS,GAAG;IAAU,OAAO;GAAS;AAC1D,aAAU,OAAO;EAClB;AAED,OAAK,UAAU,MAAM,SAAS,SAAS,KAAK,UAAU,CAAC,MAAM,MAAM,CAAE,EAAC;CACvE;;;;;CAMD,MAAME,KAAqB;AACzB,SAAO,IAAI,gBAAgB;GACzB,WAAW,KAAK;GAChB,QAAQ,KAAK,QAAQ,MAAM,IAAI;GAC/B,WAAW,KAAK;GAChB,SAAS;IAAE,GAAG,KAAK;IAAS,GAAG;GAAK;EACrC;CACF;;;;;CAMD,cAAcC,WAAoC;AAChD,SAAO,IAAI,gBAAgB;GACzB,WAAW,KAAK;GAChB,QAAQ,KAAK;GACb;GACA,SAAS,KAAK;EACf;CACF;AACF;;;;;;;;;;;;;;;;;AAkBD,SAAgB,sBACdC,WACAC,QACAC,SACiB;AACjB,QAAO,IAAI,gBAAgB;EAAE;EAAW;EAAQ;CAAS;AAC1D"}

package/dist/logger/pino.cjs

@@ -0,0 +1,118 @@
+const require_chunk = require('../chunk-CUT6urMc.cjs');
+const pino_abstract_transport = require_chunk.__toESM(require("pino-abstract-transport"));
+
+//#region src/logger/pino.ts
+/**
+* Map Pino numeric levels to Telescope log levels
+*/
+function mapPinoLevel(level) {
+	if (level <= 20) return "debug";
+	if (level <= 30) return "info";
+	if (level <= 40) return "warn";
+	return "error";
+}
+/**
+* Create a Pino transport that sends logs to Telescope.
+*
+* Uses pino-abstract-transport for proper async iteration and backpressure handling.
+* Logs are batched for performance and flushed either when the batch is full
+* or after the flush interval.
+*
+* @example
+* ```typescript
+* import pino from 'pino';
+* import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+* import { createPinoTransport } from '@geekmidas/telescope/logger/pino';
+*
+* const telescope = new Telescope({ storage: new InMemoryStorage() });
+*
+* // Use with pino.multistream to log to both stdout and Telescope
+* const logger = pino(
+*   { level: 'debug' },
+*   pino.multistream([
+*     { stream: process.stdout },
+*     { stream: createPinoTransport({ telescope }) }
+*   ])
+* );
+*
+* logger.info({ userId: '123' }, 'User logged in');
+* ```
+*/
+function createPinoTransport(options) {
+	const { telescope, requestId, batchSize = 100, flushIntervalMs = 1e3 } = options;
+	const batch = [];
+	let flushTimer = null;
+	async function flush() {
+		if (batch.length === 0) return;
+		const toFlush = batch.splice(0, batch.length);
+		try {
+			await telescope.log(toFlush);
+		} catch {}
+	}
+	function scheduleFlush() {
+		if (flushTimer === null) flushTimer = setTimeout(() => {
+			flushTimer = null;
+			flush().catch(() => {});
+		}, flushIntervalMs);
+	}
+	function clearFlushTimer() {
+		if (flushTimer !== null) {
+			clearTimeout(flushTimer);
+			flushTimer = null;
+		}
+	}
+	return (0, pino_abstract_transport.default)(async (source) => {
+		for await (const obj of source) {
+			const data = obj;
+			const { level, msg, time, pid, hostname,...context } = data;
+			const telescopeLevel = mapPinoLevel(level);
+			let reqId;
+			if (typeof requestId === "function") reqId = requestId(data);
+			else if (typeof requestId === "string") reqId = requestId;
+			else if (typeof context.requestId === "string") {
+				reqId = context.requestId;
+				delete context.requestId;
+			}
+			batch.push({
+				level: telescopeLevel,
+				message: msg || "",
+				context,
+				requestId: reqId
+			});
+			if (batch.length >= batchSize) {
+				clearFlushTimer();
+				await flush();
+			} else scheduleFlush();
+		}
+	}, { async close() {
+		clearFlushTimer();
+		await flush();
+	} });
+}
+/**
+* Create a Pino destination that sends logs to Telescope.
+* Alias for createPinoTransport for API compatibility.
+*
+* @example
+* ```typescript
+* import pino from 'pino';
+* import { createPinoDestination } from '@geekmidas/telescope/logger/pino';
+*
+* const telescope = new Telescope({ storage: new InMemoryStorage() });
+*
+* // Use with pino.multistream to log to both stdout and Telescope
+* const logger = pino(
+*   { level: 'debug' },
+*   pino.multistream([
+*     { stream: process.stdout },
+*     { stream: createPinoDestination({ telescope }) }
+*   ])
+* );
+* ```
+*/
+const createPinoDestination = createPinoTransport;
+
+//#endregion
+exports.createPinoDestination = createPinoDestination;
+exports.createPinoTransport = createPinoTransport;
+//# sourceMappingURL=pino.cjs.map

package/dist/logger/pino.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino.cjs","names":["level: number","options: TelescopePinoTransportOptions","batch: LogBatch[]","flushTimer: ReturnType<typeof setTimeout> | null","reqId: string | undefined"],"sources":["../../src/logger/pino.ts"],"sourcesContent":["import build from 'pino-abstract-transport';\nimport type { Telescope } from '../Telescope';\n\n/**\n * Pino log object structure after parsing\n */\nexport interface PinoLogObject {\n  level: number;\n  time: number;\n  pid?: number;\n  hostname?: string;\n  msg?: string;\n  [key: string]: unknown;\n}\n\nexport interface TelescopePinoTransportOptions {\n  /**\n   * The Telescope instance to send logs to\n   */\n  telescope: Telescope;\n  /**\n   * Request ID to associate logs with a specific request.\n   * Can be a static string or a function that extracts the ID from log data.\n   */\n  requestId?: string | ((data: PinoLogObject) => string | undefined);\n  /**\n   * Batch size before flushing to Telescope (default: 100)\n   */\n  batchSize?: number;\n  /**\n   * Flush interval in milliseconds (default: 1000ms)\n   */\n  flushIntervalMs?: number;\n}\n\ntype TelescopeLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\ninterface LogBatch {\n  level: TelescopeLogLevel;\n  message: string;\n  context: Record<string, unknown>;\n  requestId?: string;\n}\n\n/**\n * Map Pino numeric levels to Telescope log levels\n */\nfunction mapPinoLevel(level: number): TelescopeLogLevel {\n  // Pino levels: trace=10, debug=20, info=30, warn=40, error=50, fatal=60\n  if (level <= 20) return 'debug'; // trace, debug\n  if (level <= 30) return 'info';\n  if (level <= 40) return 'warn';\n  return 'error'; // error, fatal\n}\n\n/**\n * Create a Pino transport that sends logs to Telescope.\n *\n * Uses pino-abstract-transport for proper async iteration and backpressure handling.\n * Logs are batched for performance and flushed either when the batch is full\n * or after the flush interval.\n *\n * @example\n * ```typescript\n * import pino from 'pino';\n * import { Telescope, InMemoryStorage } from '@geekmidas/telescope';\n * import { createPinoTransport } from '@geekmidas/telescope/logger/pino';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * // Use with pino.multistream to log to both stdout and Telescope\n * const logger = pino(\n *   { level: 'debug' },\n *   pino.multistream([\n *     { stream: process.stdout },\n *     { stream: createPinoTransport({ telescope }) }\n *   ])\n * );\n *\n * logger.info({ userId: '123' }, 'User logged in');\n * ```\n */\nexport function createPinoTransport(options: TelescopePinoTransportOptions) {\n  const {\n    telescope,\n    requestId,\n    batchSize = 100,\n    flushIntervalMs = 1000,\n  } = options;\n\n  const batch: LogBatch[] = [];\n  let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  async function flush(): Promise<void> {\n    if (batch.length === 0) return;\n\n    const toFlush = batch.splice(0, batch.length);\n\n    // Use batch insert for better performance\n    try {\n      await telescope.log(toFlush);\n    } catch {\n      // Silently ignore errors to not break logging\n    }\n  }\n\n  function scheduleFlush(): void {\n    if (flushTimer === null) {\n      flushTimer = setTimeout(() => {\n        flushTimer = null;\n        flush().catch(() => {\n          // Silently ignore flush errors\n        });\n      }, flushIntervalMs);\n    }\n  }\n\n  function clearFlushTimer(): void {\n    if (flushTimer !== null) {\n      clearTimeout(flushTimer);\n      flushTimer = null;\n    }\n  }\n\n  return build(\n    async (source) => {\n      for await (const obj of source) {\n        const data = obj as PinoLogObject;\n        const { level, msg, time, pid, hostname, ...context } = data;\n\n        const telescopeLevel = mapPinoLevel(level);\n\n        // Extract request ID\n        let reqId: string | undefined;\n        if (typeof requestId === 'function') {\n          reqId = requestId(data);\n        } else if (typeof requestId === 'string') {\n          reqId = requestId;\n        } else if (typeof context.requestId === 'string') {\n          reqId = context.requestId;\n          delete context.requestId;\n        }\n\n        batch.push({\n          level: telescopeLevel,\n          message: msg || '',\n          context,\n          requestId: reqId,\n        });\n\n        if (batch.length >= batchSize) {\n          clearFlushTimer();\n          await flush();\n        } else {\n          scheduleFlush();\n        }\n      }\n    },\n    {\n      async close() {\n        clearFlushTimer();\n        await flush();\n      },\n    },\n  );\n}\n\n/**\n * Create a Pino destination that sends logs to Telescope.\n * Alias for createPinoTransport for API compatibility.\n *\n * @example\n * ```typescript\n * import pino from 'pino';\n * import { createPinoDestination } from '@geekmidas/telescope/logger/pino';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * // Use with pino.multistream to log to both stdout and Telescope\n * const logger = pino(\n *   { level: 'debug' },\n *   pino.multistream([\n *     { stream: process.stdout },\n *     { stream: createPinoDestination({ telescope }) }\n *   ])\n * );\n * ```\n */\nexport const createPinoDestination = createPinoTransport;\n\nexport type { Telescope };\n"],"mappings":";;;;;;;AA+CA,SAAS,aAAaA,OAAkC;AAEtD,KAAI,SAAS,GAAI,QAAO;AACxB,KAAI,SAAS,GAAI,QAAO;AACxB,KAAI,SAAS,GAAI,QAAO;AACxB,QAAO;AACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BD,SAAgB,oBAAoBC,SAAwC;CAC1E,MAAM,EACJ,WACA,WACA,YAAY,KACZ,kBAAkB,KACnB,GAAG;CAEJ,MAAMC,QAAoB,CAAE;CAC5B,IAAIC,aAAmD;CAEvD,eAAe,QAAuB;AACpC,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,UAAU,MAAM,OAAO,GAAG,MAAM,OAAO;AAG7C,MAAI;AACF,SAAM,UAAU,IAAI,QAAQ;EAC7B,QAAO,CAEP;CACF;CAED,SAAS,gBAAsB;AAC7B,MAAI,eAAe,KACjB,cAAa,WAAW,MAAM;AAC5B,gBAAa;AACb,UAAO,CAAC,MAAM,MAAM,CAEnB,EAAC;EACH,GAAE,gBAAgB;CAEtB;CAED,SAAS,kBAAwB;AAC/B,MAAI,eAAe,MAAM;AACvB,gBAAa,WAAW;AACxB,gBAAa;EACd;CACF;AAED,QAAO,qCACL,OAAO,WAAW;AAChB,aAAW,MAAM,OAAO,QAAQ;GAC9B,MAAM,OAAO;GACb,MAAM,EAAE,OAAO,KAAK,MAAM,KAAK,SAAU,GAAG,SAAS,GAAG;GAExD,MAAM,iBAAiB,aAAa,MAAM;GAG1C,IAAIC;AACJ,cAAW,cAAc,WACvB,SAAQ,UAAU,KAAK;mBACP,cAAc,SAC9B,SAAQ;mBACQ,QAAQ,cAAc,UAAU;AAChD,YAAQ,QAAQ;AAChB,WAAO,QAAQ;GAChB;AAED,SAAM,KAAK;IACT,OAAO;IACP,SAAS,OAAO;IAChB;IACA,WAAW;GACZ,EAAC;AAEF,OAAI,MAAM,UAAU,WAAW;AAC7B,qBAAiB;AACjB,UAAM,OAAO;GACd,MACC,gBAAe;EAElB;CACF,GACD,EACE,MAAM,QAAQ;AACZ,mBAAiB;AACjB,QAAM,OAAO;CACd,EACF,EACF;AACF;;;;;;;;;;;;;;;;;;;;;;AAuBD,MAAa,wBAAwB"}

package/dist/logger/pino.d.cts

@@ -0,0 +1,89 @@
+import "../types-BGDhFv4R.cjs";
+import { Telescope } from "../Telescope-C5dyDYYB.cjs";
+import * as stream0 from "stream";
+import build from "pino-abstract-transport";
+
+//#region src/logger/pino.d.ts
+/**
+ * Pino log object structure after parsing
+ */
+interface PinoLogObject {
+  level: number;
+  time: number;
+  pid?: number;
+  hostname?: string;
+  msg?: string;
+  [key: string]: unknown;
+}
+interface TelescopePinoTransportOptions {
+  /**
+   * The Telescope instance to send logs to
+   */
+  telescope: Telescope;
+  /**
+   * Request ID to associate logs with a specific request.
+   * Can be a static string or a function that extracts the ID from log data.
+   */
+  requestId?: string | ((data: PinoLogObject) => string | undefined);
+  /**
+   * Batch size before flushing to Telescope (default: 100)
+   */
+  batchSize?: number;
+  /**
+   * Flush interval in milliseconds (default: 1000ms)
+   */
+  flushIntervalMs?: number;
+}
+/**
+ * Create a Pino transport that sends logs to Telescope.
+ *
+ * Uses pino-abstract-transport for proper async iteration and backpressure handling.
+ * Logs are batched for performance and flushed either when the batch is full
+ * or after the flush interval.
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+ * import { createPinoTransport } from '@geekmidas/telescope/logger/pino';
+ *
+ * const telescope = new Telescope({ storage: new InMemoryStorage() });
+ *
+ * // Use with pino.multistream to log to both stdout and Telescope
+ * const logger = pino(
+ *   { level: 'debug' },
+ *   pino.multistream([
+ *     { stream: process.stdout },
+ *     { stream: createPinoTransport({ telescope }) }
+ *   ])
+ * );
+ *
+ * logger.info({ userId: '123' }, 'User logged in');
+ * ```
+ */
+declare function createPinoTransport(options: TelescopePinoTransportOptions): stream0.Transform & build.OnUnknown;
+/**
+ * Create a Pino destination that sends logs to Telescope.
+ * Alias for createPinoTransport for API compatibility.
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { createPinoDestination } from '@geekmidas/telescope/logger/pino';
+ *
+ * const telescope = new Telescope({ storage: new InMemoryStorage() });
+ *
+ * // Use with pino.multistream to log to both stdout and Telescope
+ * const logger = pino(
+ *   { level: 'debug' },
+ *   pino.multistream([
+ *     { stream: process.stdout },
+ *     { stream: createPinoDestination({ telescope }) }
+ *   ])
+ * );
+ * ```
+ */
+declare const createPinoDestination: typeof createPinoTransport;
+//#endregion
+export { PinoLogObject, Telescope, TelescopePinoTransportOptions, createPinoDestination, createPinoTransport };
+//# sourceMappingURL=pino.d.cts.map

package/dist/logger/pino.d.mts

@@ -0,0 +1,89 @@
+import "../types-CZbzz8kx.mjs";
+import { Telescope } from "../Telescope-DyIWgh9-.mjs";
+import build from "pino-abstract-transport";
+import * as stream0 from "stream";
+
+//#region src/logger/pino.d.ts
+/**
+ * Pino log object structure after parsing
+ */
+interface PinoLogObject {
+  level: number;
+  time: number;
+  pid?: number;
+  hostname?: string;
+  msg?: string;
+  [key: string]: unknown;
+}
+interface TelescopePinoTransportOptions {
+  /**
+   * The Telescope instance to send logs to
+   */
+  telescope: Telescope;
+  /**
+   * Request ID to associate logs with a specific request.
+   * Can be a static string or a function that extracts the ID from log data.
+   */
+  requestId?: string | ((data: PinoLogObject) => string | undefined);
+  /**
+   * Batch size before flushing to Telescope (default: 100)
+   */
+  batchSize?: number;
+  /**
+   * Flush interval in milliseconds (default: 1000ms)
+   */
+  flushIntervalMs?: number;
+}
+/**
+ * Create a Pino transport that sends logs to Telescope.
+ *
+ * Uses pino-abstract-transport for proper async iteration and backpressure handling.
+ * Logs are batched for performance and flushed either when the batch is full
+ * or after the flush interval.
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+ * import { createPinoTransport } from '@geekmidas/telescope/logger/pino';
+ *
+ * const telescope = new Telescope({ storage: new InMemoryStorage() });
+ *
+ * // Use with pino.multistream to log to both stdout and Telescope
+ * const logger = pino(
+ *   { level: 'debug' },
+ *   pino.multistream([
+ *     { stream: process.stdout },
+ *     { stream: createPinoTransport({ telescope }) }
+ *   ])
+ * );
+ *
+ * logger.info({ userId: '123' }, 'User logged in');
+ * ```
+ */
+declare function createPinoTransport(options: TelescopePinoTransportOptions): stream0.Transform & build.OnUnknown;
+/**
+ * Create a Pino destination that sends logs to Telescope.
+ * Alias for createPinoTransport for API compatibility.
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { createPinoDestination } from '@geekmidas/telescope/logger/pino';
+ *
+ * const telescope = new Telescope({ storage: new InMemoryStorage() });
+ *
+ * // Use with pino.multistream to log to both stdout and Telescope
+ * const logger = pino(
+ *   { level: 'debug' },
+ *   pino.multistream([
+ *     { stream: process.stdout },
+ *     { stream: createPinoDestination({ telescope }) }
+ *   ])
+ * );
+ * ```
+ */
+declare const createPinoDestination: typeof createPinoTransport;
+//#endregion
+export { PinoLogObject, Telescope, TelescopePinoTransportOptions, createPinoDestination, createPinoTransport };
+//# sourceMappingURL=pino.d.mts.map

package/dist/logger/pino.mjs

@@ -0,0 +1,116 @@
+import build from "pino-abstract-transport";
+
+//#region src/logger/pino.ts
+/**
+* Map Pino numeric levels to Telescope log levels
+*/
+function mapPinoLevel(level) {
+	if (level <= 20) return "debug";
+	if (level <= 30) return "info";
+	if (level <= 40) return "warn";
+	return "error";
+}
+/**
+* Create a Pino transport that sends logs to Telescope.
+*
+* Uses pino-abstract-transport for proper async iteration and backpressure handling.
+* Logs are batched for performance and flushed either when the batch is full
+* or after the flush interval.
+*
+* @example
+* ```typescript
+* import pino from 'pino';
+* import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+* import { createPinoTransport } from '@geekmidas/telescope/logger/pino';
+*
+* const telescope = new Telescope({ storage: new InMemoryStorage() });
+*
+* // Use with pino.multistream to log to both stdout and Telescope
+* const logger = pino(
+*   { level: 'debug' },
+*   pino.multistream([
+*     { stream: process.stdout },
+*     { stream: createPinoTransport({ telescope }) }
+*   ])
+* );
+*
+* logger.info({ userId: '123' }, 'User logged in');
+* ```
+*/
+function createPinoTransport(options) {
+	const { telescope, requestId, batchSize = 100, flushIntervalMs = 1e3 } = options;
+	const batch = [];
+	let flushTimer = null;
+	async function flush() {
+		if (batch.length === 0) return;
+		const toFlush = batch.splice(0, batch.length);
+		try {
+			await telescope.log(toFlush);
+		} catch {}
+	}
+	function scheduleFlush() {
+		if (flushTimer === null) flushTimer = setTimeout(() => {
+			flushTimer = null;
+			flush().catch(() => {});
+		}, flushIntervalMs);
+	}
+	function clearFlushTimer() {
+		if (flushTimer !== null) {
+			clearTimeout(flushTimer);
+			flushTimer = null;
+		}
+	}
+	return build(async (source) => {
+		for await (const obj of source) {
+			const data = obj;
+			const { level, msg, time, pid, hostname,...context } = data;
+			const telescopeLevel = mapPinoLevel(level);
+			let reqId;
+			if (typeof requestId === "function") reqId = requestId(data);
+			else if (typeof requestId === "string") reqId = requestId;
+			else if (typeof context.requestId === "string") {
+				reqId = context.requestId;
+				delete context.requestId;
+			}
+			batch.push({
+				level: telescopeLevel,
+				message: msg || "",
+				context,
+				requestId: reqId
+			});
+			if (batch.length >= batchSize) {
+				clearFlushTimer();
+				await flush();
+			} else scheduleFlush();
+		}
+	}, { async close() {
+		clearFlushTimer();
+		await flush();
+	} });
+}
+/**
+* Create a Pino destination that sends logs to Telescope.
+* Alias for createPinoTransport for API compatibility.
+*
+* @example
+* ```typescript
+* import pino from 'pino';
+* import { createPinoDestination } from '@geekmidas/telescope/logger/pino';
+*
+* const telescope = new Telescope({ storage: new InMemoryStorage() });
+*
+* // Use with pino.multistream to log to both stdout and Telescope
+* const logger = pino(
+*   { level: 'debug' },
+*   pino.multistream([
+*     { stream: process.stdout },
+*     { stream: createPinoDestination({ telescope }) }
+*   ])
+* );
+* ```
+*/
+const createPinoDestination = createPinoTransport;
+
+//#endregion
+export { createPinoDestination, createPinoTransport };
+//# sourceMappingURL=pino.mjs.map

package/dist/logger/pino.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino.mjs","names":["level: number","options: TelescopePinoTransportOptions","batch: LogBatch[]","flushTimer: ReturnType<typeof setTimeout> | null","reqId: string | undefined"],"sources":["../../src/logger/pino.ts"],"sourcesContent":["import build from 'pino-abstract-transport';\nimport type { Telescope } from '../Telescope';\n\n/**\n * Pino log object structure after parsing\n */\nexport interface PinoLogObject {\n  level: number;\n  time: number;\n  pid?: number;\n  hostname?: string;\n  msg?: string;\n  [key: string]: unknown;\n}\n\nexport interface TelescopePinoTransportOptions {\n  /**\n   * The Telescope instance to send logs to\n   */\n  telescope: Telescope;\n  /**\n   * Request ID to associate logs with a specific request.\n   * Can be a static string or a function that extracts the ID from log data.\n   */\n  requestId?: string | ((data: PinoLogObject) => string | undefined);\n  /**\n   * Batch size before flushing to Telescope (default: 100)\n   */\n  batchSize?: number;\n  /**\n   * Flush interval in milliseconds (default: 1000ms)\n   */\n  flushIntervalMs?: number;\n}\n\ntype TelescopeLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\ninterface LogBatch {\n  level: TelescopeLogLevel;\n  message: string;\n  context: Record<string, unknown>;\n  requestId?: string;\n}\n\n/**\n * Map Pino numeric levels to Telescope log levels\n */\nfunction mapPinoLevel(level: number): TelescopeLogLevel {\n  // Pino levels: trace=10, debug=20, info=30, warn=40, error=50, fatal=60\n  if (level <= 20) return 'debug'; // trace, debug\n  if (level <= 30) return 'info';\n  if (level <= 40) return 'warn';\n  return 'error'; // error, fatal\n}\n\n/**\n * Create a Pino transport that sends logs to Telescope.\n *\n * Uses pino-abstract-transport for proper async iteration and backpressure handling.\n * Logs are batched for performance and flushed either when the batch is full\n * or after the flush interval.\n *\n * @example\n * ```typescript\n * import pino from 'pino';\n * import { Telescope, InMemoryStorage } from '@geekmidas/telescope';\n * import { createPinoTransport } from '@geekmidas/telescope/logger/pino';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * // Use with pino.multistream to log to both stdout and Telescope\n * const logger = pino(\n *   { level: 'debug' },\n *   pino.multistream([\n *     { stream: process.stdout },\n *     { stream: createPinoTransport({ telescope }) }\n *   ])\n * );\n *\n * logger.info({ userId: '123' }, 'User logged in');\n * ```\n */\nexport function createPinoTransport(options: TelescopePinoTransportOptions) {\n  const {\n    telescope,\n    requestId,\n    batchSize = 100,\n    flushIntervalMs = 1000,\n  } = options;\n\n  const batch: LogBatch[] = [];\n  let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  async function flush(): Promise<void> {\n    if (batch.length === 0) return;\n\n    const toFlush = batch.splice(0, batch.length);\n\n    // Use batch insert for better performance\n    try {\n      await telescope.log(toFlush);\n    } catch {\n      // Silently ignore errors to not break logging\n    }\n  }\n\n  function scheduleFlush(): void {\n    if (flushTimer === null) {\n      flushTimer = setTimeout(() => {\n        flushTimer = null;\n        flush().catch(() => {\n          // Silently ignore flush errors\n        });\n      }, flushIntervalMs);\n    }\n  }\n\n  function clearFlushTimer(): void {\n    if (flushTimer !== null) {\n      clearTimeout(flushTimer);\n      flushTimer = null;\n    }\n  }\n\n  return build(\n    async (source) => {\n      for await (const obj of source) {\n        const data = obj as PinoLogObject;\n        const { level, msg, time, pid, hostname, ...context } = data;\n\n        const telescopeLevel = mapPinoLevel(level);\n\n        // Extract request ID\n        let reqId: string | undefined;\n        if (typeof requestId === 'function') {\n          reqId = requestId(data);\n        } else if (typeof requestId === 'string') {\n          reqId = requestId;\n        } else if (typeof context.requestId === 'string') {\n          reqId = context.requestId;\n          delete context.requestId;\n        }\n\n        batch.push({\n          level: telescopeLevel,\n          message: msg || '',\n          context,\n          requestId: reqId,\n        });\n\n        if (batch.length >= batchSize) {\n          clearFlushTimer();\n          await flush();\n        } else {\n          scheduleFlush();\n        }\n      }\n    },\n    {\n      async close() {\n        clearFlushTimer();\n        await flush();\n      },\n    },\n  );\n}\n\n/**\n * Create a Pino destination that sends logs to Telescope.\n * Alias for createPinoTransport for API compatibility.\n *\n * @example\n * ```typescript\n * import pino from 'pino';\n * import { createPinoDestination } from '@geekmidas/telescope/logger/pino';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * // Use with pino.multistream to log to both stdout and Telescope\n * const logger = pino(\n *   { level: 'debug' },\n *   pino.multistream([\n *     { stream: process.stdout },\n *     { stream: createPinoDestination({ telescope }) }\n *   ])\n * );\n * ```\n */\nexport const createPinoDestination = createPinoTransport;\n\nexport type { Telescope };\n"],"mappings":";;;;;;AA+CA,SAAS,aAAaA,OAAkC;AAEtD,KAAI,SAAS,GAAI,QAAO;AACxB,KAAI,SAAS,GAAI,QAAO;AACxB,KAAI,SAAS,GAAI,QAAO;AACxB,QAAO;AACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BD,SAAgB,oBAAoBC,SAAwC;CAC1E,MAAM,EACJ,WACA,WACA,YAAY,KACZ,kBAAkB,KACnB,GAAG;CAEJ,MAAMC,QAAoB,CAAE;CAC5B,IAAIC,aAAmD;CAEvD,eAAe,QAAuB;AACpC,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,UAAU,MAAM,OAAO,GAAG,MAAM,OAAO;AAG7C,MAAI;AACF,SAAM,UAAU,IAAI,QAAQ;EAC7B,QAAO,CAEP;CACF;CAED,SAAS,gBAAsB;AAC7B,MAAI,eAAe,KACjB,cAAa,WAAW,MAAM;AAC5B,gBAAa;AACb,UAAO,CAAC,MAAM,MAAM,CAEnB,EAAC;EACH,GAAE,gBAAgB;CAEtB;CAED,SAAS,kBAAwB;AAC/B,MAAI,eAAe,MAAM;AACvB,gBAAa,WAAW;AACxB,gBAAa;EACd;CACF;AAED,QAAO,MACL,OAAO,WAAW;AAChB,aAAW,MAAM,OAAO,QAAQ;GAC9B,MAAM,OAAO;GACb,MAAM,EAAE,OAAO,KAAK,MAAM,KAAK,SAAU,GAAG,SAAS,GAAG;GAExD,MAAM,iBAAiB,aAAa,MAAM;GAG1C,IAAIC;AACJ,cAAW,cAAc,WACvB,SAAQ,UAAU,KAAK;mBACP,cAAc,SAC9B,SAAQ;mBACQ,QAAQ,cAAc,UAAU;AAChD,YAAQ,QAAQ;AAChB,WAAO,QAAQ;GAChB;AAED,SAAM,KAAK;IACT,OAAO;IACP,SAAS,OAAO;IAChB;IACA,WAAW;GACZ,EAAC;AAEF,OAAI,MAAM,UAAU,WAAW;AAC7B,qBAAiB;AACjB,UAAM,OAAO;GACd,MACC,gBAAe;EAElB;CACF,GACD,EACE,MAAM,QAAQ;AACZ,mBAAiB;AACjB,QAAM,OAAO;CACd,EACF,EACF;AACF;;;;;;;;;;;;;;;;;;;;;;AAuBD,MAAa,wBAAwB"}