@toa.io/extensions.exposition 1.0.0-alpha.32 → 1.0.0-alpha.321

package/transpiled/Discovery/Site.js.map

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

package/transpiled/Discovery/index.d.ts

@@ -0,0 +1,3 @@
+export { Explorer } from './Explorer.ts';
+export { Site } from './Site.ts';
+export { looking } from './trunk.ts';

package/transpiled/Discovery/index.js

@@ -0,0 +1,4 @@
+export { Explorer } from './Explorer.js';
+export { Site } from './Site.js';
+export { looking } from './trunk.js';
+//# sourceMappingURL=index.js.map

package/transpiled/Discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/Discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/transpiled/Discovery/tree.d.ts

@@ -0,0 +1,28 @@
+import { type Described } from '../directives/help/index.ts';
+import type * as http from '../HTTP/index.ts';
+import type { Tree } from '../RTD/index.ts';
+/**
+ * Every route in the tree this caller may reach, keyed by the template it answers at, and
+ * each described exactly as `OPTIONS` on that path describes it — so a key can be taken
+ * from the answer and sent back as a request.
+ *
+ * A route a name cannot spell is here, unlike at `/.rpc` and `/.mcp`: HTTP addresses a
+ * route by its path, so leaving one out would make this disagree with the router. A
+ * resource no method of which this caller may reach is not here at all — `OPTIONS` answers
+ * `403` to one, and an empty entry would still say it exists.
+ *
+ * Sorted, because a branch is merged whenever its tenant answers and two replicas would
+ * otherwise order the same tree differently. Verbs keep the order they were declared in,
+ * which is the order `OPTIONS` answers them in.
+ */
+export declare function describe(tree: Tree, request: http.Context): Promise<Discovered>;
+/** What the tree answers. An object, so that what is said of the whole of it has somewhere to go. */
+export interface Discovered {
+    routes: Record<string, Resource>;
+    /** Where MCP is served for the authority asked, where that is a host of its own. */
+    mcp?: string;
+}
+/** What one resource is, and what it serves; a verb is upper case, and nothing else here is. */
+export interface Resource extends Described {
+    [verb: string]: unknown;
+}

package/transpiled/Discovery/tree.js

@@ -0,0 +1,50 @@
+import { describing } from '../Introspection.js';
+import { template } from '../RPC/names.js';
+import { variables } from '../RTD/segment.js';
+import { guarded, resource } from '../directives/help/index.js';
+/**
+ * Every route in the tree this caller may reach, keyed by the template it answers at, and
+ * each described exactly as `OPTIONS` on that path describes it — so a key can be taken
+ * from the answer and sent back as a request.
+ *
+ * A route a name cannot spell is here, unlike at `/.rpc` and `/.mcp`: HTTP addresses a
+ * route by its path, so leaving one out would make this disagree with the router. A
+ * resource no method of which this caller may reach is not here at all — `OPTIONS` answers
+ * `403` to one, and an empty entry would still say it exists.
+ *
+ * Sorted, because a branch is merged whenever its tenant answers and two replicas would
+ * otherwise order the same tree differently. Verbs keep the order they were declared in,
+ * which is the order `OPTIONS` answers them in.
+ */
+export async function describe(tree, request) {
+    const context = describing(request);
+    const routes = new Map();
+    /*
+     * Sequentially: there is no I/O to overlap — an endpoint's own description is read once
+     * and memoized — so awaiting the whole tree at once would only allocate every clone of
+     * it at the same moment.
+     */
+    for (const { segments, verb, method } of tree.walk()) {
+        const introspection = await method.explain(context, variables(segments));
+        if (introspection === null)
+            continue;
+        const route = template(segments);
+        let mounted = routes.get(route);
+        if (mounted === undefined) {
+            mounted = { described: resource(method.directives), methods: {} };
+            routes.set(route, mounted);
+        }
+        // two declarations can walk to one template — `/a/b` and `/a: { /b: }` — and the walk
+        // is in the order `match` tries them, so the first is the one a request would reach
+        mounted.methods[verb] ??= introspection;
+    }
+    const described = {};
+    for (const route of Array.from(routes.keys()).sort()) {
+        const { described: stated, methods } = routes.get(route);
+        // what the resource is, beside the methods it serves; a verb is upper case and cannot
+        // collide with either key
+        described[route] = { ...stated, ...guarded(methods), ...methods };
+    }
+    return { routes: described };
+}
+//# sourceMappingURL=tree.js.map

