@toa.io/extensions.exposition 1.0.0-alpha.31 → 1.0.0-alpha.310

package/transpiled/directives/auth/Echo.js

@@ -1,13 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Echo = void 0;
-class Echo {
-    authorize(identity) {
-        return identity !== null;
+import { create } from './create.js';
+export class Echo {
+    authorize(identity, context) {
+        if (identity === null && 'authorization' in context.request.headers)
+            return false;
+        context.identity ??= create();
+        return true;
     }
-    reply(identity) {
-        return { body: identity };
+    /** What `authorize` answers, without inventing the identity it would go on to invent. */
+    admits(identity, context) {
+        return !(identity === null && 'authorization' in context.request.headers);
+    }
+    reply(context) {
+        const body = context.identity;
+        return body.scheme === null ? { status: 201, body } : { body };
     }
 }
-exports.Echo = Echo;
 //# sourceMappingURL=Echo.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Echo.js","sourceRoot":"","sources":["../../../source/directives/auth/Echo.ts"],"names":[],"mappings":";;;AAGA,MAAa,IAAI;IACR,SAAS,CAAE,QAAyB;QACzC,OAAO,QAAQ,KAAK,IAAI,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAE,QAAyB;QACrC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IAC3B,CAAC;CACF;AARD,oBAQC"}
+{"version":3,"file":"Echo.js","sourceRoot":"","sources":["../../../source/directives/auth/Echo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIpC,MAAM,OAAO,IAAI;IACR,SAAS,CAAC,QAAyB,EAAE,OAAgB;QAC1D,IAAI,QAAQ,KAAK,IAAI,IAAI,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,KAAK,CAAA;QAEjF,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAA;QAE7B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,yFAAyF;IAClF,MAAM,CAAC,QAAyB,EAAE,OAAgB;QACvD,OAAO,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3E,CAAC;IAEM,KAAK,CAAC,OAAgB;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAS,CAAA;QAE9B,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;IAChE,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+import type { Directive, Identity, Context } from './types.ts';
+import type { Introspection } from '../../Introspection.ts';
+import type { Parameter } from '../../RTD/index.ts';
+export declare class Federation implements Directive {
+    private readonly matchers;
+    constructor(options: Options);
+    /** Which claims it takes needs the request; that it takes an identity does not. */
+    admits(identity: Identity | null): boolean | undefined;
+    /** Which claims is the application's business; that it takes an identity is the caller's. */
+    describe(introspection: Introspection): Introspection;
+    authorize(identity: Identity | null, context: Context, parameters: Parameter[]): boolean;
+}
+interface Claims {
+    iss: string;
+    sub: string;
+    aud: string | string[];
+}
+interface Options extends Partial<Claims> {
+    iss: string;
+}
+export {};

package/transpiled/directives/auth/Federation.js

@@ -0,0 +1,54 @@
+export class Federation {
+    matchers;
+    constructor(options) {
+        this.matchers = Object.entries(options).map(([key, value]) => [key, toMatcher(value)]);
+        if (this.matchers.length === 0)
+            throw new Error('`auth:claims` requires at least one property defined');
+    }
+    /** Which claims it takes needs the request; that it takes an identity does not. */
+    admits(identity) {
+        return identity === null ? false : undefined;
+    }
+    /** Which claims is the application's business; that it takes an identity is the caller's. */
+    describe(introspection) {
+        return { ...introspection, authenticated: true };
+    }
+    authorize(identity, context, parameters) {
+        if (identity === null || !('claims' in identity))
+            return false;
+        const claims = identity.claims;
+        for (const [key, match] of this.matchers)
+            if (!match(claims[key], context, parameters))
+                return false;
+        return true;
+    }
+}
+function toMatcher(expression) {
+    if (expression.startsWith(':')) {
+        const key = expression.slice(1);
+        if (key === 'authority')
+            return (value, context) => matches(value, context[key]);
+        if (key === 'domain')
+            return (value, context) => {
+                return Array.isArray(value)
+                    ? value.some((iss) => codomain(iss, context))
+                    : codomain(value, context);
+            };
+        throw new Error('Unknown `auth:claims` syntax: ' + expression);
+    }
+    if (expression.startsWith('/:')) {
+        const name = expression.slice(2);
+        return (value, _, parameters) => parameters.some((parameter) => parameter.name === name && matches(value, parameter.value));
+    }
+    return (value) => matches(value, expression);
+}
+function matches(value, reference) {
+    return Array.isArray(value) ? value.includes(reference) : value === reference;
+}
+function codomain(iss, context) {
+    const hostname = new URL(iss).hostname;
+    const dot = hostname.indexOf('.');
+    const basename = dot === -1 ? hostname : hostname.slice(dot);
+    return context.authority.slice(-basename.length) === basename;
+}
+//# sourceMappingURL=Federation.js.map

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

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

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

@@ -1,7 +1,16 @@
-import { type Parameter } from '../../RTD';
-import { type Directive, type Identity } from './types';
+import { type Parameter } from '../../RTD/index.ts';
+import { type Directive, type Identity } from './types.ts';
+import type { Introspection } from '../../Introspection.ts';
 export declare class Id implements Directive {
     private readonly parameter;
     constructor(parameter: string);
-    authorize(identity: Identity | null, _: any, parameters: Parameter[]): boolean;
+    /**
+     * Whether it is *this* identity's cannot be told from a description, which has no route
+     * variable to read — but that there must be an identity at all can, and a caller with
+     * none is refused whatever the value would have been.
+     */
+    admits(identity: Identity | null): boolean | undefined;
+    /** Reaching it is being the identity it is about, which is what `private` says. */
+    describe(introspection: Introspection): Introspection;
+    authorize(identity: Identity | null, _: unknown, parameters: Parameter[]): boolean;
 }

package/transpiled/directives/auth/Id.js

@@ -1,11 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Id = void 0;
-class Id {
+export class Id {
     parameter;
     constructor(parameter) {
         this.parameter = parameter;
     }
+    /**
+     * Whether it is *this* identity's cannot be told from a description, which has no route
+     * variable to read — but that there must be an identity at all can, and a caller with
+     * none is refused whatever the value would have been.
+     */
+    admits(identity) {
+        return identity === null ? false : undefined;
+    }
+    /** Reaching it is being the identity it is about, which is what `private` says. */
+    describe(introspection) {
+        return { ...introspection, private: true };
+    }
     authorize(identity, _, parameters) {
         if (identity === null)
             return false;
@@ -13,5 +22,4 @@ class Id {
         return parameter?.value === identity.id;
     }
 }
-exports.Id = Id;
 //# sourceMappingURL=Id.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Id.js","sourceRoot":"","sources":["../../../source/directives/auth/Id.ts"],"names":[],"mappings":";;;AAGA,MAAa,EAAE;IACI,SAAS,CAAQ;IAElC,YAAoB,SAAiB;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAEM,SAAS,CAAE,QAAyB,EAAE,CAAM,EAAE,UAAuB;QAC1E,IAAI,QAAQ,KAAK,IAAI;YACnB,OAAO,KAAK,CAAA;QAEd,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,CAAA;QAEnF,OAAO,SAAS,EAAE,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAA;IACzC,CAAC;CACF;AAfD,gBAeC"}
+{"version":3,"file":"Id.js","sourceRoot":"","sources":["../../../source/directives/auth/Id.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,EAAE;IACI,SAAS,CAAQ;IAElC,YAAmB,SAAiB;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,QAAyB;QACrC,OAAO,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9C,CAAC;IAED,mFAAmF;IAC5E,QAAQ,CAAC,aAA4B;QAC1C,OAAO,EAAE,GAAG,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC5C,CAAC;IAEM,SAAS,CACd,QAAyB,EACzB,CAAU,EACV,UAAuB;QAEvB,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAA;QAEnC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,CAAA;QAEnF,OAAO,SAAS,EAAE,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAA;IACzC,CAAC;CACF"}

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

@@ -1,10 +1,15 @@
-import * as http from '../../HTTP';
-import { type Directive, type Discovery, type Identity, type Input } from './types';
+import * as http from '../../HTTP/index.ts';
+import type { Directive, Discovery, Identity, Context } from './types.ts';
 export declare class Incept implements Directive {
+    private static readonly components;
+    private static discovery;
+    private static bans;
     private readonly property;
-    private readonly discovery;
-    private readonly schemes;
     constructor(property: string, discovery: Discovery);
-    authorize(identity: Identity | null, input: Input): boolean;
-    settle(input: Input, response: http.OutgoingMessage): Promise<void>;
+    static incept(context: Context, id: string): Promise<Identity>;
+    /** Credentials that were rejected for any reason but being unknown are not incepted. */
+    static acceptable(context: Context): boolean;
+    authorize(identity: Identity | null, context: Context): boolean;
+    reply(context: Context): http.OutgoingMessage | null;
+    settle(context: Context, response: http.OutgoingMessage): Promise<void>;
 }

package/transpiled/directives/auth/Incept.js

@@ -1,64 +1,82 @@
-"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;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Incept = void 0;
-const http = __importStar(require("../../HTTP"));
-const split_1 = require("./split");
-const schemes_1 = require("./schemes");
-class Incept {
+import { console } from 'openspan';
+import * as http from '../../HTTP/index.js';
+import { split } from './split.js';
+import { create } from './create.js';
+import { INCEPTION, UNKNOWN, providers as providersOf } from './schemes.js';
+import { Role } from './Role.js';
+export class Incept {
+    static components = {};
+    static discovery;
+    static bans = null;
     property;
-    discovery;
-    schemes = {};
     constructor(property, discovery) {
+        if (!(property === null || typeof property === 'string'))
+            throw new Error('`auth:incept` value must be a string or null');
         this.property = property;
-        this.discovery = discovery;
-    }
-    authorize(identity, input) {
-        return identity === null && 'authorization' in input.request.headers;
+        Incept.discovery ??= discovery;
     }
-    async settle(input, response) {
-        const id = response.body?.[this.property];
-        if (id === undefined)
-            throw new http.Conflict('Identity inception has failed as the response body ' +
-                ` does not contain the '${this.property}' property.`);
-        const [scheme, credentials] = (0, split_1.split)(input.request.headers.authorization);
-        const provider = schemes_1.PROVIDERS[scheme];
-        this.schemes[scheme] ??= await this.discovery[provider];
-        const identity = await this.schemes[scheme]
-            .invoke('incept', {
+    static async incept(context, id) {
+        const [scheme, credentials] = split(context.request.headers.authorization);
+        const candidates = providersOf(scheme);
+        if (candidates === undefined)
+            throw new http.BadRequest('Authentication scheme is not supported');
+        // a scheme several providers claim is incepted by the one that incepts; `Bearer`
+        // carries an access token this gateway issued, and an identity cannot be incepted
+        // from a credential it would itself have to exist to hold
+        const provider = candidates.find((candidate) => INCEPTION.includes(candidate));
+        if (provider === undefined)
+            throw new http.Unauthorized();
+        Incept.bans ??= await Incept.discovery.bans;
+        const ban = await Incept.bans.invoke('observe', { query: { id } });
+        if (ban.banned)
+            throw new http.Unauthorized();
+        Incept.components[provider] ??= await Incept.discovery[provider];
+        const identity = await Incept.components[provider].invoke('incept', {
             input: {
-                authority: input.authority,
+                scheme,
+                authority: context.authority,
                 id,
                 credentials
             }
         });
         if (identity instanceof Error)
             throw new http.UnprocessableEntity(identity);
-        input.identity = identity;
-        input.identity.scheme = scheme;
+        identity.scheme = scheme;
+        // the roles are read where the token is minted: an Identity incepted as the principal
+        // has one already
+        return identity;
+    }
+    /** Credentials that were rejected for any reason but being unknown are not incepted. */
+    static acceptable(context) {
+        return (context.request.headers.authorization === undefined || context.rejection === UNKNOWN);
+    }
+    authorize(identity, context) {
+        return identity === null && Incept.acceptable(context);
+    }
+    reply(context) {
+        if (this.property !== null)
+            return null;
+        const body = create(context.request.headers.authorization);
+        return { body };
+    }
+    async settle(context, response) {
+        const id = response.body?.[this.property ?? 'id'];
+        if (id === undefined) {
+            console.debug('Inception skipped: response does not contain expected property', {
+                property: this.property,
+                response
+            });
+            return;
+        }
+        if (typeof id !== 'string')
+            throw new Error(`Response body property "${this.property}" expected to be a string`);
+        if (context.request.headers.authorization !== undefined)
+            context.identity = await Incept.incept(context, id);
+        else {
+            const identity = { id, scheme: null, refresh: true };
+            const roles = await Role.get(identity, Incept.discovery.roles);
+            context.identity = { ...identity, roles };
+        }
     }
 }
-exports.Incept = Incept;
 //# sourceMappingURL=Incept.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Incept.js","sourceRoot":"","sources":["../../../source/directives/auth/Incept.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,iDAAkC;AAElC,mCAA+B;AAC/B,uCAAqC;AAErC,MAAa,MAAM;IACA,QAAQ,CAAQ;IAChB,SAAS,CAAW;IACpB,OAAO,GAAY,EAAwB,CAAA;IAE5D,YAAoB,QAAgB,EAAE,SAAoB;QACxD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAEM,SAAS,CAAE,QAAyB,EAAE,KAAY;QACvD,OAAO,QAAQ,KAAK,IAAI,IAAI,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAA;IACtE,CAAC;IAEM,KAAK,CAAC,MAAM,CAAE,KAAY,EAAE,QAA8B;QAC/D,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEzC,IAAI,EAAE,KAAK,SAAS;YAClB,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,qDAAqD;gBAC3E,0BAA0B,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAA;QAEzD,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAA,aAAK,EAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAc,CAAC,CAAA;QACzE,MAAM,QAAQ,GAAG,mBAAS,CAAC,MAAM,CAAC,CAAA;QAElC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAEvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;aACxC,MAAM,CAAkB,QAAQ,EAAE;YACnC,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,EAAE;gBACF,WAAW;aACZ;SACF,CAAC,CAAA;QAEF,IAAI,QAAQ,YAAY,KAAK;YAC3B,MAAM,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QAE9C,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACzB,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAA;IAChC,CAAC;CACF;AAzCD,wBAyCC"}
+{"version":3,"file":"Incept.js","sourceRoot":"","sources":["../../../source/directives/auth/Incept.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+import type { Parameter } from '../../RTD/index.ts';
+import type { Context, Directive, Identity, Create } from './types.ts';
+export declare class Input implements Directive {
+    priority: number;
+    private readonly statements;
+    constructor(declarations: Declaration[], create: Create);
+    /** It admits nobody: it says what a body may carry, not who may send one. */
+    admits(): boolean;
+    authorize(identity: Identity | null, context: Context, parameters: Parameter[]): Promise<boolean>;
+    private check;
+}
+export interface Declaration {
+    [key: Exclude<string, 'prop'>]: unknown;
+    prop: string | string[];
+}

package/transpiled/directives/auth/Input.js

@@ -0,0 +1,49 @@
+import { Forbidden } from '../../HTTP/index.js';
+export class Input {
+    priority = 0;
+    statements = [];
+    constructor(declarations, create) {
+        this.statements = declarations.map((declaration) => new Statement(declaration, create));
+    }
+    /** It admits nobody: it says what a body may carry, not who may send one. */
+    admits() {
+        return false;
+    }
+    async authorize(identity, context, parameters) {
+        context.pipelines.body.push(async (body) => this.check(identity, context, parameters, body));
+        return false;
+    }
+    // eslint-disable-next-line max-params
+    async check(identity, context, parameters, body) {
+        if (body === undefined || body === null || body.constructor !== Object)
+            return body;
+        const settled = await Promise.allSettled(this.statements.map(async (statement) => statement.check(identity, context, parameters, body)));
+        for (const result of settled)
+            if (result.status === 'rejected')
+                throw result.reason;
+        return body;
+    }
+}
+class Statement {
+    properties;
+    directives = [];
+    constructor({ prop, ...directives }, create) {
+        this.properties = typeof prop === 'string' ? [prop] : prop;
+        for (const [name, value] of Object.entries(directives)) {
+            const directive = create(name, value);
+            this.directives.push(directive);
+        }
+    }
+    // eslint-disable-next-line max-params
+    async check(identity, context, parameters, body) {
+        const match = this.properties.some((property) => property in body);
+        if (!match)
+            return;
+        for (const directive of this.directives) {
+            const authorized = await directive.authorize(identity, context, parameters);
+            if (!authorized)
+                throw new Forbidden('Input property is not authorized');
+        }
+    }
+}
+//# sourceMappingURL=Input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Input.js","sourceRoot":"","sources":["../../../source/directives/auth/Input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAI/C,MAAM,OAAO,KAAK;IACT,QAAQ,GAAG,CAAC,CAAA;IACF,UAAU,GAAgB,EAAE,CAAA;IAE7C,YAAmB,YAA2B,EAAE,MAAc;QAC5D,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,CAChC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,CACpD,CAAA;IACH,CAAC;IAED,6EAA6E;IACtE,MAAM;QACX,OAAO,KAAK,CAAA;IACd,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,QAAyB,EACzB,OAAgB,EAChB,UAAuB;QAEvB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACzC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAChD,CAAA;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED,sCAAsC;IAC9B,KAAK,CAAC,KAAK,CACjB,QAAyB,EACzB,OAAgB,EAChB,UAAuB,EACvB,IAAa;QAEb,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM;YAAE,OAAO,IAAI,CAAA;QAEnF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CACtC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAY,CAAC,CAC7D,CACF,CAAA;QAED,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAA;QAEnF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,MAAM,SAAS;IACI,UAAU,CAAU;IACpB,UAAU,GAAgB,EAAE,CAAA;IAE7C,YAAmB,EAAE,IAAI,EAAE,GAAG,UAAU,EAAe,EAAE,MAAc;QACrE,IAAI,CAAC,UAAU,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAE1D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAErC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,sCAAsC;IAC/B,KAAK,CAAC,KAAK,CAChB,QAAyB,EACzB,OAAgB,EAChB,UAAuB,EACvB,IAAU;QAEV,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAA;QAElE,IAAI,CAAC,KAAK;YAAE,OAAM;QAElB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;YAE3E,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;CACF"}

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

@@ -1,14 +1,23 @@
 import { type Component } from '@toa.io/core';
-import { type Directive, type Identity } from './types';
-import type { Parameter } from '../../RTD';
+import { type Directive, type Identity } from './types.ts';
+import type { Parameter } from '../../RTD/index.ts';
+import type { Introspection } from '../../Introspection.ts';
 export declare class Role implements Directive {
     static remote: Component | null;
     private readonly roles;
     private readonly discovery;
     private readonly dynamic;
     constructor(roles: string | string[], discovery: Promise<Component>);
-    static set(identity: Identity, discovery: Promise<Component>): Promise<void>;
+    static get(identity: Identity, discovery: Promise<Component>): Promise<string[]>;
+    /**
+     * Reaching it takes a role, which is what `protected` says. A role of the `system` scope
+     * says so besides: what it guards is the machinery an application runs on rather than
+     * anything it serves, and a reader has no business being offered it as one.
+     */
+    describe(introspection: Introspection): Introspection;
     authorize(identity: Identity | null, _: unknown, parameters: Parameter[]): Promise<boolean>;
+    /** A role naming a route variable cannot be told from a description, which has no values. */
+    admits(identity: Identity | null): Promise<boolean | undefined>;
     private match;
     private substitute;
 }

package/transpiled/directives/auth/Role.js

@@ -1,11 +1,5 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Role = void 0;
-const node_assert_1 = __importDefault(require("node:assert"));
-class Role {
+import { quote } from '@toa.io/generic';
+export class Role {
     static remote = null;
     roles;
     discovery;
@@ -15,22 +9,38 @@ class Role {
         this.discovery = discovery;
         this.dynamic = this.roles.some((role) => role.includes('{'));
     }
-    static async set(identity, discovery) {
+    static async get(identity, discovery) {
         this.remote ??= await discovery;
         const query = {
-            criteria: `identity==${identity.id}`,
+            criteria: `identity==${quote(identity.id)}`,
             limit: 1024
         };
-        identity.roles = await this.remote.invoke('list', { query });
+        return await this.remote.invoke('list', { query });
+    }
+    /**
+     * Reaching it takes a role, which is what `protected` says. A role of the `system` scope
+     * says so besides: what it guards is the machinery an application runs on rather than
+     * anything it serves, and a reader has no business being offered it as one.
+     */
+    describe(introspection) {
+        const system = this.roles.some((role) => role === SYSTEM || role.startsWith(SYSTEM + ':'));
+        return { ...introspection, protected: true, ...(system ? { system: true } : {}) };
     }
     async authorize(identity, _, parameters) {
         if (identity === null)
             return false;
-        await Role.set(identity, this.discovery);
-        if (identity.roles.length === 0) // Role.set()
-            return false;
+        identity.roles ??= await Role.get(identity, this.discovery);
         return this.match(identity.roles, parameters);
     }
+    /** A role naming a route variable cannot be told from a description, which has no values. */
+    async admits(identity) {
+        if (this.dynamic)
+            return undefined;
+        if (identity === null)
+            return false;
+        identity.roles ??= await Role.get(identity, this.discovery);
+        return this.match(identity.roles, []);
+    }
     match(roles, parameters) {
         const required = this.dynamic ? this.substitute(parameters) : this.roles;
         for (const role of roles) {
@@ -43,10 +53,12 @@ class Role {
     substitute(parameters) {
         return this.roles.map((role) => role.replaceAll(/{(\w+)}/g, (_, key) => {
             const value = parameters.find((parameter) => parameter.name === key)?.value;
-            node_assert_1.default.ok(value !== undefined, `Role '${role}' requires '${key}' route parameter.`);
+            if (value === undefined)
+                throw new Error(`Role '${role}' requires '${key}' route parameter`);
             return value;
         }));
     }
 }
-exports.Role = Role;
+/** The scope of what an application runs on, as opposed to what it serves. */
+const SYSTEM = 'system';
 //# sourceMappingURL=Role.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../source/directives/auth/Role.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAgC;AAKhC,MAAa,IAAI;IACR,MAAM,CAAC,MAAM,GAAqB,IAAI,CAAA;IAC5B,KAAK,CAAU;IACf,SAAS,CAAoB;IAC7B,OAAO,CAAS;IAEjC,YAAoB,KAAwB,EAAE,SAA6B;QACzE,IAAI,CAAC,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QACxD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAE,QAAkB,EAAE,SAA6B;QACxE,IAAI,CAAC,MAAM,KAAK,MAAM,SAAS,CAAA;QAE/B,MAAM,KAAK,GAAU;YACnB,QAAQ,EAAE,aAAa,QAAQ,CAAC,EAAE,EAAE;YACpC,KAAK,EAAE,IAAI;SACZ,CAAA;QAED,QAAQ,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9D,CAAC;IAEM,KAAK,CAAC,SAAS,CACrB,QAAyB,EAAE,CAAU,EAAE,UAAuB;QAC7D,IAAI,QAAQ,KAAK,IAAI;YACnB,OAAO,KAAK,CAAA;QAEd,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QAExC,IAAI,QAAQ,CAAC,KAAM,CAAC,MAAM,KAAK,CAAC,EAAE,aAAa;YAE7C,OAAO,KAAK,CAAA;QAEd,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAM,EAAE,UAAU,CAAC,CAAA;IAChD,CAAC;IAEO,KAAK,CAAE,KAAe,EAAE,UAAuB;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAA;QAExE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAA;YAE5F,IAAI,EAAE;gBACJ,OAAO,IAAI,CAAA;QACf,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,UAAU,CAAE,UAAuB;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YACrE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,CAAA;YAE3E,qBAAM,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,EAC3B,SAAS,IAAI,eAAe,GAAG,oBAAoB,CAAC,CAAA;YAEtD,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;;AA3DH,oBA4DC"}
+{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../source/directives/auth/Role.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,12 @@
-import { type Parameter } from '../../RTD';
-import type { Input, Directive, Identity } from './types';
+import { type Parameter } from '../../RTD/index.ts';
+import type { Introspection } from '../../Introspection.ts';
+import type { Context, Directive, Identity, Create } from './types.ts';
 export declare class Rule implements Directive {
     private readonly directives;
     constructor(directives: Record<string, any>, create: Create);
-    authorize(identity: Identity | null, input: Input, parameters: Parameter[]): Promise<boolean>;
+    authorize(identity: Identity | null, context: Context, parameters: Parameter[]): Promise<boolean>;
+    /** Whatever each of them makes of it, in the order they were declared. */
+    describe(introspection: Introspection): Introspection;
+    /** All of them, so one that refuses ends it and one that cannot tell leaves it untold. */
+    admits(identity: Identity | null, context: Context): Promise<boolean | undefined>;
 }
-type Create = (name: string, value: any, ...args: any[]) => Directive;
-export {};

package/transpiled/directives/auth/Rule.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Rule = void 0;
-class Rule {
+export class Rule {
     directives = [];
     constructor(directives, create) {
         for (const [name, value] of Object.entries(directives)) {
@@ -9,14 +6,33 @@ class Rule {
             this.directives.push(directive);
         }
     }
-    async authorize(identity, input, parameters) {
+    async authorize(identity, context, parameters) {
         for (const directive of this.directives) {
-            const authorized = await directive.authorize(identity, input, parameters);
+            const authorized = await directive.authorize(identity, context, parameters);
             if (!authorized)
                 return false;
         }
         return true;
     }
+    /** Whatever each of them makes of it, in the order they were declared. */
+    describe(introspection) {
+        for (const directive of this.directives)
+            introspection = directive.describe?.(introspection) ?? introspection;
+        return introspection;
+    }
+    /** All of them, so one that refuses ends it and one that cannot tell leaves it untold. */
+    async admits(identity, context) {
+        let untold = false;
+        for (const directive of this.directives) {
+            const admits = await directive.admits?.(identity, context);
+            if (admits === undefined) {
+                untold = true;
+                continue;
+            }
+            if (!admits)
+                return false;
+        }
+        return untold ? undefined : true;
+    }
 }
-exports.Rule = Rule;
 //# sourceMappingURL=Rule.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../../source/directives/auth/Rule.ts"],"names":[],"mappings":";;;AAGA,MAAa,IAAI;IACE,UAAU,GAAgB,EAAE,CAAA;IAE7C,YAAoB,UAA+B,EAAE,MAAc;QACjE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAErC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,SAAS,CACrB,QAAyB,EAAE,KAAY,EAAE,UAAuB;QAC/D,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;YAEzE,IAAI,CAAC,UAAU;gBACb,OAAO,KAAK,CAAA;QAChB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAtBD,oBAsBC"}
+{"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../../source/directives/auth/Rule.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,IAAI;IACE,UAAU,GAAgB,EAAE,CAAA;IAE7C,YAAmB,UAA+B,EAAE,MAAc;QAChE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAErC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,QAAyB,EACzB,OAAgB,EAChB,UAAuB;QAEvB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;YAE3E,IAAI,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAA;QAC/B,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0EAA0E;IACnE,QAAQ,CAAC,aAA4B;QAC1C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU;YACrC,aAAa,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,IAAI,aAAa,CAAA;QAEtE,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,0FAA0F;IACnF,KAAK,CAAC,MAAM,CACjB,QAAyB,EACzB,OAAgB;QAEhB,IAAI,MAAM,GAAG,KAAK,CAAA;QAElB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAE1D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,IAAI,CAAA;gBAEb,SAAQ;YACV,CAAC;YAED,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAA;QAC3B,CAAC;QAED,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;IAClC,CAAC;CACF"}

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

@@ -1,7 +1,9 @@
-import { type Directive, type Identity, type Input } from './types';
+import { type Directive, type Identity, type Context } from './types.ts';
 export declare class Scheme implements Directive {
     private readonly scheme;
     private readonly Scheme;
     constructor(scheme: string);
-    authorize(_: Identity | null, input: Input): boolean;
+    authorize(_: Identity | null, context: Context): boolean;
+    /** It admits nobody: it is there to refuse a scheme, not to authorize one. */
+    admits(): boolean;
 }