@toa.io/extensions.introspection 1.0.0-alpha.305 → 1.0.0-alpha.306

package/components/introspection.edges/manifest.toa.yaml

@@ -1,10 +1,10 @@
 namespace: introspection
 name: edges
 
-# One document per edge of the map: a call one component made to another, with `src`
-# saying what caused it — another operation, an event, or a service. What the
-# application declares is described by `introspection.nodes`; an edge is what
-# actually happened.
+# One document per edge of the map: that a call one component made to another was made,
+# with `src` saying what caused it — another operation, an event, or a service. What the
+# call carried is not recorded. What the application declares is described by
+# `introspection.nodes`; an edge is what actually happened.
 #
 # Every replica of a component derives the same id for the same edge, so `merge` is
 # an upsert and `UPDATED` shows when the edge was last observed.
@@ -29,14 +29,6 @@ entity:
         namespace: { type: string }
         component: { type: string }
         operation: { type: string }
-    sample:
-      description: The last call observed on this edge
-      type: object
-      required: [at, outcome]
-      properties:
-        at: { type: integer }
-        input: {}
-        outcome: { type: string }
   required: [src, dst]
 
 operations:

package/components/introspection.edges/operations/merge.js

@@ -12,10 +12,7 @@ export function transition(input, objects) {
             continue;
         edge.src = observed.src;
         edge.dst = observed.dst;
-        // absent when sampling is off, and the last one wins otherwise
-        if (observed.sample !== undefined)
-            edge.sample = observed.sample;
     }
     return objects;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVyZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zb3VyY2UvbWVyZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUE7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLFVBQVUsQ0FBQyxLQUFpQixFQUFFLE9BQWlCO0lBQzdELEtBQUssTUFBTSxJQUFJLElBQUksT0FBTyxFQUFFLENBQUM7UUFDM0IsTUFBTSxRQUFRLEdBQUcsS0FBSyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUE7UUFFckMsSUFBSSxRQUFRLEtBQUssU0FBUztZQUFFLFNBQVE7UUFFcEMsSUFBSSxDQUFDLEdBQUcsR0FBRyxRQUFRLENBQUMsR0FBRyxDQUFBO1FBQ3ZCLElBQUksQ0FBQyxHQUFHLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQTtRQUV2QiwrREFBK0Q7UUFDL0QsSUFBSSxRQUFRLENBQUMsTUFBTSxLQUFLLFNBQVM7WUFBRSxJQUFJLENBQUMsTUFBTSxHQUFHLFFBQVEsQ0FBQyxNQUFNLENBQUE7SUFDbEUsQ0FBQztJQUVELE9BQU8sT0FBTyxDQUFBO0FBQ2hCLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVyZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zb3VyY2UvbWVyZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUE7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLFVBQVUsQ0FBQyxLQUFpQixFQUFFLE9BQWlCO0lBQzdELEtBQUssTUFBTSxJQUFJLElBQUksT0FBTyxFQUFFLENBQUM7UUFDM0IsTUFBTSxRQUFRLEdBQUcsS0FBSyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUE7UUFFckMsSUFBSSxRQUFRLEtBQUssU0FBUztZQUFFLFNBQVE7UUFFcEMsSUFBSSxDQUFDLEdBQUcsR0FBRyxRQUFRLENBQUMsR0FBRyxDQUFBO1FBQ3ZCLElBQUksQ0FBQyxHQUFHLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQTtJQUN6QixDQUFDO0lBRUQsT0FBTyxPQUFPLENBQUE7QUFDaEIsQ0FBQyJ9

package/components/introspection.edges/source/merge.ts

@@ -15,9 +15,6 @@ export function transition(input: MergeInput, objects: Entity[]): Entity[] {
 
     edge.src = observed.src
     edge.dst = observed.dst
-
-    // absent when sampling is off, and the last one wins otherwise
-    if (observed.sample !== undefined) edge.sample = observed.sample
   }
 
   return objects

package/components/introspection.edges/types/toa.d.ts

@@ -19,12 +19,6 @@ export interface Entity {
     component: string
     operation: string
   }
-  /** The last call observed on this edge */
-  sample?: {
-    at: number
-    input?: unknown
-    outcome: string
-  }
   id: string
   VERSION: number
   CREATED: number
@@ -50,12 +44,6 @@ export type MergeInput = {
       component: string
       operation: string
     }
-    /** The last call observed on this edge */
-    sample?: {
-      at: number
-      input?: unknown
-      outcome: string
-    }
   }>
 }
 

