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

package/transpiled/Halt.d.ts

@@ -0,0 +1,72 @@
+import { Connector } from '@toa.io/core';
+import type { Options } from '@toa.io/definitions/extensions.introspection';
+import type { Host } from './Factory.ts';
+/**
+ * Hears a halt, takes the process quiet, and reads the map to find out whether the deployment
+ * went quiet with it.
+ *
+ * A signal is a record of `introspection.signals`, so what carries it is the event that
+ * component publishes on a committed write. The subscription takes no group, which is a queue
+ * of its own per process — so a signal written once reaches every process there is.
+ *
+ * **Any process may call the stop, and the rest obey without consulting their own view.**
+ * Seeing stillness is an assertion, acted on alone and binding on everyone; seeing activity is
+ * only an opinion, held quietly and given up if anyone asserts otherwise. Nothing has to be
+ * agreed, which is the point: `UPDATED` is one field overwritten in place, so no two processes
+ * reading the map read the same past, and a scheme that needed them to would need an atomic
+ * read point this has nowhere to take from.
+ *
+ * This sits behind a gate of its own, and so goes down with everything else. Nothing is
+ * listening while a halt lasts, which is what makes a halted process hold nothing open, and
+ * why a halt cannot be called off once it is down: it ends when the interval it carried is up,
+ * and by nothing else.
+ */
+export declare class Halt extends Connector {
+    private readonly host;
+    private readonly options;
+    private readonly remotes;
+    /** The halt this process is quiesced for, while it is. */
+    private pending;
+    private timer;
+    constructor(host: Host, options: Options);
+    protected open(): Promise<void>;
+    protected close(): Promise<void>;
+    private subscribe;
+    /**
+     * What arrives crosses the wire and outlives the release that wrote it, so every number is
+     * read as one and bounded here rather than trusted: the receiver is what has to come back.
+     */
+    private signalled;
+    private begin;
+    private quiesce;
+    /**
+     * The window is over. What the map says now is what this process has to go on, and what it
+     * says is one thing: whether anything, anywhere in this region, was called since the signal.
+     */
+    private decide;
+    /** No stop came. Nothing was closed, so nothing has to be built again. */
+    private give;
+    /** A stop is obeyed only while this process is quiesced for the halt it answers. */
+    private obey;
+    private down;
+    /**
+     * Whether nothing has been called in this region since the signal.
+     *
+     * The map is what the whole fleet writes, and a flush that observed nothing writes nothing —
+     * so a region with no edge newer than the signal is a region where nothing was called. It is
+     * read rather than voted on, and this process's own view of itself is not part of it: what a
+     * process is handling it has written no edge for yet, and a stop called while it was would
+     * still wait for it rather than interrupt it.
+     *
+     * Anything unanswered is activity. A process that cannot read the map does not stop the
+     * deployment on a guess.
+     */
+    private still;
+    /** Writes the stop. It reaches every process as the halt did, this one included. */
+    private call;
+    private later;
+    private disarm;
+    /** Runs in the background: discovery waits for the explorer as long as it takes. */
+    private acquire;
+    private reach;
+}

package/transpiled/Halt.js

