@toa.io/extensions.exposition 1.0.0-alpha.2 → 1.0.0-alpha.200

package/transpiled/directives/flow/Flow.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Flow = void 0;
+const Fetch_1 = require("./Fetch");
+const Compose_1 = require("./Compose");
+class Flow {
+    name = 'flow';
+    mandatory = false;
+    create(name, value, remotes) {
+        const Class = constructors[name];
+        if (Class === undefined)
+            throw new Error(`Directive '${this.name}:${name}' is not implemented`);
+        return new Class(value, remotes);
+    }
+    async preflight(directives, input, parameters) {
+        for (const directive of directives) {
+            if (directive.attach !== undefined)
+                directive.attach(input);
+            if (directive.apply === undefined)
+                continue;
+            const output = await directive.apply(input, parameters);
+            if (output !== null)
+                return output;
+        }
+        return null;
+    }
+}
+exports.Flow = Flow;
+const constructors = {
+    fetch: Fetch_1.Fetch,
+    compose: Compose_1.Compose
+};
+//# sourceMappingURL=Flow.js.map

package/transpiled/directives/flow/Flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flow.js","sourceRoot":"","sources":["../../../source/directives/flow/Flow.ts"],"names":[],"mappings":";;;AAAA,mCAA+B;AAC/B,uCAAmC;AAMnC,MAAa,IAAI;IACC,IAAI,GAAW,MAAM,CAAA;IACrB,SAAS,GAAY,KAAK,CAAA;IAEnC,MAAM,CAAE,IAAY,EAAE,KAAc,EAAE,OAAgB;QAC3D,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,IAAI,IAAI,sBAAsB,CAAC,CAAA;QAExE,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,UAAuB,EAAE,KAAY,EAAE,UAAuB;QACpF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;gBAChC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAEzB,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;gBAC/B,SAAQ;YAEV,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;YAEvD,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AA7BD,oBA6BC;AAED,MAAM,YAAY,GAAsE;IACtF,KAAK,EAAE,aAAK;IACZ,OAAO,EAAE,iBAAO;CACjB,CAAA"}

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

@@ -0,0 +1,2 @@
+import { Flow } from './Flow';
+export declare const flow: Flow;

package/transpiled/directives/flow/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flow = void 0;
+const Flow_1 = require("./Flow");
+exports.flow = new Flow_1.Flow();
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/flow/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6B;AAEhB,QAAA,IAAI,GAAG,IAAI,WAAI,EAAE,CAAA"}

package/transpiled/directives/flow/types.d.ts

@@ -0,0 +1,6 @@
+import type { Input as Context, Input, Output } from '../../io';
+import type { Parameter } from '../../RTD';
+export interface Directive {
+    apply?: (input: Input, parameters: Parameter[]) => Promise<Output>;
+    attach?: (context: Context) => void;
+}

package/transpiled/directives/flow/types.js.map

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

package/transpiled/directives/index.d.ts

@@ -1,4 +1,4 @@
-import type { Family } from '../Directive';
+import type { DirectiveFamily } from '../RTD';
 import type { Interceptor } from '../Interception';
-export declare const families: Family[];
+export declare const families: DirectiveFamily[];
 export declare const interceptors: Interceptor[];

package/transpiled/directives/index.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.interceptors = exports.families = void 0;
-const dev_1 = require("./dev");
 const auth_1 = require("./auth");
 const cache_1 = require("./cache");
-const octets_1 = require("./octets");
 const cors_1 = require("./cors");
-const vary_1 = require("./vary");
-exports.families = [auth_1.authorization, cache_1.cache, octets_1.octets, vary_1.vary, dev_1.dev];
+const dev_1 = require("./dev");
+const octets_1 = require("./octets");
+const io_1 = require("./io");
+const map_1 = require("./map");
+const require_1 = require("./require");
+const flow_1 = require("./flow");
+exports.families = [auth_1.authorization, io_1.io, cache_1.cache, map_1.map, require_1.req, flow_1.flow, octets_1.octets, dev_1.dev];
 exports.interceptors = [cors_1.cors];
 //# sourceMappingURL=index.js.map

