@abloatai/transaction 0.37.0

package/dist/transport/wsFrameHandlers.js

@@ -0,0 +1,429 @@
+/**
+ * Routes each inbound frame from the sync WebSocket to the handler for its
+ * type. Handlers work against a minimal {@link WsSession} interface — only
+ * the members they actually touch, rather than the transport object itself,
+ * which keeps this module free of an import cycle. Reading a message off the
+ * socket, parsing its JSON, and tracking heartbeats all happen before this
+ * point; every parsed frame then passes through {@link dispatchWsFrame}.
+ */
+import { AbloConnectionError, CapabilityError, errorFromWire, } from '../errors.js';
+import { commitAckSchema, commitReceiptSchema } from '../wire/commit.js';
+import { subscriptionAckPayloadSchema } from '../coordination/schema.js';
+import { WS_INBOUND_FRAMES, isKnownInboundFrame, isSchemaValidatedFrame, wsInboundEnvelopeSchema, } from '../wire/inboundFrames.js';
+import { formatConflict } from '../coordination/trace.js';
+import { parseNotifications, recordClaim } from './commitFrames.js';
+/** Narrow arbitrary wire data to a plain string-keyed record. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Read the envelope off an inbound message, or `null` when it is not one —
+ * anything that is not an object, or whose `type` is not a string. The payload
+ * is not checked here; that belongs to the frame's own schema, applied at
+ * dispatch.
+ */
+export function readWsInboundFrame(value) {
+    const parsed = wsInboundEnvelopeSchema.safeParse(value);
+    return parsed.success ? parsed.data : null;
+}
+/**
+ * Handles the acknowledgement of a `commit` request. The canonical wire
+ * shape is `MutationResultMessage`. The payload is parsed defensively
+ * rather than cast, since it is untrusted and may be malformed or sent by
+ * an older server.
+ */
+const handleMutationResult = (session, message) => {
+    const p = (message.payload ?? message);
+    const { clientTxId, success, error } = p;
+    // Defensive: validate notifications against the canonical schema —
+    // untrusted wire data from a possibly-older/newer server.
+    const notifications = parseNotifications(p?.notifications);
+    const missingIds = Array.isArray(p.missingIds)
+        ? [
+            ...new Set(p.missingIds.filter((id) => typeof id === 'string' && id.length > 0)),
+        ]
+        : undefined;
+    const pending = typeof clientTxId === 'string'
+        ? session.pendingMutations.get(clientTxId)
+        : undefined;
+    if (!pending)
+        return;
+    clearTimeout(pending.timeout);
+    // `pending` exists ⇒ clientTxId was a string key (the guard above).
+    session.pendingMutations.delete(clientTxId);
+    if (success) {
+        const parsedReceipt = commitReceiptSchema.safeParse({
+            ...p,
+            notifications,
+            missingIds,
+        });
+        if (!parsedReceipt.success) {
+            pending.reject(new AbloConnectionError('The sync server returned an invalid commit receipt; its outcome remains pending and is safe to retry.', { code: 'commit_no_result', cause: parsedReceipt.error }));
+            return;
+        }
+        const receipt = parsedReceipt.data;
+        // The write succeeded, but a guarded premise shifted underneath it.
+        // Emit the advisory signal so a caller can react, and still resolve
+        // the receipt, since the commit itself went through.
+        if (receipt.notifications && receipt.notifications.length > 0) {
+            const txId = receipt.clientTxId;
+            const event = {
+                clientTxId: txId,
+                rows: receipt.notifications.map((n) => ({
+                    model: n.model,
+                    id: n.id,
+                    fields: n.conflictingFields,
+                    writtenBy: n.writtenBy.kind,
+                })),
+            };
+            const message = formatConflict(event);
+            session.logger.warn(message);
+            session.observability.breadcrumb(message, 'sync.coordination', 'warning');
+            session.observability.captureConflict(event);
+            session.emit('conflict:notified', {
+                clientTxId: txId,
+                notifications: receipt.notifications,
+            });
+        }
+        pending.resolve(commitAckSchema.parse({
+            status: receipt.status,
+            ...(receipt.correlationId
+                ? { correlationId: receipt.correlationId }
+                : {}),
+            lastSyncId: receipt.lastSyncId,
+            ...(receipt.notifications && receipt.notifications.length > 0
+                ? { notifications: receipt.notifications }
+                : {}),
+            ...(receipt.missingIds && receipt.missingIds.length > 0
+                ? { missingIds: receipt.missingIds }
+                : {}),
+        }));
+    }
+    else {
+        // Capture the full server error so the caller can see what actually
+        // rejected the mutation, rather than a generic "mutation failed on
+        // server". Object errors are stringified so structured server payloads,
+        // such as validation issues, survive being wrapped in an Error.
+        let errorMessage;
+        let errorCode;
+        let requiredCapability;
+        if (typeof error === 'string') {
+            errorMessage = error;
+        }
+        else if (error != null && typeof error === 'object') {
+            const obj = error;
+            if (typeof obj.code === 'string')
+                errorCode = obj.code;
+            if (typeof obj.message === 'string') {
+                errorMessage = obj.message;
+            }
+            else {
+                try {
+                    errorMessage = JSON.stringify(error);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            if (obj.requiredCapability != null &&
+                typeof obj.requiredCapability === 'object' &&
+                typeof obj.requiredCapability.scope === 'string') {
+                requiredCapability = obj.requiredCapability;
+            }
+        }
+        else {
+            errorMessage = 'mutation failed on server';
+        }
+        // A stale-context rejection (the write read state that has since
+        // changed) or a foreign-claim conflict is a coordination collision.
+        // The success-with-notifications path above records the conflict, and a
+        // hard rejection must record it too, or the collision count would miss
+        // every rejected write. The conflicting rows ride along on the typed
+        // error's `conflicts` detail.
+        if (errorCode === 'stale_context' ||
+            errorCode === 'claim_conflict' ||
+            errorCode === 'entity_claimed' ||
+            errorCode?.startsWith('policy:') === true) {
+            const rawConflicts = error != null &&
+                typeof error === 'object' &&
+                Array.isArray(error.conflicts)
+                ? error
+                    .conflicts
+                : [];
+            const conflictEvent = {
+                clientTxId: typeof clientTxId === 'string' ? clientTxId : '',
+                rows: rawConflicts.map((r) => ({
+                    model: typeof r.model === 'string' ? r.model : 'unknown',
+                    id: typeof r.id === 'string' ? r.id : 'unknown',
+                    fields: [],
+                })),
+            };
+            session.observability.breadcrumb(formatConflict(conflictEvent), 'sync.coordination', 'warning');
+            session.observability.captureConflict(conflictEvent);
+        }
+        // Build the proper typed AbloError from the wire code via the
+        // shared factory — the same code→class mapping the HTTP commit
+        // path uses (`translateHttpError`). This keeps rejected commits
+        // inside the typed hierarchy (capability denials →
+        // CapabilityError with `.requiredCapability`; foreign-claim
+        // conflicts → AbloClaimedError; everything else → the subclass
+        // its registry `httpStatus` implies) instead of a hand-rolled
+        // `new Error`, so callers can `instanceof`/`e.type` it and
+        // downstream retry logic can read the contract's retryability.
+        pending.reject(errorFromWire(errorMessage, {
+            code: errorCode,
+            requiredCapability,
+        }));
+    }
+};
+/**
+ * Handles the acknowledgement of a `claim` request. The frame has the shape
+ * `{ type: 'claim_ack', payload: { claimId, success, syncGroups?,
+ * ttlSeconds?, error? } }`.
+ */
+const handleClaimAck = (session, message) => {
+    const p = (message.payload ?? {});
+    const { claimId, success, syncGroups, ttlSeconds, error } = p;
+    const pending = typeof claimId === 'string'
+        ? session.pendingClaims.get(claimId)
+        : undefined;
+    if (!pending)
+        return;
+    clearTimeout(pending.timeout);
+    // `pending` exists ⇒ claimId was a string key (the guard above).
+    session.pendingClaims.delete(claimId);
+    if (success) {
+        pending.resolve({
+            syncGroups: Array.isArray(syncGroups) ? syncGroups : [],
+            ttlSeconds: typeof ttlSeconds === 'number' ? ttlSeconds : undefined,
+        });
+    }
+    else {
+        const err = error;
+        const code = err?.code && typeof err.code === 'string'
+            ? err.code
+            : 'claim_rejected';
+        const msg = err?.message && typeof err.message === 'string'
+            ? err.message
+            : 'claim rejected by server';
+        // Capability denials get the typed CapabilityError so
+        // callers can read `.requiredCapability` and attenuate-
+        // and-retry the claim with a narrower token.
+        if (code === 'capability_scope_denied' ||
+            code === 'capability_invalid') {
+            const rc = error
+                ?.requiredCapability;
+            const requiredCapability = rc != null &&
+                typeof rc === 'object' &&
+                typeof rc.scope === 'string'
+                ? rc
+                : undefined;
+            pending.reject(new CapabilityError(code, msg, requiredCapability));
+        }
+        else {
+            // Route through the shared factory so a failed claim_ack is a
+            // typed AbloError (registry code → right subclass), symmetric
+            // with the commit `mutation_result` path — never a bare Error.
+            pending.reject(errorFromWire(msg, { code }));
+        }
+    }
+};
+/**
+ * Handles the acknowledgement of an `update_subscription` request. The wire
+ * carries no correlation id, so the ack is matched to the oldest pending
+ * request in first-in, first-out order, since the server applies and
+ * acknowledges subscription updates in the order it receives them. The
+ * payload is validated against its canonical schema before use.
+ */
+const handleSubscriptionAck = (session, message) => {
+    const pending = session.shiftPendingSubscription();
+    if (!pending)
+        return;
+    clearTimeout(pending.timeout);
+    const parsed = subscriptionAckPayloadSchema.safeParse(message.payload);
+    if (!parsed.success) {
+        // Unreadable ack — resolve the pending request as a failure
+        // rather than hang it until timeout.
+        pending.reject(errorFromWire('malformed subscription_ack from server', {
+            code: 'malformed_subscription',
+        }));
+        return;
+    }
+    const ack = parsed.data;
+    if (ack.success) {
+        // Keep the reconnect URL aligned with current interest: a
+        // reconnect re-subscribes from `this.options.syncGroups`.
+        session.options.syncGroups = ack.syncGroups;
+        pending.resolve({ syncGroups: ack.syncGroups });
+    }
+    else {
+        pending.reject(errorFromWire(ack.error?.message ?? 'update_subscription rejected by server', { code: ack.error?.code ?? 'malformed_subscription' }));
+    }
+};
+/**
+ * Handles a `delta` frame, which carries either a single delta or a
+ * `{ deltas: [...] }` batch. This only tells the two shapes apart; each
+ * delta is validated once downstream, so batch elements are passed along
+ * raw rather than parsed here.
+ */
+const handleDeltaFrame = (session, message) => {
+    const p = message.payload;
+    if (!isRecord(p))
+        return;
+    if (p.actionType || p.modelName) {
+        session.handleDelta(p);
+    }
+    else if (Array.isArray(p.deltas)) {
+        for (const d of p.deltas) {
+            session.handleDelta(d);
+        }
+        // `p.newVersions` from older servers is ignored; `sync_id` is the
+        // causality token.
+    }
+};
+/** The reporting ports of one session, in the shape {@link recordClaim} takes. */
+function tracePorts(session) {
+    return { logger: session.logger, observability: session.observability };
+}
+/**
+ * Maps each frame type to its handler. Every named server frame this
+ * package understands is dispatched from this table; anything else falls
+ * through to the collaboration-event and unknown-type path in
+ * {@link dispatchWsFrame}.
+ */
+export const wsFrameHandlers = {
+    sync_response: (session, message) => { session.handleSyncResponse(message.payload); },
+    bootstrap_response: (session, message) => { session.handleBootstrapResponse(message.payload); },
+    presence_update: (session, message) => { session.handlePresenceUpdate(message); },
+    mutation_result: handleMutationResult,
+    claim_ack: handleClaimAck,
+    subscription_ack: handleSubscriptionAck,
+    delta: handleDeltaFrame,
+};
+/**
+ * Binds a handler to the schema that validates its input.
+ *
+ * The two are paired here, at the declaration, so the payload type is inferred
+ * from the schema rather than restated — and the frame's validation cannot be
+ * changed without the handler's parameter type following it. The bound function
+ * accepts `unknown`, which is what lets the dispatcher call any of them from a
+ * lookup without an assertion.
+ */
+function validating(schema, frameType, run) {
+    return (session, payload) => {
+        const parsed = schema.safeParse(payload ?? {});
+        if (!parsed.success) {
+            throw new AbloConnectionError(`The sync server sent a ${frameType} frame that does not match the protocol; it was not applied.`, { code: 'malformed_response', cause: parsed.error });
+        }
+        run(session, parsed.data);
+    };
+}
+/**
+ * Handlers for the frames the protocol validates before dispatch. Each takes
+ * the parsed payload, typed by the registry's own schema — which is why none of
+ * them narrows, defaults, or casts. The record's key type makes the table
+ * exhaustive: adding a `validation: 'schema'` frame to the registry without
+ * adding it here is a compile error.
+ */
+const validatedFrameHandlers = {
+    presence_update: validating(WS_INBOUND_FRAMES.presence_update.payload, 'presence_update', (session, payload) => {
+        session.handlePresenceUpdate({ payload });
+    }),
+    claim_expired: validating(WS_INBOUND_FRAMES.claim_expired.payload, 'claim_expired', (session, payload) => {
+        // Server-initiated expiry. The claim is already inactive by the time
+        // this arrives, so a consumer either re-claims with a fresh credential
+        // or accepts the drop.
+        recordClaim(tracePorts(session), 'expired', payload);
+        session.emit('claim_expired', payload);
+    }),
+    claim_rejected: validating(WS_INBOUND_FRAMES.claim_rejected.payload, 'claim_rejected', (session, payload) => {
+        // The target is held by another participant and this claim did not opt
+        // into the wait line.
+        recordClaim(tracePorts(session), 'rejected', payload);
+        session.emit('claim_rejected', payload);
+    }),
+    claim_acquired: validating(WS_INBOUND_FRAMES.claim_acquired.payload, 'claim_acquired', (session, payload) => {
+        // The target was free: the lease is ours without waiting.
+        recordClaim(tracePorts(session), 'acquired', payload);
+        session.emit('claim_acquired', payload);
+    }),
+    claim_queued: validating(WS_INBOUND_FRAMES.claim_queued.payload, 'claim_queued', (session, payload) => {
+        // Opt-in fair queue: our claim waits in line, carrying its position.
+        recordClaim(tracePorts(session), 'queued', payload);
+        session.emit('claim_queued', payload);
+    }),
+    claim_granted: validating(WS_INBOUND_FRAMES.claim_granted.payload, 'claim_granted', (session, payload) => {
+        // Our queued claim reached the head — the lease is now ours.
+        recordClaim(tracePorts(session), 'granted', payload);
+        session.emit('claim_granted', payload);
+    }),
+    claim_lost: validating(WS_INBOUND_FRAMES.claim_lost.payload, 'claim_lost', (session, payload) => {
+        // A held or granted lease was taken from us (TTL lapse, preemption).
+        recordClaim(tracePorts(session), 'lost', payload);
+        session.emit('claim_lost', payload);
+    }),
+    claim_queue: validating(WS_INBOUND_FRAMES.claim_queue.payload, 'claim_queue', (session, payload) => {
+        // Per-entity wait-line snapshot backing the reactive `queue(id)` read.
+        // Not logged: the per-claim queued/granted events tell that story.
+        session.emit('claim_queue', payload);
+    }),
+    claim_heartbeat_ack: validating(WS_INBOUND_FRAMES.claim_heartbeat_ack.payload, 'claim_heartbeat_ack', (session, payload) => {
+        // Reply to our `claim_heartbeat`; the claim stream correlates it back to
+        // the awaiting caller by claimId. Not logged per-frame — a heartbeat is
+        // a cadence, and the transition that matters (lost) surfaces as an error.
+        session.emit('claim_heartbeat_ack', payload);
+    }),
+};
+/**
+ * Routes one inbound frame to its handler, validating the payload first.
+ *
+ * A frame the protocol declares with a payload schema is parsed here, so its
+ * handler works on a proven shape. A frame the protocol does not declare is
+ * rejected: the server and this package ship together, so an unrecognised type
+ * means the two have drifted, and a change nobody validated should not reach a
+ * local store. The one exception is an application's own collaboration events,
+ * which the consumer registers at construction and the protocol knows nothing
+ * about.
+ *
+ * Throwing is the reporting channel. The transport's message loop catches and
+ * reports through `captureWebSocketError`, so a bad frame surfaces as a
+ * captured error and the connection survives.
+ */
+export function dispatchWsFrame(session, message) {
+    if (message.type === 'pong' || message.type === 'ping') {
+        // Ignore keepalive messages
+        session.logger.debug('Received keepalive', { type: message.type });
+        return;
+    }
+    if (message.type === undefined) {
+        // A bare delta, validated downstream like every other delta.
+        if (message.actionType || message.modelName) {
+            session.handleDelta(message);
+        }
+        return;
+    }
+    const frameType = message.type;
+    if (isKnownInboundFrame(frameType)) {
+        if (isSchemaValidatedFrame(frameType)) {
+            // Validated on the way in — see `validating`, which pairs each handler
+            // with the registry schema its parameter type is inferred from.
+            validatedFrameHandlers[frameType](session, message.payload);
+            return;
+        }
+        // `validation: 'handler'` — the check lives inside, cited by the registry.
+        const handler = wsFrameHandlers[frameType];
+        if (handler) {
+            handler(session, message);
+            return;
+        }
+    }
+    // Collaboration events use underscore wire format (e.g., 'section_selection')
+    // Convert to colon format for the event map (e.g., 'section:selection')
+    const eventKey = frameType.replace(/_/g, ':');
+    if (session.collaborationEventTypes.has(eventKey)) {
+        session.emit(eventKey, message.payload);
+        return;
+    }
+    throw new AbloConnectionError(`The sync server sent an unrecognised frame type "${frameType}". This client and the server have drifted; the frame was not applied.`, { code: 'malformed_response' });
+}
+//# sourceMappingURL=wsFrameHandlers.js.map

package/dist/transport/wsFrameHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsFrameHandlers.js","sourceRoot":"","sources":["../../src/transport/wsFrameHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,GAEd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GAGxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AA+CpF,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAuCD;;;;;GAKG;AACH,MAAM,oBAAoB,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAA4B,CAAC;IAClE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACzC,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,aAAa,GAAG,kBAAkB,CACrC,CAA6C,EAAE,aAAa,CAC9D,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QAC5C,CAAC,CAAC;YACE,GAAG,IAAI,GAAG,CACR,CAAC,CAAC,UAAU,CAAC,MAAM,CACjB,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAC9D,CACF;SACF;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,OAAO,GACX,OAAO,UAAU,KAAK,QAAQ;QAC5B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,oEAAoE;IACpE,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAoB,CAAC,CAAC;IACtD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,aAAa,GAAG,mBAAmB,CAAC,SAAS,CAAC;YAClD,GAAG,CAAC;YACJ,aAAa;YACb,UAAU;SACX,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CACZ,IAAI,mBAAmB,CACrB,uGAAuG,EACvG,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,CACzD,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC;QACnC,oEAAoE;QACpE,oEAAoE;QACpE,qDAAqD;QACrD,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;YAChC,MAAM,KAAK,GAAG;gBACZ,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtC,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,MAAM,EAAE,CAAC,CAAC,iBAAiB;oBAC3B,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI;iBAC5B,CAAC,CAAC;aACJ,CAAC;YACF,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;YAC1E,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAChC,UAAU,EAAE,IAAI;gBAChB,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,OAAO,CACb,eAAe,CAAC,KAAK,CAAC;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,CAAC,OAAO,CAAC,aAAa;gBACvB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;gBAC1C,CAAC,CAAC,EAAE,CAAC;YACP,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBAC3D,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;gBAC1C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBACrD,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;gBACpC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,oEAAoE;QACpE,mEAAmE;QACnE,wEAAwE;QACxE,gEAAgE;QAChE,IAAI,YAAoB,CAAC;QACzB,IAAI,SAA6B,CAAC;QAClC,IAAI,kBAAkD,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,KAIX,CAAC;YACF,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;YACvD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACpC,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACvC,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,IACE,GAAG,CAAC,kBAAkB,IAAI,IAAI;gBAC9B,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ;gBAC1C,OAAQ,GAAG,CAAC,kBAA0C,CAAC,KAAK,KAAK,QAAQ,EACzE,CAAC;gBACD,kBAAkB,GAAG,GAAG,CAAC,kBAAwC,CAAC;YACpE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,2BAA2B,CAAC;QAC7C,CAAC;QACD,iEAAiE;QACjE,oEAAoE;QACpE,wEAAwE;QACxE,uEAAuE;QACvE,qEAAqE;QACrE,8BAA8B;QAC9B,IACE,SAAS,KAAK,eAAe;YAC7B,SAAS,KAAK,gBAAgB;YAC9B,SAAS,KAAK,gBAAgB;YAC9B,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,IAAI,EACzC,CAAC;YACD,MAAM,YAAY,GAChB,KAAK,IAAI,IAAI;gBACb,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,CAAC,OAAO,CAAE,KAAiC,CAAC,SAAS,CAAC;gBACzD,CAAC,CAAE,KAAqE;qBACnE,SAAS;gBACd,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,aAAa,GAAG;gBACpB,UAAU,EAAE,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;gBAC5D,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;oBACxD,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;oBAC/C,MAAM,EAAE,EAAc;iBACvB,CAAC,CAAC;aACJ,CAAC;YACF,OAAO,CAAC,aAAa,CAAC,UAAU,CAC9B,cAAc,CAAC,aAAa,CAAC,EAC7B,mBAAmB,EACnB,SAAS,CACV,CAAC;YACF,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;QACD,8DAA8D;QAC9D,+DAA+D;QAC/D,gEAAgE;QAChE,mDAAmD;QACnD,4DAA4D;QAC5D,+DAA+D;QAC/D,8DAA8D;QAC9D,2DAA2D;QAC3D,+DAA+D;QAC/D,OAAO,CAAC,MAAM,CACZ,aAAa,CAAC,YAAY,EAAE;YAC1B,IAAI,EAAE,SAAS;YACf,kBAAkB;SACnB,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,cAAc,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAC1D,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;IAC7D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,OAAO,GACX,OAAO,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;QACpC,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,iEAAiE;IACjE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,OAAiB,CAAC,CAAC;IAChD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,OAAO,CAAC;YACd,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;YACvD,UAAU,EAAE,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACpE,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,KAEC,CAAC;QACd,MAAM,IAAI,GACR,GAAG,EAAE,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YACvC,CAAC,CAAC,GAAG,CAAC,IAAI;YACV,CAAC,CAAC,gBAAgB,CAAC;QACvB,MAAM,GAAG,GACP,GAAG,EAAE,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAC7C,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,0BAA0B,CAAC;QACjC,sDAAsD;QACtD,wDAAwD;QACxD,6CAA6C;QAC7C,IACE,IAAI,KAAK,yBAAyB;YAClC,IAAI,KAAK,oBAAoB,EAC7B,CAAC;YACD,MAAM,EAAE,GAAI,KAAsD;gBAChE,EAAE,kBAAkB,CAAC;YACvB,MAAM,kBAAkB,GACtB,EAAE,IAAI,IAAI;gBACV,OAAO,EAAE,KAAK,QAAQ;gBACtB,OAAQ,EAA0B,CAAC,KAAK,KAAK,QAAQ;gBACnD,CAAC,CAAE,EAAyB;gBAC5B,CAAC,CAAC,SAAS,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,8DAA8D;YAC9D,8DAA8D;YAC9D,+DAA+D;YAC/D,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,4BAA4B,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,4DAA4D;QAC5D,qCAAqC;QACrC,OAAO,CAAC,MAAM,CACZ,aAAa,CAAC,wCAAwC,EAAE;YACtD,IAAI,EAAE,wBAAwB;SAC/B,CAAC,CACH,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,0DAA0D;QAC1D,0DAA0D;QAC1D,OAAO,CAAC,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAC5C,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CACZ,aAAa,CACX,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,wCAAwC,EAC9D,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,wBAAwB,EAAE,CACtD,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAC5D,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO;IACzB,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,kEAAkE;QAClE,mBAAmB;IACrB,CAAC;AACH,CAAC,CAAC;AAEF,kFAAkF;AAClF,SAAS,UAAU,CAAC,OAAkB;IACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrF,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/F,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjF,eAAe,EAAE,oBAAoB;IACrC,SAAS,EAAE,cAAc;IACzB,gBAAgB,EAAE,qBAAqB;IACvC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAS,UAAU,CACjB,MAAoB,EACpB,SAAiB,EACjB,GAA6C;IAE7C,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,mBAAmB,CAC3B,0BAA0B,SAAS,8DAA8D,EACjG,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CACpD,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,sBAAsB,GAGxB;IACF,eAAe,EAAE,UAAU,CACzB,iBAAiB,CAAC,eAAe,CAAC,OAAO,EACzC,iBAAiB,EACjB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC,CACF;IACD,aAAa,EAAE,UAAU,CACvB,iBAAiB,CAAC,aAAa,CAAC,OAAO,EACvC,eAAe,EACf,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,qEAAqE;QACrE,uEAAuE;QACvE,uBAAuB;QACvB,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,CACF;IACD,cAAc,EAAE,UAAU,CACxB,iBAAiB,CAAC,cAAc,CAAC,OAAO,EACxC,gBAAgB,EAChB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,uEAAuE;QACvE,sBAAsB;QACtB,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CACF;IACD,cAAc,EAAE,UAAU,CACxB,iBAAiB,CAAC,cAAc,CAAC,OAAO,EACxC,gBAAgB,EAChB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,0DAA0D;QAC1D,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CACF;IACD,YAAY,EAAE,UAAU,CACtB,iBAAiB,CAAC,YAAY,CAAC,OAAO,EACtC,cAAc,EACd,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,qEAAqE;QACrE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC,CACF;IACD,aAAa,EAAE,UAAU,CACvB,iBAAiB,CAAC,aAAa,CAAC,OAAO,EACvC,eAAe,EACf,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,6DAA6D;QAC7D,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,CACF;IACD,UAAU,EAAE,UAAU,CACpB,iBAAiB,CAAC,UAAU,CAAC,OAAO,EACpC,YAAY,EACZ,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,qEAAqE;QACrE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CACF;IACD,WAAW,EAAE,UAAU,CACrB,iBAAiB,CAAC,WAAW,CAAC,OAAO,EACrC,aAAa,EACb,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,uEAAuE;QACvE,mEAAmE;QACnE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,CACF;IACD,mBAAmB,EAAE,UAAU,CAC7B,iBAAiB,CAAC,mBAAmB,CAAC,OAAO,EAC7C,qBAAqB,EACrB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACnB,yEAAyE;QACzE,wEAAwE;QACxE,0EAA0E;QAC1E,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,CACF;CACF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,OAAkB,EAAE,OAAuB;IACzE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACvD,4BAA4B;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,6DAA6D;QAC7D,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC5C,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/B,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,uEAAuE;YACvE,gEAAgE;YAChE,sBAAsB,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,2EAA2E;QAC3E,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,wEAAwE;IACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,mBAAmB,CAC3B,oDAAoD,SAAS,wEAAwE,EACrI,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAC/B,CAAC;AACJ,CAAC"}