@zeltjs/adapter-cloudflare-workers 0.10.0 → 0.10.1-canary.0

package/README.md

@@ -12,6 +12,14 @@ Cloudflare Workers adapter for Zelt.
 pnpm add @zeltjs/adapter-cloudflare-workers
 ```
 
+This adapter uses `AsyncLocalStorage` from `node:async_hooks`, so the
+`nodejs_compat` compatibility flag (or the narrower `nodejs_als`) must be
+enabled in your `wrangler.toml` / `wrangler.jsonc`:
+
+```toml
+compatibility_flags = ["nodejs_compat"]
+```
+
 ## Usage
 
 ```typescript
@@ -106,3 +114,7 @@ export default { fetch: workers.fetch };
 `bindings.get('DB')` is typed from the augmented global `Env`, so no manual typing is needed.
 
 **Important:** `CloudflareBindings.get()` reads from request-scoped storage populated by `onCloudflareWorkers()`, so it only works during request handling — calling it outside a request (e.g. at module load time) throws.
+
+## Background Tasks
+
+`onCloudflareWorkers()` automatically registers `CloudflareWorkersWaitUntilAdaptor`, which extends `TaskService`'s after-response and fire-and-forget tasks through `ctx.waitUntil`, so the Workers runtime keeps the isolate alive until they finish.

package/dist/index.cjs

@@ -13,9 +13,10 @@ const storage = new node_async_hooks.AsyncLocalStorage();
 	return context;
 };
 const runWithCloudflareRuntimeContext = (context, fn) => storage.run(context, fn);
+const tryGetCloudflareRuntimeContext = () => storage.getStore();
 //#endregion
 //#region src/cloudflare-bindings.service.ts
