@toa.io/extensions.exposition 1.0.0-alpha.16 → 1.0.0-alpha.160

package/transpiled/directives/flow/Compose.js

@@ -0,0 +1,94 @@
+"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.Compose = void 0;
+const node_events_1 = require("node:events");
+const assert = __importStar(require("node:assert"));
+const node_stream_1 = require("node:stream");
+const openspan_1 = require("openspan");
+class Compose {
+    expressions;
+    constructor(composition) {
+        this.expressions = build(composition);
+    }
+    attach(context) {
+        context.pipelines.response.push(async (message) => {
+            if (!(message.body instanceof node_stream_1.Readable)) {
+                openspan_1.console.warn('Response body is not a stream, skipping composition');
+                return;
+            }
+            assert.ok(message.body instanceof node_stream_1.Readable, 'Response body is not a stream');
+            // @ts-expect-error -- objectMode is not defined in the type definition
+            assert.ok(message.body._readableState.objectMode, 'Response stream is not in object mode');
+            const $ = await this.compose(message.body);
+            message.body = this.execute($);
+        });
+    }
+    async compose(stream) {
+        const $ = [];
+        stream.on('data', (data) => $.push(data));
+        await (0, node_events_1.once)(stream, 'end');
+        return $;
+    }
+    execute($) {
+        let exception;
+        for (const expression of this.expressions)
+            try {
+                return expression($);
+            }
+            catch (e) {
+                exception = e;
+                openspan_1.console.debug('Chunks composition failed', { cause: exception.message });
+            }
+        throw exception;
+    }
+}
+exports.Compose = Compose;
+function build(composition) {
+    return Array.isArray(composition)
+        ? composition.map((variant) => compile(variant))
+        : [compile(composition)];
+}
+function compile(composition) {
+    const text = typeof composition === 'string'
+        ? `return ${composition}`
+        : `return ${json(composition)}`;
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval,no-new-func
+    return new Function('$', text);
+}
+function json(node) {
+    if (typeof node === 'string')
+        if (node.startsWith('\\'))
+            return `"${node}"`;
+        else
+            return node;
+    if (Array.isArray(node))
+        return `[${node.map((v) => json(v)).join(',')}]`;
+    if (node.constructor !== Object)
+        return JSON.stringify(node);
+    return '{' + Object.entries(node)
+        .map(([key, value]) => `"${key}": ${json(value)}`).join(',') + '}';
+}
+//# sourceMappingURL=Compose.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { Directive } from './types';
+import type { Remotes } from '../../Remotes';
+import type { Output } from '../../io';
+import type { Input } from '../octets/types';
+import type { Parameter } from '../../RTD';
+export declare class Fetch implements Directive {
+    private readonly connecting;
+    private remote;
+    private readonly operation;
+    constructor(endpoint: string, discovery: Remotes);
+    apply(input: Input, parameters: Parameter[]): Promise<Output>;
+}

