@toa.io/extensions.exposition 1.0.0-alpha.27 → 1.0.0-alpha.270

package/transpiled/HTTP/exceptions.js

@@ -1,13 +1,16 @@
 "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;
+exports.ServiceUnavailable = exports.TooManyRequests = exports.UnprocessableEntity = exports.UnsupportedMediaType = exports.RequestEntityTooLarge = exports.PreconditionFailed = exports.Conflict = exports.NotAcceptable = exports.MethodNotAllowed = exports.NotFound = exports.Forbidden = exports.Unauthorized = exports.BadRequest = exports.ClientError = exports.Exception = void 0;
 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;
@@ -38,18 +41,6 @@ class NotFound extends ClientError {
     }
 }
 exports.NotFound = NotFound;
-class Conflict extends ClientError {
-    constructor(body) {
-        super(409, body);
-    }
-}
-exports.Conflict = Conflict;
-class UnprocessableEntity extends ClientError {
-    constructor(body) {
-        super(422, body);
-    }
-}
-exports.UnprocessableEntity = UnprocessableEntity;
 class MethodNotAllowed extends ClientError {
     constructor() {
         super(405);
@@ -62,16 +53,47 @@ class NotAcceptable extends ClientError {
     }
 }
 exports.NotAcceptable = NotAcceptable;
-class UnsupportedMediaType extends ClientError {
-    constructor() {
-        super(415);
+class Conflict extends ClientError {
+    constructor(body) {
+        super(409, body);
     }
 }
-exports.UnsupportedMediaType = UnsupportedMediaType;
+exports.Conflict = Conflict;
 class PreconditionFailed extends ClientError {
     constructor() {
         super(412);
     }
 }
 exports.PreconditionFailed = PreconditionFailed;
+class RequestEntityTooLarge extends ClientError {
+    constructor(body) {
+        super(413, body);
+    }
+}
+exports.RequestEntityTooLarge = RequestEntityTooLarge;
+class UnsupportedMediaType extends ClientError {
+    constructor() {
+        super(415);
+    }
+}
+exports.UnsupportedMediaType = UnsupportedMediaType;
+class UnprocessableEntity extends ClientError {
+    constructor(body) {
+        super(422, body);
+    }
+}
+exports.UnprocessableEntity = UnprocessableEntity;
+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) }));
+    }
+}
+exports.TooManyRequests = TooManyRequests;
+class ServiceUnavailable extends Exception {
+    constructor(body) {
+        super(503, body);
+    }
+}
+exports.ServiceUnavailable = ServiceUnavailable;
 //# 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,MAAa,SAAU,SAAQ,KAAK;IAClB,MAAM,CAAQ;IACd,IAAI,CAAM;IAE1B,+EAA+E;IAC/D,OAAO,CAAU;IAEjC,YAAuB,MAAc,EAAE,IAAU,EAAE,OAAiB;QAClE,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;AAbD,8BAaC;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,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,QAAS,SAAQ,WAAW;IACvC,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,4BAIC;AAED,MAAa,kBAAmB,SAAQ,WAAW;IACjD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAJD,gDAIC;AAED,MAAa,qBAAsB,SAAQ,WAAW;IACpD,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,sDAIC;AAED,MAAa,oBAAqB,SAAQ,WAAW;IACnD;QACE,KAAK,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;CACF;AAJD,oDAIC;AAED,MAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,kDAIC;AAED,MAAa,eAAgB,SAAQ,WAAW;IAC9C,gEAAgE;IAChE,YAAoB,KAAc;QAChC,KAAK,CAAC,GAAG,EAAE,SAAS,EAClB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACpF,CAAC;CACF;AAND,0CAMC;AAED,MAAa,kBAAmB,SAAQ,SAAS;IAC/C,YAAoB,IAAU;QAC5B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAClB,CAAC;CACF;AAJD,gDAIC"}

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

@@ -1,10 +1,10 @@
 /// <reference types="node" />
-import { type Buffer } from 'node:buffer';
+/// <reference types="node" />
 export declare const formats: Record<string, Format>;
 export declare const types: string[];
 export interface Format {
     readonly type: string;
     readonly multipart: string;
     encode: (value: any) => Buffer;
-    decode: (buffer: Buffer) => any;
+    decode: (buffer: Buffer, charset?: string) => any;
 }

package/transpiled/HTTP/formats/index.js

