orez 0.2.26 → 0.2.29

package/dist/pg-sqlite-compiler/test/oracle.js

@@ -0,0 +1,204 @@
+/**
+ * pgsqlite-backed oracle for compiler quality.
+ *
+ * Spawns a real pgsqlite server, sends PG SQL via the PG wire protocol,
+ * captures the result set. Compares against running the same query through
+ * our compiler + bun:sqlite. Equivalence at the result-set level is what we
+ * actually care about — pgsqlite is the oracle, not the spec.
+ *
+ * The pgsqlite binary path comes from `vendor/pgsqlite/.resolved-path`,
+ * populated by `scripts/pgsqlite/ensure.ts`. If empty, oracle tests should
+ * be marked `it.skip` so the suite still runs without pgsqlite installed.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { createConnection, createServer } from 'node:net';
+import { tmpdir } from 'node:os';
+import { resolve } from 'node:path';
+import Database from '@rocicorp/zero-sqlite3';
+const VENDOR_PATH_FILE = resolve(import.meta.dirname, '..', '..', '..', 'vendor', 'pgsqlite', '.resolved-path');
+export function pgsqliteBinPath() {
+    if (!existsSync(VENDOR_PATH_FILE))
+        return null;
+    const path = readFileSync(VENDOR_PATH_FILE, 'utf-8').trim();
+    return path && existsSync(path) ? path : null;
+}
+export const ORACLE_AVAILABLE = pgsqliteBinPath() !== null;
+/**
+ * Pick a free TCP port by binding ephemeral and reading what we got.
+ * Then close immediately and hand the port to pgsqlite. There's a tiny TOCTOU
+ * window where another process could grab it before pgsqlite binds, but
+ * vitest's parallel test files all go through this helper, so the only races
+ * are against unrelated processes on the host — vanishingly unlikely in CI.
+ */
+async function getFreePort() {
+    return new Promise((resolveFn, reject) => {
+        const server = createServer();
+        server.unref();
+        server.on('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const addr = server.address();
+            if (!addr || typeof addr === 'string') {
+                server.close();
+                reject(new Error('failed to get free port'));
+                return;
+            }
+            const port = addr.port;
+            server.close(() => resolveFn(port));
+        });
+    });
+}
+async function probePort(port, timeoutMs) {
+    return new Promise((resolveFn) => {
+        const sock = createConnection({ host: '127.0.0.1', port });
+        const cleanup = (val) => {
+            try {
+                sock.destroy();
+            }
+            catch { }
+            resolveFn(val);
+        };
+        const timer = setTimeout(() => cleanup(false), timeoutMs);
+        sock.once('connect', () => {
+            clearTimeout(timer);
+            cleanup(true);
+        });
+        sock.once('error', () => {
+            clearTimeout(timer);
+            cleanup(false);
+        });
+    });
+}
+/**
+ * Start a pgsqlite server on an OS-assigned ephemeral port with an ephemeral
+ * database. Throws on probe timeout. Caller is responsible for calling
+ * `stop()` in a `finally` / `afterAll` hook — `stop()` awaits child exit
+ * and cleans up the tempdir.
+ */
+export async function startPgsqliteServer() {
+    const bin = pgsqliteBinPath();
+    if (!bin)
+        throw new Error('pgsqlite binary not available');
+    const port = await getFreePort();
+    const tmpDir = mkdtempSync(resolve(tmpdir(), 'orez-oracle-'));
+    const dbPath = resolve(tmpDir, 'pg.db');
+    const proc = spawn(bin, ['--port', String(port), '--database', dbPath, '--log-level', 'error'], { stdio: ['ignore', 'pipe', 'pipe'] });
+    const exited = new Promise((res) => proc.once('exit', () => res()));
+    // wait for "ready" — poll until the server accepts a connection or we time out
+    let ready = false;
+    const start = Date.now();
+    while (Date.now() - start < 10_000) {
+        if (await probePort(port, 250)) {
+            ready = true;
+            break;
+        }
+        if (proc.exitCode !== null) {
+            throw new Error(`pgsqlite exited before becoming ready (code=${proc.exitCode})`);
+        }
+        await new Promise((r) => setTimeout(r, 50));
+    }
+    if (!ready) {
+        try {
+            proc.kill('SIGKILL');
+        }
+        catch { }
+        try {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch { }
+        throw new Error(`pgsqlite did not become ready on port ${port} within 10s`);
+    }
+    return {
+        port,
+        dbPath,
+        async stop() {
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch { }
+            // wait up to 2s for graceful exit, then SIGKILL
+            const killTimer = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch { }
+            }, 2_000);
+            try {
+                await exited;
+            }
+            finally {
+                clearTimeout(killTimer);
+            }
+            try {
+                rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch { }
+        },
+    };
+}
+/**
+ * Helper: open a postgres.js client to a running pgsqlite server.
+ * Requires `postgres` to be available (we already ship it via @rocicorp/zero).
+ */
+export async function connectOracle(server) {
+    const { default: postgres } = await import('postgres');
+    const sql = postgres({
+        host: '127.0.0.1',
+        port: server.port,
+        user: 'oracle',
+        password: '',
+        database: 'main',
+        ssl: false,
+        max: 1,
+        idle_timeout: 5,
+        connect_timeout: 5,
+        fetch_types: false,
+        prepare: false,
+    });
+    return {
+        exec: async (s, params = []) => {
+            const rows = await sql.unsafe(s, params);
+            return rows;
+        },
+        end: () => sql.end({ timeout: 2 }).then(() => undefined),
+    };
+}
+/**
+ * Run the same query against pgsqlite (oracle) and our compiler+SQLite (under
+ * test). Return both result sets so the test can diff them however it wants.
+ *
+ * Uses freshly-spawned servers/dbs for each call — slow but isolated. For
+ * batches use the lower-level helpers above.
+ */
+export async function runOracleAndCompiler(setupSql, pgSql, params = []) {
+    const server = await startPgsqliteServer();
+    try {
+        const conn = await connectOracle(server);
+        try {
+            for (const s of setupSql)
+                await conn.exec(s);
+            const oracle = await conn.exec(pgSql, params);
+            // ours: setup + query against fresh in-memory sqlite (after compile())
+            const { compile } = await import('../index.js');
+            const db = new Database(':memory:');
+            for (const s of setupSql) {
+                const { sql: translated } = compile(s);
+                db.exec(translated);
+            }
+            const { sql: translatedQuery } = compile(pgSql);
+            // postgres.js uses $1 params; sqlite uses ?
+            const sqliteSql = translatedQuery.replace(/\$(\d+)/g, '?');
+            const stmt = db.prepare(sqliteSql);
+            const ours = (params.length > 0 ? stmt.all(...params) : stmt.all());
+            db.close();
+            return { oracle, ours };
+        }
+        finally {
+            await conn.end();
+        }
+    }
+    finally {
+        await server.stop();
+    }
+}
+//# sourceMappingURL=oracle.js.map

