@krisanalfa/bunest-adapter 0.3.0 → 0.5.0

package/dist/bun.server-instance.d.ts

@@ -0,0 +1,137 @@
+import { CorsOptions, CorsOptionsDelegate } from '@nestjs/common/interfaces/external/cors-options.interface.js';
+import { RequestMethod } from '@nestjs/common';
+import { Server, ServerWebSocket } from 'bun';
+import { RequestHandler } from '@nestjs/common/interfaces/index.js';
+import { BunStaticAssetsOptions, BunWsClientData, ServerOptions, WsData, WsOptions } from './bun.internal.types.js';
+import { BunMiddlewareEngine } from './bun.middleware-engine.js';
+import { BunRequest } from './bun.request.js';
+import { BunResponse } from './bun.response.js';
+/**
+ * BunServerInstance is the actual server instance that handles route registrations,
+ * WebSocket functionalities, and the listen method. This class is passed to
+ * AbstractHttpAdapter.setInstance() and implements the methods that NestJS expects
+ * from an HTTP server instance (similar to Express app or Fastify instance).
+ */
+export declare class BunServerInstance {
+    private readonly bunServeOptions;
+    private readonly logger;
+    private readonly middlewareEngine;
+    private useVersioning;
+    private readonly routes;
+    private readonly routeHandlers;
+    private notFoundHandler;
+    private readonly wsHandlers;
+    private readonly wsMiddlewareEngine;
+    private wsOptions;
+    private useWs;
+    private useWsCors;
+    private staticAssetsOptions;
+    private httpServer;
+    constructor(bunServeOptions: ServerOptions<BunWsClientData>);
+    use(maybePath: string | RequestHandler<BunRequest, BunResponse>, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    private createHttpMethodHandler;
+    get(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    post(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    put(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    patch(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    delete(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    head(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    options(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    private createUnsupportedMethod;
+    all(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    propfind(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    proppatch(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    mkcol(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    copy(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    move(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    lock(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    unlock(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    search(pathOrHandler: unknown, maybeHandler?: RequestHandler<BunRequest, BunResponse>): void;
+    /**
+     * Start listening on the specified port and hostname.
+     * @param port The port number or Unix socket path to listen on.
+     * @param hostnameOrCallback The hostname to bind to or the callback function.
+     * @param maybeCallback Optional callback to invoke once the server is listening.
+     */
+    listen(port: string | number, hostnameOrCallback?: string | (() => void), maybeCallback?: () => void): Promise<Server<unknown>>;
+    /**
+     * NestJS compatibility methods - stop the server
+     */
+    stop(force?: boolean): Promise<void>;
+    /**
+     * Get the address of the server
+     */
+    address(): {
+        address: string;
+        port: number;
+    };
+    /**
+     * Set WebSocket options
+     */
+    setWsOptions(options: WsOptions): void;
+    /**
+     * Register WebSocket open handler
+     */
+    registerWsOpenHandler(handler: (ws: ServerWebSocket<unknown>) => void): void;
+    /**
+     * Register WebSocket message handler
+     */
+    registerWsMessageHandler(handler: (ws: ServerWebSocket<unknown>, message: WsData, server: Server<unknown>) => void): void;
+    /**
+     * Register WebSocket close handler
+     */
+    registerWsCloseHandler(handler: (ws: ServerWebSocket<unknown>, code: number, reason: string) => void): void;
+    /**
+     * Get the underlying Bun server
+     */
+    getBunServer(): Server<unknown> | null;
+    /**
+     * Proxy method for WebSocket server close (BaseWsInstance)
+     */
+    close(): Promise<void>;
+    /**
+     * Get the middleware engine
+     */
+    getMiddlewareEngine(): BunMiddlewareEngine;
+    /**
+     * Set the not found handler
+     */
+    setNotFoundHandler(handler: RequestHandler<BunRequest, BunResponse>): void;
+    /**
+     * Enable versioning support
+     */
+    setUseVersioning(value: boolean): void;
+    /**
+     * Register body parser middleware
+     */
+    registerParserMiddleware(prefix?: string, rawBody?: boolean): void;
+    /**
+     * Create middleware factory for NestJS
+     */
+    createMiddlewareFactory(requestMethod: RequestMethod): (path: string, callback: Function) => void;
+    /**
+     * Enable CORS middleware
+     */
+    enableCors(corsOptions?: CorsOptions | CorsOptionsDelegate<BunRequest>, prefix?: string): void;
+    /**
+     * Serve static assets
+     */
+    useStaticAssets(path: string, options?: BunStaticAssetsOptions): void;
+    private static isNumericPort;
+    private static omitKeys;
+    private isWebSocketUpgradeRequest;
+    private provideCorsHeaders;
+    private upgradeWebSocket;
+    private setupStaticAssetsIfNeeded;
+    private setupWebSocketIfNeeded;
+    private createServer;
+    private delegateRouteHandler;
+    private ensureRouteExists;
+    private prepareRequestHandler;
+    private createRouteFetchHandler;
+    private createVersioningHandlers;
+    private executeHandlerChain;
+    private createChainedHandlerForVersioningResolution;
+    private mapRequestMethodToString;
+    private parseRouteHandler;
+}

package/dist/bun.ws-adapter.d.ts

@@ -2,9 +2,8 @@ import { AbstractWsAdapter, BaseWsInstance, MessageMappingProperties } from '@ne
 import { Observable } from 'rxjs';
 import { INestApplicationContext } from '@nestjs/common';
 import { ServerWebSocket } from 'bun';
+import { BunWsClientData, WsData, WsOptions } from './bun.internal.types.js';
 import { BunPreflightHttpServer } from './bun.preflight-http-server.js';
-import { WsOptions } from './internal.types.js';
-export type WsData = string | Buffer | ArrayBuffer | Buffer[];
 export type WsMessageParser<TData = unknown> = (data: WsData) => WsParsedData<TData>;
 export interface WsParsedData<TData = unknown> {
     event: string;
@@ -13,15 +12,6 @@ export interface WsParsedData<TData = unknown> {
 export interface BunWsAdapterOptions extends WsOptions {
     messageParser?: WsMessageParser;
 }
-/** Internal data stored on each WebSocket connection - must match bun.adapter.ts */
-interface BunWsClientData {
-    /** Called when a message is received - matches bun.adapter.ts onMessageInternal */
-    onMessageInternal?: (message: WsData) => void;
-    /** Called when the connection closes - matches bun.adapter.ts onCloseInternal */
-    onCloseInternal?: () => void;
-    /** Called by NestJS for disconnect handling */
-    onDisconnect?: (ws: ServerWebSocket<unknown>) => void;
-}
 type BunWsClient = ServerWebSocket<BunWsClientData> & BaseWsInstance;
 /**
  * High-performance WebSocket adapter for Bun runtime with NestJS.

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './bun.adapter.js';
 export * from './bun.request.js';
 export * from './bun.response.js';
 export * from './bun.file.interceptor.js';
-export * from './internal.types.js';
+export * from './bun.internal.types.js';
 export * from './bun.preflight-http-server.js';
+export * from './bun.server-instance.js';
 export * from './bun.ws-adapter.js';