@graphty/remote-logger 0.0.1 → 1.2.0

package/dist/server/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Server-side logging utilities.
+ * These are only meant to be run in Node.js, not in the browser.
+ * @module server
+ */
+export { createDualServer, type DualServerOptions, type DualServerResult, } from "./dual-server.js";
+export { type FileStats, type JsonlEntry, JsonlWriter, } from "./jsonl-writer.js";
+export { clearLogs, createLogServer, type CreateLogServerOptions, type CreateLogServerResult, getJsonlWriter, getLogStorage, HELP_TEXT, type LogEntry, type LogServerOptions, main, parseArgs, type ParseArgsResult, setLogStorage, startLogServer, } from "./log-server.js";
+export { type AddLogsOptions, type ClearFilter, type HealthStatus, type LogEntryWithSession, type LogFilter, LogStorage, type LogStorageOptions, type SearchOptions, type ServerConfig, type ServerMode, type ServerStatus, type SessionFilter, type SessionMetadata, } from "./log-storage.js";
+export { extractMarkerFromPath, extractMarkerFromSessionId, type MarkerResolutionOptions, resolveProjectMarker, } from "./marker-utils.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,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,KAAK,SAAS,EACd,KAAK,UAAU,EACf,WAAW,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,SAAS,EACT,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,cAAc,EACd,aAAa,EACb,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,IAAI,EACJ,SAAS,EACT,KAAK,eAAe,EACpB,aAAa,EACb,cAAc,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,oBAAoB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,12 @@
+/**
+ * Server-side logging utilities.
+ * These are only meant to be run in Node.js, not in the browser.
+ * @module server
+ */
+export { createDualServer, } from "./dual-server.js";
+export { JsonlWriter, } from "./jsonl-writer.js";
+export { clearLogs, createLogServer, getJsonlWriter, getLogStorage, HELP_TEXT, main, parseArgs, setLogStorage, startLogServer, } from "./log-server.js";
+export { LogStorage, } from "./log-storage.js";
+export { extractMarkerFromPath, extractMarkerFromSessionId, resolveProjectMarker, } from "./marker-utils.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,gBAAgB,GAGnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGH,WAAW,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,SAAS,EACT,eAAe,EAGf,cAAc,EACd,aAAa,EACb,SAAS,EAGT,IAAI,EACJ,SAAS,EAET,aAAa,EACb,cAAc,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAMH,UAAU,GAQb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,qBAAqB,EACrB,0BAA0B,EAE1B,oBAAoB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAsB,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/server/jsonl-writer.d.ts

