@ailura/nestjs-hono-adapter 1.0.0

package/dist/server-adapter.d.ts

@@ -0,0 +1,106 @@
+import type { NestHandler, NestRequest } from './bridge.ts';
+import type { NestContext } from './context.ts';
+import type { CorsOptions } from './cors-middleware.ts';
+import type { NestExceptionHandler } from './handler-bridge.ts';
+import { HonoLifecycle } from './hono-lifecycle.ts';
+import type { TransportOptions } from './hono-lifecycle.ts';
+import type { StaticAssetsOptions } from './static-assets.ts';
+import type { ViewOptions } from './views.ts';
+/** The options the adapter itself reads. */
+interface ServerAdapterOptions extends TransportOptions {
+    /**
+     * The views a handler may render, when the application has
+     * any.
+     */
+    readonly views?: ViewOptions;
+}
+/** The options Nest hands the parser middleware. */
+interface BodyParserOptions {
+    readonly limit?: number | string;
+}
+/**
+ * HTTP adapter that runs Nest on Hono.
+ *
+ * There is no official Hono adapter for Nest, so this one lives
+ * in the repository. It implements the `AbstractHttpAdapter`
+ * contract rather than wrapping another framework: routes are
+ * registered on a Hono application, and Hono's Web `Request`
+ * and `Response` are translated to and from the objects Nest
+ * reads and writes. The application, the middleware chain and
+ * the server lifecycle are inherited from {@link HonoLifecycle};
+ * this class implements the rest of the Nest contract.
+ */
+declare class ServerAdapter extends HonoLifecycle {
+    private readonly writer;
+    private readonly views;
+    constructor(options?: ServerAdapterOptions);
+    status(response: NestContext, statusCode: number): void;
+    reply(response: NestContext, body: unknown, statusCode?: number): void;
+    end(response: NestContext, message?: string): void;
+    redirect(response: NestContext, statusCode: number, url: string): void;
+    setHeader(response: NestContext, name: string, value: string): void;
+    getHeader(response: NestContext, name: string): string | undefined;
+    appendHeader(response: NestContext, name: string, value: string): void;
+    isHeadersSent(response: NestContext): boolean;
+    /** Renders one view with the engine the deployment gave. */
+    render(response: NestContext, view: string, options: unknown): Promise<void>;
+    /** Names the engine, by the extension it renders. */
+    setViewEngine(engine: string): void;
+    /** Names the directories a view is read from. */
+    setBaseViewsDir(directory: string | readonly string[]): void;
+    /**
+     * Serves the files in a directory, under the prefix asked
+     * for.
+     */
+    useStaticAssets(path: string | readonly string[], options?: StaticAssetsOptions): void;
+    /**
+     * Turns on the CORS middleware for this service.
+     *
+     * It has to be configured before the first request is served,
+     * which is how Nest itself is used: the application is built,
+     * `enableCors` is called on it, and only then does it listen.
+     * Until it is called no origin is allowed.
+     */
+    enableCors(options?: CorsOptions): void;
+    getRequestMethod(request: NestRequest): string;
+    getRequestUrl(request: NestRequest): string;
+    getRequestHostname(request: NestRequest): string;
+    /**
+     * Records that Nest wants parsed bodies. The payload itself
+     * is read per route in the handler bridge, because Hono
+     * parses a body on demand rather than through middleware.
+     */
+    registerParserMiddleware(_prefix?: string, rawBody?: boolean): void;
+    /**
+     * `app.useBodyParser()` reaches the adapter here. Every
+     * parser reads the same payload, so the type is not branched
+     * on; the size limit is, because it is the option a
+     * deployment sets.
+     */
+    useBodyParser(_type?: string, rawBody?: boolean, options?: BodyParserOptions): void;
+    setNotFoundHandler(handler: NestHandler): void;
+    setErrorHandler(handler: NestExceptionHandler): void;
+    protected register(method: string, path: string, handler: NestHandler): void;
+    private get bridgeOptions();
+    private applyLimit;
+    /** A limit of nothing means the size is not checked. */
+    private effectiveBodyLimit;
+}
+declare module '@nestjs/common' {
+    /**
+     * The application methods this adapter implements. Nest
+     * declares them on its own platform interfaces, which an
+     * application on Hono does not otherwise have.
+     */
+    interface INestApplication<TServer> {
+        /** Serves the files in a directory, at the prefix asked for. */
+        useStaticAssets: (path: string | readonly string[], options?: StaticAssetsOptions) => this;
+        /** Names the directories a view is read from. */
+        setBaseViewsDir: (directory: string | readonly string[]) => this;
+        /** Names the view engine, by the extension it renders. */
+        setViewEngine: (engine: string) => this;
+    }
+}
+export { ServerAdapter };
+export type { ServerAdapterOptions };
+//# sourceMappingURL=server-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-adapter.d.ts","sourceRoot":"","sources":["../src/server-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,4CAA4C;AAC5C,UAAU,oBAAqB,SAAQ,gBAAgB;IACrD;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,oDAAoD;AACpD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,cAAM,aAAc,SAAQ,aAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,YAAmB,OAAO,GAAE,oBAAyB,EAGpD;IAEe,MAAM,CACpB,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,GACjB,IAAI,CAEN;IAEe,KAAK,CACnB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAEN;IAEe,GAAG,CACjB,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAEN;IAEe,QAAQ,CACtB,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,IAAI,CAEN;IAEe,SAAS,CACvB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,IAAI,CAEN;IAEe,SAAS,CACvB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAEpB;IAEe,YAAY,CAC1B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,IAAI,CAEN;IAEe,aAAa,CAC3B,QAAQ,EAAE,WAAW,GACpB,OAAO,CAET;IAED,4DAA4D;IAC5C,MAAM,CACpB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;IAED,qDAAqD;IACrC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAElD;IAED,iDAAiD;IAC1C,eAAe,CACpB,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GACpC,IAAI,CAEN;IAED;;;OAGG;IACa,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAEN;IAED;;;;;;;OAOG;IACa,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAEtD;IAEe,gBAAgB,CAC9B,OAAO,EAAE,WAAW,GACnB,MAAM,CAER;IAEe,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE1D;IAEe,kBAAkB,CAChC,OAAO,EAAE,WAAW,GACnB,MAAM,CAER;IAED;;;;OAIG;IACa,wBAAwB,CACtC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI,CAGN;IAED;;;;;OAKG;IACI,aAAa,CAClB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAIN;IAEe,kBAAkB,CAChC,OAAO,EAAE,WAAW,GACnB,IAAI,CAIN;IAEe,eAAe,CAC7B,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAMN;IAED,UAAmB,QAAQ,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,IAAI,CAWN;IAED,OAAO,KAAK,aAAa,GAQxB;IAED,OAAO,CAAC,UAAU;IAUlB,wDAAwD;IACxD,OAAO,CAAC,kBAAkB;CAM3B;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,UAAU,gBAAgB,CAAC,OAAO;QAChC,gEAAgE;QAChE,eAAe,EAAE,CACf,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,KAC1B,IAAI,CAAC;QACV,iDAAiD;QACjD,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,KAClC,IAAI,CAAC;QACV,0DAA0D;QAC1D,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;KACzC;CACF;AAED,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/server-adapter.js

