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

package/transpiled/directives/cors/index.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/cors/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6B;AAEhB,QAAA,IAAI,GAAG,IAAI,WAAI,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/cors/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/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;
+    precall(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 precall(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,CAAC,IAAY,EAAE,KAAc;QACxC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,sBAAsB,CAAC,CAAA;QAEtF,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,UAAuB,EAAE,KAAY;QACxD,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,YAAmB,WAAmB;QACpC,MAAM,CAAC,EAAE,CACP,OAAO,WAAW,KAAK,QAAQ,EAC/B,+CAA+C,CAChD,CAAA;QACD,MAAM,CAAC,EAAE,CACP,WAAW,GAAG,CAAC,IAAI,WAAW,IAAI,CAAC,EACnC,0DAA0D,CAC3D,CAAA;QAED,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;YAAE,OAAO,IAAI,CAAA;QAEjD,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,YAAmB,KAAa;QAC9B,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,CAAC,KAAY;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAA2B,CAAA;QAE/D,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAEpC,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,CAAC,KAAa;QACzB,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;gBAAE,MAAM,IAAI,KAAK,EAAE,CAAA;YAEhE,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,YAAmB,KAAc;QAC/B,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,YAAmB,OAAe;QAChC,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,71 @@
+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');
+            assert.ok(
+            // @ts-expect-error -- objectMode is not defined in the type definition
+            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;
+    precall(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 precall(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,CAAC,IAAY,EAAE,KAAc,EAAE,OAAgB;QAC1D,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,OAAO,CAClB,UAAuB,EACvB,KAAY,EACZ,UAAuB;QAEvB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;gBAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAE3D,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAQ;YAE3C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;YAEvD,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAA;QACpC,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/help/Family.d.ts

@@ -0,0 +1,28 @@
+import { Help } from './Help.js';
+import { Parameters } from './Parameters.js';
+import type { Introspection } from '../../Introspection.js';
+import type { Described } from './described.js';
+import type { Context } from '../../HTTP/index.js';
+import type { DirectiveFamily } from '../../RTD/index.js';
+/** The name the family is declared under, and what a consumer of one asks a method for. */
+export declare const FAMILY = "help";
+export type Directive = Help | Parameters;
+export declare class Family implements DirectiveFamily<Directive> {
+    readonly name = "help";
+    readonly mandatory = false;
+    /**
+     * What a node says of itself is not said of what is under it: inherited, `help:node`
+     * would describe every resource below as the one it was written for. The rest go with
+     * it — a sentence about one method is not true of the next, and a route variable a
+     * template does not have is not one at all.
+     */
+    readonly inherited = false;
+    /** What the nearest declaration says of the method, or nothing where none does. */
+    static method(directives: Directive[] | undefined): Help | null;
+    /** And the same of the resource the method is on. */
+    static node(directives: Directive[] | undefined): Help | null;
+    create(name: string, value: unknown, _: unknown, route: string): Directive;
+    /** What the route states this method and its parameters are. */
+    explain(directives: Directive[], _: Context, introspection: Introspection): Introspection | null;
+}
+export type { Described };

package/transpiled/directives/help/Family.js

@@ -0,0 +1,83 @@
+import assert from 'node:assert';
+import { Help } from './Help.js';
+import { Parameters } from './Parameters.js';
+/** The name the family is declared under, and what a consumer of one asks a method for. */
+export const FAMILY = 'help';
+export class Family {
+    name = FAMILY;
+    mandatory = false;
+    /**
+     * What a node says of itself is not said of what is under it: inherited, `help:node`
+     * would describe every resource below as the one it was written for. The rest go with
+     * it — a sentence about one method is not true of the next, and a route variable a
+     * template does not have is not one at all.
+     */
+    inherited = false;
+    /** What the nearest declaration says of the method, or nothing where none does. */
+    static method(directives) {
+        return stated(directives, 'method');
+    }
+    /** And the same of the resource the method is on. */
+    static node(directives) {
+        return stated(directives, 'node');
+    }
+    // eslint-disable-next-line max-params
+    create(name, value, _, route) {
+        if (name === 'node' || name === 'method')
+            return new Help(name, value);
+        assert.ok(name === 'route' || name === 'query', `Unknown directive: help:${name}`);
+        return new Parameters(name, value, route);
+    }
+    /** What the route states this method and its parameters are. */
+    explain(directives, _, introspection) {
+        const help = Family.method(directives);
+        // what is hidden is hidden from every answer at once, this being the one place they
+        // all read; the method itself is reached as it always was
+        if (help?.hidden === true)
+            return null;
+        const described = {
+            ...introspection,
+            ...(help?.title === undefined ? {} : { title: help.title }),
+            ...(help?.description === undefined ? {} : { description: help.description })
+        };
+        // a schema says `title` and `description` of what it describes, which is where these go
+        for (const subject of PARAMETERS) {
+            const declaration = declared(directives, subject);
+            if (declaration === null)
+                continue;
+            const parameters = declaration.parameters;
+            for (const [name, stated] of Object.entries(parameters)) {
+                const schema = described[subject]?.[name];
+                /*
+                 * A route variable is one because the template names it, whether or not the
+                 * operation declares it as input — and only then is it answered. `:id` on an
+                 * observation is the ordinary case: it is taken by the query, so nothing describes
+                 * it and the caller is not told it is a path parameter at all.
+                 *
+                 * Anything else is described only where it is already answered: a querystring
+                 * parameter is one only where the mapping takes it, and a segment `map:segments`
+                 * renames is answered under the property it fills.
+                 */
+                if (schema === undefined && !declaration.variables.includes(name))
+                    continue;
+                // written where the shape states it, whatever the schema already said
+                const merged = { ...schema };
+                delete merged.title;
+                delete merged.description;
+                described[subject] ??= {};
+                described[subject][name] = Object.assign(merged, stated);
+            }
+        }
+        return described;
+    }
+}
+const PARAMETERS = ['route', 'query'];
+function stated(directives, subject) {
+    const help = directives?.find((directive) => directive instanceof Help && directive.subject === subject);
+    return help ?? null;
+}
+function declared(directives, subject) {
+    const found = directives?.find((directive) => directive instanceof Parameters && directive.subject === subject);
+    return found ?? null;
+}
+//# sourceMappingURL=Family.js.map