@edge-base/server 0.3.1 → 0.3.3

package/admin-build/_app/immutable/nodes/{9.f548N7zh.js → 9.9BZCZcm_.js}

@@ -1 +1 @@
-import"../chunks/CWj6FrbW.js";import{o as U}from"../chunks/Bn2NtlTj.js";import{p as j,a as z,f as G,c as b,g as t,s as m,r as g,u as n,b as y,d as D,t as J}from"../chunks/BdTBlfLy.js";import{d as K,s as N,a as O}from"../chunks/DtZk82gG.js";import{a as Q,t as V,e as W,i as X}from"../chunks/BkrC_6Ss.js";import{a as F,f as I}from"../chunks/DEELgv7K.js";import{d as Y,s as Z}from"../chunks/CjcrXziO.js";import{P as tt}from"../chunks/BkZCgsc3.js";import{a as et}from"../chunks/Q2nPFxS6.js";import{M as _,T as at}from"../chunks/DOOhHO-v.js";import{D as rt,T as nt}from"../chunks/dZsKGnWZ.js";var st=I("<button> </button>"),ot=I('<div class="range-selector"></div>'),lt=I('<div class="analytics-grid"><!> <!> <!> <!></div> <div class="analytics-chart"><!></div> <div class="analytics-bottom"><!> <!></div>',1);function yt(w,A){j(A,!0);let s=D(!0),o=D(null),p=D("24h");const M=[{value:"1h",label:"1H"},{value:"6h",label:"6H"},{value:"24h",label:"24H"},{value:"7d",label:"7D"},{value:"30d",label:"30D"}],T=n(()=>()=>{switch(t(p)){case"1h":return"minute";case"6h":case"24h":return"hour";default:return"day"}});async function $(){try{const e=await Q.fetch(`data/analytics?range=${t(p)}&category=function&metric=overview&groupBy=${t(T)()}`);y(o,e,!0)}catch(e){V(Y(e,"Failed to load functions analytics."))}finally{y(s,!1)}}function k(e){y(p,e,!0),y(s,!0),$()}U(()=>{$();const e=setInterval($,3e4);return()=>clearInterval(e)});const H=n(()=>()=>{var c;if(!((c=t(o))!=null&&c.summary))return 0;const{totalRequests:e,totalErrors:a}=t(o).summary;return e>0?a/e*100:0}),B=n(()=>()=>{var e;return(((e=t(o))==null?void 0:e.timeSeries)||[]).map(a=>({timestamp:a.timestamp,value:a.requests??a.value??0}))}),C=n(()=>()=>{var e;return(((e=t(o))==null?void 0:e.breakdown)||[]).map(a=>({label:a.label||"other",value:a.count}))}),E=n(()=>()=>{var e;return(((e=t(o))==null?void 0:e.topItems)||[]).map(a=>({label:a.label,count:a.count,secondary:`${Math.round(a.avgLatency)}ms · ${a.errorRate.toFixed(1)}% 5xx`}))});tt(w,{title:"Functions Analytics",description:"Serverless function execution and performance metrics",get docsHref(){return et},actions:a=>{var c=ot();W(c,21,()=>M,X,(f,d)=>{var l=st();let v;var h=b(l,!0);g(l),J(()=>{v=Z(l,1,"range-btn",null,v,{"range-btn--active":t(p)===t(d).value}),N(h,t(d).label)}),O("click",l,()=>k(t(d).value)),F(f,l)}),g(c),F(a,c)},children:(a,c)=>{var f=lt(),d=G(f),l=b(d);{let r=n(()=>{var i,u;return((u=(i=t(o))==null?void 0:i.summary)==null?void 0:u.totalRequests)??0});_(l,{label:"Invocations",get value(){return t(r)},get loading(){return t(s)}})}var v=m(l,2);{let r=n(()=>{var i,u;return((u=(i=t(o))==null?void 0:i.summary)==null?void 0:u.uniqueUsers)??0});_(v,{label:"Unique Users",get value(){return t(r)},get loading(){return t(s)}})}var h=m(v,2);{let r=n(()=>t(H)().toFixed(1));_(h,{label:"5xx Rate",get value(){return t(r)},unit:"%",get loading(){return t(s)}})}var L=m(h,2);{let r=n(()=>{var i,u;return Math.round(((u=(i=t(o))==null?void 0:i.summary)==null?void 0:u.avgLatency)??0)});_(L,{label:"Avg Duration",get value(){return t(r)},unit:"ms",get loading(){return t(s)}})}g(d);var x=m(d,2),P=b(x);{let r=n(()=>t(B)());at(P,{get data(){return t(r)},type:"bar",height:240,label:"Function invocations over time",get loading(){return t(s)},color:"#dc2626"})}g(x);var R=m(x,2),q=b(R);{let r=n(()=>t(C)());rt(q,{get items(){return t(r)},title:"Functions by invocation count",get loading(){return t(s)}})}var S=m(q,2);{let r=n(()=>t(E)());nt(S,{get items(){return t(r)},title:"Top Functions",get loading(){return t(s)}})}g(R),F(a,f)}}),z()}K(["click"]);export{yt as component};
+import"../chunks/CWj6FrbW.js";import{o as U}from"../chunks/Bn2NtlTj.js";import{p as j,a as z,f as G,c as b,g as t,s as m,r as g,u as n,b as y,d as D,t as J}from"../chunks/BdTBlfLy.js";import{d as K,s as N,a as O}from"../chunks/DtZk82gG.js";import{a as Q,t as V,e as W,i as X}from"../chunks/D3arvney.js";import{a as F,f as I}from"../chunks/DEELgv7K.js";import{d as Y,s as Z}from"../chunks/CjcrXziO.js";import{P as tt}from"../chunks/BkZCgsc3.js";import{a as et}from"../chunks/Q2nPFxS6.js";import{M as _,T as at}from"../chunks/CtOkHpP1.js";import{D as rt,T as nt}from"../chunks/Da6ZRIF1.js";var st=I("<button> </button>"),ot=I('<div class="range-selector"></div>'),lt=I('<div class="analytics-grid"><!> <!> <!> <!></div> <div class="analytics-chart"><!></div> <div class="analytics-bottom"><!> <!></div>',1);function yt(w,A){j(A,!0);let s=D(!0),o=D(null),p=D("24h");const M=[{value:"1h",label:"1H"},{value:"6h",label:"6H"},{value:"24h",label:"24H"},{value:"7d",label:"7D"},{value:"30d",label:"30D"}],T=n(()=>()=>{switch(t(p)){case"1h":return"minute";case"6h":case"24h":return"hour";default:return"day"}});async function $(){try{const e=await Q.fetch(`data/analytics?range=${t(p)}&category=function&metric=overview&groupBy=${t(T)()}`);y(o,e,!0)}catch(e){V(Y(e,"Failed to load functions analytics."))}finally{y(s,!1)}}function k(e){y(p,e,!0),y(s,!0),$()}U(()=>{$();const e=setInterval($,3e4);return()=>clearInterval(e)});const H=n(()=>()=>{var c;if(!((c=t(o))!=null&&c.summary))return 0;const{totalRequests:e,totalErrors:a}=t(o).summary;return e>0?a/e*100:0}),B=n(()=>()=>{var e;return(((e=t(o))==null?void 0:e.timeSeries)||[]).map(a=>({timestamp:a.timestamp,value:a.requests??a.value??0}))}),C=n(()=>()=>{var e;return(((e=t(o))==null?void 0:e.breakdown)||[]).map(a=>({label:a.label||"other",value:a.count}))}),E=n(()=>()=>{var e;return(((e=t(o))==null?void 0:e.topItems)||[]).map(a=>({label:a.label,count:a.count,secondary:`${Math.round(a.avgLatency)}ms · ${a.errorRate.toFixed(1)}% 5xx`}))});tt(w,{title:"Functions Analytics",description:"Serverless function execution and performance metrics",get docsHref(){return et},actions:a=>{var c=ot();W(c,21,()=>M,X,(f,d)=>{var l=st();let v;var h=b(l,!0);g(l),J(()=>{v=Z(l,1,"range-btn",null,v,{"range-btn--active":t(p)===t(d).value}),N(h,t(d).label)}),O("click",l,()=>k(t(d).value)),F(f,l)}),g(c),F(a,c)},children:(a,c)=>{var f=lt(),d=G(f),l=b(d);{let r=n(()=>{var i,u;return((u=(i=t(o))==null?void 0:i.summary)==null?void 0:u.totalRequests)??0});_(l,{label:"Invocations",get value(){return t(r)},get loading(){return t(s)}})}var v=m(l,2);{let r=n(()=>{var i,u;return((u=(i=t(o))==null?void 0:i.summary)==null?void 0:u.uniqueUsers)??0});_(v,{label:"Unique Users",get value(){return t(r)},get loading(){return t(s)}})}var h=m(v,2);{let r=n(()=>t(H)().toFixed(1));_(h,{label:"5xx Rate",get value(){return t(r)},unit:"%",get loading(){return t(s)}})}var L=m(h,2);{let r=n(()=>{var i,u;return Math.round(((u=(i=t(o))==null?void 0:i.summary)==null?void 0:u.avgLatency)??0)});_(L,{label:"Avg Duration",get value(){return t(r)},unit:"ms",get loading(){return t(s)}})}g(d);var x=m(d,2),P=b(x);{let r=n(()=>t(B)());at(P,{get data(){return t(r)},type:"bar",height:240,label:"Function invocations over time",get loading(){return t(s)},color:"#dc2626"})}g(x);var R=m(x,2),q=b(R);{let r=n(()=>t(C)());rt(q,{get items(){return t(r)},title:"Functions by invocation count",get loading(){return t(s)}})}var S=m(q,2);{let r=n(()=>t(E)());nt(S,{get items(){return t(r)},title:"Top Functions",get loading(){return t(s)}})}g(R),F(a,f)}}),z()}K(["click"]);export{yt as component};

