@geekmidas/telescope 0.0.1

package/dist/storage/kysely.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely.mjs","names":["config: KyselyStorageConfig<DB>","entry: RequestEntry","entries: RequestEntry[]","options?: QueryOptions","row: TelescopeRequestTable","id: string","entry: ExceptionEntry","entries: ExceptionEntry[]","row: TelescopeExceptionTable","entry: LogEntry","entries: LogEntry[]","row: TelescopeLogTable","olderThan: Date","eb: any","query: any","value: unknown"],"sources":["../../src/storage/kysely.ts"],"sourcesContent":["import type { Kysely } from 'kysely';\nimport type {\n  ExceptionEntry,\n  LogEntry,\n  QueryOptions,\n  RequestEntry,\n  TelescopeStats,\n  TelescopeStorage,\n} from '../types';\n\n/**\n * Database table interface for telescope requests.\n * Use this to define your telescope_requests table in your Kysely database schema.\n */\nexport interface TelescopeRequestTable {\n  id: string;\n  method: string;\n  path: string;\n  url: string;\n  headers: unknown;\n  body: unknown | null;\n  query: unknown | null;\n  status: number;\n  response_headers: unknown;\n  response_body: unknown | null;\n  duration: number;\n  timestamp: Date;\n  ip: string | null;\n  user_id: string | null;\n  tags: unknown | null;\n}\n\n/**\n * Database table interface for telescope exceptions.\n */\nexport interface TelescopeExceptionTable {\n  id: string;\n  name: string;\n  message: string;\n  stack: unknown;\n  source: unknown | null;\n  request_id: string | null;\n  timestamp: Date;\n  handled: boolean;\n  tags: unknown | null;\n}\n\n/**\n * Database table interface for telescope logs.\n */\nexport interface TelescopeLogTable {\n  id: string;\n  level: string;\n  message: string;\n  context: unknown | null;\n  request_id: string | null;\n  timestamp: Date;\n}\n\n/**\n * Combined database interface for all telescope tables.\n * Use this to extend your database schema.\n *\n * @example\n * ```typescript\n * import type { TelescopeTables } from '@geekmidas/telescope/storage/kysely';\n *\n * interface Database extends TelescopeTables {\n *   users: UserTable;\n *   // ... other tables\n * }\n * ```\n */\nexport interface TelescopeTables {\n  telescope_requests: TelescopeRequestTable;\n  telescope_exceptions: TelescopeExceptionTable;\n  telescope_logs: TelescopeLogTable;\n}\n\n/**\n * Configuration for KyselyStorage.\n */\nexport interface KyselyStorageConfig<DB> {\n  /** Kysely database instance */\n  db: Kysely<DB>;\n  /**\n   * Table name prefix (default: 'telescope').\n   * Tables will be named: {prefix}_requests, {prefix}_exceptions, {prefix}_logs\n   */\n  tablePrefix?: string;\n}\n\n/**\n * Kysely-based storage implementation for Telescope.\n * Stores telescope data in PostgreSQL, MySQL, or SQLite using Kysely.\n *\n * @template DB - Your Kysely database schema (must include TelescopeTables)\n *\n * @example\n * ```typescript\n * import { Kysely, PostgresDialect } from 'kysely';\n * import { KyselyStorage, type TelescopeTables } from '@geekmidas/telescope/storage/kysely';\n *\n * interface Database extends TelescopeTables {\n *   users: UserTable;\n * }\n *\n * const db = new Kysely<Database>({ dialect: new PostgresDialect({ pool }) });\n * const storage = new KyselyStorage({ db });\n *\n * const telescope = new Telescope({ storage });\n * ```\n */\nexport class KyselyStorage<DB> implements TelescopeStorage {\n  private readonly db: Kysely<DB>;\n  private readonly requestsTable: string;\n  private readonly exceptionsTable: string;\n  private readonly logsTable: string;\n\n  constructor(config: KyselyStorageConfig<DB>) {\n    this.db = config.db;\n    const prefix = config.tablePrefix ?? 'telescope';\n    this.requestsTable = `${prefix}_requests`;\n    this.exceptionsTable = `${prefix}_exceptions`;\n    this.logsTable = `${prefix}_logs`;\n  }\n\n  // ============================================\n  // Requests\n  // ============================================\n\n  async saveRequest(entry: RequestEntry): Promise<void> {\n    const row = this.requestToRow(entry);\n    await (this.db as any)\n      .insertInto(this.requestsTable)\n      .values(row)\n      .execute();\n  }\n\n  async saveRequests(entries: RequestEntry[]): Promise<void> {\n    if (entries.length === 0) return;\n\n    const rows = entries.map((e) => this.requestToRow(e));\n    await (this.db as any)\n      .insertInto(this.requestsTable)\n      .values(rows)\n      .execute();\n  }\n\n  async getRequests(options?: QueryOptions): Promise<RequestEntry[]> {\n    let query = (this.db as any)\n      .selectFrom(this.requestsTable)\n      .selectAll()\n      .orderBy('timestamp', 'desc');\n\n    query = this.applyQueryOptions(query, options);\n\n    const rows = await query.execute();\n    return rows.map((row: TelescopeRequestTable) => this.rowToRequest(row));\n  }\n\n  async getRequest(id: string): Promise<RequestEntry | null> {\n    const row = await (this.db as any)\n      .selectFrom(this.requestsTable)\n      .selectAll()\n      .where('id', '=', id)\n      .executeTakeFirst();\n\n    return row ? this.rowToRequest(row) : null;\n  }\n\n  // ============================================\n  // Exceptions\n  // ============================================\n\n  async saveException(entry: ExceptionEntry): Promise<void> {\n    const row = this.exceptionToRow(entry);\n    await (this.db as any)\n      .insertInto(this.exceptionsTable)\n      .values(row)\n      .execute();\n  }\n\n  async saveExceptions(entries: ExceptionEntry[]): Promise<void> {\n    if (entries.length === 0) return;\n\n    const rows = entries.map((e) => this.exceptionToRow(e));\n    await (this.db as any)\n      .insertInto(this.exceptionsTable)\n      .values(rows)\n      .execute();\n  }\n\n  async getExceptions(options?: QueryOptions): Promise<ExceptionEntry[]> {\n    let query = (this.db as any)\n      .selectFrom(this.exceptionsTable)\n      .selectAll()\n      .orderBy('timestamp', 'desc');\n\n    query = this.applyQueryOptions(query, options);\n\n    const rows = await query.execute();\n    return rows.map((row: TelescopeExceptionTable) => this.rowToException(row));\n  }\n\n  async getException(id: string): Promise<ExceptionEntry | null> {\n    const row = await (this.db as any)\n      .selectFrom(this.exceptionsTable)\n      .selectAll()\n      .where('id', '=', id)\n      .executeTakeFirst();\n\n    return row ? this.rowToException(row) : null;\n  }\n\n  // ============================================\n  // Logs\n  // ============================================\n\n  async saveLog(entry: LogEntry): Promise<void> {\n    const row = this.logToRow(entry);\n    await (this.db as any).insertInto(this.logsTable).values(row).execute();\n  }\n\n  async saveLogs(entries: LogEntry[]): Promise<void> {\n    if (entries.length === 0) return;\n\n    const rows = entries.map((e) => this.logToRow(e));\n    await (this.db as any).insertInto(this.logsTable).values(rows).execute();\n  }\n\n  async getLogs(options?: QueryOptions): Promise<LogEntry[]> {\n    let query = (this.db as any)\n      .selectFrom(this.logsTable)\n      .selectAll()\n      .orderBy('timestamp', 'desc');\n\n    query = this.applyQueryOptions(query, options);\n\n    const rows = await query.execute();\n    return rows.map((row: TelescopeLogTable) => this.rowToLog(row));\n  }\n\n  // ============================================\n  // Cleanup\n  // ============================================\n\n  async prune(olderThan: Date): Promise<number> {\n    const results = await Promise.all([\n      (this.db as any)\n        .deleteFrom(this.requestsTable)\n        .where('timestamp', '<', olderThan)\n        .executeTakeFirst(),\n      (this.db as any)\n        .deleteFrom(this.exceptionsTable)\n        .where('timestamp', '<', olderThan)\n        .executeTakeFirst(),\n      (this.db as any)\n        .deleteFrom(this.logsTable)\n        .where('timestamp', '<', olderThan)\n        .executeTakeFirst(),\n    ]);\n\n    return results.reduce(\n      (sum, result) => sum + Number(result.numDeletedRows ?? 0),\n      0,\n    );\n  }\n\n  // ============================================\n  // Stats\n  // ============================================\n\n  async getStats(): Promise<TelescopeStats> {\n    const [requestsResult, exceptionsResult, logsResult] = await Promise.all([\n      (this.db as any)\n        .selectFrom(this.requestsTable)\n        .select((eb: any) => [\n          eb.fn.count('id').as('count'),\n          eb.fn.min('timestamp').as('oldest'),\n          eb.fn.max('timestamp').as('newest'),\n        ])\n        .executeTakeFirst(),\n      (this.db as any)\n        .selectFrom(this.exceptionsTable)\n        .select((eb: any) => [\n          eb.fn.count('id').as('count'),\n          eb.fn.min('timestamp').as('oldest'),\n          eb.fn.max('timestamp').as('newest'),\n        ])\n        .executeTakeFirst(),\n      (this.db as any)\n        .selectFrom(this.logsTable)\n        .select((eb: any) => [\n          eb.fn.count('id').as('count'),\n          eb.fn.min('timestamp').as('oldest'),\n          eb.fn.max('timestamp').as('newest'),\n        ])\n        .executeTakeFirst(),\n    ]);\n\n    const allDates = [\n      requestsResult?.oldest,\n      requestsResult?.newest,\n      exceptionsResult?.oldest,\n      exceptionsResult?.newest,\n      logsResult?.oldest,\n      logsResult?.newest,\n    ]\n      .filter((d): d is Date => d != null)\n      .sort((a, b) => new Date(a).getTime() - new Date(b).getTime());\n\n    return {\n      requests: Number(requestsResult?.count ?? 0),\n      exceptions: Number(exceptionsResult?.count ?? 0),\n      logs: Number(logsResult?.count ?? 0),\n      oldestEntry: allDates[0] ? new Date(allDates[0]) : undefined,\n      newestEntry: allDates.length > 0\n        ? new Date(allDates[allDates.length - 1])\n        : undefined,\n    };\n  }\n\n  // ============================================\n  // Private Helpers\n  // ============================================\n\n  private applyQueryOptions(query: any, options?: QueryOptions): any {\n    if (!options) {\n      return query.limit(50);\n    }\n\n    if (options.after) {\n      query = query.where('timestamp', '>=', options.after);\n    }\n\n    if (options.before) {\n      query = query.where('timestamp', '<=', options.before);\n    }\n\n    if (options.search) {\n      // Search in relevant text fields - using ILIKE for case-insensitive\n      // This is a simple implementation; for production you'd want full-text search\n      query = query.where((eb: any) =>\n        eb.or([\n          eb('message', 'ilike', `%${options.search}%`),\n          eb('path', 'ilike', `%${options.search}%`),\n          eb('url', 'ilike', `%${options.search}%`),\n        ]),\n      );\n    }\n\n    // Tags filter would require array contains operation\n    // which is database-specific (PostgreSQL: @>, etc.)\n\n    const limit = options.limit ?? 50;\n    const offset = options.offset ?? 0;\n\n    return query.limit(limit).offset(offset);\n  }\n\n  private requestToRow(entry: RequestEntry): TelescopeRequestTable {\n    return {\n      id: entry.id,\n      method: entry.method,\n      path: entry.path,\n      url: entry.url,\n      headers: entry.headers,\n      body: entry.body ?? null,\n      query: entry.query ?? null,\n      status: entry.status,\n      response_headers: entry.responseHeaders,\n      response_body: entry.responseBody ?? null,\n      duration: entry.duration,\n      timestamp: entry.timestamp,\n      ip: entry.ip ?? null,\n      user_id: entry.userId ?? null,\n      tags: entry.tags ?? null,\n    };\n  }\n\n  private rowToRequest(row: TelescopeRequestTable): RequestEntry {\n    return {\n      id: row.id,\n      method: row.method,\n      path: row.path,\n      url: row.url,\n      headers: this.parseJson(row.headers) as Record<string, string>,\n      body: row.body ? this.parseJson(row.body) : undefined,\n      query: row.query\n        ? (this.parseJson(row.query) as Record<string, string>)\n        : undefined,\n      status: row.status,\n      responseHeaders: this.parseJson(row.response_headers) as Record<\n        string,\n        string\n      >,\n      responseBody: row.response_body\n        ? this.parseJson(row.response_body)\n        : undefined,\n      duration: row.duration,\n      timestamp: new Date(row.timestamp),\n      ip: row.ip ?? undefined,\n      userId: row.user_id ?? undefined,\n      tags: row.tags ? (this.parseJson(row.tags) as string[]) : undefined,\n    };\n  }\n\n  private exceptionToRow(entry: ExceptionEntry): TelescopeExceptionTable {\n    return {\n      id: entry.id,\n      name: entry.name,\n      message: entry.message,\n      stack: entry.stack,\n      source: entry.source ?? null,\n      request_id: entry.requestId ?? null,\n      timestamp: entry.timestamp,\n      handled: entry.handled,\n      tags: entry.tags ?? null,\n    };\n  }\n\n  private rowToException(row: TelescopeExceptionTable): ExceptionEntry {\n    return {\n      id: row.id,\n      name: row.name,\n      message: row.message,\n      stack: this.parseJson(row.stack) as ExceptionEntry['stack'],\n      source: row.source\n        ? (this.parseJson(row.source) as ExceptionEntry['source'])\n        : undefined,\n      requestId: row.request_id ?? undefined,\n      timestamp: new Date(row.timestamp),\n      handled: row.handled,\n      tags: row.tags ? (this.parseJson(row.tags) as string[]) : undefined,\n    };\n  }\n\n  private logToRow(entry: LogEntry): TelescopeLogTable {\n    return {\n      id: entry.id,\n      level: entry.level,\n      message: entry.message,\n      context: entry.context ?? null,\n      request_id: entry.requestId ?? null,\n      timestamp: entry.timestamp,\n    };\n  }\n\n  private rowToLog(row: TelescopeLogTable): LogEntry {\n    return {\n      id: row.id,\n      level: row.level as LogEntry['level'],\n      message: row.message,\n      context: row.context\n        ? (this.parseJson(row.context) as Record<string, unknown>)\n        : undefined,\n      requestId: row.request_id ?? undefined,\n      timestamp: new Date(row.timestamp),\n    };\n  }\n\n  /**\n   * Parse a JSON value that may already be parsed (e.g., from jsonb columns).\n   */\n  private parseJson(value: unknown): unknown {\n    if (typeof value === 'object' && value !== null) {\n      return value;\n    }\n    if (typeof value === 'string') {\n      try {\n        return JSON.parse(value);\n      } catch {\n        return value;\n      }\n    }\n    return value;\n  }\n}\n\n/**\n * SQL migration to create telescope tables.\n * Use this to set up the required tables in your database.\n *\n * @example\n * ```typescript\n * import { getTelescopeMigration } from '@geekmidas/telescope/storage/kysely';\n *\n * // In your migration file\n * export async function up(db: Kysely<any>): Promise<void> {\n *   const migration = getTelescopeMigration();\n *   await db.schema.executeRaw(migration.up).execute();\n * }\n *\n * export async function down(db: Kysely<any>): Promise<void> {\n *   const migration = getTelescopeMigration();\n *   await db.schema.executeRaw(migration.down).execute();\n * }\n * ```\n */\nexport function getTelescopeMigration(tablePrefix = 'telescope'): {\n  up: string;\n  down: string;\n} {\n  return {\n    up: `\n-- Telescope requests table\nCREATE TABLE IF NOT EXISTS ${tablePrefix}_requests (\n  id VARCHAR(21) PRIMARY KEY,\n  method VARCHAR(10) NOT NULL,\n  path TEXT NOT NULL,\n  url TEXT NOT NULL,\n  headers JSONB NOT NULL,\n  body JSONB,\n  query JSONB,\n  status INTEGER NOT NULL,\n  response_headers JSONB NOT NULL,\n  response_body JSONB,\n  duration DOUBLE PRECISION NOT NULL,\n  timestamp TIMESTAMPTZ NOT NULL,\n  ip VARCHAR(45),\n  user_id VARCHAR(255),\n  tags JSONB\n);\n\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_requests_timestamp\n  ON ${tablePrefix}_requests (timestamp DESC);\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_requests_path\n  ON ${tablePrefix}_requests (path);\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_requests_status\n  ON ${tablePrefix}_requests (status);\n\n-- Telescope exceptions table\nCREATE TABLE IF NOT EXISTS ${tablePrefix}_exceptions (\n  id VARCHAR(21) PRIMARY KEY,\n  name VARCHAR(255) NOT NULL,\n  message TEXT NOT NULL,\n  stack JSONB NOT NULL,\n  source JSONB,\n  request_id VARCHAR(21),\n  timestamp TIMESTAMPTZ NOT NULL,\n  handled BOOLEAN NOT NULL DEFAULT FALSE,\n  tags JSONB\n);\n\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_exceptions_timestamp\n  ON ${tablePrefix}_exceptions (timestamp DESC);\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_exceptions_request_id\n  ON ${tablePrefix}_exceptions (request_id);\n\n-- Telescope logs table\nCREATE TABLE IF NOT EXISTS ${tablePrefix}_logs (\n  id VARCHAR(21) PRIMARY KEY,\n  level VARCHAR(10) NOT NULL,\n  message TEXT NOT NULL,\n  context JSONB,\n  request_id VARCHAR(21),\n  timestamp TIMESTAMPTZ NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_logs_timestamp\n  ON ${tablePrefix}_logs (timestamp DESC);\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_logs_level\n  ON ${tablePrefix}_logs (level);\nCREATE INDEX IF NOT EXISTS idx_${tablePrefix}_logs_request_id\n  ON ${tablePrefix}_logs (request_id);\n`,\n    down: `\nDROP TABLE IF EXISTS ${tablePrefix}_logs;\nDROP TABLE IF EXISTS ${tablePrefix}_exceptions;\nDROP TABLE IF EXISTS ${tablePrefix}_requests;\n`,\n  };\n}\n"],"mappings":"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"}

package/dist/storage/memory.cjs

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

package/dist/storage/memory.d.cts

@@ -0,0 +1,3 @@
+import "../types-BGDhFv4R.cjs";
+import { InMemoryStorage, InMemoryStorageOptions } from "../memory-DiP1a-pp.cjs";
+export { InMemoryStorage, InMemoryStorageOptions };

package/dist/storage/memory.d.mts

@@ -0,0 +1,3 @@
+import "../types-CZbzz8kx.mjs";
+import { InMemoryStorage, InMemoryStorageOptions } from "../memory-Cm0eevCS.mjs";
+export { InMemoryStorage, InMemoryStorageOptions };

package/dist/storage/memory.mjs

@@ -0,0 +1,3 @@
+import { InMemoryStorage } from "../memory-SdN5vtG9.mjs";
+
+export { InMemoryStorage };

package/dist/types-BGDhFv4R.d.cts

@@ -0,0 +1,170 @@
+//#region src/types.d.ts
+/**
+ * Stack frame from a parsed error stack trace
+ */
+interface StackFrame {
+  file: string;
+  line: number;
+  column: number;
+  function: string;
+  /** Whether this frame is from application code (vs node_modules) */
+  isApp: boolean;
+}
+/**
+ * Source code context around an error
+ */
+interface SourceContext {
+  file: string;
+  line: number;
+  column: number;
+  lines: Array<{
+    num: number;
+    code: string;
+    highlight: boolean;
+  }>;
+}
+/**
+ * Recorded HTTP request entry
+ */
+interface RequestEntry {
+  id: string;
+  method: string;
+  path: string;
+  url: string;
+  headers: Record<string, string>;
+  body?: unknown;
+  query?: Record<string, string>;
+  status: number;
+  responseHeaders: Record<string, string>;
+  responseBody?: unknown;
+  duration: number;
+  timestamp: Date;
+  ip?: string;
+  userId?: string;
+  tags?: string[];
+}
+/**
+ * Recorded exception entry
+ */
+interface ExceptionEntry {
+  id: string;
+  name: string;
+  message: string;
+  stack: StackFrame[];
+  source?: SourceContext;
+  requestId?: string;
+  timestamp: Date;
+  handled: boolean;
+  tags?: string[];
+}
+/**
+ * Recorded log entry
+ */
+interface LogEntry {
+  id: string;
+  level: 'debug' | 'info' | 'warn' | 'error';
+  message: string;
+  context?: Record<string, unknown>;
+  requestId?: string;
+  timestamp: Date;
+}
+/**
+ * Query options for retrieving entries
+ */
+interface QueryOptions {
+  limit?: number;
+  offset?: number;
+  before?: Date;
+  after?: Date;
+  search?: string;
+  tags?: string[];
+}
+/**
+ * Storage interface for Telescope data
+ * Implementations can use memory, database, or any other backend
+ */
+interface TelescopeStorage {
+  saveRequest(entry: RequestEntry): Promise<void>;
+  saveRequests?(entries: RequestEntry[]): Promise<void>;
+  getRequests(options?: QueryOptions): Promise<RequestEntry[]>;
+  getRequest(id: string): Promise<RequestEntry | null>;
+  saveException(entry: ExceptionEntry): Promise<void>;
+  saveExceptions?(entries: ExceptionEntry[]): Promise<void>;
+  getExceptions(options?: QueryOptions): Promise<ExceptionEntry[]>;
+  getException(id: string): Promise<ExceptionEntry | null>;
+  saveLog(entry: LogEntry): Promise<void>;
+  saveLogs?(entries: LogEntry[]): Promise<void>;
+  getLogs(options?: QueryOptions): Promise<LogEntry[]>;
+  prune(olderThan: Date): Promise<number>;
+  getStats(): Promise<TelescopeStats>;
+}
+/**
+ * Statistics about stored entries
+ */
+interface TelescopeStats {
+  requests: number;
+  exceptions: number;
+  logs: number;
+  oldestEntry?: Date;
+  newestEntry?: Date;
+}
+/**
+ * Configuration options for Telescope
+ */
+interface TelescopeOptions {
+  /** Storage backend for persisting data */
+  storage: TelescopeStorage;
+  /** Whether telescope is enabled (default: true) */
+  enabled?: boolean;
+  /** Dashboard path (default: '/__telescope') */
+  path?: string;
+  /** Whether to record request/response bodies (default: true) */
+  recordBody?: boolean;
+  /** Maximum body size to record in bytes (default: 64KB) */
+  maxBodySize?: number;
+  /** URL patterns to ignore (default: []) */
+  ignorePatterns?: string[];
+  /** Auto-prune entries older than this many hours (default: undefined - no auto-prune) */
+  pruneAfterHours?: number;
+}
+/**
+ * Normalized telescope options with defaults applied
+ */
+interface NormalizedTelescopeOptions {
+  storage: TelescopeStorage;
+  enabled: boolean;
+  path: string;
+  recordBody: boolean;
+  maxBodySize: number;
+  ignorePatterns: string[];
+  pruneAfterHours?: number;
+}
+/**
+ * WebSocket event types
+ */
+type TelescopeEventType = 'request' | 'exception' | 'log' | 'stats' | 'connected';
+/**
+ * WebSocket event payload
+ */
+interface TelescopeEvent<T = unknown> {
+  type: TelescopeEventType;
+  payload: T;
+  timestamp: number;
+}
+/**
+ * Context stored during request processing
+ */
+interface RequestContext {
+  id: string;
+  startTime: number;
+  method: string;
+  path: string;
+  url: string;
+  headers: Record<string, string>;
+  query: Record<string, string>;
+  body?: unknown;
+  ip?: string;
+}
+//#endregion
+export { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage };
+//# sourceMappingURL=types-BGDhFv4R.d.cts.map

package/dist/types-CZbzz8kx.d.mts

@@ -0,0 +1,170 @@
+//#region src/types.d.ts
+/**
+ * Stack frame from a parsed error stack trace
+ */
+interface StackFrame {
+  file: string;
+  line: number;
+  column: number;
+  function: string;
+  /** Whether this frame is from application code (vs node_modules) */
+  isApp: boolean;
+}
+/**
+ * Source code context around an error
+ */
+interface SourceContext {
+  file: string;
+  line: number;
+  column: number;
+  lines: Array<{
+    num: number;
+    code: string;
+    highlight: boolean;
+  }>;
+}
+/**
+ * Recorded HTTP request entry
+ */
+interface RequestEntry {
+  id: string;
+  method: string;
+  path: string;
+  url: string;
+  headers: Record<string, string>;
+  body?: unknown;
+  query?: Record<string, string>;
+  status: number;
+  responseHeaders: Record<string, string>;
+  responseBody?: unknown;
+  duration: number;
+  timestamp: Date;
+  ip?: string;
+  userId?: string;
+  tags?: string[];
+}
+/**
+ * Recorded exception entry
+ */
+interface ExceptionEntry {
+  id: string;
+  name: string;
+  message: string;
+  stack: StackFrame[];
+  source?: SourceContext;
+  requestId?: string;
+  timestamp: Date;
+  handled: boolean;
+  tags?: string[];
+}
+/**
+ * Recorded log entry
+ */
+interface LogEntry {
+  id: string;
+  level: 'debug' | 'info' | 'warn' | 'error';
+  message: string;
+  context?: Record<string, unknown>;
+  requestId?: string;
+  timestamp: Date;
+}
+/**
+ * Query options for retrieving entries
+ */
+interface QueryOptions {
+  limit?: number;
+  offset?: number;
+  before?: Date;
+  after?: Date;
+  search?: string;
+  tags?: string[];
+}
+/**
+ * Storage interface for Telescope data
+ * Implementations can use memory, database, or any other backend
+ */
+interface TelescopeStorage {
+  saveRequest(entry: RequestEntry): Promise<void>;
+  saveRequests?(entries: RequestEntry[]): Promise<void>;
+  getRequests(options?: QueryOptions): Promise<RequestEntry[]>;
+  getRequest(id: string): Promise<RequestEntry | null>;
+  saveException(entry: ExceptionEntry): Promise<void>;
+  saveExceptions?(entries: ExceptionEntry[]): Promise<void>;
+  getExceptions(options?: QueryOptions): Promise<ExceptionEntry[]>;
+  getException(id: string): Promise<ExceptionEntry | null>;
+  saveLog(entry: LogEntry): Promise<void>;
+  saveLogs?(entries: LogEntry[]): Promise<void>;
+  getLogs(options?: QueryOptions): Promise<LogEntry[]>;
+  prune(olderThan: Date): Promise<number>;
+  getStats(): Promise<TelescopeStats>;
+}
+/**
+ * Statistics about stored entries
+ */
+interface TelescopeStats {
+  requests: number;
+  exceptions: number;
+  logs: number;
+  oldestEntry?: Date;
+  newestEntry?: Date;
+}
+/**
+ * Configuration options for Telescope
+ */
+interface TelescopeOptions {
+  /** Storage backend for persisting data */
+  storage: TelescopeStorage;
+  /** Whether telescope is enabled (default: true) */
+  enabled?: boolean;
+  /** Dashboard path (default: '/__telescope') */
+  path?: string;
+  /** Whether to record request/response bodies (default: true) */
+  recordBody?: boolean;
+  /** Maximum body size to record in bytes (default: 64KB) */
+  maxBodySize?: number;
+  /** URL patterns to ignore (default: []) */
+  ignorePatterns?: string[];
+  /** Auto-prune entries older than this many hours (default: undefined - no auto-prune) */
+  pruneAfterHours?: number;
+}
+/**
+ * Normalized telescope options with defaults applied
+ */
+interface NormalizedTelescopeOptions {
+  storage: TelescopeStorage;
+  enabled: boolean;
+  path: string;
+  recordBody: boolean;
+  maxBodySize: number;
+  ignorePatterns: string[];
+  pruneAfterHours?: number;
+}
+/**
+ * WebSocket event types
+ */
+type TelescopeEventType = 'request' | 'exception' | 'log' | 'stats' | 'connected';
+/**
+ * WebSocket event payload
+ */
+interface TelescopeEvent<T = unknown> {
+  type: TelescopeEventType;
+  payload: T;
+  timestamp: number;
+}
+/**
+ * Context stored during request processing
+ */
+interface RequestContext {
+  id: string;
+  startTime: number;
+  method: string;
+  path: string;
+  url: string;
+  headers: Record<string, string>;
+  query: Record<string, string>;
+  body?: unknown;
+  ip?: string;
+}
+//#endregion
+export { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage };
+//# sourceMappingURL=types-CZbzz8kx.d.mts.map

package/dist/types.d.cts

@@ -0,0 +1,2 @@
+import { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage } from "./types-BGDhFv4R.cjs";
+export { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage };

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage } from "./types-CZbzz8kx.mjs";
+export { ExceptionEntry, LogEntry, NormalizedTelescopeOptions, QueryOptions, RequestContext, RequestEntry, SourceContext, StackFrame, TelescopeEvent, TelescopeEventType, TelescopeOptions, TelescopeStats, TelescopeStorage };