@toa.io/extensions.introspection 1.0.0-alpha.259

package/transpiled/const.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAMPLE_LIMIT = exports.REDACTED = exports.DENIED = exports.MAX_EDGES = exports.ANNOUNCE_INTERVAL = exports.DEFAULT_THRESHOLD = exports.DEFAULT_INTERVAL = exports.UI_PORT = exports.UI_PATH = exports.EDGES = exports.NODES = exports.ENV = exports.NAMESPACE = exports.ID = void 0;
+exports.ID = 'introspection';
+exports.NAMESPACE = 'introspection';
+exports.ENV = 'TOA_INTROSPECTION';
+exports.NODES = 'nodes';
+exports.EDGES = 'edges';
+/** Where the UI is mounted; `/introspection/*` belongs to the components' own API. */
+exports.UI_PATH = '/.introspection';
+exports.UI_PORT = 8002;
+exports.DEFAULT_INTERVAL = 300;
+exports.DEFAULT_THRESHOLD = 1024;
+/** How often a component re-announces its description, so that removed components fade out. */
+exports.ANNOUNCE_INTERVAL = 1_800_000;
+/**
+ * `source` arrives over the wire, so the number of distinct edges a process
+ * can hold must be bounded regardless of what peers send.
+ */
+exports.MAX_EDGES = 4096;
+/** Never capture samples for these namespaces, whatever the annotation says. */
+exports.DENIED = new Set(['identity', 'introspection']);
+/** Keys never stored in a sample, even when sampling is on. */
+exports.REDACTED = /^(password|secret|token|credentials?|key|authorization|cookie)$/i;
+/** Serialized size cap of a single sample. */
+exports.SAMPLE_LIMIT = 4096;
+//# sourceMappingURL=const.js.map

package/transpiled/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../source/const.ts"],"names":[],"mappings":";;;AAAa,QAAA,EAAE,GAAG,eAAe,CAAA;AACpB,QAAA,SAAS,GAAG,eAAe,CAAA;AAE3B,QAAA,GAAG,GAAG,mBAAmB,CAAA;AAEzB,QAAA,KAAK,GAAG,OAAO,CAAA;AACf,QAAA,KAAK,GAAG,OAAO,CAAA;AAE5B,sFAAsF;AACzE,QAAA,OAAO,GAAG,iBAAiB,CAAA;AAC3B,QAAA,OAAO,GAAG,IAAI,CAAA;AAEd,QAAA,gBAAgB,GAAG,GAAG,CAAA;AACtB,QAAA,iBAAiB,GAAG,IAAI,CAAA;AAErC,+FAA+F;AAClF,QAAA,iBAAiB,GAAG,SAAS,CAAA;AAE1C;;;GAGG;AACU,QAAA,SAAS,GAAG,IAAI,CAAA;AAE7B,gFAAgF;AACnE,QAAA,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAA;AAE5D,+DAA+D;AAClD,QAAA,QAAQ,GAAG,kEAAkE,CAAA;AAE1F,8CAA8C;AACjC,QAAA,YAAY,GAAG,IAAI,CAAA"}

package/transpiled/describe.d.ts

@@ -0,0 +1,9 @@
+import type { Node } from './model';
+import type { Manifest } from '@toa.io/norm';
+/**
+ * Turns a normalized component manifest into the node of the map.
+ *
+ * Everything here is already expanded by norm: concise schemas are resolved and
+ * the prototype chain is collapsed, so this is the shape the runtime actually runs.
+ */
+export declare function describe(manifest: Manifest): Node;

