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

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

@@ -0,0 +1,70 @@
+import { console } from 'openspan';
+/**
+ * Reconciles every quota of the process with the other gateways, on one tick.
+ *
+ * Nothing here is on the request path. Each tick takes what the quotas have spent since
+ * the last one and sends all of it as a single call, so the cost of staying in step is
+ * one round trip a tick — not one per key, and not one per directive. What comes back is
+ * the debt the whole group has reached, which the quotas then decide on locally.
+ */
+export class Sync {
+    atom;
+    quotas = [];
+    timer = null;
+    period = Infinity;
+    /** Ticks do not overlap: a slow round trip delays reconciling, it does not double it. */
+    reconciling = false;
+    constructor(atom) {
+        this.atom = atom;
+    }
+    register(quotas) {
+        this.quotas.push(quotas);
+        // the shortest interval sets the pace, and reconciling the others more often than
+        // they asked for only makes them more accurate — an idle quota contributes nothing
+        if (quotas.period < this.period) {
+            this.period = quotas.period;
+            this.start();
+        }
+    }
+    dispose() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    start() {
+        this.dispose();
+        this.timer = setInterval(this.tick, this.period);
+        this.timer.unref();
+    }
+    tick = () => {
+        if (this.reconciling)
+            return;
+        const now = Date.now();
+        const batch = [];
+        for (const quotas of this.quotas)
+            quotas.flush(now, batch);
+        if (batch.length === 0)
+            return;
+        this.reconciling = true;
+        void this.reconcile(batch).finally(() => {
+            this.reconciling = false;
+        });
+    };
+    async reconcile(batch) {
+        try {
+            const keys = batch.map((entry) => entry.quotas.name(entry.key));
+            const deltas = batch.map((entry) => entry.delta);
+            const debts = await this.atom.meter(keys, deltas);
+            const now = Date.now();
+            for (let i = 0; i < batch.length; i++)
+                batch[i].quotas.settled(batch[i], debts[i], now);
+        }
+        catch (error) {
+            // what was not reported stays to be reported by the next tick, and until then
+            // this gateway keeps throttling on what it alone has seen, and keeps serving
+            console.warn('Throttling could not reconcile with the group', error);
+        }
+    }
+}
+//# sourceMappingURL=Sync.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * A warning about a condition that holds for request after request, written once per
+ * `interval` rather than once per request.
+ */
+export declare class Warning {
+    private readonly message;
+    private readonly interval;
+    private last;
+    constructor(message: string, interval?: number);
+    emit(attributes?: Record<string, unknown>): void;
+}

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

@@ -0,0 +1,24 @@
+import { console } from 'openspan';
+/**
+ * A warning about a condition that holds for request after request, written once per
+ * `interval` rather than once per request.
+ */
+export class Warning {
+    message;
+    interval;
+    last = -Infinity;
+    constructor(message, interval = INTERVAL) {
+        this.message = message;
+        this.interval = interval;
+    }
+    emit(attributes) {
+        const now = Date.now();
+        if (now - this.last < this.interval)
+            return;
+        this.last = now;
+        console.warn(this.message, attributes);
+    }
+}
+/** 100 seconds */
+const INTERVAL = 100_000;
+//# sourceMappingURL=Warning.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Warning.js","sourceRoot":"","sources":["../../../../../source/directives/io/lib/throttle/Warning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAElC;;;GAGG;AACH,MAAM,OAAO,OAAO;IACD,OAAO,CAAQ;IACf,QAAQ,CAAQ;IACzB,IAAI,GAAG,CAAC,QAAQ,CAAA;IAExB,YAAoB,OAAe,EAAE,WAAmB,QAAQ;QAC9D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,IAAI,CAAE,UAAoC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEtB,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ;YACjC,OAAM;QAER,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;QAEf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IACxC,CAAC;CACF;AAED,kBAAkB;AAClB,MAAM,QAAQ,GAAG,OAAO,CAAA"}

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

