@edge-base/server 0.2.1 → 0.2.3

package/admin-build/_app/immutable/nodes/{9.BLDLX5hV.js → 9.C2Ub82wn.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/CqUxCvs_.js";import{a as F,f as I}from"../chunks/DEELgv7K.js";import{s as Y}from"../chunks/CoI6jjbg.js";import{P as Z}from"../chunks/B8s_s9QY.js";import{a as tt}from"../chunks/Q2nPFxS6.js";import{M as _,T as et}from"../chunks/k0CIJkw4.js";import{D as at,T as rt}from"../chunks/DjOEv9M9.js";var nt=I("<button> </button>"),st=I('<div class="range-selector"></div>'),ot=I('<div class="analytics-grid"><!> <!> <!> <!></div> <div class="analytics-chart"><!></div> <div class="analytics-bottom"><!> <!></div>',1);function bt(w,M){j(M,!0);let s=D(!0),o=D(null),p=D("24h");const T=[{value:"1h",label:"1H"},{value:"6h",label:"6H"},{value:"24h",label:"24H"},{value:"7d",label:"7D"},{value:"30d",label:"30D"}],k=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(k)()}`);y(o,e,!0)}catch(e){V(e instanceof Error?e.message:"Failed to load functions analytics")}finally{y(s,!1)}}function A(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`}))});Z(w,{title:"Functions Analytics",description:"Serverless function execution and performance metrics",get docsHref(){return tt},actions:a=>{var c=st();W(c,21,()=>T,X,(f,d)=>{var l=nt();let v;var h=b(l,!0);g(l),J(()=>{v=Y(l,1,"range-btn",null,v,{"range-btn--active":t(p)===t(d).value}),N(h,t(d).label)}),O("click",l,()=>A(t(d).value)),F(f,l)}),g(c),F(a,c)},children:(a,c)=>{var f=ot(),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)());et(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)());at(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)());rt(S,{get items(){return t(r)},title:"Top Functions",get loading(){return t(s)}})}g(R),F(a,f)}}),z()}K(["click"]);export{bt 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/Dc1-6Po6.js";import{a as F,f as I}from"../chunks/DEELgv7K.js";import{s as Y}from"../chunks/CoI6jjbg.js";import{P as Z}from"../chunks/B8s_s9QY.js";import{a as tt}from"../chunks/Q2nPFxS6.js";import{M as _,T as et}from"../chunks/CzSAxmuj.js";import{D as at,T as rt}from"../chunks/A_3UuvCe.js";var nt=I("<button> </button>"),st=I('<div class="range-selector"></div>'),ot=I('<div class="analytics-grid"><!> <!> <!> <!></div> <div class="analytics-chart"><!></div> <div class="analytics-bottom"><!> <!></div>',1);function bt(w,M){j(M,!0);let s=D(!0),o=D(null),p=D("24h");const T=[{value:"1h",label:"1H"},{value:"6h",label:"6H"},{value:"24h",label:"24H"},{value:"7d",label:"7D"},{value:"30d",label:"30D"}],k=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(k)()}`);y(o,e,!0)}catch(e){V(e instanceof Error?e.message:"Failed to load functions analytics")}finally{y(s,!1)}}function A(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`}))});Z(w,{title:"Functions Analytics",description:"Serverless function execution and performance metrics",get docsHref(){return tt},actions:a=>{var c=st();W(c,21,()=>T,X,(f,d)=>{var l=nt();let v;var h=b(l,!0);g(l),J(()=>{v=Y(l,1,"range-btn",null,v,{"range-btn--active":t(p)===t(d).value}),N(h,t(d).label)}),O("click",l,()=>A(t(d).value)),F(f,l)}),g(c),F(a,c)},children:(a,c)=>{var f=ot(),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)());et(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)());at(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)());rt(S,{get items(){return t(r)},title:"Top Functions",get loading(){return t(s)}})}g(R),F(a,f)}}),z()}K(["click"]);export{bt as component};

