feat(adapter-cf): initial Cloudflare adapter integration and dev setup

Author: zonayedpca

.gitignore

@@ -26,6 +26,9 @@ packages/ui/dist
 example/**/wrangler.toml
 .wrangler/
 .mf/              # Miniflare cache
+.miniflare/
 .dev.vars         # local secrets (DO NOT COMMIT)
+.statkapi-cf-tmp/
 worker-*.mjs
-**/worker-*.mjs
+**/worker-*.mjs
+wrangler.toml.local

example/cloudflare/src-api/docs/[...slug].js

@@ -0,0 +1,3 @@
+
+export async function paths(){ return [['a','b'], ['guide']]; }
+export async function data({ params }){ return { doc: params.slug.join('/') }; }

example/cloudflare/src-api/index.js

@@ -0,0 +1 @@
+export default { hello: 'world!' };

example/cloudflare/src-api/users/[id].js

@@ -0,0 +1,7 @@
+export async function paths() {
+  return ['1', '2', '3', '4', '5', '6'];
+}
+
+export async function data({ params }) {
+  return { id: params.id, extra: 'value' };
+}

example/cloudflare/wrangler.example.toml

@@ -11,4 +11,5 @@ binding = "STATIK_MANIFEST"
 id = "REPLACE_ME_KV_NAMESPACE_ID"
 
 [vars]
-STATIK_BUILD_TOKEN = "REPLACE_ME_STATIK_BUILD_TOKEN"
+STATIK_BUILD_TOKEN = "REPLACE_ME_STATIK_BUILD_TOKEN"
+STATIK_SRC = "src-api"   # optional: lets the CLI auto-detect

package.json

@@ -15,7 +15,10 @@
     "dev": "concurrently -n API,UI -c cyan,magenta \"pnpm -C example/basic dev --no-ui --keep-alive\" \"pnpm -C packages/ui dev\"",
     "ui:preview": "pnpm -C packages/ui preview",
     "ui:build": "pnpm -C packages/ui build && node packages/cli/scripts/embed-ui.js",
-    "cf:bundle": "statikapi-cf --src src-api --out dist/worker.mjs",
+    "cf:bundle": "pnpm --filter @statikapi/adapter-cf exec statikapi-cf --out dist/worker.mjs",
+    "cf:watch": "pnpm --filter @statikapi/adapter-cf exec statikapi-cf --watch --out dist/worker.mjs",
+    "cf:dev": "wrangler dev --local",
+    "cf:dev:all": "concurrently -n BUILD,WRANGLER -c yellow,cyan \"pnpm cf:watch\" \"pnpm cf:dev\"",
     "prepublishOnly": "pnpm -r test"
   },
   "devDependencies": {
@@ -28,7 +31,8 @@
     "eslint-plugin-n": "^17.23.1",
     "eslint-plugin-promise": "^6.6.0",
     "globals": "^16.4.0",
-    "prettier": "^3.3.3"
+    "prettier": "^3.3.3",
+    "wrangler": "^4.47.0"
   },
   "keywords": [],
   "author": "zonayedpca",

packages/adapter-cloudflare/bin/statikapi-cf.js

@@ -1,30 +1,88 @@
 #!/usr/bin/env node
+import fs from 'node:fs/promises';
+import path from 'node:path';
 import { bundle } from '../src/node/bundle.js';
 
-const args = process.argv.slice(2);
-let srcDir = 'src-api';
-let outFile = 'dist/worker.mjs';
-let prettyDefault = false;
-
-for (let i = 0; i < args.length; i++) {
-  const a = args[i];
-  if (a === '--src' && args[i + 1]) {
-    srcDir = args[++i];
-  } else if (a === '--out' && args[i + 1]) {
-    outFile = args[++i];
-  } else if (a === '--pretty') {
-    prettyDefault = true;
-  } else if (a === '--help' || a === '-h') {
-    console.log(`Usage: statikapi-cf bundle [--src src-api] [--out dist/worker.mjs] [--pretty]`);
-    process.exit(0);
+function parseArgs(argv) {
+  const out = { srcDir: null, outFile: null, prettyDefault: false, cwd: null, watch: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--src' && argv[i + 1]) out.srcDir = argv[++i];
+    else if (a === '--out' && argv[i + 1]) out.outFile = argv[++i];
+    else if (a === '--cwd' && argv[i + 1]) out.cwd = argv[++i];
+    else if (a === '--pretty') out.prettyDefault = true;
+    else if (a === '--watch') out.watch = true;
+    else if (a === '--help' || a === '-h') {
+      console.log(
+        `Usage: statikapi-cf [--src src-api] [--out dist/worker.mjs] [--pretty] [--cwd DIR] [--watch]\n` +
+          `Auto-detects src from wrangler.toml [vars] STATIK_SRC if present.`
+      );
+      process.exit(0);
+    }
   }
+  return out;
 }
 
-bundle({ srcDir, outFile, prettyDefault })
-  .then(() => {
-    console.log(`✔ worker emitted → ${outFile}`);
-  })
-  .catch((e) => {
+async function findProjectRoot(start) {
+  let dir = path.resolve(start);
+  while (true) {
+    try {
+      const f = await fs.readFile(path.join(dir, 'wrangler.toml'), 'utf8');
+      return { root: dir, wranglerToml: f };
+    } catch {}
+    const parent = path.dirname(dir);
+    if (parent === dir) return { root: path.resolve(start), wranglerToml: null };
+    dir = parent;
+  }
+}
+
+function readTomlVar(toml, key) {
+  // tiny parser for [vars] STATIK_SRC = "..."
+  // keeps it simple and safe; not a full TOML parse
+  const lines = String(toml || '').split(/\r?\n/);
+  let inVars = false;
+  for (const line of lines) {
+    const l = line.trim();
+    if (!l || l.startsWith('#')) continue;
+    if (l.startsWith('[') && l.endsWith(']')) {
+      inVars = l.toLowerCase() === '[vars]';
+      continue;
+    }
+    if (!inVars) continue;
+    const m = l.match(/^([A-Za-z0-9_]+)\s*=\s*["']([^"']+)["']/);
+    if (m && m[1] === key) return m[2];
+  }
+  return null;
+}
+
+(async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  const base = args.cwd || process.cwd();
+  const { root, wranglerToml } = await findProjectRoot(base);
+
+  // Resolve srcDir preference: flag > [vars]STATIK_SRC > env > default
+  let srcDir =
+    args.srcDir || readTomlVar(wranglerToml, 'STATIK_SRC') || process.env.STATIK_SRC || 'src-api';
+
+  const outFile = args.outFile || 'dist/worker.mjs';
+
+  const run = async () => {
+    await bundle({
+      cwd: root,
+      srcDir,
+      outFile,
+      prettyDefault: args.prettyDefault,
+      watch: args.watch,
+    });
+    if (!args.watch) console.log(`✔ worker emitted → ${path.relative(root, outFile)}`);
+    else console.log(`⟲ watcher active — emitting → ${path.relative(root, outFile)}`);
+  };
+
+  try {
+    await run();
+  } catch (e) {
     console.error(e?.stack || e?.message || String(e));
     process.exit(1);
-  });
+  }
+})();