station-adapter-sqlite 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 porkytheblack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# station-adapter-sqlite
+
+SQLite storage adapter for station-signal using better-sqlite3.
+
+## Install
+
+```bash
+pnpm add station-adapter-sqlite
+```
+
+Requires `station-signal` as a peer dependency.
+
+## Usage
+
+Configure globally:
+
+```ts
+import { configure } from "station-signal";
+import { SqliteAdapter } from "station-adapter-sqlite";
+
+configure({ adapter: new SqliteAdapter() });
+```
+
+## Options
+
+```ts
+interface SqliteAdapterOptions {
+  /** Path to the SQLite database file. Defaults to "station-signal.db". */
+  dbPath?: string;
+  /** Table name. Defaults to "entries". */
+  tableName?: string;
+}
+```
+
+Example with options:
+
+```ts
+const adapter = new SqliteAdapter({
+  dbPath: "./data/jobs.db",
+  tableName: "signal_entries",
+});
+```
+
+## With SignalRunner
+
+The `configModule` pattern lets you share a single adapter instance across the runner and all spawned child processes.
+
+1. Create a config module (e.g. `src/adapter.config.ts`):
+
+```ts
+import { configure } from "station-signal";
+import { SqliteAdapter } from "station-adapter-sqlite";
+
+configure({ adapter: new SqliteAdapter({ dbPath: "./jobs.db" }) });
+```
+
+2. Pass it to the runner:
+
+```ts
+import { SignalRunner } from "station-signal";
+import { fileURLToPath } from "node:url";
+
+const runner = new SignalRunner({
+  signalsDir: "./src/signals",
+  configModule: fileURLToPath(new URL("./adapter.config.ts", import.meta.url)),
+});
+
+await runner.start();
+```
+
+The runner imports the config module on startup and passes its path to every spawned child process via an environment variable, so they all connect to the same SQLite database.
+
+## Graceful shutdown
+
+```ts
+const adapter = new SqliteAdapter();
+// ... use adapter ...
+adapter.close();
+```
+
+## Details
+
+- WAL mode is enabled by default for better concurrent read/write performance.
+- Table and indexes are created automatically on first use (`CREATE TABLE IF NOT EXISTS`).
+- Date fields are stored as ISO-8601 text strings.
+- All methods are async (to satisfy the `SignalQueueAdapter` interface) but use synchronous better-sqlite3 under the hood.

package/dist/broadcast.d.ts