package/transpiled/directives/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/directives/index.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAC3B,iCAAsC;AACtC,mCAA+B;AAC/B,qCAAiC;AACjC,iCAA6B;AAC7B,iCAA6B;AAIhB,QAAA,QAAQ,GAAa,CAAC,oBAAa,EAAE,aAAK,EAAE,eAAM,EAAE,WAAI,EAAE,SAAG,CAAC,CAAA;AAC9D,QAAA,YAAY,GAAkB,CAAC,WAAI,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/directives/index.ts"],"names":[],"mappings":";;;AAAA,iCAAsC;AACtC,mCAA+B;AAC/B,iCAA6B;AAC7B,+BAA2B;AAC3B,qCAAiC;AACjC,6BAAyB;AACzB,+BAA2B;AAC3B,uCAA+B;AAC/B,iCAA6B;AAIhB,QAAA,QAAQ,GAAsB,CAAC,oBAAa,EAAE,OAAE,EAAE,aAAK,EAAE,SAAG,EAAE,aAAG,EAAE,WAAI,EAAE,eAAM,EAAE,SAAG,CAAC,CAAA;AACrF,QAAA,YAAY,GAAkB,CAAC,WAAI,CAAC,CAAA"}

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

@@ -0,0 +1,11 @@
+import type { Input as Context } from '../../io';
+import type * as http from '../../HTTP';
+export interface Directive {
+    preflight: (context: Context) => void;
+    settle?: (context: Context, response: http.OutgoingMessage) => Promise<void> | void;
+    dispose?: () => void;
+}
+export interface Constructor {
+    validate: (value: unknown) => void;
+    new (value: any): Directive;
+}

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

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

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

@@ -0,0 +1,11 @@
+import type * as http from '../../HTTP';
+import type { Directive } from './Directive';
+import type { DirectiveFamily } from '../../RTD';
+export declare class IO implements DirectiveFamily<Directive> {
+    readonly name = "io";
+    readonly mandatory = true;
+    create(name: string, value: unknown): Directive;
+    preflight(directives: Directive[], context: http.Context): null;
+    settle(directives: Directive[], context: http.Context, output: http.OutgoingMessage): Promise<void>;
+    dispose(directives: Directive[]): void;
+}

package/transpiled/directives/io/IO.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IO = void 0;
+const Output_1 = require("./Output");
+const Input_1 = require("./Input");
+const Throttle_1 = require("./Throttle");
+class IO {
+    name = 'io';
+    mandatory = true;
+    create(name, value) {
+        if (!(name in constructors))
+            throw new Error(`Directive 'io:${name}' is not implemented`);
+        const Directive = constructors[name];
+        Directive.validate(value);
+        return new Directive(value);
+    }
+    preflight(directives, context) {
+        let restricted = false;
+        for (const directive of directives) {
+            restricted ||= directive instanceof Output_1.Output;
+            directive.preflight(context);
+        }
+        if (!restricted)
+            DENIAL.preflight(context);
+        return null;
+    }
+    async settle(directives, context, output) {
+        for (const directive of directives)
+            await directive.settle?.(context, output);
+    }
+    dispose(directives) {
+        for (const directive of directives)
+            directive.dispose?.();
+    }
+}
+exports.IO = IO;
+const constructors = {
+    input: Input_1.Input,
+    output: Output_1.Output,
+    throttle: Throttle_1.Throttle
+};
+const DENIAL = new Output_1.Output([]);
+//# sourceMappingURL=IO.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IO.js","sourceRoot":"","sources":["../../../source/directives/io/IO.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AACjC,mCAA+B;AAC/B,yCAAqC;AAKrC,MAAa,EAAE;IACG,IAAI,GAAG,IAAI,CAAA;IACX,SAAS,GAAG,IAAI,CAAA;IAEzB,MAAM,CAAE,IAAY,EAAE,KAAc;QACzC,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,sBAAsB,CAAC,CAAA;QAE9D,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAEpC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAEzB,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;IAEM,SAAS,CAAE,UAAuB,EAAE,OAAqB;QAC9D,IAAI,UAAU,GAAG,KAAK,CAAA;QAEtB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,UAAU,KAAK,SAAS,YAAY,eAAM,CAAA;YAE1C,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC;QAED,IAAI,CAAC,UAAU;YACb,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAE3B,OAAO,IAAI,CAAA;IACb,CAAC;IAEM,KAAK,CAAC,MAAM,CAAE,UAAuB,EAAE,OAAqB,EAAE,MAA4B;QAC/F,KAAK,MAAM,SAAS,IAAI,UAAU;YAChC,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC7C,CAAC;IAEM,OAAO,CAAE,UAAuB;QACrC,KAAK,MAAM,SAAS,IAAI,UAAU;YAChC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAA;IACzB,CAAC;CACF;AAvCD,gBAuCC;AAED,MAAM,YAAY,GAAgC;IAChD,KAAK,EAAE,aAAK;IACZ,MAAM,EAAE,eAAM;IACd,QAAQ,EAAE,mBAAQ;CACnB,CAAA;AAED,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,EAAE,CAAC,CAAA"}

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

