@decohere/http 0.0.1-dev.130 → 0.0.1-dev.20261105.103

package/commonjs/src/sse/sse.encoder.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "encodeSse", {
-    enumerable: true,
-    get: function() {
-        return encodeSse;
-    }
-});
-const _scribe = require("@decohere/scribe");
-const _ssewire = require("./sse.wire.js");
-const logger = _scribe.scribe.logger("SseEncoder");
-async function* encodeSse(source, options) {
-    const { signal, heartbeatMs } = options;
-    const iterator = source[Symbol.asyncIterator]();
-    let onAbort;
-    const abortStep = new Promise((resolve)=>{
-        onAbort = ()=>resolve({
-                kind: "abort"
-            });
-        if (signal.aborted) onAbort();
-        else signal.addEventListener("abort", onAbort, {
-            once: true
-        });
-    });
-    let pending;
-    try {
-        yield _ssewire.sseWire.formatComment("open");
-        while(!signal.aborted){
-            pending ??= iterator.next().then((result)=>({
-                    kind: "item",
-                    result
-                }));
-            let timer;
-            const steps = [
-                pending,
-                abortStep
-            ];
-            if (heartbeatMs > 0) {
-                steps.push(new Promise((resolve)=>{
-                    timer = setTimeout(()=>resolve({
-                            kind: "heartbeat"
-                        }), heartbeatMs);
-                }));
-            }
-            let step;
-            try {
-                step = await Promise.race(steps);
-            } finally{
-                clearTimeout(timer);
-            }
-            if (step.kind === "abort") return;
-            if (step.kind === "heartbeat") {
-                yield _ssewire.sseWire.formatComment("heartbeat");
-                continue;
-            }
-            pending = undefined;
-            if (step.result.done) return;
-            yield _ssewire.sseWire.formatMessage(step.result.value);
-        }
-    } catch (error) {
-        // Headers are already sent, so the only honest thing left is to log and end the stream.
-        if (!signal.aborted) logger.error("SSE producer failed", error);
-    } finally{
-        if (onAbort) signal.removeEventListener("abort", onAbort);
-        // If the producer has not answered its last `next()`, `return()` waits behind it. That is
-        // why handlers must pass the signal to whatever they wait on.
-        options.onProducerStopped(Promise.resolve().then(()=>iterator.return?.()).then(()=>undefined, (error)=>{
-            if (!signal.aborted) logger.error("SSE producer failed while stopping", error);
-        }));
-    }
-}

package/commonjs/src/sse/sse.types.js

@@ -1,36 +0,0 @@
-/**
- * One server-sent event. A bare `string` yielded by a handler is shorthand for `{ data }`.
- *
- * `data` is written as-is when it is a string and as JSON otherwise.
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get DEFAULT_SSE_HEARTBEAT_MS () {
-        return DEFAULT_SSE_HEARTBEAT_MS;
-    },
-    get SseResponse () {
-        return SseResponse;
-    }
-});
-const DEFAULT_SSE_HEARTBEAT_MS = 15_000;
-class SseResponse {
-    events;
-    onRelease;
-    released;
-    constructor(events, onRelease){
-        this.events = events;
-        this.onRelease = onRelease;
-    }
-    /** Safe to call more than once. */ release() {
-        this.released ??= this.onRelease();
-        return this.released;
-    }
-}

package/commonjs/src/sse/sse.wire.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "sseWire", {
-    enumerable: true,
-    get: function() {
-        return sseWire;
-    }
-});
-/** Line breaks would end a field early, so a client-controlled `id` could inject extra fields. */ function singleLine(value) {
-    return value.replace(/[\r\n]+/g, " ");
-}
-function toMessage(item) {
-    if (typeof item === "object" && item !== null && "data" in item) {
-        return item;
-    }
-    return {
-        data: item
-    };
-}
-/** Encode one event as the text a browser's `EventSource` parses. */ function formatMessage(item) {
-    const { data, event, id, retry } = toMessage(item);
-    let frame = "";
-    if (id != null) frame += `id: ${singleLine(String(id))}\n`;
-    if (event != null) frame += `event: ${singleLine(event)}\n`;
-    if (retry != null && Number.isFinite(retry)) frame += `retry: ${Math.trunc(retry)}\n`;
-    const text = typeof data === "string" ? data : JSON.stringify(data) ?? "";
-    for (const line of text.split(/\r\n|\r|\n/)){
-        frame += `data: ${line}\n`;
-    }
-    return `${frame}\n`;
-}
-/** A comment line: ignored by `EventSource`, but it is traffic on the wire. */ function formatComment(text) {
-    return `: ${singleLine(text)}\n\n`;
-}
-const sseWire = {
-    formatMessage,
-    formatComment
-};

