@astrale-os/kernel-client 0.5.0 → 0.6.0-beta.1

package/dist/transport/http/transport.js

@@ -0,0 +1,333 @@
+import { codecs, invocation as protocol } from '@astrale-os/kernel-protocol';
+import { ProtocolError, ResponseError, TransportError } from '../../errors/index.js';
+import { asError, controlledSignal, positiveInteger, requireLive, } from '../index.js';
+import { binaryHeaders, codecForResponse, decodeProtocol, normalizeMediaType, readBoundedBody, requireId, } from './response.js';
+import { HttpStream } from './stream.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAXIMUM_REQUEST_BYTES = 16 * 1024 * 1024;
+const DEFAULT_MAXIMUM_RESPONSE_BYTES = 16 * 1024 * 1024;
+/** HTTP implementation of the universal invocation protocol. */
+export class HttpTransport {
+    url;
+    codecName;
+    fetchImpl;
+    headers;
+    timeoutMs;
+    maximumRequestBytes;
+    maximumResponseBytes;
+    nextId = 1;
+    constructor(options) {
+        if (options === null || typeof options !== 'object') {
+            throw new TypeError('HttpTransport options must be an object.');
+        }
+        this.url = normalizeUrl(options.url);
+        this.codecName = admitCodecName(options.codec);
+        this.fetchImpl = admitFetch(options.fetch);
+        this.headers = admitHeaders(options.headers ?? {});
+        this.timeoutMs = positiveInteger(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 'timeoutMs');
+        this.maximumRequestBytes = positiveInteger(options.maximumRequestBytes ?? DEFAULT_MAXIMUM_REQUEST_BYTES, 'maximumRequestBytes');
+        this.maximumResponseBytes = positiveInteger(options.maximumResponseBytes ?? DEFAULT_MAXIMUM_RESPONSE_BYTES, 'maximumResponseBytes');
+    }
+    async dispatch(input, options = {}) {
+        const id = this.nextRequestId();
+        const timeoutMs = positiveInteger(options.timeoutMs ?? this.timeoutMs, 'timeoutMs');
+        const codec = await this.requestCodec();
+        const request = protocol.decodeRequest({
+            version: protocol.VERSION,
+            id,
+            ...input,
+            ...(options.idempotencyKey === undefined ? {} : { idempotencyKey: options.idempotencyKey }),
+        });
+        const encoded = codec.encode(request);
+        const control = controlledSignal(options.signal, timeoutMs);
+        let handedOff = false;
+        let phase = 'connect';
+        let delivery = 'not-sent';
+        try {
+            requireLive(control);
+            if (encodedByteLength(encoded) > this.maximumRequestBytes) {
+                throw new TransportError(`request exceeds maximumRequestBytes (${this.maximumRequestBytes}).`, { phase: 'send', delivery: 'not-sent' });
+            }
+            phase = 'send';
+            delivery = 'unknown';
+            const response = await this.fetchResponse(codec, encoded, control);
+            phase = 'receive';
+            requireLive(control);
+            if (response.status >= 300 && response.status < 400) {
+                throw new ProtocolError('server returned a network redirect.');
+            }
+            requireNoStore(response);
+            const streamFraming = response.headers.get(protocol.http.STREAM_FRAMING_FIELD);
+            const binaryId = response.headers.get(protocol.http.REQUEST_ID_FIELD);
+            const binaryManifest = response.headers.get(protocol.http.BINARY_HEADERS_FIELD);
+            const hasStreamSignal = streamFraming !== null;
+            const hasBinarySignal = binaryId !== null || binaryManifest !== null;
+            if (hasStreamSignal && hasBinarySignal) {
+                throw new ProtocolError('server returned conflicting stream and binary response signals.');
+            }
+            if (hasBinarySignal) {
+                if (binaryId === null || binaryManifest === null) {
+                    throw new ProtocolError('server returned an incomplete binary response signal.');
+                }
+                return await this.decodeBinary(response, id, binaryId, control);
+            }
+            const responseCodec = await codecForResponse(response.headers.get('content-type'));
+            if (responseCodec === undefined) {
+                throw new ProtocolError(`server returned unsupported Content-Type ${JSON.stringify(response.headers.get('content-type'))}.`);
+            }
+            if (hasStreamSignal) {
+                if (streamFraming !== protocol.http.LENGTH_PREFIX_V1) {
+                    throw new ProtocolError(`server returned unsupported stream framing ${JSON.stringify(streamFraming)}.`);
+                }
+                if (!response.ok) {
+                    throw new ProtocolError('server returned a non-success stream response.');
+                }
+                const stream = await HttpStream.open(response, responseCodec, id, this.maximumResponseBytes, control);
+                requireLive(control);
+                handedOff = true;
+                return { kind: 'stream', stream };
+            }
+            const body = await readBoundedBody(response, this.maximumResponseBytes, control.signal);
+            requireLive(control);
+            const decoded = decodeProtocol('response body', () => responseCodec.decode(body));
+            const envelope = decodeProtocol('response envelope', () => protocol.decodeResponse(decoded));
+            if (envelope.id === null && 'error' in envelope) {
+                throw new ResponseError(envelope.error.code, envelope.error.message, envelope.error.data);
+            }
+            requireId(id, envelope.id);
+            if ('kind' in envelope && envelope.kind === 'stale') {
+                const stale = decodeProtocol('stale response', () => protocol.decodeStale(envelope));
+                requireLive(control);
+                return Object.freeze({ kind: 'stale', current: stale.current });
+            }
+            if ('kind' in envelope && envelope.kind === 'miss') {
+                decodeProtocol('miss response', () => protocol.decodeMiss(envelope));
+                requireLive(control);
+                return Object.freeze({ kind: 'miss' });
+            }
+            if ('kind' in envelope && envelope.kind === 'redirect') {
+                const redirect = decodeProtocol('redirect response', () => protocol.decodeRedirect(envelope));
+                requireLive(control);
+                return redirectResult(redirect);
+            }
+            if ('error' in envelope) {
+                throw new ResponseError(envelope.error.code, envelope.error.message, envelope.error.data);
+            }
+            requireLive(control);
+            return { kind: 'value', value: envelope.result };
+        }
+        catch (error) {
+            throw transportFailure(error, control, options.signal, timeoutMs, this.url, phase, delivery);
+        }
+        finally {
+            if (!handedOff)
+                control.close();
+        }
+    }
+    async fetchResponse(codec, encoded, control) {
+        return this.fetchImpl(this.url, {
+            method: 'POST',
+            redirect: 'error',
+            credentials: 'omit',
+            cache: 'no-store',
+            referrerPolicy: 'no-referrer',
+            headers: {
+                ...this.headers,
+                'content-type': codec.contentType,
+                accept: codec.contentType,
+            },
+            body: toBody(encoded),
+            signal: control.signal,
+        });
+    }
+    async decodeBinary(response, id, binaryId, control) {
+        if (!response.ok) {
+            throw new ProtocolError('server returned binary data with an error status.');
+        }
+        if (binaryId !== String(id)) {
+            throw new ProtocolError(`binary response id ${JSON.stringify(binaryId)} does not match request id ${id}.`);
+        }
+        const mediaType = normalizeMediaType(response.headers.get('content-type'));
+        if (mediaType === undefined) {
+            throw new ProtocolError('binary response has no media type.');
+        }
+        const body = await readBoundedBody(response, this.maximumResponseBytes, control.signal);
+        requireLive(control);
+        const headerNames = decodeProtocol('binary application-header manifest', () => protocol.http.decodeBinaryHeaderNames(response.headers.get(protocol.http.BINARY_HEADERS_FIELD)));
+        const headers = binaryHeaders(response.headers, headerNames);
+        const binary = decodeProtocol('binary response', () => protocol.decodeBinaryResponse({
+            kind: 'binary',
+            id,
+            body,
+            mediaType,
+            ...(Object.keys(headers).length === 0 ? {} : { headers }),
+        }));
+        requireLive(control);
+        return {
+            kind: 'binary',
+            value: {
+                body: binary.body,
+                mediaType: binary.mediaType,
+                ...(binary.headers === undefined ? {} : { headers: binary.headers }),
+            },
+        };
+    }
+    nextRequestId() {
+        const id = this.nextId;
+        this.nextId = id === Number.MAX_SAFE_INTEGER ? 1 : id + 1;
+        return id;
+    }
+    requestCodec() {
+        return this.codecName === 'msgpack' ? codecs.loadMsgpack() : Promise.resolve(codecs.json);
+    }
+}
+function redirectResult(redirect) {
+    return Object.freeze({
+        kind: 'redirect',
+        redirect: Object.freeze({
+            route: redirect.route,
+            ...(redirect.credential === undefined ? {} : { credential: redirect.credential }),
+        }),
+    });
+}
+function normalizeUrl(input) {
+    if (typeof input !== 'string')
+        throw new TypeError('server URL must be a string.');
+    let parsed;
+    try {
+        parsed = new URL(input);
+    }
+    catch (error) {
+        throw new TypeError(`Invalid server URL ${JSON.stringify(input)}.`, { cause: asError(error) });
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new TypeError('server URL must use http or https.');
+    }
+    if (parsed.username !== '' || parsed.password !== '' || parsed.hash !== '') {
+        throw new TypeError('server URL cannot contain credentials or a fragment.');
+    }
+    return parsed.toString();
+}
+function admitHeaders(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError('HTTP headers must be an object.');
+    }
+    const output = {};
+    for (const [name, value] of Object.entries(input)) {
+        if (!HEADER_NAME.test(name)) {
+            throw new TypeError(`HTTP header name ${JSON.stringify(name)} is invalid.`);
+        }
+        const normalized = name.toLowerCase();
+        if (Object.hasOwn(output, normalized)) {
+            throw new TypeError(`HTTP header ${JSON.stringify(name)} occurs more than once.`);
+        }
+        if (isReservedRequestHeader(normalized)) {
+            throw new TypeError(`HTTP header ${JSON.stringify(name)} is owned by transport.`);
+        }
+        if (typeof value !== 'string') {
+            throw new TypeError(`HTTP header ${JSON.stringify(name)} must be a string.`);
+        }
+        if (hasControlCharacter(value)) {
+            throw new TypeError(`HTTP header ${JSON.stringify(name)} contains a control character.`);
+        }
+        output[normalized] = value;
+    }
+    return Object.freeze(output);
+}
+function toBody(input) {
+    if (typeof input === 'string')
+        return input;
+    const copy = new Uint8Array(input);
+    return copy.buffer;
+}
+function encodedByteLength(input) {
+    return typeof input === 'string' ? new TextEncoder().encode(input).byteLength : input.byteLength;
+}
+function requireNoStore(response) {
+    const directives = response.headers
+        .get('cache-control')
+        ?.split(',')
+        .map((directive) => directive.trim().toLowerCase()) ?? [];
+    if (!directives.includes('no-store')) {
+        throw new ProtocolError('server response is missing Cache-Control: no-store.');
+    }
+}
+function transportFailure(input, control, parent, timeoutMs, url, phase, delivery) {
+    if (input instanceof ResponseError || input instanceof ProtocolError)
+        return input;
+    if (control.timedOut) {
+        return new TransportError(`request timed out after ${timeoutMs}ms.`, {
+            cause: asError(input),
+            phase: 'timeout',
+            delivery,
+        });
+    }
+    if (parent?.aborted)
+        return asError(parent.reason ?? input);
+    return input instanceof TransportError
+        ? input
+        : new TransportError(`Failed to communicate with the server at ${url}.`, {
+            cause: asError(input),
+            phase,
+            delivery,
+        });
+}
+function admitCodecName(input) {
+    if (input === undefined || input === 'json')
+        return 'json';
+    if (input === 'msgpack')
+        return input;
+    throw new TypeError('codec must be "json" or "msgpack".');
+}
+function admitFetch(input) {
+    const implementation = input ?? globalThis.fetch;
+    if (typeof implementation !== 'function') {
+        throw new TypeError('HttpTransport requires a Fetch implementation.');
+    }
+    return input === undefined ? implementation.bind(globalThis) : implementation;
+}
+const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
+const RESERVED_REQUEST_HEADERS = new Set([
+    'accept',
+    'accept-encoding',
+    'authorization',
+    'cache-control',
+    'connection',
+    'content-length',
+    'content-type',
+    'cookie',
+    'expect',
+    'forwarded',
+    'host',
+    'keep-alive',
+    'origin',
+    'pragma',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'referer',
+    'referrer-policy',
+    'set-cookie',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+    'via',
+]);
+function isReservedRequestHeader(name) {
+    return (RESERVED_REQUEST_HEADERS.has(name) ||
+        name.startsWith('access-control-') ||
+        name.startsWith('content-') ||
+        name.startsWith('proxy-') ||
+        name.startsWith('sec-websocket-') ||
+        name.startsWith('x-astrale-') ||
+        name.startsWith('x-forwarded-'));
+}
+function hasControlCharacter(input) {
+    for (let index = 0; index < input.length; index += 1) {
+        const code = input.charCodeAt(index);
+        if (code <= 0x1f || code === 0x7f)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport/http/transport.js.map

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

package/dist/transport/index.d.ts

@@ -1,8 +1,3 @@
-export type { BatchEntry, Transport, TransportRequest } from './contract.js';
-export { HttpEnvelopeTransport, type HttpEnvelopeTransportConfig } from './http-envelope.js';
-export { WsEnvelopeTransport, type WsEnvelopeTransportConfig } from './ws-envelope.js';
-export { HttpRoutedTransport, type HttpRoutedTransportConfig, type RoutedTransportRequest, } from './http-routed.js';
-export type { BinaryResponse } from './binary.js';
-export { safeFetch } from './fetch.js';
-export { nextRequestId } from './request-id.js';
+export type { RequestOptions, MissControl, StaleControl, Transport, TransportRequest, TransportResult, } from './transport.js';
+export { asError, controlledSignal, positiveInteger, requireLive, type ControlledSignal, } from './deadline.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AACtF,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../transport/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA"}

package/dist/transport/index.js

@@ -1,6 +1,2 @@
-export { HttpEnvelopeTransport } from './http-envelope.js';
-export { WsEnvelopeTransport } from './ws-envelope.js';
-export { HttpRoutedTransport, } from './http-routed.js';
-export { safeFetch } from './fetch.js';
-export { nextRequestId } from './request-id.js';
+export { asError, controlledSignal, positiveInteger, requireLive, } from './deadline.js';
 //# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAoC,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EAAE,mBAAmB,EAAkC,MAAM,kBAAkB,CAAA;AACtF,OAAO,EACL,mBAAmB,GAGpB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../transport/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,WAAW,GAEZ,MAAM,eAAe,CAAA"}

package/dist/transport/transport.d.ts

@@ -0,0 +1,29 @@
+import type { Result } from '@astrale-os/kernel-ports/functions';
+import type { invocation as protocol } from '@astrale-os/kernel-protocol';
+export interface RequestOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly idempotencyKey?: protocol.IdempotencyKey;
+}
+export interface TransportRequest {
+    readonly call: protocol.Call;
+    readonly credential?: string;
+    readonly delegate?: protocol.Delegate;
+    readonly routing?: protocol.Routing;
+}
+/** Correlated reserved control decoded independently from application results and errors. */
+export interface StaleControl {
+    readonly kind: 'stale';
+    readonly current: protocol.Stale['current'];
+}
+export interface MissControl {
+    readonly kind: 'miss';
+}
+export type TransportResult = Result | StaleControl | MissControl;
+export interface Transport {
+    /** Primary embedding-environment adapter for a complete invocation boundary. */
+    dispatch(input: TransportRequest, options?: RequestOptions): Promise<TransportResult>;
+    /** Optional owned-resource shutdown used by Client.close(). */
+    readonly close?: () => void;
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAEzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAA;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAA;CACpC;AAED,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,CAAA;AAEjE,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IACrF,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CAC5B"}

package/dist/transport/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../transport/transport.ts"],"names":[],"mappings":""}

package/dist/transport/websocket/connection.d.ts

@@ -0,0 +1,38 @@
+import { invocation as protocol, type codecs } from '@astrale-os/kernel-protocol';
+import type { ControlledSignal } from '../index.js';
+import type { TransportResult } from '../index.js';
+import type { ExchangeOwner } from './exchange.js';
+import type { WebSocketConstructor } from './transport.js';
+import { WebSocketExchange } from './exchange.js';
+export interface ConnectionOwner {
+    closed(connection: WebSocketConnection): void;
+}
+export declare class WebSocketConnection implements ExchangeOwner {
+    private readonly owner;
+    private readonly codec;
+    private readonly maximumRequestBytes;
+    private readonly maximumResponseBytes;
+    private readonly maximumBufferedBytes;
+    private readonly maximumActiveInvocations;
+    private readonly socket;
+    private readonly ready;
+    private resolveReady;
+    private rejectReady;
+    private opened;
+    private closedState;
+    private readonly active;
+    private readonly cancelled;
+    private incoming;
+    constructor(owner: ConnectionOwner, WebSocketConstructor: WebSocketConstructor, url: string, codec: codecs.Codec, maximumRequestBytes: number, maximumResponseBytes: number, maximumBufferedBytes: number, maximumActiveInvocations: number);
+    get isOpen(): boolean;
+    get isAvailable(): boolean;
+    connect(control: ControlledSignal): Promise<void>;
+    dispatch(request: protocol.Request, control: ControlledSignal, maximumBufferedItems: number): Promise<TransportResult>;
+    finish(exchange: WebSocketExchange, reusable: boolean, closeCode?: 1002 | 1008 | 1011): void;
+    cancel(exchange: WebSocketExchange, id: protocol.RequestId): void;
+    shutdown(reason?: Error, closeCode?: number, closeReason?: string): void;
+    private onOpen;
+    private onMessage;
+    private onFailure;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/transport/websocket/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../transport/websocket/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,eAAe,CAAA;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAI1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAKjD,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAA;CAC9C;AAED,qBAAa,mBAAoB,YAAW,aAAa;IAYrD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAGtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IAlB3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAoB;IAEpC,YACmB,KAAK,EAAE,eAAe,EACvC,oBAAoB,EAAE,oBAAoB,EAC1C,GAAG,EAAE,MAAM,EACM,KAAK,EAAE,MAAM,CAAC,KAAK,EACnB,mBAAmB,EAAE,MAAM,EAC3B,oBAAoB,EAAE,MAAM,EAC5B,oBAAoB,EAAE,MAAM,EAC5B,wBAAwB,EAAE,MAAM,EAYlD;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAEK,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CActD;IAED,QAAQ,CACN,OAAO,EAAE,QAAQ,CAAC,OAAO,EACzB,OAAO,EAAE,gBAAgB,EACzB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,eAAe,CAAC,CA+C1B;IAED,MAAM,CACJ,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,OAAO,EACjB,SAAS,GAAE,IAAI,GAAG,IAAI,GAAG,IAAW,GACnC,IAAI,CAYN;IAED,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAgChE;IAED,QAAQ,CACN,MAAM,GAAE,KAGN,EACF,SAAS,SAAO,EAChB,WAAW,SAAkB,GAC5B,IAAI,CAgBN;IAED,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,SAAS;CASlB"}