@@ -0,0 +1,153 @@
+import { toByteLimit } from './body.js';
+import { createExceptionRunner, createRouteHandler, runNestHandler, } from './handler-bridge.js';
+import { HonoLifecycle } from './hono-lifecycle.js';
+import { toHonoPath } from './path.js';
+import { ResponseWriter } from './response-writer.js';
+import { ALL_METHOD } from './route-adapter.js';
+import { mountStaticAssets } from './static-assets.js';
+import { ViewRenderer } from './views.js';
+/**
+ * HTTP adapter that runs Nest on Hono.
+ *
+ * There is no official Hono adapter for Nest, so this one lives
+ * in the repository. It implements the `AbstractHttpAdapter`
+ * contract rather than wrapping another framework: routes are
+ * registered on a Hono application, and Hono's Web `Request`
+ * and `Response` are translated to and from the objects Nest
+ * reads and writes. The application, the middleware chain and
+ * the server lifecycle are inherited from {@link HonoLifecycle};
+ * this class implements the rest of the Nest contract.
+ */
+class ServerAdapter extends HonoLifecycle {
+    constructor(options = {}) {
+        super(options);
+        this.writer = new ResponseWriter();
+        this.views = new ViewRenderer(options.views);
+    }
+    status(response, statusCode) {
+        this.writer.status(response, statusCode);
+    }
+    reply(response, body, statusCode) {
+        this.writer.reply(response, body, statusCode);
+    }
+    end(response, message) {
+        this.writer.end(response, message);
+    }
+    redirect(response, statusCode, url) {
+        this.writer.redirect(response, statusCode, url);
+    }
+    setHeader(response, name, value) {
+        this.writer.setHeader(response, name, value);
+    }
+    getHeader(response, name) {
+        return this.writer.getHeader(response, name);
+    }
+    appendHeader(response, name, value) {
+        this.writer.appendHeader(response, name, value);
+    }
+    isHeadersSent(response) {
+        return this.writer.isHeadersSent(response);
+    }
+    /** Renders one view with the engine the deployment gave. */
+    render(response, view, options) {
+        return this.views.render(response, view, options);
+    }
+    /** Names the engine, by the extension it renders. */
+    setViewEngine(engine) {
+        this.views.useEngine(engine);
+    }
+    /** Names the directories a view is read from. */
+    setBaseViewsDir(directory) {
+        this.views.useDirectories(directory);
+    }
+    /**
+     * Serves the files in a directory, under the prefix asked
+     * for.
+     */
+    useStaticAssets(path, options) {
+        mountStaticAssets(this.hono, path, options ?? {});
+    }
+    /**
+     * Turns on the CORS middleware for this service.
+     *
+     * It has to be configured before the first request is served,
+     * which is how Nest itself is used: the application is built,
+     * `enableCors` is called on it, and only then does it listen.
+     * Until it is called no origin is allowed.
+     */
+    enableCors(options) {
+        this.corsOptions = options ?? {};
+    }
+    getRequestMethod(request) {
+        return request.method;
+    }
+    getRequestUrl(request) {
+        return request.originalUrl;
+    }
+    getRequestHostname(request) {
+        return request.hostname;
+    }
+    /**
+     * Records that Nest wants parsed bodies. The payload itself
+     * is read per route in the handler bridge, because Hono
+     * parses a body on demand rather than through middleware.
+     */
+    registerParserMiddleware(_prefix, rawBody) {
+        this.bodyParsingEnabled = true;
+        this.keepRawBody(rawBody);
+    }
+    /**
+     * `app.useBodyParser()` reaches the adapter here. Every
+     * parser reads the same payload, so the type is not branched
+     * on; the size limit is, because it is the option a
+     * deployment sets.
+     */
+    useBodyParser(_type, rawBody, options) {
+        this.bodyParsingEnabled = true;
+        this.keepRawBody(rawBody);
+        this.applyLimit(options);
+    }
+    setNotFoundHandler(handler) {
+        this.hono.notFound((context) => runNestHandler(handler, context, this.bridgeOptions));
+    }
+    setErrorHandler(handler) {
+        const run = createExceptionRunner(handler, this.bridgeOptions);
+        this.hono.onError((error, context) => run(error, context));
+    }
+    register(method, path, handler) {
+        const honoPath = toHonoPath(path);
+        const honoHandler = createRouteHandler(handler, this.bridgeOptions);
+        if (method === ALL_METHOD) {
+            this.hono.all(honoPath, honoHandler);
+            return;
+        }
+        this.hono.on(method, honoPath, honoHandler);
+    }
+    get bridgeOptions() {
+        return {
+            bodyLimit: () => this.effectiveBodyLimit(),
+            bodyParsingEnabled: () => this.bodyParsingEnabled,
+            pendingStatus: (context) => this.writer.statusOf(context),
+            rawBody: () => this.rawBodyEnabled,
+            trustProxy: () => this.trustProxy,
+        };
+    }
+    applyLimit(options) {
+        if (options === undefined) {
+            return;
+        }
+        if (options.limit === undefined) {
+            return;
+        }
+        this.bodyLimit = toByteLimit(options.limit);
+    }
+    /** A limit of nothing means the size is not checked. */
+    effectiveBodyLimit() {
+        if (this.bodyLimit === 0) {
+            return undefined;
+        }
+        return this.bodyLimit;
+    }
+}
+export { ServerAdapter };
+//# sourceMappingURL=server-adapter.js.map

