@catalyst-cloud/sdk 0.16.0 → 0.16.1

package/dist/events-socket.d.ts

@@ -0,0 +1,82 @@
+import { type AuthStrategy, type WebSocketFactory } from "./live-sync-client.js";
+/** One `events` frame as the cloud sent it. `events` is unparsed: the follower validates each one. */
+export interface EventsFrame {
+    after: number;
+    through: number;
+    gap: boolean;
+    events: unknown[];
+}
+export type EventsSocketState = "idle" | "connecting" | "live" | "down" | "stopped";
+export interface EventsSocketOptions {
+    /** The cloud origin, e.g. `https://staging.catalystcloud.dev` (no `/api/v1`). */
+    baseUrl: string;
+    auth: Exclude<AuthStrategy, {
+        kind: "cookie";
+    }>;
+    tenantId: string;
+    /** Opens the socket. Defaults to the runtime's global `WebSocket`. */
+    wsFactory?: WebSocketFactory;
+    /** Silence after which the client sends a ping. Default 90 s. */
+    pingAfterMs?: number;
+    /** How long a ping, or a new socket's subscription, may go unanswered before reconnecting. Default 15 s. */
+    pongTimeoutMs?: number;
+    /** First reconnect delay after a failure, doubling to `reconnectMaxMs`. Default 1 s. */
+    reconnectMinMs?: number;
+    reconnectMaxMs?: number;
+    /** Buffered frames past this count, or past `maxBufferedBytes`, are dropped and reported as an overflow. */
+    maxBufferedFrames?: number;
+    maxBufferedBytes?: number;
+}
+export interface EventsSocketBatch {
+    frames: EventsFrame[];
+    /** Frames were dropped since the last take; the follower must catch up through the backbone. */
+    overflowed: boolean;
+    /** The generation the frames were taken under. */
+    generation: number;
+}
+/** The runtime's global WebSocket, or null when it has none (then a follower polls). */
+export declare function globalWebSocketFactory(): WebSocketFactory | null;
+/** The events socket URL. The token rides `?token=` because a WebSocket cannot set a header. */
+export declare function eventsSocketUrl(options: Pick<EventsSocketOptions, "baseUrl" | "auth" | "tenantId">, token?: string): string;
+export declare class EventsChannelClient {
+    private readonly options;
+    private readonly factory;
+    private ws;
+    private current;
+    private gen;
+    private frames;
+    private bufferedBytes;
+    private overflow;
+    private backoff;
+    private openedAt;
+    /** Bumped on every teardown, so a bearer token resolving late cannot open a superseded socket. */
+    private attempt;
+    private reconnectTimer;
+    private silenceTimer;
+    private answerTimer;
+    private waiters;
+    constructor(options: EventsSocketOptions);
+    get state(): EventsSocketState;
+    /** Bumped each time a socket confirms its subscription. */
+    get generation(): number;
+    hasPending(): boolean;
+    /** Take every buffered frame, and whether any were dropped, in arrival order. */
+    take(): EventsSocketBatch;
+    /**
+     * Resolves on the next buffered frame or the next time a socket goes live. Never rejects; an abort
+     * only unregisters the waiter, so a long outage does not pile them up.
+     */
+    changed(signal?: AbortSignal): Promise<void>;
+    start(): void;
+    stop(): void;
+    private notify;
+    private open;
+    private onMessage;
+    /** The socket closed or failed: tear it down and schedule the next attempt. */
+    private fail;
+    private teardown;
+    private armSilence;
+    private armAnswer;
+    private clearAnswer;
+}
+//# sourceMappingURL=events-socket.d.ts.map

