@graphty/remote-logger 0.0.1 → 1.2.0

package/bin/remote-log-server.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main } from "../dist/server/index.js";
+main();

package/dist/client/RemoteLogClient.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Browser client for sending log messages to a remote server.
+ * Provides batching and automatic retry with exponential backoff.
+ * @module client/RemoteLogClient
+ */
+import type { RemoteLogClientOptions } from "./types.js";
+/**
+ * Client for sending log messages to a remote logging server.
+ *
+ * Features:
+ * - Batches multiple log entries before sending
+ * - Automatic retry with exponential backoff on network failures
+ * - Unique session ID for correlating logs
+ * @example
+ * ```typescript
+ * const client = new RemoteLogClient({
+ *     serverUrl: "http://localhost:9080",
+ *     sessionPrefix: "myapp",
+ * });
+ *
+ * client.log("INFO", "User logged in", { userId: 123 });
+ * client.log("DEBUG", "Loading data...");
+ *
+ * // Flush immediately when needed
+ * await client.flush();
+ *
+ * // Clean up when done
+ * await client.close();
+ * ```
+ */
+export declare class RemoteLogClient {
+    /** Unique identifier for this logging session */
+    readonly sessionId: string;
+    private readonly serverUrl;
+    private readonly batchIntervalMs;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private readonly throttlePatterns;
+    private readonly projectMarker;
+    private readonly worktreePath;
+    private pendingLogs;
+    private batchTimer;
+    private isClosed;
+    private flushPromise;
+    /** Tracks when each throttle pattern was last allowed through */
+    private throttleLastTimes;
+    /**
+     * Creates a new RemoteLogClient.
+     * @param options - Configuration options
+     */
+    constructor(options: RemoteLogClientOptions);
+    /**
+     * Checks if a message should be throttled based on configured patterns.
+     * Updates the last time tracking if the message is allowed through.
+     * @param message - The message to check
+     * @returns true if the message should be dropped (throttled)
+     */
+    private shouldThrottle;
+    /**
+     * Logs a message at the specified level.
+     * @param level - Log level (e.g., "INFO", "DEBUG", "WARN", "ERROR")
+     * @param message - The log message
+     * @param data - Optional additional data to include
+     */
+    log(level: string, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Schedules a batch send after the configured interval.
+     * If a timer is already scheduled, does nothing.
+     */
+    private scheduleBatchSend;
+    /**
+     * Sends the current batch of logs to the server.
+     * Uses retry logic with exponential backoff on failure.
+     */
+    private sendBatch;
+    /**
+     * Sends logs with retry logic using exponential backoff.
+     * @param logs - The log entries to send
+     */
+    private sendWithRetry;
+    /**
+     * Makes the actual HTTP request to send logs.
+     * @param logs - The log entries to send
+     * @throws Error if the request fails
+     */
+    private sendRequest;
+    /**
+     * Helper to sleep for the specified duration.
+     * @param ms - Milliseconds to sleep
+     * @returns A promise that resolves after the specified time
+     */
+    private sleep;
+    /**
+     * Immediately flushes all pending logs to the server.
+     * Useful before page unload or when immediate delivery is needed.
+     */
+    flush(): Promise<void>;
+    /**
+     * Closes the client, flushing any pending logs and stopping the batch timer.
+     * After calling close(), no more logs will be accepted.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Factory function to create a RemoteLogClient.
+ * @param options - Configuration options
+ * @returns A new RemoteLogClient instance
+ * @example
+ * ```typescript
+ * const client = createRemoteLogClient({
+ *     serverUrl: "http://localhost:9080",
+ * });
+ * ```
+ */
+export declare function createRemoteLogClient(options: RemoteLogClientOptions): RemoteLogClient;
+//# sourceMappingURL=RemoteLogClient.d.ts.map

package/dist/client/RemoteLogClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteLogClient.d.ts","sourceRoot":"","sources":["../../src/client/RemoteLogClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAY,sBAAsB,EAAmB,MAAM,YAAY,CAAC;AA+CpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IACxB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA8B;IAElD,iEAAiE;IACjE,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;;OAGG;gBACS,OAAO,EAAE,sBAAsB;IAa3C;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqBzE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;YACW,SAAS;IAYvB;;;OAGG;YACW,aAAa;IAuB3B;;;;OAIG;YACW,WAAW;IAgCzB;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF"}

package/dist/client/RemoteLogClient.js

@@ -0,0 +1,269 @@
+/**
+ * Browser client for sending log messages to a remote server.
+ * Provides batching and automatic retry with exponential backoff.
+ * @module client/RemoteLogClient
+ */
+/**
+ * Safely read a global variable that may or may not be defined.
+ * @param name - Name of the global variable
+ * @returns The value of the global variable, or undefined if not defined
+ */
+function getGlobalValue(name) {
+    try {
+        if (name === "__REMOTE_LOG_PROJECT_MARKER__") {
+            return typeof __REMOTE_LOG_PROJECT_MARKER__ !== "undefined" ? __REMOTE_LOG_PROJECT_MARKER__ : undefined;
+        }
+        if (name === "__REMOTE_LOG_WORKTREE_PATH__") {
+            return typeof __REMOTE_LOG_WORKTREE_PATH__ !== "undefined" ? __REMOTE_LOG_WORKTREE_PATH__ : undefined;
+        }
+    }
+    catch {
+        // ReferenceError if the global is not defined at all
+        return undefined;
+    }
+    return undefined;
+}
+/** Default configuration values */
+const DEFAULT_BATCH_INTERVAL_MS = 1000;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_RETRY_DELAY_MS = 1000;
+const DEFAULT_SESSION_PREFIX = "session";
+/**
+ * Generates a unique session ID with the given prefix.
+ * Format: {prefix}-{timestamp}-{random}
+ * @param prefix - The prefix to use for the session ID
+ * @returns A unique session ID string
+ */
+function generateSessionId(prefix) {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${prefix}-${timestamp}-${random}`;
+}
+/**
+ * Client for sending log messages to a remote logging server.
+ *
+ * Features:
+ * - Batches multiple log entries before sending
+ * - Automatic retry with exponential backoff on network failures
+ * - Unique session ID for correlating logs
+ * @example
+ * ```typescript
+ * const client = new RemoteLogClient({
+ *     serverUrl: "http://localhost:9080",
+ *     sessionPrefix: "myapp",
+ * });
+ *
+ * client.log("INFO", "User logged in", { userId: 123 });
+ * client.log("DEBUG", "Loading data...");
+ *
+ * // Flush immediately when needed
+ * await client.flush();
+ *
+ * // Clean up when done
+ * await client.close();
+ * ```
+ */
+export class RemoteLogClient {
+    /**
+     * Creates a new RemoteLogClient.
+     * @param options - Configuration options
+     */
+    constructor(options) {
+        this.pendingLogs = [];
+        this.batchTimer = null;
+        this.isClosed = false;
+        this.flushPromise = null;
+        /** Tracks when each throttle pattern was last allowed through */
+        this.throttleLastTimes = new Map();
+        this.serverUrl = options.serverUrl;
+        this.sessionId = generateSessionId(options.sessionPrefix ?? DEFAULT_SESSION_PREFIX);
+        this.batchIntervalMs = options.batchIntervalMs ?? DEFAULT_BATCH_INTERVAL_MS;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+        this.throttlePatterns = options.throttlePatterns ?? [];
+        // Priority: explicit option > global variable
+        this.projectMarker = options.projectMarker ?? getGlobalValue("__REMOTE_LOG_PROJECT_MARKER__");
+        this.worktreePath = options.worktreePath ?? getGlobalValue("__REMOTE_LOG_WORKTREE_PATH__");
+    }
+    /**
+     * Checks if a message should be throttled based on configured patterns.
+     * Updates the last time tracking if the message is allowed through.
+     * @param message - The message to check
+     * @returns true if the message should be dropped (throttled)
+     */
+    shouldThrottle(message) {
+        const now = Date.now();
+        for (const { pattern, intervalMs } of this.throttlePatterns) {
+            if (pattern.test(message)) {
+                const key = pattern.source;
+                const lastTime = this.throttleLastTimes.get(key) ?? 0;
+                if (now - lastTime < intervalMs) {
+                    // Within throttle window, drop this message
+                    return true;
+                }
+                // Outside throttle window, update timestamp and allow through
+                this.throttleLastTimes.set(key, now);
+                return false;
+            }
+        }
+        // No matching pattern, allow through
+        return false;
+    }
+    /**
+     * Logs a message at the specified level.
+     * @param level - Log level (e.g., "INFO", "DEBUG", "WARN", "ERROR")
+     * @param message - The log message
+     * @param data - Optional additional data to include
+     */
+    log(level, message, data) {
+        if (this.isClosed) {
+            return;
+        }
+        // Check throttling before adding to buffer
+        if (this.shouldThrottle(message)) {
+            return;
+        }
+        const entry = {
+            time: new Date().toISOString(),
+            level,
+            message,
+            ...(data !== undefined && { data }),
+        };
+        this.pendingLogs.push(entry);
+        this.scheduleBatchSend();
+    }
+    /**
+     * Schedules a batch send after the configured interval.
+     * If a timer is already scheduled, does nothing.
+     */
+    scheduleBatchSend() {
+        if (this.batchTimer !== null || this.isClosed) {
+            return;
+        }
+        this.batchTimer = setTimeout(() => {
+            this.batchTimer = null;
+            void this.sendBatch();
+        }, this.batchIntervalMs);
+    }
+    /**
+     * Sends the current batch of logs to the server.
+     * Uses retry logic with exponential backoff on failure.
+     */
+    async sendBatch() {
+        if (this.pendingLogs.length === 0) {
+            return;
+        }
+        // Take the current logs and clear the pending array
+        const logsToSend = this.pendingLogs;
+        this.pendingLogs = [];
+        await this.sendWithRetry(logsToSend);
+    }
+    /**
+     * Sends logs with retry logic using exponential backoff.
+     * @param logs - The log entries to send
+     */
+    async sendWithRetry(logs) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                await this.sendRequest(logs);
+                return; // Success!
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < this.maxRetries) {
+                    // Exponential backoff: delay * 2^attempt
+                    const delay = this.retryDelayMs * Math.pow(2, attempt);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        // All retries exhausted - log the error but don't throw
+        // In a browser context, we don't want to break the application
+        console.error("[RemoteLogClient] Failed to send logs after retries:", lastError?.message);
+    }
+    /**
+     * Makes the actual HTTP request to send logs.
+     * @param logs - The log entries to send
+     * @throws Error if the request fails
+     */
+    async sendRequest(logs) {
+        const requestBody = {
+            sessionId: this.sessionId,
+            logs,
+        };
+        // Only include these fields if they have values
+        if (this.projectMarker !== undefined) {
+            requestBody.projectMarker = this.projectMarker;
+        }
+        if (this.worktreePath !== undefined) {
+            requestBody.worktreePath = this.worktreePath;
+        }
+        const response = await fetch(`${this.serverUrl}/log`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+    }
+    /**
+     * Helper to sleep for the specified duration.
+     * @param ms - Milliseconds to sleep
+     * @returns A promise that resolves after the specified time
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Immediately flushes all pending logs to the server.
+     * Useful before page unload or when immediate delivery is needed.
+     */
+    async flush() {
+        // Cancel any scheduled batch
+        if (this.batchTimer !== null) {
+            clearTimeout(this.batchTimer);
+            this.batchTimer = null;
+        }
+        // Wait for any in-progress flush
+        if (this.flushPromise !== null) {
+            await this.flushPromise;
+        }
+        // Send any remaining logs
+        if (this.pendingLogs.length > 0) {
+            this.flushPromise = this.sendBatch();
+            await this.flushPromise;
+            this.flushPromise = null;
+        }
+    }
+    /**
+     * Closes the client, flushing any pending logs and stopping the batch timer.
+     * After calling close(), no more logs will be accepted.
+     */
+    async close() {
+        if (this.isClosed) {
+            return;
+        }
+        this.isClosed = true;
+        // Flush remaining logs
+        await this.flush();
+    }
+}
+/**
+ * Factory function to create a RemoteLogClient.
+ * @param options - Configuration options
+ * @returns A new RemoteLogClient instance
+ * @example
+ * ```typescript
+ * const client = createRemoteLogClient({
+ *     serverUrl: "http://localhost:9080",
+ * });
+ * ```
+ */
+export function createRemoteLogClient(options) {
+    return new RemoteLogClient(options);
+}
+//# sourceMappingURL=RemoteLogClient.js.map

package/dist/client/RemoteLogClient.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Browser client for remote logging.
+ * @module client
+ */
+export { createRemoteLogClient, RemoteLogClient } from "./RemoteLogClient.js";
+export type { LogEntry, RemoteLogClientOptions, ThrottlePattern } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,6 @@
+/**
+ * Browser client for remote logging.
+ * @module client
+ */
+export { createRemoteLogClient, RemoteLogClient } from "./RemoteLogClient.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Type definitions for the remote logging client.
+ * @module client/types
+ */
+/**
+ * A single log entry to be sent to the remote server.
+ */
+export interface LogEntry {
+    /** ISO 8601 timestamp when the log was created */
+    time: string;
+    /** Log level (e.g., "INFO", "DEBUG", "WARN", "ERROR") */
+    level: string;
+    /** The log message */
+    message: string;
+    /** Optional additional data to include with the log */
+    data?: Record<string, unknown>;
+}
+/**
+ * Configuration for throttling specific message patterns.
+ */
+export interface ThrottlePattern {
+    /** Regular expression pattern to match log messages */
+    pattern: RegExp;
+    /** Minimum interval in milliseconds between matching messages */
+    intervalMs: number;
+}
+/**
+ * Configuration options for the RemoteLogClient.
+ */
+export interface RemoteLogClientOptions {
+    /** URL of the remote log server (e.g., "http://localhost:9080") */
+    serverUrl: string;
+    /** Prefix for the generated session ID (default: "session") */
+    sessionPrefix?: string;
+    /** Interval in milliseconds between batch sends (default: 1000) */
+    batchIntervalMs?: number;
+    /** Maximum number of retry attempts for failed sends (default: 3) */
+    maxRetries?: number;
+    /** Base delay in milliseconds between retries (uses exponential backoff) (default: 1000) */
+    retryDelayMs?: number;
+    /**
+     * Patterns to throttle to prevent log flooding.
+     * Messages matching a pattern will only be sent once per the configured interval.
+     */
+    throttlePatterns?: ThrottlePattern[];
+    /**
+     * Project marker to identify logs from this project.
+     * If not provided, the client will attempt to read from the
+     * __REMOTE_LOG_PROJECT_MARKER__ global variable (injected by Vite plugin).
+     */
+    projectMarker?: string;
+    /**
+     * Full path to the worktree or project directory.
+     * Used for debugging and log organization.
+     * If not provided, the client will attempt to read from the
+     * __REMOTE_LOG_WORKTREE_PATH__ global variable (injected by Vite plugin).
+     */
+    worktreePath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/client/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for the remote logging client.
+ * @module client/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Remote logging client and server for browser debugging.
+ *
+ * Client usage (Browser):
+ *   import { RemoteLogClient } from "@graphty/remote-logger";
+ *   const client = new RemoteLogClient({ serverUrl: "http://localhost:9080" });
+ *   client.log("INFO", "Hello from browser");
+ *
+ * Server usage (Node.js):
+ *   import { startLogServer } from "@graphty/remote-logger/server";
+ *   startLogServer({ port: 9080 });
+ *
+ * Or via CLI:
+ *   npx remote-log-server --port 9080
+ *
+ * UI usage (Browser):
+ *   import { initConsoleCaptureUI } from "@graphty/remote-logger/ui";
+ *   initConsoleCaptureUI();
+ */
+export type { LogEntry, RemoteLogClientOptions, ThrottlePattern } from "./client/index.js";
+export { createRemoteLogClient, RemoteLogClient } from "./client/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,YAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * Remote logging client and server for browser debugging.
+ *
+ * Client usage (Browser):
+ *   import { RemoteLogClient } from "@graphty/remote-logger";
+ *   const client = new RemoteLogClient({ serverUrl: "http://localhost:9080" });
+ *   client.log("INFO", "Hello from browser");
+ *
+ * Server usage (Node.js):
+ *   import { startLogServer } from "@graphty/remote-logger/server";
+ *   startLogServer({ port: 9080 });
+ *
+ * Or via CLI:
+ *   npx remote-log-server --port 9080
+ *
+ * UI usage (Browser):
+ *   import { initConsoleCaptureUI } from "@graphty/remote-logger/ui";
+ *   initConsoleCaptureUI();
+ */
+export { createRemoteLogClient, RemoteLogClient } from "./client/index.js";
+// Note: UI components are NOT re-exported here to keep the main entry lightweight.
+// Import from "@graphty/remote-logger/ui" for UI usage.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE3E,mFAAmF;AACnF,wDAAwD"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP server module exports.
+ *
+ * Provides Model Context Protocol interface for log queries.
+ * @module mcp
+ */
+export { createMcpServer, getToolNames, startMcpServer } from "./mcp-server.js";
+export { logsGetRecentHandler, type LogsGetRecentInput, logsGetRecentInputSchema, type LogsGetRecentOutput, logsGetRecentTool, logsListSessionsHandler, type LogsListSessionsInput, logsListSessionsInputSchema, type LogsListSessionsOutput, logsListSessionsTool, logsStatusHandler, type LogsStatusInput, logsStatusInputSchema, type LogsStatusOutput, logsStatusTool, } from "./tools/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACH,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,cAAc,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,9 @@
+/**
+ * MCP server module exports.
+ *
+ * Provides Model Context Protocol interface for log queries.
+ * @module mcp
+ */
+export { createMcpServer, getToolNames, startMcpServer } from "./mcp-server.js";
+export { logsGetRecentHandler, logsGetRecentInputSchema, logsGetRecentTool, logsListSessionsHandler, logsListSessionsInputSchema, logsListSessionsTool, logsStatusHandler, logsStatusInputSchema, logsStatusTool, } from "./tools/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACH,oBAAoB,EAEpB,wBAAwB,EAExB,iBAAiB,EACjB,uBAAuB,EAEvB,2BAA2B,EAE3B,oBAAoB,EACpB,iBAAiB,EAEjB,qBAAqB,EAErB,cAAc,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/mcp/mcp-server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MCP Server for remote logging.
+ *
+ * Provides an MCP interface for Claude Code to query logs from browser
+ * applications. Uses STDIO transport for communication.
+ * @module mcp/mcp-server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LogStorage } from "../server/log-storage.js";
+/**
+ * Get the names of all registered tools.
+ * Useful for testing.
+ * @returns Array of registered tool names
+ */
+export declare function getToolNames(): string[];
+/**
+ * Create an MCP server with logging tools.
+ *
+ * Registers all logging tools and returns the configured server.
+ * The server is not started; use `startMcpServer` to run it.
+ * @param storage - The LogStorage instance to use for log operations
+ * @returns Configured McpServer instance
+ */
+export declare function createMcpServer(storage: LogStorage): McpServer;
+/**
+ * Start the MCP server with STDIO transport.
+ *
+ * This function runs the MCP server and blocks until the connection is closed.
+ * @param storage - The LogStorage instance to use for log operations
+ */
+export declare function startMcpServer(storage: LogStorage): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAyC3D;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAsFD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAkM9D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE"}