@toa.io/extensions.exposition 1.0.0-alpha.291 → 1.0.0-alpha.293

package/source/schemas.test.ts

@@ -1,31 +0,0 @@
-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 }
-    })
-  )
-})

package/source/schemas.ts

@@ -1,15 +0,0 @@
-import { resolve } from 'node:path'
-import * as schemas from '@toa.io/schemas'
-import type { Query } from './HTTP/index.js'
-import type { Node } from './RTD/index.js'
-import type { Call } from './RPC/types.js'
-import type { Schema } from '@toa.io/schemas'
-import type { Annotation } from './Annotation.js'
-
-const path = resolve(import.meta.dirname, '../schemas')
-const namespace = schemas.namespace(path)
-
-export const querystring: Schema<Query> = namespace.schema('querystring')
-export const annotation: Schema<Annotation> = namespace.schema('annotation')
-export const node: Schema<Node> = namespace.schema('node')
-export const call: Schema<Call> = namespace.schema('call')

package/source/service.ts

@@ -1,94 +0,0 @@
-import assert from 'node:assert'
-import { console, traces, type LevelName, type TracesOptions } from 'openspan'
-import { Gateway } from './Gateway.js'
-import { Remotes } from './Remotes.js'
-import { Tree } from './RTD/index.js'
-import { EndpointsFactory } from './Endpoint.js'
-import { families, interceptors } from './directives/index.js'
-import { DirectivesFactory } from './Directive.js'
-import { Composition } from './Composition.js'
-import * as root from './root.js'
-import { ATOM_GROUP, CHANNEL } from './const.js'
-import { Interception } from './Interception.js'
-import { Dispatcher } from './RPC/index.js'
-import { Server as Model } from './MCP/index.js'
-import * as http from './HTTP/index.js'
-import { environment } from '@toa.io/generic'
-import type { Broadcast } from './Gateway.js'
-import type { Connector } from '@toa.io/core'
-import type { Host } from './Factory.js'
-
-/**
- * The gateway. A composition loads this extension for its tenants alone, so what the
- * gateway is made of is reached from here and nowhere the factory imports.
- */
-export async function service(host: Host): Promise<Connector | null> {
-  const properties = environment.get('TOA_EXPOSITION_PROPERTIES')
-
-  assert.ok(properties !== undefined, 'TOA_EXPOSITION_PROPERTIES is undefined')
-
-  configureLogs()
-
-  const options = JSON.parse(properties) as http.Options
-  const broadcast: Broadcast = await host.broadcast(CHANNEL)
-  const server = http.Server.create({ ...options })
-  const remotes = new Remotes(host)
-  const node = root.resolve()
-  const methods = new EndpointsFactory(remotes)
-  const directives = new DirectivesFactory(families, remotes, host, options)
-  const interception = new Interception(interceptors, options)
-  const tree = new Tree(node, methods, directives)
-
-  const composition = new Composition(host)
-  const dispatcher = options.rpc === undefined ? null : new Dispatcher(options.rpc)
-  const mcp = options.mcp === undefined ? null : new Model(options.mcp, tree)
-  const gateway = new Gateway(broadcast, tree, interception, directives, dispatcher, mcp)
-
-  gateway.depends(remotes)
-  gateway.depends(composition)
-  // what the directives meter through; one atom per process, connected once
-  gateway.depends(host.atom(ATOM_GROUP))
-
-  server.attach(gateway.process.bind(gateway))
-  server.depends(gateway)
-
-  return server
-}
-
-const LOGS_PREFIX = 'TOA_TELEMETRY_LOGS'
-const TRACES_ENV = 'TOA_TELEMETRY_TRACES'
-
-function configureLogs(): void {
-  const globEnv = environment.get(LOGS_PREFIX)
-  const level: LevelName = environment.get('TOA_DEV') === '1' ? 'trace' : 'info'
-  const options =
-    globEnv === undefined ? { level } : (JSON.parse(globEnv) as { level?: LevelName })
-
-  console.configure({ level: options.level ?? level })
-
-  const tracesEnv = environment.get(TRACES_ENV)
-  const tracing =
-    tracesEnv === undefined ? development() : (JSON.parse(tracesEnv) as TracesOptions)
-
-  // `openspan` is not Toa's and reads the environment, which no longer holds the context by
-  // the time the exporter is made — so the service is named here
-  if (tracing.exporters?.otlp !== undefined)
-    tracing.exporters.otlp.service ??= environment.get('TOA_CONTEXT')
-
-  traces(tracing)
-}
-
-/**
- * Tracing is off unless it is configured. The console exporter is a local development
- * mechanism, so it is turned on for `toa dev` and for a boot trace the CLI has already
- * asked for (`runtime/boot/src/span.js`), and nowhere else — a deployment that wants
- * traces annotates `telemetry.traces.exporters`.
- *
- * The gateway boots without the telemetry extension, hence the copy of
- * `extensions/telemetry/source/extension.ts`.
- */
-function development(): TracesOptions {
-  const local = environment.get('TOA_DEV') === '1' || environment.get('TOA_BOOT_TRACE') === '1'
-
-  return local ? { exporters: { console: {} } } : {}
-}