package/components/introspection.signals/manifest.toa.yaml

@@ -0,0 +1,109 @@
+namespace: introspection
+name: signals
+
+# What an operator tells every process of the deployment at once. A signal is a record and
+# nothing more: creating one publishes the prototype's `created` event, which every process
+# is subscribed to, and carrying it out is theirs. Nothing here knows anyone is listening.
+#
+# The records stay, because they are how a halt is legible after the fact: `CREATED` says
+# when it was asked for and `seconds` how long it was for, so whether one is on is read off
+# the record and never has to be retracted — which matters, because the write that would
+# retract it is the one thing a halted deployment cannot do.
+
+entity:
+  properties:
+    type:
+      description: What the processes are being told to do
+      type: string
+      enum: [halt, stop]
+    # what a halt may ask for is the deployment's own say, read off `bounds` and applied by
+    # every process that hears the signal, so what is stated here is only what a number is
+    seconds:
+      description: How long every process stays disconnected before it builds itself again
+      type: integer
+      minimum: 0
+    quiescence:
+      description: How long the deployment is given to go quiet before the map is read
+      type: integer
+      minimum: 0
+    grace:
+      description: How long a process that has found the deployment busy waits before it leaves
+      type: integer
+      minimum: 2
+      maximum: 120
+    signal:
+      description: The halt a stop answers
+      type: string
+  required:
+    - type
+    - seconds
+    - quiescence
+
+operations:
+  # `query: false` is what makes this a new signal rather than a change to one. What a signal
+  # may say is the entity's own say on itself, so the bounds are stated once: a value that
+  # breaks them is refused by the record and not by the route.
+  create:
+    description: Tell every process of this deployment to do something.
+    query: false
+    forward: transit
+    input: &signal
+      type: object
+      properties:
+        type:
+          type: string
+        seconds:
+          type: integer
+        quiescence:
+          type: integer
+        grace:
+          type: integer
+        signal:
+          type: string
+      required:
+        - type
+        - seconds
+        - quiescence
+  transit:
+    concurrency: retry
+    input: *signal
+  # what the deployment is configured to accept, by signal — `halt` is the only one there is,
+  # and it is absent where the deployment does not take halts
+  configuration:
+    description: What a signal of this deployment may ask for, in seconds.
+    output:
+      type: object
+      properties:
+        halt:
+          type: object
+          properties:
+            duration: &range
+              type: array
+              items:
+                type: integer
+              minItems: 2
+              maxItems: 2
+            quiescence: *range
+          required:
+            - duration
+            - quiescence
+
+# the map must not describe itself
+introspection: false
+
+exposition:
+  isolated: true
+  /:
+    # not `system:introspection`: reading the map and stopping the product are not one
+    # authority, and the map's role is already held by whoever draws it
+    auth:role: system:halt
+    io:output: true
+
+    # what a signal may ask for, so that whoever writes one asks for something that will be
+    # carried out as written rather than clamped on arrival. The records themselves are not
+    # read: a process is told by the event, and during a halt the gateway answers 503 anyway
+    GET: configuration
+
+    # the records are kept all the same — a halt needs no retraction, because `CREATED` and
+    # `seconds` answer whether one is on
+    POST: create

package/components/introspection.signals/operations/configuration.js