package/commonjs/src/testing/boot-module.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "bootModule", {
-    enumerable: true,
-    get: function() {
-        return bootModule;
-    }
-});
-const _builder = require("../builder/builder.js");
-require("../http/http.extensions.js");
-const _fastifyprovider = require("../providers/fastify.provider.js");
-const _ssereader = require("./sse-reader.js");
-async function bootModule(options) {
-    let builder = _builder.Builder.create().withHttp(options.provider ?? _fastifyprovider.FastifyProvider).withControllers(...options.controllers);
-    if (options.services) builder = builder.withServices(options.services);
-    options.configure?.(builder);
-    const app = await builder.build();
-    await app.start({
-        port: 0,
-        host: "127.0.0.1",
-        shutdownSignals: false
-    });
-    const baseUrl = app.addresses[0];
-    if (baseUrl == null) {
-        await app.dispose();
-        throw new Error("app.start({ port: 0 }) advertised no IPv4 address");
-    }
-    const stop = ()=>app.dispose();
-    return {
-        app,
-        baseUrl,
-        readEvents: (path, readOptions)=>(0, _ssereader.readEventStream)(`${baseUrl}${path}`, readOptions),
-        stop,
-        [Symbol.asyncDispose]: stop
-    };
-}

package/commonjs/src/testing/index.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get bootModule () {
-        return _bootmodule.bootModule;
-    },
-    get readEventStream () {
-        return _ssereader.readEventStream;
-    }
-});
-const _bootmodule = require("./boot-module.js");
-const _ssereader = require("./sse-reader.js");

package/commonjs/src/testing/sse-reader.js

@@ -1,98 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "readEventStream", {
-    enumerable: true,
-    get: function() {
-        return readEventStream;
-    }
-});
-/** Incremental parser for the `text/event-stream` format. */ class SseParser {
-    buffer = "";
-    data = [];
-    current = {
-        data: ""
-    };
-    hasFields = false;
-    events = [];
-    comments = [];
-    push(chunk) {
-        this.buffer += chunk;
-        let newline;
-        while((newline = this.buffer.search(/\r\n|\r|\n/)) !== -1){
-            const line = this.buffer.slice(0, newline);
-            const eol = this.buffer.slice(newline).startsWith("\r\n") ? 2 : 1;
-            this.buffer = this.buffer.slice(newline + eol);
-            this.line(line);
-        }
-    }
-    line(line) {
-        if (line === "") {
-            if (this.hasFields) {
-                this.events.push({
-                    ...this.current,
-                    data: this.data.join("\n")
-                });
-            }
-            this.data = [];
-            this.current = {
-                data: ""
-            };
-            this.hasFields = false;
-            return;
-        }
-        if (line.startsWith(":")) {
-            this.comments.push(line.slice(1).trim());
-            return;
-        }
-        const colon = line.indexOf(":");
-        const field = colon === -1 ? line : line.slice(0, colon);
-        let value = colon === -1 ? "" : line.slice(colon + 1);
-        if (value.startsWith(" ")) value = value.slice(1);
-        this.hasFields = true;
-        if (field === "data") this.data.push(value);
-        else if (field === "event") this.current.event = value;
-        else if (field === "id") this.current.id = value;
-        else if (field === "retry") this.current.retry = Number(value);
-    }
-}
-async function readEventStream(url, options = {}) {
-    const count = options.count ?? 1;
-    const abort = new AbortController();
-    const timer = setTimeout(()=>abort.abort(new Error(`No ${count} events from ${url} in time`)), options.timeoutMs ?? 5000);
-    try {
-        const response = await fetch(url, {
-            headers: {
-                accept: "text/event-stream",
-                ...options.headers
-            },
-            signal: abort.signal
-        });
-        const parser = new SseParser();
-        let ended = false;
-        if (response.status === 200 && response.body != null) {
-            const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
-            while(parser.events.length < count){
-                const { done, value } = await reader.read();
-                if (done) {
-                    ended = true;
-                    break;
-                }
-                parser.push(value);
-            }
-            await reader.cancel();
-        } else {
-            await response.body?.cancel();
-        }
-        return {
-            status: response.status,
-            headers: response.headers,
-            events: parser.events.slice(0, count),
-            comments: parser.comments,
-            ended
-        };
-    } finally{
-        clearTimeout(timer);
-    }
-}