@volter/twin-clerk 0.1.1 → 0.1.2

package/dist/src/clerk-events.js

@@ -1,4 +1,4 @@
-import { nodeBuiltin, worldNow } from '@volter/world-core';
+import { nodeBuiltin, worldNow, deliveryTraceHeaders } from '@volter/world-core';
 import { appDestination, appFetch } from '@volter/world-core/app-route';
 import { worldEgressRefusal } from '@volter/world-core/network-policy';
 function nodeCrypto() {
@@ -104,7 +104,7 @@ const httpDelivery = async (url, body, headers) => {
     if (!appDestination(url) && worldEgressRefusal(url) !== null)
         return; // the World's egress rule, the application's own hostnames reaching it inside the World: refused like an unreachable endpoint
     try {
-        await appFetch(url, { method: 'POST', headers: { 'content-type': 'application/json', ...headers }, body });
+        await appFetch(url, { method: 'POST', headers: { 'content-type': 'application/json', ...headers, ...deliveryTraceHeaders() }, body });
     }
     catch {
         /* fire-and-forget, like the real vendor */

package/dist/src/clerk-mirror-ui.js

@@ -6,7 +6,7 @@
 // pack's OWN fetch adapter (createClerkTwinFetch) as its API backend and reads every byte of
 // state back over the wire, exactly as the browser client does.
 import { readFile } from 'node:fs/promises';
-import { bundleClient, fileResponse } from '@volter/world-core';
+import { bundleClient, fileResponse, filePathOf } from '@volter/world-core';
 import { serveHttp } from '@volter/world-core';
 import { createClerkTwinFetch } from "./clerk-server.js";
 // Resolved LAZILY (on first serve), not at module load: `new URL(..., import.meta.url)` at
@@ -14,8 +14,8 @@ import { createClerkTwinFetch } from "./clerk-server.js";
 // `import.meta.url` is not a valid file base (e.g. workerd) even though the mirror UI is never
 // served there. Computing them on demand keeps Node/Bun behavior identical while letting a
 // serverless host import this module's barrel without a startup crash.
-const clientEntryPath = () => new URL('../client/clerk-mirror.tsx', import.meta.url).pathname;
-const clientCssPath = () => new URL('../client/clerk-mirror.css', import.meta.url).pathname;
+const clientEntryPath = () => filePathOf(new URL('../client/clerk-mirror.tsx', import.meta.url));
+const clientCssPath = () => filePathOf(new URL('../client/clerk-mirror.css', import.meta.url));
 /** A user's display name: "First Last", else username, else primary email, else id. */
 export function formatUserName(u) {
     const name = [u?.first_name, u?.last_name].filter(Boolean).join(' ').trim();

package/dist/src/clerk-server.js

@@ -7,7 +7,7 @@
 // Personas are world state: pass `personas` (a JSON file of users with passwords) and the
 // server seeds them as ordinary user rows at start — sign-in is a protocol, never a default.
 // JSON bodies pass through to the handler. Writable by default; readOnly rejects writes (R4).
-import { serveHttp } from '@volter/world-core';
+import { runWithRequestTrace, serveHttp } from '@volter/world-core';
 import { handleClerkTwinRequest } from "./clerk-twin.js";
 import { worldNow, statefulTwinManifest, packAsset } from '@volter/world-core';
 import { handleClerkFapiRequest } from "./clerk-fapi.js";
@@ -89,7 +89,9 @@ export function createClerkTwinFetch(options = {}) {
     // the pack CONSTRUCTS on any host (workerd included) and only the local-CDN route itself needs
     // Bun — until the dist rides a pack-asset seam (`TwinPack.assets`, the pack-asset seam), that route is the
     // pack's one host-bound surface, not the whole pack.
-    return async function clerkTwinFetch(request) {
+    // a request's W3C trace context scopes everything it writes and delivers (world-core trace-context)
+    return (request) => runWithRequestTrace(request, () => clerkTwinFetch(request));
+    async function clerkTwinFetch(request) {
         await seeded;
         const url = new URL(request.url);
         // GET /twin — the discovery manifest (education inside the twin).
@@ -160,7 +162,7 @@ export function createClerkTwinFetch(options = {}) {
             ...(options.root !== undefined ? { root: options.root } : {}),
         });
         return new Response(JSON.stringify(out), { status, headers: { 'content-type': 'application/json', 'clerk-trace-id': 'trace_twin', ...cors } });
-    };
+    }
 }
 export async function createClerkTwinServer(options) {
     const server = await serveHttp({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-clerk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Local Clerk twin — a faithful, stateful local Clerk Backend API your real `@clerk/backend` SDK talks to unmodified. Users, sessions, orgs, real signed JWTs + a JWKS endpoint. Mirror, simulate, and fork. Built on @volter/world-core.",
   "keywords": [
     "twin",
@@ -58,10 +58,10 @@
     "react-dom": "^19.2.7"
   },
   "peerDependencies": {
-    "@volter/world-core": "2.0.1"
+    "@volter/world-core": "2.0.2"
   },
   "devDependencies": {
-    "@volter/world-core": "2.0.1",
+    "@volter/world-core": "2.0.2",
     "@volter/world-tooling": "0.1.0",
     "@clerk/backend": "^1.15.0",
     "@types/bun": "^1.2.20",

package/src/clerk-events.ts

@@ -1,4 +1,4 @@
-import { nodeBuiltin, worldNow } from '@volter/world-core';
+import { nodeBuiltin, worldNow, deliveryTraceHeaders } from '@volter/world-core';
 import { appDestination, appFetch } from '@volter/world-core/app-route';
 import { worldEgressRefusal } from '@volter/world-core/network-policy';
 // Clerk webhook emission — svix-style signed webhooks on user/session/org events.
@@ -124,7 +124,7 @@ function svixMessageId(url: string, timestamp: number, body: string): string { l
 const httpDelivery: ClerkWebhookDelivery = async (url, body, headers) => {
   if (!appDestination(url) && worldEgressRefusal(url) !== null) return; // the World's egress rule, the application's own hostnames reaching it inside the World: refused like an unreachable endpoint
   try {
-    await appFetch(url, { method: 'POST', headers: { 'content-type': 'application/json', ...headers }, body });
+    await appFetch(url, { method: 'POST', headers: { 'content-type': 'application/json', ...headers, ...deliveryTraceHeaders() }, body });
   } catch {
     /* fire-and-forget, like the real vendor */
   }

package/src/clerk-mirror-ui.ts

@@ -6,7 +6,7 @@
 // pack's OWN fetch adapter (createClerkTwinFetch) as its API backend and reads every byte of
 // state back over the wire, exactly as the browser client does.
 import { readFile } from 'node:fs/promises';
-import { bundleClient, fileResponse } from '@volter/world-core';
+import { bundleClient, fileResponse, filePathOf } from '@volter/world-core';
 import { serveHttp } from '@volter/world-core';
 import { createClerkTwinFetch } from './clerk-server.ts';
 
@@ -15,8 +15,8 @@ import { createClerkTwinFetch } from './clerk-server.ts';
 // `import.meta.url` is not a valid file base (e.g. workerd) even though the mirror UI is never
 // served there. Computing them on demand keeps Node/Bun behavior identical while letting a
 // serverless host import this module's barrel without a startup crash.
-const clientEntryPath = () => new URL('../client/clerk-mirror.tsx', import.meta.url).pathname;
-const clientCssPath = () => new URL('../client/clerk-mirror.css', import.meta.url).pathname;
+const clientEntryPath = () => filePathOf(new URL('../client/clerk-mirror.tsx', import.meta.url));
+const clientCssPath = () => filePathOf(new URL('../client/clerk-mirror.css', import.meta.url));
 
 // ---------------------------------------------------------------------------
 // Pure, dependency-free render/format helpers. Framework-agnostic (plain data in →

package/src/clerk-server.ts

@@ -7,7 +7,7 @@
 // Personas are world state: pass `personas` (a JSON file of users with passwords) and the
 // server seeds them as ordinary user rows at start — sign-in is a protocol, never a default.
 // JSON bodies pass through to the handler. Writable by default; readOnly rejects writes (R4).
-import { serveHttp } from '@volter/world-core';
+import { runWithRequestTrace, serveHttp } from '@volter/world-core';
 import { handleClerkTwinRequest } from './clerk-twin.ts';
 import { worldNow, statefulTwinManifest, packAsset } from '@volter/world-core';
 import { handleClerkFapiRequest } from './clerk-fapi.ts';
@@ -97,7 +97,9 @@ export function createClerkTwinFetch(options: ClerkTwinFetchOptions = {}): (requ
   // the pack CONSTRUCTS on any host (workerd included) and only the local-CDN route itself needs
   // Bun — until the dist rides a pack-asset seam (`TwinPack.assets`, the pack-asset seam), that route is the
   // pack's one host-bound surface, not the whole pack.
-  return async function clerkTwinFetch(request: Request): Promise<Response> {
+  // a request's W3C trace context scopes everything it writes and delivers (world-core trace-context)
+  return (request: Request): Promise<Response> => runWithRequestTrace(request, () => clerkTwinFetch(request));
+  async function clerkTwinFetch(request: Request): Promise<Response> {
     await seeded;
     const url = new URL(request.url);
     // GET /twin — the discovery manifest (education inside the twin).
@@ -162,7 +164,7 @@ export function createClerkTwinFetch(options: ClerkTwinFetchOptions = {}): (requ
       ...(options.root !== undefined ? { root: options.root } : {}),
     });
     return new Response(JSON.stringify(out), { status, headers: { 'content-type': 'application/json', 'clerk-trace-id': 'trace_twin', ...cors } });
-  };
+  }
 }
 
 export async function createClerkTwinServer(options: { root?: string; port?: number; readOnly?: boolean; personas?: Array<Record<string, unknown>> }): Promise<{ port: number; stop: () => void }> {