@@ -0,0 +1,17 @@
+import { environment } from '@toa.io/definitions/extensions.introspection';
+/**
+ * What a signal of this deployment may ask for, in seconds.
+ *
+ * It is what every process that hears one holds it to, read from the same annotation, so
+ * whoever writes a signal can ask for something that will be carried out as written rather
+ * than clamped on arrival. A deployment that does not take halts says nothing about them.
+ */
+export function computation() {
+    const options = environment();
+    if (options === null)
+        throw new Error('Introspection is not configured in this process');
+    if (!options.halt)
+        return {};
+    return { halt: { duration: options.duration, quiescence: options.quiescence } };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlndXJhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NvdXJjZS9jb25maWd1cmF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSw4Q0FBOEMsQ0FBQTtBQUcxRTs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsV0FBVztJQUN6QixNQUFNLE9BQU8sR0FBRyxXQUFXLEVBQUUsQ0FBQTtJQUU3QixJQUFJLE9BQU8sS0FBSyxJQUFJO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxpREFBaUQsQ0FBQyxDQUFBO0lBRXhGLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSTtRQUFFLE9BQU8sRUFBRSxDQUFBO0lBRTVCLE9BQU8sRUFBRSxJQUFJLEVBQUUsRUFBRSxRQUFRLEVBQUUsT0FBTyxDQUFDLFFBQVEsRUFBRSxVQUFVLEVBQUUsT0FBTyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUE7QUFDakYsQ0FBQyJ9

package/components/introspection.signals/source/configuration.ts

@@ -0,0 +1,26 @@
+import { environment } from '@toa.io/definitions/extensions.introspection'
+import type { Bounds } from '@toa.io/definitions/extensions.introspection'
+
+/**
+ * What a signal of this deployment may ask for, in seconds.
+ *
+ * It is what every process that hears one holds it to, read from the same annotation, so
+ * whoever writes a signal can ask for something that will be carried out as written rather
+ * than clamped on arrival. A deployment that does not take halts says nothing about them.
+ */
+export function computation(): Configuration {
+  const options = environment()
+
+  if (options === null) throw new Error('Introspection is not configured in this process')
+
+  if (!options.halt) return {}
+
+  return { halt: { duration: options.duration, quiescence: options.quiescence } }
+}
+
+interface Configuration {
+  halt?: {
+    duration: Bounds
+    quiescence: Bounds
+  }
+}

package/components/introspection.signals/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../../../tsconfig.component.json",
+  "compilerOptions": {
+    "outDir": "./operations",
+    "rootDir": "./source"
+  },
+  "include": [
+    "source"
+  ]
+}

package/components/introspection.signals/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './toa.d.ts'
+
+// What a manifest does not state belongs here, and every run keeps it.

package/components/introspection.signals/types/toa.d.ts

@@ -0,0 +1,61 @@
+// Written by `toa types`. Every run rewrites it.
+// What a manifest does not state belongs in a file of your own.
+
+import type { Options, Query } from '@toa.io/core/types'
+import type { Readable } from 'node:stream'
+
+export interface Entity {
+  /** What the processes are being told to do */
+  type: "halt" | "stop"
+  /** How long every process stays disconnected before it builds itself again */
+  seconds: number
+  /** How long the deployment is given to go quiet before the map is read */
+  quiescence: number
+  /** How long a process that has found the deployment busy waits before it leaves */
+  grace?: number
+  /** The halt a stop answers */
+  signal?: string
+  id: string
+  VERSION: number
+  CREATED: number
+  UPDATED: number
+  DELETED: number | null
+  REGION: number
+}
+
+export type CreateInput = {
+  type: string
+  seconds: number
+  quiescence: number
+  grace?: number
+  signal?: string
+}
+
+export type TransitInput = {
+  type: string
+  seconds: number
+  quiescence: number
+  grace?: number
+  signal?: string
+}
+
+export type ConfigurationOutput = {
+  halt?: {
+    duration: number[]
+    quiescence: number[]
+  }
+}
+
+export interface Component {
+  /** Tell every process of this deployment to do something. */
+  create: (request: { input: CreateInput, task?: boolean }, options?: Options) => Promise<unknown>
+  transit: (request: { input: TransitInput, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
+  /** What a signal of this deployment may ask for, in seconds. */
+  configuration: (request: { input?: null, task?: boolean }, options?: Options) => Promise<ConfigurationOutput>
+  assign: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
+  ensure: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
+  enumerate: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity[]>
+  observe: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity | null>
+  stream: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Readable>
+  terminate: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.introspection",
-  "version": "1.0.0-alpha.305",
+  "version": "1.0.0-alpha.306",
   "type": "module",
   "description": "Toa Introspection",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -27,18 +27,18 @@
     "!**/.env*"
   ],
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.305",
-    "@toa.io/definitions": "1.0.0-alpha.305",
+    "@toa.io/core": "1.0.0-alpha.306",
+    "@toa.io/definitions": "1.0.0-alpha.306",
     "@toa.io/generic": "1.0.0-alpha.304",
-    "@toa.io/norm": "1.0.0-alpha.305",
+    "@toa.io/norm": "1.0.0-alpha.306",
     "@toa.io/schemas": "1.0.0-alpha.304",
     "openspan": "1.0.0-alpha.305"
   },
   "scripts": {
-    "transpile": "npx tsc && npx tsc -p ./components/introspection.nodes && npx tsc -p ./components/introspection.edges",
+    "transpile": "npx tsc && npx tsc -p ./components/introspection.nodes && npx tsc -p ./components/introspection.edges && npx tsc -p ./components/introspection.signals",
     "build:ui": "npm --prefix ui ci && npm --prefix ui run build",
     "prepack": "npm run build:ui",
-    "features": "TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js --tags 'not @skip and not @samples and not @shutdown' && TOA_INTROSPECTION_SAMPLES=1 TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js --tags 'not @skip and @samples' && TOA_INTROSPECTION_INTERVAL=3600 TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js --tags 'not @skip and @shutdown'"
+    "features": "TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js --tags 'not @skip and not @shutdown' && TOA_INTROSPECTION_INTERVAL=3600 TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js --tags 'not @skip and @shutdown'"
   },
-  "gitHead": "6a28476303826e2484cc2ea6306efee6f19fb594"
+  "gitHead": "0693d180a8053a7d07dca879dac2a3c4784d6d45"
 }

