@lunora/runtime 1.0.0-alpha.6 → 1.0.0-alpha.8

package/dist/index.d.mts

@@ -110,6 +110,38 @@ declare const toFivetranResponse: (page: ConnectorSyncPage, primaryKey?: Record<
 * @param emittedAt epoch-ms stamped on each `RECORD` (default `Date.now()`).
 */
 declare const toAirbyteMessages: (page: ConnectorSyncPage, emittedAt?: number) => AirbyteMessage[];
+/**
+* The subset of the Cloudflare `ExecutionContext` the Lunora worker entry and
+* the framework mount seams rely on — `waitUntil` for fire-and-forget work that
+* must outlive the response, and `passThroughOnException` for the top-level
+* error posture.
+*
+* It is deliberately **not** a package. `@lunora/runtime` is the leaf server
+* runtime and `@lunora/nuxt` is a framework integration that intentionally does
+* not depend on `@lunora/runtime`'s worker types, yet both need this exact
+* shape: the runtime to build/forward the worker `fetch`, Nuxt to forward an
+* inbound request to the user's composed worker. Each imports this file by
+* relative path and the bundler (packem/rollup) inlines it: no runtime
+* dependency edge is created, the helper is duplicated only in emitted output,
+* never in source. One source of truth, zero deps. See AGENTS.md → "Top-level
+* `shared/` — bundler-inlined source".
+*
+* Both methods are **optional**: a real Cloudflare `ExecutionContext` always
+* supplies them, but a host that mounts Lunora as a sub-handler (Nitro/H3, a
+* non-Cloudflare preview, a unit test) may hand over a partial context or none
+* at all. Callers therefore invoke them defensively (`ctx.waitUntil?.(…)`) or
+* fall back to {@link NOOP_EXECUTION_CONTEXT}.
+*/
+interface ExecutionContextLike {
+  passThroughOnException?: () => void;
+  waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+* No-op `ExecutionContext` used when the host runtime didn't supply one (a
+* non-Cloudflare preview, or a unit test), so the worker's `fetch` always
+* receives a valid third argument.
+*/
+declare const NOOP_EXECUTION_CONTEXT: ExecutionContextLike;
 /** A timestamp as better-auth stores it: epoch-ms, an ISO string, or absent. */
 type AuthTimestamp = null | number | string;
 /**
@@ -1157,10 +1189,6 @@ interface RpcEnvelope {
   functionPath: string;
   shardKey?: string;
 }
-interface ExecutionContextLike {
-  passThroughOnException: () => void;
-  waitUntil: (promise: Promise<unknown>) => void;
-}
 type Route = (request: Request, env: unknown, context: ExecutionContextLike) => Promise<Response> | Response;
 /**
 * Context handed to HTTP-action handlers. Built per request by the worker; its
@@ -2095,12 +2123,6 @@ declare const withFrameworkWorker: (host: FrameworkHostHandler, optionsInput: Fr
 */
 type LunoraHandlerOptions = ((env: unknown) => FrameworkWorkerOptions) | Partial<FrameworkWorkerOptions>;
 /**
-* No-op `ExecutionContext` used when the host runtime didn't supply one (a
-* non-Cloudflare preview, or a unit test), so the worker's `fetch` always
-* receives a valid third argument.
-*/
-declare const NOOP_EXECUTION_CONTEXT: ExecutionContextLike;
-/**
 * Resolve per-request Lunora worker options. A factory is called with the
 * request `env`; a partial object has its `shardDO` defaulted to `env.SHARD` so
 * the common case needs no configuration. Throws a clear error when no shard

package/dist/index.d.ts

@@ -110,6 +110,38 @@ declare const toFivetranResponse: (page: ConnectorSyncPage, primaryKey?: Record<
 * @param emittedAt epoch-ms stamped on each `RECORD` (default `Date.now()`).
 */
 declare const toAirbyteMessages: (page: ConnectorSyncPage, emittedAt?: number) => AirbyteMessage[];
+/**
+* The subset of the Cloudflare `ExecutionContext` the Lunora worker entry and
+* the framework mount seams rely on — `waitUntil` for fire-and-forget work that
+* must outlive the response, and `passThroughOnException` for the top-level
+* error posture.
+*
+* It is deliberately **not** a package. `@lunora/runtime` is the leaf server
+* runtime and `@lunora/nuxt` is a framework integration that intentionally does
+* not depend on `@lunora/runtime`'s worker types, yet both need this exact
+* shape: the runtime to build/forward the worker `fetch`, Nuxt to forward an
+* inbound request to the user's composed worker. Each imports this file by
+* relative path and the bundler (packem/rollup) inlines it: no runtime
+* dependency edge is created, the helper is duplicated only in emitted output,
+* never in source. One source of truth, zero deps. See AGENTS.md → "Top-level
+* `shared/` — bundler-inlined source".
+*
+* Both methods are **optional**: a real Cloudflare `ExecutionContext` always
+* supplies them, but a host that mounts Lunora as a sub-handler (Nitro/H3, a
+* non-Cloudflare preview, a unit test) may hand over a partial context or none
+* at all. Callers therefore invoke them defensively (`ctx.waitUntil?.(…)`) or
+* fall back to {@link NOOP_EXECUTION_CONTEXT}.
+*/
+interface ExecutionContextLike {
+  passThroughOnException?: () => void;
+  waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+* No-op `ExecutionContext` used when the host runtime didn't supply one (a
+* non-Cloudflare preview, or a unit test), so the worker's `fetch` always
+* receives a valid third argument.
+*/
+declare const NOOP_EXECUTION_CONTEXT: ExecutionContextLike;
 /** A timestamp as better-auth stores it: epoch-ms, an ISO string, or absent. */
 type AuthTimestamp = null | number | string;
 /**
@@ -1157,10 +1189,6 @@ interface RpcEnvelope {
   functionPath: string;
   shardKey?: string;
 }
-interface ExecutionContextLike {
-  passThroughOnException: () => void;
-  waitUntil: (promise: Promise<unknown>) => void;
-}
 type Route = (request: Request, env: unknown, context: ExecutionContextLike) => Promise<Response> | Response;
 /**
 * Context handed to HTTP-action handlers. Built per request by the worker; its
@@ -2095,12 +2123,6 @@ declare const withFrameworkWorker: (host: FrameworkHostHandler, optionsInput: Fr
 */
 type LunoraHandlerOptions = ((env: unknown) => FrameworkWorkerOptions) | Partial<FrameworkWorkerOptions>;
 /**
-* No-op `ExecutionContext` used when the host runtime didn't supply one (a
-* non-Cloudflare preview, or a unit test), so the worker's `fetch` always
-* receives a valid third argument.
-*/
-declare const NOOP_EXECUTION_CONTEXT: ExecutionContextLike;
-/**
 * Resolve per-request Lunora worker options. A factory is called with the
 * request `env`; a partial object has its `shardDO` defaulted to `env.SHARD` so
 * the common case needs no configuration. Throws a clear error when no shard

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { toAirbyteMessages, toFivetranResponse } from './packem_shared/toAirbyteMessages-DrHdplb4.mjs';
-export { NOOP_EXECUTION_CONTEXT, composeWorker, createLunoraHandler, createWorker, defineRpcEnvelope, resolveLunoraOptions, withFrameworkWorker } from './packem_shared/NOOP_EXECUTION_CONTEXT-Rns-X7RV.mjs';
+export { composeWorker, createLunoraHandler, createWorker, defineRpcEnvelope, resolveLunoraOptions, withFrameworkWorker } from './packem_shared/composeWorker-Y3uASpzc.mjs';
 export { createCrossShardRelationCapabilities } from './packem_shared/createCrossShardRelationCapabilities-C0KOf7er.mjs';
 export { DEFAULT_REGISTRY_CACHE_TTL_MS, SHARD_REGISTRY_DO_NAME, createDynamicShardRegistry } from './packem_shared/DEFAULT_REGISTRY_CACHE_TTL_MS-ocax8v0n.mjs';
 export { LunoraError, toErrorResponse } from './packem_shared/LunoraError-CL0aOtpo.mjs';
@@ -8,6 +8,7 @@ export { analyticsEngineSink, combineSinks, consoleSink, sentrySink, webhookSink
 export { createQueryCoordinator, createStaticShardRegistry, mergeStrategyForAggregate } from './packem_shared/createQueryCoordinator-Cbds9cUI.mjs';
 export { applyJurisdiction, resolveShard } from './packem_shared/applyJurisdiction-BkZtTkct.mjs';
 export { decorateResponse, enforceOrigin, handleCorsPreflight, resolveSecurity } from './packem_shared/decorateResponse-DbISh_Wi.mjs';
+export { NOOP_EXECUTION_CONTEXT } from './packem_shared/NOOP_EXECUTION_CONTEXT-CCTu0Bf1.mjs';
 
 const VERSION = "0.0.0";
 

package/dist/packem_shared/NOOP_EXECUTION_CONTEXT-CCTu0Bf1.mjs

@@ -0,0 +1,8 @@
+const NOOP_EXECUTION_CONTEXT = {
+  passThroughOnException: () => {
+  },
+  waitUntil: () => {
+  }
+};
+
+export { NOOP_EXECUTION_CONTEXT };

package/dist/packem_shared/{NOOP_EXECUTION_CONTEXT-Rns-X7RV.mjs → composeWorker-Y3uASpzc.mjs}

@@ -1,3 +1,4 @@
+import { NOOP_EXECUTION_CONTEXT } from './NOOP_EXECUTION_CONTEXT-CCTu0Bf1.mjs';
 import { LunoraError, toErrorResponse, isStructuralLunoraError, isStructuralConflictError } from './LunoraError-CL0aOtpo.mjs';
 import { emitRpcEvent } from './emitLogEvent-pEdtqAK8.mjs';
 import { resolveShard, applyJurisdiction } from './applyJurisdiction-BkZtTkct.mjs';
@@ -1502,7 +1503,7 @@ const buildWorkflowsAdminRoutes = (deps) => {
     assertAdmin(request);
     const client = resolveWorkflowsClient(env);
     if (!client) {
-      return throwNotConfigured();
+      return Response.json({ configured: false, instances: [], page: 1, perPage: 0, totalCount: 0 });
     }
     const workflowName = requireQuery(url, "name");
     const status = toInstanceStatus(url.searchParams.get("status"));
@@ -1598,6 +1599,8 @@ const resolveForwardContext = async (request, env, resolveIdentity) => {
   const cookie = request.headers.get("cookie");
   const bookmark = request.headers.get("x-d1-bookmark");
   const mutationId = request.headers.get("x-lunora-mutation-id");
+  const clientId = request.headers.get("x-lunora-client-id");
+  const clientSeq = request.headers.get("x-lunora-client-seq");
   if (authorization) {
     headers["authorization"] = authorization;
   }
@@ -1610,6 +1613,12 @@ const resolveForwardContext = async (request, env, resolveIdentity) => {
   if (mutationId) {
     headers["x-lunora-mutation-id"] = mutationId;
   }
+  if (clientId) {
+    headers["x-lunora-client-id"] = clientId;
+  }
+  if (clientSeq) {
+    headers["x-lunora-client-seq"] = clientSeq;
+  }
   const clientIp = request.headers.get("cf-connecting-ip");
   if (clientIp) {
     headers["x-lunora-client-ip"] = clientIp;
@@ -1662,6 +1671,12 @@ const validateFanOut = (fanOut) => {
   }
   return spec;
 };
+const logRpcDebug = (env, envelope) => {
+  if (!env?.LUNORA_DEBUG_RPC) {
+    return;
+  }
+  console.warn(`[lunora:rpc] ${envelope.fanOut ? "fan-out" : `shard=${envelope.shardKey ?? "(root)"}`} ${envelope.functionPath}`);
+};
 const parseEnvelope = async (request) => {
   const text = await readBodyTextWithLimit(request);
   let body;
@@ -2149,6 +2164,7 @@ const createWorker = (options) => {
       throw new LunoraError("RPC endpoint requires POST", { code: "METHOD_NOT_ALLOWED", status: 405 });
     }
     const envelope = await parseEnvelope(request);
+    logRpcDebug(env, envelope);
     if (envelope.fanOut && envelope.shardKey) {
       throw new LunoraError("RPC envelope cannot set both `shardKey` and `fanOut`", { code: "BAD_REQUEST", status: 400 });
     }
@@ -2171,7 +2187,7 @@ const createWorker = (options) => {
       const { observability } = options;
       const sinkContext = context ? {
         waitUntil: (promise) => {
-          context.waitUntil(promise);
+          context.waitUntil?.(promise);
         }
       } : void 0;
       if (envelope.fanOut) {
@@ -2375,7 +2391,7 @@ const createWorker = (options) => {
     }
     const basePath = options.authBasePath ?? DEFAULT_AUTH_BASE_PATH;
     if (isAuthAttemptPath(url.pathname, basePath)) {
-      context.waitUntil(recordAuthAttempt(env, authResponse.status >= 400 ? "fail" : "ok"));
+      context.waitUntil?.(recordAuthAttempt(env, authResponse.status >= 400 ? "fail" : "ok"));
     }
     return authResponse;
   };
@@ -2448,7 +2464,7 @@ const createWorker = (options) => {
   return {
     async fetch(request, env, context) {
       if (options.passThroughOnException) {
-        context.passThroughOnException();
+        context.passThroughOnException?.();
       }
       ensureSecurityResolved(env);
       resolveAdminTokenFromEnv(env);
@@ -2505,12 +2521,6 @@ const withFrameworkWorker = (host, optionsInput) => {
     serverQuery: (request, env, reference, args, options) => build(optionsFactory(env)).serverQuery(request, env, reference, args, options)
   };
 };
-const NOOP_EXECUTION_CONTEXT = {
-  passThroughOnException: () => {
-  },
-  waitUntil: () => {
-  }
-};
 const resolveLunoraOptions = (options, env) => {
   if (typeof options === "function") {
     return options(env);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/runtime",
-  "version": "1.0.0-alpha.6",
+  "version": "1.0.0-alpha.8",
   "description": "Lunora Worker runtime: the RPC router, shard resolver, and query coordinator",
   "keywords": [
     "cloudflare",