package/dist/events-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-socket.d.ts","sourceRoot":"","sources":["../src/events-socket.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAsB,MAAM,uBAAuB,CAAC;AAGtH,sGAAsG;AACtG,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4GAA4G;IAC5G,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gGAAgG;IAChG,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,wFAAwF;AACxF,wBAAgB,sBAAsB,IAAI,gBAAgB,GAAG,IAAI,CAGhE;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3H;AAmBD,qBAAa,mBAAmB;IAiBlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,kGAAkG;IAClG,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,OAAO,CAAyB;gBAEX,OAAO,EAAE,mBAAmB;IAOzD,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,2DAA2D;IAC3D,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,UAAU,IAAI,OAAO;IAIrB,iFAAiF;IACjF,IAAI,IAAI,iBAAiB;IAQzB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,MAAM;YAMA,IAAI;IA6BlB,OAAO,CAAC,SAAS;IA2CjB,+EAA+E;IAC/E,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,QAAQ;IA4BhB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,WAAW;CAIpB"}

package/dist/events-socket.js

@@ -0,0 +1,295 @@
+// events-socket.ts — CTC-5295. The client half of the events socket (`/api/v1/connect?channels=events`,
+// catalyst-cloud CTC-4562): the tenant pushes every backbone event over a hibernatable WebSocket, so
+// an event follower hears about an event when it happens instead of polling `/events/backbone`.
+//
+// This class only carries frames. It opens the socket, buffers each `events` frame, keeps the socket
+// alive, and reconnects. Deciding what a frame means for the cache (apply it, or catch up through the
+// backbone first) is `CatalystEventSync`'s job, in events.ts.
+//
+// ⭐ THE FRAME. `{type:"events", after, through, events[], gap?}`. Every backbone sequence in
+// (after, through] was scanned for this socket, and on an unfiltered `fields=full` socket the events
+// listed are all of them, as backbone lines. The next frame's `after` is this frame's `through`.
+//
+// ⭐ GENERATION. Bumped each time a socket confirms its subscription (the `channels` frame). Frames
+// from before a reconnect stay buffered (they are real events), but the follower must catch up
+// through the backbone once per generation, because nothing was pushed while the socket was down.
+import { buildConnectUrl } from "./live-sync-client.js";
+import { PING_FRAME, PONG_FRAME } from "./types.js";
+const DEFAULT_PING_AFTER_MS = 90_000;
+const DEFAULT_PONG_TIMEOUT_MS = 15_000;
+const DEFAULT_RECONNECT_MIN_MS = 1_000;
+const DEFAULT_RECONNECT_MAX_MS = 30_000;
+const DEFAULT_MAX_BUFFERED_FRAMES = 1_000;
+const DEFAULT_MAX_BUFFERED_BYTES = 8 * 1024 * 1024;
+/** The mirror's reauthenticate close codes: the credential bound passed, so reconnect at once. */
+const REAUTH_CLOSE_CODES = new Set([4401, 4410]);
+/** A socket that lived shorter than this before a reauth close reconnects with backoff, not at once. */
+const MIN_HEALTHY_LIFETIME_MS = 1_000;
+/** The runtime's global WebSocket, or null when it has none (then a follower polls). */
+export function globalWebSocketFactory() {
+    const Ctor = globalThis.WebSocket;
+    return typeof Ctor === "function" ? (url) => new Ctor(url) : null;
+}
+/** The events socket URL. The token rides `?token=` because a WebSocket cannot set a header. */
+export function eventsSocketUrl(options, token) {
+    return buildConnectUrl({
+        baseUrl: options.baseUrl,
+        connectPath: "/api/v1/connect",
+        accountId: options.tenantId,
+        auth: options.auth,
+        ...(token !== undefined ? { bearerToken: token } : {}),
+        extraParams: { channels: "events", fields: "full" },
+    });
+}
+function closeCode(event) {
+    const code = event?.code;
+    return typeof code === "number" ? code : undefined;
+}
+function parseEventsFrame(value) {
+    const { after, through, events } = value;
+    if (!Number.isSafeInteger(after) ||
+        !Number.isSafeInteger(through) ||
+        through < after ||
+        !Array.isArray(events))
+        return null;
+    return { after: after, through: through, gap: value.gap === true, events };
+}
+export class EventsChannelClient {
+    options;
+    factory;
+    ws = null;
+    current = "idle";
+    gen = 0;
+    frames = [];
+    bufferedBytes = 0;
+    overflow = false;
+    backoff;
+    openedAt = 0;
+    /** Bumped on every teardown, so a bearer token resolving late cannot open a superseded socket. */
+    attempt = 0;
+    reconnectTimer = null;
+    silenceTimer = null;
+    answerTimer = null;
+    waiters = [];
+    constructor(options) {
+        this.options = options;
+        const factory = options.wsFactory ?? globalWebSocketFactory();
+        if (!factory)
+            throw new Error("events socket: no WebSocket available; pass wsFactory");
+        this.factory = factory;
+        this.backoff = options.reconnectMinMs ?? DEFAULT_RECONNECT_MIN_MS;
+    }
+    get state() {
+        return this.current;
+    }
+    /** Bumped each time a socket confirms its subscription. */
+    get generation() {
+        return this.gen;
+    }
+    hasPending() {
+        return this.frames.length > 0 || this.overflow;
+    }
+    /** Take every buffered frame, and whether any were dropped, in arrival order. */
+    take() {
+        const batch = { frames: this.frames, overflowed: this.overflow, generation: this.gen };
+        this.frames = [];
+        this.bufferedBytes = 0;
+        this.overflow = false;
+        return batch;
+    }
+    /**
+     * Resolves on the next buffered frame or the next time a socket goes live. Never rejects; an abort
+     * only unregisters the waiter, so a long outage does not pile them up.
+     */
+    changed(signal) {
+        return new Promise((resolve) => {
+            if (signal?.aborted)
+                return;
+            this.waiters.push(resolve);
+            signal?.addEventListener("abort", () => {
+                this.waiters = this.waiters.filter((waiter) => waiter !== resolve);
+            }, { once: true });
+        });
+    }
+    start() {
+        if (this.current !== "idle" && this.current !== "stopped")
+            return;
+        this.current = "connecting";
+        void this.open();
+    }
+    stop() {
+        this.current = "stopped";
+        this.teardown();
+        if (this.reconnectTimer)
+            clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = null;
+        this.notify();
+    }
+    notify() {
+        const waiters = this.waiters;
+        this.waiters = [];
+        for (const resolve of waiters)
+            resolve();
+    }
+    async open() {
+        const attempt = ++this.attempt;
+        let token;
+        if (this.options.auth.kind === "bearer") {
+            try {
+                token = await this.options.auth.getToken();
+            }
+            catch {
+                if (attempt === this.attempt && this.current !== "stopped")
+                    this.fail(undefined);
+                return;
+            }
+            if (attempt !== this.attempt || this.current === "stopped")
+                return;
+        }
+        let ws;
+        try {
+            ws = this.factory(eventsSocketUrl(this.options, token));
+        }
+        catch {
+            this.fail(undefined);
+            return;
+        }
+        this.ws = ws;
+        this.openedAt = Date.now();
+        // The subscription must be confirmed within the answer window, or the socket is presumed dead.
+        this.armAnswer();
+        ws.onmessage = (event) => this.onMessage(event.data);
+        ws.onclose = (event) => this.fail(closeCode(event));
+        // Some runtimes fire error without a close; treat it as one.
+        ws.onerror = () => this.fail(undefined);
+    }
+    onMessage(data) {
+        this.clearAnswer();
+        this.armSilence();
+        if (typeof data !== "string")
+            return;
+        if (data === PONG_FRAME)
+            return;
+        let value;
+        try {
+            value = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (!value || typeof value !== "object")
+            return;
+        const frame = value;
+        if (frame.type === "channels") {
+            this.current = "live";
+            this.gen++;
+            this.backoff = this.options.reconnectMinMs ?? DEFAULT_RECONNECT_MIN_MS;
+            this.notify();
+            return;
+        }
+        if (frame.type !== "events")
+            return;
+        const parsed = parseEventsFrame(frame);
+        if (!parsed) {
+            // A frame the client cannot read is a hole in the chain; the follower must catch up.
+            this.overflow = true;
+            this.notify();
+            return;
+        }
+        const bytes = data.length;
+        const maxFrames = this.options.maxBufferedFrames ?? DEFAULT_MAX_BUFFERED_FRAMES;
+        const maxBytes = this.options.maxBufferedBytes ?? DEFAULT_MAX_BUFFERED_BYTES;
+        if (this.frames.length + 1 > maxFrames || this.bufferedBytes + bytes > maxBytes) {
+            // Everything buffered is in the backbone already, so dropping it costs one catch-up, never an event.
+            this.frames = [];
+            this.bufferedBytes = 0;
+            this.overflow = true;
+        }
+        else {
+            this.frames.push(parsed);
+            this.bufferedBytes += bytes;
+        }
+        this.notify();
+    }
+    /** The socket closed or failed: tear it down and schedule the next attempt. */
+    fail(code) {
+        const lived = this.openedAt > 0 ? Date.now() - this.openedAt : 0;
+        this.teardown();
+        if (this.current === "stopped")
+            return;
+        this.current = "down";
+        const immediate = code !== undefined && REAUTH_CLOSE_CODES.has(code) && lived >= MIN_HEALTHY_LIFETIME_MS;
+        const delay = immediate ? 0 : this.backoff;
+        if (!immediate)
+            this.backoff = Math.min(this.options.reconnectMaxMs ?? DEFAULT_RECONNECT_MAX_MS, this.backoff * 2);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            if (this.current === "stopped")
+                return;
+            this.current = "connecting";
+            void this.open();
+        }, delay);
+    }
+    teardown() {
+        this.attempt++;
+        this.clearAnswer();
+        if (this.silenceTimer)
+            clearTimeout(this.silenceTimer);
+        this.silenceTimer = null;
+        this.openedAt = 0;
+        const ws = this.ws;
+        this.ws = null;
+        if (!ws)
+            return;
+        ws.onopen = null;
+        ws.onmessage = null;
+        ws.onclose = null;
+        ws.onerror = null;
+        try {
+            ws.close();
+        }
+        catch {
+            // Already closed.
+        }
+        const killable = ws;
+        if (typeof killable.terminate === "function") {
+            try {
+                killable.terminate();
+            }
+            catch {
+                // Already destroyed.
+            }
+        }
+    }
+    armSilence() {
+        if (this.silenceTimer)
+            clearTimeout(this.silenceTimer);
+        this.silenceTimer = setTimeout(() => {
+            this.silenceTimer = null;
+            const ws = this.ws;
+            if (!ws)
+                return;
+            try {
+                ws.send(PING_FRAME);
+            }
+            catch {
+                this.fail(undefined);
+                return;
+            }
+            this.armAnswer();
+        }, this.options.pingAfterMs ?? DEFAULT_PING_AFTER_MS);
+    }
+    armAnswer() {
+        this.clearAnswer();
+        this.answerTimer = setTimeout(() => {
+            this.answerTimer = null;
+            this.fail(undefined);
+        }, this.options.pongTimeoutMs ?? DEFAULT_PONG_TIMEOUT_MS);
+    }
+    clearAnswer() {
+        if (this.answerTimer)
+            clearTimeout(this.answerTimer);
+        this.answerTimer = null;
+    }
+}
+//# sourceMappingURL=events-socket.js.map

