@fluojs/platform-cloudflare-workers 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fluo contributors
+
+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.ko.md

@@ -0,0 +1,103 @@
+# @fluojs/platform-cloudflare-workers
+
+<p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
+
+엣지에 최적화된 fluo 런타임용 Cloudflare Workers HTTP 어댑터 패키지입니다.
+
+## 목차
+
+- [설치](#설치)
+- [사용 시점](#사용-시점)
+- [빠른 시작](#빠른-시작)
+- [주요 패턴](#주요-패턴)
+- [공개 API 개요](#공개-api-개요)
+- [관련 패키지](#관련-패키지)
+- [예제 소스](#예제-소스)
+
+## 설치
+
+```bash
+npm install @fluojs/platform-cloudflare-workers
+```
+
+이 패키지는 Cloudflare Workers에서 실행하는 것을 전제로 합니다. 배포 manifest는 npm 메타데이터가 Workers 런타임 계약과 어긋나지 않도록 의도적으로 `engines.node`를 선언하지 않으며, 저장소의 Node.js 20+ 요구사항은 메인테이너용 빌드/테스트 툴체인에만 적용됩니다.
+
+## 사용 시점
+
+fluo 애플리케이션을 [Cloudflare Workers](https://workers.cloudflare.com/)에 배포할 때 이 패키지를 사용합니다. 이 어댑터는 서버리스 엣지 환경에 맞게 설계되었으며, Worker isolate 제약 조건과 네이티브 Web API를 준수하는 가벼운 `fetch` 기반 어댑터를 제공합니다.
+
+이 어댑터는 각 요청 수명주기를 `executionContext.waitUntil(...)`에 연결하고, `close()` 중에도 진행 중인 디스패치를 유지하여 Worker 종료 도중 활성 작업이 중간에 잘리지 않도록 보장합니다.
+
+애플리케이션 종료 중에는 즉시 새 ingress 수락을 중단하고, 활성 HTTP 핸들러가 정리될 수 있도록 최대 10초의 bounded drain window를 제공합니다. 이 시간을 넘기면 `close()`는 무기한 대기하지 않고 timeout 오류로 종료됩니다.
+
+## 빠른 시작
+
+### 표준 어댑터 사용
+애플리케이션을 부트스트랩하고 표준 Cloudflare Worker `fetch` 핸들러를 내보냅니다.
+
+```typescript
+import { fluoFactory } from '@fluojs/runtime';
+import { createCloudflareWorkerAdapter } from '@fluojs/platform-cloudflare-workers';
+import { AppModule } from './app.module';
+
+const adapter = createCloudflareWorkerAdapter();
+const app = await fluoFactory.create(AppModule, { adapter });
+
+await app.listen();
+
+export default {
+  fetch: (req, env, ctx) => adapter.fetch(req, env, ctx),
+};
+```
+
+### 지연 엔트리포인트 (Zero-Config)
+첫 번째 요청 시 부트스트랩을 수행하는 엔트리포인트 헬퍼를 사용하여 설정을 더욱 간소화할 수 있습니다.
+
+```typescript
+import { createCloudflareWorkerEntrypoint } from '@fluojs/platform-cloudflare-workers';
+import { AppModule } from './app.module';
+
+const worker = createCloudflareWorkerEntrypoint(AppModule);
+
+export default {
+  fetch: worker.fetch,
+};
+```
+
+## 주요 패턴
+
+### WebSocketPair 활용
+어댑터는 `@fluojs/websockets/cloudflare-workers` 바인딩을 통해 실시간 통신을 위한 Cloudflare의 네이티브 `WebSocketPair`를 지원합니다.
+
+```typescript
+@WebSocketGateway({ path: '/ws' })
+export class MyGateway {}
+```
+
+### 엣지 네이티브 미들웨어
+표준 fluo 미들웨어(CORS, Global Prefix 등)가 완전히 지원되며 Cloudflare 환경에 최적화되어 있습니다.
+
+```typescript
+const adapter = createCloudflareWorkerAdapter({
+  globalPrefix: 'api/v1',
+  cors: true,
+});
+```
+
+## 공개 API 개요
+
+- `createCloudflareWorkerAdapter(options)`: Worker HTTP 어댑터를 위한 팩토리입니다.
+- `createCloudflareWorkerEntrypoint(module, options)`: 지연 부트스트랩 방식의 Worker 엔트리포인트를 생성합니다.
+- `bootstrapCloudflareWorkerApplication(module, options)`: Worker를 위한 비동기 부트스트랩 헬퍼입니다.
+- `CloudflareWorkerHttpApplicationAdapter`: 핵심 어댑터 구현 클래스입니다.
+
+## 관련 패키지
+
+- `@fluojs/runtime`: 핵심 런타임입니다.
+- `@fluojs/websockets`: 전용 서브패스 `@fluojs/websockets/cloudflare-workers`를 포함합니다.
+- `@fluojs/http`: 공통 HTTP 데코레이터 계층입니다.
+
+## 예제 소스
+
+- `packages/platform-cloudflare-workers/src/adapter.test.ts`
+- `packages/websockets/src/cloudflare-workers/cloudflare-workers.test.ts`

package/README.md

@@ -0,0 +1,103 @@
+# @fluojs/platform-cloudflare-workers
+
+<p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
+
+Cloudflare Workers HTTP adapter for the fluo runtime, optimized for the edge.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [When to Use](#when-to-use)
+- [Quick Start](#quick-start)
+- [Common Patterns](#common-patterns)
+- [Public API Overview](#public-api-overview)
+- [Related Packages](#related-packages)
+- [Example Sources](#example-sources)
+
+## Installation
+
+```bash
+npm install @fluojs/platform-cloudflare-workers
+```
+
+This package is intended to run on Cloudflare Workers. The published manifest intentionally does not declare `engines.node`, so npm metadata stays aligned with the Workers runtime contract; the repository's Node.js 20+ requirement only applies to the maintainer build/test toolchain.
+
+## When to Use
+
+Use this package when deploying fluo applications to [Cloudflare Workers](https://workers.cloudflare.com/). It is designed for the serverless edge environment, providing a lightweight `fetch`-based adapter that respects Worker isolate constraints and native Web APIs.
+
+The adapter binds each request lifecycle to `executionContext.waitUntil(...)` and keeps in-flight dispatches alive during `close()` so Worker shutdown does not drop active work mid-request.
+
+During application shutdown, the adapter stops accepting new ingress immediately and gives active HTTP handlers a bounded 10-second drain window before `close()` fails with a timeout instead of hanging indefinitely.
+
+## Quick Start
+
+### Standard Adapter Usage
+Bootstrap your application and export a standard Cloudflare Worker `fetch` handler.
+
+```typescript
+import { fluoFactory } from '@fluojs/runtime';
+import { createCloudflareWorkerAdapter } from '@fluojs/platform-cloudflare-workers';
+import { AppModule } from './app.module';
+
+const adapter = createCloudflareWorkerAdapter();
+const app = await fluoFactory.create(AppModule, { adapter });
+
+await app.listen();
+
+export default {
+  fetch: (req, env, ctx) => adapter.fetch(req, env, ctx),
+};
+```
+
+### Lazy Entrypoint (Zero-Config)
+Use the entrypoint helper for an even simpler setup that bootstraps on the first request.
+
+```typescript
+import { createCloudflareWorkerEntrypoint } from '@fluojs/platform-cloudflare-workers';
+import { AppModule } from './app.module';
+
+const worker = createCloudflareWorkerEntrypoint(AppModule);
+
+export default {
+  fetch: worker.fetch,
+};
+```
+
+## Common Patterns
+
+### Working with WebSocketPairs
+The adapter supports Cloudflare's native `WebSocketPair` for real-time communication via the `@fluojs/websockets/cloudflare-workers` binding.
+
+```typescript
+@WebSocketGateway({ path: '/ws' })
+export class MyGateway {}
+```
+
+### Edge-Native Middleware
+Standard fluo middleware (CORS, Global Prefix, etc.) is fully supported and optimized for the Cloudflare environment.
+
+```typescript
+const adapter = createCloudflareWorkerAdapter({
+  globalPrefix: 'api/v1',
+  cors: true,
+});
+```
+
+## Public API Overview
+
+- `createCloudflareWorkerAdapter(options)`: Factory for the Worker HTTP adapter.
+- `createCloudflareWorkerEntrypoint(module, options)`: Creates a lazy-bootstrapping Worker entrypoint.
+- `bootstrapCloudflareWorkerApplication(module, options)`: Async bootstrap helper for Workers.
+- `CloudflareWorkerHttpApplicationAdapter`: The core adapter implementation.
+
+## Related Packages
+
+- `@fluojs/runtime`: Core framework runtime.
+- `@fluojs/websockets`: Includes specific subpath `@fluojs/websockets/cloudflare-workers`.
+- `@fluojs/http`: Shared HTTP decorators.
+
+## Example Sources
+
+- `packages/platform-cloudflare-workers/src/adapter.test.ts`
+- `packages/websockets/src/cloudflare-workers/cloudflare-workers.test.ts`

package/dist/adapter.d.ts

@@ -0,0 +1,120 @@
+import { type Dispatcher, type HttpApplicationAdapter } from '@fluojs/http';
+import { type BootstrapHttpAdapterApplicationOptions } from '@fluojs/runtime/internal/http-adapter';
+import type { Application, ModuleType, UploadedFile } from '@fluojs/runtime';
+import { type CreateWebRequestResponseFactoryOptions } from '@fluojs/runtime/web';
+declare module '@fluojs/http' {
+    interface FrameworkRequest {
+        files?: UploadedFile[];
+        rawBody?: Uint8Array;
+    }
+}
+/** Minimal Worker execution context surface used by the adapter. */
+export interface CloudflareWorkerExecutionContext {
+    passThroughOnException?(): void;
+    waitUntil(promise: Promise<unknown>): void;
+}
+/** Message payloads accepted by Cloudflare Worker websockets. */
+export type CloudflareWorkerWebSocketMessage = ArrayBuffer | ArrayBufferView | Blob | string;
+/** Server-side Cloudflare Worker websocket shape used by the raw binding seam. */
+export interface CloudflareWorkerWebSocket extends Pick<WebSocket, 'addEventListener' | 'close' | 'removeEventListener' | 'send'> {
+    readonly readyState: number;
+    accept(): void;
+}
+/** Pair returned by Cloudflare's `WebSocketPair` constructor. */
+export interface CloudflareWorkerWebSocketPair {
+    0: CloudflareWorkerWebSocket;
+    1: CloudflareWorkerWebSocket;
+}
+/** Factory for creating Cloudflare Worker websocket pairs during upgrades. */
+export type CloudflareWorkerWebSocketPairFactory = () => CloudflareWorkerWebSocketPair;
+/** Result returned when the adapter upgrades a request to a Worker websocket. */
+export interface CloudflareWorkerWebSocketUpgradeResult {
+    response: Response;
+    serverSocket: CloudflareWorkerWebSocket;
+}
+/** Host wrapper passed to websocket bindings for performing Worker upgrades. */
+export interface CloudflareWorkerWebSocketUpgradeHost {
+    upgrade(request: Request): CloudflareWorkerWebSocketUpgradeResult;
+}
+/** Official websocket binding contract consumed by `@fluojs/websockets/cloudflare-workers`. */
+export interface CloudflareWorkerWebSocketBinding {
+    fetch(request: Request, host: CloudflareWorkerWebSocketUpgradeHost): Response | Promise<Response>;
+}
+/** Hook surface exposed by the Worker adapter for websocket bindings. */
+export interface CloudflareWorkerWebSocketBindingHost {
+    configureWebSocketBinding(binding: CloudflareWorkerWebSocketBinding | undefined): void;
+}
+/** Parsing and transport options for the Cloudflare Worker adapter. */
+export interface CloudflareWorkerAdapterOptions extends CreateWebRequestResponseFactoryOptions {
+    createWebSocketPair?: CloudflareWorkerWebSocketPairFactory;
+}
+/** Bootstrap options for constructing a Cloudflare Worker application shell. */
+export interface BootstrapCloudflareWorkerApplicationOptions extends BootstrapHttpAdapterApplicationOptions, CloudflareWorkerAdapterOptions {
+}
+/** Fetch handler shape exposed by Worker-backed application entrypoints. */
+export interface CloudflareWorkerHandler<Env = unknown> {
+    fetch(request: Request, env: Env, executionContext: CloudflareWorkerExecutionContext): Promise<Response>;
+}
+/** Fully bootstrapped Cloudflare Worker application wrapper. */
+export interface CloudflareWorkerApplication<Env = unknown> extends CloudflareWorkerHandler<Env> {
+    readonly adapter: CloudflareWorkerHttpApplicationAdapter;
+    readonly app: Application;
+    close(signal?: string): Promise<void>;
+}
+/** Lazy Cloudflare Worker entrypoint that bootstraps on first use. */
+export interface CloudflareWorkerEntrypoint<Env = unknown> extends CloudflareWorkerHandler<Env> {
+    close(signal?: string): Promise<void>;
+    ready(): Promise<CloudflareWorkerApplication<Env>>;
+}
+/**
+ * Cloudflare Workers HTTP adapter with waitUntil-aware request tracking and graceful close behavior.
+ */
+export declare class CloudflareWorkerHttpApplicationAdapter implements HttpApplicationAdapter, CloudflareWorkerWebSocketBindingHost {
+    private readonly options;
+    private closeInFlight?;
+    private dispatcher?;
+    private inFlightDrain?;
+    private inFlightRequestCount;
+    private websocketBinding?;
+    constructor(options?: CloudflareWorkerAdapterOptions);
+    close(): Promise<void>;
+    getRealtimeCapability(): import("@fluojs/http").FetchStyleHttpAdapterRealtimeCapability;
+    configureWebSocketBinding(binding: CloudflareWorkerWebSocketBinding | undefined): void;
+    fetch<Env = unknown>(request: Request, _env?: Env, executionContext?: CloudflareWorkerExecutionContext): Promise<Response>;
+    listen(dispatcher: Dispatcher): Promise<void>;
+    private upgradeWebSocket;
+    private trackInFlightRequest;
+    private waitForInFlightRequests;
+}
+/**
+ * Create the canonical Cloudflare Worker adapter instance.
+ *
+ * @param options Parsing, raw-body, and websocket-pair options for Worker requests.
+ * @returns A Cloudflare Worker HTTP adapter.
+ */
+export declare function createCloudflareWorkerAdapter(options?: CloudflareWorkerAdapterOptions): CloudflareWorkerHttpApplicationAdapter;
+/**
+ * Bootstrap a Cloudflare Worker application and return its fetch-capable wrapper.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Worker adapter and runtime bootstrap options.
+ * @returns A bootstrapped Worker application wrapper with `fetch(...)` and `close(...)`.
+ */
+export declare function bootstrapCloudflareWorkerApplication<Env = unknown>(rootModule: ModuleType, options?: BootstrapCloudflareWorkerApplicationOptions): Promise<CloudflareWorkerApplication<Env>>;
+/**
+ * Create a lazy Cloudflare Worker entrypoint that bootstraps once on first request.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Worker adapter and runtime bootstrap options.
+ * @returns A Worker entrypoint exposing lazy `fetch(...)`, `ready()`, and `close(...)` helpers.
+ */
+export declare function createCloudflareWorkerEntrypoint<Env = unknown>(rootModule: ModuleType, options?: BootstrapCloudflareWorkerApplicationOptions): CloudflareWorkerEntrypoint<Env>;
+declare global {
+    interface ResponseInit {
+        webSocket?: CloudflareWorkerWebSocket;
+    }
+    interface GlobalThis {
+        WebSocketPair?: new () => CloudflareWorkerWebSocketPair;
+    }
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,313 @@
+import { createFetchStyleHttpAdapterRealtimeCapability } from '@fluojs/http';
+import { bootstrapHttpAdapterApplication } from '@fluojs/runtime/internal/http-adapter';
+import { dispatchWebRequest } from '@fluojs/runtime/web';
+const WORKER_DISPATCHER_NOT_READY_MESSAGE = 'Cloudflare Workers adapter received a request before dispatcher binding completed.';
+const DEFAULT_SHUTDOWN_TIMEOUT_MS = 10_000;
+
+/** Minimal Worker execution context surface used by the adapter. */
+
+/** Message payloads accepted by Cloudflare Worker websockets. */
+
+/** Server-side Cloudflare Worker websocket shape used by the raw binding seam. */
+
+/** Pair returned by Cloudflare's `WebSocketPair` constructor. */
+
+/** Factory for creating Cloudflare Worker websocket pairs during upgrades. */
+
+/** Result returned when the adapter upgrades a request to a Worker websocket. */
+
+/** Host wrapper passed to websocket bindings for performing Worker upgrades. */
+
+/** Official websocket binding contract consumed by `@fluojs/websockets/cloudflare-workers`. */
+
+/** Hook surface exposed by the Worker adapter for websocket bindings. */
+
+/** Parsing and transport options for the Cloudflare Worker adapter. */
+
+/** Bootstrap options for constructing a Cloudflare Worker application shell. */
+
+/** Fetch handler shape exposed by Worker-backed application entrypoints. */
+
+/** Fully bootstrapped Cloudflare Worker application wrapper. */
+
+/** Lazy Cloudflare Worker entrypoint that bootstraps on first use. */
+
+/**
+ * Cloudflare Workers HTTP adapter with waitUntil-aware request tracking and graceful close behavior.
+ */
+export class CloudflareWorkerHttpApplicationAdapter {
+  closeInFlight;
+  dispatcher;
+  inFlightDrain;
+  inFlightRequestCount = 0;
+  websocketBinding;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  async close() {
+    if (this.closeInFlight) {
+      await waitForCloseWithTimeout(this.closeInFlight, DEFAULT_SHUTDOWN_TIMEOUT_MS);
+      return;
+    }
+    if (!this.dispatcher) {
+      return;
+    }
+    const closeInFlight = this.waitForInFlightRequests().finally(() => {
+      this.closeInFlight = undefined;
+      this.dispatcher = undefined;
+    });
+    this.closeInFlight = closeInFlight;
+    void closeInFlight.catch(() => {});
+    await waitForCloseWithTimeout(closeInFlight, DEFAULT_SHUTDOWN_TIMEOUT_MS);
+  }
+  getRealtimeCapability() {
+    return createFetchStyleHttpAdapterRealtimeCapability('Cloudflare Workers exposes WebSocketPair isolate-local request-upgrade hosting. Use @fluojs/websockets/cloudflare-workers for the official raw websocket binding.', {
+      support: 'supported'
+    });
+  }
+  configureWebSocketBinding(binding) {
+    this.websocketBinding = binding;
+  }
+  async fetch(request, _env, executionContext) {
+    if (this.closeInFlight) {
+      return createShutdownResponse();
+    }
+    const release = this.trackInFlightRequest();
+    const responsePromise = (async () => {
+      try {
+        if (this.websocketBinding && isWebSocketUpgradeRequest(request)) {
+          return await this.websocketBinding.fetch(request, {
+            upgrade: upgradeRequest => this.upgradeWebSocket(upgradeRequest)
+          });
+        }
+        return await dispatchWebRequest({
+          ...this.options,
+          dispatcher: this.dispatcher,
+          dispatcherNotReadyMessage: WORKER_DISPATCHER_NOT_READY_MESSAGE,
+          request
+        });
+      } finally {
+        release();
+      }
+    })();
+    executionContext?.waitUntil(responsePromise.then(() => undefined, () => undefined));
+    return await responsePromise;
+  }
+  async listen(dispatcher) {
+    this.dispatcher = dispatcher;
+  }
+  upgradeWebSocket(_request) {
+    const pair = resolveWebSocketPairFactory(this.options.createWebSocketPair)();
+    const clientSocket = pair[0];
+    const serverSocket = pair[1];
+    return {
+      response: createWebSocketUpgradeResponse(clientSocket),
+      serverSocket
+    };
+  }
+  trackInFlightRequest() {
+    this.inFlightRequestCount += 1;
+    if (this.inFlightRequestCount === 1) {
+      this.inFlightDrain = createDeferred();
+    }
+    return () => {
+      if (this.inFlightRequestCount === 0) {
+        return;
+      }
+      this.inFlightRequestCount -= 1;
+      if (this.inFlightRequestCount === 0) {
+        this.inFlightDrain?.resolve();
+        this.inFlightDrain = undefined;
+      }
+    };
+  }
+  async waitForInFlightRequests() {
+    if (this.inFlightRequestCount === 0) {
+      return;
+    }
+    await this.inFlightDrain?.promise;
+  }
+}
+
+/**
+ * Create the canonical Cloudflare Worker adapter instance.
+ *
+ * @param options Parsing, raw-body, and websocket-pair options for Worker requests.
+ * @returns A Cloudflare Worker HTTP adapter.
+ */
+export function createCloudflareWorkerAdapter(options = {}) {
+  return new CloudflareWorkerHttpApplicationAdapter(options);
+}
+
+/**
+ * Bootstrap a Cloudflare Worker application and return its fetch-capable wrapper.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Worker adapter and runtime bootstrap options.
+ * @returns A bootstrapped Worker application wrapper with `fetch(...)` and `close(...)`.
+ */
+export async function bootstrapCloudflareWorkerApplication(rootModule, options = {}) {
+  const adapter = createCloudflareWorkerAdapter(options);
+  const app = await bootstrapHttpAdapterApplication(rootModule, options, adapter);
+  await app.listen();
+  return {
+    adapter,
+    app,
+    close(signal) {
+      return app.close(signal);
+    },
+    fetch(request, env, executionContext) {
+      return adapter.fetch(request, env, executionContext);
+    }
+  };
+}
+
+/**
+ * Create a lazy Cloudflare Worker entrypoint that bootstraps once on first request.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Worker adapter and runtime bootstrap options.
+ * @returns A Worker entrypoint exposing lazy `fetch(...)`, `ready()`, and `close(...)` helpers.
+ */
+export function createCloudflareWorkerEntrypoint(rootModule, options = {}) {
+  let closeError;
+  let closeInFlight;
+  let runningApplication;
+  const ready = async () => {
+    if (closeError) {
+      throw closeError;
+    }
+    if (!runningApplication) {
+      runningApplication = bootstrapCloudflareWorkerApplication(rootModule, options);
+    }
+    return await runningApplication;
+  };
+  return {
+    async close(signal) {
+      if (closeInFlight) {
+        await closeInFlight;
+        return;
+      }
+      if (closeError) {
+        throw closeError;
+      }
+      const application = runningApplication;
+      if (!application) {
+        return;
+      }
+      const closing = (async () => {
+        try {
+          await (await application).close(signal);
+          if (runningApplication === application) {
+            runningApplication = undefined;
+          }
+        } catch (error) {
+          closeError = error;
+          throw error;
+        } finally {
+          closeInFlight = undefined;
+        }
+      })();
+      closeInFlight = closing;
+      await closing;
+    },
+    async fetch(request, env, executionContext) {
+      if (closeError || closeInFlight) {
+        return createShutdownResponse();
+      }
+      return await (await ready()).fetch(request, env, executionContext);
+    },
+    ready
+  };
+}
+function createWebSocketUpgradeResponse(socket) {
+  try {
+    return new Response(null, {
+      status: 101,
+      webSocket: socket
+    });
+  } catch {
+    const response = Object.create(Response.prototype);
+    Object.defineProperties(response, {
+      headers: {
+        value: new Headers()
+      },
+      ok: {
+        value: false
+      },
+      redirected: {
+        value: false
+      },
+      status: {
+        value: 101
+      },
+      statusText: {
+        value: 'Switching Protocols'
+      },
+      type: {
+        value: 'default'
+      },
+      url: {
+        value: ''
+      },
+      webSocket: {
+        value: socket
+      }
+    });
+    return response;
+  }
+}
+function resolveWebSocketPairFactory(createWebSocketPair) {
+  if (createWebSocketPair) {
+    return createWebSocketPair;
+  }
+  const pair = globalThis.WebSocketPair;
+  if (typeof pair === 'function') {
+    return () => new pair();
+  }
+  throw new Error('Cloudflare Workers websocket support requires globalThis.WebSocketPair or options.createWebSocketPair().');
+}
+function isWebSocketUpgradeRequest(request) {
+  return request.headers.get('upgrade')?.toLowerCase() === 'websocket';
+}
+function createDeferred() {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return {
+    promise,
+    reject,
+    resolve
+  };
+}
+function createShutdownResponse() {
+  return new Response(JSON.stringify({
+    error: {
+      code: 'SERVICE_UNAVAILABLE',
+      message: 'Server is shutting down.',
+      status: 503
+    }
+  }), {
+    headers: {
+      'content-type': 'application/json'
+    },
+    status: 503
+  });
+}
+function waitForCloseWithTimeout(closePromise, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    const timeoutHandle = setTimeout(() => {
+      reject(new Error(`Cloudflare Workers adapter shutdown timeout exceeded ${String(timeoutMs)}ms.`));
+    }, timeoutMs);
+    void closePromise.then(() => {
+      clearTimeout(timeoutHandle);
+      resolve();
+    }, error => {
+      clearTimeout(timeoutHandle);
+      reject(error);
+    });
+  });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './adapter.js';
+//# 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":"AAAA,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from './adapter.js';

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@fluojs/platform-cloudflare-workers",
+  "description": "Cloudflare Workers HTTP adapter for the Fluo runtime built on the shared Web Request/Response core.",
+  "keywords": [
+    "fluo",
+    "cloudflare",
+    "workers",
+    "http-adapter",
+    "platform",
+    "fetch"
+  ],
+  "version": "1.0.0-beta.1",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluojs/fluo.git",
+    "directory": "packages/platform-cloudflare-workers"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fluojs/http": "^1.0.0-beta.1",
+    "@fluojs/runtime": "^1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
+    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "pnpm exec vitest run -c vitest.config.ts",
+    "test:watch": "pnpm exec vitest -c vitest.config.ts"
+  }
+}