@@ -29,10 +29,10 @@ const yaml = __importStar(require("./yaml"));
 const msgpack = __importStar(require("./msgpack"));
 const text = __importStar(require("./text"));
 exports.formats = {
-    [msgpack.type]: msgpack,
-    [yaml.type]: yaml,
     [json.type]: json,
-    [text.type]: text
+    [yaml.type]: yaml,
+    [text.type]: text,
+    [msgpack.type]: msgpack
 };
 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,6CAA8B;AAC9B,6CAA8B;AAC9B,mDAAoC;AACpC,6CAA8B;AAEjB,QAAA,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;AAEY,QAAA,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAO,CAAC,CAAA"}

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

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import { Buffer } from 'node:buffer';
+/// <reference types="node" />
 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,16 @@
 "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();
+function decode(buffer, charset = 'utf-8') {
+    const text = buffer.toString(charset);
     return JSON.parse(text);
 }
 exports.decode = decode;
 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,QAAA,IAAI,GAAG,kBAAkB,CAAA;AACzB,QAAA,SAAS,GAAG,gBAAgB,CAAA;AAEzC,SAAgB,MAAM,CAAE,MAAc,EAAE,OAAO,GAAG,OAAO;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAA;IAEvD,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,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAJD,wBAIC"}

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

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { type Buffer } from 'node:buffer';
+/// <reference types="node" />
 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.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,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"}

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

@@ -1,8 +1,8 @@
 /// <reference types="node" />
-import { Buffer } from 'node:buffer';
+/// <reference types="node" />
 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,14 @@
 "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();
+function decode(buffer, charset = 'utf-8') {
+    return buffer.toString(charset);
 }
 exports.decode = decode;
 function encode(value) {
-    return node_buffer_1.Buffer.from(value.toString());
+    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,QAAA,IAAI,GAAG,YAAY,CAAA;AACnB,QAAA,SAAS,GAAG,gBAAgB,CAAA;AAEzC,SAAgB,MAAM,CAAE,MAAc,EAAE,OAAO,GAAG,OAAO;IACvD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAA;AACnD,CAAC;AAFD,wBAEC;AAED,SAAgB,MAAM,CAAE,KAAiC;IACvD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;AACtC,CAAC;AAFD,wBAEC"}

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

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import { Buffer } from 'node:buffer';
+/// <reference types="node" />
 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

@@ -24,18 +24,18 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 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();
+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);
+    const serializable = value instanceof Error ? Object.assign({}, value) : value;
+    const text = yaml.dump(serializable, { lineWidth: -1, noRefs: true });
+    return Buffer.from(text);
 }
 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,8CAA+B;AAElB,QAAA,IAAI,GAAG,kBAAkB,CAAA;AACzB,QAAA,SAAS,GAAG,gBAAgB,CAAA;AAEzC,SAAgB,MAAM,CAAE,MAAc,EAAE,OAAO,GAAG,OAAO;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAyB,CAAC,CAAA;IAEvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAJD,wBAIC;AAED,SAAgB,MAAM,CAAE,KAAU;IAChC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC9E,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;AALD,wBAKC"}

package/transpiled/HTTP/messages.d.ts

@@ -1,17 +1,22 @@
 /// <reference types="node" />
 import type { Context } from './Context';
 import type * as http from 'node:http';
-export declare function write(context: Context, response: http.ServerResponse, message: OutgoingMessage): void;
+export declare function write(context: Context, response: http.ServerResponse, message: OutgoingMessage): Promise<void>;
 export declare function read(context: Context): Promise<any>;
