@nac3/forge-cli 0.2.0-alpha.1

package/dist/lan/mdns_packet.js

@@ -0,0 +1,247 @@
+/**
+ * Minimal mDNS / DNS-over-UDP packet primitives (RFC 6762).
+ *
+ * Forge announces a `_yujin-forge._tcp.local.` service on the
+ * LAN so mobile + sibling laptops can discover the local brain
+ * with zero configuration.
+ *
+ * Scope kept small: we encode/decode the record types we
+ * actually use -- PTR (service browse), SRV (host:port), TXT
+ * (free-form metadata), A (IPv4). Name compression is NOT
+ * applied on encode (waste bytes, simpler code), but IS
+ * accepted on decode (the spec requires it).
+ *
+ * ASCII-only.
+ */
+/* DNS record types. */
+export const TYPE_A = 1;
+export const TYPE_PTR = 12;
+export const TYPE_TXT = 16;
+export const TYPE_SRV = 33;
+export const TYPE_ANY = 255;
+export const CLASS_IN = 1;
+/* RFC 6762 - cache flush bit set on responses we own. */
+export const CLASS_IN_FLUSH = 0x8001;
+export function isPtr(d) {
+    return typeof d.ptr === 'string';
+}
+export function isSrv(d) {
+    return typeof d.port === 'number';
+}
+export function isTxt(d) {
+    return Array.isArray(d.txt);
+}
+export function isA(d) {
+    return typeof d.ip === 'string';
+}
+/* ----- encoding ----- */
+function encodeName(name) {
+    const labels = name.replace(/\.$/, '').split('.');
+    const chunks = [];
+    for (const label of labels) {
+        if (label.length === 0)
+            continue;
+        if (label.length > 63)
+            throw new Error('mDNS: label exceeds 63 chars: ' + label);
+        const buf = Buffer.alloc(1 + label.length);
+        buf.writeUInt8(label.length, 0);
+        buf.write(label, 1, 'utf8');
+        chunks.push(buf);
+    }
+    chunks.push(Buffer.from([0]));
+    return Buffer.concat(chunks);
+}
+export function encodeQuestion(q) {
+    const n = encodeName(q.name);
+    const tail = Buffer.alloc(4);
+    tail.writeUInt16BE(q.type, 0);
+    tail.writeUInt16BE(q.klass, 2);
+    return Buffer.concat([n, tail]);
+}
+function encodeRdata(answer) {
+    if (answer.type === TYPE_PTR && isPtr(answer.data)) {
+        return encodeName(answer.data.ptr);
+    }
+    if (answer.type === TYPE_TXT && isTxt(answer.data)) {
+        const chunks = [];
+        for (const item of answer.data.txt) {
+            if (item.length > 255)
+                throw new Error('mDNS: TXT segment exceeds 255 chars');
+            const buf = Buffer.alloc(1 + item.length);
+            buf.writeUInt8(item.length, 0);
+            buf.write(item, 1, 'utf8');
+            chunks.push(buf);
+        }
+        return Buffer.concat(chunks);
+    }
+    if (answer.type === TYPE_SRV && isSrv(answer.data)) {
+        const head = Buffer.alloc(6);
+        head.writeUInt16BE(answer.data.priority, 0);
+        head.writeUInt16BE(answer.data.weight, 2);
+        head.writeUInt16BE(answer.data.port, 4);
+        return Buffer.concat([head, encodeName(answer.data.target)]);
+    }
+    if (answer.type === TYPE_A && isA(answer.data)) {
+        const parts = answer.data.ip.split('.').map((s) => Number.parseInt(s, 10));
+        if (parts.length !== 4 || parts.some((n) => !Number.isFinite(n) || n < 0 || n > 255)) {
+            throw new Error('mDNS: invalid IPv4: ' + answer.data.ip);
+        }
+        return Buffer.from(parts);
+    }
+    if (answer.data instanceof Buffer)
+        return answer.data;
+    throw new Error('mDNS: cannot encode record type ' + answer.type);
+}
+export function encodeAnswer(a) {
+    const n = encodeName(a.name);
+    const rdata = encodeRdata(a);
+    const head = Buffer.alloc(10);
+    head.writeUInt16BE(a.type, 0);
+    head.writeUInt16BE(a.klass, 2);
+    head.writeUInt32BE(a.ttl, 4);
+    head.writeUInt16BE(rdata.length, 8);
+    return Buffer.concat([n, head, rdata]);
+}
+export function encodePacket(pkt) {
+    const head = Buffer.alloc(12);
+    head.writeUInt16BE(pkt.header.id, 0);
+    head.writeUInt16BE(pkt.header.flags, 2);
+    head.writeUInt16BE(pkt.questions.length, 4);
+    head.writeUInt16BE(pkt.answers.length, 6);
+    head.writeUInt16BE(pkt.authorities.length, 8);
+    head.writeUInt16BE(pkt.additionals.length, 10);
+    const parts = [head];
+    for (const q of pkt.questions)
+        parts.push(encodeQuestion(q));
+    for (const a of pkt.answers)
+        parts.push(encodeAnswer(a));
+    for (const a of pkt.authorities)
+        parts.push(encodeAnswer(a));
+    for (const a of pkt.additionals)
+        parts.push(encodeAnswer(a));
+    return Buffer.concat(parts);
+}
+function readName(c) {
+    const labels = [];
+    let pos = c.pos;
+    let jumped = false;
+    let safety = 256; /* anti-loop on malformed compression */
+    while (safety-- > 0) {
+        if (pos >= c.buf.length)
+            throw new Error('mDNS: name truncated');
+        const len = c.buf[pos];
+        if (len === 0) {
+            pos += 1;
+            break;
+        }
+        if ((len & 0xc0) === 0xc0) {
+            if (pos + 1 >= c.buf.length)
+                throw new Error('mDNS: compressed name truncated');
+            const ptr = ((len & 0x3f) << 8) | c.buf[pos + 1];
+            if (!jumped)
+                c.pos = pos + 2;
+            pos = ptr;
+            jumped = true;
+            continue;
+        }
+        if (len > 63)
+            throw new Error('mDNS: invalid label length ' + len);
+        labels.push(c.buf.slice(pos + 1, pos + 1 + len).toString('utf8'));
+        pos += 1 + len;
+    }
+    if (!jumped)
+        c.pos = pos;
+    return labels.join('.');
+}
+function readUint16(c) {
+    if (c.pos + 2 > c.buf.length)
+        throw new Error('mDNS: uint16 truncated');
+    const v = c.buf.readUInt16BE(c.pos);
+    c.pos += 2;
+    return v;
+}
+function readUint32(c) {
+    if (c.pos + 4 > c.buf.length)
+        throw new Error('mDNS: uint32 truncated');
+    const v = c.buf.readUInt32BE(c.pos);
+    c.pos += 4;
+    return v;
+}
+function readRdata(type, c, rdataLen) {
+    const end = c.pos + rdataLen;
+    if (type === TYPE_PTR) {
+        const ptr = readName(c);
+        c.pos = end;
+        return { ptr };
+    }
+    if (type === TYPE_TXT) {
+        const txt = [];
+        while (c.pos < end) {
+            const len = c.buf[c.pos];
+            c.pos += 1;
+            txt.push(c.buf.slice(c.pos, c.pos + len).toString('utf8'));
+            c.pos += len;
+        }
+        return { txt };
+    }
+    if (type === TYPE_SRV) {
+        const priority = readUint16(c);
+        const weight = readUint16(c);
+        const port = readUint16(c);
+        const target = readName(c);
+        c.pos = end;
+        return { priority, weight, port, target };
+    }
+    if (type === TYPE_A) {
+        if (rdataLen !== 4)
+            throw new Error('mDNS: A record rdata must be 4 bytes');
+        const ip = [c.buf[c.pos], c.buf[c.pos + 1], c.buf[c.pos + 2], c.buf[c.pos + 3]].join('.');
+        c.pos = end;
+        return { ip };
+    }
+    /* Unknown -- return the raw buffer. */
+    const raw = c.buf.slice(c.pos, end);
+    c.pos = end;
+    return raw;
+}
+function readAnswer(c) {
+    const name = readName(c);
+    const type = readUint16(c);
+    const klass = readUint16(c);
+    const ttl = readUint32(c);
+    const len = readUint16(c);
+    const data = readRdata(type, c, len);
+    return { name, type, klass, ttl, data };
+}
+export function decodePacket(buf) {
+    const c = { buf, pos: 0 };
+    if (buf.length < 12)
+        throw new Error('mDNS: packet < 12 bytes');
+    const header = {
+        id: buf.readUInt16BE(0),
+        flags: buf.readUInt16BE(2),
+        qdCount: buf.readUInt16BE(4),
+        anCount: buf.readUInt16BE(6),
+        nsCount: buf.readUInt16BE(8),
+        arCount: buf.readUInt16BE(10),
+    };
+    c.pos = 12;
+    const questions = [];
+    for (let i = 0; i < header.qdCount; i++) {
+        const name = readName(c);
+        const type = readUint16(c);
+        const klass = readUint16(c);
+        questions.push({ name, type, klass });
+    }
+    const answers = [];
+    for (let i = 0; i < header.anCount; i++)
+        answers.push(readAnswer(c));
+    const authorities = [];
+    for (let i = 0; i < header.nsCount; i++)
+        authorities.push(readAnswer(c));
+    const additionals = [];
+    for (let i = 0; i < header.arCount; i++)
+        additionals.push(readAnswer(c));
+    return { header, questions, answers, authorities, additionals };
+}
+//# sourceMappingURL=mdns_packet.js.map

