@catalyst-cloud/sdk 0.9.2 → 0.10.0

package/README.md

@@ -244,6 +244,32 @@ switch (moved.outcome) {
 
 The contract cache is in memory per client by default; pass `contractCache: { get, set }` to keep it on disk (the bundle does). `fetch`, `now` and `timeoutMs` are injectable so a test never opens a socket.
 
+### Durable event cache for node and Bun
+
+`@catalyst-cloud/sdk/events` mirrors the tenant's exact durable Catalyst event backbone into an append-only local cache. It uses bounded HTTP replay with an idle backoff; local consumers tail files and never poll GitHub, Linear, or cloud tables. Start and stop it with the process that currently needs the tenant instead of installing another permanent daemon.
+
+```ts
+import { CatalystEventSync, tailCachedEvents } from "@catalyst-cloud/sdk/events";
+
+const sync = new CatalystEventSync({
+  baseUrl: "https://staging.catalystcloud.dev",
+  auth: { kind: "token", token: process.env.CATALYST_CLOUD_TOKEN! },
+  tenantId: "tenant-1",
+});
+const running = sync.start();
+for await (const event of tailCachedEvents({ tenantId: "tenant-1", signal })) {
+  console.log(event.type, event.sequence);
+}
+await sync.stop();
+await running;
+```
+
+The default path is `$XDG_STATE_HOME/catalyst/events/<tenant>/backbone/`, falling back to `~/.local/state/catalyst/events/<tenant>/backbone/`. Daily `YYYY-MM-DD[-NNN].jsonl` segments contain the cloud's `CatalystEvent` envelope unchanged. `cursor.json` is owned by the one sync writer; readers keep their own offsets elsewhere and do not write into this directory. The stable replay identity is `(tenantId, sequence, eventId)`.
+
+The writer fsyncs appended records before atomically advancing its cursor. On restart it truncates an incomplete final line and derives the resume cursor from the last complete record, making a crash between append and checkpoint safe. Server archive gaps and reads behind the local retention floor raise `EventHistoryGapError` with the head, suggested resume point, and reason; the SDK does not silently skip history. New caches bootstrap at the current backbone head. Closed daily segments are retained for seven days or until the cache reaches 256 MiB, whichever happens first. The active segment rotates before the same byte bound, so it cannot grow without limit; `retainDays` and `maxCacheBytes` configure these bounds.
+
+This API only reads the durable backbone. It does not publish events or treat raw provider events, the legacy coordination feed, or analytical samples as execution or billing authority. Use the existing authorized cloud operations to report outcomes and changes.
+
 ## API
 
 | Export | What it is |
@@ -256,6 +282,7 @@ The contract cache is in memory per client by default; pass `contractCache: { ge
 | `createTenantClient` | The typed HTTP client — `contract()`, `me()`, `issues.list/get`, `pulls.list/get`, `projects.list`, `agent.*` (issueState, issueLabel, issueComment, issueCreate, reaction, attachment, attachments, session, ask, askAccept). |
 | `TenantContract` · `routeByName` · `teamByKey` · `teamForTicket` · `stageIdForSlot` · `labelIdFor` | The contract document's shape and the pure accessors over it, each returning a typed miss rather than throwing. |
 | `TenantClientFailure` · `PageCursor` · `pageCursor` · `memoryContractCache` | The shared failure arms, the opaque page token, and the default contract cache store. |
+| `CatalystEventSync` · `readCachedEvents` · `tailCachedEvents` · `EventHistoryGapError` | Node/Bun durable-backbone replay, local cache readers, and explicit history-gap handling from `@catalyst-cloud/sdk/events`. |
 
 `start()` resolves only when `stop()` is called. On a backend, `await` it to keep the process alive; in a browser, never await it — just call `stop()` on teardown.
 

package/dist/events.d.ts

@@ -0,0 +1,79 @@
+import type { CatalystEvent } from "@catalyst-cloud/schema";
+import type { AuthStrategy } from "./live-sync-client.js";
+import { type WriterGuardOptions } from "./replica/writer-lock.js";
+export type { CatalystEvent } from "@catalyst-cloud/schema";
+export interface EventCachePaths {
+    directory: string;
+    cursor: string;
+    lock: string;
+}
+export interface EventSyncOptions {
+    baseUrl: string;
+    auth: Exclude<AuthStrategy, {
+        kind: "cookie";
+    }>;
+    tenantId: string;
+    directory?: string;
+    fetch?: typeof fetch;
+    requestTimeoutMs?: number;
+    idleMinMs?: number;
+    idleMaxMs?: number;
+    retainDays?: number;
+    maxCacheBytes?: number;
+    writerGuard?: WriterGuardOptions;
+    now?: () => Date;
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+export interface EventSyncStatus {
+    state: "idle" | "syncing" | "stopped" | "failed";
+    cursor: number | null;
+    head: number | null;
+    lastSyncAt: string | null;
+    error: string | null;
+}
+export interface EventSyncResult {
+    appended: number;
+    cursor: number;
+    head: number;
+}
+export declare class EventHistoryGapError extends Error {
+    readonly head: number;
+    readonly resumeFrom: number;
+    readonly reason: string;
+    constructor(message: string, head: number, resumeFrom: number, reason: string);
+}
+export declare function defaultEventCacheDirectory(tenantId: string): string;
+export declare function eventCachePaths(tenantId: string, directory?: string): EventCachePaths;
+export declare class CatalystEventSync {
+    private readonly options;
+    readonly paths: EventCachePaths;
+    private readonly fetchImpl;
+    private readonly now;
+    private readonly sleeper;
+    private lock;
+    private controller;
+    private running;
+    private recoveredCursor;
+    private floor;
+    private current;
+    constructor(options: EventSyncOptions);
+    status(): EventSyncStatus;
+    syncOnce(signal?: AbortSignal): Promise<EventSyncResult>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private loop;
+    private request;
+    private readCurrentHead;
+    private readPage;
+}
+export interface ReadCachedEventsOptions {
+    tenantId: string;
+    directory?: string;
+    after?: number;
+}
+export declare function readCachedEvents(options: ReadCachedEventsOptions): Promise<CatalystEvent[]>;
+export declare function tailCachedEvents(options: ReadCachedEventsOptions & {
+    signal: AbortSignal;
+}): AsyncGenerator<CatalystEvent>;
+export declare function eventIdentity(event: CatalystEvent): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,492 @@
+import { mkdir, open, readFile, readdir, rename, rm, stat, truncate, watch, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { claimWriterLock, } from "./replica/writer-lock.js";
+const HEAD_HEADER = "x-catalyst-event-backbone-head-seq";
+const MAX_EVENT_LINE_BYTES = 1024 * 1024;
+const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
+const DEFAULT_IDLE_MIN_MS = 1_000;
+const DEFAULT_IDLE_MAX_MS = 30_000;
+const DEFAULT_RETAIN_DAYS = 7;
+const DEFAULT_MAX_CACHE_BYTES = 256 * 1024 * 1024;
+const SEGMENT_PATTERN = /^\d{4}-\d{2}-\d{2}(?:-\d{3})?\.jsonl$/;
+export class EventHistoryGapError extends Error {
+    head;
+    resumeFrom;
+    reason;
+    constructor(message, head, resumeFrom, reason) {
+        super(message);
+        this.head = head;
+        this.resumeFrom = resumeFrom;
+        this.reason = reason;
+        this.name = "EventHistoryGapError";
+    }
+}
+class EventSyncHttpError extends Error {
+    status;
+    constructor(status) {
+        super(`event sync: backbone returned ${status}`);
+        this.status = status;
+        this.name = "EventSyncHttpError";
+    }
+}
+export function defaultEventCacheDirectory(tenantId) {
+    const state = globalThis
+        .process?.env?.XDG_STATE_HOME || join(homedir(), ".local", "state");
+    return join(state, "catalyst", "events", tenantId, "backbone");
+}
+export function eventCachePaths(tenantId, directory) {
+    const root = directory ?? defaultEventCacheDirectory(tenantId);
+    return {
+        directory: root,
+        cursor: join(root, "cursor.json"),
+        lock: join(root, ".sync"),
+    };
+}
+function positiveInteger(value, name) {
+    if ((typeof value !== "string" && typeof value !== "number") ||
+        String(value).trim() === "")
+        throw new Error(`event sync: invalid ${name}`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0)
+        throw new Error(`event sync: invalid ${name}`);
+    return parsed;
+}
+function parseEvent(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("event sync: invalid event");
+    const event = value;
+    if (typeof event.tenantId !== "string" ||
+        !Number.isSafeInteger(event.sequence) ||
+        (event.sequence ?? -1) < 0 ||
+        typeof event.eventId !== "string" ||
+        typeof event.type !== "string" ||
+        !Number.isSafeInteger(event.schemaVersion) ||
+        typeof event.recordedAt !== "string" ||
+        !("payload" in event))
+        throw new Error("event sync: invalid event");
+    return event;
+}
+async function readNdjson(response) {
+    if (!response.body)
+        return [];
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let pending = "";
+    const rows = [];
+    const consume = (line) => {
+        if (!line)
+            return;
+        if (new TextEncoder().encode(line).byteLength > MAX_EVENT_LINE_BYTES)
+            throw new Error("event sync: event line exceeds 1 MiB");
+        rows.push({ event: parseEvent(JSON.parse(line)), line });
+    };
+    for (;;) {
+        const { done, value } = await reader.read();
+        pending += decoder.decode(value, { stream: !done });
+        let newline = pending.indexOf("\n");
+        while (newline >= 0) {
+            consume(pending.slice(0, newline));
+            pending = pending.slice(newline + 1);
+            newline = pending.indexOf("\n");
+        }
+        if (pending.length > MAX_EVENT_LINE_BYTES)
+            throw new Error("event sync: event line exceeds 1 MiB");
+        if (done)
+            break;
+    }
+    if (pending)
+        consume(pending);
+    return rows;
+}
+function segmentName(date, index = 0) {
+    const day = date.toISOString().slice(0, 10);
+    return index === 0
+        ? `${day}.jsonl`
+        : `${day}-${String(index).padStart(3, "0")}.jsonl`;
+}
+async function writeJsonAtomic(path, value) {
+    const pid = globalThis.process?.pid ?? 0;
+    const temporary = `${path}.${pid}.tmp`;
+    await writeFile(temporary, JSON.stringify(value) + "\n", { mode: 0o600 });
+    await rename(temporary, path);
+}
+async function readCursor(path) {
+    try {
+        const value = JSON.parse(await readFile(path, "utf8"));
+        return typeof value.cursor === "number" &&
+            Number.isSafeInteger(value.cursor) &&
+            value.cursor >= 0
+            ? {
+                cursor: value.cursor,
+                floor: typeof value.floor === "number" &&
+                    Number.isSafeInteger(value.floor)
+                    ? value.floor
+                    : -1,
+            }
+            : null;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+async function repairTail(directory) {
+    const segments = (await readdir(directory))
+        .filter((name) => SEGMENT_PATTERN.test(name))
+        .sort();
+    for (const name of segments.reverse()) {
+        const path = join(directory, name);
+        const bytes = await readFile(path);
+        if (bytes.length === 0)
+            continue;
+        const lastNewline = bytes.lastIndexOf(10);
+        if (lastNewline !== bytes.length - 1)
+            await truncate(path, lastNewline < 0 ? 0 : lastNewline + 1);
+        const complete = bytes
+            .subarray(0, lastNewline < 0 ? 0 : lastNewline)
+            .toString("utf8")
+            .trimEnd();
+        const line = complete.slice(complete.lastIndexOf("\n") + 1);
+        if (line)
+            return parseEvent(JSON.parse(line)).sequence;
+    }
+    return null;
+}
+async function retainBoundedSegments(directory, now, retainDays, maxBytes, current, floor) {
+    const segments = (await readdir(directory))
+        .filter((name) => SEGMENT_PATTERN.test(name))
+        .sort();
+    const sizes = new Map();
+    for (const name of segments)
+        sizes.set(name, (await stat(join(directory, name))).size);
+    let total = [...sizes.values()].reduce((sum, size) => sum + size, 0);
+    const cutoff = new Date(now);
+    cutoff.setUTCDate(cutoff.getUTCDate() - retainDays);
+    const remove = [];
+    for (const name of segments) {
+        if (name === current)
+            continue;
+        const expired = name.slice(0, 10) < cutoff.toISOString().slice(0, 10);
+        if (!expired && total <= maxBytes)
+            continue;
+        remove.push(name);
+        total -= sizes.get(name) ?? 0;
+    }
+    for (const name of remove) {
+        const body = await readFile(join(directory, name), "utf8");
+        const lines = body.trimEnd().split("\n");
+        const last = lines.at(-1);
+        if (last)
+            floor = Math.max(floor, parseEvent(JSON.parse(last)).sequence);
+    }
+    await Promise.all(remove.map((name) => rm(join(directory, name), { force: true })));
+    return floor;
+}
+async function appendBoundedRows(directory, date, rows, maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < MAX_EVENT_LINE_BYTES)
+        throw new Error("event sync: maxCacheBytes must be at least 1 MiB");
+    const day = date.toISOString().slice(0, 10);
+    const existing = (await readdir(directory))
+        .filter((name) => name.startsWith(day) && SEGMENT_PATTERN.test(name))
+        .sort();
+    let index = existing.length === 0 ? 0 : existing.length - 1;
+    let name = segmentName(date, index);
+    let size = 0;
+    try {
+        size = (await stat(join(directory, name))).size;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    let handle = await open(join(directory, name), "a", 0o600);
+    try {
+        for (const row of rows) {
+            const line = `${row.line}\n`;
+            const bytes = new TextEncoder().encode(line).byteLength;
+            if (size > 0 && size + bytes > maxBytes) {
+                await handle.sync();
+                await handle.close();
+                name = segmentName(date, ++index);
+                handle = await open(join(directory, name), "a", 0o600);
+                size = 0;
+            }
+            await handle.write(line);
+            size += bytes;
+        }
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    return name;
+}
+function abortableSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const finish = () => {
+            signal.removeEventListener("abort", abort);
+            resolve();
+        };
+        const timer = setTimeout(finish, ms);
+        const abort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", abort);
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", abort, { once: true });
+    });
+}
+export class CatalystEventSync {
+    options;
+    paths;
+    fetchImpl;
+    now;
+    sleeper;
+    lock = null;
+    controller = null;
+    running = null;
+    recoveredCursor = null;
+    floor = -1;
+    current = {
+        state: "stopped",
+        cursor: null,
+        head: null,
+        lastSyncAt: null,
+        error: null,
+    };
+    constructor(options) {
+        this.options = options;
+        this.paths = eventCachePaths(options.tenantId, options.directory);
+        this.fetchImpl = options.fetch ?? fetch;
+        this.now = options.now ?? (() => new Date());
+        this.sleeper = options.sleep ?? abortableSleep;
+    }
+    status() {
+        return { ...this.current };
+    }
+    async syncOnce(signal = new AbortController().signal) {
+        await mkdir(this.paths.directory, { recursive: true, mode: 0o700 });
+        if (!this.lock) {
+            this.lock = claimWriterLock(this.paths.lock, this.options.writerGuard ?? {});
+            this.recoveredCursor = await repairTail(this.paths.directory);
+        }
+        this.current = { ...this.current, state: "syncing", error: null };
+        const checkpoint = await readCursor(this.paths.cursor);
+        this.floor = Math.max(this.floor, checkpoint?.floor ?? -1);
+        let cursor = Math.max(checkpoint?.cursor ?? -1, this.recoveredCursor ?? -1, this.current.cursor ?? -1);
+        if (cursor < 0) {
+            cursor = await this.readCurrentHead(signal);
+            this.floor = cursor;
+        }
+        const result = await this.readPage(cursor, signal);
+        const now = this.now();
+        const maxCacheBytes = this.options.maxCacheBytes ?? DEFAULT_MAX_CACHE_BYTES;
+        let segment = segmentName(now);
+        if (result.rows.length > 0) {
+            segment = await appendBoundedRows(this.paths.directory, now, result.rows, maxCacheBytes);
+            cursor = result.rows[result.rows.length - 1].event.sequence;
+            this.recoveredCursor = cursor;
+        }
+        this.floor = await retainBoundedSegments(this.paths.directory, now, this.options.retainDays ?? DEFAULT_RETAIN_DAYS, maxCacheBytes, segment, this.floor);
+        await writeJsonAtomic(this.paths.cursor, {
+            version: 1,
+            cursor,
+            floor: this.floor,
+        });
+        this.current = {
+            state: "idle",
+            cursor,
+            head: result.head,
+            lastSyncAt: this.now().toISOString(),
+            error: null,
+        };
+        return { appended: result.rows.length, cursor, head: result.head };
+    }
+    start() {
+        if (this.running)
+            return this.running;
+        this.controller = new AbortController();
+        this.running = this.loop(this.controller.signal).finally(() => {
+            if (this.current.state !== "failed")
+                this.current = { ...this.current, state: "stopped" };
+            this.lock?.release();
+            this.lock = null;
+            this.recoveredCursor = null;
+            this.running = null;
+            this.controller = null;
+        });
+        return this.running;
+    }
+    async stop() {
+        const controller = this.controller;
+        if (!this.running) {
+            this.lock?.release();
+            this.lock = null;
+            this.current = { ...this.current, state: "stopped" };
+            return;
+        }
+        controller?.abort(new Error("event sync stopped"));
+        try {
+            await this.running;
+        }
+        catch (error) {
+            if (!controller?.signal.aborted)
+                throw error;
+        }
+    }
+    async loop(signal) {
+        let idle = this.options.idleMinMs ?? DEFAULT_IDLE_MIN_MS;
+        const maxIdle = this.options.idleMaxMs ?? DEFAULT_IDLE_MAX_MS;
+        try {
+            while (!signal.aborted) {
+                try {
+                    const result = await this.syncOnce(signal);
+                    idle =
+                        result.appended > 0
+                            ? (this.options.idleMinMs ?? DEFAULT_IDLE_MIN_MS)
+                            : Math.min(maxIdle, idle * 2);
+                }
+                catch (error) {
+                    if (error instanceof EventHistoryGapError ||
+                        (error instanceof EventSyncHttpError && error.status < 500))
+                        throw error;
+                    this.current = {
+                        ...this.current,
+                        state: "idle",
+                        error: error instanceof Error ? error.message : String(error),
+                    };
+                    idle = Math.min(maxIdle, idle * 2);
+                }
+                await this.sleeper(idle, signal);
+            }
+        }
+        catch (error) {
+            if (signal.aborted)
+                return;
+            this.current = {
+                ...this.current,
+                state: "failed",
+                error: error instanceof Error ? error.message : String(error),
+            };
+            throw error;
+        }
+    }
+    async request(since, signal) {
+        const timeout = AbortSignal.timeout(this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
+        const token = this.options.auth.kind === "token"
+            ? this.options.auth.token
+            : await this.options.auth.getToken();
+        return this.fetchImpl(`${this.options.baseUrl.replace(/\/$/, "")}/api/v1/events/backbone?since=${since}`, {
+            headers: { authorization: `Bearer ${token}` },
+            signal: AbortSignal.any([signal, timeout]),
+        });
+    }
+    async readCurrentHead(signal) {
+        const response = await this.request(Number.MAX_SAFE_INTEGER, signal);
+        if (response.status !== 409)
+            throw new EventSyncHttpError(response.status);
+        const body = (await response.json());
+        if (body.error !== "cursor_ahead_of_head")
+            throw new Error("event sync: head bootstrap contract mismatch");
+        return positiveInteger(body.resumeFrom, "bootstrap cursor");
+    }
+    async readPage(cursor, signal) {
+        const response = await this.request(cursor, signal);
+        if (!response.ok && response.status !== 409)
+            throw new EventSyncHttpError(response.status);
+        const head = positiveInteger(response.headers.get(HEAD_HEADER), "head header");
+        if (response.status === 409) {
+            const body = (await response.json());
+            throw new EventHistoryGapError("event sync: durable history has a gap", head, positiveInteger(body.resumeFrom, "resume cursor"), typeof body.reason === "string"
+                ? body.reason
+                : String(body.error ?? "cursor_refused"));
+        }
+        const rows = await readNdjson(response);
+        let previous = cursor;
+        for (const row of rows) {
+            if (row.event.tenantId !== this.options.tenantId)
+                throw new Error("event sync: tenant mismatch");
+            if (row.event.sequence <= previous)
+                throw new Error("event sync: non-monotonic sequence");
+            previous = row.event.sequence;
+        }
+        return { head, rows };
+    }
+}
+export async function readCachedEvents(options) {
+    const { directory } = eventCachePaths(options.tenantId, options.directory);
+    const checkpoint = await readCursor(eventCachePaths(options.tenantId, options.directory).cursor);
+    if (options.after !== undefined &&
+        checkpoint &&
+        options.after < checkpoint.floor)
+        throw new EventHistoryGapError("event cache: requested sequence precedes retained history", checkpoint.cursor, checkpoint.floor, "local-retention");
+    let names;
+    try {
+        names = (await readdir(directory))
+            .filter((name) => SEGMENT_PATTERN.test(name))
+            .sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const events = [];
+    for (const name of names) {
+        const body = await readFile(join(directory, name), "utf8");
+        const complete = body.endsWith("\n")
+            ? body.slice(0, -1)
+            : body.slice(0, body.lastIndexOf("\n") + 1);
+        for (const line of complete.split("\n")) {
+            if (!line)
+                continue;
+            const event = parseEvent(JSON.parse(line));
+            if (event.sequence > (options.after ?? -1))
+                events.push(event);
+        }
+    }
+    return events;
+}
+export async function* tailCachedEvents(options) {
+    const paths = eventCachePaths(options.tenantId, options.directory);
+    const { directory } = paths;
+    let cursor = options.after ?? (await readCursor(paths.cursor))?.cursor ?? -1;
+    const emit = async () => {
+        const rows = await readCachedEvents({ ...options, after: cursor });
+        if (rows.length > 0)
+            cursor = rows[rows.length - 1].sequence;
+        return rows;
+    };
+    const changes = watch(directory, { signal: options.signal })[Symbol.asyncIterator]();
+    const nextChange = () => changes.next().then((value) => ({ value }), (error) => ({ error }));
+    let pending = nextChange();
+    try {
+        for (const event of await emit())
+            yield event;
+        for (;;) {
+            const outcome = await pending;
+            if ("error" in outcome)
+                throw outcome.error;
+            const change = outcome.value;
+            if (change.done)
+                return;
+            pending = nextChange();
+            for (const event of await emit())
+                yield event;
+        }
+    }
+    finally {
+        await changes.return?.();
+        await pending;
+    }
+}
+export function eventIdentity(event) {
+    return JSON.stringify([event.tenantId, event.sequence, event.eventId]);
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EACL,eAAe,GAGhB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AACzD,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,uBAAuB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAClD,MAAM,eAAe,GAAG,uCAAuC,CAAC;AAsChE,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGlC;IACA;IACA;IAJX,YACE,OAAe,EACN,IAAY,EACZ,UAAkB,EAClB,MAAc;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAQ;QAGvB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,kBAAmB,SAAQ,KAAK;IACf;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;QAD9B,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,MAAM,KAAK,GACR,UAAyE;SACvE,OAAO,EAAE,GAAG,EAAE,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,SAAkB;IAElB,MAAM,IAAI,GAAG,SAAS,IAAI,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC/D,OAAO;QACL,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,IAAY;IACnD,IACE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAE3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,KAA+B,CAAC;IAC9C,IACE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;QACrC,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC;QAC1C,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QAErB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,QAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,IAAI,GAAkD,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,oBAAoB;YAClE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,OAAO,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACnC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACrC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,oBAAoB;YACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,IAAI,IAAI;YAAE,MAAM;IAClB,CAAC;IACD,IAAI,OAAO;QAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAU,EAAE,KAAK,GAAG,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC;QAChB,CAAC,CAAC,GAAG,GAAG,QAAQ;QAChB,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IACzD,MAAM,GAAG,GAAI,UAA6C,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,GAAG,MAAM,CAAC;IACvC,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAOD,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAEpD,CAAC;QACF,OAAO,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YACrC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;YAClC,KAAK,CAAC,MAAM,IAAI,CAAC;YACjB,CAAC,CAAC;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EACH,OAAQ,KAA6B,CAAC,KAAK,KAAK,QAAQ;oBACxD,MAAM,CAAC,aAAa,CAAE,KAA2B,CAAC,KAAK,CAAC;oBACtD,CAAC,CAAE,KAA2B,CAAC,KAAK;oBACpC,CAAC,CAAC,CAAC,CAAC;aACT;YACH,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,SAAiB;IACzC,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC5C,IAAI,EAAE,CAAC;IACV,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,WAAW,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;YAClC,MAAM,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK;aACnB,QAAQ,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;aAC9C,QAAQ,CAAC,MAAM,CAAC;aAChB,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI;YAAE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,SAAiB,EACjB,GAAS,EACT,UAAkB,EAClB,QAAgB,EAChB,OAAe,EACf,KAAa;IAEb,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC5C,IAAI,EAAE,CAAC;IACV,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,QAAQ;QACzB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,OAAO;YAAE,SAAS;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,QAAQ;YAAE,SAAS;QAC5C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI;YAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CACjE,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,SAAiB,EACjB,IAAU,EACV,IAA6B,EAC7B,QAAgB;IAEhB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,oBAAoB;QACpE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACpE,IAAI,EAAE,CAAC;IACV,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;YACxD,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACxC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;gBAClC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBACvD,IAAI,GAAG,CAAC,CAAC;YACX,CAAC;YACD,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC;QACD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,EAAU,EAAE,MAAmB;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,iBAAiB;IAkBC;IAjBpB,KAAK,CAAkB;IACf,SAAS,CAAe;IACxB,GAAG,CAAa;IAChB,OAAO,CAAqD;IACrE,IAAI,GAA4B,IAAI,CAAC;IACrC,UAAU,GAA2B,IAAI,CAAC;IAC1C,OAAO,GAAyB,IAAI,CAAC;IACrC,eAAe,GAAkB,IAAI,CAAC;IACtC,KAAK,GAAG,CAAC,CAAC,CAAC;IACX,OAAO,GAAoB;QACjC,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;KACZ,CAAC;IAEF,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;QACpD,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;IACjD,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,SAAsB,IAAI,eAAe,EAAE,CAAC,MAAM;QAElD,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,eAAe,CACzB,IAAI,CAAC,KAAK,CAAC,IAAI,EACf,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAC/B,CAAC;YACF,IAAI,CAAC,eAAe,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CACnB,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,EACxB,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,EAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAC1B,CAAC;QACF,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACtB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;QAC5E,IAAI,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,GAAG,MAAM,iBAAiB,CAC/B,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,GAAG,EACH,MAAM,CAAC,IAAI,EACX,aAAa,CACd,CAAC;YACF,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7D,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM,qBAAqB,CACtC,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,GAAG,EACH,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,EAC9C,aAAa,EACb,OAAO,EACP,IAAI,CAAC,KAAK,CACX,CAAC;QACF,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YACvC,OAAO,EAAE,CAAC;YACV,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,MAAM;YACb,MAAM;YACN,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YACpC,KAAK,EAAE,IAAI;SACZ,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC5D,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ;gBACjC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACvD,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACrD,OAAO;QACT,CAAC;QACD,UAAU,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAmB;QACpC,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAC;QAC9D,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC3C,IAAI;wBACF,MAAM,CAAC,QAAQ,GAAG,CAAC;4BACjB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAC;4BACjD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IACE,KAAK,YAAY,oBAAoB;wBACrC,CAAC,KAAK,YAAY,kBAAkB,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;wBAE3D,MAAM,KAAK,CAAC;oBACd,IAAI,CAAC,OAAO,GAAG;wBACb,GAAG,IAAI,CAAC,OAAO;wBACf,KAAK,EAAE,MAAM;wBACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC;oBACF,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;gBACrC,CAAC;gBACD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO;YAC3B,IAAI,CAAC,OAAO,GAAG;gBACb,GAAG,IAAI,CAAC,OAAO;gBACf,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,MAAmB;QACtD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CACjC,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAC5D,CAAC;QACF,MAAM,KAAK,GACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;YAChC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK;YACzB,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,KAAK,EAAE,EAClF;YACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;YAC7C,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAC3C,CACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,MAAmB;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK,KAAK,sBAAsB;YACvC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,OAAO,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAC9D,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,MAAc,EACd,MAAmB;QAKnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YACzC,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,eAAe,CAC1B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EACjC,aAAa,CACd,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;YAChE,MAAM,IAAI,oBAAoB,CAC5B,uCAAuC,EACvC,IAAI,EACJ,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EACjD,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAC7B,CAAC,CAAC,IAAI,CAAC,MAAM;gBACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,QAAQ,GAAG,MAAM,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAC9C,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,QAAQ;gBAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAChC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;CACF;AAQD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgC;IAEhC,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,MAAM,UAAU,CACjC,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAC5D,CAAC;IACF,IACE,OAAO,CAAC,KAAK,KAAK,SAAS;QAC3B,UAAU;QACV,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK;QAEhC,MAAM,IAAI,oBAAoB,CAC5B,2DAA2D,EAC3D,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,KAAK,EAChB,iBAAiB,CAClB,CAAC;IACJ,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;aAC/B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC5C,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAC9D,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,gBAAgB,CACrC,OAA0D;IAE1D,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,IAAI,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,QAAQ,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAC1D,MAAM,CAAC,aAAa,CACrB,EAAE,CAAC;IACJ,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CACjB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EACtB,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAChC,CAAC;IACJ,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE;YAAE,MAAM,KAAK,CAAC;QAC9C,SAAS,CAAC;YACR,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;YAC9B,IAAI,OAAO,IAAI,OAAO;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC;YAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI;gBAAE,OAAO;YACxB,OAAO,GAAG,UAAU,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE;gBAAE,MAAM,KAAK,CAAC;QAChD,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACzB,MAAM,OAAO,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catalyst-cloud/sdk",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "Keep a live local copy of your Linear and GitHub project data — pushed in real time, without polling rate limits or webhook tunnels.",
   "license": "MIT",
   "author": "Coalesce Labs",
@@ -39,6 +39,11 @@
       "types": "./dist/node.d.ts",
       "import": "./dist/node.js",
       "default": "./dist/node.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js",
+      "default": "./dist/events.js"
     }
   },
   "files": [