@fluojs/platform-deno 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,85 @@
+# @fluojs/platform-deno
+
+<p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
+
+네이티브 `Deno.serve`를 기반으로 구축된 fluo 런타임용 Deno 기반 HTTP 어댑터 패키지입니다.
+
+## 목차
+
+- [설치](#설치)
+- [사용 시점](#사용-시점)
+- [빠른 시작](#빠른-시작)
+- [주요 패턴](#주요-패턴)
+- [공개 API 개요](#공개-api-개요)
+- [관련 패키지](#관련-패키지)
+- [예제 소스](#예제-소스)
+
+## 설치
+
+```bash
+deno add npm:@fluojs/platform-deno npm:@fluojs/runtime npm:@fluojs/http
+```
+
+이 패키지는 Deno에서 실행하는 것을 전제로 합니다. 배포 manifest는 npm 메타데이터가 Deno 런타임 계약과 어긋나지 않도록 의도적으로 `engines.node`를 선언하지 않으며, 저장소의 Node.js 20+ 요구사항은 메인테이너용 빌드/테스트 툴체인에만 적용됩니다.
+
+## 사용 시점
+
+fluo 애플리케이션을 [Deno](https://deno.com/) 런타임에서 실행할 때 이 패키지를 사용합니다. 이 어댑터는 Deno의 네이티브 `fetch` 표준 `Request` 및 `Response` 객체를 활용하여 TypeScript 백엔드 개발을 위한 안전하고 고성능인 환경을 제공합니다.
+
+애플리케이션 종료 중에는 새 유입을 중단하고, Deno 서버 수명주기가 종료되기 전에 활성 HTTP 핸들러가 bounded drain window 안에서 마무리될 수 있도록 동작합니다.
+
+`runDenoApplication(...)`을 Deno signal API를 사용할 수 있는 환경에서 실행하면 `SIGINT`/`SIGTERM` 리스너도 등록하고, 애플리케이션이 닫히면 해당 리스너를 정리합니다.
+
+## 빠른 시작
+
+```typescript
+import { runDenoApplication } from '@fluojs/platform-deno';
+import { AppModule } from './app.module.ts';
+
+await runDenoApplication(AppModule, {
+  port: 3000,
+});
+```
+
+## 주요 패턴
+
+### 수동 요청 디스패칭
+테스트나 커스텀 `Deno.serve` 구현을 위해 어댑터의 `handle` 메서드를 사용하여 네이티브 웹 요청을 수동으로 디스패치할 수 있습니다. 다만 `handle(...)`은 런타임 dispatcher가 바인딩된 뒤에만 동작하므로, 먼저 `app.listen()`(또는 `runDenoApplication(...)`)으로 부트스트랩을 완료해야 합니다.
+
+```typescript
+import { fluoFactory } from '@fluojs/runtime';
+
+const adapter = createDenoAdapter({ port: 3000 });
+const app = await fluoFactory.create(AppModule, { adapter });
+
+await app.listen();
+
+const response = await adapter.handle(new Request('http://localhost:3000/health'));
+```
+
+### Deno 네이티브 WebSocket 지원
+어댑터는 `@fluojs/websockets/deno` 바인딩을 통해 Deno의 네이티브 `Deno.upgradeWebSocket`을 지원합니다.
+
+```typescript
+// Deno 어댑터가 활성화된 경우 게이트웨이는 자동으로 Deno의 네이티브 업그레이드를 사용합니다.
+@WebSocketGateway({ path: '/ws' })
+export class MyGateway {}
+```
+
+## 공개 API 개요
+
+- `createDenoAdapter(options)`: Deno HTTP 어댑터를 위한 팩토리입니다.
+- `bootstrapDenoApplication(module, options)`: 커스텀 오케스트레이션을 위한 고급 부트스트랩입니다.
+- `runDenoApplication(module, options)`: Deno를 위한 권장 빠른 시작 헬퍼입니다.
+- `handle(request)`: 수동 `Request` to `Response` 디스패처입니다.
+
+## 관련 패키지
+
+- `@fluojs/runtime`: 핵심 런타임입니다.
+- `@fluojs/websockets`: 전용 서브패스 `@fluojs/websockets/deno`를 포함합니다.
+- `@fluojs/http`: HTTP 데코레이터 및 추상화 계층입니다.
+
+## 예제 소스
+
+- `packages/platform-deno/src/adapter.test.ts`
+- `packages/websockets/src/deno/deno.test.ts`

package/README.md

@@ -0,0 +1,85 @@
+# @fluojs/platform-deno
+
+<p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
+
+Deno-backed HTTP adapter for the fluo runtime, built on native `Deno.serve`.
+
+## 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
+deno add npm:@fluojs/platform-deno npm:@fluojs/runtime npm:@fluojs/http
+```
+
+This package is intended to run on Deno. The published manifest intentionally does not declare `engines.node`, so npm metadata stays aligned with the Deno runtime contract; the repository's Node.js 20+ requirement only applies to the maintainer build/test toolchain.
+
+## When to Use
+
+Use this package when running fluo applications on the [Deno](https://deno.com/) runtime. This adapter leverages Deno's native `fetch`-standard `Request` and `Response` objects, providing a secure and high-performance environment for TypeScript backend development.
+
+During application shutdown, the adapter stops new ingress and gives active HTTP handlers a bounded drain window before the Deno server lifecycle completes.
+
+When `runDenoApplication(...)` runs inside Deno with signal APIs available, it also registers `SIGINT`/`SIGTERM` listeners and removes them once the application closes.
+
+## Quick Start
+
+```typescript
+import { runDenoApplication } from '@fluojs/platform-deno';
+import { AppModule } from './app.module.ts';
+
+await runDenoApplication(AppModule, {
+  port: 3000,
+});
+```
+
+## Common Patterns
+
+### Manual Request Dispatching
+For testing or custom `Deno.serve` implementations, you can use the adapter's `handle` method to dispatch native web requests manually. Bind the dispatcher first via `app.listen()` (or `runDenoApplication(...)`), because `handle(...)` only works after the runtime has been bootstrapped.
+
+```typescript
+import { fluoFactory } from '@fluojs/runtime';
+
+const adapter = createDenoAdapter({ port: 3000 });
+const app = await fluoFactory.create(AppModule, { adapter });
+
+await app.listen();
+
+const response = await adapter.handle(new Request('http://localhost:3000/health'));
+```
+
+### Deno-Native WebSocket Support
+The adapter supports Deno's native `Deno.upgradeWebSocket` through the `@fluojs/websockets/deno` binding.
+
+```typescript
+// Gateways automatically use Deno's native upgrade when the Deno adapter is active
+@WebSocketGateway({ path: '/ws' })
+export class MyGateway {}
+```
+
+## Public API Overview
+
+- `createDenoAdapter(options)`: Factory for the Deno HTTP adapter.
+- `bootstrapDenoApplication(module, options)`: Advanced bootstrap for custom orchestration.
+- `runDenoApplication(module, options)`: Recommended quick-start helper for Deno.
+- `handle(request)`: Manual `Request` to `Response` dispatcher.
+
+## Related Packages
+
+- `@fluojs/runtime`: Core framework runtime.
+- `@fluojs/websockets`: Includes specific subpath `@fluojs/websockets/deno`.
+- `@fluojs/http`: HTTP decorators and abstractions.
+
+## Example Sources
+
+- `packages/platform-deno/src/adapter.test.ts`
+- `packages/websockets/src/deno/deno.test.ts`

package/dist/adapter.d.ts

@@ -0,0 +1,128 @@
+import { type Dispatcher, type HttpApplicationAdapter } from '@fluojs/http';
+import type { Application, ModuleType, MultipartOptions } from '@fluojs/runtime';
+import { type BootstrapHttpAdapterApplicationOptions, type HttpAdapterListenTarget, type RunHttpAdapterApplicationOptions } from '@fluojs/runtime/internal/http-adapter';
+/** Listen target metadata reported by `Deno.serve(...)` callbacks. */
+export interface DenoServeOnListenInfo {
+    hostname: string;
+    port: number;
+}
+/** Options forwarded to the Deno-native `serve(...)` implementation. */
+export interface DenoServeOptions {
+    hostname?: string;
+    onListen?: (localAddr: DenoServeOnListenInfo) => void;
+    port?: number;
+    signal?: AbortSignal;
+}
+/** Minimal controller contract returned by `Deno.serve(...)`. */
+export interface DenoServeController {
+    finished: Promise<void>;
+    shutdown(): Promise<void> | void;
+}
+/** Deno shutdown signals supported by `runDenoApplication(...)`. */
+export type DenoApplicationSignal = 'SIGINT' | 'SIGTERM';
+/** Message payloads delivered through Deno server websocket bindings. */
+export type DenoWebSocketMessage = Blob | string;
+/** Server-side websocket shape used by the Deno platform binding seam. */
+export interface DenoServerWebSocket extends Pick<WebSocket, 'addEventListener' | 'close' | 'removeEventListener' | 'send'> {
+    readonly readyState: number;
+}
+/** Result returned when the Deno runtime upgrades a request to websocket mode. */
+export interface DenoWebSocketUpgradeResult<TSocket extends DenoServerWebSocket = DenoServerWebSocket> {
+    response: Response;
+    socket: TSocket;
+}
+/** Function signature for `Deno.upgradeWebSocket(...)` style adapters. */
+export type DenoUpgradeWebSocketFunction<TSocket extends DenoServerWebSocket = DenoServerWebSocket> = (request: Request) => DenoWebSocketUpgradeResult<TSocket>;
+/** Host wrapper that exposes websocket upgrade support to binding integrations. */
+export interface DenoWebSocketUpgradeHost<TSocket extends DenoServerWebSocket = DenoServerWebSocket> {
+    upgrade(request: Request): DenoWebSocketUpgradeResult<TSocket>;
+}
+/** Official Deno websocket binding contract consumed by `@fluojs/websockets/deno`. */
+export interface DenoWebSocketBinding<TSocket extends DenoServerWebSocket = DenoServerWebSocket> {
+    fetch(request: Request, host: DenoWebSocketUpgradeHost<TSocket>): Response | Promise<Response>;
+}
+/** Hook surface exposed by the Deno HTTP adapter for websocket bindings. */
+export interface DenoWebSocketBindingHost<TSocket extends DenoServerWebSocket = DenoServerWebSocket> {
+    configureWebSocketBinding(binding: DenoWebSocketBinding<TSocket> | undefined): void;
+}
+/** Native request handler shape accepted by Deno's HTTP server runtime. */
+export type DenoServeHandler = (request: Request) => Response | Promise<Response>;
+/** Function signature for a pluggable Deno serve implementation. */
+export type DenoServeFunction = (options: DenoServeOptions, handler: DenoServeHandler) => DenoServeController;
+type DenoGlobalLike = {
+    addSignalListener?: (signal: DenoApplicationSignal, handler: () => void) => void;
+    removeSignalListener?: (signal: DenoApplicationSignal, handler: () => void) => void;
+    serve: DenoServeFunction;
+    upgradeWebSocket: DenoUpgradeWebSocketFunction;
+};
+/** Transport and parsing options for the Deno HTTP adapter factory. */
+export interface DenoAdapterOptions {
+    hostname?: string;
+    maxBodySize?: number;
+    multipart?: MultipartOptions;
+    onListen?: (localAddr: DenoServeOnListenInfo) => void;
+    port?: number;
+    rawBody?: boolean;
+    serve?: DenoServeFunction;
+    upgradeWebSocket?: DenoUpgradeWebSocketFunction;
+}
+/** Bootstrap options for creating a Deno-backed app without auto-running it. */
+export interface BootstrapDenoApplicationOptions extends BootstrapHttpAdapterApplicationOptions, DenoAdapterOptions {
+}
+/** Run-helper options for Deno apps, including optional signal wiring. */
+export interface RunDenoApplicationOptions extends RunHttpAdapterApplicationOptions, DenoAdapterOptions {
+    shutdownSignals?: false | readonly DenoApplicationSignal[];
+}
+declare global {
+    interface GlobalThis {
+        Deno?: DenoGlobalLike;
+    }
+}
+/**
+ * Deno-backed HTTP adapter that preserves request draining and websocket binding seams.
+ */
+export declare class DenoHttpApplicationAdapter implements HttpApplicationAdapter {
+    private readonly options;
+    private abortController?;
+    private closeInFlight?;
+    private dispatcher?;
+    private inFlightDrain?;
+    private inFlightRequestCount;
+    private server?;
+    private websocketBinding?;
+    constructor(options: Required<Pick<DenoAdapterOptions, 'hostname' | 'port'>> & DenoAdapterOptions);
+    getServer(): DenoServeController | undefined;
+    getListenTarget(): HttpAdapterListenTarget;
+    getRealtimeCapability(): import("@fluojs/http").FetchStyleHttpAdapterRealtimeCapability;
+    configureWebSocketBinding<TSocket extends DenoServerWebSocket>(binding: DenoWebSocketBinding<TSocket> | undefined): void;
+    handle(request: Request): Promise<Response>;
+    listen(dispatcher: Dispatcher): Promise<void>;
+    close(): Promise<void>;
+    private trackInFlightRequest;
+    private waitForInFlightRequests;
+}
+/**
+ * Create the canonical Deno HTTP adapter instance.
+ *
+ * @param options Transport, parsing, and websocket-host configuration for the Deno runtime.
+ * @returns A Deno-backed `HttpApplicationAdapter`.
+ */
+export declare function createDenoAdapter(options?: DenoAdapterOptions): DenoHttpApplicationAdapter;
+/**
+ * Bootstrap a Deno-backed application shell without the quick-start run helper.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Bootstrap-time Deno adapter and runtime options.
+ * @returns An initialized application shell that can be listened to later.
+ */
+export declare function bootstrapDenoApplication(rootModule: ModuleType, options?: BootstrapDenoApplicationOptions): Promise<Application>;
+/**
+ * Bootstrap and run a Deno-backed application with optional shutdown signal wiring.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Runtime, adapter, and signal-registration options for Deno.
+ * @returns A running application shell ready to receive requests.
+ */
+export declare function runDenoApplication(rootModule: ModuleType, options?: RunDenoApplicationOptions): Promise<Application>;
+export {};
+//# 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,338 @@
+import { createFetchStyleHttpAdapterRealtimeCapability } from '@fluojs/http';
+import { bootstrapHttpAdapterApplication, runHttpAdapterApplication } from '@fluojs/runtime/internal/http-adapter';
+import { dispatchWebRequest } from '@fluojs/runtime/web';
+
+/** Listen target metadata reported by `Deno.serve(...)` callbacks. */
+
+/** Options forwarded to the Deno-native `serve(...)` implementation. */
+
+/** Minimal controller contract returned by `Deno.serve(...)`. */
+
+/** Deno shutdown signals supported by `runDenoApplication(...)`. */
+
+/** Message payloads delivered through Deno server websocket bindings. */
+
+/** Server-side websocket shape used by the Deno platform binding seam. */
+
+/** Result returned when the Deno runtime upgrades a request to websocket mode. */
+
+/** Function signature for `Deno.upgradeWebSocket(...)` style adapters. */
+
+/** Host wrapper that exposes websocket upgrade support to binding integrations. */
+
+/** Official Deno websocket binding contract consumed by `@fluojs/websockets/deno`. */
+
+/** Hook surface exposed by the Deno HTTP adapter for websocket bindings. */
+
+/** Native request handler shape accepted by Deno's HTTP server runtime. */
+
+/** Function signature for a pluggable Deno serve implementation. */
+
+/** Transport and parsing options for the Deno HTTP adapter factory. */
+
+/** Bootstrap options for creating a Deno-backed app without auto-running it. */
+
+/** Run-helper options for Deno apps, including optional signal wiring. */
+
+const DEFAULT_HOSTNAME = '0.0.0.0';
+const DEFAULT_PORT = 3000;
+const DEFAULT_SHUTDOWN_TIMEOUT_MS = 10_000;
+/**
+ * Deno-backed HTTP adapter that preserves request draining and websocket binding seams.
+ */
+export class DenoHttpApplicationAdapter {
+  abortController;
+  closeInFlight;
+  dispatcher;
+  inFlightDrain;
+  inFlightRequestCount = 0;
+  server;
+  websocketBinding;
+  constructor(options) {
+    this.options = options;
+  }
+  getServer() {
+    return this.server;
+  }
+  getListenTarget() {
+    return createListenTarget(this.options.hostname, this.options.port);
+  }
+  getRealtimeCapability() {
+    return createFetchStyleHttpAdapterRealtimeCapability('Deno exposes Deno.upgradeWebSocket(request) request-upgrade hosting. Use @fluojs/websockets/deno for the official raw websocket binding.', {
+      support: 'supported'
+    });
+  }
+  configureWebSocketBinding(binding) {
+    if (this.server) {
+      throw new Error('Deno websocket binding must be configured before Deno adapter listen() starts the server.');
+    }
+    this.websocketBinding = binding;
+  }
+  async handle(request) {
+    if (this.closeInFlight) {
+      return createShutdownResponse();
+    }
+    const release = this.trackInFlightRequest();
+    try {
+      if (this.websocketBinding && isWebSocketUpgradeRequest(request)) {
+        const upgradeWebSocket = resolveUpgradeWebSocket(this.options.upgradeWebSocket);
+        return await this.websocketBinding.fetch(request, {
+          upgrade: upgradeRequest => upgradeWebSocket(upgradeRequest)
+        });
+      }
+      return await dispatchWebRequest({
+        dispatcher: this.dispatcher,
+        dispatcherNotReadyMessage: 'Deno adapter received a request before dispatcher binding completed.',
+        maxBodySize: this.options.maxBodySize,
+        multipart: this.options.multipart,
+        rawBody: this.options.rawBody,
+        request
+      });
+    } finally {
+      release();
+    }
+  }
+  async listen(dispatcher) {
+    this.dispatcher = dispatcher;
+    if (this.server) {
+      return;
+    }
+    const abortController = new AbortController();
+    const serve = resolveServe(this.options.serve);
+    this.abortController = abortController;
+    this.server = serve({
+      hostname: this.options.hostname,
+      onListen: this.options.onListen,
+      port: this.options.port,
+      signal: abortController.signal
+    }, async request => {
+      return await this.handle(request);
+    });
+  }
+  async close() {
+    if (this.closeInFlight) {
+      await waitForCloseWithTimeout(this.closeInFlight, DEFAULT_SHUTDOWN_TIMEOUT_MS);
+      return;
+    }
+    const server = this.server;
+    const abortController = this.abortController;
+    if (!server) {
+      this.dispatcher = undefined;
+      this.abortController = undefined;
+      return;
+    }
+    const closePromise = closeDenoServerWithDrain(server, abortController, () => this.waitForInFlightRequests());
+    const closeInFlight = closePromise.finally(() => {
+      if (this.server === server) {
+        this.server = undefined;
+      }
+      if (this.abortController === abortController) {
+        this.abortController = undefined;
+      }
+      this.closeInFlight = undefined;
+      this.dispatcher = undefined;
+    });
+    this.closeInFlight = closeInFlight;
+    void closeInFlight.catch(() => {});
+    await waitForCloseWithTimeout(closeInFlight, DEFAULT_SHUTDOWN_TIMEOUT_MS);
+  }
+  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 Deno HTTP adapter instance.
+ *
+ * @param options Transport, parsing, and websocket-host configuration for the Deno runtime.
+ * @returns A Deno-backed `HttpApplicationAdapter`.
+ */
+export function createDenoAdapter(options = {}) {
+  return new DenoHttpApplicationAdapter({
+    ...options,
+    hostname: options.hostname ?? DEFAULT_HOSTNAME,
+    port: options.port ?? DEFAULT_PORT
+  });
+}
+
+/**
+ * Bootstrap a Deno-backed application shell without the quick-start run helper.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Bootstrap-time Deno adapter and runtime options.
+ * @returns An initialized application shell that can be listened to later.
+ */
+export async function bootstrapDenoApplication(rootModule, options = {}) {
+  return await bootstrapHttpAdapterApplication(rootModule, options, createDenoAdapter(options));
+}
+
+/**
+ * Bootstrap and run a Deno-backed application with optional shutdown signal wiring.
+ *
+ * @param rootModule Root module compiled by the Fluo runtime.
+ * @param options Runtime, adapter, and signal-registration options for Deno.
+ * @returns A running application shell ready to receive requests.
+ */
+export async function runDenoApplication(rootModule, options = {}) {
+  const adapter = createDenoAdapter(options);
+  return await runHttpAdapterApplication(rootModule, {
+    ...options,
+    shutdownRegistration: options.shutdownSignals === false ? undefined : createDenoShutdownSignalRegistration(options.shutdownSignals ?? defaultDenoShutdownSignals())
+  }, adapter);
+}
+function defaultDenoShutdownSignals() {
+  return ['SIGINT', 'SIGTERM'];
+}
+function createDenoShutdownSignalRegistration(signals) {
+  return (app, logger) => {
+    const denoGlobal = resolveDenoSignalGlobal();
+    if (!denoGlobal) {
+      return () => {};
+    }
+    const bindings = [];
+    const seen = new Set();
+    for (const signal of signals) {
+      if (seen.has(signal)) {
+        continue;
+      }
+      seen.add(signal);
+      const handler = () => {
+        void closeDenoApplicationFromSignal(app, logger, signal);
+      };
+      bindings.push({
+        handler,
+        signal
+      });
+      denoGlobal.addSignalListener(signal, handler);
+    }
+    return () => {
+      for (const binding of bindings) {
+        denoGlobal.removeSignalListener(binding.signal, binding.handler);
+      }
+    };
+  };
+}
+function createListenTarget(hostname, port) {
+  const isWildcard = hostname === '0.0.0.0' || hostname === '::';
+  const bindTarget = `${formatHostForAuthority(hostname)}:${String(port)}`;
+  const publicHostname = isWildcard ? 'localhost' : formatHostForAuthority(hostname);
+  return {
+    bindTarget,
+    url: `http://${publicHostname}:${String(port)}`
+  };
+}
+function formatHostForAuthority(hostname) {
+  return hostname.includes(':') && !hostname.startsWith('[') ? `[${hostname}]` : hostname;
+}
+function resolveServe(serve) {
+  if (serve) {
+    return serve;
+  }
+  const denoGlobal = globalThis.Deno;
+  if (denoGlobal?.serve) {
+    return denoGlobal.serve.bind(denoGlobal);
+  }
+  throw new Error('Deno.serve is not available. Pass options.serve when running outside Deno.');
+}
+function resolveUpgradeWebSocket(upgradeWebSocket) {
+  if (upgradeWebSocket) {
+    return upgradeWebSocket;
+  }
+  const denoGlobal = globalThis.Deno;
+  if (denoGlobal?.upgradeWebSocket) {
+    return denoGlobal.upgradeWebSocket.bind(denoGlobal);
+  }
+  throw new Error('Deno.upgradeWebSocket is not available. Pass options.upgradeWebSocket when running outside Deno.');
+}
+function isWebSocketUpgradeRequest(request) {
+  return request.headers.get('upgrade')?.toLowerCase() === 'websocket';
+}
+function closeDenoServerWithDrain(server, abortController, waitForDrain) {
+  return (async () => {
+    abortController?.abort();
+    await server.shutdown();
+    await waitForDrain();
+    await server.finished;
+  })();
+}
+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 timeout = setTimeout(() => {
+      reject(new Error(`Deno adapter shutdown timeout exceeded ${String(timeoutMs)}ms.`));
+    }, timeoutMs);
+    void closePromise.then(() => {
+      clearTimeout(timeout);
+      resolve();
+    }, error => {
+      clearTimeout(timeout);
+      reject(error);
+    });
+  });
+}
+function resolveDenoSignalGlobal() {
+  const denoGlobal = globalThis.Deno;
+  if (!denoGlobal?.addSignalListener || !denoGlobal.removeSignalListener) {
+    return undefined;
+  }
+  return {
+    addSignalListener: denoGlobal.addSignalListener.bind(denoGlobal),
+    removeSignalListener: denoGlobal.removeSignalListener.bind(denoGlobal)
+  };
+}
+async function closeDenoApplicationFromSignal(app, logger, signal) {
+  if (app.state === 'closed') {
+    return;
+  }
+  try {
+    await app.close(signal);
+    logger.log(`Application closed after receiving ${signal}.`, 'FluoFactory');
+  } catch (error) {
+    logger.error('Failed to shut down the application cleanly.', error, 'FluoFactory');
+  }
+}

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,48 @@
+{
+  "name": "@fluojs/platform-deno",
+  "description": "Deno-based HTTP adapter for the Fluo runtime.",
+  "keywords": [
+    "fluo",
+    "deno",
+    "http-adapter",
+    "platform",
+    "server"
+  ],
+  "version": "1.0.0-beta.1",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluojs/fluo.git",
+    "directory": "packages/platform-deno"
+  },
+  "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"
+  }
+}