package/dist/lan/mdns_packet.js.map

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

package/dist/lan/mdns_service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * mDNS service announce + browse for `_yujin-forge._tcp.local.`.
+ *
+ * Forge laptop side: announceService spins up a UDP socket bound
+ * to multicast group 224.0.0.251 / port 5353 + joins the
+ * multicast group + listens for PTR queries against the Forge
+ * service name. On match it responds with PTR + SRV + TXT + A
+ * records.
+ *
+ * Mobile / sibling laptop side: browseServices fires a PTR
+ * query + collects matching SRV/TXT/A records into a typed
+ * Discovery object for `forgeCallerTimeout` ms.
+ *
+ * Both halves are framework-agnostic -- they accept any object
+ * satisfying the SocketLike interface so unit tests can drive
+ * them without touching the network.
+ *
+ * ASCII-only.
+ */
+import { type DnsAnswer } from './mdns_packet.js';
+export declare const MDNS_PORT = 5353;
+export declare const MDNS_GROUP_IPV4 = "224.0.0.251";
+export declare const SERVICE_TYPE = "_yujin-forge._tcp.local.";
+export interface ServiceConfig {
+    /** Instance name, e.g. "pablos-laptop". */
+    instanceName: string;
+    /** Hostname for the A record, e.g. "pablos-laptop.local.". */
+    hostName: string;
+    /** Service port (Forge chat panel port, default 4847). */
+    port: number;
+    /** IPv4 to advertise in the A record. */
+    ipv4: string;
+    /** TXT key=value entries (URL slug, panel build, etc). */
+    txt?: Record<string, string>;
+    /** TTL in seconds (default 120). */
+    ttl?: number;
+}
+export interface SocketLike {
+    on(event: 'message', cb: (msg: Buffer, rinfo: {
+        address: string;
+        port: number;
+    }) => void): void;
+    on(event: 'error', cb: (err: Error) => void): void;
+    send(msg: Buffer, port: number, address: string, cb?: (err: Error | null) => void): void;
+    close(cb?: () => void): void;
+}
+/** Build the PTR/SRV/TXT/A answer set for a query against the
+ *  service type. Used by the announce path. */
+export declare function buildAnnounceAnswers(cfg: ServiceConfig): DnsAnswer[];
+/** Build the unsolicited announcement packet (sent at startup
+ *  per RFC 6762 sec. 8: send the answer set as if responding to
+ *  a query for the service type). */
+export declare function buildUnsolicitedAnnouncement(cfg: ServiceConfig): Buffer;
+/** Build a PTR query for the service type. Used by browse. */
+export declare function buildBrowseQuery(): Buffer;
+/** True if the inbound message is a PTR query targeting our
+ *  service type. */
+export declare function isQueryForOurService(rawMessage: Buffer): boolean;
+/** Build the response we send back when isQueryForOurService
+ *  is true. Same shape as the unsolicited announcement plus an
+ *  echoed question. */
+export declare function buildQueryResponse(cfg: ServiceConfig): Buffer;
+export interface Discovery {
+    instance: string;
+    host: string;
+    port: number;
+    ipv4: string | null;
+    txt: Record<string, string>;
+}
+/** Merge a response packet into the rolling discovery map.
+ *  Keyed by the instance label so multiple announces from the
+ *  same host collapse into one record. */
+export declare function ingestResponse(raw: Buffer, current: Map<string, Discovery>): Map<string, Discovery>;
+/** High-level browse loop: open a socket, fire the PTR query,
+ *  ingest responses for `timeoutMs`, resolve to the discovery
+ *  map. Caller supplies the socket + clock so tests can drive
+ *  this synchronously. */
+export interface BrowseOpts {
+    socket: SocketLike;
+    timeoutMs: number;
+    setTimeoutImpl?: typeof setTimeout;
+    multicast?: {
+        address: string;
+        port: number;
+    };
+}
+export declare function browseServices(opts: BrowseOpts): Promise<Discovery[]>;
+/** Bind a passive announcer: listen for queries against our
+ *  service type + respond. Caller is responsible for setting
+ *  up the multicast socket + invoking close() on shutdown. */
+export interface AnnounceOpts {
+    socket: SocketLike;
+    cfg: ServiceConfig;
+    multicast?: {
+        address: string;
+        port: number;
+    };
+}
+export declare function attachAnnouncer(opts: AnnounceOpts): {
+    unsolicited: Buffer;
+};
+//# sourceMappingURL=mdns_service.d.ts.map

