@toa.io/definitions 1.0.0-alpha.288

package/transpiled/extensions.exposition/const.js

@@ -0,0 +1,37 @@
+export const BRANCH_TTL = 1_800_000;
+/** The broadcast the gateway and its tenants share. */
+export const CHANNEL = 'exposition';
+/** The replicas of the gateway decide together, whatever context they serve. */
+export const ATOM_GROUP = 'exposition';
+/**
+ * Where JSON-RPC is served, for every procedure at once. Pinned rather than configured: a
+ * path an application could choose is a path it could collide with a route of its own.
+ */
+export const RPC = '/.rpc';
+/** Calls one request may carry where the annotation does not say. */
+export const BATCH = 32;
+/**
+ * Where the Model Context Protocol is served. Pinned for the reason `/.rpc` is: a path an
+ * application could choose is a path it could collide with a route of its own.
+ */
+export const MCP = '/.mcp';
+/**
+ * Where the resource tree and the page that reads it are served. Pinned for the reason
+ * `/.rpc` is: a path an application could choose is a path it could collide with a route of
+ * its own. Unlike those two it is not annotated — every entry it carries is what `OPTIONS`
+ * on that path already answers to the same caller, and what it adds is the enumeration.
+ */
+export const DISCOVERY = '/.discovery';
+/** Where the gateway serves. */
+export const PORT = 8000;
+/**
+ * Reserved for the readiness probe. `8001` is the Telemetry readiness probe's, and `toa export`
+ * refuses a port claimed twice — `toa mono` and a local run put every service in one process.
+ */
+export const PROBE = 8004;
+/**
+ * The initial delay of the readiness probe. The server does not sleep for it: whoever
+ * probes is the one that waits, and doing it here as well only delayed the process twice.
+ */
+export const DELAY = 3; // seconds
+//# sourceMappingURL=const.js.map

package/transpiled/extensions.exposition/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../source/extensions.exposition/const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAA;AAEnC,uDAAuD;AACvD,MAAM,CAAC,MAAM,OAAO,GAAG,YAAY,CAAA;AAEnC,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAA;AAE1B,qEAAqE;AACrE,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAA;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAA;AAEtC,gCAAgC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAA;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAA;AAEzB;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAA,CAAC,UAAU"}

package/transpiled/extensions.exposition/deployment.d.ts

@@ -0,0 +1,6 @@
+import { type Dependency } from '@toa.io/operations';
+import { type Annotation } from './Annotation.js';
+/** Where Toa's release publishes this service's image. An application takes it
+ *  instead of building one when its context says `registry.services: published`. */
+export declare const image = "ghcr.io/toa-io/extension-exposition-gateway";
+export declare function deployment(_: unknown, annotation?: Annotation): Dependency;

package/transpiled/extensions.exposition/deployment.js

@@ -0,0 +1,75 @@
+import assert from 'node:assert';
+import * as schemas from './schemas.js';
+import { shortcuts } from './shortcuts.js';
+import { components } from './components.js';
+import { parse } from './syntax/index.js';
+import { DELAY, PORT, PROBE } from './const.js';
+import { version } from '../version.js';
+/** Where Toa's release publishes this service's image. An application takes it
+ *  instead of building one when its context says `registry.services: published`. */
+export const image = 'ghcr.io/toa-io/extension-exposition-gateway';
+export function deployment(_, annotation) {
+    assert.ok(annotation !== undefined, 'Exposition context annotation is required');
+    schemas.annotation.validate(annotation);
+    const labels = components().labels;
+    const service = {
+        group: 'exposition',
+        name: 'gateway',
+        image,
+        port: PORT,
+        version,
+        variables: [],
+        components: labels,
+        resources: annotation.resources,
+        ingress: { path: '/', hosts: [] },
+        probe: {
+            path: '/.ready',
+            port: PROBE,
+            delay: DELAY
+        }
+    };
+    if (annotation?.['/'] !== undefined) {
+        const tree = parse(annotation['/'], shortcuts);
+        service.variables.push({
+            name: 'TOA_EXPOSITION',
+            value: JSON.stringify(tree)
+        });
+    }
+    const { debug, authorities } = annotation;
+    service.ingress.hosts = Object.values(authorities);
+    // leaving these undefined lets the context's own ingress section supply them
+    if (annotation.class !== undefined)
+        service.ingress.class = annotation.class;
+    if (annotation.annotations !== undefined)
+        service.ingress.annotations = annotation.annotations;
+    if (annotation.service?.annotations !== undefined)
+        service.annotations = annotation.service.annotations;
+    const properties = { authorities };
+    if (debug === true)
+        properties.debug = true;
+    if (annotation.protocol !== undefined)
+        properties.protocol = annotation.protocol;
+    if (annotation.ip !== undefined)
+        properties.ip = annotation.ip;
+    if (annotation.bouncer !== undefined)
+        properties.bouncer = annotation.bouncer;
+    if (annotation.oauth !== undefined)
+        properties.oauth = annotation.oauth;
+    if (annotation.rpc !== undefined)
+        properties.rpc = annotation.rpc;
+    if (annotation.mcp !== undefined)
+        properties.mcp = annotation.mcp;
+    service.variables.push({
+        name: 'TOA_EXPOSITION_PROPERTIES',
+        value: JSON.stringify(properties)
+    });
+    // The identity composition nested in this process connects before route discovery settles,
+    // so telemetry's probe — which tracks that composition — would report ready too early.
+    // The gateway answers for itself, on the same port telemetry would have used.
+    service.variables.push({
+        name: 'TOA_TELEMETRY_READY',
+        value: JSON.stringify(false)
+    });
+    return { services: [service] };
+}
+//# sourceMappingURL=deployment.js.map

