@ailura/nestjs-hono-adapter 1.0.0

package/dist/ws-adapter.js

@@ -0,0 +1,214 @@
+import { createNodeWebSocket } from '@hono/node-ws';
+import { Logger } from '@nestjs/common';
+import { AbstractWsAdapter } from '@nestjs/websockets';
+import { EMPTY, catchError, filter, first, fromEvent, map, mergeMap, share, takeUntil, } from 'rxjs';
+import { CLOSE_EVENT, HonoSocket, MESSAGE_EVENT, isReply, parseFrame, toReply, } from './ws-client.js';
+import { GatewayServer } from './ws-server.js';
+/** The port a gateway asks for when it keeps the HTTP one. */
+const UNDERLYING_PORT = 0;
+/** The path a gateway listens on when it named none. */
+const ROOT_PATH = '/';
+/** The event Node reports a protocol upgrade on. */
+const UPGRADE_EVENT = 'upgrade';
+/** Gives a gateway path the leading slash a route needs. */
+function normalizePath(path) {
+    if (path === undefined || path === '') {
+        return ROOT_PATH;
+    }
+    if (path.startsWith(ROOT_PATH)) {
+        return path;
+    }
+    return `/${path}`;
+}
+/** The handlers of one gateway, by the event each answers. */
+function indexHandlers(handlers) {
+    const byEvent = new Map();
+    for (const handler of handlers) {
+        byEvent.set(handler.message, handler);
+    }
+    return byEvent;
+}
+/**
+ * Removes the upgrade listeners `@hono/node-ws` installed on
+ * the server. Node types a listener as `Function`, which `off`
+ * does not accept, so the call goes through `Reflect.apply`,
+ * whose argument list carries no type.
+ */
+function detachUpgradeListeners(server, kept) {
+    const off = server.off.bind(server);
+    for (const listener of server.listeners(UPGRADE_EVENT)) {
+        if (!kept.includes(listener)) {
+            Reflect.apply(off, undefined, [UPGRADE_EVENT, listener]);
+        }
+    }
+}
+/**
+ * WebSocket adapter that runs Nest's gateways on the Hono
+ * application the HTTP adapter already serves.
+ *
+ * `@hono/node-ws` upgrades a request by asking the Hono
+ * application for the gateway path, so the upgrade happens on
+ * one server rather than on a second one opened beside it. One
+ * route is registered per path a gateway named, and each route
+ * hands Nest a {@link HonoSocket} to answer on.
+ *
+ * A gateway that asked for its own port or for a namespace
+ * cannot be served this way; both are refused rather than
+ * quietly served on the HTTP server.
+ */
+class HonoWsAdapter extends AbstractWsAdapter {
+    constructor(httpAdapter) {
+        super(httpAdapter);
+        this.servers = new Map();
+        this.logger = new Logger(HonoWsAdapter.name);
+        this.injected = false;
+        this.adapter = httpAdapter;
+        this.node = createNodeWebSocket({
+            app: httpAdapter.getHono(),
+        });
+    }
+    create(port, options = {}) {
+        this.ensureSupported(port, options);
+        return this.open(normalizePath(options.path));
+    }
+    /**
+     * Bridges the handlers Nest explored for one client onto the
+     * frames that client sends. Every subscription is tied to the
+     * socket's own close event, so a connection that goes away
+     * takes its subscriptions with it.
+     */
+    bindMessageHandlers(client, handlers, transform) {
+        const byEvent = indexHandlers(handlers);
+        const closed = fromEvent(client, CLOSE_EVENT).pipe(share(), first());
+        const answers = fromEvent(client, MESSAGE_EVENT).pipe(mergeMap((raw) => this.answer(raw, byEvent, transform)), takeUntil(closed));
+        answers.subscribe((reply) => {
+            client.sendJson(reply);
+        });
+    }
+    bindClientDisconnect(client, callback) {
+        client.once(CLOSE_EVENT, callback);
+    }
+    /** Closes every socket a gateway path is serving. */
+    close(server) {
+        server.close();
+        return Promise.resolve();
+    }
+    /**
+     * Releases the paths, the sockets and the WebSocket server
+     * this adapter created, and takes the upgrade listeners back
+     * off the Node server.
+     */
+    dispose() {
+        this.release();
+        return Promise.resolve();
+    }
+    /**
+     * Releases the paths, the sockets, the WebSocket server and
+     * the upgrade listeners this adapter registered.
+     */
+    release() {
+        const servers = [...this.servers.values()];
+        this.servers.clear();
+        for (const server of servers) {
+            server.close();
+        }
+        this.node.wss.close();
+        const { detach } = this;
+        if (detach !== undefined) {
+            detach();
+        }
+        this.detach = undefined;
+        this.injected = false;
+    }
+    /**
+     * Serves one path, reusing the server already serving it:
+     * Nest asks once per path, and a repeated ask must not
+     * register the route twice.
+     */
+    open(path) {
+        const known = this.servers.get(path);
+        if (known !== undefined) {
+            return known;
+        }
+        const server = new GatewayServer();
+        this.servers.set(path, server);
+        this.serve(path, server);
+        this.inject();
+        return server;
+    }
+    /** Registers the upgrade route one gateway path needs. */
+    serve(path, server) {
+        const upgrade = this.node.upgradeWebSocket(() => {
+            const client = new HonoSocket();
+            return {
+                onClose: () => {
+                    client.disconnect();
+                },
+                onMessage: (event) => {
+                    client.deliver(event.data);
+                },
+                onOpen: (_event, socket) => {
+                    client.use(socket);
+                    server.accept(client);
+                },
+            };
+        });
+        this.adapter.getHono().get(path, upgrade);
+    }
+    /** Lets the Node server hand upgrades to the Hono app. */
+    inject() {
+        if (this.injected) {
+            return;
+        }
+        const server = this.adapter.getHttpServer();
+        const before = server.listeners(UPGRADE_EVENT);
+        this.node.injectWebSocket(server);
+        this.detach = () => {
+            detachUpgradeListeners(server, before);
+        };
+        this.injected = true;
+    }
+    /** Answers one frame, when a handler claims its event. */
+    answer(raw, byEvent, transform) {
+        const frame = parseFrame(raw);
+        if (frame === undefined) {
+            return EMPTY;
+        }
+        const handler = byEvent.get(frame.event);
+        if (handler === undefined) {
+            return EMPTY;
+        }
+        return this.invoke(handler, frame, transform);
+    }
+    /** Runs one handler and turns its answer into frames. */
+    invoke(handler, frame, transform) {
+        try {
+            return this.replies(transform(handler.callback(frame.data)), frame);
+        }
+        catch (error) {
+            return this.report(error);
+        }
+    }
+    /** The frames one handler's stream answers with. */
+    replies(stream, frame) {
+        return stream.pipe(map((value) => toReply(frame, value)), filter(isReply), catchError((error) => this.report(error)));
+    }
+    /** Reports a handler that failed and answers nothing. */
+    report(error) {
+        this.logger.error(error);
+        return EMPTY;
+    }
+    /** Refuses the gateways this adapter cannot serve. */
+    ensureSupported(port, options) {
+        if (port !== UNDERLYING_PORT) {
+            throw new TypeError('HonoWsAdapter serves every gateway on the HTTP ' +
+                `adapter's server, so the gateway port ${port} ` +
+                'cannot be honoured.');
+        }
+        if (options.namespace !== undefined) {
+            throw new TypeError('HonoWsAdapter does not support WebSocket namespaces.');
+        }
+    }
+}
+export { HonoWsAdapter };
+//# sourceMappingURL=ws-adapter.js.map