package/admin-build/_app/version.json

@@ -1 +1 @@
-{"version":"1783089130568"}
+{"version":"1783478674771"}

package/admin-build/index.html

@@ -5,12 +5,12 @@
         <meta name="viewport" content="width=device-width, initial-scale=1" />
         <title>EdgeBase Admin</title>
         <link rel="icon" href="/admin/favicon.svg" type="image/svg+xml" />
-        <link href="/admin/_app/immutable/entry/start.BgMeGq-q.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/chunks/DdjFeYwG.js" rel="modulepreload">
+        <link href="/admin/_app/immutable/entry/start.D21f0BIj.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/chunks/DuAuob_N.js" rel="modulepreload">
 		<link href="/admin/_app/immutable/chunks/BdTBlfLy.js" rel="modulepreload">
 		<link href="/admin/_app/immutable/chunks/Bn2NtlTj.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/chunks/D3hdqsfp.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/entry/app.j1WHBlZX.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/chunks/ByFwWOVj.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/entry/app.BtTg2P3N.js" rel="modulepreload">
 		<link href="/admin/_app/immutable/chunks/B2bEC_Hm.js" rel="modulepreload">
 		<link href="/admin/_app/immutable/chunks/Bb0e0sAP.js" rel="modulepreload">
 		<link href="/admin/_app/immutable/chunks/DtZk82gG.js" rel="modulepreload">