package/dist/server-adapter.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,67 @@
+import { Writable } from 'node:stream';
+import type { NestContext } from './context.ts';
+/** The callback every Node stream write and finalizer takes. */
+type StreamCallback = (error?: Error | null) => void;
+/** What Nest calls once the stream's headers are chosen. */
+type CommitListener = (response: Response) => void;
+/**
+ * The Node writable Nest pipes an event stream into, and the
+ * web stream the Hono response reads its frames from.
+ *
+ * Nest answers `@Sse()` through `SseStream`, a `Transform` that
+ * is piped onto the response object. That object has to be a
+ * genuine `Writable`, so this one collects what Nest writes and
+ * hands the same bytes to a `ReadableStream`, which becomes the
+ * Hono response the client reads. The members Nest touches
+ * around the pipe — the status, the headers, the flushing and
+ * the end — are all here, so it needs nothing from Node's own
+ * `ServerResponse`. A client that walks away cancels the web
+ * stream, and the writes that follow are dropped rather than
+ * thrown at the process.
+ */
+declare class SseResponse extends Writable {
+    private readonly onCommit;
+    private readonly status;
+    private readonly stream;
+    private controller;
+    private committed;
+    private cancelled;
+    private headers;
+    private answerStatus;
+    constructor(status: () => number | undefined, onCommit: CommitListener);
+    /**
+     * The status Nest read from the adapter before the handler
+     * ran, so `@HttpCode()` and a POST default reach the stream.
+     */
+    get statusCode(): number | undefined;
+    /** Chooses the answer's status and headers, once. */
+    writeHead(status: number, headers?: Record<string, string>): this;
+    /**
+     * Nothing is buffered here, so there is nothing left to
+     * flush: Hono already has the response by the time Nest
+     * asks.
+     */
+    flushHeaders(): void;
+    setHeader(name: string, value: string): void;
+    /**
+     * Turns what Nest wrote into the Hono response, exactly once.
+     * The response is handed over before the start event is
+     * emitted, so whoever waits on the event reads a live body.
+     */
+    private commit;
+    private enqueue;
+    private finish;
+    private logFailure;
+    _write(chunk: unknown, _encoding: BufferEncoding, callback: StreamCallback): void;
+    _final(callback: StreamCallback): void;
+    _destroy(error: Error | null, callback: StreamCallback): void;
+}
+/**
+ * Opens an event stream on the response Nest reads, and says
+ * when it started. The stream is the destination `SseStream`
+ * pipes into, so nothing is buffered until Nest commits the
+ * headers, which is also the moment the promise settles.
+ */
+declare function mountSse(context: NestContext, status: () => number | undefined): Promise<unknown>;
+export { SseResponse, mountSse };
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,gEAAgE;AAChE,KAAK,cAAc,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;AAgCrD,4DAA4D;AAC5D,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,cAAM,WAAY,SAAQ,QAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,UAAU,CAEJ;IACd,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAA0B;IAE9C,YACE,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,cAAc,EAkBzB;IAED;;;OAGG;IACH,IAAW,UAAU,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,qDAAqD;IAC9C,SAAS,CACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,IAAI,CAKN;IAED;;;;OAIG;IACI,YAAY,IAAI,IAAI,CAE1B;IAEM,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAElD;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,UAAU;IAIF,MAAM,CACpB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,cAAc,GACvB,IAAI,CAWN;IAEe,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAGrD;IAEe,QAAQ,CACtB,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,QAAQ,EAAE,cAAc,GACvB,IAAI,CAGN;CACF;AA2DD;;;;;GAKG;AACH,iBAAS,QAAQ,CACf,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/sse.js