package/dist/lan/mdns_service.d.ts.map

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

package/dist/lan/mdns_service.js

@@ -0,0 +1,206 @@
+/**
+ * mDNS service announce + browse for `_yujin-forge._tcp.local.`.
+ *
+ * Forge laptop side: announceService spins up a UDP socket bound
+ * to multicast group 224.0.0.251 / port 5353 + joins the
+ * multicast group + listens for PTR queries against the Forge
+ * service name. On match it responds with PTR + SRV + TXT + A
+ * records.
+ *
+ * Mobile / sibling laptop side: browseServices fires a PTR
+ * query + collects matching SRV/TXT/A records into a typed
+ * Discovery object for `forgeCallerTimeout` ms.
+ *
+ * Both halves are framework-agnostic -- they accept any object
+ * satisfying the SocketLike interface so unit tests can drive
+ * them without touching the network.
+ *
+ * ASCII-only.
+ */
+import { encodePacket, decodePacket, TYPE_PTR, TYPE_SRV, TYPE_TXT, TYPE_A, CLASS_IN, CLASS_IN_FLUSH, isPtr, isSrv, isTxt, isA, } from './mdns_packet.js';
+export const MDNS_PORT = 5353;
+export const MDNS_GROUP_IPV4 = '224.0.0.251';
+export const SERVICE_TYPE = '_yujin-forge._tcp.local.';
+/** Names from the wire come back without trailing dot. Strip
+ *  on both sides before comparing. */
+function nameMatches(a, b) {
+    return a.replace(/\.$/, '') === b.replace(/\.$/, '');
+}
+function fullInstanceName(cfg) {
+    return cfg.instanceName + '.' + SERVICE_TYPE;
+}
+function txtPayload(txt) {
+    if (!txt)
+        return [];
+    const out = [];
+    for (const [k, v] of Object.entries(txt))
+        out.push(k + '=' + v);
+    return out;
+}
+/** Build the PTR/SRV/TXT/A answer set for a query against the
+ *  service type. Used by the announce path. */
+export function buildAnnounceAnswers(cfg) {
+    const ttl = cfg.ttl ?? 120;
+    const instance = fullInstanceName(cfg);
+    return [
+        {
+            name: SERVICE_TYPE, type: TYPE_PTR, klass: CLASS_IN, ttl,
+            data: { ptr: instance },
+        },
+        {
+            name: instance, type: TYPE_SRV, klass: CLASS_IN_FLUSH, ttl,
+            data: { priority: 0, weight: 0, port: cfg.port, target: cfg.hostName },
+        },
+        {
+            name: instance, type: TYPE_TXT, klass: CLASS_IN_FLUSH, ttl,
+            data: { txt: txtPayload(cfg.txt) },
+        },
+        {
+            name: cfg.hostName, type: TYPE_A, klass: CLASS_IN_FLUSH, ttl,
+            data: { ip: cfg.ipv4 },
+        },
+    ];
+}
+/** Build the unsolicited announcement packet (sent at startup
+ *  per RFC 6762 sec. 8: send the answer set as if responding to
+ *  a query for the service type). */
+export function buildUnsolicitedAnnouncement(cfg) {
+    return encodePacket({
+        header: {
+            id: 0,
+            /* QR=1 (response), AA=1. */
+            flags: 0x8400,
+            qdCount: 0,
+            anCount: 4, nsCount: 0, arCount: 0,
+        },
+        questions: [],
+        answers: buildAnnounceAnswers(cfg),
+        authorities: [], additionals: [],
+    });
+}
+/** Build a PTR query for the service type. Used by browse. */
+export function buildBrowseQuery() {
+    return encodePacket({
+        header: { id: 0, flags: 0, qdCount: 1, anCount: 0, nsCount: 0, arCount: 0 },
+        questions: [{ name: SERVICE_TYPE, type: TYPE_PTR, klass: CLASS_IN }],
+        answers: [], authorities: [], additionals: [],
+    });
+}
+/** True if the inbound message is a PTR query targeting our
+ *  service type. */
+export function isQueryForOurService(rawMessage) {
+    let pkt;
+    try {
+        pkt = decodePacket(rawMessage);
+    }
+    catch {
+        return false;
+    }
+    if (pkt.header.qdCount === 0)
+        return false;
+    for (const q of pkt.questions) {
+        if (!nameMatches(q.name, SERVICE_TYPE))
+            continue;
+        if (q.type !== TYPE_PTR && q.type !== 0xff /* ANY */)
+            continue;
+        return true;
+    }
+    return false;
+}
+/** Build the response we send back when isQueryForOurService
+ *  is true. Same shape as the unsolicited announcement plus an
+ *  echoed question. */
+export function buildQueryResponse(cfg) {
+    return encodePacket({
+        header: {
+            id: 0, flags: 0x8400,
+            qdCount: 0,
+            anCount: 4, nsCount: 0, arCount: 0,
+        },
+        questions: [],
+        answers: buildAnnounceAnswers(cfg),
+        authorities: [], additionals: [],
+    });
+}
+/** Merge a response packet into the rolling discovery map.
+ *  Keyed by the instance label so multiple announces from the
+ *  same host collapse into one record. */
+export function ingestResponse(raw, current) {
+    let pkt;
+    try {
+        pkt = decodePacket(raw);
+    }
+    catch {
+        return current;
+    }
+    /* Walk answers + additionals as one. */
+    const records = [...pkt.answers, ...pkt.additionals];
+    /* Step 1: collect PTRs into the map skeleton. */
+    for (const r of records) {
+        if (r.type === TYPE_PTR && isPtr(r.data) && nameMatches(r.name, SERVICE_TYPE)) {
+            const instance = r.data.ptr.split('.')[0];
+            if (!current.has(instance)) {
+                current.set(instance, {
+                    instance, host: '', port: 0, ipv4: null, txt: {},
+                });
+            }
+        }
+    }
+    /* Step 2: fill SRV/TXT/A. We bind by name = `${instance}.${SERVICE_TYPE}`. */
+    for (const r of records) {
+        const labels = r.name.split('.');
+        const instance = labels[0];
+        const d = current.get(instance);
+        if (!d)
+            continue;
+        if (r.type === TYPE_SRV && isSrv(r.data)) {
+            d.port = r.data.port;
+            d.host = r.data.target;
+        }
+        else if (r.type === TYPE_TXT && isTxt(r.data)) {
+            for (const entry of r.data.txt) {
+                const eq = entry.indexOf('=');
+                if (eq < 0)
+                    continue;
+                d.txt[entry.slice(0, eq)] = entry.slice(eq + 1);
+            }
+        }
+        else if (r.type === TYPE_A && isA(r.data)) {
+            d.ipv4 = r.data.ip;
+        }
+    }
+    return current;
+}
+export function browseServices(opts) {
+    const target = opts.multicast ?? { address: MDNS_GROUP_IPV4, port: MDNS_PORT };
+    const discoveries = new Map();
+    return new Promise((resolve) => {
+        opts.socket.on('message', (msg) => { ingestResponse(msg, discoveries); });
+        opts.socket.send(buildBrowseQuery(), target.port, target.address);
+        const t = (opts.setTimeoutImpl ?? setTimeout)(() => {
+            opts.socket.close();
+            /* Drop incomplete records (missing port -- no SRV arrived). */
+            const out = [];
+            for (const d of discoveries.values()) {
+                if (d.port > 0)
+                    out.push(d);
+            }
+            resolve(out);
+        }, opts.timeoutMs);
+        /* setTimeout returns a handle; avoid blocking process exit. */
+        if (typeof t.unref === 'function') {
+            t.unref();
+        }
+    });
+}
+export function attachAnnouncer(opts) {
+    const target = opts.multicast ?? { address: MDNS_GROUP_IPV4, port: MDNS_PORT };
+    opts.socket.on('message', (msg) => {
+        if (!isQueryForOurService(msg))
+            return;
+        const response = buildQueryResponse(opts.cfg);
+        opts.socket.send(response, target.port, target.address);
+    });
+    return { unsolicited: buildUnsolicitedAnnouncement(opts.cfg) };
+}
+//# sourceMappingURL=mdns_service.js.map

