hazo_connect 2.4.7 → 2.7.0

package/README.md

@@ -465,12 +465,176 @@ const hazo = createHazoConnect({
 })
 ```
 
+### pg Configuration
+
+Use the `pg` adapter when you need SQL features that PostgREST does not expose, such as `SELECT … FOR UPDATE SKIP LOCKED` for job-queue locking or advisory locks. It connects directly to Postgres via the `postgres` driver (postgres.js).
+
+```typescript
+const hazo = createHazoConnect({
+  type: 'pg',
+  pg: {
+    connection_string: process.env.DATABASE_URL  // e.g. postgres://user:pass@host:5432/db
+  }
+})
+```
+
+**Adapters at a glance:**
+
+| Adapter | When to use |
+|---------|-------------|
+| `postgrest` | Default REST-over-Postgres. Covers most CRUD needs. |
+| `supabase` | Hosted PostgREST with Supabase auth and realtime. |
+| `sqlite` | Embedded SQLite for local dev, tests, or edge deployments. |
+| `pg` | Raw Postgres via `postgres` driver. Use when you need `SELECT … FOR UPDATE SKIP LOCKED` or other SQL features PostgREST doesn't expose. Requires a direct Postgres connection string. |
+
+---
+
+## Using SQLite with Next.js App Router
+
+This walkthrough covers the bootstrap shape an embedded-SQLite app (single-operator, local-file) typically wants: `DATABASE_URL`-driven config, migrations applied at boot, Server Components reading directly, route handlers writing inside an atomic transaction with idempotent UPSERT.
+
+### 1. Configure via `DATABASE_URL`
+
+```bash
+# .env.local
+DATABASE_URL=sqlite:./data/site-ops.db
+HAZO_CONNECT_ENABLE_ADMIN_UI=true   # optional, for the built-in admin UI
+```
+
+Supported URI forms: `sqlite:./relative`, `sqlite:/absolute`, `sqlite:///absolute`, `sqlite::memory:`. `HAZO_CONNECT_SQLITE_PATH` (if set) wins over `DATABASE_URL`.
+
+### 2. Singleton accessor
+
+```ts
+// lib/db.ts
+import 'server-only'
+import { getHazoConnectSingleton } from 'hazo_connect/nextjs/setup'
+
+export const db = getHazoConnectSingleton()
+```
+
+### 3. Apply migrations at boot
+
+Place migration files as `migrations/0001_*.sql`, `0002_*.sql`, … in your project root.
+
+```ts
+// lib/migrate.ts
+import 'server-only'
+import path from 'path'
+import { runMigrations } from 'hazo_connect/server'
+import { db } from './db'
+
+let applied: Promise<void> | null = null
+export function ensureMigrationsApplied() {
+  if (!applied) {
+    applied = runMigrations(db, {
+      directory: path.join(process.cwd(), 'migrations')
+    }).then(() => undefined)
+  }
+  return applied
+}
+```
+
+`runMigrations` is idempotent — pending files are detected via a `_migrations` tracking table, applied inside an `adapter.transaction()`, and recorded with a SHA-256 checksum.
+
+### 4. Read inside Server Components
+
+```tsx
+// app/(dashboard)/runs/page.tsx
+import { QueryBuilder } from 'hazo_connect/server'
+import { db } from '@/lib/db'
+import { ensureMigrationsApplied } from '@/lib/migrate'
+
+export default async function RunsPage() {
+  await ensureMigrationsApplied()
+  const runs = await db.query(
+    new QueryBuilder().from('daily_runs').order('run_date', 'desc').limit(20)
+  )
+  return <RunsTable runs={runs} />
+}
+```
+
+All adapter methods return `Promise`s — Server Components `await` them directly.
+
+### 5. Write inside route handlers (idempotent UPSERT + transactions)
+
+```ts
+// app/api/v1/runs/route.ts
+import { NextResponse } from 'next/server'
+import { QueryBuilder, type SqliteTransactionContext } from 'hazo_connect/server'
+import { SqliteAdapter } from 'hazo_connect/server'
+import { db } from '@/lib/db'
+
+export async function POST(req: Request) {
+  const payload = await req.json()
+  const adapter = db as SqliteAdapter
+
+  const runId = await adapter.transaction(async (tx: SqliteTransactionContext) => {
+    // Idempotent on (site_id, run_date). Re-running the same routine on the
+    // same day updates the existing row.
+    const [run] = await tx.query(
+      new QueryBuilder()
+        .from('daily_runs')
+        .onConflict(['site_id', 'run_date'])
+        .doUpdate(),
+      'POST',
+      {
+        site_id: payload.site_id,
+        run_date: payload.run_date,
+        status: payload.status,
+        steps_completed: payload.steps_completed
+      }
+    )
+
+    for (const article of payload.articles ?? []) {
+      await tx.query(
+        new QueryBuilder().from('articles_published'),
+        'POST',
+        { ...article, run_id: run.run_id }
+      )
+    }
+
+    for (const check of payload.health_checks ?? []) {
+      await tx.query(
+        new QueryBuilder()
+          .from('health_checks')
+          .onConflict(['site_id', 'check_date', 'check_key'])
+          .doUpdate(),
+        'POST',
+        { ...check, run_id: run.run_id, site_id: payload.site_id }
+      )
+    }
+
+    return run.run_id
+  })
+
+  return NextResponse.json({ ok: true, data: { run_id: runId } }, { status: 201 })
+}
+```
+
+Key points:
+
+- `adapter.transaction(fn)` wraps the callback in `BEGIN`/`COMMIT`. If `fn` throws, `ROLLBACK` runs and no rows reach disk.
+- The SQLite adapter persists the in-memory DB image to disk **exactly once** per transaction (not once per statement) — large multi-write payloads are reasonably fast.
+- `QueryBuilder.onConflict(cols).doUpdate()` defaults to `SET col = excluded.col` for every inserted column except the conflict target. Pass an object — `doUpdate({ status: 'done' })` — to update only specific columns. Pass `doNothing()` to keep the existing row.
+
+### 6. Backups
+
+`sql.js` works on an in-memory image, so a "hot backup" while a transaction is mid-flight isn't meaningful. The simplest backup pattern is a cron job:
+
+```bash
+cp data/site-ops.db data/backups/$(date +%F).db
+```
+
+Run it outside an in-flight transaction window. (A typed `store.backup()` helper is on the roadmap once we move to `better-sqlite3`.)
+
 ### Environment Variables
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `HAZO_CONNECT_TYPE` | Database type (`sqlite`, `postgrest`, `supabase`) | `sqlite` |
-| `HAZO_CONNECT_SQLITE_PATH` | Path to SQLite database file. Ignored when the config object supplies `sqlite.initial_sql` (so test seeds aren't overridden by ambient env). | `./database.sqlite` |
+| `HAZO_CONNECT_TYPE` | Database type (`sqlite`, `postgrest`, `supabase`, `pg`) | `sqlite` |
+| `DATABASE_URL` | SQLite-only URI form, e.g. `sqlite:./data/site-ops.db`, `sqlite:/var/lib/x.db`, `sqlite:///var/lib/x.db`, `sqlite::memory:`. Read by `createHazoConnectFromEnv` when `HAZO_CONNECT_SQLITE_PATH` is not set. | - |
+| `HAZO_CONNECT_SQLITE_PATH` | Path to SQLite database file. Ignored when the config object supplies `sqlite.initial_sql` (so test seeds aren't overridden by ambient env). Takes precedence over `DATABASE_URL` when both are set. | `./database.sqlite` |
 | `HAZO_CONNECT_SQLITE_READONLY` | Enable read-only mode | `false` |
 | `HAZO_CONNECT_SQLITE_WASM_DIR` | Path to sql-wasm.wasm directory | Auto-detected |
 | `HAZO_CONNECT_ENABLE_ADMIN_UI` | Enable SQLite admin UI | `false` |
@@ -575,7 +739,7 @@ Main configuration interface:
 
 ```typescript
 interface HazoConnectConfig {
-  type: 'postgrest' | 'supabase' | 'sqlite' | 'file'
+  type: 'postgrest' | 'supabase' | 'sqlite' | 'file' | 'pg'
   logger?: Logger
   log_level?: 'debug' | 'info' | 'warn' | 'error' | 'none'
   enable_admin_ui?: boolean  // SQLite only

package/dist/adapters/clause-builder.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared serialization helpers for the claimRows primitive.
+ * Pure functions; no I/O. Used by Pg, Postgrest, and Sqlite adapters.
+ */
+export type Dialect = "pg" | "postgrest" | "sqlite";
+export type NowSentinel = {
+    $now: true;
+};
+export declare function isNowSentinel(v: unknown): v is NowSentinel;
+export declare function validateColumnName(name: string): void;
+export declare function validateOperator(op: string): void;
+export type ResolvedNow = {
+    kind: "sql";
+    value: string;
+} | {
+    kind: "literal";
+    value: unknown;
+};
+export declare function resolveNowSentinel(v: unknown, dialect: Dialect): ResolvedNow;
+export declare function serializeWhereToPostgrest(where: Record<string, unknown>): Record<string, string>;
+export interface PgSqlFragment {
+    fragment: string;
+    params: unknown[];
+    nextParamIndex: number;
+}
+export declare function serializeWhereToPgSql(where: Record<string, unknown>, startIndex: number): PgSqlFragment;
+type SetValue = unknown | NowSentinel | {
+    increment: number;
+};
+export declare function serializeSetToPgSql(set: Record<string, SetValue>, startIndex: number): PgSqlFragment;
+export declare function serializeSetToPostgrestBody(set: Record<string, SetValue>, observed: Record<string, unknown>): Record<string, unknown>;
+/** Columns the caller incremented — needed for CAS witnesses on PostgrestAdapter. */
+export declare function incrementedColumns(set: Record<string, SetValue>): string[];
+/**
+ * Reject empty where/set/returning at the API boundary so adapters
+ * don't generate malformed SQL or — on PostgrestAdapter — accidentally
+ * match every row.
+ *
+ * Caller is expected to pass the full ClaimRowsOptions; types kept loose
+ * here because the helper lives in clause-builder which doesn't import
+ * from types.ts (avoids circular import risk).
+ */
+export declare function validateClaimRowsOptions(opts: {
+    where: Record<string, unknown>;
+    set: Record<string, unknown>;
+    returning?: string[];
+}): void;
+export {};
+//# sourceMappingURL=clause-builder.d.ts.map

package/dist/adapters/clause-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clause-builder.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/clause-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEpD,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AACzC,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAC/F,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAK5E;AAgBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBhG;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAiCvG;AAID,KAAK,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAqBpG;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBrI;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,EAAE,CAI1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,IAAI,CAUP"}

package/dist/adapters/clause-builder.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Shared serialization helpers for the claimRows primitive.
+ * Pure functions; no I/O. Used by Pg, Postgrest, and Sqlite adapters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNowSentinel = isNowSentinel;
+exports.validateColumnName = validateColumnName;
+exports.validateOperator = validateOperator;
+exports.resolveNowSentinel = resolveNowSentinel;
+exports.serializeWhereToPostgrest = serializeWhereToPostgrest;
+exports.serializeWhereToPgSql = serializeWhereToPgSql;
+exports.serializeSetToPgSql = serializeSetToPgSql;
+exports.serializeSetToPostgrestBody = serializeSetToPostgrestBody;
+exports.incrementedColumns = incrementedColumns;
+exports.validateClaimRowsOptions = validateClaimRowsOptions;
+const COLUMN_NAME_RE = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const ALLOWED_OPS = new Set(["eq", "lte", "gte", "lt", "gt", "in", "increment", "$now"]);
+function isNowSentinel(v) {
+    return typeof v === "object" && v !== null && "$now" in v && v.$now === true;
+}
+function validateColumnName(name) {
+    if (!COLUMN_NAME_RE.test(name)) {
+        throw new Error(`invalid column name: ${JSON.stringify(name)}`);
+    }
+}
+function validateOperator(op) {
+    if (!ALLOWED_OPS.has(op)) {
+        throw new Error(`unknown operator: ${JSON.stringify(op)}`);
+    }
+}
+function resolveNowSentinel(v, dialect) {
+    if (!isNowSentinel(v))
+        return { kind: "literal", value: v };
+    if (dialect === "pg")
+        return { kind: "sql", value: "now()" };
+    if (dialect === "sqlite")
+        return { kind: "sql", value: "datetime('now')" };
+    return { kind: "literal", value: new Date().toISOString() };
+}
+function asOperator(v) {
+    if (typeof v !== "object" || v === null || isNowSentinel(v))
+        return null;
+    const keys = Object.keys(v).filter((k) => ["lte", "gte", "lt", "gt", "in"].includes(k));
+    if (keys.length === 0)
+        return null;
+    if (keys.length > 1) {
+        throw new Error(`multiple operators in single clause not supported: ${keys.join(", ")}`);
+    }
+    const op = keys[0];
+    return { op, value: v[op] };
+}
+function serializeWhereToPostgrest(where) {
+    const out = {};
+    for (const [col, raw] of Object.entries(where)) {
+        validateColumnName(col);
+        const opObj = asOperator(raw);
+        if (opObj) {
+            if (opObj.op === "in") {
+                if (!Array.isArray(opObj.value))
+                    throw new Error(`in clause requires array for column ${col}`);
+                out[col] = `in.(${opObj.value.map(String).join(",")})`;
+            }
+            else {
+                const resolved = resolveNowSentinel(opObj.value, "postgrest");
+                if (resolved.kind === "sql")
+                    throw new Error("postgrest path cannot use sql sentinel");
+                out[col] = `${opObj.op}.${String(resolved.value)}`;
+            }
+        }
+        else {
+            // scalar => eq
+            const resolved = resolveNowSentinel(raw, "postgrest");
+            out[col] = `eq.${String(resolved.value)}`;
+        }
+    }
+    return out;
+}
+const PG_OP_SQL = {
+    lte: "<=", gte: ">=", lt: "<", gt: ">", eq: "=",
+};
+function serializeWhereToPgSql(where, startIndex) {
+    const parts = [];
+    const params = [];
+    let idx = startIndex;
+    for (const [col, raw] of Object.entries(where)) {
+        validateColumnName(col);
+        const opObj = asOperator(raw);
+        if (opObj) {
+            if (opObj.op === "in") {
+                if (!Array.isArray(opObj.value))
+                    throw new Error(`in clause requires array for column ${col}`);
+                const slots = opObj.value.map(() => `$${idx++}`);
+                params.push(...opObj.value);
+                parts.push(`${col} IN (${slots.join(", ")})`);
+            }
+            else {
+                const resolved = resolveNowSentinel(opObj.value, "pg");
+                if (resolved.kind === "sql") {
+                    parts.push(`${col} ${PG_OP_SQL[opObj.op]} ${resolved.value}`);
+                }
+                else {
+                    parts.push(`${col} ${PG_OP_SQL[opObj.op]} $${idx++}`);
+                    params.push(resolved.value);
+                }
+            }
+        }
+        else {
+            const resolved = resolveNowSentinel(raw, "pg");
+            if (resolved.kind === "sql") {
+                parts.push(`${col} = ${resolved.value}`);
+            }
+            else {
+                parts.push(`${col} = $${idx++}`);
+                params.push(resolved.value);
+            }
+        }
+    }
+    return { fragment: parts.join(" AND "), params, nextParamIndex: idx };
+}
+function serializeSetToPgSql(set, startIndex) {
+    const parts = [];
+    const params = [];
+    let idx = startIndex;
+    for (const [col, raw] of Object.entries(set)) {
+        validateColumnName(col);
+        if (typeof raw === "object" && raw !== null && "increment" in raw) {
+            const n = raw.increment;
+            if (typeof n !== "number" || !Number.isFinite(n))
+                throw new Error(`increment must be a finite number for column ${col}`);
+            parts.push(`${col} = ${col} + ${n}`);
+            continue;
+        }
+        const resolved = resolveNowSentinel(raw, "pg");
+        if (resolved.kind === "sql") {
+            parts.push(`${col} = ${resolved.value}`);
+        }
+        else {
+            parts.push(`${col} = $${idx++}`);
+            params.push(resolved.value);
+        }
+    }
+    return { fragment: parts.join(", "), params, nextParamIndex: idx };
+}
+function serializeSetToPostgrestBody(set, observed) {
+    const out = {};
+    for (const [col, raw] of Object.entries(set)) {
+        validateColumnName(col);
+        if (typeof raw === "object" && raw !== null && "increment" in raw) {
+            const n = raw.increment;
+            if (typeof n !== "number" || !Number.isFinite(n))
+                throw new Error(`increment must be a finite number for column ${col}`);
+            const current = observed[col];
+            if (typeof current !== "number") {
+                const display = current === null ? "null" : typeof current;
+                throw new Error(`increment on ${col} requires observed numeric value (got ${display})`);
+            }
+            out[col] = current + n;
+            continue;
+        }
+        const resolved = resolveNowSentinel(raw, "postgrest");
+        out[col] = resolved.value;
+    }
+    return out;
+}
+/** Columns the caller incremented — needed for CAS witnesses on PostgrestAdapter. */
+function incrementedColumns(set) {
+    return Object.entries(set)
+        .filter(([_, v]) => typeof v === "object" && v !== null && "increment" in v)
+        .map(([col]) => col);
+}
+/**
+ * Reject empty where/set/returning at the API boundary so adapters
+ * don't generate malformed SQL or — on PostgrestAdapter — accidentally
+ * match every row.
+ *
+ * Caller is expected to pass the full ClaimRowsOptions; types kept loose
+ * here because the helper lives in clause-builder which doesn't import
+ * from types.ts (avoids circular import risk).
+ */
+function validateClaimRowsOptions(opts) {
+    if (Object.keys(opts.where).length === 0) {
+        throw new Error("claimRows: where must contain at least one condition");
+    }
+    if (Object.keys(opts.set).length === 0) {
+        throw new Error("claimRows: set must contain at least one field");
+    }
+    if (opts.returning !== undefined && opts.returning.length === 0) {
+        throw new Error("claimRows: returning must contain at least one column (or omit for default *)");
+    }
+}
+//# sourceMappingURL=clause-builder.js.map

package/dist/adapters/clause-builder.js.map

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

package/dist/adapters/file-adapter.d.ts

@@ -13,7 +13,7 @@
  *   }
  * }
  */
-import type { HazoConnectAdapter, Logger } from '../types.js';
+import type { HazoConnectAdapter, Logger, ClaimRowsOptions } from '../types.js';
 import { BaseAdapter } from './base-adapter.js';
 import { QueryBuilder } from '../query-builder.js';
 /**
@@ -46,5 +46,6 @@ export declare class FileAdapter extends BaseAdapter implements HazoConnectAdapt
      * @returns Promise with adapter-specific config
      */
     getConfig(): Promise<any>;
+    claimRows<T = Record<string, unknown>>(_opts: ClaimRowsOptions): Promise<T[]>;
 }
 //# sourceMappingURL=file-adapter.d.ts.map

package/dist/adapters/file-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/file-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAY,YAAW,kBAAkB;IACxE;;;;OAIG;gBACS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAKxC;;;;;;OAMG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC3D,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,GAAG,CAAC;IAOf;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAOzE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;CAGhC"}
+{"version":3,"file":"file-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/file-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAY,YAAW,kBAAkB;IACxE;;;;OAIG;gBACS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAKxC;;;;;;OAMG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC3D,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,GAAG,CAAC;IAOf;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAOzE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IAIzB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAGpF"}

package/dist/adapters/file-adapter.js

@@ -57,6 +57,9 @@ class FileAdapter extends base_adapter_js_1.BaseAdapter {
     async getConfig() {
         return Promise.resolve(this.config.file || this.config);
     }
+    async claimRows(_opts) {
+        this.throwError(types_js_1.ErrorCode.NOT_IMPLEMENTED, "FileAdapter.claimRows: not supported by file backend");
+    }
 }
 exports.FileAdapter = FileAdapter;
 //# sourceMappingURL=file-adapter.js.map

package/dist/adapters/file-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-adapter.js","sourceRoot":"","sources":["../../src/lib/adapters/file-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAGH,uDAA+C;AAE/C,0CAAuC;AAEvC;;GAEG;AACH,MAAa,WAAY,SAAQ,6BAAW;IAC1C;;;;OAIG;IACH,YAAY,MAAW,EAAE,MAAe;QACtC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACrB,8CAA8C;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CACT,OAAqB,EACrB,SAAsD,KAAK,EAC3D,IAAU;QAEV,IAAI,CAAC,UAAU,CACb,oBAAS,CAAC,eAAe,EACzB,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,UAAuB,EAAE;QACxD,IAAI,CAAC,UAAU,CACb,oBAAS,CAAC,eAAe,EACzB,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;CACF;AAjDD,kCAiDC"}
+{"version":3,"file":"file-adapter.js","sourceRoot":"","sources":["../../src/lib/adapters/file-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAGH,uDAA+C;AAE/C,0CAAuC;AAEvC;;GAEG;AACH,MAAa,WAAY,SAAQ,6BAAW;IAC1C;;;;OAIG;IACH,YAAY,MAAW,EAAE,MAAe;QACtC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACrB,8CAA8C;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CACT,OAAqB,EACrB,SAAsD,KAAK,EAC3D,IAAU;QAEV,IAAI,CAAC,UAAU,CACb,oBAAS,CAAC,eAAe,EACzB,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,UAAuB,EAAE;QACxD,IAAI,CAAC,UAAU,CACb,oBAAS,CAAC,eAAe,EACzB,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,SAAS,CAA8B,KAAuB;QAClE,IAAI,CAAC,UAAU,CAAC,oBAAS,CAAC,eAAe,EAAE,sDAAsD,CAAC,CAAA;IACpG,CAAC;CACF;AArDD,kCAqDC"}

package/dist/adapters/pg-adapter.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Purpose: PostgreSQL adapter powered by the `postgres` (postgres.js) driver.
+ *
+ * Supports raw SQL execution via sql.unsafe(), which is required for advanced
+ * Postgres features (e.g., SELECT … FOR UPDATE SKIP LOCKED) that PostgREST
+ * does not expose. The query(builder) method intentionally throws until Task 1.3
+ * adds toPgSql() to the QueryBuilder.
+ */
+import type { Logger, ClaimRowsOptions } from '../types.js';
+import { BaseAdapter } from './base-adapter.js';
+import type { QueryBuilder } from '../query-builder.js';
+export interface PgAdapterConfig {
+    type: 'pg';
+    connectionString: string;
+    poolMax?: number;
+    ssl?: boolean | 'require';
+    log_level?: string;
+}
+export declare class PgAdapter extends BaseAdapter {
+    private sql;
+    constructor(config: PgAdapterConfig, logger?: Logger);
+    /**
+     * Execute a query using the QueryBuilder.
+     * Not yet implemented — toPgSql() is added in Task 1.3.
+     * hazo_jobs should use raw() directly until then.
+     */
+    query(_builder: QueryBuilder, _method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', _body?: unknown): Promise<never>;
+    /**
+     * Not applicable for the pg adapter (no HTTP layer).
+     * Satisfies the HazoConnectAdapter interface — use raw() for direct SQL.
+     */
+    rawQuery(_endpoint: string, _options?: RequestInit): Promise<never>;
+    /**
+     * Execute a raw SQL statement with positional parameters.
+     * Uses sql.unsafe() so that the caller controls the full query text.
+     * Parameters are passed as a plain array and forwarded to postgres.js.
+     *
+     * @param text   - SQL text, e.g. "SELECT * FROM jobs WHERE id = $1"
+     * @param values - Positional parameter values
+     * @returns Array of row objects
+     */
+    raw<T = unknown>(text: string, values?: unknown[]): Promise<T[]>;
+    /**
+     * Atomically claim rows from a queue table using FOR UPDATE SKIP LOCKED.
+     *
+     * A CTE selects candidate rows matching `where`, locks them with
+     * SKIP LOCKED so concurrent callers never contend, then UPDATE sets
+     * the requested fields and returns the RETURNING projection.
+     *
+     * @param opts - Table, where filter, set patch, optional orderBy/limit/returning
+     * @returns Array of updated row objects (empty when no rows match)
+     */
+    claimRows<T = Record<string, unknown>>(opts: ClaimRowsOptions): Promise<T[]>;
+    /**
+     * Drain the connection pool and release all Postgres connections.
+     * Call this on process shutdown or when the adapter is no longer needed.
+     */
+    close(): Promise<void>;
+    /**
+     * Return the resolved adapter configuration.
+     */
+    getConfig(): Promise<PgAdapterConfig>;
+}
+//# sourceMappingURL=pg-adapter.d.ts.map

package/dist/adapters/pg-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/pg-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAQvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAA;IACV,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,GAAG,CAAK;gBAEJ,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM;IAYpD;;;;OAIG;IACG,KAAK,CACT,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC5D,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,KAAK,CAAC;IAOjB;;;OAGG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IAOzE;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAS1E;;;;;;;;;OASG;IACG,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAkClF;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;CAG5C"}