package/transpiled/describe.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describe = void 0;
+/**
+ * Turns a normalized component manifest into the node of the map.
+ *
+ * Everything here is already expanded by norm: concise schemas are resolved and
+ * the prototype chain is collapsed, so this is the shape the runtime actually runs.
+ */
+function describe(manifest) {
+    return {
+        namespace: manifest.namespace,
+        component: manifest.name,
+        version: manifest.version,
+        entity: entity(manifest),
+        operations: operations(manifest),
+        events: events(manifest),
+        receivers: receivers(manifest),
+        // names only: extension declarations carry configuration and secrets
+        extensions: Object.keys(manifest.extensions ?? {})
+    };
+}
+exports.describe = describe;
+function entity(manifest) {
+    if (manifest.entity === undefined)
+        return null;
+    return {
+        schema: manifest.entity.schema,
+        storage: manifest.entity.storage,
+        associated: manifest.entity.associated === true
+    };
+}
+function operations(manifest) {
+    return Object.entries(manifest.operations ?? {})
+        .map(([endpoint, definition]) => ({
+        endpoint,
+        type: definition.type,
+        scope: definition.scope,
+        query: definition.query,
+        input: definition.input ?? null,
+        output: definition.output ?? null,
+        errors: definition.errors ?? []
+    }));
+}
+function events(manifest) {
+    return Object.entries(manifest.events ?? {})
+        .map(([label, definition]) => ({ label, binding: definition.binding }));
+}
+/*
+ * Receiver labels contain dots (`identity.bans.created`), which is why nodes keep
+ * these as arrays rather than maps — a dot in a document key is a hazard in Mongo.
+ */
+function receivers(manifest) {
+    return Object.entries(manifest.receivers ?? {})
+        .map(([label, definition]) => ({
+        label,
+        source: definition.source ?? label.split('.').slice(0, 2).join('.'),
+        event: label.split('.').pop(),
+        operation: definition.operation,
+        conditioned: definition.conditioned === true,
+        adaptive: definition.adaptive === true
+    }));
+}
+//# sourceMappingURL=describe.js.map

package/transpiled/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../source/describe.ts"],"names":[],"mappings":";;;AAGA;;;;;GAKG;AACH,SAAgB,QAAQ,CAAE,QAAkB;IAC1C,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,QAAQ,CAAC,IAAI;QACxB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;QACxB,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;QACxB,SAAS,EAAE,SAAS,CAAC,QAAQ,CAAC;QAE9B,qEAAqE;QACrE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;KACnD,CAAA;AACH,CAAC;AAbD,4BAaC;AAED,SAAS,MAAM,CAAE,QAAkB;IACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC/B,OAAO,IAAI,CAAA;IAEb,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;QAC9B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;QAChC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI;KAChD,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAE,QAAkB;IACrC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAgB,EAAE,EAAE,CAAC,CAAC;QAC/C,QAAQ;QACR,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI;QAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,IAAI;QACjC,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;KAChC,CAAC,CAAC,CAAA;AACP,CAAC;AAED,SAAS,MAAM,CAAE,QAAkB;IACjC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;AAC1F,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAE,QAAkB;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;SAC5C,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAgB,EAAE,EAAE,CAAC,CAAC;QAC5C,KAAK;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACnE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG;QAC9B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,WAAW,EAAE,UAAU,CAAC,WAAW,KAAK,IAAI;QAC5C,QAAQ,EAAE,UAAU,CAAC,QAAQ,KAAK,IAAI;KACvC,CAAC,CAAC,CAAA;AACP,CAAC"}

package/transpiled/extension.d.ts

@@ -0,0 +1,11 @@
+import type { Annotation } from './annotation';
+import type { Dependency, Instances } from '@toa.io/operations';
+export declare const standalone = true;
+/**
+ * The explorer hosts the introspection components, exactly as the exposition
+ * gateway hosts the identity ones. Collection is on unless the context says
+ * `introspection: false`, and the environment variable is emitted together
+ * with the service — never on its own, or tasks would pile up in a queue
+ * nothing consumes.
+ */
+export declare function deployment(_: Instances<unknown>, annotation?: Annotation): Dependency;

package/transpiled/extension.js