package/transpiled/directives/flow/Fetch.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fetch = void 0;
+const node_stream_1 = require("node:stream");
+const node_assert_1 = __importDefault(require("node:assert"));
+const matchacho_1 = require("matchacho");
+const HTTP_1 = require("../../HTTP");
+class Fetch {
+    connecting;
+    remote = null;
+    operation;
+    constructor(endpoint, discovery) {
+        node_assert_1.default.equal(typeof endpoint, 'string', '`flow:fetch` must be a string');
+        const [operation, name, namespace = 'default'] = endpoint.split('.').reverse();
+        this.operation = operation;
+        this.connecting = discovery.discover(namespace, name);
+    }
+    async apply(input, parameters) {
+        if ('if-none-match' in input.request.headers)
+            return { status: 304 };
+        this.remote ??= await this.connecting;
+        const request = await this.remote.invoke(this.operation, {
+            input: {
+                authority: input.authority,
+                path: input.request.url,
+                parameters: Object.fromEntries(parameters.map(({ name, value }) => [name, value]))
+            }
+        });
+        if (request instanceof Error)
+            throw new HTTP_1.NotFound(request);
+        const { url, options } = (0, matchacho_1.match)(request, String, { url: request }, (request) => ({
+            url: request.url,
+            options: {
+                method: request.options?.method ?? 'GET',
+                body: request.options?.body,
+                headers: request.options?.headers
+            }
+        }));
+        const response = await fetch(url, options);
+        if (!response.ok)
+            throw new HTTP_1.NotFound();
+        const headers = new Headers();
+        for (const header of ['content-type', 'content-length', 'etag']) {
+            const value = response.headers.get(header);
+            if (value !== null)
+                headers.set(header, value);
+        }
+        return {
+            headers,
+            body: response.body === null ? null : node_stream_1.Readable.fromWeb(response.body)
+        };
+    }
+}
+exports.Fetch = Fetch;
+//# sourceMappingURL=Fetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Fetch.js","sourceRoot":"","sources":["../../../source/directives/flow/Fetch.ts"],"names":[],"mappings":";;;;;;AAAA,6CAAsC;AACtC,8DAAgC;AAChC,yCAAiC;AACjC,qCAAqC;AAUrC,MAAa,KAAK;IACC,UAAU,CAAoB;IACvC,MAAM,GAAqB,IAAI,CAAA;IACtB,SAAS,CAAQ;IAElC,YAAoB,QAAgB,EAAE,SAAkB;QACtD,qBAAM,CAAC,KAAK,CAAC,OAAO,QAAQ,EAAE,QAAQ,EAAE,+BAA+B,CAAC,CAAA;QAExE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;QAE9E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IACvD,CAAC;IAEM,KAAK,CAAC,KAAK,CAAE,KAAY,EAAE,UAAuB;QACvD,IAAI,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO;YAC1C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QAExB,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,UAAU,CAAA;QAErC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAA0B,IAAI,CAAC,SAAS,EAAE;YAChF,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG;gBACvB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;aACnF;SACF,CAAC,CAAA;QAEF,IAAI,OAAO,YAAY,KAAK;YAC1B,MAAM,IAAI,eAAQ,CAAC,OAAO,CAAC,CAAA;QAE7B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAA,iBAAK,EAAU,OAAO,EAC7C,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EACxB,CAAC,OAAgB,EAAW,EAAE,CAAC,CAAC;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE;gBACP,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK;gBACxC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI;gBAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO;aAClC;SACF,CAAC,CAAC,CAAA;QAEL,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE;YACd,MAAM,IAAI,eAAQ,EAAE,CAAA;QAEtB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QAE7B,KAAK,MAAM,MAAM,IAAI,CAAC,cAAc,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC;YAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAE1C,IAAI,KAAK,KAAK,IAAI;gBAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QAED,OAAO;YACL,OAAO;YACP,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAsB,CAAC;SACxF,CAAA;IACH,CAAC;CACF;AA7DD,sBA6DC"}

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

@@ -0,0 +1,10 @@
+import type { Directive } from './types';
+import type { Input, Output } from '../../io';
+import type { DirectiveFamily, Parameter } from '../../RTD';
+import type { Remotes } from '../../Remotes';
+export declare class Flow implements DirectiveFamily<Directive> {
+    readonly name: string;
+    readonly mandatory: boolean;
+    create(name: string, value: unknown, remotes: Remotes): Directive;
+    preflight(directives: Directive[], input: Input, parameters: Parameter[]): Promise<Output>;
+}

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.js

@@ -7,7 +7,9 @@ const cors_1 = require("./cors");
 const dev_1 = require("./dev");
 const octets_1 = require("./octets");
 const io_1 = require("./io");
-const vary_1 = require("./vary");
-exports.families = [auth_1.authorization, io_1.io, cache_1.cache, vary_1.vary, octets_1.octets, dev_1.dev];
+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,iCAAsC;AACtC,mCAA+B;AAC/B,iCAA6B;AAC7B,+BAA2B;AAC3B,qCAAiC;AACjC,6BAAyB;AACzB,iCAA6B;AAIhB,QAAA,QAAQ,GAAsB,CAAC,oBAAa,EAAE,OAAE,EAAE,aAAK,EAAE,WAAI,EAAE,eAAM,EAAE,SAAG,CAAC,CAAA;AAC3E,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

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

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

@@ -1,9 +1,11 @@
+import type * as http from '../../HTTP';
 import type { Directive } from './Directive';
-import type { Input as Context } from '../../io';
 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: Context): null;
+    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