-function _ts_decorate$1(decorators, target, key, desc) {
+function _ts_decorate$2(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -26,10 +27,10 @@ var CloudflareBindingsService = class {
 		return getCloudflareRuntimeContext().env[key];
 	}
 };
-CloudflareBindingsService = _ts_decorate$1([(0, _zeltjs_core.Injectable)()], CloudflareBindingsService);
+CloudflareBindingsService = _ts_decorate$2([(0, _zeltjs_core.Injectable)()], CloudflareBindingsService);
 //#endregion
 //#region src/cloudflare-workers-env.adaptor.ts
-function _ts_decorate(decorators, target, key, desc) {
+function _ts_decorate$1(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -41,13 +42,27 @@ var CloudflareWorkersEnvAdaptor = class extends _zeltjs_core.EnvAdaptor {
 		return typeof value === "string" ? value : void 0;
 	}
 };
-CloudflareWorkersEnvAdaptor = _ts_decorate([_zeltjs_core.Config], CloudflareWorkersEnvAdaptor);
+CloudflareWorkersEnvAdaptor = _ts_decorate$1([_zeltjs_core.Config], CloudflareWorkersEnvAdaptor);
+//#endregion
+//#region src/cloudflare-workers-wait-until.adaptor.ts
+function _ts_decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+var CloudflareWorkersWaitUntilAdaptor = class extends _zeltjs_core.WaitUntilAdaptor {
+	waitUntil(promise) {
+		tryGetCloudflareRuntimeContext()?.ctx.waitUntil(promise);
+	}
+};
+CloudflareWorkersWaitUntilAdaptor = _ts_decorate([_zeltjs_core.Config], CloudflareWorkersWaitUntilAdaptor);
 //#endregion
 //#region src/on-cloudflare-workers.ts
 const onCloudflareWorkers = async (app, options = {}) => {
 	const readyApp = await app.createRuntime({
 		...options.configs === void 0 ? {} : { configs: options.configs },
-		fallbackConfigs: [CloudflareWorkersEnvAdaptor],
+		fallbackConfigs: [CloudflareWorkersEnvAdaptor, CloudflareWorkersWaitUntilAdaptor],
 		warmup: options.warmup ?? false
 	});
 	const fetch = async (request, env, ctx) => {
@@ -77,4 +92,10 @@ Object.defineProperty(exports, "CloudflareWorkersEnvAdaptor", {
 		return CloudflareWorkersEnvAdaptor;
 	}
 });
+Object.defineProperty(exports, "CloudflareWorkersWaitUntilAdaptor", {
+	enumerable: true,
+	get: function() {
+		return CloudflareWorkersWaitUntilAdaptor;
+	}
+});
 exports.onCloudflareWorkers = onCloudflareWorkers;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ConfigClass, ConfiguredFeature, CreateRuntimeOptions, EnvAdaptor, HttpCapabilities, RuntimeApp } from "@zeltjs/core";
+import { ConfigClass, ConfiguredFeature, CreateRuntimeOptions, EnvAdaptor, HttpCapabilities, RuntimeApp, WaitUntilAdaptor } from "@zeltjs/core";
 
 //#region src/cloudflare-bindings.service.d.ts
 declare class CloudflareBindingsService {
@@ -11,6 +11,16 @@ declare class CloudflareWorkersEnvAdaptor extends EnvAdaptor {
   get(key: string): string | undefined;
 }
 //#endregion
+//#region src/cloudflare-workers-wait-until.adaptor.d.ts
+/**
+ * Only extends execution while inside a request handled via onCloudflareWorkers'
+ * fetch (the ALS scope); outside it (future cron/queue/DO entry points) this is
+ * a silent no-op and tasks may be killed when the event settles.
+ */
+declare class CloudflareWorkersWaitUntilAdaptor extends WaitUntilAdaptor {
+  waitUntil(promise: Promise<void>): void;
+}
+//#endregion
 //#region src/on-cloudflare-workers.d.ts
 type CloudflareWorkersOptions = {
   readonly configs?: readonly ConfigClass<object>[];
@@ -29,5 +39,5 @@ type CloudflareWorkersApp = {
 };
 declare const onCloudflareWorkers: (app: HttpApp, options?: CloudflareWorkersOptions) => Promise<CloudflareWorkersApp>;
 //#endregion
-export { CloudflareBindingsService as CloudflareBindings, type CloudflareWorkersApp, CloudflareWorkersEnvAdaptor, type CloudflareWorkersOptions, onCloudflareWorkers };
+export { CloudflareBindingsService as CloudflareBindings, type CloudflareWorkersApp, CloudflareWorkersEnvAdaptor, type CloudflareWorkersOptions, CloudflareWorkersWaitUntilAdaptor, onCloudflareWorkers };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/cloudflare-bindings.service.ts","../src/cloudflare-workers-env.adaptor.ts","../src/on-cloudflare-workers.ts"],"mappings":";;;cAKa,yBAAA;;EAEX,GAAA,iBAAoB,GAAA,CAAA,CAAK,GAAA,EAAK,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA;;;cCH3B,2BAAA,SAAoC,UAAA;EACtC,GAAA,CAAI,GAAA;AAAA;;;KCKH,wBAAA;EAAA,SACD,OAAA,YAAmB,WAAA;EAAA,SACnB,MAAA;AAAA;AAAA,KAGN,cAAA,GAAiB,UAAA,UAAoB,iBAAA;EAAA,SAC/B,IAAA,EAAM,gBAAA;AAAA;AAAA,KAGZ,OAAA;EAAA,SACM,aAAA,GAAgB,OAAA,GAAU,oBAAA,KAAyB,OAAA,CAAQ,cAAA;AAAA;AAAA,KAG1D,oBAAA;EAAA,SACD,GAAA,EAAK,cAAA;EAAA,SACL,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;EAAA,SACtE,QAAA,QAAgB,OAAA;AAAA;AAAA,cAGd,mBAAA,GACX,GAAA,EAAK,OAAA,EACL,OAAA,GAAS,wBAAA,KACR,OAAA,CAAQ,oBAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/cloudflare-bindings.service.ts","../src/cloudflare-workers-env.adaptor.ts","../src/cloudflare-workers-wait-until.adaptor.ts","../src/on-cloudflare-workers.ts"],"mappings":";;;cAKa,yBAAA;;EAEX,GAAA,iBAAoB,GAAA,CAAA,CAAK,GAAA,EAAK,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA;;;cCH3B,2BAAA,SAAoC,UAAA;EACtC,GAAA,CAAI,GAAA;AAAA;;;;;ADDf;;;cEKa,iCAAA,SAA0C,gBAAA;EAC5C,SAAA,CAAU,OAAA,EAAS,OAAA;AAAA;;;KCClB,wBAAA;EAAA,SACD,OAAA,YAAmB,WAAA;EAAA,SACnB,MAAA;AAAA;AAAA,KAGN,cAAA,GAAiB,UAAA,UAAoB,iBAAA;EAAA,SAC/B,IAAA,EAAM,gBAAA;AAAA;AAAA,KAGZ,OAAA;EAAA,SACM,aAAA,GAAgB,OAAA,GAAU,oBAAA,KAAyB,OAAA,CAAQ,cAAA;AAAA;AAAA,KAG1D,oBAAA;EAAA,SACD,GAAA,EAAK,cAAA;EAAA,SACL,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;EAAA,SACtE,QAAA,QAAgB,OAAA;AAAA;AAAA,cAGd,mBAAA,GACX,GAAA,EAAK,OAAA,EACL,OAAA,GAAS,wBAAA,KACR,OAAA,CAAQ,oBAAA"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ConfigClass, ConfiguredFeature, CreateRuntimeOptions, EnvAdaptor, HttpCapabilities, RuntimeApp } from "@zeltjs/core";
+import { ConfigClass, ConfiguredFeature, CreateRuntimeOptions, EnvAdaptor, HttpCapabilities, RuntimeApp, WaitUntilAdaptor } from "@zeltjs/core";
 
 //#region src/cloudflare-bindings.service.d.ts
 declare class CloudflareBindingsService {
@@ -11,6 +11,16 @@ declare class CloudflareWorkersEnvAdaptor extends EnvAdaptor {
   get(key: string): string | undefined;
 }
 //#endregion
+//#region src/cloudflare-workers-wait-until.adaptor.d.ts
+/**
+ * Only extends execution while inside a request handled via onCloudflareWorkers'
+ * fetch (the ALS scope); outside it (future cron/queue/DO entry points) this is
+ * a silent no-op and tasks may be killed when the event settles.
+ */
+declare class CloudflareWorkersWaitUntilAdaptor extends WaitUntilAdaptor {
+  waitUntil(promise: Promise<void>): void;
+}
+//#endregion
 //#region src/on-cloudflare-workers.d.ts
 type CloudflareWorkersOptions = {
   readonly configs?: readonly ConfigClass<object>[];
@@ -29,5 +39,5 @@ type CloudflareWorkersApp = {
 };
 declare const onCloudflareWorkers: (app: HttpApp, options?: CloudflareWorkersOptions) => Promise<CloudflareWorkersApp>;
 //#endregion
-export { CloudflareBindingsService as CloudflareBindings, type CloudflareWorkersApp, CloudflareWorkersEnvAdaptor, type CloudflareWorkersOptions, onCloudflareWorkers };
+export { CloudflareBindingsService as CloudflareBindings, type CloudflareWorkersApp, CloudflareWorkersEnvAdaptor, type CloudflareWorkersOptions, CloudflareWorkersWaitUntilAdaptor, onCloudflareWorkers };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cloudflare-bindings.service.ts","../src/cloudflare-workers-env.adaptor.ts","../src/on-cloudflare-workers.ts"],"mappings":";;;cAKa,yBAAA;;EAEX,GAAA,iBAAoB,GAAA,CAAA,CAAK,GAAA,EAAK,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA;;;cCH3B,2BAAA,SAAoC,UAAA;EACtC,GAAA,CAAI,GAAA;AAAA;;;KCKH,wBAAA;EAAA,SACD,OAAA,YAAmB,WAAA;EAAA,SACnB,MAAA;AAAA;AAAA,KAGN,cAAA,GAAiB,UAAA,UAAoB,iBAAA;EAAA,SAC/B,IAAA,EAAM,gBAAA;AAAA;AAAA,KAGZ,OAAA;EAAA,SACM,aAAA,GAAgB,OAAA,GAAU,oBAAA,KAAyB,OAAA,CAAQ,cAAA;AAAA;AAAA,KAG1D,oBAAA;EAAA,SACD,GAAA,EAAK,cAAA;EAAA,SACL,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;EAAA,SACtE,QAAA,QAAgB,OAAA;AAAA;AAAA,cAGd,mBAAA,GACX,GAAA,EAAK,OAAA,EACL,OAAA,GAAS,wBAAA,KACR,OAAA,CAAQ,oBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cloudflare-bindings.service.ts","../src/cloudflare-workers-env.adaptor.ts","../src/cloudflare-workers-wait-until.adaptor.ts","../src/on-cloudflare-workers.ts"],"mappings":";;;cAKa,yBAAA;;EAEX,GAAA,iBAAoB,GAAA,CAAA,CAAK,GAAA,EAAK,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA;;;cCH3B,2BAAA,SAAoC,UAAA;EACtC,GAAA,CAAI,GAAA;AAAA;;;;;ADDf;;;cEKa,iCAAA,SAA0C,gBAAA;EAC5C,SAAA,CAAU,OAAA,EAAS,OAAA;AAAA;;;KCClB,wBAAA;EAAA,SACD,OAAA,YAAmB,WAAA;EAAA,SACnB,MAAA;AAAA;AAAA,KAGN,cAAA,GAAiB,UAAA,UAAoB,iBAAA;EAAA,SAC/B,IAAA,EAAM,gBAAA;AAAA;AAAA,KAGZ,OAAA;EAAA,SACM,aAAA,GAAgB,OAAA,GAAU,oBAAA,KAAyB,OAAA,CAAQ,cAAA;AAAA;AAAA,KAG1D,oBAAA;EAAA,SACD,GAAA,EAAK,cAAA;EAAA,SACL,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;EAAA,SACtE,QAAA,QAAgB,OAAA;AAAA;AAAA,cAGd,mBAAA,GACX,GAAA,EAAK,OAAA,EACL,OAAA,GAAS,wBAAA,KACR,OAAA,CAAQ,oBAAA"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Config, EnvAdaptor, Injectable, ZeltContextNotAvailableError } from "@zeltjs/core";
+import { Config, EnvAdaptor, Injectable, WaitUntilAdaptor, ZeltContextNotAvailableError } from "@zeltjs/core";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { env } from "cloudflare:workers";
 //#region src/cloudflare-runtime-context.lib.ts
@@ -12,9 +12,10 @@ const storage = new AsyncLocalStorage();
 	return context;
 };
 const runWithCloudflareRuntimeContext = (context, fn) => storage.run(context, fn);
+const tryGetCloudflareRuntimeContext = () => storage.getStore();
 //#endregion
 //#region src/cloudflare-bindings.service.ts
-function _ts_decorate$1(decorators, target, key, desc) {
+function _ts_decorate$2(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -25,10 +26,10 @@ var CloudflareBindingsService = class {
 		return getCloudflareRuntimeContext().env[key];
 	}
 };
-CloudflareBindingsService = _ts_decorate$1([Injectable()], CloudflareBindingsService);
+CloudflareBindingsService = _ts_decorate$2([Injectable()], CloudflareBindingsService);
 //#endregion
 //#region src/cloudflare-workers-env.adaptor.ts
-function _ts_decorate(decorators, target, key, desc) {
+function _ts_decorate$1(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -40,13 +41,27 @@ var CloudflareWorkersEnvAdaptor = class extends EnvAdaptor {
 		return typeof value === "string" ? value : void 0;
 	}
 };
-CloudflareWorkersEnvAdaptor = _ts_decorate([Config], CloudflareWorkersEnvAdaptor);
+CloudflareWorkersEnvAdaptor = _ts_decorate$1([Config], CloudflareWorkersEnvAdaptor);
+//#endregion
+//#region src/cloudflare-workers-wait-until.adaptor.ts
+function _ts_decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+var CloudflareWorkersWaitUntilAdaptor = class extends WaitUntilAdaptor {
+	waitUntil(promise) {
+		tryGetCloudflareRuntimeContext()?.ctx.waitUntil(promise);
+	}
+};
+CloudflareWorkersWaitUntilAdaptor = _ts_decorate([Config], CloudflareWorkersWaitUntilAdaptor);
 //#endregion
 //#region src/on-cloudflare-workers.ts
 const onCloudflareWorkers = async (app, options = {}) => {
 	const readyApp = await app.createRuntime({
 		...options.configs === void 0 ? {} : { configs: options.configs },
-		fallbackConfigs: [CloudflareWorkersEnvAdaptor],
+		fallbackConfigs: [CloudflareWorkersEnvAdaptor, CloudflareWorkersWaitUntilAdaptor],
 		warmup: options.warmup ?? false
 	});
 	const fetch = async (request, env, ctx) => {
@@ -64,6 +79,6 @@ const onCloudflareWorkers = async (app, options = {}) => {
 	};
 };
 //#endregion
-export { CloudflareBindingsService as CloudflareBindings, CloudflareWorkersEnvAdaptor, onCloudflareWorkers };
+export { CloudflareBindingsService as CloudflareBindings, CloudflareWorkersEnvAdaptor, CloudflareWorkersWaitUntilAdaptor, onCloudflareWorkers };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["AsyncLocalStorage","ZeltContextNotAvailableError","storage","getCloudflareRuntimeContext","context","getStore","primitive","requiredContext","runWithCloudflareRuntimeContext","fn","run","Injectable","getCloudflareRuntimeContext","CloudflareBindingsService","get","key","env","env","Config","EnvAdaptor","CloudflareWorkersEnvAdaptor","get","key","value","Reflect","undefined","runWithCloudflareRuntimeContext","CloudflareWorkersEnvAdaptor","onCloudflareWorkers","app","options","readyApp","createRuntime","configs","undefined","fallbackConfigs","warmup","fetch","request","env","ctx","response","http","waitUntil","then","get","shutdown"],"sources":["../src/cloudflare-runtime-context.lib.ts","../src/cloudflare-bindings.service.ts","../src/cloudflare-workers-env.adaptor.ts","../src/on-cloudflare-workers.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { ZeltContextNotAvailableError } from '@zeltjs/core';\n\nexport type CloudflareRuntimeContext = {\n  readonly env: Env;\n  readonly ctx: ExecutionContext;\n};\n\nconst storage = new AsyncLocalStorage<CloudflareRuntimeContext>();\n\n/** @throws {ZeltContextNotAvailableError} */\nexport const getCloudflareRuntimeContext = (): CloudflareRuntimeContext => {\n  const context = storage.getStore();\n  if (!context) {\n    throw new ZeltContextNotAvailableError({\n      primitive: 'CloudflareBindings.get',\n      requiredContext: 'entry',\n    });\n  }\n  return context;\n};\n\nexport const runWithCloudflareRuntimeContext = <T>(\n  context: CloudflareRuntimeContext,\n  fn: () => T,\n): T => storage.run(context, fn);\n\ndeclare global {\n  interface Env {}\n}\n","import { Injectable } from '@zeltjs/core';\n\nimport { getCloudflareRuntimeContext } from './cloudflare-runtime-context.lib';\n\n@Injectable()\nexport class CloudflareBindingsService {\n  /** @throws {ZeltContextNotAvailableError} */\n  get<K extends keyof Env>(key: K): Env[K] {\n    return getCloudflareRuntimeContext().env[key];\n  }\n}\n","import { env } from 'cloudflare:workers';\nimport { Config, EnvAdaptor } from '@zeltjs/core';\n\n@Config\nexport class CloudflareWorkersEnvAdaptor extends EnvAdaptor {\n  override get(key: string): string | undefined {\n    const value: unknown = Reflect.get(env, key);\n    return typeof value === 'string' ? value : undefined;\n  }\n}\n","import type {\n  ConfigClass,\n  ConfiguredFeature,\n  CreateRuntimeOptions,\n  HttpCapabilities,\n  RuntimeApp,\n} from '@zeltjs/core';\nimport { runWithCloudflareRuntimeContext } from './cloudflare-runtime-context.lib';\nimport { CloudflareWorkersEnvAdaptor } from './cloudflare-workers-env.adaptor';\n\nexport type CloudflareWorkersOptions = {\n  readonly configs?: readonly ConfigClass<object>[];\n  readonly warmup?: boolean;\n};\n\ntype HttpRuntimeApp = RuntimeApp<readonly ConfiguredFeature[]> & {\n  readonly http: HttpCapabilities;\n};\n\ntype HttpApp = {\n  readonly createRuntime: (options?: CreateRuntimeOptions) => Promise<HttpRuntimeApp>;\n};\n\nexport type CloudflareWorkersApp = {\n  readonly get: HttpRuntimeApp['get'];\n  readonly fetch: (request: Request, env: Env, ctx: ExecutionContext) => Promise<Response>;\n  readonly shutdown: () => Promise<void>;\n};\n\nexport const onCloudflareWorkers = async (\n  app: HttpApp,\n  options: CloudflareWorkersOptions = {},\n): Promise<CloudflareWorkersApp> => {\n  const readyApp = await app.createRuntime({\n    ...(options.configs === undefined ? {} : { configs: options.configs }),\n    fallbackConfigs: [CloudflareWorkersEnvAdaptor],\n    warmup: options.warmup ?? false,\n  });\n\n  const fetch = async (request: Request, env: Env, ctx: ExecutionContext): Promise<Response> => {\n    const response = runWithCloudflareRuntimeContext({ env, ctx }, () =>\n      readyApp.http.fetch(request),\n    );\n    ctx.waitUntil(response.then(() => {}));\n    return response;\n  };\n\n  return { get: readyApp.get, fetch, shutdown: readyApp.shutdown };\n};\n"],"mappings":";;;;AAQA,MAAME,UAAU,IAAIF,mBAAAA;8CAGpB,MAAaG,oCAA8B;CACzC,MAAMC,UAAUF,QAAQG,UAAQ;AAChC,KAAI,CAACD,QACH,OAAM,IAAIH,6BAA6B;EACrCK,WAAW;EACXC,iBAAiB;EACnB,CAAA;AAEF,QAAOH;;AAGT,MAAaI,mCACXJ,SACAK,OACMP,QAAQQ,IAAIN,SAASK,GAAAA;;;;;;;;;ACpB7B,IAAaI,4BAAb,MAAaA;+CAEXC,IAAyBC,KAAgB;AACvC,SAAOH,6BAAAA,CAA8BI,IAAID;;;;;;;;;;;;ACJ7C,IAAaK,8BAAb,cAAiDD,WAAAA;CACtCE,IAAIC,KAAiC;EAC5C,MAAMC,QAAiBC,QAAQH,IAAIJ,KAAKK,IAAAA;AACxC,SAAO,OAAOC,UAAU,WAAWA,QAAQE,KAAAA;;;;;;ACsB/C,MAAaG,sBAAsB,OACjCC,KACAC,UAAoC,EAAE,KAAA;CAEtC,MAAMC,WAAW,MAAMF,IAAIG,cAAc;EACvC,GAAIF,QAAQG,YAAYC,KAAAA,IAAY,EAAC,GAAI,EAAED,SAASH,QAAQG,SAAS;EACrEE,iBAAiB,CAACR,4BAA4B;EAC9CS,QAAQN,QAAQM,UAAU;EAC5B,CAAA;CAEA,MAAMC,QAAQ,OAAOC,SAAkBC,KAAUC,QAAAA;EAC/C,MAAMC,WAAWf,gCAAgC;GAAEa;GAAKC;GAAI,QAC1DT,SAASW,KAAKL,MAAMC,QAAAA,CAAAA;AAEtBE,MAAIG,UAAUF,SAASG,WAAK,GAAO,CAAA;AACnC,SAAOH;;AAGT,QAAO;EAAEI,KAAKd,SAASc;EAAKR;EAAOS,UAAUf,SAASe;EAAS"}
+{"version":3,"file":"index.js","names":["AsyncLocalStorage","ZeltContextNotAvailableError","storage","getCloudflareRuntimeContext","context","getStore","primitive","requiredContext","runWithCloudflareRuntimeContext","fn","run","tryGetCloudflareRuntimeContext","Injectable","getCloudflareRuntimeContext","CloudflareBindingsService","get","key","env","env","Config","EnvAdaptor","CloudflareWorkersEnvAdaptor","get","key","value","Reflect","undefined","Config","WaitUntilAdaptor","tryGetCloudflareRuntimeContext","CloudflareWorkersWaitUntilAdaptor","waitUntil","promise","ctx","runWithCloudflareRuntimeContext","CloudflareWorkersEnvAdaptor","CloudflareWorkersWaitUntilAdaptor","onCloudflareWorkers","app","options","readyApp","createRuntime","configs","undefined","fallbackConfigs","warmup","fetch","request","env","ctx","response","http","waitUntil","then","get","shutdown"],"sources":["../src/cloudflare-runtime-context.lib.ts","../src/cloudflare-bindings.service.ts","../src/cloudflare-workers-env.adaptor.ts","../src/cloudflare-workers-wait-until.adaptor.ts","../src/on-cloudflare-workers.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { ZeltContextNotAvailableError } from '@zeltjs/core';\n\nexport type CloudflareRuntimeContext = {\n  readonly env: Env;\n  readonly ctx: ExecutionContext;\n};\n\nconst storage = new AsyncLocalStorage<CloudflareRuntimeContext>();\n\n/** @throws {ZeltContextNotAvailableError} */\nexport const getCloudflareRuntimeContext = (): CloudflareRuntimeContext => {\n  const context = storage.getStore();\n  if (!context) {\n    throw new ZeltContextNotAvailableError({\n      primitive: 'CloudflareBindings.get',\n      requiredContext: 'entry',\n    });\n  }\n  return context;\n};\n\nexport const runWithCloudflareRuntimeContext = <T>(\n  context: CloudflareRuntimeContext,\n  fn: () => T,\n): T => storage.run(context, fn);\n\nexport const tryGetCloudflareRuntimeContext = (): CloudflareRuntimeContext | undefined =>\n  storage.getStore();\n\ndeclare global {\n  interface Env {}\n}\n","import { Injectable } from '@zeltjs/core';\n\nimport { getCloudflareRuntimeContext } from './cloudflare-runtime-context.lib';\n\n@Injectable()\nexport class CloudflareBindingsService {\n  /** @throws {ZeltContextNotAvailableError} */\n  get<K extends keyof Env>(key: K): Env[K] {\n    return getCloudflareRuntimeContext().env[key];\n  }\n}\n","import { env } from 'cloudflare:workers';\nimport { Config, EnvAdaptor } from '@zeltjs/core';\n\n@Config\nexport class CloudflareWorkersEnvAdaptor extends EnvAdaptor {\n  override get(key: string): string | undefined {\n    const value: unknown = Reflect.get(env, key);\n    return typeof value === 'string' ? value : undefined;\n  }\n}\n","import { Config, WaitUntilAdaptor } from '@zeltjs/core';\nimport { tryGetCloudflareRuntimeContext } from './cloudflare-runtime-context.lib';\n\n/**\n * Only extends execution while inside a request handled via onCloudflareWorkers'\n * fetch (the ALS scope); outside it (future cron/queue/DO entry points) this is\n * a silent no-op and tasks may be killed when the event settles.\n */\n@Config\nexport class CloudflareWorkersWaitUntilAdaptor extends WaitUntilAdaptor {\n  override waitUntil(promise: Promise<void>): void {\n    tryGetCloudflareRuntimeContext()?.ctx.waitUntil(promise);\n  }\n}\n","import type {\n  ConfigClass,\n  ConfiguredFeature,\n  CreateRuntimeOptions,\n  HttpCapabilities,\n  RuntimeApp,\n} from '@zeltjs/core';\nimport { runWithCloudflareRuntimeContext } from './cloudflare-runtime-context.lib';\nimport { CloudflareWorkersEnvAdaptor } from './cloudflare-workers-env.adaptor';\nimport { CloudflareWorkersWaitUntilAdaptor } from './cloudflare-workers-wait-until.adaptor';\n\nexport type CloudflareWorkersOptions = {\n  readonly configs?: readonly ConfigClass<object>[];\n  readonly warmup?: boolean;\n};\n\ntype HttpRuntimeApp = RuntimeApp<readonly ConfiguredFeature[]> & {\n  readonly http: HttpCapabilities;\n};\n\ntype HttpApp = {\n  readonly createRuntime: (options?: CreateRuntimeOptions) => Promise<HttpRuntimeApp>;\n};\n\nexport type CloudflareWorkersApp = {\n  readonly get: HttpRuntimeApp['get'];\n  readonly fetch: (request: Request, env: Env, ctx: ExecutionContext) => Promise<Response>;\n  readonly shutdown: () => Promise<void>;\n};\n\nexport const onCloudflareWorkers = async (\n  app: HttpApp,\n  options: CloudflareWorkersOptions = {},\n): Promise<CloudflareWorkersApp> => {\n  const readyApp = await app.createRuntime({\n    ...(options.configs === undefined ? {} : { configs: options.configs }),\n    fallbackConfigs: [CloudflareWorkersEnvAdaptor, CloudflareWorkersWaitUntilAdaptor],\n    warmup: options.warmup ?? false,\n  });\n\n  const fetch = async (request: Request, env: Env, ctx: ExecutionContext): Promise<Response> => {\n    const response = runWithCloudflareRuntimeContext({ env, ctx }, () =>\n      readyApp.http.fetch(request),\n    );\n    ctx.waitUntil(response.then(() => {}));\n    return response;\n  };\n\n  return { get: readyApp.get, fetch, shutdown: readyApp.shutdown };\n};\n"],"mappings":";;;;AAQA,MAAME,UAAU,IAAIF,mBAAAA;8CAGpB,MAAaG,oCAA8B;CACzC,MAAMC,UAAUF,QAAQG,UAAQ;AAChC,KAAI,CAACD,QACH,OAAM,IAAIH,6BAA6B;EACrCK,WAAW;EACXC,iBAAiB;EACnB,CAAA;AAEF,QAAOH;;AAGT,MAAaI,mCACXJ,SACAK,OACMP,QAAQQ,IAAIN,SAASK,GAAAA;AAE7B,MAAaE,uCACXT,QAAQG,UAAQ;;;;;;;;;ACvBlB,IAAaS,4BAAb,MAAaA;+CAEXC,IAAyBC,KAAgB;AACvC,SAAOH,6BAAAA,CAA8BI,IAAID;;;;;;;;;;;;ACJ7C,IAAaK,8BAAb,cAAiDD,WAAAA;CACtCE,IAAIC,KAAiC;EAC5C,MAAMC,QAAiBC,QAAQH,IAAIJ,KAAKK,IAAAA;AACxC,SAAO,OAAOC,UAAU,WAAWA,QAAQE,KAAAA;;;;;;;;;;;;ACE/C,IAAaI,oCAAb,cAAuDF,iBAAAA;CAC5CG,UAAUC,SAA8B;AAC/CH,kCAAAA,EAAkCI,IAAIF,UAAUC,QAAAA;;;;;;ACmBpD,MAAaK,sBAAsB,OACjCC,KACAC,UAAoC,EAAE,KAAA;CAEtC,MAAMC,WAAW,MAAMF,IAAIG,cAAc;EACvC,GAAIF,QAAQG,YAAYC,KAAAA,IAAY,EAAC,GAAI,EAAED,SAASH,QAAQG,SAAS;EACrEE,iBAAiB,CAACT,6BAA6BC,kCAAkC;EACjFS,QAAQN,QAAQM,UAAU;EAC5B,CAAA;CAEA,MAAMC,QAAQ,OAAOC,SAAkBC,KAAUC,QAAAA;EAC/C,MAAMC,WAAWhB,gCAAgC;GAAEc;GAAKC;GAAI,QAC1DT,SAASW,KAAKL,MAAMC,QAAAA,CAAAA;AAEtBE,MAAIG,UAAUF,SAASG,WAAK,GAAO,CAAA;AACnC,SAAOH;;AAGT,QAAO;EAAEI,KAAKd,SAASc;EAAKR;EAAOS,UAAUf,SAASe;EAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeltjs/adapter-cloudflare-workers",
-  "version": "0.10.0",
+  "version": "0.10.1-canary.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "dist"
   ],
   "dependencies": {
-    "@zeltjs/core": "0.10.0"
+    "@zeltjs/core": "0.10.1-canary.0"
   },
   "devDependencies": {
     "@types/node": "22.19.17",