station-adapter-sqlite 1.0.0

package/dist/index.js

@@ -0,0 +1,303 @@
+import { randomUUID } from "node:crypto";
+import Database from "better-sqlite3";
+import { registerAdapter } from "station-signal";
+const MODULE_URL = import.meta.url;
+import { validateTableName, dateToStr, createColumnMapper, rowToObject } from "./shared.js";
+const { toColumn, toField } = createColumnMapper({
+    signalName: "signal_name",
+    maxAttempts: "max_attempts",
+    nextRunAt: "next_run_at",
+    lastRunAt: "last_run_at",
+    startedAt: "started_at",
+    completedAt: "completed_at",
+    createdAt: "created_at",
+});
+const DATE_FIELDS = new Set(["nextRunAt", "lastRunAt", "startedAt", "completedAt", "createdAt"]);
+const { toColumn: toStepColumn, toField: toStepField } = createColumnMapper({
+    runId: "run_id",
+    startedAt: "started_at",
+    completedAt: "completed_at",
+});
+const STEP_DATE_FIELDS = new Set(["startedAt", "completedAt"]);
+function rowToRun(row) {
+    return rowToObject(row, toField, DATE_FIELDS);
+}
+function rowToStep(row) {
+    return rowToObject(row, toStepField, STEP_DATE_FIELDS);
+}
+export class SqliteAdapter {
+    db;
+    tableName;
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        const dbPath = options.dbPath ?? "station.db";
+        this.tableName = validateTableName(options.tableName ?? "runs");
+        this.db = new Database(dbPath);
+        // Enable WAL mode and foreign keys
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("foreign_keys = ON");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        id            TEXT PRIMARY KEY,
+        signal_name   TEXT NOT NULL,
+        kind          TEXT NOT NULL,
+        input         TEXT NOT NULL,
+        status        TEXT NOT NULL DEFAULT 'pending',
+        attempts      INTEGER NOT NULL DEFAULT 0,
+        max_attempts  INTEGER NOT NULL DEFAULT 1,
+        timeout       INTEGER NOT NULL,
+        interval      TEXT,
+        next_run_at   TEXT,
+        last_run_at   TEXT,
+        started_at    TEXT,
+        completed_at  TEXT,
+        created_at    TEXT NOT NULL,
+        output        TEXT,
+        error         TEXT
+      )
+    `);
+        // Migrate existing databases: add columns if missing
+        try {
+            this.db.exec(`ALTER TABLE ${this.tableName} ADD COLUMN output TEXT`);
+        }
+        catch { /* already exists */ }
+        try {
+            this.db.exec(`ALTER TABLE ${this.tableName} ADD COLUMN error TEXT`);
+        }
+        catch { /* already exists */ }
+        // Indexes for the two hot queries (getRunsDue / getRunsRunning)
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status_next
+        ON ${this.tableName} (status, next_run_at)
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status_running
+        ON ${this.tableName} (status) WHERE status = 'running'
+    `);
+        // M3: Index on signal_name for listRuns queries
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_signal_name
+        ON ${this.tableName} (signal_name)
+    `);
+        // Steps table with foreign key
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName}_steps (
+        id            TEXT PRIMARY KEY,
+        run_id        TEXT NOT NULL REFERENCES ${this.tableName}(id) ON DELETE CASCADE,
+        name          TEXT NOT NULL,
+        status        TEXT NOT NULL DEFAULT 'pending',
+        input         TEXT,
+        output        TEXT,
+        error         TEXT,
+        started_at    TEXT,
+        completed_at  TEXT
+      )
+    `);
+        // Migrate existing step tables: add error column if missing
+        try {
+            this.db.exec(`ALTER TABLE ${this.tableName}_steps ADD COLUMN error TEXT`);
+        }
+        catch { /* already exists */ }
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_steps_run_id
+        ON ${this.tableName}_steps (run_id)
+    `);
+    }
+    toManifest() {
+        return {
+            name: "sqlite",
+            options: this.options,
+            moduleUrl: MODULE_URL,
+        };
+    }
+    async addRun(run) {
+        this.db
+            .prepare(`INSERT INTO ${this.tableName}
+          (id, signal_name, kind, input, status, attempts, max_attempts,
+           timeout, interval, next_run_at, last_run_at, started_at,
+           completed_at, created_at, output, error)
+         VALUES
+          (@id, @signal_name, @kind, @input, @status, @attempts, @max_attempts,
+           @timeout, @interval, @next_run_at, @last_run_at, @started_at,
+           @completed_at, @created_at, @output, @error)`)
+            .run({
+            id: run.id,
+            signal_name: run.signalName,
+            kind: run.kind,
+            input: run.input,
+            status: run.status,
+            attempts: run.attempts,
+            max_attempts: run.maxAttempts,
+            timeout: run.timeout,
+            interval: run.interval ?? null,
+            next_run_at: dateToStr(run.nextRunAt),
+            last_run_at: dateToStr(run.lastRunAt),
+            started_at: dateToStr(run.startedAt),
+            completed_at: dateToStr(run.completedAt),
+            created_at: dateToStr(run.createdAt),
+            output: run.output ?? null,
+            error: run.error ?? null,
+        });
+    }
+    async removeRun(id) {
+        // Steps cascade via FOREIGN KEY ON DELETE CASCADE
+        this.db
+            .prepare(`DELETE FROM ${this.tableName} WHERE id = ?`)
+            .run(id);
+    }
+    async getRunsDue() {
+        const now = new Date().toISOString();
+        const rows = this.db
+            .prepare(`SELECT * FROM ${this.tableName}
+         WHERE status = 'pending'
+           AND (next_run_at IS NULL OR next_run_at <= ?)
+         ORDER BY created_at ASC`)
+            .all(now);
+        return rows.map(rowToRun);
+    }
+    async getRunsRunning() {
+        const rows = this.db
+            .prepare(`SELECT * FROM ${this.tableName} WHERE status = 'running'`)
+            .all();
+        return rows.map(rowToRun);
+    }
+    async getRun(id) {
+        const row = this.db
+            .prepare(`SELECT * FROM ${this.tableName} WHERE id = ?`)
+            .get(id);
+        return row ? rowToRun(row) : null;
+    }
+    /** Allowed RunPatch keys (L13: whitelist to prevent injection via unexpected keys). */
+    static RUN_PATCH_KEYS = new Set([
+        "input", "output", "error", "status", "attempts", "maxAttempts",
+        "timeout", "interval", "nextRunAt", "lastRunAt", "startedAt", "completedAt",
+    ]);
+    async updateRun(id, patch) {
+        const setClauses = [];
+        const values = { id };
+        for (const [key, value] of Object.entries(patch)) {
+            if (!SqliteAdapter.RUN_PATCH_KEYS.has(key))
+                continue;
+            if (value === undefined) {
+                const col = toColumn(key);
+                const param = `p_${col}`;
+                setClauses.push(`${col} = @${param}`);
+                values[param] = null;
+            }
+            else {
+                const col = toColumn(key);
+                const param = `p_${col}`;
+                setClauses.push(`${col} = @${param}`);
+                values[param] = DATE_FIELDS.has(key) ? dateToStr(value) : value;
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        this.db
+            .prepare(`UPDATE ${this.tableName} SET ${setClauses.join(", ")} WHERE id = @id`)
+            .run(values);
+    }
+    async listRuns(signalName) {
+        const rows = this.db
+            .prepare(`SELECT * FROM ${this.tableName} WHERE signal_name = ? ORDER BY created_at DESC`)
+            .all(signalName);
+        return rows.map(rowToRun);
+    }
+    async hasRunWithStatus(signalName, statuses) {
+        if (statuses.length === 0)
+            return false;
+        const placeholders = statuses.map(() => "?").join(", ");
+        const row = this.db
+            .prepare(`SELECT 1 FROM ${this.tableName} WHERE signal_name = ? AND status IN (${placeholders}) LIMIT 1`)
+            .get(signalName, ...statuses);
+        return row !== undefined;
+    }
+    async purgeRuns(olderThan, statuses) {
+        if (statuses.length === 0)
+            return 0;
+        const placeholders = statuses.map(() => "?").join(", ");
+        const cutoff = olderThan.toISOString();
+        // Steps cascade via FOREIGN KEY ON DELETE CASCADE
+        const result = this.db
+            .prepare(`DELETE FROM ${this.tableName} WHERE status IN (${placeholders}) AND completed_at IS NOT NULL AND completed_at < ?`)
+            .run(...statuses, cutoff);
+        return result.changes;
+    }
+    async addStep(step) {
+        this.db
+            .prepare(`INSERT INTO ${this.tableName}_steps
+          (id, run_id, name, status, input, output, error, started_at, completed_at)
+         VALUES
+          (@id, @run_id, @name, @status, @input, @output, @error, @started_at, @completed_at)`)
+            .run({
+            id: step.id,
+            run_id: step.runId,
+            name: step.name,
+            status: step.status,
+            input: step.input ?? null,
+            output: step.output ?? null,
+            error: step.error ?? null,
+            started_at: dateToStr(step.startedAt),
+            completed_at: dateToStr(step.completedAt),
+        });
+    }
+    /** Allowed StepPatch keys. */
+    static STEP_PATCH_KEYS = new Set([
+        "status", "input", "output", "error", "startedAt", "completedAt",
+    ]);
+    async updateStep(id, patch) {
+        const setClauses = [];
+        const values = { id };
+        for (const [key, value] of Object.entries(patch)) {
+            if (!SqliteAdapter.STEP_PATCH_KEYS.has(key))
+                continue;
+            if (value === undefined) {
+                const col = toStepColumn(key);
+                const param = `p_${col}`;
+                setClauses.push(`${col} = @${param}`);
+                values[param] = null;
+            }
+            else {
+                const col = toStepColumn(key);
+                const param = `p_${col}`;
+                setClauses.push(`${col} = @${param}`);
+                values[param] = STEP_DATE_FIELDS.has(key) ? dateToStr(value) : value;
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        this.db
+            .prepare(`UPDATE ${this.tableName}_steps SET ${setClauses.join(", ")} WHERE id = @id`)
+            .run(values);
+    }
+    async getSteps(runId) {
+        const rows = this.db
+            .prepare(`SELECT * FROM ${this.tableName}_steps WHERE run_id = ?`)
+            .all(runId);
+        return rows.map(rowToStep);
+    }
+    async removeSteps(runId) {
+        this.db
+            .prepare(`DELETE FROM ${this.tableName}_steps WHERE run_id = ?`)
+            .run(runId);
+    }
+    async ping() {
+        try {
+            this.db.prepare("SELECT 1").get();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    generateId() {
+        return randomUUID();
+    }
+    async close() {
+        this.db.close();
+    }
+}
+// Register in the adapter factory for cross-process reconstruction
+registerAdapter("sqlite", (options) => new SqliteAdapter(options));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/shared.d.ts

@@ -0,0 +1,14 @@
+/** Validate table name to prevent SQL injection (alphanumeric + underscores only). */
+export declare function validateTableName(name: string): string;
+/** Serialise a Date to ISO string, or pass through null/undefined. */
+export declare function dateToStr(value: unknown): string | null;
+/** Deserialise an ISO string back to Date, or return undefined. */
+export declare function strToDate(value: unknown): Date | undefined;
+/** Create forward and reverse column mappers from a camelCase→snake_case mapping. */
+export declare function createColumnMapper(mappings: Record<string, string>): {
+    toColumn: (key: string) => string;
+    toField: (col: string) => string;
+};
+/** Map a raw SQLite row to a typed object, converting date fields. */
+export declare function rowToObject<T>(row: Record<string, unknown>, toField: (col: string) => string, dateFields: Set<string>): T;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAG1D;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;oBAK/C,MAAM,KAAG,MAAM;mBAChB,MAAM,KAAG,MAAM;EAEjC;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAChC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,CAAC,CAWH"}

package/dist/shared.js

@@ -0,0 +1,44 @@
+/** Validate table name to prevent SQL injection (alphanumeric + underscores only). */
+export function validateTableName(name) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+        throw new Error(`Invalid table name "${name}". Only alphanumeric characters and underscores are allowed.`);
+    }
+    return name;
+}
+/** Serialise a Date to ISO string, or pass through null/undefined. */
+export function dateToStr(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value === undefined || value === null)
+        return null;
+    return String(value);
+}
+/** Deserialise an ISO string back to Date, or return undefined. */
+export function strToDate(value) {
+    if (typeof value === "string")
+        return new Date(value);
+    return undefined;
+}
+/** Create forward and reverse column mappers from a camelCase→snake_case mapping. */
+export function createColumnMapper(mappings) {
+    const reverse = Object.fromEntries(Object.entries(mappings).map(([k, v]) => [v, k]));
+    return {
+        toColumn: (key) => mappings[key] ?? key,
+        toField: (col) => reverse[col] ?? col,
+    };
+}
+/** Map a raw SQLite row to a typed object, converting date fields. */
+export function rowToObject(row, toField, dateFields) {
+    const obj = {};
+    for (const [col, value] of Object.entries(row)) {
+        const field = toField(col);
+        if (dateFields.has(field)) {
+            obj[field] = value != null ? strToDate(value) : undefined;
+        }
+        else {
+            obj[field] = value;
+        }
+    }
+    return obj;
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,8DAA8D,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,QAAgC;IACjE,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACjD,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG;QACvD,OAAO,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG;KACtD,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,OAAgC,EAChC,UAAuB;IAEvB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,GAAmB,CAAC;AAC7B,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "station-adapter-sqlite",
+  "version": "1.0.0",
+  "description": "SQLite adapter for station-signal using better-sqlite3",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./broadcast": {
+      "types": "./dist/broadcast.d.ts",
+      "import": "./dist/broadcast.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.9.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13"
+  },
+  "peerDependencies": {
+    "station-signal": "1.0.0",
+    "station-broadcast": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}