package/dist/lan/mdns_service.js.map

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

package/dist/license/activate.d.ts

@@ -0,0 +1,33 @@
+import type { SeatToken } from './types.js';
+export interface ParsedJwt {
+    header: Record<string, unknown>;
+    payload: Record<string, unknown>;
+    raw: string;
+}
+export declare class InvalidLicenseKeyError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a JWT without verifying the signature. Throws
+ * InvalidLicenseKeyError on any shape error so the caller can
+ * print a precise hint instead of a stack trace.
+ */
+export declare function parseJwt(raw: string): ParsedJwt;
+export interface ActivateResult {
+    seat: SeatToken;
+    path: string;
+}
+/**
+ * Activate a license key on this machine. Writes
+ * ~/.yujin-forge/license.json after extracting the relevant claims.
+ *
+ * Throws InvalidLicenseKeyError on shape / freshness errors.
+ * Throws plain Error on filesystem issues.
+ */
+export declare function activate(rawKey: string): Promise<ActivateResult>;
+/**
+ * Remove the local license cache. Returns true if a file was
+ * deleted, false if no license was installed.
+ */
+export declare function revoke(): Promise<boolean>;
+//# sourceMappingURL=activate.d.ts.map

package/dist/license/activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../src/license/activate.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,EAAM,MAAM,CAAC;CACjB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CA0B/C;AAYD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAsCtE;AAED;;;GAGG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAS/C"}