@procedures/http 0.0.0-stage → 0.3.0

package/dist/procedures/http/ndjson.js

@@ -0,0 +1,65 @@
+/**
+ * http.ndjson procedure
+ *
+ * Read an NDJSON response as a stream of parsed lines. The procedure sends a GET. Each line that
+ * is not blank is one item: its JSON value. The stream can run without an end, so the procedure
+ * declares an unbounded stream (roadmap R15). When the reader stops, the connection closes.
+ *
+ * The call waits for the status of the response. A refused host, a failed connection and a status
+ * outside 200 to 299 fail the call itself, before the first item.
+ */
+import { HttpError } from "../../errors.js";
+import { DEFAULT_ITEM_BYTES, DEFAULT_SETTINGS, excerpt, exchange, isOk, prepare, statusError, touching } from "../../exchange.js";
+import { ndjsonLines } from "../../parsers.js";
+import { CallScope } from "../../scope.js";
+const PATH = ["http", "ndjson"];
+/** The items of an open response. The end of the generator closes the connection. */
+async function* items(opened, scope, maxLineBytes) {
+    try {
+        scope.touch();
+        for await (const line of ndjsonLines(touching(opened.body, scope), maxLineBytes, "http.ndjson")) {
+            let value;
+            try {
+                value = JSON.parse(line.text);
+            }
+            catch {
+                throw new HttpError("BAD_JSON", `http.ndjson: line ${line.line} is not JSON: ${excerpt(line.text, 80)}`, opened.response.statusCode);
+            }
+            // The idle time does not run while the reader holds the item
+            scope.pause();
+            yield value;
+            scope.touch();
+        }
+    }
+    catch (error) {
+        throw scope.translate(error);
+    }
+    finally {
+        opened.body.destroy();
+        opened.close();
+        scope.dispose();
+    }
+}
+/**
+ * Read an NDJSON response as a stream of parsed lines
+ */
+export async function httpNdjson(input, ctx = {}, settings = DEFAULT_SETTINGS) {
+    const headers = { accept: "application/x-ndjson, application/jsonl;q=0.9, application/json;q=0.8" };
+    const prepared = prepare({ ...input, method: "GET" }, PATH, settings, { headers });
+    const scope = new CallScope(PATH, ctx, { timeoutMs: input.timeoutMs, idleTimeoutMs: input.idleTimeoutMs });
+    let opened;
+    try {
+        opened = await exchange(prepared, settings.policy, scope);
+        if (!isOk(opened.response.statusCode ?? 0))
+            throw await statusError(opened, scope);
+    }
+    catch (error) {
+        opened?.close();
+        scope.dispose();
+        throw scope.translate(error);
+    }
+    // The idle time starts again when the reader asks for the first item
+    scope.pause();
+    return items(opened, scope, input.maxLineBytes ?? DEFAULT_ITEM_BYTES);
+}
+//# sourceMappingURL=ndjson.js.map

package/dist/procedures/http/ndjson.js.map

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

package/dist/procedures/http/request.d.ts

@@ -0,0 +1,14 @@
+/**
+ * http.request procedure
+ *
+ * Send an HTTP request and give the status, the headers and the body. The procedure gives each
+ * status: a status of 400 or more is not an error. The body of the response has a size limit.
+ */
+import { type HttpSettings } from "../../exchange.js";
+import { type ScopeContext } from "../../scope.js";
+import type { HttpRequestInput, HttpRequestOutput } from "../../types.js";
+/**
+ * Send an HTTP request and give the status, the headers and the body
+ */
+export declare function httpRequest(input: HttpRequestInput, ctx?: ScopeContext, settings?: HttpSettings): Promise<HttpRequestOutput>;
+//# sourceMappingURL=request.d.ts.map

package/dist/procedures/http/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/procedures/http/request.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAA4F,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChJ,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA2B1E;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,GAAE,YAAiB,EAAE,QAAQ,GAAE,YAA+B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+BxJ"}

package/dist/procedures/http/request.js