package/source/shortcuts.ts

@@ -1,14 +0,0 @@
-import type { Shortcuts } from './RTD/syntax/index.js'
-
-/** What a directive may be written as, where the family is implied. */
-export const shortcuts: 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']
-])

package/source/userland.ts

@@ -1,47 +0,0 @@
-/**
- * What Exposition puts into an operation's input, for the operation to be written against.
- *
- * The gateway's own types are its business; these are the application's.
- */
-
-/**
- * The identity behind the call, as `auth:delegate` embeds it:
- *
- * ```yaml
- * /echo:
- *   GET:
- *     auth:assert: true
- *     auth:delegate: identity
- *     endpoint: echo
- * ```
- *
- * ```javascript
- * export async function computation ({ identity }, context) { }
- * ```
- */
-export interface Identity {
-  readonly id: string
-
-  /** What the identity holds. Delegation resolves them, so they are always here. */
-  roles: string[]
-
-  permissions?: Record<string, string[]>
-
-  /** How the identity was authenticated; `null` for a transient one. */
-  scheme: string | null
-
-  /** Whether the credentials presented are due to be exchanged. */
-  refresh: boolean
-
-  /** The token's claims, where the identity was federated. */
-  claims?: Claims
-}
-
-/** A federated token's payload: what it must carry, and whatever else the issuer put there. */
-export interface Claims {
-  iss: string
-  sub: string
-  aud?: string | string[]
-
-  [claim: string]: unknown
-}

package/transpiled/Annotation.d.ts

@@ -1,70 +0,0 @@
-import type { Resources } from '@toa.io/operations';
-import type { Protocol } from './HTTP/index.js';
-export interface Annotation {
-    authorities: Record<string, string>;
-    /**
-     * `h2c` requires an ingress controller that proxies cleartext HTTP/2 upstream.
-     * See `documentation/protocol.md`.
-     */
-    protocol?: Protocol;
-    class?: string;
-    resources?: Resources;
-    annotations?: Record<string, string>;
-    /** The Service, as opposed to the Ingress that `annotations` above describes. */
-    service?: {
-        annotations?: Record<string, string>;
-    };
-    debug?: boolean;
-    /** The header the client address is read from; the connection's without one. See `ip.md`. */
-    ip?: string;
-    /** Failed authentications an address may make; none are metered unless set. See `identity.md`. */
-    bouncer?: Bouncer;
-    /** The authorization server this context exposes; none is exposed without it. */
-    oauth?: OAuth;
-    /** JSON-RPC at `/.rpc`; none is served without it. See `documentation/rpc.md`. */
-    rpc?: RPC;
-    /** MCP at `/.mcp`; none is served without it. See `documentation/mcp.md`. */
-    mcp?: MCP;
-    '/'?: object;
-}
-export interface OAuth {
-    /**
-     * Where a client sends the user to consent. The one endpoint of the flow that needs a
-     * person, and so the one this extension does not serve: an application builds it.
-     */
-    authorize: string;
-    /** Paths a token may be restricted to, each advertised as a protected resource. */
-    resources?: string[];
-    /** What a client may ask for. Each is a role, or a scope within one. */
-    scopes?: string[];
-    /** Origins whose Client ID Metadata Documents may be read. None are without it. */
-    trust?: string[];
-    /** Dynamic Client Registration, off unless opened. */
-    registration?: 'open' | 'closed';
-}
-export interface RPC {
-    /**
-     * Calls one request may carry, 32 by default. One request is one authentication and one
-     * reply however many calls it makes, so what a caller may ask for at once is bounded.
-     */
-    batch?: number;
-}
-export interface MCP {
-    /** What the server calls itself, which a client shows a user. */
-    name: string;
-    /** What a model is told before it calls anything here. */
-    instructions?: string;
-    /**
-     * Browser origins the endpoint answers, which the revision requires against DNS rebinding.
-     * None are admitted without it; a request carrying no `Origin` is not a browser's.
-     */
-    origins?: string[];
-    /** Whether the endpoint answers without a credential. It does not unless it says so. */
-    anonymous?: boolean;
-}
-export interface Bouncer {
-    /** what an address may fail at once, 20 by default */
-    attempts?: number;
-    /** seconds it takes to earn them back, 60 by default */
-    interval?: number;
-}