@@ -0,0 +1,11 @@
+import type { Directive } from './Directive';
+import type { Input as Context } from '../../io';
+export declare class Input implements Directive {
+    private readonly permissions;
+    constructor(permissions: Permissions);
+    static validate(permissions: unknown): asserts permissions is Permissions;
+    preflight(context: Context): void;
+    private check;
+    private violation;
+}
+export type Permissions = string[];

package/transpiled/directives/io/Input.js

@@ -0,0 +1,65 @@
+"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.Input = void 0;
+const HTTP_1 = require("../../HTTP");
+const schemas = __importStar(require("./schemas"));
+class Input {
+    permissions;
+    constructor(permissions) {
+        this.permissions = permissions;
+    }
+    static validate(permissions) {
+        schemas.input.validate(permissions, 'Incorrect \'io:input\' format');
+    }
+    preflight(context) {
+        context.pipelines.body.push((body) => this.check(body));
+    }
+    check(body) {
+        if (body === undefined)
+            return body;
+        try {
+            schemas.message.validate(body);
+        }
+        catch {
+            throw new HTTP_1.BadRequest('Invalid request body');
+        }
+        const property = this.violation(body);
+        if (property !== undefined)
+            throw new HTTP_1.BadRequest(`Unexpected input: ${property}`);
+        return body;
+    }
+    violation(value) {
+        if (!Array.isArray(value))
+            return Object.keys(value).find((key) => !this.permissions.includes(key));
+        for (const item of value) {
+            const property = this.violation(item);
+            if (property !== undefined)
+                return property;
+        }
+    }
+}
+exports.Input = Input;
+//# sourceMappingURL=Input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Input.js","sourceRoot":"","sources":["../../../source/directives/io/Input.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAAuC;AACvC,mDAAoC;AAKpC,MAAa,KAAK;IACC,WAAW,CAAa;IAEzC,YAAoB,WAAwB;QAC1C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAChC,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAE,WAAoB;QAC1C,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAc,WAAW,EAAE,+BAA+B,CAAC,CAAA;IACnF,CAAC;IAEM,SAAS,CAAE,OAAgB;QAChC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACzD,CAAC;IAEO,KAAK,CAAE,IAAa;QAC1B,IAAI,IAAI,KAAK,SAAS;YACpB,OAAO,IAAI,CAAA;QAEb,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAsB,IAAI,CAAC,CAAA;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,iBAAU,CAAC,sBAAsB,CAAC,CAAA;QAC9C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAErC,IAAI,QAAQ,KAAK,SAAS;YACxB,MAAM,IAAI,iBAAU,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAA;QAEvD,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,SAAS,CAAE,KAA0B;QAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACvB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;QAE1E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAErC,IAAI,QAAQ,KAAK,SAAS;gBACxB,OAAO,QAAQ,CAAA;QACnB,CAAC;IACH,CAAC;CACF;AA5CD,sBA4CC"}

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

@@ -0,0 +1 @@
+export type Message = Record<string, unknown>;

package/transpiled/directives/io/Message.js

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

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

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

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

@@ -0,0 +1,13 @@
+import type { Directive } from './Directive';
+import type { Input as Context } from '../../io';
+export declare class Output implements Directive {
+    private readonly disabled;
+    private readonly omitted;
+    private readonly permissions;
+    constructor(permissions: Permissions);
+    static validate(permissions: unknown): asserts permissions is Permissions;
+    preflight(context: Context): void;
+    private restriction;
+    private fit;
+}
+export type Permissions = string[] | boolean;

package/transpiled/directives/io/Output.js

