devchain-cli 0.21.0 → 0.22.1

package/dist/server/modules/external-integrations/sessions/external-edit-session.store.js

@@ -0,0 +1,329 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalEditSessionStore = exports.DEFAULT_SESSION_STORE_LIMITS = void 0;
+exports.isWritableSessionState = isWritableSessionState;
+const node_crypto_1 = require("node:crypto");
+const external_edit_session_models_1 = require("../models/external-edit-session.models");
+exports.DEFAULT_SESSION_STORE_LIMITS = {
+    idleLimitMs: external_edit_session_models_1.EDIT_SESSION_IDLE_LIMIT_MS,
+    absoluteLimitMs: external_edit_session_models_1.EDIT_SESSION_ABSOLUTE_LIMIT_MS,
+    maxEntries: external_edit_session_models_1.EDIT_SESSION_MAX_ENTRIES,
+    maxTotalBytes: external_edit_session_models_1.EDIT_SESSION_MAX_TOTAL_BYTES,
+    maxBaselineBytes: external_edit_session_models_1.EDIT_SESSION_MAX_BASELINE_BYTES,
+};
+function sessionBytes(session) {
+    return JSON.stringify(session).length;
+}
+class ExternalEditSessionStore {
+    limits;
+    entries = new Map();
+    totalBytes = 0;
+    now;
+    constructor(limits = exports.DEFAULT_SESSION_STORE_LIMITS, now = () => Date.now()) {
+        this.limits = limits;
+        this.now = now;
+    }
+    create(input) {
+        if (input.baseline && JSON.stringify(input.baseline).length > this.limits.maxBaselineBytes) {
+            return { ok: false, reason: 'baseline_too_large' };
+        }
+        const timestamp = this.now();
+        const session = {
+            sessionId: (0, node_crypto_1.randomUUID)(),
+            kind: input.kind,
+            provider: input.provider,
+            connectionId: input.connectionId,
+            connectionGeneration: input.connectionGeneration,
+            scopeKey: input.scopeKey,
+            remoteTaskId: input.remoteTaskId,
+            remoteCommentId: input.remoteCommentId,
+            baseline: input.baseline,
+            providerMetadata: input.providerMetadata,
+            revision: 0,
+            state: 'editable',
+            pendingWrite: null,
+            createdAt: timestamp,
+            lastActivityAt: timestamp,
+        };
+        const bytes = sessionBytes(session);
+        if (bytes > this.limits.maxTotalBytes) {
+            return { ok: false, reason: 'limit_exceeded_after_eviction' };
+        }
+        this.evictForBytes(bytes);
+        this.entries.set(session.sessionId, session);
+        this.totalBytes += bytes;
+        this.evictForEntries();
+        return { ok: true, value: this.clone(session) };
+    }
+    get(sessionId) {
+        const session = this.applyExpiry(sessionId);
+        if (!session) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        return { ok: true, value: this.clone(session) };
+    }
+    touch(sessionId) {
+        const session = this.applyExpiry(sessionId);
+        if (!session) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        session.lastActivityAt = this.now();
+        this.moveToMostRecent(session);
+        return { ok: true, value: this.clone(session) };
+    }
+    beginDispatch(sessionId, payloadFingerprint, expectedRevision) {
+        const session = this.requireEditable(sessionId);
+        if (!session.ok) {
+            return session;
+        }
+        if (session.value.revision !== expectedRevision) {
+            return { ok: false, reason: 'revision_conflict' };
+        }
+        const stored = this.entries.get(sessionId);
+        stored.state = 'outcome_unknown';
+        stored.pendingWrite = { fingerprint: payloadFingerprint, dispatchedAt: this.now() };
+        stored.lastActivityAt = this.now();
+        this.moveToMostRecent(stored);
+        return { ok: true, value: this.clone(stored) };
+    }
+    beginRetryDispatch(sessionId, payloadFingerprint, expectedRevision) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (session.state === 'outcome_unknown') {
+            if (session.pendingWrite?.fingerprint !== payloadFingerprint) {
+                return { ok: false, reason: 'fingerprint_mismatch' };
+            }
+            if (session.revision !== expectedRevision) {
+                return { ok: false, reason: 'revision_conflict' };
+            }
+            session.lastActivityAt = this.now();
+            this.moveToMostRecent(session);
+            return { ok: true, value: this.clone(session) };
+        }
+        if (session.state === 'editable') {
+            return this.beginDispatch(sessionId, payloadFingerprint, expectedRevision);
+        }
+        return { ok: false, reason: 'session_not_editable' };
+    }
+    markSavedUnverified(sessionId) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (session.state !== 'outcome_unknown') {
+            return { ok: false, reason: 'invalid_state_for_operation' };
+        }
+        session.state = 'saved_unverified';
+        session.lastActivityAt = this.now();
+        this.moveToMostRecent(session);
+        return { ok: true, value: this.clone(session) };
+    }
+    revertDispatch(sessionId) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (session.state !== 'outcome_unknown') {
+            return { ok: false, reason: 'invalid_state_for_operation' };
+        }
+        session.state = 'editable';
+        session.pendingWrite = null;
+        session.lastActivityAt = this.now();
+        this.moveToMostRecent(session);
+        return { ok: true, value: this.clone(session) };
+    }
+    commitVerifiedSave(sessionId, newBaseline) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (session.state !== 'saved_unverified' &&
+            !(session.state === 'outcome_unknown' && session.pendingWrite !== null)) {
+            return { ok: false, reason: 'invalid_state_for_operation' };
+        }
+        if (newBaseline && JSON.stringify(newBaseline).length > this.limits.maxBaselineBytes) {
+            return { ok: false, reason: 'baseline_too_large' };
+        }
+        const previousBytes = sessionBytes(session);
+        session.state = 'editable';
+        session.baseline = newBaseline;
+        session.revision += 1;
+        session.pendingWrite = null;
+        session.lastActivityAt = this.now();
+        this.totalBytes -= previousBytes;
+        this.totalBytes += sessionBytes(session);
+        this.moveToMostRecent(session);
+        return { ok: true, value: this.clone(session) };
+    }
+    applyVerifyOutcome(sessionId, remoteState, newBaseline) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (remoteState === 'diverged') {
+            session.state = 'diverged';
+            session.pendingWrite = null;
+            session.lastActivityAt = this.now();
+            this.moveToMostRecent(session);
+            return { ok: true, value: this.clone(session) };
+        }
+        if (remoteState === 'old_baseline') {
+            if (session.state === 'saved_unverified') {
+                session.state = 'outcome_unknown';
+            }
+            session.lastActivityAt = this.now();
+            this.moveToMostRecent(session);
+            return { ok: true, value: this.clone(session) };
+        }
+        return this.commitVerifiedSave(sessionId, newBaseline ?? session.baseline);
+    }
+    commitReload(sessionId, newBaseline) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (session.state !== 'editable') {
+            return { ok: false, reason: 'session_not_editable' };
+        }
+        if (newBaseline && JSON.stringify(newBaseline).length > this.limits.maxBaselineBytes) {
+            return { ok: false, reason: 'baseline_too_large' };
+        }
+        const previousBytes = sessionBytes(session);
+        session.baseline = newBaseline;
+        session.revision += 1;
+        session.lastActivityAt = this.now();
+        this.totalBytes -= previousBytes;
+        this.totalBytes += sessionBytes(session);
+        this.moveToMostRecent(session);
+        return { ok: true, value: this.clone(session) };
+    }
+    markDeleted(sessionId) {
+        const session = this.entries.get(sessionId);
+        if (!session || this.applyExpiry(sessionId) === null) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        session.state = 'invalidated';
+        session.lastActivityAt = this.now();
+        this.moveToMostRecent(session);
+        return { ok: true, value: this.clone(session) };
+    }
+    invalidate(sessionId) {
+        const session = this.entries.get(sessionId);
+        if (!session) {
+            return;
+        }
+        session.state = 'invalidated';
+        session.pendingWrite = null;
+        session.lastActivityAt = this.now();
+        this.moveToMostRecent(session);
+    }
+    invalidateProvider(provider) {
+        let invalidated = 0;
+        for (const session of [...this.entries.values()]) {
+            if (session.provider === provider) {
+                this.invalidate(session.sessionId);
+                invalidated += 1;
+            }
+        }
+        return invalidated;
+    }
+    size() {
+        return this.entries.size;
+    }
+    totalSerializedBytes() {
+        return this.totalBytes;
+    }
+    view(session) {
+        return {
+            sessionId: session.sessionId,
+            kind: session.kind,
+            provider: session.provider,
+            remoteTaskId: session.remoteTaskId,
+            remoteCommentId: session.remoteCommentId,
+            state: session.state,
+            revision: session.revision,
+            baselineFingerprint: session.baseline?.fingerprint ?? null,
+            createdAt: new Date(session.createdAt).toISOString(),
+            lastActivityAt: new Date(session.lastActivityAt).toISOString(),
+            idleExpiresAt: new Date(session.lastActivityAt + this.limits.idleLimitMs).toISOString(),
+            absoluteExpiresAt: new Date(session.createdAt + this.limits.absoluteLimitMs).toISOString(),
+        };
+    }
+    requireEditable(sessionId) {
+        const session = this.applyExpiry(sessionId);
+        if (!session) {
+            return { ok: false, reason: 'session_not_found' };
+        }
+        if (session.state !== 'editable') {
+            return { ok: false, reason: 'session_not_editable' };
+        }
+        return { ok: true, value: session };
+    }
+    applyExpiry(sessionId) {
+        const session = this.entries.get(sessionId);
+        if (!session) {
+            return null;
+        }
+        const now = this.now();
+        const idleExpired = now - session.lastActivityAt > this.limits.idleLimitMs;
+        const absoluteExpired = now - session.createdAt > this.limits.absoluteLimitMs;
+        if (idleExpired || absoluteExpired) {
+            session.state = 'expired';
+            this.entries.delete(sessionId);
+            this.totalBytes -= sessionBytes(session);
+            return null;
+        }
+        this.moveToMostRecent(session);
+        return this.clone(session);
+    }
+    moveToMostRecent(session) {
+        this.entries.delete(session.sessionId);
+        this.entries.set(session.sessionId, session);
+    }
+    evictForBytes(incomingBytes) {
+        while (this.totalBytes + incomingBytes > this.limits.maxTotalBytes && this.entries.size > 0) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined) {
+                break;
+            }
+            this.drop(oldest);
+        }
+    }
+    evictForEntries() {
+        while (this.entries.size > this.limits.maxEntries) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined) {
+                break;
+            }
+            this.drop(oldest);
+        }
+    }
+    drop(sessionId) {
+        const session = this.entries.get(sessionId);
+        if (!session) {
+            return;
+        }
+        this.entries.delete(sessionId);
+        this.totalBytes -= sessionBytes(session);
+    }
+    clone(session) {
+        return {
+            ...session,
+            baseline: session.baseline
+                ? {
+                    fingerprint: session.baseline.fingerprint,
+                    document: JSON.parse(JSON.stringify(session.baseline.document)),
+                }
+                : null,
+            providerMetadata: { ...session.providerMetadata },
+            pendingWrite: session.pendingWrite ? { ...session.pendingWrite } : null,
+        };
+    }
+}
+exports.ExternalEditSessionStore = ExternalEditSessionStore;
+function isWritableSessionState(state) {
+    return state === 'editable';
+}
+//# sourceMappingURL=external-edit-session.store.js.map

