@astrale-os/kernel-server 0.4.17 → 0.5.0-beta.1

package/dist/routed/handler.d.ts

@@ -1,38 +0,0 @@
-/**
- * Route binding HTTP handler — native HTTP shape (REST-like).
- *
- * One handler per mounted route. Decodes params from the request, dispatches
- * via the kernel API, encodes the response per output mode:
- *   - value  → JSON body, HTTP status from error code table on error
- *   - stream → SSE with one event per yielded chunk (raw, NOT kernel envelope)
- *   - binary → raw bytes with BinaryResult contentType + status
- *
- * Errors use the kernel envelope's `{ error: { code, message, data? } }` shape
- * for consistency with kernel HTTP. The HTTP status comes from the error code
- * table (`kernelErrorHttpStatus`).
- */
-import type { RouteBinding } from '@astrale-os/kernel-api';
-import type { AuthPolicy } from '@astrale-os/kernel-api/routed';
-import type { CapabilityHost } from '../capabilities/index.js';
-import type { CorsConfig } from '../cors.js';
-import type { Dispatcher } from '../invocation/index.js';
-export type RouteHandlerConfig = {
-    /** The full kernel method name to dispatch (e.g. `Task.read`). */
-    method: string;
-    route: RouteBinding;
-    dispatcher: Dispatcher;
-    cors: CorsConfig;
-    /**
-     * Optional host placeholder extractor — returned values are merged into
-     * params at the lowest priority (host < path < query < header < body).
-     * Return null to reject the request with 404.
-     */
-    hostParams?: (req: Request) => Record<string, string> | null;
-    /** Authentication policy from the method definition. Defaults to `'required'`. */
-    auth?: AuthPolicy;
-};
-/**
- * Build a Hono-compatible handler for a single route binding.
- */
-export declare function createRouteHandler(config: RouteHandlerConfig): (req: Request, pathParams: Record<string, string>, host?: CapabilityHost) => Promise<Response>;
-//# sourceMappingURL=handler.d.ts.map

package/dist/routed/handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../routed/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAiC,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAS/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AA2BxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5D,kFAAkF;IAClF,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB,CAAA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GACzB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAuGhG"}

package/dist/routed/handler.js