package/admin-build/_app/version.json

@@ -1 +1 @@
-{"version":"1774248496864"}
+{"version":"1774317332252"}

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.zXCirpgY.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/chunks/m9QZTyVV.js" rel="modulepreload">
+        <link href="/admin/_app/immutable/entry/start.l1WvHznQ.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/chunks/byv2rTy8.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/D755Tqat.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/entry/app.BTsq3_xq.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/chunks/DiyBpamp.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/entry/app.CfrmEXPD.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_1vwf6db = {
+					__sveltekit_1thdx8y = {
 						base: "/admin",
 						assets: "/admin"
 					};
@@ -34,8 +34,8 @@
 					const element = document.currentScript.parentElement;
 
 					Promise.all([
-						import("/admin/_app/immutable/entry/start.zXCirpgY.js"),
-						import("/admin/_app/immutable/entry/app.BTsq3_xq.js")
+						import("/admin/_app/immutable/entry/start.l1WvHznQ.js"),
+						import("/admin/_app/immutable/entry/app.CfrmEXPD.js")
 					]).then(([kit, app]) => {
 						kit.start(app, element);
 					});

package/package.json

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

package/src/__tests__/d1-live-broadcast-verification.test.ts

@@ -0,0 +1,271 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { defineConfig } from '@edge-base/shared';
+import { buildInternalHandlerContext } from '../lib/internal-request.js';
+import type { Env } from '../types.js';
+
+function createInsertMockD1(row: Record<string, unknown>): D1Database {
+  return {
+    prepare(sql: string) {
+      const state = { bindings: [] as unknown[] };
+      const stmt = {
+        bind: (...values: unknown[]) => {
+          state.bindings = values;
+          return stmt;
+        },
+        all: async () => {
+          if (sql.startsWith('INSERT INTO')) {
+            return { results: [], meta: { changes: 1 } };
+          }
+          if (sql.startsWith('SELECT * FROM')) {
+            return { results: [row], meta: { changes: 0 } };
+          }
+          throw new Error(`Unexpected SQL: ${sql}`);
+        },
+      };
+      return stmt;
+    },
+  } as unknown as D1Database;
+}
+
+function createBatchInsertMockD1(rowsById: Record<string, Record<string, unknown>>): D1Database {
+  return {
+    prepare(sql: string) {
+      const state = { bindings: [] as unknown[] };
+      const stmt = {
+        _sql: sql,
+        bind: (...values: unknown[]) => {
+          state.bindings = values;
+          return stmt;
+        },
+        all: async () => {
+          if (!sql.startsWith('SELECT * FROM')) {
+            throw new Error(`Unexpected SQL: ${sql}`);
+          }
+          const id = String(state.bindings[0]);
+          return {
+            results: rowsById[id] ? [rowsById[id]] : [],
+            meta: { changes: 0 },
+          };
+        },
+      };
+      return stmt;
+    },
+    batch: async () => [],
+  } as unknown as D1Database;
+}
+
+function createEnv(db: D1Database): Env {
+  return {
+    EDGEBASE_CONFIG: defineConfig({
+      release: true,
+      databases: {
+        shared: {
+          tables: {
+            posts: {
+              schema: {
+                title: { type: 'string', required: true },
+              },
+            },
+          },
+        },
+      },
+    }),
+    DB_D1_SHARED: db,
+    DATABASE: {} as DurableObjectNamespace,
+    AUTH: {} as DurableObjectNamespace,
+    KV: {} as KVNamespace,
+  } as unknown as Env;
+}
+
+describe('d1 live broadcast verification', () => {
+  afterEach(() => {
+    vi.resetModules();
+    vi.clearAllMocks();
+    vi.unstubAllGlobals();
+  });
+
+  it('returns single-record insert responses without waiting for emitDbLiveEvent', async () => {
+    let resolveEmit!: () => void;
+    const emitGate = new Promise<void>((resolve) => {
+      resolveEmit = resolve;
+    });
+    const emitDbLiveEvent = vi.fn(() => emitGate);
+    const emitDbLiveBatchEvent = vi.fn().mockResolvedValue(undefined);
+    const sendToDatabaseLiveDO = vi.fn().mockResolvedValue(undefined);
+    const executeDbTriggers = vi.fn().mockResolvedValue(undefined);
+
+    vi.doMock('../lib/d1-schema-init.js', () => ({
+      ensureD1Schema: vi.fn().mockResolvedValue(undefined),
+    }));
+    vi.doMock('../lib/database-live-emitter.js', () => ({
+      emitDbLiveEvent,
+      emitDbLiveBatchEvent,
+      sendToDatabaseLiveDO,
+    }));
+    vi.doMock('../lib/functions.js', () => ({
+      executeDbTriggers,
+    }));
+
+    const { handleD1Request } = await import('../lib/d1-handler.js');
+
+    const env = createEnv(createInsertMockD1({ id: 'post-1', title: 'hello world' }));
+    const waitUntil = vi.fn();
+    const ctx = buildInternalHandlerContext({
+      env,
+      executionCtx: { waitUntil } as unknown as ExecutionContext,
+      request: new Request('http://internal/api/db/shared/tables/posts', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-Is-Service-Key': 'true',
+        },
+      }),
+      body: {
+        id: 'post-1',
+        title: 'hello world',
+      },
+    });
+
+    let settled = false;
+    const responsePromise = handleD1Request(ctx, 'shared', 'posts', '/tables/posts').then((response) => {
+      settled = true;
+      return response;
+    });
+
+    await vi.waitFor(() => {
+      expect(emitDbLiveEvent).toHaveBeenCalledTimes(1);
+    });
+    await vi.waitFor(() => {
+      expect(settled).toBe(true);
+    });
+
+    const response = await responsePromise;
+    const json = await response.json() as Record<string, unknown>;
+
+    expect(response.status).toBe(201);
+    expect(json).toMatchObject({ id: 'post-1', title: 'hello world' });
+    expect(waitUntil).toHaveBeenCalled();
+
+    resolveEmit();
+  });
+
+  it('sends small batches through a single background Promise.all instead of awaiting fan-out', async () => {
+    let resolveFanOut!: () => void;
+    const fanOutGate = new Promise<void>((resolve) => {
+      resolveFanOut = resolve;
+    });
+    const emitDbLiveEvent = vi.fn(() => fanOutGate);
+    const emitDbLiveBatchEvent = vi.fn().mockResolvedValue(undefined);
+    const sendToDatabaseLiveDO = vi.fn().mockResolvedValue(undefined);
+
+    vi.doMock('../lib/d1-schema-init.js', () => ({
+      ensureD1Schema: vi.fn().mockResolvedValue(undefined),
+    }));
+    vi.doMock('../lib/database-live-emitter.js', () => ({
+      emitDbLiveEvent,
+      emitDbLiveBatchEvent,
+      sendToDatabaseLiveDO,
+    }));
+    vi.doMock('../lib/functions.js', () => ({
+      executeDbTriggers: vi.fn().mockResolvedValue(undefined),
+    }));
+
+    const { handleD1Request } = await import('../lib/d1-handler.js');
+
+    const rowsById = {
+      'post-1': { id: 'post-1', title: 'post 1' },
+      'post-2': { id: 'post-2', title: 'post 2' },
+    };
+    const env = createEnv(createBatchInsertMockD1(rowsById));
+    const waitUntil = vi.fn();
+    const ctx = buildInternalHandlerContext({
+      env,
+      executionCtx: { waitUntil } as unknown as ExecutionContext,
+      request: new Request('http://internal/api/db/shared/tables/posts/batch', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-Is-Service-Key': 'true',
+        },
+      }),
+      body: {
+        inserts: Object.values(rowsById),
+      },
+    });
+
+    let settled = false;
+    const responsePromise = handleD1Request(ctx, 'shared', 'posts', '/tables/posts/batch').then((response) => {
+      settled = true;
+      return response;
+    });
+
+    await vi.waitFor(() => {
+      expect(emitDbLiveEvent).toHaveBeenCalledTimes(2);
+    });
+    await vi.waitFor(() => {
+      expect(settled).toBe(true);
+    });
+
+    const response = await responsePromise;
+    const json = await response.json() as { inserted: Array<Record<string, unknown>> };
+
+    expect(response.status).toBe(200);
+    expect(json.inserted).toHaveLength(2);
+    expect(emitDbLiveBatchEvent).not.toHaveBeenCalled();
+    expect(waitUntil).toHaveBeenCalledTimes(1);
+
+    resolveFanOut();
+  });
+
+  it('still sends 10+ change batches through waitUntil instead of awaiting the batch emitter', async () => {
+    const emitDbLiveEvent = vi.fn().mockResolvedValue(undefined);
+    const emitDbLiveBatchEvent = vi.fn(() => new Promise<void>(() => {}));
+    const sendToDatabaseLiveDO = vi.fn().mockResolvedValue(undefined);
+
+    vi.doMock('../lib/d1-schema-init.js', () => ({
+      ensureD1Schema: vi.fn().mockResolvedValue(undefined),
+    }));
+    vi.doMock('../lib/database-live-emitter.js', () => ({
+      emitDbLiveEvent,
+      emitDbLiveBatchEvent,
+      sendToDatabaseLiveDO,
+    }));
+    vi.doMock('../lib/functions.js', () => ({
+      executeDbTriggers: vi.fn().mockResolvedValue(undefined),
+    }));
+
+    const { handleD1Request } = await import('../lib/d1-handler.js');
+
+    const rowsById = Object.fromEntries(
+      Array.from({ length: 10 }, (_value, index) => {
+        const id = `post-${index + 1}`;
+        return [id, { id, title: `post ${index + 1}` }];
+      }),
+    );
+    const env = createEnv(createBatchInsertMockD1(rowsById));
+    const waitUntil = vi.fn();
+    const ctx = buildInternalHandlerContext({
+      env,
+      executionCtx: { waitUntil } as unknown as ExecutionContext,
+      request: new Request('http://internal/api/db/shared/tables/posts/batch', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-Is-Service-Key': 'true',
+        },
+      }),
+      body: {
+        inserts: Object.values(rowsById),
+      },
+    });
+
+    const response = await handleD1Request(ctx, 'shared', 'posts', '/tables/posts/batch');
+    const json = await response.json() as { inserted: Array<Record<string, unknown>> };
+
+    expect(response.status).toBe(200);
+    expect(json.inserted).toHaveLength(10);
+    expect(emitDbLiveBatchEvent).toHaveBeenCalledTimes(1);
+    expect(emitDbLiveEvent).not.toHaveBeenCalled();
+    expect(waitUntil).toHaveBeenCalledTimes(1);
+  });
+});