@@ -0,0 +1,6 @@
+import type { Parameter } from '../../../../../RTD/index.js';
+import type { Input as Context } from '../../../../../io.js';
+export interface Component {
+    /** what to key on, or nothing when the request cannot be keyed by this component */
+    get: (context: Context, parameters: Parameter[]) => string | undefined;
+}

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

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

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

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

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

@@ -0,0 +1,14 @@
+import type { Context } from '../../../../../HTTP/index.js';
+import type { Component } from './Component.js';
+/**
+ * The client address, as the request context resolved it; see `documentation/ip.md`.
+ *
+ * A request without one cannot be keyed, so it is let through, and whoever keys on the
+ * address says so — once in a while rather than on every request, because the cause is
+ * the deployment, not the request.
+ */
+export declare class IP implements Component {
+    private readonly warning;
+    constructor(options: unknown, route: string);
+    get(context: Context): string | undefined;
+}

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

@@ -0,0 +1,24 @@
+import { Warning } from '../Warning.js';
+/**
+ * The client address, as the request context resolved it; see `documentation/ip.md`.
+ *
+ * A request without one cannot be keyed, so it is let through, and whoever keys on the
+ * address says so — once in a while rather than on every request, because the cause is
+ * the deployment, not the request.
+ */
+export class IP {
+    warning;
+    constructor(options, route) {
+        const subject = typeof options === 'string' ? options : throttle(route);
+        this.warning = new Warning(`${subject} is not in effect: the request has no ip`);
+    }
+    get(context) {
+        if (context.ip === undefined)
+            this.warning.emit();
+        return context.ip;
+    }
+}
+function throttle(route) {
+    return route === '' ? 'Throttle' : `Throttle of ${route}`;
+}
+//# sourceMappingURL=IP.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IP.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/components/IP.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAIvC;;;;;;GAMG;AACH,MAAM,OAAO,EAAE;IACI,OAAO,CAAS;IAEjC,YAAoB,OAAgB,EAAE,KAAa;QACjD,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAEvE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,OAAO,0CAA0C,CAAC,CAAA;IAClF,CAAC;IAEM,GAAG,CAAE,OAAgB;QAC1B,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QAErB,OAAO,OAAO,CAAC,EAAE,CAAA;IACnB,CAAC;CACF;AAED,SAAS,QAAQ,CAAE,KAAa;IAC9B,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,KAAK,EAAE,CAAA;AAC3D,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { Input } from '../../../../../io.js';
+import type { Component } from './Component.js';
+/**
+ * The authenticated identity, or nothing when the request carries none.
+ *
+ * Anonymous requests therefore share one quota between them; `ip` is the component
+ * that tells them apart.
+ */
+export declare class Identity implements Component {
+    get(context: Input): string;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * The authenticated identity, or nothing when the request carries none.
+ *
+ * Anonymous requests therefore share one quota between them; `ip` is the component
+ * that tells them apart.
+ */
+export class Identity {
+    get(context) {
+        return context.identity?.id ?? '';
+    }
+}
+//# sourceMappingURL=Identity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Identity.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/components/Identity.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,QAAQ;IACZ,GAAG,CAAE,OAAc;QACxB,OAAQ,OAAgC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAA;IAC7D,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+import type { Context } from '../../../../../HTTP/index.js';
+import type { Component } from './Component.js';
+export declare class Path implements Component {
+    get(context: Context): string;
+}

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

@@ -0,0 +1,6 @@
+export class Path {
+    get(context) {
+        return context.url.pathname;
+    }
+}
+//# sourceMappingURL=Path.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Path.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/components/Path.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,IAAI;IACR,GAAG,CAAE,OAAgB;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAA;IAC7B,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+import type { Component } from './Component.js';
+/**
+ * The route as declared — `/users/:id` — rather than the path a request came in on.
+ *
+ * A constant per method, resolved when the tree is built, so every request to one
+ * route shares a quota however many concrete paths match it.
+ */
+export declare class Route implements Component {
+    private readonly route;
+    constructor(_: unknown, route: string);
+    get(): string;
+}

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

@@ -0,0 +1,16 @@
+/**
+ * The route as declared — `/users/:id` — rather than the path a request came in on.
+ *
+ * A constant per method, resolved when the tree is built, so every request to one
+ * route shares a quota however many concrete paths match it.
+ */
+export class Route {
+    route;
+    constructor(_, route) {
+        this.route = route;
+    }
+    get() {
+        return this.route;
+    }
+}
+//# sourceMappingURL=Route.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Route.js","sourceRoot":"","sources":["../../../../../../source/directives/io/lib/throttle/components/Route.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IACC,KAAK,CAAQ;IAE9B,YAAoB,CAAU,EAAE,KAAa;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,GAAG;QACR,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+import type { Parameter } from '../../../../../RTD/index.js';
+import type { Input as Context } from '../../../../../io.js';
+import type { Component } from './Component.js';
+/** 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 @@
+import assert from 'node:assert';
+/** The value a named route segment was bound to, or nothing when the route has none. */
+export class Segment {
+    name;
+    constructor(name) {
+        assert.ok(typeof name === 'string', '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":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAKhC,wFAAwF;AACxF,MAAM,OAAO,OAAO;IACD,IAAI,CAAQ;IAE7B,YAAoB,IAAa;QAC/B,MAAM,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,EAAE,mCAAmC,CAAC,CAAA;QAExE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,GAAG,CAAE,CAAU,EAAE,UAAuB;QAC7C,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.js';
+import type { Component } from './Component.js';
+type Constructor<T> = new (options: unknown, route: string) => T;
+export declare const Components: Record<KeyComponentMethod, Constructor<Component>>;
+export type { 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;AAMtC,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.js';
+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.js';
+import type { Condition } from './Condition.js';
+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 @@
+import assert from 'node:assert';
+export class Status {
+    status;
+    constructor(status) {
+        assert.ok(typeof status === 'number', '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":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAIhC,MAAM,OAAO,MAAM;IACA,MAAM,CAAQ;IAE/B,YAAoB,MAAe;QACjC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,EAAE,yBAAyB,CAAC,CAAA;QAEhE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEM,KAAK,CAAE,KAAY,EAAE,MAAc;QACxC,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.js';
+import type { Condition } from './Condition.js';
+type Constructor<T> = new (options: unknown) => T;
+export declare const Conditions: Record<KeyConditionMethod, Constructor<Condition>>;
+export type { 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;AAMpC,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.js';
+export { Sync } from './Sync.js';
+export { Warning } from './Warning.js';
+export { parse, type Configuration, type Declaration } from './Configuration.js';

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.js';
+import type { Permissions as OutputPermissions } from './Output.js';
+import type { Declaration as ThrottleDeclaration } from './lib/throttle/index.js';
+import type { Message } from './Message.js';
 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,MAAM,CAAC,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.js';
+import type { Input } from '../../io.js';
+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 assert from 'node:assert';
+import { Mapping } from './Mapping.js';
+export class Authority extends Mapping {
+    constructor(property) {
+        assert.ok(typeof property === 'string', '`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,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,MAAM,OAAO,SAAU,SAAQ,OAAe;IAC5C,YAAoB,QAAgB;QAClC,MAAM,CAAC,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ,EAAE,kCAAkC,CAAC,CAAA;QAE3E,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC;IAEM,UAAU,CAAE,OAAc;QAC/B,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.js';
+import type { Input } from '../../io.js';
+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 assert from 'node:assert';
+import { Mapping } from './Mapping.js';
+export class BufferMapping extends Mapping {
+    constructor(property) {
+        assert.ok(typeof property === 'string', '`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,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,MAAM,OAAO,aAAc,SAAQ,OAAe;IAChD,YAAoB,QAAgB;QAClC,MAAM,CAAC,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ,EAAE,+BAA+B,CAAC,CAAA;QAExE,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjB,CAAC;IAEe,KAAK,CAAC,UAAU,CAAE,OAAc;QAC9C,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.js';
+import type { Remotes } from '../../Remotes.js';
+import type { Input } from '../../io.js';
+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,37 @@
+import assert from 'node:assert';
+import { Mapping } from './Mapping.js';
+export class Claims extends Mapping {
+    discovery;
+    federation = null;
+    constructor(map, remotes) {
+        assert.ok(map.constructor === Object, '`map:claims` must be an object');
+        assert.ok(Object.values(map).every((value) => typeof value === 'string'), '`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,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAKtC,MAAM,OAAO,MAAO,SAAQ,OAA+B;IACxC,SAAS,CAAqB;IACvC,UAAU,GAAqB,IAAI,CAAA;IAE3C,YAAoB,GAA2B,EAAE,OAAgB;QAC/D,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,gCAAgC,CAAC,CAAA;QAEvE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EACtE,oDAAoD,CAAC,CAAA;QAEvD,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,CAAE,OAAc;QAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAA;QAE5D,IAAI,cAAc,KAAK,SAAS;YAC9B,OAAO,IAAI,CAAA;QAEb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAEhD,IAAI,MAAM,KAAK,IAAI;YACjB,OAAO,IAAI,CAAA;QAEb,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,UAAkC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;YACjG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;YAE3B,IAAI,KAAK,KAAK,SAAS;gBACrB,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;YAE9B,OAAO,UAAU,CAAA;QACnB,CAAC,EAAE,EAAE,CAAC,CAAA;IACR,CAAC;IAEO,KAAK,CAAC,MAAM,CAAE,cAAsB;QAC1C,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAEvD,IAAI,MAAM,KAAK,QAAQ,IAAI,WAAW,KAAK,SAAS;YAClD,OAAO,IAAI,CAAA;QAEb,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAExC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAiC,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;QAE7G,IAAI,MAAM,YAAY,KAAK;YACzB,OAAO,IAAI,CAAA;QAEb,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+import type { Mapping } from './Mapping.js';
+import type { Property } from './Properties.js';
+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,7 @@
+import { Mapping } from './Mapping.js';
+import type { Input } from '../../io.js';
+export declare class Headers extends Mapping<Record<string, string>> {
+    private readonly headers;
+    constructor(map: Record<string, string>);
+    properties(context: Input): Record<string, string>;
+}

package/transpiled/directives/map/Headers.js

@@ -0,0 +1,33 @@
+import assert from 'node:assert';
+import { cors } from '../cors/index.js';
+import { Mapping } from './Mapping.js';
+/**
+ * Forbidden request header names: the browser sets them itself and a script cannot
+ * list them in `Access-Control-Request-Headers`, so there is nothing to advertise
+ * or vary on. The value is still read, it just never reaches CORS.
+ */
+const FORBIDDEN = new Set(['host', 'origin']);
+export class Headers extends Mapping {
+    headers;
+    constructor(map) {
+        assert.ok(map.constructor === Object, '`map:headers` must be an object');
+        assert.ok(Object.values(map).every((value) => typeof value === 'string'), '`map:headers` must be an object with string values');
+        super(map);
+        this.headers = Object.values(map).filter((header) => !FORBIDDEN.has(header));
+        this.headers.forEach((header) => cors.allow(header));
+    }
+    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];
+            if (value !== undefined)
+                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,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE7C,MAAM,OAAO,OAAQ,SAAQ,OAA+B;IACzC,OAAO,CAAU;IAElC,YAAoB,GAA2B;QAC7C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,iCAAiC,CAAC,CAAA;QAExE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EACtE,oDAAoD,CAAC,CAAA;QAEvD,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,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACtD,CAAC;IAEM,UAAU,CAAE,OAAc;QAC/B,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;gBAC/B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,UAAkC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;YAClG,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAE7C,IAAI,KAAK,KAAK,SAAS;gBACrB,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;YAExE,OAAO,UAAU,CAAA;QACnB,CAAC,EAAE,EAAE,CAAC,CAAA;IACR,CAAC;CACF"}