@@ -1,123 +0,0 @@
-/**
- * Route binding HTTP handler — native HTTP shape (REST-like).
- *
- * One handler per mounted route. Decodes params from the request, dispatches
- * via the kernel API, encodes the response per output mode:
- *   - value  → JSON body, HTTP status from error code table on error
- *   - stream → SSE with one event per yielded chunk (raw, NOT kernel envelope)
- *   - binary → raw bytes with BinaryResult contentType + status
- *
- * Errors use the kernel envelope's `{ error: { code, message, data? } }` shape
- * for consistency with kernel HTTP. The HTTP status comes from the error code
- * table (`kernelErrorHttpStatus`).
- */
-import { KERNEL_ERROR_CODES, isBinaryResult, jsonCodec, kernelErrorHttpStatus, } from '@astrale-os/kernel-api';
-import { buildCorsHeaders } from '../cors.js';
-import { dispatchInvocation } from '../invocation/index.js';
-import { buildBinaryResponse, toBody } from '../render/index.js';
-import { readCredential } from './credential.js';
-import { decodeRouteRequest } from './params.js';
-import { buildRouteStreamResponse } from './stream.js';
-// ─── Helpers ────────────────────────────────────────────────────────────────
-function errorResponse(error, corsHeaders) {
-    const status = kernelErrorHttpStatus(error.code);
-    const body = jsonCodec.encode({
-        error: error.data === undefined
-            ? { code: error.code, message: error.message }
-            : { code: error.code, message: error.message, data: error.data },
-    });
-    return new Response(toBody(body), {
-        status,
-        headers: { ...corsHeaders, 'content-type': 'application/json' },
-    });
-}
-/**
- * Build a Hono-compatible handler for a single route binding.
- */
-export function createRouteHandler(config) {
-    const corsHeaders = buildCorsHeaders(config.cors);
-    const hostParamsFn = config.hostParams;
-    return async (req, pathParams, host) => {
-        if (req.method === 'OPTIONS') {
-            return new Response(null, { status: 204, headers: corsHeaders });
-        }
-        // 0. Host params (lowest priority).
-        let hostParams = {};
-        if (hostParamsFn) {
-            const extracted = hostParamsFn(req);
-            if (extracted === null) {
-                return new Response('Host not recognised', { status: 404, headers: corsHeaders });
-            }
-            hostParams = extracted;
-        }
-        // 1. Decode params + self
-        let decoded;
-        try {
-            decoded = await decodeRouteRequest({
-                route: config.route,
-                pathParams,
-                hostParams,
-                request: req,
-            });
-        }
-        catch (err) {
-            return errorResponse({
-                code: KERNEL_ERROR_CODES.PARSE_ERROR,
-                message: err instanceof Error ? err.message : 'Parse error',
-            }, corsHeaders);
-        }
-        const params = decoded.params;
-        // 1b. Inject actual HTTP method for wildcard routes.
-        if (config.route.method === '*') {
-            params._method = req.method;
-        }
-        // 2. Resolve credential.
-        //    Configurable via route.credential. Defaults to Authorization header.
-        const credSource = config.route.credential ?? { in: 'header', name: 'authorization' };
-        const credential = readCredential(req, credSource);
-        // 3. Dispatch
-        const requestId = crypto.randomUUID();
-        const result = await dispatchInvocation(config.dispatcher, {
-            path: config.method,
-            credential,
-            params,
-            ...(decoded.self === undefined ? {} : { self: decoded.self }),
-        }, { id: requestId }, host);
-        // 4. Render
-        switch (result.kind) {
-            case 'ack':
-                return new Response(null, { status: 204, headers: corsHeaders });
-            case 'success': {
-                if (isBinaryResult(result.data)) {
-                    return buildBinaryResponse(result.data, corsHeaders);
-                }
-                const body = jsonCodec.encode(result.data);
-                return new Response(toBody(body), {
-                    status: 200,
-                    headers: { ...corsHeaders, 'content-type': 'application/json' },
-                });
-            }
-            case 'error':
-                return errorResponse(result.error, corsHeaders);
-            case 'redirect': {
-                const body = jsonCodec.encode({ redirect: result.redirection });
-                return new Response(toBody(body), {
-                    status: 307,
-                    headers: {
-                        ...corsHeaders,
-                        'content-type': 'application/json',
-                        location: result.redirection.url,
-                    },
-                });
-            }
-            case 'stream': {
-                const streamResult = await buildRouteStreamResponse(result.generator, corsHeaders);
-                if (streamResult.kind === 'error') {
-                    return errorResponse(streamResult.error, corsHeaders);
-                }
-                return streamResult.response;
-            }
-        }
-    };
-}
-//# sourceMappingURL=handler.js.map

package/dist/routed/handler.js.map

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

package/dist/routed/index.d.ts

@@ -1,5 +0,0 @@
-export { createRouteHandler, type RouteHandlerConfig } from './handler.js';
-export { decodeRouteRequest, type DecodedRouteParams, type DecodeRouteInput } from './params.js';
-export { readCredential } from './credential.js';
-export { buildRouteStreamResponse, type StreamResponseResult } from './stream.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../routed/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/routed/index.js

@@ -1,5 +0,0 @@
-export { createRouteHandler } from './handler.js';
-export { decodeRouteRequest } from './params.js';
-export { readCredential } from './credential.js';
-export { buildRouteStreamResponse } from './stream.js';
-//# sourceMappingURL=index.js.map

package/dist/routed/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../routed/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAkD,MAAM,aAAa,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAA6B,MAAM,aAAa,CAAA"}

package/dist/routed/params.d.ts