package/transpiled/extensions.exposition/deployment.js.map

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

package/transpiled/extensions.exposition/index.d.ts

@@ -0,0 +1,8 @@
+export { manifest } from './manifest.js';
+export { components } from './components.js';
+export { deployment, image } from './deployment.js';
+export { shortcuts } from './shortcuts.js';
+export * from './const.js';
+export * as schemas from './schemas.js';
+export * as syntax from './syntax/index.js';
+export type { Annotation, Bouncer, MCP as MCPAnnotation, OAuth, Protocol, RPC as RPCAnnotation } from './Annotation.js';

package/transpiled/extensions.exposition/index.js

@@ -0,0 +1,8 @@
+export { manifest } from './manifest.js';
+export { components } from './components.js';
+export { deployment, image } from './deployment.js';
+export { shortcuts } from './shortcuts.js';
+export * from './const.js';
+export * as schemas from './schemas.js';
+export * as syntax from './syntax/index.js';
+//# sourceMappingURL=index.js.map

package/transpiled/extensions.exposition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.exposition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,cAAc,YAAY,CAAA;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA"}

package/transpiled/extensions.exposition/manifest.d.ts

@@ -0,0 +1,3 @@
+import { type Node } from './syntax/index.js';
+import type { Manifest } from '@toa.io/norm';
+export declare function manifest(declaration: object, manifest: Manifest): Node;

package/transpiled/extensions.exposition/manifest.js

@@ -0,0 +1,39 @@
+import assert from 'node:assert';
+import { parse } from './syntax/index.js';
+import { shortcuts } from './shortcuts.js';
+import * as schemas from './schemas.js';
+export function manifest(declaration, manifest) {
+    assert.ok(typeof declaration === 'object' && declaration !== null, 'Exposition declaration must be an object');
+    declaration = wrap(declaration, manifest.namespace, manifest.name);
+    const node = parse(declaration, shortcuts);
+    specify(node, manifest);
+    schemas.node.validate(node);
+    return node;
+}
+function wrap(declaration, namespace, name) {
+    const path = (namespace === undefined || namespace === 'default' ? '' : '/' + namespace) +
+        '/' +
+        name;
+    return { [path]: declaration };
+}
+function specify(node, manifest) {
+    for (const route of node.routes) {
+        for (const method of route.node.methods)
+            specifyMethod(method, manifest);
+        specify(route.node, manifest);
+    }
+}
+function specifyMethod(method, manifest) {
+    if (method.mapping?.endpoint === undefined)
+        return;
+    const operation = manifest.operations[method.mapping.endpoint];
+    assert.ok(operation !== undefined, `Operation '${method.mapping.endpoint}' not found`);
+    if (method.mapping.query === undefined)
+        method.mapping.query = operation.query === false ? null : {};
+    // a page is taken of a collection, and of nothing else: an operation that answers one object
+    // takes no `omit` and no `limit`, and refuses a request that carries them
+    method.mapping.paged = operation.type === 'observation' && operation.scope === 'objects';
+    method.mapping.namespace = manifest.namespace;
+    method.mapping.component = manifest.name;
+}
+//# sourceMappingURL=manifest.js.map