package/dist/pg-sqlite-compiler/test/oracle.js.map

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

package/dist/pg-sqlite-compiler/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Schema metadata available to passes for type-aware translation.
+ *
+ * Implementations are caller-provided. The default NOOP_SCHEMA returns nothing
+ * and passes degrade gracefully (regex/AST-shape fallbacks).
+ *
+ * For orez, the eventual implementation will read from `ctx.storage.sql`
+ * PRAGMA + the `_orez_pg_metadata` catalog table.
+ */
+export interface SchemaInfo {
+    /** PG type name (e.g. "jsonb", "text[]") for a column, or undefined. */
+    getColumnType(schema: string, table: string, column: string): string | undefined;
+    /** ENUM definition lookup by PG type name. */
+    getEnum(typeName: string): EnumInfo | undefined;
+    /** Validate an ENUM literal value. */
+    isEnumValue(typeOid: number, label: string): boolean;
+    /** Column list for a table (for SELECT * expansion, RETURNING * etc.). */
+    getTableColumns(schema: string, table: string): readonly string[] | undefined;
+}
+export interface EnumInfo {
+    typeOid: number;
+    values: readonly string[];
+}
+export interface CompileWarning {
+    kind: string;
+    message: string;
+    /** PG AST node tag where the warning was raised. */
+    near?: string;
+}
+export interface CompileResult {
+    sql: string;
+    warnings: CompileWarning[];
+}
+export interface CompileOptions {
+    schema?: SchemaInfo;
+    pgVersion?: number;
+    /** Override pass list (mainly for testing individual passes). */
+    passes?: Pass[];
+}
+/** Context passed to every pass. */
+export interface PassContext {
+    schema: SchemaInfo;
+    warnings: CompileWarning[];
+    /**
+     * Optional pass list — if set, runPasses uses these instead of the default
+     * pipeline. Otherwise the full default pipeline runs.
+     */
+    passes?: Pass[];
+}
+/** A pass is a function that mutates a RawStmt in place. */
+export interface Pass {
+    name: string;
+    run(rawStmt: any, ctx: PassContext): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pg-sqlite-compiler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pg-sqlite-compiler/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAEhF,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAE/C,sCAAsC;IACtC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAEpD,0EAA0E;IAC1E,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAC9E;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAA;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,EAAE,CAAA;CAChB;AAED,4DAA4D;AAC5D,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAAA;CAC1C"}

package/dist/pg-sqlite-compiler/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pg-sqlite-compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pg-sqlite-compiler/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orez",
-  "version": "0.2.26",
+  "version": "0.2.29",
   "description": "PGlite-powered zero-sync development backend. No Docker required.",
   "type": "module",
   "license": "MIT",
@@ -44,8 +44,7 @@
     "orez": "dist/cli-entry.js"
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "scripts": {
     "build": "tsc && chmod +x dist/cli-entry.js",
@@ -58,6 +57,10 @@
     "test:wasm": "vitest run src/wasm-sqlite.test.ts",
     "test:all": "vitest run",
     "test:watch": "vitest",
+    "test:compiler": "vitest run src/pg-sqlite-compiler/",
+    "test:compiler:oracle": "bun scripts/pgsqlite/ensure.ts && vitest run src/pg-sqlite-compiler/test/",
+    "compiler:harvest-fixtures": "bun scripts/pgsqlite/harvest-fixtures.ts",
+    "compiler:ensure-pgsqlite": "bun scripts/pgsqlite/ensure.ts",
     "lint": "oxlint --import-plugin --ignore-pattern sqlite-wasm/",
     "format": "oxfmt .",
     "format:check": "oxfmt --check .",
@@ -83,7 +86,8 @@
   "dependencies": {
     "@electric-sql/pglite": "0.4.1",
     "@electric-sql/pglite-tools": "^0.3.1",
-    "bedrock-sqlite": "0.2.26",
+    "@pgsql/traverse": "17.2.6",
+    "bedrock-sqlite": "0.2.28",
     "citty": "^0.2.0",
     "pg-gateway": "0.3.0-beta.4",
     "pgsql-parser": "^17.9.11",

package/src/admin/admin-data.test.ts

@@ -1,348 +0,0 @@
-/**
- * integration tests for the admin data explorer endpoints.
- *
- * spins up pglite instances + admin server directly (no zero-cache)
- * and exercises the /api/db/* and /api/sqlite/* endpoints.
- */
-import { mkdirSync, rmSync, writeFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-
-import { PGlite } from '@electric-sql/pglite'
-import { afterAll, beforeAll, describe, expect, test } from 'vitest'
-
-import { startAdminServer } from './server.js'
-
-import type { ZeroLiteConfig } from '../config.js'
-import type { LogStore } from './log-store.js'
-import type { Server } from 'node:http'
-
-const TEST_PORT = 16400 + Math.floor(Math.random() * 500)
-const DATA_DIR = `.orez-admin-data-test-${Date.now()}`
-
-function stubLogStore(): LogStore {
-  const entries: any[] = []
-  return {
-    push() {},
-    query() {
-      return { entries, cursor: 0 }
-    },
-    getAll() {
-      return entries
-    },
-    clear() {
-      entries.length = 0
-    },
-  }
-}
-
-function stubConfig(): ZeroLiteConfig {
-  return {
-    dataDir: resolve(DATA_DIR),
-    pgPort: 0,
-    zeroPort: 0,
-    adminPort: TEST_PORT,
-    pgUser: 'test',
-    pgPassword: 'test',
-    migrationsDir: '',
-    seedFile: '',
-    skipZeroCache: true,
-    disableWasmSqlite: false,
-    forceWasmSqlite: false,
-    useWorkerThreads: false,
-    singleDb: false,
-    readReplicas: 0,
-    logLevel: 'info',
-    pgliteOptions: {},
-    checkpointIntervalMs: 0,
-    maxLogFileSize: 0,
-    disableDiskLogs: true,
-  }
-}
-
-describe('admin data explorer', { timeout: 60_000 }, () => {
-  let server: Server
-  let postgres: PGlite
-  let cvr: PGlite
-  let cdb: PGlite
-  const base = `http://127.0.0.1:${TEST_PORT}`
-
-  beforeAll(async () => {
-    mkdirSync(DATA_DIR, { recursive: true })
-
-    postgres = new PGlite()
-    cvr = new PGlite()
-    cdb = new PGlite()
-    await Promise.all([postgres.waitReady, cvr.waitReady, cdb.waitReady])
-
-    // create test tables
-    await postgres.exec(`
-      CREATE TABLE public.users (
-        id serial PRIMARY KEY,
-        name text NOT NULL,
-        email text,
-        active boolean DEFAULT true
-      );
-      INSERT INTO public.users (name, email) VALUES
-        ('alice', 'alice@test.com'),
-        ('bob', 'bob@test.com'),
-        ('charlie', 'charlie@test.com');
-    `)
-
-    await postgres.exec(`
-      CREATE TABLE public.posts (
-        id serial PRIMARY KEY,
-        user_id int REFERENCES users(id),
-        title text NOT NULL,
-        body text
-      );
-      INSERT INTO public.posts (user_id, title, body) VALUES
-        (1, 'hello world', 'first post'),
-        (1, 'second post', 'more content'),
-        (2, 'bob writes', NULL);
-    `)
-
-    server = await startAdminServer({
-      port: TEST_PORT,
-      logStore: stubLogStore(),
-      config: stubConfig(),
-      zeroEnv: {},
-      startTime: Date.now(),
-      db: { postgres, cvr, cdb, postgresReplicas: [] } as any,
-    })
-  })
-
-  afterAll(async () => {
-    server?.close()
-    await Promise.all([postgres?.close(), cvr?.close(), cdb?.close()])
-    rmSync(DATA_DIR, { recursive: true, force: true })
-  })
-
-  // --- html ---
-
-  test('GET / serves html', async () => {
-    const res = await fetch(`${base}/`)
-    expect(res.status).toBe(200)
-    expect(res.headers.get('content-type')).toContain('text/html')
-    const html = await res.text()
-    expect(html).toContain('oreZ admin')
-    expect(html).toContain('data-db="sqlite"')
-  })
-
-  test('GET /data serves html', async () => {
-    const res = await fetch(`${base}/data`)
-    expect(res.status).toBe(200)
-    const html = await res.text()
-    expect(html).toContain('sql-editor')
-  })
-
-  // --- /api/db/tables ---
-
-  test('lists postgres tables', async () => {
-    const res = await fetch(`${base}/api/db/tables?db=postgres`)
-    expect(res.status).toBe(200)
-    const data = await res.json()
-    expect(data.tables).toBeDefined()
-    const names = data.tables.map((t: any) => t.table_name)
-    expect(names).toContain('users')
-    expect(names).toContain('posts')
-  })
-
-  test('lists cvr tables (empty)', async () => {
-    const res = await fetch(`${base}/api/db/tables?db=cvr`)
-    expect(res.status).toBe(200)
-    const data = await res.json()
-    expect(data.tables).toBeDefined()
-    expect(data.tables.length).toBe(0)
-  })
-
-  test('rejects unknown db name', async () => {
-    const res = await fetch(`${base}/api/db/tables?db=nope`)
-    expect(res.status).toBe(400)
-    const data = await res.json()
-    expect(data.error).toContain('unknown db')
-  })
-
-  // --- /api/db/table-data ---
-
-  test('browses table data', async () => {
-    const res = await fetch(`${base}/api/db/table-data?db=postgres&table=users`)
-    expect(res.status).toBe(200)
-    const data = await res.json()
-    expect(data.columns).toBeDefined()
-    expect(data.columns.length).toBeGreaterThanOrEqual(4)
-    expect(data.rows.length).toBe(3)
-    expect(data.total).toBe(3)
-    // check column metadata
-    const colNames = data.columns.map((c: any) => c.name)
-    expect(colNames).toContain('id')
-    expect(colNames).toContain('name')
-    expect(colNames).toContain('email')
-  })
-
-  test('table-data supports search', async () => {
-    const res = await fetch(
-      `${base}/api/db/table-data?db=postgres&table=users&search=alice`
-    )
-    const data = await res.json()
-    expect(data.rows.length).toBe(1)
-    expect(data.rows[0].name).toBe('alice')
-    expect(data.total).toBe(1)
-  })
-
-  test('table-data supports pagination', async () => {
-    const res = await fetch(
-      `${base}/api/db/table-data?db=postgres&table=users&limit=2&offset=0`
-    )
-    const data = await res.json()
-    expect(data.rows.length).toBe(2)
-    expect(data.total).toBe(3)
-
-    const page2 = await fetch(
-      `${base}/api/db/table-data?db=postgres&table=users&limit=2&offset=2`
-    )
-    const data2 = await page2.json()
-    expect(data2.rows.length).toBe(1)
-  })
-
-  test('table-data with schema-qualified name', async () => {
-    const res = await fetch(`${base}/api/db/table-data?db=postgres&table=public.posts`)
-    const data = await res.json()
-    expect(data.rows.length).toBe(3)
-    // check NULL values come through
-    const bobPost = data.rows.find((r: any) => r.title === 'bob writes')
-    expect(bobPost).toBeDefined()
-    expect(bobPost.body).toBeNull()
-  })
-
-  test('table-data missing table param', async () => {
-    const res = await fetch(`${base}/api/db/table-data?db=postgres`)
-    expect(res.status).toBe(400)
-    const data = await res.json()
-    expect(data.error).toContain('missing table')
-  })
-
-  // --- /api/db/query ---
-
-  test('runs arbitrary SQL', async () => {
-    const res = await fetch(`${base}/api/db/query`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        db: 'postgres',
-        sql: 'SELECT name, email FROM users ORDER BY name',
-      }),
-    })
-    expect(res.status).toBe(200)
-    const data = await res.json()
-    expect(data.fields).toEqual(['name', 'email'])
-    expect(data.rowCount).toBe(3)
-    expect(data.rows[0].name).toBe('alice')
-    expect(data.durationMs).toBeGreaterThanOrEqual(0)
-  })
-
-  test('returns error for bad SQL', async () => {
-    const res = await fetch(`${base}/api/db/query`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ db: 'postgres', sql: 'SELECT * FROM nonexistent' }),
-    })
-    expect(res.status).toBe(400)
-    const data = await res.json()
-    expect(data.error).toBeTruthy()
-  })
-
-  test('query with joins', async () => {
-    const res = await fetch(`${base}/api/db/query`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        db: 'postgres',
-        sql: `SELECT u.name, p.title FROM users u JOIN posts p ON p.user_id = u.id ORDER BY p.id`,
-      }),
-    })
-    const data = await res.json()
-    expect(data.rowCount).toBe(3)
-    expect(data.fields).toEqual(['name', 'title'])
-  })
-
-  test('query missing sql', async () => {
-    const res = await fetch(`${base}/api/db/query`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ db: 'postgres' }),
-    })
-    expect(res.status).toBe(400)
-    const data = await res.json()
-    expect(data.error).toContain('missing sql')
-  })
-
-  // --- sqlite ---
-
-  test('sqlite tables returns 404 when no replica', async () => {
-    const res = await fetch(`${base}/api/sqlite/tables`)
-    expect(res.status).toBe(404)
-    const data = await res.json()
-    expect(data.error).toContain('not found')
-  })
-
-  test('sqlite endpoints work when replica file exists', async () => {
-    // create a fake zero-replica.db using bedrock-sqlite
-    // @ts-expect-error - CJS module
-    const bedrock: any = await import('bedrock-sqlite')
-    const Ctor = bedrock.Database || bedrock.default?.Database || bedrock.default
-    const replicaPath = resolve(DATA_DIR, 'zero-replica.db')
-    const setupDb = new Ctor(replicaPath)
-    setupDb.exec(`
-      CREATE TABLE widgets (
-        id INTEGER PRIMARY KEY,
-        label TEXT NOT NULL,
-        count INTEGER
-      );
-      INSERT INTO widgets (label, count) VALUES
-        ('alpha', 1),
-        ('beta', 2),
-        ('gamma', 3);
-    `)
-    setupDb.close()
-
-    // list tables
-    const tablesRes = await fetch(`${base}/api/sqlite/tables`)
-    expect(tablesRes.status).toBe(200)
-    const tables = await tablesRes.json()
-    expect(tables.tables.some((t: any) => t.name === 'widgets')).toBe(true)
-
-    // browse table data
-    const browseRes = await fetch(`${base}/api/sqlite/table-data?table=widgets`)
-    expect(browseRes.status).toBe(200)
-    const browse = await browseRes.json()
-    expect(browse.rows.length).toBe(3)
-    expect(browse.total).toBe(3)
-
-    // search
-    const searchRes = await fetch(
-      `${base}/api/sqlite/table-data?table=widgets&search=beta`
-    )
-    const search = await searchRes.json()
-    expect(search.rows.length).toBe(1)
-    expect(search.rows[0].label).toBe('beta')
-
-    // raw query
-    const queryRes = await fetch(`${base}/api/sqlite/query`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ sql: 'SELECT count(*) as c FROM widgets' }),
-    })
-    expect(queryRes.status).toBe(200)
-    const q = await queryRes.json()
-    expect(q.rows[0].c).toBe(3)
-    expect(q.fields).toContain('c')
-  })
-
-  // --- CORS ---
-
-  test('OPTIONS returns CORS headers', async () => {
-    const res = await fetch(`${base}/api/db/tables`, { method: 'OPTIONS' })
-    expect(res.status).toBe(200)
-    expect(res.headers.get('access-control-allow-origin')).toBe('*')
-  })
-})