@@ -0,0 +1,79 @@
+/**
+ * http.request procedure
+ *
+ * Send an HTTP request and give the status, the headers and the body. The procedure gives each
+ * status: a status of 400 or more is not an error. The body of the response has a size limit.
+ */
+import { HttpError } from "../../errors.js";
+import { DEFAULT_SETTINGS, DEFAULT_TIMEOUT_MS, exchange, isOk, prepare, readBody, responseHeaders } from "../../exchange.js";
+import { CallScope } from "../../scope.js";
+const PATH = ["http", "request"];
+/** The body of an input and its content type, or undefined. */
+function bodyOf(input) {
+    const given = [input.body, input.json, input.bodyBase64].filter((value) => value !== undefined).length;
+    if (given > 1)
+        throw new Error("http.request: give only one of body, json and bodyBase64");
+    if (input.body !== undefined)
+        return { body: Buffer.from(input.body, "utf8"), type: "text/plain; charset=utf-8" };
+    if (input.json !== undefined)
+        return { body: Buffer.from(JSON.stringify(input.json), "utf8"), type: "application/json" };
+    if (input.bodyBase64 !== undefined)
+        return { body: Buffer.from(input.bodyBase64, "base64"), type: "application/octet-stream" };
+    return undefined;
+}
+/** The body of the response in the form of `responseType`. */
+function decode(bytes, responseType, status) {
+    if (responseType === "bytes")
+        return bytes.toString("base64");
+    const text = bytes.toString("utf8");
+    if (responseType !== "json")
+        return text;
+    if (text.trim() === "")
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new HttpError("BAD_JSON", `http.request: the body of the response is not JSON: ${text.slice(0, 200)}`, status);
+    }
+}
+/**
+ * Send an HTTP request and give the status, the headers and the body
+ */
+export async function httpRequest(input, ctx = {}, settings = DEFAULT_SETTINGS) {
+    const method = input.method ?? "GET";
+    const body = bodyOf(input);
+    if (body !== undefined && (method === "GET" || method === "HEAD")) {
+        throw new Error(`http.request: a ${method} request has no body`);
+    }
+    const headers = {};
+    if (body !== undefined)
+        headers["content-type"] = body.type;
+    if (input.responseType === "json")
+        headers["accept"] = "application/json";
+    const prepared = prepare({ ...input, method }, PATH, settings, { headers, body: body?.body });
+    const scope = new CallScope(PATH, ctx, { timeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS });
+    try {
+        const opened = await exchange(prepared, settings.policy, scope);
+        const limit = Math.min(input.maxResponseBytes ?? settings.maxResponseBytes, settings.maxResponseBytes);
+        const bytes = await readBody(opened.body, limit, scope, opened.response);
+        const status = opened.response.statusCode ?? 0;
+        return {
+            status,
+            statusText: opened.response.statusMessage ?? "",
+            ok: isOk(status),
+            url: opened.url,
+            redirected: opened.redirects.length > 0,
+            headers: responseHeaders(opened.response.headers),
+            body: decode(bytes, input.responseType, status),
+            bytes: bytes.length,
+        };
+    }
+    catch (error) {
+        throw scope.translate(error);
+    }
+    finally {
+        scope.dispose();
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/procedures/http/request.js.map

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

package/dist/procedures/http/sse.d.ts

@@ -0,0 +1,19 @@
+/**
+ * http.sse procedure
+ *
+ * Read a stream of server-sent events. The procedure sends a GET with
+ * `accept: text/event-stream`, and each event is one item: its type, its data and the last event
+ * ID. The procedure does not connect again after the end of the stream. To continue, a caller
+ * sends the last ID in `lastEventId`. The stream can run without an end (roadmap R15).
+ *
+ * The call waits for the status of the response. A refused host, a failed connection, a status
+ * outside 200 to 299 and another content type fail the call itself, before the first item.
+ */
+import { type HttpSettings } from "../../exchange.js";
+import { type ScopeContext } from "../../scope.js";
+import type { HttpSseInput, HttpSseOutput } from "../../types.js";
+/**
+ * Read a stream of server-sent events
+ */
+export declare function httpSse(input: HttpSseInput, ctx?: ScopeContext, settings?: HttpSettings): Promise<AsyncGenerator<HttpSseOutput, void, undefined>>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/procedures/http/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/procedures/http/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAmH,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvK,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuBlE;;GAEG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,GAAE,YAAiB,EAAE,QAAQ,GAAE,YAA+B,GAAG,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAsB7K"}

package/dist/procedures/http/sse.js

@@ -0,0 +1,66 @@
+/**
+ * http.sse procedure
+ *
+ * Read a stream of server-sent events. The procedure sends a GET with
+ * `accept: text/event-stream`, and each event is one item: its type, its data and the last event
+ * ID. The procedure does not connect again after the end of the stream. To continue, a caller
+ * sends the last ID in `lastEventId`. The stream can run without an end (roadmap R15).
+ *
+ * The call waits for the status of the response. A refused host, a failed connection, a status
+ * outside 200 to 299 and another content type fail the call itself, before the first item.
+ */
+import { HttpError } from "../../errors.js";
+import { DEFAULT_ITEM_BYTES, DEFAULT_SETTINGS, exchange, headerText, isOk, prepare, statusError, touching } from "../../exchange.js";
+import { sseEvents } from "../../parsers.js";
+import { CallScope } from "../../scope.js";
+const PATH = ["http", "sse"];
+/** The events of an open response. The end of the generator closes the connection. */
+async function* events(opened, scope, maxEventBytes) {
+    try {
+        scope.touch();
+        for await (const event of sseEvents(touching(opened.body, scope), maxEventBytes, "http.sse")) {
+            // The idle time does not run while the reader holds the item
+            scope.pause();
+            yield event;
+            scope.touch();
+        }
+    }
+    catch (error) {
+        throw scope.translate(error);
+    }
+    finally {
+        opened.body.destroy();
+        opened.close();
+        scope.dispose();
+    }
+}
+/**
+ * Read a stream of server-sent events
+ */
+export async function httpSse(input, ctx = {}, settings = DEFAULT_SETTINGS) {
+    const headers = { accept: "text/event-stream", "cache-control": "no-cache" };
+    if (input.lastEventId !== undefined)
+        headers["last-event-id"] = input.lastEventId;
+    const prepared = prepare({ ...input, method: "GET" }, PATH, settings, { headers });
+    const scope = new CallScope(PATH, ctx, { timeoutMs: input.timeoutMs, idleTimeoutMs: input.idleTimeoutMs });
+    let opened;
+    try {
+        opened = await exchange(prepared, settings.policy, scope);
+        const status = opened.response.statusCode ?? 0;
+        if (!isOk(status))
+            throw await statusError(opened, scope);
+        const type = headerText(opened.response.headers["content-type"]) ?? "";
+        if (!type.toLowerCase().startsWith("text/event-stream")) {
+            throw new HttpError("BAD_CONTENT_TYPE", `http.sse: the content type of the response is ${JSON.stringify(type)}, not text/event-stream`, status);
+        }
+    }
+    catch (error) {
+        opened?.close();
+        scope.dispose();
+        throw scope.translate(error);
+    }
+    // The idle time starts again when the reader asks for the first event
+    scope.pause();
+    return events(opened, scope, input.maxEventBytes ?? DEFAULT_ITEM_BYTES);
+}
+//# sourceMappingURL=sse.js.map

package/dist/procedures/http/sse.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Importing this file registers the procedures of @procedures/http in the global registry:
+ * `import "@procedures/http/register"`. The package root registers nothing.
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @procedures/http in the global registry:
+ * `import "@procedures/http/register"`. The package root registers nothing.
+ */
+import { registerHttpProcedures } from "./module.js";
+export * from "./module.js";
+registerHttpProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,cAAc,aAAa,CAAC;AAE5B,sBAAsB,EAAE,CAAC"}

package/dist/scope.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The time limits and the stop of one call (roadmap R38).
+ *
+ * A call stops at the first of these events:
+ * - the signal of the call aborts (`ctx.signal`): the caller went away, or the server stops;
+ * - the deadline of the call passes (`ctx.capability.deadline`);
+ * - the time of the input passes (`timeoutMs`);
+ * - a stream gets no data for the idle time of the input (`idleTimeoutMs`).
+ *
+ * The earliest event wins. The stop aborts the request, and the call fails with `TIMEOUT` or
+ * `ABORTED`.
+ */
+import { InvocationError, type ProcedurePath } from "@procedures/client";
+/** The cause of a stop. */
+export type StopReason = "timeout" | "idle" | "deadline" | "aborted";
+/** The parts of the context of a handler that a scope reads. */
+export interface ScopeContext {
+    readonly signal?: AbortSignal | undefined;
+    readonly capability?: {
+        readonly deadline?: number | undefined;
+    } | undefined;
+}
+/** The time limits of a scope, in milliseconds. */
+export interface ScopeLimits {
+    /** The time of the whole call. */
+    readonly timeoutMs?: number | undefined;
+    /** The longest time without data. */
+    readonly idleTimeoutMs?: number | undefined;
+}
+/** The stop of one call: one abort signal for the request, and the error of the stop. */
+export declare class CallScope {
+    #private;
+    readonly path: ProcedurePath;
+    readonly limits: ScopeLimits;
+    constructor(path: ProcedurePath, context: ScopeContext, limits?: ScopeLimits);
+    /** The signal that aborts the request at the stop. */
+    get signal(): AbortSignal;
+    /** The cause of the stop, or undefined while the call runs. */
+    get reason(): StopReason | undefined;
+    /** This function stops the call. The first cause wins. */
+    stop(reason: StopReason): void;
+    /** This function starts the idle time again: data arrived. */
+    touch(): void;
+    /** This function holds the idle time while the reader of a stream has an item and reads no data. */
+    pause(): void;
+    /** The error of the stop. Before a stop, an `ABORTED` error. */
+    error(): InvocationError;
+    /** The error to throw for a failure: the error of the stop after a stop, or the failure. */
+    translate(error: unknown): unknown;
+    /** This function removes the timers and the listener. */
+    dispose(): void;
+}
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEzE,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAKrE,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;CAC9E;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,yFAAyF;AACzF,qBAAa,SAAS;;IASlB,QAAQ,CAAC,IAAI,EAAE,aAAa;IAE5B,QAAQ,CAAC,MAAM,EAAE,WAAW;IAH9B,YACW,IAAI,EAAE,aAAa,EAC5B,OAAO,EAAE,YAAY,EACZ,MAAM,GAAE,WAAgB,EAYlC;IAMD,sDAAsD;IACtD,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,+DAA+D;IAC/D,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,0DAA0D;IAC1D,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAK7B;IAED,8DAA8D;IAC9D,KAAK,IAAI,IAAI,CAKZ;IAED,oGAAoG;IACpG,KAAK,IAAI,IAAI,CAEZ;IAOD,gEAAgE;IAChE,KAAK,IAAI,eAAe,CAYvB;IAED,4FAA4F;IAC5F,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjC;IAED,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAKd;CACF"}

package/dist/scope.js

@@ -0,0 +1,107 @@
+/**
+ * The time limits and the stop of one call (roadmap R38).
+ *
+ * A call stops at the first of these events:
+ * - the signal of the call aborts (`ctx.signal`): the caller went away, or the server stops;
+ * - the deadline of the call passes (`ctx.capability.deadline`);
+ * - the time of the input passes (`timeoutMs`);
+ * - a stream gets no data for the idle time of the input (`idleTimeoutMs`).
+ *
+ * The earliest event wins. The stop aborts the request, and the call fails with `TIMEOUT` or
+ * `ABORTED`.
+ */
+import { InvocationError } from "@procedures/client";
+/** The longest delay of `setTimeout`. A later time gets no timer: the call cannot last so long. */
+const MAX_TIMER_MS = 2_147_483_647;
+/** The stop of one call: one abort signal for the request, and the error of the stop. */
+export class CallScope {
+    path;
+    limits;
+    #controller = new AbortController();
+    #timers = [];
+    #parent;
+    #onAbort = () => this.stop("aborted");
+    #idle;
+    #reason;
+    constructor(path, context, limits = {}) {
+        this.path = path;
+        this.limits = limits;
+        this.#parent = context.signal;
+        if (this.#parent?.aborted) {
+            this.stop("aborted");
+            return;
+        }
+        this.#parent?.addEventListener("abort", this.#onAbort, { once: true });
+        if (limits.timeoutMs !== undefined)
+            this.#later(limits.timeoutMs, () => this.stop("timeout"));
+        const deadline = context.capability?.deadline;
+        if (deadline !== undefined)
+            this.#later(Math.max(0, deadline - Date.now()), () => this.stop("deadline"));
+        this.touch();
+    }
+    #later(ms, stop) {
+        if (ms <= MAX_TIMER_MS)
+            this.#timers.push(setTimeout(stop, ms));
+    }
+    /** The signal that aborts the request at the stop. */
+    get signal() {
+        return this.#controller.signal;
+    }
+    /** The cause of the stop, or undefined while the call runs. */
+    get reason() {
+        return this.#reason;
+    }
+    /** This function stops the call. The first cause wins. */
+    stop(reason) {
+        if (this.#reason !== undefined)
+            return;
+        this.#reason = reason;
+        this.#clearIdle();
+        this.#controller.abort(this.error());
+    }
+    /** This function starts the idle time again: data arrived. */
+    touch() {
+        const idle = this.limits.idleTimeoutMs;
+        if (idle === undefined || this.#reason !== undefined)
+            return;
+        this.#clearIdle();
+        if (idle <= MAX_TIMER_MS)
+            this.#idle = setTimeout(() => this.stop("idle"), idle);
+    }
+    /** This function holds the idle time while the reader of a stream has an item and reads no data. */
+    pause() {
+        this.#clearIdle();
+    }
+    #clearIdle() {
+        if (this.#idle !== undefined)
+            clearTimeout(this.#idle);
+        this.#idle = undefined;
+    }
+    /** The error of the stop. Before a stop, an `ABORTED` error. */
+    error() {
+        const key = this.path.join(".");
+        switch (this.#reason) {
+            case "timeout":
+                return new InvocationError("TIMEOUT", `${key}: the call took more than ${this.limits.timeoutMs} ms (timeoutMs)`, this.path);
+            case "idle":
+                return new InvocationError("TIMEOUT", `${key}: no data arrived in ${this.limits.idleTimeoutMs} ms (idleTimeoutMs)`, this.path);
+            case "deadline":
+                return new InvocationError("TIMEOUT", `${key}: the deadline of the call passed`, this.path);
+            default:
+                return new InvocationError("ABORTED", `${key}: the caller aborted the call`, this.path);
+        }
+    }
+    /** The error to throw for a failure: the error of the stop after a stop, or the failure. */
+    translate(error) {
+        return this.#reason !== undefined ? this.error() : error;
+    }
+    /** This function removes the timers and the listener. */
+    dispose() {
+        for (const timer of this.#timers)
+            clearTimeout(timer);
+        this.#timers.length = 0;
+        this.#clearIdle();
+        this.#parent?.removeEventListener("abort", this.#onAbort);
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Type definitions of the procedures of this package
+ *
+ * mark procedure new adds the types of each new procedure here. The zod schemas are in
+ * `module.ts`: an exported schema needs a written type (isolatedDeclarations).
+ */
+/** A JSON value. */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** The methods of `http.request`. */
+export type HttpMethod = "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
+/** The fields of a request that each procedure has. */
+export interface HttpTarget {
+    /** The URL: `http:` or `https:`. */
+    url: string;
+    /** The headers of the request. */
+    headers?: Record<string, string> | undefined;
+    /** More parameters for the query of the URL. A list gives the parameter more than one time. */
+    query?: Record<string, string | number | boolean | Array<string | number | boolean>> | undefined;
+}
+export interface HttpRequestInput extends HttpTarget {
+    method?: HttpMethod | undefined;
+    /** A body of text. */
+    body?: string | undefined;
+    /** A body of JSON: the procedure sets `content-type: application/json`. */
+    json?: unknown;
+    /** A body of bytes in base64. */
+    bodyBase64?: string | undefined;
+    /** The form of the body of the response: text (the default), parsed JSON, or bytes in base64. */
+    responseType?: "text" | "json" | "bytes" | undefined;
+    /** The time of the whole call, in milliseconds. The default is 30000. */
+    timeoutMs?: number | undefined;
+    /** The largest body of the response, in bytes. The limit of the module is the maximum. */
+    maxResponseBytes?: number | undefined;
+    /** What to do with a redirect: follow it (the default), give it (`manual`), or fail (`error`). */
+    redirect?: "follow" | "manual" | "error" | undefined;
+    /** The most redirects that the call follows. The default is 5. */
+    maxRedirects?: number | undefined;
+}
+export interface HttpRequestOutput {
+    status: number;
+    statusText: string;
+    /** True for a status in 200 to 299. */
+    ok: boolean;
+    /** The URL of the response: the last URL after the redirects. */
+    url: string;
+    /** True when the call followed one or more redirects. */
+    redirected: boolean;
+    /** The headers of the response, with names in lowercase. `set-cookie` is a list. */
+    headers: Record<string, string | string[]>;
+    /** The body: text, parsed JSON (null for an empty body), or bytes in base64. */
+    body: unknown;
+    /** The size of the body in bytes, after the content encoding. */
+    bytes: number;
+}
+export interface HttpJsonInput extends HttpTarget {
+    /** GET, or POST. The default is POST with `json`, and GET without it. */
+    method?: "GET" | "POST" | undefined;
+    /** The JSON body of a POST. */
+    json?: unknown;
+    /** The time of the whole call, in milliseconds. The default is 30000. */
+    timeoutMs?: number | undefined;
+    /** The largest body of the response, in bytes. The limit of the module is the maximum. */
+    maxResponseBytes?: number | undefined;
+    /** True (the default): a status outside 200 to 299 is an error. False: the output has it. */
+    failOnStatus?: boolean | undefined;
+}
+export interface HttpJsonOutput {
+    status: number;
+    ok: boolean;
+    url: string;
+    headers: Record<string, string | string[]>;
+    /** The parsed body. An empty body gives null. An error status with a body that is not JSON gives its text. */
+    data: unknown;
+}
+export interface HttpStreamInput extends HttpTarget {
+    /** The time of the whole stream, in milliseconds. The default is no limit. */
+    timeoutMs?: number | undefined;
+    /** The longest time without data, in milliseconds. The default is no limit. */
+    idleTimeoutMs?: number | undefined;
+}
+export interface HttpNdjsonInput extends HttpStreamInput {
+    /** The largest line, in bytes. The default is 1 MiB. */
+    maxLineBytes?: number | undefined;
+}
+/** One item of `http.ndjson`: the JSON value of one line. */
+export type HttpNdjsonOutput = unknown;
+export interface HttpSseInput extends HttpStreamInput {
+    /** The `Last-Event-ID` header: the server continues after this event. */
+    lastEventId?: string | undefined;
+    /** The largest event, in bytes. The default is 1 MiB. */
+    maxEventBytes?: number | undefined;
+}
+/** One item of `http.sse`: one event. */
+export interface HttpSseOutput {
+    event: string;
+    data: string;
+    id?: string | undefined;
+    retry?: number | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions of the procedures of this package
+ *
+ * mark procedure new adds the types of each new procedure here. The zod schemas are in
+ * `module.ts`: an exported schema needs a written type (isolatedDeclarations).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}