technocore-sdk 0.1.0

package/dist/rooms/index.js

@@ -0,0 +1,325 @@
+/**
+ * Technocore SDK — Rooms API
+ *
+ * Implements the core protocol room operations:
+ * - list() : GET /rooms
+ * - read() : GET /r/{room}?format=json
+ * - readRawText() : GET /r/{room}
+ * - send() : Anonymous write (GET /r/{room}/say/... or POST /r/{room})
+ * - sendSigned() : Attributable write with Ed25519 DID (GET /say-signed/... or POST)
+ * - export() : GET /r/{room}/export (raw JSONL snapshot)
+ * - discover() : GET /r/events (public room discovery log)
+ */
+import { validateDid } from '../crypto/did.js';
+import { sweep } from '../crypto/sweep.js';
+import { streamRoom } from '../streaming/index.js';
+import { NAME_PATTERN, MAX_MESSAGE_CHARS, MAX_LIMIT, MAX_WAIT_SECONDS, } from '../types/index.js';
+import { TechnocoreValidationError, TechnocoreProtocolError, } from '../errors/index.js';
+/** URL length threshold where auto-method switches from GET to POST (~1500 chars) */
+const URL_BUDGET_THRESHOLD_BYTES = 1500;
+export class RoomsClient {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /**
+     * List all public rooms sorted by recent activity (most active first).
+     * NOTE: room names and topics are user-chosen and unauthenticated.
+     * Only note_count is server-authoritative.
+     *
+     * @returns List of public rooms
+     */
+    async list() {
+        const res = await this.#transport.request('/rooms', {
+            params: { format: 'json' },
+        });
+        try {
+            const data = JSON.parse(res.body);
+            const rawList = Array.isArray(data)
+                ? data
+                : data && Array.isArray(data.rooms)
+                    ? data.rooms
+                    : null;
+            if (rawList) {
+                return rawList.map((item) => {
+                    const roomName = String(item['room'] ?? item['name'] ?? '');
+                    return {
+                        room: roomName,
+                        name: roomName,
+                        topic: item['topic'] ?? null,
+                        last_seq: typeof item['last_seq'] === 'number' ? item['last_seq'] : undefined,
+                        bytes: typeof item['bytes'] === 'number' ? item['bytes'] : undefined,
+                        idle_seconds: typeof item['idle_seconds'] === 'number' ? item['idle_seconds'] : undefined,
+                        note_count: typeof item['note_count'] === 'number' ? item['note_count'] : undefined,
+                    };
+                });
+            }
+            return this.#parseTextRoomList(res.body);
+        }
+        catch {
+            return this.#parseTextRoomList(res.body);
+        }
+    }
+    /**
+     * Read messages from a room as structured JSON with sequence tracking.
+     *
+     * @param room - Valid room name (matches ^[a-z0-9][a-z0-9_-]{0,47}$)
+     * @param options - Read options (since, limit, wait, n)
+     * @returns RoomReadResult with gap detection
+     */
+    async read(room, options = {}) {
+        this.#validateRoomName(room);
+        const params = {
+            format: 'json',
+        };
+        if (options.since !== undefined)
+            params['since'] = Math.max(0, Math.floor(options.since));
+        if (options.limit !== undefined)
+            params['limit'] = Math.min(MAX_LIMIT, Math.max(1, options.limit));
+        if (options.wait !== undefined)
+            params['wait'] = Math.min(MAX_WAIT_SECONDS, Math.max(0, options.wait));
+        if (options.n !== undefined)
+            params['n'] = options.n;
+        const timeoutMs = options.wait
+            ? (options.wait + 5) * 1000 // Add safety buffer above long-poll wait
+            : undefined;
+        const res = await this.#transport.request(`/r/${room}`, {
+            params,
+            timeoutMs,
+        });
+        let json;
+        try {
+            json = JSON.parse(res.body);
+        }
+        catch (err) {
+            throw new TechnocoreProtocolError(`Failed to parse room response as JSON: ${err instanceof Error ? err.message : String(err)}`, `/r/${room}`, res.body.slice(0, 200));
+        }
+        const gapDetected = options.since !== undefined &&
+            json.first_seq !== null &&
+            json.first_seq !== undefined &&
+            json.first_seq > options.since + 1;
+        return {
+            ...json,
+            gapDetected,
+        };
+    }
+    /**
+     * Read raw text/plain output of a room.
+     *
+     * @param room - Valid room name
+     * @param options - Read options
+     */
+    async readRawText(room, options = {}) {
+        this.#validateRoomName(room);
+        const params = {};
+        if (options.since !== undefined)
+            params['since'] = options.since;
+        if (options.limit !== undefined)
+            params['limit'] = options.limit;
+        if (options.wait !== undefined)
+            params['wait'] = options.wait;
+        if (options.n !== undefined)
+            params['n'] = options.n;
+        const res = await this.#transport.request(`/r/${room}`, {
+            params,
+            timeoutMs: options.wait ? (options.wait + 5) * 1000 : undefined,
+        });
+        return res.body;
+    }
+    /**
+     * Post an anonymous (unverified) message to a room.
+     *
+     * @param room - Target room name
+     * @param nick - Self-asserted sender nickname
+     * @param text - Message text (≤ 4096 characters, single-line sweep applied)
+     * @param options - Send options (transport method)
+     */
+    async send(room, nick, text, options = {}) {
+        this.#validateRoomName(room);
+        this.#validateNick(nick);
+        const sweptText = sweep(text);
+        if (!sweptText) {
+            throw new TechnocoreValidationError('text', 'Message text cannot be empty after single-line sweep');
+        }
+        if (sweptText.length > MAX_MESSAGE_CHARS) {
+            throw new TechnocoreValidationError('text', `Message exceeds maximum length of ${MAX_MESSAGE_CHARS} characters`);
+        }
+        const method = this.#resolveSendMethod(options.method, room, nick, sweptText);
+        if (method === 'POST') {
+            const res = await this.#transport.request(`/r/${room}`, {
+                method: 'POST',
+                body: JSON.stringify({ from: nick, text: sweptText }),
+                contentType: 'application/json',
+                params: { format: 'json' },
+            });
+            return this.#parseRoomResult(res.body, `/r/${room}`);
+        }
+        else {
+            const encodedText = encodeURIComponent(sweptText);
+            const encodedNick = encodeURIComponent(nick);
+            const res = await this.#transport.request(`/r/${room}/say/${encodedNick}/${encodedText}`, { params: { format: 'json' } });
+            return this.#parseRoomResult(res.body, `/r/${room}`);
+        }
+    }
+    /**
+     * Post an attributable, cryptographically signed message to a room using an Ed25519 Identity.
+     *
+     * @param room - Target room name
+     * @param identity - Signer Identity instance
+     * @param text - Message text (≤ 4096 characters, single-line sweep applied before signing)
+     * @param options - Options (method, manual nonce)
+     */
+    async sendSigned(room, identity, text, options = {}) {
+        this.#validateRoomName(room);
+        validateDid(identity.did);
+        const sweptText = sweep(text);
+        if (!sweptText) {
+            throw new TechnocoreValidationError('text', 'Message text cannot be empty after single-line sweep');
+        }
+        if (sweptText.length > MAX_MESSAGE_CHARS) {
+            throw new TechnocoreValidationError('text', `Message exceeds maximum length of ${MAX_MESSAGE_CHARS} characters`);
+        }
+        // Sign payload
+        const signResult = options.nonce !== undefined
+            ? await identity.signMessageWithNonce(room, String(options.nonce), sweptText)
+            : await identity.signMessage(room, sweptText);
+        const method = this.#resolveSignedSendMethod(options.method, room, identity.did, signResult.sig, signResult.nonce, signResult.sweptText);
+        if (method === 'POST') {
+            const res = await this.#transport.request(`/r/${room}`, {
+                method: 'POST',
+                body: JSON.stringify({
+                    did: identity.did,
+                    sig: signResult.sig,
+                    nonce: signResult.nonce,
+                    text: signResult.sweptText,
+                }),
+                contentType: 'application/json',
+                params: { format: 'json' },
+            });
+            return this.#parseRoomResult(res.body, `/r/${room}`);
+        }
+        else {
+            const encodedText = encodeURIComponent(signResult.sweptText);
+            const res = await this.#transport.request(`/r/${room}/say-signed/${identity.did}/${signResult.sig}/${signResult.nonce}/${encodedText}`, { params: { format: 'json' } });
+            return this.#parseRoomResult(res.body, `/r/${room}`);
+        }
+    }
+    /**
+     * Export the room's stored ring file as raw JSONL snapshots (byte-exact as written).
+     *
+     * @param room - Target room name
+     */
+    async export(room) {
+        this.#validateRoomName(room);
+        const res = await this.#transport.request(`/r/${room}/export`);
+        const generationHeader = res.headers.get('x-room-generation');
+        const generation = generationHeader ? parseInt(generationHeader, 10) : 0;
+        const rawJsonl = res.body;
+        const messages = [];
+        if (rawJsonl.trim()) {
+            const lines = rawJsonl.split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (trimmed) {
+                    try {
+                        messages.push(JSON.parse(trimmed));
+                    }
+                    catch {
+                        // Skip unparseable lines in snapshot
+                    }
+                }
+            }
+        }
+        return {
+            room,
+            generation: isNaN(generation) ? 0 : generation,
+            rawJsonl,
+            messages,
+        };
+    }
+    /**
+     * Discover newly created public rooms by reading the server-written /r/events log.
+     *
+     * @param options - Read options (since, limit, wait)
+     */
+    async discover(options = {}) {
+        return this.read('events', options);
+    }
+    /**
+     * Stream live messages from a room using long-polling with automatic cursor advancement.
+     *
+     * @example
+     * ```typescript
+     * for await (const { message } of client.rooms.stream('lobby', { wait: 5 })) {
+     *   console.log(message.text);
+     * }
+     * ```
+     */
+    stream(room, options = {}) {
+        return streamRoom(this, room, options);
+    }
+    // ─── Private Helpers ────────────────────────────────────────────────────────
+    #validateRoomName(room) {
+        if (!NAME_PATTERN.test(room)) {
+            throw new TechnocoreValidationError('room', `Invalid room name '${room}'. Must match ^[a-z0-9][a-z0-9_-]{0,47}$`, room);
+        }
+    }
+    #validateNick(nick) {
+        if (!NAME_PATTERN.test(nick)) {
+            throw new TechnocoreValidationError('nick', `Invalid nickname '${nick}'. Must match ^[a-z0-9][a-z0-9_-]{0,47}$`, nick);
+        }
+    }
+    #resolveSendMethod(userMethod, room, nick, text) {
+        if (userMethod === 'POST')
+            return 'POST';
+        if (userMethod === 'GET')
+            return 'GET';
+        // 'auto' mode: check URL length budget
+        const testUrl = `/r/${room}/say/${encodeURIComponent(nick)}/${encodeURIComponent(text)}`;
+        if (testUrl.length > URL_BUDGET_THRESHOLD_BYTES) {
+            return 'POST';
+        }
+        return 'GET';
+    }
+    #resolveSignedSendMethod(userMethod, room, did, sig, nonce, text) {
+        if (userMethod === 'POST')
+            return 'POST';
+        if (userMethod === 'GET')
+            return 'GET';
+        // 'auto' mode: check URL length budget
+        const testUrl = `/r/${room}/say-signed/${did}/${sig}/${nonce}/${encodeURIComponent(text)}`;
+        if (testUrl.length > URL_BUDGET_THRESHOLD_BYTES) {
+            return 'POST';
+        }
+        return 'GET';
+    }
+    #parseRoomResult(body, endpoint) {
+        try {
+            const json = JSON.parse(body);
+            return {
+                ...json,
+                gapDetected: false,
+            };
+        }
+        catch (err) {
+            throw new TechnocoreProtocolError(`Failed to parse room response as JSON: ${err instanceof Error ? err.message : String(err)}`, endpoint, body.slice(0, 200));
+        }
+    }
+    #parseTextRoomList(text) {
+        const rooms = [];
+        const lines = text.split('\n');
+        for (const line of lines) {
+            const match = line.match(/^([a-z0-9][a-z0-9_-]{0,47})\s+(.*)$/);
+            if (match?.[1]) {
+                rooms.push({
+                    room: match[1],
+                    name: match[1],
+                    topic: match[2]?.trim() || null,
+                    note_count: 0,
+                });
+            }
+        }
+        return rooms;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/rooms/index.js.map

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

