@hotmeshio/long-tail 0.26.0 → 0.28.0

package/build/lib/machines/protocol/codec.js

@@ -8,12 +8,21 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GENERIC_CHANNELS = exports.RECEIPT_FROM = exports.DISPATCH_ON = void 0;
+exports.declaredRowOps = declaredRowOps;
 exports.topicOf = topicOf;
 exports.genericCodec = genericCodec;
 const constants_1 = require("./constants");
 const contract_1 = require("./contract");
 const envelope_1 = require("./envelope");
 const topics_1 = require("./topics");
+/** The codec's own row ops, each a non-empty string; anything else is a misconfigured codec and throws. */
+function declaredRowOps(codec) {
+    const ops = codec.rowOps ?? [];
+    if (!Array.isArray(ops) || ops.some((op) => typeof op !== 'string' || !op)) {
+        throw new Error('codec.rowOps must be a list of non-empty strings');
+    }
+    return ops;
+}
 exports.DISPATCH_ON = { CREATED: 'created', ARRIVAL: 'arrival' };
 /** Which job event counts as the receiver's receipt. */
 exports.RECEIPT_FROM = { ARRIVED: 'arrived', BOUND: 'bound', STARTED: 'started' };
@@ -66,6 +75,7 @@ function genericCodec(opts) {
         channels: exports.GENERIC_CHANNELS,
         unitsPerDispatch: opts.unitsPerDispatch ?? null,
         dispatchOn: opts.dispatchOn ?? exports.DISPATCH_ON.CREATED,
+        retainedAlarms: true,
         decode(topic, payload, retained) {
             const seen = atMachine((0, contract_1.inspectMessage)(opts.root, topic, payload, retained), ids);
             if (!seen.parsed)

package/build/lib/machines/protocol/constants.d.ts

@@ -93,7 +93,7 @@ export declare const OP: {
     readonly CANCEL: "cancel";
     /** Take work: begin or continue the queue. */
     readonly START: "start";
-    /** Finish the current unit, then take no more; the queue is kept. */
+    /** Finish the current unit, then take no more; the queue is kept. With `args.jobId`, stop that job at a safe point and hold its units. */
     readonly STOP: "stop";
     /** Halt at the next safe point, holding the current unit; nothing new starts. */
     readonly PAUSE: "pause";

package/build/lib/machines/protocol/constants.js

@@ -77,7 +77,7 @@ exports.OP = {
     CANCEL: 'cancel',
     /** Take work: begin or continue the queue. */
     START: 'start',
-    /** Finish the current unit, then take no more; the queue is kept. */
+    /** Finish the current unit, then take no more; the queue is kept. With `args.jobId`, stop that job at a safe point and hold its units. */
     STOP: 'stop',
     /** Halt at the next safe point, holding the current unit; nothing new starts. */
     PAUSE: 'pause',

package/build/lib/machines/protocol/contract.js

@@ -35,7 +35,7 @@ const ENVELOPE = shape({
 });
 const RECIPE = { anyOf: [shape({ id: STR, version: STR }), { type: 'null' }] };
 const BODY = {
-    [topics_1.MESSAGE_KIND.PRESENCE]: shape({ online: BOOL, software: STR }, ['software']),
+    [topics_1.MESSAGE_KIND.PRESENCE]: shape({ online: BOOL, software: STR, sessionId: STR, reason: STR }, ['software', 'sessionId', 'reason']),
     [topics_1.MESSAGE_KIND.SNAPSHOT]: shape({
         bootId: STR, software: STR, mode: oneOf(constants_1.MODE), enabled: BOOL, recipe: RECIPE,
         jobs: { type: 'array', items: shape({ jobId: STR, units: { type: 'array', items: STR }, status: STR }) },
@@ -51,7 +51,8 @@ const BODY = {
         },
         materials: { type: 'array', items: shape({ material: STR, lot: STR }) },
         startedAt: TS, endedAt: TS, durationMs: INT0, failure: oneOf(constants_1.TRANSFER_FAILURE),
-    }, ['peer', 'result', 'reason', 'measurements', 'materials', 'startedAt', 'endedAt', 'durationMs', 'failure']),
+        percent: { type: 'number', minimum: 0, maximum: 100 }, remainingSec: INT0, stage: STR, detail: { type: 'object' },
+    }, ['jobId', 'unitId', 'peer', 'result', 'reason', 'measurements', 'materials', 'startedAt', 'endedAt', 'durationMs', 'failure', 'percent', 'remainingSec', 'stage', 'detail']),
     [topics_1.MESSAGE_KIND.ALARM]: shape({
         alarmId: STR, code: STR, level: oneOf(constants_1.LEVEL), text: STR, active: BOOL,
         raisedAt: TS, clearedAt: TS_N, clearedBy: STR_N, ackedBy: STR_N, ackedAt: TS_N,
@@ -59,7 +60,7 @@ const BODY = {
     }),
     [topics_1.MESSAGE_KIND.TELEMETRY]: shape({ readings: { type: 'object', additionalProperties: NUM } }),
     [topics_1.MESSAGE_KIND.CMD]: shape({ cmdId: STR, op: oneOf(constants_1.OP), args: { type: 'object' } }),
-    [topics_1.MESSAGE_KIND.REPLY]: shape({ cmdId: STR, status: oneOf(constants_1.REPLY_STATUS), reason: STR }),
+    [topics_1.MESSAGE_KIND.REPLY]: shape({ cmdId: STR, status: oneOf(constants_1.REPLY_STATUS), reason: STR, code: STR }, ['code']),
     [topics_1.MESSAGE_KIND.REPORT]: { type: 'object' },
 };
 const ajv = new ajv_1.default({ allErrors: true, strict: false });
@@ -92,6 +93,8 @@ function inspectMessage(root, topic, raw, retained) {
     violations.push(...crossFieldRules(parsed, body, retained));
     return { parsed, body, violations };
 }
+/** Job events a receiver may report naming only the carrier it scanned. */
+const CARRIER_EVENTS = [constants_1.JOB_EVENT.ARRIVED, constants_1.JOB_EVENT.TRANSFER_FAILED];
 function crossFieldRules(parsed, env, retained) {
     const out = [];
     const b = env.body ?? {};
@@ -102,6 +105,12 @@ function crossFieldRules(parsed, env, retained) {
     if (kind === topics_1.MESSAGE_KIND.ALARM && b.alarmId !== key)
         out.push('alarmId disagrees with the topic');
     if (kind === topics_1.MESSAGE_KIND.JOB) {
+        // A scan at a receiver may read only the carrier; every other job event names its unit and job.
+        const byCarrier = CARRIER_EVENTS.includes(b.event) && typeof b.carrierId === 'string';
+        if (b.unitId === undefined && !byCarrier)
+            out.push(`${b.event} without a unitId`);
+        if (b.jobId === undefined && !byCarrier)
+            out.push(`${b.event} without a jobId`);
         if (b.event === constants_1.JOB_EVENT.FINISHED) {
             for (const field of ['result', 'measurements', 'materials', 'startedAt', 'endedAt']) {
                 if (!(field in b))

package/build/lib/machines/site/edge-account.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A line's edge account on Long Tail's NATS: the machine broker's bridge logs
+ * in by client certificate (the CN is its user), over MQTT only, and may
+ * publish under the line's topics and subscribe to nothing. Long Tail imports
+ * exactly those subjects.
+ */
+import type { EdgeAccount } from '../../messaging/nats/render-conf';
+import type { LineDef } from '../line';
+/** An account name for a line: letters, digits, `-` and `_`. */
+export declare function edgeAccountName(line: LineDef): string;
+export declare function edgeAccountFor(line: LineDef, root: string, bridgeUser?: string): EdgeAccount;

package/build/lib/machines/site/edge-account.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * A line's edge account on Long Tail's NATS: the machine broker's bridge logs
+ * in by client certificate (the CN is its user), over MQTT only, and may
+ * publish under the line's topics and subscribe to nothing. Long Tail imports
+ * exactly those subjects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.edgeAccountName = edgeAccountName;
+exports.edgeAccountFor = edgeAccountFor;
+const protocol_1 = require("../protocol");
+const site_conf_1 = require("./site-conf");
+/** An account name for a line: letters, digits, `-` and `_`. */
+function edgeAccountName(line) {
+    return `EDGE_${line.siteId}_${line.lineId}`.replace(/[^A-Za-z0-9_-]/g, '_');
+}
+function edgeAccountFor(line, root, bridgeUser = `CN=${(0, site_conf_1.bridgeId)(line)}`) {
+    const subjects = `${(0, protocol_1.toSubject)(`${root}/${line.siteId}/${line.lineId}`)}.>`;
+    return {
+        name: edgeAccountName(line),
+        subjects,
+        users: [{ user: bridgeUser, allowed_connection_types: ['MQTT'], permissions: { publish: [subjects], subscribe: { deny: ['>'] } } }],
+    };
+}

package/build/lib/machines/site/mosquitto-conf.d.ts

@@ -1,5 +1,5 @@
 /**
- * The machine broker (Mosquitto), rendered from the line. Machines speak
+ * The machine broker (Mosquitto), rendered from its lines. Machines speak
  * MQTT 5 to it over TLS, each with its own client certificate (the CN is
  * its username). The ACL lets a machine publish only its own channels and
  * read only its own commands, and lets the line controller command every
@@ -7,7 +7,7 @@
  * NATS, where JetStream keeps them.
  */
 import { type LineCodec } from '../protocol/codec';
-import { type LineDef } from '../line';
+import { type Lines } from './site-conf';
 export interface MosquittoConfOptions {
     root: string;
     /** Certificate directory as the broker sees it. */
@@ -17,11 +17,12 @@ export interface MosquittoConfOptions {
     aclFile: string;
     maxPacketBytes?: number;
 }
-export declare function renderMosquittoConf(line: LineDef, opts: MosquittoConfOptions): string;
+/** The broker for one line or several: one listener, one bridge per line. */
+export declare function renderMosquittoConf(lines: Lines, opts: MosquittoConfOptions): string;
 /**
  * The codec's channels decide the topics: a machine writes its events and telemetry and reads its commands.
  * A station whose address the line learns has no user of its own: `pattern` rules give every certificate
  * the channels under its own name (%u), so its certificate's common name must be its address. On a line
  * that also declares addresses, a certificate named for a declared address is denied that station's channels.
  */
-export declare function renderMosquittoAcl(line: LineDef, codec: Pick<LineCodec, 'root' | 'channels' | 'topicFor'>): string;
+export declare function renderMosquittoAcl(lines: Lines, codec: Pick<LineCodec, 'root' | 'channels' | 'topicFor'>): string;

package/build/lib/machines/site/mosquitto-conf.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * The machine broker (Mosquitto), rendered from the line. Machines speak
+ * The machine broker (Mosquitto), rendered from its lines. Machines speak
  * MQTT 5 to it over TLS, each with its own client certificate (the CN is
  * its username). The ACL lets a machine publish only its own channels and
  * read only its own commands, and lets the line controller command every
@@ -14,7 +14,26 @@ const envelope_1 = require("../protocol/envelope");
 const codec_1 = require("../protocol/codec");
 const line_1 = require("../line");
 const site_conf_1 = require("./site-conf");
-function renderMosquittoConf(line, opts) {
+/** One bridge connection per line, carrying the line's topics out to the site NATS. */
+function bridgeBlock(line, opts) {
+    return `connection ${line.siteId}-${line.lineId}-site-nats
+address ${opts.siteNats}
+bridge_protocol_version mqttv311
+bridge_cafile ${opts.certDir}/ca.pem
+bridge_certfile ${opts.certDir}/${(0, site_conf_1.bridgeId)(line)}.pem
+bridge_keyfile ${opts.certDir}/${(0, site_conf_1.bridgeId)(line)}.key
+remote_clientid ${(0, site_conf_1.bridgeId)(line)}
+cleansession false
+try_private false
+notifications false
+topic ${opts.root}/${line.siteId}/${line.lineId}/# out 1
+`;
+}
+/** The broker for one line or several: one listener, one bridge per line. */
+function renderMosquittoConf(lines, opts) {
+    const list = (0, site_conf_1.linesOf)(lines);
+    if (!list.length)
+        throw new Error('renderMosquittoConf needs at least one line');
     return `# Rendered from the line definition by site/setup.ts. Do not edit by hand.
 persistence true
 persistence_location /mosquitto/data/
@@ -32,18 +51,7 @@ use_identity_as_username true
 acl_file ${opts.aclFile}
 max_packet_size ${opts.maxPacketBytes ?? 262_144}
 
-connection ${line.siteId}-${line.lineId}-site-nats
-address ${opts.siteNats}
-bridge_protocol_version mqttv311
-bridge_cafile ${opts.certDir}/ca.pem
-bridge_certfile ${opts.certDir}/${(0, site_conf_1.bridgeId)(line)}.pem
-bridge_keyfile ${opts.certDir}/${(0, site_conf_1.bridgeId)(line)}.key
-remote_clientid ${(0, site_conf_1.bridgeId)(line)}
-cleansession false
-try_private false
-notifications false
-topic ${opts.root}/${line.siteId}/${line.lineId}/# out 1
-`;
+${list.map((line) => bridgeBlock(line, opts)).join('\n')}`;
 }
 /**
  * The codec's channels decide the topics: a machine writes its events and telemetry and reads its commands.
@@ -51,7 +59,14 @@ topic ${opts.root}/${line.siteId}/${line.lineId}/# out 1
  * the channels under its own name (%u), so its certificate's common name must be its address. On a line
  * that also declares addresses, a certificate named for a declared address is denied that station's channels.
  */
-function renderMosquittoAcl(line, codec) {
+function renderMosquittoAcl(lines, codec) {
+    const list = (0, site_conf_1.linesOf)(lines);
+    if (!list.length)
+        throw new Error('renderMosquittoAcl needs at least one line');
+    return `# Rendered from the line definition by site/setup.ts. Do not edit by hand.\n\n${list.map((line) => aclRules(line, codec)).join('\n\n')}\n`;
+}
+/** One line's rules: its stations, its controller, and the shadows a learning line needs. */
+function aclRules(line, codec) {
     const { siteId, lineId } = line;
     const { events, telemetry, commands } = codec.channels;
     const own = (address, channels) => channels.map((c) => (0, codec_1.topicOf)(codec, { siteId, lineId, address }, c));
@@ -70,7 +85,7 @@ function renderMosquittoAcl(line, codec) {
         ...commands.map((c) => `topic write ${(0, codec_1.topicOf)(codec, { siteId, lineId }, c)}`),
         `topic read ${codec.root}/${siteId}/${lineId}/#`,
     ].join('\n');
-    return `# Rendered from the line definition by site/setup.ts. Do not edit by hand.\n\n${[...learned, ...shadows, ...machines, controller].join('\n\n')}\n`;
+    return [...learned, ...shadows, ...machines, controller].join('\n\n');
 }
 /** Deny a declared station's channels to a certificate named for its address, which the patterns would grant. */
 function shadowRules(line, address, topics) {

package/build/lib/machines/site/site-conf.d.ts

@@ -1,12 +1,13 @@
 /**
- * The site's NATS server, rendered from the line. It runs JetStream and an
+ * The site's NATS server, rendered from its lines. It runs JetStream and an
  * MQTT listener that only the machine broker's bridge logs in to (by client
  * certificate; the CN is its user, and it may publish only under the line's
- * topics). The gateway logs in by password and may only read: the JetStream
- * API, acks and its inbox, and the line's subjects. The site NATS stands
- * alone; Long Tail's escalation events stay inside Long Tail.
+ * topics). The gateway logs in by password and may only keep and read the
+ * line's streams through its own consumer (it can neither publish a machine
+ * subject nor delete a stream), and subscribe to its inbox and the line. The
+ * site NATS stands alone; Long Tail's escalation events stay inside Long Tail.
  */
-import type { LineDef } from '../line';
+import { type LineDef } from '../line';
 export interface SiteConfOptions {
     root: string;
     gatewayUser: string;
@@ -17,4 +18,13 @@ export interface SiteConfOptions {
 }
 /** The machine broker's bridge identity for a line. */
 export declare function bridgeId(line: LineDef): string;
-export declare function renderSiteConf(line: LineDef, opts: SiteConfOptions): string;
+/** What the gateway may publish: its streams' and its consumer's JetStream requests and acks, never a machine subject. */
+export declare function gatewayPublish(line: LineDef): string[];
+/** One line, or every line the site runs. */
+export type Lines = LineDef | LineDef[];
+export declare function linesOf(lines: Lines): LineDef[];
+/**
+ * The site NATS for one line or several: one bridge user per line, one
+ * gateway user allowed every line's streams and subjects.
+ */
+export declare function renderSiteConf(lines: Lines, opts: SiteConfOptions): string;

package/build/lib/machines/site/site-conf.js

@@ -1,35 +1,61 @@
 "use strict";
 /**
- * The site's NATS server, rendered from the line. It runs JetStream and an
+ * The site's NATS server, rendered from its lines. It runs JetStream and an
  * MQTT listener that only the machine broker's bridge logs in to (by client
  * certificate; the CN is its user, and it may publish only under the line's
- * topics). The gateway logs in by password and may only read: the JetStream
- * API, acks and its inbox, and the line's subjects. The site NATS stands
- * alone; Long Tail's escalation events stay inside Long Tail.
+ * topics). The gateway logs in by password and may only keep and read the
+ * line's streams through its own consumer (it can neither publish a machine
+ * subject nor delete a stream), and subscribe to its inbox and the line. The
+ * site NATS stands alone; Long Tail's escalation events stay inside Long Tail.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bridgeId = bridgeId;
+exports.gatewayPublish = gatewayPublish;
+exports.linesOf = linesOf;
 exports.renderSiteConf = renderSiteConf;
+const line_1 = require("../line");
 const protocol_1 = require("../protocol");
+const permissions_1 = require("../../messaging/nats/permissions");
+const streams_1 = require("../transport/streams");
 const q = JSON.stringify;
 /** The machine broker's bridge identity for a line. */
 function bridgeId(line) {
     return `${line.siteId}-${line.lineId}-bridge`;
 }
-/** What the gateway may publish: JetStream requests, acks and flow control, never a machine subject. */
-const GATEWAY_PUBLISH = ['$JS.API.>', '$JS.ACK.>', '$JS.FC.>'];
-function renderSiteConf(line, opts) {
-    const base = (0, protocol_1.toSubject)(`${opts.root}/${line.siteId}/${line.lineId}`);
-    const bridge = [
+/** What the gateway may publish: its streams' and its consumer's JetStream requests and acks, never a machine subject. */
+function gatewayPublish(line) {
+    return (0, permissions_1.jsPermissions)({ streams: Object.values(streams_1.LINE_STREAM), durable: `${(0, line_1.controllerId)(line)}-events` }).publish;
+}
+function linesOf(lines) {
+    return Array.isArray(lines) ? lines : [lines];
+}
+/** The server's name: the line for one line, the site when every line shares it, `site` otherwise. */
+function serverName(lines) {
+    if (lines.length === 1)
+        return `${lines[0].siteId}-${lines[0].lineId}`;
+    const sites = new Set(lines.map((l) => l.siteId));
+    return sites.size === 1 ? lines[0].siteId : 'site';
+}
+/**
+ * The site NATS for one line or several: one bridge user per line, one
+ * gateway user allowed every line's streams and subjects.
+ */
+function renderSiteConf(lines, opts) {
+    const list = linesOf(lines);
+    if (!list.length)
+        throw new Error('renderSiteConf needs at least one line');
+    const baseOf = (line) => (0, protocol_1.toSubject)(`${opts.root}/${line.siteId}/${line.lineId}`);
+    const bridge = list.map((line) => [
         `    { user: ${q(`CN=${bridgeId(line)}`)}, allowed_connection_types: ["MQTT"],`,
-        `      permissions: { publish: [${q(`${base}.>`)}], subscribe: { deny: [">"] } } }`,
-    ].join('\n');
+        `      permissions: { publish: [${q(`${baseOf(line)}.>`)}], subscribe: { deny: [">"] } } }`,
+    ].join('\n')).join('\n');
+    const publish = [...new Set(list.flatMap((line) => gatewayPublish(line)))];
     const gateway = [
         `    { user: ${q(opts.gatewayUser)}, password: ${q(opts.gatewayPassword)}, allowed_connection_types: ["STANDARD"],`,
-        `      permissions: { publish: ${q(GATEWAY_PUBLISH)}, subscribe: ${q(['_INBOX.>', `${base}.>`])} } }`,
+        `      permissions: { publish: ${q(publish)}, subscribe: ${q(['_INBOX.>', ...list.map((line) => `${baseOf(line)}.>`)])} } }`,
     ].join('\n');
     return `# Rendered from the line definition by site/setup.ts. Do not edit by hand.
-server_name: ${q(`${line.siteId}-${line.lineId}`)}
+server_name: ${q(serverName(list))}
 port: 4222
 http: 8222
 jetstream { store_dir: ${q(opts.storeDir)} }

package/build/lib/machines/transport/callback-feed.d.ts

@@ -14,5 +14,6 @@ export declare class CallbackEscalationFeed implements EscalationFeed {
     constructor(adapter: CallbackEventAdapter, nakDelayMs?: number);
     connect(): Promise<void>;
     consume(handler: (event: EscalationEvent) => Promise<MachineDisposition>): Promise<void>;
+    unsubscribe(): Promise<void>;
     close(): Promise<void>;
 }

package/build/lib/machines/transport/callback-feed.js

@@ -23,9 +23,12 @@ class CallbackEscalationFeed {
                 void this.redelivery.deliver(() => handler(event));
         });
     }
-    async close() {
+    async unsubscribe() {
         this.off?.();
         await this.redelivery.stop();
     }
+    async close() {
+        await this.unsubscribe();
+    }
 }
 exports.CallbackEscalationFeed = CallbackEscalationFeed;

package/build/lib/machines/transport/delivery.d.ts

@@ -4,17 +4,16 @@
  * own commands. The gateway holds a MachineBus: durable, ordered delivery of
  * every machine message on the line, QoS 1 command egress, and retained reads.
  */
+import type { Delivery } from '../../../types/messaging';
 import type { EscalationEvent, EscalationFeed, InboundMessage, LinkConnectOptions, LinkWill, MachineBus, MachineLink, PublishOptions } from '../../../types/machines';
 export type { EscalationEvent, EscalationFeed, InboundMessage, LinkConnectOptions, LinkWill, MachineBus, MachineLink, PublishOptions };
+/** What the gateway does with a machine message: the messaging capability's deliveries (nak: its row does not exist yet). */
 export declare const DISPOSITION: {
-    /** Handled; do not deliver again. */
     readonly ACK: "ack";
-    /** Not yet actionable (its row does not exist yet); deliver again later. */
     readonly NAK: "nak";
-    /** Never actionable; drop it. */
     readonly TERM: "term";
 };
-export type Disposition = typeof DISPOSITION[keyof typeof DISPOSITION];
+export type Disposition = Delivery;
 /** MQTT filter match with `+` (one level) and `#` (the rest). */
 export declare function topicMatches(filter: string, topic: string): boolean;
 /** Read an LTEvent body into an EscalationEvent; null for other families. */

package/build/lib/machines/transport/delivery.js

@@ -9,14 +9,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DISPOSITION = void 0;
 exports.topicMatches = topicMatches;
 exports.toEscalationEvent = toEscalationEvent;
-exports.DISPOSITION = {
-    /** Handled; do not deliver again. */
-    ACK: 'ack',
-    /** Not yet actionable (its row does not exist yet); deliver again later. */
-    NAK: 'nak',
-    /** Never actionable; drop it. */
-    TERM: 'term',
-};
+const constants_1 = require("../../messaging/constants");
+/** What the gateway does with a machine message: the messaging capability's deliveries (nak: its row does not exist yet). */
+exports.DISPOSITION = constants_1.DELIVERY;
 /** MQTT filter match with `+` (one level) and `#` (the rest). */
 function topicMatches(filter, topic) {
     const f = filter.split('/');

package/build/lib/machines/transport/index.d.ts

@@ -6,6 +6,8 @@ export * from './streams';
 export * from './mqtt-session';
 export * from './mqtt-link';
 export * from './mqtt-bus';
+export * from './stream-bus';
 export * from './nats-bus';
 export * from './nats-feed';
+export * from './pubsub-feed';
 export * from './callback-feed';

package/build/lib/machines/transport/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./streams"), exports);
 __exportStar(require("./mqtt-session"), exports);
 __exportStar(require("./mqtt-link"), exports);
 __exportStar(require("./mqtt-bus"), exports);
+__exportStar(require("./stream-bus"), exports);
 __exportStar(require("./nats-bus"), exports);
 __exportStar(require("./nats-feed"), exports);
+__exportStar(require("./pubsub-feed"), exports);
 __exportStar(require("./callback-feed"), exports);

package/build/lib/machines/transport/memory.d.ts

@@ -26,6 +26,7 @@ export declare class MemoryMachineBus implements MachineBus {
         retain?: boolean;
     }): Promise<void>;
     retained(filter: string): Promise<InboundMessage[]>;
+    unsubscribe(): Promise<void>;
     close(): Promise<void>;
 }
 export declare class MemoryEscalationFeed implements EscalationFeed {
@@ -36,5 +37,6 @@ export declare class MemoryEscalationFeed implements EscalationFeed {
     emit(body: Record<string, any>): void;
     connect(): Promise<void>;
     consume(handler: (event: EscalationEvent) => Promise<Disposition>): Promise<void>;
+    unsubscribe(): Promise<void>;
     close(): Promise<void>;
 }

package/build/lib/machines/transport/memory.js

@@ -50,6 +50,9 @@ class MemoryMachineBus {
     async retained(filter) {
         return this.broker.retained(filter);
     }
+    async unsubscribe() {
+        this.broker.detach(this.durableName);
+    }
     async close() {
         this.broker.detach(this.durableName);
     }
@@ -72,6 +75,9 @@ class MemoryEscalationFeed {
             return event ? handler(event) : delivery_1.DISPOSITION.TERM;
         });
     }
+    async unsubscribe() {
+        this.broker.detach(this.durableName);
+    }
     async close() {
         this.broker.detach(this.durableName);
     }

package/build/lib/machines/transport/mqtt-bus.d.ts

@@ -19,6 +19,8 @@ export declare class MqttMachineBus implements MachineBus {
         retain?: boolean;
     }): Promise<void>;
     retained(filter: string): Promise<InboundMessage[]>;
+    /** Stops delivery in this process; the persistent session keeps its subscription, so messages queue for the next gateway. */
+    unsubscribe(): Promise<void>;
     close(): Promise<void>;
     private connected;
 }

package/build/lib/machines/transport/mqtt-bus.js

@@ -30,6 +30,10 @@ class MqttMachineBus {
     retained(filter) {
         return this.connected().retained(filter);
     }
+    /** Stops delivery in this process; the persistent session keeps its subscription, so messages queue for the next gateway. */
+    async unsubscribe() {
+        await this.redelivery.stop();
+    }
     async close() {
         await this.redelivery.stop();
         await this.session?.close(true);

package/build/lib/machines/transport/nats-bus.d.ts

@@ -1,12 +1,10 @@
 /**
- * The gateway on the site NATS. Machine events come from the line's durable
- * consumer on LINE_EVENTS (replayed after a restart); telemetry is read live,
- * since it only proves a machine is alive. Commands leave through an MQTT
- * session at QoS 1: a NATS publish reaches MQTT subscribers at QoS 0 and
- * would not wait for a machine that is away.
+ * The gateway on a NATS server of the site's own (MACHINE_SITE_NATS_*): the
+ * stream bus on a NATS messaging provider this bus connects and closes itself.
+ * With Long Tail's messaging configured, the stream bus runs on that instead.
  */
 import type { MqttEndpoint } from '../../../services/machines/config';
-import { type StreamCodec } from './streams';
+import type { StreamCodec } from './streams';
 import type { Disposition, InboundMessage, MachineBus } from './delivery';
 export interface NatsBusOptions {
     natsUrl: string;
@@ -23,11 +21,8 @@ export interface NatsBusOptions {
 }
 export declare class NatsMachineBus implements MachineBus {
     private readonly opts;
-    private nc?;
-    private session?;
-    private messages?;
-    private telemetry;
-    private readonly queue;
+    private readonly provider;
+    private bus?;
     constructor(opts: NatsBusOptions);
     get durableName(): string;
     connect(): Promise<void>;
@@ -36,7 +31,7 @@ export declare class NatsMachineBus implements MachineBus {
         retain?: boolean;
     }): Promise<void>;
     retained(filter: string): Promise<InboundMessage[]>;
+    unsubscribe(): Promise<void>;
     close(): Promise<void>;
-    private nats;
-    private mqtt;
+    private stream;
 }