@b9g/platform-cloudflare 0.1.9 → 0.1.11

package/src/directories.js

@@ -0,0 +1,344 @@
+/// <reference types="./directories.d.ts" />
+// src/directories.ts
+import mime from "mime";
+import { getEnv } from "./variables.js";
+var R2FileSystemWritableFileStream = class extends WritableStream {
+  constructor(r2Bucket, key) {
+    const chunks = [];
+    super({
+      write: (chunk) => {
+        chunks.push(chunk);
+        return Promise.resolve();
+      },
+      close: async () => {
+        const totalLength = chunks.reduce(
+          (sum, chunk) => sum + chunk.length,
+          0
+        );
+        const buffer = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const chunk of chunks) {
+          buffer.set(chunk, offset);
+          offset += chunk.length;
+        }
+        await r2Bucket.put(key, buffer);
+      },
+      abort: async () => {
+        chunks.length = 0;
+      }
+    });
+  }
+};
+var R2FileSystemFileHandle = class _R2FileSystemFileHandle {
+  kind;
+  name;
+  #r2Bucket;
+  #key;
+  constructor(r2Bucket, key) {
+    this.kind = "file";
+    this.#r2Bucket = r2Bucket;
+    this.#key = key;
+    this.name = key.split("/").pop() || key;
+  }
+  async getFile() {
+    const r2Object = await this.#r2Bucket.get(this.#key);
+    if (!r2Object) {
+      throw new DOMException("File not found", "NotFoundError");
+    }
+    const arrayBuffer = await r2Object.arrayBuffer();
+    return new File([arrayBuffer], this.name, {
+      lastModified: r2Object.uploaded.getTime(),
+      type: r2Object.httpMetadata?.contentType || this.#getMimeType(this.#key)
+    });
+  }
+  async createWritable() {
+    return new R2FileSystemWritableFileStream(
+      this.#r2Bucket,
+      this.#key
+    );
+  }
+  async createSyncAccessHandle() {
+    throw new DOMException(
+      "Synchronous access handles are not supported for R2 storage",
+      "InvalidStateError"
+    );
+  }
+  async isSameEntry(other) {
+    if (other.kind !== "file") return false;
+    if (!(other instanceof _R2FileSystemFileHandle)) return false;
+    return this.#key === other.#key;
+  }
+  async queryPermission() {
+    return "granted";
+  }
+  async requestPermission() {
+    return "granted";
+  }
+  #getMimeType(key) {
+    return mime.getType(key) || "application/octet-stream";
+  }
+};
+var R2FileSystemDirectoryHandle = class _R2FileSystemDirectoryHandle {
+  kind;
+  name;
+  #r2Bucket;
+  #prefix;
+  constructor(r2Bucket, prefix) {
+    this.kind = "directory";
+    this.#r2Bucket = r2Bucket;
+    this.#prefix = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
+    this.name = this.#prefix.split("/").pop() || "root";
+  }
+  async getFileHandle(name, options) {
+    const key = this.#prefix ? `${this.#prefix}/${name}` : name;
+    const exists = await this.#r2Bucket.head(key);
+    if (!exists && options?.create) {
+      await this.#r2Bucket.put(key, new Uint8Array(0));
+    } else if (!exists) {
+      throw new DOMException("File not found", "NotFoundError");
+    }
+    return new R2FileSystemFileHandle(this.#r2Bucket, key);
+  }
+  async getDirectoryHandle(name, options) {
+    const newPrefix = this.#prefix ? `${this.#prefix}/${name}` : name;
+    if (options?.create) {
+      const markerKey = `${newPrefix}/.shovel_directory_marker`;
+      const exists = await this.#r2Bucket.head(markerKey);
+      if (!exists) {
+        await this.#r2Bucket.put(markerKey, new Uint8Array(0));
+      }
+    }
+    return new _R2FileSystemDirectoryHandle(this.#r2Bucket, newPrefix);
+  }
+  async removeEntry(name, options) {
+    const key = this.#prefix ? `${this.#prefix}/${name}` : name;
+    const fileExists = await this.#r2Bucket.head(key);
+    if (fileExists) {
+      await this.#r2Bucket.delete(key);
+      return;
+    }
+    if (options?.recursive) {
+      const dirPrefix = `${key}/`;
+      const listed = await this.#r2Bucket.list({ prefix: dirPrefix });
+      const deletePromises = listed.objects.map(
+        (object) => this.#r2Bucket.delete(object.key)
+      );
+      await Promise.all(deletePromises);
+      const markerKey = `${key}/.shovel_directory_marker`;
+      const markerExists = await this.#r2Bucket.head(markerKey);
+      if (markerExists) {
+        await this.#r2Bucket.delete(markerKey);
+      }
+    } else {
+      throw new DOMException(
+        "Directory is not empty",
+        "InvalidModificationError"
+      );
+    }
+  }
+  async resolve(_possibleDescendant) {
+    return null;
+  }
+  async *entries() {
+    const listPrefix = this.#prefix ? `${this.#prefix}/` : "";
+    try {
+      const result = await this.#r2Bucket.list({
+        prefix: listPrefix,
+        delimiter: "/"
+      });
+      for (const object of result.objects) {
+        if (object.key !== listPrefix) {
+          const name = object.key.substring(listPrefix.length);
+          if (!name.includes("/") && !name.endsWith(".shovel_directory_marker")) {
+            yield [
+              name,
+              new R2FileSystemFileHandle(this.#r2Bucket, object.key)
+            ];
+          }
+        }
+      }
+      for (const prefix of result.delimitedPrefixes) {
+        const name = prefix.substring(listPrefix.length).replace(/\/$/, "");
+        if (name) {
+          yield [
+            name,
+            new _R2FileSystemDirectoryHandle(
+              this.#r2Bucket,
+              prefix.replace(/\/$/, "")
+            )
+          ];
+        }
+      }
+    } catch (error) {
+      throw new DOMException("Directory not found", "NotFoundError");
+    }
+  }
+  async *keys() {
+    for await (const [name] of this.entries()) {
+      yield name;
+    }
+  }
+  async *values() {
+    for await (const [, handle] of this.entries()) {
+      yield handle;
+    }
+  }
+  async isSameEntry(other) {
+    if (other.kind !== "directory") return false;
+    if (!(other instanceof _R2FileSystemDirectoryHandle)) return false;
+    return this.#prefix === other.#prefix;
+  }
+  async queryPermission() {
+    return "granted";
+  }
+  async requestPermission() {
+    return "granted";
+  }
+};
+var CFAssetsFileHandle = class _CFAssetsFileHandle {
+  kind;
+  name;
+  #assets;
+  #path;
+  constructor(assets, path, name) {
+    this.kind = "file";
+    this.#assets = assets;
+    this.#path = path;
+    this.name = name;
+  }
+  async getFile() {
+    const response = await this.#assets.fetch(
+      new Request("https://assets" + this.#path)
+    );
+    if (!response.ok) {
+      throw new DOMException(
+        `A requested file or directory could not be found: ${this.name}`,
+        "NotFoundError"
+      );
+    }
+    const blob = await response.blob();
+    const contentType = response.headers.get("content-type") || "application/octet-stream";
+    return new File([blob], this.name, { type: contentType });
+  }
+  async createWritable(_options) {
+    throw new DOMException("Assets are read-only", "NotAllowedError");
+  }
+  async createSyncAccessHandle() {
+    throw new DOMException("Sync access not supported", "NotSupportedError");
+  }
+  isSameEntry(other) {
+    return Promise.resolve(
+      other instanceof _CFAssetsFileHandle && other.#path === this.#path
+    );
+  }
+};
+var CFAssetsDirectoryHandle = class _CFAssetsDirectoryHandle {
+  kind;
+  name;
+  #assets;
+  #basePath;
+  constructor(assets, basePath = "/") {
+    this.kind = "directory";
+    this.#assets = assets;
+    this.#basePath = basePath.endsWith("/") ? basePath : basePath + "/";
+    this.name = basePath.split("/").filter(Boolean).pop() || "assets";
+  }
+  async getFileHandle(name, _options) {
+    const path = this.#basePath + name;
+    const response = await this.#assets.fetch(
+      new Request("https://assets" + path)
+    );
+    if (!response.ok) {
+      throw new DOMException(
+        `A requested file or directory could not be found: ${name}`,
+        "NotFoundError"
+      );
+    }
+    return new CFAssetsFileHandle(this.#assets, path, name);
+  }
+  async getDirectoryHandle(name, _options) {
+    return new _CFAssetsDirectoryHandle(this.#assets, this.#basePath + name);
+  }
+  async removeEntry(_name, _options) {
+    throw new DOMException("Assets directory is read-only", "NotAllowedError");
+  }
+  async resolve(_possibleDescendant) {
+    return null;
+  }
+  // eslint-disable-next-line require-yield
+  async *entries() {
+    throw new DOMException(
+      "Directory listing not supported for ASSETS binding. Use an asset manifest for enumeration.",
+      "NotSupportedError"
+    );
+  }
+  // eslint-disable-next-line require-yield
+  async *keys() {
+    throw new DOMException(
+      "Directory listing not supported for ASSETS binding",
+      "NotSupportedError"
+    );
+  }
+  // eslint-disable-next-line require-yield
+  async *values() {
+    throw new DOMException(
+      "Directory listing not supported for ASSETS binding",
+      "NotSupportedError"
+    );
+  }
+  [Symbol.asyncIterator]() {
+    return this.entries();
+  }
+  isSameEntry(other) {
+    return Promise.resolve(
+      other instanceof _CFAssetsDirectoryHandle && other.#basePath === this.#basePath
+    );
+  }
+};
+var CloudflareR2Directory = class extends R2FileSystemDirectoryHandle {
+  constructor(name, options = {}) {
+    const env = getEnv();
+    const bindingName = options.binding || `${name.toUpperCase()}_R2`;
+    const r2Bucket = env[bindingName];
+    if (!r2Bucket) {
+      throw new Error(
+        `R2 bucket binding "${bindingName}" not found. Configure in wrangler.toml:
+
+[[r2_buckets]]
+binding = "${bindingName}"
+bucket_name = "your-bucket-name"`
+      );
+    }
+    const prefix = options.path ?? "";
+    const normalizedPrefix = prefix.startsWith("/") ? prefix.slice(1) : prefix;
+    super(r2Bucket, normalizedPrefix);
+  }
+};
+var CloudflareAssetsDirectory = class extends CFAssetsDirectoryHandle {
+  constructor(_name, options = {}) {
+    const env = getEnv();
+    const assets = env.ASSETS;
+    if (!assets) {
+      throw new Error(
+        `ASSETS binding not found. Configure in wrangler.toml:
+
+[assets]
+directory = "./public"`
+      );
+    }
+    const basePath = options.path ?? "/";
+    const normalizedBase = basePath === "/" ? "/" : basePath.startsWith("/") ? basePath : `/${basePath}`;
+    super(assets, normalizedBase);
+  }
+};
+var directories_default = CloudflareR2Directory;
+export {
+  CFAssetsDirectoryHandle,
+  CFAssetsFileHandle,
+  CloudflareAssetsDirectory,
+  CloudflareR2Directory,
+  R2FileSystemDirectoryHandle,
+  R2FileSystemFileHandle,
+  R2FileSystemWritableFileStream,
+  directories_default as default
+};

package/src/index.d.ts

@@ -2,9 +2,17 @@
  * @b9g/platform-cloudflare - Cloudflare Workers platform adapter for Shovel
  *
  * Provides ServiceWorker-native deployment for Cloudflare Workers with KV/R2/D1 integration.
+ *
+ * Architecture:
+ * - Uses ServiceWorkerGlobals from @b9g/platform for full feature parity with Node/Bun
+ * - AsyncContext provides per-request access to Cloudflare's env/ctx
+ * - Directories use R2 via lazy factory (accessed when directories.open() is called)
+ * - Caches use Cloudflare's native Cache API
  */
-import { BasePlatform, PlatformConfig, Handler, Server, ServerOptions, ServiceWorkerOptions, ServiceWorkerInstance } from "@b9g/platform";
+import { BasePlatform, PlatformConfig, type PlatformDefaults, Handler, Server, ServerOptions, ServiceWorkerOptions, ServiceWorkerInstance, EntryWrapperOptions, PlatformESBuildConfig, type LoggerStorage } from "@b9g/platform";
+import { type ShovelConfig } from "@b9g/platform/runtime";
 import { CustomCacheStorage } from "@b9g/cache";
+import type { DirectoryStorage } from "@b9g/filesystem";
 export type { Platform, Handler, Server, ServerOptions, ServiceWorkerOptions, ServiceWorkerInstance, } from "@b9g/platform";
 export interface CloudflarePlatformOptions extends PlatformConfig {
     /** Cloudflare Workers environment (production, preview, dev) */
@@ -13,6 +21,8 @@ export interface CloudflarePlatformOptions extends PlatformConfig {
     assetsDirectory?: string;
     /** Working directory for config file resolution */
     cwd?: string;
+    /** Shovel configuration (caches, directories, etc.) */
+    config?: ShovelConfig;
 }
 /**
  * Cloudflare Workers platform implementation
@@ -22,56 +32,53 @@ export declare class CloudflarePlatform extends BasePlatform {
     readonly name: string;
     constructor(options?: CloudflarePlatformOptions);
     /**
-     * Create cache storage
-     * Uses config from shovel.json with memory cache default.
-     *
-     * Note: This is for the platform/test runner context. Inside actual
-     * Cloudflare Workers, native caches are available via globalThis.caches
-     * (captured by the banner as globalThis.__cloudflareCaches).
+     * Create cache storage using config from shovel.json
+     * Default: Cloudflare's native Cache API
+     * Merges with runtime defaults (actual class references) for fallback behavior
      */
     createCaches(): Promise<CustomCacheStorage>;
     /**
-     * Create "server" for Cloudflare Workers (which is really just the handler)
+     * Create directory storage for Cloudflare Workers
+     * Directories must be configured via shovel.json (no platform defaults)
+     */
+    createDirectories(): Promise<DirectoryStorage>;
+    /**
+     * Create logger storage for Cloudflare Workers
+     */
+    createLoggers(): Promise<LoggerStorage>;
+    /**
+     * Create "server" for Cloudflare Workers (stub for Platform interface)
      */
     createServer(handler: Handler, _options?: ServerOptions): Server;
     /**
-     * Load ServiceWorker-style entrypoint using miniflare (workerd)
-     *
-     * Note: In production Cloudflare Workers, the banner/footer wrapper code
-     * handles request dispatch directly - loadServiceWorker is only used for
-     * local development with miniflare.
+     * Load ServiceWorker using miniflare (workerd) for dev mode
      */
     loadServiceWorker(entrypoint: string, _options?: ServiceWorkerOptions): Promise<ServiceWorkerInstance>;
+    dispose(): Promise<void>;
     /**
-     * Dispose of platform resources
+     * Get virtual entry wrapper for Cloudflare Workers
+     *
+     * Wraps user code with:
+     * 1. Config import (shovel:config virtual module)
+     * 2. Runtime initialization (ServiceWorkerGlobals)
+     * 3. User code import (registers fetch handlers)
+     * 4. ES module export for Cloudflare Workers format
+     *
+     * Note: Unlike Node/Bun, Cloudflare bundles user code inline, so the
+     * entryPath is embedded directly in the wrapper.
      */
-    dispose(): Promise<void>;
+    getEntryWrapper(entryPath: string, _options?: EntryWrapperOptions): string;
+    /**
+     * Get Cloudflare-specific esbuild configuration
+     *
+     * Note: Cloudflare Workers natively support import.meta.env, so no define alias
+     * is needed. The nodejs_compat flag enables node:* built-in modules at runtime,
+     * so we externalize them during bundling.
+     */
+    getESBuildConfig(): PlatformESBuildConfig;
+    /**
+     * Get Cloudflare-specific defaults for config generation
+     */
+    getDefaults(): PlatformDefaults;
 }
-/**
- * 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;
-/**
- * Generate banner code for ServiceWorker → ES Module conversion
- */
-export declare const cloudflareWorkerBanner = "// Cloudflare Worker ES Module wrapper\nlet serviceWorkerGlobals = null;\n\n// Capture native Cloudflare caches before any framework code runs\nconst nativeCaches = globalThis.caches;\n\n// Set up ServiceWorker environment\nif (typeof globalThis.self === 'undefined') {\n\tglobalThis.self = globalThis;\n}\n\n// Store native caches for access via globalThis.__cloudflareCaches\nglobalThis.__cloudflareCaches = nativeCaches;\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// Helper for error responses\n\t\t\tconst createErrorResponse = (err) => {\n\t\t\t\tconst isDev = typeof import.meta !== \"undefined\" && import.meta.env?.MODE !== \"production\";\n\t\t\t\tif (isDev) {\n\t\t\t\t\tconst escapeHtml = (str) => str.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\").replace(/\"/g, \"&quot;\");\n\t\t\t\t\treturn new Response(`<!DOCTYPE html>\n<html>\n<head>\n  <title>500 Internal Server Error</title>\n  <style>\n    body { font-family: system-ui, sans-serif; padding: 2rem; max-width: 800px; margin: 0 auto; }\n    h1 { color: #c00; }\n    .message { font-size: 1.2em; color: #333; }\n    pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; border-radius: 4px; }\n  </style>\n</head>\n<body>\n  <h1>500 Internal Server Error</h1>\n  <p class=\"message\">${escapeHtml(err.message)}</p>\n  <pre>${escapeHtml(err.stack || \"No stack trace available\")}</pre>\n</body>\n</html>`, { status: 500, headers: { \"Content-Type\": \"text/html; charset=utf-8\" } });\n\t\t\t\t} else {\n\t\t\t\t\treturn new Response(\"Internal Server Error\", { status: 500, headers: { \"Content-Type\": \"text/plain\" } });\n\t\t\t\t}\n\t\t\t};\n\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\tawait handler(event);\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(\"Handler error:\", error);\n\t\t\t\t\treturn createErrorResponse(error);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn new Response('No ServiceWorker handler', { status: 404 });\n\t\t} catch (topLevelError) {\n\t\t\tconsole.error(\"Top-level error:\", topLevelError);\n\t\t\tconst isDev = typeof import.meta !== \"undefined\" && import.meta.env?.MODE !== \"production\";\n\t\t\tif (isDev) {\n\t\t\t\tconst escapeHtml = (str) => String(str).replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\").replace(/\"/g, \"&quot;\");\n\t\t\t\treturn new Response(`<!DOCTYPE html>\n<html>\n<head>\n  <title>500 Internal Server Error</title>\n  <style>\n    body { font-family: system-ui, sans-serif; padding: 2rem; max-width: 800px; margin: 0 auto; }\n    h1 { color: #c00; }\n    .message { font-size: 1.2em; color: #333; }\n    pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; border-radius: 4px; }\n  </style>\n</head>\n<body>\n  <h1>500 Internal Server Error</h1>\n  <p class=\"message\">${escapeHtml(topLevelError.message)}</p>\n  <pre>${escapeHtml(topLevelError.stack || \"No stack trace available\")}</pre>\n</body>\n</html>`, { status: 500, headers: { \"Content-Type\": \"text/html; charset=utf-8\" } });\n\t\t\t} else {\n\t\t\t\treturn new Response(\"Internal Server Error\", { status: 500, headers: { \"Content-Type\": \"text/plain\" } });\n\t\t\t}\n\t\t}\n\t}\n};";
-/**
- * Default export for easy importing
- */
 export default CloudflarePlatform;