@memberjunction/server 5.41.0 → 5.43.0

package/dist/logging/StartupLogger.js

@@ -1,5 +1,6 @@
 import { configInfo } from '../config.js';
 import { LogStatus } from '@memberjunction/core';
+import ora from 'ora';
 /** Numeric rank for each level, used for `>=` threshold comparisons. */
 const LEVEL_RANK = {
     minimal: 0,
@@ -37,6 +38,12 @@ export class StartupLogger {
     constructor(level) {
         this.phaseTimings = [];
         this.summary = { AuthProviders: [] };
+        /** Transient boot spinner — active only at `standard` level on a TTY (see {@link spinnerEnabled}). */
+        this.spinner = null;
+        /** Interval that ticks the live elapsed counter on the spinner line. */
+        this.bootTimer = null;
+        /** Wall-clock start of the boot indicator, for the live elapsed counter. */
+        this.bootStartMs = 0;
         this.resolvedLevel = level ?? StartupLogger.resolveLevelFromConfig();
     }
     /**
@@ -83,6 +90,79 @@ export class StartupLogger {
     StartPhase() {
         return performance.now();
     }
+    /**
+     * True when the transient boot spinner should animate: only at `standard`
+     * level AND when stdout is an interactive TTY. In non-TTY contexts (Docker,
+     * systemd, piped logs) a spinner emits escape codes that pollute log
+     * aggregation, and at `verbose`+ the inline phase lines would fight it — so
+     * both fall back to plain, line-oriented output.
+     */
+    get spinnerEnabled() {
+        return this.resolvedLevel === 'standard' && process.stdout.isTTY === true;
+    }
+    /** Prefix for the transient boot indicator (no rocket — we haven't launched yet). */
+    static { this.BOOT_LABEL = 'Bootstrapping MemberJunction Server'; }
+    /** Composes the boot label, plus the current phase when known (no elapsed counter). */
+    bootText(phase) {
+        return phase ? `${StartupLogger.BOOT_LABEL} · ${phase}` : StartupLogger.BOOT_LABEL;
+    }
+    /** Repaints the spinner line with the current phase and a live elapsed counter. */
+    refreshBootText() {
+        if (this.spinner) {
+            const elapsed = ((performance.now() - this.bootStartMs) / 1000).toFixed(1);
+            this.spinner.text = `${this.bootText(this.currentPhase)}  ${elapsed}s`;
+        }
+    }
+    /**
+     * Begins the transient "Bootstrapping…" indicator, replaced by the 🚀 summary
+     * block once {@link PrintSummary} runs (so the rocket appears only after launch).
+     *
+     * - `standard` + TTY: an animated, self-clearing `ora` spinner (its glyph is the
+     *   leading "working" icon; phase status is appended inline).
+     * - `verbose`/`debug`, or non-TTY at `standard`: a single plain line with an
+     *   hourglass icon (can't be cleared, but inline phase logs / the final block
+     *   carry the detail). `minimal` stays silent.
+     */
+    StartBoot() {
+        if (this.spinner) {
+            return;
+        }
+        if (this.spinnerEnabled) {
+            this.bootStartMs = performance.now();
+            this.spinner = ora({ text: this.bootText(), stream: process.stdout }).start();
+            // Tick the elapsed counter independently of ora's glyph animation. Unref'd so
+            // it never keeps the event loop alive; cleared by StopBoot before the block prints.
+            this.bootTimer = setInterval(() => this.refreshBootText(), 200);
+            this.bootTimer.unref();
+        }
+        else if (this.resolvedLevel !== 'minimal') {
+            // eslint-disable-next-line no-console
+            console.log(`⏳ ${this.bootText()}…`);
+        }
+    }
+    /**
+     * Marks the beginning of a named phase: updates the spinner status (when active)
+     * and returns a start timestamp to pass to {@link EndPhase}. Pure timing helper
+     * when the spinner is disabled — equivalent to {@link StartPhase}.
+     *
+     * @param phase Friendly label for the upcoming phase, shown after the boot label.
+     */
+    BeginPhase(phase) {
+        this.currentPhase = phase;
+        this.refreshBootText();
+        return performance.now();
+    }
+    /** Stops and clears the boot spinner + its elapsed-counter interval. Safe to call when inactive. */
+    StopBoot() {
+        if (this.bootTimer) {
+            clearInterval(this.bootTimer);
+            this.bootTimer = null;
+        }
+        if (this.spinner) {
+            this.spinner.stop();
+            this.spinner = null;
+        }
+    }
     /**
      * Records the elapsed time for a phase since `startedAt`, buffering it for the
      * summary. At `verbose`+ the phase is also printed immediately (matching the
@@ -104,6 +184,10 @@ export class StartupLogger {
     SetVersion(version) {
         this.summary.Version = version;
     }
+    /** Records the resolved config-file path for the summary `Config` line. */
+    SetConfigPath(path) {
+        this.summary.ConfigPath = path;
+    }
     /** Records DB platform + connection + entity count for the summary `DB` line. */
     SetDatabaseInfo(platform, connection, entityCount) {
         this.summary.DbPlatform = platform;
@@ -134,6 +218,9 @@ export class StartupLogger {
      *    all detail lines were already printed inline during boot).
      */
     PrintSummary() {
+        // Clear the transient spinner before any block output so the line it
+        // occupied is replaced cleanly by the summary.
+        this.StopBoot();
         if (this.resolvedLevel === 'minimal') {
             this.printReadyLineOnly();
             return;
@@ -158,6 +245,7 @@ export class StartupLogger {
         const lines = [];
         lines.push(this.buildHeaderLine());
         lines.push(this.buildDbLine());
+        lines.push(this.buildConfigLine());
         lines.push(this.buildAuthLine());
         lines.push(this.buildStartupLine());
         lines.push(this.buildReadyLine());
@@ -182,6 +270,13 @@ export class StartupLogger {
         }
         return `   DB        ${parts.join(' · ')}`;
     }
+    /** `   Config    <path>` (omitted when no config file was resolved). */
+    buildConfigLine() {
+        if (!this.summary.ConfigPath) {
+            return '';
+        }
+        return `   Config    ${this.summary.ConfigPath}`;
+    }
     /** `   Auth      <providers>          REST <on/off> · <N> scheduled jobs`. */
     buildAuthLine() {
         const providers = this.summary.AuthProviders.length > 0
@@ -197,16 +292,30 @@ export class StartupLogger {
         const trailerPart = trailer ? `   ${trailer}` : '';
         return `   Auth      ${providers}${trailerPart}`;
     }
-    /** `   Startup   <total>s  (<phase> <x>s · <phase> <y>s …)`. */
+    /**
+     * `   Startup   <total>s  (<phase> <x>s · … · other <z>s)`.
+     *
+     * The headline `<total>` is the TRUE wall-clock since process start — in Node,
+     * `performance.now()` is measured from `performance.timeOrigin` (≈ process
+     * start), so it captures the entire bootstrap (module import, config load,
+     * ServerBootstrap, and `serve()`), not just the timed phases. The parenthetical
+     * lists each captured phase; `other` is the unattributed remainder (import +
+     * config + any untimed setup) shown only when it's non-trivial.
+     */
     buildStartupLine() {
         if (this.phaseTimings.length === 0) {
             return '';
         }
-        const totalMs = this.phaseTimings.reduce((sum, p) => sum + p.Ms, 0);
-        const phaseParts = this.phaseTimings
-            .map((p) => `${this.shortPhaseLabel(p.Label)} ${(p.Ms / 1000).toFixed(1)}s`)
-            .join(' · ');
-        return `   Startup   ${(totalMs / 1000).toFixed(1)}s  (${phaseParts})`;
+        const totalMs = performance.now();
+        const phaseSumMs = this.phaseTimings.reduce((sum, p) => sum + p.Ms, 0);
+        const otherMs = totalMs - phaseSumMs;
+        const parts = this.phaseTimings.map((p) => `${this.shortPhaseLabel(p.Label)} ${(p.Ms / 1000).toFixed(1)}s`);
+        // Surface unattributed boot time only when it's meaningful (>50ms), so the
+        // line stays clean when phases already account for ~all of startup.
+        if (otherMs > 50) {
+            parts.push(`other ${(otherMs / 1000).toFixed(1)}s`);
+        }
+        return `   Startup   ${(totalMs / 1000).toFixed(1)}s  (${parts.join(' · ')})`;
     }
     /**
      * Abbreviates a verbose phase label into a compact token for the collapsed

package/dist/logging/StartupLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"StartupLogger.js","sourceRoot":"","sources":["../../src/logging/StartupLogger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"StartupLogger.js","sourceRoot":"","sources":["../../src/logging/StartupLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,GAAG,MAAM,KAAK,CAAC;AActB,wEAAwE;AACxE,MAAM,UAAU,GAAmC;IACjD,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACT,CAAC;AAwCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,aAAa;IAaxB;;;OAGG;IACH,YAAY,KAAsB;QAfjB,iBAAY,GAAkB,EAAE,CAAC;QACjC,YAAO,GAAuB,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QACrE,sGAAsG;QAC9F,YAAO,GAAe,IAAI,CAAC;QACnC,wEAAwE;QAChE,cAAS,GAA0C,IAAI,CAAC;QAChE,4EAA4E;QACpE,gBAAW,GAAG,CAAC,CAAC;QAStB,IAAI,CAAC,aAAa,GAAG,KAAK,IAAI,aAAa,CAAC,sBAAsB,EAAE,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,sBAAsB;QAClC,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpF,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACI,SAAS,CAAC,QAAwB;QACvC,OAAO,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,QAAwB,EAAE,OAAe;QACpD,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,UAAU;QACf,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;IAC5E,CAAC;IAED,qFAAqF;aAC7D,eAAU,GAAG,qCAAqC,AAAxC,CAAyC;IAE3E,uFAAuF;IAC/E,QAAQ,CAAC,KAAc;QAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC;IACrF,CAAC;IAED,mFAAmF;IAC3E,eAAe;QACrB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC3E,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,OAAO,GAAG,CAAC;QACzE,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACI,SAAS;QACd,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC9E,8EAA8E;YAC9E,oFAAoF;YACpF,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,CAAC,CAAC;YAChE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC5C,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,UAAU,CAAC,KAAa;QAC7B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,oGAAoG;IAC7F,QAAQ;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACI,QAAQ,CAAC,KAAa,EAAE,SAAiB;QAC9C,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,iEAAiE;IAC1D,UAAU,CAAC,OAA2B;QAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IACjC,CAAC;IAED,2EAA2E;IACpE,aAAa,CAAC,IAAwB;QAC3C,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IACjC,CAAC;IAED,iFAAiF;IAC1E,eAAe,CAAC,QAAgB,EAAE,UAAkB,EAAE,WAAmB;QAC9E,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,UAAU,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;IACzC,CAAC;IAED,uEAAuE;IAChE,eAAe,CAAC,IAAY;QACjC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,2EAA2E;IACpE,cAAc,CAAC,OAAgB;QACpC,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC;IACrC,CAAC;IAED,0EAA0E;IACnE,oBAAoB,CAAC,KAAa;QACvC,IAAI,CAAC,OAAO,CAAC,iBAAiB,GAAG,KAAK,CAAC;IACzC,CAAC;IAED,0DAA0D;IACnD,WAAW,CAAC,GAAW;QAC5B,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,YAAY;QACjB,qEAAqE;QACrE,+CAA+C;QAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,iDAAiD;IACzC,kBAAkB;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,+DAA+D;IACvD,iBAAiB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvC,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,yEAAyE;IACjE,iBAAiB;QACvB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,8EAA8E;IACtE,eAAe;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,2BAA2B,OAAO,EAAE,CAAC;IAC9C,CAAC;IAED,+DAA+D;IACvD,WAAW;QACjB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,WAAW,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,gBAAgB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,wEAAwE;IAChE,eAAe;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,gBAAgB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnD,CAAC;IAED,8EAA8E;IACtE,aAAa;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YACrD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YACvC,CAAC,CAAC,MAAM,CAAC;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI;YACjD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,iBAAiB,CAAC;QACvD,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,gBAAgB,SAAS,GAAG,WAAW,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACK,gBAAgB;QACtB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACvE,CAAC;QACF,2EAA2E;QAC3E,oEAAoE;QACpE,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IAChF,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,KAAa;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,4BAA4B;IACpB,cAAc;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,gBAAgB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC"}

package/dist/resolvers/ExecuteRemoteOperationResolver.d.ts

@@ -0,0 +1,46 @@
+import { PubSubEngine } from 'type-graphql';
+import { ResolverBase } from '../generic/ResolverBase.js';
+import { AppContext } from '../types.js';
+/** Input for the generic Remote Operation transport mutation. */
+export declare class ExecuteRemoteOperationInput {
+    operationKey: string;
+    inputJSON: string;
+    invokeMode: string;
+    /**
+     * Optional client-generated channel id. When set (attached mode over the wire), the server publishes every
+     * `RemoteOpProgress` the operation emits to the `RemoteOperationProgress` subscription filtered by this id,
+     * so the caller's `onProgress` fires live while the operation runs. Omitted for sync / no-progress calls.
+     */
+    progressChannelId?: string;
+}
+/** A single streamed progress envelope delivered over the `RemoteOperationProgress` subscription. */
+export declare class RemoteOperationProgressNotification {
+    ChannelId: string;
+    /** JSON-serialized {@link RemoteOpProgress}. */
+    ProgressJSON: string;
+}
+/** Result of the generic Remote Operation transport mutation. */
+export declare class ExecuteRemoteOperationResultType {
+    success: boolean;
+    resultCode?: string;
+    outputJSON?: string;
+    handle?: string;
+    errorMessage?: string;
+}
+/**
+ * The single generic server entry point for Remote Operations. Resolves the operation by key,
+ * applies the framework authorization gates (API-key scope, system-user, then the operation's own
+ * `Authorize`), and routes the operation through the per-request provider — which executes it
+ * in-process. Only registered, active operations are reachable, so the public `RouteOperation`
+ * power-tool is safe by construction.
+ */
+export declare class ExecuteRemoteOperationResolver extends ResolverBase {
+    ExecuteRemoteOperation(input: ExecuteRemoteOperationInput, ctx: AppContext, pubSub: PubSubEngine): Promise<ExecuteRemoteOperationResultType>;
+    /**
+     * Subscription the client opens (with a self-generated `channelId`) immediately before calling
+     * `ExecuteRemoteOperation` with the same id in `progressChannelId`. The server publishes one event per
+     * `RemoteOpProgress` the operation emits; filtered by `channelId` so concurrent calls never interleave.
+     */
+    RemoteOperationProgress(notification: RemoteOperationProgressNotification, _channelId: string): RemoteOperationProgressNotification;
+}
+//# sourceMappingURL=ExecuteRemoteOperationResolver.d.ts.map

package/dist/resolvers/ExecuteRemoteOperationResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteRemoteOperationResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/ExecuteRemoteOperationResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,YAAY,EAAgC,MAAM,cAAc,CAAC;AAIxI,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,iEAAiE;AACjE,qBACa,2BAA2B;IAEpC,YAAY,EAAE,MAAM,CAAC;IAGrB,SAAS,EAAE,MAAM,CAAC;IAGlB,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IAEH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qGAAqG;AACrG,qBACa,mCAAmC;IAE5C,SAAS,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAEhD,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,iEAAiE;AACjE,qBACa,gCAAgC;IAEzC,OAAO,EAAE,OAAO,CAAC;IAGjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,qBACa,8BAA+B,SAAQ,YAAY;IAEtD,sBAAsB,CACV,KAAK,EAAE,2BAA2B,EACzC,GAAG,EAAE,UAAU,EACZ,MAAM,EAAE,YAAY,GAC/B,OAAO,CAAC,gCAAgC,CAAC;IAmE5C;;;;OAIG;IAKH,uBAAuB,CACX,YAAY,EAAE,mCAAmC,EAC7B,UAAU,EAAE,MAAM,GAC/C,mCAAmC;CAGzC"}

package/dist/resolvers/ExecuteRemoteOperationResolver.js

@@ -0,0 +1,192 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Arg, Ctx, Field, ID, InputType, Mutation, ObjectType, PubSub, PubSubEngine, Resolver, Root, Subscription } from 'type-graphql';
+import { MJGlobal } from '@memberjunction/global';
+import { BaseRemotableOperation } from '@memberjunction/core';
+import { RemoteOperationEngineBase } from '@memberjunction/core-entities';
+import { ResolverBase } from '../generic/ResolverBase.js';
+import { GetReadWriteProvider } from '../util.js';
+/** PubSub topic carrying RemoteOpProgress envelopes for attached over-the-wire callers (RO-3). */
+const REMOTE_OP_PROGRESS_TOPIC = 'RemoteOperationProgress';
+/** Input for the generic Remote Operation transport mutation. */
+let ExecuteRemoteOperationInput = class ExecuteRemoteOperationInput {
+};
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationInput.prototype, "operationKey", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationInput.prototype, "inputJSON", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationInput.prototype, "invokeMode", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationInput.prototype, "progressChannelId", void 0);
+ExecuteRemoteOperationInput = __decorate([
+    InputType()
+], ExecuteRemoteOperationInput);
+export { ExecuteRemoteOperationInput };
+/** A single streamed progress envelope delivered over the `RemoteOperationProgress` subscription. */
+let RemoteOperationProgressNotification = class RemoteOperationProgressNotification {
+};
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], RemoteOperationProgressNotification.prototype, "ChannelId", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], RemoteOperationProgressNotification.prototype, "ProgressJSON", void 0);
+RemoteOperationProgressNotification = __decorate([
+    ObjectType()
+], RemoteOperationProgressNotification);
+export { RemoteOperationProgressNotification };
+/** Result of the generic Remote Operation transport mutation. */
+let ExecuteRemoteOperationResultType = class ExecuteRemoteOperationResultType {
+};
+__decorate([
+    Field(() => Boolean),
+    __metadata("design:type", Boolean)
+], ExecuteRemoteOperationResultType.prototype, "success", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationResultType.prototype, "resultCode", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationResultType.prototype, "outputJSON", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationResultType.prototype, "handle", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], ExecuteRemoteOperationResultType.prototype, "errorMessage", void 0);
+ExecuteRemoteOperationResultType = __decorate([
+    ObjectType()
+], ExecuteRemoteOperationResultType);
+export { ExecuteRemoteOperationResultType };
+/**
+ * The single generic server entry point for Remote Operations. Resolves the operation by key,
+ * applies the framework authorization gates (API-key scope, system-user, then the operation's own
+ * `Authorize`), and routes the operation through the per-request provider — which executes it
+ * in-process. Only registered, active operations are reachable, so the public `RouteOperation`
+ * power-tool is safe by construction.
+ */
+let ExecuteRemoteOperationResolver = class ExecuteRemoteOperationResolver extends ResolverBase {
+    async ExecuteRemoteOperation(input, ctx, pubSub) {
+        try {
+            const key = input.operationKey?.trim();
+            if (!key) {
+                return fail('INVALID_OPERATION_KEY', 'operationKey is required');
+            }
+            // Resolve the operation's declaration so we can apply its scope / system-user gates.
+            const registration = MJGlobal.Instance.ClassFactory.GetRegistration(BaseRemotableOperation, key);
+            if (!registration) {
+                return fail('UNKNOWN_OPERATION', `Remote operation '${key}' is not registered`);
+            }
+            const opDecl = MJGlobal.Instance.ClassFactory.CreateInstance(BaseRemotableOperation, key);
+            // (1) API-key scope gate — a no-op for interactive OAuth/JWT users.
+            if (opDecl?.RequiredScope) {
+                await this.CheckAPIKeyScopeAuthorization(opDecl.RequiredScope, key, ctx.userPayload);
+            }
+            // (2) System-user gate.
+            if (opDecl?.RequiresSystemUser && !ctx.userPayload.isSystemUser) {
+                return fail('FORBIDDEN', `Operation '${key}' may only be invoked by the system user`);
+            }
+            // (3) Resolve the acting user (works for OAuth/JWT and API-key sessions alike).
+            const user = this.GetUserFromPayload(ctx.userPayload);
+            if (!user) {
+                return fail('NO_USER', 'Not authenticated');
+            }
+            // (4) Metadata gate (defense-in-depth): honor the op's MJ: Remote Operations Status/approval, so a
+            // registered-but-disabled (or unapproved AI) op is rejected even though its class is still in code.
+            const provider = GetReadWriteProvider(ctx.providers);
+            await RemoteOperationEngineBase.Instance.Config(false, user, provider);
+            const invokability = RemoteOperationEngineBase.Instance.IsInvokable(key);
+            if (!invokability.Invokable) {
+                return fail(invokability.ResultCode ?? 'OPERATION_UNAVAILABLE', invokability.Reason ?? `Operation '${key}' is unavailable`);
+            }
+            let parsedInput;
+            try {
+                parsedInput = input.inputJSON ? JSON.parse(input.inputJSON) : {};
+            }
+            catch (e) {
+                return fail('INVALID_INPUT_JSON', `Invalid input JSON: ${e instanceof Error ? e.message : String(e)}`);
+            }
+            // Attached over-the-wire (RO-3): forward each emitted RemoteOpProgress to the progress channel so a
+            // remote caller's onProgress fires live. No-op when the caller didn't open a channel (sync calls).
+            const onProgress = input.progressChannelId
+                ? (p) => {
+                    void pubSub.publish(REMOTE_OP_PROGRESS_TOPIC, { ChannelId: input.progressChannelId, ProgressJSON: JSON.stringify(p) });
+                }
+                : undefined;
+            // Route through the per-request provider (server in-process path; runs the op's Authorize + InternalExecute).
+            const result = await provider.RouteOperation(key, parsedInput, { user, mode: input.invokeMode, onProgress });
+            return {
+                success: result.Success,
+                resultCode: result.ResultCode,
+                outputJSON: result.Output !== undefined ? JSON.stringify(result.Output) : undefined,
+                handle: result.Handle,
+                errorMessage: result.ErrorMessage,
+            };
+        }
+        catch (e) {
+            return fail('ERROR', e instanceof Error ? e.message : String(e));
+        }
+    }
+    /**
+     * Subscription the client opens (with a self-generated `channelId`) immediately before calling
+     * `ExecuteRemoteOperation` with the same id in `progressChannelId`. The server publishes one event per
+     * `RemoteOpProgress` the operation emits; filtered by `channelId` so concurrent calls never interleave.
+     */
+    RemoteOperationProgress(notification, _channelId) {
+        return notification;
+    }
+};
+__decorate([
+    Mutation(() => ExecuteRemoteOperationResultType),
+    __param(0, Arg('input')),
+    __param(1, Ctx()),
+    __param(2, PubSub()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [ExecuteRemoteOperationInput, Object, PubSubEngine]),
+    __metadata("design:returntype", Promise)
+], ExecuteRemoteOperationResolver.prototype, "ExecuteRemoteOperation", null);
+__decorate([
+    Subscription(() => RemoteOperationProgressNotification, {
+        topics: REMOTE_OP_PROGRESS_TOPIC,
+        filter: ({ payload, args }) => payload.ChannelId === args.channelId,
+    }),
+    __param(0, Root()),
+    __param(1, Arg('channelId', () => ID)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [RemoteOperationProgressNotification, String]),
+    __metadata("design:returntype", RemoteOperationProgressNotification)
+], ExecuteRemoteOperationResolver.prototype, "RemoteOperationProgress", null);
+ExecuteRemoteOperationResolver = __decorate([
+    Resolver()
+], ExecuteRemoteOperationResolver);
+export { ExecuteRemoteOperationResolver };
+/** Builds a failed result. */
+function fail(resultCode, errorMessage) {
+    return { success: false, resultCode, errorMessage };
+}
+//# sourceMappingURL=ExecuteRemoteOperationResolver.js.map