package/dist/events-socket.js.map

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

package/dist/events.d.ts

@@ -1,7 +1,9 @@
 import type { CatalystEvent } from "@catalyst-cloud/schema";
-import type { AuthStrategy } from "./live-sync-client.js";
+import type { AuthStrategy, WebSocketFactory } from "./live-sync-client.js";
+import { type EventsSocketOptions } from "./events-socket.js";
 import { type WriterGuardOptions } from "./replica/writer-lock.js";
 export type { CatalystEvent } from "@catalyst-cloud/schema";
+export { EventsChannelClient, eventsSocketUrl, type EventsFrame, type EventsSocketBatch, type EventsSocketOptions, type EventsSocketState, } from "./events-socket.js";
 export interface EventCachePaths {
     directory: string;
     cursor: string;
@@ -23,6 +25,16 @@ export interface EventSyncOptions {
     writerGuard?: WriterGuardOptions;
     now?: () => Date;
     sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+    /**
+     * Take events from the tenant's events socket instead of polling (CTC-5295). Default true when the
+     * runtime has a global `WebSocket` or `wsFactory` is given. The socket opens on `start()` or
+     * `waitForChange()`, never on a bare `syncOnce()`, and closes on `stop()`.
+     */
+    push?: boolean;
+    /** Opens the events socket. Defaults to the runtime's global `WebSocket`. */
+    wsFactory?: WebSocketFactory;
+    /** Events socket timing and buffer bounds; the defaults suit a long-running follower. */
+    socket?: Pick<EventsSocketOptions, "pingAfterMs" | "pongTimeoutMs" | "reconnectMinMs" | "reconnectMaxMs" | "maxBufferedFrames" | "maxBufferedBytes">;
 }
 export interface EventSyncStatus {
     state: "idle" | "syncing" | "stopped" | "failed";
@@ -30,6 +42,8 @@ export interface EventSyncStatus {
     head: number | null;
     lastSyncAt: string | null;
     error: string | null;
+    /** How new events arrive: `push` while the events socket is live, else `poll`. */
+    transport?: "push" | "poll";
 }
 export interface EventSyncResult {
     appended: number;
@@ -55,6 +69,10 @@ export declare class CatalystEventSync {
     private running;
     private recoveredCursor;
     private floor;
+    private socket;
+    /** The socket generation the cache last caught up under; a new one needs a backbone catch-up. */
+    private syncedGeneration;
+    private catchUpPending;
     private current;
     constructor(options: EventSyncOptions);
     status(): EventSyncStatus;
@@ -62,6 +80,25 @@ export declare class CatalystEventSync {
     start(): Promise<void>;
     stop(): Promise<void>;
     private loop;
+    /**
+     * Wait up to `maxMs` for something to sync: a pushed frame, or the events socket going live (which
+     * needs a catch-up). Opens the events socket on first call when push is on. Resolves true when a
+     * change ended the wait, false on timeout; rejects only when `signal` aborts. Without a socket it
+     * is a plain sleep, so a caller's own loop can use it either way.
+     */
+    waitForChange(maxMs: number, signal: AbortSignal): Promise<boolean>;
+    private ensureSocket;
+    private closeSocket;
+    private needsCatchUp;
+    /**
+     * The push path. Apply buffered frames that chain from the cursor with no request. Read the backbone
+     * from the cursor instead when this socket generation has not caught up yet (subscribe first: the
+     * frames buffered meanwhile are deduped by sequence after), when a frame starts past the cursor, is
+     * flagged `gap`, or carries an event without its payload, or when the buffer overflowed.
+     */
+    private readPushed;
+    /** Apply frames that chain from `cursor`; stop at the first one that does not. */
+    private applyFrames;
     private request;
     private readCurrentHead;
     private readPage;

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAW5D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAHvB,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAK1B;AASD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,CAOjB;AAiOD,qBAAa,iBAAiB;IAkBhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjBpC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqD;IAC7E,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,OAAO,CAMb;gBAE2B,OAAO,EAAE,gBAAgB;IAOtD,MAAM,IAAI,eAAe;IAInB,QAAQ,CACZ,MAAM,GAAE,WAA0C,GACjD,OAAO,CAAC,eAAe,CAAC;IA0D3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAehB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBb,IAAI;YAqCJ,OAAO;YAiBP,eAAe;YASf,QAAQ;CAoCvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,aAAa,EAAE,CAAC,CAsC1B;AAED,wBAAuB,gBAAgB,CACrC,OAAO,EAAE,uBAAuB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACzD,cAAc,CAAC,aAAa,CAAC,CAgC/B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE1D"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}