@@ -0,0 +1,29 @@
+import type { BroadcastQueueAdapter, BroadcastRun, BroadcastRunPatch, BroadcastRunStatus, BroadcastNodeRun, BroadcastNodeRunPatch } from "station-broadcast";
+export interface BroadcastSqliteAdapterOptions {
+    dbPath?: string;
+    tableName?: string;
+}
+export declare class BroadcastSqliteAdapter implements BroadcastQueueAdapter {
+    private db;
+    private runsTable;
+    private nodesTable;
+    constructor(options?: BroadcastSqliteAdapterOptions);
+    addBroadcastRun(run: BroadcastRun): Promise<void>;
+    getBroadcastRun(id: string): Promise<BroadcastRun | null>;
+    private static readonly BROADCAST_RUN_PATCH_KEYS;
+    updateBroadcastRun(id: string, patch: BroadcastRunPatch): Promise<void>;
+    getBroadcastRunsDue(): Promise<BroadcastRun[]>;
+    getBroadcastRunsRunning(): Promise<BroadcastRun[]>;
+    listBroadcastRuns(broadcastName: string): Promise<BroadcastRun[]>;
+    hasBroadcastRunWithStatus(broadcastName: string, statuses: BroadcastRunStatus[]): Promise<boolean>;
+    purgeBroadcastRuns(olderThan: Date, statuses: BroadcastRunStatus[]): Promise<number>;
+    addNodeRun(nodeRun: BroadcastNodeRun): Promise<void>;
+    getNodeRun(id: string): Promise<BroadcastNodeRun | null>;
+    private static readonly NODE_RUN_PATCH_KEYS;
+    updateNodeRun(id: string, patch: BroadcastNodeRunPatch): Promise<void>;
+    getNodeRuns(broadcastRunId: string): Promise<BroadcastNodeRun[]>;
+    generateId(): string;
+    ping(): Promise<boolean>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAgC3B,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,sBAAuB,YAAW,qBAAqB;IAClE,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,6BAAkC;IA2DjD,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK/D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAG7C;IAEG,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvE,mBAAmB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAW9C,uBAAuB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKlD,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKjE,yBAAyB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IASlG,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpF,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAK9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAExC;IAEG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKtE,UAAU,IAAI,MAAM;IAId,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IASxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/broadcast.js

@@ -0,0 +1,239 @@
+import { randomUUID } from "node:crypto";
+import Database from "better-sqlite3";
+import { validateTableName, dateToStr, createColumnMapper, rowToObject } from "./shared.js";
+const { toColumn: toBroadcastRunCol, toField: toBroadcastRunField } = createColumnMapper({
+    broadcastName: "broadcast_name",
+    failurePolicy: "failure_policy",
+    nextRunAt: "next_run_at",
+    startedAt: "started_at",
+    completedAt: "completed_at",
+    createdAt: "created_at",
+});
+const BROADCAST_RUN_DATE_FIELDS = new Set(["nextRunAt", "startedAt", "completedAt", "createdAt"]);
+const { toColumn: toNodeRunCol, toField: toNodeRunField } = createColumnMapper({
+    broadcastRunId: "broadcast_run_id",
+    nodeName: "node_name",
+    signalName: "signal_name",
+    signalRunId: "signal_run_id",
+    skipReason: "skip_reason",
+    startedAt: "started_at",
+    completedAt: "completed_at",
+});
+const NODE_RUN_DATE_FIELDS = new Set(["startedAt", "completedAt"]);
+function rowToBroadcastRun(row) {
+    return rowToObject(row, toBroadcastRunField, BROADCAST_RUN_DATE_FIELDS);
+}
+function rowToNodeRun(row) {
+    return rowToObject(row, toNodeRunField, NODE_RUN_DATE_FIELDS);
+}
+export class BroadcastSqliteAdapter {
+    db;
+    runsTable;
+    nodesTable;
+    constructor(options = {}) {
+        const dbPath = options.dbPath ?? "station.db";
+        this.runsTable = validateTableName(options.tableName ?? "broadcast_runs");
+        this.nodesTable = validateTableName(`${this.runsTable}_nodes`);
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("foreign_keys = ON");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.runsTable} (
+        id              TEXT PRIMARY KEY,
+        broadcast_name  TEXT NOT NULL,
+        input           TEXT NOT NULL,
+        status          TEXT NOT NULL DEFAULT 'pending',
+        failure_policy  TEXT NOT NULL DEFAULT 'fail-fast',
+        timeout         INTEGER,
+        interval        TEXT,
+        next_run_at     TEXT,
+        started_at      TEXT,
+        completed_at    TEXT,
+        created_at      TEXT NOT NULL,
+        error           TEXT
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.runsTable}_status
+        ON ${this.runsTable} (status, next_run_at)
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.runsTable}_name
+        ON ${this.runsTable} (broadcast_name)
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.nodesTable} (
+        id                TEXT PRIMARY KEY,
+        broadcast_run_id  TEXT NOT NULL REFERENCES ${this.runsTable}(id) ON DELETE CASCADE,
+        node_name         TEXT NOT NULL,
+        signal_name       TEXT NOT NULL,
+        signal_run_id     TEXT,
+        status            TEXT NOT NULL DEFAULT 'pending',
+        skip_reason       TEXT,
+        input             TEXT,
+        output            TEXT,
+        error             TEXT,
+        started_at        TEXT,
+        completed_at      TEXT
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.nodesTable}_run_id
+        ON ${this.nodesTable} (broadcast_run_id)
+    `);
+    }
+    async addBroadcastRun(run) {
+        this.db.prepare(`
+      INSERT INTO ${this.runsTable}
+        (id, broadcast_name, input, status, failure_policy, timeout, interval,
+         next_run_at, started_at, completed_at, created_at, error)
+      VALUES
+        (@id, @broadcast_name, @input, @status, @failure_policy, @timeout, @interval,
+         @next_run_at, @started_at, @completed_at, @created_at, @error)
+    `).run({
+            id: run.id,
+            broadcast_name: run.broadcastName,
+            input: run.input,
+            status: run.status,
+            failure_policy: run.failurePolicy,
+            timeout: run.timeout ?? null,
+            interval: run.interval ?? null,
+            next_run_at: dateToStr(run.nextRunAt),
+            started_at: dateToStr(run.startedAt),
+            completed_at: dateToStr(run.completedAt),
+            created_at: dateToStr(run.createdAt),
+            error: run.error ?? null,
+        });
+    }
+    async getBroadcastRun(id) {
+        const row = this.db.prepare(`SELECT * FROM ${this.runsTable} WHERE id = ?`).get(id);
+        return row ? rowToBroadcastRun(row) : null;
+    }
+    static BROADCAST_RUN_PATCH_KEYS = new Set([
+        "input", "status", "failurePolicy", "timeout", "interval", "nextRunAt",
+        "startedAt", "completedAt", "error",
+    ]);
+    async updateBroadcastRun(id, patch) {
+        const setClauses = [];
+        const values = { id };
+        for (const [key, value] of Object.entries(patch)) {
+            if (!BroadcastSqliteAdapter.BROADCAST_RUN_PATCH_KEYS.has(key))
+                continue;
+            const col = toBroadcastRunCol(key);
+            const param = `p_${col}`;
+            setClauses.push(`${col} = @${param}`);
+            if (value === undefined) {
+                values[param] = null;
+            }
+            else {
+                values[param] = BROADCAST_RUN_DATE_FIELDS.has(key) ? dateToStr(value) : value;
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        this.db.prepare(`UPDATE ${this.runsTable} SET ${setClauses.join(", ")} WHERE id = @id`).run(values);
+    }
+    async getBroadcastRunsDue() {
+        const now = new Date().toISOString();
+        const rows = this.db.prepare(`
+      SELECT * FROM ${this.runsTable}
+      WHERE status = 'pending'
+        AND (next_run_at IS NULL OR next_run_at <= ?)
+      ORDER BY created_at ASC
+    `).all(now);
+        return rows.map(rowToBroadcastRun);
+    }
+    async getBroadcastRunsRunning() {
+        const rows = this.db.prepare(`SELECT * FROM ${this.runsTable} WHERE status = 'running'`).all();
+        return rows.map(rowToBroadcastRun);
+    }
+    async listBroadcastRuns(broadcastName) {
+        const rows = this.db.prepare(`SELECT * FROM ${this.runsTable} WHERE broadcast_name = ? ORDER BY created_at DESC`).all(broadcastName);
+        return rows.map(rowToBroadcastRun);
+    }
+    async hasBroadcastRunWithStatus(broadcastName, statuses) {
+        if (statuses.length === 0)
+            return false;
+        const placeholders = statuses.map(() => "?").join(", ");
+        const row = this.db.prepare(`SELECT 1 FROM ${this.runsTable} WHERE broadcast_name = ? AND status IN (${placeholders}) LIMIT 1`).get(broadcastName, ...statuses);
+        return row !== undefined;
+    }
+    async purgeBroadcastRuns(olderThan, statuses) {
+        if (statuses.length === 0)
+            return 0;
+        const placeholders = statuses.map(() => "?").join(", ");
+        const cutoff = olderThan.toISOString();
+        const result = this.db.prepare(`DELETE FROM ${this.runsTable} WHERE status IN (${placeholders}) AND completed_at IS NOT NULL AND completed_at < ?`).run(...statuses, cutoff);
+        return result.changes;
+    }
+    async addNodeRun(nodeRun) {
+        this.db.prepare(`
+      INSERT INTO ${this.nodesTable}
+        (id, broadcast_run_id, node_name, signal_name, signal_run_id,
+         status, skip_reason, input, output, error, started_at, completed_at)
+      VALUES
+        (@id, @broadcast_run_id, @node_name, @signal_name, @signal_run_id,
+         @status, @skip_reason, @input, @output, @error, @started_at, @completed_at)
+    `).run({
+            id: nodeRun.id,
+            broadcast_run_id: nodeRun.broadcastRunId,
+            node_name: nodeRun.nodeName,
+            signal_name: nodeRun.signalName,
+            signal_run_id: nodeRun.signalRunId ?? null,
+            status: nodeRun.status,
+            skip_reason: nodeRun.skipReason ?? null,
+            input: nodeRun.input ?? null,
+            output: nodeRun.output ?? null,
+            error: nodeRun.error ?? null,
+            started_at: dateToStr(nodeRun.startedAt),
+            completed_at: dateToStr(nodeRun.completedAt),
+        });
+    }
+    async getNodeRun(id) {
+        const row = this.db.prepare(`SELECT * FROM ${this.nodesTable} WHERE id = ?`).get(id);
+        return row ? rowToNodeRun(row) : null;
+    }
+    static NODE_RUN_PATCH_KEYS = new Set([
+        "signalRunId", "status", "skipReason", "input", "output", "error", "startedAt", "completedAt",
+    ]);
+    async updateNodeRun(id, patch) {
+        const setClauses = [];
+        const values = { id };
+        for (const [key, value] of Object.entries(patch)) {
+            if (!BroadcastSqliteAdapter.NODE_RUN_PATCH_KEYS.has(key))
+                continue;
+            const col = toNodeRunCol(key);
+            const param = `p_${col}`;
+            setClauses.push(`${col} = @${param}`);
+            if (value === undefined) {
+                values[param] = null;
+            }
+            else {
+                values[param] = NODE_RUN_DATE_FIELDS.has(key) ? dateToStr(value) : value;
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        this.db.prepare(`UPDATE ${this.nodesTable} SET ${setClauses.join(", ")} WHERE id = @id`).run(values);
+    }
+    async getNodeRuns(broadcastRunId) {
+        const rows = this.db.prepare(`SELECT * FROM ${this.nodesTable} WHERE broadcast_run_id = ?`).all(broadcastRunId);
+        return rows.map(rowToNodeRun);
+    }
+    generateId() {
+        return randomUUID();
+    }
+    async ping() {
+        try {
+            this.db.prepare("SELECT 1").get();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/dist/broadcast.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import type { SerializableAdapter, AdapterManifest, Run, RunPatch, RunStatus, Step, StepPatch } from "station-signal";
+export interface SqliteAdapterOptions {
+    /** Path to the SQLite database file. Defaults to `"station.db"`. */
+    dbPath?: string;
+    /** Table name (alphanumeric and underscores only). Defaults to `"runs"`. */
+    tableName?: string;
+}
+export declare class SqliteAdapter implements SerializableAdapter {
+    private db;
+    private tableName;
+    private options;
+    constructor(options?: SqliteAdapterOptions);
+    toManifest(): AdapterManifest;
+    addRun(run: Run): Promise<void>;
+    removeRun(id: string): Promise<void>;
+    getRunsDue(): Promise<Run[]>;
+    getRunsRunning(): Promise<Run[]>;
+    getRun(id: string): Promise<Run | null>;
+    /** Allowed RunPatch keys (L13: whitelist to prevent injection via unexpected keys). */
+    private static readonly RUN_PATCH_KEYS;
+    updateRun(id: string, patch: RunPatch): Promise<void>;
+    listRuns(signalName: string): Promise<Run[]>;
+    hasRunWithStatus(signalName: string, statuses: RunStatus[]): Promise<boolean>;
+    purgeRuns(olderThan: Date, statuses: RunStatus[]): Promise<number>;
+    addStep(step: Step): Promise<void>;
+    /** Allowed StepPatch keys. */
+    private static readonly STEP_PATCH_KEYS;
+    updateStep(id: string, patch: StepPatch): Promise<void>;
+    getSteps(runId: string): Promise<Step[]>;
+    removeSteps(runId: string): Promise<void>;
+    ping(): Promise<boolean>;
+    generateId(): string;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAgCtH,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,mBAAmB;IACvD,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,GAAE,oBAAyB;IA2E9C,UAAU,IAAI,eAAe;IAQvB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAc5B,cAAc,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAQhC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAQ7C,uFAAuF;IACvF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAGnC;IAEG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAU5C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAW7E,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAalE,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxC,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAEpC;IAEG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BvD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAQxC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAS9B,UAAU,IAAI,MAAM;IAId,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}