@edge-base/server 0.2.4 → 0.2.6

package/src/__tests__/runtime-startup.test.ts

@@ -0,0 +1,49 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+vi.mock('cloudflare:workers', () => ({
+  DurableObject: class DurableObject {},
+}));
+
+afterEach(() => {
+  vi.resetModules();
+  if (typeof globalThis === 'object' && globalThis !== null) {
+    delete (globalThis as Record<string, unknown>).__EDGEBASE_RUNTIME_CONFIG__;
+  }
+});
+
+describe('runtime startup bootstrap', () => {
+  it('initializes runtime config idempotently for lazy server and DO entrypoints', async () => {
+    const { ensureServerStartup } = await import('../lib/runtime-startup.js');
+    const { parseConfig } = await import('../lib/do-router.js');
+
+    await expect(ensureServerStartup()).resolves.toBeUndefined();
+    const firstConfig = parseConfig();
+
+    await expect(ensureServerStartup()).resolves.toBeUndefined();
+    const secondConfig = parseConfig();
+
+    expect(firstConfig).toEqual(secondConfig);
+    expect(secondConfig).toBeTypeOf('object');
+  });
+
+  it('does not clobber an explicitly injected runtime config', async () => {
+    const { ensureServerStartup } = await import('../lib/runtime-startup.js');
+    const { parseConfig, setConfig } = await import('../lib/do-router.js');
+
+    setConfig({
+      release: false,
+      auth: {
+        allowedRedirectUrls: ['http://localhost:4173'],
+      },
+    });
+
+    await expect(ensureServerStartup()).resolves.toBeUndefined();
+
+    expect(parseConfig()).toMatchObject({
+      release: false,
+      auth: {
+        allowedRedirectUrls: ['http://localhost:4173'],
+      },
+    });
+  });
+});

package/src/__tests__/schema.test.ts

@@ -825,10 +825,10 @@ describe('zodDefaultHook', () => {
     const c = mockContext();
     const result = zodDefaultHook({
       success: false,
-      error: { issues: [{ message: 'field required' }, { message: 'invalid type' }] },
+      error: { issues: [{ message: 'field required', path: ['body', 'email'] }, { message: 'invalid type' }] },
     }, c);
     expect(result).toBeDefined();
-    expect(c.lastJson).toEqual({ code: 400, message: 'field required, invalid type' });
+    expect(c.lastJson).toEqual({ code: 400, message: 'body.email: field required, invalid type' });
     expect(c.lastStatus).toBe(400);
   });
 
@@ -841,13 +841,13 @@ describe('zodDefaultHook', () => {
     expect(c.lastJson).toEqual({ code: 400, message: 'too short' });
   });
 