package/dist/ws-adapter.js.map

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

package/dist/ws-client.d.ts

@@ -0,0 +1,68 @@
+import { EventEmitter } from 'node:events';
+import type { WSContext } from 'hono/ws';
+/** The event a frame from the client arrives on. */
+declare const MESSAGE_EVENT = "message";
+/** The event that says the socket has gone away. */
+declare const CLOSE_EVENT = "close";
+/**
+ * One frame from a client: the event it names, the payload it
+ * carries, and the correlation it asked to have repeated.
+ */
+interface WsFrame {
+    /** The event the gateway answers. */
+    readonly event: string;
+    /** What the handler is given. */
+    readonly data?: unknown;
+    /** The correlation the answer repeats, when there is one. */
+    readonly id?: string | number;
+}
+/** What a gateway answers with. */
+interface WsReply {
+    /** The event being answered. */
+    readonly event: string;
+    /** What the handler returned, when it returned anything. */
+    readonly data?: unknown;
+    /** The correlation the client asked to have repeated. */
+    readonly id?: string | number;
+}
+/**
+ * Reads a frame from what the socket delivered. Text frames
+ * arrive as text, binary frames as bytes, and a socket may hand
+ * over an already parsed frame when one is replayed.
+ */
+declare function parseFrame(raw: unknown): WsFrame | undefined;
+/**
+ * The frame that answers one, or nothing when the handler
+ * answered with nothing and the client asked for no
+ * acknowledgement.
+ *
+ * A handler that answered with its own `{ event, data }` keeps
+ * that shape, which is what the `ws` platform sends; anything
+ * else is wrapped in the event being answered.
+ */
+declare function toReply(frame: WsFrame, value: unknown): WsReply | undefined;
+/** Says whether an answer is worth sending. */
+declare function isReply(value: WsReply | undefined): value is WsReply;
+/**
+ * One client connection, in the shape Nest's WebSocket layer
+ * reads: a `message` event for every frame the client sends, a
+ * `close` event once, and `send()` for the answers. Nest
+ * subscribes with `on` and `once`, so this follows the Node
+ * emitter its own adapters use rather than an `EventTarget`.
+ */
+declare class HonoSocket extends EventEmitter {
+    private socket;
+    /** Binds this client to the socket the upgrade produced. */
+    use(socket: WSContext): void;
+    /** Emits the frame the client sent. */
+    deliver(data: unknown): void;
+    /** Says the socket is gone, and only ever once. */
+    disconnect(): void;
+    /** Sends one answer, unless the socket is no longer open. */
+    sendJson(reply: unknown): void;
+    /** Closes the socket from this side. */
+    close(): void;
+}
+export { CLOSE_EVENT, MESSAGE_EVENT, HonoSocket, isReply, parseFrame, toReply, };
+export type { WsFrame, WsReply };
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../src/ws-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,oDAAoD;AACpD,QAAA,MAAM,aAAa,YAAY,CAAC;AAEhC,oDAAoD;AACpD,QAAA,MAAM,WAAW,UAAU,CAAC;AAK5B;;;GAGG;AACH,UAAU,OAAO;IACf,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED,mCAAmC;AACnC,UAAU,OAAO;IACf,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAsCD;;;;GAIG;AACH,iBAAS,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAQrD;AAiBD;;;;;;;;GAQG;AACH,iBAAS,OAAO,CACd,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,GACb,OAAO,GAAG,SAAS,CAYrB;AAED,+CAA+C;AAC/C,iBAAS,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,IAAI,OAAO,CAE7D;AAED;;;;;;GAMG;AACH,cAAM,UAAW,SAAQ,YAAY;IACnC,OAAO,CAAC,MAAM,CAAwB;IAEtC,4DAA4D;IACrD,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAElC;IAED,uCAAuC;IAChC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAElC;IAED,mDAAmD;IAC5C,UAAU,IAAI,IAAI,CAGxB;IAED,6DAA6D;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CASpC;IAED,wCAAwC;IACjC,KAAK,IAAI,IAAI,CAMnB;CACF;AAED,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,OAAO,EACP,UAAU,EACV,OAAO,GACR,CAAC;AACF,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/ws-client.js