package/transpiled/Discovery/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../source/Discovery/tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,6BAA6B,CAAA;AAK/E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAU,EAAE,OAAqB;IAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAA;IAEzC;;;;OAIG;IACH,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACrD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;QAExE,IAAI,aAAa,KAAK,IAAI;YAAE,SAAQ;QAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChC,IAAI,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAE/B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;YACjE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC5B,CAAC;QAED,sFAAsF;QACtF,oFAAoF;QACpF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,aAAa,CAAA;IACzC,CAAC;IAED,MAAM,SAAS,GAA6B,EAAE,CAAA;IAE9C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACrD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAE,CAAA;QAEzD,sFAAsF;QACtF,0BAA0B;QAC1B,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAA;IACnE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC9B,CAAC"}

package/transpiled/Discovery/trunk.d.ts

@@ -0,0 +1,13 @@
+import type { Context, OutgoingMessage } from '../HTTP/index.ts';
+/**
+ * Where a browser that asked for the trunk is sent. An application serves what it declares,
+ * and `/` is usually not one of those — a person who typed the address into a browser is
+ * looking for something to look at, and the page is the only thing here that is one.
+ *
+ * A client that asked for something in particular gets what it asked for: only an `accept`
+ * that prefers a page, or one that names no preference at all, is sent here. The second is
+ * what an unfurler sends — several ask for anything, and a link to an application would
+ * otherwise show nothing — and what `curl` sends, which the page serves no worse than the
+ * `405` it used to get.
+ */
+export declare function looking(context: Context): OutgoingMessage | null;

package/transpiled/Discovery/trunk.js

@@ -0,0 +1,29 @@
+import Negotiator from 'negotiator';
+import { types } from '../HTTP/formats/index.js';
+import { DISCOVERY } from '@toa.io/definitions/extensions.exposition';
+/** What a browser asks for, and what nothing else here answers with. */
+const HTML = 'text/html';
+/**
+ * Where a browser that asked for the trunk is sent. An application serves what it declares,
+ * and `/` is usually not one of those — a person who typed the address into a browser is
+ * looking for something to look at, and the page is the only thing here that is one.
+ *
+ * A client that asked for something in particular gets what it asked for: only an `accept`
+ * that prefers a page, or one that names no preference at all, is sent here. The second is
+ * what an unfurler sends — several ask for anything, and a link to an application would
+ * otherwise show nothing — and what `curl` sends, which the page serves no worse than the
+ * `405` it used to get.
+ */
+export function looking(context) {
+    if (context.request.method !== 'GET' || context.procedural)
+        return null;
+    const accept = context.request.headers.accept;
+    if (accept !== undefined && accept.trim() !== ANYTHING) {
+        if (new Negotiator(context.request).mediaType([...types, HTML]) !== HTML)
+            return null;
+    }
+    return { status: 302, headers: new Headers({ location: DISCOVERY + '/' }) };
+}
+/** An `accept` that names nothing, which is the same as naming none. */
+const ANYTHING = '*/*';
+//# sourceMappingURL=trunk.js.map

package/transpiled/Discovery/trunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trunk.js","sourceRoot":"","sources":["../../source/Discovery/trunk.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAA;AAGrE,wEAAwE;AACxE,MAAM,IAAI,GAAG,WAAW,CAAA;AAExB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAEvE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAA;IAE7C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACvD,IAAI,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;IACvF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,GAAG,GAAG,EAAE,CAAC,EAAE,CAAA;AAC7E,CAAC;AAED,wEAAwE;AACxE,MAAM,QAAQ,GAAG,KAAK,CAAA"}

package/transpiled/Endpoint.d.ts

