otok-adapter-cloudflare 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kamod
+
+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

@@ -0,0 +1,40 @@
+# otok-adapter-cloudflare
+
+Cloudflare Workers deployment adapter for [Otok](https://github.com/kamod-ch/otok).
+
+## Usage
+
+```ts
+import { defineConfig } from "@kamod-ch/otok";
+import cloudflare from "otok-adapter-cloudflare";
+
+export default defineConfig({
+  adapter: cloudflare({
+    outDir: "dist",
+    wranglerName: "my-otok-app",
+  }),
+});
+```
+
+## Features
+
+- Worker-compatible SSR bundle (`ssr.target: webworker`)
+- Web-standard APIs only in the worker output
+- Generates `wrangler.toml` with Workers Assets binding
+- Typed bindings via Wrangler env (extend with `envSchema` in custom plugins)
+- No Node-only imports in the worker bundle
+
+## Deploy
+
+```bash
+pnpm build
+pnpm exec wrangler deploy
+```
+
+See `examples/adapters/cloudflare/`.
+
+## Capabilities
+
+`ssr`, `streaming`, `middleware`, `server-actions`, `islands`, `static-assets`, `env-bindings`, `worker-fetch`
+
+**Not available:** `node-apis`, `filesystem`, `process-env`, `graceful-shutdown`

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { type AdapterBuildContext } from "@kamod-ch/otok-config";
+export interface CloudflareAdapterOptions {
+    outDir?: string;
+    /** Wrangler project name. Defaults to the package directory name. */
+    wranglerName?: string;
+    /** Compatibility date for generated wrangler.toml. */
+    compatibilityDate?: string;
+    /** Project-relative worker entry. Generated when omitted. */
+    workerEntry?: string;
+    /** Client entry path passed to createOtokWorkerApp. */
+    clientEntry?: string;
+    /**
+     * Cloudflare KV binding name used for HTML response caching via `EdgeKvCacheProvider`.
+     * When set, wrangler.toml gets a `[[kv_namespaces]]` stub and the worker wires the provider per request.
+     */
+    cacheKvBinding?: string;
+}
+declare const GENERATED_WORKER_ENTRY = "src/otok.generated.worker.ts";
+declare function outputDirs(options: CloudflareAdapterOptions): {
+    root: string;
+    client: string;
+    server: string;
+};
+declare function generatedWorkerSource(options: CloudflareAdapterOptions): string;
+declare function generatedWranglerToml(options: CloudflareAdapterOptions, ctx: AdapterBuildContext): string;
+declare const cloudflareAdapterFactory: (options?: CloudflareAdapterOptions | undefined) => import("@kamod-ch/otok-config").OtokAdapter<CloudflareAdapterOptions>;
+/** Cloudflare Workers adapter with worker-safe bundles and Workers Assets. */
+export default function cloudflare(options?: CloudflareAdapterOptions): import("@kamod-ch/otok-config").OtokAdapter<CloudflareAdapterOptions>;
+export { cloudflare, cloudflareAdapterFactory, GENERATED_WORKER_ENTRY, generatedWorkerSource, generatedWranglerToml, outputDirs as cloudflareOutputDirs, };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4C,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE3G,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAcD,QAAA,MAAM,sBAAsB,iCAAiC,CAAC;AAE9D,iBAAS,UAAU,CAAC,OAAO,EAAE,wBAAwB;;;;EAOpD;AAED,iBAAS,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAgDxE;AAED,iBAAS,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAwBlG;AAaD,QAAA,MAAM,wBAAwB,2HA6D5B,CAAC;AAEH,8EAA8E;AAC9E,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAO,GAAE,wBAA6B,yEAExE;AAED,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,IAAI,oBAAoB,GACnC,CAAC"}

package/dist/index.js

@@ -0,0 +1,169 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createDualBuildVitePlugin, defineAdapter } from "@kamod-ch/otok-config";
+const CF_CAPABILITIES = [
+    "ssr",
+    "streaming",
+    "middleware",
+    "server-actions",
+    "islands",
+    "static-assets",
+    "env-bindings",
+    "worker-fetch",
+];
+const DEFAULT_OUT_DIR = "dist";
+const GENERATED_WORKER_ENTRY = "src/otok.generated.worker.ts";
+function outputDirs(options) {
+    const root = options.outDir ?? DEFAULT_OUT_DIR;
+    return {
+        root,
+        client: path.posix.join(root, "client"),
+        server: path.posix.join(root, "server"),
+    };
+}
+function generatedWorkerSource(options) {
+    const clientEntry = options.clientEntry ?? "src/client.ts";
+    const kvBinding = options.cacheKvBinding;
+    const cacheImports = kvBinding
+        ? `\nimport { setCacheProvider, EdgeKvCacheProvider } from "@kamod-ch/otok/cache";`
+        : "";
+    const fetchWrapper = kvBinding
+        ? `
+type Env = {
+  ${kvBinding}: {
+    get(key: string, type?: "text"): Promise<string | null>;
+    put(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>;
+    delete(key: string): Promise<void>;
+  };
+  ASSETS?: Fetcher;
+};
+
+export default {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
+    setCacheProvider(new EdgeKvCacheProvider({ namespace: env.${kvBinding} }));
+    return app.fetch(request, env, ctx);
+  },
+};
+`
+        : `
+export default app;
+`;
+    return `import { createOtokWorkerApp, resolveOtokManifest, type ViteManifest } from "@kamod-ch/otok/server";
+import { errorRoute, notFoundRoute, routes } from "virtual:otok-routes";
+import clientManifest from "../dist/client/.vite/manifest.json";${cacheImports}
+
+/**
+ * Cloudflare Worker entry generated by otok-adapter-cloudflare.
+ * Hashed assets are served from Workers Assets (see wrangler.toml).
+ */
+const app = createOtokWorkerApp({
+  routes,
+  notFoundRoute,
+  errorRoute,
+  manifest: resolveOtokManifest(clientManifest as ViteManifest, { prodOnly: false }),
+  clientEntry: ${JSON.stringify(clientEntry)},
+  health: { ok: true, runtime: "cloudflare", adapter: "otok-adapter-cloudflare" },
+  streaming: true,
+});
+${fetchWrapper}`;
+}
+function generatedWranglerToml(options, ctx) {
+    const outDirs = outputDirs(options);
+    const name = options.wranglerName ?? path.basename(ctx.root);
+    const compatibilityDate = options.compatibilityDate ?? "2025-04-01";
+    const kvBinding = options.cacheKvBinding;
+    const kvSection = kvBinding
+        ? `
+# HTML response cache (replace id after wrangler kv namespace create)
+[[kv_namespaces]]
+binding = ${JSON.stringify(kvBinding)}
+id = "REPLACE_WITH_KV_NAMESPACE_ID"
+`
+        : "";
+    return `name = ${JSON.stringify(name)}
+main = ${JSON.stringify(path.posix.join(outDirs.server, "server.js"))}
+compatibility_date = ${JSON.stringify(compatibilityDate)}
+
+# Hashed Vite client assets. HTML is rendered by the Worker.
+[assets]
+directory = ${JSON.stringify(`./${outDirs.client}`)}
+binding = "ASSETS"
+${kvSection}`;
+}
+async function writeGeneratedArtifacts(ctx, options) {
+    if (!options.workerEntry) {
+        const workerPath = path.resolve(ctx.root, GENERATED_WORKER_ENTRY);
+        fs.mkdirSync(path.dirname(workerPath), { recursive: true });
+        fs.writeFileSync(workerPath, generatedWorkerSource(options));
+    }
+    const wranglerPath = path.resolve(ctx.root, "wrangler.toml");
+    fs.writeFileSync(wranglerPath, generatedWranglerToml(options, ctx));
+}
+const cloudflareAdapterFactory = defineAdapter({
+    name: "otok-adapter-cloudflare",
+    runtime: "cloudflare",
+    capabilities: CF_CAPABILITIES,
+    build: {
+        clientEntry: "src/client.ts",
+        ssrEntry: GENERATED_WORKER_ENTRY,
+        ssrTarget: "webworker",
+        bundleDeps: true,
+        clientManifest: true,
+    },
+    outputDirs(options, _root) {
+        return outputDirs(options);
+    },
+    serverEntry(ctx) {
+        const options = ctx.options;
+        const entry = options.workerEntry ?? GENERATED_WORKER_ENTRY;
+        return { path: entry, generated: !options.workerEntry };
+    },
+    assets: {
+        assetsPath: "/assets",
+    },
+    environment: {
+        bindings: true,
+    },
+    ssr: {
+        supported: true,
+        streaming: true,
+    },
+    middleware: {
+        supported: true,
+    },
+    prerender: {
+        supported: false,
+    },
+    hooks: {
+        async buildStart(ctx) {
+            await writeGeneratedArtifacts(ctx, ctx.adapter.options);
+        },
+        async buildEnd(ctx) {
+            if (!ctx.isSsrBuild)
+                return;
+            await writeGeneratedArtifacts(ctx, ctx.adapter.options);
+        },
+    },
+    configureVite(ctx) {
+        const options = ctx.options;
+        const outDirs = outputDirs(options);
+        const workerEntry = options.workerEntry ?? GENERATED_WORKER_ENTRY;
+        return createDualBuildVitePlugin({
+            name: "otok-adapter-cloudflare",
+            outDirs,
+            build: {
+                clientEntry: options.clientEntry ?? "src/client.ts",
+                ssrEntry: workerEntry,
+                ssrTarget: "webworker",
+                bundleDeps: true,
+                clientManifest: true,
+            },
+        });
+    },
+});
+/** Cloudflare Workers adapter with worker-safe bundles and Workers Assets. */
+export default function cloudflare(options = {}) {
+    return cloudflareAdapterFactory(options);
+}
+export { cloudflare, cloudflareAdapterFactory, GENERATED_WORKER_ENTRY, generatedWorkerSource, generatedWranglerToml, outputDirs as cloudflareOutputDirs, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "otok-adapter-cloudflare",
+  "version": "1.0.1",
+  "description": "Cloudflare Workers deployment adapter for Otok with worker-safe bundles and Workers Assets.",
+  "license": "MIT",
+  "homepage": "https://github.com/kamod-ch/otok/tree/main/packages/otok-adapter-cloudflare#readme",
+  "bugs": {
+    "url": "https://github.com/kamod-ch/otok/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kamod-ch/otok.git",
+    "directory": "packages/otok-adapter-cloudflare"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@kamod-ch/otok": ">=0.6.1",
+    "vite": ">=6"
+  },
+  "dependencies": {
+    "@kamod-ch/otok-config": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.2",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.10",
+    "vitest": "^4.1.2",
+    "@kamod-ch/otok": "0.6.1",
+    "otok-adapter-contract": "0.1.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}