@@ -0,0 +1,76 @@
+"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 openspan_1 = require("openspan");
+const schemas = __importStar(require("./schemas"));
+class Output {
+    disabled = false;
+    omitted = true;
+    permissions = [];
+    constructor(permissions) {
+        if (typeof permissions === 'boolean')
+            if (permissions)
+                this.disabled = true;
+            else
+                this.omitted = false;
+        else
+            this.permissions = permissions;
+    }
+    static validate(permissions) {
+        schemas.output.validate(permissions, 'Incorrect \'io:output\' format');
+    }
+    preflight(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;
+            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)
+                    openspan_1.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');
+            if (Array.isArray(message.body))
+                message.body = message.body.map((entity) => this.fit(entity));
+            else
+                message.body = this.fit(message.body);
+        };
+    }
+    fit(message) {
+        const entries = Object.entries(message)
+            .filter(([key]) => this.permissions.includes(key));
+        return Object.fromEntries(entries);
+    }
+}
+exports.Output = Output;
+//# sourceMappingURL=Output.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,11 @@
+import { type Declaration } from './lib/throttle';
+import type * as http from '../../HTTP';
+import type { Directive } from './Directive';
+export declare class Throttle implements Directive {
+    private readonly quotas;
+    constructor(declaration: Declaration);
+    static validate(declaration: unknown): asserts declaration is Declaration;
+    preflight(context: http.Context): void;
+    settle(context: http.Context, output: http.OutgoingMessage): void;
+    dispose(): void;
+}

package/transpiled/directives/{octets/Permute.js → io/Throttle.js}

@@ -23,29 +23,29 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Permute = void 0;
+exports.Throttle = void 0;
 const HTTP_1 = require("../../HTTP");
 const schemas = __importStar(require("./schemas"));
