@b9g/platform-cloudflare 0.1.0

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@b9g/platform-cloudflare",
+  "version": "0.1.0",
+  "description": "Cloudflare Workers platform adapter for Shovel - already ServiceWorker-based!",
+  "keywords": [
+    "shovel",
+    "platform",
+    "cloudflare",
+    "workers",
+    "edge",
+    "serviceworker"
+  ],
+  "dependencies": {
+    "@b9g/platform": "workspace:*",
+    "@b9g/cache": "workspace:*",
+    "@b9g/assets": "workspace:*",
+    "@cloudflare/workers-types": "^4.20241218.0"
+  },
+  "devDependencies": {
+    "@b9g/libuild": "^0.1.10",
+    "bun-types": "latest"
+  },
+  "type": "module",
+  "types": "src/index.d.ts",
+  "module": "src/index.js",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./platform": {
+      "types": "./src/platform.d.ts",
+      "import": "./src/platform.js"
+    },
+    "./platform.js": {
+      "types": "./src/platform.d.ts",
+      "import": "./src/platform.js"
+    },
+    "./wrangler": {
+      "types": "./src/wrangler.d.ts",
+      "import": "./src/wrangler.js"
+    },
+    "./package.json": "./package.json",
+    "./index": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./index.js": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./wrangler.js": {
+      "types": "./src/wrangler.d.ts",
+      "import": "./src/wrangler.js"
+    },
+    "./wrapper": {
+      "types": "./src/wrapper.d.ts",
+      "import": "./src/wrapper.js"
+    },
+    "./wrapper.js": {
+      "types": "./src/wrapper.d.ts",
+      "import": "./src/wrapper.js"
+    }
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @b9g/platform-cloudflare - Cloudflare Workers platform adapter for Shovel
+ *
+ * Provides ServiceWorker-native deployment for Cloudflare Workers with KV/R2/D1 integration.
+ */
+export { CloudflarePlatform, createCloudflarePlatform, type CloudflarePlatformOptions, } from "./platform.js";
+export { createOptionsFromEnv, generateWranglerConfig } from "./wrangler.js";
+export { cloudflareWorkerBanner, cloudflareWorkerFooter } from "./wrapper.js";
+export type { Platform, CacheConfig, StaticConfig, Handler, Server, ServerOptions, ServiceWorkerOptions, ServiceWorkerInstance, } from "@b9g/platform";

package/src/index.js

@@ -0,0 +1,16 @@
+/// <reference types="./index.d.ts" />
+// src/index.ts
+import {
+  CloudflarePlatform,
+  createCloudflarePlatform
+} from "./platform.js";
+import { createOptionsFromEnv, generateWranglerConfig } from "./wrangler.js";
+import { cloudflareWorkerBanner, cloudflareWorkerFooter } from "./wrapper.js";
+export {
+  CloudflarePlatform,
+  cloudflareWorkerBanner,
+  cloudflareWorkerFooter,
+  createCloudflarePlatform,
+  createOptionsFromEnv,
+  generateWranglerConfig
+};