package/transpiled/extensions.exposition/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.exposition/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,KAAK,EAAsC,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAGvC,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAkB;IAC9D,MAAM,CAAC,EAAE,CACP,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,EACvD,0CAA0C,CAC3C,CAAA;IAED,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAElE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAE1C,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACvB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAE3B,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,IAAI,CAAC,WAAmB,EAAE,SAAiB,EAAE,IAAY;IAChE,MAAM,IAAI,GACR,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC;QAC3E,GAAG;QACH,IAAI,CAAA;IAEN,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;AAChC,CAAC;AAED,SAAS,OAAO,CAAC,IAAU,EAAE,QAAkB;IAC7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO;YAAE,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAExE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,QAAkB;IACvD,IAAI,MAAM,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS;QAAE,OAAM;IAElD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE9D,MAAM,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,EAAE,cAAc,MAAM,CAAC,OAAO,CAAC,QAAQ,aAAa,CAAC,CAAA;IAEtF,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;QACpC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,EAAuB,CAAA;IAEpF,6FAA6F;IAC7F,0EAA0E;IAC1E,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,KAAK,aAAa,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,CAAA;IAExF,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAA;AAC1C,CAAC"}

package/transpiled/extensions.exposition/manifest.test.d.ts

@@ -0,0 +1 @@
+export {};

package/transpiled/extensions.exposition/manifest.test.js