package/transpiled/Annotation.js

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

package/transpiled/Annotation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Annotation.js","sourceRoot":"","sources":["../source/Annotation.ts"],"names":[],"mappings":""}

package/transpiled/RTD/syntax/parse.d.ts

@@ -1,4 +0,0 @@
-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/RTD/syntax/parse.js

@@ -1,112 +0,0 @@
-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/RTD/syntax/parse.js.map

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

package/transpiled/RTD/syntax/types.d.ts

@@ -1,52 +0,0 @@
-export interface Node {
-    protected?: boolean;
-    isolated?: boolean;
-    forward?: string;
-    routes: Route[];
-    methods: Method[];
-    directives: Directive[];
-}
-export interface Route {
-    path: string;
-    node: Node;
-}
-export interface Method {
-    verb: string;
-    mapping?: Mapping;
-    directives: Directive[];
-}
-export interface Directive {
-    family: string;
-    name: string;
-    value: any;
-}
-export interface Mapping {
-    namespace?: string;
-    component?: string;
-    endpoint: string;
-    query?: Query | null;
-    /**
-     * Whether the operation this maps to answers a page of a collection, and so takes the
-     * `omit` and `limit` a page is taken by. Written where the component's manifest is read,
-     * beside `namespace` and `component`, and not declared.
-     */
-    paged?: boolean;
-}
-export interface Query {
-    id?: string;
-    criteria?: string;
-    search?: boolean;
-    sample?: number;
-    sort?: string;
-    omit?: Range;
-    limit?: Range;
-    selectors?: string[];
-    projection?: string[];
-    parameters?: string[];
-    deleted?: boolean;
-}
-export interface Range {
-    value?: number;
-    range: [number, number];
-}
-export declare const verbs: Set<string>;

package/transpiled/RTD/syntax/types.js

@@ -1,11 +0,0 @@
-export const verbs = new Set([
-    'GET',
-    'HEAD',
-    'POST',
-    'PUT',
-    'PATCH',
-    'DELETE',
-    'LOCK',
-    'UNLOCK'
-]);
-//# sourceMappingURL=types.js.map

package/transpiled/RTD/syntax/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../source/RTD/syntax/types.ts"],"names":[],"mappings":"AA2DA,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS;IACnC,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,QAAQ;CACT,CAAC,CAAA"}

package/transpiled/const.d.ts

@@ -1,36 +0,0 @@
-export declare const BRANCH_TTL = 1800000;
-/** The broadcast the gateway and its tenants share. */
-export declare const CHANNEL = "exposition";
-/** The replicas of the gateway decide together, whatever context they serve. */
-export declare 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 declare const RPC = "/.rpc";
-/** Calls one request may carry where the annotation does not say. */
-export declare 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 declare 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 declare const DISCOVERY = "/.discovery";
-/** Where the gateway serves. */
-export declare 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 declare 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 declare const DELAY = 3;

package/transpiled/const.js

@@ -1,37 +0,0 @@
-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/const.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"const.js","sourceRoot":"","sources":["../source/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/deployment.d.ts

@@ -1,6 +0,0 @@
-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/deployment.js

@@ -1,76 +0,0 @@
-import { readFileSync } from 'node:fs';
-import assert from 'node:assert';
-import * as schemas from './schemas.js';
-import { shortcuts } from './shortcuts.js';
-import { components } from './Composition.js';
-import { parse } from './RTD/syntax/index.js';
-import { DELAY, PORT, PROBE } from './const.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: JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
-            .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/deployment.js.map

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

package/transpiled/manifest.d.ts

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