@edge-base/server 0.2.2 → 0.2.4

package/admin-build/_app/immutable/nodes/{9.Dddmd7_F.js → 9.DOkvfmir.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/g3ZZdY-r.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/C85dMlzL.js";import{D as at,T as rt}from"../chunks/BWyDPAjM.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/C6lpZLE2.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/5RQRbp5q.js";import{D as at,T as rt}from"../chunks/BgDzp0i0.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":"1774256743573"}
+{"version":"1774395752593"}

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.Mr9mmopc.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/chunks/qiZXAKh-.js" rel="modulepreload">
+        <link href="/admin/_app/immutable/entry/start.CtsqDyfj.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/chunks/D__dwMuW.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/5PDcRlfX.js" rel="modulepreload">
-		<link href="/admin/_app/immutable/entry/app.BZxfavhF.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/chunks/DBsVqhuh.js" rel="modulepreload">
+		<link href="/admin/_app/immutable/entry/app.C8ylfBe6.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_1ddhohc = {
+					__sveltekit_x4yv2o = {
 						base: "/admin",
 						assets: "/admin"
 					};
@@ -34,8 +34,8 @@
 					const element = document.currentScript.parentElement;
 
 					Promise.all([
-						import("/admin/_app/immutable/entry/start.Mr9mmopc.js"),
-						import("/admin/_app/immutable/entry/app.BZxfavhF.js")
+						import("/admin/_app/immutable/entry/start.CtsqDyfj.js"),
+						import("/admin/_app/immutable/entry/app.C8ylfBe6.js")
 					]).then(([kit, app]) => {
 						kit.start(app, element);
 					});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-base/server",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "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.2.2",
-    "@edge-base/core": "0.2.2"
+    "@edge-base/core": "0.2.4",
+    "@edge-base/shared": "0.2.4"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.8.71",

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

@@ -165,6 +165,35 @@ describe('admin data routes', () => {
     });
   });
 
+  it('rejects instanceId query params for single-instance record browsing', async () => {
+    setConfig(
+      createConfig({
+        shared: {
+          tables: {
+            posts: { schema: { title: { type: 'string' } } },
+          },
+        },
+      }),
+    );
+
+    const app = createApp();
+    const response = await app.request(
+      '/admin/api/data/tables/posts/records?instanceId=shadow',
+      {
+        headers: {
+          'X-EdgeBase-Service-Key': 'sk-root',
+        },
+      },
+      {} as Env,
+    );
+
+    expect(response.status).toBe(400);
+    await expect(response.json()).resolves.toMatchObject({
+      code: 400,
+      message: "instanceId is not allowed for single-instance namespace 'shared'",
+    });
+  });
+
   it('routes dynamic record browsing to the scoped DO when instanceId is provided', async () => {
     setConfig(
       createConfig({

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-do-route-validation.test.ts

@@ -0,0 +1,105 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { defineConfig } from '@edge-base/shared';
+import { setConfig } from '../lib/do-router.js';
+
+vi.mock('cloudflare:workers', () => ({
+  DurableObject: class DurableObject {
+    ctx: unknown;
+    env: unknown;
+
+    constructor(ctx: unknown, env: unknown) {
+      this.ctx = ctx;
+      this.env = env;
+    }
+  },
+}));
+
+function createCtx() {
+  return {
+    storage: {
+      sql: {
+        exec: vi.fn(),
+      },
+    },
+    waitUntil: vi.fn(),
+  } as unknown as DurableObjectState;
+}
+
+function createEnv() {
+  return {
+    DATABASE_LIVE: {} as DurableObjectNamespace,
+    DATABASE: {} as DurableObjectNamespace,
+    AUTH: {} as DurableObjectNamespace,
+  };
+}
+
+describe('DatabaseDO route validation', () => {
+  afterEach(() => {
+    setConfig({});
+  });
+
+  it('rejects id-suffixed doNames for single-instance namespaces', async () => {
+    setConfig(defineConfig({
+      release: true,
+      databases: {
+        app: {
+          provider: 'do',
+          tables: {
+            posts: {},
+          },
+        },
+      },
+    }));
+
+    const { DatabaseDO } = await import('../durable-objects/database-do.js');
+    const ctx = createCtx();
+    const databaseDo = new DatabaseDO(ctx, createEnv() as never);
+
+    const response = await databaseDo.fetch(new Request('http://do/tables/posts', {
+      headers: {
+        'X-DO-Name': 'app:shadow',
+      },
+    }));
+
+    expect(response.status).toBe(400);
+    await expect(response.json()).resolves.toMatchObject({
+      code: 400,
+      message: "instanceId is not allowed for single-instance namespace 'app'",
+      error: 'INVALID_DB_INSTANCE_ID',
+    });
+    expect((ctx.storage.sql.exec as unknown as ReturnType<typeof vi.fn>)).not.toHaveBeenCalled();
+  });
+
+  it('rejects missing instance ids for dynamic namespaces', async () => {
+    setConfig(defineConfig({
+      release: true,
+      databases: {
+        workspace: {
+          provider: 'do',
+          instance: true,
+          tables: {
+            users: {},
+          },
+        },
+      },
+    }));
+
+    const { DatabaseDO } = await import('../durable-objects/database-do.js');
+    const ctx = createCtx();
+    const databaseDo = new DatabaseDO(ctx, createEnv() as never);
+
+    const response = await databaseDo.fetch(new Request('http://do/tables/users', {
+      headers: {
+        'X-DO-Name': 'workspace',
+      },
+    }));
+
+    expect(response.status).toBe(400);
+    await expect(response.json()).resolves.toMatchObject({
+      code: 400,
+      message: "instanceId is required for dynamic namespace 'workspace'",
+      error: 'INVALID_DB_INSTANCE_ID',
+    });
+    expect((ctx.storage.sql.exec as unknown as ReturnType<typeof vi.fn>)).not.toHaveBeenCalled();
+  });
+});

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.');
+  });
 });