@hasna/recordings 0.3.13 → 0.5.0

package/dist/cli/macos-shortcut.d.ts

@@ -80,7 +80,7 @@ export declare const TOGGLE_RECORDING_DEFAULTS_KEY = "KeyboardShortcuts_toggleRe
  * thing — and so the claim can be pinned against the Swift source that implements it.
  *
  * Verified against the shipped bundle on 2026-07-27 with `nm -u` on
- * HasnaRecordings.app/Contents/MacOS/Recordings, which lists `_RegisterEventHotKey` (the
+ * Hasna Recordings.app/Contents/MacOS/Recordings, which lists `_RegisterEventHotKey` (the
  * hotkey) and `_CGEventTapCreate` + `_AXIsProcessTrusted` (the fn monitor).
  */
 export interface TriggerGrantRequirement {
@@ -124,7 +124,7 @@ export interface BundleScanProbes {
     readBundleIdentifier?: BundleIdentifierReader;
 }
 /**
- * Bundle paths of the HasnaRecordings.app instances currently running.
+ * Bundle paths of the Hasna Recordings.app instances currently running.
  *
  * TCC grants key to a specific bundle (and, for an unstably-signed build, to its cdhash),
  * so "which bundle is running" is the only honest answer to "where does the Accessibility

package/dist/contracts/hosted-v1.d.ts

@@ -0,0 +1,105 @@
+import { type ContractParser, type JSONValue } from "./stream-v1.js";
+export type { ContractParser, ContractResult, JSONValue } from "./stream-v1.js";
+export { ContractValidationError } from "./stream-v1.js";
+export interface HostedRecordingInput {
+    id: string;
+    sessionId?: string;
+    title: string;
+    transcript: string;
+    durationMs: number;
+}
+export interface HostedRecording extends HostedRecordingInput {
+    createdAt: string;
+    updatedAt: string;
+    provenance?: Record<string, JSONValue>;
+    [key: string]: unknown;
+}
+export interface HostedPasteInput {
+    id: string;
+    recordingId?: string | null;
+    text: string;
+    destinationAppId?: string;
+    destinationAppName?: string;
+    status: "attempted" | "confirmed" | "failed";
+    occurredAt?: string;
+}
+export interface HostedPasteReceipt extends HostedPasteInput {
+    recordingId: string | null;
+    occurredAt: string;
+    createdAt: string;
+    updatedAt: string;
+    /** Reported by the client; the server does not independently observe the paste target. */
+    evidenceSource: "client_reported";
+    [key: string]: unknown;
+}
+export interface HostedAccount {
+    id: string;
+    displayName: string;
+    email: string;
+    createdAt: string;
+    [key: string]: unknown;
+}
+export interface HostedPageOptions {
+    limit?: number;
+    before?: string;
+    beforeId?: string;
+}
+export interface HostedAccountResponse {
+    account: HostedAccount;
+    wireVersion?: string;
+    capabilities?: string[];
+    [key: string]: unknown;
+}
+export interface HostedVersionResponse {
+    name: "recordings";
+    version: string;
+    apiVersion: "v1";
+    wireVersion?: string;
+    capabilities?: string[];
+    [key: string]: unknown;
+}
+export interface HostedHealthResponse {
+    status: "ok";
+    [key: string]: unknown;
+}
+export interface HostedReadyResponse {
+    status: "ready";
+    [key: string]: unknown;
+}
+export declare const recordingInputParser: ContractParser<HostedRecordingInput>;
+export declare const recordingParser: ContractParser<HostedRecording>;
+export declare const pasteInputParser: ContractParser<HostedPasteInput>;
+export declare const pasteReceiptParser: ContractParser<HostedPasteReceipt>;
+export declare const pageOptionsParser: ContractParser<HostedPageOptions>;
+export declare const bootstrapInputParser: ContractParser<Record<string, never>>;
+export declare const renameInputParser: ContractParser<{
+    title: string;
+}>;
+export declare const accountResponseParser: ContractParser<HostedAccountResponse>;
+export declare const versionResponseParser: ContractParser<HostedVersionResponse>;
+export declare const healthResponseParser: ContractParser<HostedHealthResponse>;
+export declare const readyResponseParser: ContractParser<HostedReadyResponse>;
+export declare const recordingResponseParser: ContractParser<{
+    recording: HostedRecording;
+    [key: string]: unknown;
+}>;
+export declare const recordingListParser: ContractParser<{
+    recordings: HostedRecording[];
+    [key: string]: unknown;
+}>;
+export declare const pasteResponseParser: ContractParser<{
+    receipt: HostedPasteReceipt;
+    [key: string]: unknown;
+}>;
+export declare const pasteListParser: ContractParser<{
+    receipts: HostedPasteReceipt[];
+    [key: string]: unknown;
+}>;
+export declare const pendingDeletionParser: ContractParser<{
+    audioCleanup: {
+        state: "pending";
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}>;
+//# sourceMappingURL=hosted-v1.d.ts.map

package/dist/contracts/hosted-v1.d.ts.map

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

package/dist/contracts/hosted-v1.js

@@ -0,0 +1,41 @@
+// @bun
+import {
+  accountResponseParser,
+  bootstrapInputParser,
+  healthResponseParser,
+  pageOptionsParser,
+  pasteInputParser,
+  pasteListParser,
+  pasteReceiptParser,
+  pasteResponseParser,
+  pendingDeletionParser,
+  readyResponseParser,
+  recordingInputParser,
+  recordingListParser,
+  recordingParser,
+  recordingResponseParser,
+  renameInputParser,
+  versionResponseParser
+} from "../hosted-v1-gdr9extc.js";
+import {
+  ContractValidationError
+} from "../hosted-v1-aavn7ktb.js";
+export {
+  versionResponseParser,
+  renameInputParser,
+  recordingResponseParser,
+  recordingParser,
+  recordingListParser,
+  recordingInputParser,
+  readyResponseParser,
+  pendingDeletionParser,
+  pasteResponseParser,
+  pasteReceiptParser,
+  pasteListParser,
+  pasteInputParser,
+  pageOptionsParser,
+  healthResponseParser,
+  bootstrapInputParser,
+  accountResponseParser,
+  ContractValidationError
+};

package/dist/contracts/stream-v1.d.ts

@@ -0,0 +1,117 @@
+/** Public wire values only. Implementations own transport, credentials and session state. */
+export type JSONValue = null | boolean | number | string | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export type ContractResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: {
+        code: "invalid_contract";
+    };
+};
+export interface ContractParser<T> {
+    parse(value: unknown): T;
+    safeParse(value: unknown): ContractResult<T>;
+}
+/** Never retains the rejected input, schema issues, a cause or a server message. */
+export declare class ContractValidationError extends Error {
+    readonly code = "invalid_contract";
+    constructor();
+}
+export declare const WIRE_VERSION: "1.0";
+export declare const REQUIRED_CAPABILITIES: readonly ["version-negotiation", "pcm-s16le-24000-mono", "audio-ack", "session-authorize"];
+export declare const PCM_FORMAT: Readonly<{
+    readonly encoding: "pcm_s16le";
+    readonly sampleRateHz: 24000;
+    readonly channels: 1;
+}>;
+export declare const MAX_PCM_FRAME_BYTES = 24000;
+export declare const MAX_PCM_BYTES = 86400000;
+export declare const MAX_CONTROL_BYTES = 20000;
+export interface WireMetadata {
+    wireVersion: string;
+    capabilities: string[];
+}
+export interface StreamStart {
+    type: "session.start";
+    sessionId: string;
+    model?: string;
+    language?: string;
+    wireVersion?: string;
+    capabilities?: string[];
+}
+export type StreamControl = StreamStart | {
+    type: "input.finish";
+} | {
+    type: "session.cancel";
+} | {
+    type: "session.authorize";
+    accessToken: string;
+};
+export interface StreamSegment {
+    id: string;
+    text: string;
+    startSecond?: number;
+    endSecond?: number;
+    [key: string]: unknown;
+}
+export interface StreamTranscript {
+    sessionId: string;
+    text: string;
+    segments?: StreamSegment[];
+    provenance?: Record<string, JSONValue>;
+    [key: string]: unknown;
+}
+interface EventBase {
+    sessionId: string;
+    sequence?: number;
+    [key: string]: unknown;
+}
+export interface AudioAccepted extends EventBase {
+    type: "audio.accepted";
+    bytes: number;
+    totalBytes: number;
+}
+export type StreamEvent = (EventBase & {
+    type: "session.ready";
+    format: typeof PCM_FORMAT;
+    maxInFlightAudioBytes?: number;
+    maxAudioDurationMs?: number;
+    expiresAt?: number;
+    wireVersion?: string;
+    capabilities?: string[];
+}) | AudioAccepted | (EventBase & {
+    type: "session.authorized";
+    expiresAt: number;
+}) | (EventBase & {
+    type: "partial" | "committed";
+    segment: StreamSegment;
+}) | (EventBase & {
+    type: "final";
+    transcript: StreamTranscript;
+    recordingId?: string;
+}) | (EventBase & {
+    type: "error";
+    code: string;
+    message?: string;
+    requestId?: string;
+});
+export declare const recordingIDParser: ContractParser<string>;
+export declare const wireMetadataParser: ContractParser<WireMetadata>;
+/** Absence is legacy v1. An explicit advertisement must be complete and compatible. */
+export declare function optionalWireMetadata(value: {
+    wireVersion?: unknown;
+    capabilities?: unknown;
+}): WireMetadata | undefined;
+/** A decoded JSON control object; use parseStreamControlJSON for the byte-limited wire message. */
+export declare const streamControlParser: ContractParser<StreamControl>;
+export declare function parseStreamControlJSON(message: string): StreamControl;
+export declare const streamEventParser: ContractParser<StreamEvent>;
+/** No conversion, copy or cumulative accounting. The caller owns the session's total/buffer limits. */
+export declare const pcmFrameParser: ContractParser<Uint8Array>;
+/** Pure readback check; does not mutate counters or acknowledge unsent audio. */
+export declare function acceptsAudioAcknowledgement(event: AudioAccepted, sentBytes: number, acknowledgedBytes: number): boolean;
+export {};
+//# sourceMappingURL=stream-v1.d.ts.map

package/dist/contracts/stream-v1.d.ts.map

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

package/dist/contracts/stream-v1.js

@@ -0,0 +1,35 @@
+// @bun
+import {
+  ContractValidationError,
+  MAX_CONTROL_BYTES,
+  MAX_PCM_BYTES,
+  MAX_PCM_FRAME_BYTES,
+  PCM_FORMAT,
+  REQUIRED_CAPABILITIES,
+  WIRE_VERSION,
+  acceptsAudioAcknowledgement,
+  optionalWireMetadata,
+  parseStreamControlJSON,
+  pcmFrameParser,
+  recordingIDParser,
+  streamControlParser,
+  streamEventParser,
+  wireMetadataParser
+} from "../hosted-v1-aavn7ktb.js";
+export {
+  wireMetadataParser,
+  streamEventParser,
+  streamControlParser,
+  recordingIDParser,
+  pcmFrameParser,
+  parseStreamControlJSON,
+  optionalWireMetadata,
+  acceptsAudioAcknowledgement,
+  WIRE_VERSION,
+  REQUIRED_CAPABILITIES,
+  PCM_FORMAT,
+  MAX_PCM_FRAME_BYTES,
+  MAX_PCM_BYTES,
+  MAX_CONTROL_BYTES,
+  ContractValidationError
+};

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,eAAO,MAAM,UAAU,UAqFtB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,QAAwB,CAAC;AAE7D,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAiBrD;AA0ED,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,oEAAoE;AACpE,wBAAgB,UAAU,IAAI,aAAa,CAK1C;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,eAAO,MAAM,UAAU,UA8FtB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,QAAwB,CAAC;AAE7D,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAiBrD;AA6ED,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,oEAAoE;AACpE,wBAAgB,UAAU,IAAI,aAAa,CAK1C;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/db/pg-migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pg-migrations.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,aAAa,EAAE,MAAM,EAgGjC,CAAC"}
+{"version":3,"file":"pg-migrations.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,aAAa,EAAE,MAAM,EAuGjC,CAAC"}

package/dist/db/recordings.d.ts

@@ -1,6 +1,12 @@
 import { type Database } from "bun:sqlite";
 import type { Recording, CreateRecordingInput, RecordingFilter } from "../types/index.js";
 export declare function createRecording(input: CreateRecordingInput, db?: Database, idempotencyKey?: string): Recording;
+/**
+ * Link an uploaded audio object to an existing recording row: object key,
+ * content digest and byte size. Called after the artifact kit upload at
+ * creation; a no-op shape-wise when the row is missing.
+ */
+export declare function updateRecordingAudio(id: string, audioObjectKey: string, audioSha256: string, audioBytes: number, db?: Database): Recording | null;
 export declare function getRecording(id: string, db?: Database): Recording | null;
 export declare function listRecordings(filter?: RecordingFilter, db?: Database): Recording[];
 export declare function countRecordings(filter?: RecordingFilter, db?: Database): number;

package/dist/db/recordings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recordings.d.ts","sourceRoot":"","sources":["../../src/db/recordings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AA4B3B,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,EAAE,CAAC,EAAE,QAAQ,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,SAAS,CAsDX;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,GAAG,IAAI,CAgBlB;AAED,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,eAAe,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,EAAE,CASb;AAED,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,eAAe,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAsDD,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAIT;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,eAAe,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,EAAE,CAEb;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CA2CA"}
+{"version":3,"file":"recordings.d.ts","sourceRoot":"","sources":["../../src/db/recordings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AA+B3B,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,EAAE,CAAC,EAAE,QAAQ,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,SAAS,CAyDX;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,GAAG,IAAI,CAOlB;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,GAAG,IAAI,CAgBlB;AAED,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,eAAe,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,EAAE,CASb;AAED,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,eAAe,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAsDD,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAIT;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,eAAe,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,SAAS,EAAE,CAEb;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CA2CA"}

package/dist/hosted/index.d.ts

@@ -0,0 +1,58 @@
+import * as contract from "../contracts/hosted-v1.js";
+import { type ClientOptions, type RequestOptions } from "./transport.js";
+export { RecordingsSDKError, type SDKErrorCode, type CredentialProvider, type ClientOptions, type RequestOptions } from "./transport.js";
+export type { HostedRecordingInput as RecordingInput, HostedRecording as Recording, HostedPasteInput as PasteInput, HostedPasteReceipt as PasteReceipt, HostedAccount as Account, HostedAccountResponse as AccountResponse, HostedPageOptions as PageOptions } from "../contracts/hosted-v1.js";
+export interface Cursor {
+    before: string;
+    beforeId: string;
+}
+export type DeletionResult = {
+    state: "removed";
+} | {
+    state: "pending";
+};
+/** Explicit cursor for the last received row. No extra request or inferred total. */
+export declare const recordingCursor: (last: contract.HostedRecording) => Cursor;
+export declare const pasteCursor: (last: contract.HostedPasteReceipt) => Cursor;
+/** Hosted JSON API adapter. No native control, ambient login or automatic retry. */
+export declare class HostedRecordingsClient {
+    #private;
+    constructor(options: ClientOptions);
+    get apiBase(): string;
+    health(options?: RequestOptions): Promise<contract.HostedHealthResponse>;
+    version(options?: RequestOptions): Promise<contract.HostedVersionResponse>;
+    ready(options?: RequestOptions): Promise<contract.HostedReadyResponse>;
+    account(options?: RequestOptions): Promise<contract.HostedAccountResponse>;
+    /** Caller owns broker OAuth/PKCE. Profile authority comes from the opaque bearer session. */
+    bootstrap(options?: RequestOptions): Promise<contract.HostedAccountResponse>;
+    logout(options?: RequestOptions): Promise<void>;
+    listRecordings(page?: contract.HostedPageOptions, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recordings: contract.HostedRecording[];
+    }>;
+    getRecording(id: string, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recording: contract.HostedRecording;
+    }>;
+    saveRecording(value: contract.HostedRecordingInput, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recording: contract.HostedRecording;
+    }>;
+    renameRecording(id: string, title: string, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recording: contract.HostedRecording;
+    }>;
+    /** Pending is durable deletion accepted, not completed audio purge. Repeat explicitly. */
+    deleteRecording(id: string, options?: RequestOptions): Promise<DeletionResult>;
+    listPasteReceipts(page?: contract.HostedPageOptions, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        receipts: contract.HostedPasteReceipt[];
+    }>;
+    savePasteReceipt(value: contract.HostedPasteInput, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        receipt: contract.HostedPasteReceipt;
+    }>;
+    deletePasteReceipt(id: string, options?: RequestOptions): Promise<void>;
+    clearPasteHistory(options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hosted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzI,YAAY,EAAE,oBAAoB,IAAI,cAAc,EAAE,eAAe,IAAI,SAAS,EAAE,gBAAgB,IAAI,UAAU,EAChH,kBAAkB,IAAI,YAAY,EAAE,aAAa,IAAI,OAAO,EAAE,qBAAqB,IAAI,eAAe,EACtG,iBAAiB,IAAI,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACtE,MAAM,WAAW,MAAM;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC5D,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AACzE,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,MAAM,QAAQ,CAAC,eAAe,KAAG,MAAyD,CAAC;AAC3H,eAAO,MAAM,WAAW,GAAI,MAAM,QAAQ,CAAC,kBAAkB,KAAG,MAA0D,CAAC;AAE3H,oFAAoF;AACpF,qBAAa,sBAAsB;;gBAErB,OAAO,EAAE,aAAa;IAClC,IAAI,OAAO,IAAI,MAAM,CAAiC;IAChD,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc;IAC/B,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc;IAChC,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc;IAC9B,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc;IACtC,6FAA6F;IACvF,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc;IAGlC,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,cAAc,CAAC,IAAI,GAAE,QAAQ,CAAC,iBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAG9E,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAGjD,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAG5E,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAGzE,0FAA0F;IACpF,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAK9E,iBAAiB,CAAC,IAAI,GAAE,QAAQ,CAAC,iBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAGjF,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAG3E,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IACvE,iBAAiB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CACjE"}