@toa.io/extensions.exposition 1.0.0-alpha.29 → 1.0.0-alpha.291

package/transpiled/directives/io/Output.js

@@ -1,33 +1,11 @@
-"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.Output = void 0;
-const node_stream_1 = require("node:stream");
-const schemas = __importStar(require("./schemas"));
-class Output {
+import { Stream } from 'node:stream';
+import { console } from 'openspan';
+import * as schemas from './schemas.js';
+export class Output {
+    /** whether the reply passes whole, which is when the schema is the operation's own */
     disabled = false;
+    /** what a reply may carry, which is therefore what the output schema states */
+    allowed;
     omitted = true;
     permissions = [];
     constructor(permissions) {
@@ -38,39 +16,45 @@ class Output {
                 this.omitted = false;
         else
             this.permissions = permissions;
+        this.allowed = new Set(this.permissions);
     }
     static validate(permissions) {
-        schemas.output.validate(permissions, 'Incorrect \'io:output\' format');
+        schemas.output.validate(permissions, "Incorrect 'io:output' format");
     }
-    attach(context) {
+    precall(context) {
         context.pipelines.response.push(this.restriction(context));
     }
     restriction(context) {
         return (message) => {
-            const error = message.status !== undefined && message.status >= 300;
-            const stream = message.body instanceof node_stream_1.Stream;
+            // what the gateway built is its own — a code and a message — and a restriction has
+            // nothing to say about it; everything else is a reply the operation returned, and is
+            // restricted whatever status it carries
+            const error = message.authentic === true;
+            const stream = message.body instanceof Stream;
             const none = message.body === undefined || message.body === null;
             if (this.disabled || error || stream || none)
                 return;
             if (typeof message.body !== 'object' || this.permissions.length === 0) {
                 if (this.omitted)
-                    console.warn('Permissions for \'io:output\' are not specified properly ' +
-                        `(${context.request.url}). Response omitted.`);
+                    console.warn("Permissions for 'io:output' are not specified properly, response omitted", { path: context.url.pathname });
                 delete message.body;
                 return;
             }
-            schemas.message.validate(message.body, '\'io:output\' expects response to be an object or array of objects');
+            schemas.message.validate(message.body, "'io:output' expects response to be an object or array of objects");
             if (Array.isArray(message.body))
                 message.body = message.body.map((entity) => this.fit(entity));
             else
                 message.body = this.fit(message.body);
         };
     }
+    /** Runs per entity of a collection, hence the set and the absence of intermediates. */
     fit(message) {
-        const entries = Object.entries(message)
-            .filter(([key]) => this.permissions.includes(key));
-        return Object.fromEntries(entries);
+        const output = {};
+        // the keys of the entity, so that the response keeps the order it was built in
+        for (const key of Object.keys(message))
+            if (this.allowed.has(key))
+                output[key] = message[key];
+        return output;
     }
 }
-exports.Output = Output;
 //# sourceMappingURL=Output.js.map

package/transpiled/directives/io/Output.js.map

@@ -1 +1 @@
-{"version":3,"file":"Output.js","sourceRoot":"","sources":["../../../source/directives/io/Output.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAoC;AACpC,mDAAoC;AAMpC,MAAa,MAAM;IACA,QAAQ,GAAY,KAAK,CAAA;IACzB,OAAO,GAAY,IAAI,CAAA;IACvB,WAAW,GAAa,EAAE,CAAA;IAE3C,YAAoB,WAAwB;QAC1C,IAAI,OAAO,WAAW,KAAK,SAAS;YAClC,IAAI,WAAW;gBACb,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;;gBAEpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;;YAGtB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAClC,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAE,WAAoB;QAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAA;IACxE,CAAC;IAEM,MAAM,CAAE,OAAgB;QAC7B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;IAC5D,CAAC;IAEO,WAAW,CAAE,OAAgB;QACnC,OAAO,CAAC,OAAwB,EAAQ,EAAE;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,CAAA;YACnE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,YAAY,oBAAM,CAAA;YAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAA;YAEhE,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,IAAI,MAAM,IAAI,IAAI;gBAC1C,OAAM;YAER,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtE,IAAI,IAAI,CAAC,OAAO;oBACd,OAAO,CAAC,IAAI,CAAC,2DAA2D;wBACtE,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAA;gBAElD,OAAO,OAAO,CAAC,IAAI,CAAA;gBAEnB,OAAM;YACR,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EACnC,oEAAoE,CAAC,CAAA;YAEvE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC7B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;;gBAE7D,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC;IAEO,GAAG,CAAE,OAAgB;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aACpC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;QAEpD,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;CACF;AA3DD,wBA2DC"}
+{"version":3,"file":"Output.js","sourceRoot":"","sources":["../../../source/directives/io/Output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAMvC,MAAM,OAAO,MAAM;IACjB,sFAAsF;IACtE,QAAQ,GAAY,KAAK,CAAA;IAEzC,+EAA+E;IAC/D,OAAO,CAAa;IACnB,OAAO,GAAY,IAAI,CAAA;IACvB,WAAW,GAAa,EAAE,CAAA;IAE3C,YAAmB,WAAwB;QACzC,IAAI,OAAO,WAAW,KAAK,SAAS;YAClC,IAAI,WAAW;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;;gBAChC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;;YACtB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAEnC,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC1C,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,WAAoB;QACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAA;IACtE,CAAC;IAEM,OAAO,CAAC,OAAgB;QAC7B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;IAC5D,CAAC;IAEO,WAAW,CAAC,OAAgB;QAClC,OAAO,CAAC,OAAwB,EAAQ,EAAE;YACxC,mFAAmF;YACnF,qFAAqF;YACrF,wCAAwC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAA;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,YAAY,MAAM,CAAA;YAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAA;YAEhE,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAM;YAEpD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtE,IAAI,IAAI,CAAC,OAAO;oBACd,OAAO,CAAC,IAAI,CACV,0EAA0E,EAC1E,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAC/B,CAAA;gBAEH,OAAO,OAAO,CAAC,IAAI,CAAA;gBAEnB,OAAM;YACR,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,QAAQ,CACtB,OAAO,CAAC,IAAI,EACZ,kEAAkE,CACnE,CAAA;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC7B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAiB,CAAC,CAAC,CAAA;;gBACrE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5C,CAAC,CAAA;IACH,CAAC;IAED,uFAAuF;IAC/E,GAAG,CAAC,OAAgB;QAC1B,MAAM,MAAM,GAAY,EAAE,CAAA;QAE1B,+EAA+E;QAC/E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACpC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAEvD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/directives/io/Status.d.ts

@@ -0,0 +1,19 @@
+import type { Directive } from './Directive.js';
+import type * as http from '../../HTTP/index.js';
+/**
+ * The status of the reply, taken from a property of what the operation returned and removed
+ * from it — an outcome the operation knows and the transport does not, like a protocol that
+ * states its error as a body rather than as a status of its own.
+ *
+ * Settled rather than transformed, so the status is set before anything reads it. A reply of
+ * 300 or above is left as the operation built it, which `io:output` does not restrict: a
+ * failure and a success are different shapes, and one list of permitted properties does not
+ * describe both.
+ */
+export declare class Status implements Directive {
+    private readonly property;
+    constructor(property: unknown);
+    static validate(value: unknown): asserts value is string;
+    precall(): void;
+    settle(_: unknown, response: http.OutgoingMessage): void;
+}

package/transpiled/directives/io/Status.js

@@ -0,0 +1,34 @@
+import assert from 'node:assert';
+/**
+ * The status of the reply, taken from a property of what the operation returned and removed
+ * from it — an outcome the operation knows and the transport does not, like a protocol that
+ * states its error as a body rather than as a status of its own.
+ *
+ * Settled rather than transformed, so the status is set before anything reads it. A reply of
+ * 300 or above is left as the operation built it, which `io:output` does not restrict: a
+ * failure and a success are different shapes, and one list of permitted properties does not
+ * describe both.
+ */
+export class Status {
+    property;
+    constructor(property) {
+        this.property = property;
+    }
+    static validate(value) {
+        assert.ok(typeof value === 'string', '`io:status` must be a string');
+    }
+    precall() {
+        // nothing to do until the operation has answered
+    }
+    settle(_, response) {
+        const body = response.body;
+        if (body === null || typeof body !== 'object' || !(this.property in body))
+            return;
+        const value = body[this.property];
+        assert.ok(typeof value === 'number', `\`io:status\` expects '${this.property}' to be a number`);
+        response.status = value;
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete body[this.property];
+    }
+}
+//# sourceMappingURL=Status.js.map

package/transpiled/directives/io/Status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Status.js","sourceRoot":"","sources":["../../../source/directives/io/Status.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAIhC;;;;;;;;;GASG;AACH,MAAM,OAAO,MAAM;IACA,QAAQ,CAAQ;IAEjC,YAAmB,QAAiB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAkB,CAAA;IACpC,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,KAAc;QACnC,MAAM,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,EAAE,8BAA8B,CAAC,CAAA;IACtE,CAAC;IAEM,OAAO;QACZ,iDAAiD;IACnD,CAAC;IAEM,MAAM,CAAC,CAAU,EAAE,QAA8B;QACtD,MAAM,IAAI,GAAY,QAAQ,CAAC,IAAI,CAAA;QAEnC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;YAAE,OAAM;QAEjF,MAAM,KAAK,GAAa,IAAgC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEvE,MAAM,CAAC,EAAE,CACP,OAAO,KAAK,KAAK,QAAQ,EACzB,0BAA0B,IAAI,CAAC,QAAQ,kBAAkB,CAC1D,CAAA;QAED,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAA;QAEvB,gEAAgE;QAChE,OAAQ,IAAgC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACzD,CAAC;CACF"}

package/transpiled/directives/io/Throttle.d.ts

@@ -0,0 +1,11 @@
+import { type Declaration, type Sync } from './lib/throttle/index.js';
+import type * as http from '../../HTTP/index.js';
+import type { Parameter } from '../../RTD/index.js';
+import type { Directive } from './Directive.js';
+export declare class Throttle implements Directive {
+    private readonly quotas;
+    constructor(declaration: Declaration, sync: Sync, route: string);
+    static validate(declaration: unknown): asserts declaration is Declaration;
+    precall(context: http.Context, parameters: Parameter[]): void;
+    settle(context: http.Context, output: http.OutgoingMessage): void;
+}

package/transpiled/directives/io/Throttle.js

@@ -0,0 +1,22 @@
+import { TooManyRequests } from '../../HTTP/index.js';
+import * as schemas from './schemas.js';
+import { parse, Quotas } from './lib/throttle/index.js';
+export class Throttle {
+    quotas;
+    constructor(declaration, sync, route) {
+        this.quotas = Quotas.create(parse(declaration), route);
+        sync.register(this.quotas);
+    }
+    static validate(declaration) {
+        schemas.throttle.validate(declaration, "Incorrect 'io:throttle' format");
+    }
+    precall(context, parameters) {
+        const retry = this.quotas.check(context, parameters);
+        if (retry > 0)
+            throw new TooManyRequests(retry);
+    }
+    settle(context, output) {
+        this.quotas.use(context, output);
+    }
+}
+//# sourceMappingURL=Throttle.js.map

package/transpiled/directives/io/Throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Throttle.js","sourceRoot":"","sources":["../../../source/directives/io/Throttle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,EAA+B,MAAM,yBAAyB,CAAA;AAKpF,MAAM,OAAO,QAAQ;IACF,MAAM,CAAQ;IAE/B,YAAmB,WAAwB,EAAE,IAAU,EAAE,KAAa;QACpE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAA;QAEtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,WAAoB;QACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAA;IAC1E,CAAC;IAEM,OAAO,CAAC,OAAqB,EAAE,UAAuB;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;QAEpD,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;IACjD,CAAC;IAEM,MAAM,CAAC,OAAqB,EAAE,MAA4B;QAC/D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;CACF"}

package/transpiled/directives/io/index.d.ts

@@ -1,2 +1,2 @@
-import { IO } from './IO';
+import { IO } from './IO.js';
 export declare const io: IO;

package/transpiled/directives/io/index.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.io = void 0;
-const IO_1 = require("./IO");
-exports.io = new IO_1.IO();
+import { IO } from './IO.js';
+export const io = new IO();
 //# sourceMappingURL=index.js.map

package/transpiled/directives/io/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/io/index.ts"],"names":[],"mappings":";;;AAAA,6BAAyB;AAEZ,QAAA,EAAE,GAAG,IAAI,OAAE,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/io/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,CAAA"}

package/transpiled/directives/io/lib/throttle/Configuration.d.ts

@@ -0,0 +1,26 @@
+export interface Configuration {
+    key: KeyComponent[];
+    condition?: KeyCondition[];
+    requests: number;
+    interval: number;
+}
+interface Rule<T, K = unknown> {
+    method: T;
+    options?: K;
+}
+export type KeyComponentMethod = 'ip' | 'path' | 'route' | 'identity' | 'segment';
+export type KeyConditionMethod = 'status';
+export type KeyComponent = Rule<KeyComponentMethod>;
+export type KeyCondition = Rule<KeyConditionMethod>;
+/** A bare component, or the one that takes an argument. */
+type KeyEntry = KeyComponentMethod | {
+    segment: string;
+};
+type KeyDeclaration = KeyEntry | KeyEntry[];
+type ConditionDeclaration = Record<KeyConditionMethod, unknown> | Array<Record<KeyConditionMethod, unknown>>;
+export interface Declaration extends Omit<Configuration, 'key' | 'condition'> {
+    key: KeyDeclaration;
+    condition?: ConditionDeclaration;
+}
+export declare function parse(declaration: Declaration): Configuration;
+export {};

package/transpiled/directives/io/lib/throttle/Configuration.js

@@ -0,0 +1,31 @@
+export function parse(declaration) {
+    const { key, condition, requests, interval } = declaration;
+    return {
+        key: mapKey(key),
+        condition: mapCondition(condition),
+        requests,
+        interval: interval * 1000
+    };
+}
+function mapKey(declaration) {
+    const entries = Array.isArray(declaration) ? declaration : [declaration];
+    // a bare `path`, or `segment: id` for the ones that take an argument
+    return entries.flatMap((entry) => typeof entry === 'string'
+        ? [{ method: entry }]
+        : Object.entries(entry).map(([method, options]) => ({
+            method: method,
+            options
+        })));
+}
+function mapCondition(declaration) {
+    if (declaration === undefined)
+        return;
+    // reduce to a single object, then map entries to rules
+    const conditions = Array.isArray(declaration) ? declaration : [declaration];
+    const single = conditions.reduce((acc, condition) => ({ ...acc, ...condition }), {});
+    return Object.entries(single).map(([method, options]) => ({
+        method,
+        options
+    }));
+}
+//# sourceMappingURL=Configuration.js.map

package/transpiled/directives/io/lib/throttle/Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Configuration.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,KAAK,CAAC,WAAwB;IAC5C,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAA;IAE1D,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;QAChB,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;QAClC,QAAQ;QACR,QAAQ,EAAE,QAAQ,GAAG,IAAI;KAC1B,CAAA;AACH,CAAC;AAED,SAAS,MAAM,CAAC,WAA2B;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAExE,qEAAqE;IACrE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAkB,EAAE,CAC/C,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,MAAM,EAAE,MAA4B;YACpC,OAAO;SACR,CAAC,CAAC,CACR,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,WAAkC;IACtD,IAAI,WAAW,KAAK,SAAS;QAAE,OAAM;IAErC,uDAAuD;IACvD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAEpF,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM;QACN,OAAO;KACR,CAAC,CAAmB,CAAA;AACvB,CAAC"}

package/transpiled/directives/io/lib/throttle/Keys.d.ts

@@ -0,0 +1,14 @@
+import { type Component } from './components/index.js';
+import { type Condition } from './conditions/index.js';
+import type { KeyComponent, KeyCondition } from './Configuration.js';
+import type { Parameter } from '../../../../RTD/index.js';
+import type { Input as Context, Output } from '../../../../io.js';
+export declare class Keys {
+    private readonly components;
+    private readonly conditions?;
+    constructor(components: Component[], conditions?: Condition[]);
+    static create(componentRules: KeyComponent[], conditionRules?: KeyCondition[], route?: string): Keys;
+    /** The key of the request, or nothing when a component cannot key it. */
+    get(context: Context, parameters?: Parameter[]): string | undefined;
+    matches(input: Context, output: Output): boolean;
+}

package/transpiled/directives/io/lib/throttle/Keys.js

@@ -0,0 +1,32 @@
+import { createHash } from 'node:crypto';
+import { Components } from './components/index.js';
+import { Conditions } from './conditions/index.js';
+const NONE = [];
+export class Keys {
+    components;
+    conditions;
+    constructor(components, conditions) {
+        this.components = components;
+        this.conditions = conditions;
+    }
+    static create(componentRules, conditionRules, route = '') {
+        const components = componentRules.map((rule) => new Components[rule.method](rule.options, route));
+        const conditions = conditionRules?.map((rule) => new Conditions[rule.method](rule.options));
+        return new this(components, conditions);
+    }
+    /** The key of the request, or nothing when a component cannot key it. */
+    get(context, parameters = NONE) {
+        const hash = createHash('sha256');
+        for (const component of this.components) {
+            const part = component.get(context, parameters);
+            if (part === undefined)
+                return;
+            hash.update(part);
+        }
+        return hash.digest('hex');
+    }
+    matches(input, output) {
+        return this.conditions?.some((condition) => !condition.match(input, output)) !== true;
+    }
+}
+//# sourceMappingURL=Keys.js.map

package/transpiled/directives/io/lib/throttle/Keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Keys.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAkB,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAE,UAAU,EAAkB,MAAM,uBAAuB,CAAA;AAKlE,MAAM,IAAI,GAAgB,EAAE,CAAA;AAE5B,MAAM,OAAO,IAAI;IACE,UAAU,CAAa;IACvB,UAAU,CAAc;IAEzC,YAAmB,UAAuB,EAAE,UAAwB;QAClE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAEM,MAAM,CAAC,MAAM,CAClB,cAA8B,EAC9B,cAA+B,EAC/B,QAAgB,EAAE;QAElB,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CACnC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAC3D,CAAA;QAED,MAAM,UAAU,GAAG,cAAc,EAAE,GAAG,CACpC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CACpD,CAAA;QAED,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IACzC,CAAC;IAED,yEAAyE;IAClE,GAAG,CAAC,OAAgB,EAAE,aAA0B,IAAI;QACzD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;QAEjC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;YAE/C,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAM;YAE9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACnB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAEM,OAAO,CAAC,KAAc,EAAE,MAAc;QAC3C,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,CAAA;IACvF,CAAC;CACF"}

package/transpiled/directives/io/lib/throttle/Quotas.d.ts

@@ -0,0 +1,70 @@
+import { Keys } from './Keys.js';
+import type { Batch } from './Sync.js';
+import type { Configuration } from './Configuration.js';
+import type { Parameter } from '../../../../RTD/index.js';
+import type { Input as Context, Output } from '../../../../io.js';
+/**
+ * A quota per key, metered by GCRA, decided in this process and shared with the others.
+ *
+ * The state of a key is one theoretical arrival time: the moment the key would be back
+ * at zero if nothing more arrived. An admitted request pushes it `emission` further out,
+ * time drags it back, and a request is admitted while it stays within `capacity` of now.
+ * So `requests` is what a key may spend at once, and `requests / interval` what it earns
+ * back — no window to burst across the edge of, and no lockout to time out of.
+ *
+ * Deciding needs nothing but the local map, which is what keeps the request path free of
+ * I/O. What the other gateways have spent arrives on {@link Sync}'s tick, as a debt in
+ * milliseconds — a duration, so it carries across processes without their clocks having
+ * to agree, and additive, which is what lets each process report only its own increments.
+ */
+export declare class Quotas {
+    /** How often the debt is worth reconciling with the other gateways, in milliseconds. */
+    readonly period: number;
+    /** Milliseconds of debt an admitted request adds, `interval / requests`. */
+    private readonly emission;
+    /** Debt a key may carry before it is refused, `interval` — a burst of `requests`. */
+    private readonly capacity;
+    private readonly keys;
+    private readonly prefix;
+    private readonly conditional;
+    private readonly entries;
+    /**
+     * The key computed at precall, for settle to charge against.
+     *
+     * `segment` reads the route parameters, which settle is not given, and `identity`
+     * can be refreshed between the two — so recomputing there would key a request
+     * differently than it was checked, and throttling would quietly stop working.
+     */
+    private readonly keyed;
+    constructor(options: Options);
+    static create(configuration: Configuration, route?: string): Quotas;
+    /**
+     * Seconds to wait before the request would be admitted, or zero when it is.
+     *
+     * Charges here when nothing conditions the count, so that the request is metered by
+     * the same call that admits it; otherwise only the response can tell whether it counts,
+     * and {@link use} charges once it can.
+     */
+    check(context: Context, parameters: Parameter[]): number;
+    /** Charges what the condition accepts, once the response can be matched against it. */
+    use(input: Context, output: Output): void;
+    /**
+     * Adds what is worth reporting to the batch, and drops what has gone quiet.
+     *
+     * The debt is not cleared here but in {@link settled}, so a tick that fails to reach
+     * Redis leaves it to be reported by the next one instead of losing it.
+     */
+    flush(now: number, batch: Batch[]): void;
+    /** Takes the group's debt back, and clears what this process contributed to it. */
+    settled(reported: Batch, debt: number, now: number): void;
+    name(key: string): string;
+    private charge;
+}
+export interface Options {
+    keys: Keys;
+    requests: number;
+    interval: number;
+    conditional: boolean;
+    /** what the keys are reported under, in place of the budget they carry */
+    name?: string;
+}

package/transpiled/directives/io/lib/throttle/Quotas.js

@@ -0,0 +1,142 @@
+import { Keys } from './Keys.js';
+/**
+ * A quota per key, metered by GCRA, decided in this process and shared with the others.
+ *
+ * The state of a key is one theoretical arrival time: the moment the key would be back
+ * at zero if nothing more arrived. An admitted request pushes it `emission` further out,
+ * time drags it back, and a request is admitted while it stays within `capacity` of now.
+ * So `requests` is what a key may spend at once, and `requests / interval` what it earns
+ * back — no window to burst across the edge of, and no lockout to time out of.
+ *
+ * Deciding needs nothing but the local map, which is what keeps the request path free of
+ * I/O. What the other gateways have spent arrives on {@link Sync}'s tick, as a debt in
+ * milliseconds — a duration, so it carries across processes without their clocks having
+ * to agree, and additive, which is what lets each process report only its own increments.
+ */
+export class Quotas {
+    /** How often the debt is worth reconciling with the other gateways, in milliseconds. */
+    period;
+    /** Milliseconds of debt an admitted request adds, `interval / requests`. */
+    emission;
+    /** Debt a key may carry before it is refused, `interval` — a burst of `requests`. */
+    capacity;
+    keys;
+    prefix;
+    conditional;
+    entries = new Map();
+    /**
+     * The key computed at precall, for settle to charge against.
+     *
+     * `segment` reads the route parameters, which settle is not given, and `identity`
+     * can be refreshed between the two — so recomputing there would key a request
+     * differently than it was checked, and throttling would quietly stop working.
+     */
+    keyed = new WeakMap();
+    constructor(options) {
+        this.keys = options.keys;
+        this.conditional = options.conditional;
+        this.emission = options.interval / options.requests;
+        this.capacity = options.interval;
+        this.period = period(options.interval);
+        // a key means one budget, so quotas that do not share one must not share a key
+        this.prefix =
+            options.name === undefined
+                ? `t:${options.requests}:${options.interval}:`
+                : `${options.name}:`;
+    }
+    static create(configuration, route = '') {
+        const { requests, interval, condition } = configuration;
+        const keys = Keys.create(configuration.key, condition, route);
+        return new this({ keys, requests, interval, conditional: condition !== undefined });
+    }
+    /**
+     * Seconds to wait before the request would be admitted, or zero when it is.
+     *
+     * Charges here when nothing conditions the count, so that the request is metered by
+     * the same call that admits it; otherwise only the response can tell whether it counts,
+     * and {@link use} charges once it can.
+     */
+    check(context, parameters) {
+        const key = this.keys.get(context, parameters);
+        // a request that cannot be keyed is not metered
+        if (key === undefined)
+            return 0;
+        this.keyed.set(context, key);
+        const now = Date.now();
+        const entry = this.entries.get(key);
+        const tat = Math.max(entry?.tat ?? now, now);
+        const admit = tat + this.emission - this.capacity;
+        if (admit > now)
+            return Math.ceil((admit - now) / 1000);
+        if (!this.conditional)
+            this.charge(key, entry, tat);
+        return 0;
+    }
+    /** Charges what the condition accepts, once the response can be matched against it. */
+    use(input, output) {
+        if (!this.conditional || !this.keys.matches(input, output))
+            return;
+        // precall always runs first, and a request it refuses never reaches settle
+        const key = this.keyed.get(input) ?? this.keys.get(input);
+        if (key === undefined)
+            return;
+        const now = Date.now();
+        const entry = this.entries.get(key);
+        const tat = Math.max(entry?.tat ?? now, now);
+        this.charge(key, entry, tat);
+    }
+    /**
+     * Adds what is worth reporting to the batch, and drops what has gone quiet.
+     *
+     * The debt is not cleared here but in {@link settled}, so a tick that fails to reach
+     * Redis leaves it to be reported by the next one instead of losing it.
+     */
+    flush(now, batch) {
+        for (const [key, entry] of this.entries) {
+            const delta = Math.round(entry.debt);
+            if (delta > 0) {
+                batch.push({ quotas: this, key, delta });
+                continue;
+            }
+            // out of debt and with nothing left to report, a key says no more than an absent one
+            if (entry.tat <= now)
+                this.entries.delete(key);
+        }
+    }
+    /** Takes the group's debt back, and clears what this process contributed to it. */
+    settled(reported, debt, now) {
+        const entry = this.entries.get(reported.key);
+        if (entry === undefined) {
+            if (debt > 0)
+                this.entries.set(reported.key, { tat: now + debt, debt: 0 });
+            return;
+        }
+        entry.debt -= reported.delta;
+        // the group has spent at least what this process has, so its debt is the one to keep
+        entry.tat = Math.max(entry.tat, now + debt);
+    }
+    name(key) {
+        return this.prefix + key;
+    }
+    charge(key, entry, tat) {
+        if (entry === undefined)
+            this.entries.set(key, { tat: tat + this.emission, debt: this.emission });
+        else {
+            entry.tat = tat + this.emission;
+            entry.debt += this.emission;
+        }
+    }
+}
+/**
+ * How often to reconcile, in milliseconds.
+ *
+ * Reconciling is what bounds the overshoot — between two ticks a gateway is going on
+ * what it alone has spent — so it is worth doing an order of magnitude more often than
+ * the interval, within reason on either end.
+ */
+function period(interval) {
+    return Math.min(Math.max(interval / 10, MIN_PERIOD), MAX_PERIOD);
+}
+const MIN_PERIOD = 250;
+const MAX_PERIOD = 2000;
+//# sourceMappingURL=Quotas.js.map

package/transpiled/directives/io/lib/throttle/Quotas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Quotas.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Quotas.ts"],"names":[],"mappings":"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"}

package/transpiled/directives/io/lib/throttle/Sync.d.ts

@@ -0,0 +1,29 @@
+import type { Quotas } from './Quotas.js';
+import type { atomicity } from '@toa.io/core/types';
+/**
+ * Reconciles every quota of the process with the other gateways, on one tick.
+ *
+ * Nothing here is on the request path. Each tick takes what the quotas have spent since
+ * the last one and sends all of it as a single call, so the cost of staying in step is
+ * one round trip a tick — not one per key, and not one per directive. What comes back is
+ * the debt the whole group has reached, which the quotas then decide on locally.
+ */
+export declare class Sync {
+    private readonly atom;
+    private readonly quotas;
+    private timer;
+    private period;
+    /** Ticks do not overlap: a slow round trip delays reconciling, it does not double it. */
+    private reconciling;
+    constructor(atom: atomicity.Atom);
+    register(quotas: Quotas): void;
+    dispose(): void;
+    private start;
+    private readonly tick;
+    private reconcile;
+}
+export interface Batch {
+    quotas: Quotas;
+    key: string;
+    delta: number;
+}