@@ -1,40 +0,0 @@
-/**
- * Route binding parameter decoder.
- *
- * Extracts params from all sources (host, path, query, header, body) per
- * spec §3. Merge order: host < path < query < header < body — later wins.
- * `route.self`, if set, is lifted to a separate top-level `self` channel
- * AND removed from `params` — handlers read it via the `self` sibling in
- * their execute context (`self.path.raw`), never from `params`. Leaving
- * a copy in `params` would trip strict Zod validation of `inputSchema`
- * (`route-self.ts` explicitly allows the placeholder to be absent from
- * the schema, so the runtime must not smuggle it through anyway).
- *
- * Body modes:
- *   - `'*'`     parse JSON body, merge top-level fields into params.
- *   - `'raw'`   skip parsing; raw bytes at `params._body`.
- *   - `Record`  parse JSON, pick mapped fields with wire-name remapping.
- */
-import type { RouteBinding } from '@astrale-os/kernel-api';
-export type DecodedRouteParams = Record<string, unknown>;
-export type DecodedRoute = {
-    params: DecodedRouteParams;
-    /** Lifted from the placeholder declared by `route.self`. Sibling of params. */
-    self?: string;
-};
-export type DecodeRouteInput = {
-    route: RouteBinding;
-    /** Pre-extracted path params (from path matcher). */
-    pathParams: Record<string, string>;
-    /** Pre-extracted host params (from server-side host matcher). May be empty. */
-    hostParams?: Record<string, string>;
-    /** The raw request. */
-    request: Request;
-};
-/**
- * Decode params from a route + request.
- *
- * Throws on body parse errors — the caller should map to PARSE_ERROR.
- */
-export declare function decodeRouteRequest(input: DecodeRouteInput): Promise<DecodedRoute>;
-//# sourceMappingURL=params.d.ts.map

package/dist/routed/params.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../routed/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,wBAAwB,CAAA;AASpE,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAExD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,YAAY,CAAA;IACnB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqGvF"}

package/dist/routed/params.js

