@graphty/remote-logger 0.0.1 → 1.1.1

package/dist/client/RemoteLogClient.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 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 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;AAoBpF;;;;;;;;;;;;;;;;;;;;;;;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;IAErD,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;IAS3C;;;;;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;IAiBzB;;;;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,238 @@
+/**
+ * Browser client for sending log messages to a remote server.
+ * Provides batching and automatic retry with exponential backoff.
+ * @module client/RemoteLogClient
+ */
+/** 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 ?? [];
+    }
+    /**
+     * 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 response = await fetch(`${this.serverUrl}/log`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                sessionId: this.sessionId,
+                logs,
+            }),
+        });
+        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":"AAAA;;;;GAIG;AAIH,mCAAmC;AACnC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AACvC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEzC;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,MAAc;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,eAAe;IAkBxB;;;OAGG;IACH,YAAY,OAA+B;QAZnC,gBAAW,GAAe,EAAE,CAAC;QAC7B,eAAU,GAAyC,IAAI,CAAC;QACxD,aAAQ,GAAG,KAAK,CAAC;QACjB,iBAAY,GAAyB,IAAI,CAAC;QAElD,iEAAiE;QACzD,sBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAOlD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC,CAAC;QACpF,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;QAC5E,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC;QACnE,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,OAAe;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAEtD,IAAI,GAAG,GAAG,QAAQ,GAAG,UAAU,EAAE,CAAC;oBAC9B,4CAA4C;oBAC5C,OAAO,IAAI,CAAC;gBAChB,CAAC;gBAED,8DAA8D;gBAC9D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACrC,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QAED,qCAAqC;QACrC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,IAA8B;QAC9D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QAED,2CAA2C;QAC3C,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO;QACX,CAAC;QAED,MAAM,KAAK,GAAa;YACpB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9B,KAAK;YACL,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;SACtC,CAAC;QAEF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACrB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5C,OAAO;QACX,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,SAAS;QACnB,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;QACX,CAAC;QAED,oDAAoD;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QAEtB,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa,CAAC,IAAgB;QACxC,IAAI,SAAS,GAAiB,IAAI,CAAC;QAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC7B,OAAO,CAAC,WAAW;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtE,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;oBAC5B,yCAAyC;oBACzC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBACvD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;YACL,CAAC;QACL,CAAC;QAED,wDAAwD;QACxD,+DAA+D;QAC/D,OAAO,CAAC,KAAK,CAAC,sDAAsD,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,WAAW,CAAC,IAAgB;QACtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,MAAM,EAAE;YAClD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;aACrC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI;aACP,CAAC;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,EAAU;QACpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACP,6BAA6B;QAC7B,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,iCAAiC;QACjC,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,YAAY,CAAC;QAC5B,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,YAAY,CAAC;YACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC7B,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACP,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,uBAAuB;QACvB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACJ;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACjE,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

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,47 @@
+/**
+ * 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[];
+}
+//# 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;CACxC"}

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/server/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Server-side logging utilities.
+ * These are only meant to be run in Node.js, not in the browser.
+ * @module server
+ */
+export { clearLogs, HELP_TEXT, type LogEntry, type LogServerOptions, main, parseArgs, type ParseArgsResult, startLogServer, } from "./log-server.js";
+export { certFilesExist, type GeneratedCert, generateSelfSignedCert, readCertFiles } from "./self-signed-cert.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,SAAS,EACT,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,IAAI,EACJ,SAAS,EACT,KAAK,eAAe,EACpB,cAAc,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,8 @@
+/**
+ * Server-side logging utilities.
+ * These are only meant to be run in Node.js, not in the browser.
+ * @module server
+ */
+export { clearLogs, HELP_TEXT, main, parseArgs, startLogServer, } from "./log-server.js";
+export { certFilesExist, generateSelfSignedCert, readCertFiles } from "./self-signed-cert.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,SAAS,EACT,SAAS,EAGT,IAAI,EACJ,SAAS,EAET,cAAc,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAsB,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,75 @@
+/**
+ * Remote Log Server - A standalone HTTP/HTTPS log server for remote debugging.
+ *
+ * Features:
+ * - HTTPS with auto-generated self-signed certs or custom certs
+ * - Receives logs from browser via POST /log
+ * - Pretty terminal output with colors
+ * - REST API for querying logs
+ * - Optional file logging for Claude Code to read
+ *
+ * Usage:
+ *   npx remote-log-server --port 9080
+ *   npx remote-log-server --cert /path/to/cert.crt --key /path/to/key.key
+ */
+import * as http from "http";
+import * as https from "https";
+export interface LogServerOptions {
+    /** Port to listen on (default: 9080) */
+    port?: number;
+    /** Hostname to bind to (default: localhost) */
+    host?: string;
+    /** Path to SSL certificate file */
+    certPath?: string;
+    /** Path to SSL private key file */
+    keyPath?: string;
+    /** Path to file for writing logs (optional) */
+    logFile?: string;
+    /** Use HTTP instead of HTTPS (default: false) */
+    useHttp?: boolean;
+    /** Suppress startup banner (default: false) */
+    quiet?: boolean;
+}
+export interface LogEntry {
+    time: string;
+    level: string;
+    message: string;
+}
+/**
+ * Clear all stored logs.
+ * Useful for testing.
+ */
+export declare function clearLogs(): void;
+/**
+ * Start the log server.
+ * @param options - Server configuration options
+ * @returns The HTTP or HTTPS server instance
+ */
+export declare function startLogServer(options?: LogServerOptions): http.Server | https.Server;
+/**
+ * Help text displayed when --help is passed.
+ */
+export declare const HELP_TEXT = "\nRemote Log Server - Remote logging for browser debugging\n\nUsage:\n  npx remote-log-server [options]\n  npx @graphty/remote-logger [options]\n\nOptions:\n  --port, -p <port>       Port to listen on (default: 9080)\n  --host, -h <host>       Hostname to bind to (default: localhost)\n  --cert, -c <path>       Path to SSL certificate file\n  --key, -k <path>        Path to SSL private key file\n  --log-file, -l <path>   Write logs to file\n  --http                  Use HTTP instead of HTTPS\n  --quiet, -q             Suppress startup banner\n  --help                  Show this help message\n\nExamples:\n  npx remote-log-server                           # Start with defaults (port 9080, self-signed cert)\n  npx remote-log-server --port 9085               # Custom port\n  npx remote-log-server --http                    # Use HTTP instead of HTTPS\n  npx remote-log-server --cert cert.crt --key key.key  # Custom SSL certs\n  npx remote-log-server --log-file ./tmp/logs.jsonl    # Also write to file\n";
+/**
+ * Result of parsing command line arguments.
+ */
+export interface ParseArgsResult {
+    /** Parsed options for the log server */
+    options: LogServerOptions;
+    /** Whether --help was requested */
+    showHelp: boolean;
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Parse command line arguments into LogServerOptions.
+ * This is separated from main() to enable testing.
+ * @param args - Array of command line arguments (excluding node and script name)
+ * @returns ParseArgsResult with options, help flag, or error
+ */
+export declare function parseArgs(args: string[]): ParseArgsResult;
+/**
+ * Parse command line arguments and start the server.
+ */
+export declare function main(): void;
+//# sourceMappingURL=log-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log-server.d.ts","sourceRoot":"","sources":["../../src/server/log-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B,MAAM,WAAW,gBAAgB;IAC7B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AAaD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAqSD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CA6EzF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,u/BAuBrB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,wCAAwC;IACxC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAgDzD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAgB3B"}