@webda/core 4.0.0-beta.6 → 4.0.0-beta.8

package/lib/contexts/httpcontext.js

@@ -1,9 +1,29 @@
 import { parse as cookieParse } from "cookie";
 import { Readable } from "stream";
+import { HttpError, UnsupportedMediaType } from "../errors/errors.js";
 /**
  * All methods supported by Webda
  */
 export const HttpMethodTypeAny = ["GET", "OPTIONS", "POST", "PUT", "PATCH", "DELETE"];
+/**
+ * Extract the charset parameter from a Content-Type header value
+ *
+ * The parameter name is matched case-insensitively, surrounding quotes and whitespace are removed
+ *
+ * @param contentType the Content-Type header value
+ * @returns the charset label or undefined if none is present
+ */
+export function getCharset(contentType) {
+    const match = contentType?.match(/;\s*charset\s*=\s*("[^"]*"|[^;]*)/i);
+    if (!match) {
+        return undefined;
+    }
+    const charset = match[1]
+        .trim()
+        .replace(/^"(.*)"$/, "$1")
+        .trim();
+    return charset || undefined;
+}
 /**
  * The HttpContext
  *
@@ -216,26 +236,28 @@ export class HttpContext {
     /**
      * Get the raw body as string
      *
+     * Any WHATWG Encoding Standard label is accepted (utf-8, iso-8859-1, shift_jis, gbk, utf-16le, ...)
+     * A leading BOM is stripped
+     *
      * @param limit the size of readable request
      * @param timeout the time to read the request
-     * @param encoding to analyze
+     * @param encoding to decode with, default to the Content-Type charset or utf-8
      * @returns the result
+     * @throws UnsupportedMediaType if the encoding is not supported
      */
     async getRawBodyAsString(limit = 1024 * 1024 * 10, timeout = 60000, encoding) {
-        // Get charset from header
-        if (!encoding) {
-            const match = this.getUniqueHeader("content-type", "charset=utf-8").match(/charset=([^;\s]+)/);
-            if (match) {
-                encoding = match[1].trim();
-            }
-            else {
-                encoding = "utf-8";
-            }
+        const label = encoding ?? getCharset(this.getUniqueHeader("content-type")) ?? "utf-8";
+        let decoder;
+        try {
+            decoder = new TextDecoder(label);
         }
-        if (encoding !== "utf-8") {
-            throw new Error("Only UTF-8 is currently managed: https://github.com/loopingz/webda.io/issues/221");
+        catch (err) {
+            if (err instanceof RangeError) {
+                throw new UnsupportedMediaType(`Unsupported charset '${label}'`);
+            }
+            throw err;
         }
-        return ((await this.getRawBody(limit, timeout)) || Buffer.from("")).toString(encoding);
+        return decoder.decode((await this.getRawBody(limit, timeout)) ?? Buffer.alloc(0));
     }
     /**
      * Get request body
@@ -243,26 +265,46 @@ export class HttpContext {
      * @param limit the size of readable request
      * @param timeout the time to read the request
      * @returns the result
+     * @throws HttpError 413 if the body is bigger than limit, 408 if it is not read within timeout
      */
     async getRawBody(limit = 1024 * 1024 * 10, timeout = 60000) {
         if (this.body instanceof Readable) {
             return new Promise((resolve, reject) => {
                 const req = this.body;
                 const body = [];
+                let total = 0;
+                let done = false;
+                const fail = (err) => {
+                    done = true;
+                    clearTimeout(timeoutId);
+                    req.removeAllListeners("readable");
+                    req.destroy();
+                    reject(err);
+                };
                 const timeoutId = setTimeout(() => {
-                    reject("Request timeout");
+                    fail(new HttpError("Request timeout", 408));
                 }, timeout);
                 req.on("readable", () => {
-                    const chunk = req.read();
-                    if (chunk !== null) {
-                        if (chunk.length + body.length > limit) {
-                            clearTimeout(timeoutId);
-                            reject("Request oversized");
+                    let chunk;
+                    while (!done && (chunk = req.read()) !== null) {
+                        if (total + chunk.length > limit) {
+                            fail(new HttpError("Request oversized", 413));
+                            return;
                         }
+                        total += chunk.length;
                         body.push(chunk);
                     }
                 });
+                req.on("error", err => {
+                    if (!done) {
+                        fail(err);
+                    }
+                });
                 req.on("end", () => {
+                    if (done) {
+                        return;
+                    }
+                    done = true;
                     clearTimeout(timeoutId);
                     // Cache body as stream won't be able to be read twice
                     this.body = Buffer.concat(body);

package/lib/contexts/httpcontext.js.map

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

package/lib/contexts/operationcontext.d.ts

@@ -159,6 +159,12 @@ export declare class OperationContext<Input = any, Parameters = any, Output = an
      * @returns true if the condition is met
      */
     write(output: Output, _encoding?: string, _cb?: (error: Error) => void): boolean;
+    /**
+     * Resolves when the client can take more streamed output. callOperation awaits it whenever write() returned
+     * false; transports with a real connection override it (backpressure, cancellation).
+     * @returns when more output can be written
+     */
+    drained(): Promise<void>;
     /**
      * Initialize the operation context
      * @returns this for chaining

package/lib/contexts/operationcontext.d.ts.map

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

package/lib/contexts/operationcontext.js

@@ -39,6 +39,7 @@ import { NotEnumerable } from "@webda/tsc-esm";
 import sanitize from "sanitize-html";
 import { JSONUtils } from "@webda/utils";
 import { useLog } from "../loggers/hooks.js";
+import { HttpError } from "../errors/errors.js";
 import { runAsSystem } from "./execution.js";
 import { useUserResolver } from "../core/hooks.js";
 /**
@@ -200,10 +201,11 @@ let OperationContext = (() => {
                 }
                 return obj;
             };
+            let data;
             try {
                 // TODO define this
                 const { requestLimit, requestTimeout } = { requestLimit: 10 * 1024 * 1024, requestTimeout: 60000 };
-                const data = await this.getRawInputAsString(requestLimit, requestTimeout);
+                data = await this.getRawInputAsString(requestLimit, requestTimeout);
                 if (sanitizedOptions.raw === true) {
                     return JSON.parse(data || sanitizedOptions.defaultValue);
                 }
@@ -214,7 +216,11 @@ let OperationContext = (() => {
                 this._sanitized = recursiveSanitize(JSON.parse(data), sanitizedOptions);
             }
             catch (err) {
-                useLog("ERROR", err, `Body: '${await this.getRawInputAsString()}'`);
+                // Unsupported charset, oversized or timed out body are client errors to report
+                if (err instanceof HttpError) {
+                    throw err;
+                }
+                useLog("ERROR", err, `Body: '${data}'`);
                 this._sanitized = sanitizedOptions.defaultValue;
             }
             return this._sanitized;
@@ -318,6 +324,14 @@ let OperationContext = (() => {
             }
             return true;
         }
+        /**
+         * Resolves when the client can take more streamed output. callOperation awaits it whenever write() returned
+         * false; transports with a real connection override it (backpressure, cancellation).
+         * @returns when more output can be written
+         */
+        async drained() {
+            // In-memory output never fills up
+        }
         /**
          * Initialize the operation context
          * @returns this for chaining

package/lib/contexts/operationcontext.js.map

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

package/lib/contexts/restcontext.d.ts

@@ -0,0 +1,110 @@
+import type { OutgoingHttpHeaders, ServerResponse } from "node:http";
+import { HttpContext } from "./httpcontext.js";
+import { StreamingOperationContext } from "./streamingcontext.js";
+import type { Session } from "../session/session.js";
+/** How the chunks of a streamed response are framed */
+export type RestStreamFormat = "ndjson" | "sse";
+/**
+ * @param response - an HTTP/1.1 or HTTP/2 (compatibility API) response
+ * @returns whether it is over or its connection gone
+ */
+export declare function isResponseGone(response: ServerResponse): boolean;
+/**
+ * The context of a server-streaming operation served over a plain HTTP request: each streamed chunk is written to the
+ * response as soon as the operation yields it, as one JSON line (`ndjson`) or one server-sent event (`sse`).
+ *
+ * The status line and headers leave with the first chunk (or the first keep-alive): until then an error is still a
+ * normal HTTP error response. The context never ends the response by itself, see {@link RestStreamingOperationContext.finish}.
+ */
+export declare class RestStreamingOperationContext extends StreamingOperationContext {
+    private readonly response;
+    private readonly format;
+    private readonly keepAliveInterval;
+    private readonly baseHeaders;
+    private readonly cookies;
+    private started;
+    private finished;
+    private timer?;
+    private beginning?;
+    private queued;
+    private needDrain;
+    private aborted;
+    /**
+     * @param httpContext - the request
+     * @param response - the HTTP response to stream to
+     * @param format - how to frame the chunks
+     * @param session - the session already loaded for the request, if any
+     * @param keepAliveInterval - milliseconds between two SSE keep-alive comments (0 disables them)
+     * @param baseHeaders - headers already set for the response (CORS...), sent with the first chunk
+     * @param cookies - Set-Cookie values already set for the response
+     */
+    constructor(httpContext: HttpContext, response: ServerResponse, format: RestStreamFormat, session?: Session, keepAliveInterval?: number, baseHeaders?: OutgoingHttpHeaders, cookies?: string[]);
+    /**
+     * The session of an authorized request is reused, not loaded twice
+     * @override
+     */
+    init(): Promise<this>;
+    /**
+     * @returns whether the status line and headers were sent
+     */
+    get hasStarted(): boolean;
+    /**
+     * The response is over or its connection destroyed (an HTTP/2 response has no `destroyed`: its stream tells)
+     * @override
+     */
+    protected get connectionEnded(): boolean;
+    /**
+     * @returns whether the client is gone or the response is over
+     */
+    get disconnected(): boolean;
+    /**
+     * Send the status line and headers, once
+     */
+    private start;
+    /**
+     * The operation failed before the response head was sent: it will never be written, so the caller can answer with a
+     * normal HTTP error
+     */
+    abortBeforeStart(): void;
+    /**
+     * Save the session (its cookie leaves with the headers, so changes made until now are kept), send the headers, then
+     * what was written meanwhile. Once.
+     * @returns a promise resolved when the response head is out
+     */
+    begin(): Promise<void>;
+    /**
+     * Send an SSE keep-alive comment every interval while the response is open and the operation is streaming. When the
+     * operation has not yielded anything yet the first one commits the response as a stream (an error after it is an
+     * error event). An operation that is not (yet) streaming, like a plain method awaiting its result, gets none.
+     */
+    startKeepAlive(): void;
+    /**
+     * Stop sending keep-alive comments
+     */
+    stopKeepAlive(): void;
+    /**
+     * One JSON line or server-sent event per chunk, without its `__` keys. The first one waits for the response head
+     * (the session is saved first): the operation is asked to wait for `drained()`.
+     * @override
+     */
+    protected sendChunk(chunk: any): boolean;
+    /**
+     * Wait for the response head, then for the response buffer to empty, or the response to close or fail
+     * @override
+     */
+    protected waitForDrain(signal: AbortSignal): Promise<void>;
+    /**
+     * Tell the client the stream failed: the last event or line of the response
+     * @param message - what the client may know
+     * @param code - the HTTP status the error maps to
+     * @returns a promise resolved once it is written
+     */
+    writeError(message: string, code: number): Promise<void>;
+    /**
+     * End the response (a normal end is announced to SSE clients with an `end` event)
+     * @param normal - whether the stream ended without error
+     * @returns a promise resolved once the response is ended
+     */
+    finish(normal?: boolean): Promise<void>;
+}
+//# sourceMappingURL=restcontext.d.ts.map

package/lib/contexts/restcontext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restcontext.d.ts","sourceRoot":"","sources":["../../src/contexts/restcontext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,KAAK,CAAC;AAWhD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEhE;AAED;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,yBAAyB;IAoBxE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAxB1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;;;OAQG;IACH,YACE,WAAW,EAAE,WAAW,EACP,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,gBAAgB,EACzC,OAAO,CAAC,EAAE,OAAO,EACA,iBAAiB,GAAE,MAAc,EACjC,WAAW,GAAE,mBAAwB,EACrC,OAAO,GAAE,MAAM,EAAO,EASxC;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;OAGG;IACH,SAAS,KAAK,eAAe,IAAI,OAAO,CAEvC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,OAAO,CAAC,KAAK;IAoBb;;;OAGG;IACH,gBAAgB,IAAI,IAAI,CAEvB;IAED;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAYrB;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAarB;IAED;;OAEG;IACH,aAAa,IAAI,IAAI,CAGpB;IAED;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAWvC;IAED;;;OAGG;IACH,UAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/D;IAED;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7D;IAED;;;;OAIG;IACG,MAAM,CAAC,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAanD;CACF"}

package/lib/contexts/restcontext.js

@@ -0,0 +1,247 @@
+import { once } from "node:events";
+import { JSONUtils } from "@webda/utils";
+import { StreamingOperationContext } from "./streamingcontext.js";
+/** Headers that only exist in HTTP/1.1: refused by HTTP/2 */
+const HTTP1_ONLY_HEADERS = ["connection", "keep-alive", "transfer-encoding", "upgrade"];
+/** Content type of each format */
+const CONTENT_TYPES = {
+    ndjson: "application/x-ndjson",
+    sse: "text/event-stream; charset=utf-8"
+};
+/**
+ * @param response - an HTTP/1.1 or HTTP/2 (compatibility API) response
+ * @returns whether it is over or its connection gone
+ */
+export function isResponseGone(response) {
+    return response.writableEnded || response.destroyed || response.stream?.destroyed === true;
+}
+/**
+ * The context of a server-streaming operation served over a plain HTTP request: each streamed chunk is written to the
+ * response as soon as the operation yields it, as one JSON line (`ndjson`) or one server-sent event (`sse`).
+ *
+ * The status line and headers leave with the first chunk (or the first keep-alive): until then an error is still a
+ * normal HTTP error response. The context never ends the response by itself, see {@link RestStreamingOperationContext.finish}.
+ */
+export class RestStreamingOperationContext extends StreamingOperationContext {
+    response;
+    format;
+    keepAliveInterval;
+    baseHeaders;
+    cookies;
+    started = false;
+    finished = false;
+    timer;
+    beginning;
+    queued = [];
+    needDrain = false;
+    aborted = false;
+    /**
+     * @param httpContext - the request
+     * @param response - the HTTP response to stream to
+     * @param format - how to frame the chunks
+     * @param session - the session already loaded for the request, if any
+     * @param keepAliveInterval - milliseconds between two SSE keep-alive comments (0 disables them)
+     * @param baseHeaders - headers already set for the response (CORS...), sent with the first chunk
+     * @param cookies - Set-Cookie values already set for the response
+     */
+    constructor(httpContext, response, format, session, keepAliveInterval = 20000, baseHeaders = {}, cookies = []) {
+        super(httpContext, response);
+        this.response = response;
+        this.format = format;
+        this.keepAliveInterval = keepAliveInterval;
+        this.baseHeaders = baseHeaders;
+        this.cookies = cookies;
+        if (session)
+            this.session = session;
+        response.once("close", () => {
+            this.stopKeepAlive();
+            // The client left before the end of the stream
+            if (!this.finished)
+                this.cancel();
+        });
+    }
+    /**
+     * The session of an authorized request is reused, not loaded twice
+     * @override
+     */
+    async init() {
+        return this.session ? this : super.init();
+    }
+    /**
+     * @returns whether the status line and headers were sent
+     */
+    get hasStarted() {
+        return this.started;
+    }
+    /**
+     * The response is over or its connection destroyed (an HTTP/2 response has no `destroyed`: its stream tells)
+     * @override
+     */
+    get connectionEnded() {
+        return isResponseGone(this.response);
+    }
+    /**
+     * @returns whether the client is gone or the response is over
+     */
+    get disconnected() {
+        return this.connectionEnded;
+    }
+    /**
+     * Send the status line and headers, once
+     */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        const headers = {};
+        for (const [name, value] of Object.entries({ ...this.baseHeaders, ...this.getResponseHeaders() })) {
+            // Ours below, whatever the case of the name
+            if (["content-type", "cache-control", "content-length"].includes(name.toLowerCase()))
+                continue;
+            if (this.response.req?.httpVersionMajor >= 2 && HTTP1_ONLY_HEADERS.includes(name.toLowerCase()))
+                continue;
+            headers[name] = value;
+        }
+        headers["Content-Type"] = CONTENT_TYPES[this.format];
+        headers["Cache-Control"] = "no-cache";
+        // Reverse proxies must not buffer a stream
+        headers["X-Accel-Buffering"] = "no";
+        const cookies = [...this.cookies, ...this.getSetCookieHeaders()];
+        if (cookies.length)
+            headers["Set-Cookie"] = cookies;
+        this.setFlushedHeaders();
+        this.response.writeHead(200, headers);
+    }
+    /**
+     * The operation failed before the response head was sent: it will never be written, so the caller can answer with a
+     * normal HTTP error
+     */
+    abortBeforeStart() {
+        if (!this.started)
+            this.aborted = true;
+    }
+    /**
+     * Save the session (its cookie leaves with the headers, so changes made until now are kept), send the headers, then
+     * what was written meanwhile. Once.
+     * @returns a promise resolved when the response head is out
+     */
+    begin() {
+        this.beginning ??= (async () => {
+            this._sessionSaved = false;
+            await this.saveSession();
+            // Gone, over, or failed before anything was sent: the head is not ours to write anymore
+            if (this.finished || this.aborted || this.connectionEnded)
+                return;
+            this.start();
+            for (const text of this.queued.splice(0)) {
+                if (!this.response.write(text))
+                    this.needDrain = true;
+            }
+        })();
+        return this.beginning;
+    }
+    /**
+     * Send an SSE keep-alive comment every interval while the response is open and the operation is streaming. When the
+     * operation has not yielded anything yet the first one commits the response as a stream (an error after it is an
+     * error event). An operation that is not (yet) streaming, like a plain method awaiting its result, gets none.
+     */
+    startKeepAlive() {
+        if (this.format !== "sse" || this.keepAliveInterval <= 0 || this.timer)
+            return;
+        this.timer = setInterval(() => {
+            if (this.finished || this.connectionEnded)
+                return;
+            if (!this.started && !this.getExtension("operationStreaming"))
+                return;
+            this.begin().then(() => {
+                if (!this.finished && !this.connectionEnded)
+                    this.response.write(": keep-alive\n\n");
+            }, () => undefined);
+        }, this.keepAliveInterval);
+        this.timer.unref();
+    }
+    /**
+     * Stop sending keep-alive comments
+     */
+    stopKeepAlive() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    /**
+     * One JSON line or server-sent event per chunk, without its `__` keys. The first one waits for the response head
+     * (the session is saved first): the operation is asked to wait for `drained()`.
+     * @override
+     */
+    sendChunk(chunk) {
+        const json = JSONUtils.stringify(chunk, undefined, 0, true) ?? "null";
+        const text = this.format === "sse" ? `data: ${json}\n\n` : `${json}\n`;
+        if (this.started) {
+            const flushed = this.response.write(text);
+            if (!flushed)
+                this.needDrain = true;
+            return flushed;
+        }
+        this.queued.push(text);
+        this.begin().catch(() => undefined);
+        return false;
+    }
+    /**
+     * Wait for the response head, then for the response buffer to empty, or the response to close or fail
+     * @override
+     */
+    async waitForDrain(signal) {
+        await this.beginning;
+        // The client left while the head was being prepared: nothing will ever drain
+        this.assertAlive();
+        if (this.started && !this.needDrain)
+            return;
+        this.needDrain = false;
+        await Promise.race([
+            once(this.response, "drain", { signal }),
+            once(this.response, "close", { signal }),
+            once(this.response, "error", { signal }).then(([error]) => {
+                throw error;
+            })
+        ]);
+    }
+    /**
+     * Tell the client the stream failed: the last event or line of the response
+     * @param message - what the client may know
+     * @param code - the HTTP status the error maps to
+     * @returns a promise resolved once it is written
+     */
+    async writeError(message, code) {
+        if (this.finished || this.connectionEnded)
+            return;
+        await this.begin();
+        if (this.finished || this.connectionEnded)
+            return;
+        const payload = JSON.stringify({ message, code });
+        this.response.write(this.format === "sse" ? `event: error\ndata: ${payload}\n\n` : `{"error":${payload}}\n`);
+    }
+    /**
+     * End the response (a normal end is announced to SSE clients with an `end` event)
+     * @param normal - whether the stream ended without error
+     * @returns a promise resolved once the response is ended
+     */
+    async finish(normal = false) {
+        if (this.finished)
+            return;
+        this.stopKeepAlive();
+        if (this.connectionEnded) {
+            this.finished = true;
+            return;
+        }
+        await this.begin();
+        if (this.finished)
+            return;
+        this.finished = true;
+        if (this.connectionEnded)
+            return;
+        if (normal && this.format === "sse")
+            this.response.write("event: end\ndata: {}\n\n");
+        this.response.end();
+    }
+}
+//# sourceMappingURL=restcontext.js.map

package/lib/contexts/restcontext.js.map

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