@cavi-ai/api-client 0.1.0

package/dist/core/gateway/resources/wiki.d.ts

@@ -0,0 +1,136 @@
+import { BaseHttpApiClient } from "../../http/client.js";
+import type { HttpApiClientOptions, HttpApiRequestInit } from "../../http/types.js";
+export declare const GATEWAY_WIKI_FORMATS: readonly ["qmd", "markdown", "html", "pdf", "text", "json"];
+export type GatewayWikiFormat = (typeof GATEWAY_WIKI_FORMATS)[number];
+export type GatewayWikiJsonValue = string | number | boolean | null | readonly GatewayWikiJsonValue[] | {
+    readonly [key: string]: GatewayWikiJsonValue;
+};
+export type GatewayWikiEndpointMap = {
+    vaults: string;
+    vault: (vaultId: string) => string;
+    tree: (vaultId: string) => string;
+    read: (vaultId: string, path: string) => string;
+    ingest: (vaultId: string) => string;
+    compile: (vaultId: string) => string;
+    promote: (vaultId: string) => string;
+    job: (vaultId: string, jobId: string) => string;
+    artifact: (vaultId: string, artifactId: string) => string;
+};
+export type GatewayWikiVault = {
+    id: string;
+    label?: string;
+    pluginId?: string;
+    rootPath?: string;
+    defaultFormat?: GatewayWikiFormat | string;
+    capabilities?: readonly string[];
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiVaultList = {
+    object?: string;
+    vaults: readonly GatewayWikiVault[];
+};
+export type GatewayWikiTreeEntry = {
+    path: string;
+    kind: "directory" | "file" | string;
+    title?: string;
+    format?: GatewayWikiFormat | string;
+    size?: number;
+    updatedAt?: string;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiTree = {
+    object?: string;
+    vaultId: string;
+    entries: readonly GatewayWikiTreeEntry[];
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiPage = {
+    object?: string;
+    vaultId: string;
+    path: string;
+    title?: string;
+    format?: GatewayWikiFormat | string;
+    content: string;
+    frontmatter?: Record<string, GatewayWikiJsonValue>;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiIngestRequest = {
+    path?: string;
+    title?: string;
+    content?: string;
+    sourceUrl?: string;
+    sourcePath?: string;
+    artifactId?: string;
+    format?: GatewayWikiFormat | string;
+    tags?: readonly string[];
+    frontmatter?: Record<string, GatewayWikiJsonValue>;
+    teamId?: string;
+    memberId?: string;
+    actionId?: string;
+    options?: Record<string, GatewayWikiJsonValue>;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiCompileRequest = {
+    path?: string;
+    paths?: readonly string[];
+    target?: GatewayWikiFormat | string;
+    outputPath?: string;
+    options?: Record<string, GatewayWikiJsonValue>;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiPromoteRequest = {
+    sourcePath?: string;
+    targetPath?: string;
+    artifactId?: string;
+    title?: string;
+    status?: string;
+    tags?: readonly string[];
+    frontmatter?: Record<string, GatewayWikiJsonValue>;
+    options?: Record<string, GatewayWikiJsonValue>;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiJobResult = {
+    object?: string;
+    id?: string;
+    jobId?: string;
+    vaultId?: string;
+    path?: string;
+    status: "queued" | "running" | "completed" | "failed" | "cancelled" | string;
+    artifactId?: string;
+    outputPath?: string;
+    page?: GatewayWikiPage;
+    error?: string;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayWikiArtifactRequest = Pick<HttpApiRequestInit, "cache" | "credentials" | "headers" | "signal" | "timeoutMs"> & {
+    accept?: string;
+};
+export type GatewayWikiApiClientOptions = {
+    endpoints?: GatewayWikiEndpointMap;
+    surface?: string;
+};
+export interface GatewayWikiClient {
+    listWikiVaults(): Promise<GatewayWikiVaultList>;
+    getWikiVault(vaultId: string): Promise<GatewayWikiVault>;
+    getWikiTree(vaultId: string): Promise<GatewayWikiTree>;
+    readWikiPage(vaultId: string, path: string): Promise<GatewayWikiPage>;
+    ingestWiki(vaultId: string, body: GatewayWikiIngestRequest, idempotencyKey?: string): Promise<GatewayWikiJobResult>;
+    compileWiki(vaultId: string, body: GatewayWikiCompileRequest, idempotencyKey?: string): Promise<GatewayWikiJobResult>;
+    promoteWiki(vaultId: string, body: GatewayWikiPromoteRequest, idempotencyKey?: string): Promise<GatewayWikiJobResult>;
+    getWikiJob(vaultId: string, jobId: string): Promise<GatewayWikiJobResult>;
+    getWikiArtifact(vaultId: string, artifactId: string, init?: GatewayWikiArtifactRequest): Promise<Blob>;
+}
+export declare class GatewayWikiApiClient extends BaseHttpApiClient implements GatewayWikiClient {
+    readonly endpoints: GatewayWikiEndpointMap;
+    constructor(options: HttpApiClientOptions, wikiOptions?: GatewayWikiApiClientOptions);
+    listWikiVaults(): Promise<GatewayWikiVaultList>;
+    getWikiVault(vaultId: string): Promise<GatewayWikiVault>;
+    getWikiTree(vaultId: string): Promise<GatewayWikiTree>;
+    readWikiPage(vaultId: string, path: string): Promise<GatewayWikiPage>;
+    ingestWiki(vaultId: string, body: GatewayWikiIngestRequest, idempotencyKey?: string): Promise<GatewayWikiJobResult>;
+    compileWiki(vaultId: string, body: GatewayWikiCompileRequest, idempotencyKey?: string): Promise<GatewayWikiJobResult>;
+    promoteWiki(vaultId: string, body: GatewayWikiPromoteRequest, idempotencyKey?: string): Promise<GatewayWikiJobResult>;
+    getWikiJob(vaultId: string, jobId: string): Promise<GatewayWikiJobResult>;
+    getWikiArtifact(vaultId: string, artifactId: string, init?: GatewayWikiArtifactRequest): Promise<Blob>;
+}
+//# sourceMappingURL=wiki.d.ts.map

package/dist/core/gateway/resources/wiki.d.ts.map

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

package/dist/core/gateway/resources/wiki.js

@@ -0,0 +1,72 @@
+import { GATEWAY_WIKI_API_ENDPOINTS } from "../../../contracts/paths.js";
+import { BaseHttpApiClient } from "../../http/client.js";
+export const GATEWAY_WIKI_FORMATS = [
+    "qmd",
+    "markdown",
+    "html",
+    "pdf",
+    "text",
+    "json",
+];
+function requiredText(value, label) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw new Error(`gateway wiki: missing ${label}`);
+    }
+    return normalized;
+}
+function normalizeVaultId(vaultId) {
+    return requiredText(vaultId, "wiki vault id");
+}
+export class GatewayWikiApiClient extends BaseHttpApiClient {
+    endpoints;
+    constructor(options, wikiOptions = {}) {
+        super(wikiOptions.surface ?? "gateway-wiki-api", options);
+        this.endpoints = wikiOptions.endpoints ?? GATEWAY_WIKI_API_ENDPOINTS;
+    }
+    listWikiVaults() {
+        return this.requestJson(this.endpoints.vaults);
+    }
+    getWikiVault(vaultId) {
+        return this.requestJson(this.endpoints.vault(normalizeVaultId(vaultId)));
+    }
+    getWikiTree(vaultId) {
+        return this.requestJson(this.endpoints.tree(normalizeVaultId(vaultId)));
+    }
+    readWikiPage(vaultId, path) {
+        return this.requestJson(this.endpoints.read(normalizeVaultId(vaultId), requiredText(path, "wiki page path")));
+    }
+    ingestWiki(vaultId, body, idempotencyKey) {
+        return this.requestJson(this.endpoints.ingest(normalizeVaultId(vaultId)), {
+            method: "POST",
+            body,
+            idempotencyKey,
+        });
+    }
+    compileWiki(vaultId, body, idempotencyKey) {
+        return this.requestJson(this.endpoints.compile(normalizeVaultId(vaultId)), {
+            method: "POST",
+            body,
+            idempotencyKey,
+        });
+    }
+    promoteWiki(vaultId, body, idempotencyKey) {
+        return this.requestJson(this.endpoints.promote(normalizeVaultId(vaultId)), {
+            method: "POST",
+            body,
+            idempotencyKey,
+        });
+    }
+    getWikiJob(vaultId, jobId) {
+        return this.requestJson(this.endpoints.job(normalizeVaultId(vaultId), requiredText(jobId, "wiki job id")));
+    }
+    getWikiArtifact(vaultId, artifactId, init = {}) {
+        return this.requestBlob(this.endpoints.artifact(normalizeVaultId(vaultId), requiredText(artifactId, "wiki artifact id")), {
+            ...init,
+            headers: {
+                Accept: init.accept ?? "application/octet-stream",
+                ...(init.headers ?? {}),
+            },
+        });
+    }
+}

package/dist/core/gateway/rpc/client.d.ts

@@ -0,0 +1,150 @@
+import { type DeviceIdentity } from "./device-store.js";
+import { type GatewayPreauthHandshakeEnv, type GatewayPreauthHandshakeEnvKeys } from "./preauth-handshake.js";
+export { GatewayRpcError } from "./error.js";
+export { DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS, GATEWAY_PREAUTH_HANDSHAKE_ENV_KEYS, resolvePreauthHandshakeTimeoutMs, resolveDeviceTokenOnlyFallbackMs, resolvePreauthHandshakeTimeoutMsFromEnv, type GatewayPreauthHandshakeEnv, type GatewayPreauthHandshakeEnvKeys, type ResolvePreauthHandshakeTimeoutMsParams, type ResolveDeviceTokenOnlyFallbackMsParams, } from "./preauth-handshake.js";
+export { signPayload } from "./device-crypto.js";
+export { loadOrCreateDeviceIdentity, isDeviceIdentitySupported, type DeviceIdentity, } from "./device-store.js";
+export { BASELINE_SESSIONS_LIST_PARAMS, EMPTY_SESSIONS_USAGE, SESSIONS_DETAIL_CACHE_TTL_MS, canonicalizeSessionDetailParams, canonicalizeSessionsListParams, canonicalizeSessionsPreviewParams, canonicalizeSessionsUsageParams, createSessionLoaders, isUnchangedSessionsListPayload, normalizeSessionsListPayload, type SessionDetailPayload, type SessionDetailRequestParams, type SessionLoaders, type SessionPatchInput, type SessionsListPayloadWithCache, type SessionsListRequestParams, type SessionsListRpcPayload, type SessionsListUnchangedPayload, type SessionsPreviewRequestParams, } from "../snapshots/session-loaders.js";
+export type GatewayStreamEvent = {
+    event: string;
+    payload: unknown;
+};
+export type GatewayConnectionState = "idle" | "connecting" | "reconnecting" | "connected" | "error";
+export declare const DEFAULT_GATEWAY_PROTOCOL_VERSION = 4;
+/** Completed WebSocket RPC (after response or failure). Params are redacted. */
+export type GatewayRpcTraceEntry = {
+    at: number;
+    transport: "websocket";
+    correlationId: string;
+    method: string;
+    durationMs: number;
+    ok: boolean;
+    params: Record<string, unknown>;
+    /** JSON preview of successful payload (bounded). */
+    resultPreview?: string;
+    /** Populated when `ok` is false. */
+    error?: {
+        name: string;
+        message: string;
+        code?: string;
+    };
+};
+export type GatewayRpcClientOptions = {
+    clientId?: string;
+    clientVersion?: string;
+    clientMode?: string;
+    clientPlatform?: string;
+    /**
+     * Gateway protocol compatibility range to advertise during connect.
+     * Defaults to the current generic gateway protocol. Override only when
+     * talking to a gateway with a known alternate compatibility contract.
+     */
+    minProtocol?: number;
+    maxProtocol?: number;
+    enableDeviceIdentity?: boolean;
+    /**
+     * Optional platform-specific device identity loader. Browser callers use the
+     * built-in IndexedDB/WebCrypto store; React Native callers can provide a
+     * SecureStore-backed loader while still using the shared connect signer.
+     */
+    deviceIdentityLoader?: () => Promise<DeviceIdentity | null>;
+    /**
+     * Operator scopes to request on connect. Empty/blank entries are ignored.
+     * When omitted, defaults to `["operator.read"]` for backwards compatibility;
+     * callers needing admin-level methods (e.g. `device.pair.approve`) must opt in
+     * explicitly so the gateway does not silently downgrade them to read-only.
+     */
+    requestedScopes?: readonly string[];
+    /**
+     * Gateway pre-auth handshake budget (ms). Set this to the same value as server
+     * handshake config when it is not the default, especially for browser clients
+     * that cannot read gateway env.
+     */
+    preauthHandshakeTimeoutMs?: number;
+    /**
+     * Env bag and keys for provider-specific pre-auth handshake config. Core uses
+     * GATEWAY_* keys by default; providers can pass their own keys without baking
+     * product names into the core client.
+     */
+    preauthHandshakeEnv?: GatewayPreauthHandshakeEnv;
+    preauthHandshakeEnvKeys?: GatewayPreauthHandshakeEnvKeys;
+    /** Override the per-RPC response timeout. */
+    requestTimeoutMs?: number;
+    /** Override client-side RPC concurrency. */
+    maxConcurrentRequests?: number;
+    /** Override the default requested scopes used when requestedScopes is omitted. */
+    defaultRequestedScopes?: readonly string[];
+    /**
+     * Optional hook for completed RPCs (success, gateway error, timeout, or send failure).
+     * Params are redacted; payloads are truncated. Must not throw.
+     */
+    onRpcTrace?: (entry: GatewayRpcTraceEntry) => void;
+};
+export declare function resolveGatewayConnectScopes(options?: GatewayRpcClientOptions): string[];
+/** Resolved client fields for `connect` and device-auth v3 signing (must stay aligned). */
+export type ResolvedGatewayRpcClientProfile = {
+    clientId: string;
+    clientVersion: string;
+    clientPlatform: string;
+    clientMode: string;
+};
+export declare function resolveGatewayRpcClientProfile(options?: GatewayRpcClientOptions): ResolvedGatewayRpcClientProfile;
+/** Defaults for React Native while preserving caller-provided client identity. */
+export declare function mergeGatewayRpcClientOptionsForReactNative(options?: GatewayRpcClientOptions): GatewayRpcClientOptions;
+export declare function createGatewayRpcConnectParams(params: {
+    authToken: string | null;
+    userAgent: string;
+    locale: string;
+    options?: GatewayRpcClientOptions;
+    device?: {
+        id: string;
+        publicKey: string;
+        signature: string;
+        signedAt: number;
+        nonce: string;
+    } | null;
+}): Record<string, unknown>;
+export declare class GatewayRpcClient {
+    private readonly wsUrl;
+    private readonly authToken;
+    private readonly options;
+    private socket;
+    private connectPromise;
+    private pending;
+    private activeRpcRequests;
+    private queuedRpcRequests;
+    private sequence;
+    private connected;
+    /** Set when a connect RPC is explicitly rejected (auth failure, etc.) so onClose
+     *  does not emit a retryable socket_closed error that triggers an infinite reconnect loop. */
+    private connectRejected;
+    private eventListeners;
+    private stateListeners;
+    private state;
+    private lastError;
+    private intentionalClose;
+    private emitRpcTrace;
+    private deviceIdentity;
+    private deviceIdentityReady;
+    /** Incremented on each connect attempt; stale async connect paths must not resolve the outer promise. */
+    private connectAttemptSeq;
+    constructor(wsUrl: string, authToken: string | null, options?: GatewayRpcClientOptions);
+    getConnectionState(): GatewayConnectionState;
+    getLastError(): Error | null;
+    onEvent(listener: (event: GatewayStreamEvent) => void): () => void;
+    onStateChange(listener: (state: GatewayConnectionState, error: Error | null) => void): () => void;
+    connect(): Promise<void>;
+    request<TPayload>(method: string, params?: Record<string, unknown>): Promise<TPayload>;
+    close(): Promise<void>;
+    private setState;
+    private getConnectClientInfo;
+    private ensureConnected;
+    private requestRaw;
+    private runWithRpcBackpressure;
+    private drainQueuedRpcRequests;
+    private rejectQueuedRpcRequests;
+    private handleMessage;
+}
+export { resolveGatewayTargets, tryResolveGatewayTargets, } from "../../ws/targets.js";
+export { PORTAL_CONFIG_PATCH_CLIENT_ID_HEADER, PORTAL_CONFIG_PATCH_CONTRACT, PORTAL_CONFIG_PATCH_CONTRACT_VERSION, PortalConfigPatchError, portalConfigPatchPath, postPortalConfigPatch, unflattenPortalConfigPatchKeys, type PortalConfigPatchRequestBody, type PostPortalConfigPatchParams, } from "../portal/config-patch.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/core/gateway/rpc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/rpc/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACpC,MAAM,wBAAwB,CAAC;AAYhC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,uCAAuC,EACvC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,sCAAsC,EAC3C,KAAK,sCAAsC,GAC5C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,+BAA+B,EAC/B,8BAA8B,EAC9B,iCAAiC,EACjC,+BAA+B,EAC/B,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,iCAAiC,CAAC;AA0CzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,YAAY,GACZ,cAAc,GACd,WAAW,GACX,OAAO,CAAC;AAIZ,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAIlD,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,WAAW,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5D;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,uBAAuB,CAAC,EAAE,8BAA8B,CAAC;IACzD,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kFAAkF;IAClF,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACpD,CAAC;AAsBF,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,uBAAuB,GAChC,MAAM,EAAE,CAUV;AAED,2FAA2F;AAC3F,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,OAAO,CAAC,EAAE,uBAAuB,GAChC,+BAA+B,CAajC;AAoBD,kFAAkF;AAClF,wBAAgB,0CAA0C,CACxD,OAAO,CAAC,EAAE,uBAAuB,GAChC,uBAAuB,CAOzB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,MAAM,CAAC,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,IAAI,CAAC;CACV,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4B1B;AAyGD,qBAAa,gBAAgB;IAmDzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IApD1B,OAAO,CAAC,MAAM,CAA0B;IAExC,OAAO,CAAC,cAAc,CAA8B;IAEpD,OAAO,CAAC,OAAO,CAAqC;IAEpD,OAAO,CAAC,iBAAiB,CAAK;IAE9B,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,OAAO,CAAC,QAAQ,CAAK;IAErB,OAAO,CAAC,SAAS,CAAS;IAE1B;kGAC8F;IAC9F,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,cAAc,CAAkD;IAExE,OAAO,CAAC,cAAc,CAElB;IAEJ,OAAO,CAAC,KAAK,CAAkC;IAE/C,OAAO,CAAC,SAAS,CAAsB;IAEvC,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc,CAA+B;IAErD,OAAO,CAAC,mBAAmB,CAAgB;IAE3C,yGAAyG;IACzG,OAAO,CAAC,iBAAiB,CAAK;gBAGX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,GAAE,uBAA4B;IAuBxD,kBAAkB,IAAI,sBAAsB;IAI5C,YAAY,IAAI,KAAK,GAAG,IAAI;IAI5B,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,aAAa,CACX,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GACrE,MAAM,IAAI;IAqBP,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,CAAC,QAAQ,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,QAAQ,CAAC;IAOd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,oBAAoB;YAUd,eAAe;YAmPf,UAAU;YA8GV,sBAAsB;IA+BpC,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,aAAa;CAiDtB;AAED,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oCAAoC,EACpC,4BAA4B,EAC5B,oCAAoC,EACpC,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,8BAA8B,EAC9B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,GACjC,MAAM,2BAA2B,CAAC"}