@toa.io/extensions.exposition 1.0.0-alpha.34 → 1.0.0-alpha.340

package/transpiled/directives/io/lib/throttle/components/Segment.d.ts

@@ -0,0 +1,9 @@
+import type { Parameter } from '../../../../../RTD/index.ts';
+import type { Input as Context } from '../../../../../io.ts';
+import type { Component } from './Component.ts';
+/** The value a named route segment was bound to, or nothing when the route has none. */
+export declare class Segment implements Component {
+    private readonly name;
+    constructor(name: unknown);
+    get(_: Context, parameters: Parameter[]): string;
+}

package/transpiled/directives/io/lib/throttle/components/Segment.js

@@ -0,0 +1,13 @@
+/** The value a named route segment was bound to, or nothing when the route has none. */
+export class Segment {
+    name;
+    constructor(name) {
+        if (typeof name !== 'string')
+            throw new Error('Throttle segment must be a string');
+        this.name = name;
+    }
+    get(_, parameters) {
+        return parameters.find(({ name }) => name === this.name)?.value ?? '';
+    }
+}
+//# sourceMappingURL=Segment.js.map

package/transpiled/directives/io/lib/throttle/components/Segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Segment.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/components/Segment.ts"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,MAAM,OAAO,OAAO;IACD,IAAI,CAAQ;IAE7B,YAAmB,IAAa;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QAElF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,GAAG,CAAC,CAAU,EAAE,UAAuB;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAA;IACvE,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+import type { KeyComponentMethod } from '../Configuration.ts';
+import type { Component } from './Component.ts';
+export type { Component } from './Component.ts';
+type Constructor<T> = new (options: unknown, route: string) => T;
+export declare const Components: Record<KeyComponentMethod, Constructor<Component>>;

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