@@ -26,7 +26,7 @@
         <div style="display: contents">
 			<script>
 				{
-					__sveltekit_xb7lyo = {
+					__sveltekit_lsmon = {
 						base: "/admin",
 						assets: "/admin"
 					};
@@ -34,8 +34,8 @@
 					const element = document.currentScript.parentElement;
 
 					Promise.all([
-						import("/admin/_app/immutable/entry/start.BgMeGq-q.js"),
-						import("/admin/_app/immutable/entry/app.j1WHBlZX.js")
+						import("/admin/_app/immutable/entry/start.D21f0BIj.js"),
+						import("/admin/_app/immutable/entry/app.BtTg2P3N.js")
 					]).then(([kit, app]) => {
 						kit.start(app, element);
 					});

package/openapi.json

@@ -6027,6 +6027,17 @@
             "description": "Full-text search query",
             "name": "search",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Set to '0' or 'false' to skip the COUNT query. total is returned as null and hasMore still drives cursor pagination.",
+              "example": "0"
+            },
+            "required": false,
+            "description": "Set to '0' or 'false' to skip the COUNT query. total is returned as null and hasMore still drives cursor pagination.",
+            "name": "includeTotal",
+            "in": "query"
           }
         ],
         "responses": {
@@ -6548,6 +6559,86 @@
         }
       }
     },