@@ -3,12 +3,13 @@ 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.`);
+            throw new Error(`Directive 'io:${name}' is not implemented`);
         const Directive = constructors[name];
         Directive.validate(value);
         return new Directive(value);
@@ -17,17 +18,26 @@ class IO {
         let restricted = false;
         for (const directive of directives) {
             restricted ||= directive instanceof Output_1.Output;
-            directive.attach(context);
+            directive.preflight(context);
         }
         if (!restricted)
-            DENIAL.attach(context);
+            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,
-    input: Input_1.Input
+    throttle: Throttle_1.Throttle
 };
 const DENIAL = new Output_1.Output([]);
 //# sourceMappingURL=IO.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"IO.js","sourceRoot":"","sources":["../../../source/directives/io/IO.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AACjC,mCAA+B;AAK/B,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,uBAAuB,CAAC,CAAA;QAE/D,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,OAAgB;QACzD,IAAI,UAAU,GAAG,KAAK,CAAA;QAEtB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,UAAU,KAAK,SAAS,YAAY,eAAM,CAAA;YAE1C,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC3B,CAAC;QAED,IAAI,CAAC,UAAU;YACb,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAExB,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AA7BD,gBA6BC;AAED,MAAM,YAAY,GAAgC;IAChD,MAAM,EAAE,eAAM;IACd,KAAK,EAAE,aAAK;CACb,CAAA;AAED,MAAM,MAAM,GAAW,IAAI,eAAM,CAAC,EAAE,CAAC,CAAA"}
+{"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

@@ -4,7 +4,7 @@ export declare class Input implements Directive {
     private readonly permissions;
     constructor(permissions: Permissions);
     static validate(permissions: unknown): asserts permissions is Permissions;
-    attach(context: Context): void;
+    preflight(context: Context): void;
     private check;
     private violation;
 }

package/transpiled/directives/io/Input.js

@@ -34,19 +34,21 @@ class Input {
     static validate(permissions) {
         schemas.input.validate(permissions, 'Incorrect \'io:input\' format');
     }
-    attach(context) {
+    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.');
+            throw new HTTP_1.BadRequest('Invalid request body');
         }
         const property = this.violation(body);
         if (property !== undefined)
-            throw new HTTP_1.BadRequest(`Unexpected input: ${property}.`);
+            throw new HTTP_1.BadRequest(`Unexpected input: ${property}`);
         return body;
     }
     violation(value) {

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

@@ -1 +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;IACtE,CAAC;IAEM,MAAM,CAAE,OAAgB;QAC7B,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,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,iBAAU,CAAC,uBAAuB,CAAC,CAAA;QAC/C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAErC,IAAI,QAAQ,KAAK,SAAS;YACxB,MAAM,IAAI,iBAAU,CAAC,qBAAqB,QAAQ,GAAG,CAAC,CAAA;QAExD,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;AAzCD,sBAyCC"}
+{"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/Output.d.ts

@@ -6,7 +6,7 @@ export declare class Output implements Directive {
     private readonly permissions;
     constructor(permissions: Permissions);
     static validate(permissions: unknown): asserts permissions is Permissions;
-    attach(context: Context): void;
+    preflight(context: Context): void;
     private restriction;
     private fit;
 }

package/transpiled/directives/io/Output.js

@@ -25,6 +25,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 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;
@@ -42,7 +43,7 @@ class Output {
     static validate(permissions) {
         schemas.output.validate(permissions, 'Incorrect \'io:output\' format');
     }
-    attach(context) {
+    preflight(context) {
         context.pipelines.response.push(this.restriction(context));
     }
     restriction(context) {
@@ -54,8 +55,7 @@ class Output {
                 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.`);
+                    openspan_1.console.warn('Permissions for \'io:output\' are not specified properly, response omitted', { path: context.url.pathname });
                 delete message.body;
                 return;
             }

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,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,36 +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"));
-const Directive_1 = require("./Directive");
-class Permute extends Directive_1.Directive {
-    targeted = false;
-    discovery;
-    storage = null;
-    constructor(value, discovery) {
-        super();
-        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, input) {
-        this.storage ??= await this.discovery;
-        if (input.encoder === null)
-            throw new HTTP_1.NotAcceptable();
-        const path = input.request.url;
-        const list = await input.body();
-        const error = await this.storage.invoke('permute', {
-            input: {
-                storage,
-                path,
-                list
-            }
-        });
-        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/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"}