@zeltjs/adapter-cloudflare-workers 0.0.1 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 9wick / Kohei Kido
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,45 +1,69 @@
 # @zeltjs/adapter-cloudflare-workers
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Cloudflare Workers adapter for Zelt.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Installation
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+```bash
+pnpm add @zeltjs/adapter-cloudflare-workers
+```
 
-## Purpose
+## Usage
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@zeltjs/adapter-cloudflare-workers`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+```typescript
+import { createHttpApp, Controller, Get } from '@zeltjs/core';
+import { onCloudflareWorkers } from '@zeltjs/adapter-cloudflare-workers';
 
-## What is OIDC Trusted Publishing?
+@Controller('/hello')
+class HelloController {
+  @Get('/')
+  greet() {
+    return { message: 'Hello from Workers!' };
+  }
+}
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+const app = createHttpApp({ controllers: [HelloController] });
 
-## Setup Instructions
+const workers = await onCloudflareWorkers(app);
 
-To properly configure OIDC trusted publishing for this package:
+export default { fetch: workers.fetch };
+```
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+## Options
 
-## DO NOT USE THIS PACKAGE
+```typescript
+onCloudflareWorkers(app, {
+  warmup: false, // default: false (lazy mode for cold start optimization)
+});
+```
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+- `warmup: false` (default) - Controllers are resolved on first request (optimized for serverless)
+- `warmup: true` - All controllers are resolved during initialization
 
-## More Information
+## Environment Variables
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+When using `EnvConfig`, it is automatically replaced with `CloudflareWorkersEnvConfig` which reads from `cloudflare:workers` env:
 
----
+```typescript
+import { createHttpApp, Controller, Get, EnvConfig, EnvService, inject } from '@zeltjs/core';
+import { onCloudflareWorkers } from '@zeltjs/adapter-cloudflare-workers';
 