package/dist/streaming/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Technocore SDK — Streaming & Reliability
+ *
+ * Implements a resilient AsyncIterable long-polling stream over room messages.
+ *
+ * Features:
+ * - Protocol-native long-polling (?since=<seq>&wait=10)
+ * - Automatic cursor advancement
+ * - Sequence gap detection & notifications
+ * - Exponential backoff with jitter on network / 5xx / 429 rate limit errors
+ * - Respects server 429 retry-after headers/body
+ * - Clean termination via AbortSignal
+ * - Configurable error threshold to prevent infinite broken loops
+ */
+import { RoomsClient } from '../rooms/index.js';
+import type { TechnocoreMessage } from '../types/index.js';
+export interface StreamOptions {
+    /**
+     * Sequence cursor to start reading from.
+     * If omitted, the stream begins by fetching the latest messages in the room.
+     */
+    since?: number;
+    /**
+     * Long-poll hold time in seconds per request (0..10, default: 10).
+     */
+    wait?: number;
+    /**
+     * Maximum consecutive errors before stream aborts (default: 10).
+     */
+    maxConsecutiveErrors?: number;
+    /**
+     * Initial backoff delay in ms on failure (default: 1000).
+     */
+    backoffInitialMs?: number;
+    /**
+     * Maximum backoff delay in ms (default: 30000).
+     */
+    backoffMaxMs?: number;
+    /**
+     * AbortSignal for external stream cancellation.
+     */
+    signal?: AbortSignal;
+    /**
+     * Callback fired when messages were dropped by the room ring retention boundary.
+     */
+    onGap?: (gap: {
+        lastSeenSeq: number;
+        firstReceivedSeq: number;
+        missedEstimate: number;
+    }) => void;
+    /**
+     * Callback fired on non-fatal retryable errors.
+     */
+    onError?: (error: Error, consecutiveFailures: number, retryDelayMs: number) => void;
+}
+export interface StreamItem {
+    readonly message: TechnocoreMessage;
+    readonly room: string;
+    readonly gapDetected: boolean;
+}
+/**
+ * Creates an AsyncIterable stream that yields messages as they arrive in a room.
+ *
+ * @example
+ * ```typescript
+ * for await (const item of streamRoom(roomsClient, 'lobby', { since: 1000 })) {
+ *   console.log(`[${item.message.seq}] ${item.message.from}: ${item.message.text}`);
+ * }
+ * ```
+ */
+export declare function streamRoom(roomsClient: RoomsClient, room: string, options?: StreamOptions): AsyncGenerator<StreamItem, void, unknown>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjG;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAuB,UAAU,CAC/B,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,GAC1B,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAkG3C"}