-  it('handles empty issues → empty message', () => {
+  it('handles empty issues → default message', () => {
     const c = mockContext();
     zodDefaultHook({
       success: false,
       error: { issues: [] },
     }, c);
-    expect(c.lastJson).toEqual({ code: 400, message: '' });
+    expect(c.lastJson).toEqual({ code: 400, message: 'Request validation failed.' });
   });
 
   it('handles missing error.issues and error.errors', () => {
@@ -856,7 +856,7 @@ describe('zodDefaultHook', () => {
       success: false,
       error: {},
     }, c);
-    expect(c.lastJson).toEqual({ code: 400, message: '' });
+    expect(c.lastJson).toEqual({ code: 400, message: 'Request validation failed.' });
   });
 
   it('handles undefined error', () => {
@@ -864,7 +864,16 @@ describe('zodDefaultHook', () => {
     zodDefaultHook({
       success: false,
     }, c);
-    expect(c.lastJson).toEqual({ code: 400, message: '' });
+    expect(c.lastJson).toEqual({ code: 400, message: 'Request validation failed.' });
+  });
+
+  it('formats array indexes in issue paths', () => {
+    const c = mockContext();
+    zodDefaultHook({
+      success: false,
+      error: { issues: [{ message: 'Expected string', path: ['body', 'members', 0, 'email'] }] },
+    }, c);
+    expect(c.lastJson).toEqual({ code: 400, message: 'body.members[0].email: Expected string' });
   });
 });
 

package/src/durable-objects/database-do.ts

@@ -60,6 +60,7 @@ import { buildDbLiveChannel, DATABASE_LIVE_HUB_DO_NAME } from '../lib/database-l
 import { resolveRootServiceKey } from '../lib/service-key.js';
 import { resolveDbLiveBatchThreshold } from '../lib/database-live-config.js';
 import { buildTableHookRuntimeServices } from '../lib/table-hook-runtime.js';
+import { ensureServerStartup } from '../lib/runtime-startup.js';
 import type { Env } from '../types.js';
 
 // ─── Types ───
@@ -80,6 +81,7 @@ export class DatabaseDO extends DurableObject<DOEnv> {
   private config: EdgeBaseConfig;
   private initialized = false;
   private doName = '';
+  private runtimeReadyPromise: Promise<void> | null = null;
 
   constructor(ctx: DurableObjectState, env: DOEnv) {
     super(ctx, env);
@@ -92,6 +94,7 @@ export class DatabaseDO extends DurableObject<DOEnv> {
   }
 
   async fetch(request: Request): Promise<Response> {
+    await this.ensureRuntimeReady();
     // Determine DO name from header or URL
     const doNameHeader = request.headers.get('X-DO-Name');
 
@@ -1933,7 +1936,13 @@ export class DatabaseDO extends DurableObject<DOEnv> {
         return c.json(normalizedDbError.toJSON(), normalizedDbError.code as 400);
       }
       console.error('DatabaseDO Error:', err);
-      return c.json({ code: 500, message: 'Internal server error.' }, 500);
+      return c.json(
+        {
+          code: 500,
+          message: `Database request failed while handling '${c.req.path}'. Check the worker logs for the original exception.`,
+        },
+        500,
+      );
     });
 
     return app;
@@ -1991,6 +2000,17 @@ export class DatabaseDO extends DurableObject<DOEnv> {
     return getGlobalConfig(env);
   }
 
+  private async ensureRuntimeReady(): Promise<void> {
+    if (!this.runtimeReadyPromise) {
+      this.runtimeReadyPromise = (async () => {
+        await ensureServerStartup();
+        this.config = this.parseConfig(this.env);
+      })();
+    }
+
+    await this.runtimeReadyPromise;
+  }
+
   // ─── Database Live Event Emission ───
 
   /**

package/src/durable-objects/database-live-do.ts

@@ -7,6 +7,7 @@ import { verifyAccessToken } from '../lib/jwt.js';
 import { parseConfig as getGlobalConfig } from '../lib/do-router.js';
 import { isDbLiveChannel } from '../lib/database-live-emitter.js';
 import { resolveDbLiveAuthTimeoutMs } from '../lib/database-live-config.js';
+import { ensureServerStartup } from '../lib/runtime-startup.js';
 
 interface DOEnv {
   JWT_USER_SECRET?: string;
@@ -142,6 +143,7 @@ export class DatabaseLiveDO extends DurableObject<DOEnv> {
   private pendingAuth = new Map<string, ReturnType<typeof setTimeout>>();
   private metaCache = new Map<WebSocket, WSMeta>();
   private recentDeliveryIds = new Map<string, number>();
+  private runtimeReadyPromise: Promise<void> | null = null;
 
   constructor(ctx: DurableObjectState, env: DOEnv) {
     super(ctx, env);
@@ -149,6 +151,7 @@ export class DatabaseLiveDO extends DurableObject<DOEnv> {
   }
 
   async fetch(request: Request): Promise<Response> {
+    await this.ensureRuntimeReady();
     const url = new URL(request.url);
 
     if (url.pathname === '/internal/event') {
@@ -218,6 +221,7 @@ export class DatabaseLiveDO extends DurableObject<DOEnv> {
   }
 
   async webSocketMessage(ws: WebSocket, message: string | ArrayBuffer): Promise<void> {
+    await this.ensureRuntimeReady();
     if (typeof message !== 'string') return;
 
     let msg: Record<string, unknown>;
@@ -922,6 +926,17 @@ export class DatabaseLiveDO extends DurableObject<DOEnv> {
     if (parts.length >= 5) return parts[3];
     return null;
   }
+
+  private async ensureRuntimeReady(): Promise<void> {
+    if (!this.runtimeReadyPromise) {
+      this.runtimeReadyPromise = (async () => {
+        await ensureServerStartup();
+        this.config = getGlobalConfig(this.env);
+      })();
+    }
+
+    await this.runtimeReadyPromise;
+  }
 }
 
 export function evaluateDatabaseLiveFilters(