@@ -0,0 +1,13 @@
+import { Path } from './Path.js';
+import { IP } from './IP.js';
+import { Route } from './Route.js';
+import { Identity } from './Identity.js';
+import { Segment } from './Segment.js';
+export const Components = {
+    ip: IP,
+    path: Path,
+    route: Route,
+    identity: Identity,
+    segment: Segment
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAOtC,MAAM,CAAC,MAAM,UAAU,GAAuD;IAC5E,EAAE,EAAE,EAAE;IACN,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,OAAO;CACjB,CAAA"}

package/transpiled/directives/io/lib/throttle/conditions/Condition.d.ts

@@ -0,0 +1,4 @@
+import type { Input, Output } from '../../../../../io.ts';
+export interface Condition {
+    match: (input: Input, output: Output) => boolean;
+}

package/transpiled/directives/io/lib/throttle/conditions/Condition.js

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

package/transpiled/directives/io/lib/throttle/conditions/Condition.js.map

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

package/transpiled/directives/io/lib/throttle/conditions/Status.d.ts

@@ -0,0 +1,7 @@
+import type { Input, Output } from '../../../../../io.ts';
+import type { Condition } from './Condition.ts';
+export declare class Status implements Condition {
+    private readonly status;
+    constructor(status: unknown);
+    match(input: Input, output: Output): boolean;
+}

package/transpiled/directives/io/lib/throttle/conditions/Status.js

@@ -0,0 +1,12 @@
+export class Status {
+    status;
+    constructor(status) {
+        if (typeof status !== 'number')
+            throw new Error('Status must be a number');
+        this.status = status;
+    }
+    match(input, output) {
+        return output?.status === this.status;
+    }
+}
+//# sourceMappingURL=Status.js.map

package/transpiled/directives/io/lib/throttle/conditions/Status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Status.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/conditions/Status.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,MAAM;IACA,MAAM,CAAQ;IAE/B,YAAmB,MAAe;QAChC,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;QAE1E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAY,EAAE,MAAc;QACvC,OAAO,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,MAAM,CAAA;IACvC,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+import type { KeyConditionMethod } from '../Configuration.ts';
+import type { Condition } from './Condition.ts';
+export type { Condition } from './Condition.ts';
+type Constructor<T> = new (options: unknown) => T;
+export declare const Conditions: Record<KeyConditionMethod, Constructor<Condition>>;

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

@@ -0,0 +1,5 @@
+import { Status } from './Status.js';
+export const Conditions = {
+    status: Status
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/conditions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOpC,MAAM,CAAC,MAAM,UAAU,GAAuD;IAC5E,MAAM,EAAE,MAAM;CACf,CAAA"}

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

@@ -0,0 +1,4 @@
+export { Quotas } from './Quotas.ts';
+export { Sync } from './Sync.ts';
+export { Warning } from './Warning.ts';
+export { parse, type Configuration, type Declaration } from './Configuration.ts';

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

@@ -0,0 +1,5 @@
+export { Quotas } from './Quotas.js';
+export { Sync } from './Sync.js';
+export { Warning } from './Warning.js';
+export { parse } from './Configuration.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAwC,MAAM,oBAAoB,CAAA"}

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

@@ -1,7 +1,9 @@
-import { type Schema } from '@toa.io/schemas';
-import type { Permissions as InputPermissions } from './Input';
-import type { Permissions as OutputPermissions } from './Output';
-import type { Message } from './Message';
+import type { Schema } from '@toa.io/schemas';
+import type { Permissions as InputPermissions } from './Input.ts';
+import type { Permissions as OutputPermissions } from './Output.ts';
+import type { Declaration as ThrottleDeclaration } from './lib/throttle/index.ts';
+import type { Message } from './Message.ts';
 export declare const message: Schema<Message | Message[]>;
 export declare const input: Schema<InputPermissions>;
 export declare const output: Schema<OutputPermissions>;
+export declare const throttle: Schema<ThrottleDeclaration>;

package/transpiled/directives/io/schemas.js

@@ -1,14 +1,9 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.output = exports.input = exports.message = void 0;
-const node_path_1 = require("node:path");
-const schemas_1 = __importDefault(require("@toa.io/schemas"));
-const path = (0, node_path_1.resolve)(__dirname, '../../../schemas/io');
-const namespace = schemas_1.default.namespace(path);
-exports.message = namespace.schema('message');
-exports.input = namespace.schema('input');
-exports.output = namespace.schema('output');
+import { resolve } from 'node:path';
+import * as schemas from '@toa.io/schemas';
+const path = resolve(import.meta.dirname, '../../../schemas/io');
+const namespace = schemas.namespace(path);
+export const message = namespace.schema('message');
+export const input = namespace.schema('input');
+export const output = namespace.schema('output');
+export const throttle = namespace.schema('throttle');
 //# sourceMappingURL=schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../source/directives/io/schemas.ts"],"names":[],"mappings":";;;;;;AAAA,yCAAmC;AACnC,8DAAsD;AAKtD,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,qBAAqB,CAAC,CAAA;AACtD,MAAM,SAAS,GAAG,iBAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAE5B,QAAA,OAAO,GAAgC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;AAClE,QAAA,KAAK,GAA6B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3D,QAAA,MAAM,GAA8B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../source/directives/io/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAQ1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;AAChE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,OAAO,GAAgC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;AAC/E,MAAM,CAAC,MAAM,KAAK,GAA6B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,MAAM,GAA8B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAAgC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA"}

package/transpiled/directives/map/Authority.d.ts

@@ -0,0 +1,6 @@
+import { Mapping } from './Mapping.ts';
+import type { Input } from '../../io.ts';
+export declare class Authority extends Mapping<string> {
+    constructor(property: string);
+    properties(context: Input): Record<string, string>;
+}

package/transpiled/directives/map/Authority.js

@@ -0,0 +1,12 @@
+import { Mapping } from './Mapping.js';
+export class Authority extends Mapping {
+    constructor(property) {
+        if (typeof property !== 'string')
+            throw new Error('`map:authority` must be a string');
+        super(property);
+    }
+    properties(context) {
+        return { [this.value]: context.authority };
+    }
+}
+//# sourceMappingURL=Authority.js.map

package/transpiled/directives/map/Authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Authority.js","sourceRoot":"","sources":["../../../source/directives/map/Authority.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,MAAM,OAAO,SAAU,SAAQ,OAAe;IAC5C,YAAmB,QAAgB;QACjC,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QAErF,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC;IAEM,UAAU,CAAC,OAAc;QAC9B,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,CAAA;IAC5C,CAAC;CACF"}

package/transpiled/directives/map/Buffer.d.ts

@@ -0,0 +1,6 @@
+import { Mapping } from './Mapping.ts';
+import type { Input } from '../../io.ts';
+export declare class BufferMapping extends Mapping<string> {
+    constructor(property: string);
+    properties(context: Input): Promise<Record<string, string>>;
+}

package/transpiled/directives/map/Buffer.js

@@ -0,0 +1,12 @@
+import { Mapping } from './Mapping.js';
+export class BufferMapping extends Mapping {
+    constructor(property) {
+        if (typeof property !== 'string')
+            throw new Error('`map:buffer` must be a string');
+        super(property);
+    }
+    async properties(context) {
+        return { [this.value]: (await context.buffer()).toString('utf8') };
+    }
+}
+//# sourceMappingURL=Buffer.js.map

package/transpiled/directives/map/Buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Buffer.js","sourceRoot":"","sources":["../../../source/directives/map/Buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,MAAM,OAAO,aAAc,SAAQ,OAAe;IAChD,YAAmB,QAAgB;QACjC,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAElF,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC;IAEe,KAAK,CAAC,UAAU,CAAC,OAAc;QAC7C,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAA;IACpE,CAAC;CACF"}

package/transpiled/directives/map/Claims.d.ts

@@ -0,0 +1,10 @@
+import { Mapping } from './Mapping.ts';
+import type { Remotes } from '../../Remotes.ts';
+import type { Input } from '../../io.ts';
+export declare class Claims extends Mapping<Record<string, string>> {
+    private readonly discovery;
+    private federation;
+    constructor(map: Record<string, string>, remotes: Remotes);
+    properties(context: Input): Promise<Record<string, string> | null>;
+    private claims;
+}

package/transpiled/directives/map/Claims.js

@@ -0,0 +1,38 @@
+import { Mapping } from './Mapping.js';
+export class Claims extends Mapping {
+    discovery;
+    federation = null;
+    constructor(map, remotes) {
+        if (map.constructor !== Object)
+            throw new Error('`map:claims` must be an object');
+        if (!Object.values(map).every((value) => typeof value === 'string'))
+            throw new Error('`map:claims ` must be an object with string values');
+        super(map, remotes);
+        this.discovery = remotes.discover('identity', 'federation');
+    }
+    async properties(context) {
+        const authentication = context.request.headers.authorization;
+        if (authentication === undefined)
+            return null;
+        const claims = await this.claims(authentication);
+        if (claims === null)
+            return null;
+        return Object.entries(this.value).reduce((properties, [property, claim]) => {
+            const value = claims[claim];
+            if (value !== undefined)
+                properties[property] = value;
+            return properties;
+        }, {});
+    }
+    async claims(authentication) {
+        const [scheme, credentials] = authentication.split(' ');
+        if (scheme !== 'Bearer' || credentials === undefined)
+            return null;
+        this.federation ??= await this.discovery;
+        const claims = await this.federation.invoke('decode', { input: credentials });
+        if (claims instanceof Error)
+            return null;
+        return claims;
+    }
+}
+//# sourceMappingURL=Claims.js.map

package/transpiled/directives/map/Claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Claims.js","sourceRoot":"","sources":["../../../source/directives/map/Claims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAKtC,MAAM,OAAO,MAAO,SAAQ,OAA+B;IACxC,SAAS,CAAqB;IACvC,UAAU,GAAqB,IAAI,CAAA;IAE3C,YAAmB,GAA2B,EAAE,OAAgB;QAC9D,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QAEjF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;QAEvE,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAEnB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IAC7D,CAAC;IAEe,KAAK,CAAC,UAAU,CAC9B,OAAc;QAEd,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAA;QAE5D,IAAI,cAAc,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAE7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAEhD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CACtC,CAAC,UAAkC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;YAE3B,IAAI,KAAK,KAAK,SAAS;gBAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;YAErD,OAAO,UAAU,CAAA;QACnB,CAAC,EACD,EAAE,CACH,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,cAAsB;QACzC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAEvD,IAAI,MAAM,KAAK,QAAQ,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAEjE,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAExC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CACzC,QAAQ,EACR,EAAE,KAAK,EAAE,WAAW,EAAE,CACvB,CAAA;QAED,IAAI,MAAM,YAAY,KAAK;YAAE,OAAO,IAAI,CAAA;QAExC,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/directives/map/Client.d.ts

@@ -0,0 +1,21 @@
+import { Mapping } from './Mapping.ts';
+import type { Input } from '../../io.ts';
+/**
+ * What the gateway resolved of the client — its address, its country — as `exposition.ip` and
+ * `exposition.country` read them. Set whether the request has one or not, as `null` where it has
+ * none, so a body cannot say it for the client.
+ */
+declare abstract class Resolved extends Mapping<string> {
+    protected constructor(property: string, directive: string);
+    properties(context: Input): Record<string, string | null>;
+    protected abstract read(context: Input): string | undefined;
+}
+export declare class IP extends Resolved {
+    constructor(property: string);
+    protected read(context: Input): string | undefined;
+}
+export declare class Country extends Resolved {
+    constructor(property: string);
+    protected read(context: Input): string | undefined;
+}
+export {};

package/transpiled/directives/map/Client.js

@@ -0,0 +1,33 @@
+import { Mapping } from './Mapping.js';
+/**
+ * What the gateway resolved of the client — its address, its country — as `exposition.ip` and
+ * `exposition.country` read them. Set whether the request has one or not, as `null` where it has
+ * none, so a body cannot say it for the client.
+ */
+class Resolved extends Mapping {
+    constructor(property, directive) {
+        if (typeof property !== 'string')
+            throw new Error(`\`${directive}\` must be a string`);
+        super(property);
+    }
+    properties(context) {
+        return { [this.value]: this.read(context) ?? null };
+    }
+}
+export class IP extends Resolved {
+    constructor(property) {
+        super(property, 'map:ip');
+    }
+    read(context) {
+        return context.ip;
+    }
+}
+export class Country extends Resolved {
+    constructor(property) {
+        super(property, 'map:country');
+    }
+    read(context) {
+        return context.country;
+    }
+}
+//# sourceMappingURL=Client.js.map

package/transpiled/directives/map/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../../source/directives/map/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC;;;;GAIG;AACH,MAAe,QAAS,SAAQ,OAAe;IAC7C,YAAsB,QAAgB,EAAE,SAAiB;QACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,SAAS,qBAAqB,CAAC,CAAA;QAEtF,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC;IAEM,UAAU,CAAC,OAAc;QAC9B,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAA;IACrD,CAAC;CAGF;AAED,MAAM,OAAO,EAAG,SAAQ,QAAQ;IAC9B,YAAmB,QAAgB;QACjC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC3B,CAAC;IAES,IAAI,CAAC,OAAc;QAC3B,OAAO,OAAO,CAAC,EAAE,CAAA;IACnB,CAAC;CACF;AAED,MAAM,OAAO,OAAQ,SAAQ,QAAQ;IACnC,YAAmB,QAAgB;QACjC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;IAChC,CAAC;IAES,IAAI,CAAC,OAAc;QAC3B,OAAO,OAAO,CAAC,OAAO,CAAA;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+import type { Mapping } from './Mapping.ts';
+import type { Property } from './Properties.ts';
+export type Directive = Mapping | Property;

package/transpiled/directives/map/Directive.js

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

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

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

package/transpiled/directives/map/Headers.d.ts

@@ -0,0 +1,15 @@
+import { Mapping } from './Mapping.ts';
+import type { Input } from '../../io.ts';
+import type { Introspection } from '../../Introspection.ts';
+export declare class Headers extends Mapping<Record<string, string>> {
+    private readonly headers;
+    constructor(map: Record<string, string>);
+    /**
+     * The property is filled from a request header, so it is not the body's to send. Which
+     * header, and that there is one at all, is not answered: what an application reads off a
+     * request is its own, and a caller has nowhere to put one anyway.
+     */
+    explain(introspection: Introspection): void;
+    /** A header the request does not have is a property it has none of, whatever the body says. */
+    properties(context: Input): Record<string, string | undefined>;
+}

package/transpiled/directives/map/Headers.js

@@ -0,0 +1,41 @@
+import { Mapping } from './Mapping.js';
+import { take } from '../../Introspection.js';
+/**
+ * A cache keys a reply by its URL, the host in it, so there is nothing to vary on. The value
+ * is still read.
+ */
+const KEYED = new Set(['host']);
+export class Headers extends Mapping {
+    headers;
+    constructor(map) {
+        if (map.constructor !== Object)
+            throw new Error('`map:headers` must be an object');
+        if (!Object.values(map).every((value) => typeof value === 'string'))
+            throw new Error('`map:headers` must be an object with string values');
+        super(map);
+        this.headers = Object.values(map).filter((header) => !KEYED.has(header));
+    }
+    /**
+     * The property is filled from a request header, so it is not the body's to send. Which
+     * header, and that there is one at all, is not answered: what an application reads off a
+     * request is its own, and a caller has nowhere to put one anyway.
+     */
+    explain(introspection) {
+        for (const property of Object.keys(this.value))
+            take(introspection, property);
+    }
+    /** A header the request does not have is a property it has none of, whatever the body says. */
+    properties(context) {
+        context.pipelines.response.push((response) => {
+            response.headers ??= new global.Headers();
+            for (const header of this.headers)
+                response.headers.append('vary', header);
+        });
+        return Object.entries(this.value).reduce((properties, [property, header]) => {
+            const value = context.request.headers[header];
+            properties[property] = Array.isArray(value) ? value.join(', ') : value;
+            return properties;
+        }, {});
+    }
+}
+//# sourceMappingURL=Headers.js.map

package/transpiled/directives/map/Headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headers.js","sourceRoot":"","sources":["../../../source/directives/map/Headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAI7C;;;GAGG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAE/B,MAAM,OAAO,OAAQ,SAAQ,OAA+B;IACzC,OAAO,CAAU;IAElC,YAAmB,GAA2B;QAC5C,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QAElF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;QAEvE,KAAK,CAAC,GAAG,CAAC,CAAA;QAEV,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED;;;;OAIG;IACa,OAAO,CAAC,aAA4B;QAClD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IAC/E,CAAC;IAED,+FAA+F;IACxF,UAAU,CAAC,OAAc;QAC9B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC3C,QAAQ,CAAC,OAAO,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAA;YAEzC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;gBAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5E,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CACtC,CAAC,UAA8C,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;YACrE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAE7C,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;YAEtE,OAAO,UAAU,CAAA;QACnB,CAAC,EACD,EAAE,CACH,CAAA;IACH,CAAC;CACF"}

package/transpiled/directives/map/Instance.d.ts

@@ -0,0 +1,15 @@
+import { Mapping } from './Mapping.ts';
+import type { Parameter } from '../../RTD/index.ts';
+import type { Input } from '../../io.ts';
+import type { Introspection } from '../../Introspection.ts';
+/**
+ * Names the route parameter that carries the process a stateful operation is called on. The name
+ * belongs to the call, so the parameter is taken out of what is embedded in the input and out of
+ * the criteria, and left on the context for the endpoint to call with.
+ */
+export declare class Instance extends Mapping<string> {
+    constructor(parameter: unknown);
+    properties(context: Input, parameters: Parameter[]): null;
+    /** The name is the caller's to send, so it is stated with the route. */
+    explain(introspection: Introspection): void;
+}

package/transpiled/directives/map/Instance.js

@@ -0,0 +1,27 @@
+import { Mapping } from './Mapping.js';
+/**
+ * Names the route parameter that carries the process a stateful operation is called on. The name
+ * belongs to the call, so the parameter is taken out of what is embedded in the input and out of
+ * the criteria, and left on the context for the endpoint to call with.
+ */
+export class Instance extends Mapping {
+    constructor(parameter) {
+        if (typeof parameter !== 'string' || parameter === '')
+            throw new Error('`map:instance` must name a route parameter');
+        super(parameter);
+    }
+    properties(context, parameters) {
+        const index = parameters.findIndex(({ name }) => name === this.value);
+        if (index === -1)
+            throw new Error(`Route parameter '${this.value}' is missing`);
+        context.instance = parameters[index].value;
+        parameters.splice(index, 1);
+        return null;
+    }
+    /** The name is the caller's to send, so it is stated with the route. */
+    explain(introspection) {
+        introspection.route ??= {};
+        introspection.route.instance = { type: 'string' };
+    }
+}
+//# sourceMappingURL=Instance.js.map

package/transpiled/directives/map/Instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Instance.js","sourceRoot":"","sources":["../../../source/directives/map/Instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAKtC;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAe;IAC3C,YAAmB,SAAkB;QACnC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,EAAE;YACnD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAE/D,KAAK,CAAC,SAAS,CAAC,CAAA;IAClB,CAAC;IAEe,UAAU,CAAC,OAAc,EAAE,UAAuB;QAChE,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAA;QAErE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,cAAc,CAAC,CAAA;QAE/E,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAA;QAC1C,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAE3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wEAAwE;IACxD,OAAO,CAAC,aAA4B;QAClD,aAAa,CAAC,KAAK,KAAK,EAAE,CAAA;QAC1B,aAAa,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAuB,CAAA;IACxE,CAAC;CACF"}

package/transpiled/directives/map/Language.d.ts

@@ -0,0 +1,10 @@
+import { Mapping } from './Mapping.ts';
+import type { Input } from '../../io.ts';
+import type { Parameter } from '../../RTD/index.ts';
+import type { Directive } from './Directive.ts';
+export declare class Language extends Mapping<string> {
+    private languages;
+    constructor(property: string);
+    properties(context: Input, parameters: Parameter[], directives: Directive[]): Record<string, string>;
+    private resolve;
+}

package/transpiled/directives/map/Language.js

@@ -0,0 +1,29 @@
+import Negotiator from 'negotiator';
+import { Mapping } from './Mapping.js';
+import { Languages } from './Languages.js';
+export class Language extends Mapping {
+    languages = null;
+    constructor(property) {
+        if (typeof property !== 'string')
+            throw new Error('`map:language` must be a string');
+        super(property);
+    }
+    properties(context, parameters, directives) {
+        this.languages ??= this.resolve(directives);
+        const negotiator = new Negotiator(context.request);
+        const language = negotiator.language(this.languages) ?? this.languages[0];
+        context.pipelines.response.push((response) => {
+            response.headers ??= new Headers();
+            response.headers.set('content-language', language);
+            response.headers.append('vary', 'accept-language');
+        });
+        return { [this.value]: language };
+    }
+    resolve(directives) {
+        for (const directive of directives)
+            if (directive instanceof Languages)
+                return directive.value;
+        throw new Error('Supported languages are not defined, add `map:languages` directive');
+    }
+}
+//# sourceMappingURL=Language.js.map

package/transpiled/directives/map/Language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Language.js","sourceRoot":"","sources":["../../../source/directives/map/Language.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAK1C,MAAM,OAAO,QAAS,SAAQ,OAAe;IACnC,SAAS,GAAoB,IAAI,CAAA;IAEzC,YAAmB,QAAgB;QACjC,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QAEpF,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC;IAEM,UAAU,CACf,OAAc,EACd,UAAuB,EACvB,UAAuB;QAEvB,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAE3C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAEzE,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC3C,QAAQ,CAAC,OAAO,KAAK,IAAI,OAAO,EAAE,CAAA;YAClC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAA;YAClD,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnC,CAAC;IAEO,OAAO,CAAC,UAAuB;QACrC,KAAK,MAAM,SAAS,IAAI,UAAU;YAChC,IAAI,SAAS,YAAY,SAAS;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAA;QAE5D,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACvF,CAAC;CACF"}

package/transpiled/directives/map/Languages.d.ts

@@ -0,0 +1,4 @@
+import { Property } from './Properties.ts';
+export declare class Languages extends Property<'languages'> {
+    constructor(value: string[]);
+}

package/transpiled/directives/map/Languages.js

@@ -0,0 +1,11 @@
+import { Property } from './Properties.js';
+export class Languages extends Property {
+    constructor(value) {
+        if (!(Array.isArray(value) && value.length > 0))
+            throw new Error('`map:languages` must be a non-empty array of strings');
+        if (!value.every((language) => typeof language === 'string'))
+            throw new Error('`map:languages` must be an array of strings');
+        super('languages', value);
+    }
+}
+//# sourceMappingURL=Languages.js.map

package/transpiled/directives/map/Languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Languages.js","sourceRoot":"","sources":["../../../source/directives/map/Languages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,MAAM,OAAO,SAAU,SAAQ,QAAqB;IAClD,YAAmB,KAAe;QAChC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACzE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAEhE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;CACF"}

package/transpiled/directives/map/Map.d.ts

@@ -0,0 +1,15 @@
+import { Property } from './Properties.ts';
+import { Mapping } from './Mapping.ts';
+import type { Directive } from './Directive.ts';
+import type { DirectiveFamily, Parameter } from '../../RTD/index.ts';
+import type { Input, Output } from '../../io.ts';
+import type { Introspection } from '../../Introspection.ts';
+import type { Remotes } from '../../Remotes.ts';
+export declare class Map implements DirectiveFamily {
+    readonly name = "map";
+    readonly mandatory = false;
+    private remotes;
+    create(name: string, value: unknown, remotes: Remotes): Property | Mapping;
+    explain(directives: Directive[], introspection: Introspection): Introspection;
+    precall(directives: Directive[], context: Input, parameters: Parameter[]): Promise<Output>;
+}