@@ -0,0 +1,135 @@
+import { EventEmitter } from 'node:events';
+/** The event a frame from the client arrives on. */
+const MESSAGE_EVENT = 'message';
+/** The event that says the socket has gone away. */
+const CLOSE_EVENT = 'close';
+/** The state a socket is in once it accepts a send. */
+const OPEN_STATE = 1;
+/** Says whether a value is a frame, by the event it names. */
+function isFrame(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    return 'event' in value && typeof value.event === 'string';
+}
+/**
+ * Reads the frame a parsed payload carries. A payload that is
+ * only a string names the event and carries no data, which is
+ * how a gateway is called without arguments.
+ */
+function frameFrom(value) {
+    if (isFrame(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return { event: value };
+    }
+    return undefined;
+}
+/**
+ * Reads a frame from text. Text that is not JSON is taken as
+ * the event name itself, so a client may send `ping` as well as
+ * `{"event":"ping"}`.
+ */
+function parseText(text) {
+    try {
+        return frameFrom(JSON.parse(text));
+    }
+    catch {
+        return { event: text };
+    }
+}
+/**
+ * Reads a frame from what the socket delivered. Text frames
+ * arrive as text, binary frames as bytes, and a socket may hand
+ * over an already parsed frame when one is replayed.
+ */
+function parseFrame(raw) {
+    if (typeof raw === 'string') {
+        return parseText(raw);
+    }
+    if (raw instanceof Uint8Array) {
+        return parseText(new TextDecoder().decode(raw));
+    }
+    return frameFrom(raw);
+}
+/** Repeats the correlation the client asked for, when it did. */
+function withCorrelation(answer, frame) {
+    if (frame.id === undefined) {
+        return answer;
+    }
+    return {
+        data: answer.data,
+        event: answer.event,
+        id: frame.id,
+    };
+}
+/**
+ * The frame that answers one, or nothing when the handler
+ * answered with nothing and the client asked for no
+ * acknowledgement.
+ *
+ * A handler that answered with its own `{ event, data }` keeps
+ * that shape, which is what the `ws` platform sends; anything
+ * else is wrapped in the event being answered.
+ */
+function toReply(frame, value) {
+    if (value === undefined || value === null) {
+        if (frame.id === undefined) {
+            return undefined;
+        }
+        return { event: frame.event, id: frame.id };
+    }
+    if (isFrame(value)) {
+        return withCorrelation(value, frame);
+    }
+    const answer = { data: value, event: frame.event };
+    return withCorrelation(answer, frame);
+}
+/** Says whether an answer is worth sending. */
+function isReply(value) {
+    return value !== undefined;
+}
+/**
+ * One client connection, in the shape Nest's WebSocket layer
+ * reads: a `message` event for every frame the client sends, a
+ * `close` event once, and `send()` for the answers. Nest
+ * subscribes with `on` and `once`, so this follows the Node
+ * emitter its own adapters use rather than an `EventTarget`.
+ */
+class HonoSocket extends EventEmitter {
+    /** Binds this client to the socket the upgrade produced. */
+    use(socket) {
+        this.socket = socket;
+    }
+    /** Emits the frame the client sent. */
+    deliver(data) {
+        this.emit(MESSAGE_EVENT, data);
+    }
+    /** Says the socket is gone, and only ever once. */
+    disconnect() {
+        this.socket = undefined;
+        this.emit(CLOSE_EVENT);
+    }
+    /** Sends one answer, unless the socket is no longer open. */
+    sendJson(reply) {
+        const { socket } = this;
+        if (socket === undefined) {
+            return;
+        }
+        if (socket.readyState !== OPEN_STATE) {
+            return;
+        }
+        socket.send(JSON.stringify(reply));
+    }
+    /** Closes the socket from this side. */
+    close() {
+        const { socket } = this;
+        if (socket === undefined) {
+            return;
+        }
+        socket.close();
+    }
+}
+export { CLOSE_EVENT, MESSAGE_EVENT, HonoSocket, isReply, parseFrame, toReply, };
+//# sourceMappingURL=ws-client.js.map

package/dist/ws-client.js.map

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

package/dist/ws-server.d.ts

@@ -0,0 +1,23 @@
+import { EventEmitter } from 'node:events';
+import type { HonoSocket } from './ws-client.ts';
+/** The event Nest listens on for every new socket. */
+declare const CONNECTION_EVENT = "connection";
+/**
+ * The sockets of one gateway path.
+ *
+ * Nest binds a connection handler to the server `create()`
+ * returns and then, per socket, its message handlers and its
+ * disconnect hook. This is the emitter those bindings need: it
+ * emits `connection` with each socket and holds that socket
+ * until the path is closed, so no listener outlives the
+ * connection it was bound to.
+ */
+declare class GatewayServer extends EventEmitter {
+    private readonly sockets;
+    /** Tracks a socket and hands it to Nest. */
+    accept(socket: HonoSocket): void;
+    /** Closes every socket on the path. */
+    close(): void;
+}
+export { CONNECTION_EVENT, GatewayServer };
+//# sourceMappingURL=ws-server.d.ts.map

package/dist/ws-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.d.ts","sourceRoot":"","sources":["../src/ws-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,sDAAsD;AACtD,QAAA,MAAM,gBAAgB,eAAe,CAAC;AAEtC;;;;;;;;;GASG;AACH,cAAM,aAAc,SAAQ,YAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,4CAA4C;IACrC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAMtC;IAED,uCAAuC;IAChC,KAAK,IAAI,IAAI,CAKnB;CACF;AAED,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/ws-server.js

@@ -0,0 +1,37 @@
+import { EventEmitter } from 'node:events';
+import { CLOSE_EVENT } from './ws-client.js';
+/** The event Nest listens on for every new socket. */
+const CONNECTION_EVENT = 'connection';
+/**
+ * The sockets of one gateway path.
+ *
+ * Nest binds a connection handler to the server `create()`
+ * returns and then, per socket, its message handlers and its
+ * disconnect hook. This is the emitter those bindings need: it
+ * emits `connection` with each socket and holds that socket
+ * until the path is closed, so no listener outlives the
+ * connection it was bound to.
+ */
+class GatewayServer extends EventEmitter {
+    constructor() {
+        super(...arguments);
+        this.sockets = new Set();
+    }
+    /** Tracks a socket and hands it to Nest. */
+    accept(socket) {
+        this.sockets.add(socket);
+        socket.once(CLOSE_EVENT, () => {
+            this.sockets.delete(socket);
+        });
+        this.emit(CONNECTION_EVENT, socket);
+    }
+    /** Closes every socket on the path. */
+    close() {
+        for (const socket of this.sockets) {
+            socket.close();
+        }
+        this.sockets.clear();
+    }
+}
+export { CONNECTION_EVENT, GatewayServer };
+//# sourceMappingURL=ws-server.js.map

package/dist/ws-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.js","sourceRoot":"","sources":["../src/ws-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,sDAAsD;AACtD,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,aAAc,SAAQ,YAAY;IAAxC;;QACmB,YAAO,GAAG,IAAI,GAAG,EAAc,CAAC;IAkBnD,CAAC;IAhBC,4CAA4C;IACrC,MAAM,CAAC,MAAkB;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,uCAAuC;IAChC,KAAK;QACV,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/dist/ws.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The WebSocket entry point, kept out of the root module so a
+ * deployment that only serves HTTP never resolves
+ * `@nestjs/websockets` or `@hono/node-ws`: both are optional
+ * peers, and neither is needed to run the HTTP adapter.
+ *
+ * It is published as the `@ailura/nestjs-hono-adapter/ws`
+ * subpath rather than re-exported from `index.ts`, because an
+ * ESM re-export resolves eagerly and would load them anyway.
+ */
+export { HonoWsAdapter } from './ws-adapter.ts';
+export type { HonoGatewayOptions } from './ws-adapter.ts';
+export type { HonoSocket } from './ws-client.ts';
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ws.js

@@ -0,0 +1,12 @@
+/**
+ * The WebSocket entry point, kept out of the root module so a
+ * deployment that only serves HTTP never resolves
+ * `@nestjs/websockets` or `@hono/node-ws`: both are optional
+ * peers, and neither is needed to run the HTTP adapter.
+ *
+ * It is published as the `@ailura/nestjs-hono-adapter/ws`
+ * subpath rather than re-exported from `index.ts`, because an
+ * ESM re-export resolves eagerly and would load them anyway.
+ */
+export { HonoWsAdapter } from './ws-adapter.js';
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@ailura/nestjs-hono-adapter",
+  "version": "1.0.0",
+  "description": "NestJS HTTP adapter that runs an application on Hono.",
+  "keywords": [
+    "adapter",
+    "hono",
+    "http",
+    "nestjs",
+    "node"
+  ],
+  "homepage": "https://github.com/ailuracollective/nestjs-hono-adapter#readme",
+  "bugs": {
+    "url": "https://github.com/ailuracollective/nestjs-hono-adapter/issues"
+  },
+  "license": "MIT",
+  "author": "Ailura Code",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ailuracollective/nestjs-hono-adapter.git"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ws": {
+      "types": "./dist/ws.d.ts",
+      "default": "./dist/ws.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "bun run lint && bun run format:check && bun run typecheck && bun run test && bun run build",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "prepack": "rm -rf dist *.tsbuildinfo && tsc -p tsconfig.json",
+    "prepare": "tsc -p tsconfig.json",
+    "release": "semantic-release",
+    "release:dry": "semantic-release --dry-run",
+    "test": "bun test",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json"
+  },
+  "devDependencies": {
+    "@hono/node-server": "^2.1.1",
+    "@hono/node-ws": "^1.3.1",
+    "@nestjs/common": "^12.0.3",
+    "@nestjs/core": "^12.0.3",
+    "@nestjs/microservices": "^12.0.3",
+    "@nestjs/websockets": "^12.0.3",
+    "@semantic-release/changelog": "^7",
+    "@semantic-release/git": "^11",
+    "@types/bun": "^1.4.2",
+    "@types/node": "^22.20.3",
+    "@types/ws": "^8.18.1",
+    "conventional-changelog-conventionalcommits": "^10",
+    "hono": "^4.13.8",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
+    "oxlint-tsgolint": "^7.0.2002",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "semantic-release": "^25",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "@hono/node-server": "^2.1.1",
+    "@hono/node-ws": "^1.3.1",
+    "@nestjs/common": ">=11 <13",
+    "@nestjs/core": ">=11 <13",
+    "@nestjs/websockets": ">=11 <13",
+    "hono": "^4.13.8"
+  },
+  "peerDependenciesMeta": {
+    "@hono/node-ws": {
+      "optional": true
+    },
+    "@nestjs/websockets": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}