-class Permute {
-    targeted = false;
-    discovery;
-    storage = null;
-    constructor(value, discovery) {
-        schemas.permute.validate(value);
-        this.discovery = discovery;
+const throttle_1 = require("./lib/throttle");
+class Throttle {
+    quotas;
+    constructor(declaration) {
+        const configuration = (0, throttle_1.parse)(declaration);
+        this.quotas = throttle_1.Quotas.create(configuration);
     }
-    async apply(storage, request) {
-        this.storage ??= await this.discovery;
-        if (request.encoder === null)
-            throw new HTTP_1.NotAcceptable();
-        const path = request.url;
-        const list = await request.parse();
-        const input = { storage, path, list };
-        const error = await this.storage.invoke('permute', { input });
-        if (error instanceof Error)
-            throw new HTTP_1.NotFound();
-        return {};
+    static validate(declaration) {
+        schemas.throttle.validate(declaration, 'Incorrect \'io:throttle\' format');
+    }
+    preflight(context) {
+        if (!this.quotas.ok(context))
+            throw new HTTP_1.TooManyRequests();
+    }
+    settle(context, output) {
+        this.quotas.use(context, output);
+    }
+    dispose() {
+        this.quotas.dispose();
     }
 }
-exports.Permute = Permute;
-//# sourceMappingURL=Permute.js.map
+exports.Throttle = Throttle;
+//# 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,qCAA4C;AAC5C,mDAAoC;AACpC,6CAAgE;AAIhE,MAAa,QAAQ;IACF,MAAM,CAAQ;IAE/B,YAAoB,WAAwB;QAC1C,MAAM,aAAa,GAAG,IAAA,gBAAK,EAAC,WAAW,CAAC,CAAA;QAExC,IAAI,CAAC,MAAM,GAAG,iBAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;IAC5C,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;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC;YAC1B,MAAM,IAAI,sBAAe,EAAE,CAAA;IAC/B,CAAC;IAEM,MAAM,CAAE,OAAqB,EAAE,MAA4B;QAChE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;IACvB,CAAC;CACF;AAzBD,4BAyBC"}

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

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

package/transpiled/directives/io/index.js

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+export interface Configuration {
+    key: KeyComponent[];
+    condition?: KeyCondition[];
+    requests: number;
+    interval: number;
+    cooldown: number;
+}
+interface Rule<T, K = unknown> {
+    method: T;
+    options?: K;
+}
+export type KeyComponentMethod = 'ip' | 'path';
+export type KeyConditionMethod = 'status';
+export type KeyComponent = Rule<KeyComponentMethod>;
+export type KeyCondition = Rule<KeyConditionMethod>;
+type KeyDeclaration = KeyComponentMethod | KeyComponentMethod[];
+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,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = void 0;
+function parse(declaration) {
+    const { key, condition, requests, interval, cooldown } = declaration;
+    return {
+        key: mapKey(key),
+        condition: mapCondition(condition),
+        requests,
+        interval: interval * 1000,
+        cooldown: cooldown * 1000
+    };
+}
+exports.parse = parse;
+function mapKey(declaration) {
+    const methods = Array.isArray(declaration) ? declaration : [declaration];
+    return methods.map((method) => ({ method }));
+}
+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":";;;AA8BA,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,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;AAC9C,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/Interval.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+import { EventEmitter } from 'node:events';
+export declare class Interval extends EventEmitter {
+    number: number;
+    private interval;
+    constructor(interval: number);
+    start(interval: number): void;
+    dispose(): void;
+}

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

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Interval = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_events_1 = require("node:events");
+class Interval extends node_events_1.EventEmitter {
+    number = 0;
+    interval = null;
+    constructor(interval) {
+        super();
+        const number = Math.ceil(Date.now() / interval);
+        const shift = number * interval - Date.now();
+        node_assert_1.default.ok(shift >= 0, 'shift must be positive');
+        setTimeout(() => this.start(interval), shift);
+    }
+    start(interval) {
+        this.interval = setInterval(() => this.emit('tick'), interval);
+    }
+    dispose() {
+        if (this.interval !== null) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        this.removeAllListeners();
+    }
+}
+exports.Interval = Interval;
+//# sourceMappingURL=Interval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Interval.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Interval.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAgC;AAChC,6CAA0C;AAE1C,MAAa,QAAS,SAAQ,0BAAY;IACjC,MAAM,GAAW,CAAC,CAAA;IACjB,QAAQ,GAA0C,IAAI,CAAA;IAE9D,YAAoB,QAAgB;QAClC,KAAK,EAAE,CAAA;QAEP,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAA;QAC/C,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5C,qBAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAA;QAE/C,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;IAC/C,CAAC;IAEM,KAAK,CAAE,QAAgB;QAC5B,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAA;IAChE,CAAC;IAEM,OAAO;QACZ,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACtB,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,CAAA;IAC3B,CAAC;CACF;AA3BD,4BA2BC"}

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

@@ -0,0 +1,12 @@
+import { type Component } from './components';
+import { type Condition } from './conditions';
+import type { KeyComponent, KeyCondition } from './Configuration';
+import type { Input as Context, Output } from '../../../../io';
+export declare class Keys {
+    private readonly components;
+    private readonly conditions?;
+    constructor(components: Component[], conditions?: Condition[]);
+    static create(componentRules: KeyComponent[], conditionRules?: KeyCondition[]): Keys;
+    get(context: Context): string;
+    match(input: Context, output: Output): string | null;
+}

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Keys = void 0;
+const node_crypto_1 = require("node:crypto");
+const components_1 = require("./components");
+const conditions_1 = require("./conditions");
+class Keys {
+    components;
+    conditions;
+    constructor(components, conditions) {
+        this.components = components;
+        this.conditions = conditions;
+    }
+    static create(componentRules, conditionRules) {
+        const components = componentRules.map((rule) => new components_1.Components[rule.method](rule.options));
+        const conditions = conditionRules?.map((rule) => new conditions_1.Conditions[rule.method](rule.options));
+        return new this(components, conditions);
+    }
+    get(context) {
+        const hash = (0, node_crypto_1.createHash)('sha256');
+        for (const component of this.components)
+            hash.update(component.get(context));
+        return hash.digest('hex');
+    }
+    match(input, output) {
+        const miss = this.conditions?.some((condition) => !condition.match(input, output));
+        if (miss === true)
+            return null;
+        else
+            return this.get(input);
+    }
+}
+exports.Keys = Keys;
+//# 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,6CAAwC;AACxC,6CAAyD;AACzD,6CAAyD;AAIzD,MAAa,IAAI;IACE,UAAU,CAAa;IACvB,UAAU,CAAc;IAEzC,YAAoB,UAAuB,EAAE,UAAwB;QACnE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAEM,MAAM,CAAC,MAAM,CAAE,cAA8B,EAAE,cAA+B;QACnF,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,uBAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;QAC1F,MAAM,UAAU,GAAG,cAAc,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,uBAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;QAE3F,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IACzC,CAAC;IAEM,GAAG,CAAE,OAAgB;QAC1B,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAA;QAEjC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU;YACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;QAErC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAEM,KAAK,CAAE,KAAc,EAAE,MAAc;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;QAElF,IAAI,IAAI,KAAK,IAAI;YACf,OAAO,IAAI,CAAA;;YAEX,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;CACF;AAjCD,oBAiCC"}

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

@@ -0,0 +1,8 @@
+export declare class Quota {
+    private readonly limit;
+    private used;
+    constructor(limit: number);
+    get idle(): boolean;
+    use(count?: number): boolean;
+    reset(): void;
+}