package/src/__tests__/database-live-do.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it, vi } from 'vitest';
+
+vi.mock('cloudflare:workers', () => ({
+  DurableObject: class DurableObject {
+    ctx: unknown;
+    env: unknown;
+
+    constructor(ctx: unknown, env: unknown) {
+      this.ctx = ctx;
+      this.env = env;
+    }
+  },
+}));
+
+describe('DatabaseLiveDO delivery idempotency', () => {
+  it('ignores duplicate internal change events with the same deliveryId', async () => {
+    const { DatabaseLiveDO } = await import('../durable-objects/database-live-do.js');
+
+    const ctx = {
+      acceptWebSocket: vi.fn(),
+      getWebSockets: vi.fn(() => []),
+      getTags: vi.fn(() => []),
+    } as any;
+    const live = new DatabaseLiveDO(ctx, {} as any) as any;
+    live.broadcastWithFilters = vi.fn().mockResolvedValue(undefined);
+
+    const payload = {
+      deliveryId: 'delivery-1',
+      type: 'modified',
+      channel: 'dblive:shared:posts',
+      table: 'posts',
+      docId: 'post-1',
+      data: { id: 'post-1', title: 'hello' },
+      timestamp: '2026-03-24T00:00:00.000Z',
+    };
+
+    const first = await live.handleInternalEvent(new Request('http://internal/internal/event', {
+      method: 'POST',
+      body: JSON.stringify(payload),
+    }));
+    const second = await live.handleInternalEvent(new Request('http://internal/internal/event', {
+      method: 'POST',
+      body: JSON.stringify(payload),
+    }));
+
+    await expect(first.json()).resolves.toEqual({ ok: true });
+    await expect(second.json()).resolves.toEqual({ ok: true, duplicate: true });
+    expect(live.broadcastWithFilters).toHaveBeenCalledTimes(1);
+  });
+});

