@lunora/runtime 1.0.0-alpha.20 → 1.0.0-alpha.22

package/README.md

@@ -86,6 +86,23 @@ export { ShardDO };
 
 > This README covers the basics. For the full API, options, and guides, see the **[documentation](https://lunora.sh/docs/packages/runtime)**.
 
+### Workers Cache
+
+When `cache: { enabled: true }` is present in `wrangler.jsonc` and `compatibility_date >= "2026-05-01"`, the runtime forwards the Worker's `ExecutionContext.cache` into action handlers as `ctx.cache`. This lets you purge cache by tag from HTTP action handlers:
+
+```ts
+export const refreshProducts = action.action(async ({ ctx }) => {
+    if (!ctx.cache) {
+        throw new Error("Workers Cache is not enabled in wrangler.jsonc");
+    }
+
+    await ctx.cache.purge({ tags: ["products"] });
+    return { ok: true };
+});
+```
+
+The `ctx.cache` binding is only available in **action** handlers (not query/mutation), because actions run in the Worker while queries/mutations run inside the Durable Object. Cache header declarations on `httpRoute` (`.cacheControl()`, `.cacheTag()`, `.vary()`) are attached by `@lunora/server` before the response leaves the handler.
+
 ## Related
 
 - [`@lunora/do`](https://www.npmjs.com/package/@lunora/do) — the `ShardDO` / `SessionDO` Durable Objects this runtime routes to.

package/dist/index.d.mts

@@ -134,6 +134,12 @@ declare const toAirbyteMessages: (page: ConnectorSyncPage, emittedAt?: number) =
 * fall back to {@link NOOP_EXECUTION_CONTEXT}.
 */
 interface ExecutionContextLike {
+  cache?: {
+    purge: (options: {
+      purgeEverything?: boolean;
+      tags?: string[];
+    }) => Promise<unknown>;
+  };
   passThroughOnException?: () => void;
   waitUntil?: (promise: Promise<unknown>) => void;
 }
@@ -1500,6 +1506,12 @@ interface HttpActionContext {
     getIdentity: () => Promise<Record<string, unknown> | null>;
     userId: null | string;
   };
+  cache?: {
+    purge: (options: {
+      purgeEverything?: boolean;
+      tags?: string[];
+    }) => Promise<unknown>;
+  };
   fetch: typeof globalThis.fetch;
   runAction: <R>(reference: unknown, args?: Record<string, unknown>) => Promise<R>;
   runMutation: <R>(reference: unknown, args?: Record<string, unknown>) => Promise<R>;

package/dist/index.d.ts

@@ -134,6 +134,12 @@ declare const toAirbyteMessages: (page: ConnectorSyncPage, emittedAt?: number) =
 * fall back to {@link NOOP_EXECUTION_CONTEXT}.
 */
 interface ExecutionContextLike {
+  cache?: {
+    purge: (options: {
+      purgeEverything?: boolean;
+      tags?: string[];
+    }) => Promise<unknown>;
+  };
   passThroughOnException?: () => void;
   waitUntil?: (promise: Promise<unknown>) => void;
 }
@@ -1500,6 +1506,12 @@ interface HttpActionContext {
     getIdentity: () => Promise<Record<string, unknown> | null>;
     userId: null | string;
   };
+  cache?: {
+    purge: (options: {
+      purgeEverything?: boolean;
+      tags?: string[];
+    }) => Promise<unknown>;
+  };
   fetch: typeof globalThis.fetch;
   runAction: <R>(reference: unknown, args?: Record<string, unknown>) => Promise<R>;
   runMutation: <R>(reference: unknown, args?: Record<string, unknown>) => Promise<R>;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { toAirbyteMessages, toFivetranResponse } from './packem_shared/toAirbyteMessages-DrHdplb4.mjs';
-export { composeWorker, createLunoraHandler, createWorker, defineRpcEnvelope, resolveLunoraOptions, withFrameworkWorker } from './packem_shared/composeWorker-Cyk4C-Vy.mjs';
+export { composeWorker, createLunoraHandler, createWorker, defineRpcEnvelope, resolveLunoraOptions, withFrameworkWorker } from './packem_shared/composeWorker-Dpw9d1s5.mjs';
 export { createCrossShardRelationCapabilities } from './packem_shared/createCrossShardRelationCapabilities-CbcWjkAn.mjs';
 export { DEFAULT_REGISTRY_CACHE_TTL_MS, SHARD_REGISTRY_DO_NAME, createDynamicShardRegistry } from './packem_shared/DEFAULT_REGISTRY_CACHE_TTL_MS-B3pA7aXp.mjs';
 export { LunoraError, toErrorResponse } from './packem_shared/LunoraError-Bpb9EFJ3.mjs';

package/dist/packem_shared/{composeWorker-Cyk4C-Vy.mjs → composeWorker-Dpw9d1s5.mjs}

@@ -2434,7 +2434,7 @@ const createWorker = (options) => {
     queryParameter,
     requireAdminOption
   });
-  const buildHttpActionContext = async (request, env) => {
+  const buildHttpActionContext = async (request, env, context) => {
     const { claims, headers, userId } = await resolveForwardContext(request, env, publicResolveIdentity);
     const run = async (reference, args = {}) => {
       const functionPath = reference.__lunoraRef;
@@ -2461,6 +2461,7 @@ const createWorker = (options) => {
         getIdentity: () => Promise.resolve(claims),
         userId
       },
+      cache: context.cache,
       fetch: globalThis.fetch.bind(globalThis),
       runAction: run,
       runMutation: run,
@@ -2471,7 +2472,7 @@ const createWorker = (options) => {
     if (!options.httpRouter) {
       return void 0;
     }
-    const httpContext = await buildHttpActionContext(request, env);
+    const httpContext = await buildHttpActionContext(request, env, context);
     try {
       return await options.httpRouter.fetch(request, { ...env, __lunoraCtx: httpContext }, context);
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/runtime",
-  "version": "1.0.0-alpha.20",
+  "version": "1.0.0-alpha.22",
   "description": "Lunora Worker runtime: the RPC router, shard resolver, and query coordinator",
   "keywords": [
     "cloudflare",
@@ -46,7 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.2"
+    "@lunora/errors": "1.0.0-alpha.3"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"