@@ -0,0 +1,211 @@
+import { once } from 'node:events';
+import { Writable } from 'node:stream';
+import { Logger } from '@nestjs/common';
+/** The status an event stream answers with when Nest names none. */
+const DEFAULT_STATUS = 200;
+/** The event a stream emits once its headers are on the wire. */
+const STARTED = 'started';
+/** The header that says a proxy must not buffer the stream. */
+const NO_BUFFERING = 'no';
+/** The headers a stream is opened with, whatever Nest added. */
+const STREAM_HEADERS = {
+    'cache-control': 'no-cache',
+    connection: 'keep-alive',
+    'content-type': 'text/event-stream',
+    'x-accel-buffering': NO_BUFFERING,
+};
+/** Says why a stream failed, without taking the process down. */
+const logger = new Logger('SseResponse');
+function toBytes(chunk) {
+    if (typeof chunk === 'string') {
+        return new TextEncoder().encode(chunk);
+    }
+    if (chunk instanceof Uint8Array) {
+        return chunk;
+    }
+    return undefined;
+}
+/**
+ * The Node writable Nest pipes an event stream into, and the
+ * web stream the Hono response reads its frames from.
+ *
+ * Nest answers `@Sse()` through `SseStream`, a `Transform` that
+ * is piped onto the response object. That object has to be a
+ * genuine `Writable`, so this one collects what Nest writes and
+ * hands the same bytes to a `ReadableStream`, which becomes the
+ * Hono response the client reads. The members Nest touches
+ * around the pipe — the status, the headers, the flushing and
+ * the end — are all here, so it needs nothing from Node's own
+ * `ServerResponse`. A client that walks away cancels the web
+ * stream, and the writes that follow are dropped rather than
+ * thrown at the process.
+ */
+class SseResponse extends Writable {
+    constructor(status, onCommit) {
+        super();
+        this.committed = false;
+        this.cancelled = false;
+        this.headers = {};
+        this.answerStatus = DEFAULT_STATUS;
+        this.status = status;
+        this.onCommit = onCommit;
+        this.stream = new ReadableStream({
+            cancel: () => {
+                this.cancelled = true;
+            },
+            start: (controller) => {
+                this.controller = controller;
+            },
+        });
+        // A client that walked away makes the next write fail; that
+        // is the client's business, not a reason to crash.
+        this.on('error', (error) => {
+            this.logFailure(error);
+        });
+    }
+    /**
+     * The status Nest read from the adapter before the handler
+     * ran, so `@HttpCode()` and a POST default reach the stream.
+     */
+    get statusCode() {
+        return this.status();
+    }
+    /** Chooses the answer's status and headers, once. */
+    writeHead(status, headers) {
+        this.answerStatus = status;
+        this.headers = headers ?? {};
+        this.commit();
+        return this;
+    }
+    /**
+     * Nothing is buffered here, so there is nothing left to
+     * flush: Hono already has the response by the time Nest
+     * asks.
+     */
+    flushHeaders() {
+        this.commit();
+    }
+    setHeader(name, value) {
+        this.headers[name] = value;
+    }
+    /**
+     * Turns what Nest wrote into the Hono response, exactly once.
+     * The response is handed over before the start event is
+     * emitted, so whoever waits on the event reads a live body.
+     */
+    commit() {
+        if (this.committed) {
+            return;
+        }
+        this.committed = true;
+        const headers = new Headers(STREAM_HEADERS);
+        for (const [name, value] of Object.entries(this.headers)) {
+            headers.set(name, value);
+        }
+        this.onCommit(new Response(this.stream, {
+            headers,
+            status: this.answerStatus,
+        }));
+        this.emit(STARTED);
+    }
+    enqueue(chunk) {
+        const { controller } = this;
+        if (this.cancelled || controller === undefined) {
+            return;
+        }
+        controller.enqueue(chunk);
+    }
+    finish() {
+        const { controller } = this;
+        if (this.cancelled || controller === undefined) {
+            return;
+        }
+        this.cancelled = true;
+        controller.close();
+    }
+    logFailure(error) {
+        logger.debug(error.message);
+    }
+    _write(chunk, _encoding, callback) {
+        this.commit();
+        const bytes = toBytes(chunk);
+        if (bytes === undefined) {
+            callback(new TypeError('An event stream carries bytes only.'));
+            return;
+        }
+        this.enqueue(bytes);
+        callback();
+    }
+    _final(callback) {
+        this.finish();
+        callback();
+    }
+    _destroy(error, callback) {
+        this.finish();
+        callback(error);
+    }
+}
+/** The headers Hono already recorded for the answer. */
+function recordedHeaders(context) {
+    const record = {};
+    for (const [name, value] of context.res.headers) {
+        if (name !== 'content-type') {
+            record[name] = value;
+        }
+    }
+    return record;
+}
+/**
+ * Gives the object Nest reads as its response the surface its
+ * SSE path touches, so the same object serves every supported
+ * Nest major.
+ *
+ * Nest 11 and 12 both prefer `res.raw` when it is set, and Nest
+ * 12 never reads the response's own members then. Pointing
+ * `raw` at this writable is what keeps the frames travelling
+ * through Hono: writing them straight into `c.env.outgoing`
+ * would bypass the `Response` this adapter returns, and the
+ * transport would then write that response into the same socket
+ * a second time. `req.raw` is the real incoming message, which
+ * is what tunes the socket and reports a disconnect.
+ */
+function installSurface(context, response) {
+    Object.defineProperties(context, {
+        raw: { configurable: true, value: response },
+        statusCode: {
+            configurable: true,
+            get: () => response.statusCode,
+        },
+        writableEnded: {
+            configurable: true,
+            get: () => response.writableEnded,
+        },
+    });
+    Object.assign(context, {
+        emit: response.emit.bind(response),
+        end: response.end.bind(response),
+        flushHeaders: response.flushHeaders.bind(response),
+        getHeaders: () => recordedHeaders(context),
+        on: response.on.bind(response),
+        once: response.once.bind(response),
+        removeListener: response.removeListener.bind(response),
+        setHeader: response.setHeader.bind(response),
+        write: response.write.bind(response),
+        writeHead: response.writeHead.bind(response),
+    });
+}
+/**
+ * Opens an event stream on the response Nest reads, and says
+ * when it started. The stream is the destination `SseStream`
+ * pipes into, so nothing is buffered until Nest commits the
+ * headers, which is also the moment the promise settles.
+ */
+function mountSse(context, status) {
+    const response = new SseResponse(status, (answer) => {
+        context.res = answer;
+    });
+    installSurface(context, response);
+    return once(response, STARTED);
+}
+export { SseResponse, mountSse };
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/dist/static-assets.d.ts

