@c9up/ream 0.1.3

package/dist/http/Request.js

@@ -0,0 +1,484 @@
+/**
+ * Request — wraps raw HTTP request data from the NAPI layer.
+ *
+ * Provides a fluent, AdonisJS-compatible API for reading request data.
+ * JSON body parsing is lazy — deferred until first access via input()/all()/body().
+ *
+ * @implements FR21
+ */
+export class Request {
+    #raw;
+    #params;
+    #parsedBody;
+    #parsedQs;
+    #merged;
+    #files = new Map();
+    /**
+     * CSRF token for this request (AdonisJS idiom: `request.csrfToken`). Seeded
+     * by the `@c9up/blackhole` middleware when CSRF is enabled; `undefined`
+     * otherwise. Also published to `ctx.store` for templating helpers.
+     */
+    csrfToken;
+    constructor(raw, params = {}) {
+        this.#raw = raw;
+        this.#params = params;
+    }
+    // ─── HTTP accessors ───────────────────────────────────────
+    /** HTTP method (GET, POST, etc.). */
+    method() {
+        return this.#raw.method;
+    }
+    /** Request URL (path + query string). */
+    url(includeQs = true) {
+        if (includeQs && this.#raw.query) {
+            return `${this.#raw.path}?${this.#raw.query}`;
+        }
+        return this.#raw.path;
+    }
+    /** Request path (without query string). */
+    path() {
+        return this.#raw.path;
+    }
+    /**
+     * Resolved client IP. The HyperServer computes this once per request from
+     * the socket peer + `X-Forwarded-For` / `X-Real-IP` headers, gated by the
+     * configured trusted-proxy CIDR list, and ships the resolved value on
+     * `request.ip`. JS reads that field as-is.
+     *
+     * When `#raw.ip` is missing — only happens in test fixtures that
+     * hand-build `RawRequest` without going through the Rust pipeline — fall
+     * back to the socket peer (`remoteAddr`). Do NOT consult `X-Forwarded-For`
+     * or `X-Real-IP` here: those headers are attacker-controlled on direct
+     * requests and the trusted-proxy gate lives in Rust. Honouring them in
+     * the TS fallback would let test fixtures masking real spoofing
+     * regressions (two semantics for the same API). Fixtures that need to
+     * simulate a proxy-resolved IP must set `#raw.ip` directly to the
+     * desired resolved value.
+     */
+    ip() {
+        if (this.#raw.ip)
+            return this.#raw.ip;
+        return this.#raw.remoteAddr ?? '127.0.0.1';
+    }
+    /**
+     * Return all cookies sent on this request as a name → value map. The
+     * HyperServer parses the `Cookie:` header once via the `cookie` crate
+     * (RFC 6265) and ships the result on `RawRequest.cookies`. Test fixtures
+     * that don't pre-fill the field fall back to inline parsing of the raw
+     * header — same tolerant `;`-split with quoted-value passthrough.
+     */
+    cookies() {
+        if (this.#raw.cookies)
+            return { ...this.#raw.cookies };
+        const header = this.#raw.headers.cookie;
+        if (!header)
+            return {};
+        const result = {};
+        for (const pair of header.split(';')) {
+            const trimmed = pair.trim();
+            if (!trimmed)
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx === -1)
+                continue;
+            const k = trimmed.slice(0, eqIdx).trim();
+            const v = trimmed.slice(eqIdx + 1);
+            // Empty value (`name=`) is valid per RFC 6265 — used in session/logout
+            // flows that explicitly clear cookies. Only the key being empty is
+            // grounds to skip. Aligns the fallback with the pre-parsed path
+            // (HyperServer's cookie crate also accepts empty values).
+            if (k)
+                result[k] = v;
+        }
+        return result;
+    }
+    /** Pre-parsed cookie value by name, or `null` when absent. */
+    cookie(name) {
+        const cookies = this.#raw.cookies ?? this.cookies();
+        return cookies[name] ?? null;
+    }
+    /** Get the raw body as a string (decoded from base64 if binary). */
+    raw() {
+        if (this.#raw.bodyEncoding === 'base64') {
+            return Buffer.from(this.#raw.body, 'base64').toString('utf8');
+        }
+        return this.#raw.body;
+    }
+    /** Get the raw body as a Buffer (preserves binary integrity for file uploads). */
+    rawBuffer() {
+        if (this.#raw.bodyEncoding === 'base64') {
+            return Buffer.from(this.#raw.body, 'base64');
+        }
+        return Buffer.from(this.#raw.body, 'utf8');
+    }
+    // ─── Headers ──────────────────────────────────────────────
+    /** Get a single request header (case-insensitive). */
+    header(key) {
+        return this.#raw.headers[key.toLowerCase()];
+    }
+    /** Get all request headers. */
+    headers() {
+        return this.#raw.headers;
+    }
+    // ─── Route params ─────────────────────────────────────────
+    /** Get a single route parameter. */
+    param(key, defaultValue) {
+        return this.#params[key] ?? defaultValue;
+    }
+    /** Get all route parameters. */
+    params() {
+        return this.#params;
+    }
+    // ─── Query string ─────────────────────────────────────────
+    /** Get parsed query string as an object. */
+    qs() {
+        if (!this.#parsedQs) {
+            this.#parsedQs = parseQueryString(this.#raw.query);
+        }
+        return { ...this.#parsedQs };
+    }
+    // ─── Body ─────────────────────────────────────────────────
+    /** Get the parsed request body. */
+    body() {
+        this.#ensureParsedBody();
+        return this.#parsedBody;
+    }
+    // ─── Merged input (body + qs) ─────────────────────────────
+    /** Get a single input value from body or query string. */
+    input(key, defaultValue) {
+        const merged = this.all();
+        if (key in merged) {
+            // biome-ignore lint/suspicious/noExplicitAny: generic accessor — caller brands the value type via T
+            return merged[key];
+        }
+        // biome-ignore lint/suspicious/noExplicitAny: generic default — caller brands the value type via T
+        return defaultValue;
+    }
+    /** Get all input (query string merged with body). */
+    all() {
+        if (!this.#merged) {
+            this.#ensureParsedBody();
+            this.#merged = { ...this.qs(), ...this.#parsedBody };
+        }
+        return { ...this.#merged };
+    }
+    /** Cherry-pick specific keys from input. */
+    only(keys) {
+        const merged = this.all();
+        const result = {};
+        for (const key of keys) {
+            if (key in merged) {
+                result[key] = merged[key];
+            }
+        }
+        return result;
+    }
+    /** Get all input except specific keys. */
+    except(keys) {
+        const merged = this.all();
+        const keySet = new Set(keys);
+        const result = {};
+        for (const [k, v] of Object.entries(merged)) {
+            if (!keySet.has(k))
+                result[k] = v;
+        }
+        return result;
+    }
+    // ─── Content negotiation ──────────────────────────────────
+    /** Check if the request content-type matches any of the given types. */
+    is(types) {
+        const ct = this.#raw.headers['content-type'] ?? '';
+        for (const type of types) {
+            if (type === 'json' && ct.includes('application/json'))
+                return 'json';
+            if (type === 'html' && ct.includes('text/html'))
+                return 'html';
+            if (type === 'xml' && ct.includes('xml'))
+                return 'xml';
+            if (type === 'multipart' && ct.includes('multipart/form-data'))
+                return 'multipart';
+            if (ct.includes(type))
+                return type;
+        }
+        return null;
+    }
+    /**
+     * Content negotiation — which of the offered types does the client accept,
+     * honouring RFC 7231 §5.3.2 quality values?
+     *
+     * Walks the parsed Accept header in descending q-order and returns the
+     * first server-offered type that matches. The server's preference order
+     * (`types` argument) is the tiebreaker only when multiple client entries
+     * share the same q. A bare `accepts(types)` therefore respects the
+     * client's stated priorities (`application/json;q=0.9, text/html;q=0.1`
+     * beats a server passing `['html', 'json']`).
+     *
+     * Aliases (`'json'` ↔ `application/json`, `'html'` ↔ `text/html`,
+     * `'xml'` ↔ any subtype containing `xml`) are honoured.
+     */
+    accepts(types) {
+        const header = this.#raw.headers.accept ?? '*/*';
+        const entries = parseAcceptHeader(header);
+        if (entries.length === 0)
+            return null;
+        // Group by q so the highest q always wins; within one q-bucket, server
+        // offer order is the tiebreaker (devs control that order intentionally).
+        const buckets = bucketByQ(entries);
+        for (const bucket of buckets) {
+            for (const type of types) {
+                for (const entry of bucket) {
+                    if (acceptMatches(entry.value, type))
+                        return type;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Language negotiation from Accept-Language honouring RFC 4647 / 7231
+     * quality values. Returns the first offered language whose tag (or its
+     * primary subtag) matches the highest-q client entry, falling back to
+     * `langs[0]` when nothing matches and the client header is empty/absent.
+     */
+    language(langs) {
+        const header = this.#raw.headers['accept-language'] ?? '';
+        if (!header.trim())
+            return langs[0] ?? null;
+        const entries = parseAcceptHeader(header);
+        if (entries.length === 0)
+            return null;
+        const buckets = bucketByQ(entries);
+        for (const bucket of buckets) {
+            for (const lang of langs) {
+                for (const entry of bucket) {
+                    if (languageMatches(entry.value, lang))
+                        return lang;
+                }
+            }
+        }
+        return null;
+    }
+    // ─── Internals ────────────────────────────────────────────
+    // ─── Files ─────────────────────────────────────────────────
+    /** Get an uploaded file by field name. */
+    file(fieldName, options) {
+        const files = this.#files.get(fieldName);
+        if (!files || files.length === 0)
+            return null;
+        const file = files[0];
+        if (options)
+            file.validate(options);
+        return file;
+    }
+    /** Get all uploaded files for a field name. */
+    files(fieldName, options) {
+        const files = this.#files.get(fieldName) ?? [];
+        if (options) {
+            for (const f of files)
+                f.validate(options);
+        }
+        return files;
+    }
+    /** Get all uploaded files. */
+    allFiles() {
+        return this.#files;
+    }
+    /**
+     * Pre-parsed `multipart/form-data` payload as the HyperServer wrote it.
+     * Returns `undefined` when the request wasn't multipart (or the test
+     * fixture didn't fill the field). BodyParser hydrates `MultipartFile`
+     * instances from this — application code should keep using
+     * `request.file()` / `request.files()`.
+     */
+    multipart() {
+        return this.#raw.multipart;
+    }
+    /** @internal Set files (called by BodyParser middleware). */
+    setFiles(files) {
+        this.#files.clear();
+        for (const file of files) {
+            const existing = this.#files.get(file.fieldName) ?? [];
+            existing.push(file);
+            this.#files.set(file.fieldName, existing);
+        }
+    }
+    // ─── Internals ────────────────────────────────────────────
+    /** @internal Set the parsed body (called by BodyParser middleware). */
+    setParsedBody(body) {
+        this.#parsedBody = body;
+        this.#merged = undefined; // reset merged cache
+    }
+    #ensureParsedBody() {
+        if (this.#parsedBody !== undefined)
+            return;
+        const raw = this.#raw.body;
+        if (!raw || raw.length === 0) {
+            this.#parsedBody = {};
+            return;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            this.#parsedBody = isPlainObject(parsed) ? parsed : { _body: parsed };
+        }
+        catch {
+            this.#parsedBody = {};
+        }
+    }
+}
+/** Parse a query string (key=value&key2=value2) into an object. */
+/**
+ * Test whether an IPv4 address is within a CIDR range. Bare IP entries
+ * (`10.0.0.42`) are accepted as `/32`. IPv6 falls back to string equality
+ * — a full v6 implementation isn't required by the current security tests.
+ */
+/**
+ * Type guard for plain JSON-decoded objects. Excludes `null` (which is
+ * `typeof === 'object'`) and arrays so consumers can index by string key
+ * without a separate runtime check.
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Decode a percent-encoded segment without throwing on malformed input.
+ * Browsers happily send `q=%E0%A4%A` (truncated UTF-8 sequences) — refusing
+ * the whole request would let any client knock the route handler offline.
+ */
+function safeDecode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+function parseQueryString(qs) {
+    if (!qs)
+        return {};
+    const result = {};
+    for (const pair of qs.split('&')) {
+        const eqIdx = pair.indexOf('=');
+        if (eqIdx === -1) {
+            result[safeDecode(pair)] = '';
+        }
+        else {
+            const key = safeDecode(pair.slice(0, eqIdx));
+            const value = safeDecode(pair.slice(eqIdx + 1));
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Parse an Accept-style header (Accept, Accept-Language, Accept-Encoding…)
+ * into entries sorted by descending q-value, with the client's original
+ * order as a stable tiebreaker. Entries with `q=0` are dropped (RFC 7231:
+ * "the value 0 means not acceptable"). A bare wildcard entry is preserved.
+ */
+function parseAcceptHeader(header) {
+    const entries = [];
+    let index = 0;
+    for (const raw of header.split(',')) {
+        const part = raw.trim();
+        if (!part)
+            continue;
+        const [valueRaw, ...params] = part.split(';');
+        const value = (valueRaw ?? '').trim().toLowerCase();
+        if (!value)
+            continue;
+        let q = 1;
+        for (const param of params) {
+            const [k, v] = param.split('=');
+            if ((k ?? '').trim().toLowerCase() === 'q') {
+                const parsed = Number.parseFloat((v ?? '').trim());
+                if (Number.isFinite(parsed))
+                    q = parsed;
+            }
+        }
+        if (q <= 0)
+            continue;
+        entries.push({ value, q, index });
+        index += 1;
+    }
+    entries.sort((a, b) => b.q - a.q || a.index - b.index);
+    return entries;
+}
+/**
+ * Match an Accept entry value (already lowercased) against an offered
+ * type. Honours short aliases (`json` ↔ `application/json`, `html` ↔
+ * `text/html`, `xml` ↔ any subtype containing `xml`) and the full
+ * wildcard (matches anything). A `type/<wildcard>` entry matches any
+ * subtype with the same primary type.
+ */
+function acceptMatches(entry, offered) {
+    if (entry === '*/*' || entry === '*')
+        return true;
+    const o = offered.trim().toLowerCase();
+    if (entry === o)
+        return true;
+    // Expand short aliases to their canonical media-type so the wildcard
+    // and exact-match checks below see the full type.
+    const expanded = expandAlias(o);
+    if (expanded && entry === expanded)
+        return true;
+    if (o === 'xml' && entry.includes('xml'))
+        return true;
+    // type/<wildcard> entry (e.g. `text/*` matches `text/html`).
+    if (entry.endsWith('/*')) {
+        const prefix = entry.slice(0, -1); // keep trailing slash
+        if (expanded?.startsWith(prefix))
+            return true;
+        return o.startsWith(prefix);
+    }
+    return false;
+}
+function expandAlias(short) {
+    if (short === 'json')
+        return 'application/json';
+    if (short === 'html')
+        return 'text/html';
+    if (short === 'text')
+        return 'text/plain';
+    if (short === 'form')
+        return 'application/x-www-form-urlencoded';
+    if (short === 'multipart')
+        return 'multipart/form-data';
+    return null;
+}
+function bucketByQ(entries) {
+    const buckets = [];
+    let current = [];
+    let lastQ = Number.POSITIVE_INFINITY;
+    for (const entry of entries) {
+        if (entry.q !== lastQ) {
+            if (current.length > 0)
+                buckets.push(current);
+            current = [];
+            lastQ = entry.q;
+        }
+        current.push(entry);
+    }
+    if (current.length > 0)
+        buckets.push(current);
+    return buckets;
+}
+/**
+ * Language tag match. Returns true when the Accept-Language entry equals
+ * the offered tag (case-insensitive), or when the entry's primary subtag
+ * matches the offered tag (RFC 4647 basic filtering: `en` matches `en-US`
+ * but not vice versa). Wildcard `*` matches anything.
+ */
+function languageMatches(entry, offered) {
+    if (entry === '*')
+        return true;
+    const o = offered.trim().toLowerCase();
+    if (entry === o)
+        return true;
+    if (entry.startsWith(`${o}-`))
+        return true;
+    const primary = entry.split('-')[0];
+    if (primary && primary === o.split('-')[0])
+        return true;
+    return false;
+}
+//# sourceMappingURL=Request.js.map

package/dist/http/Request.js.map

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

package/dist/http/Response.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Response — accumulates HTTP response state with a fluent API.
+ *
+ * Wraps the same { status, headers, body } wire format expected by the NAPI layer.
+ * Provides AdonisJS-compatible methods: json(), send(), status(), header(), etc.
+ *
+ * @implements FR21
+ */
+import type { RedirectBuilder } from './RedirectBuilder.js';
+import { type SseStream, type SseStreamOptions, type StreamBackend } from './SseStream.js';
+export declare class Response {
+    #private;
+    /**
+     * CSP nonce for this request (AdonisJS idiom: `response.nonce`). Seeded by
+     * the `@c9up/blackhole` middleware when the CSP uses `@nonce`; `undefined`
+     * otherwise. Also published to `ctx.store` as `cspNonce` for templating.
+     */
+    nonce?: string;
+    /** Set the HTTP status code. Chainable. */
+    status(code: number): this;
+    /** Set status only if not already set (still 200). */
+    safeStatus(code: number): this;
+    /** Set a response header. Chainable. */
+    header(key: string, value: string): this;
+    /** Append to a response header (for multi-value like Set-Cookie). */
+    append(key: string, value: string): this;
+    /** Remove a response header. */
+    removeHeader(key: string): this;
+    /** Set the Content-Type header. Chainable. */
+    type(contentType: string): this;
+    /** Send a JSON response. Sets content-type and stringifies. */
+    json(data: unknown): void;
+    /** Send a response body. Auto-detects content type if not set. */
+    send(data: unknown): void;
+    /**
+     * Send a binary body as-is. Encodes to base64 across the NAPI bridge
+     * with the `x-ream-body-encoding: base64` marker so the Rust HTTP
+     * layer decodes it before writing to the socket. The marker header is
+     * stripped server-side and never leaks to the client.
+     *
+     * Use this for any non-UTF-8 payload (images, PDFs, archives, etc.) —
+     * `send()` auto-routes Buffers here, but call directly when intent is
+     * unambiguous.
+     */
+    sendBuffer(buffer: Buffer): void;
+    /** Send 204 No Content. */
+    noContent(): void;
+    /** Get a redirect builder. */
+    redirect(): RedirectBuilder;
+    /** @internal Set the redirect builder factory (injected by HttpContext). */
+    setRedirectFactory(factory: () => RedirectBuilder): void;
+    /** @internal Wire the SSE backend (HyperServer NAPI). Injected by HttpKernel. */
+    setStreamBackend(backend: StreamBackend): void;
+    /**
+     * Open a Server-Sent Events stream. The returned `SseStream` lets the
+     * handler push named events for as long as the client stays
+     * connected. Headers are pre-set to the SSE wire format; the host
+     * router serializes the response with the reserved stream id so the
+     * Rust HyperServer keeps the connection open.
+     *
+     *   const sse = await ctx.response.sse()
+     *   sse.send('connected', { uid: caller.id })
+     *   onTaskAssigned((evt) => sse.send('task.assigned', evt))
+     *
+     * Throws `STREAMING_UNSUPPORTED` if the underlying HyperServer host
+     * does not implement the streaming NAPI (e.g. a mock server in unit
+     * tests). The host capability is opt-in: implement
+     * `registerStream`/`writeStream`/`closeStream`/`onStreamDisconnect`
+     * to participate.
+     */
+    sse(options?: SseStreamOptions): Promise<SseStream>;
+    /** Set a response cookie. */
+    cookie(name: string, value: string, options?: {
+        maxAge?: number;
+        path?: string;
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'lax' | 'strict' | 'none';
+    }): this;
+    /** @internal Get the accumulated status code. */
+    getStatus(): number;
+    /** @internal Get all accumulated headers (Set-Cookie as separate entries joined by newline). */
+    getHeaders(): Record<string, string>;
+    /**
+     * Read a single accumulated response header by name (case-insensitive).
+     * Returns `undefined` when not set — used by middleware that conditionally
+     * inspects the outgoing content-type before sanitisation.
+     */
+    getHeader(name: string): string | undefined;
+    /** @internal Get the accumulated body string. */
+    getBody(): string;
+    /** @internal Check if response has been finalized. */
+    isFinished(): boolean;
+    /** @internal Set body directly (used by redirect, exception handler). */
+    setBody(body: string): void;
+    /**
+     * @internal Streaming-response handle, set by `sse()`. The host
+     * router forwards this id to the Rust HyperServer so the connection
+     * stays open and chunks flow from the JS-side writer.
+     */
+    getStreamId(): string | undefined;
+    /**
+     * @internal Tear down a stream the handler opened via `sse()` but
+     * then abandoned by throwing. Closes the backend registry slot and
+     * clears the stream id + finished flag so the kernel's error path
+     * serializes a normal buffered error response instead of emitting
+     * `streamId` alongside an error body (which would leave the
+     * HyperServer feeding a dead/empty stream forever). Best-effort: a
+     * closeStream failure is swallowed — the slot's TTL/disconnect will
+     * reclaim it.
+     */
+    abortStream(): Promise<void>;
+}
+//# sourceMappingURL=Response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Response.d.ts","sourceRoot":"","sources":["../../src/http/Response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAA;AAgBvB,qBAAa,QAAQ;;IAUnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAId,2CAA2C;IAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,sDAAsD;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS9B,wCAAwC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMxC,qEAAqE;IACrE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBxC,gCAAgC;IAChC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/B,8CAA8C;IAC9C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAU/B,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAMzB,kEAAkE;IAClE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAwBzB;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC,2BAA2B;IAC3B,SAAS,IAAI,IAAI;IAQjB,8BAA8B;IAC9B,QAAQ,IAAI,eAAe;IAS3B,4EAA4E;IAC5E,kBAAkB,CAAC,OAAO,EAAE,MAAM,eAAe,GAAG,IAAI;IAIxD,iFAAiF;IACjF,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAM9C;;;;;;;;;;;;;;;;OAgBG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BzD,6BAA6B;IAC7B,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;KACrC,GACA,IAAI;IAkCP,iDAAiD;IACjD,SAAS,IAAI,MAAM;IAInB,gGAAgG;IAChG,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IASpC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C,iDAAiD;IACjD,OAAO,IAAI,MAAM;IAIjB,sDAAsD;IACtD,UAAU,IAAI,OAAO;IAIrB,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;OAIG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAanC"}