@drej/postgres 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# @drej/postgres
+
+## 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
+
+- 82e77fd: Introduce pluggable storage adapter system.
+
+  - `ILedger` renamed to `IStorageAdapter` with optional `connect()` and `close()` lifecycle methods
+  - `DrejClientOptions.adapter` accepts any `IStorageAdapter` implementation; `DrejClient` exposes matching `connect()` and `close()` methods
+  - New `@drej/postgres` package: `PostgresAdapter` backed by a user-supplied Postgres connection string; owns its schema and runs migrations on `connect()`
+
+### Patch Changes
+
+- Updated dependencies [82e77fd]
+- Updated dependencies [5d77498]
+  - @drej/core@0.1.0

package/package.json

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

package/src/adapter.ts

@@ -0,0 +1,87 @@
+import postgres from "postgres";
+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: unknown;
+  error: string | null;
+  ts: string;
+};
+
+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 ?? undefined,
+    error: row.error ?? undefined,
+    ts: Number(row.ts),
+  };
+}
+
+export class PostgresAdapter implements IStorageAdapter {
+  private readonly sql: ReturnType<typeof postgres>;
+
+  constructor(connectionString: string) {
+    this.sql = postgres(connectionString);
+  }
+
+  async connect(): Promise<void> {
+    await this.sql.unsafe(MIGRATION_SQL);
+  }
+
+  async close(): Promise<void> {
+    await this.sql.end();
+  }
+
+  async append(entry: LedgerEntry): Promise<void> {
+    await this.sql`
+      INSERT INTO drej_events (run_id, wf_name, step_idx, branch, event, payload, error, ts)
+      VALUES (
+        ${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 = await this.sql<Row[]>`
+      SELECT run_id, wf_name, step_idx, branch, event, payload, error, ts
+      FROM drej_events
+      WHERE wf_name = ${workflowName} AND run_id = ${runId}
+      ORDER BY ts ASC
+    `;
+    return rows.map(rowToEntry);
+  }
+
+  async lastCheckpoint(workflowName: string, runId: string): Promise<LedgerEntry | null> {
+    const rows = await this.sql<Row[]>`
+      SELECT run_id, wf_name, step_idx, branch, event, payload, error, ts
+      FROM drej_events
+      WHERE wf_name = ${workflowName} AND run_id = ${runId} AND event = 'checkpoint'
+      ORDER BY ts DESC
+      LIMIT 1
+    `;
+    return rows.length ? rowToEntry(rows[0]) : null;
+  }
+
+  async listRuns(workflowName: string): Promise<string[]> {
+    const rows = await this.sql<{ run_id: string }[]>`
+      SELECT DISTINCT run_id FROM drej_events WHERE wf_name = ${workflowName}
+    `;
+    return rows.map((r) => r.run_id);
+  }
+}

package/src/index.ts

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

package/src/migrations.ts

@@ -0,0 +1,16 @@
+export const MIGRATION_SQL = `
+CREATE TABLE IF NOT EXISTS drej_events (
+  id        BIGSERIAL   PRIMARY KEY,
+  run_id    TEXT        NOT NULL,
+  wf_name   TEXT        NOT NULL,
+  step_idx  INTEGER     NOT NULL,
+  branch    INTEGER,
+  event     TEXT        NOT NULL,
+  payload   JSONB,
+  error     TEXT,
+  ts        BIGINT      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"]
+}