@toa.io/extensions.exposition 1.0.0-alpha.28 → 1.0.0-alpha.282

package/transpiled/directives/dev/Development.d.ts

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

package/transpiled/directives/dev/Development.js

@@ -1,29 +1,33 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Development = void 0;
-const Stub_1 = require("./Stub");
-const Throw_1 = require("./Throw");
-class Development {
+import { Stub } from './Stub.js';
+import { Throw } from './Throw.js';
+import { Sleep } from './Sleep.js';
+import { Faulty } from './Faulty.js';
+export class Development {
     name = 'dev';
     mandatory = false;
     create(name, value) {
         const Class = constructors[name];
         if (Class === undefined)
-            throw new Error(`Directive 'dev:${name}' is not implemented.`);
+            throw new Error(`Directive 'dev:${name}' is not implemented`);
         return new Class(value);
     }
-    preflight(directives, input) {
+    async preflight(directives, input) {
+        let output = null;
         for (const directive of directives) {
-            const output = directive.apply(input);
-            if (output !== null)
-                return output;
+            const out = await directive.apply(input);
+            if (out !== null)
+                if (output !== null)
+                    throw new Error('`dev` directives ambiguous output');
+                else
+                    output = out;
         }
-        return null;
+        return output;
     }
 }
-exports.Development = Development;
 const constructors = {
-    stub: Stub_1.Stub,
-    throw: Throw_1.Throw
+    stub: Stub,
+    throw: Throw,
+    sleep: Sleep,
+    faulty: Faulty
 };
 //# sourceMappingURL=Development.js.map

package/transpiled/directives/dev/Development.js.map

@@ -1 +1 @@
-{"version":3,"file":"Development.js","sourceRoot":"","sources":["../../../source/directives/dev/Development.ts"],"names":[],"mappings":";;;AAAA,iCAA6B;AAC7B,mCAA+B;AAK/B,MAAa,WAAW;IACN,IAAI,GAAW,KAAK,CAAA;IACpB,SAAS,GAAY,KAAK,CAAA;IAEnC,MAAM,CAAE,IAAY,EAAE,KAAc;QACzC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,uBAAuB,CAAC,CAAA;QAEhE,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAEM,SAAS,CAAE,UAAuB,EAAE,KAAY;QACrD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAErC,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAvBD,kCAuBC;AAED,MAAM,YAAY,GAAkD;IAClE,IAAI,EAAE,WAAI;IACV,KAAK,EAAE,aAAK;CACb,CAAA"}
+{"version":3,"file":"Development.js","sourceRoot":"","sources":["../../../source/directives/dev/Development.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKpC,MAAM,OAAO,WAAW;IACN,IAAI,GAAW,KAAK,CAAA;IACpB,SAAS,GAAY,KAAK,CAAA;IAEnC,MAAM,CAAE,IAAY,EAAE,KAAc;QACzC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,sBAAsB,CAAC,CAAA;QAE/D,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,UAAuB,EAAE,KAAY;QAC3D,IAAI,MAAM,GAAG,IAAI,CAAA;QAEjB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAExC,IAAI,GAAG,KAAK,IAAI;gBACd,IAAI,MAAM,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;;oBACpE,MAAM,GAAG,GAAG,CAAA;QACrB,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,MAAM,YAAY,GAAkD;IAClE,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,MAAM;CACf,CAAA"}

package/transpiled/directives/dev/Faulty.d.ts

@@ -0,0 +1,8 @@
+import type { Output } from '../../io.js';
+import type { Directive } from './types.js';
+export declare class Faulty implements Directive {
+    private static readonly warned;
+    private readonly probability;
+    constructor(probability: number);
+    apply(): Promise<Output>;
+}

package/transpiled/directives/dev/Faulty.js

@@ -0,0 +1,19 @@
+import assert from 'node:assert';
+import { ServiceUnavailable } from '../../HTTP/index.js';
+import { cors } from '../cors/index.js';
+export class Faulty {
+    static warned = false;
+    probability;
+    constructor(probability) {
+        assert.ok(typeof probability === 'number', '`dev:faulty` directive value must be a number');
+        assert.ok(probability > 0 && probability <= 1, '`dev:faulty` directive value must be in the range (0, 1]');
+        this.probability = probability;
+        cors.allow('faulty');
+    }
+    async apply() {
+        if (Math.random() > this.probability)
+            return null;
+        throw new ServiceUnavailable();
+    }
+}
+//# sourceMappingURL=Faulty.js.map

package/transpiled/directives/dev/Faulty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Faulty.js","sourceRoot":"","sources":["../../../source/directives/dev/Faulty.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAIvC,MAAM,OAAO,MAAM;IACT,MAAM,CAAU,MAAM,GAAG,KAAK,CAAA;IACrB,WAAW,CAAQ;IAEpC,YAAoB,WAAmB;QACrC,MAAM,CAAC,EAAE,CAAC,OAAO,WAAW,KAAK,QAAQ,EAAE,+CAA+C,CAAC,CAAA;QAC3F,MAAM,CAAC,EAAE,CAAC,WAAW,GAAG,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,0DAA0D,CAAC,CAAA;QAE1G,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAE9B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW;YAClC,OAAO,IAAI,CAAA;QAEb,MAAM,IAAI,kBAAkB,EAAE,CAAA;IAChC,CAAC"}

package/transpiled/directives/dev/Sleep.d.ts

@@ -0,0 +1,9 @@
+import type { Directive } from './types.js';
+import type { Input, Output } from '../../io.js';
+export declare class Sleep implements Directive {
+    private static warned;
+    private readonly maximum;
+    constructor(value: number);
+    apply(input: Input): Promise<Output>;
+    private parse;
+}

package/transpiled/directives/dev/Sleep.js

@@ -0,0 +1,41 @@
+import assert from 'node:assert';
+import { setTimeout } from 'node:timers/promises';
+import { console } from 'openspan';
+import { cors } from '../cors/index.js';
+import { BadRequest } from '../../HTTP/index.js';
+export class Sleep {
+    static warned = false;
+    maximum;
+    constructor(value) {
+        assert.ok(Number.isInteger(value), '`dev:sleep` directive value must be an integer');
+        if (!Sleep.warned) {
+            console.warn('Sleep directive is enabled', { maximum: value });
+            Sleep.warned = true;
+        }
+        cors.allow('sleep');
+        this.maximum = value;
+    }
+    async apply(input) {
+        const value = input.request.headers.sleep;
+        if (value === undefined)
+            return null;
+        const [min, max] = this.parse(value);
+        if (min < 0 || max < 0 || min > max || max > this.maximum)
+            throw new BadRequest('Invalid sleep duration');
+        const duration = Math.floor(Math.random() * (max - min)) + min;
+        await setTimeout(duration);
+        return null;
+    }
+    parse(value) {
+        try {
+            const pair = JSON.parse(value);
+            if (!Array.isArray(pair) || pair.length !== 2)
+                throw new Error();
+            return pair;
+        }
+        catch {
+            throw new BadRequest('Invalid sleep duration value');
+        }
+    }
+}
+//# sourceMappingURL=Sleep.js.map

package/transpiled/directives/dev/Sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sleep.js","sourceRoot":"","sources":["../../../source/directives/dev/Sleep.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIhD,MAAM,OAAO,KAAK;IACR,MAAM,CAAC,MAAM,GAAG,KAAK,CAAA;IACZ,OAAO,CAAQ;IAEhC,YAAoB,KAAa;QAC/B,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,gDAAgD,CAAC,CAAA;QAEpF,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9D,KAAK,CAAC,MAAM,GAAG,IAAI,CAAA;QACrB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAE,KAAY;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAA2B,CAAA;QAE/D,IAAI,KAAK,KAAK,SAAS;YACrB,OAAO,IAAI,CAAA;QAEb,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAEpC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO;YACvD,MAAM,IAAI,UAAU,CAAC,wBAAwB,CAAC,CAAA;QAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;QAE9D,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAA;QAE1B,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,KAAK,CAAE,KAAa;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAqB,CAAA;YAElD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAC3C,MAAM,IAAI,KAAK,EAAE,CAAA;YAEnB,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAA;QACtD,CAAC;IACH,CAAC"}

package/transpiled/directives/dev/Stub.d.ts

@@ -1,5 +1,5 @@
-import type { Output } from '../../io';
-import type { Directive } from './types';
+import type { Output } from '../../io.js';
+import type { Directive } from './types.js';
 export declare class Stub implements Directive {
     private readonly value;
     constructor(value: unknown);

package/transpiled/directives/dev/Stub.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Stub = void 0;
-class Stub {
+export class Stub {
     value;
     constructor(value) {
         this.value = value;
@@ -10,5 +7,4 @@ class Stub {
         return { body: this.value };
     }
 }
-exports.Stub = Stub;
 //# sourceMappingURL=Stub.js.map

package/transpiled/directives/dev/Stub.js.map

@@ -1 +1 @@
-{"version":3,"file":"Stub.js","sourceRoot":"","sources":["../../../source/directives/dev/Stub.ts"],"names":[],"mappings":";;;AAGA,MAAa,IAAI;IACE,KAAK,CAAS;IAE/B,YAAoB,KAAc;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,KAAK;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IAC7B,CAAC;CACF;AAVD,oBAUC"}
+{"version":3,"file":"Stub.js","sourceRoot":"","sources":["../../../source/directives/dev/Stub.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,IAAI;IACE,KAAK,CAAS;IAE/B,YAAoB,KAAc;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,KAAK;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IAC7B,CAAC;CACF"}

package/transpiled/directives/dev/Throw.d.ts

@@ -1,5 +1,5 @@
-import type { Output } from '../../io';
-import type { Directive } from './types';
+import type { Output } from '../../io.js';
+import type { Directive } from './types.js';
 export declare class Throw implements Directive {
     private readonly message;
     constructor(message: string);

package/transpiled/directives/dev/Throw.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Throw = void 0;
-class Throw {
+export class Throw {
     message;
     constructor(message) {
         this.message = message;
@@ -10,5 +7,4 @@ class Throw {
         throw new Error(this.message);
     }
 }
-exports.Throw = Throw;
 //# sourceMappingURL=Throw.js.map

package/transpiled/directives/dev/Throw.js.map

@@ -1 +1 @@
-{"version":3,"file":"Throw.js","sourceRoot":"","sources":["../../../source/directives/dev/Throw.ts"],"names":[],"mappings":";;;AAGA,MAAa,KAAK;IACC,OAAO,CAAQ;IAEhC,YAAoB,OAAe;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,KAAK;QACV,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;CACF;AAVD,sBAUC"}
+{"version":3,"file":"Throw.js","sourceRoot":"","sources":["../../../source/directives/dev/Throw.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,KAAK;IACC,OAAO,CAAQ;IAEhC,YAAoB,OAAe;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,KAAK;QACV,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;CACF"}

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

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

package/transpiled/directives/dev/index.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/dev/index.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE9B,QAAA,GAAG,GAAG,IAAI,yBAAW,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/dev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAA"}

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

@@ -1,4 +1,4 @@
-import type { Input, Output } from '../../io';
+import type { Input, Output } from '../../io.js';
 export interface Directive {
-    apply: (input: Input) => Output;
+    apply: (input: Input) => Promise<Output> | Output;
 }

package/transpiled/directives/dev/types.js

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

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

@@ -0,0 +1,9 @@
+import type { Directive } from './types.js';
+import type { Input as Context } from '../../io.js';
+export declare class Compose implements Directive {
+    private readonly expressions;
+    constructor(composition: any);
+    attach(context: Context): void;
+    private compose;
+    private execute;
+}

package/transpiled/directives/flow/Compose.js

@@ -0,0 +1,67 @@
+import { once } from 'node:events';
+import * as assert from 'node:assert';
+import { Readable } from 'node:stream';
+import { console } from 'openspan';
+export class Compose {
+    expressions;
+    constructor(composition) {
+        this.expressions = build(composition);
+    }
+    attach(context) {
+        context.pipelines.response.push(async (message) => {
+            if (!(message.body instanceof Readable)) {
+                console.warn('Response body is not a stream, skipping composition');
+                return;
+            }
+            assert.ok(message.body instanceof 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 once(stream, 'end');
+        return $;
+    }
+    execute($) {
+        let exception;
+        for (const expression of this.expressions)
+            try {
+                return expression($);
+            }
+            catch (e) {
+                exception = e;
+                console.debug('Chunks composition failed', { cause: exception.message });
+            }
+        throw exception;
+    }
+}
+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.js';
+import type { Remotes } from '../../Remotes.js';
+import type { Output } from '../../io.js';
+import type { Input } from '../octets/types.js';
+import type { Parameter } from '../../RTD/index.js';
+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,51 @@
+import { Readable } from 'node:stream';
+import assert from 'node:assert';
+import { match } from 'matchacho';
+import { NotFound } from '../../HTTP/index.js';
+export class Fetch {
+    connecting;
+    remote = null;
+    operation;
+    constructor(endpoint, discovery) {
+        assert.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 NotFound(request);
+        const { url, options } = 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 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 : Readable.fromWeb(response.body)
+        };
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,10 @@
+import type { Directive } from './types.js';
+import type { Input, Output } from '../../io.js';
+import type { DirectiveFamily, Parameter } from '../../RTD/index.js';
+import type { Remotes } from '../../Remotes.js';
+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,29 @@
+import { Fetch } from './Fetch.js';
+import { Compose } from './Compose.js';
+export 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;
+    }
+}
+const constructors = {
+    fetch: Fetch,
+    compose: 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,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAMtC,MAAM,OAAO,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;AAED,MAAM,YAAY,GAAsE;IACtF,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,OAAO;CACjB,CAAA"}

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

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

package/transpiled/directives/flow/index.js

@@ -0,0 +1,3 @@
+import { Flow } from './Flow.js';
+export const flow = new 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,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAA"}

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

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

package/transpiled/directives/flow/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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 { DirectiveFamily } from '../RTD';
-import type { Interceptor } from '../Interception';
+import type { DirectiveFamily } from '../RTD/index.js';
+import type { Interceptor } from '../Interception.js';
 export declare const families: DirectiveFamily[];
 export declare const interceptors: Interceptor[];

package/transpiled/directives/index.js

@@ -1,14 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.interceptors = exports.families = void 0;
-const auth_1 = require("./auth");
-const cache_1 = require("./cache");
-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");
-const require_1 = require("./require");
-exports.families = [auth_1.authorization, io_1.io, cache_1.cache, vary_1.vary, require_1.req, octets_1.octets, dev_1.dev];
-exports.interceptors = [cors_1.cors];
+import { authorization } from './auth/index.js';
+import { cache } from './cache/index.js';
+import { cors } from './cors/index.js';
+import { dev } from './dev/index.js';
+import { octets } from './octets/index.js';
+import { io } from './io/index.js';
+import { map } from './map/index.js';
+import { req } from './require/index.js';
+import { flow } from './flow/index.js';
+export const families = [authorization, io, cache, map, req, flow, octets, dev];
+export const interceptors = [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;AAC7B,uCAA+B;AAIlB,QAAA,QAAQ,GAAsB,CAAC,oBAAa,EAAE,OAAE,EAAE,aAAK,EAAE,WAAI,EAAE,aAAG,EAAE,eAAM,EAAE,SAAG,CAAC,CAAA;AAChF,QAAA,YAAY,GAAkB,CAAC,WAAI,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/directives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAItC,MAAM,CAAC,MAAM,QAAQ,GAAsB,CAAC,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;AAClG,MAAM,CAAC,MAAM,YAAY,GAAkB,CAAC,IAAI,CAAC,CAAA"}

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

@@ -1,8 +1,13 @@
-import type { Input } from '../../io';
+import type { Sync } from './lib/throttle/index.js';
+import type { Parameter } from '../../RTD/index.js';
+import type { Input as Context } from '../../io.js';
+import type * as http from '../../HTTP/index.js';
 export interface Directive {
-    attach: (context: Input) => void;
+    preflight: (context: Context, parameters: Parameter[]) => void;
+    /** Synchronous by contract: settling holds the response, and none of it needs I/O. */
+    settle?: (context: Context, response: http.OutgoingMessage) => void;
 }
 export interface Constructor {
     validate: (value: unknown) => void;
-    new (value: any): Directive;
+    new (value: any, sync: Sync, route: string): Directive;
 }

package/transpiled/directives/io/Directive.js

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

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

@@ -1,9 +1,22 @@
-import type { Directive } from './Directive';
-import type { Input as Context } from '../../io';
-import type { DirectiveFamily } from '../../RTD';
+import type * as http from '../../HTTP/index.js';
+import type { Parameter, DirectiveFamily } from '../../RTD/index.js';
+import type { Remotes } from '../../Remotes.js';
+import type { Directive } from './Directive.js';
+import type { extensions } from '@toa.io/core';
 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;
+    private host;
+    /** Throttling reconciles through the atom of the gateways, one for every directive. */
+    private sync;
+    mount(host: extensions.Host): void;
+    create(name: string, value: unknown, remotes: Remotes, route: string): Directive;
+    preflight(directives: Directive[], context: http.Context, parameters: Parameter[]): null;
+    settle(directives: Directive[], context: http.Context, output: http.OutgoingMessage): void;
+    /**
+     * The ticker belongs to the family rather than to any route's directives, and the
+     * factory disposes every route it made — so this runs once per route at shutdown,
+     * and disposing an already stopped ticker is what makes that harmless.
+     */
+    dispose(): void;
 }