package/src/__tests__/database-live-emitter.test.ts

@@ -1,5 +1,11 @@
 import { describe, expect, it, vi } from 'vitest';
-import { buildDbLiveChannel, emitDbLiveBatchEvent, emitDbLiveEvent } from '../lib/database-live-emitter.js';
+import {
+  buildDbLiveChannel,
+  emitDbLiveBatchEvent,
+  emitDbLiveEvent,
+  isDbLiveChannel,
+  sendToDatabaseLiveDO,
+} from '../lib/database-live-emitter.js';
 
 describe('buildDbLiveChannel', () => {
   it('builds shared table channels with namespace', () => {
@@ -13,6 +19,24 @@ describe('buildDbLiveChannel', () => {
   });
 });
 
+describe('isDbLiveChannel', () => {
+  it('accepts valid db-live table and document channels', () => {
+    expect(isDbLiveChannel('dblive:shared:posts')).toBe(true);
+    expect(isDbLiveChannel('dblive:shared:posts:post-1')).toBe(true);
+    expect(isDbLiveChannel('dblive:workspace:ws-1:posts')).toBe(true);
+    expect(isDbLiveChannel('dblive:workspace:ws-1:posts:post-1')).toBe(true);
+  });
+
+  it('rejects non-db-live, presence, broadcast, malformed, and empty-segment channels', () => {
+    expect(isDbLiveChannel('presence:shared:posts')).toBe(false);
+    expect(isDbLiveChannel('dblive:presence:posts')).toBe(false);
+    expect(isDbLiveChannel('dblive:broadcast:posts')).toBe(false);
+    expect(isDbLiveChannel('dblive:shared')).toBe(false);
+    expect(isDbLiveChannel('dblive:one:two:three:four:five')).toBe(false);
+    expect(isDbLiveChannel('dblive:shared::posts')).toBe(false);
+  });
+});
+
 describe('database-live emitter', () => {
   it('emits shared-table events to namespace-aware table and doc channels', async () => {
     const fetch = vi.fn().mockResolvedValue(new Response(null, { status: 200 }));
@@ -53,4 +77,95 @@ describe('database-live emitter', () => {
     const payload = JSON.parse(fetch.mock.calls[0]![1].body as string);
     expect(payload.channel).toBe('dblive:workspace:ws-9:documents');
   });
+
+  it('rejects when the database-live DO responds with a server error', async () => {
+    const fetch = vi.fn().mockResolvedValue(new Response(null, { status: 500 }));
+    const env = {
+      DATABASE_LIVE: {
+        idFromName: vi.fn((name: string) => name),
+        get: vi.fn().mockReturnValue({ fetch }),
+      },
+    } as any;
+
+    await expect(
+      emitDbLiveEvent(env, 'shared', 'posts', 'modified', 'post-1', { id: 'post-1' }),
+    ).rejects.toThrow(/DatabaseLiveDO .* failed with 500/);
+
+    expect(fetch).toHaveBeenCalledTimes(4);
+  });
+
+  it('skips the document fan-out for bulk events', async () => {
+    const fetch = vi.fn().mockResolvedValue(new Response(null, { status: 200 }));
+    const env = {
+      DATABASE_LIVE: {
+        idFromName: vi.fn((name: string) => name),
+        get: vi.fn().mockReturnValue({ fetch }),
+      },
+    } as any;
+
+    await emitDbLiveEvent(env, 'shared', 'posts', 'removed', '_bulk', { action: 'delete', count: 3 });
+
+    expect(fetch).toHaveBeenCalledTimes(1);
+    const payload = JSON.parse(fetch.mock.calls[0]![1].body as string);
+    expect(payload.channel).toBe('dblive:shared:posts');
+  });
+
+  it('returns early when DATABASE_LIVE is not configured', async () => {
+    await expect(
+      sendToDatabaseLiveDO({} as any, { channel: 'dblive:shared:posts', event: 'refresh' }),
+    ).resolves.toBeUndefined();
+  });
+
+  it('reuses the same deliveryId across retries for a single handoff', async () => {
+    const fetch = vi.fn()
+      .mockResolvedValueOnce(new Response(null, { status: 500 }))
+      .mockResolvedValueOnce(new Response(null, { status: 200 }));
+    const env = {
+      DATABASE_LIVE: {
+        idFromName: vi.fn((name: string) => name),
+        get: vi.fn().mockReturnValue({ fetch }),
+      },
+    } as any;
+
+    await sendToDatabaseLiveDO(env, { channel: 'dblive:shared:posts', event: 'refresh' }, '/internal/broadcast');
+
+    expect(fetch).toHaveBeenCalledTimes(2);
+    const firstBody = JSON.parse(fetch.mock.calls[0]![1].body as string);
+    const secondBody = JSON.parse(fetch.mock.calls[1]![1].body as string);
+    expect(firstBody.deliveryId).toBeTruthy();
+    expect(firstBody.deliveryId).toBe(secondBody.deliveryId);
+  });
+
+  it('keeps an existing deliveryId instead of generating a new one', async () => {
+    const fetch = vi.fn().mockResolvedValue(new Response(null, { status: 200 }));
+    const env = {
+      DATABASE_LIVE: {
+        idFromName: vi.fn((name: string) => name),
+        get: vi.fn().mockReturnValue({ fetch }),
+      },
+    } as any;
+
+    await sendToDatabaseLiveDO(env, {
+      channel: 'dblive:shared:posts',
+      deliveryId: 'delivery-fixed',
+      event: 'refresh',
+    });
+
+    const body = JSON.parse(fetch.mock.calls[0]![1].body as string);
+    expect(body.deliveryId).toBe('delivery-fixed');
+  });
+
+  it('throws a generic error when retries fail with a non-Error value', async () => {
+    const fetch = vi.fn().mockRejectedValue('boom');
+    const env = {
+      DATABASE_LIVE: {
+        idFromName: vi.fn((name: string) => name),
+        get: vi.fn().mockReturnValue({ fetch }),
+      },
+    } as any;
+
+    await expect(
+      sendToDatabaseLiveDO(env, { channel: 'dblive:shared:posts', event: 'refresh' }),
+    ).rejects.toThrow('DatabaseLiveDO delivery failed.');
+  });
 });

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

@@ -154,6 +154,13 @@ describe('hookRejectedError', () => {
     expect(hookRejectedError(original)).toBe(original);
   });
 
+  it('uses the fallback message and hook prefix for unauthorized non-Error rejections', () => {
+    const err = hookRejectedError('plain failure', 'Authentication required', 'beforeSave');
+    expect(err.code).toBe(401);
+    expect(err.message).toBe("Hook 'beforeSave' rejected: Authentication required");
+    expect(err.slug).toBe('hook-rejected');
+  });
+
   it('maps ownership denial messages to 403', () => {
     const err = hookRejectedError(new Error('Only owners can update this record.'));
     expect(err.code).toBe(403);
@@ -171,6 +178,18 @@ describe('hookRejectedError', () => {
     expect(err.code).toBe(409);
   });
 
+  it('maps not-found style messages to 404', () => {
+    const err = hookRejectedError(new Error('Unknown project id.'));
+    expect(err.code).toBe(404);
+    expect(err.message).toBe('Unknown project id.');
+  });
+
+  it('maps rate-limit style messages to 429', () => {
+    const err = hookRejectedError(new Error('Too many uploads, throttled.'));
+    expect(err.code).toBe(429);
+    expect(err.slug).toBe('hook-rejected');
+  });
+
   it('falls back to validation errors for unknown hook failures', () => {
     const err = hookRejectedError(new Error('Custom hook failure.'));
     expect(err.code).toBe(400);
@@ -179,6 +198,11 @@ describe('hookRejectedError', () => {
 });
 
 describe('normalizeDatabaseError', () => {
+  it('passes EdgeBaseError instances through untouched', () => {
+    const original = validationError('Already normalized');
+    expect(normalizeDatabaseError(original)).toBe(original);
+  });
+
   it('maps foreign key failures to validation errors', () => {
     const err = normalizeDatabaseError(new Error('D1_ERROR: FOREIGN KEY constraint failed: SQLITE_CONSTRAINT'));
     expect(err).toBeInstanceOf(EdgeBaseError);
@@ -187,6 +211,13 @@ describe('normalizeDatabaseError', () => {
     expect(err?.slug).toBe('foreign-key-failed');
   });
 
+  it('maps foreign key failures without a detected column to the generic message', () => {
+    const err = normalizeDatabaseError('FOREIGN KEY constraint failed');
+    expect(err).toBeInstanceOf(EdgeBaseError);
+    expect(err?.code).toBe(400);
+    expect(err?.message).toContain('Check that all foreign key references');
+  });
+
   it('maps foreign key failures from cross-realm error-like objects', () => {
     const err = normalizeDatabaseError({
       message: 'D1_ERROR: FOREIGN KEY constraint failed: SQLITE_CONSTRAINT',
@@ -204,6 +235,38 @@ describe('normalizeDatabaseError', () => {
     expect(err?.slug).toBe('record-already-exists');
   });
 
+  it('maps unique constraint failures without a parsed column to a generic conflict message', () => {
+    const err = normalizeDatabaseError('UNIQUE constraint failed');
+    expect(err).toBeInstanceOf(EdgeBaseError);
+    expect(err?.code).toBe(409);
+    expect(err?.message).toBe('Record already exists. A unique constraint was violated.');
+  });
+
+  it('maps not-null constraint failures to validation errors', () => {
+    const err = normalizeDatabaseError(new Error('NOT NULL constraint failed: users.email'));
+    expect(err).toBeInstanceOf(EdgeBaseError);
+    expect(err?.code).toBe(400);
+    expect(err?.message).toContain("'email'");
+    expect(err?.slug).toBe('constraint-failed');
+  });
+
+  it('maps cause-only check constraint failures to a generic validation error', () => {
+    const err = normalizeDatabaseError({
+      message: 'outer wrapper',
+      cause: {
+        message: 'check constraint failed',
+      },
+    });
+    expect(err).toBeInstanceOf(EdgeBaseError);
+    expect(err?.code).toBe(400);
+    expect(err?.message).toBe('Request violates a database constraint. Ensure all required fields are provided.');
+    expect(err?.slug).toBe('constraint-failed');
+  });
+
+  it('returns null for blank string inputs', () => {
+    expect(normalizeDatabaseError('   ')).toBeNull();
+  });
+
   it('returns null for unrelated runtime errors', () => {
     expect(normalizeDatabaseError(new Error('socket hang up'))).toBeNull();
   });