@fluojs/platform-bun 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,88 @@
+# @fluojs/platform-bun
+
+<p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
+
+네이티브 `Bun.serve()`를 기반으로 구축된 fluo 런타임용 Bun 기반 HTTP 어댑터 패키지입니다.
+
+## 목차
+
+- [설치](#설치)
+- [사용 시점](#사용-시점)
+- [빠른 시작](#빠른-시작)
+- [주요 패턴](#주요-패턴)
+- [공개 API 개요](#공개-api-개요)
+- [관련 패키지](#관련-패키지)
+- [예제 소스](#예제-소스)
+
+## 설치
+
+```bash
+npm install @fluojs/platform-bun
+```
+
+이 패키지는 Bun에서 실행하는 것을 전제로 합니다. 배포 manifest는 npm 메타데이터가 Bun 런타임 계약과 어긋나지 않도록 의도적으로 `engines.node`를 선언하지 않으며, 저장소의 Node.js 20+ 요구사항은 메인테이너용 빌드/테스트 툴체인에만 적용됩니다.
+
+## 사용 시점
+
+fluo 애플리케이션을 [Bun](https://bun.sh/) 런타임에서 실행할 때 이 패키지를 사용합니다. 이 어댑터는 Bun의 고성능 `Request`/`Response` 브리지와 네이티브 `fetch` 방식의 아키텍처를 활용하여 Bun 사용자에게 원활하고 빠른 경험을 제공합니다.
+
+애플리케이션 종료 중에는 새 유입을 중단하고, Bun이 서버를 강제로 내리기 전에 활성 HTTP 핸들러가 bounded drain window 안에서 마무리될 수 있도록 동작합니다. 시그널 기반 종료가 `forceExitTimeoutMs`를 넘기거나 실패하면 fluo는 그 상태를 로그와 `process.exitCode`로 보고하고, 최종 프로세스 종료는 Bun 또는 주변 호스트에 맡깁니다.
+
+## 빠른 시작
+
+```typescript
+import { createBunAdapter } from '@fluojs/platform-bun';
+import { fluoFactory } from '@fluojs/runtime';
+import { AppModule } from './app.module';
+
+const app = await fluoFactory.create(AppModule, {
+  adapter: createBunAdapter({ port: 3000 }),
+});
+
+await app.listen();
+```
+
+## 주요 패턴
+
+### 수동 Fetch 처리
+Bun 서버를 직접 관리하려는 경우 fetch 핸들러를 직접 사용할 수 있습니다.
+
+```typescript
+import { createBunFetchHandler } from '@fluojs/platform-bun';
+
+const handler = await createBunFetchHandler({
+  dispatcher: app.getHttpDispatcher(),
+});
+
+Bun.serve({
+  fetch: handler,
+  port: 3000,
+});
+```
+
+### 네이티브 WebSocket 업그레이드
+어댑터는 `@fluojs/websockets/bun` 바인딩을 통해 Bun의 네이티브 `server.upgrade()`를 지원합니다.
+
+```typescript
+// Bun 어댑터가 활성화된 경우 게이트웨이는 자동으로 Bun의 네이티브 업그레이드를 사용합니다.
+@WebSocketGateway({ path: '/ws' })
+export class MyGateway {}
+```
+
+## 공개 API 개요
+
+- `createBunAdapter(options)`: Bun 어댑터를 위한 권장 팩토리입니다.
+- `createBunFetchHandler(options)`: 커스텀 `Bun.serve()` 설정을 위한 네이티브 `fetch(request)` 핸들러를 생성합니다.
+- `bootstrapBunApplication(module, options)`: 암시적 시작 로그 없이 애플리케이션을 부트스트랩하는 고급 헬퍼입니다.
+- `runBunApplication(module, options)`: 시그널 연결을 포함한 빠른 시작을 위한 호환 헬퍼입니다.
+
+## 관련 패키지
+
+- `@fluojs/runtime`: 핵심 런타임입니다.
+- `@fluojs/websockets`: 전용 서브패스 `@fluojs/websockets/bun`을 포함합니다.
+- `@fluojs/socket.io`: 네이티브 Bun 엔진을 지원합니다.
+
+## 예제 소스
+
+- `packages/platform-bun/src/adapter.test.ts`
+- `packages/websockets/src/bun/bun.test.ts`

package/README.md

@@ -0,0 +1,88 @@
+# @fluojs/platform-bun
+
+<p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
+
+Bun-backed HTTP adapter for the fluo runtime, built on native `Bun.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
+npm install @fluojs/platform-bun
+```
+
+This package is intended to run on Bun. The published manifest intentionally does not declare `engines.node`, so npm metadata stays aligned with the Bun 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 [Bun](https://bun.sh/) runtime. This adapter leverages Bun's high-performance `Request`/`Response` bridge and native `fetch`-style architecture, providing a seamless and fast experience for Bun users.
+
+During application shutdown, the adapter stops new ingress and gives active HTTP handlers a bounded drain window before Bun forcefully tears the server down. If signal-driven shutdown exceeds `forceExitTimeoutMs` or fails, fluo reports that condition through logging and `process.exitCode` while leaving final process termination to Bun or the surrounding host.
+
+## Quick Start
+
+```typescript
+import { createBunAdapter } from '@fluojs/platform-bun';
+import { fluoFactory } from '@fluojs/runtime';
+import { AppModule } from './app.module';
+
+const app = await fluoFactory.create(AppModule, {
+  adapter: createBunAdapter({ port: 3000 }),
+});
+
+await app.listen();
+```
+
+## Common Patterns
+
+### Manual Fetch Handling
+If you prefer to manage the Bun server yourself, you can use the fetch handler directly.
+
+```typescript
+import { createBunFetchHandler } from '@fluojs/platform-bun';
+
+const handler = await createBunFetchHandler({
+  dispatcher: app.getHttpDispatcher(),
+});
+
+Bun.serve({
+  fetch: handler,
+  port: 3000,
+});
+```
+
+### Native WebSocket Upgrade
+The adapter supports Bun's native `server.upgrade()` through the `@fluojs/websockets/bun` binding.
+
+```typescript
+// gateways automatically use Bun's native upgrade when the Bun adapter is active
+@WebSocketGateway({ path: '/ws' })
+export class MyGateway {}
+```
+
+## Public API Overview
+
+- `createBunAdapter(options)`: Recommended factory for the Bun adapter.
+- `createBunFetchHandler(options)`: Creates a native `fetch(request)` handler for custom `Bun.serve()` setups.
+- `bootstrapBunApplication(module, options)`: Advanced bootstrap without implicit startup logging.
+- `runBunApplication(module, options)`: Compatibility helper for quick startup with signal wiring.
+
+## Related Packages
+
+- `@fluojs/runtime`: Core framework runtime.
+- `@fluojs/websockets`: Includes specific subpath `@fluojs/websockets/bun`.
+- `@fluojs/socket.io`: Supports the native Bun engine.
+
+## Example Sources
+
+- `packages/platform-bun/src/adapter.test.ts`
+- `packages/websockets/src/bun/bun.test.ts`

package/dist/adapter.d.ts

@@ -0,0 +1,144 @@
+import type { CorsOptions, Dispatcher, HttpApplicationAdapter, MiddlewareLike, SecurityHeadersOptions } from '@fluojs/http';
+import type { Application, ApplicationLogger, CreateApplicationOptions, ModuleType, MultipartOptions, UploadedFile } from '@fluojs/runtime';
+import { type HttpAdapterListenTarget } from '@fluojs/runtime/internal/http-adapter';
+declare module '@fluojs/http' {
+    interface FrameworkRequest {
+        files?: UploadedFile[];
+        rawBody?: Uint8Array;
+    }
+}
+type BunHostname = string;
+export type BunApplicationSignal = 'SIGINT' | 'SIGTERM';
+export type BunCorsInput = false | string | string[] | CorsOptions;
+export type BunTlsOptions = Record<string, unknown>;
+export type BunWebSocketMessage = string | ArrayBuffer | Uint8Array;
+export interface BunServerWebSocket<TData = unknown> {
+    readonly data: TData;
+    readonly readyState: number;
+    readonly remoteAddress: string;
+    readonly subscriptions: string[];
+    close(code?: number, reason?: string): void;
+    cork(callback: (socket: BunServerWebSocket<TData>) => void): void;
+    isSubscribed(topic: string): boolean;
+    publish(topic: string, message: BunWebSocketMessage): void;
+    send(message: BunWebSocketMessage, compress?: boolean): number;
+    subscribe(topic: string): void;
+    unsubscribe(topic: string): void;
+}
+export interface BunWebSocketHandler<TData = unknown> {
+    backpressureLimit?: number;
+    close?(socket: BunServerWebSocket<TData>, code: number, reason: string): void | Promise<void>;
+    closeOnBackpressureLimit?: boolean;
+    data?: TData;
+    drain?(socket: BunServerWebSocket<TData>): void | Promise<void>;
+    error?(socket: BunServerWebSocket<TData>, error: Error): void | Promise<void>;
+    idleTimeout?: number;
+    maxPayloadLength?: number;
+    message?(socket: BunServerWebSocket<TData>, message: BunWebSocketMessage): void | Promise<void>;
+    open?(socket: BunServerWebSocket<TData>): void | Promise<void>;
+    perMessageDeflate?: boolean | {
+        compress?: boolean | '128KB' | '16KB' | '256KB' | '32KB' | '3KB' | '4KB' | '64KB' | '8KB' | 'dedicated' | 'disable' | 'shared';
+        decompress?: boolean | '128KB' | '16KB' | '256KB' | '32KB' | '3KB' | '4KB' | '64KB' | '8KB' | 'dedicated' | 'disable' | 'shared';
+    };
+    publishToSelf?: boolean;
+    sendPings?: boolean;
+}
+export interface BunWebSocketBinding<TData = unknown> {
+    fetch(request: Request, server: BunServerLike): Response | Promise<Response> | undefined | Promise<Response | undefined>;
+    idleTimeout?: number;
+    maxRequestBodySize?: number;
+    websocket: BunWebSocketHandler<TData>;
+}
+export interface BunRealtimeBindingHost {
+    configureRealtimeBinding<TData>(binding: BunWebSocketBinding<TData> | undefined): void;
+}
+export interface BunWebSocketBindingHost extends BunRealtimeBindingHost {
+    configureWebSocketBinding<TData>(binding: BunWebSocketBinding<TData> | undefined): void;
+}
+export interface BunServeOptions {
+    development?: boolean;
+    error?: (error: Error) => Response | Promise<Response>;
+    fetch(request: Request, server: BunServerLike): Response | Promise<Response> | undefined | Promise<Response | undefined>;
+    hostname?: BunHostname;
+    idleTimeout?: number;
+    maxRequestBodySize?: number;
+    port?: number;
+    tls?: BunTlsOptions;
+    websocket?: BunWebSocketHandler;
+}
+export interface BunServerLike {
+    fetch?(request: Request): Response | Promise<Response> | undefined | Promise<Response | undefined>;
+    hostname?: BunHostname;
+    port?: number;
+    stop(closeActiveConnections?: boolean): void;
+    upgrade<TData = unknown>(request: Request, options?: {
+        data?: TData;
+        headers?: HeadersInit;
+    }): boolean;
+    url?: URL;
+}
+export interface BunAdapterOptions {
+    development?: boolean;
+    hostname?: BunHostname;
+    idleTimeout?: number;
+    maxBodySize?: number;
+    multipart?: MultipartOptions;
+    port?: number;
+    rawBody?: boolean;
+    stopActiveConnections?: boolean;
+    tls?: BunTlsOptions;
+}
+export interface CreateBunFetchHandlerOptions {
+    dispatcher: Dispatcher;
+    dispatcherNotReadyMessage?: string;
+    maxBodySize?: number;
+    multipart?: MultipartOptions;
+    rawBody?: boolean;
+}
+export interface BootstrapBunApplicationOptions extends Omit<CreateApplicationOptions, 'adapter' | 'logger' | 'middleware'> {
+    cors?: BunCorsInput;
+    development?: boolean;
+    globalPrefix?: string;
+    globalPrefixExclude?: readonly string[];
+    hostname?: BunHostname;
+    idleTimeout?: number;
+    logger?: ApplicationLogger;
+    maxBodySize?: number;
+    middleware?: MiddlewareLike[];
+    multipart?: MultipartOptions;
+    port?: number;
+    rawBody?: boolean;
+    securityHeaders?: false | SecurityHeadersOptions;
+    stopActiveConnections?: boolean;
+    tls?: BunTlsOptions;
+}
+export interface RunBunApplicationOptions extends BootstrapBunApplicationOptions {
+    forceExitTimeoutMs?: number;
+    shutdownSignals?: false | readonly BunApplicationSignal[];
+}
+export declare class BunHttpApplicationAdapter implements HttpApplicationAdapter, BunWebSocketBindingHost {
+    private readonly options;
+    private closeInFlight?;
+    private dispatcher?;
+    private inFlightDrain?;
+    private inFlightRequestCount;
+    private server?;
+    private realtimeBinding?;
+    constructor(options?: BunAdapterOptions);
+    getServer(): BunServerLike | undefined;
+    getListenTarget(): HttpAdapterListenTarget;
+    getRealtimeCapability(): import("@fluojs/http").FetchStyleHttpAdapterRealtimeCapability;
+    configureRealtimeBinding<TData>(binding: BunWebSocketBinding<TData> | undefined): void;
+    configureWebSocketBinding<TData>(binding: BunWebSocketBinding<TData> | undefined): void;
+    listen(dispatcher: Dispatcher): Promise<void>;
+    close(): Promise<void>;
+    private dispatchHttpRequest;
+    private trackInFlightRequest;
+    private waitForInFlightRequests;
+}
+export declare function createBunFetchHandler({ dispatcher, dispatcherNotReadyMessage, maxBodySize, multipart, rawBody, }: CreateBunFetchHandlerOptions): (request: Request) => Promise<Response>;
+export declare function createBunAdapter(options?: BunAdapterOptions): HttpApplicationAdapter;
+export declare function bootstrapBunApplication(rootModule: ModuleType, options: BootstrapBunApplicationOptions): Promise<Application>;
+export declare function runBunApplication(rootModule: ModuleType, options: RunBunApplicationOptions): 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,249 @@
+import { createFetchStyleHttpAdapterRealtimeCapability } from '@fluojs/http';
+import { createNodeShutdownSignalRegistration, defaultNodeShutdownSignals } from '@fluojs/runtime/node';
+import { dispatchWebRequest } from '@fluojs/runtime/web';
+import { bootstrapHttpAdapterApplication, runHttpAdapterApplication } from '@fluojs/runtime/internal/http-adapter';
+const DEFAULT_PORT = 3000;
+const DEFAULT_DISPATCHER_NOT_READY_MESSAGE = 'Bun adapter received a request before dispatcher binding completed.';
+const DEFAULT_SHUTDOWN_TIMEOUT_MS = 10_000;
+const BUN_WEBSOCKET_SUPPORT_REASON = 'Bun exposes Bun.serve() + server.upgrade() request-upgrade hosting. Use @fluojs/websockets/bun for the official raw websocket binding.';
+export class BunHttpApplicationAdapter {
+  closeInFlight;
+  dispatcher;
+  inFlightDrain;
+  inFlightRequestCount = 0;
+  server;
+  realtimeBinding;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  getServer() {
+    return this.server;
+  }
+  getListenTarget() {
+    const protocol = this.options.tls ? 'https' : 'http';
+    const configuredHostname = this.options.hostname ?? 'localhost';
+    const port = this.server?.port ?? this.options.port ?? DEFAULT_PORT;
+    const url = this.server?.url?.origin ?? `${protocol}://${configuredHostname}:${String(port)}`;
+    const bindHost = this.server?.hostname ?? this.options.hostname ?? configuredHostname;
+    return {
+      bindTarget: `${bindHost}:${String(port)}`,
+      url
+    };
+  }
+  getRealtimeCapability() {
+    return createFetchStyleHttpAdapterRealtimeCapability(BUN_WEBSOCKET_SUPPORT_REASON, {
+      support: 'supported'
+    });
+  }
+  configureRealtimeBinding(binding) {
+    if (this.server && binding !== undefined) {
+      throw new Error('Bun websocket binding must be configured before Bun adapter listen() starts the server.');
+    }
+    this.realtimeBinding = binding;
+  }
+  configureWebSocketBinding(binding) {
+    this.configureRealtimeBinding(binding);
+  }
+  async listen(dispatcher) {
+    this.dispatcher = dispatcher;
+    if (this.server) {
+      return;
+    }
+    const bun = requireBunGlobal();
+    const realtimeBinding = this.realtimeBinding;
+    this.server = bun.serve({
+      development: this.options.development,
+      fetch: async (request, server) => {
+        if (this.server === undefined) {
+          this.server = server;
+        }
+        if (realtimeBinding) {
+          const handled = await realtimeBinding.fetch(request, server);
+          if (handled !== undefined || isWebSocketUpgradeRequest(request)) {
+            return handled;
+          }
+        }
+        return await this.dispatchHttpRequest(request);
+      },
+      hostname: this.options.hostname,
+      idleTimeout: realtimeBinding?.idleTimeout ?? this.options.idleTimeout,
+      maxRequestBodySize: realtimeBinding?.maxRequestBodySize ?? this.options.maxBodySize,
+      port: resolvePort(this.options.port),
+      tls: this.options.tls,
+      websocket: realtimeBinding?.websocket
+    });
+  }
+  async close() {
+    if (this.closeInFlight) {
+      await waitForCloseWithTimeout(this.closeInFlight, DEFAULT_SHUTDOWN_TIMEOUT_MS);
+      return;
+    }
+    if (!this.server) {
+      this.dispatcher = undefined;
+      return;
+    }
+    const server = this.server;
+    const closePromise = closeBunServerWithDrain(server, this.options.stopActiveConnections, () => this.waitForInFlightRequests());
+    const closeInFlight = closePromise.finally(() => {
+      if (this.server === server) {
+        this.server = undefined;
+      }
+      this.closeInFlight = undefined;
+      this.dispatcher = undefined;
+    });
+    this.closeInFlight = closeInFlight;
+    void closeInFlight.catch(() => {});
+    await waitForCloseWithTimeout(closeInFlight, DEFAULT_SHUTDOWN_TIMEOUT_MS);
+  }
+  async dispatchHttpRequest(request) {
+    if (this.closeInFlight) {
+      return createShutdownResponse();
+    }
+    const release = this.trackInFlightRequest();
+    try {
+      return await dispatchWebRequest({
+        dispatcher: this.dispatcher,
+        dispatcherNotReadyMessage: DEFAULT_DISPATCHER_NOT_READY_MESSAGE,
+        maxBodySize: this.options.maxBodySize,
+        multipart: this.options.multipart,
+        rawBody: this.options.rawBody,
+        request
+      });
+    } finally {
+      release();
+    }
+  }
+  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;
+  }
+}
+export function createBunFetchHandler({
+  dispatcher,
+  dispatcherNotReadyMessage = DEFAULT_DISPATCHER_NOT_READY_MESSAGE,
+  maxBodySize,
+  multipart,
+  rawBody
+}) {
+  return async function bunFetchHandler(request) {
+    return await dispatchWebRequest({
+      dispatcher,
+      dispatcherNotReadyMessage,
+      maxBodySize,
+      multipart,
+      rawBody,
+      request
+    });
+  };
+}
+export function createBunAdapter(options = {}) {
+  return new BunHttpApplicationAdapter(options);
+}
+export async function bootstrapBunApplication(rootModule, options) {
+  return bootstrapHttpAdapterApplication(rootModule, options, createBunAdapter({
+    development: options.development,
+    hostname: options.hostname,
+    idleTimeout: options.idleTimeout,
+    maxBodySize: options.maxBodySize,
+    multipart: options.multipart,
+    port: options.port,
+    rawBody: options.rawBody,
+    stopActiveConnections: options.stopActiveConnections,
+    tls: options.tls
+  }));
+}
+export async function runBunApplication(rootModule, options) {
+  const adapter = createBunAdapter({
+    development: options.development,
+    hostname: options.hostname,
+    idleTimeout: options.idleTimeout,
+    maxBodySize: options.maxBodySize,
+    multipart: options.multipart,
+    port: options.port,
+    rawBody: options.rawBody,
+    stopActiveConnections: options.stopActiveConnections,
+    tls: options.tls
+  });
+  return runHttpAdapterApplication(rootModule, {
+    ...options,
+    shutdownRegistration: createNodeShutdownSignalRegistration(options.shutdownSignals ?? defaultNodeShutdownSignals())
+  }, adapter);
+}
+function requireBunGlobal() {
+  const bun = globalThis.Bun;
+  if (!bun || typeof bun.serve !== 'function') {
+    throw new Error('Bun adapter requires globalThis.Bun.serve(). Run this package inside Bun or provide a Bun-compatible test double.');
+  }
+  return bun;
+}
+function resolvePort(port) {
+  return typeof port === 'number' && Number.isFinite(port) ? port : DEFAULT_PORT;
+}
+function closeBunServerWithDrain(server, stopActiveConnections, waitForDrain) {
+  return (async () => {
+    server.stop(stopActiveConnections);
+    await waitForDrain();
+  })();
+}
+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(`Bun adapter shutdown timeout exceeded ${String(timeoutMs)}ms.`));
+    }, timeoutMs);
+    void closePromise.then(() => {
+      clearTimeout(timeoutHandle);
+      resolve();
+    }, error => {
+      clearTimeout(timeoutHandle);
+      reject(error);
+    });
+  });
+}
+function isWebSocketUpgradeRequest(request) {
+  return request.headers.get('upgrade')?.toLowerCase() === 'websocket';
+}

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-bun",
+  "description": "Bun-based HTTP adapter for the Fluo runtime.",
+  "keywords": [
+    "fluo",
+    "bun",
+    "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-bun"
+  },
+  "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"
+  }
+}