@@ -1,146 +0,0 @@
-/**
- * Route binding parameter decoder.
- *
- * Extracts params from all sources (host, path, query, header, body) per
- * spec §3. Merge order: host < path < query < header < body — later wins.
- * `route.self`, if set, is lifted to a separate top-level `self` channel
- * AND removed from `params` — handlers read it via the `self` sibling in
- * their execute context (`self.path.raw`), never from `params`. Leaving
- * a copy in `params` would trip strict Zod validation of `inputSchema`
- * (`route-self.ts` explicitly allows the placeholder to be absent from
- * the schema, so the runtime must not smuggle it through anyway).
- *
- * Body modes:
- *   - `'*'`     parse JSON body, merge top-level fields into params.
- *   - `'raw'`   skip parsing; raw bytes at `params._body`.
- *   - `Record`  parse JSON, pick mapped fields with wire-name remapping.
- */
-import { jsonCodec } from '@astrale-os/kernel-api';
-/** Check if a body pick is a whole-body read mode ({ as: 'text' } or { as: 'bytes' }). */
-function isWholeBodyPick(pick) {
-    return typeof pick === 'object' && 'as' in pick;
-}
-/**
- * Decode params from a route + request.
- *
- * Throws on body parse errors — the caller should map to PARSE_ERROR.
- */
-export async function decodeRouteRequest(input) {
-    const { route, pathParams, hostParams = {}, request } = input;
-    const url = new URL(request.url);
-    const params = {};
-    // 1. Host placeholders (lowest priority)
-    for (const [k, v] of Object.entries(hostParams)) {
-        params[k] = v;
-    }
-    // 2. Path placeholders (implicit by name)
-    for (const [k, v] of Object.entries(pathParams)) {
-        params[k] = v;
-    }
-    // 3. Query parameters (explicit field → wire-name)
-    if (route.query) {
-        for (const [field, wireName] of Object.entries(route.query)) {
-            const value = url.searchParams.get(wireName);
-            if (value !== null) {
-                params[field] = decodeQueryValue(value);
-            }
-        }
-    }
-    // 4. Headers — per-entry: string = specific wire name, '*' = all headers
-    if (route.headers) {
-        for (const [field, pick] of Object.entries(route.headers)) {
-            if (pick === '*') {
-                const all = {};
-                request.headers.forEach((value, key) => {
-                    all[key] = value;
-                });
-                params[field] = all;
-            }
-            else {
-                const value = request.headers.get(pick);
-                if (value !== null) {
-                    params[field] = value;
-                }
-            }
-        }
-    }
-    // 5. Body — '*' = JSON spread, Record = per-field picks
-    if (route.body !== undefined) {
-        if (route.body === '*') {
-            // Parse JSON, merge all top-level fields
-            if (hasBody(request.method)) {
-                const decoded = await parseJsonBody(request);
-                if (decoded && typeof decoded === 'object') {
-                    for (const [k, v] of Object.entries(decoded)) {
-                        params[k] = v;
-                    }
-                }
-            }
-        }
-        else {
-            // Record<string, BodyPick> — inspect picks to determine read mode
-            const entries = Object.entries(route.body);
-            const wholeEntry = entries.find(([_, pick]) => isWholeBodyPick(pick));
-            if (wholeEntry) {
-                // Whole-body read: { as: 'text' } or { as: 'bytes' }
-                const [field, pick] = wholeEntry;
-                if (pick.as === 'text') {
-                    params[field] = await request.text();
-                }
-                else {
-                    params[field] = new Uint8Array(await request.arrayBuffer());
-                }
-            }
-            else if (hasBody(request.method)) {
-                // All string picks → JSON field picking
-                const decoded = await parseJsonBody(request);
-                if (decoded && typeof decoded === 'object') {
-                    const obj = decoded;
-                    for (const [field, wireName] of entries) {
-                        if (wireName in obj) {
-                            params[field] = obj[wireName];
-                        }
-                    }
-                }
-            }
-        }
-    }
-    // 6. self lift: route.self placeholder → DecodedRoute.self (sibling of
-    //    params, NOT a member). The source field is REMOVED from params —
-    //    `self` is the canonical channel for "the node this method runs
-    //    on" (matches envelope dispatch via `<path>::method`, which also
-    //    keeps self out of the body). Leaving a copy in `params` would
-    //    cause strict Zod validation of the inputSchema to reject the
-    //    placeholder field, even though `validateRouteSelf` already says
-    //    the schema doesn't have to declare it.
-    let self;
-    if (route.self !== undefined) {
-        const sourceValue = params[route.self];
-        if (typeof sourceValue === 'string') {
-            self = sourceValue;
-            delete params[route.self];
-        }
-    }
-    return self !== undefined ? { params, self } : { params };
-}
-// ─── Helpers ────────────────────────────────────────────────────────────────
-function hasBody(method) {
-    return method === 'POST' || method === 'PUT' || method === 'PATCH' || method === 'DELETE';
-}
-async function parseJsonBody(req) {
-    const bytes = new Uint8Array(await req.arrayBuffer());
-    if (bytes.length === 0)
-        return null;
-    return jsonCodec.decode(bytes);
-}
-/** Coerce a query string value to a sensible JS value (number/bool/string). */
-function decodeQueryValue(raw) {
-    if (raw === 'true')
-        return true;
-    if (raw === 'false')
-        return false;
-    if (raw !== '' && !isNaN(Number(raw)))
-        return Number(raw);
-    return raw;
-}
-//# sourceMappingURL=params.js.map

package/dist/routed/params.js.map

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

package/dist/routed/stream.d.ts

@@ -1,21 +0,0 @@
-/**
- * SSE response with raw chunk framing — used by route bindings.
- *
- * Distinct from `envelope/sse.ts`: route SSE emits each yielded value as its
- * own JSON `data:` line, with `event: end` / `event: error` for terminal
- * events. There is no kernel envelope wrapping; the route's `outputSchema`
- * IS the chunk shape.
- *
- * Setup failures from the first iteration become a kernel error response so
- * the caller can return them with the right HTTP status.
- */
-import type { KernelErrorPayload } from '@astrale-os/kernel-api';
-export type StreamResponseResult = {
-    kind: 'response';
-    response: Response;
-} | {
-    kind: 'error';
-    error: KernelErrorPayload;
-};
-export declare function buildRouteStreamResponse(generator: AsyncGenerator<unknown>, corsHeaders: Record<string, string>): Promise<StreamResponseResult>;
-//# sourceMappingURL=stream.d.ts.map