package/dist/resolvers/ExecuteRemoteOperationResolver.js.map

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

package/dist/resolvers/IntegrationDiscoveryResolver.d.ts

@@ -300,6 +300,60 @@ declare class MutationResultOutput {
     Success: boolean;
     Message: string;
 }
+declare class IntegrationSyncConfigInput {
+    SyncConcurrency?: number;
+    MaxConcurrency?: number;
+    RateLimitTokensPerSec?: number;
+    RateLimitBurst?: number;
+    CrossLayerPipeline?: boolean;
+    PartitionReconcile?: boolean;
+    DiscoveryTimeBudgetMs?: number;
+    DiscoveryBatchSize?: number;
+    DiscoveryMaxRecords?: number;
+    DeactivateAbsent?: boolean;
+}
+declare class IntegrationSyncConfigOutput {
+    Success: boolean;
+    Message: string;
+    SyncConcurrency?: number;
+    MaxConcurrency?: number;
+    RateLimitTokensPerSec?: number;
+    RateLimitBurst?: number;
+    CrossLayerPipeline?: boolean;
+    PartitionReconcile?: boolean;
+    DiscoveryTimeBudgetMs?: number;
+    DiscoveryBatchSize?: number;
+    DiscoveryMaxRecords?: number;
+    DeactivateAbsent?: boolean;
+}
+declare class CustomColumnCandidate {
+    EntityName: string;
+    /** The source field key as captured in the overflow column. */
+    SourceKey: string;
+    /** The sanitized, collision-resolved column name that would be created. */
+    ColumnName: string;
+    /** Inferred schema-field type family ('string' | 'number' | 'boolean' | 'datetime'). */
+    InferredType: string;
+    /** true = the real column does not exist yet (ADD COLUMN); false = recovery (column exists, mapping missing). */
+    NeedsColumn: boolean;
+}
+declare class CustomColumnCandidatesOutput {
+    Success: boolean;
+    Message: string;
+    Candidates: CustomColumnCandidate[];
+}
+declare class PromotedColumn {
+    EntityName: string;
+    ColumnName: string;
+}
+declare class PromoteCustomColumnsOutput {
+    Success: boolean;
+    Message: string;
+    Promoted: boolean;
+    ColumnsAdded: PromotedColumn[];
+    /** true when an RSU schema change ran (a server restart may be pending to expose the new columns). */
+    SchemaUpdatePending: boolean;
+}
 declare class FieldMapInput {
     SourceFieldName: string;
     DestinationFieldName: string;
@@ -345,6 +399,10 @@ declare class CreateScheduleInput {
     Description?: string;
     SyncDirection?: string;
     FullSync?: boolean;
+    /** §13 — 'sync' (default; moves data via RunSync) or 'discovery' (schema-only RefreshConnectorSchema on cron, evolving the IO/IOF catalog — no RSU, no data sync). */
+    JobKind?: string;
+    /** Discovery-job only: deactivate objects/fields absent from an authoritative refresh (reversible). Default true. */
+    DeactivateAbsent?: boolean;
 }
 declare class CreateScheduleOutput {
     Success: boolean;
@@ -598,7 +656,7 @@ export declare class IntegrationDiscoveryResolver extends ResolverBase {
      * both on stdout (visible in the MJAPI log file) and in a per-run
      * `<cwd>/logs/integration-runs/<runID>/progress.jsonl` artifact.
      */
-    IntegrationRefreshConnectorSchema(companyIntegrationID: string, universalPKConvention: string | undefined, ctx: AppContext): Promise<RefreshConnectorSchemaOutput>;
+    IntegrationRefreshConnectorSchema(companyIntegrationID: string, universalPKConvention: string | undefined, deactivateAbsent: boolean | undefined, ctx: AppContext): Promise<RefreshConnectorSchemaOutput>;
     /**
      * Generates + persists strongly-typed Action metadata on demand for an
      * integration object. When `verb` is supplied, a single Action is generated
@@ -838,6 +896,37 @@ export declare class IntegrationDiscoveryResolver extends ResolverBase {
      * Updates credential values and/or configuration on an existing CompanyIntegration.
      */
     IntegrationUpdateConnection(companyIntegrationID: string, credentialValues: string, configuration: string, externalSystemID: string, testConnection: boolean, runSchemaRefresh: boolean, universalPKConvention: string | undefined, ctx: AppContext): Promise<MutationResultOutput>;
+    /**
+     * Sets the per-connection sync tuning (rate limit, concurrency, time budget, pipeline flags) as
+     * STRUCTURED typed fields, merged into CompanyIntegration.Configuration (other keys preserved).
+     * These are the exact keys the IntegrationEngine reads at runtime, so they become customizable
+     * via the API instead of hidden code constants. Returns the merged config typed.
+     */
+    IntegrationSetSyncConfig(companyIntegrationID: string, config: IntegrationSyncConfigInput, ctx: AppContext): Promise<IntegrationSyncConfigOutput>;
+    /** Reads the per-connection sync tuning back as STRUCTURED typed fields. */
+    IntegrationGetSyncConfig(companyIntegrationID: string, ctx: AppContext): Promise<IntegrationSyncConfigOutput>;
+    /** Reads a single boolean key from a CompanyIntegration.Configuration JSON string (undefined if absent/malformed). */
+    private readConfigBool;
+    /** Extracts the typed sync-config fields from a parsed Configuration object (type-guarded). */
+    private readSyncConfig;
+    /** The MJ entity names this connection has entity maps for (for whole-connection scope). */
+    private getMappedEntityNames;
+    /**
+     * Lists the custom-column CANDIDATES captured in the overflow column awaiting promotion — the "new
+     * columns found" for a connection. READ-ONLY (no schema change, no RSU). Scope to one entity via
+     * entityName, or omit to list across all the connection's mapped entities. Computed live (overflow keys
+     * minus already-mapped/already-a-column), so it is inherently deduped against anything a concurrent
+     * discovery already promoted.
+     */
+    IntegrationListCustomColumnCandidates(companyIntegrationID: string, entityName: string | undefined, ctx: AppContext): Promise<CustomColumnCandidatesOutput>;
+    /**
+     * On-demand promotion of captured custom columns: runs RSU (ADD COLUMN + register EntityField + field map),
+     * which may require a server restart to expose them over GraphQL. This is the USER-ACCEPTED trigger — by
+     * default a sync only CAPTURES to the overflow column (auto-promote is opt-in per connection via
+     * Configuration.autoPromoteCustomColumns). Scope via entityNames, or omit to promote across all mapped
+     * entities. Idempotent: already-promoted/mapped keys are skipped (safe to re-run / run alongside discovery).
+     */
+    IntegrationPromoteCustomColumns(companyIntegrationID: string, entityNames: string[] | undefined, ctx: AppContext): Promise<PromoteCustomColumnsOutput>;
     /**
      * Soft-deletes a CompanyIntegration by setting IsActive=false.
      */
@@ -895,6 +984,17 @@ export declare class IntegrationDiscoveryResolver extends ResolverBase {
      * Build schema artifacts for a single connector's objects.
      * Shared by IntegrationApplySchema (single) and IntegrationApplySchemaBatch (batch).
      */
+    /**
+     * §B — enforce OPTIONAL table/column caps at the create-tables (RSU) gate. These are OPERATOR
+     * (deployment) guardrails read from ENV — `MJ_INTEGRATION_MAX_TABLES` / `MJ_INTEGRATION_MAX_COLUMNS_PER_TABLE`
+     * (absent or ≤0 = unbounded, the common case). They are DELIBERATELY env-only, NOT per-connection
+     * `Configuration`/GraphQL: a guardrail a user can raise via the same API they apply with is toothless.
+     * THROWS a clear error when the selection exceeds a cap so NOTHING partial is created — the caller surfaces
+     * it and the user narrows the selection (the cap itself is an operator concern). NEVER truncates. Discovery
+     * still surfaces every object/field; only materialization is capped. Per-table column count = the selected
+     * field subset, or the object's full discovered field count when all fields are selected.
+     */
+    private enforceSchemaLimits;
     private buildSchemaForConnector;
     /**
      * Starts an async integration sync. Returns immediately with the run ID.