@geekmidas/telescope 0.0.1

package/dist/Telescope-DyIWgh9-.d.mts

@@ -0,0 +1,133 @@
+import { ExceptionEntry, LogEntry, QueryOptions, RequestEntry, TelescopeEvent, TelescopeOptions, TelescopeStats } from "./types-CZbzz8kx.mjs";
+
+//#region src/Telescope.d.ts
+
+/**
+ * Framework-agnostic Telescope class for debugging and monitoring applications.
+ * Use framework-specific adapters (e.g., @geekmidas/telescope/hono) for integration.
+ */
+declare class Telescope {
+  private storage;
+  private options;
+  private wsClients;
+  private pruneInterval?;
+  constructor(options: TelescopeOptions);
+  /**
+   * Record a request entry
+   */
+  recordRequest(entry: Omit<RequestEntry, 'id' | 'timestamp'>): Promise<string>;
+  /**
+   * Log entry input for batch operations
+   */
+  private saveLogEntries;
+  /**
+   * Record log entries in batch.
+   * More efficient than individual calls for database storage.
+   *
+   * @example
+   * await telescope.log([
+   *   { level: 'info', message: 'Request started' },
+   *   { level: 'debug', message: 'Processing...', context: { step: 1 } },
+   * ]);
+   */
+  log(entries: Array<{
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    context?: Record<string, unknown>;
+    requestId?: string;
+  }>): Promise<void>;
+  /**
+   * Log a debug message
+   */
+  debug(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log an info message
+   */
+  info(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log a warning message
+   */
+  warn(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Log an error message
+   */
+  error(message: string, context?: Record<string, unknown>, requestId?: string): Promise<void>;
+  /**
+   * Record an exception
+   */
+  exception(error: Error, requestId?: string): Promise<void>;
+  /**
+   * Get requests from storage
+   */
+  getRequests(options?: QueryOptions): Promise<RequestEntry[]>;
+  /**
+   * Get a single request by ID
+   */
+  getRequest(id: string): Promise<RequestEntry | null>;
+  /**
+   * Get exceptions from storage
+   */
+  getExceptions(options?: QueryOptions): Promise<ExceptionEntry[]>;
+  /**
+   * Get a single exception by ID
+   */
+  getException(id: string): Promise<ExceptionEntry | null>;
+  /**
+   * Get logs from storage
+   */
+  getLogs(options?: QueryOptions): Promise<LogEntry[]>;
+  /**
+   * Get storage statistics
+   */
+  getStats(): Promise<TelescopeStats>;
+  /**
+   * Add a WebSocket client for real-time updates
+   */
+  addWsClient(ws: WebSocket): void;
+  /**
+   * Remove a WebSocket client
+   */
+  removeWsClient(ws: WebSocket): void;
+  /**
+   * Broadcast an event to all connected WebSocket clients
+   */
+  broadcast(event: TelescopeEvent): void;
+  /**
+   * Manually prune old entries
+   */
+  prune(olderThan: Date): Promise<number>;
+  /**
+   * Clean up resources
+   */
+  destroy(): void;
+  /**
+   * Get the telescope path
+   */
+  get path(): string;
+  /**
+   * Check if telescope is enabled
+   */
+  get enabled(): boolean;
+  /**
+   * Check if body recording is enabled
+   */
+  get recordBody(): boolean;
+  /**
+   * Get max body size
+   */
+  get maxBodySize(): number;
+  /**
+   * Check if a path should be ignored
+   */
+  shouldIgnore(path: string): boolean;
+  /**
+   * Get the dashboard HTML
+   */
+  getDashboardHtml(): string;
+  private normalizeOptions;
+  private parseStack;
+  private autoPrune;
+}
+//#endregion
+export { Telescope };
+//# sourceMappingURL=Telescope-DyIWgh9-.d.mts.map

package/dist/Telescope.cjs

@@ -0,0 +1,3 @@
+const require_Telescope = require('./Telescope-B3Wd82yk.cjs');
+
+exports.Telescope = require_Telescope.Telescope;

package/dist/Telescope.d.cts

@@ -0,0 +1,3 @@
+import "./types-BGDhFv4R.cjs";
+import { Telescope } from "./Telescope-C5dyDYYB.cjs";
+export { Telescope };

package/dist/Telescope.d.mts

@@ -0,0 +1,3 @@
+import "./types-CZbzz8kx.mjs";
+import { Telescope } from "./Telescope-DyIWgh9-.mjs";
+export { Telescope };

package/dist/Telescope.mjs

@@ -0,0 +1,3 @@
+import { Telescope } from "./Telescope-D-uoZB6b.mjs";
+
+export { Telescope };

package/dist/chunk-CUT6urMc.cjs

@@ -0,0 +1,30 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/index.cjs

@@ -0,0 +1,5 @@
+const require_Telescope = require('./Telescope-B3Wd82yk.cjs');
+const require_memory = require('./memory-9-B9WACq.cjs');
+
+exports.InMemoryStorage = require_memory.InMemoryStorage;
+exports.Telescope = require_Telescope.Telescope;

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+import { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage } from "./types-BGDhFv4R.cjs";
+import { Telescope } from "./Telescope-C5dyDYYB.cjs";
+import { InMemoryStorage, InMemoryStorageOptions } from "./memory-DiP1a-pp.cjs";
+export { ExceptionEntry, InMemoryStorage, InMemoryStorageOptions, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, Telescope, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage };

package/dist/index.d.mts

@@ -0,0 +1,4 @@
+import { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage } from "./types-CZbzz8kx.mjs";
+import { Telescope } from "./Telescope-DyIWgh9-.mjs";
+import { InMemoryStorage, InMemoryStorageOptions } from "./memory-Cm0eevCS.mjs";
+export { ExceptionEntry, InMemoryStorage, InMemoryStorageOptions, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, Telescope, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage };

package/dist/index.mjs

@@ -0,0 +1,4 @@
+import { Telescope } from "./Telescope-D-uoZB6b.mjs";
+import { InMemoryStorage } from "./memory-SdN5vtG9.mjs";
+
+export { InMemoryStorage, Telescope };

package/dist/logger/console.cjs

@@ -0,0 +1,161 @@
+
+//#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
+exports.TelescopeLogger = TelescopeLogger;
+exports.createTelescopeLogger = createTelescopeLogger;
+//# sourceMappingURL=console.cjs.map

package/dist/logger/console.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.cjs","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/console.d.cts

@@ -0,0 +1,109 @@
+import "../types-BGDhFv4R.cjs";
+import { Telescope } from "../Telescope-C5dyDYYB.cjs";
+
+//#region src/logger/console.d.ts
+/**
+ * Logger interface matching @geekmidas/logger
+ */
+interface Logger {
+  debug: LogFn;
+  info: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  fatal: LogFn;
+  trace: LogFn;
+  child: (obj: object) => Logger;
+}
+type LogFn = {
+  <T extends object>(obj: T, msg?: string, ...args: any[]): void;
+  (msg: string): void;
+};
+interface TelescopeLoggerOptions {
+  /**
+   * The Telescope instance to send logs to
+   */
+  telescope: Telescope;
+  /**
+   * Optional underlying logger to also forward logs to.
+   * If not provided, logs will only go to Telescope.
+   */
+  logger?: Logger;
+  /**
+   * Request ID to associate logs with a specific request.
+   */
+  requestId?: string;
+  /**
+   * Initial context data to include in all log messages
+   */
+  context?: Record<string, unknown>;
+}
+/**
+ * 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');
+ * ```
+ */
+declare class TelescopeLogger implements Logger {
+  private telescope;
+  private logger?;
+  private requestId?;
+  private context;
+  constructor(options: TelescopeLoggerOptions);
+  private createLogFn;
+  debug: LogFn;
+  info: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  fatal: LogFn;
+  trace: LogFn;
+  /**
+   * Creates a child logger with additional context.
+   * The child logger inherits all context from the parent.
+   */
+  child(obj: object): Logger;
+  /**
+   * Create a child logger bound to a specific request ID.
+   * Useful for correlating logs with HTTP requests.
+   */
+  withRequestId(requestId: string): TelescopeLogger;
+}
+/**
+ * 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');
+ * ```
+ */
+declare function createTelescopeLogger(telescope: Telescope, logger?: Logger, context?: Record<string, unknown>): TelescopeLogger;
+//#endregion
+export { LogFn, Logger, Telescope, TelescopeLogger, TelescopeLoggerOptions, createTelescopeLogger };
+//# sourceMappingURL=console.d.cts.map

package/dist/logger/console.d.mts

@@ -0,0 +1,109 @@
+import "../types-CZbzz8kx.mjs";
+import { Telescope } from "../Telescope-DyIWgh9-.mjs";
+
+//#region src/logger/console.d.ts
+/**
+ * Logger interface matching @geekmidas/logger
+ */
+interface Logger {
+  debug: LogFn;
+  info: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  fatal: LogFn;
+  trace: LogFn;
+  child: (obj: object) => Logger;
+}
+type LogFn = {
+  <T extends object>(obj: T, msg?: string, ...args: any[]): void;
+  (msg: string): void;
+};
+interface TelescopeLoggerOptions {
+  /**
+   * The Telescope instance to send logs to
+   */
+  telescope: Telescope;
+  /**
+   * Optional underlying logger to also forward logs to.
+   * If not provided, logs will only go to Telescope.
+   */
+  logger?: Logger;
+  /**
+   * Request ID to associate logs with a specific request.
+   */
+  requestId?: string;
+  /**
+   * Initial context data to include in all log messages
+   */
+  context?: Record<string, unknown>;
+}
+/**
+ * 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');
+ * ```
+ */
+declare class TelescopeLogger implements Logger {
+  private telescope;
+  private logger?;
+  private requestId?;
+  private context;
+  constructor(options: TelescopeLoggerOptions);
+  private createLogFn;
+  debug: LogFn;
+  info: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  fatal: LogFn;
+  trace: LogFn;
+  /**
+   * Creates a child logger with additional context.
+   * The child logger inherits all context from the parent.
+   */
+  child(obj: object): Logger;
+  /**
+   * Create a child logger bound to a specific request ID.
+   * Useful for correlating logs with HTTP requests.
+   */
+  withRequestId(requestId: string): TelescopeLogger;
+}
+/**
+ * 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');
+ * ```
+ */
+declare function createTelescopeLogger(telescope: Telescope, logger?: Logger, context?: Record<string, unknown>): TelescopeLogger;
+//#endregion
+export { LogFn, Logger, Telescope, TelescopeLogger, TelescopeLoggerOptions, createTelescopeLogger };
+//# sourceMappingURL=console.d.mts.map