-**Maintained for OIDC setup purposes only**
+@Controller('/config')
+class ConfigController {
+  constructor(private env = inject(EnvService)) {}
+
+  @Get('/')
+  getApiHost() {
+    return { apiHost: this.env.get('API_HOST') };
+  }
+}
+
+const app = createHttpApp({
+  controllers: [ConfigController],
+  configs: [EnvConfig],
+});
+
+const workers = await onCloudflareWorkers(app);
+
+export default { fetch: workers.fetch };
+```

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { ControllerRouteInfo, EnvConfig, HttpApp, HttpMetadata, ReadyResult } from "@zeltjs/core";
+
+//#region src/cloudflare-workers-env.config.d.ts
+declare class CloudflareWorkersEnvConfig extends EnvConfig {
+  get(key: string): string | undefined;
+}
+//#endregion
+//#region src/on-cloudflare-workers.d.ts
+type DynamicMeta = HttpMetadata;
+type CloudflareWorkersOptions = {
+  readonly warmup?: boolean;
+  readonly dynamic?: boolean;
+};
+type BaseCloudflareWorkersApp = ReadyResult & {
+  readonly fetch: (request: Request, env: unknown, ctx: ExecutionContext) => Promise<Response>;
+  readonly shutdown: () => Promise<void>;
+};
+type CloudflareWorkersApp = BaseCloudflareWorkersApp & {
+  readonly __dynamicMeta?: DynamicMeta;
+};
+declare const onCloudflareWorkers: (app: HttpApp, options?: CloudflareWorkersOptions) => Promise<CloudflareWorkersApp>;
+//#endregion
+export { type CloudflareWorkersApp, CloudflareWorkersEnvConfig, type CloudflareWorkersOptions, type ControllerRouteInfo, type DynamicMeta, type HttpMetadata, onCloudflareWorkers };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/cloudflare-workers-env.config.ts","../src/on-cloudflare-workers.ts"],"mappings":";;;cAIa,0BAAA,SAAmC,SAAA;EACrC,GAAA,CAAI,GAAA;AAAA;;;KCOH,WAAA,GAAc,YAAA;AAAA,KAEd,wBAAA;EAAA,SACD,MAAA;EAAA,SACA,OAAA;AAAA;AAAA,KAGN,wBAAA,GAA2B,WAAA;EAAA,SACrB,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,WAAc,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;EAAA,SAC1E,QAAA,QAAgB,OAAA;AAAA;AAAA,KAGf,oBAAA,GAAuB,wBAAA;EAAA,SACxB,aAAA,GAAgB,WAAA;AAAA;AAAA,cAGd,mBAAA,GACX,GAAA,EAAK,OAAA,EACL,OAAA,GAAS,wBAAA,KACR,OAAA,CAAQ,oBAAA"}

package/dist/index.js

@@ -0,0 +1,47 @@
+import { env } from "cloudflare:workers";
+import { Config, EnvConfig } from "@zeltjs/core";
+//#region \0@oxc-project+runtime@0.127.0/helpers/decorate.js
+function __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;
+}
+//#endregion
+//#region src/cloudflare-workers-env.config.ts
+let CloudflareWorkersEnvConfig = class CloudflareWorkersEnvConfig extends EnvConfig {
+	get(key) {
+		const value = env[key];
+		return typeof value === "string" ? value : void 0;
+	}
+};
+CloudflareWorkersEnvConfig = __decorate([Config], CloudflareWorkersEnvConfig);
+//#endregion
+//#region src/on-cloudflare-workers.ts
+const onCloudflareWorkers = async (app, options = {}) => {
+	app.addFallbackConfig(CloudflareWorkersEnvConfig);
+	const readyOptions = { warmup: options.warmup ?? false };
+	const resolver = await app.ready(readyOptions);
+	const fetch = async (request, _env, ctx) => {
+		const response = app.fetch(request);
+		ctx.waitUntil(response.then(() => {}));
+		return response;
+	};
+	const base = {
+		...resolver,
+		fetch,
+		shutdown: app.shutdown
+	};
+	if (options.dynamic) {
+		const __dynamicMeta = app.getMetadata();
+		return {
+			...base,
+			__dynamicMeta
+		};
+	}
+	return base;
+};
+//#endregion
+export { CloudflareWorkersEnvConfig, onCloudflareWorkers };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/cloudflare-workers-env.config.ts","../src/on-cloudflare-workers.ts"],"sourcesContent":["import { env } from 'cloudflare:workers';\nimport { Config, EnvConfig } from '@zeltjs/core';\n\n@Config\nexport class CloudflareWorkersEnvConfig extends EnvConfig {\n  override get(key: string): string | undefined {\n    const value: unknown = (env as Record<string, unknown>)[key];\n    return typeof value === 'string' ? value : undefined;\n  }\n}\n","import type {\n  ControllerRouteInfo,\n  HttpApp,\n  HttpMetadata,\n  ReadyOptions,\n  ReadyResult,\n} from '@zeltjs/core';\n\nimport { CloudflareWorkersEnvConfig } from './cloudflare-workers-env.config';\n\nexport type { ControllerRouteInfo, HttpMetadata };\n\nexport type DynamicMeta = HttpMetadata;\n\nexport type CloudflareWorkersOptions = {\n  readonly warmup?: boolean;\n  readonly dynamic?: boolean;\n};\n\ntype BaseCloudflareWorkersApp = ReadyResult & {\n  readonly fetch: (request: Request, env: unknown, ctx: ExecutionContext) => Promise<Response>;\n  readonly shutdown: () => Promise<void>;\n};\n\nexport type CloudflareWorkersApp = BaseCloudflareWorkersApp & {\n  readonly __dynamicMeta?: DynamicMeta;\n};\n\nexport const onCloudflareWorkers = async (\n  app: HttpApp,\n  options: CloudflareWorkersOptions = {},\n): Promise<CloudflareWorkersApp> => {\n  app.addFallbackConfig(CloudflareWorkersEnvConfig);\n\n  const readyOptions: ReadyOptions = { warmup: options.warmup ?? false };\n  const resolver = await app.ready(readyOptions);\n\n  const fetch = async (\n    request: Request,\n    _env: unknown,\n    ctx: ExecutionContext,\n  ): Promise<Response> => {\n    const response = app.fetch(request);\n    ctx.waitUntil(response.then(() => {}));\n    return response;\n  };\n\n  const base: BaseCloudflareWorkersApp = { ...resolver, fetch, shutdown: app.shutdown };\n\n  if (options.dynamic) {\n    const __dynamicMeta = app.getMetadata();\n    return { ...base, __dynamicMeta };\n  }\n\n  return base;\n};\n"],"mappings":";;;;;;;;;;;AAIO,IAAA,6BAAA,MAAM,mCAAmC,UAAU;CACxD,IAAa,KAAiC;EAC5C,MAAM,QAAkB,IAAgC;AACxD,SAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;;;yCAJ9C,OAAA,EAAA,2BAAA;;;ACyBD,MAAa,sBAAsB,OACjC,KACA,UAAoC,EAAE,KACJ;AAClC,KAAI,kBAAkB,2BAA2B;CAEjD,MAAM,eAA6B,EAAE,QAAQ,QAAQ,UAAU,OAAO;CACtE,MAAM,WAAW,MAAM,IAAI,MAAM,aAAa;CAE9C,MAAM,QAAQ,OACZ,SACA,MACA,QACsB;EACtB,MAAM,WAAW,IAAI,MAAM,QAAQ;AACnC,MAAI,UAAU,SAAS,WAAW,GAAG,CAAC;AACtC,SAAO;;CAGT,MAAM,OAAiC;EAAE,GAAG;EAAU;EAAO,UAAU,IAAI;EAAU;AAErF,KAAI,QAAQ,SAAS;EACnB,MAAM,gBAAgB,IAAI,aAAa;AACvC,SAAO;GAAE,GAAG;GAAM;GAAe;;AAGnC,QAAO"}

package/package.json

@@ -1,10 +1,37 @@
 {
   "name": "@zeltjs/adapter-cloudflare-workers",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @zeltjs/adapter-cloudflare-workers",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+  "version": "0.4.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeltjs/zelt.git",
+    "directory": "packages/adapter-cloudflare-workers"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@zeltjs/core": "0.4.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "4.20250523.0"
+  },
+  "volta": {
+    "extends": "../../package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc -b"
+  }
+}