+export declare function multipart(message: OutgoingMessage, context: Context, response: http.ServerResponse): void;
 export interface OutgoingMessage {
     status?: number;
     headers?: Headers;
     body?: any;
+    /** tag the response with a hash of the encoded body, see `conditional` */
+    etag?: boolean;
 }
 export interface Query {
     [key: string]: string | number | undefined;
     id?: string;
     criteria?: string;
+    search?: string;
+    sample?: number;
     sort?: string;
     omit?: string;
     limit?: string;

package/transpiled/HTTP/messages.js

@@ -1,15 +1,52 @@
 "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.read = exports.write = void 0;
+exports.multipart = exports.read = exports.write = void 0;
 const node_stream_1 = require("node:stream");
-const consumers_1 = require("node:stream/consumers");
+const node_crypto_1 = require("node:crypto");
+const contentType = __importStar(require("content-type"));
+const openspan_1 = require("openspan");
 const formats_1 = require("./formats");
 const exceptions_1 = require("./exceptions");
-function write(context, response, message) {
+const server = `Exposition/${require('../../package.json').version}` +
+    ((process.env.TOA_CONTEXT === undefined ? '' : ` ${process.env.TOA_CONTEXT}`) +
+        (process.env.TOA_ENV === undefined ? '' : `/${process.env.TOA_ENV}`));
+const pending = new Map();
+async function write(context, response, message) {
     for (const transform of context.pipelines.response)
-        transform(message);
+        await transform(message);
+    if (message?.status !== undefined)
+        response.statusCode = message.status;
+    response.setHeader('server', server);
     message.headers?.forEach((value, key) => response.setHeader(key, value));
     context.timing.append(response);
+    if (response.destroyed) {
+        openspan_1.console.warn('Request destroyed prematurely', { path: context.url.pathname });
+        return;
+    }
+    response.on('error', (exception) => openspan_1.console.warn('HTTP response error', { path: context.url.pathname, exception }));
     if (message.body instanceof node_stream_1.Readable)
         stream(message, context, response);
     else
@@ -17,57 +54,125 @@ function write(context, response, message) {
 }
 exports.write = write;
 async function read(context) {
-    const type = context.request.headers['content-type'];
-    if (type === undefined)
+    const header = context.request.headers['content-type'];
+    if (header === undefined)
         return undefined;
+    const { type, parameters } = contentType.parse(header);
     if (!(type in formats_1.formats))
         throw new exceptions_1.UnsupportedMediaType();
     const format = formats_1.formats[type];
-    const buf = await context.timing.capture('buffer', (0, consumers_1.buffer)(context.request));
+    const buf = await context.buffer();
     try {
-        return format.decode(buf);
+        return format.decode(buf, parameters.charset);
     }
-    catch {
+    catch (error) {
+        openspan_1.console.debug('Failed to decode message', {
+            path: context.url.pathname,
+            error: error?.toString?.()
+        });
         throw new exceptions_1.BadRequest();
     }
 }
 exports.read = read;
 function send(message, context, response) {
     if (message.body === undefined || message.body === null) {
+        // a HEAD reply carries no body but must still report the length a GET would
+        // have returned, so a length already set by a directive is left alone
+        if (!response.hasHeader('content-length'))
+            response.setHeader('content-length', '0');
         response.end();
         return;
     }
     if (context.encoder === null)
         throw new exceptions_1.NotAcceptable();
     const buf = context.encoder.encode(message.body);
+    if (message.etag === true && conditional(context, response, buf))
+        return;
     response
         .setHeader('content-type', context.encoder.type)
+        .setHeader('content-length', buf.length.toString())
         .appendHeader('vary', 'accept')
         .end(buf);
 }
+/**
+ * Tags a reply that carries no version with a hash of the body being sent, and answers
+ * `304` when the client already has it. The tag is taken from the encoded body rather
+ * than from a serialization of its own, so it identifies the representation — which is
+ * what `vary` says.
+ */
+function conditional(context, response, buf) {
+    const etag = `"${(0, node_crypto_1.createHash)('sha256').update(buf).digest('hex')}"`;
+    response.setHeader('etag', etag);
+    if (context.request.headers['if-none-match'] !== etag)
+        return false;
+    response
+        .setHeader('content-length', '0')
+        .appendHeader('vary', 'accept');
+    response.statusCode = 304;
+    response.end();
+    return true;
+}
 function stream(message, context, response) {
     const encoded = message.headers !== undefined && message.headers.has('content-type');
     if (encoded)
         message.body.pipe(response);
     else
         multipart(message, context, response);
-    message.body.on('error', (e) => {
-        console.error(e);
+    message.body.on('error', (exception) => {
+        openspan_1.console.warn('Message stream error', { path: context.url.pathname, exception });
         response.end();
     });
+    if (context.debug)
+        debugStream(context, response);
 }
 function multipart(message, context, response) {
     if (context.encoder === null)
         throw new exceptions_1.NotAcceptable();
     const encoder = context.encoder;
     response.setHeader('content-type', `${encoder.multipart}; boundary=${BOUNDARY}`);
+    response.write(Buffer.concat([
+        CUT,
+        CRLF,
+        encoder.encode('ACK'),
+        CRLF,
+        CUT
+    ]));
     message.body
-        .map((part) => Buffer.concat([CUT, encoder.encode(part), CRLF]))
-        .on('end', () => response.end(FINALCUT))
+        .map((part) => Buffer.concat([
+        CRLF /* indicates no boundary headers */,
+        encoder.encode(part),
+        CRLF,
+        CUT
+    ]))
+        .on('end', () => response.end(Buffer.concat([
+        CRLF,
+        encoder.encode('FIN'),
+        CRLF,
+        FINALCUT
+    ])))
         .pipe(response);
 }
+exports.multipart = multipart;
 const BOUNDARY = 'cut';
 const CUT = Buffer.from(`--${BOUNDARY}\r\n`);
 const CRLF = Buffer.from('\r\n');
 const FINALCUT = Buffer.from(`--${BOUNDARY}--`);
+const PENDING_DEBUG_INTERVAL = 30000;
+let pendingInterval = null;
+function debugStream(context, response) {
+    const ctx = { method: context.request.method, path: context.url.pathname };
+    openspan_1.console.debug('Stream opened', ctx);
+    pending.set(context.id, ctx);
+    response.on('close', () => {
+        openspan_1.console.debug('Stream closed', ctx);
+        pending.delete(context.id);
+        if (pending.size === 0) {
+            if (pendingInterval !== null)
+                clearInterval(pendingInterval);
+            pendingInterval = null;
+        }
+    });
+    if (pendingInterval === null)
+        pendingInterval = setInterval(() => openspan_1.console.debug('Pending streams', { size: pending.size }), PENDING_DEBUG_INTERVAL);
+}
 //# sourceMappingURL=messages.js.map

package/transpiled/HTTP/messages.js.map

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

package/transpiled/Interception.d.ts

@@ -6,4 +6,6 @@ export declare class Interception implements Interceptor {
 }
 export interface Interceptor {
     intercept: (input: Input) => Output | Promise<Output>;
+    /** Discards whatever the interceptor accumulated while serving. */
+    reset?: () => void;
 }

package/transpiled/Interception.js

@@ -5,6 +5,10 @@ class Interception {
     interceptors;
     constructor(interceptors) {
         this.interceptors = interceptors;
+        // interceptors are module singletons, so a second gateway in one process —
+        // which is how the features run — would otherwise inherit the first one's state
+        for (const interceptor of interceptors)
+            interceptor.reset?.();
     }
     async intercept(input) {
         for (const interceptor of this.interceptors) {

package/transpiled/Interception.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interception.js","sourceRoot":"","sources":["../source/Interception.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACN,YAAY,CAAe;IAE5C,YAAoB,YAA2B;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,KAAY;QAClC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAEjD,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAjBD,oCAiBC"}
+{"version":3,"file":"Interception.js","sourceRoot":"","sources":["../source/Interception.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACN,YAAY,CAAe;IAE5C,YAAoB,YAA2B;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,2EAA2E;QAC3E,gFAAgF;QAChF,KAAK,MAAM,WAAW,IAAI,YAAY;YACpC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAA;IACzB,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,KAAY;QAClC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAEjD,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAtBD,oCAsBC"}

package/transpiled/Introspection.d.ts

@@ -0,0 +1,9 @@
+import type { Remote } from '@toa.io/core';
+export interface Introspection {
+    route?: Record<string, Schema>;
+    query?: Record<string, Schema>;
+    input?: Schema;
+    output?: Schema;
+    errors?: string[];
+}
+export type Schema = Awaited<ReturnType<Remote['explain']>>['input'];

package/transpiled/Introspection.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Introspection.js.map

package/transpiled/Introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Introspection.js","sourceRoot":"","sources":["../source/Introspection.ts"],"names":[],"mappings":""}

package/transpiled/Mapping.d.ts

@@ -1,8 +1,17 @@
 import { type Parameter } from './RTD';
+import { Query } from './Query';
+import type { Introspection, Schema } from './Introspection';
+import type { QueryString } from './Query';
 import type * as http from './HTTP';
 import type * as syntax from './RTD/syntax';
 import type * as core from '@toa.io/core';
 export declare abstract class Mapping {
-    static create(query?: syntax.Query): Mapping;
-    abstract fit(input: any, qs: http.Query, parameters: Parameter[]): core.Request;
+    protected readonly query: Query;
+    abstract readonly queryable: boolean;
+    constructor(query: Query);
+    static create(query?: syntax.Query | null): Mapping;
+    explain(introspection: Introspection): Record<string, Schema> | null;
+    protected assign(input: any, qs: QueryString): void;
+    abstract fit(input: any, query: http.Query, parameters: Parameter[]): core.Request;
 }
+export declare function queryable(query?: syntax.Query | null): boolean;