package/readme.md

@@ -7,12 +7,14 @@ The topology includes:
 
 - components and their entities, operations, events, and receivers;
 - declared event relations between components;
-- calls observed between components and services at runtime;
-- input and outcome samples for observed calls, when sampling is enabled.
+- calls observed between components and services at runtime.
 
 This provides a single view of both the product's declared structure and the communication paths
 that are exercised at runtime. The topology is available through a web UI and an HTTP API.
 
+An observed call is recorded as the pair it connects and nothing else: what the call carried is
+not collected, and nothing an application passes between its components reaches the topology.
+
 Introspection is enabled by default for every component in a composition.
 
 ## Configuration
@@ -21,20 +23,20 @@ Configure Introspection in `context.toa.yaml`:
 
 ```yaml
 introspection:
-  samples: false
   interval: 300
   threshold: 1024
   ui: true
+  halt: false
 ```
 
 All properties are optional.
 
 | Property    | Default | Description                                                                                   |
 | ----------- | ------- | --------------------------------------------------------------------------------------------- |
-| `samples`   | `false` | Enables collection of call input and outcome samples.                                         |
 | `interval`  | `300`   | Interval between topology updates, in seconds.                                                |
 | `threshold` | `1024`  | Number of distinct observed interactions that triggers an update before the interval expires. |
 | `ui`        | `true`  | Publishes the web UI.                                                                         |
+| `halt`      | `false` | Accepts [halt](/documentation/halt.md) signals, which stop the whole deployment. `true`, or a pair of `[min, max]` bounds for what one may ask for: `duration` and `quiescence`, in seconds. |
 | `resources` | —       | Resource requirements for the Introspection deployment.                                       |
 
 Resource requirements can be declared specifically for Introspection:
@@ -60,33 +62,12 @@ does not use Exposition must disable Introspection.
 
 ### Component configuration
 
-Sampling can be prohibited for an individual component in `manifest.toa.yaml`:
-
-```yaml
-introspection:
-  samples: false
-```
-
-This restriction cannot be overridden by the context configuration.
-
-Exclude a component from the topology entirely:
+Exclude a component from the topology in its `manifest.toa.yaml`:
 
 ```yaml
 introspection: false
 ```
 
-## Samples
-
-A sample contains the input and outcome of an observed call. Sampling is disabled by default
-because call inputs may contain production or personal data.
-
-Samples are collected only when they are enabled in the context and not prohibited by the target
-component. Payloads in the `identity` namespace are never collected. Properties whose names match
-known secret patterns are redacted, streams are excluded, and oversized values are replaced with a
-truncation marker.
-
-Components that process sensitive data should disable sampling explicitly in their manifests.
-
 ## Web UI
 
 The web UI visualizes the product topology and is enabled by default. It is published at

package/transpiled/Factory.d.ts

