@memberjunction/server 6.2.0-edge.6 → 6.2.0-edge.8

package/dist/integration/RSUPostRestartProgress.js

@@ -0,0 +1,323 @@
+/**
+ * @fileoverview The second half of an RSU run's progress stream — the half that happens in a
+ * different process from the first.
+ *
+ * The RSU pipeline restarts the API as one of its own steps. Everything after that restart —
+ * creating the entity maps and field maps, then starting the first sync — runs in the NEW process,
+ * from the durable pending-work queue. Until now none of it was observable: the pre-restart process
+ * died mid-run, so its emitter never wrote a terminal result and the run stayed flagged in-flight
+ * forever, while the post-restart work reported nothing at all. A client watching the setup journey
+ * saw the stream stop at "restart instance" and had no way to learn whether the connector ever
+ * became live.
+ *
+ * This module re-attaches to that same run and finishes it. Re-attaching (rather than opening a new
+ * run) is the entire point: the tail API returns strictly `seq > cursor`, and a fresh emitter
+ * restarts its sequence at 1 — so a brand-new run's events would sort BELOW the cursor of every
+ * client already tailing, permanently invisible to them, while the resolver echoed their unchanged
+ * cursor back and they polled forever receiving nothing.
+ *
+ * Correlation is by MANIFEST, not by checkpoint. The manifest is written when the run opens, minutes
+ * before the restart; the checkpoint is written in the last moments before the kill signal. Keying
+ * off the durable artifact and treating the checkpoint as enrichment means a lost checkpoint costs
+ * step numbers, not the whole re-attachment.
+ */
+import { IntegrationProgressEmitter, IntegrationProgressReader, IntegrationRunResumeError, SweepInterruptedRuns, } from '@memberjunction/integration-progress-artifacts';
+import { RuntimeSchemaManager } from '@memberjunction/schema-engine';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { RESTART_STAGE } from './RSUProgressBridge.js';
+/** The two stages this module owns, in order. Named by the pipeline so the halves cannot drift. */
+const [ENTITY_MAPS_STAGE, START_SYNC_STAGE] = RuntimeSchemaManager.EXPECTED_STEPS_POST_RESTART;
+/**
+ * How many in-flight RSU runs to consider for a single connection before giving up.
+ *
+ * More than one can exist only when an earlier run's post-restart work never completed (its process
+ * died again, or its pending-work rows were consumed on a boot that then crashed). The newest is the
+ * one this pending-work item belongs to; the window is small so a pathological backlog cannot turn
+ * one item's re-attachment into a directory scan of the whole run history.
+ */
+const CANDIDATE_RUN_WINDOW = 25;
+/**
+ * One re-attached RSU run. Emits the two post-restart stages into the run the pre-restart process
+ * opened, and terminates it exactly once.
+ *
+ * Obtained from {@link RSUPostRestartProgressSession}, never constructed directly — the session is
+ * what guarantees a run is attached (and terminated) once even when several pending-work items in
+ * one sweep belong to the same batch.
+ */
+export class RSUPostRestartProgress {
+    /** @internal — use {@link RSUPostRestartProgressSession.For}. */
+    constructor(emitter, position) {
+        this.emitter = emitter;
+        this.position = position;
+        this.entityMapsOpen = false;
+        this.syncOpen = false;
+        this.failed = false;
+        this.failures = [];
+    }
+    /** The run being continued, so a caller can log or hand it to a client. */
+    get RunID() {
+        return this.emitter.RunID;
+    }
+    /**
+     * "step 12 of 14" for a post-restart step, or undefined when the checkpoint did not survive.
+     *
+     * `offset` is the step's position AFTER `RestartMJAPI` (1 for CreateEntityMaps, 2 for StartSync).
+     * Derived from the checkpoint rather than recomputed, because the pipeline skips steps
+     * conditionally (`SkipGitCommit`) and a recomputed index would disagree with the one the client
+     * has already been shown.
+     */
+    positionLabel(offset) {
+        const { stepIndex, stepTotal } = this.position;
+        if (stepIndex == null || stepTotal == null)
+            return undefined;
+        return `step ${stepIndex + offset} of ${stepTotal}`;
+    }
+    /** Opens the `CreateEntityMaps` stage for one pending-work item. */
+    BeginEntityMaps(objectCount) {
+        this.emitter.stageStart(ENTITY_MAPS_STAGE, this.positionLabel(1));
+        this.entityMapsOpen = true;
+        this.emitter.heartbeat(ENTITY_MAPS_STAGE, `Mapping ${objectCount} object(s)`, { processed: 0, totalKnown: objectCount });
+    }
+    /**
+     * Reports one object's entity map + field maps as done.
+     *
+     * A heartbeat rather than a `records.batch.complete`: heartbeat counts are explicitly excluded
+     * from the run's applied aggregate, so per-object liveness cannot double-count against the
+     * stage rollup that follows.
+     */
+    ObjectMapped(objectName, processed, totalKnown) {
+        this.emitter.heartbeat(ENTITY_MAPS_STAGE, `Mapped ${objectName} (${processed}/${totalKnown})`, { processed, totalKnown });
+    }
+    /**
+     * Closes `CreateEntityMaps` with the applied quartet, in OBJECTS.
+     *
+     * The run's aggregate is in objects, not migrations, for a resumed run: the migration quartet is
+     * emitted by `run.end`, which a restarting run by definition never reaches. Emitting both here
+     * would sum two different units into one number (2 migrations + 12 objects reported as
+     * "processed: 14"), so the migration counts stay in the terminal message instead.
+     */
+    CompleteEntityMaps(processed, succeeded, failed) {
+        if (!this.entityMapsOpen)
+            return;
+        this.entityMapsOpen = false;
+        this.emitter.stageComplete(ENTITY_MAPS_STAGE, { processed, succeeded, failed, totalKnown: processed });
+    }
+    /**
+     * Closes `CreateEntityMaps` as an ERROR, naming the objects that were never mapped.
+     *
+     * Naming them is the requirement, not a nicety: when this half fails, those objects have tables
+     * in the database and no way to sync into them, and the operator's only signal that something
+     * needs re-applying is this message.
+     */
+    FailEntityMaps(message, unmappedObjects) {
+        this.entityMapsOpen = false;
+        this.failed = true;
+        const named = unmappedObjects.length > 0
+            ? ` Objects never mapped: ${unmappedObjects.slice(0, 20).join(', ')}${unmappedObjects.length > 20 ? ` (+${unmappedObjects.length - 20} more)` : ''}.`
+            : '';
+        const full = `${message}${named}`;
+        this.failures.push(full);
+        this.emitter.stageError(ENTITY_MAPS_STAGE, full, {
+            code: 'RSU_POST_RESTART_ENTITY_MAPS_FAILED',
+            unmappedObjects,
+        });
+    }
+    /** Opens the `StartSync` stage. */
+    BeginStartSync() {
+        this.emitter.stageStart(START_SYNC_STAGE, this.positionLabel(2));
+        this.syncOpen = true;
+    }
+    /**
+     * Closes `StartSync`, carrying the sync run's ID so a client can hop from this stream to the
+     * sync's own.
+     *
+     * Deliberately carries NO `counts`: the records belong to the sync run, and counting them here
+     * would add another unit to this run's aggregate. `syncRunID` may be null when the sync was
+     * launched but its run row was not yet readable — the stage still completes, because the sync
+     * did start; the client simply has to find the run itself.
+     */
+    CompleteStartSync(syncRunID) {
+        if (!this.syncOpen)
+            return;
+        this.syncOpen = false;
+        this.emitter.emit('stage.complete', {
+            stage: START_SYNC_STAGE,
+            level: 'info',
+            message: syncRunID ? `Sync started — run ${syncRunID}` : 'Sync started',
+            data: { syncRunID },
+        });
+    }
+    /** Closes `StartSync` as skipped — the caller asked for no initial sync. */
+    SkipStartSync(reason) {
+        if (!this.syncOpen)
+            return;
+        this.syncOpen = false;
+        this.emitter.emit('stage.complete', {
+            stage: START_SYNC_STAGE,
+            level: 'info',
+            message: `Sync not started — ${reason}`,
+            data: { syncRunID: null, skipped: true, reason },
+        });
+    }
+    /** Closes `StartSync` as an error — the sync could not be launched. */
+    FailStartSync(message) {
+        this.syncOpen = false;
+        this.failed = true;
+        this.failures.push(message);
+        this.emitter.stageError(START_SYNC_STAGE, message, { code: 'RSU_POST_RESTART_SYNC_START_FAILED' });
+    }
+    /** Records a failure that happened outside either stage (connector resolution, for example). */
+    RecordFailure(stage, message) {
+        this.failed = true;
+        this.failures.push(message);
+        this.emitter.stageError(stage, message, { code: 'RSU_POST_RESTART_FAILED' });
+    }
+    /**
+     * Terminates the run. Idempotent — the emitter refuses a second terminal write, and the result
+     * file is created-not-truncated, so a duplicate call cannot rewrite an outcome a client has
+     * already read.
+     */
+    async Finish() {
+        // An unclosed stage would leave a client's stepper stuck on it forever; a run must never end
+        // with a stage still open.
+        if (this.entityMapsOpen)
+            this.FailEntityMaps('Post-restart processing ended with entity-map creation still open', []);
+        if (this.syncOpen)
+            this.FailStartSync('Post-restart processing ended with sync start still open');
+        if (this.failed) {
+            await this.emitter.fail(`RSU post-restart work failed — ${this.failures.join(' | ')}`, 'rsu-post-restart-failed');
+        }
+        else {
+            await this.emitter.complete('RSU pipeline complete — entity maps created and sync started');
+        }
+    }
+}
+/**
+ * Owns the re-attachments for ONE pass of the post-restart pending-work queue.
+ *
+ * A single RSU batch registers one pending-work row per input, so several rows in one sweep can
+ * belong to the same run. Attaching per row would try to resume — and terminate — the same run
+ * repeatedly; the second attempt would be refused as already-terminal and its work would go
+ * unreported. Memoizing by run ID makes the run's stream a single coherent continuation, with one
+ * `run.resumed` at the top and one terminal event at the bottom.
+ */
+export class RSUPostRestartProgressSession {
+    /**
+     * Every run any session in this process re-attached to. Process-wide on purpose: the startup
+     * sweep that left restart-killed runs in flight and the pass that resumes them live in
+     * different places, and the one question that joins them — "did anything pick this run up?" —
+     * must survive the resuming pass throwing halfway.
+     */
+    static { this.attachedRunIDs = new Set(); }
+    static get AttachedRunIDs() {
+        return RSUPostRestartProgressSession.attachedRunIDs;
+    }
+    constructor(emitterOptions = {}) {
+        this.emitterOptions = emitterOptions;
+        this.byRunID = new Map();
+        this.byCompanyIntegrationID = new Map();
+    }
+    /**
+     * The continuation handle for a connection's RSU run, or null when there is nothing to continue
+     * (no in-flight run for that connection, or it was already finished).
+     *
+     * Null is a normal outcome, not an error: pending work can legitimately be processed on a boot
+     * whose run artifact has been pruned, or after a retry that already closed the run. The caller
+     * does its work either way — progress reporting never gates the work itself.
+     */
+    async For(companyIntegrationID) {
+        const cached = this.byCompanyIntegrationID.get(companyIntegrationID);
+        if (cached !== undefined)
+            return cached;
+        const attached = await this.attach(companyIntegrationID);
+        this.byCompanyIntegrationID.set(companyIntegrationID, attached);
+        return attached;
+    }
+    /** Terminates every run this session re-attached to. Safe to call more than once. */
+    async FinishAll() {
+        for (const progress of this.byRunID.values()) {
+            await progress.Finish().catch(err => LogError(`[RSU] post-restart terminal write failed for run ${progress.RunID}: ${err}`));
+        }
+    }
+    async attach(companyIntegrationID) {
+        try {
+            const reader = new IntegrationProgressReader(this.emitterOptions.rootDir);
+            const candidates = await reader.ListRuns({ runKind: 'RSU', companyIntegrationID, inFlightOnly: true }, CANDIDATE_RUN_WINDOW);
+            // A run this session already picked up no longer LOOKS killed-at-the-restart — its latest
+            // event is now the `run.resumed` this session wrote. So an already-attached run must be
+            // matched first, or the second pending-work item of the same batch would find nothing to
+            // report into and its work would go unobserved.
+            const snapshot = candidates.find(s => this.byRunID.has(s.manifest.runID))
+                ?? candidates.find(RSUPostRestartProgressSession.WasKilledAtRestart);
+            if (!snapshot)
+                return null;
+            const runID = snapshot.manifest.runID;
+            const existing = this.byRunID.get(runID);
+            if (existing)
+                return existing;
+            const checkpoint = await reader.LatestCheckpoint(runID);
+            const emitter = await IntegrationProgressEmitter.Resume(runID, this.emitterOptions);
+            emitter.RunResumed(`Resumed after the RSU restart — continuing with ${RuntimeSchemaManager.EXPECTED_STEPS_POST_RESTART.join(' then ')}`, { companyIntegrationID });
+            const progress = new RSUPostRestartProgress(emitter, RSUPostRestartProgressSession.PositionFrom(checkpoint));
+            this.byRunID.set(runID, progress);
+            RSUPostRestartProgressSession.attachedRunIDs.add(runID);
+            LogStatus(`[RSU] Re-attached to run ${runID} for connection ${companyIntegrationID}`);
+            return progress;
+        }
+        catch (err) {
+            // A run that is already terminal, or has no manifest, is not an error condition worth
+            // failing the actual work over — the work still has to happen, unobserved.
+            if (err instanceof IntegrationRunResumeError) {
+                LogStatus(`[RSU] Not resuming progress for ${companyIntegrationID}: ${err.message}`);
+                return null;
+            }
+            LogError(`[RSU] Could not re-attach progress for ${companyIntegrationID}: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
+    /**
+     * Whether a run's stream stops at the restart — which is the signature of a run this process is
+     * the continuation of.
+     *
+     * Checking the LAST stage, not the presence of the checkpoint, on purpose. The checkpoint is
+     * written in the moments before the kill signal and can be lost; the `stage.start RestartMJAPI`
+     * that precedes it cannot, because the pipeline waits on nothing between emitting it and dying.
+     * Requiring the checkpoint would trade a recoverable loss of step numbers for an unrecoverable
+     * loss of the whole continuation.
+     */
+    static WasKilledAtRestart(snapshot) {
+        return snapshot.latestEvent?.stage === RESTART_STAGE;
+    }
+    /**
+     * Closes out the restart-killed runs the startup sweep left in flight that NO session then
+     * re-attached to — because there was no system user, or the pending work was stale and
+     * dropped, or it simply failed before reaching the run. Without this they would read as in
+     * flight forever, which is the state the sweep exists to end.
+     *
+     * Only the runs in `leftInFlight` (the sweep's `Skipped` list) are candidates: anything else
+     * in flight by now may be a run this process started, and is not ours to judge. A candidate
+     * a session attached to is live — its session terminates it — and is left alone.
+     */
+    static async SweepUnattached(leftInFlight, rootDir, log = () => { }) {
+        if (leftInFlight.length === 0)
+            return { Swept: [], Failed: [], Skipped: [] };
+        const candidates = new Set(leftInFlight);
+        return SweepInterruptedRuns(rootDir, log, snapshot => {
+            const runID = snapshot.manifest.runID;
+            return !candidates.has(runID) || RSUPostRestartProgressSession.attachedRunIDs.has(runID);
+        });
+    }
+    /** Reads the step position out of a restart checkpoint, tolerating a missing or partial one. */
+    static PositionFrom(checkpoint) {
+        const state = checkpoint?.stage === RESTART_STAGE ? checkpoint.resumableState : undefined;
+        if (!state)
+            return {};
+        const stepIndex = state.stepIndex;
+        const stepTotal = state.stepTotal;
+        return {
+            stepIndex: typeof stepIndex === 'number' ? stepIndex : undefined,
+            stepTotal: typeof stepTotal === 'number' ? stepTotal : undefined,
+        };
+    }
+}
+//# sourceMappingURL=RSUPostRestartProgress.js.map

package/dist/integration/RSUPostRestartProgress.js.map

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

package/dist/integration/RSUProgressBridge.d.ts

@@ -1,6 +1,12 @@
 import type { EmitterOptions } from '@memberjunction/integration-progress-artifacts';
 import type { RSUObserverEvent } from '@memberjunction/schema-engine';
 import { BaseSingleton } from '@memberjunction/global';
+/**
+ * The pipeline step that kills this process. Named here because BOTH sides of the restart use it:
+ * this bridge closes the stage and checkpoints under it, and the post-restart consumer recognises a
+ * run as resumable by finding it as the run's last stage.
+ */
+export declare const RESTART_STAGE = "RestartMJAPI";
 /**
  * Owns one emitter per RSU pipeline run and translates observer events into progress events.
  *
@@ -20,6 +26,15 @@ export declare class RSUProgressBridge extends BaseSingleton<RSUProgressBridge>
     private currentRunID;
     /** Liveness timer for the step currently in flight — see {@link HEARTBEAT_INTERVAL_MS}. */
     private heartbeat;
+    /**
+     * The stage the live heartbeat belongs to, held on the INSTANCE rather than only captured in
+     * the timer closure. A closure-only stage name is a leak waiting to happen: a timer that
+     * outlives its step (or its whole run) keeps firing with the name it was created with, and
+     * writes that stale name into whatever emitter the bridge is pointing at by then. Comparing the
+     * tick's captured name against this field makes that structurally impossible — a stopped or
+     * superseded heartbeat writes nothing.
+     */
+    private heartbeatStage;
     private emitterOptions;
     /** The one bridge for this process. */
     static get Instance(): RSUProgressBridge;
@@ -48,8 +63,32 @@ export declare class RSUProgressBridge extends BaseSingleton<RSUProgressBridge>
      * leaking an interval that keeps the process alive.
      */
     Reset(): void;
-    /** The observer to hand to {@link RuntimeSchemaManager.PipelineObserver}. */
-    readonly Observe: (event: RSUObserverEvent) => void;
+    /**
+     * The observer to hand to {@link RuntimeSchemaManager.PipelineObserver}.
+     *
+     * Returns a promise ONLY for `restart.pending` — the pipeline awaits that one (bounded) because
+     * the process is about to be killed and an unflushed write would be lost. Every other event
+     * stays fire-and-forget.
+     */
+    readonly Observe: (event: RSUObserverEvent) => void | Promise<void>;
+    /**
+     * Closes the `RestartMJAPI` stage and writes the checkpoint the next process re-attaches from,
+     * then FLUSHES — the caller awaits this, and pm2 kills the process moments later.
+     *
+     * Two separate things are written here, and they matter for different reasons:
+     *
+     *  - the `stage.complete` for `RestartMJAPI`, because `step.end` for that step is unreachable
+     *    (the process dies inside the step), so without it the stream ends on an open stage and a
+     *    determinate stepper stalls one short of the restart;
+     *  - the `checkpoint`, carrying the step position and the pending-work correlation, so the
+     *    consumer on the other side can resume the stepper where this process left it.
+     *
+     * The checkpoint is deliberately NOT the consumer's only way back to this run. Re-attachment
+     * keys off the MANIFEST — written minutes earlier, when the run opened — precisely because this
+     * write is the one racing a kill signal. If it is lost the run is still found and still
+     * resumed; only the step indices degrade to defaults.
+     */
+    private onRestartPending;
     private onRunStart;
     private onStepStart;
     private onStepEnd;

package/dist/integration/RSUProgressBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RSUProgressBridge.d.ts","sourceRoot":"","sources":["../../src/integration/RSUProgressBridge.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAErF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAevD;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IACnE,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,YAAY,CAAuB;IAC3C,2FAA2F;IAC3F,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,cAAc,CAAsB;IAE5C,uCAAuC;IACvC,WAAkB,QAAQ,IAAI,iBAAiB,CAE9C;IAED;;;;;;;;;OASG;IACI,SAAS,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAItD;;;;OAIG;IACH,IAAW,YAAY,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED;;;;;;OAMG;IACI,KAAK,IAAI,IAAI;IAMpB,6EAA6E;IAC7E,SAAgB,OAAO,GAAI,OAAO,gBAAgB,KAAG,IAAI,CAWvD;IAEF,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,QAAQ;IA4BhB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB,mEAAmE;IACnE,OAAO,CAAC,aAAa;IAMrB,kFAAkF;IAClF,OAAO,CAAC,YAAY;IASpB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAIxB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,GAAE,cAAmB,GAAG,iBAAiB,CAKhG"}
+{"version":3,"file":"RSUProgressBridge.d.ts","sourceRoot":"","sources":["../../src/integration/RSUProgressBridge.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAErF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKvD;;;;GAIG;AACH,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAY5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IACnE,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,YAAY,CAAuB;IAC3C,2FAA2F;IAC3F,OAAO,CAAC,SAAS,CAA+C;IAChE;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAsB;IAE5C,uCAAuC;IACvC,WAAkB,QAAQ,IAAI,iBAAiB,CAE9C;IAED;;;;;;;;;OASG;IACI,SAAS,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAItD;;;;OAIG;IACH,IAAW,YAAY,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED;;;;;;OAMG;IACI,KAAK,IAAI,IAAI;IAMpB;;;;;;OAMG;IACH,SAAgB,OAAO,GAAI,OAAO,gBAAgB,KAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAavE;IAEF;;;;;;;;;;;;;;;;OAgBG;YACW,gBAAgB;IAmB9B,OAAO,CAAC,UAAU;IA0ClB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,QAAQ;IA4BhB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgBtB,mEAAmE;IACnE,OAAO,CAAC,aAAa;IAUrB,kFAAkF;IAClF,OAAO,CAAC,YAAY;IASpB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAIxB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,GAAE,cAAmB,GAAG,iBAAiB,CAKhG"}

package/dist/integration/RSUProgressBridge.js

@@ -20,6 +20,12 @@ import { LogError } from '@memberjunction/core';
 import { BaseSingleton } from '@memberjunction/global';
 /** The emitter stage name used for run-level (non-step) events. */
 const RUN_STAGE = 'RSUPipeline';
+/**
+ * The pipeline step that kills this process. Named here because BOTH sides of the restart use it:
+ * this bridge closes the stage and checkpoints under it, and the post-restart consumer recognises a
+ * run as resumable by finding it as the run's last stage.
+ */
+export const RESTART_STAGE = 'RestartMJAPI';
 /**
  * How often an in-flight step reports that it is still alive.
  *
@@ -50,8 +56,23 @@ export class RSUProgressBridge extends BaseSingleton {
         this.currentRunID = null;
         /** Liveness timer for the step currently in flight — see {@link HEARTBEAT_INTERVAL_MS}. */
         this.heartbeat = null;
+        /**
+         * The stage the live heartbeat belongs to, held on the INSTANCE rather than only captured in
+         * the timer closure. A closure-only stage name is a leak waiting to happen: a timer that
+         * outlives its step (or its whole run) keeps firing with the name it was created with, and
+         * writes that stale name into whatever emitter the bridge is pointing at by then. Comparing the
+         * tick's captured name against this field makes that structurally impossible — a stopped or
+         * superseded heartbeat writes nothing.
+         */
+        this.heartbeatStage = null;
         this.emitterOptions = {};
-        /** The observer to hand to {@link RuntimeSchemaManager.PipelineObserver}. */
+        /**
+         * The observer to hand to {@link RuntimeSchemaManager.PipelineObserver}.
+         *
+         * Returns a promise ONLY for `restart.pending` — the pipeline awaits that one (bounded) because
+         * the process is about to be killed and an unflushed write would be lost. Every other event
+         * stays fire-and-forget.
+         */
         this.Observe = (event) => {
             switch (event.Kind) {
                 case 'run.start':
@@ -60,6 +81,8 @@ export class RSUProgressBridge extends BaseSingleton {
                     return this.onStepStart(event);
                 case 'step.end':
                     return this.onStepEnd(event);
+                case 'restart.pending':
+                    return this.onRestartPending(event);
                 case 'run.end':
                     return this.onRunEnd(event);
             }
@@ -102,18 +125,68 @@ export class RSUProgressBridge extends BaseSingleton {
         this.emitter = null;
         this.currentRunID = null;
     }
+    /**
+     * Closes the `RestartMJAPI` stage and writes the checkpoint the next process re-attaches from,
+     * then FLUSHES — the caller awaits this, and pm2 kills the process moments later.
+     *
+     * Two separate things are written here, and they matter for different reasons:
+     *
+     *  - the `stage.complete` for `RestartMJAPI`, because `step.end` for that step is unreachable
+     *    (the process dies inside the step), so without it the stream ends on an open stage and a
+     *    determinate stepper stalls one short of the restart;
+     *  - the `checkpoint`, carrying the step position and the pending-work correlation, so the
+     *    consumer on the other side can resume the stepper where this process left it.
+     *
+     * The checkpoint is deliberately NOT the consumer's only way back to this run. Re-attachment
+     * keys off the MANIFEST — written minutes earlier, when the run opened — precisely because this
+     * write is the one racing a kill signal. If it is lost the run is still found and still
+     * resumed; only the step indices degrade to defaults.
+     */
+    async onRestartPending(event) {
+        this.stopHeartbeat();
+        const emitter = this.emitter;
+        if (!emitter)
+            return;
+        emitter.stageComplete(RESTART_STAGE);
+        emitter.checkpoint(RESTART_STAGE, {
+            runID: emitter.RunID,
+            remainingSteps: event.RemainingSteps,
+            stepIndex: event.StepIndex,
+            stepTotal: event.StepTotal,
+            companyIntegrationIDs: event.CompanyIntegrationIDs,
+            pendingWorkIDs: event.PendingWorkIDs,
+            migrationTotalCount: event.TotalCount,
+            migrationSuccessCount: event.SuccessCount,
+        });
+        // A failed flush must not stop the restart — the pipeline swallows this, but say so.
+        await emitter.flush().catch(err => LogError(`RSUProgressBridge: pre-restart flush failed — ${err}`));
+    }
     onRunStart(event) {
+        // Unconditional, and BEFORE the emitter check below. Stopping the previous run's liveness
+        // timer must not be reachable only via `closeCurrent`, whose call is gated on there being
+        // an emitter — that gate is the one path on which a live heartbeat could survive into the
+        // next run and stamp the previous run's stage name onto it.
+        this.stopHeartbeat();
         // A retry re-enters RunPipelineBatch, so it legitimately starts a NEW run. If a previous
         // emitter is still open (a throw escaped before run.end), close it rather than leak it.
         if (this.emitter)
             this.closeCurrent('Superseded by a new RSU run');
         const runID = IntegrationProgressEmitter.newRunID('rsu');
         this.currentRunID = runID;
+        const companyIntegrationIDs = event.CompanyIntegrationIDs ?? [];
         this.emitter = new IntegrationProgressEmitter({
             runID,
             runKind: 'RSU',
             triggerType: 'Pipeline',
             startedAt: new Date().toISOString(),
+            // The run's IDENTITY, and the reason an RSU run is readable over the API at all: the
+            // run-artifact authorization check tests the caller against the connections on the
+            // manifest, and an RSU manifest never carried any. The plural field is the whole set
+            // (a batch may span connections); the singular one is populated ONLY for a
+            // single-connection run, so everything that reports "the" connection of a run keeps
+            // reporting one unambiguous answer rather than an arbitrary member of a set.
+            companyIntegrationIDs,
+            companyIntegrationID: companyIntegrationIDs.length === 1 ? companyIntegrationIDs[0] : undefined,
             context: {
                 itemCount: event.ItemCount,
                 descriptions: event.Descriptions,
@@ -178,7 +251,13 @@ export class RSUProgressBridge extends BaseSingleton {
     startHeartbeat(stage) {
         this.stopHeartbeat();
         const startedAt = Date.now();
+        this.heartbeatStage = stage;
         this.heartbeat = setInterval(() => {
+            // Guard on the INSTANCE's current stage, not just the captured one. A tick that fires
+            // after the heartbeat was stopped, or after a different step/run took over, must not
+            // write this step's name into someone else's stream.
+            if (this.heartbeatStage !== stage)
+                return;
             const elapsedSec = Math.round((Date.now() - startedAt) / 1000);
             this.emitter?.heartbeat(stage, `${stage} still running — ${elapsedSec}s elapsed`);
         }, HEARTBEAT_INTERVAL_MS);
@@ -187,6 +266,10 @@ export class RSUProgressBridge extends BaseSingleton {
     }
     /** Stops the liveness timer. Safe to call when none is running. */
     stopHeartbeat() {
+        // Deliberately unconditional on the stage: clearing the name is what disarms a tick that is
+        // already queued on the event loop, so it must happen even when there is no timer handle
+        // left to clear.
+        this.heartbeatStage = null;
         if (!this.heartbeat)
             return;
         clearInterval(this.heartbeat);

package/dist/integration/RSUProgressBridge.js.map

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

package/dist/integration/RunArtifactAuthorization.d.ts

@@ -0,0 +1,39 @@
+import type { IntegrationRunManifest } from '@memberjunction/integration-progress-artifacts';
+/**
+ * Answers "may the calling user read this one connection?".
+ *
+ * Supplied by the resolver, which implements it as a `RunView` on `MJ: Company Integrations` under
+ * the CALLER's context — so the data provider applies the same row-level security it applies to
+ * every other user-context read, and no row coming back means unauthorized.
+ */
+export type CompanyIntegrationReadCheck = (companyIntegrationID: string) => Promise<boolean>;
+/** The verdict, carrying the connection that blocked it so a denial can name it. */
+export interface RunArtifactAuthorizationResult {
+    Authorized: boolean;
+    /** The first connection the caller could not read. Absent when the run has no identity at all. */
+    DeniedCompanyIntegrationID?: string;
+}
+/**
+ * Authorizes a caller for a run artifact against EVERY connection the run touched.
+ *
+ * ── The rule ───────────────────────────────────────────────────────────────────────────────────
+ * A run is readable only if the caller is authorized for ALL of its connections. Not any — all.
+ *
+ * Most runs touch exactly one connection and the rule collapses to the obvious check. But a schema
+ * update (RSU) run is a BATCH: the pipeline takes N inputs, and those inputs may legitimately
+ * belong to different connectors. A run artifact is one undivided event stream — its migration
+ * descriptions, affected table names and error messages interleave every connection in the batch,
+ * and there is no mechanism to serve a caller a partial view of it. "Authorized for any one of
+ * them" would therefore hand connection A's schema-change descriptions to a user who only holds
+ * rights on connection B. AND is the only rule that cannot leak; a cross-tenant batch simply
+ * becomes readable to nobody but a caller holding rights to both, which is the correct conservative
+ * answer rather than a silent disclosure.
+ *
+ * A run with NO connection identity is denied: non-tenant-scoped artifacts are not exposed through
+ * the per-company endpoints, and that must not change as a side effect of runs gaining a set.
+ *
+ * Short-circuits on the first denial, so an unauthorized caller cannot use the number of permission
+ * lookups to probe which connections a run covers.
+ */
+export declare function AuthorizeRunArtifact(manifest: IntegrationRunManifest, canReadCompanyIntegration: CompanyIntegrationReadCheck): Promise<RunArtifactAuthorizationResult>;
+//# sourceMappingURL=RunArtifactAuthorization.d.ts.map

package/dist/integration/RunArtifactAuthorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunArtifactAuthorization.d.ts","sourceRoot":"","sources":["../../src/integration/RunArtifactAuthorization.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAE7F;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,oBAAoB,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7F,oFAAoF;AACpF,MAAM,WAAW,8BAA8B;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,kGAAkG;IAClG,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,sBAAsB,EAChC,yBAAyB,EAAE,2BAA2B,GACvD,OAAO,CAAC,8BAA8B,CAAC,CAczC"}