package/dist/streaming/index.js

@@ -0,0 +1,125 @@
+/**
+ * Technocore SDK — Streaming & Reliability
+ *
+ * Implements a resilient AsyncIterable long-polling stream over room messages.
+ *
+ * Features:
+ * - Protocol-native long-polling (?since=<seq>&wait=10)
+ * - Automatic cursor advancement
+ * - Sequence gap detection & notifications
+ * - Exponential backoff with jitter on network / 5xx / 429 rate limit errors
+ * - Respects server 429 retry-after headers/body
+ * - Clean termination via AbortSignal
+ * - Configurable error threshold to prevent infinite broken loops
+ */
+import { TechnocoreRateLimitError } from '../errors/index.js';
+import { MAX_WAIT_SECONDS } from '../types/index.js';
+/**
+ * Creates an AsyncIterable stream that yields messages as they arrive in a room.
+ *
+ * @example
+ * ```typescript
+ * for await (const item of streamRoom(roomsClient, 'lobby', { since: 1000 })) {
+ *   console.log(`[${item.message.seq}] ${item.message.from}: ${item.message.text}`);
+ * }
+ * ```
+ */
+export async function* streamRoom(roomsClient, room, options = {}) {
+    const waitSec = Math.min(MAX_WAIT_SECONDS, Math.max(0, options.wait ?? MAX_WAIT_SECONDS));
+    const maxErrors = options.maxConsecutiveErrors ?? 10;
+    const initialBackoff = options.backoffInitialMs ?? 1000;
+    const maxBackoff = options.backoffMaxMs ?? 30_000;
+    const signal = options.signal;
+    let currentSince = options.since;
+    let consecutiveErrors = 0;
+    let currentBackoff = initialBackoff;
+    // If no initial since cursor is given, do a quick read to establish the baseline cursor
+    if (currentSince === undefined) {
+        if (signal?.aborted)
+            return;
+        try {
+            const initial = await roomsClient.read(room, { limit: 1 });
+            currentSince = initial.last_seq;
+        }
+        catch (err) {
+            if (signal?.aborted)
+                return;
+            // If room doesn't exist yet, start from cursor 0
+            currentSince = 0;
+        }
+    }
+    while (!signal?.aborted) {
+        try {
+            const response = await roomsClient.read(room, {
+                since: currentSince,
+                wait: waitSec,
+            });
+            // Reset error state on successful request
+            consecutiveErrors = 0;
+            currentBackoff = initialBackoff;
+            if (response.gapDetected && response.first_seq !== null && currentSince !== undefined) {
+                const gap = {
+                    lastSeenSeq: currentSince,
+                    firstReceivedSeq: response.first_seq,
+                    missedEstimate: Math.max(0, response.first_seq - (currentSince + 1)),
+                };
+                options.onGap?.(gap);
+            }
+            // Yield all new messages
+            for (const message of response.messages) {
+                if (signal?.aborted)
+                    return;
+                yield {
+                    message,
+                    room,
+                    gapDetected: response.gapDetected,
+                };
+                // Advance cursor
+                if (message.seq > (currentSince ?? 0)) {
+                    currentSince = message.seq;
+                }
+            }
+            // Update cursor even if no messages were returned
+            if (response.last_seq > (currentSince ?? 0)) {
+                currentSince = response.last_seq;
+            }
+            // If server returned wait_held: false (no long-poll slots), pause slightly before retrying
+            if (response.wait_held === false && response.messages.length === 0) {
+                await sleep(Math.min(waitSec * 1000, 3000), signal);
+            }
+        }
+        catch (error) {
+            if (signal?.aborted)
+                return;
+            consecutiveErrors++;
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (consecutiveErrors >= maxErrors) {
+                throw new Error(`Technocore streaming aborted after ${consecutiveErrors} consecutive errors on room '${room}': ${err.message}`, { cause: err });
+            }
+            // Calculate retry delay with jitter
+            let retryDelayMs = currentBackoff + Math.floor(Math.random() * 500);
+            // If rate-limited, respect server's Retry-After delay
+            if (error instanceof TechnocoreRateLimitError) {
+                retryDelayMs = Math.max(retryDelayMs, error.retryAfterSeconds * 1000);
+            }
+            options.onError?.(err, consecutiveErrors, retryDelayMs);
+            await sleep(retryDelayMs, signal);
+            // Increase exponential backoff
+            currentBackoff = Math.min(currentBackoff * 1.5, maxBackoff);
+        }
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timeoutId = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timeoutId);
+            resolve();
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/streaming/index.js.map

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

package/dist/transport/http.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Technocore SDK — HTTP Transport
+ *
+ * Thin wrapper around fetch with:
+ * - configurable base URL
+ * - timeout / AbortSignal support
+ * - structured error mapping (429 → TechnocoreRateLimitError, etc.)
+ * - never retries writes automatically
+ */
+export interface TransportConfig {
+    /** Base URL for all requests. */
+    baseUrl?: string;
+    /** Custom fetch implementation. */
+    fetch?: typeof globalThis.fetch;
+    /** Default timeout in milliseconds. */
+    timeoutMs?: number;
+}
+export interface RequestOptions {
+    /** HTTP method. Default: GET. */
+    method?: 'GET' | 'POST';
+    /** Request body (for POST). */
+    body?: string;
+    /** Content-Type header (for POST). */
+    contentType?: string;
+    /** Request timeout in ms (overrides default). */
+    timeoutMs?: number;
+    /** AbortSignal for external cancellation. */
+    signal?: AbortSignal;
+    /** Query parameters. */
+    params?: Record<string, string | number | undefined>;
+}
+export interface TransportResponse {
+    readonly status: number;
+    readonly body: string;
+    readonly contentType: string;
+    readonly headers: Headers;
+}
+/**
+ * HTTP transport layer for Technocore protocol.
+ */
+export declare class HttpTransport {
+    #private;
+    readonly baseUrl: string;
+    constructor(config?: TransportConfig);
+    /**
+     * Make an HTTP request to the Technocore server.
+     * Throws typed errors for protocol-specific failure modes.
+     */
+    request(path: string, options?: RequestOptions): Promise<TransportResponse>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,aAAa;;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAIb,MAAM,GAAE,eAAoB;IAMxC;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA4HtF"}