package/dist/server/modules/external-integrations/sessions/external-edit-session.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-edit-session.store.js","sourceRoot":"","sources":["../../../../src/modules/external-integrations/sessions/external-edit-session.store.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/external-integrations/sessions/external-time-mutation.store.d.ts

@@ -0,0 +1,44 @@
+import { type ExternalTimeCreateBaseline, type ExternalTimeMutationKind, type ExternalTimeMutationPhase, type ExternalTimeMutationReceipt, type ExternalTimeMutationTuple, type ExternalTimeOperationReceiptView } from '../models/external-time-mutation.models';
+export type TimeMutationStoreFailure = 'operation_id_conflict' | 'duplicate_live' | 'duplicate_terminal' | 'receipt_capacity';
+export type TimeMutationAdmitResult = {
+    ok: true;
+    receipt: ExternalTimeMutationReceipt;
+} | {
+    ok: false;
+    reason: TimeMutationStoreFailure;
+    receipt?: ExternalTimeMutationReceipt;
+};
+export type TimeMutationAckResult = {
+    ok: true;
+    receipt: ExternalTimeMutationReceipt;
+} | {
+    ok: false;
+    reason: 'not_found' | 'not_unknown';
+};
+export declare function timeEntryNoteFingerprint(note: string | null): string;
+export declare class ExternalTimeMutationStore {
+    private readonly maxLive;
+    private readonly maxReceipts;
+    private readonly ttlMs;
+    private readonly now;
+    private readonly receipts;
+    constructor(maxLive?: number, maxReceipts?: number, ttlMs?: number, now?: () => number);
+    admit(input: {
+        operationId: string;
+        kind: ExternalTimeMutationKind;
+        tuple: ExternalTimeMutationTuple;
+        baseline: ExternalTimeCreateBaseline | null;
+    }): TimeMutationAdmitResult;
+    get(operationId: string): ExternalTimeMutationReceipt | null;
+    markDispatched(operationId: string): ExternalTimeMutationReceipt | null;
+    markUnknown(operationId: string): ExternalTimeMutationReceipt | null;
+    markTerminal(operationId: string, phase: Extract<ExternalTimeMutationPhase, 'succeeded' | 'failed' | 'already_deleted' | 'not_applied' | 'abandoned_unknown' | 'superseded'>, remoteEntryId?: string | null): ExternalTimeMutationReceipt | null;
+    acknowledgeUnknown(operationId: string): TimeMutationAckResult;
+    view(receipt: ExternalTimeMutationReceipt): ExternalTimeOperationReceiptView;
+    size(): number;
+    private liveCount;
+    private transition;
+    private ensureCapacity;
+    private oldestTerminal;
+    private sameTuple;
+}

