@toa.io/extensions.exposition 1.0.0-alpha.3 → 1.0.0-alpha.300

package/transpiled/directives/auth/Anonymous.d.ts

@@ -1,6 +1,21 @@
-import { type Directive, type Input } from './types';
+import { type Directive, type Context } from './types.js';
+import type { Introspection } from '../../Introspection.js';
 export declare class Anonymous implements Directive {
     private readonly allow;
     constructor(allow: boolean);
-    authorize(_: any, input: Input): boolean;
+    /**
+     * A credential refuses, because it would make the reply uncacheable — which is the whole
+     * of the rule, and none of it applies to a procedure, nor to a description. What a
+     * procedure answers is a value in an envelope, and the envelope is the one thing that is
+     * cached or not; what a description answers is what the resource is, which is not the
+     * reply a cache would hold and varies by who asked in any case.
+     */
+    authorize(_: any, context: Context): boolean;
+    admits(_: any, context: Context): boolean;
+    /**
+     * That nothing guards it is something said rather than something left unsaid: it is also
+     * what refuses a caller presenting a credential, and a client with one has to know which
+     * methods not to present it to.
+     */
+    describe(introspection: Introspection): Introspection;
 }

package/transpiled/directives/auth/Anonymous.js

@@ -1,17 +1,30 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Anonymous = void 0;
-class Anonymous {
+export class Anonymous {
     allow;
     constructor(allow) {
         this.allow = allow;
     }
-    authorize(_, input) {
-        if ('authorization' in input.headers)
-            return false;
-        else
+    /**
+     * A credential refuses, because it would make the reply uncacheable — which is the whole
+     * of the rule, and none of it applies to a procedure, nor to a description. What a
+     * procedure answers is a value in an envelope, and the envelope is the one thing that is
+     * cached or not; what a description answers is what the resource is, which is not the
+     * reply a cache would hold and varies by who asked in any case.
+     */
+    authorize(_, context) {
+        if (context.procedural || context.exploratory)
             return this.allow;
+        return 'authorization' in context.request.headers ? false : this.allow;
+    }
+    admits(_, context) {
+        return this.authorize(_, context);
+    }
+    /**
+     * That nothing guards it is something said rather than something left unsaid: it is also
+     * what refuses a caller presenting a credential, and a client with one has to know which
+     * methods not to present it to.
+     */
+    describe(introspection) {
+        return this.allow ? { ...introspection, anonymous: true } : introspection;
     }
 }
-exports.Anonymous = Anonymous;
 //# sourceMappingURL=Anonymous.js.map

package/transpiled/directives/auth/Anonymous.js.map

@@ -1 +1 @@
-{"version":3,"file":"Anonymous.js","sourceRoot":"","sources":["../../../source/directives/auth/Anonymous.ts"],"names":[],"mappings":";;;AAEA,MAAa,SAAS;IACH,KAAK,CAAS;IAE/B,YAAoB,KAAc;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,SAAS,CAAE,CAAM,EAAE,KAAY;QACpC,IAAI,eAAe,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,KAAK,CAAA;;YAC7C,OAAO,IAAI,CAAC,KAAK,CAAA;IACxB,CAAC;CACF;AAXD,8BAWC"}
+{"version":3,"file":"Anonymous.js","sourceRoot":"","sources":["../../../source/directives/auth/Anonymous.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACH,KAAK,CAAS;IAE/B,YAAmB,KAAc;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED;;;;;;OAMG;IACI,SAAS,CAAC,CAAM,EAAE,OAAgB;QACvC,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,KAAK,CAAA;QAEhE,OAAO,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAA;IACxE,CAAC;IAEM,MAAM,CAAC,CAAM,EAAE,OAAgB;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,aAA4B;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAA;IAC3E,CAAC;CACF"}

package/transpiled/directives/auth/Anyone.d.ts

@@ -0,0 +1,10 @@
+import { type Directive, type Context } from './types.js';
+import type { Introspection } from '../../Introspection.js';
+export declare class Anyone implements Directive {
+    private readonly allow;
+    constructor(allow: boolean);
+    authorize(_: any, context: Context): boolean;
+    admits(_: any, context: Context): boolean;
+    /** Whoever asks, as long as they are somebody. */
+    describe(introspection: Introspection): Introspection;
+}

package/transpiled/directives/auth/Anyone.js

@@ -0,0 +1,17 @@
+export class Anyone {
+    allow;
+    constructor(allow) {
+        this.allow = allow;
+    }
+    authorize(_, context) {
+        return context.identity !== null && this.allow;
+    }
+    admits(_, context) {
+        return this.authorize(_, context);
+    }
+    /** Whoever asks, as long as they are somebody. */
+    describe(introspection) {
+        return this.allow ? { ...introspection, authenticated: true } : introspection;
+    }
+}
+//# sourceMappingURL=Anyone.js.map

package/transpiled/directives/auth/Anyone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Anyone.js","sourceRoot":"","sources":["../../../source/directives/auth/Anyone.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,MAAM;IACA,KAAK,CAAS;IAE/B,YAAmB,KAAc;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,SAAS,CAAC,CAAM,EAAE,OAAgB;QACvC,OAAO,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAA;IAChD,CAAC;IAEM,MAAM,CAAC,CAAM,EAAE,OAAgB;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,kDAAkD;IAC3C,QAAQ,CAAC,aAA4B;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAA;IAC/E,CAAC;CACF"}

package/transpiled/directives/auth/Assert.d.ts

@@ -0,0 +1,9 @@
+import type { Context, Directive, Identity } from './types.js';
+export declare class Assert implements Directive {
+    private readonly disabled;
+    constructor(enabled: boolean);
+    /** It admits nobody: it is there to require a credential, not to authorize one. */
+    admits(): boolean;
+    authorize(identity: Identity | null, context: Context): Promise<boolean>;
+    private incept;
+}

package/transpiled/directives/auth/Assert.js

@@ -0,0 +1,33 @@
+import { newid } from '@toa.io/generic';
+import * as http from '../../HTTP/index.js';
+import { Incept } from './Incept.js';
+export class Assert {
+    disabled;
+    constructor(enabled) {
+        if (typeof enabled !== 'boolean')
+            throw new Error('`auth:assert` directive value must be a boolean');
+        this.disabled = !enabled;
+    }
+    /** It admits nobody: it is there to require a credential, not to authorize one. */
+    admits() {
+        return false;
+    }
+    async authorize(identity, context) {
+        if (!this.disabled)
+            await this.incept(context, identity);
+        return false;
+    }
+    async incept(context, identity) {
+        if (context.request.headers.authorization === undefined)
+            throw new http.Unauthorized();
+        if (identity === null) {
+            if (!Incept.acceptable(context))
+                throw new http.Unauthorized();
+            context.identity = await Incept.incept(context, newid());
+            context.pipelines.response.push((response) => {
+                response.status = 201;
+            });
+        }
+    }
+}
+//# sourceMappingURL=Assert.js.map

package/transpiled/directives/auth/Assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Assert.js","sourceRoot":"","sources":["../../../source/directives/auth/Assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,MAAM,OAAO,MAAM;IACA,QAAQ,CAAS;IAElC,YAAmB,OAAgB;QACjC,IAAI,OAAO,OAAO,KAAK,SAAS;YAC9B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QAEpE,IAAI,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAA;IAC1B,CAAC;IAED,mFAAmF;IAC5E,MAAM;QACX,OAAO,KAAK,CAAA;IACd,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,QAAyB,EAAE,OAAgB;QAChE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAExD,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAgB,EAAE,QAAyB;QAC9D,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YAAE,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAA;QAEtF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAA;YAE9D,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;YAExD,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC3C,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAA;YACvB,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}

package/transpiled/directives/auth/Authorization.d.ts

@@ -1,20 +1,61 @@
-import * as http from '../../HTTP';
-import type { Output } from '../../io';
-import type { Remotes } from '../../Remotes';
-import type { Family } from '../../Directive';
-import type { Parameter } from '../../RTD';
-import type { Directive, Extension, Input } from './types';
-export declare class Authorization implements Family<Directive, Extension> {
+import * as http from '../../HTTP/index.js';
+import type { Output } from '../../io.js';
+import type { Introspection } from '../../Introspection.js';
+import type { Remotes } from '../../Remotes.js';
+import type { Parameter, DirectiveFamily } from '../../RTD/index.js';
+import type { Host } from '../../Factory.js';
+import type { Directive, Extension, Context } from './types.js';
+export declare class Authorization implements DirectiveFamily<Directive, Extension> {
     readonly depends: string[];
     readonly name: string;
     readonly mandatory: boolean;
-    private readonly schemes;
+    private readonly components;
     private readonly discovery;
     private tokens;
     private bans;
+    /** Failed authentications per address, reconciled with the other gateways. */
+    private meter;
+    private sync;
+    mount(host: Host, options: http.Options): void;
+    dispose(): void;
     create(name: string, value: any, remotes: Remotes): Directive;
-    preflight(directives: Directive[], input: Input, parameters: Parameter[]): Promise<Output>;
-    settle(directives: Directive[], request: Input, response: http.OutgoingMessage): Promise<void>;
+    arrange(directives: Directive[]): void;
+    /**
+     * Authentication: who the credential names, if one is presented. A credential belongs to
+     * the request, so it is read once however many calls the request carries.
+     */
+    preflight(context: Context): Promise<void>;
+    /** Authorization: whether that identity may make this call, which every call asks anew. */
+    precall(directives: Directive[], context: Context, parameters: Parameter[]): Promise<Output>;
+    /**
+     * The same disjunction as `precall`, over what can be told without a request. A method no
+     * directive admits, and none is undecided about, is not this caller's to be told about —
+     * `null` takes it out of the answer.
+     *
+     * A permission is matched against a path, and a description is not a request to one, so
+     * `permits` has no say here. The call it describes is still checked, which is where a
+     * token's permissions belong.
+     *
+     * A method that is described is then described by each of them, which is a separate pass:
+     * admission is a disjunction and stops at the first that admits, while what the directives
+     * fill is not any one of them's to state alone.
+     */
+    explain(directives: Directive[], context: Context, introspection: Introspection): Promise<Introspection | null>;
+    settle(directives: Directive[], context: Context, response: http.OutgoingMessage): Promise<void>;
+    /**
+     * Re-issuing a credential, and refusing a ban, are the request's business: the header
+     * carries one token however many calls were made, and a ban refuses all of them.
+     */
+    depart(context: Context, response: http.OutgoingMessage): Promise<void>;
     private resolve;
+    private permitted;
     private banned;
 }
+/** Whether the permissions admit the method on the path the request is routed by. */
+export declare function permits(permissions: Record<string, string[]>, method: string, pathname: string): boolean;
+/**
+ * Whether the request is one the token's `aud` was issued for. A path is a prefix of the
+ * entry; an origin (empty or `/`) is every path on that host. A URI whose host is not
+ * this request's is not this resource.
+ */
+export declare function audience(audiences: string[], url: URL): boolean;

package/transpiled/directives/auth/Authorization.js

@@ -1,125 +1,303 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Authorization = void 0;
-const node_assert_1 = __importDefault(require("node:assert"));
-const matchacho_1 = require("matchacho");
-const http = __importStar(require("../../HTTP"));
-const Anonymous_1 = require("./Anonymous");
-const Id_1 = require("./Id");
-const Role_1 = require("./Role");
-const Rule_1 = require("./Rule");
-const Incept_1 = require("./Incept");
-const Echo_1 = require("./Echo");
-const split_1 = require("./split");
-const Scheme_1 = require("./Scheme");
-const schemes_1 = require("./schemes");
-class Authorization {
+import { match } from 'matchacho';
+import { console } from 'openspan';
+import { Minimatch } from 'minimatch';
+import * as http from '../../HTTP/index.js';
+import { Anonymous } from './Anonymous.js';
+import { Id } from './Id.js';
+import { Role } from './Role.js';
+import { Rule } from './Rule.js';
+import { Incept } from './Incept.js';
+import { Assert } from './Assert.js';
+import { Echo } from './Echo.js';
+import { Scheme } from './Scheme.js';
+import { Delegate } from './Delegate.js';
+import { Federation } from './Federation.js';
+import { Anyone } from './Anyone.js';
+import { Input } from './Input.js';
+import { split } from './split.js';
+import { PRIMARY, UNRECOGNIZED, providers as providersOf } from './schemes.js';
+import { ATOM_GROUP } from '@toa.io/definitions/extensions.exposition';
+import { Quotas, Sync } from '../io/lib/throttle/index.js';
+import { Keys } from '../io/lib/throttle/Keys.js';
+export class Authorization {
     depends = ['Vary'];
     name = 'auth';
     mandatory = true;
-    schemes = {};
+    components = {};
     discovery = {};
     tokens = null;
     bans = null;
+    /** Failed authentications per address, reconciled with the other gateways. */
+    meter = null;
+    sync = null;
+    mount(host, options) {
+        this.sync?.dispose();
+        this.sync = null;
+        this.meter = null;
+        const bouncer = options.bouncer;
+        // keyed by address, which is the deployment's to name, so off until it is set
+        if (bouncer === undefined)
+            return;
+        this.meter = new Quotas({
+            keys: Keys.create([{ method: 'ip', options: BOUNCER }]),
+            requests: bouncer.attempts ?? ATTEMPTS,
+            interval: (bouncer.interval ?? INTERVAL) * 1000,
+            conditional: true, // charged on a rejection, not on a check
+            name: METER
+        });
+        this.sync = new Sync(host.atom(ATOM_GROUP));
+        this.sync.register(this.meter);
+    }
+    dispose() {
+        this.sync?.dispose();
+    }
     create(name, value, remotes) {
-        node_assert_1.default.ok(name in CLASSES, `Directive '${name}' is not provided by the '${this.name}' family.`);
-        const Class = CLASSES[name];
+        if (!(name in constructors))
+            throw new Error(`Directive 'auth:${name}' is not implemented`);
+        const Class = constructors[name];
         for (const name of REMOTES)
             this.discovery[name] ??= remotes.discover('identity', name);
-        return (0, matchacho_1.match)(Class, Role_1.Role, () => new Role_1.Role(value, this.discovery.roles), Rule_1.Rule, () => new Rule_1.Rule(value, this.create.bind(this)), Incept_1.Incept, () => new Incept_1.Incept(value, this.discovery), () => new Class(value));
+        return match(Class, Role, () => new Role(value, this.discovery.roles), Rule, () => new Rule(value, this.create.bind(this)), Input, () => new Input(value, this.create.bind(this)), Incept, () => new Incept(value, this.discovery), Delegate, () => new Delegate(value, this.discovery.roles), () => new Class(value));
+    }
+    arrange(directives) {
+        directives.sort((a, b) => (a.priority ?? 1) - (b.priority ?? 1));
+    }
+    /**
+     * Authentication: who the credential names, if one is presented. A credential belongs to
+     * the request, so it is read once however many calls the request carries.
+     */
+    async preflight(context) {
+        context.identity = await this.resolve(context);
+        // the outer request, not a procedure it forks: `aud` is where this credential may
+        // appear, and a tool call is still the request to `/.mcp`
+        if (context.identity?.aud !== undefined &&
+            !audience(context.identity.aud, context.url))
+            throw new http.Unauthorized();
     }
-    async preflight(directives, input, parameters) {
-        const identity = await this.resolve(input.headers.authorization);
-        input.identity = identity;
+    /** Authorization: whether that identity may make this call, which every call asks anew. */
+    async precall(directives, context, parameters) {
         for (const directive of directives) {
-            const allow = await directive.authorize(identity, input, parameters);
+            const allow = await directive.authorize(context.identity, context, parameters);
             if (allow)
-                return directive.reply?.(identity) ?? null;
+                if (this.permitted(context))
+                    return directive.reply?.(context) ?? null;
+                else
+                    throw new http.Forbidden();
         }
-        if (identity === null)
+        if (context.identity === null)
             throw new http.Unauthorized();
         else
             throw new http.Forbidden();
     }
-    async settle(directives, request, response) {
+    /**
+     * The same disjunction as `precall`, over what can be told without a request. A method no
+     * directive admits, and none is undecided about, is not this caller's to be told about —
+     * `null` takes it out of the answer.
+     *
+     * A permission is matched against a path, and a description is not a request to one, so
+     * `permits` has no say here. The call it describes is still checked, which is where a
+     * token's permissions belong.
+     *
+     * A method that is described is then described by each of them, which is a separate pass:
+     * admission is a disjunction and stops at the first that admits, while what the directives
+     * fill is not any one of them's to state alone.
+     */
+    async explain(directives, context, introspection) {
+        let untold = false;
+        let admitted = false;
+        for (const directive of directives) {
+            const admits = await directive.admits?.(context.identity, context);
+            if (admits === undefined) {
+                untold = true;
+                continue;
+            }
+            if (admits) {
+                admitted = true;
+                break;
+            }
+        }
+        if (!admitted && !untold)
+            return null;
+        // whichever of them admitted, a property any of them fills from the identity is filled
+        // from the identity: what a caller sent there would be overwritten or forged
         for (const directive of directives)
-            await directive.settle?.(request, response);
-        const identity = request.identity;
+            introspection = directive.describe?.(introspection) ?? introspection;
+        return introspection;
+    }
+    async settle(directives, context, response) {
+        await Promise.all(directives.map(async (directive) => directive.settle?.(context, response)));
+    }
+    /**
+     * Re-issuing a credential, and refusing a ban, are the request's business: the header
+     * carries one token however many calls were made, and a ban refuses all of them.
+     */
+    async depart(context, response) {
+        const identity = context.identity;
         if (identity === null)
             return;
-        if (identity.scheme === schemes_1.PRIMARY && !identity.refresh)
+        if (identity.provider === PRIMARY && !identity.refresh)
             return;
-        // Role directive may have already set the value
-        if (identity.roles === undefined)
-            await Role_1.Role.set(identity, this.discovery.roles);
+        // resolving already asked, for any provider but the primary
+        if (context.vetted !== true && (await this.banned(identity)))
+            throw new http.Unauthorized();
+        // a token carries the roles it was issued with, and the refresh is where they are read again;
+        // any other scheme has just read them, unless a Role directive already did
+        if (identity.provider === PRIMARY)
+            identity.roles = await Role.get(identity, this.discovery.roles);
+        else
+            identity.roles ??= await Role.get(identity, this.discovery.roles);
         this.tokens ??= await this.discovery.tokens;
-        const token = await this.tokens.invoke('encrypt', { input: { identity } });
+        const token = await this.tokens.invoke('encrypt', {
+            input: { authority: context.authority, identity }
+        });
         const authorization = `Token ${token}`;
-        if (response.headers === undefined)
-            response.headers = new Headers();
+        response.headers ??= new Headers();
         response.headers.set('authorization', authorization);
+        response.headers.set('cache-control', 'no-store');
     }
-    async resolve(authorization) {
+    async resolve(context) {
+        const { authority } = context;
+        const { authorization } = context.request.headers;
         if (authorization === undefined)
             return null;
-        const [scheme, credentials] = (0, split_1.split)(authorization);
-        const provider = schemes_1.PROVIDERS[scheme];
-        if (!(provider in this.discovery))
-            throw new http.Unauthorized(`Unknown authentication scheme '${scheme}'.`);
-        this.schemes[scheme] ??= await this.discovery[provider];
-        const result = await this.schemes[scheme].invoke('authenticate', {
-            input: credentials
-        });
-        if (result instanceof Error)
+        const retry = this.meter?.check(context, NONE) ?? 0;
+        if (retry > 0)
+            throw new http.TooManyRequests(retry);
+        const [scheme, credentials] = split(authorization);
+        const candidates = providersOf(scheme);
+        if (candidates === undefined)
+            throw new http.Unauthorized(`Unknown authentication scheme '${scheme}'`);
+        let provider = null;
+        let result = null;
+        // the first provider that does not decline has claimed the credentials, and answers
+        // for them: a rejection from one that never recognized them is not the rejection
+        for (const candidate of candidates) {
+            this.components[candidate] ??= await this.discovery[candidate];
+            const answer = await this.components[candidate].invoke('authenticate', {
+                input: {
+                    scheme,
+                    authority,
+                    credentials
+                }
+            });
+            if (declined(answer))
+                continue;
+            provider = candidate;
+            result = answer;
+            break;
+        }
+        if (result === null || result instanceof Error) {
+            const code = result === null ? UNRECOGNIZED : codeOf(result);
+            if (code !== undefined) {
+                console.info('Authentication failed', { code });
+                context.rejection = code;
+            }
+            this.meter?.use(context, null);
             return null;
+        }
         const identity = result.identity;
-        if (scheme !== schemes_1.PRIMARY && (await this.banned(identity)))
-            throw new http.Unauthorized();
+        if (provider !== PRIMARY) {
+            if (await this.banned(identity))
+                throw new http.Unauthorized();
+            context.vetted = true;
+        }
         identity.scheme = scheme;
+        identity.provider = provider;
         identity.refresh = result.refresh;
         return identity;
     }
+    permitted(context) {
+        const permissions = context.identity?.permissions;
+        if (permissions === undefined)
+            return true;
+        // the route is matched on the normalized path, so the permission is too
+        return permits(permissions, context.request.method, context.url.pathname);
+    }
     async banned(identity) {
         this.bans ??= await this.discovery.bans;
         const ban = await this.bans.invoke('observe', { query: { id: identity.id } });
         return ban.banned;
     }
 }
-exports.Authorization = Authorization;
-const CLASSES = {
-    anonymous: Anonymous_1.Anonymous,
-    id: Id_1.Id,
-    role: Role_1.Role,
-    rule: Rule_1.Rule,
-    incept: Incept_1.Incept,
-    scheme: Scheme_1.Scheme,
-    echo: Echo_1.Echo
+/** Whether a provider says the credentials are not of its kind, so the next is asked. */
+function declined(result) {
+    return result instanceof Error && codeOf(result) === UNRECOGNIZED;
+}
+function codeOf(result) {
+    const code = result.code;
+    return typeof code === 'string' ? code : undefined;
+}
+/** Whether the permissions admit the method on the path the request is routed by. */
+export function permits(permissions, method, pathname) {
+    return Object.entries(permissions).some(([pattern, methods]) => methods.some((allowed) => allowed === '*' || allowed === method) &&
+        glob(pattern).match(pathname));
+}
+/**
+ * Whether the request is one the token's `aud` was issued for. A path is a prefix of the
+ * entry; an origin (empty or `/`) is every path on that host. A URI whose host is not
+ * this request's is not this resource.
+ */
+export function audience(audiences, url) {
+    return audiences.some((value) => covers(value, url));
+}
+function covers(value, url) {
+    if (value.startsWith('/'))
+        return prefixed(value, url.pathname);
+    let resource;
+    try {
+        resource = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (resource.hostname !== url.hostname)
+        return false;
+    return prefixed(resource.pathname, url.pathname);
+}
+function prefixed(declared, pathname) {
+    const prefix = declared.endsWith('/') ? declared.slice(0, -1) : declared;
+    if (prefix === '')
+        return true;
+    return pathname === prefix || pathname.startsWith(prefix + '/');
+}
+/**
+ * `minimatch(str, pattern)` compiles the pattern on every call, and a permission is
+ * matched on every request the identity makes. Patterns arrive with an identity, hence
+ * the bound.
+ */
+function glob(pattern) {
+    let compiled = GLOBS.get(pattern);
+    if (compiled === undefined) {
+        if (GLOBS.size >= GLOBS_LIMIT)
+            GLOBS.clear();
+        compiled = new Minimatch(pattern);
+        GLOBS.set(pattern, compiled);
+    }
+    return compiled;
+}
+/** What an address may fail at once, and the seconds it takes to earn them back. */
+const ATTEMPTS = 20;
+const INTERVAL = 60;
+/** Who is speaking when a request cannot be keyed. */
+const BOUNCER = 'Authentication bouncer';
+/** The meter's name in the atom: `atom:exposition:meter:credentials:<address>`. */
+const METER = 'credentials';
+const NONE = [];
+const GLOBS = new Map();
+const GLOBS_LIMIT = 1024;
+const constructors = {
+    anonymous: Anonymous,
+    anyone: Anyone,
+    id: Id,
+    role: Role,
+    rule: Rule,
+    incept: Incept,
+    assert: Assert,
+    scheme: Scheme,
+    echo: Echo,
+    delegate: Delegate,
+    claims: Federation,
+    input: Input
 };
-const REMOTES = ['basic', 'federation', 'tokens', 'roles', 'bans'];
+const REMOTES = ['basic', 'federation', 'tokens', 'roles', 'bans', 'otp'];
 //# sourceMappingURL=Authorization.js.map