@@ -0,0 +1,64 @@
+"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.deployment = exports.standalone = void 0;
+const generic_1 = require("@toa.io/generic");
+const annotation_1 = require("./annotation");
+const Composition_1 = require("./Composition");
+const const_1 = require("./const");
+const schemas = __importStar(require("./schemas"));
+exports.standalone = true;
+/**
+ * The explorer hosts the introspection components, exactly as the exposition
+ * gateway hosts the identity ones. Collection is on unless the context says
+ * `introspection: false`, and the environment variable is emitted together
+ * with the service — never on its own, or tasks would pile up in a queue
+ * nothing consumes.
+ */
+function deployment(_, annotation) {
+    if (annotation === false)
+        return {};
+    if (annotation !== undefined)
+        schemas.annotation.validate(annotation);
+    const opts = (0, annotation_1.options)(annotation);
+    const service = {
+        group: 'introspection',
+        name: 'explorer',
+        version: require('../package.json').version,
+        components: (0, Composition_1.components)().labels,
+        resources: annotation?.resources,
+        variables: []
+    };
+    if (opts.ui) {
+        service.port = const_1.UI_PORT;
+        service.ingress = { path: const_1.UI_PATH };
+    }
+    return {
+        services: [service],
+        variables: { global: [{ name: const_1.ENV, value: (0, generic_1.encode)(opts) }] }
+    };
+}
+exports.deployment = deployment;
+//# sourceMappingURL=extension.js.map

package/transpiled/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../source/extension.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAwC;AACxC,6CAAsC;AACtC,+CAA0C;AAC1C,mCAA+C;AAC/C,mDAAoC;AAIvB,QAAA,UAAU,GAAG,IAAI,CAAA;AAE9B;;;;;;GAMG;AACH,SAAgB,UAAU,CAAE,CAAqB,EAAE,UAAuB;IACxE,IAAI,UAAU,KAAK,KAAK;QACtB,OAAO,EAAE,CAAA;IAEX,IAAI,UAAU,KAAK,SAAS;QAC1B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAEzC,MAAM,IAAI,GAAG,IAAA,oBAAO,EAAC,UAAU,CAAC,CAAA;IAEhC,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO;QAC3C,UAAU,EAAE,IAAA,wBAAU,GAAE,CAAC,MAAM;QAC/B,SAAS,EAAE,UAAU,EAAE,SAAS;QAChC,SAAS,EAAE,EAAE;KACd,CAAA;IAED,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,GAAG,eAAO,CAAA;QACtB,OAAO,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,eAAO,EAAE,CAAA;IACrC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAG,EAAE,KAAK,EAAE,IAAA,gBAAM,EAAC,IAAI,CAAC,EAAE,CAAC,EAAE;KAC5D,CAAA;AACH,CAAC;AA3BD,gCA2BC"}

package/transpiled/index.d.ts

@@ -0,0 +1,6 @@
+export { Factory } from './Factory';
+export { manifest } from './manifest';
+export { components } from './Composition';
+export * from './extension';
+export type { Annotation, Declaration, Options, Settings } from './annotation';
+export type * from './model';

package/transpiled/index.js

@@ -0,0 +1,25 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.components = exports.manifest = exports.Factory = void 0;
+var Factory_1 = require("./Factory");
+Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
+var manifest_1 = require("./manifest");
+Object.defineProperty(exports, "manifest", { enumerable: true, get: function () { return manifest_1.manifest; } });
+var Composition_1 = require("./Composition");
+Object.defineProperty(exports, "components", { enumerable: true, get: function () { return Composition_1.components; } });
+__exportStar(require("./extension"), exports);
+//# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,6CAA0C;AAAjC,yGAAA,UAAU,OAAA;AACnB,8CAA2B"}

package/transpiled/keys.d.ts

@@ -0,0 +1,9 @@
+import type { Origin, Target } from './model';
+/**
+ * Entity ids must match `^[a-fA-F0-9]{32}$`, and both nodes and edges are
+ * addressed by a value derived from their identity, so that every replica
+ * of a component updates the very same object.
+ */
+export declare function digest(...parts: Array<string | undefined>): string;
+export declare function node(namespace: string, component: string): string;
+export declare function edge(src: Origin, dst: Target): string;

