@toa.io/extensions.exposition 1.0.0-alpha.30 → 1.0.0-alpha.301

package/transpiled/HTTP/Timing.d.ts

@@ -1,10 +1,6 @@
-/// <reference types="node" />
-import type { ServerResponse } from 'node:http';
+import type { ServerResponse } from './types.ts';
+/** How long the request took, from received to written: one number, the header's. */
 export declare class Timing {
-    private readonly skip;
     private readonly start;
-    private readonly breakpoints;
-    constructor(enabled: boolean);
-    capture<T>(id: string, promise: Promise<T>): Promise<T>;
     append(response: ServerResponse): void;
 }

package/transpiled/HTTP/Timing.js

@@ -1,29 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Timing = void 0;
-const node_perf_hooks_1 = require("node:perf_hooks");
-class Timing {
-    skip;
-    start = node_perf_hooks_1.performance.now();
-    breakpoints = [];
-    constructor(enabled) {
-        this.skip = !enabled;
-    }
-    async capture(id, promise) {
-        if (this.skip)
-            return promise;
-        const start = node_perf_hooks_1.performance.now();
-        const result = promise instanceof Promise ? await promise : promise;
-        this.breakpoints.push({ id, duration: node_perf_hooks_1.performance.now() - start });
-        return result;
-    }
+import { performance } from 'node:perf_hooks';
+/** How long the request took, from received to written: one number, the header's. */
+export class Timing {
+    start = performance.now();
     append(response) {
-        if (this.skip)
-            return;
-        this.breakpoints.push({ id: 'total', duration: node_perf_hooks_1.performance.now() - this.start });
-        for (const breakpoint of this.breakpoints)
-            response.appendHeader('server-timing', `${breakpoint.id};dur=${breakpoint.duration.toFixed(3)}`);
+        response.setHeader('server-timing', `total;dur=${(performance.now() - this.start).toFixed(3)}`);
     }
 }
-exports.Timing = Timing;
 //# sourceMappingURL=Timing.js.map

package/transpiled/HTTP/Timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../source/HTTP/Timing.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAG7C,MAAa,MAAM;IACA,IAAI,CAAS;IACb,KAAK,GAAG,6BAAW,CAAC,GAAG,EAAE,CAAA;IACzB,WAAW,GAAiB,EAAE,CAAA;IAE/C,YAAoB,OAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAK,EAAU,EAAE,OAAmB;QACtD,IAAI,IAAI,CAAC,IAAI;YACX,OAAO,OAAO,CAAA;QAEhB,MAAM,KAAK,GAAG,6BAAW,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,OAAO,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;QAEnE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,6BAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;QAElE,OAAO,MAAM,CAAA;IACf,CAAC;IAEM,MAAM,CAAE,QAAwB;QACrC,IAAI,IAAI,CAAC,IAAI;YACX,OAAM;QAER,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,6BAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAEhF,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW;YACvC,QAAQ,CAAC,YAAY,CAAC,eAAe,EACnC,GAAG,UAAU,CAAC,EAAE,QAAQ,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC/D,CAAC;CACF;AA/BD,wBA+BC"}
+{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../source/HTTP/Timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG7C,qFAAqF;AACrF,MAAM,OAAO,MAAM;IACA,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAEnC,MAAM,CAAC,QAAwB;QACpC,QAAQ,CAAC,SAAS,CAChB,eAAe,EACf,aAAa,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC3D,CAAA;IACH,CAAC;CACF"}

package/transpiled/HTTP/address.d.ts

@@ -0,0 +1,7 @@
+import type { IncomingMessage } from './types.ts';
+/**
+ * The client address: the value of the header the deployment names, and nothing otherwise.
+ * Of a header holding a list, the last value is the one the edge in front appended. The
+ * connection's address is never it: behind an edge it is the edge's.
+ */
+export declare function address(request: IncomingMessage, header?: string): string | undefined;

package/transpiled/HTTP/address.js

@@ -0,0 +1,14 @@
+/**
+ * The client address: the value of the header the deployment names, and nothing otherwise.
+ * Of a header holding a list, the last value is the one the edge in front appended. The
+ * connection's address is never it: behind an edge it is the edge's.
+ */
+export function address(request, header) {
+    if (header === undefined)
+        return;
+    const value = request.headers[header];
+    const raw = Array.isArray(value) ? value[value.length - 1] : value;
+    const last = raw?.slice(raw.lastIndexOf(',') + 1).trim();
+    return last === '' ? undefined : last;
+}
+//# sourceMappingURL=address.js.map

package/transpiled/HTTP/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../source/HTTP/address.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAAwB,EAAE,MAAe;IAC/D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAM;IAEhC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAClE,MAAM,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAExD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AACvC,CAAC"}

package/transpiled/HTTP/exceptions.d.ts

@@ -1,7 +1,9 @@
 export declare class Exception extends Error {
     readonly status: number;
     readonly body?: any;
-    protected constructor(status: number, body?: any);
+    /** Headers the status is not complete without, like `Retry-After` on a 429. */
+    readonly headers?: Headers;
+    protected constructor(status: number, body?: any, headers?: Headers);
 }
 export declare class ClientError extends Exception {
 }
@@ -17,21 +19,37 @@ export declare class Forbidden extends ClientError {
 export declare class NotFound extends ClientError {
     constructor(body?: any);
 }
-export declare class Conflict extends ClientError {
-    constructor(body?: any);
+export declare class MethodNotAllowed extends ClientError {
+    constructor(headers?: Headers);
 }
-export declare class UnprocessableEntity extends ClientError {
+export declare class NotAcceptable extends ClientError {
+    constructor();
+}
+export declare class Conflict extends ClientError {
     constructor(body?: any);
 }
-export declare class MethodNotAllowed extends ClientError {
+export declare class PreconditionFailed extends ClientError {
     constructor();
 }
-export declare class NotAcceptable extends ClientError {
-    constructor();
+export declare class RequestEntityTooLarge extends ClientError {
+    constructor(body?: any);
 }
 export declare class UnsupportedMediaType extends ClientError {
     constructor();
 }
-export declare class PreconditionFailed extends ClientError {
+export declare class UnprocessableEntity extends ClientError {
+    constructor(body?: any);
+}
+export declare class TooManyRequests extends ClientError {
+    /** @param retry Seconds until the request would be admitted. */
+    constructor(retry?: number);
+}
+export declare class UnavailableForLegalReasons extends ClientError {
     constructor();
 }
+export declare class ServiceUnavailable extends Exception {
+    constructor(body?: any);
+}
+export declare class GatewayTimeout extends Exception {
+    constructor(body?: any);
+}

package/transpiled/HTTP/exceptions.js

@@ -1,77 +1,91 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PreconditionFailed = exports.UnsupportedMediaType = exports.NotAcceptable = exports.MethodNotAllowed = exports.UnprocessableEntity = exports.Conflict = exports.NotFound = exports.Forbidden = exports.Unauthorized = exports.BadRequest = exports.ClientError = exports.Exception = void 0;
-class Exception extends Error {
+export class Exception extends Error {
     status;
     body;
-    constructor(status, body) {
+    /** Headers the status is not complete without, like `Retry-After` on a 429. */
+    headers;
+    constructor(status, body, headers) {
         super();
         this.status = status;
         this.body = body;
+        this.headers = headers;
     }
 }
-exports.Exception = Exception;
-class ClientError extends Exception {
+export class ClientError extends Exception {
 }
-exports.ClientError = ClientError;
-class BadRequest extends ClientError {
+export class BadRequest extends ClientError {
     constructor(body) {
         super(400, body);
     }
 }
-exports.BadRequest = BadRequest;
-class Unauthorized extends ClientError {
+export class Unauthorized extends ClientError {
     constructor(body) {
         super(401, body);
     }
 }
-exports.Unauthorized = Unauthorized;
-class Forbidden extends ClientError {
+export class Forbidden extends ClientError {
     constructor(body) {
         super(403, body);
     }
 }
-exports.Forbidden = Forbidden;
-class NotFound extends ClientError {
+export class NotFound extends ClientError {
     constructor(body) {
         super(404, body);
     }
 }
-exports.NotFound = NotFound;
-class Conflict extends ClientError {
-    constructor(body) {
-        super(409, body);
+export class MethodNotAllowed extends ClientError {
+    constructor(headers) {
+        super(405, undefined, headers);
     }
 }
-exports.Conflict = Conflict;
-class UnprocessableEntity extends ClientError {
+export class NotAcceptable extends ClientError {
+    constructor() {
+        super(406);
+    }
+}
+export class Conflict extends ClientError {
     constructor(body) {
-        super(422, body);
+        super(409, body);
     }
 }
-exports.UnprocessableEntity = UnprocessableEntity;
-class MethodNotAllowed extends ClientError {
+export class PreconditionFailed extends ClientError {
     constructor() {
-        super(405);
+        super(412);
     }
 }
-exports.MethodNotAllowed = MethodNotAllowed;
-class NotAcceptable extends ClientError {
-    constructor() {
-        super(406);
+export class RequestEntityTooLarge extends ClientError {
+    constructor(body) {
+        super(413, body);
     }
 }
-exports.NotAcceptable = NotAcceptable;
-class UnsupportedMediaType extends ClientError {
+export class UnsupportedMediaType extends ClientError {
     constructor() {
         super(415);
     }
 }
-exports.UnsupportedMediaType = UnsupportedMediaType;
-class PreconditionFailed extends ClientError {
+export class UnprocessableEntity extends ClientError {
+    constructor(body) {
+        super(422, body);
+    }
+}
+export class TooManyRequests extends ClientError {
+    /** @param retry Seconds until the request would be admitted. */
+    constructor(retry) {
+        super(429, undefined, retry === undefined ? undefined : new Headers({ 'retry-after': String(retry) }));
+    }
+}
+export class UnavailableForLegalReasons extends ClientError {
     constructor() {
-        super(412);
+        super(451);
+    }
+}
+export class ServiceUnavailable extends Exception {
+    constructor(body) {
+        super(503, body);
+    }
+}
+export class GatewayTimeout extends Exception {
+    constructor(body) {
+        super(504, body);
     }
 }
-exports.PreconditionFailed = PreconditionFailed;
 //# sourceMappingURL=exceptions.js.map

package/transpiled/HTTP/exceptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../source/HTTP/exceptions.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAU,SAAQ,KAAK;IAClB,MAAM,CAAQ;IACd,IAAI,CAAM;IAE1B,YAAuB,MAAc,EAAE,IAAU;QAC/C,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AATD,8BASC;AAED,MAAa,WAAY,SAAQ,SAAS;CACzC;AADD,kCACC;AAED,MAAa,UAAW,SAAQ,WAAW;IACzC,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,gCAIC;AAED,MAAa,YAAa,SAAQ,WAAW;IAC3C,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,oCAIC;AAED,MAAa,SAAU,SAAQ,WAAW;IACxC,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,8BAIC;AAED,MAAa,QAAS,SAAQ,WAAW;IACvC,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,4BAIC;AAED,MAAa,QAAS,SAAQ,WAAW;IACvC,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,4BAIC;AAED,MAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,kDAIC;AAED,MAAa,gBAAiB,SAAQ,WAAW;IAC/C;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAJD,4CAIC;AAED,MAAa,aAAc,SAAQ,WAAW;IAC5C;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,oBAAqB,SAAQ,WAAW;IACnD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAJD,oDAIC;AAED,MAAa,kBAAmB,SAAQ,WAAW;IACjD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAJD,gDAIC"}
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../source/HTTP/exceptions.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,MAAM,CAAQ;IACd,IAAI,CAAM;IAE1B,+EAA+E;IAC/D,OAAO,CAAU;IAEjC,YAAsB,MAAc,EAAE,IAAU,EAAE,OAAiB;QACjE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,SAAS;CAAG;AAE7C,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,YAAmB,OAAiB;QAClC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,gEAAgE;IAChE,YAAmB,KAAc;QAC/B,KAAK,CACH,GAAG,EACH,SAAS,EACT,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAChF,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,WAAW;IACzD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,YAAmB,IAAU;QAC3B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF"}

package/transpiled/HTTP/formats/form.d.ts

@@ -0,0 +1,9 @@
+export declare const type = "application/x-www-form-urlencoded";
+/**
+ * A form is read and never written: it is what an HTML form and a handful of protocols send,
+ * and nothing asks for a reply in it.
+ *
+ * A name repeated in a form is a list, which is how a form says one — `URLSearchParams` keeps
+ * every value, and a name given once stays the string it was written as.
+ */
+export declare function decode(buffer: Buffer, charset?: string): any;

package/transpiled/HTTP/formats/form.js

@@ -0,0 +1,18 @@
+export const type = 'application/x-www-form-urlencoded';
+/**
+ * A form is read and never written: it is what an HTML form and a handful of protocols send,
+ * and nothing asks for a reply in it.
+ *
+ * A name repeated in a form is a list, which is how a form says one — `URLSearchParams` keeps
+ * every value, and a name given once stays the string it was written as.
+ */
+export function decode(buffer, charset = 'utf-8') {
+    const params = new URLSearchParams(buffer.toString(charset));
+    const value = {};
+    for (const name of new Set(params.keys())) {
+        const values = params.getAll(name);
+        value[name] = values.length === 1 ? values[0] : values;
+    }
+    return value;
+}
+//# sourceMappingURL=form.js.map

package/transpiled/HTTP/formats/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../../source/HTTP/formats/form.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,mCAAmC,CAAA;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,OAAO,GAAG,OAAO;IACtD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAC,CAAA;IAC9E,MAAM,KAAK,GAAsC,EAAE,CAAA;IAEnD,KAAK,MAAM,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAElC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACxD,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/transpiled/HTTP/formats/index.d.ts

@@ -1,10 +1,16 @@
-/// <reference types="node" />
-import { type Buffer } from 'node:buffer';
+/** What a reply may be encoded as, and so what `accept` is negotiated against. */
 export declare const formats: Record<string, Format>;
 export declare const types: string[];
-export interface Format {
+/**
+ * What a request body may arrive as. Everything a reply may be, and a form besides — which
+ * is read and never written, so it is not something a reply can be asked for.
+ */
+export declare const decoders: Record<string, Decoder>;
+export interface Decoder {
     readonly type: string;
+    decode: (buffer: Buffer, charset?: string) => any;
+}
+export interface Format extends Decoder {
     readonly multipart: string;
     encode: (value: any) => Buffer;
-    decode: (buffer: Buffer) => any;
 }

package/transpiled/HTTP/formats/index.js

@@ -1,38 +1,22 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.types = exports.formats = void 0;
-const json = __importStar(require("./json"));
-const yaml = __importStar(require("./yaml"));
-const msgpack = __importStar(require("./msgpack"));
-const text = __importStar(require("./text"));
-exports.formats = {
-    [msgpack.type]: msgpack,
-    [yaml.type]: yaml,
+import * as json from './json.js';
+import * as yaml from './yaml.js';
+import * as msgpack from './msgpack.js';
+import * as text from './text.js';
+import * as form from './form.js';
+/** What a reply may be encoded as, and so what `accept` is negotiated against. */
+export const formats = {
     [json.type]: json,
-    [text.type]: text
+    [yaml.type]: yaml,
+    [text.type]: text,
+    [msgpack.type]: msgpack
+};
+export const types = Object.keys(formats);
+/**
+ * What a request body may arrive as. Everything a reply may be, and a form besides — which
+ * is read and never written, so it is not something a reply can be asked for.
+ */
+export const decoders = {
+    ...formats,
+    [form.type]: form
 };
-exports.types = Object.keys(exports.formats);
 //# sourceMappingURL=index.js.map

package/transpiled/HTTP/formats/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/HTTP/formats/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6CAA8B;AAC9B,6CAA8B;AAC9B,mDAAoC;AACpC,6CAA8B;AAEjB,QAAA,OAAO,GAA2B;IAC7C,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO;IACvB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;CAClB,CAAA;AAEY,QAAA,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAO,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/HTTP/formats/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,kFAAkF;AAClF,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO;CACxB,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA4B;IAC/C,GAAG,OAAO;IACV,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;CAClB,CAAA"}

package/transpiled/HTTP/formats/json.d.ts

@@ -1,6 +1,4 @@
-/// <reference types="node" />
-import { Buffer } from 'node:buffer';
 export declare const type = "application/json";
 export declare const multipart = "multipart/json";
-export declare function decode(buffer: Buffer): any;
+export declare function decode(buffer: Buffer, charset?: string): any;
 export declare function encode(value: any): Buffer;

package/transpiled/HTTP/formats/json.js

@@ -1,17 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.encode = exports.decode = exports.multipart = exports.type = void 0;
-const node_buffer_1 = require("node:buffer");
-exports.type = 'application/json';
-exports.multipart = 'multipart/json';
-function decode(buffer) {
-    const text = buffer.toString();
+export const type = 'application/json';
+export const multipart = 'multipart/json';
+export function decode(buffer, charset = 'utf-8') {
+    const text = buffer.toString(charset);
     return JSON.parse(text);
 }
-exports.decode = decode;
-function encode(value) {
+export function encode(value) {
     const text = JSON.stringify(value);
-    return node_buffer_1.Buffer.from(text);
+    return Buffer.from(text);
 }
-exports.encode = encode;
 //# sourceMappingURL=json.js.map

package/transpiled/HTTP/formats/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../source/HTTP/formats/json.ts"],"names":[],"mappings":";;;AAAA,6CAAoC;AAEvB,QAAA,IAAI,GAAG,kBAAkB,CAAA;AACzB,QAAA,SAAS,GAAG,gBAAgB,CAAA;AAEzC,SAAgB,MAAM,CAAE,MAAc;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAE9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAJD,wBAIC;AAED,SAAgB,MAAM,CAAE,KAAU;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAElC,OAAO,oBAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAJD,wBAIC"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../source/HTTP/formats/json.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAA;AACtC,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAA;AAEzC,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,OAAO,GAAG,OAAO;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAA;IAEvD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAU;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAElC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/transpiled/HTTP/formats/msgpack.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-import { type Buffer } from 'node:buffer';
 export declare function decode(buffer: Buffer): any;
 export declare function encode(value: any): Buffer;
 export declare const type = "application/msgpack";

package/transpiled/HTTP/formats/msgpack.js

@@ -1,17 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.multipart = exports.type = exports.encode = exports.decode = void 0;
-const msgpackr_1 = require("msgpackr");
-function decode(buffer) {
-    return (0, msgpackr_1.unpack)(buffer);
+import { pack, unpack } from 'msgpackr';
+export function decode(buffer) {
+    return unpack(buffer);
 }
-exports.decode = decode;
-function encode(value) {
+export function encode(value) {
     if (typeof value === 'object' && value !== null)
         Object.setPrototypeOf(value, null);
-    return (0, msgpackr_1.pack)(value);
+    return pack(value);
 }
-exports.encode = encode;
-exports.type = 'application/msgpack';
-exports.multipart = 'multipart/msgpack';
+export const type = 'application/msgpack';
+export const multipart = 'multipart/msgpack';
 //# sourceMappingURL=msgpack.js.map

package/transpiled/HTTP/formats/msgpack.js.map

@@ -1 +1 @@
-{"version":3,"file":"msgpack.js","sourceRoot":"","sources":["../../../source/HTTP/formats/msgpack.ts"],"names":[],"mappings":";;;AACA,uCAAuC;AAEvC,SAAgB,MAAM,CAAE,MAAc;IACpC,OAAO,IAAA,iBAAM,EAAC,MAAM,CAAC,CAAA;AACvB,CAAC;AAFD,wBAEC;AAED,SAAgB,MAAM,CAAE,KAAU;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAC7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAEpC,OAAO,IAAA,eAAI,EAAC,KAAK,CAAC,CAAA;AACpB,CAAC;AALD,wBAKC;AAEY,QAAA,IAAI,GAAG,qBAAqB,CAAA;AAC5B,QAAA,SAAS,GAAG,mBAAmB,CAAA"}
+{"version":3,"file":"msgpack.js","sourceRoot":"","sources":["../../../source/HTTP/formats/msgpack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEvC,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAU;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAEnF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAA;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,mBAAmB,CAAA"}

package/transpiled/HTTP/formats/text.d.ts

@@ -1,8 +1,6 @@
-/// <reference types="node" />
-import { Buffer } from 'node:buffer';
 export declare const type = "text/plain";
 export declare const multipart = "multipart/text";
-export declare function decode(buffer: Buffer): any;
+export declare function decode(buffer: Buffer, charset?: string): any;
 export declare function encode(value: {
     toString: () => string;
 }): Buffer;

package/transpiled/HTTP/formats/text.js

@@ -1,15 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.encode = exports.decode = exports.multipart = exports.type = void 0;
-const node_buffer_1 = require("node:buffer");
-exports.type = 'text/plain';
-exports.multipart = 'multipart/text';
-function decode(buffer) {
-    return buffer.toString();
+export const type = 'text/plain';
+export const multipart = 'multipart/text';
+export function decode(buffer, charset = 'utf-8') {
+    return buffer.toString(charset);
 }
-exports.decode = decode;
-function encode(value) {
-    return node_buffer_1.Buffer.from(value.toString());
+export function encode(value) {
+    return Buffer.from(value.toString());
 }
-exports.encode = encode;
 //# sourceMappingURL=text.js.map

package/transpiled/HTTP/formats/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../source/HTTP/formats/text.ts"],"names":[],"mappings":";;;AAAA,6CAAoC;AAEvB,QAAA,IAAI,GAAG,YAAY,CAAA;AACnB,QAAA,SAAS,GAAG,gBAAgB,CAAA;AAEzC,SAAgB,MAAM,CAAE,MAAc;IACpC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;AAC1B,CAAC;AAFD,wBAEC;AAED,SAAgB,MAAM,CAAE,KAAiC;IACvD,OAAO,oBAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;AACtC,CAAC;AAFD,wBAEC"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../source/HTTP/formats/text.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,YAAY,CAAA;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAA;AAEzC,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,OAAO,GAAG,OAAO;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAiC;IACtD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;AACtC,CAAC"}

package/transpiled/HTTP/formats/yaml.d.ts

@@ -1,6 +1,4 @@
-/// <reference types="node" />
-import { Buffer } from 'node:buffer';
 export declare const type = "application/yaml";
 export declare const multipart = "multipart/yaml";
-export declare function decode(buffer: Buffer): any;
+export declare function decode(buffer: Buffer, charset?: string): any;
 export declare function encode(value: any): Buffer;

package/transpiled/HTTP/formats/yaml.js

@@ -1,41 +1,30 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.encode = exports.decode = exports.multipart = exports.type = void 0;
-const node_buffer_1 = require("node:buffer");
-const yaml = __importStar(require("js-yaml"));
-exports.type = 'application/yaml';
-exports.multipart = 'multipart/yaml';
-function decode(buffer) {
-    const text = buffer.toString();
+import { yaml } from '@toa.io/generic';
+export const type = 'application/yaml';
+export const multipart = 'multipart/yaml';
+export function decode(buffer, charset = 'utf-8') {
+    const text = buffer.toString(charset);
     return yaml.load(text);
 }
-exports.decode = decode;
-function encode(value) {
-    const text = yaml.dump(value, { lineWidth: -1, noRefs: true });
-    return node_buffer_1.Buffer.from(text);
+export function encode(value) {
+    const serializable = value instanceof Error ? Object.assign({}, value) : represent(value);
+    const text = yaml.dump(serializable, { lineWidth: -1, noRefs: true });
+    return Buffer.from(text);
+}
+/** What says how it is to be written — a redacted secret — is written that way, as in JSON. */
+function represent(value) {
+    if (typeof value !== 'object' ||
+        value === null ||
+        value instanceof Date ||
+        Buffer.isBuffer(value))
+        return value;
+    if ('toJSON' in value && typeof value.toJSON === 'function')
+        return value.toJSON();
+    if (Array.isArray(value))
+        return value.map(represent);
+    const object = value;
+    const represented = {};
+    for (const key of Object.keys(object))
+        represented[key] = represent(object[key]);
+    return represented;
 }
-exports.encode = encode;
 //# sourceMappingURL=yaml.js.map

package/transpiled/HTTP/formats/yaml.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../source/HTTP/formats/yaml.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAoC;AACpC,8CAA+B;AAElB,QAAA,IAAI,GAAG,kBAAkB,CAAA;AACzB,QAAA,SAAS,GAAG,gBAAgB,CAAA;AAEzC,SAAgB,MAAM,CAAE,MAAc;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAE9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAJD,wBAIC;AAED,SAAgB,MAAM,CAAE,KAAU;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9D,OAAO,oBAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAJD,wBAIC"}
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../source/HTTP/formats/yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAA;AACtC,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAA;AAEzC,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,OAAO,GAAG,OAAO;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAA;IAEvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAU;IAC/B,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAErE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,+FAA+F;AAC/F,SAAS,SAAS,CAAC,KAAc;IAC/B,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,YAAY,IAAI;QACrB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEtB,OAAO,KAAK,CAAA;IAEd,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,MAAM,EAAE,CAAA;IAElF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAErD,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,MAAM,WAAW,GAA4B,EAAE,CAAA;IAE/C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAEhF,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/transpiled/HTTP/index.d.ts

@@ -1,4 +1,6 @@
-export * from './Server';
-export * from './messages';
-export * from './exceptions';
-export * from './Context';
+export * from './Server.ts';
+export * from './messages.ts';
+export * from './exceptions.ts';
+export * from './Context.ts';
+export * from './types.ts';
+export * from './Probe.ts';