+    "/api/db/{namespace}/transact": {
+      "post": {
+        "operationId": "dbSingleTransact",
+        "tags": [
+          "client"
+        ],
+        "summary": "Apply multi-table write operations atomically in a single-instance database",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "description": "Database namespace",
+              "example": "app"
+            },
+            "required": true,
+            "description": "Database namespace",
+            "name": "namespace",
+            "in": "path"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "operations": {
+                    "type": "array",
+                    "description": "Ordered operations applied atomically in one transaction. op: insert | update | delete | expect. insert: { table, op, data }. update: { table, op, id, data }. delete: { table, op, id }. expect: { table, op, id?, where?, exists } asserts row state and aborts the transaction with 409 when unmet.",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                },
+                "required": [
+                  "operations"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Ordered per-operation results",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": {}
+                      }
+                    }
+                  },
+                  "additionalProperties": {}
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation error (unknown table, malformed op, batch limit exceeded)"
+          },
+          "403": {
+            "description": "An access rule rejected one of the operations"
+          },
+          "409": {
+            "description": "An expect operation was not satisfied; transaction rolled back"
+          },
+          "501": {
+            "description": "Provider does not support multi-table transactions (d1/postgres)"
+          }
+        }
+      }
+    },
     "/api/db/{namespace}/{instanceId}/tables/{table}/count": {
       "get": {
         "operationId": "dbCountRecords",
@@ -7584,6 +7675,17 @@
             "description": "Full-text search query",
             "name": "search",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Set to '0' or 'false' to skip the COUNT query. total is returned as null and hasMore still drives cursor pagination.",
+              "example": "0"
+            },
+            "required": false,
+            "description": "Set to '0' or 'false' to skip the COUNT query. total is returned as null and hasMore still drives cursor pagination.",
+            "name": "includeTotal",
+            "in": "query"
           }
         ],
         "responses": {
@@ -8138,6 +8240,97 @@
         }
       }
     },
