@zpl-toolchain/print 0.1.2

package/dist/proxy.d.ts

@@ -0,0 +1,57 @@
+import type { Server } from "node:http";
+import type { ProxyConfig } from "./types.js";
+export type { ProxyConfig } from "./types.js";
+/**
+ * Create and start an HTTP and WebSocket print proxy server.
+ *
+ * The proxy accepts JSON POST requests and forwards them to printers over
+ * TCP port 9100. This enables browser-based applications to print without
+ * requiring the Zebra Browser Print agent.
+ *
+ * ## Endpoints
+ *
+ * ### `POST /print`
+ * Send ZPL to a printer.
+ * ```json
+ * { "printer": "192.168.1.100", "zpl": "^XA^FDHello^FS^XZ" }
+ * ```
+ *
+ * ### `POST /status`
+ * Query a printer's status.
+ * ```json
+ * { "printer": "192.168.1.100" }
+ * ```
+ *
+ * ### `GET /health`
+ * Returns `{ "ok": true }`.
+ *
+ * ### WebSocket (`ws://host:port`)
+ * Accepts JSON messages with a `type` field (`"print"` or `"status"`).
+ * ```json
+ * { "type": "print", "printer": "192.168.1.100", "zpl": "^XA^FDHello^FS^XZ" }
+ * ```
+ * Responses are JSON with an `ok` field:
+ * ```json
+ * { "ok": true, "success": true, "bytesWritten": 42, "duration": 12 }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createPrintProxy } from "@zpl-toolchain/print/proxy";
+ *
+ * const { server, close } = await createPrintProxy({
+ *   port: 3001,
+ *   allowedPrinters: ["192.168.1.100", "192.168.1.101"],
+ * });
+ *
+ * console.log("Proxy listening on port 3001");
+ *
+ * // Shut down later
+ * await close();
+ * ```
+ */
+export declare function createPrintProxy(config?: ProxyConfig): Promise<{
+    server: Server;
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAyH9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAiSzD"}

package/dist/proxy.js

@@ -0,0 +1,404 @@
+import { createServer } from "node:http";
+import { WebSocketServer } from "ws";
+import { print, tcpQuery } from "./index.js";
+import { parseHostStatus } from "./status.js";
+// ─── Defaults ────────────────────────────────────────────────────────────────
+const DEFAULT_PROXY_PORT = 3001;
+const DEFAULT_HOSTNAME = "127.0.0.1";
+const DEFAULT_MAX_PAYLOAD = 1024 * 1024; // 1 MiB
+const DEFAULT_CORS = "*";
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function readBody(req, maxSize, timeoutMs = 30_000) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let settled = false;
+        const fail = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(err);
+        };
+        const succeed = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(value);
+        };
+        // Guard against slow-loris: reject if body isn't received within the deadline.
+        const timer = setTimeout(() => {
+            req.removeAllListeners("data");
+            req.resume();
+            fail(new Error("Body read timed out"));
+        }, timeoutMs);
+        req.on("data", (chunk) => {
+            size += chunk.length;
+            if (size > maxSize) {
+                // Don't destroy the socket — the response still needs to be written
+                // (e.g., 413). Just stop collecting data and signal the error.
+                req.removeAllListeners("data");
+                req.resume(); // drain remaining body data
+                fail(new Error(`Payload exceeds maximum size of ${maxSize} bytes`));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => {
+            succeed(Buffer.concat(chunks).toString("utf-8"));
+        });
+        req.on("error", fail);
+    });
+}
+function jsonResponse(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(payload),
+    });
+    res.end(payload);
+}
+function isPrinterAllowed(printer, compiledList) {
+    if (compiledList.length === 0)
+        return false;
+    return compiledList.some(({ pattern, regex }) => {
+        if (regex)
+            return regex.test(printer);
+        return pattern === printer;
+    });
+}
+function isPortAllowed(port, allowedPorts) {
+    return allowedPorts.includes(port);
+}
+function setCorsHeaders(res, cors, origin) {
+    if (cors === "*") {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+    }
+    else if (Array.isArray(cors)) {
+        if (origin && cors.includes(origin)) {
+            res.setHeader("Access-Control-Allow-Origin", origin);
+            res.setHeader("Vary", "Origin");
+        }
+    }
+    else if (typeof cors === "string" && origin && cors === origin) {
+        res.setHeader("Access-Control-Allow-Origin", origin);
+        res.setHeader("Vary", "Origin");
+    }
+    res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+    res.setHeader("Access-Control-Max-Age", "86400");
+}
+/** Send JSON to a WebSocket only if the connection is still open. */
+function wsSend(ws, data) {
+    if (ws.readyState === 1 /* OPEN */) {
+        ws.send(JSON.stringify(data));
+    }
+}
+// ─── Proxy server ────────────────────────────────────────────────────────────
+/**
+ * Create and start an HTTP and WebSocket print proxy server.
+ *
+ * The proxy accepts JSON POST requests and forwards them to printers over
+ * TCP port 9100. This enables browser-based applications to print without
+ * requiring the Zebra Browser Print agent.
+ *
+ * ## Endpoints
+ *
+ * ### `POST /print`
+ * Send ZPL to a printer.
+ * ```json
+ * { "printer": "192.168.1.100", "zpl": "^XA^FDHello^FS^XZ" }
+ * ```
+ *
+ * ### `POST /status`
+ * Query a printer's status.
+ * ```json
+ * { "printer": "192.168.1.100" }
+ * ```
+ *
+ * ### `GET /health`
+ * Returns `{ "ok": true }`.
+ *
+ * ### WebSocket (`ws://host:port`)
+ * Accepts JSON messages with a `type` field (`"print"` or `"status"`).
+ * ```json
+ * { "type": "print", "printer": "192.168.1.100", "zpl": "^XA^FDHello^FS^XZ" }
+ * ```
+ * Responses are JSON with an `ok` field:
+ * ```json
+ * { "ok": true, "success": true, "bytesWritten": 42, "duration": 12 }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createPrintProxy } from "@zpl-toolchain/print/proxy";
+ *
+ * const { server, close } = await createPrintProxy({
+ *   port: 3001,
+ *   allowedPrinters: ["192.168.1.100", "192.168.1.101"],
+ * });
+ *
+ * console.log("Proxy listening on port 3001");
+ *
+ * // Shut down later
+ * await close();
+ * ```
+ */
+export async function createPrintProxy(config = {}) {
+    const port = config.port ?? DEFAULT_PROXY_PORT;
+    const hostname = config.hostname ?? DEFAULT_HOSTNAME;
+    const maxPayload = config.maxPayloadSize ?? DEFAULT_MAX_PAYLOAD;
+    const cors = config.cors ?? DEFAULT_CORS;
+    const allowed = config.allowedPrinters;
+    const allowedPorts = config.allowedPorts ?? [9100];
+    const maxConnections = config.maxConnections ?? 50;
+    // Pre-compile glob patterns into regexes once at startup.
+    const compiledAllowlist = (allowed ?? []).map((pattern) => {
+        if (!pattern.includes("*"))
+            return { pattern };
+        // Bare "*" is a special case meaning "match all" (including dotted IPs/hostnames).
+        if (pattern === "*")
+            return { pattern, regex: /^.*$/ };
+        const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+        const regex = new RegExp("^" + escaped.replace(/\*/g, "[^.]*") + "$");
+        return { pattern, regex };
+    });
+    const server = createServer(async (req, res) => {
+        const origin = req.headers.origin;
+        setCorsHeaders(res, cors, origin);
+        // Handle CORS preflight.
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // ── GET /health ────────────────────────────────────────────────────
+        if (req.method === "GET" && req.url === "/health") {
+            jsonResponse(res, 200, { ok: true });
+            return;
+        }
+        // Only POST from here on.
+        if (req.method !== "POST") {
+            jsonResponse(res, 405, { error: "Method not allowed" });
+            return;
+        }
+        // Fail fast on unknown routes before reading body.
+        if (req.url !== "/print" && req.url !== "/status") {
+            jsonResponse(res, 404, { error: "Not found" });
+            return;
+        }
+        try {
+            const contentType = req.headers["content-type"] ?? "";
+            if (!contentType.toLowerCase().includes("application/json")) {
+                jsonResponse(res, 415, {
+                    error: "Content-Type must be application/json",
+                });
+                return;
+            }
+            const body = await readBody(req, maxPayload);
+            let parsed;
+            try {
+                parsed = JSON.parse(body);
+            }
+            catch {
+                jsonResponse(res, 400, { error: "Invalid JSON" });
+                return;
+            }
+            // ── POST /print ──────────────────────────────────────────────────
+            if (req.url === "/print") {
+                const printer = parsed.printer;
+                const zpl = parsed.zpl;
+                if (typeof printer !== "string" || !printer) {
+                    jsonResponse(res, 400, { error: 'Missing required field "printer"' });
+                    return;
+                }
+                if (typeof zpl !== "string" || !zpl) {
+                    jsonResponse(res, 400, { error: 'Missing required field "zpl"' });
+                    return;
+                }
+                if (!isPrinterAllowed(printer, compiledAllowlist)) {
+                    jsonResponse(res, 403, {
+                        error: `Printer "${printer}" is not in the allowed list`,
+                    });
+                    return;
+                }
+                const reqPort = typeof parsed.port === "number" ? parsed.port : 9100;
+                if (!Number.isInteger(reqPort) || reqPort < 1 || reqPort > 65535) {
+                    jsonResponse(res, 400, { error: "Port must be an integer between 1 and 65535" });
+                    return;
+                }
+                if (!isPortAllowed(reqPort, allowedPorts)) {
+                    jsonResponse(res, 403, { error: `Port ${reqPort} is not in the allowed list` });
+                    return;
+                }
+                const result = await print(zpl, {
+                    host: printer,
+                    port: reqPort,
+                    timeout: typeof parsed.timeout === "number" ? Math.max(1000, Math.min(parsed.timeout, 60000)) : 5000,
+                });
+                jsonResponse(res, 200, result);
+                return;
+            }
+            // ── POST /status ─────────────────────────────────────────────────
+            if (req.url === "/status") {
+                const printer = parsed.printer;
+                if (typeof printer !== "string" || !printer) {
+                    jsonResponse(res, 400, { error: 'Missing required field "printer"' });
+                    return;
+                }
+                if (!isPrinterAllowed(printer, compiledAllowlist)) {
+                    jsonResponse(res, 403, {
+                        error: `Printer "${printer}" is not in the allowed list`,
+                    });
+                    return;
+                }
+                const printerPort = typeof parsed.port === "number" ? parsed.port : 9100;
+                if (!Number.isInteger(printerPort) || printerPort < 1 || printerPort > 65535) {
+                    jsonResponse(res, 400, { error: "Port must be an integer between 1 and 65535" });
+                    return;
+                }
+                if (!isPortAllowed(printerPort, allowedPorts)) {
+                    jsonResponse(res, 403, { error: `Port ${printerPort} is not in the allowed list` });
+                    return;
+                }
+                const timeout = typeof parsed.timeout === "number" ? Math.max(1000, Math.min(parsed.timeout, 60000)) : 5000;
+                const raw = await tcpQuery(printer, printerPort, "~HS", timeout);
+                const status = parseHostStatus(raw);
+                jsonResponse(res, 200, status);
+                return;
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isPayloadError = message.includes("Payload exceeds maximum size");
+            const isBodyTimeout = message.includes("Body read timed out");
+            const status = isPayloadError ? 413 : isBodyTimeout ? 408 : 502;
+            // Sanitize: don't leak internal IPs/ports from TCP errors to clients.
+            const clientMessage = isPayloadError || isBodyTimeout
+                ? message
+                : "Failed to communicate with printer";
+            jsonResponse(res, status, { error: clientMessage });
+        }
+    });
+    // ── WebSocket upgrade endpoint ──────────────────────────────────────────
+    const wss = new WebSocketServer({
+        server,
+        maxPayload,
+        verifyClient: (info, cb) => {
+            if (wss.clients.size >= maxConnections) {
+                cb(false, 503, "Too many connections");
+                return;
+            }
+            const originAllowed = cors === "*" ||
+                (Array.isArray(cors) ? cors.includes(info.origin) : cors === info.origin);
+            if (!originAllowed) {
+                cb(false, 403, "Origin not allowed");
+                return;
+            }
+            cb(true);
+        },
+    });
+    wss.on("connection", (ws) => {
+        let alive = true;
+        ws.on("pong", () => { alive = true; });
+        const heartbeat = setInterval(() => {
+            if (!alive) {
+                ws.terminate();
+                return;
+            }
+            alive = false;
+            ws.ping();
+        }, 30_000);
+        ws.on("close", () => clearInterval(heartbeat));
+        ws.on("error", () => {
+            // Swallow per-connection errors to prevent process crash.
+            // The connection will be cleaned up by the "close" event.
+        });
+        ws.on("message", (raw) => {
+            void (async () => {
+                let parsed;
+                try {
+                    const text = typeof raw === "string" ? raw : raw.toString("utf-8");
+                    parsed = JSON.parse(text);
+                }
+                catch {
+                    wsSend(ws, { ok: false, error: "Invalid JSON" });
+                    return;
+                }
+                const msgType = parsed.type;
+                if (typeof msgType !== "string" || !["print", "status"].includes(msgType)) {
+                    wsSend(ws, { ok: false, error: 'Missing or invalid "type" field (expected "print" or "status")' });
+                    return;
+                }
+                const printer = parsed.printer;
+                if (typeof printer !== "string" || !printer) {
+                    wsSend(ws, { ok: false, error: 'Missing required field "printer"' });
+                    return;
+                }
+                if (!isPrinterAllowed(printer, compiledAllowlist)) {
+                    wsSend(ws, { ok: false, error: `Printer "${printer}" is not in the allowed list` });
+                    return;
+                }
+                const reqPort = typeof parsed.port === "number" ? parsed.port : 9100;
+                if (!Number.isInteger(reqPort) || reqPort < 1 || reqPort > 65535) {
+                    wsSend(ws, { ok: false, error: "Port must be an integer between 1 and 65535" });
+                    return;
+                }
+                if (!isPortAllowed(reqPort, allowedPorts)) {
+                    wsSend(ws, { ok: false, error: `Port ${reqPort} is not in the allowed list` });
+                    return;
+                }
+                const timeout = typeof parsed.timeout === "number"
+                    ? Math.max(1000, Math.min(parsed.timeout, 60000))
+                    : 5000;
+                try {
+                    if (msgType === "print") {
+                        const zpl = parsed.zpl;
+                        if (typeof zpl !== "string" || !zpl) {
+                            wsSend(ws, { ok: false, error: 'Missing required field "zpl"' });
+                            return;
+                        }
+                        const result = await print(zpl, { host: printer, port: reqPort, timeout });
+                        wsSend(ws, { ok: true, ...result });
+                    }
+                    else {
+                        // status
+                        const rawResp = await tcpQuery(printer, reqPort, "~HS", timeout);
+                        const status = parseHostStatus(rawResp);
+                        wsSend(ws, { ok: true, ...status });
+                    }
+                }
+                catch (err) {
+                    // Sanitize: don't leak internal IPs/ports from TCP errors.
+                    wsSend(ws, { ok: false, error: "Failed to communicate with printer" });
+                }
+            })().catch((err) => {
+                // Shouldn't happen — inner handler has its own try/catch.
+                if (typeof console !== "undefined")
+                    console.error("[print-proxy] Unhandled error:", err);
+            });
+        });
+    });
+    // Cap total connections (HTTP + WebSocket combined) at the OS level.
+    server.maxConnections = maxConnections;
+    return new Promise((resolve, reject) => {
+        server.on("error", reject);
+        server.listen(port, hostname, () => {
+            server.removeListener("error", reject);
+            resolve({
+                server,
+                close: () => new Promise((res, rej) => {
+                    // Close all WebSocket connections first
+                    for (const client of wss.clients) {
+                        client.terminate();
+                    }
+                    wss.close(() => {
+                        server.close((err) => (err ? rej(err) : res()));
+                    });
+                }),
+            });
+        });
+    });
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,14 @@
+import type { PrinterStatus } from "./types.js";
+/**
+ * Parse a raw ~HS (Host Status) response string into a structured
+ * {@link PrinterStatus} object.
+ *
+ * The parser is lenient: it returns sensible defaults for fields it cannot
+ * extract, so callers never need to worry about partial / malformed responses
+ * in the field.
+ *
+ * @param raw - The full ~HS response as received from the printer socket.
+ * @returns A {@link PrinterStatus} with boolean flags and remaining-label count.
+ */
+export declare function parseHostStatus(raw: string): PrinterStatus;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqChD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CA4E1D"}

package/dist/status.js

@@ -0,0 +1,108 @@
+// ─── ~HS Response Parser ─────────────────────────────────────────────────────
+//
+// The Zebra ~HS (Host Status) command returns three lines of comma-separated
+// fields framed with STX (\x02) and ETX (\x03).
+//
+//   Line 1  (prefix \x02): communication / paper / head flags
+//   Line 2  (prefix \x02): function settings
+//   Line 3  (prefix \x02): miscellaneous
+//
+// Each line is delimited by CR/LF and wrapped in STX…ETX.
+// Reference: ZPL II Programming Guide, chapter "Host Status Return".
+// ─────────────────────────────────────────────────────────────────────────────
+const STX = "\x02";
+const ETX = "\x03";
+/**
+ * Strip STX / ETX framing characters and split the response into its three
+ * comma-separated field arrays.
+ */
+function splitHsLines(raw) {
+    // Remove STX/ETX framing, normalise line endings, trim.
+    const cleaned = raw
+        .replaceAll(STX, "")
+        .replaceAll(ETX, "")
+        .replace(/\r\n?/g, "\n")
+        .trim();
+    const lines = cleaned.split("\n").filter((l) => l.trim().length > 0);
+    return lines.map((line) => line.split(",").map((f) => f.trim()));
+}
+/**
+ * Parse a raw ~HS (Host Status) response string into a structured
+ * {@link PrinterStatus} object.
+ *
+ * The parser is lenient: it returns sensible defaults for fields it cannot
+ * extract, so callers never need to worry about partial / malformed responses
+ * in the field.
+ *
+ * @param raw - The full ~HS response as received from the printer socket.
+ * @returns A {@link PrinterStatus} with boolean flags and remaining-label count.
+ */
+export function parseHostStatus(raw) {
+    const lines = splitHsLines(raw);
+    const line1 = lines[0] ?? [];
+    const line2 = lines[1] ?? [];
+    const line3 = lines[2] ?? [];
+    const flag = (fields, idx) => (fields[idx] ?? "0") !== "0";
+    const int = (fields, idx) => {
+        const n = parseInt(fields[idx] ?? "", 10);
+        return Number.isNaN(n) ? 0 : n;
+    };
+    // ── Line 1 (12 fields) ────────────────────────────────────────────
+    const communicationFlag = int(line1, 0);
+    const paperOut = flag(line1, 1);
+    const paused = flag(line1, 2);
+    const labelLengthDots = int(line1, 3);
+    const formatsInBuffer = int(line1, 4);
+    const bufferFull = flag(line1, 5);
+    const commDiagMode = flag(line1, 6);
+    const partialFormat = flag(line1, 7);
+    const reserved1 = int(line1, 8);
+    const corruptRam = flag(line1, 9);
+    const underTemperature = flag(line1, 10);
+    const overTemperature = flag(line1, 11);
+    // ── Line 2 (10 fields) ────────────────────────────────────────────
+    const functionSettings = int(line2, 0);
+    const headOpen = flag(line2, 1);
+    const ribbonOut = flag(line2, 2);
+    const thermalTransferMode = flag(line2, 3);
+    const printMode = int(line2, 4);
+    const printWidthMode = int(line2, 5);
+    const labelWaiting = flag(line2, 6);
+    const labelsRemaining = int(line2, 7);
+    const formatWhilePrinting = int(line2, 8);
+    const graphicsStoredInMemory = int(line2, 9);
+    // ── Line 3 (2 fields) ─────────────────────────────────────────────
+    const password = int(line3, 0);
+    const staticRamInstalled = flag(line3, 1);
+    // "ready" = not paused, head closed, media loaded.
+    const ready = !paused && !headOpen && !paperOut;
+    return {
+        ready,
+        communicationFlag,
+        paperOut,
+        paused,
+        labelLengthDots,
+        formatsInBuffer,
+        bufferFull,
+        commDiagMode,
+        partialFormat,
+        reserved1,
+        corruptRam,
+        underTemperature,
+        overTemperature,
+        functionSettings,
+        headOpen,
+        ribbonOut,
+        thermalTransferMode,
+        printMode,
+        printWidthMode,
+        labelWaiting,
+        labelsRemaining,
+        formatWhilePrinting,
+        graphicsStoredInMemory,
+        password,
+        staticRamInstalled,
+        raw,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,gDAAgD;AAChD,EAAE;AACF,8DAA8D;AAC9D,6CAA6C;AAC7C,yCAAyC;AACzC,EAAE;AACF,0DAA0D;AAC1D,qEAAqE;AACrE,gFAAgF;AAEhF,MAAM,GAAG,GAAG,MAAM,CAAC;AACnB,MAAM,GAAG,GAAG,MAAM,CAAC;AAEnB;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,wDAAwD;IACxD,MAAM,OAAO,GAAG,GAAG;SAChB,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;SACnB,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,IAAI,EAAE,CAAC;IAEV,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,CAAC,MAAgB,EAAE,GAAW,EAAW,EAAE,CACtD,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC;IAE/B,MAAM,GAAG,GAAG,CAAC,MAAgB,EAAE,GAAW,EAAU,EAAE;QACpD,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,qEAAqE;IACrE,MAAM,iBAAiB,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,eAAe,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,eAAe,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExC,qEAAqE;IACrE,MAAM,gBAAgB,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,eAAe,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,mBAAmB,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,sBAAsB,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE7C,qEAAqE;IACrE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE1C,mDAAmD;IACnD,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC;IAEhD,OAAO;QACL,KAAK;QACL,iBAAiB;QACjB,QAAQ;QACR,MAAM;QACN,eAAe;QACf,eAAe;QACf,UAAU;QACV,YAAY;QACZ,aAAa;QACb,SAAS;QACT,UAAU;QACV,gBAAgB;QAChB,eAAe;QACf,gBAAgB;QAChB,QAAQ;QACR,SAAS;QACT,mBAAmB;QACnB,SAAS;QACT,cAAc;QACd,YAAY;QACZ,eAAe;QACf,mBAAmB;QACnB,sBAAsB;QACtB,QAAQ;QACR,kBAAkB;QAClB,GAAG;KACJ,CAAC;AACJ,CAAC"}