@@ -0,0 +1,93 @@
+/**
+ * JSONL file writer for streaming logs to disk.
+ *
+ * Organizes logs by project marker in the temp directory:
+ * {baseDir}/{marker}/logs.jsonl
+ * @module server/jsonl-writer
+ */
+/**
+ * A JSONL log entry.
+ */
+export interface JsonlEntry {
+    /** 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;
+    /** Session ID this log belongs to */
+    sessionId: string;
+    /** Optional additional data */
+    data?: Record<string, unknown>;
+}
+/**
+ * File statistics.
+ */
+export interface FileStats {
+    /** Whether the file exists */
+    exists: boolean;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * JSONL file writer that streams log entries to disk.
+ *
+ * Each project marker gets its own log file in the structure:
+ * {baseDir}/{marker}/logs.jsonl
+ */
+export declare class JsonlWriter {
+    private readonly baseDir;
+    private readonly markerStates;
+    private closed;
+    /**
+     * Create a new JsonlWriter.
+     * @param baseDir - Base directory for log files (e.g., os.tmpdir()/remote-logger)
+     */
+    constructor(baseDir: string);
+    /**
+     * Get the file path for a project marker.
+     * @param projectMarker - The project marker
+     * @returns Full path to the JSONL file
+     */
+    getFilePath(projectMarker: string): string;
+    /**
+     * Get file statistics for a project marker's log file.
+     * @param projectMarker - The project marker
+     * @returns File stats or null if file doesn't exist
+     */
+    getFileStats(projectMarker: string): FileStats | null;
+    /**
+     * Write a log entry to the appropriate file.
+     * @param projectMarker - The project marker
+     * @param entry - The log entry to write
+     * @returns Promise that resolves when the write is queued
+     */
+    write(projectMarker: string, entry: JsonlEntry): Promise<void>;
+    /**
+     * Flush all pending writes to disk.
+     */
+    flush(): Promise<void>;
+    /**
+     * Close all file handles.
+     */
+    close(): Promise<void>;
+    /**
+     * Ensure the marker state exists, creating file if needed.
+     * @param projectMarker - The project marker
+     * @returns The marker state
+     */
+    private ensureMarkerState;
+    /**
+     * Flush the buffer for a marker state.
+     * @param state - The marker state to flush
+     */
+    private flushBuffer;
+    /**
+     * Clean up old project log files based on directory modification time.
+     * Removes entire project directories that haven't been modified within the retention period.
+     * @param retentionDays - Number of days to retain logs
+     * @returns Number of project directories removed
+     */
+    cleanupOldFiles(retentionDays: number): number;
+}
+//# sourceMappingURL=jsonl-writer.d.ts.map

package/dist/server/jsonl-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.d.ts","sourceRoot":"","sources":["../../src/server/jsonl-writer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;GAKG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,OAAO,EAAE,MAAM;IAI3B;;;;OAIG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;OAIG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAcrD;;;;;OAKG;IACH,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAanB;;;;;OAKG;IACH,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAoDjD"}

package/dist/server/jsonl-writer.js

@@ -0,0 +1,205 @@
+/**
+ * JSONL file writer for streaming logs to disk.
+ *
+ * Organizes logs by project marker in the temp directory:
+ * {baseDir}/{marker}/logs.jsonl
+ * @module server/jsonl-writer
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * JSONL file writer that streams log entries to disk.
+ *
+ * Each project marker gets its own log file in the structure:
+ * {baseDir}/{marker}/logs.jsonl
+ */
+export class JsonlWriter {
+    /**
+     * Create a new JsonlWriter.
+     * @param baseDir - Base directory for log files (e.g., os.tmpdir()/remote-logger)
+     */
+    constructor(baseDir) {
+        this.markerStates = new Map();
+        this.closed = false;
+        this.baseDir = baseDir;
+    }
+    /**
+     * Get the file path for a project marker.
+     * @param projectMarker - The project marker
+     * @returns Full path to the JSONL file
+     */
+    getFilePath(projectMarker) {
+        return path.join(this.baseDir, projectMarker, "logs.jsonl");
+    }
+    /**
+     * Get file statistics for a project marker's log file.
+     * @param projectMarker - The project marker
+     * @returns File stats or null if file doesn't exist
+     */
+    getFileStats(projectMarker) {
+        const filePath = this.getFilePath(projectMarker);
+        try {
+            const stats = fs.statSync(filePath);
+            return {
+                exists: true,
+                size: stats.size,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Write a log entry to the appropriate file.
+     * @param projectMarker - The project marker
+     * @param entry - The log entry to write
+     * @returns Promise that resolves when the write is queued
+     */
+    write(projectMarker, entry) {
+        if (this.closed) {
+            return Promise.resolve();
+        }
+        const state = this.ensureMarkerState(projectMarker);
+        const line = `${JSON.stringify(entry)}\n`;
+        // Add to buffer and trigger write
+        state.buffer.push(line);
+        // Chain the write to maintain order
+        state.writeLock = state.writeLock.then(() => {
+            this.flushBuffer(state);
+        });
+        return Promise.resolve();
+    }
+    /**
+     * Flush all pending writes to disk.
+     */
+    async flush() {
+        const flushPromises = [];
+        for (const state of this.markerStates.values()) {
+            // Wait for pending writes and flush buffer
+            flushPromises.push(state.writeLock.then(() => {
+                this.flushBuffer(state);
+            }));
+        }
+        await Promise.all(flushPromises);
+        // Sync all file descriptors
+        for (const state of this.markerStates.values()) {
+            try {
+                fs.fsyncSync(state.fd);
+            }
+            catch {
+                // Ignore sync errors
+            }
+        }
+    }
+    /**
+     * Close all file handles.
+     */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        // Flush all pending writes
+        await this.flush();
+        // Close all file handles
+        for (const state of this.markerStates.values()) {
+            try {
+                fs.closeSync(state.fd);
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+        this.markerStates.clear();
+    }
+    /**
+     * Ensure the marker state exists, creating file if needed.
+     * @param projectMarker - The project marker
+     * @returns The marker state
+     */
+    ensureMarkerState(projectMarker) {
+        let state = this.markerStates.get(projectMarker);
+        if (!state) {
+            const filePath = this.getFilePath(projectMarker);
+            const dir = path.dirname(filePath);
+            // Create directory if it doesn't exist
+            fs.mkdirSync(dir, { recursive: true });
+            // Open file for appending
+            const fd = fs.openSync(filePath, "a");
+            state = {
+                fd,
+                buffer: [],
+                writeLock: Promise.resolve(),
+            };
+            this.markerStates.set(projectMarker, state);
+        }
+        return state;
+    }
+    /**
+     * Flush the buffer for a marker state.
+     * @param state - The marker state to flush
+     */
+    flushBuffer(state) {
+        if (state.buffer.length === 0) {
+            return;
+        }
+        // Take all buffered entries
+        const toWrite = state.buffer.join("");
+        state.buffer = [];
+        // Write to file
+        fs.writeSync(state.fd, toWrite);
+    }
+    /**
+     * Clean up old project log files based on directory modification time.
+     * Removes entire project directories that haven't been modified within the retention period.
+     * @param retentionDays - Number of days to retain logs
+     * @returns Number of project directories removed
+     */
+    cleanupOldFiles(retentionDays) {
+        // Check if base directory exists
+        if (!fs.existsSync(this.baseDir)) {
+            return 0;
+        }
+        const cutoffTime = new Date();
+        cutoffTime.setDate(cutoffTime.getDate() - retentionDays);
+        const cutoffMs = cutoffTime.getTime();
+        let removed = 0;
+        try {
+            const entries = fs.readdirSync(this.baseDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory()) {
+                    continue;
+                }
+                const dirPath = path.join(this.baseDir, entry.name);
+                try {
+                    const stats = fs.statSync(dirPath);
+                    // Check if directory is older than retention period
+                    if (stats.mtimeMs < cutoffMs) {
+                        // Close file handle if we have one open for this marker
+                        const state = this.markerStates.get(entry.name);
+                        if (state) {
+                            try {
+                                fs.closeSync(state.fd);
+                            }
+                            catch {
+                                // Ignore close errors
+                            }
+                            this.markerStates.delete(entry.name);
+                        }
+                        // Remove the directory
+                        fs.rmSync(dirPath, { recursive: true, force: true });
+                        removed++;
+                    }
+                }
+                catch {
+                    // Ignore errors for individual directories
+                }
+            }
+        }
+        catch {
+            // Ignore errors reading base directory
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=jsonl-writer.js.map

package/dist/server/jsonl-writer.js.map

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

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

@@ -0,0 +1,126 @@
+/**
+ * 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";
+import { JsonlWriter } from "./jsonl-writer.js";
+import { LogStorage } from "./log-storage.js";
+/**
+ * Get the shared LogStorage instance, creating it if needed.
+ * Creates a JsonlWriter for JSONL file streaming by default.
+ * @returns The shared LogStorage instance
+ */
+export declare function getLogStorage(): LogStorage;
+/**
+ * Get the shared JsonlWriter instance.
+ * @returns The shared JsonlWriter instance or null if not initialized
+ */
+export declare function getJsonlWriter(): JsonlWriter | null;
+/**
+ * Set the shared LogStorage instance (for testing or external injection).
+ * @param storage - The LogStorage instance to use
+ */
+export declare function setLogStorage(storage: LogStorage): void;
+export interface LogServerOptions {
+    /** Port to listen on (default: 9080) */
+    port?: number;
+    /** Hostname to bind to (default: localhost) */
+    host?: string;
+    /** Path to SSL certificate file (HTTPS only used if both certPath and keyPath provided) */
+    certPath?: string;
+    /** Path to SSL private key file (HTTPS only used if both certPath and keyPath provided) */
+    keyPath?: string;
+    /** Path to file for writing logs (optional) */
+    logFile?: string;
+    /** Start in MCP server mode (default: false) @deprecated Use mcpOnly instead */
+    mcp?: boolean;
+    /** Start only MCP server (no HTTP) */
+    mcpOnly?: boolean;
+    /** Start only HTTP server (no MCP) - legacy mode */
+    httpOnly?: boolean;
+    /** Suppress startup banner (default: false) */
+    quiet?: boolean;
+}
+export type { LogEntry } from "./log-storage.js";
+/**
+ * Clear all stored logs.
+ * Useful for testing.
+ */
+export declare function clearLogs(): void;
+/**
+ * Options for creating a log server without starting it.
+ */
+export interface CreateLogServerOptions {
+    /** Port to listen on */
+    port: number;
+    /** Hostname to bind to */
+    host: string;
+    /** Shared log storage instance */
+    storage: LogStorage;
+    /** Suppress terminal output (default: false) */
+    quiet?: boolean;
+    /** Only serve /log POST and /health GET endpoints (default: false) */
+    logReceiveOnly?: boolean;
+    /** Path to SSL certificate file (HTTPS only used if both certPath and keyPath provided) */
+    certPath?: string;
+    /** Path to SSL private key file (HTTPS only used if both certPath and keyPath provided) */
+    keyPath?: string;
+}
+/**
+ * Result of creating a log server.
+ */
+export interface CreateLogServerResult {
+    /** The HTTP or HTTPS server instance (not yet listening) */
+    server: http.Server | https.Server;
+}
+/**
+ * Create a log server with shared storage.
+ * The server is not started - call server.listen() to start it.
+ * @param options - Server configuration options
+ * @returns The server instance
+ */
+export declare function createLogServer(options: CreateLogServerOptions): CreateLogServerResult;
+/**
+ * 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 (enables HTTPS)\n  --key, -k <path>        Path to SSL private key file (enables HTTPS)\n  --log-file, -l <path>   Write logs to file\n  --mcp-only              Start only MCP server (no HTTP)\n  --http-only             Start only HTTP server (legacy mode)\n  --mcp                   Alias for --mcp-only (deprecated)\n  --quiet, -q             Suppress startup banner\n  --help                  Show this help message\n\nProtocol:\n  HTTP is used by default. To use HTTPS, provide both --cert and --key.\n\nModes:\n  Default (no flags)      Dual mode: HTTP + MCP running together\n  --mcp-only              MCP only: For Claude Code integration\n  --http-only             HTTP only: Legacy mode for browser debugging\n\nExamples:\n  npx remote-log-server                                # Start dual mode (HTTP + MCP)\n  npx remote-log-server --port 9085                    # Custom port\n  npx remote-log-server --mcp-only                     # MCP server only (for Claude Code)\n  npx remote-log-server --http-only                    # HTTP server only (legacy)\n  npx remote-log-server --cert cert.crt --key key.key  # Use HTTPS with custom 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(): Promise<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;AAK/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAiB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ7D;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAU1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEvD;AAkBD,MAAM,WAAW,gBAAgB;IAC7B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAajD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAqRD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,4DAA4D;IAC5D,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAsCtF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAkEzF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,siDAkCrB,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,CAuDzD;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAoG1C"}