package/dist/server/modules/external-integrations/sessions/external-time-mutation.store.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalTimeMutationStore = void 0;
+exports.timeEntryNoteFingerprint = timeEntryNoteFingerprint;
+const node_crypto_1 = require("node:crypto");
+const external_time_mutation_models_1 = require("../models/external-time-mutation.models");
+function timeEntryNoteFingerprint(note) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(note ?? '')
+        .digest('hex');
+}
+class ExternalTimeMutationStore {
+    maxLive;
+    maxReceipts;
+    ttlMs;
+    now;
+    receipts = new Map();
+    constructor(maxLive = external_time_mutation_models_1.TIME_OPERATION_MAX_LIVE_RECEIPTS, maxReceipts = external_time_mutation_models_1.TIME_OPERATION_MAX_RECEIPTS, ttlMs = external_time_mutation_models_1.TIME_OPERATION_RECEIPT_TTL_MS, now = Date.now) {
+        this.maxLive = maxLive;
+        this.maxReceipts = maxReceipts;
+        this.ttlMs = ttlMs;
+        this.now = now;
+    }
+    admit(input) {
+        const existing = this.get(input.operationId);
+        if (existing) {
+            if (!this.sameTuple(existing.tuple, input.tuple)) {
+                return { ok: false, reason: 'operation_id_conflict', receipt: existing };
+            }
+            return {
+                ok: false,
+                reason: external_time_mutation_models_1.TERMINAL_TIME_MUTATION_PHASES.has(existing.phase)
+                    ? 'duplicate_terminal'
+                    : 'duplicate_live',
+                receipt: existing,
+            };
+        }
+        if (this.liveCount() >= this.maxLive) {
+            return { ok: false, reason: 'receipt_capacity' };
+        }
+        if (!this.ensureCapacity()) {
+            return { ok: false, reason: 'receipt_capacity' };
+        }
+        const timestamp = this.now();
+        const receipt = {
+            operationId: input.operationId,
+            kind: input.kind,
+            tuple: input.tuple,
+            phase: 'pending',
+            remoteEntryId: null,
+            baseline: input.baseline,
+            createdAt: timestamp,
+            updatedAt: timestamp,
+        };
+        this.receipts.set(input.operationId, receipt);
+        return { ok: true, receipt };
+    }
+    get(operationId) {
+        const receipt = this.receipts.get(operationId);
+        if (!receipt) {
+            return null;
+        }
+        if (this.now() - receipt.createdAt > this.ttlMs) {
+            this.receipts.delete(operationId);
+            return null;
+        }
+        return receipt;
+    }
+    markDispatched(operationId) {
+        return this.transition(operationId, 'dispatched');
+    }
+    markUnknown(operationId) {
+        return this.transition(operationId, 'outcome_unknown');
+    }
+    markTerminal(operationId, phase, remoteEntryId) {
+        const receipt = this.get(operationId);
+        if (!receipt) {
+            return null;
+        }
+        receipt.phase = phase;
+        receipt.updatedAt = this.now();
+        if (remoteEntryId !== undefined) {
+            receipt.remoteEntryId = remoteEntryId;
+        }
+        return receipt;
+    }
+    acknowledgeUnknown(operationId) {
+        const receipt = this.get(operationId);
+        if (!receipt) {
+            return { ok: false, reason: 'not_found' };
+        }
+        if (receipt.phase !== 'outcome_unknown') {
+            return { ok: false, reason: 'not_unknown' };
+        }
+        receipt.phase = 'abandoned_unknown';
+        receipt.updatedAt = this.now();
+        return { ok: true, receipt };
+    }
+    view(receipt) {
+        return {
+            operationId: receipt.operationId,
+            kind: receipt.kind,
+            provider: receipt.tuple.provider,
+            remoteTaskId: receipt.tuple.remoteTaskId,
+            remoteEntryId: receipt.remoteEntryId,
+            phase: receipt.phase,
+            createdAt: new Date(receipt.createdAt).toISOString(),
+            updatedAt: new Date(receipt.updatedAt).toISOString(),
+            expiresAt: new Date(receipt.createdAt + this.ttlMs).toISOString(),
+        };
+    }
+    size() {
+        return this.receipts.size;
+    }
+    liveCount() {
+        let live = 0;
+        for (const receipt of this.receipts.values()) {
+            if (!external_time_mutation_models_1.TERMINAL_TIME_MUTATION_PHASES.has(receipt.phase)) {
+                live += 1;
+            }
+        }
+        return live;
+    }
+    transition(operationId, phase) {
+        const receipt = this.get(operationId);
+        if (!receipt) {
+            return null;
+        }
+        receipt.phase = phase;
+        receipt.updatedAt = this.now();
+        return receipt;
+    }
+    ensureCapacity() {
+        if (this.receipts.size < this.maxReceipts) {
+            return true;
+        }
+        for (const [operationId, receipt] of this.receipts) {
+            if (this.now() - receipt.createdAt > this.ttlMs) {
+                this.receipts.delete(operationId);
+            }
+        }
+        while (this.receipts.size >= this.maxReceipts) {
+            const evictable = this.oldestTerminal();
+            if (!evictable) {
+                return false;
+            }
+            this.receipts.delete(evictable);
+        }
+        return true;
+    }
+    oldestTerminal() {
+        for (const [operationId, receipt] of this.receipts) {
+            if (external_time_mutation_models_1.TERMINAL_TIME_MUTATION_PHASES.has(receipt.phase)) {
+                return operationId;
+            }
+        }
+        return null;
+    }
+    sameTuple(left, right) {
+        return (left.provider === right.provider &&
+            left.connectionId === right.connectionId &&
+            left.connectionGeneration === right.connectionGeneration &&
+            left.remoteTaskId === right.remoteTaskId &&
+            left.remoteEntryId === right.remoteEntryId &&
+            left.effectiveStartedAt === right.effectiveStartedAt &&
+            left.durationMs === right.durationMs &&
+            left.noteFingerprint === right.noteFingerprint);
+    }
+}
+exports.ExternalTimeMutationStore = ExternalTimeMutationStore;
+//# sourceMappingURL=external-time-mutation.store.js.map