@@ -0,0 +1,279 @@
+import { Connector, Locator } from '@toa.io/core';
+import { console } from 'openspan';
+import { environment, timeout } from '@toa.io/generic';
+import { CHECK_TIMEOUT, DEFAULT_GRACE, EDGES, GRACE, HALT_GAP, NAMESPACE, SIGNAL, SIGNALS } from '@toa.io/definitions/extensions.introspection';
+/**
+ * Hears a halt, takes the process quiet, and reads the map to find out whether the deployment
+ * went quiet with it.
+ *
+ * A signal is a record of `introspection.signals`, so what carries it is the event that
+ * component publishes on a committed write. The subscription takes no group, which is a queue
+ * of its own per process — so a signal written once reaches every process there is.
+ *
+ * **Any process may call the stop, and the rest obey without consulting their own view.**
+ * Seeing stillness is an assertion, acted on alone and binding on everyone; seeing activity is
+ * only an opinion, held quietly and given up if anyone asserts otherwise. Nothing has to be
+ * agreed, which is the point: `UPDATED` is one field overwritten in place, so no two processes
+ * reading the map read the same past, and a scheme that needed them to would need an atomic
+ * read point this has nowhere to take from.
+ *
+ * This sits behind a gate of its own, and so goes down with everything else. Nothing is
+ * listening while a halt lasts, which is what makes a halted process hold nothing open, and
+ * why a halt cannot be called off once it is down: it ends when the interval it carried is up,
+ * and by nothing else.
+ */
+export class Halt extends Connector {
+    host;
+    options;
+    remotes = {};
+    /** The halt this process is quiesced for, while it is. */
+    pending = null;
+    timer = null;
+    constructor(host, options) {
+        super();
+        this.host = host;
+        this.options = options;
+    }
+    async open() {
+        /*
+         * Deliberately not awaited. Reaching the component is a discovery, which waits as long as
+         * it takes, and in the explorer process the component being looked up is one this same
+         * process is still starting. A halt is not worth holding a boot for.
+         */
+        void this.subscribe().catch((error) => {
+            console.error('Introspection cannot subscribe to signals', {
+                message: error.message
+            });
+        });
+    }
+    async close() {
+        this.disarm();
+        this.pending = null;
+    }
+    async subscribe() {
+        const consumer = await this.host.receive(SIGNAL, new Subscription(this.signalled.bind(this)));
+        this.depends(consumer);
+        await consumer.connect();
+    }
+    /**
+     * What arrives crosses the wire and outlives the release that wrote it, so every number is
+     * read as one and bounded here rather than trusted: the receiver is what has to come back.
+     */
+    signalled(signal) {
+        if (signal?.type === 'halt')
+            this.begin(signal);
+        if (signal?.type === 'stop')
+            this.obey(signal);
+    }
+    begin(signal) {
+        // one at a time: a process quiesced for a halt is deaf to another, and to a redelivery
+        if (this.pending !== null || typeof signal.id !== 'string')
+            return;
+        const seconds = bound(signal.seconds, this.options.duration);
+        const quiescence = bound(signal.quiescence, this.options.quiescence);
+        const grace = bound(signal.grace, GRACE, DEFAULT_GRACE);
+        if (seconds === null || quiescence === null || grace === null)
+            return;
+        /*
+         * The map is read against the moment the signal was written, not the moment this process
+         * received it: `CREATED` and an edge's `UPDATED` are both written by the components of
+         * this extension, so they are one clock, and what this process's clock says about either
+         * is beside the point.
+         */
+        const since = typeof signal.CREATED === 'number' ? signal.CREATED : Date.now();
+        this.pending = { id: signal.id, seconds, quiescence, grace, since };
+        console.warn('Halt signalled, going quiet', { seconds, quiescence });
+        // the caller is a consumer callback, and this goes on to wait out a window under it
+        void this.quiesce(quiescence);
+    }
+    async quiesce(quiescence) {
+        // in the background, so that the map is reachable by the time there is a decision to make
+        this.acquire();
+        try {
+            await this.host.quiesce();
+        }
+        finally {
+            // whatever the quiesce did, there is a decision owed: one never taken is a process
+            // that is quiet for good
+            this.later(quiescence + HALT_GAP, () => void this.decide());
+        }
+    }
+    /**
+     * The window is over. What the map says now is what this process has to go on, and what it
+     * says is one thing: whether anything, anywhere in this region, was called since the signal.
+     */
+    async decide() {
+        const pending = this.pending;
+        if (pending === null)
+            return;
+        const still = await this.still(pending.since);
+        // someone else's stop may have landed while the map was being read
+        if (this.pending !== pending)
+            return;
+        if (still) {
+            console.warn('The deployment is still, calling the stop');
+            // written first, because what stops every other process is the record and not this one
+            if (await this.call(pending)) {
+                this.down(pending.seconds);
+                return;
+            }
+        }
+        /*
+         * Someone is always last to catch on. This process has concluded, and what it does now is
+         * wait for someone else's conclusion — listening, not looking again. It leaves the halt
+         * only if no stop arrives, and the guard covers the other order: one that has left ignores
+         * a stop that lands after.
+         */
+        console.warn('The deployment is working, waiting for another opinion', {
+            grace: pending.grace
+        });
+        this.later(pending.grace, () => void this.give());
+    }
+    /** No stop came. Nothing was closed, so nothing has to be built again. */
+    async give() {
+        if (this.pending === null)
+            return;
+        this.pending = null;
+        console.warn('Halt cancelled, this process is working');
+        await this.host.cancel();
+    }
+    /** A stop is obeyed only while this process is quiesced for the halt it answers. */
+    obey(signal) {
+        const pending = this.pending;
+        if (pending === null || signal.signal !== pending.id)
+            return;
+        this.down(pending.seconds);
+    }
+    down(seconds) {
+        this.disarm();
+        this.pending = null;
+        this.host.stop(seconds);
+    }
+    /**
+     * Whether nothing has been called in this region since the signal.
+     *
+     * The map is what the whole fleet writes, and a flush that observed nothing writes nothing —
+     * so a region with no edge newer than the signal is a region where nothing was called. It is
+     * read rather than voted on, and this process's own view of itself is not part of it: what a
+     * process is handling it has written no edge for yet, and a stop called while it was would
+     * still wait for it rather than interrupt it.
+     *
+     * Anything unanswered is activity. A process that cannot read the map does not stop the
+     * deployment on a guess.
+     */
+    async still(since) {
+        const edges = this.remotes[EDGES];
+        if (edges === undefined)
+            return false;
+        const criteria = `UPDATED>${since};REGION==${REGION}`;
+        try {
+            const reply = await race(edges.invoke('enumerate', { query: { criteria, limit: 1 } }));
+            const rows = Array.isArray(reply) ? reply : reply?.output;
+            if (!Array.isArray(rows)) {
+                console.warn('The map answered something else', { reply });
+                return false;
+            }
+            return rows.length === 0;
+        }
+        catch (error) {
+            console.error('The map could not be read', { message: error.message });
+            return false;
+        }
+    }
+    /** Writes the stop. It reaches every process as the halt did, this one included. */
+    async call(pending) {
+        const signals = this.remotes[SIGNALS];
+        if (signals === undefined)
+            return false;
+        try {
+            const reply = await race(signals.invoke('create', {
+                input: {
+                    type: 'stop',
+                    seconds: pending.seconds,
+                    // what the halt asked for, because a record says what it was answering
+                    quiescence: pending.quiescence,
+                    signal: pending.id
+                }
+            }));
+            if (reply?.error !== undefined || reply?.exception !== undefined) {
+                console.error('The stop was refused', { reply });
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('The stop could not be written', {
+                message: error.message
+            });
+            return false;
+        }
+    }
+    later(seconds, fn) {
+        this.disarm();
+        this.timer = setTimeout(fn, seconds * 1000);
+        this.timer.unref();
+    }
+    disarm() {
+        if (this.timer === null)
+            return;
+        clearTimeout(this.timer);
+        this.timer = null;
+    }
+    /** Runs in the background: discovery waits for the explorer as long as it takes. */
+    acquire() {
+        for (const name of [EDGES, SIGNALS]) {
+            if (name in this.remotes)
+                continue;
+            void this.reach(name).catch((error) => {
+                console.error('Introspection cannot reach its explorer', {
+                    message: error.message
+                });
+            });
+        }
+    }
+    async reach(name) {
+        const remote = await this.host.remote(new Locator(name, NAMESPACE));
+        this.depends(remote);
+        await remote.connect();
+        this.remotes[name] = remote;
+    }
+}
+/** What a binding hands a message to; the connector's lifecycle is not the handler's. */
+class Subscription extends Connector {
+    handler;
+    constructor(handler) {
+        super();
+        this.handler = handler;
+    }
+    async receive(message) {
+        this.handler(message.payload);
+    }
+}
+/** A number as it came, within what this release accepts, or `null` where it is not one. */
+function bound(value, [min, max], fallback) {
+    if (value === undefined && fallback !== undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return null;
+    return Math.min(max, Math.max(min, Math.round(value)));
+}
+/**
+ * A quiesced process that waits for an answer that never comes is a process that never comes
+ * back, so every call a decision rests on is given a deadline.
+ *
+ * What runs out of it is a failure and not an answer: a stop whose write went unacknowledged
+ * may never have been written, and a process that took it for one would go down alone.
+ */
+async function race(call) {
+    const reply = await Promise.race([
+        call,
+        timeout(CHECK_TIMEOUT).then(() => UNANSWERED)
+    ]);
+    if (reply === UNANSWERED)
+        throw new Error(`it was not answered within ${CHECK_TIMEOUT}ms`);
+    return reply;
+}
+const UNANSWERED = Symbol('unanswered');
+/** The region this deployment is, which is the only one its map answers for. */
+const REGION = Number(environment.get('TOA_REGION') ?? 0);
+//# sourceMappingURL=Halt.js.map

package/transpiled/Halt.js.map

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

package/transpiled/Reporter.d.ts

@@ -28,7 +28,17 @@ export declare class Reporter extends Connector {
     /** A call between two components. */
     observe(observed: Edge): void;
     protected open(): Promise<void>;
+    /**
+     * A quiesced process flushes every second instead of on its configured period, because what
+     * it observed last is the evidence a halt is decided on and the decision is seconds away.
+     *
+     * It costs nothing: nothing is calling anything, so every flush but the first finds an empty
+     * buffer and returns without a call.
+     */
+    protected pause(): void;
+    protected unpause(): void;
     protected close(): Promise<void>;
+    private every;
     private ready;
     private flush;
     private discard;

package/transpiled/Reporter.js

@@ -1,6 +1,6 @@
 import { Connector, Locator } from '@toa.io/core';
 import { console } from 'openspan';
-import { EDGES, MAX_EDGES, NAMESPACE, NODES } from '@toa.io/definitions/extensions.introspection';
+import { EDGES, MAX_EDGES, NAMESPACE, NODES, QUIESCE_INTERVAL } from '@toa.io/definitions/extensions.introspection';
 import * as keys from './keys.js';
 /**
  * Buffers what a process observes and flushes it into the introspection
@@ -35,8 +35,7 @@ export class Reporter extends Connector {
     /** A call between two components. */
     observe(observed) {
         const id = keys.edge(observed.src, observed.dst);
-        const edge = this.edges.get(id);
-        if (edge === undefined) {
+        if (!this.edges.has(id)) {
             /*
              * `source` arrives over the wire, so the number of distinct edges a process
              * can hold has to be bounded regardless of what peers send — and of whether
@@ -48,16 +47,27 @@ export class Reporter extends Connector {
             }
             this.edges.set(id, observed);
         }
-        else if (observed.sample !== undefined)
-            edge.sample = observed.sample;
         if (this.edges.size >= this.options.threshold)
             void this.flush();
     }
     async open() {
         // deliberately not awaited: the explorer may not be there yet, or at all
         this.acquire();
-        this.timer = setInterval(() => void this.flush(), this.options.interval * 1000);
-        this.timer.unref();
+        this.every(this.options.interval);
+    }
+    /**
+     * A quiesced process flushes every second instead of on its configured period, because what
+     * it observed last is the evidence a halt is decided on and the decision is seconds away.
+     *
+     * It costs nothing: nothing is calling anything, so every flush but the first finds an empty
+     * buffer and returns without a call.
+     */
+    pause() {
+        this.every(QUIESCE_INTERVAL);
+        void this.flush();
+    }
+    unpause() {
+        this.every(this.options.interval);
     }
     async close() {
         if (this.timer !== null) {
@@ -74,6 +84,12 @@ export class Reporter extends Connector {
             console.debug('Introspection final flush failed', { message: error.message });
         });
     }
+    every(seconds) {
+        if (this.timer !== null)
+            clearInterval(this.timer);
+        this.timer = setInterval(() => void this.flush(), seconds * 1000);
+        this.timer.unref();
+    }
     ready() {
         return NODES in this.remotes && EDGES in this.remotes;
     }

package/transpiled/Reporter.js.map

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

package/transpiled/index.d.ts

@@ -1,4 +1,4 @@
 export { Factory } from './Factory.ts';
 export { components } from './Composition.ts';
-export type { Annotation, Declaration, Options, Settings } from '@toa.io/definitions/extensions.introspection';
+export type { Annotation, Declaration, Options } from '@toa.io/definitions/extensions.introspection';
 export type * from './model.ts';

package/transpiled/model.d.ts

@@ -52,21 +52,14 @@ export interface Node {
     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.
+ * A call observed in a process between flushes: that it was made, and between whom —
+ * never what it carried. 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;
 }