package/src/platform.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Cloudflare Workers platform implementation for Shovel
+ *
+ * Uses bundled adapters to avoid dynamic imports in Workers environment
+ * Supports KV for caching and R2 for filesystem operations
+ */
+import { BasePlatform, PlatformConfig, CacheConfig, Handler, Server, ServerOptions, ServiceWorkerOptions, ServiceWorkerInstance } from "@b9g/platform";
+export interface CloudflarePlatformOptions extends PlatformConfig {
+    /** Cloudflare Workers environment (production, preview, dev) */
+    environment?: "production" | "preview" | "dev";
+    /** KV namespace bindings */
+    kvNamespaces?: Record<string, any>;
+    /** R2 bucket bindings */
+    r2Buckets?: Record<string, any>;
+    /** D1 database bindings */
+    d1Databases?: Record<string, any>;
+    /** Durable Object bindings */
+    durableObjects?: Record<string, any>;
+}
+/**
+ * Cloudflare Workers platform implementation
+ */
+export declare class CloudflarePlatform extends BasePlatform {
+    readonly name = "cloudflare";
+    private options;
+    private _dist?;
+    constructor(options?: CloudflarePlatformOptions);
+    /**
+     * Build artifacts filesystem (not available in Workers runtime)
+     */
+    get distDir(): FileSystemDirectoryHandle;
+    /**
+     * Get platform-specific default cache configuration for Cloudflare Workers
+     */
+    protected getDefaultCacheConfig(): CacheConfig;
+    /**
+     * Override cache creation to use bundled KV adapter
+     */
+    createCaches(config?: CacheConfig): Promise<CacheStorage>;
+    /**
+     * Create "server" for Cloudflare Workers (which is really just the handler)
+     */
+    createServer(handler: Handler, _options?: ServerOptions): Server;
+    /**
+     * Load ServiceWorker-style entrypoint in Cloudflare Workers
+     *
+     * Cloudflare Workers are already ServiceWorker-based, so we can use
+     * the global environment directly in production
+     */
+    loadServiceWorker(entrypoint: string, options?: ServiceWorkerOptions): Promise<ServiceWorkerInstance>;
+    /**
+     * Get filesystem root for File System Access API
+     */
+    getFileSystemRoot(name?: string): Promise<FileSystemDirectoryHandle>;
+    /**
+     * Dispose of platform resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Create a Cloudflare platform instance
+ */
+export declare function createCloudflarePlatform(options?: CloudflarePlatformOptions): CloudflarePlatform;
+/**
+ * Default export for easy importing
+ */
+export default createCloudflarePlatform;

package/src/platform.js

@@ -0,0 +1,136 @@
+/// <reference types="./platform.d.ts" />
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/platform.ts
+import {
+  BasePlatform
+} from "@b9g/platform";
+import { FileSystemRegistry, getFileSystemRoot, MemoryFileSystemAdapter } from "@b9g/filesystem";
+var CloudflarePlatform = class extends BasePlatform {
+  name = "cloudflare";
+  options;
+  _dist;
+  constructor(options = {}) {
+    super(options);
+    this.options = {
+      environment: "production",
+      kvNamespaces: {},
+      r2Buckets: {},
+      d1Databases: {},
+      durableObjects: {},
+      ...options
+    };
+    FileSystemRegistry.register("memory", new MemoryFileSystemAdapter());
+    if (this.options.r2Buckets?.default) {
+      try {
+        const { R2FileSystemAdapter } = __require("@b9g/filesystem-r2");
+        FileSystemRegistry.register("r2", new R2FileSystemAdapter(this.options.r2Buckets.default));
+      } catch {
+        console.warn("[Cloudflare] R2 adapter not available, using memory filesystem");
+      }
+    }
+  }
+  /**
+   * Build artifacts filesystem (not available in Workers runtime)
+   */
+  get distDir() {
+    if (!this._dist) {
+      this._dist = new MemoryFileSystemAdapter().getFileSystemRoot("dist");
+    }
+    return this._dist;
+  }
+  /**
+   * Get platform-specific default cache configuration for Cloudflare Workers
+   */
+  getDefaultCacheConfig() {
+    return {
+      pages: { type: "cloudflare" },
+      // Use Cloudflare's native Cache API
+      api: { type: "cloudflare" },
+      // Use Cloudflare's native Cache API
+      static: { type: "cloudflare" }
+      // Static files handled by CDN
+    };
+  }
+  /**
+   * Override cache creation to use bundled KV adapter
+   */
+  async createCaches(config) {
+    return globalThis.caches;
+  }
+  /**
+   * Create "server" for Cloudflare Workers (which is really just the handler)
+   */
+  createServer(handler, _options = {}) {
+    return {
+      listen: () => {
+        console.info("[Cloudflare] Worker handler ready");
+        return Promise.resolve();
+      },
+      close: () => {
+        console.info("[Cloudflare] Worker handler stopped");
+        return Promise.resolve();
+      },
+      address: () => ({ port: 0, host: "cloudflare-workers" })
+    };
+  }
+  /**
+   * Load ServiceWorker-style entrypoint in Cloudflare Workers
+   * 
+   * Cloudflare Workers are already ServiceWorker-based, so we can use
+   * the global environment directly in production
+   */
+  async loadServiceWorker(entrypoint, options = {}) {
+    const isCloudflareWorker = typeof globalThis.addEventListener === "function" && typeof globalThis.caches !== "undefined" && typeof globalThis.FetchEvent !== "undefined";
+    if (isCloudflareWorker) {
+      console.info("[Cloudflare] Running in native ServiceWorker environment");
+      const instance = {
+        runtime: globalThis,
+        handleRequest: async (request) => {
+          const event = new FetchEvent("fetch", { request });
+          globalThis.dispatchEvent(event);
+          return new Response("Worker handler", { status: 200 });
+        },
+        install: () => Promise.resolve(),
+        activate: () => Promise.resolve(),
+        collectStaticRoutes: async () => [],
+        // Not supported in Workers
+        get ready() {
+          return true;
+        },
+        dispose: async () => {
+        }
+      };
+      await import(entrypoint);
+      return instance;
+    } else {
+      throw new Error("Cloudflare platform development mode not yet implemented. Use Node platform for development.");
+    }
+  }
+  /**
+   * Get filesystem root for File System Access API
+   */
+  async getFileSystemRoot(name = "default") {
+    return await getFileSystemRoot(name);
+  }
+  /**
+   * Dispose of platform resources
+   */
+  async dispose() {
+  }
+};
+function createCloudflarePlatform(options) {
+  return new CloudflarePlatform(options);
+}
+var platform_default = createCloudflarePlatform;
+export {
+  CloudflarePlatform,
+  createCloudflarePlatform,
+  platform_default as default
+};

package/src/wrangler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Wrangler integration utilities for Cloudflare Workers
+ */
+import type { CloudflarePlatformOptions } from "./platform.js";
+/**
+ * Create platform options from Wrangler environment
+ */
+export declare function createOptionsFromEnv(env: any): CloudflarePlatformOptions;
+/**
+ * Generate wrangler.toml configuration for a Shovel app from CLI flags
+ */
+export declare function generateWranglerConfig(options: {
+    name: string;
+    entrypoint: string;
+    cacheAdapter?: string;
+    filesystemAdapter?: string;
+    kvNamespaces?: string[];
+    r2Buckets?: string[];
+    d1Databases?: string[];
+}): string;

package/src/wrangler.js

@@ -0,0 +1,95 @@
+/// <reference types="./wrangler.d.ts" />
+// src/wrangler.ts
+function createOptionsFromEnv(env) {
+  return {
+    environment: env.ENVIRONMENT || "production",
+    kvNamespaces: extractKVNamespaces(env),
+    r2Buckets: extractR2Buckets(env),
+    d1Databases: extractD1Databases(env),
+    durableObjects: extractDurableObjects(env)
+  };
+}
+function extractKVNamespaces(env) {
+  const kvNamespaces = {};
+  for (const [key, value] of Object.entries(env)) {
+    if (key.endsWith("_KV") || key.includes("KV")) {
+      kvNamespaces[key] = value;
+    }
+  }
+  return kvNamespaces;
+}
+function extractR2Buckets(env) {
+  const r2Buckets = {};
+  for (const [key, value] of Object.entries(env)) {
+    if (key.endsWith("_R2") || key.includes("R2")) {
+      r2Buckets[key] = value;
+    }
+  }
+  return r2Buckets;
+}
+function extractD1Databases(env) {
+  const d1Databases = {};
+  for (const [key, value] of Object.entries(env)) {
+    if (key.endsWith("_D1") || key.includes("D1") || key.endsWith("_DB")) {
+      d1Databases[key] = value;
+    }
+  }
+  return d1Databases;
+}
+function extractDurableObjects(env) {
+  const durableObjects = {};
+  for (const [key, value] of Object.entries(env)) {
+    if (key.endsWith("_DO") || key.includes("DURABLE")) {
+      durableObjects[key] = value;
+    }
+  }
+  return durableObjects;
+}
+function generateWranglerConfig(options) {
+  const {
+    name,
+    entrypoint,
+    cacheAdapter,
+    filesystemAdapter,
+    kvNamespaces = [],
+    r2Buckets = [],
+    d1Databases = []
+  } = options;
+  const autoKVNamespaces = [];
+  const autoR2Buckets = filesystemAdapter === "r2" ? ["STORAGE_R2"] : [];
+  const allKVNamespaces = [.../* @__PURE__ */ new Set([...kvNamespaces, ...autoKVNamespaces])];
+  const allR2Buckets = [.../* @__PURE__ */ new Set([...r2Buckets, ...autoR2Buckets])];
+  return `# Generated wrangler.toml for Shovel app
+name = "${name}"
+main = "${entrypoint}"
+compatibility_date = "2024-01-01"
+
+# ServiceWorker format (since Shovel apps are ServiceWorker-style)
+usage_model = "bundled"
+
+# KV bindings${allKVNamespaces.length > 0 ? "\n" + allKVNamespaces.map(
+    (kv) => `[[kv_namespaces]]
+binding = "${kv}"
+id = "your-kv-namespace-id"
+preview_id = "your-preview-kv-namespace-id"`
+  ).join("\n\n") : ""}
+
+# R2 bindings${allR2Buckets.length > 0 ? "\n" + allR2Buckets.map(
+    (bucket) => `[[r2_buckets]]
+binding = "${bucket}"
+bucket_name = "your-bucket-name"`
+  ).join("\n\n") : ""}
+
+# D1 bindings
+${d1Databases.map(
+    (db) => `[[d1_databases]]
+binding = "${db}"
+database_name = "your-database-name"
+database_id = "your-database-id"`
+  ).join("\n\n")}
+`;
+}
+export {
+  createOptionsFromEnv,
+  generateWranglerConfig
+};

package/src/wrapper.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cloudflare Workers ES Module wrapper
+ * Converts ServiceWorker code to ES Module format for Cloudflare Workers
+ */
+/**
+ * Generate banner code for ServiceWorker → ES Module conversion
+ */
+export declare const cloudflareWorkerBanner = "// Cloudflare Worker ES Module wrapper\nlet serviceWorkerGlobals = null;\n\n// Set up ServiceWorker environment\nif (typeof globalThis.self === 'undefined') {\n\tglobalThis.self = globalThis;\n}\n\n// Capture fetch event handlers\nconst fetchHandlers = [];\nconst originalAddEventListener = globalThis.addEventListener;\nglobalThis.addEventListener = function(type, handler, options) {\n\tif (type === 'fetch') {\n\t\tfetchHandlers.push(handler);\n\t} else {\n\t\toriginalAddEventListener?.call(this, type, handler, options);\n\t}\n};\n\n// Create a promise-based FetchEvent that can be awaited\nclass FetchEvent {\n\tconstructor(type, init) {\n\t\tthis.type = type;\n\t\tthis.request = init.request;\n\t\tthis._response = null;\n\t\tthis._responsePromise = new Promise((resolve) => {\n\t\t\tthis._resolveResponse = resolve;\n\t\t});\n\t}\n\t\n\trespondWith(response) {\n\t\tthis._response = response;\n\t\tthis._resolveResponse(response);\n\t}\n\t\n\tasync waitUntil(promise) {\n\t\tawait promise;\n\t}\n}";
+/**
+ * Generate footer code for ServiceWorker → ES Module conversion
+ */
+export declare const cloudflareWorkerFooter = "\n// Export ES Module for Cloudflare Workers\nexport default {\n\tasync fetch(request, env, ctx) {\n\t\ttry {\n\t\t\t// Set up ServiceWorker-like dirs API for bundled deployment\n\t\t\tif (!globalThis.self.dirs) {\n\t\t\t\t// For bundled deployment, assets are served via static middleware\n\t\t\t\t// not through the dirs API\n\t\t\t\tglobalThis.self.dirs = {\n\t\t\t\t\tasync open(directoryName) {\n\t\t\t\t\t\tif (directoryName === 'assets') {\n\t\t\t\t\t\t\t// Return a minimal interface that indicates no files available\n\t\t\t\t\t\t\t// The assets middleware will fall back to dev mode behavior\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tasync getFileHandle(fileName) {\n\t\t\t\t\t\t\t\t\tthrow new Error(`NotFoundError: ${fileName} not found in bundled assets`);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\t\t\t\t\t\tthrow new Error(`Directory ${directoryName} not available in bundled deployment`);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}\n\t\t\t\n\t\t\t// Set up caches API\n\t\t\tif (!globalThis.self.caches) {\n\t\t\t\tglobalThis.self.caches = globalThis.caches;\n\t\t\t}\n\t\t\t\n\t\t\t// Ensure request.url is a string\n\t\t\tif (typeof request.url !== 'string') {\n\t\t\t\treturn new Response('Invalid request URL: ' + typeof request.url, { status: 500 });\n\t\t\t}\n\t\t\t\n\t\t\t// Create proper FetchEvent-like object\n\t\t\tlet responseReceived = null;\n\t\t\tconst event = { \n\t\t\t\trequest, \n\t\t\t\trespondWith: (response) => { responseReceived = response; }\n\t\t\t};\n\t\t\t\n\t\t\t// Dispatch to ServiceWorker fetch handlers\n\t\t\tfor (const handler of fetchHandlers) {\n\t\t\t\ttry {\n\t\t\t\t\tconsole.log('[Wrapper] Calling handler for:', request.url);\n\t\t\t\t\tawait handler(event);\n\t\t\t\t\tconsole.log('[Wrapper] Handler completed, response:', !!responseReceived);\n\t\t\t\t\tif (responseReceived) {\n\t\t\t\t\t\treturn responseReceived;\n\t\t\t\t\t}\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconsole.error('[Wrapper] Handler error:', error);\n\t\t\t\t\tconsole.error('[Wrapper] Error stack:', error.stack);\n\t\t\t\t\t// Return detailed error in response body for debugging\n\t\t\t\t\treturn new Response(JSON.stringify({\n\t\t\t\t\t\terror: error.message,\n\t\t\t\t\t\tstack: error.stack,\n\t\t\t\t\t\tname: error.name,\n\t\t\t\t\t\turl: request.url\n\t\t\t\t\t}, null, 2), { \n\t\t\t\t\t\tstatus: 500,\n\t\t\t\t\t\theaders: { 'Content-Type': 'application/json' }\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\t\n\t\t\treturn new Response('No ServiceWorker handler', { status: 404 });\n\t\t} catch (topLevelError) {\n\t\t\tconsole.error('[Wrapper] Top-level error:', topLevelError);\n\t\t\treturn new Response(JSON.stringify({\n\t\t\t\terror: 'Top-level wrapper error: ' + topLevelError.message,\n\t\t\t\tstack: topLevelError.stack,\n\t\t\t\tname: topLevelError.name,\n\t\t\t\turl: request?.url || 'unknown'\n\t\t\t}, null, 2), { \n\t\t\t\tstatus: 500,\n\t\t\t\theaders: { 'Content-Type': 'application/json' }\n\t\t\t});\n\t\t}\n\t}\n};";

package/src/wrapper.js

@@ -0,0 +1,127 @@
+/// <reference types="./wrapper.d.ts" />
+// src/wrapper.ts
+var cloudflareWorkerBanner = `// Cloudflare Worker ES Module wrapper
+let serviceWorkerGlobals = null;
+
+// Set up ServiceWorker environment
+if (typeof globalThis.self === 'undefined') {
+	globalThis.self = globalThis;
+}
+
+// Capture fetch event handlers
+const fetchHandlers = [];
+const originalAddEventListener = globalThis.addEventListener;
+globalThis.addEventListener = function(type, handler, options) {
+	if (type === 'fetch') {
+		fetchHandlers.push(handler);
+	} else {
+		originalAddEventListener?.call(this, type, handler, options);
+	}
+};
+
+// Create a promise-based FetchEvent that can be awaited
+class FetchEvent {
+	constructor(type, init) {
+		this.type = type;
+		this.request = init.request;
+		this._response = null;
+		this._responsePromise = new Promise((resolve) => {
+			this._resolveResponse = resolve;
+		});
+	}
+	
+	respondWith(response) {
+		this._response = response;
+		this._resolveResponse(response);
+	}
+	
+	async waitUntil(promise) {
+		await promise;
+	}
+}`;
+var cloudflareWorkerFooter = `
+// Export ES Module for Cloudflare Workers
+export default {
+	async fetch(request, env, ctx) {
+		try {
+			// Set up ServiceWorker-like dirs API for bundled deployment
+			if (!globalThis.self.dirs) {
+				// For bundled deployment, assets are served via static middleware
+				// not through the dirs API
+				globalThis.self.dirs = {
+					async open(directoryName) {
+						if (directoryName === 'assets') {
+							// Return a minimal interface that indicates no files available
+							// The assets middleware will fall back to dev mode behavior
+							return {
+								async getFileHandle(fileName) {
+									throw new Error(\`NotFoundError: \${fileName} not found in bundled assets\`);
+								}
+							};
+						}
+						throw new Error(\`Directory \${directoryName} not available in bundled deployment\`);
+					}
+				};
+			}
+			
+			// Set up caches API
+			if (!globalThis.self.caches) {
+				globalThis.self.caches = globalThis.caches;
+			}
+			
+			// Ensure request.url is a string
+			if (typeof request.url !== 'string') {
+				return new Response('Invalid request URL: ' + typeof request.url, { status: 500 });
+			}
+			
+			// Create proper FetchEvent-like object
+			let responseReceived = null;
+			const event = { 
+				request, 
+				respondWith: (response) => { responseReceived = response; }
+			};
+			
+			// Dispatch to ServiceWorker fetch handlers
+			for (const handler of fetchHandlers) {
+				try {
+					console.log('[Wrapper] Calling handler for:', request.url);
+					await handler(event);
+					console.log('[Wrapper] Handler completed, response:', !!responseReceived);
+					if (responseReceived) {
+						return responseReceived;
+					}
+				} catch (error) {
+					console.error('[Wrapper] Handler error:', error);
+					console.error('[Wrapper] Error stack:', error.stack);
+					// Return detailed error in response body for debugging
+					return new Response(JSON.stringify({
+						error: error.message,
+						stack: error.stack,
+						name: error.name,
+						url: request.url
+					}, null, 2), { 
+						status: 500,
+						headers: { 'Content-Type': 'application/json' }
+					});
+				}
+			}
+			
+			return new Response('No ServiceWorker handler', { status: 404 });
+		} catch (topLevelError) {
+			console.error('[Wrapper] Top-level error:', topLevelError);
+			return new Response(JSON.stringify({
+				error: 'Top-level wrapper error: ' + topLevelError.message,
+				stack: topLevelError.stack,
+				name: topLevelError.name,
+				url: request?.url || 'unknown'
+			}, null, 2), { 
+				status: 500,
+				headers: { 'Content-Type': 'application/json' }
+			});
+		}
+	}
+};`;
+export {
+  cloudflareWorkerBanner,
+  cloudflareWorkerFooter
+};