@rudderjs/telescope 0.0.1

package/dist/index.js

@@ -0,0 +1,170 @@
+import { ServiceProvider } from '@rudderjs/core';
+import { MemoryStorage, SqliteStorage } from './storage.js';
+import { RequestCollector } from './collectors/request.js';
+import { QueryCollector } from './collectors/query.js';
+import { JobCollector } from './collectors/job.js';
+import { ExceptionCollector } from './collectors/exception.js';
+import { LogCollector } from './collectors/log.js';
+import { MailCollector } from './collectors/mail.js';
+import { NotificationCollector } from './collectors/notification.js';
+import { EventCollector } from './collectors/event.js';
+import { CacheCollector } from './collectors/cache.js';
+import { ScheduleCollector } from './collectors/schedule.js';
+import { ModelCollector } from './collectors/model.js';
+import { registerRoutes } from './api/routes.js';
+import { defaultConfig } from './types.js';
+export { MemoryStorage, SqliteStorage, createEntry } from './storage.js';
+export { RequestCollector } from './collectors/request.js';
+export { QueryCollector } from './collectors/query.js';
+export { JobCollector } from './collectors/job.js';
+export { ExceptionCollector } from './collectors/exception.js';
+export { LogCollector } from './collectors/log.js';
+export { MailCollector } from './collectors/mail.js';
+export { NotificationCollector } from './collectors/notification.js';
+export { EventCollector } from './collectors/event.js';
+export { CacheCollector } from './collectors/cache.js';
+export { ScheduleCollector } from './collectors/schedule.js';
+export { ModelCollector } from './collectors/model.js';
+// ─── Telescope Registry ────────────────────────────────────
+export class TelescopeRegistry {
+    static storage = null;
+    static set(storage) { this.storage = storage; }
+    static get() { return this.storage; }
+    /** @internal — clears the registered storage. Used for testing. */
+    static reset() { this.storage = null; }
+}
+// ─── Telescope Facade ──────────────────────────────────────
+export class Telescope {
+    static store() {
+        const s = TelescopeRegistry.get();
+        if (!s)
+            throw new Error('[RudderJS Telescope] No storage registered. Add telescope() to providers.');
+        return s;
+    }
+    static list(options = {}) {
+        return this.store().list(options);
+    }
+    static find(id) {
+        return this.store().find(id);
+    }
+    static count(type) {
+        return this.store().count(type);
+    }
+    static prune(type) {
+        return this.store().prune(type);
+    }
+    static record(entry) {
+        return this.store().store(entry);
+    }
+}
+// ─── Service Provider Factory ──────────────────────────────
+/**
+ * Returns a TelescopeServiceProvider class configured for the given config.
+ *
+ * Records requests, queries, jobs, exceptions, logs, mail, notifications,
+ * events, cache operations, scheduled tasks, and model changes.
+ *
+ * Usage in bootstrap/providers.ts:
+ *   import { telescope } from '@rudderjs/telescope'
+ *   export default [..., telescope(configs.telescope), ...]
+ */
+export function telescope(config = {}) {
+    const merged = { ...defaultConfig, ...config };
+    // Strip undefined values introduced by exactOptionalPropertyTypes spread
+    const resolved = {
+        enabled: merged.enabled ?? defaultConfig.enabled,
+        path: merged.path ?? defaultConfig.path,
+        storage: merged.storage ?? defaultConfig.storage,
+        sqlitePath: merged.sqlitePath ?? defaultConfig.sqlitePath,
+        maxEntries: merged.maxEntries ?? defaultConfig.maxEntries,
+        pruneAfterHours: merged.pruneAfterHours ?? defaultConfig.pruneAfterHours,
+        recordRequests: merged.recordRequests ?? defaultConfig.recordRequests,
+        recordQueries: merged.recordQueries ?? defaultConfig.recordQueries,
+        recordJobs: merged.recordJobs ?? defaultConfig.recordJobs,
+        recordExceptions: merged.recordExceptions ?? defaultConfig.recordExceptions,
+        recordLogs: merged.recordLogs ?? defaultConfig.recordLogs,
+        recordMail: merged.recordMail ?? defaultConfig.recordMail,
+        recordNotifications: merged.recordNotifications ?? defaultConfig.recordNotifications,
+        recordEvents: merged.recordEvents ?? defaultConfig.recordEvents,
+        recordCache: merged.recordCache ?? defaultConfig.recordCache,
+        recordSchedule: merged.recordSchedule ?? defaultConfig.recordSchedule,
+        recordModels: merged.recordModels ?? defaultConfig.recordModels,
+        ignoreRequests: merged.ignoreRequests ?? defaultConfig.ignoreRequests,
+        slowQueryThreshold: merged.slowQueryThreshold ?? defaultConfig.slowQueryThreshold,
+        auth: merged.auth ?? defaultConfig.auth,
+    };
+    class TelescopeServiceProvider extends ServiceProvider {
+        register() {
+            this.publishes({
+                from: new URL('../../boost/guidelines.md', import.meta.url).pathname,
+                to: 'boost',
+                tag: 'telescope-boost',
+            });
+        }
+        async boot() {
+            if (!resolved.enabled)
+                return;
+            // ── Create storage ────────────────────────────────────
+            let storage;
+            if (resolved.storage === 'sqlite') {
+                storage = new SqliteStorage(resolved.sqlitePath);
+            }
+            else {
+                storage = new MemoryStorage(resolved.maxEntries);
+            }
+            TelescopeRegistry.set(storage);
+            this.app.instance('telescope', storage);
+            // ── Auto-prune on interval ────────────────────────────
+            const pruneHours = resolved.pruneAfterHours;
+            if (pruneHours > 0) {
+                const interval = Math.min(pruneHours * 60 * 60 * 1000, 3_600_000);
+                const timer = setInterval(() => {
+                    const cutoff = new Date(Date.now() - pruneHours * 60 * 60 * 1000);
+                    storage.pruneOlderThan(cutoff);
+                }, interval);
+                timer.unref();
+            }
+            // ── Register collectors ───────────────────────────────
+            const collectors = [];
+            const requestCollector = new RequestCollector(storage, resolved);
+            collectors.push(requestCollector);
+            if (resolved.recordQueries)
+                collectors.push(new QueryCollector(storage, resolved));
+            if (resolved.recordJobs)
+                collectors.push(new JobCollector(storage));
+            if (resolved.recordExceptions)
+                collectors.push(new ExceptionCollector(storage));
+            if (resolved.recordLogs)
+                collectors.push(new LogCollector(storage));
+            if (resolved.recordMail)
+                collectors.push(new MailCollector(storage));
+            if (resolved.recordNotifications)
+                collectors.push(new NotificationCollector(storage));
+            if (resolved.recordEvents)
+                collectors.push(new EventCollector(storage));
+            if (resolved.recordCache)
+                collectors.push(new CacheCollector(storage));
+            if (resolved.recordSchedule)
+                collectors.push(new ScheduleCollector(storage));
+            if (resolved.recordModels)
+                collectors.push(new ModelCollector(storage));
+            for (const collector of collectors) {
+                await collector.register();
+            }
+            // ── Register request middleware ───────────────────────
+            if (resolved.recordRequests) {
+                try {
+                    const { router } = await import('@rudderjs/router');
+                    router.use(requestCollector.middleware());
+                }
+                catch {
+                    // @rudderjs/router not available — request recording disabled
+                }
+            }
+            // ── Register API routes ───────────────────────────────
+            await registerRoutes(storage, resolved);
+        }
+    }
+    return TelescopeServiceProvider;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,35 @@
+import type { TelescopeEntry, TelescopeStorage, ListOptions, EntryType } from './types.js';
+export declare function createEntry(type: EntryType, content: Record<string, unknown>, options?: {
+    batchId?: string;
+    tags?: string[];
+    familyHash?: string;
+}): TelescopeEntry;
+export declare class MemoryStorage implements TelescopeStorage {
+    private readonly maxEntries;
+    private entries;
+    constructor(maxEntries?: number);
+    store(entry: TelescopeEntry): void;
+    storeBatch(entries: TelescopeEntry[]): void;
+    list(options: ListOptions): TelescopeEntry[];
+    find(id: string): TelescopeEntry | null;
+    count(type?: EntryType): number;
+    prune(type?: EntryType): void;
+    pruneOlderThan(date: Date): void;
+}
+export declare class SqliteStorage implements TelescopeStorage {
+    private readonly dbPath;
+    private db;
+    constructor(dbPath: string);
+    private getDb;
+    private migrate;
+    private toRow;
+    private fromRow;
+    store(entry: TelescopeEntry): void;
+    storeBatch(entries: TelescopeEntry[]): void;
+    list(options: ListOptions): TelescopeEntry[];
+    find(id: string): TelescopeEntry | null;
+    count(type?: EntryType): number;
+    prune(type?: EntryType): void;
+    pruneOlderThan(date: Date): void;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI1F,wBAAgB,WAAW,CACzB,IAAI,EAAK,SAAS,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,cAAc,CAUhB;AAID,qBAAa,aAAc,YAAW,gBAAgB;IAGxC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,OAAO,CAAuB;gBAET,UAAU,GAAE,MAAa;IAEtD,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAOlC,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE;IA2B5C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAIvC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM;IAK/B,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI;IAQ7B,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAIjC;AAID,qBAAa,aAAc,YAAW,gBAAgB;IAGxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,EAAE,CAAiD;gBAE9B,MAAM,EAAE,MAAM;IAE3C,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,OAAO;IAYf,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQlC,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAY3C,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE;IAwB5C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAOvC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM;IAQ/B,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI;IAQ7B,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAGjC"}

package/dist/storage.js

@@ -0,0 +1,201 @@
+import { randomUUID } from 'node:crypto';
+// ─── Helpers ───────────────────────────────────────────────
+export function createEntry(type, content, options) {
+    return {
+        id: randomUUID(),
+        batchId: options?.batchId ?? null,
+        type,
+        content,
+        tags: options?.tags ?? [],
+        familyHash: options?.familyHash ?? null,
+        createdAt: new Date(),
+    };
+}
+// ─── Memory Storage ────────────────────────────────────────
+export class MemoryStorage {
+    maxEntries;
+    entries = [];
+    constructor(maxEntries = 1000) {
+        this.maxEntries = maxEntries;
+    }
+    store(entry) {
+        this.entries.unshift(entry);
+        if (this.entries.length > this.maxEntries) {
+            this.entries.length = this.maxEntries;
+        }
+    }
+    storeBatch(entries) {
+        for (const entry of entries)
+            this.store(entry);
+    }
+    list(options) {
+        let result = this.entries;
+        if (options.type) {
+            result = result.filter(e => e.type === options.type);
+        }
+        if (options.batchId) {
+            const bId = options.batchId;
+            result = result.filter(e => e.batchId === bId);
+        }
+        if (options.tag) {
+            const tag = options.tag;
+            result = result.filter(e => e.tags.includes(tag));
+        }
+        if (options.search) {
+            const s = options.search.toLowerCase();
+            result = result.filter(e => JSON.stringify(e.content).toLowerCase().includes(s));
+        }
+        const page = options.page ?? 1;
+        const perPage = options.perPage ?? 50;
+        const start = (page - 1) * perPage;
+        return result.slice(start, start + perPage);
+    }
+    find(id) {
+        return this.entries.find(e => e.id === id) ?? null;
+    }
+    count(type) {
+        if (!type)
+            return this.entries.length;
+        return this.entries.filter(e => e.type === type).length;
+    }
+    prune(type) {
+        if (!type) {
+            this.entries.length = 0;
+        }
+        else {
+            this.entries = this.entries.filter(e => e.type !== type);
+        }
+    }
+    pruneOlderThan(date) {
+        const ts = date.getTime();
+        this.entries = this.entries.filter(e => e.createdAt.getTime() >= ts);
+    }
+}
+// ─── SQLite Storage ────────────────────────────────────────
+export class SqliteStorage {
+    dbPath;
+    db = null;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+    }
+    getDb() {
+        if (!this.db) {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const Database = globalThis.__betterSqlite3;
+            if (!Database) {
+                throw new Error('[RudderJS Telescope] better-sqlite3 is required for SQLite storage. Run: pnpm add better-sqlite3');
+            }
+            this.db = new Database(this.dbPath);
+            this.migrate();
+        }
+        return this.db;
+    }
+    migrate() {
+        const db = this.db;
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS telescope_entries (
+        id          TEXT PRIMARY KEY,
+        batch_id    TEXT,
+        type        TEXT NOT NULL,
+        content     TEXT NOT NULL,
+        tags        TEXT NOT NULL DEFAULT '[]',
+        family_hash TEXT,
+        created_at  TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_telescope_type_created ON telescope_entries(type, created_at);
+      CREATE INDEX IF NOT EXISTS idx_telescope_batch ON telescope_entries(batch_id);
+    `);
+    }
+    toRow(entry) {
+        return {
+            id: entry.id,
+            batch_id: entry.batchId,
+            type: entry.type,
+            content: JSON.stringify(entry.content),
+            tags: JSON.stringify(entry.tags),
+            family_hash: entry.familyHash,
+            created_at: entry.createdAt.toISOString(),
+        };
+    }
+    fromRow(row) {
+        return {
+            id: row['id'],
+            batchId: row['batch_id'] || null,
+            type: row['type'],
+            content: JSON.parse(row['content']),
+            tags: JSON.parse(row['tags']),
+            familyHash: row['family_hash'] || null,
+            createdAt: new Date(row['created_at']),
+        };
+    }
+    store(entry) {
+        const row = this.toRow(entry);
+        this.getDb().prepare(`INSERT INTO telescope_entries (id, batch_id, type, content, tags, family_hash, created_at)
+       VALUES (@id, @batch_id, @type, @content, @tags, @family_hash, @created_at)`).run(row);
+    }
+    storeBatch(entries) {
+        const db = this.getDb();
+        const stmt = db.prepare(`INSERT INTO telescope_entries (id, batch_id, type, content, tags, family_hash, created_at)
+       VALUES (@id, @batch_id, @type, @content, @tags, @family_hash, @created_at)`);
+        const tx = db.transaction((rows) => {
+            for (const row of rows)
+                stmt.run(row);
+        });
+        tx(entries.map(e => this.toRow(e)));
+    }
+    list(options) {
+        const conditions = [];
+        const params = {};
+        if (options.type) {
+            conditions.push('type = @type');
+            params['type'] = options.type;
+        }
+        if (options.batchId) {
+            conditions.push('batch_id = @batchId');
+            params['batchId'] = options.batchId;
+        }
+        if (options.tag) {
+            conditions.push('tags LIKE @tag');
+            params['tag'] = `%${options.tag}%`;
+        }
+        if (options.search) {
+            conditions.push('content LIKE @search');
+            params['search'] = `%${options.search}%`;
+        }
+        const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';
+        const page = options.page ?? 1;
+        const perPage = options.perPage ?? 50;
+        const offset = (page - 1) * perPage;
+        params['limit'] = perPage;
+        params['offset'] = offset;
+        const rows = this.getDb()
+            .prepare(`SELECT * FROM telescope_entries ${where} ORDER BY created_at DESC LIMIT @limit OFFSET @offset`)
+            .all(params);
+        return rows.map(r => this.fromRow(r));
+    }
+    find(id) {
+        const row = this.getDb()
+            .prepare('SELECT * FROM telescope_entries WHERE id = ?')
+            .get(id);
+        return row ? this.fromRow(row) : null;
+    }
+    count(type) {
+        const sql = type
+            ? 'SELECT COUNT(*) as cnt FROM telescope_entries WHERE type = ?'
+            : 'SELECT COUNT(*) as cnt FROM telescope_entries';
+        const row = this.getDb().prepare(sql).get(...(type ? [type] : []));
+        return row.cnt;
+    }
+    prune(type) {
+        if (type) {
+            this.getDb().prepare('DELETE FROM telescope_entries WHERE type = ?').run(type);
+        }
+        else {
+            this.getDb().prepare('DELETE FROM telescope_entries').run();
+        }
+    }
+    pruneOlderThan(date) {
+        this.getDb().prepare('DELETE FROM telescope_entries WHERE created_at < ?').run(date.toISOString());
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export type EntryType = 'request' | 'query' | 'job' | 'exception' | 'log' | 'mail' | 'notification' | 'event' | 'cache' | 'schedule' | 'model';
+export interface TelescopeEntry {
+    id: string;
+    batchId: string | null;
+    type: EntryType;
+    content: Record<string, unknown>;
+    tags: string[];
+    familyHash: string | null;
+    createdAt: Date;
+}
+export interface Collector {
+    /** Human-readable name (e.g. "Request Collector") */
+    readonly name: string;
+    /** The entry type this collector produces */
+    readonly type: EntryType;
+    /** Register hooks. Called during provider boot. */
+    register(): void | Promise<void>;
+}
+export interface TelescopeStorage {
+    store(entry: TelescopeEntry): void | Promise<void>;
+    storeBatch(entries: TelescopeEntry[]): void | Promise<void>;
+    /** List entries by type, with pagination and optional filters */
+    list(options: ListOptions): TelescopeEntry[] | Promise<TelescopeEntry[]>;
+    /** Get a single entry by ID */
+    find(id: string): TelescopeEntry | null | Promise<TelescopeEntry | null>;
+    /** Count entries by type */
+    count(type?: EntryType): number | Promise<number>;
+    /** Delete all entries, optionally filtered by type */
+    prune(type?: EntryType): void | Promise<void>;
+    /** Delete entries older than the given date */
+    pruneOlderThan(date: Date): void | Promise<void>;
+}
+export interface ListOptions {
+    type?: EntryType | undefined;
+    page?: number | undefined;
+    perPage?: number | undefined;
+    tag?: string | undefined;
+    search?: string | undefined;
+    batchId?: string | undefined;
+}
+export interface TelescopeConfig {
+    enabled?: boolean | undefined;
+    path?: string | undefined;
+    storage?: 'memory' | 'sqlite' | undefined;
+    sqlitePath?: string | undefined;
+    maxEntries?: number | undefined;
+    pruneAfterHours?: number | undefined;
+    recordRequests?: boolean | undefined;
+    recordQueries?: boolean | undefined;
+    recordJobs?: boolean | undefined;
+    recordExceptions?: boolean | undefined;
+    recordLogs?: boolean | undefined;
+    recordMail?: boolean | undefined;
+    recordNotifications?: boolean | undefined;
+    recordEvents?: boolean | undefined;
+    recordCache?: boolean | undefined;
+    recordSchedule?: boolean | undefined;
+    recordModels?: boolean | undefined;
+    ignoreRequests?: string[] | undefined;
+    slowQueryThreshold?: number | undefined;
+    auth?: null | ((req: unknown) => boolean | Promise<boolean>) | undefined;
+}
+export declare const defaultConfig: Required<Omit<TelescopeConfig, 'auth' | 'sqlitePath'>> & {
+    auth: TelescopeConfig['auth'];
+    sqlitePath: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,24 @@
+// ─── Entry Types ───────────────────────────────────────────
+export const defaultConfig = {
+    enabled: true,
+    path: 'telescope',
+    storage: 'memory',
+    sqlitePath: '.telescope.db',
+    maxEntries: 1000,
+    pruneAfterHours: 24,
+    recordRequests: true,
+    recordQueries: true,
+    recordJobs: true,
+    recordExceptions: true,
+    recordLogs: true,
+    recordMail: true,
+    recordNotifications: true,
+    recordEvents: true,
+    recordCache: true,
+    recordSchedule: true,
+    recordModels: true,
+    ignoreRequests: ['/telescope*', '/health'],
+    slowQueryThreshold: 100,
+    auth: null,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAwF9D,MAAM,CAAC,MAAM,aAAa,GAAmH;IAC3I,OAAO,EAAe,IAAI;IAC1B,IAAI,EAAkB,WAAW;IACjC,OAAO,EAAe,QAAQ;IAC9B,UAAU,EAAY,eAAe;IACrC,UAAU,EAAY,IAAI;IAC1B,eAAe,EAAO,EAAE;IACxB,cAAc,EAAQ,IAAI;IAC1B,aAAa,EAAS,IAAI;IAC1B,UAAU,EAAY,IAAI;IAC1B,gBAAgB,EAAM,IAAI;IAC1B,UAAU,EAAY,IAAI;IAC1B,UAAU,EAAY,IAAI;IAC1B,mBAAmB,EAAG,IAAI;IAC1B,YAAY,EAAU,IAAI;IAC1B,WAAW,EAAW,IAAI;IAC1B,cAAc,EAAQ,IAAI;IAC1B,YAAY,EAAU,IAAI;IAC1B,cAAc,EAAQ,CAAC,aAAa,EAAE,SAAS,CAAC;IAChD,kBAAkB,EAAI,GAAG;IACzB,IAAI,EAAkB,IAAI;CAC3B,CAAA"}

package/dist/ui/layout.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared HTML layout for Telescope UI pages.
+ * Sidebar navigation + content area. Alpine.js + Tailwind CDN.
+ */
+export interface NavItem {
+    label: string;
+    path: string;
+    icon: string;
+}
+export declare function layout(title: string, body: string, basePath: string, activePath: string): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/ui/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/ui/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAG,MAAM,CAAA;IACb,IAAI,EAAG,MAAM,CAAA;CACd;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiEhG"}

package/dist/ui/layout.js

@@ -0,0 +1,69 @@
+/**
+ * Shared HTML layout for Telescope UI pages.
+ * Sidebar navigation + content area. Alpine.js + Tailwind CDN.
+ */
+export function layout(title, body, basePath, activePath) {
+    const nav = [
+        { label: 'Dashboard', path: '', icon: 'M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6' },
+        { label: 'Requests', path: '/requests', icon: 'M13 10V3L4 14h7v7l9-11h-7z' },
+        { label: 'Queries', path: '/queries', icon: 'M4 7v10c0 2.21 3.582 4 8 4s8-1.79 8-4V7M4 7c0 2.21 3.582 4 8 4s8-1.79 8-4M4 7c0-2.21 3.582-4 8-4s8 1.79 8 4' },
+        { label: 'Jobs', path: '/jobs', icon: 'M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10' },
+        { label: 'Exceptions', path: '/exceptions', icon: 'M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z' },
+        { label: 'Logs', path: '/logs', icon: 'M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z' },
+        { label: 'Mail', path: '/mail', icon: 'M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z' },
+        { label: 'Notifications', path: '/notifications', icon: 'M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9' },
+        { label: 'Events', path: '/events', icon: 'M13 10V3L4 14h7v7l9-11h-7z' },
+        { label: 'Cache', path: '/cache', icon: 'M5 8h14M5 8a2 2 0 110-4h14a2 2 0 110 4M5 8v10a2 2 0 002 2h10a2 2 0 002-2V8m-9 4h4' },
+        { label: 'Schedule', path: '/schedule', icon: 'M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z' },
+        { label: 'Models', path: '/models', icon: 'M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10' },
+    ];
+    const navHtml = nav.map(n => {
+        const href = `${basePath}${n.path}`;
+        const active = activePath === n.path || (n.path === '' && activePath === '/');
+        return `<a href="${href}" class="flex items-center gap-3 px-3 py-2 text-sm rounded-lg transition ${active ? 'bg-indigo-50 text-indigo-700 font-medium' : 'text-gray-600 hover:bg-gray-50 hover:text-gray-900'}">
+      <svg class="w-4 h-4 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="${n.icon}"/></svg>
+      ${n.label}
+    </a>`;
+    }).join('\n        ');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title} — Telescope</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js"></script>
+  <style>
+    [x-cloak] { display: none !important; }
+    .badge { @apply inline-flex items-center px-2 py-0.5 rounded text-xs font-medium; }
+  </style>
+</head>
+<body class="bg-gray-50 text-gray-900 font-sans antialiased">
+  <div class="flex min-h-screen">
+    <!-- Sidebar -->
+    <aside class="w-56 bg-white border-r border-gray-200 flex flex-col">
+      <div class="px-4 py-5 flex items-center gap-2 border-b border-gray-100">
+        <div class="w-7 h-7 bg-violet-600 rounded-lg flex items-center justify-center">
+          <svg class="w-4 h-4 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+          </svg>
+        </div>
+        <span class="font-semibold text-sm">Telescope</span>
+      </div>
+      <nav class="flex-1 px-3 py-4 space-y-0.5 overflow-y-auto">
+        ${navHtml}
+      </nav>
+    </aside>
+
+    <!-- Main content -->
+    <main class="flex-1 overflow-auto">
+      <div class="max-w-6xl mx-auto px-6 py-8">
+        ${body}
+      </div>
+    </main>
+  </div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/ui/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/ui/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,IAAY,EAAE,QAAgB,EAAE,UAAkB;IACtF,MAAM,GAAG,GAAc;QACrB,EAAE,KAAK,EAAE,WAAW,EAAM,IAAI,EAAE,EAAE,EAAe,IAAI,EAAE,kJAAkJ,EAAE;QAC3M,EAAE,KAAK,EAAE,UAAU,EAAO,IAAI,EAAE,WAAW,EAAM,IAAI,EAAE,4BAA4B,EAAE;QACrF,EAAE,KAAK,EAAE,SAAS,EAAQ,IAAI,EAAE,UAAU,EAAO,IAAI,EAAE,6GAA6G,EAAE;QACtK,EAAE,KAAK,EAAE,MAAM,EAAW,IAAI,EAAE,OAAO,EAAU,IAAI,EAAE,wJAAwJ,EAAE;QACjN,EAAE,KAAK,EAAE,YAAY,EAAK,IAAI,EAAE,aAAa,EAAI,IAAI,EAAE,sIAAsI,EAAE;QAC/L,EAAE,KAAK,EAAE,MAAM,EAAW,IAAI,EAAE,OAAO,EAAU,IAAI,EAAE,sHAAsH,EAAE;QAC/K,EAAE,KAAK,EAAE,MAAM,EAAW,IAAI,EAAE,OAAO,EAAU,IAAI,EAAE,sGAAsG,EAAE;QAC/J,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,+LAA+L,EAAE;QACzP,EAAE,KAAK,EAAE,QAAQ,EAAS,IAAI,EAAE,SAAS,EAAQ,IAAI,EAAE,4BAA4B,EAAE;QACrF,EAAE,KAAK,EAAE,OAAO,EAAU,IAAI,EAAE,QAAQ,EAAS,IAAI,EAAE,mFAAmF,EAAE;QAC5I,EAAE,KAAK,EAAE,UAAU,EAAO,IAAI,EAAE,WAAW,EAAM,IAAI,EAAE,6CAA6C,EAAE;QACtG,EAAE,KAAK,EAAE,QAAQ,EAAS,IAAI,EAAE,SAAS,EAAQ,IAAI,EAAE,wJAAwJ,EAAE;KAClN,CAAA;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC1B,MAAM,IAAI,GAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,UAAU,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,UAAU,KAAK,GAAG,CAAC,CAAA;QAC7E,OAAO,YAAY,IAAI,4EAA4E,MAAM,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAC,oDAAoD;0KACvC,CAAC,CAAC,IAAI;QACxK,CAAC,CAAC,KAAK;SACN,CAAA;IACP,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAErB,OAAO;;;;;WAKE,KAAK;;;;;;;;;;;;;;;;;;;;;;UAsBN,OAAO;;;;;;;UAOP,IAAI;;;;;QAKN,CAAA;AACR,CAAC"}