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

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

@@ -4,10 +4,12 @@ export declare class Output implements Directive {
     private readonly disabled;
     private readonly omitted;
     private readonly permissions;
+    private readonly allowed;
     constructor(permissions: Permissions);
     static validate(permissions: unknown): asserts permissions is Permissions;
     preflight(context: Context): void;
     private restriction;
+    /** Runs per entity of a collection, hence the set and the absence of intermediates. */
     private fit;
 }
 export type Permissions = string[] | boolean;

package/transpiled/directives/io/Output.js

@@ -31,6 +31,7 @@ class Output {
     disabled = false;
     omitted = true;
     permissions = [];
+    allowed;
     constructor(permissions) {
         if (typeof permissions === 'boolean')
             if (permissions)
@@ -39,6 +40,7 @@ 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');
@@ -66,10 +68,14 @@ class Output {
                 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;

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,uCAAkC;AAClC,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,SAAS,CAAE,OAAgB;QAChC,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,kBAAO,CAAC,IAAI,CAAC,4EAA4E,EACvF,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;gBAEnC,OAAO,OAAO,CAAC,IAAI,CAAA;gBAEnB,OAAM;YACR,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAU,OAAO,CAAC,IAAI,EAC5C,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,MAAiB,CAAC,CAAC,CAAA;;gBAExE,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,6CAAoC;AACpC,uCAAkC;AAClC,mDAAoC;AAMpC,MAAa,MAAM;IACA,QAAQ,GAAY,KAAK,CAAA;IACzB,OAAO,GAAY,IAAI,CAAA;IACvB,WAAW,GAAa,EAAE,CAAA;IAC1B,OAAO,CAAa;IAErC,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;QAEhC,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC1C,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAE,WAAoB;QAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAA;IACxE,CAAC;IAEM,SAAS,CAAE,OAAgB;QAChC,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,kBAAO,CAAC,IAAI,CAAC,4EAA4E,EACvF,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;gBAEnC,OAAO,OAAO,CAAC,IAAI,CAAA;gBAEnB,OAAM;YACR,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAU,OAAO,CAAC,IAAI,EAC5C,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,MAAiB,CAAC,CAAC,CAAA;;gBAExE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC;IAED,uFAAuF;IAC/E,GAAG,CAAE,OAAgB;QAC3B,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;gBACvB,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAE9B,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAnED,wBAmEC"}

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

@@ -1,13 +1,11 @@
-import { type Declaration } from './lib/throttle';
-import type { Remote } from '@toa.io/core';
+import { type Declaration, type Sync } from './lib/throttle';
 import type * as http from '../../HTTP';
 import type { Parameter } from '../../RTD';
 import type { Directive } from './Directive';
 export declare class Throttle implements Directive {
     private readonly quotas;
-    constructor(declaration: Declaration, counter: Promise<Remote>, route: string);
+    constructor(declaration: Declaration, sync: Sync, route: string);
     static validate(declaration: unknown): asserts declaration is Declaration;
     preflight(context: http.Context, parameters: Parameter[]): void;
-    settle(context: http.Context, output: http.OutgoingMessage): Promise<void>;
-    dispose(): void;
+    settle(context: http.Context, output: http.OutgoingMessage): void;
 }

package/transpiled/directives/io/Throttle.js

@@ -29,22 +29,20 @@ const schemas = __importStar(require("./schemas"));
 const throttle_1 = require("./lib/throttle");
 class Throttle {
     quotas;
-    constructor(declaration, counter, route) {
-        const configuration = (0, throttle_1.parse)(declaration);
-        this.quotas = throttle_1.Quotas.create(configuration, counter, route);
+    constructor(declaration, sync, route) {
+        this.quotas = throttle_1.Quotas.create((0, throttle_1.parse)(declaration), route);
+        sync.register(this.quotas);
     }
     static validate(declaration) {
         schemas.throttle.validate(declaration, 'Incorrect \'io:throttle\' format');
     }
     preflight(context, parameters) {
-        if (!this.quotas.ok(context, parameters))
-            throw new HTTP_1.TooManyRequests();
+        const retry = this.quotas.check(context, parameters);
+        if (retry > 0)
+            throw new HTTP_1.TooManyRequests(retry);
     }
-    async settle(context, output) {
-        await this.quotas.use(context, output);
-    }
-    dispose() {
-        this.quotas.dispose();
+    settle(context, output) {
+        this.quotas.use(context, output);
     }
 }
 exports.Throttle = Throttle;

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

@@ -1 +1 @@
-{"version":3,"file":"Throttle.js","sourceRoot":"","sources":["../../../source/directives/io/Throttle.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAA4C;AAC5C,mDAAoC;AACpC,6CAAgE;AAMhE,MAAa,QAAQ;IACF,MAAM,CAAQ;IAE/B,YAAoB,WAAwB,EAAE,OAAwB,EAAE,KAAa;QACnF,MAAM,aAAa,GAAG,IAAA,gBAAK,EAAC,WAAW,CAAC,CAAA;QAExC,IAAI,CAAC,MAAM,GAAG,iBAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC5D,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAE,WAAoB;QAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAA;IAC5E,CAAC;IAEM,SAAS,CAAE,OAAqB,EAAE,UAAuB;QAC9D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;YACtC,MAAM,IAAI,sBAAe,EAAE,CAAA;IAC/B,CAAC;IAEM,KAAK,CAAC,MAAM,CAAE,OAAqB,EAAE,MAA4B;QACtE,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACxC,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;IACvB,CAAC;CACF;AAzBD,4BAyBC"}
+{"version":3,"file":"Throttle.js","sourceRoot":"","sources":["../../../source/directives/io/Throttle.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAA4C;AAC5C,mDAAoC;AACpC,6CAA2E;AAK3E,MAAa,QAAQ;IACF,MAAM,CAAQ;IAE/B,YAAoB,WAAwB,EAAE,IAAU,EAAE,KAAa;QACrE,IAAI,CAAC,MAAM,GAAG,iBAAM,CAAC,MAAM,CAAC,IAAA,gBAAK,EAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAA;QAEtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAE,WAAoB;QAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAA;IAC5E,CAAC;IAEM,SAAS,CAAE,OAAqB,EAAE,UAAuB;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;QAEpD,IAAI,KAAK,GAAG,CAAC;YACX,MAAM,IAAI,sBAAe,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAEM,MAAM,CAAE,OAAqB,EAAE,MAA4B;QAChE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;CACF;AAvBD,4BAuBC"}

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

@@ -3,7 +3,6 @@ export interface Configuration {
     condition?: KeyCondition[];
     requests: number;
     interval: number;
-    cooldown: number;
 }
 interface Rule<T, K = unknown> {
     method: T;

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

@@ -2,13 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parse = void 0;
 function parse(declaration) {
-    const { key, condition, requests, interval, cooldown } = declaration;
+    const { key, condition, requests, interval } = declaration;
     return {
         key: mapKey(key),
         condition: mapCondition(condition),
         requests,
-        interval: interval * 1000,
-        cooldown: cooldown * 1000
+        interval: interval * 1000
     };
 }
 exports.parse = parse;

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

@@ -1 +1 @@
-{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Configuration.ts"],"names":[],"mappings":";;;AAgCA,SAAgB,KAAK,CAAE,WAAwB;IAC7C,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAA;IAEpE,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;QAChB,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;QAClC,QAAQ;QACR,QAAQ,EAAE,QAAQ,GAAG,IAAI;QACzB,QAAQ,EAAE,QAAQ,GAAG,IAAI;KAC1B,CAAA;AACH,CAAC;AAVD,sBAUC;AAED,SAAS,MAAM,CAAE,WAA2B;IAC1C,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,CAChD,CAAC,EAAE,MAAM,EAAE,MAA4B,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,SAAS,YAAY,CAAE,WAAkC;IACvD,IAAI,WAAW,KAAK,SAAS;QAC3B,OAAM;IAER,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,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAmB,CAAA;AACnG,CAAC"}
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Configuration.ts"],"names":[],"mappings":";;;AA+BA,SAAgB,KAAK,CAAE,WAAwB;IAC7C,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;AATD,sBASC;AAED,SAAS,MAAM,CAAE,WAA2B;IAC1C,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,CAChD,CAAC,EAAE,MAAM,EAAE,MAA4B,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,SAAS,YAAY,CAAE,WAAkC;IACvD,IAAI,WAAW,KAAK,SAAS;QAC3B,OAAM;IAER,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,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAmB,CAAA;AACnG,CAAC"}

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

@@ -1,45 +1,69 @@
 import { Keys } from './Keys';
-import type { Remote } from '@toa.io/core';
+import type { Batch } from './Sync';
 import type { Configuration } from './Configuration';
 import type { Parameter } from '../../../../RTD';
 import type { Input as Context, Output } from '../../../../io';
 /**
- * Quota usage counted across every gateway process, and blocking decided in this one.
+ * A quota per key, metered by GCRA, decided in this process and shared with the others.
  *
- * The count comes from the `exposition.stash` component, which counts through Redis
- * and hands back a lower bound on what the whole group has reached. Blocking stays
- * local: every process sees the same number and reaches the same conclusion on its
- * own, and a process that cannot reach Redis still enforces what it has seen itself.
+ * 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 {
-    private readonly requests;
-    private readonly interval;
-    private readonly cooldown;
+    /** 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 counter;
-    private readonly blocked;
-    private readonly timers;
+    private readonly prefix;
+    private readonly conditional;
+    private readonly entries;
     /**
-     * The key computed at preflight, for settle to count against.
+     * The key computed at preflight, 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 blocking would quietly stop working.
+     * differently than it was checked, and throttling would quietly stop working.
      */
     private readonly keyed;
-    private remote;
     constructor(options: Options);
-    static create(configuration: Configuration, counter: Promise<Remote>, route?: string): Quotas;
-    ok(context: Context, parameters: Parameter[]): boolean;
-    use(input: Context, output: Output): Promise<void>;
-    dispose(): void;
-    private block;
+    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;
 }
 interface Options {
     keys: Keys;
     requests: number;
     interval: number;
-    cooldown: number;
-    counter: Promise<Remote>;
+    conditional: boolean;
 }
 export {};

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

@@ -1,77 +1,138 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Quotas = void 0;
-const openspan_1 = require("openspan");
 const Keys_1 = require("./Keys");
 /**
- * Quota usage counted across every gateway process, and blocking decided in this one.
+ * A quota per key, metered by GCRA, decided in this process and shared with the others.
  *
- * The count comes from the `exposition.stash` component, which counts through Redis
- * and hands back a lower bound on what the whole group has reached. Blocking stays
- * local: every process sees the same number and reaches the same conclusion on its
- * own, and a process that cannot reach Redis still enforces what it has seen itself.
+ * 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.
  */
 class Quotas {
-    requests;
-    interval;
-    cooldown;
+    /** 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;
-    counter;
-    blocked = {};
-    timers = new Set();
+    prefix;
+    conditional;
+    entries = new Map();
     /**
-     * The key computed at preflight, for settle to count against.
+     * The key computed at preflight, 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 blocking would quietly stop working.
+     * differently than it was checked, and throttling would quietly stop working.
      */
     keyed = new WeakMap();
-    remote = null;
     constructor(options) {
-        this.requests = options.requests;
-        this.interval = options.interval;
-        this.cooldown = options.cooldown;
         this.keys = options.keys;
-        this.counter = options.counter;
+        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 = `t:${options.requests}:${options.interval}:`;
     }
-    static create(configuration, counter, route = '') {
-        const { requests, interval, cooldown } = configuration;
-        const keys = Keys_1.Keys.create(configuration.key, configuration.condition, route);
-        return new this({ requests, interval, cooldown, keys, counter });
+    static create(configuration, route = '') {
+        const { requests, interval, condition } = configuration;
+        const keys = Keys_1.Keys.create(configuration.key, condition, route);
+        return new this({ keys, requests, interval, conditional: condition !== undefined });
     }
-    ok(context, parameters) {
+    /**
+     * 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);
         this.keyed.set(context, key);
-        return this.blocked[key] !== true;
+        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;
     }
-    async use(input, output) {
-        if (!this.keys.matches(input, output))
+    /** 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;
-        // preflight always runs first, and a request it throws on never reaches settle
+        // preflight always runs first, and a request it refuses never reaches settle
         const key = this.keyed.get(input) ?? this.keys.get(input);
-        this.remote ??= await this.counter;
-        const count = await this.remote.invoke('count', { input: { name: key, interval: this.interval, amount: 1 } });
-        if (count >= this.requests)
-            this.block(key);
+        const now = Date.now();
+        const entry = this.entries.get(key);
+        const tat = Math.max(entry?.tat ?? now, now);
+        this.charge(key, entry, tat);
     }
-    dispose() {
-        for (const timer of this.timers)
-            clearTimeout(timer);
-        this.timers.clear();
+    /**
+     * 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);
+        }
     }
-    block(key) {
-        if (this.blocked[key] === true)
+    /** 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;
-        this.blocked[key] = true;
-        const timer = setTimeout(() => {
-            delete this.blocked[key];
-            this.timers.delete(timer);
-        }, this.cooldown);
-        timer.unref();
-        this.timers.add(timer);
-        openspan_1.console.info('Quota exceeded, key blocked', { key, cooldown: this.cooldown });
+        }
+        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;
+        }
     }
 }
 exports.Quotas = Quotas;
+/**
+ * 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

@@ -1 +1 @@
-{"version":3,"file":"Quotas.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Quotas.ts"],"names":[],"mappings":"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"}
+{"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,30 @@
+import type { Quotas } from './Quotas';
+import type { Remote } from '@toa.io/core';
+/**
+ * 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 stash;
+    private readonly quotas;
+    private remote;
+    private timer;
+    private period;
+    /** Ticks do not overlap: a slow round trip delays reconciling, it does not double it. */
+    private reconciling;
+    constructor(stash: Promise<Remote>);
+    register(quotas: Quotas): void;
+    dispose(): void;
+    private start;
+    private readonly tick;
+    private reconcile;
+}
+export interface Batch {
+    quotas: Quotas;
+    key: string;
+    delta: number;
+}

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

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sync = void 0;
+const openspan_1 = require("openspan");
+/**
+ * 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.
+ */
+class Sync {
+    stash;
+    quotas = [];
+    remote = null;
+    timer = null;
+    period = Infinity;
+    /** Ticks do not overlap: a slow round trip delays reconciling, it does not double it. */
+    reconciling = false;
+    constructor(stash) {
+        this.stash = stash;
+    }
+    register(quotas) {
+        this.quotas.push(quotas);
+        // the shortest interval sets the pace, and reconciling the others more often than
+        // they asked for only makes them more accurate — an idle quota contributes nothing
+        if (quotas.period < this.period) {
+            this.period = quotas.period;
+            this.start();
+        }
+    }
+    dispose() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    start() {
+        this.dispose();
+        this.timer = setInterval(this.tick, this.period);
+        this.timer.unref();
+    }
+    tick = () => {
+        if (this.reconciling)
+            return;
+        const now = Date.now();
+        const batch = [];
+        for (const quotas of this.quotas)
+            quotas.flush(now, batch);
+        if (batch.length === 0)
+            return;
+        this.reconciling = true;
+        void this.reconcile(batch).finally(() => {
+            this.reconciling = false;
+        });
+    };
+    async reconcile(batch) {
+        try {
+            this.remote ??= await this.stash;
+            const keys = batch.map((entry) => entry.quotas.name(entry.key));
+            const deltas = batch.map((entry) => entry.delta);
+            const debts = await this.remote.invoke('meter', { input: { keys, deltas } });
+            const now = Date.now();
+            for (let i = 0; i < batch.length; i++)
+                batch[i].quotas.settled(batch[i], debts[i], now);
+        }
+        catch (error) {
+            // what was not reported stays to be reported by the next tick, and until then
+            // this gateway keeps throttling on what it alone has seen, and keeps serving
+            openspan_1.console.warn('Throttling could not reconcile with the group', error);
+        }
+    }
+}
+exports.Sync = Sync;
+//# sourceMappingURL=Sync.js.map

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

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

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

@@ -1,2 +1,3 @@
 export { Quotas } from './Quotas';
+export { Sync } from './Sync';
 export { parse, type Configuration, type Declaration } from './Configuration';

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

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parse = exports.Quotas = void 0;
+exports.parse = exports.Sync = exports.Quotas = void 0;
 var Quotas_1 = require("./Quotas");
 Object.defineProperty(exports, "Quotas", { enumerable: true, get: function () { return Quotas_1.Quotas; } });
+var Sync_1 = require("./Sync");
+Object.defineProperty(exports, "Sync", { enumerable: true, get: function () { return Sync_1.Sync; } });
 var Configuration_1 = require("./Configuration");
 Object.defineProperty(exports, "parse", { enumerable: true, get: function () { return Configuration_1.parse; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/index.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAAxB,gGAAA,MAAM,OAAA;AACf,iDAA6E;AAApE,sGAAA,KAAK,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/index.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAAxB,gGAAA,MAAM,OAAA;AACf,+BAA6B;AAApB,4FAAA,IAAI,OAAA;AACb,iDAA6E;AAApE,sGAAA,KAAK,OAAA"}