@tangle-network/braid 0.1.0

package/dist/adapters/storage/sqlite-effects.js

@@ -0,0 +1,290 @@
+import { stat } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { canonicalJson } from '../../domain/canonical.js';
+import { parseConversationId, parseEventId } from '../../domain/ids.js';
+import { credentialRef } from '../../ports/credentials.js';
+import { StorageError } from './sqlite-errors.js';
+import { pragmaNumber, SQLITE_SCHEMA_VERSION } from './sqlite-schema.js';
+import { assertEffectRecordInput, assertOperationRequestDigest } from './storage-validation.js';
+import { SqliteOperationStorage } from './sqlite-operations.js';
+import { effectRecordFromRow, jsonValue, cloneJson, asNumber, asString } from './sqlite-rows.js';
+import { classifySqliteError, assertApprovedPath, validatePath } from './sqlite-paths.js';
+export class SqliteEffectsStorage extends SqliteOperationStorage {
+    async rebuild(operation) {
+        assertOperationRequestDigest(operation, {});
+        const replay = await this.reuseMutation(operation);
+        if (replay !== undefined)
+            return replay;
+        let mutationCommitted = false;
+        try {
+            const result = await this.writes.run(async () => {
+                this.assertOpen();
+                this.begin();
+                try {
+                    const projection = this.buildProjection();
+                    this.writeProjection(projection);
+                    this.commit('rebuild');
+                    mutationCommitted = true;
+                    return structuredClone(projection);
+                }
+                catch (error) {
+                    this.rollback();
+                    throw classifySqliteError(error);
+                }
+            });
+            await this.completeMutation(operation, 'terminal', jsonValue(result));
+            return result;
+        }
+        catch (error) {
+            await this.completeMutationFailure(operation, error, mutationCommitted);
+            throw error;
+        }
+    }
+    reserveEffect(record) {
+        this.assertOpen();
+        assertEffectRecordInput(record);
+        this.begin();
+        try {
+            const admission = this.database
+                .prepare('SELECT * FROM braid_effect_admissions WHERE operation_id = ?')
+                .get(record.operationId);
+            if (admission) {
+                const admittedDigest = asString(admission.request_digest, 'request_digest');
+                const existing = this.database
+                    .prepare(`SELECT * FROM braid_effect_records
+             WHERE operation_id = ? AND request_digest = ?
+             ORDER BY effect_sequence DESC LIMIT 1`)
+                    .get(record.operationId, admittedDigest);
+                if (admittedDigest === record.requestDigest) {
+                    const replay = existing
+                        ? effectRecordFromRow(existing)
+                        : {
+                            ...record,
+                            effectKind: asString(admission.effect_kind, 'effect_kind'),
+                            attempt: asNumber(admission.attempt, 'attempt'),
+                            createdAt: asString(admission.created_at, 'created_at'),
+                            updatedAt: asString(admission.updated_at, 'updated_at'),
+                        };
+                    this.commit('effect.reserve.replay');
+                    return { record: replay, created: false };
+                }
+                const conflict = {
+                    ...record,
+                    status: 'conflict',
+                    detail: `Operation is already bound to request digest ${admittedDigest}`,
+                    conflictWithDigest: admittedDigest,
+                };
+                this.insertEffectUnsafe(conflict);
+                this.commit('effect.reserve.conflict');
+                return { record: conflict, created: false };
+            }
+            this.database
+                .prepare(`INSERT INTO braid_effect_admissions(
+             operation_id, effect_kind, request_digest, attempt, created_at, updated_at
+           ) VALUES (?, ?, ?, ?, ?, ?)`)
+                .run(record.operationId, record.effectKind, record.requestDigest, record.attempt, record.createdAt, record.updatedAt);
+            this.insertEffectUnsafe(record);
+            this.commit('effect.reserve');
+            return { record: structuredClone(record), created: true };
+        }
+        catch (error) {
+            this.rollback();
+            throw classifySqliteError(error);
+        }
+    }
+    current(operationId) {
+        this.assertOpen();
+        const row = this.database
+            .prepare(`SELECT * FROM braid_effect_records
+       WHERE operation_id = ? AND status <> 'conflict'
+       ORDER BY effect_sequence DESC LIMIT 1`)
+            .get(operationId);
+        return row === undefined ? undefined : effectRecordFromRow(row);
+    }
+    latest(operationId, requestDigest) {
+        this.assertOpen();
+        const row = this.database
+            .prepare(`SELECT * FROM braid_effect_records
+       WHERE operation_id = ? AND request_digest = ?
+       ORDER BY effect_sequence DESC LIMIT 1`)
+            .get(operationId, requestDigest);
+        return row === undefined ? undefined : effectRecordFromRow(row);
+    }
+    appendEffect(record) {
+        this.assertOpen();
+        assertEffectRecordInput(record);
+        this.begin();
+        try {
+            this.insertEffectUnsafe(record);
+            if (record.status !== 'conflict') {
+                this.database
+                    .prepare(`UPDATE braid_effect_admissions
+             SET effect_kind = ?, attempt = ?, updated_at = ?
+             WHERE operation_id = ? AND request_digest = ?`)
+                    .run(record.effectKind, record.attempt, record.updatedAt, record.operationId, record.requestDigest);
+            }
+            this.commit('effect');
+        }
+        catch (error) {
+            this.rollback();
+            throw classifySqliteError(error);
+        }
+    }
+    history(operationId) {
+        this.assertOpen();
+        const rows = this.database
+            .prepare('SELECT * FROM braid_effect_records WHERE operation_id = ? ORDER BY effect_sequence')
+            .all(operationId);
+        return rows.map(effectRecordFromRow);
+    }
+    insertEffectUnsafe(record) {
+        this.database
+            .prepare(`INSERT INTO braid_effect_records(
+        operation_id, effect_kind, request_digest, status, attempt, created_at,
+        updated_at, metadata_json, detail, external_reference, conflict_with_digest
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(record.operationId, record.effectKind, record.requestDigest, record.status, record.attempt, record.createdAt, record.updatedAt, canonicalJson(record.metadata), record.detail ?? null, record.externalReference ?? null, record.conflictWithDigest ?? null);
+    }
+    async reuseMutation(intent) {
+        const reservation = await this.reserveOperation(intent);
+        if (reservation.record.status === 'conflict') {
+            throw new StorageError('OPERATION_CONFLICT', `Operation ${intent.operationId} was reused with a different request digest`);
+        }
+        if (!reservation.created && reservation.record.status === 'failed') {
+            throw new StorageError('OPERATION_FAILED_REPLAY', `Operation ${intent.operationId} already failed; use a new operation identifier to retry`);
+        }
+        if (!reservation.created && reservation.record.status === 'unknown') {
+            throw new StorageError('OPERATION_OUTCOME_UNKNOWN', `Operation ${intent.operationId} has an unknown outcome and requires reconciliation`);
+        }
+        if (!reservation.created && reservation.record.status === 'pending') {
+            const reconciled = await this.reconcilePendingMutation(intent);
+            if (reconciled !== undefined) {
+                await this.completeMutation(intent, 'terminal', jsonValue(reconciled));
+                return reconciled;
+            }
+            throw new StorageError('OPERATION_OUTCOME_PENDING', `Operation ${intent.operationId} is pending and requires explicit reconciliation evidence`);
+        }
+        if (!reservation.created &&
+            (reservation.record.status === 'terminal' || reservation.record.status === 'acknowledged')) {
+            if (reservation.record.result === undefined) {
+                throw new StorageError('OPERATION_RESULT_MISSING', `Operation ${intent.operationId} has no stored result`);
+            }
+            return cloneJson(reservation.record.result);
+        }
+        return undefined;
+    }
+    async reconcilePendingMutation(intent) {
+        const request = intent.request;
+        const object = request !== null && typeof request === 'object' && !Array.isArray(request)
+            ? request
+            : undefined;
+        if (intent.kind === 'backup' && typeof object?.path === 'string') {
+            const path = validatePath(object.path, 'Backup path');
+            await assertApprovedPath(path, this.workspaceRoot ?? dirname(this.path), 'Backup path');
+            const exists = await stat(path)
+                .then(() => true)
+                .catch(() => false);
+            if (!exists)
+                return undefined;
+            await this.assertEncryptedArtifact(path);
+            await this.assertReadableBackup(path);
+            return { path, bytes: (await stat(path)).size, encrypted: true };
+        }
+        if (intent.kind === 'destruction' && typeof object?.conversationId === 'string') {
+            const tombstone = this.database
+                .prepare('SELECT conversation_id FROM braid_conversation_tombstones WHERE conversation_id = ?')
+                .get(object.conversationId);
+            if (tombstone) {
+                return {
+                    conversationId: object.conversationId,
+                    destroyed: true,
+                    retainedCiphertext: true,
+                };
+            }
+            return undefined;
+        }
+        if (intent.kind === 'redact' &&
+            typeof object?.conversationId === 'string' &&
+            typeof object.eventId === 'string') {
+            const record = this.database
+                .prepare('SELECT rewritten_at FROM braid_redaction_records WHERE conversation_id = ? AND event_id = ?')
+                .get(object.conversationId, object.eventId);
+            if (!record)
+                return undefined;
+            const keyRow = this.database
+                .prepare('SELECT credential_ref FROM braid_conversation_keys WHERE conversation_id = ?')
+                .get(object.conversationId);
+            if (!keyRow)
+                return undefined;
+            const ref = credentialRef(asString(keyRow.credential_ref, 'credential_ref'));
+            const verified = await this.verifyConversation(parseConversationId(object.conversationId), parseEventId(object.eventId), ref);
+            if (!verified)
+                return undefined;
+            const count = this.database
+                .prepare('SELECT COUNT(*) AS count FROM braid_journal_events WHERE conversation_id = ?')
+                .get(object.conversationId);
+            return {
+                conversationId: object.conversationId,
+                redactedEventId: object.eventId,
+                rewrittenEvents: asNumber(count.count, 'rewrittenEvents'),
+                newContentKeyRef: ref,
+            };
+        }
+        if (intent.kind === 'migrate' &&
+            pragmaNumber(this.database, 'user_version') >= SQLITE_SCHEMA_VERSION) {
+            return {
+                fromVersion: SQLITE_SCHEMA_VERSION,
+                toVersion: SQLITE_SCHEMA_VERSION,
+                migrated: false,
+            };
+        }
+        if (intent.kind === 'rebuild')
+            return this.buildProjection();
+        if (intent.kind === 'compact')
+            return { completed: true };
+        if (intent.kind === 'retention') {
+            const before = typeof object?.before === 'string' ? object.before : undefined;
+            if (!before)
+                return undefined;
+            const pending = this.database
+                .prepare(`SELECT 1 FROM braid_journal_events e
+           JOIN braid_run_cursors c ON c.run_id = e.run_id
+           WHERE e.received_at < ? AND e.redacted = 0 AND c.terminal = 1 LIMIT 1`)
+                .get(before);
+            if (!pending)
+                return { redactedEvents: 0, deletedConversations: [] };
+        }
+        return undefined;
+    }
+    async completeMutation(intent, status, result) {
+        await this.completeOperation({
+            operationId: intent.operationId,
+            requestDigest: intent.requestDigest,
+            status,
+            result,
+        });
+    }
+    async completeMutationFailure(intent, error, mutationCommitted = false) {
+        const result = {
+            code: mutationCommitted
+                ? 'STORAGE_MUTATION_OUTCOME_UNKNOWN'
+                : error instanceof StorageError
+                    ? error.code
+                    : 'STORAGE_MUTATION_FAILED',
+            message: mutationCommitted
+                ? 'The storage mutation committed but its final outcome is unknown'
+                : error instanceof StorageError
+                    ? error.code
+                    : 'Storage mutation failed',
+        };
+        try {
+            await this.completeMutation(intent, mutationCommitted ? 'unknown' : 'failed', result);
+        }
+        catch {
+            await this.completeMutation(intent, 'unknown', {
+                code: 'STORAGE_MUTATION_OUTCOME_UNKNOWN',
+            }).catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=sqlite-effects.js.map

package/dist/adapters/storage/sqlite-effects.js.map

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

package/dist/adapters/storage/sqlite-errors.d.ts

@@ -0,0 +1,7 @@
+export declare class StorageError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: {
+        readonly cause?: unknown;
+    });
+}
+//# sourceMappingURL=sqlite-errors.d.ts.map

package/dist/adapters/storage/sqlite-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAIhF;CACF"}

package/dist/adapters/storage/sqlite-errors.js

@@ -0,0 +1,9 @@
+export class StorageError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'StorageError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=sqlite-errors.js.map

package/dist/adapters/storage/sqlite-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-errors.js","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,OAAe,EAAE,OAAsC;QAC/E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/adapters/storage/sqlite-initialization.d.ts

@@ -0,0 +1,15 @@
+export interface InitializationMarker {
+    readonly version: 1;
+    readonly databaseDigest: string;
+    readonly pid: number;
+}
+export type InitializationMarkerState = 'none' | 'active' | 'stale';
+export declare function initializationMarkerPath(databasePath: string): string;
+export declare function initializationMarker(databasePath: string, pid?: number): InitializationMarker;
+export declare function processIsAlive(pid: number): boolean;
+export declare function inspectInitializationMarker(databasePath: string): Promise<InitializationMarkerState>;
+export declare function claimInitializationMarker(databasePath: string): Promise<void>;
+export declare function releaseInitializationMarker(databasePath: string): Promise<void>;
+export declare function markInitializationInterrupted(databasePath: string): Promise<void>;
+export declare function removeDatabaseArtifacts(databasePath: string): Promise<void>;
+//# sourceMappingURL=sqlite-initialization.d.ts.map

package/dist/adapters/storage/sqlite-initialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-initialization.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite-initialization.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEnE,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,GAAG,SAAc,GAChB,oBAAoB,CAMtB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAiDpC;AAED,wBAAsB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBnF;AAED,wBAAsB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrF;AAED,wBAAsB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvF;AAED,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjF"}

package/dist/adapters/storage/sqlite-initialization.js

@@ -0,0 +1,113 @@
+import { constants } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { open as openFile, rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { canonicalJson } from '../../domain/canonical.js';
+import { StorageError } from './sqlite-errors.js';
+import { syncDirectory } from './sqlite-paths.js';
+export function initializationMarkerPath(databasePath) {
+    return `${databasePath}.initializing`;
+}
+export function initializationMarker(databasePath, pid = process.pid) {
+    return {
+        version: 1,
+        databaseDigest: createHash('sha256').update(databasePath).digest('hex'),
+        pid,
+    };
+}
+export function processIsAlive(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+export async function inspectInitializationMarker(databasePath) {
+    const markerPath = initializationMarkerPath(databasePath);
+    let handle;
+    try {
+        handle = await openFile(markerPath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+        const metadata = await handle.stat();
+        if (!metadata.isFile() || metadata.nlink !== 1 || metadata.size > 512) {
+            throw new StorageError('STORAGE_INITIALIZATION_MARKER', 'Database initialization marker is invalid');
+        }
+        if (process.platform !== 'win32' && (metadata.mode & 0o777) !== 0o600) {
+            throw new StorageError('STORAGE_INITIALIZATION_MARKER', 'Database initialization marker must have mode 0600');
+        }
+        if (typeof process.getuid === 'function' && metadata.uid !== process.getuid()) {
+            throw new StorageError('STORAGE_INITIALIZATION_MARKER', 'Database initialization marker ownership does not match the process');
+        }
+        const raw = await handle.readFile({ encoding: 'utf8' });
+        const parsed = JSON.parse(raw);
+        const expected = initializationMarker(databasePath, 0).databaseDigest;
+        if (parsed.version !== 1 ||
+            parsed.databaseDigest !== expected ||
+            !Number.isSafeInteger(parsed.pid)) {
+            throw new StorageError('STORAGE_INITIALIZATION_MARKER', 'Database initialization marker is invalid');
+        }
+        return processIsAlive(parsed.pid) ? 'active' : 'stale';
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return 'none';
+        if (error instanceof StorageError)
+            throw error;
+        throw new StorageError('STORAGE_INITIALIZATION_MARKER', 'Database initialization marker could not be read', { cause: error });
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+export async function claimInitializationMarker(databasePath) {
+    const markerPath = initializationMarkerPath(databasePath);
+    for (;;) {
+        let handle;
+        try {
+            handle = await openFile(markerPath, 'wx', 0o600);
+            await handle.writeFile(`${canonicalJson(initializationMarker(databasePath))}\n`);
+            await handle.sync();
+            await handle.close();
+            handle = undefined;
+            await syncDirectory(dirname(databasePath));
+            return;
+        }
+        catch (error) {
+            await handle?.close().catch(() => undefined);
+            if (error.code !== 'EEXIST')
+                throw error;
+            const state = await inspectInitializationMarker(databasePath);
+            if (state === 'active') {
+                throw new StorageError('STORAGE_INITIALIZING', 'Another process is initializing the encrypted database');
+            }
+            await rm(markerPath, { force: true });
+        }
+    }
+}
+export async function releaseInitializationMarker(databasePath) {
+    await rm(initializationMarkerPath(databasePath), { force: true });
+    await syncDirectory(dirname(databasePath));
+}
+export async function markInitializationInterrupted(databasePath) {
+    const markerPath = initializationMarkerPath(databasePath);
+    let handle;
+    try {
+        handle = await openFile(markerPath, 'r+');
+        await handle.truncate(0);
+        await handle.writeFile(`${canonicalJson(initializationMarker(databasePath, 0))}\n`);
+        await handle.sync();
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+export async function removeDatabaseArtifacts(databasePath) {
+    await rm(databasePath, { force: true });
+    await rm(`${databasePath}-wal`, { force: true });
+    await rm(`${databasePath}-shm`, { force: true });
+    await syncDirectory(dirname(databasePath));
+}
+//# sourceMappingURL=sqlite-initialization.js.map

package/dist/adapters/storage/sqlite-initialization.js.map

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

package/dist/adapters/storage/sqlite-journal.d.ts

@@ -0,0 +1,24 @@
+import type { AppendResult, ConversationId, JournalEvent, ProjectionSnapshot, ReplayResult, RunId, StateSnapshot, StoredJournalEvent, WorkspaceId } from '../../ports/storage.js';
+import { SqliteLifecycleStorage } from './sqlite-lifecycle.js';
+export declare abstract class SqliteJournalStorage extends SqliteLifecycleStorage {
+    append(events: readonly JournalEvent[]): Promise<AppendResult>;
+    appendWithSnapshot(input: {
+        readonly events: readonly JournalEvent[];
+        readonly snapshot: StateSnapshot;
+    }): Promise<AppendResult>;
+    private validateAppend;
+    appendUnsafe(events: readonly JournalEvent[], snapshot?: StateSnapshot): Promise<AppendResult>;
+    events(input?: {
+        readonly workspaceId?: WorkspaceId;
+        readonly conversationId?: ConversationId;
+        readonly runId?: RunId;
+        readonly afterStorageId?: number;
+    }): Promise<readonly StoredJournalEvent[]>;
+    replay(input: {
+        readonly runId: RunId;
+        readonly afterSequence?: number;
+    }): Promise<ReplayResult>;
+    projection(): Promise<ProjectionSnapshot>;
+    projectionChecksum(): Promise<string>;
+}
+//# sourceMappingURL=sqlite-journal.d.ts.map

package/dist/adapters/storage/sqlite-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-journal.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite-journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAEd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,KAAK,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACZ,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAO9D,8BAAsB,oBAAqB,SAAQ,sBAAsB;IACjE,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAGnE;IAEK,kBAAkB,CAAC,KAAK,EAAE;QAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;QACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;KACjC,GAAG,OAAO,CAAC,YAAY,CAAC,CAGxB;IAED,OAAO,CAAC,cAAc;IAwBhB,YAAY,CAChB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC,CAwQvB;IAEK,MAAM,CACV,KAAK,GAAE;QACL,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;QAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;QACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;QACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAC5B,GACL,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAyBxC;IAEK,MAAM,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;QACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAChC,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBxB;IAEK,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAG9C;IAEK,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG1C;CACF"}