@@ -0,0 +1,39 @@
+import type { NestHono } from './context.ts';
+/**
+ * The options Nest accepts for static assets. They are declared
+ * here because Nest types the parameter as `any` on both the
+ * application and the adapter, so nothing can be taken from a
+ * signature.
+ *
+ * The options Hono's handler decides for itself are refused
+ * rather than ignored, so a deployment finds out at startup
+ * instead of from a response that quietly differs from the one
+ * that was asked for.
+ */
+interface StaticAssetsOptions {
+    readonly dotfiles?: string;
+    readonly etag?: boolean;
+    readonly extensions?: readonly string[];
+    readonly fallthrough?: boolean;
+    readonly immutable?: boolean;
+    readonly index?: string | false;
+    readonly maxAge?: number | string;
+    readonly prefix?: string;
+    readonly redirect?: boolean;
+    readonly setHeaders?: unknown;
+}
+/** The directories a call named, as a list. */
+declare function toDirectories(path: string | readonly string[]): readonly string[];
+/**
+ * Mounts the directories a deployment named, under the prefix
+ * it asked for.
+ *
+ * A request that names no file in them travels on, which is
+ * what Nest's own middleware does: the routes behind it answer,
+ * and an answer the deployment asked for is written before
+ * that.
+ */
+declare function mountStaticAssets(hono: NestHono, path: string | readonly string[], options: StaticAssetsOptions): void;
+export { mountStaticAssets, toDirectories };
+export type { StaticAssetsOptions };
+//# sourceMappingURL=static-assets.d.ts.map

package/dist/static-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-assets.d.ts","sourceRoot":"","sources":["../src/static-assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,QAAQ,EAET,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAwCD,+CAA+C;AAC/C,iBAAS,aAAa,CACpB,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC/B,SAAS,MAAM,EAAE,CAMnB;AA6ID;;;;;;;;GAQG;AACH,iBAAS,iBAAiB,CACxB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAChC,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CASN;AAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,CAAC"}