@@ -6,18 +6,24 @@ import type { extensions } from '@toa.io/core/types';
 export declare class Factory implements extensions.Factory {
     private readonly host;
     private readonly options;
-    private readonly settings;
+    private readonly mapped;
     private reporter;
     constructor(host: Host);
     tenant(locator: Locator, decl: Declaration | null, manifest: Manifest): Connector;
     component(component: Component): Component;
+    /**
+     * What this extension keeps in every process of a deployment, whatever that process runs:
+     * the ear a halt arrives at. Behind a gate, so that a halted process holds nothing — the
+     * subscription included — and hears the next signal only once it is back.
+     */
+    resident(host: Host): Connector | null;
     service(): Connector | null;
     /**
-     * `tenant()` runs before any component is created, so settings are warm.
-     * A component booted on its own (without a composition) falls back to
-     * the environment, with sampling off.
+     * `tenant()` runs before any component is created, so what it decided is warm.
+     * A component booted on its own (without a composition) falls back to the
+     * environment: it is on the map wherever collection is configured at all.
      */
-    private resolve;
+    private observed;
     /**
      * One collector per process — and per build of its tree. A reporter that went with a tree
      * that has been taken down holds remotes that are gone: it would answer that it is ready,

package/transpiled/Factory.js

@@ -1,50 +1,38 @@
 import { Connector } from '@toa.io/core';
-import { DISABLED, environment, component as declaration, settings } from '@toa.io/definitions/extensions.introspection';
+import { environment } from '@toa.io/definitions/extensions.introspection';
 import { NAMESPACE, uiPort } from '@toa.io/definitions/extensions.introspection';
 import { describe } from './describe.js';
 import { Reporter } from './Reporter.js';
 import { Tenant } from './Tenant.js';
+import { Halt } from './Halt.js';
 import { Composition } from './Composition.js';
 import { Explorer } from './Explorer.js';
 import { UI } from './UI.js';
-import { capture, samplable } from './sample.js';
 export class Factory {
     host;
     options;
-    settings = {};
+    mapped = {};
     reporter = null;
     constructor(host) {
         this.host = host;
         this.options = environment();
     }
     tenant(locator, decl, manifest) {
-        const resolved = settings(locator.namespace, declaration(decl), this.options);
-        this.settings[locator.id] = resolved;
-        if (!resolved.enabled || locator.namespace === NAMESPACE)
+        const mapped = this.options !== null && decl !== false;
+        this.mapped[locator.id] = mapped;
+        if (!mapped || locator.namespace === NAMESPACE)
             return new Connector();
         return new Tenant(this.collector(), describe(manifest));
     }
     component(component) {
         const locator = component.locator;
-        const resolved = this.resolve(locator);
-        if (!resolved.enabled)
+        if (!this.observed(locator))
             return component;
         const reporter = this.collector();
         const invoke = component.invoke.bind(component);
         component.invoke = async (endpoint, request) => {
-            let outcome = 'ok';
-            let reply;
             try {
-                reply = await invoke(endpoint, request);
-                if (reply?.exception !== undefined)
-                    outcome = 'exception';
-                else if (reply?.error !== undefined)
-                    outcome = 'error';
-                return reply;
-            }
-            catch (error) {
-                outcome = 'exception';
-                throw error;
+                return await invoke(endpoint, request);
             }
             finally {
                 // a call that failed is still a connection between two components
@@ -54,35 +42,44 @@ export class Factory {
                     component: locator.name,
                     operation: endpoint
                 };
-                const sample = resolved.samples && samplable(request?.input)
-                    ? capture(request?.input, outcome)
-                    : undefined;
-                reporter.observe({ src, dst, sample });
+                reporter.observe({ src, dst });
             }
         };
         component.depends(reporter);
         return component;
     }
+    /**
+     * What this extension keeps in every process of a deployment, whatever that process runs:
+     * the ear a halt arrives at. Behind a gate, so that a halted process holds nothing — the
+     * subscription included — and hears the next signal only once it is back.
+     */
+    resident(host) {
+        if (this.options?.halt !== true)
+            return null;
+        return host.gate(async () => new Halt(host, this.options));
+    }
+    // a halt takes the whole of it, the UI with it: a map nobody is reporting to is stale
     service() {
         if (this.options === null)
             return null;
-        const composition = new Composition(this.host);
-        const explorer = new Explorer();
-        explorer.depends(composition);
-        if (this.options.ui)
-            explorer.depends(new UI(uiPort()));
-        return explorer;
+        return this.host.gate(async () => {
+            const composition = new Composition(this.host);
+            const explorer = new Explorer();
+            explorer.depends(composition);
+            if (this.options?.ui === true)
+                explorer.depends(new UI(uiPort()));
+            return explorer;
+        });
     }
     /**
-     * `tenant()` runs before any component is created, so settings are warm.
-     * A component booted on its own (without a composition) falls back to
-     * the environment, with sampling off.
+     * `tenant()` runs before any component is created, so what it decided is warm.
+     * A component booted on its own (without a composition) falls back to the
+     * environment: it is on the map wherever collection is configured at all.
      */
-    resolve(locator) {
+    observed(locator) {
         if (locator.namespace === NAMESPACE)
-            return DISABLED;
-        return (this.settings[locator.id] ??
-            settings(locator.namespace, {}, this.options === null ? null : { ...this.options, samples: false }));
+            return false;
+        return this.mapped[locator.id] ?? this.options !== null;
     }
     /**
      * One collector per process — and per build of its tree. A reporter that went with a tree

package/transpiled/Factory.js.map

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