package/transpiled/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../source/keys.ts"],"names":[],"mappings":";;;AAAA,6CAAwC;AAGxC;;;;GAIG;AACH,SAAgB,MAAM,CAAE,GAAG,KAAgC;IACzD,OAAO,IAAA,wBAAU,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAChE,CAAC;AAFD,wBAEC;AAED,SAAgB,IAAI,CAAE,SAAiB,EAAE,SAAiB;IACxD,OAAO,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;AAC7C,CAAC;AAFD,oBAEC;AAED,SAAgB,IAAI,CAAE,GAAW,EAAE,GAAW;IAC5C,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;AACnF,CAAC;AAFD,oBAEC;AAED,SAAS,KAAK,CAAE,MAAc;IAC5B,IAAI,SAAS,IAAI,MAAM;QACrB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAEpC,OAAO;QACL,WAAW;QACX,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,SAAS;QAChB,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACpD,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAC7C,CAAA;AACH,CAAC"}

package/transpiled/manifest.d.ts

@@ -0,0 +1,9 @@
+import type { Declaration } from './annotation';
+/**
+ * The component level of the annotation.
+ *
+ * The extension is predefined, so most components say nothing and the
+ * declaration arrives as `null` — which still has to produce a value,
+ * or norm rejects the extension.
+ */
+export declare function manifest(declaration: Declaration | null | undefined): Declaration;

package/transpiled/manifest.js

@@ -0,0 +1,43 @@
+"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.manifest = void 0;
+const annotation_1 = require("./annotation");
+const schemas = __importStar(require("./schemas"));
+/**
+ * The component level of the annotation.
+ *
+ * The extension is predefined, so most components say nothing and the
+ * declaration arrives as `null` — which still has to produce a value,
+ * or norm rejects the extension.
+ */
+function manifest(declaration) {
+    const normalized = (0, annotation_1.component)(declaration);
+    if (normalized !== false)
+        schemas.declaration.validate(normalized);
+    return normalized;
+}
+exports.manifest = manifest;
+//# sourceMappingURL=manifest.js.map

package/transpiled/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../source/manifest.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAwC;AACxC,mDAAoC;AAGpC;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAE,WAA2C;IACnE,MAAM,UAAU,GAAG,IAAA,sBAAS,EAAC,WAAW,CAAC,CAAA;IAEzC,IAAI,UAAU,KAAK,KAAK;QACtB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAE1C,OAAO,UAAU,CAAA;AACnB,CAAC;AAPD,4BAOC"}

package/transpiled/model.d.ts

@@ -0,0 +1,71 @@
+import type { Source } from '@toa.io/core';
+export type { Source };
+/**
+ * The caller side of an edge: the operation that made the call, the event that
+ * caused it, or the service the call came from.
+ */
+export type Origin = Source;
+/** The callee side of an edge. */
+export interface Target {
+    namespace: string;
+    component: string;
+    operation: string;
+}
+export interface Operation {
+    endpoint: string;
+    type: string;
+    scope?: string;
+    query?: boolean;
+    input?: object | null;
+    output?: object | null;
+    errors?: string[];
+}
+export interface Event {
+    label: string;
+    binding?: string;
+}
+export interface Receiver {
+    label: string;
+    source: string;
+    event: string;
+    operation: string;
+    conditioned: boolean;
+    adaptive: boolean;
+}
+export interface Entity {
+    schema: object;
+    storage?: string;
+    associated: boolean;
+}
+/**
+ * The static description of a component, derived from its manifest.
+ * Sent to `introspection.nodes`.
+ */
+export interface Node {
+    namespace: string;
+    component: string;
+    version: string;
+    entity: Entity | null;
+    operations: Operation[];
+    events: Event[];
+    receivers: Receiver[];
+    extensions: string[];
+}
+export interface Sample {
+    at: number;
+    input?: unknown;
+    outcome: Outcome;
+}
+export type Outcome = 'ok' | 'error' | 'exception';
+/**
+ * A call observed in a process between flushes. What the application declares —
+ * which events exist, and which receiver takes which — is a node's business;
+ * an edge is what actually happened.
+ *
+ * Sent to `introspection.edges`.
+ */
+export interface Edge {
+    src: Origin;
+    dst: Target;
+    sample?: Sample;
+}

