@gloocan/cat-inspector 0.1.1

package/dist/type-string-normalize.js

@@ -0,0 +1,178 @@
+/**
+ * Normalize TypeScript `typeToString` output for comparison with `getType(result)` strings.
+ * Best-effort: peels `Labeled<"L", T>`, optional `Readonly<T>`, `Promise<T>`, and checks union membership.
+ */
+/** Split `a | b | c` at top-level `|` respecting `<>` and `()` depth. */
+export function splitTopLevelUnion(s) {
+    const t = s.trim();
+    if (!t.includes('|'))
+        return [t];
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < t.length; i++) {
+        const c = t[i];
+        if (c === '<' || c === '(')
+            depth++;
+        else if (c === '>' || c === ')')
+            depth = Math.max(0, depth - 1);
+        else if (c === '|' && depth === 0) {
+            parts.push(t.slice(start, i).trim());
+            start = i + 1;
+        }
+    }
+    parts.push(t.slice(start).trim());
+    return parts.filter(Boolean);
+}
+function splitFirstGenericArg(content) {
+    let depth = 0;
+    for (let i = 0; i < content.length; i++) {
+        const c = content[i];
+        if (c === '<' || c === '(')
+            depth++;
+        else if (c === '>' || c === ')')
+            depth = Math.max(0, depth - 1);
+        else if (c === ',' && depth === 0) {
+            return [content.slice(0, i).trim(), content.slice(i + 1).trim()];
+        }
+    }
+    return null;
+}
+/**
+ * If `s` starts with `Labeled<...>`, return the inner payload type `T` (second type arg).
+ */
+export function peelOuterLabeled(s) {
+    const t = s.trim();
+    const prefix = t.match(/^Labeled\s*</i);
+    if (!prefix)
+        return null;
+    const openAngle = prefix[0].length - 1;
+    let depth = 0;
+    for (let j = openAngle; j < t.length; j++) {
+        const c = t[j];
+        if (c === '<')
+            depth++;
+        else if (c === '>') {
+            depth--;
+            if (depth === 0) {
+                const inner = t.slice(openAngle + 1, j);
+                const pair = splitFirstGenericArg(inner);
+                if (!pair)
+                    return null;
+                return pair[1].trim();
+            }
+        }
+    }
+    return null;
+}
+/** Strip one layer of `Readonly<T>` / `Readonly<T >` if present. */
+export function peelReadonly(s) {
+    const t = s.trim();
+    const m = /^Readonly\s*</i.exec(t);
+    if (!m || m.index !== 0)
+        return null;
+    const open = m[0].length - 1;
+    let depth = 0;
+    for (let j = open; j < t.length; j++) {
+        const c = t[j];
+        if (c === '<')
+            depth++;
+        else if (c === '>') {
+            depth--;
+            if (depth === 0) {
+                return t.slice(open + 1, j).trim();
+            }
+        }
+    }
+    return null;
+}
+/** Strip one layer of `Promise<T>` if present (async functions use `Promise<...>` in catalog). */
+export function peelPromise(s) {
+    const t = s.trim();
+    const m = /^Promise\s*</i.exec(t);
+    if (!m || m.index !== 0)
+        return null;
+    const open = m[0].length - 1;
+    let depth = 0;
+    for (let j = open; j < t.length; j++) {
+        const c = t[j];
+        if (c === '<')
+            depth++;
+        else if (c === '>') {
+            depth--;
+            if (depth === 0) {
+                return t.slice(open + 1, j).trim();
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Recursively peel `Labeled`, `Readonly`, and `Promise` wrappers until stable, then trim.
+ */
+export function normalizeReturnTypeForRpcCompare(input) {
+    let s = input.trim();
+    let prev = '';
+    while (s !== prev) {
+        prev = s;
+        {
+            const lower = s.toLowerCase();
+            // Treat numeric aliases as `number` for runtime comparisons.
+            if (lower === 'int' ||
+                lower === 'integer' ||
+                lower === 'int32' ||
+                lower === 'int64' ||
+                lower === 'float' ||
+                lower === 'float32' ||
+                lower === 'float64' ||
+                lower === 'double' ||
+                lower === 'decimal') {
+                s = 'number';
+                continue;
+            }
+        }
+        // JS runtime uses `undefined` for `void` returns.
+        if (s === 'void') {
+            s = 'undefined';
+            continue;
+        }
+        const l = peelOuterLabeled(s);
+        if (l !== null) {
+            s = l;
+            continue;
+        }
+        const r = peelReadonly(s);
+        if (r !== null) {
+            s = r;
+            continue;
+        }
+        const p = peelPromise(s);
+        if (p !== null) {
+            s = p;
+            continue;
+        }
+        // Runtime `returnType` is coarse for objects (`object`), while TypeScript
+        // declarations can be object-literals (`{ a: number }`). Treat object-literals as `object`.
+        if (s.startsWith('{') && s.endsWith('}')) {
+            s = 'object';
+            continue;
+        }
+    }
+    return s.trim();
+}
+/**
+ * True if normalized `expected` equals normalized `actual`, or if `expected` is a union
+ * and `actual` matches any union member after normalization.
+ */
+export function typesMatchForRpc(expected, actual) {
+    const expN = normalizeReturnTypeForRpcCompare(expected);
+    const actN = normalizeReturnTypeForRpcCompare(actual);
+    if (expN === actN)
+        return true;
+    const members = splitTopLevelUnion(expN);
+    if (members.length > 1) {
+        return members.some((m) => normalizeReturnTypeForRpcCompare(m) === actN);
+    }
+    return false;
+}
+//# sourceMappingURL=type-string-normalize.js.map

package/dist/type-string-normalize.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,218 @@
+export declare const PROTOCOL_VERSION: 10;
+export interface ReturnEntry {
+    label: string;
+    type: string | null;
+    status: 'pending' | 'resolved';
+}
+export interface ErrorEntry {
+    label: string;
+    type: string | null;
+    message: string | null;
+    status: 'pending' | 'resolved';
+}
+export interface ApiResponseEntry {
+    label: string;
+    statusCode: number | null;
+    bodyShape: string | null;
+    status: 'pending' | 'resolved';
+}
+export type CatMode = 'service' | 'api_candidate' | 'api';
+export type ParamKind = 'json' | 'file' | 'files';
+/** Wire encoding for file params on RPC; default on catalog is `ref`. */
+export type QaFileWireMode = 'ref' | 'url';
+/** Where tenant web uploads bytes before persisting `__qaFileUrl` (catalog hint only). */
+export type QaMediaUploadTarget = 'admin' | 'host';
+export type RegistryParam = {
+    name: string;
+    type: string;
+    /**
+     * Optional richer classification for QA UIs and file materialization.
+     *
+     * - `file`: param value itself is a single file (File/Blob/Buffer/etc.)
+     * - `files`: param value itself is an array of files (File[]/Blob[]/Buffer[]/etc.)
+     * - `json`: default / everything else
+     */
+    kind?: ParamKind;
+    /** Nested single-file fields inside an object param (e.g. `input.file`). */
+    filePaths?: string[];
+    /** Nested multi-file (array-of-file) fields inside an object param (e.g. `input.attachments`). */
+    fileArrayPaths?: string[];
+    /** Copied from host bootstrap for QA UI (scenario builder). Omitted for non-file params. */
+    qaFileWire?: QaFileWireMode;
+    /** When `qaFileWire` is `url`, which upload API the UI should use. */
+    qaMediaUpload?: QaMediaUploadTarget;
+};
+export interface RegistryEntry {
+    mode: CatMode;
+    className: string;
+    method: string;
+    style: 'class' | 'function';
+    body: string;
+    params: RegistryParam[];
+    declaredReturn: string;
+    returns: ReturnEntry[];
+    errors: ErrorEntry[];
+    children: string[];
+    parents: string[];
+    route: string | null;
+    httpMethod: string | null;
+    apiResponses: ApiResponseEntry[];
+    serviceLinks: string[];
+    pipelineId: string | null;
+    pipelineIndex: number | null;
+    /** Optional JSON Schema (draft-07 subset) for the entire positional `args` array (tuple-style). */
+    paramsJsonSchema?: Record<string, unknown> | null;
+    /** Optional JSON Schema (draft-07 subset) for QA validation of RPC `result` */
+    returnJsonSchema?: Record<string, unknown> | null;
+    /** When `http_synthetic`, `executeRPC` runs in-process HTTP via `registerHttpBridgeRoute` instead of `originalFn`. */
+    invokeKind?: 'rpc' | 'http_synthetic';
+    /** For Express handler matching (CatRouter / registerCatPipeline) */
+    originalFn: Function;
+}
+export interface RpcErrorDetail {
+    message: string;
+    stack: string | null;
+    layer: 'validation' | 'expected' | 'unexpected';
+    /** Machine-readable code (e.g. `FN_NOT_FOUND`, `RATE_LIMITED`); optional for back-compat. */
+    code?: string;
+}
+export interface RpcArtifactRef {
+    kind: string;
+    uploadUrl?: string;
+    objectKey?: string;
+    expiresAt?: string;
+    [key: string]: unknown;
+}
+export interface RpcResponse {
+    type: 'RPC_RESPONSE';
+    requestId: string;
+    fnKey: string;
+    status: 'ok' | 'error';
+    result: unknown;
+    returnType: string;
+    /** Runtime `getShape(result)` when status is ok; null on error */
+    returnShape: string | null;
+    label: string | null;
+    duration: string;
+    error: RpcErrorDetail | null;
+    /** Optional artifact handles (protocol v7+). */
+    artifacts?: RpcArtifactRef[];
+}
+export interface CoverageRequest {
+    type: 'COVERAGE_REQUEST';
+}
+export interface CoverageReportWire {
+    type: 'COVERAGE_REPORT';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    /** Present on success */
+    report?: unknown;
+    /** Present on failure */
+    error?: string;
+}
+export interface BootstrapEvent {
+    event: 'BOOTSTRAP';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    registry: Record<string, RegistryEntry>;
+    tree: object[];
+    /** v9+: wire mode for file params (`ref` = __qaFileRef, `url` = __qaFileUrl). */
+    qaFileWire?: {
+        mode: QaFileWireMode;
+    };
+    /** v9+: catalog hint for URL-mode uploads (no secrets). */
+    qaMediaUpload?: {
+        target: QaMediaUploadTarget;
+    };
+    /** v9+: invoke-time URL fetch allowlist (hostnames only). */
+    fileUrl?: {
+        allowedHosts: string[];
+        maxDownloadBytes: number;
+        timeoutMs: number;
+        maxRedirects?: number;
+        allowHttp?: boolean;
+    };
+    /** v9+: HTTPS base for host-only Minio upload when `qaMediaUpload.target === 'host'` (no credentials). */
+    qaMediaUploadHostUploadUrl?: string;
+    /** v10+: when true, tenant may stream bytes over Socket.IO `qa:hostMedia:*` instead of HTTP `qaMediaUploadHostUploadUrl`. */
+    qaHostMediaUploadViaSocket?: boolean;
+}
+export interface ReturnResolvedEvent {
+    event: 'RETURN_RESOLVED';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    fnKey: string;
+    label: string;
+    type: string;
+    timestamp: string;
+    /** Optional: attach correlation for HTTP-originated traces */
+    correlationId?: string;
+}
+export interface ErrorThrownEvent {
+    event: 'ERROR_THROWN';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    fnKey: string;
+    label: string;
+    layer: RpcErrorDetail['layer'];
+    message: string;
+    stack: string | null;
+    timestamp: string;
+    correlationId?: string;
+}
+export interface ApiResponseEvent {
+    event: 'API_RESPONSE';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    endpointKey: string;
+    /**
+     * Optional: which pipeline handler produced this response.
+     * When middleware returns early (no next()), this should be that middleware fnKey so UI can mark it as fail/warn.
+     */
+    producerFnKey?: string | null;
+    label: string;
+    statusCode: number;
+    bodyShape: string;
+    /**
+     * Optional JSON payload for debugging/QA (may be omitted/redacted/size-limited).
+     * Intended to help QA see validation issues without guessing from `bodyShape`.
+     */
+    body?: unknown;
+    timestamp: string;
+    correlationId?: string;
+}
+export interface MiddlewareNextEvent {
+    event: 'MIDDLEWARE_NEXT';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    /** Middleware fnKey (matches expected pipeline handler title) */
+    fnKey: string;
+    /** Optional label for display, e.g. NEXT */
+    label?: string;
+    timestamp: string;
+    correlationId?: string;
+}
+export interface RpcExecutedEvent {
+    event: 'RPC_EXECUTED';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    requestId: string;
+    fnKey: string;
+    label: string | null;
+    status: 'ok' | 'error';
+    duration: string;
+    timestamp: string;
+}
+/** Server → client job progress (inspector broadcast / optional strict parsers). */
+export interface JobProgressWireEvent {
+    event: 'JOB_PROGRESS';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    jobId: string;
+    status: 'queued' | 'running' | 'done' | 'failed';
+    percent?: number;
+    detail?: string;
+    timestamp: string;
+}
+/** Server → client session snapshot after `SESSION_CREATE` / `SESSION_STEP` on WebSocket transport. */
+export interface SessionStateWireMessage {
+    type: 'SESSION_STATE';
+    protocolVersion: typeof PROTOCOL_VERSION;
+    requestId: string;
+    sessionId: string;
+    data: Record<string, unknown>;
+}
+export type InspectorWireEvent = BootstrapEvent | ReturnResolvedEvent | ErrorThrownEvent | ApiResponseEvent | MiddlewareNextEvent | RpcExecutedEvent | RpcResponse | CoverageReportWire | JobProgressWireEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export const PROTOCOL_VERSION = 10;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAW,CAAA"}

package/dist/upload/fetch-file-url.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HTTPS fetch for __qaFileUrl materialization (SSRF-safe allowlist, size cap, timeout).
+ */
+export type FetchFileUrlOptions = {
+    /** Hostnames allowed (exact match, case-insensitive). Entry starting with `.` matches hostname suffix (e.g. `.amazonaws.com`). */
+    allowedHosts: string[];
+    maxDownloadBytes: number;
+    timeoutMs: number;
+    /** Default 3 */
+    maxRedirects?: number;
+    /** When true, allow http: URLs (dev only). Default false. */
+    allowHttp?: boolean;
+};
+export declare function isHostnameAllowed(hostname: string, allowedHosts: string[]): boolean;
+export type FetchedFileBytes = {
+    buffer: Buffer;
+    contentType: string;
+    filename: string;
+};
+/**
+ * GET url, enforce allowlist + max bytes + timeout. Follows redirects up to maxRedirects.
+ */
+export declare function fetchFileUrl(urlString: string, options: FetchFileUrlOptions): Promise<FetchedFileBytes>;
+//# sourceMappingURL=fetch-file-url.d.ts.map

package/dist/upload/fetch-file-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-file-url.d.ts","sourceRoot":"","sources":["../../src/upload/fetch-file-url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IACjC,kIAAkI;IAClI,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAYnF;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CAChB,CAAA;AAOD;;GAEG;AACH,wBAAsB,YAAY,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAwG3B"}

package/dist/upload/fetch-file-url.js

@@ -0,0 +1,130 @@
+/**
+ * HTTPS fetch for __qaFileUrl materialization (SSRF-safe allowlist, size cap, timeout).
+ */
+function normalizeHost(hostname) {
+    return hostname.trim().toLowerCase();
+}
+export function isHostnameAllowed(hostname, allowedHosts) {
+    const h = normalizeHost(hostname);
+    for (const entry of allowedHosts) {
+        const e = entry.trim().toLowerCase();
+        if (!e)
+            continue;
+        if (e.startsWith('.')) {
+            if (h === e.slice(1) || h.endsWith(e))
+                return true;
+        }
+        else if (h === e) {
+            return true;
+        }
+    }
+    return false;
+}
+function filenameFromUrl(url) {
+    const last = url.pathname.split('/').filter(Boolean).pop();
+    return last && last.length > 0 ? decodeURIComponent(last) : 'download.bin';
+}
+/**
+ * GET url, enforce allowlist + max bytes + timeout. Follows redirects up to maxRedirects.
+ */
+export async function fetchFileUrl(urlString, options) {
+    const { allowedHosts, maxDownloadBytes, timeoutMs, maxRedirects = 3, allowHttp = false } = options;
+    if (!allowedHosts.length) {
+        throw new Error('FILE_URL_FETCH_FAILED: fileUrl.allowedHosts is empty');
+    }
+    let current = urlString.trim();
+    let redirects = 0;
+    while (redirects <= maxRedirects) {
+        let url;
+        try {
+            url = new URL(current);
+        }
+        catch {
+            throw new Error('FILE_URL_FETCH_FAILED: invalid URL');
+        }
+        if (url.protocol !== 'https:' && !(allowHttp && url.protocol === 'http:')) {
+            throw new Error(`FILE_URL_FETCH_FAILED: only ${allowHttp ? 'http and ' : ''}https URLs are allowed`);
+        }
+        if (!isHostnameAllowed(url.hostname, allowedHosts)) {
+            throw new Error(`FILE_URL_HOST_NOT_ALLOWED: ${url.hostname}`);
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let res;
+        try {
+            res = await fetch(current, {
+                method: 'GET',
+                redirect: 'manual',
+                signal: controller.signal,
+            });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : 'fetch failed';
+            if (e?.name === 'AbortError') {
+                throw new Error(`FILE_URL_FETCH_FAILED: timeout after ${timeoutMs}ms`);
+            }
+            throw new Error(`FILE_URL_FETCH_FAILED: ${msg}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (res.status >= 300 && res.status < 400) {
+            const loc = res.headers.get('location');
+            if (!loc)
+                throw new Error('FILE_URL_FETCH_FAILED: redirect without Location');
+            redirects++;
+            if (redirects > maxRedirects)
+                throw new Error('FILE_URL_FETCH_FAILED: too many redirects');
+            current = new URL(loc, current).href;
+            continue;
+        }
+        if (!res.ok) {
+            throw new Error(`FILE_URL_FETCH_FAILED: HTTP ${res.status}`);
+        }
+        const cl = res.headers.get('content-length');
+        if (cl !== null) {
+            const n = Number(cl);
+            if (Number.isFinite(n) && n > maxDownloadBytes) {
+                throw new Error(`FILE_URL_TOO_LARGE: Content-Length ${n} exceeds max ${maxDownloadBytes}`);
+            }
+        }
+        const reader = res.body?.getReader();
+        if (!reader) {
+            const buf = Buffer.from(await res.arrayBuffer());
+            if (buf.byteLength > maxDownloadBytes) {
+                throw new Error(`FILE_URL_TOO_LARGE: body exceeds max ${maxDownloadBytes}`);
+            }
+            const contentType = res.headers.get('content-type')?.split(';')[0]?.trim() || 'application/octet-stream';
+            return {
+                buffer: buf,
+                contentType,
+                filename: filenameFromUrl(new URL(current)),
+            };
+        }
+        const chunks = [];
+        let total = 0;
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (!value)
+                continue;
+            const buf = Buffer.from(value);
+            total += buf.byteLength;
+            if (total > maxDownloadBytes) {
+                await reader.cancel().catch(() => { });
+                throw new Error(`FILE_URL_TOO_LARGE: body exceeds max ${maxDownloadBytes}`);
+            }
+            chunks.push(buf);
+        }
+        const buffer = Buffer.concat(chunks);
+        const contentType = res.headers.get('content-type')?.split(';')[0]?.trim() || 'application/octet-stream';
+        return {
+            buffer,
+            contentType,
+            filename: filenameFromUrl(new URL(current)),
+        };
+    }
+    throw new Error('FILE_URL_FETCH_FAILED: redirect loop');
+}
+//# sourceMappingURL=fetch-file-url.js.map

package/dist/upload/fetch-file-url.js.map

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

package/dist/upload/host-minio-client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Host-held Minio/S3: parse {@link HostMinioOptions} and upload bytes + presign GET (never on catalog wire).
+ */
+import type { HostMinioOptions } from '../bootstrap.js';
+export type ParsedHostMinioClientConfig = {
+    endPoint: string;
+    port: number;
+    useSSL: boolean;
+    accessKey: string;
+    secretKey: string;
+    region?: string;
+    pathStyle: boolean;
+};
+/** Parse `HostMinioOptions.endpoint` into Minio `Client` fields (hostname, port, TLS). */
+export declare function parseHostMinioEndpoint(host: HostMinioOptions): ParsedHostMinioClientConfig;
+export type PutBufferAndPresignGetInput = {
+    objectKey: string;
+    buffer: Buffer;
+    contentType: string;
+    /** Default 24h */
+    getExpirySeconds?: number;
+};
+/**
+ * `putObject` then `presignedGetObject`. Uses dynamic `import('minio')` so consumers can keep `minio` as optional peer.
+ */
+export declare function putBufferAndPresignGetUrl(host: HostMinioOptions, input: PutBufferAndPresignGetInput): Promise<{
+    getUrl: string;
+    objectKey: string;
+}>;
+//# sourceMappingURL=host-minio-client.d.ts.map

package/dist/upload/host-minio-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-minio-client.d.ts","sourceRoot":"","sources":["../../src/upload/host-minio-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,MAAM,MAAM,2BAA2B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,2BAA2B,CA8B1F;AAED,MAAM,MAAM,2BAA2B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC9C,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,2BAA2B,GAChC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBhD"}