package/dist/routed/stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../routed/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAIhE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAEhD,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,EAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAyD/B"}

package/dist/routed/stream.js

@@ -1,69 +0,0 @@
-/**
- * SSE response with raw chunk framing — used by route bindings.
- *
- * Distinct from `envelope/sse.ts`: route SSE emits each yielded value as its
- * own JSON `data:` line, with `event: end` / `event: error` for terminal
- * events. There is no kernel envelope wrapping; the route's `outputSchema`
- * IS the chunk shape.
- *
- * Setup failures from the first iteration become a kernel error response so
- * the caller can return them with the right HTTP status.
- */
-import { classifyError } from '@astrale-os/kernel-api';
-export async function buildRouteStreamResponse(generator, corsHeaders) {
-    // Eagerly pull the first chunk so setup failures become a proper HTTP error.
-    let first;
-    try {
-        first = await generator.next();
-    }
-    catch (err) {
-        return { kind: 'error', error: classifyError(err) };
-    }
-    const encoder = new TextEncoder();
-    let cancelled = false;
-    const stream = new ReadableStream({
-        async start(controller) {
-            try {
-                if (!first.done) {
-                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(first.value)}\n\n`));
-                }
-                for await (const chunk of generator) {
-                    if (cancelled)
-                        break;
-                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(chunk)}\n\n`));
-                }
-                if (!cancelled) {
-                    controller.enqueue(encoder.encode(`event: end\ndata: {}\n\n`));
-                }
-                controller.close();
-            }
-            catch (err) {
-                try {
-                    const error = classifyError(err);
-                    controller.enqueue(encoder.encode(`event: error\ndata: ${JSON.stringify({ code: error.code, message: error.message })}\n\n`));
-                }
-                catch {
-                    /* swallow */
-                }
-                controller.close();
-            }
-        },
-        cancel() {
-            cancelled = true;
-            generator.return(undefined).catch(() => { });
-        },
-    });
-    return {
-        kind: 'response',
-        response: new Response(stream, {
-            status: 200,
-            headers: {
-                ...corsHeaders,
-                'content-type': 'text/event-stream',
-                'cache-control': 'no-cache',
-                connection: 'keep-alive',
-            },
-        }),
-    };
-}
-//# sourceMappingURL=stream.js.map

package/dist/routed/stream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../routed/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAMtD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAkC,EAClC,WAAmC;IAEnC,6EAA6E;IAC7E,IAAI,KAA8B,CAAA;IAClC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,UAAU;YACpB,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;gBAChF,CAAC;gBACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;oBACpC,IAAI,SAAS;wBAAE,MAAK;oBACpB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;gBAC1E,CAAC;gBACD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAA;gBAChE,CAAC;gBACD,UAAU,CAAC,KAAK,EAAE,CAAA;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;oBAChC,UAAU,CAAC,OAAO,CAChB,OAAO,CAAC,MAAM,CACZ,uBAAuB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAC1F,CACF,CAAA;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,aAAa;gBACf,CAAC;gBACD,UAAU,CAAC,KAAK,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;QACD,MAAM;YACJ,SAAS,GAAG,IAAI,CAAA;YAChB,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC7C,CAAC;KACF,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE;YAC7B,MAAM,EAAE,GAAG;YACX,OAAO,EAAE;gBACP,GAAG,WAAW;gBACd,cAAc,EAAE,mBAAmB;gBACnC,eAAe,EAAE,UAAU;gBAC3B,UAAU,EAAE,YAAY;aACzB;SACF,CAAC;KACH,CAAA;AACH,CAAC"}