@@ -0,0 +1,38 @@
+import { it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { generate } from 'randomstring';
+import { manifest } from './manifest.js';
+const name = 'cm-' + generate();
+const namespace = 'ns' + generate();
+let mf;
+const operations = { observe: {} };
+beforeEach(() => {
+    mf = { namespace, name, operations };
+});
+const declaration = {
+    '/': { GET: 'observe' }
+};
+it('should create branch', async () => {
+    const node = manifest(declaration, mf);
+    assert.notStrictEqual(node, undefined);
+    assert.strictEqual(node.routes.length, 1);
+    assert.strictEqual(node.routes[0].path, '/' + namespace + '/' + name);
+});
+it('should not create node for default namespace', async () => {
+    mf.namespace = 'default';
+    const node = manifest(declaration, mf);
+    assert.strictEqual(node.routes.length, 1);
+    assert.strictEqual(node.routes[0].path, '/' + name);
+});
+it('should throw on invalid declaration type', async () => {
+    assert.throws(() => manifest('hello', mf), (error) => /Exposition declaration must be an object/.test(error.message));
+});
+it('should set namespace and component', async () => {
+    const node = manifest(declaration, mf);
+    const root = node.routes[0].node;
+    const intemediate = root.routes[0].node;
+    const GET = intemediate.methods[0];
+    assert.strictEqual(GET.mapping?.namespace, namespace);
+    assert.strictEqual(GET.mapping?.component, name);
+});
+//# sourceMappingURL=manifest.test.js.map

package/transpiled/extensions.exposition/manifest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.test.js","sourceRoot":"","sources":["../../source/extensions.exposition/manifest.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,IAAI,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAA;AAC/B,MAAM,SAAS,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAA;AAEnC,IAAI,EAAY,CAAA;AAEhB,MAAM,UAAU,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;AAElC,UAAU,CAAC,GAAG,EAAE;IACd,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAyB,CAAA;AAC7D,CAAC,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;CACxB,CAAA;AAED,EAAE,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAEtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IACtC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACzC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,CAAA;AACvE,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;IAC5D,EAAE,CAAC,SAAS,GAAG,SAAS,CAAA;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAEtC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACzC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC,CAAA;AACrD,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;IACxD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,QAAQ,CAAC,OAA4B,EAAE,EAAE,CAAC,EAChD,CAAC,KAAU,EAAE,EAAE,CAAC,0CAA0C,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAC/E,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACvC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAElC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;IACrD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;AAClD,CAAC,CAAC,CAAA"}

package/transpiled/extensions.exposition/schemas.d.ts

@@ -0,0 +1,7 @@
+import type { Schema } from '@toa.io/schemas';
+import type { Node } from './syntax/types.js';
+import type { Annotation } from './Annotation.js';
+export declare const querystring: Schema<Record<string, unknown>>;
+export declare const call: Schema<Record<string, unknown>>;
+export declare const annotation: Schema<Annotation>;
+export declare const node: Schema<Node>;

package/transpiled/extensions.exposition/schemas.js

@@ -0,0 +1,10 @@
+import { resolve } from 'node:path';
+import * as schemas from '@toa.io/schemas';
+const path = resolve(import.meta.dirname, '../../schemas/extensions.exposition');
+const namespace = schemas.namespace(path);
+// what the gateway validates a request by, kept beside what a manifest is validated by
+export const querystring = namespace.schema('querystring');
+export const call = namespace.schema('call');
+export const annotation = namespace.schema('annotation');
+export const node = namespace.schema('node');
+//# sourceMappingURL=schemas.js.map

package/transpiled/extensions.exposition/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/extensions.exposition/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAK1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAA;AAChF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAEzC,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GACtB,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AACjC,MAAM,CAAC,MAAM,IAAI,GAAoC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAE7E,MAAM,CAAC,MAAM,UAAU,GAAuB,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;AAC5E,MAAM,CAAC,MAAM,IAAI,GAAiB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA"}

package/transpiled/extensions.exposition/schemas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/transpiled/extensions.exposition/schemas.test.js

@@ -0,0 +1,22 @@
+import { it } from 'node:test';
+import assert from 'node:assert/strict';
+import * as schemas from './schemas.js';
+const authorities = { nex: 'nex.toa.io' };
+it('should require ip with bouncer', () => {
+    assert.throws(() => schemas.annotation.validate({ authorities, bouncer: {} }));
+    assert.doesNotThrow(() => schemas.annotation.validate({ authorities, bouncer: {}, ip: 'x-real-ip' }));
+    assert.doesNotThrow(() => schemas.annotation.validate({ authorities, ip: 'x-real-ip' }));
+});
+it('should default nothing in bouncer', () => {
+    assert.doesNotThrow(() => schemas.annotation.validate({
+        authorities,
+        ip: 'x-real-ip',
+        bouncer: { attempts: 5 }
+    }));
+    assert.throws(() => schemas.annotation.validate({
+        authorities,
+        ip: 'x-real-ip',
+        bouncer: { attempts: 0 }
+    }));
+});
+//# sourceMappingURL=schemas.test.js.map

package/transpiled/extensions.exposition/schemas.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.js","sourceRoot":"","sources":["../../source/extensions.exposition/schemas.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAC9B,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,CAAA;AAEzC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;IACxC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IAC9E,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CACvB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAC3E,CAAA;IACD,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;AAC1F,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC3C,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CACvB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC1B,WAAW;QACX,EAAE,EAAE,WAAW;QACf,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;KACzB,CAAC,CACH,CAAA;IACD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CACjB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC1B,WAAW;QACX,EAAE,EAAE,WAAW;QACf,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;KACzB,CAAC,CACH,CAAA;AACH,CAAC,CAAC,CAAA"}

package/transpiled/extensions.exposition/shortcuts.d.ts

@@ -0,0 +1,3 @@
+import type { Shortcuts } from './syntax/index.js';
+/** What a directive may be written as, where the family is implied. */
+export declare const shortcuts: Shortcuts;

package/transpiled/extensions.exposition/shortcuts.js

@@ -0,0 +1,13 @@
+/** What a directive may be written as, where the family is implied. */
+export const shortcuts = new Map([
+    ['anonymous', 'auth:anonymous'],
+    ['anyone', 'auth:anyone'],
+    ['id', 'auth:id'],
+    ['role', 'auth:role'],
+    ['rule', 'auth:rule'],
+    ['incept', 'auth:incept'],
+    ['input', 'io:input'],
+    ['output', 'io:output'],
+    ['languages', 'map:languages']
+]);
+//# sourceMappingURL=shortcuts.js.map

package/transpiled/extensions.exposition/shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.js","sourceRoot":"","sources":["../../source/extensions.exposition/shortcuts.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAc,IAAI,GAAG,CAAC;IAC1C,CAAC,WAAW,EAAE,gBAAgB,CAAC;IAC/B,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,IAAI,EAAE,SAAS,CAAC;IACjB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,QAAQ,EAAE,WAAW,CAAC;IACvB,CAAC,WAAW,EAAE,eAAe,CAAC;CAC/B,CAAC,CAAA"}

package/transpiled/extensions.exposition/syntax/index.d.ts

@@ -0,0 +1,2 @@
+export * from './parse.js';
+export * from './types.js';

package/transpiled/extensions.exposition/syntax/index.js

@@ -0,0 +1,3 @@
+export * from './parse.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/transpiled/extensions.exposition/syntax/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/extensions.exposition/syntax/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/transpiled/extensions.exposition/syntax/parse.d.ts

@@ -0,0 +1,4 @@
+import { type Node } from './types.js';
+export declare function parse(input: object, shortcuts?: Shortcuts): Node;
+export declare function createNode(): Node;
+export type Shortcuts = Map<string, string>;

package/transpiled/extensions.exposition/syntax/parse.js

@@ -0,0 +1,112 @@
+import * as schemas from '../schemas.js';
+import { verbs } from './types.js';
+export function parse(input, shortcuts) {
+    const node = parseNode(input, shortcuts);
+    schemas.node.validate(node);
+    return node;
+}
+function parseNode(input, shortcuts) {
+    const node = createNode();
+    if (typeof input === 'string') {
+        node.forward = input;
+        return node;
+    }
+    for (const [key, value] of Object.entries(input))
+        switch (key) {
+            case 'protected':
+            case 'isolated':
+                node[key] = value;
+                break;
+            case 'forward':
+                node[key] = value;
+                break;
+            default:
+                // eslint-disable-next-line max-depth
+                if (key[0] === '/') {
+                    const route = parseRoute(key, value, shortcuts);
+                    node.routes.push(route);
+                    continue;
+                }
+                // eslint-disable-next-line max-depth
+                if (verbs.has(key)) {
+                    const method = parseMethod(key, value, shortcuts);
+                    node.methods.push(method);
+                    continue;
+                }
+                // eslint-disable-next-line no-case-declarations
+                const directive = parseDirective(key, value, shortcuts);
+                // eslint-disable-next-line max-depth
+                if (directive !== null) {
+                    node.directives.push(directive);
+                    continue;
+                }
+                throw new Error(`RTD parse error: unknown key '${key}'`);
+        }
+    return node;
+}
+export function createNode() {
+    return {
+        routes: [],
+        methods: [],
+        directives: []
+    };
+}
+function parseRoute(path, value, shortcuts) {
+    const node = parse(value, shortcuts);
+    return createRoute(path, node);
+}
+function createRoute(path, node) {
+    return { path, node };
+}
+function parseMethod(verb, value, shortcuts) {
+    const mapping = typeof value === 'string' ? { endpoint: value } : value;
+    parseEndpoint(mapping);
+    parseQuery(mapping);
+    const directives = parseDirectives(mapping, shortcuts);
+    return { verb, mapping, directives };
+}
+function parseEndpoint(mapping) {
+    if (mapping.endpoint === undefined)
+        return;
+    const [endpoiont, component, namespace] = mapping.endpoint.split('.').reverse();
+    if (component !== undefined) {
+        mapping.component = component;
+        mapping.namespace = namespace ?? mapping.namespace ?? 'default';
+        mapping.endpoint = endpoiont;
+    }
+}
+function parseQuery(mapping) {
+    const query = mapping.query;
+    if (query === undefined || query === null)
+        return;
+    if (typeof query.limit === 'number')
+        query.limit = expandRange(query.limit);
+    if (typeof query.omit === 'number')
+        query.omit = expandRange(query.omit);
+}
+function parseDirectives(mapping, shortcuts) {
+    const directives = [];
+    for (const [key, value] of Object.entries(mapping)) {
+        const directive = parseDirective(key, value, shortcuts);
+        if (directive === null)
+            continue;
+        directives.push(directive);
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete mapping[key];
+    }
+    return directives;
+}
+function parseDirective(key, value, shortcuts) {
+    if (shortcuts?.has(key) === true)
+        key = shortcuts.get(key); // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    const match = key.match(DIRECTIVE_RX);
+    if (match === null)
+        return null;
+    const { family, name } = match.groups;
+    return { family, name, value };
+}
+function expandRange(range) {
+    return { value: range, range: [range, range] };
+}
+const DIRECTIVE_RX = /^(?<family>\w{1,32}):(?<name>\w{1,32})$/;
+//# sourceMappingURL=parse.js.map

package/transpiled/extensions.exposition/syntax/parse.js.map

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

package/transpiled/extensions.exposition/syntax/parse.test.d.ts

@@ -0,0 +1 @@
+export {};

package/transpiled/extensions.exposition/syntax/parse.test.js

@@ -0,0 +1,156 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { parse } from './parse.js';
+describe('routes', () => {
+    it('should parse route', async () => {
+        const declaration = {
+            '/': {},
+            '/foo': {}
+        };
+        const node = parse(declaration);
+        assert.strictEqual(node.routes.length, 2);
+        assert.strictEqual(node.routes[0].path, '/');
+        assert.strictEqual(node.routes[1].path, '/foo');
+    });
+    it('should parse nested routes', async () => {
+        const declaration = {
+            '/': {
+                '/foo': {},
+                '/bar': {}
+            }
+        };
+        const node = parse(declaration);
+        const root = node.routes[0].node;
+        assert.strictEqual(root.routes.length, 2);
+        assert.strictEqual(root.routes[0].path, '/foo');
+        assert.strictEqual(root.routes[1].path, '/bar');
+    });
+});
+describe('methods', () => {
+    it('should parse methods', () => {
+        const declaration = {
+            '/': {
+                GET: {
+                    endpoint: 'observe'
+                }
+            }
+        };
+        const node = parse(declaration);
+        const root = node.routes[0].node;
+        assert.strictEqual(root.methods.length, 1);
+        assert.strictEqual(root.methods[0].verb, 'GET');
+        assert.partialDeepStrictEqual(root.methods[0].mapping, { endpoint: 'observe' });
+    });
+    it('should parse endpoint shortcut', async () => {
+        const declaration = {
+            '/': {
+                GET: 'observe'
+            }
+        };
+        const node = parse(declaration);
+        const root = node.routes[0].node;
+        assert.strictEqual(root.methods.length, 1);
+        assert.strictEqual(root.methods[0].verb, 'GET');
+        assert.partialDeepStrictEqual(root.methods[0].mapping, { endpoint: 'observe' });
+    });
+    it('should parse fq endpoint', async () => {
+        const declaration = {
+            '/': {
+                GET: 'dummies.dummy.observe'
+            }
+        };
+        const node = parse(declaration);
+        const root = node.routes[0].node;
+        assert.strictEqual(root.methods.length, 1);
+        assert.strictEqual(root.methods[0].verb, 'GET');
+        assert.partialDeepStrictEqual(root.methods[0].mapping, {
+            namespace: 'dummies',
+            component: 'dummy',
+            endpoint: 'observe'
+        });
+    });
+    it('should parse fq endpoint within default namespace', async () => {
+        const declaration = {
+            '/': {
+                GET: 'dummy.observe'
+            }
+        };
+        const node = parse(declaration);
+        const root = node.routes[0].node;
+        assert.strictEqual(root.methods.length, 1);
+        assert.strictEqual(root.methods[0].verb, 'GET');
+        assert.partialDeepStrictEqual(root.methods[0].mapping, {
+            namespace: 'default',
+            component: 'dummy',
+            endpoint: 'observe'
+        });
+    });
+    it('should parse directives', async () => {
+        const declaration = {
+            '/': {
+                GET: {
+                    'auth:incept': 'id',
+                    endpoint: 'observe'
+                }
+            }
+        };
+        const node = parse(declaration);
+        const root = node.routes[0].node;
+        assert.deepStrictEqual(root.methods[0].directives, [
+            { family: 'auth', name: 'incept', value: 'id' }
+        ]);
+    });
+});
+describe('directives', () => {
+    it('should parse shortcuts', async () => {
+        const declaration = {
+            '/': {
+                foo: 'baz'
+            }
+        };
+        const shortcuts = new Map([['foo', 'dev:foo']]);
+        const node = parse(declaration, shortcuts);
+        const root = node.routes[0].node;
+        assert.strictEqual(root.directives.length, 1);
+        assert.strictEqual(root.directives[0].family, 'dev');
+        assert.strictEqual(root.directives[0].name, 'foo');
+        assert.strictEqual(root.directives[0].value, 'baz');
+    });
+});
+describe('validation', () => {
+    it('should throw on unknown key', async () => {
+        const declaration = { hello: 'world' };
+        assert.throws(() => parse(declaration), (error) => /RTD parse error: unknown key 'hello'/.test(error.message));
+    });
+    it('should throw on invalid mapping', async () => {
+        const declaration = {
+            '/': {
+                GET: {
+                    endpoint: 'observe',
+                    hello: 'world'
+                }
+            }
+        };
+        assert.throws(() => parse(declaration), (error) => /\/methods\/0\/mapping/.test(error.message));
+    });
+});
+it('should expand ranges', async () => {
+    const declaration = {
+        '/': {
+            GET: {
+                endpoint: 'enumerate',
+                query: {
+                    omit: 3,
+                    limit: 2
+                }
+            }
+        }
+    };
+    const node = parse(declaration);
+    const query = node.routes[0].node.methods[0].mapping?.query;
+    assert.partialDeepStrictEqual(query, {
+        omit: { value: 3, range: [3, 3] },
+        limit: { value: 2, range: [2, 2] }
+    });
+});
+//# sourceMappingURL=parse.test.js.map