package/transpiled/model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=model.js.map

package/transpiled/model.js.map

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

package/transpiled/sample.d.ts

@@ -0,0 +1,7 @@
+import type { Outcome, Sample } from './model';
+/**
+ * Captures the payload of a call. Only reached when both the context and the
+ * component have opted in, and never for a denied namespace.
+ */
+export declare function capture(input: unknown, outcome: Outcome): Sample;
+export declare function samplable(input: unknown): boolean;

package/transpiled/sample.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.samplable = exports.capture = void 0;
+const node_stream_1 = require("node:stream");
+const const_1 = require("./const");
+/**
+ * Captures the payload of a call. Only reached when both the context and the
+ * component have opted in, and never for a denied namespace.
+ */
+function capture(input, outcome) {
+    return { at: Date.now(), input: redact(input), outcome };
+}
+exports.capture = capture;
+function samplable(input) {
+    return !(input instanceof node_stream_1.Readable);
+}
+exports.samplable = samplable;
+function redact(value) {
+    if (value === null || value === undefined || typeof value !== 'object')
+        return truncate(value);
+    if (Array.isArray(value))
+        return truncate(value.map(redact));
+    const result = {};
+    for (const [key, property] of Object.entries(value))
+        result[key] = const_1.REDACTED.test(key) ? '***' : redact(property);
+    return truncate(result);
+}
+/**
+ * The map holds one sample per edge indefinitely, so a single oversized
+ * payload must not become a permanent tenant of the collection.
+ */
+function truncate(value) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(value) ?? '';
+    }
+    catch {
+        return '[unserializable]';
+    }
+    if (serialized.length <= const_1.SAMPLE_LIMIT)
+        return value;
+    return '[truncated]';
+}
+//# sourceMappingURL=sample.js.map

package/transpiled/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../source/sample.ts"],"names":[],"mappings":";;;AAAA,6CAAsC;AACtC,mCAAgD;AAGhD;;;GAGG;AACH,SAAgB,OAAO,CAAE,KAAc,EAAE,OAAgB;IACvD,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;AAC1D,CAAC;AAFD,0BAEC;AAED,SAAgB,SAAS,CAAE,KAAc;IACvC,OAAO,CAAC,CAAC,KAAK,YAAY,sBAAQ,CAAC,CAAA;AACrC,CAAC;AAFD,8BAEC;AAED,SAAS,MAAM,CAAE,KAAc;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QACpE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;IAExB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAEpC,MAAM,MAAM,GAA4B,EAAE,CAAA;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAE7D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAA;AACzB,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAE,KAAc;IAC/B,IAAI,UAAkB,CAAA;IAEtB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,IAAI,oBAAY;QACnC,OAAO,KAAK,CAAA;IAEd,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/transpiled/schemas.d.ts

@@ -0,0 +1,4 @@
+import type { Schema } from '@toa.io/schemas';
+import type { Annotation, Declaration } from './annotation';
+export declare const annotation: Schema<Exclude<Annotation, false>>;
+export declare const declaration: Schema<Exclude<Declaration, false>>;

package/transpiled/schemas.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declaration = exports.annotation = void 0;
+const node_path_1 = require("node:path");
+const schemas_1 = __importDefault(require("@toa.io/schemas"));
+const path = (0, node_path_1.resolve)(__dirname, '../schemas');
+const namespace = schemas_1.default.namespace(path);
+exports.annotation = namespace.schema('annotation');
+exports.declaration = namespace.schema('declaration');
+//# sourceMappingURL=schemas.js.map

package/transpiled/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../source/schemas.ts"],"names":[],"mappings":";;;;;;AAAA,yCAAmC;AACnC,8DAAqC;AAIrC,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,YAAY,CAAC,CAAA;AAC7C,MAAM,SAAS,GAAG,iBAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAE5B,QAAA,UAAU,GAAuC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;AAC/E,QAAA,WAAW,GAAwC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA"}