@drej/sqlite 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# @drej/sqlite
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [4c0ad93]
+- Updated dependencies [b04f8eb]
+- Updated dependencies [a971b7b]
+- Updated dependencies [ce173be]
+- Updated dependencies [86c2dde]
+- Updated dependencies [82094ae]
+  - @drej/core@0.2.0
+
+## 0.1.1
+
+### Patch Changes
+
+- 0ea4c33: Rename npm scope from `@drej/*` to `@drej/*` and add TSDoc to all public API surfaces.
+
+  - All workspace packages now published under `@drej/*` (e.g. `@drej/sqlite`, `@drej/postgres`)
+  - `DrejClient`, `WorkflowBuilder`, `SandboxStepBuilder`, `IStorageAdapter`, `LedgerEvent`, `SandboxOpts` and all their members now have hover documentation visible in VS Code
+
+- Updated dependencies [0ea4c33]
+  - @drej/core@0.1.1
+
+## 0.1.0
+
+### Minor Changes
+
+- 5d77498: Introduce `@drej/sqlite` storage adapter.
+
+  `SQLiteAdapter` implements `IStorageAdapter` via Bun's built-in `bun:sqlite` — zero extra dependencies and no infrastructure required. Data persists across restarts, making it suitable for local development and single-process production workloads.
+
+  ```ts
+  import { DrejClient } from "drej";
+  import { SQLiteAdapter } from "@drej/sqlite";
+
+  const client = new DrejClient({
+    baseUrl: "http://localhost:8080",
+    adapter: new SQLiteAdapter("./drej.db"),
+  });
+  await client.connect();
+  ```
+
+  WAL mode is enabled on `connect()` for safe concurrent reads alongside ongoing writes.
+
+### Patch Changes
+
+- Updated dependencies [82e77fd]
+- Updated dependencies [5d77498]
+  - @drej/core@0.1.0

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@drej/sqlite",
+  "version": "0.1.2",
+  "publishConfig": { "access": "public" },
+  "main": "./src/index.ts",
+  "dependencies": {
+    "@drej/core": "workspace:*"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "typescript": "latest"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,97 @@
+import { Database } from "bun:sqlite";
+import type { IStorageAdapter, LedgerEntry, LedgerEvent } from "@drej/core";
+import { MIGRATION_SQL } from "./migrations";
+
+type Row = {
+  run_id: string;
+  wf_name: string;
+  step_idx: number;
+  branch: number | null;
+  event: string;
+  payload: string | null;
+  error: string | null;
+  ts: number;
+};
+
+function rowToEntry(row: Row): LedgerEntry {
+  return {
+    runId: row.run_id,
+    workflowName: row.wf_name,
+    stepIndex: row.step_idx,
+    branch: row.branch ?? undefined,
+    event: row.event as LedgerEvent,
+    payload: row.payload !== null ? (JSON.parse(row.payload) as unknown) : undefined,
+    error: row.error ?? undefined,
+    ts: row.ts,
+  };
+}
+
+export class SQLiteAdapter implements IStorageAdapter {
+  private readonly db: Database;
+
+  constructor(path: string) {
+    this.db = new Database(path, { create: true });
+  }
+
+  async connect(): Promise<void> {
+    this.db.exec(MIGRATION_SQL);
+    // WAL mode prevents writer from blocking readers on concurrent access
+    this.db.exec("PRAGMA journal_mode = WAL;");
+  }
+
+  async close(): Promise<void> {
+    this.db.close();
+  }
+
+  async append(entry: LedgerEntry): Promise<void> {
+    this.db
+      .prepare(
+        `INSERT INTO drej_events (run_id, wf_name, step_idx, branch, event, payload, error, ts)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(
+        entry.runId,
+        entry.workflowName,
+        entry.stepIndex,
+        entry.branch ?? null,
+        entry.event,
+        entry.payload !== undefined ? JSON.stringify(entry.payload) : null,
+        entry.error ?? null,
+        entry.ts,
+      );
+  }
+
+  async readAll(workflowName: string, runId: string): Promise<LedgerEntry[]> {
+    const rows = this.db
+      .prepare<Row, [string, string]>(
+        `SELECT run_id, wf_name, step_idx, branch, event, payload, error, ts
+         FROM drej_events
+         WHERE wf_name = ? AND run_id = ?
+         ORDER BY ts ASC`,
+      )
+      .all(workflowName, runId);
+    return rows.map(rowToEntry);
+  }
+
+  async lastCheckpoint(workflowName: string, runId: string): Promise<LedgerEntry | null> {
+    const row = this.db
+      .prepare<Row, [string, string]>(
+        `SELECT run_id, wf_name, step_idx, branch, event, payload, error, ts
+         FROM drej_events
+         WHERE wf_name = ? AND run_id = ? AND event = 'checkpoint'
+         ORDER BY ts DESC
+         LIMIT 1`,
+      )
+      .get(workflowName, runId);
+    return row ? rowToEntry(row) : null;
+  }
+
+  async listRuns(workflowName: string): Promise<string[]> {
+    const rows = this.db
+      .prepare<{ run_id: string }, [string]>(
+        `SELECT DISTINCT run_id FROM drej_events WHERE wf_name = ?`,
+      )
+      .all(workflowName);
+    return rows.map((r) => r.run_id);
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { SQLiteAdapter } from "./adapter";

package/src/migrations.ts

@@ -0,0 +1,16 @@
+export const MIGRATION_SQL = `
+CREATE TABLE IF NOT EXISTS drej_events (
+  id       INTEGER  PRIMARY KEY AUTOINCREMENT,
+  run_id   TEXT     NOT NULL,
+  wf_name  TEXT     NOT NULL,
+  step_idx INTEGER  NOT NULL,
+  branch   INTEGER,
+  event    TEXT     NOT NULL,
+  payload  TEXT,
+  error    TEXT,
+  ts       INTEGER  NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS drej_events_run_id ON drej_events(run_id);
+CREATE INDEX IF NOT EXISTS drej_events_wf_name ON drej_events(wf_name);
+`;

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true,
+    "types": ["bun-types"]
+  },
+  "include": ["src"]
+}