+    "/api/db/{namespace}/{instanceId}/transact": {
+      "post": {
+        "operationId": "dbTransact",
+        "tags": [
+          "client"
+        ],
+        "summary": "Apply multi-table write operations atomically in a dynamic database instance",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "description": "Database namespace",
+              "example": "app"
+            },
+            "required": true,
+            "description": "Database namespace",
+            "name": "namespace",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Database instance ID",
+              "example": "ws-456"
+            },
+            "required": true,
+            "description": "Database instance ID",
+            "name": "instanceId",
+            "in": "path"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "operations": {
+                    "type": "array",
+                    "description": "Ordered operations applied atomically in one transaction. op: insert | update | delete | expect. insert: { table, op, data }. update: { table, op, id, data }. delete: { table, op, id }. expect: { table, op, id?, where?, exists } asserts row state and aborts the transaction with 409 when unmet.",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                },
+                "required": [
+                  "operations"
+                ],
+                "additionalProperties": false
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Ordered per-operation results",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": {}
+                      }
+                    }
+                  },
+                  "additionalProperties": {}
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation error (unknown table, malformed op, batch limit exceeded)"
+          },
+          "403": {
+            "description": "An access rule rejected one of the operations"
+          },
+          "409": {
+            "description": "An expect operation was not satisfied; transaction rolled back"
+          },
+          "501": {
+            "description": "Provider does not support multi-table transactions (d1/postgres)"
+          }
+        }
+      }
+    },
     "/api/db/connect-check": {
       "get": {
         "operationId": "checkDatabaseSubscriptionConnection",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-base/server",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "EdgeBase runtime assets consumed by the EdgeBase CLI",
   "license": "MIT",
   "repository": {
@@ -34,8 +34,8 @@
     "jose": "^6.0.0",
     "pg": "^8.16.3",
     "zod": "^4.3.6",
-    "@edge-base/shared": "0.3.1",
-    "@edge-base/core": "0.3.1"
+    "@edge-base/core": "0.3.3",
+    "@edge-base/shared": "0.3.3"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.8.71",

package/src/__tests__/error-format.test.ts

@@ -263,6 +263,27 @@ describe('normalizeDatabaseError', () => {
     expect(err?.slug).toBe('constraint-failed');
   });
 
+  // PostgreSQL uses different constraint phrasings than SQLite/D1; the same
+  // normalizer must map them to the same slugs/status codes for provider parity.
+  it('maps PostgreSQL foreign key violations to the same 400 slug', () => {
+    const err = normalizeDatabaseError(
+      new Error('insert or update on table "posts" violates foreign key constraint "posts_author_id_fkey"'),
+    );
+    expect(err).toBeInstanceOf(EdgeBaseError);
+    expect(err?.code).toBe(400);
+    expect(err?.slug).toBe('foreign-key-failed');
+  });
+
+  it('maps PostgreSQL not-null violations to the constraint slug and extracts the column', () => {
+    const err = normalizeDatabaseError(
+      new Error('null value in column "email" of relation "users" violates not-null constraint'),
+    );
+    expect(err).toBeInstanceOf(EdgeBaseError);
+    expect(err?.code).toBe(400);
+    expect(err?.message).toContain("'email'");
+    expect(err?.slug).toBe('constraint-failed');
+  });
+
   it('returns null for blank string inputs', () => {
     expect(normalizeDatabaseError('   ')).toBeNull();
   });

package/src/__tests__/postgres-api-consistency.test.ts

@@ -0,0 +1,240 @@
+/**
+ * PostgreSQL handler ↔ D1/DO contract parity (single-record + search):
+ * - GET /search without a term → 200 { items: [] } (was 400)
+ * - PATCH {id} with an empty body → 200 existing record (was 400)
+ * - DELETE {id} → { deleted: true } (was { success: true, deleted: <row> })
+ * - validation failures carry only { code, message, data } (no legacy `errors`)
+ * - 403 rule-rejection wording matches the D1 handler
+ *
+ * Uses a mocked executor (same pattern as postgres-batch.test.ts).
+ */
+import { describe, expect, it, vi, afterEach } from 'vitest';
+import { defineConfig } from '@edge-base/shared';
+import { buildInternalHandlerContext } from '../lib/internal-request.js';
+import type { Env } from '../types.js';
+
+const CONFIG = defineConfig({
+  release: true,
+  databases: {
+    shared: {
+      provider: 'postgres',
+      connectionString: 'DB_POSTGRES_SHARED_URL',
+      tables: {
+        api_docs: {
+          schema: {
+            title: { type: 'string', required: true },
+            status: { type: 'string' },
+          },
+          access: {
+            read: () => true,
+            insert: () => true,
+            update: () => true,
+            delete: () => true,
+          },
+        },
+        // Auto timestamps disabled so an empty update body yields a genuinely
+        // empty change set (exercises the no-op early-return path).
+        api_notes: {
+          schema: {
+            title: { type: 'string', required: true },
+            createdAt: false,
+            updatedAt: false,
+          },
+          access: {
+            read: () => true,
+            insert: () => true,
+            update: () => true,
+            delete: () => true,
+          },
+        },
+      },
+    },
+  },
+});
+
+function makeEnv(): Env {
+  return {
+    EDGEBASE_CONFIG: CONFIG,
+    DB_POSTGRES_SHARED_URL: 'postgres://edgebase:test@localhost/shared',
+  } as unknown as Env;
+}
+
+function mockExecutorModule(
+  handler: (sql: string, params: unknown[]) => { rows: Record<string, unknown>[]; rowCount: number },
+) {
+  const calls: Array<{ sql: string; params: unknown[] }> = [];
+  vi.doMock('../lib/postgres-executor.js', () => ({
+    executePostgresQuery: vi.fn(),
+    ensureLocalDevPostgresSchema: vi.fn().mockResolvedValue(undefined),
+    withPostgresConnection: vi.fn(async (_cs: string, fn: (q: unknown) => Promise<unknown>) =>
+      fn(async (sql: string, params: unknown[] = []) => {
+        calls.push({ sql, params });
+        return handler(sql, params);
+      })),
+    getLocalDevPostgresExecOptions: vi.fn(() => undefined),
+    getProviderBindingName: () => 'DB_POSTGRES_SHARED',
+  }));
+  vi.doMock('../lib/postgres-schema-init.js', () => ({
+    ensurePgSchema: vi.fn().mockResolvedValue(undefined),
+  }));
+  return calls;
+}
+
+async function callPg(
+  method: string,
+  path: string,
+  { body, search, query, table = 'api_docs' }:
+    { body?: unknown; search?: string; query?: string; table?: string } = {},
+) {
+  const { handlePgRequest } = await import('../lib/postgres-handler.js');
+  const qs = search !== undefined
+    ? `?search=${encodeURIComponent(search)}`
+    : query !== undefined ? `?${query}` : '';
+  const url = `http://internal/api/db/shared${path}${qs}`;
+  const ctx = buildInternalHandlerContext({
+    env: makeEnv(),
+    request: new Request(url, {
+      method,
+      headers: { 'Content-Type': 'application/json', 'X-Is-Service-Key': 'true' },
+    }),
+    body: body as Record<string, unknown>,
+  });
+  return handlePgRequest(ctx as never, 'shared', table, path);
+}
+
+describe('postgres API consistency (D1/DO parity)', () => {
+  afterEach(() => {
+    vi.resetModules();
+    vi.clearAllMocks();
+    vi.unstubAllGlobals();
+  });
+
+  it('returns 200 { items: [] } when the search term is missing (no 400)', async () => {
+    const calls = mockExecutorModule(() => ({ rows: [], rowCount: 0 }));
+    const response = await callPg('GET', '/tables/api_docs/search');
+    expect(response.status).toBe(200);
+    expect(await response.json()).toEqual({ items: [] });
+    // Early return — no search query is issued.
+    expect(calls.some((c) => /ILIKE/i.test(c.sql))).toBe(false);
+  });
+
+  it('runs an ILIKE search over text fields when a term is provided', async () => {
+    const hit = { id: 'doc-1', title: 'hello world', status: 'open' };
+    const calls = mockExecutorModule((sql) => {
+      if (/ILIKE/i.test(sql) && !/COUNT/i.test(sql)) return { rows: [hit], rowCount: 1 };
+      if (/COUNT/i.test(sql)) return { rows: [{ total: 1 }], rowCount: 1 };
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('GET', '/tables/api_docs/search', { search: 'hello' });
+    expect(response.status).toBe(200);
+    const json = (await response.json()) as { items: unknown[]; total: number };
+    expect(json.items).toHaveLength(1);
+    expect(json.total).toBe(1);
+    // The search scans the schema's text columns (title, status), not just id.
+    const searchSql = calls.find((c) => /ILIKE/i.test(c.sql))?.sql ?? '';
+    expect(searchSql).toMatch(/"title"/);
+  });
+
+  it('returns the existing record with 200 for an empty update body (no 400)', async () => {
+    const existing = { id: 'note-1', title: 'Kept' };
+    const calls = mockExecutorModule((sql) => {
+      if (sql.startsWith('SELECT')) return { rows: [existing], rowCount: 1 };
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('PATCH', '/tables/api_notes/note-1', { body: {}, table: 'api_notes' });
+    expect(response.status).toBe(200);
+    const json = (await response.json()) as Record<string, unknown>;
+    expect(json.id).toBe('note-1');
+    expect(json.title).toBe('Kept');
+    // No UPDATE statement is executed for a no-op update.
+    expect(calls.some((c) => c.sql.startsWith('UPDATE'))).toBe(false);
+  });
+
+  it('returns { deleted: true } from a single-record delete', async () => {
+    const existing = { id: 'doc-1', title: 'Bye', status: 'open' };
+    mockExecutorModule((sql) => {
+      if (sql.startsWith('SELECT')) return { rows: [existing], rowCount: 1 };
+      if (sql.startsWith('DELETE')) return { rows: [existing], rowCount: 1 };
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('DELETE', '/tables/api_docs/doc-1');
+    expect(response.status).toBe(200);
+    expect(await response.json()).toEqual({ deleted: true });
+  });
+
+  it('omits the legacy `errors` field from validation failures', async () => {
+    mockExecutorModule(() => ({ rows: [], rowCount: 0 }));
+    // Missing required `title`.
+    const response = await callPg('POST', '/tables/api_docs', { body: { status: 'open' } });
+    expect(response.status).toBe(400);
+    const json = (await response.json()) as Record<string, unknown>;
+    expect(json.data).toBeDefined();
+    expect(json).not.toHaveProperty('errors');
+  });
+
+  it('lists records with a total count', async () => {
+    mockExecutorModule((sql) => {
+      if (/COUNT/i.test(sql)) return { rows: [{ total: 2 }], rowCount: 1 };
+      if (sql.startsWith('SELECT')) {
+        return { rows: [{ id: 'a', title: 'A' }, { id: 'b', title: 'B' }], rowCount: 2 };
+      }
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('GET', '/tables/api_docs');
+    expect(response.status).toBe(200);
+    const json = (await response.json()) as { items: unknown[]; total: number };
+    expect(json.items).toHaveLength(2);
+    expect(json.total).toBe(2);
+  });
+
+  it('skips the COUNT query when includeTotal=0 (total is null)', async () => {
+    const calls = mockExecutorModule((sql) => {
+      if (sql.startsWith('SELECT')) return { rows: [{ id: 'a', title: 'A' }], rowCount: 1 };
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('GET', '/tables/api_docs', { query: 'includeTotal=0' });
+    expect(response.status).toBe(200);
+    const json = (await response.json()) as { items: unknown[]; total: number | null };
+    expect(json.items).toHaveLength(1);
+    expect(json.total).toBeNull();
+    expect(calls.some((c) => /COUNT/i.test(c.sql))).toBe(false);
+  });
+
+  it('gets a single record by id', async () => {
+    mockExecutorModule((sql) => {
+      if (sql.startsWith('SELECT')) return { rows: [{ id: 'doc-1', title: 'Hi' }], rowCount: 1 };
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('GET', '/tables/api_docs/doc-1');
+    expect(response.status).toBe(200);
+    expect((await response.json() as { id: string }).id).toBe('doc-1');
+  });
+
+  it('returns 404 for a missing record', async () => {
+    mockExecutorModule(() => ({ rows: [], rowCount: 0 }));
+    const response = await callPg('GET', '/tables/api_docs/nope');
+    expect(response.status).toBe(404);
+  });
+
+  it('counts records', async () => {
+    mockExecutorModule((sql) => {
+      if (/COUNT/i.test(sql)) return { rows: [{ total: 7 }], rowCount: 1 };
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('GET', '/tables/api_docs/count');
+    expect(response.status).toBe(200);
+    expect((await response.json() as { total: number }).total).toBe(7);
+  });
+
+  it('inserts a record and returns it', async () => {
+    mockExecutorModule((sql) => {
+      if (sql.startsWith('INSERT')) {
+        return { rows: [{ id: 'new-1', title: 'Fresh', status: 'open' }], rowCount: 1 };
+      }
+      return { rows: [], rowCount: 0 };
+    });
+    const response = await callPg('POST', '/tables/api_docs', { body: { title: 'Fresh' } });
+    expect([200, 201]).toContain(response.status);
+    expect((await response.json() as { title: string }).title).toBe('Fresh');
+  });
+});

package/src/__tests__/postgres-batch-compat.test.ts

@@ -11,31 +11,33 @@ describe('postgres batch compatibility', () => {
   });
 
   it('accepts D1-style batch inserts for upsertMany and returns inserted rows', async () => {
-    const executePostgresQuery = vi.fn()
-      .mockResolvedValueOnce({
-        rows: [{
-          id: 'probe-1',
-          probeKey: 'probe-a',
-          phase: 'batch',
-          sourceProvider: 'neon',
-          targetProvider: 'neon',
-          checksum: 'checksum-a',
-          verified: false,
-        }],
-        rowCount: 1,
-      })
-      .mockResolvedValueOnce({
-        rows: [{
-          id: 'probe-2',
-          probeKey: 'probe-b',
-          phase: 'batch',
-          sourceProvider: 'neon',
-          targetProvider: 'neon',
-          checksum: 'checksum-b',
-          verified: false,
-        }],
-        rowCount: 1,
-      });
+    let insertCount = 0;
+    const insertRows = [
+      {
+        id: 'probe-1',
+        probeKey: 'probe-a',
+        phase: 'batch',
+        sourceProvider: 'neon',
+        targetProvider: 'neon',
+        checksum: 'checksum-a',
+        verified: false,
+      },
+      {
+        id: 'probe-2',
+        probeKey: 'probe-b',
+        phase: 'batch',
+        sourceProvider: 'neon',
+        targetProvider: 'neon',
+        checksum: 'checksum-b',
+        verified: false,
+      },
+    ];
+    const executePostgresQuery = vi.fn(async (_cs: string, sql: string, _params?: unknown[]) => {
+      if (sql.startsWith('INSERT INTO')) {
+        return { rows: [insertRows[insertCount++]], rowCount: 1 };
+      }
+      return { rows: [], rowCount: 0 };
+    });
 
     vi.doMock('../lib/postgres-executor.js', () => ({
       executePostgresQuery,
@@ -126,8 +128,12 @@ describe('postgres batch compatibility', () => {
     expect(response.status).toBe(200);
     expect(json.inserted).toHaveLength(2);
     expect(json.items).toHaveLength(2);
-    expect(executePostgresQuery).toHaveBeenCalledTimes(2);
-    const firstSql = executePostgresQuery.mock.calls[0][1] as string;
+    // Batch inserts are wrapped in a single BEGIN/COMMIT transaction.
+    const sqls = executePostgresQuery.mock.calls.map((call) => call[1] as string);
+    expect(sqls[0]).toBe('BEGIN');
+    expect(sqls[sqls.length - 1]).toBe('COMMIT');
+    expect(sqls.filter((sql) => sql.startsWith('INSERT INTO'))).toHaveLength(2);
+    const firstSql = sqls.find((sql) => sql.startsWith('INSERT INTO'))!;
     expect(firstSql).toContain('ON CONFLICT ("probeKey") DO UPDATE');
   });
 });