@streamotter/gateway 0.1.0-rc.1

package/dist/runtime/traces.js

@@ -0,0 +1,98 @@
+import { randomBytes } from "node:crypto";
+import { StreamOtterError, utf8ByteLength } from "@streamotter/contracts";
+import { nowIso } from "./util.js";
+/**
+ * Bounded in-memory trace metadata. Never stores payloads or credentials. Cursors
+ * are ephemeral positions scoped to this gateway run, not data-recovery cursors.
+ */
+export class TraceBuffer {
+    #maxEntries;
+    #maxBytes;
+    #runId = randomBytes(6).toString("base64url");
+    #entries = [];
+    #head = 0;
+    #bytes = 0;
+    #nextSeq = 1;
+    constructor(maxEntries, maxBytes) {
+        this.#maxEntries = maxEntries;
+        this.#maxBytes = maxBytes;
+    }
+    record(input) {
+        const seq = this.#nextSeq++;
+        const trace = { id: `${this.#runId}-${seq}`, at: nowIso(), ...input };
+        const bytes = utf8ByteLength(JSON.stringify(trace));
+        this.#entries.push({ seq, trace, bytes });
+        this.#bytes += bytes;
+        while (this.size > this.#maxEntries || (this.#bytes > this.#maxBytes && this.size > 0)) {
+            const dropped = this.#entries[this.#head];
+            if (dropped === undefined)
+                break;
+            this.#bytes -= dropped.bytes;
+            this.#head++;
+        }
+        if (this.#head > 1024 && this.#head * 2 > this.#entries.length) {
+            this.#entries = this.#entries.slice(this.#head);
+            this.#head = 0;
+        }
+    }
+    get size() {
+        return this.#entries.length - this.#head;
+    }
+    #cursorFor(seq) {
+        return Buffer.from(`${this.#runId}:${seq}`).toString("base64url");
+    }
+    #parseCursor(cursor) {
+        let decoded;
+        try {
+            decoded = Buffer.from(cursor, "base64url").toString("utf8");
+        }
+        catch {
+            throw new StreamOtterError("INVALID_REQUEST", { message: "The trace cursor is malformed." });
+        }
+        const match = /^([A-Za-z0-9_-]+):(\d{1,15})$/.exec(decoded);
+        if (match === null)
+            throw new StreamOtterError("INVALID_REQUEST", { message: "The trace cursor is malformed." });
+        if (match[1] !== this.#runId)
+            throw new StreamOtterError("TRACE_CURSOR_EXPIRED");
+        return Number(match[2]);
+    }
+    /**
+     * Without a cursor, returns the newest `limit` matching traces (oldest first).
+     * With a cursor, returns up to `limit` matching traces recorded after it.
+     * nextCursor continues after the last examined trace, so callers can poll.
+     */
+    page(query) {
+        const matches = (entry) => (query.sourceId === undefined || entry.trace.sourceId === query.sourceId)
+            && (query.channel === undefined || entry.trace.channel === query.channel)
+            && (query.outcome === undefined || entry.trace.outcome === query.outcome);
+        const oldestSeq = this.#entries[this.#head]?.seq ?? this.#nextSeq;
+        if (query.cursor === undefined) {
+            const items = [];
+            for (let i = this.#entries.length - 1; i >= this.#head && items.length < query.limit; i--) {
+                const entry = this.#entries[i];
+                if (entry !== undefined && matches(entry))
+                    items.push(entry.trace);
+            }
+            items.reverse();
+            return { items, nextCursor: this.#cursorFor(this.#nextSeq - 1) };
+        }
+        const after = this.#parseCursor(query.cursor);
+        if (after + 1 < oldestSeq)
+            throw new StreamOtterError("TRACE_CURSOR_EXPIRED");
+        const items = [];
+        let last = after;
+        for (let i = this.#head + Math.max(0, after + 1 - oldestSeq); i < this.#entries.length; i++) {
+            const entry = this.#entries[i];
+            if (entry === undefined)
+                break;
+            last = entry.seq;
+            if (matches(entry)) {
+                items.push(entry.trace);
+                if (items.length >= query.limit)
+                    break;
+            }
+        }
+        return { items, nextCursor: this.#cursorFor(last) };
+    }
+}
+//# sourceMappingURL=traces.js.map

package/dist/runtime/traces.js.map

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

package/dist/runtime/util.d.ts

@@ -0,0 +1,50 @@
+import { type Awaitable, type GatewayLogger, type Json } from "@streamotter/contracts";
+export type HandlerOutcome<T> = {
+    kind: "ok";
+    value: T;
+} | {
+    kind: "timeout";
+} | {
+    kind: "aborted";
+} | {
+    kind: "error";
+    error: unknown;
+};
+/**
+ * Invokes an application handler with a deadline and an AbortSignal linked to
+ * `parent`. Late results after timeout or abort are ignored.
+ */
+export declare function invokeHandler<T>(handler: (context: {
+    signal: AbortSignal;
+    requestId: string;
+}) => Awaitable<T>, options: {
+    timeoutMs: number;
+    requestId: string;
+    parent?: AbortSignal | undefined;
+}): Promise<HandlerOutcome<T>>;
+export declare function sha256Hex(value: unknown): string;
+export declare function newId(): string;
+export declare function nowIso(): string;
+/** Describes an application error for operator logs without its stack. */
+export declare function describeError(error: unknown): Json;
+/** Structured console logger; the default operator diagnostics sink. */
+export declare function consoleLogger(minimum?: "info" | "warn" | "error"): GatewayLogger;
+export declare const silentLogger: GatewayLogger;
+/** setTimeout that tolerates delays beyond the 32-bit timer limit. */
+export declare function setLongTimeout(callback: () => void, delayMs: number): {
+    clear(): void;
+};
+/** Counting semaphore whose waits honor a deadline and an abort signal. */
+export declare class Semaphore {
+    #private;
+    constructor(permits: number);
+    acquire(signal: AbortSignal, deadline: number): Promise<boolean>;
+    release(): void;
+}
+/** Token bucket used for per-connection control-request rate limits. */
+export declare class TokenBucket {
+    #private;
+    constructor(ratePerSecond: number, capacity: number);
+    take(): boolean;
+}
+//# sourceMappingURL=util.d.ts.map

package/dist/runtime/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/runtime/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAmC,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAExH,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtC;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAC9E,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GAClF,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAyB5B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAGlD;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,OAAgB,GAAG,aAAa,CAYxF;AAED,eAAO,MAAM,YAAY,EAAE,aAAoD,CAAC;AAEhF,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAYvF;AAED,2EAA2E;AAC3E,qBAAa,SAAS;;gBAIR,OAAO,EAAE,MAAM;IAI3B,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BhE,OAAO,IAAI,IAAI;CAKhB;AAED,wEAAwE;AACxE,qBAAa,WAAW;;gBAMV,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMnD,IAAI,IAAI,OAAO;CAQhB"}

package/dist/runtime/util.js

@@ -0,0 +1,148 @@
+import { createHash, randomUUID } from "node:crypto";
+import { canonicalJson, StreamOtterError } from "@streamotter/contracts";
+/**
+ * Invokes an application handler with a deadline and an AbortSignal linked to
+ * `parent`. Late results after timeout or abort are ignored.
+ */
+export async function invokeHandler(handler, options) {
+    const controller = new AbortController();
+    const { parent } = options;
+    if (parent?.aborted)
+        return { kind: "aborted" };
+    let settle;
+    const race = new Promise(resolve => { settle = resolve; });
+    const timer = setTimeout(() => {
+        controller.abort(new StreamOtterError("TIMEOUT", { requestId: options.requestId }));
+        settle?.({ kind: "timeout" });
+    }, options.timeoutMs);
+    const onParentAbort = () => {
+        controller.abort(new StreamOtterError("CANCELLED", { requestId: options.requestId }));
+        settle?.({ kind: "aborted" });
+    };
+    parent?.addEventListener("abort", onParentAbort, { once: true });
+    try {
+        Promise.resolve()
+            .then(() => handler({ signal: controller.signal, requestId: options.requestId }))
+            .then(value => settle?.({ kind: "ok", value }), (error) => settle?.({ kind: "error", error }));
+        return await race;
+    }
+    finally {
+        clearTimeout(timer);
+        parent?.removeEventListener("abort", onParentAbort);
+        settle = undefined;
+    }
+}
+export function sha256Hex(value) {
+    return createHash("sha256").update(canonicalJson(value)).digest("hex");
+}
+export function newId() {
+    return randomUUID();
+}
+export function nowIso() {
+    return new Date().toISOString();
+}
+/** Describes an application error for operator logs without its stack. */
+export function describeError(error) {
+    if (error instanceof Error)
+        return { name: error.name, message: error.message.slice(0, 200) };
+    return { name: typeof error };
+}
+/** Structured console logger; the default operator diagnostics sink. */
+export function consoleLogger(minimum = "info") {
+    const order = { info: 0, warn: 1, error: 2 };
+    const write = (level, message, fields) => {
+        if (order[level] < order[minimum])
+            return;
+        const line = JSON.stringify({ at: nowIso(), level, message, ...(fields ?? {}) });
+        if (level === "info")
+            console.log(line);
+        else
+            console.error(line);
+    };
+    return {
+        info: (message, fields) => write("info", message, fields),
+        warn: (message, fields) => write("warn", message, fields),
+        error: (message, fields) => write("error", message, fields)
+    };
+}
+export const silentLogger = { info() { }, warn() { }, error() { } };
+/** setTimeout that tolerates delays beyond the 32-bit timer limit. */
+export function setLongTimeout(callback, delayMs) {
+    const MAX = 2_147_000_000;
+    let handle;
+    const schedule = (remaining) => {
+        handle = setTimeout(() => {
+            if (remaining > MAX)
+                schedule(remaining - MAX);
+            else
+                callback();
+        }, Math.max(0, Math.min(remaining, MAX)));
+        handle.unref?.();
+    };
+    schedule(delayMs);
+    return { clear: () => clearTimeout(handle) };
+}
+/** Counting semaphore whose waits honor a deadline and an abort signal. */
+export class Semaphore {
+    #available;
+    #waiters = [];
+    constructor(permits) {
+        this.#available = permits;
+    }
+    acquire(signal, deadline) {
+        if (signal.aborted || Date.now() >= deadline)
+            return Promise.resolve(false);
+        if (this.#available > 0) {
+            this.#available--;
+            return Promise.resolve(true);
+        }
+        return new Promise(resolve => {
+            const waiter = {
+                resolve: (acquired) => {
+                    clearTimeout(timer);
+                    signal.removeEventListener("abort", onAbort);
+                    resolve(acquired);
+                }
+            };
+            const drop = () => {
+                const index = this.#waiters.indexOf(waiter);
+                if (index >= 0)
+                    this.#waiters.splice(index, 1);
+                waiter.resolve(false);
+            };
+            const onAbort = () => drop();
+            const timer = setTimeout(drop, Math.max(0, deadline - Date.now()));
+            signal.addEventListener("abort", onAbort, { once: true });
+            this.#waiters.push(waiter);
+        });
+    }
+    release() {
+        const next = this.#waiters.shift();
+        if (next !== undefined)
+            next.resolve(true);
+        else
+            this.#available++;
+    }
+}
+/** Token bucket used for per-connection control-request rate limits. */
+export class TokenBucket {
+    #ratePerSecond;
+    #capacity;
+    #tokens;
+    #updated = Date.now();
+    constructor(ratePerSecond, capacity) {
+        this.#ratePerSecond = ratePerSecond;
+        this.#capacity = capacity;
+        this.#tokens = capacity;
+    }
+    take() {
+        const now = Date.now();
+        this.#tokens = Math.min(this.#capacity, this.#tokens + ((now - this.#updated) / 1000) * this.#ratePerSecond);
+        this.#updated = now;
+        if (this.#tokens < 1)
+            return false;
+        this.#tokens -= 1;
+        return true;
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/runtime/util.js.map

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

package/dist/sources/fixture.d.ts

@@ -0,0 +1,27 @@
+import { type DiagnosticStep, type Json } from "@streamotter/contracts";
+import type { SourceAdapter, SourceSink } from "./types.ts";
+export interface FixtureRecord {
+    key: string | null;
+    value: Json;
+}
+/**
+ * Deterministic development source. Records advance in array order only when
+ * requested. A paused fixture keeps its position; resume retries that record.
+ */
+export declare class FixtureSourceAdapter implements SourceAdapter {
+    #private;
+    readonly kind: "fixture";
+    constructor(records: readonly FixtureRecord[], sink: SourceSink, onCommit: () => void);
+    get position(): {
+        index: number;
+        total: number;
+        paused: boolean;
+    };
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Processes up to `count` records in order; resolves with the number committed. */
+    advance(count: number): Promise<number>;
+    resume(): Promise<void>;
+    check(): Promise<DiagnosticStep[]>;
+}
+//# sourceMappingURL=fixture.d.ts.map

package/dist/sources/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/sources/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,aAAa;IAAG,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE;AAElE;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,aAAa;;IACxD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;gBASvB,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI;IAMrF,IAAI,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAEhE;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,oFAAoF;IACpF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBjC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAWvB,KAAK,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CA2BzC"}

package/dist/sources/fixture.js

@@ -0,0 +1,89 @@
+import { StreamOtterError } from "@streamotter/contracts";
+/**
+ * Deterministic development source. Records advance in array order only when
+ * requested. A paused fixture keeps its position; resume retries that record.
+ */
+export class FixtureSourceAdapter {
+    kind = "fixture";
+    #records;
+    #sink;
+    #onCommit;
+    #index = 0;
+    #paused = false;
+    #stopped = false;
+    #chain = Promise.resolve();
+    constructor(records, sink, onCommit) {
+        this.#records = records;
+        this.#sink = sink;
+        this.#onCommit = onCommit;
+    }
+    get position() {
+        return { index: this.#index, total: this.#records.length, paused: this.#paused };
+    }
+    async start() {
+        this.#sink.setStatus("healthy");
+    }
+    async stop() {
+        this.#stopped = true;
+        await this.#chain.catch(() => undefined);
+    }
+    /** Processes up to `count` records in order; resolves with the number committed. */
+    advance(count) {
+        const run = this.#chain.then(async () => {
+            if (this.#stopped)
+                throw new StreamOtterError("SOURCE_UNAVAILABLE", { message: "The gateway is stopping." });
+            if (this.#paused) {
+                throw new StreamOtterError("SOURCE_UNAVAILABLE", { message: "The fixture source is paused; resume it after correcting the cause." });
+            }
+            let advanced = 0;
+            while (advanced < count && this.#index < this.#records.length && !this.#stopped) {
+                if (!(await this.#step()))
+                    break;
+                advanced++;
+            }
+            return advanced;
+        });
+        this.#chain = run.catch(() => undefined);
+        return run;
+    }
+    async resume() {
+        const run = this.#chain.then(async () => {
+            if (!this.#paused || this.#stopped)
+                return;
+            this.#paused = false;
+            this.#sink.setStatus("healthy");
+            await this.#step();
+        });
+        this.#chain = run.catch(() => undefined);
+        await run;
+    }
+    async check() {
+        return [
+            { stage: "resolve", outcome: "ok", message: `Fixture with ${this.#records.length} records is registered.` },
+            { stage: "connect", outcome: "skipped", message: "Fixture sources have no network connection." },
+            { stage: "tls", outcome: "skipped", message: "Fixture sources have no network connection." },
+            { stage: "authenticate", outcome: "skipped", message: "Fixture sources have no credentials." },
+            { stage: "metadata", outcome: "ok", message: `Position ${this.#index} of ${this.#records.length}${this.#paused ? " (paused)" : ""}.` }
+        ];
+    }
+    /** Processes the record at the current index. Returns false when it paused or was abandoned. */
+    async #step() {
+        const record = this.#records[this.#index];
+        if (record === undefined)
+            return false;
+        const outcome = await this.#sink.process({
+            key: record.key,
+            value: record.value,
+            position: { kind: "fixture", index: String(this.#index) }
+        });
+        if (outcome.kind === "commit") {
+            this.#index++;
+            this.#onCommit();
+            return true;
+        }
+        if (outcome.kind === "pause")
+            this.#paused = true;
+        return false;
+    }
+}
+//# sourceMappingURL=fixture.js.map

package/dist/sources/fixture.js.map

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

package/dist/sources/kafka.d.ts

@@ -0,0 +1,63 @@
+import { type ISocketFactory } from "kafkajs";
+import { type DiagnosticStep, type KafkaConnection, type Source, type SourceRecord } from "@streamotter/contracts";
+import type { SourceAdapter, SourceSink } from "./types.ts";
+export interface ResolvedKafkaConnection {
+    readonly brokers: readonly string[];
+    readonly tls: boolean;
+    readonly ca: string | null;
+    readonly sasl: {
+        mechanism: "plain" | "scram-sha-256" | "scram-sha-512";
+        username: string;
+        password: string;
+    } | null;
+}
+/** Resolves environment secret references and CA files. Never logs resolved values. */
+export declare function resolveKafkaConnection(profile: KafkaConnection, configDir: string): Promise<ResolvedKafkaConnection>;
+/**
+ * Socket factory equivalent to KafkaJS's default, but tracking every socket so
+ * stop() can guarantee release. KafkaJS can leave a broker connection open after
+ * reconnecting through a broker restart.
+ */
+export declare class TrackedSockets {
+    #private;
+    readonly factory: ISocketFactory;
+    get size(): number;
+    /**
+     * Destroys remaining sockets with an error so KafkaJS runs its own error path:
+     * it rejects queued requests, disconnects, and stops the connection's timers.
+     */
+    destroyAll(): void;
+}
+/**
+ * KafkaJS adapter with explicit progress management: auto-commit and automatic
+ * batch resolution are disabled, records are processed in partition order with
+ * heartbeats, and the next offset is committed only after the gateway finishes
+ * processing a record. A poison record pauses the whole source and seeks back so
+ * resume retries the same record; nothing after it is committed.
+ */
+export declare class KafkaSourceAdapter implements SourceAdapter {
+    #private;
+    readonly kind: "kafka";
+    constructor(options: {
+        projectId: string;
+        sourceId: string;
+        source: Extract<Source, {
+            kind: "kafka";
+        }>;
+        connection: ResolvedKafkaConnection;
+        sink: SourceSink;
+        onCommit: () => void;
+        beforeCommit?: (sourceId: string, position: SourceRecord["position"]) => Promise<void>;
+    });
+    start(): Promise<void>;
+    stop(deadline: number): Promise<void>;
+    resume(): Promise<void>;
+    check(deadline: number): Promise<DiagnosticStep[]>;
+}
+export declare function createKafkaSourceAdapter(options: ConstructorParameters<typeof KafkaSourceAdapter>[0]): KafkaSourceAdapter;
+/**
+ * Staged diagnostics for an existing profile: resolve → connect → tls →
+ * authenticate → metadata. Messages name brokers and stages, never credentials.
+ */
+export declare function runKafkaDiagnostics(connection: ResolvedKafkaConnection, topics: readonly string[], deadline: number): Promise<DiagnosticStep[]>;
+//# sourceMappingURL=kafka.d.ts.map

package/dist/sources/kafka.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.d.ts","sourceRoot":"","sources":["../../src/sources/kafka.ts"],"names":[],"mappings":"AAKA,OAAgB,EAAiB,KAAK,cAAc,EAAsC,MAAM,SAAS,CAAC;AAC1G,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAErI,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,GAAG,eAAe,GAAG,eAAe,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtH;AAED,uFAAuF;AACvF,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4B1H;AAED;;;;GAIG;AACH,qBAAa,cAAc;;IAGzB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAQ9B;IAEF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,UAAU,IAAI,IAAI;CAInB;AAsCD;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,aAAa;;IACtD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;gBAkBrB,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC3C,UAAU,EAAE,uBAAuB,CAAC;QACpC,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACxF;IAUK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDtB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAiEzD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAEzH;AAkBD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,uBAAuB,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAsGrJ"}