@aihu/adapter-cloudflare 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fellwork
+
+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,32 @@
+# @aihu/adapter-cloudflare
+
+> Cloudflare Workers/Pages deployment adapter for @aihu/app.
+
+Part of the [aihu](https://github.com/fellwork/aihu) framework — agentic discovery and interaction, for human purpose.
+
+## Install
+
+```bash
+npm install @aihu/adapter-cloudflare
+# or
+bun add @aihu/adapter-cloudflare
+```
+
+## Usage
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import { aihu } from '@aihu/app';
+import cloudflare from '@aihu/adapter-cloudflare';
+
+export default defineConfig({ plugins: [aihu({ adapter: cloudflare() })] });
+```
+
+## Status
+
+Early access (`0.1.x`). API may evolve before v1.1 GA. See the [v1.1 roadmap](https://github.com/fellwork/aihu/tree/main/docs/roadmap) for stability commitments.
+
+## License
+
+MIT — see [LICENSE](https://github.com/fellwork/aihu/blob/main/LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { AihuAdapter } from "@aihu/app";
+
+//#region src/index.d.ts
+interface CloudflareAdapterOptions {
+  /**
+   * Cloudflare Worker name. Used in generated wrangler.toml.
+   * Default: value of "name" in the project's package.json, or 'aihu-app'.
+   */
+  name?: string;
+  /**
+   * Deployment mode.
+   * - 'workers': Cloudflare Workers with static assets via env.ASSETS binding
+   * - 'pages': Cloudflare Pages (_worker.js convention — same output, different deploy target)
+   * Default: 'workers'
+   */
+  mode?: 'workers' | 'pages';
+  /**
+   * Whether to write wrangler.toml in the project root if it does not exist.
+   * Never overwrites an existing wrangler.toml.
+   * Default: true
+   */
+  generateWrangler?: boolean;
+}
+/**
+ * Cloudflare Workers / Pages adapter for aihu.
+ *
+ * Writes `_worker.js` to the Vite output directory and optionally creates
+ * `wrangler.toml` in the project root (if absent).
+ *
+ * @example
+ * // aihu.config.ts
+ * import { defineConfig } from '@aihu/app'
+ * import { cloudflare } from '@aihu/adapter-cloudflare'
+ *
+ * export default defineConfig({
+ *   adapter: cloudflare({ name: 'my-worker' }),
+ * })
+ */
+declare function cloudflare(options?: CloudflareAdapterOptions): AihuAdapter;
+//#endregion
+export { CloudflareAdapterOptions, cloudflare };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;UAIiB,wBAAA;;AAAjB;;;EAKE,IAAA;EAAA;;;;;AAmFF;EA5EE,IAAA;;;;;;EAMA,gBAAA;AAAA;;;;;;;;;;;;;;;;iBAsEc,UAAA,CAAW,OAAA,GAAU,wBAAA,GAA2B,WAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import{existsSync as e,readFileSync as t}from"node:fs";import{resolve as n}from"node:path";function r(r){let i=n(r,`package.json`);if(!e(i))return null;try{let e=JSON.parse(t(i,`utf8`));return typeof e.name==`string`?e.name:null}catch{return null}}function i(){return[`// AUTO-GENERATED by @aihu/adapter-cloudflare — do not edit`,`// Cloudflare Workers entry — SPA mode`,`//`,`// All page requests are served from the ASSETS binding (Cloudflare CDN).`,`// For SSR mode, upgrade to @aihu/adapter-cloudflare with ssr: true (V1+).`,``,`export default {`,`  async fetch(request, env, _ctx) {`,`    try {`,`      return await env.ASSETS.fetch(request)`,`    } catch {`,`      // Fallback to index.html for client-side routing (404 from ASSETS).`,`      const url = new URL(request.url)`,`      const indexUrl = new URL('/index.html', url.origin)`,`      return env.ASSETS.fetch(new Request(indexUrl, request))`,`    }`,`  },`,`}`].join(`
+`)}function a(e){return[`# AUTO-GENERATED by @aihu/adapter-cloudflare`,`# Edit this file to customize your Worker configuration.`,`# Reference: https://developers.cloudflare.com/workers/wrangler/configuration/`,``,`name = "${e}"`,`main = "_worker.js"`,`compatibility_date = "2024-01-01"`,``,`[assets]`,`directory = "."`,`binding = "ASSETS"`].join(`
+`)+`
+`}function o(t){return{name:`cloudflare`,async adapt(o){let s=t?.name??r(o.root)??`aihu-app`,c=i();await o.emitFile(`_worker.js`,c),console.log(`[@aihu/adapter-cloudflare] Wrote _worker.js (SPA mode)`);let l=n(o.root,`wrangler.toml`);if(t?.generateWrangler!==!1&&!e(l)){let e=a(s);await o.writeFile(l,e),console.log(`[@aihu/adapter-cloudflare] Created wrangler.toml (name = "${s}")`)}console.log(`[@aihu/adapter-cloudflare] Build complete → ${o.outDir}`),console.log(`[@aihu/adapter-cloudflare] Deploy with: wrangler deploy --config wrangler.toml`)}}}export{o as cloudflare};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["resolvePath"],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { resolve as resolvePath } from 'node:path'\nimport type { AdapterContext, AihuAdapter } from '@aihu/app'\n\nexport interface CloudflareAdapterOptions {\n  /**\n   * Cloudflare Worker name. Used in generated wrangler.toml.\n   * Default: value of \"name\" in the project's package.json, or 'aihu-app'.\n   */\n  name?: string\n  /**\n   * Deployment mode.\n   * - 'workers': Cloudflare Workers with static assets via env.ASSETS binding\n   * - 'pages': Cloudflare Pages (_worker.js convention — same output, different deploy target)\n   * Default: 'workers'\n   */\n  mode?: 'workers' | 'pages'\n  /**\n   * Whether to write wrangler.toml in the project root if it does not exist.\n   * Never overwrites an existing wrangler.toml.\n   * Default: true\n   */\n  generateWrangler?: boolean\n}\n\nfunction readPackageJsonName(root: string): string | null {\n  const pkgPath = resolvePath(root, 'package.json')\n  if (!existsSync(pkgPath)) return null\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as { name?: string }\n    return typeof pkg.name === 'string' ? pkg.name : null\n  } catch {\n    return null\n  }\n}\n\nfunction generateWorkerEntry(): string {\n  return [\n    '// AUTO-GENERATED by @aihu/adapter-cloudflare — do not edit',\n    '// Cloudflare Workers entry — SPA mode',\n    '//',\n    '// All page requests are served from the ASSETS binding (Cloudflare CDN).',\n    '// For SSR mode, upgrade to @aihu/adapter-cloudflare with ssr: true (V1+).',\n    '',\n    'export default {',\n    '  async fetch(request, env, _ctx) {',\n    '    try {',\n    '      return await env.ASSETS.fetch(request)',\n    '    } catch {',\n    '      // Fallback to index.html for client-side routing (404 from ASSETS).',\n    '      const url = new URL(request.url)',\n    \"      const indexUrl = new URL('/index.html', url.origin)\",\n    '      return env.ASSETS.fetch(new Request(indexUrl, request))',\n    '    }',\n    '  },',\n    '}',\n  ].join('\\n')\n}\n\nfunction generateWranglerToml(name: string): string {\n  return (\n    [\n      '# AUTO-GENERATED by @aihu/adapter-cloudflare',\n      '# Edit this file to customize your Worker configuration.',\n      '# Reference: https://developers.cloudflare.com/workers/wrangler/configuration/',\n      '',\n      `name = \"${name}\"`,\n      'main = \"_worker.js\"',\n      'compatibility_date = \"2024-01-01\"',\n      '',\n      '[assets]',\n      'directory = \".\"',\n      'binding = \"ASSETS\"',\n    ].join('\\n') + '\\n'\n  )\n}\n\n/**\n * Cloudflare Workers / Pages adapter for aihu.\n *\n * Writes `_worker.js` to the Vite output directory and optionally creates\n * `wrangler.toml` in the project root (if absent).\n *\n * @example\n * // aihu.config.ts\n * import { defineConfig } from '@aihu/app'\n * import { cloudflare } from '@aihu/adapter-cloudflare'\n *\n * export default defineConfig({\n *   adapter: cloudflare({ name: 'my-worker' }),\n * })\n */\nexport function cloudflare(options?: CloudflareAdapterOptions): AihuAdapter {\n  return {\n    name: 'cloudflare',\n\n    async adapt(context: AdapterContext): Promise<void> {\n      const workerName = options?.name ?? readPackageJsonName(context.root) ?? 'aihu-app'\n\n      // Step 1 — Write _worker.js\n      const workerEntry = generateWorkerEntry()\n      await context.emitFile('_worker.js', workerEntry)\n      console.log(`[@aihu/adapter-cloudflare] Wrote _worker.js (SPA mode)`)\n\n      // Step 2 — Write wrangler.toml (only if absent, never overwrites)\n      const wranglerPath = resolvePath(context.root, 'wrangler.toml')\n      if (options?.generateWrangler !== false && !existsSync(wranglerPath)) {\n        const toml = generateWranglerToml(workerName)\n        await context.writeFile(wranglerPath, toml)\n        console.log(`[@aihu/adapter-cloudflare] Created wrangler.toml (name = \"${workerName}\")`)\n      }\n\n      console.log(`[@aihu/adapter-cloudflare] Build complete → ${context.outDir}`)\n      console.log(`[@aihu/adapter-cloudflare] Deploy with: wrangler deploy --config wrangler.toml`)\n    },\n  }\n}\n"],"mappings":"2FAyBA,SAAS,EAAoB,EAA6B,CACxD,IAAM,EAAUA,EAAY,EAAM,eAAe,CACjD,GAAI,CAAC,EAAW,EAAQ,CAAE,OAAO,KACjC,GAAI,CACF,IAAM,EAAM,KAAK,MAAM,EAAa,EAAS,OAAO,CAAC,CACrD,OAAO,OAAO,EAAI,MAAS,SAAW,EAAI,KAAO,UAC3C,CACN,OAAO,MAIX,SAAS,GAA8B,CACrC,MAAO,CACL,8DACA,yCACA,KACA,4EACA,6EACA,GACA,mBACA,sCACA,YACA,+CACA,gBACA,6EACA,yCACA,4DACA,gEACA,QACA,OACA,IACD,CAAC,KAAK;EAAK,CAGd,SAAS,EAAqB,EAAsB,CAClD,MACE,CACE,+CACA,2DACA,iFACA,GACA,WAAW,EAAK,GAChB,sBACA,oCACA,GACA,WACA,kBACA,qBACD,CAAC,KAAK;EAAK,CAAG;EAmBnB,SAAgB,EAAW,EAAiD,CAC1E,MAAO,CACL,KAAM,aAEN,MAAM,MAAM,EAAwC,CAClD,IAAM,EAAa,GAAS,MAAQ,EAAoB,EAAQ,KAAK,EAAI,WAGnE,EAAc,GAAqB,CACzC,MAAM,EAAQ,SAAS,aAAc,EAAY,CACjD,QAAQ,IAAI,yDAAyD,CAGrE,IAAM,EAAeA,EAAY,EAAQ,KAAM,gBAAgB,CAC/D,GAAI,GAAS,mBAAqB,IAAS,CAAC,EAAW,EAAa,CAAE,CACpE,IAAM,EAAO,EAAqB,EAAW,CAC7C,MAAM,EAAQ,UAAU,EAAc,EAAK,CAC3C,QAAQ,IAAI,6DAA6D,EAAW,IAAI,CAG1F,QAAQ,IAAI,+CAA+C,EAAQ,SAAS,CAC5E,QAAQ,IAAI,iFAAiF,EAEhG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@aihu/adapter-cloudflare",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "rolldown -c",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "@aihu/app": "workspace:*",
+    "vite": ">=5.0.0"
+  },
+  "description": "Cloudflare Workers/Pages deployment adapter for @aihu/app.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fellwork/aihu.git",
+    "directory": "packages/adapter-cloudflare"
+  },
+  "homepage": "https://github.com/fellwork/aihu/tree/main/packages/adapter-cloudflare#readme",
+  "bugs": "https://github.com/fellwork/aihu/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}