@@ -1,16 +1,30 @@
-import { type Component } from '@toa.io/core';
-import { type Remotes } from './Remotes';
-import { Mapping } from './Mapping';
-import { type Context } from './Context';
-import * as http from './HTTP';
-import type * as RTD from './RTD';
+import { Mapping } from './Mapping.ts';
+import * as http from './HTTP/index.ts';
+import type { Introspection, Schema } from './Introspection.ts';
+import type { Remote } from '@toa.io/core';
+import type { Remotes } from './Remotes.ts';
+import type { Context } from './Context.ts';
+import type * as RTD from './RTD/index.ts';
 export declare class Endpoint implements RTD.Endpoint {
     private readonly endpoint;
     private readonly mapping;
     private readonly discovery;
     private remote;
-    constructor(endpoint: string, mapping: Mapping, discovery: Promise<Component>);
-    call(context: http.Context, parameters: RTD.Parameter[]): Promise<http.OutgoingMessage>;
+    /** Whether the method this serves is a safe one, which `io:readonly` overrides per request. */
+    private readonly safe;
+    /** What the operation says, with what the route takes already split out of it. */
+    private introspection;
+    constructor(endpoint: string, mapping: Mapping, discovery: Promise<Remote>, safe?: boolean);
+    call(context: http.Context & Authenticated, parameters: RTD.Parameter[]): Promise<http.OutgoingMessage>;
+    selection(): Record<string, Schema> | null;
+    explain(parameters: RTD.Parameter[]): Promise<Introspection>;
+    /**
+     * `Remote.explain` answers the contract's own object, whose `input` is the manifest's by
+     * reference. What follows takes properties out of it, and two routes mounting one endpoint
+     * share one remote — so the copy is what keeps the second from describing what the first
+     * took away.
+     */
+    private introspect;
     close(): Promise<void>;
     private query;
     private version;
@@ -20,3 +34,13 @@ export declare class EndpointsFactory implements RTD.EndpointsFactory {
     constructor(remotes: Remotes);
     create(method: RTD.syntax.Method, context: Context): Endpoint;
 }
+/**
+ * What the auth family leaves on the context, as much of it as this reads. Declared here rather
+ * than imported, the way `cache` declares its own: the property is that family's.
+ */
+interface Authenticated {
+    identity?: {
+        id: string;
+    } | null;
+}
+export {};

package/transpiled/Endpoint.js

@@ -1,103 +1,177 @@
-"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.EndpointsFactory = exports.Endpoint = void 0;
-const Mapping_1 = require("./Mapping");
-const http = __importStar(require("./HTTP"));
-class Endpoint {
+import { Readable } from 'node:stream';
+import { entities } from '@toa.io/core';
+import { Mapping } from './Mapping.js';
+import { take } from './Introspection.js';
+import { parse } from './directives/cache/etag.js';
+import * as http from './HTTP/index.js';
+/** What a reply may travel as bytes in, which is the one format a component encodes. */
+const JSON_TYPE = 'application/json';
+export class Endpoint {
     endpoint;
     mapping;
     discovery;
     remote = null;
-    constructor(endpoint, mapping, discovery) {
+    /** Whether the method this serves is a safe one, which `io:readonly` overrides per request. */
+    safe;
+    /** What the operation says, with what the route takes already split out of it. */
+    introspection = null;
+    // eslint-disable-next-line max-params
+    constructor(endpoint, mapping, discovery, safe = false) {
         this.endpoint = endpoint;
         this.mapping = mapping;
         this.discovery = discovery;
+        this.safe = safe;
     }
     async call(context, parameters) {
         const body = await context.body();
         const query = this.query(context);
         const request = this.mapping.fit(body, query, parameters);
+        // a header sent twice is an ambiguity, not a key; the client repeats one value or none
+        const key = context.request.headers[IDEMPOTENCY_KEY];
+        if (typeof key === 'string' && key !== '')
+            request.id = identity(context, key);
+        // the process a stateful operation is called on, where the route carries one
+        if (context.instance !== undefined)
+            request.instance = context.instance;
+        // what this request receives of the output, which the operation answers of it
+        if (context.output !== undefined)
+            request.output = context.output;
+        /*
+         * Bytes to write on rather than values to read: the response is JSON, nothing on the way out
+         * reads the body, and this is a request to a resource rather than a procedure of one, whose
+         * reply is wrapped in an envelope of its own.
+         */
+        if (context.encoder?.type === JSON_TYPE && context.reads !== true && !context.procedural)
+            request.encoded = true;
+        // what the method means, unless a route said otherwise; see `documentation/readonly.md`
+        if (context.readonly ?? this.safe)
+            request.readonly = true;
         this.remote ??= await this.discovery;
         const reply = await this.remote.invoke(this.endpoint, request);
-        if (context.debug)
-            console.debug('Call', `${this.remote.locator.id}.${this.endpoint}`, request);
+        // a body that outgrew what the route takes was cut, whatever the operation made of that
+        if (context.exceeded === true)
+            throw new http.RequestEntityTooLarge();
         if (reply instanceof Error)
             throw new http.UnprocessableEntity(reply);
-        const message = {};
-        if (typeof reply === 'object' && reply !== null && '_version' in reply) {
-            const etag = context.request.headers['if-none-match'];
-            message.headers ??= new Headers();
-            if (etag !== undefined && reply._version === this.version(etag)) {
-                message.status = 304;
-                message.headers.set('etag', etag);
-                return message;
-            }
-            else
-                message.headers.set('etag', `"${reply._version.toString()}"`);
+        if (context.answers === undefined)
+            return { body: reply };
+        // a route that states what it produces answers bytes, and a value is not one of those
+        if (!(reply instanceof Readable) || reply.readableObjectMode)
+            throw new http.UnprocessableEntity();
+        return { body: reply, headers: new Headers({ 'content-type': context.answers }) };
+    }
+    selection() {
+        return this.mapping.selection();
+    }
+    async explain(parameters) {
+        this.introspection ??= await this.introspect(parameters);
+        // what a directive narrows is this caller's answer, not the next caller's
+        return structuredClone(this.introspection);
+    }
+    /**
+     * `Remote.explain` answers the contract's own object, whose `input` is the manifest's by
+     * reference. What follows takes properties out of it, and two routes mounting one endpoint
+     * share one remote — so the copy is what keeps the second from describing what the first
+     * took away.
+     */
+    async introspect(parameters) {
+        this.remote ??= await this.discovery;
+        const operation = structuredClone(await this.remote.explain(this.endpoint));
+        // what the operation states it is, is the Introspection's to read and not a resource's:
+        // an operation is written without knowledge of any route, and the same one mounted twice
+        // is two methods. What a method states is what its route states, which `mcp:tool` gives.
+        delete operation.description;
+        let route = null;
+        // a variable the operation names is taken by the path, so it is not the body's to send
+        for (const parameter of parameters) {
+            const schema = take(operation, parameter.name);
+            if (schema === undefined)
+                continue;
+            route ??= {};
+            route[parameter.name] = schema;
         }
-        message.body = reply;
-        return message;
+        const query = this.mapping.explain(operation);
+        const selection = this.mapping.selection();
+        const introspection = {};
+        if (route !== null)
+            introspection.route = route;
+        if (query !== null)
+            introspection.query = query;
+        if (selection !== null)
+            introspection.selection = selection;
+        Object.assign(introspection, operation);
+        return introspection;
     }
     async close() {
         this.remote ??= await this.discovery;
         await this.remote.disconnect(INTERRUPT);
     }
     query(context) {
-        const query = Object.fromEntries(context.url.searchParams);
+        // a URL without a query builds no parameters to read nothing out of
+        const query = context.url.search === '' ? {} : Object.fromEntries(context.url.searchParams);
         const etag = context.request.headers['if-match'];
-        if (etag !== undefined)
+        if (etag !== undefined && this.mapping.queryable)
             query.version = this.version(etag);
         return query;
     }
     version(etag) {
-        const match = etag.match(ETAG);
-        if (match === null)
-            throw new http.BadRequest('Invalid ETag.');
-        return Number.parseInt(match.groups.version);
+        const version = parse(etag);
+        if (version === null)
+            throw new http.BadRequest('Invalid ETag');
+        return version;
     }
 }
-exports.Endpoint = Endpoint;
-class EndpointsFactory {
+export class EndpointsFactory {
     remotes;
     constructor(remotes) {
         this.remotes = remotes;
     }
     create(method, context) {
         if (method.mapping === undefined)
-            throw new Error('Cannot create Endpoint without mapping.');
-        const mapping = Mapping_1.Mapping.create(method.mapping.query);
-        const namespace = method.mapping.namespace ?? context.extension?.namespace;
-        const component = method.mapping.component ?? context.extension?.component;
+            throw new Error('Cannot create Endpoint without mapping');
+        const mapping = Mapping.create(method.mapping.query, method.mapping.paged, method.mapping.streamed);
+        const branch = context.extension;
+        const namespace = method.mapping.namespace ?? branch?.namespace;
+        const component = method.mapping.component ?? branch?.component;
         if (namespace === undefined || component === undefined)
-            throw new Error('Annotation endpoints must be fully qualified.');
-        const discovery = this.remotes.discover(namespace, component);
-        return new Endpoint(method.mapping.endpoint, mapping, discovery);
+            throw new Error('Annotation endpoints must be fully qualified');
+        const discovery = this.remotes.discover(namespace, component, branch?.contract);
+        return new Endpoint(method.mapping.endpoint, mapping, discovery, SAFE.has(method.verb));
     }
 }
-exports.EndpointsFactory = EndpointsFactory;
-const ETAG = /^"(?<version>\d{1,32})"$/;
+/**
+ * The methods that only read, as RFC 9110 defines safe ones. `OPTIONS` is not among them because it
+ * reaches no endpoint, and `TRACE` because the server answers it `501`.
+ */
+const SAFE = new Set(['GET', 'HEAD']);
 const INTERRUPT = true;
+/**
+ * What a client's idempotency key names, as an identity the runtime can hold: it is what the
+ * operation records the call under, so a retry under the same key is the same call.
+ *
+ * Four things, and each of them earns its place. The **principal**, because two clients that
+ * both pick `1` would otherwise be answered with each other's replies — and worse, either could
+ * suppress the other's write by getting there first. The **key** itself, which is what the
+ * client repeats. The **method** and the **path**, because one key sent to two routes is two
+ * calls: the path carries the record the call is about, so a key reused across orders does not
+ * collapse them into one.
+ *
+ * Not the payload. A client that sends one key with two different bodies is answered with what
+ * the first one answered, which is what an idempotency key means; telling them off for it costs
+ * a stored fingerprint and buys a diagnostic.
+ *
+ * Hashed rather than taken as it is, so that a key is opaque input: a client cannot name an
+ * identity the runtime would have minted, and cannot reach one another client's key derives.
+ */
+function identity(context, key) {
+    return entities.derive(context.identity?.id ?? ANONYMOUS, key, context.request.method, context.url.pathname);
+}
+/**
+ * A route nothing authenticates has no principal to scope a key by, so every client of one
+ * shares a namespace. Keys are still honoured there — the alternative is refusing a header the
+ * client is entitled to send — and what it costs is that two anonymous clients picking one key
+ * on one path collide. Anonymous routes that change state are the case to watch.
+ */
+const ANONYMOUS = '';
+const IDEMPOTENCY_KEY = 'idempotency-key';
 //# sourceMappingURL=Endpoint.js.map

package/transpiled/Endpoint.js.map

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

package/transpiled/Factory.d.ts

@@ -1,9 +1,29 @@
-import { syntax } from './RTD';
-import type { Connector, Locator, extensions } from '@toa.io/core';
+import { Realtime } from './realtime/Factory.ts';
+import type { syntax } from './RTD/index.ts';
+import type { Connector, Contract, Locator } from '@toa.io/core';
+import type { extensions } from '@toa.io/core/types';
 export declare class Factory implements extensions.Factory {
-    private readonly boot;
-    constructor(boot: Bootloader);
-    tenant(locator: Locator, node: syntax.Node): Connector;
-    service(): Connector | null;
+    /** `realtime`, declared beside `exposition`: the routes of a component's events to streams */
+    readonly keys: {
+        realtime: Realtime;
+    };
+    private readonly host;
+    private announcing;
+    private announcements;
+    constructor(host: Host);
+    tenant(locator: Locator, node: syntax.Node, manifest: Manifest): Promise<Connector>;
+    /**
+     * The announcements this process holds, made if there are none. A factory is loaded once and
+     * outlives every composition it hands a tenant to, so what it remembers is replaced rather
+     * than handed out again once it has been taken down.
+     */
+    private shared;
+    private announce;
+    service(): Promise<Connector | null>;
 }
-export type Bootloader = typeof import('@toa.io/boot');
+export type Host = extensions.Host;
+/** What a tenant reads of the component it announces: what it provides, and which version. */
+type Manifest = Contract & {
+    version: string;
+};
+export {};