package/dist/server/modules/external-integrations/sessions/external-time-mutation.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-time-mutation.store.js","sourceRoot":"","sources":["../../../../src/modules/external-integrations/sessions/external-time-mutation.store.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/external-integrations/sessions/provider-operation-gate.d.ts

@@ -0,0 +1,7 @@
+export type ProviderOperationGateKey = string;
+export declare const PROVIDER_GATE_BUSY_REASON = "operation_in_progress";
+export declare class ProviderOperationGate {
+    private readonly held;
+    run<T>(key: ProviderOperationGateKey, operation: () => Promise<T>): Promise<T>;
+    isHeld(key: ProviderOperationGateKey): boolean;
+}

package/dist/server/modules/external-integrations/sessions/provider-operation-gate.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderOperationGate = exports.PROVIDER_GATE_BUSY_REASON = void 0;
+const error_types_1 = require("../../../common/errors/error-types");
+exports.PROVIDER_GATE_BUSY_REASON = 'operation_in_progress';
+class ProviderOperationGate {
+    held = new Map();
+    async run(key, operation) {
+        if (this.held.has(key)) {
+            throw new error_types_1.BusyError('A provider operation is already in progress.', {
+                reason: exports.PROVIDER_GATE_BUSY_REASON,
+                provider: key,
+            });
+        }
+        let release = () => undefined;
+        const promise = new Promise((resolve) => {
+            release = resolve;
+        });
+        this.held.set(key, { promise });
+        try {
+            return await operation();
+        }
+        finally {
+            this.held.delete(key);
+            release();
+        }
+    }
+    isHeld(key) {
+        return this.held.has(key);
+    }
+}
+exports.ProviderOperationGate = ProviderOperationGate;
+//# sourceMappingURL=provider-operation-gate.js.map

package/dist/server/modules/external-integrations/sessions/provider-operation-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-operation-gate.js","sourceRoot":"","sources":["../../../../src/modules/external-integrations/sessions/provider-operation-gate.ts"],"names":[],"mappings":";;;AAMA,oEAA+D;AAIlD,QAAA,yBAAyB,GAAG,uBAAuB,CAAC;AAMjE,MAAa,qBAAqB;IACf,IAAI,GAAG,IAAI,GAAG,EAAuC,CAAC;IAOvE,KAAK,CAAC,GAAG,CAAI,GAA6B,EAAE,SAA2B;QACrE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,uBAAS,CAAC,8CAA8C,EAAE;gBAClE,MAAM,EAAE,iCAAyB;gBACjC,QAAQ,EAAE,GAAG;aACd,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAA6B;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AA/BD,sDA+BC"}