@memberjunction/server 5.41.0 → 5.43.0

package/dist/integration/CustomColumnPromoter.js

@@ -0,0 +1,508 @@
+/**
+ * Post-sync custom-column promoter (gaps.md §2 / M2b-server).
+ *
+ * Registered onto {@link IntegrationEngine} as the post-sync schema-promotion hook (the engine
+ * itself has no dependency on RSU/CodeGen — see SetPostSyncSchemaPromotionCallback). After a
+ * sync drains, the engine invokes this for the synced entities; here we:
+ *
+ *   1. GATE — sample the overflow column per entity. No overflow rows → no work (this is what
+ *      keeps a customs-free sync single-stage / 1×; your hard rule).
+ *   2. PLAN — {@link buildOverflowStats} + {@link planPromotions} decide which keys earn a real
+ *      column and the generously-bounded type for each (pure engine logic, unit-tested).
+ *   3. PROMOTE — for the winners: ADD COLUMN via {@link DDLGenerator} + {@link RuntimeSchemaManager}
+ *      (CodeGen reflects the column into a real EntityField), an IOF row per field (IsCustom,
+ *      MetadataSource='Discovered'), and a field map so the next sync maps it natively → the
+ *      capture/promote loop terminates.
+ *
+ * DIALECT PARITY (crucial, per PR #2752): the coverage scan is RunView (dialect-agnostic); DDL
+ * goes through DDLGenerator driven by provider.PlatformKey ('sqlserver' | 'postgresql'); RSU has
+ * dual SS/PG setup; IOF + field map are BaseEntity. No SS-only SQL anywhere in this file.
+ *
+ * The MJAPI restart (so the new column is exposed over GraphQL) + the JSON spread of staged
+ * values into the new columns are M3 — this stage applies the schema only (SkipRestart).
+ */
+import { LogError, LogStatus, LogStatusEx, Metadata, RunView, } from '@memberjunction/core';
+import { IntegrationEngine, CUSTOM_OVERFLOW_COLUMN, CONTENT_HASH_COLUMN, computeContentHash, buildOverflowStats, planPromotions, sanitizeColumnName, } from '@memberjunction/integration-engine';
+import { DDLGenerator } from '@memberjunction/integration-schema-builder';
+import { RuntimeSchemaManager } from '@memberjunction/schema-engine';
+/** Max rows sampled from the overflow column to compute coverage + infer types (bounded memory). */
+const OVERFLOW_SAMPLE_SIZE = 1000;
+/**
+ * Max columns promoted in a SINGLE pass, so a feed that suddenly exposes hundreds of distinct
+ * high-coverage keys can't mint hundreds of columns in one sync (bounded schema churn). The
+ * remainder is logged + deferred; it promotes on subsequent syncs (the keys stay captured).
+ */
+const MAX_PROMOTIONS_PER_PASS = 25;
+/** Registers the post-sync custom-column promotion hook on the IntegrationEngine singleton. */
+export function registerIntegrationCustomColumnPromoter() {
+    IntegrationEngine.Instance.SetPostSyncSchemaPromotionCallback(async (ctx) => {
+        const user = ctx.ContextUser;
+        const provider = ctx.Provider;
+        // GATE — promotion runs RSU (ADD COLUMN + register EntityField) + restart, which is disruptive.
+        // It is OPT-IN per connection (DEFAULT OFF): by default a sync only CAPTURES unmapped fields into
+        // the overflow column; the user triggers promotion on demand via IntegrationPromoteCustomColumns
+        // (after reviewing IntegrationListCustomColumnCandidates). Set Configuration.autoPromoteCustomColumns=true
+        // to restore automatic post-sync promotion. (Capture is unconditional; only the RSU step is gated.)
+        if (!(await readAutoPromoteFlag(ctx.CompanyIntegrationID, user, provider))) {
+            LogStatus(`[CustomColumnPromoter] Auto-promote OFF for CI ${ctx.CompanyIntegrationID} — unmapped fields captured to ` +
+                `the overflow column; awaiting on-demand promotion (IntegrationPromoteCustomColumns).`);
+            return { Promoted: false, ColumnsAdded: [], SchemaUpdatePending: false };
+        }
+        const promoter = new IntegrationCustomColumnPromoter(user, provider);
+        return promoter.PromoteForSync(ctx.CompanyIntegrationID, ctx.SyncedEntityNames);
+    });
+    // Verbose-only: this is a boot-time registration confirmation, not operator-actionable at
+    // standard level. Routes through the global verbose gate (set from the server's telemetry.level).
+    LogStatusEx({ message: '[CustomColumnPromoter] Registered post-sync custom-column promotion hook (auto-promote opt-in, default OFF).', verboseOnly: true });
+}
+/** Reads the per-connection `autoPromoteCustomColumns` flag (default false = capture-only, on-demand promotion). */
+async function readAutoPromoteFlag(companyIntegrationID, user, provider) {
+    try {
+        const md = provider ?? Metadata.Provider;
+        const ci = await md.GetEntityObject('MJ: Company Integrations', user);
+        if (!(await ci.Load(companyIntegrationID)) || !ci.Configuration)
+            return false;
+        return JSON.parse(ci.Configuration).autoPromoteCustomColumns === true;
+    }
+    catch {
+        return false;
+    }
+}
+const NOT_PROMOTED = { Promoted: false, ColumnsAdded: [], SchemaUpdatePending: false };
+/**
+ * Orchestrates promotion for one sync run. One instance per invocation (carries the per-sync
+ * context user + provider so it respects the bound provider, never the global default blindly).
+ */
+export class IntegrationCustomColumnPromoter {
+    constructor(user, providerOverride) {
+        this.user = user;
+        this.providerOverride = providerOverride;
+    }
+    get provider() {
+        return this.providerOverride ?? Metadata.Provider;
+    }
+    get dbProvider() {
+        return this.provider;
+    }
+    /** Entry point: promote custom columns for every entity touched by the sync. */
+    async PromoteForSync(companyIntegrationID, syncedEntityNames) {
+        const integrationID = await this.resolveIntegrationID(companyIntegrationID);
+        if (!integrationID)
+            return NOT_PROMOTED;
+        const columnsAdded = [];
+        for (const entityName of syncedEntityNames) {
+            try {
+                const added = await this.promoteEntity(companyIntegrationID, integrationID, entityName);
+                columnsAdded.push(...added);
+            }
+            catch (err) {
+                // One entity's promotion failure must not abort the others, and never the sync.
+                LogError(`[CustomColumnPromoter] Promotion failed for entity '${entityName}': ${this.msg(err)}`);
+            }
+        }
+        const promoted = columnsAdded.length > 0;
+        if (promoted) {
+            // Make the freshly-created EntityFields visible in-process for the next sync's mapping.
+            try {
+                await this.provider.Refresh();
+            }
+            catch (err) {
+                LogError(`[CustomColumnPromoter] provider.Refresh failed: ${this.msg(err)}`);
+            }
+        }
+        return { Promoted: promoted, ColumnsAdded: columnsAdded, SchemaUpdatePending: promoted };
+    }
+    /** Gate → plan → promote for a single target entity. Returns the columns it added. */
+    async promoteEntity(companyIntegrationID, integrationID, entityName) {
+        const planned = await this.planWorkForEntity(companyIntegrationID, entityName);
+        if (!planned || planned.work.length === 0)
+            return []; // no overflow / no entity map / already converged
+        const { entityInfo, entityMap } = planned;
+        let work = planned.work;
+        // M4a: bound schema churn per pass — the remainder stays captured and promotes next sync.
+        if (work.length > MAX_PROMOTIONS_PER_PASS) {
+            LogStatus(`[CustomColumnPromoter] ${work.length} candidates on ${entityName}; promoting ${MAX_PROMOTIONS_PER_PASS} this pass, ${work.length - MAX_PROMOTIONS_PER_PASS} deferred to next sync.`);
+            work = work.slice(0, MAX_PROMOTIONS_PER_PASS);
+        }
+        // 4. PROMOTE: ADD COLUMN+CodeGen (only the keys that need a column) → IOF rows → field maps → spread.
+        const newColumns = work.filter(w => w.needsColumn);
+        if (newColumns.length > 0 && !await this.applySchemaChange(entityInfo, newColumns)) {
+            return []; // DDL failed — leave everything captured; retry next sync (no partial commit lost)
+        }
+        await this.createIntegrationObjectFields(integrationID, entityMap.ExternalObjectName, work);
+        await this.createFieldMaps(entityMap.ID, work.filter(w => w.needsFieldMap));
+        // M3: spread staged values into the real columns + re-baseline the content hash.
+        // CRITICAL: refresh metadata FIRST. applySchemaChange just added the columns AND had RSU
+        // regenerate the spUpdate sproc to include them — but the running provider's in-memory entity
+        // metadata still predates the column add (the Refresh at the top ran before it). Without this,
+        // the spread's row.Save() builds a sproc call from the STALE field list that doesn't match the
+        // regenerated sproc → "Error executing SQL" (the spread-save failures). Re-loading metadata
+        // here aligns the entity's field set with the new DB sproc so the backfill saves succeed.
+        try {
+            await this.provider.Refresh();
+        }
+        catch (err) {
+            LogError(`[CustomColumnPromoter] pre-spread Refresh failed: ${this.msg(err)}`);
+        }
+        const refreshedEntityInfo = this.provider.EntityByName(entityName) ?? entityInfo;
+        await this.spreadAndRebaseline(entityName, entityMap.ID, refreshedEntityInfo, work);
+        LogStatus(`[CustomColumnPromoter] Promoted/recovered ${work.length} custom column(s) on ${entityName}: ${work.map(w => w.columnName).join(', ')}`);
+        return work.map(w => ({ EntityName: entityName, ColumnName: w.columnName }));
+    }
+    /**
+     * Dry-run of GATE → scan → PLAN → resolve-work for ONE entity, WITHOUT applying any schema change.
+     * Shared by {@link promoteEntity} (which then PROMOTES the work) and {@link ListCandidates} (which only
+     * reports it). Returns null when the entity has no overflow column / no captured customs / no entity map.
+     * Because the work list is computed live (overflow keys minus already-column-and-mapped), re-running is
+     * inherently deduped — a concurrent discovery that already promoted a key yields no work item for it.
+     */
+    async planWorkForEntity(companyIntegrationID, entityName) {
+        const entityInfo = this.provider.EntityByName(entityName);
+        if (!entityInfo?.SchemaName || !entityInfo.BaseTable)
+            return null;
+        // No overflow column on this table (predates the feature) → nothing to promote.
+        if (!entityInfo.Fields.some(f => f.Name === CUSTOM_OVERFLOW_COLUMN))
+            return null;
+        const overflowJson = await this.scanOverflow(entityName);
+        if (overflowJson.length === 0)
+            return null; // no customs captured
+        const passing = planPromotions(buildOverflowStats(overflowJson), {});
+        if (passing.length === 0)
+            return null;
+        const entityMap = await this.findEntityMap(companyIntegrationID, entityName);
+        if (!entityMap) {
+            LogError(`[CustomColumnPromoter] No entity map for ${entityName} on CI ${companyIntegrationID}.`);
+            return null;
+        }
+        // Skip fully-terminated keys (column + field map both exist); keep promote (needs column) / recover.
+        const fieldMapSources = await this.activeFieldMapSources(entityMap.ID);
+        const work = this.resolveWorkItems(passing, entityInfo, fieldMapSources);
+        return { entityInfo, entityMap, work };
+    }
+    /**
+     * Lists the custom-column CANDIDATES for one entity — the "new columns found" awaiting promotion,
+     * computed live from the overflow column minus already-mapped/already-a-column keys (inherently deduped).
+     * READ-ONLY: no schema change, no RSU. Backs `IntegrationListCustomColumnCandidates`.
+     */
+    async ListCandidates(companyIntegrationID, entityName) {
+        const planned = await this.planWorkForEntity(companyIntegrationID, entityName);
+        if (!planned)
+            return [];
+        return planned.work.map(w => ({
+            EntityName: entityName,
+            SourceKey: w.sourceKey,
+            ColumnName: w.columnName,
+            InferredType: w.candidate.Inferred.SchemaFieldType,
+            NeedsColumn: w.needsColumn,
+        }));
+    }
+    /** Samples the overflow column (rows where it is non-null) — dialect-agnostic via RunView. */
+    async scanOverflow(entityName) {
+        const rv = new RunView();
+        const res = await rv.RunView({
+            EntityName: entityName,
+            Fields: [CUSTOM_OVERFLOW_COLUMN],
+            ExtraFilter: `${CUSTOM_OVERFLOW_COLUMN} IS NOT NULL`,
+            MaxRows: OVERFLOW_SAMPLE_SIZE,
+            ResultType: 'simple',
+        }, this.user);
+        if (!res.Success) {
+            LogError(`[CustomColumnPromoter] Overflow scan failed for ${entityName}: ${res.ErrorMessage}`);
+            return [];
+        }
+        return (res.Results ?? []).map(r => r[CUSTOM_OVERFLOW_COLUMN] ?? null);
+    }
+    /**
+     * Splits coverage-passing keys into actionable work items, dropping any that are fully
+     * terminated (column AND field map both exist). A key whose column exists but whose field
+     * map is missing becomes a RECOVERY item (covers the crash window between ADD COLUMN and the
+     * field-map write) — needsColumn=false, needsFieldMap=true.
+     */
+    resolveWorkItems(passing, entityInfo, fieldMapSources) {
+        const existingByLower = new Map(entityInfo.Fields.map(f => [f.Name.toLowerCase(), f.Name]));
+        const taken = new Set(entityInfo.Fields.map(f => f.Name.toLowerCase()));
+        const items = [];
+        for (const candidate of passing) {
+            const existingCol = existingByLower.get(sanitizeColumnName(candidate.Key).toLowerCase());
+            const hasColumn = !!existingCol;
+            const hasFieldMap = fieldMapSources.has(candidate.Key.toLowerCase());
+            if (hasColumn && hasFieldMap)
+                continue; // terminated — nothing to do
+            const columnName = existingCol ?? this.uniqueColumnName(sanitizeColumnName(candidate.Key), taken);
+            if (!hasColumn)
+                taken.add(columnName.toLowerCase());
+            items.push({ candidate, sourceKey: candidate.Key, columnName, needsColumn: !hasColumn, needsFieldMap: !hasFieldMap });
+        }
+        return items;
+    }
+    /** Active field-map SOURCE field names for an entity map (lowercased) — for the terminate/recovery check. */
+    async activeFieldMapSources(entityMapID) {
+        const rv = new RunView();
+        const res = await rv.RunView({
+            EntityName: 'MJ: Company Integration Field Maps',
+            ExtraFilter: `EntityMapID='${entityMapID}' AND Status='Active'`,
+            Fields: ['SourceFieldName'],
+            ResultType: 'simple',
+        }, this.user);
+        return new Set(res.Success ? (res.Results ?? []).map(r => (r.SourceFieldName ?? '').toLowerCase()) : []);
+    }
+    /** Suffixes _2, _3, … until the sanitized name does not collide with an existing/assigned one. */
+    uniqueColumnName(base, taken) {
+        if (!taken.has(base.toLowerCase()))
+            return base;
+        for (let i = 2; i < 1000; i++) {
+            const candidate = `${base}_${i}`;
+            if (!taken.has(candidate.toLowerCase()))
+                return candidate;
+        }
+        return `${base}_${Date.now() % 100000}`; // pathological fallback (never expected)
+    }
+    /** Generates ADD COLUMN DDL for the new columns and runs it through RSU (CodeGen reflects them). */
+    async applySchemaChange(entityInfo, named) {
+        const platform = this.dbProvider.PlatformKey;
+        const ddl = new DDLGenerator();
+        const statements = named.map(n => ddl.GenerateAlterTableAddColumn(entityInfo.SchemaName, entityInfo.BaseTable, this.toTargetColumn(n, platform), platform));
+        const input = {
+            MigrationSQL: statements.join('\n'),
+            Description: `Promote ${named.length} custom column(s) on ${entityInfo.Name}`,
+            AffectedTables: [`${entityInfo.SchemaName}.${entityInfo.BaseTable}`],
+            // M3 owns the restart-signal + restart; this stage applies schema only. Runtime
+            // promotion creates no git commit (the dev RSU flow does; a per-sync commit is noise).
+            SkipRestart: true,
+            SkipGitCommit: true,
+        };
+        const result = await RuntimeSchemaManager.Instance.RunPipeline(input);
+        if (!result.Success) {
+            LogError(`[CustomColumnPromoter] RSU ADD COLUMN failed on ${entityInfo.Name}: ${result.ErrorMessage ?? result.ErrorStep ?? 'unknown'}`);
+        }
+        return result.Success;
+    }
+    /** Builds a per-platform TargetColumnConfig from a planned candidate. */
+    toTargetColumn(n, platform) {
+        const inferred = n.candidate.Inferred;
+        return {
+            SourceFieldName: n.sourceKey,
+            TargetColumnName: n.columnName,
+            TargetSqlType: platform === 'sqlserver' ? inferred.SqlServerType : inferred.PostgresType,
+            IsNullable: true, // customs are always nullable (never fabricate NOT NULL)
+            MaxLength: inferred.MaxLength,
+            Precision: null,
+            Scale: null,
+            DefaultValue: null,
+        };
+    }
+    /** Creates an IOF row per promoted field (IsCustom, MetadataSource='Discovered'). */
+    async createIntegrationObjectFields(integrationID, externalObjectName, named) {
+        const objectID = await this.resolveIntegrationObjectID(integrationID, externalObjectName);
+        if (!objectID) {
+            LogError(`[CustomColumnPromoter] No IntegrationObject '${externalObjectName}' for integration ${integrationID}; IOF rows skipped.`);
+            return;
+        }
+        // Lookup-or-reactivate-or-create — NEVER blind-create over an existing field. A field the source
+        // dropped is DEACTIVATED (Status='Inactive'), not deleted, and its column is preserved. When that
+        // key reappears in the payload and reaches promotion, the IOF already exists: reactivate it (so the
+        // active-filtered ApplyAll re-materializes the still-present column) instead of creating a duplicate.
+        // This is the "removed-then-re-added" case + the recovery case (column existed, field map missing).
+        const existingIOFs = await this.existingIOFsByName(objectID);
+        for (const n of named) {
+            const existing = existingIOFs.get(n.sourceKey.toLowerCase());
+            if (existing) {
+                if (existing.Status !== 'Active') {
+                    const reIof = await this.provider.GetEntityObject('MJ: Integration Object Fields', this.user);
+                    if (await reIof.Load(existing.ID)) {
+                        reIof.Status = 'Active';
+                        const ok = await reIof.Save();
+                        if (!ok)
+                            LogError(`[CustomColumnPromoter] Failed to reactivate IOF '${n.sourceKey}': ${reIof.LatestResult?.CompleteMessage ?? 'unknown'}`);
+                    }
+                }
+                continue;
+            }
+            const iof = await this.provider.GetEntityObject('MJ: Integration Object Fields', this.user);
+            iof.NewRecord();
+            iof.IntegrationObjectID = objectID;
+            iof.Name = n.sourceKey;
+            iof.DisplayName = n.sourceKey;
+            iof.Description = `Custom field discovered during sync; promoted to column ${n.columnName}.`;
+            iof.Type = n.candidate.Inferred.SchemaFieldType;
+            iof.Length = n.candidate.Inferred.MaxLength;
+            iof.AllowsNull = true;
+            iof.IsPrimaryKey = false; // never fabricated for customs (deferred to D4)
+            iof.IsUniqueKey = false;
+            iof.IsReadOnly = false;
+            iof.IsRequired = false;
+            iof.IsCustom = true;
+            // Provenance is STAMPED by this write path, never inferred later. 'Discovered' = the
+            // system found it automatically (vs 'Declared' curated / 'Custom' customer-added). The
+            // Configuration marker records the finer truth: it was data-sampled from a flat-file
+            // feed (not an authoritative describe endpoint) with this coverage, and its type was
+            // INFERRED — so consumers can treat it as soft / safely re-typable.
+            iof.MetadataSource = 'Discovered';
+            iof.Configuration = JSON.stringify({
+                promotedFrom: 'overflow',
+                coverage: Number(n.candidate.Coverage.toFixed(3)),
+                typeInferredFromData: true,
+            });
+            iof.Status = 'Active';
+            if (!await iof.Save()) {
+                LogError(`[CustomColumnPromoter] IOF save failed for ${n.sourceKey}: ${iof.LatestResult?.CompleteMessage ?? 'unknown'}`);
+            }
+        }
+    }
+    /** Creates a field map (source key → new column) so the next sync maps natively → terminate. */
+    async createFieldMaps(entityMapID, named) {
+        for (const n of named) {
+            const fm = await this.provider.GetEntityObject('MJ: Company Integration Field Maps', this.user);
+            fm.NewRecord();
+            fm.EntityMapID = entityMapID;
+            fm.SourceFieldName = n.sourceKey;
+            fm.DestinationFieldName = n.columnName;
+            fm.IsKeyField = false;
+            fm.IsRequired = false;
+            fm.Status = 'Active';
+            if (!await fm.Save()) {
+                LogError(`[CustomColumnPromoter] Field map save failed for ${n.sourceKey}: ${fm.LatestResult?.CompleteMessage ?? 'unknown'}`);
+            }
+        }
+    }
+    /**
+     * Spreads the staged overflow JSON values into the freshly-created real columns, then
+     * re-baselines the content hash (gaps.md §2 step 3). JS per-row pass — dialect-agnostic (no
+     * cast SQL, which is where PG bugs hide); BaseEntity handles the dialect on write. The overflow
+     * column is intentionally NOT cleared: once the field map exists the key is no longer "unmapped",
+     * so the next sync stops re-capturing it and planPromotions skips the now-existing column — the
+     * stale value self-heals. Bounded to rows that carry overflow, paged, once on the discovery sync.
+     */
+    async spreadAndRebaseline(entityName, entityMapID, entityInfo, named) {
+        const hasHashCol = entityInfo.Fields.some(f => f.Name === CONTENT_HASH_COLUMN);
+        const mappedDestFields = hasHashCol ? await this.activeDestinationFields(entityMapID) : [];
+        let startRow = 0;
+        const pageSize = 500;
+        for (;;) {
+            const rv = new RunView();
+            const res = await rv.RunView({
+                EntityName: entityName,
+                ExtraFilter: `${CUSTOM_OVERFLOW_COLUMN} IS NOT NULL`,
+                ResultType: 'entity_object',
+                MaxRows: pageSize,
+                StartRow: startRow,
+            }, this.user);
+            if (!res.Success) {
+                LogError(`[CustomColumnPromoter] Spread scan failed for ${entityName}: ${res.ErrorMessage}`);
+                return;
+            }
+            const rows = res.Results ?? [];
+            for (const row of rows) {
+                await this.spreadOneRow(row, named, hasHashCol, mappedDestFields);
+            }
+            if (rows.length < pageSize)
+                break;
+            startRow += pageSize;
+        }
+    }
+    /** Applies the staged values + re-baselined hash to a single row entity and saves it. */
+    async spreadOneRow(row, named, hasHashCol, mappedDestFields) {
+        // Dynamic .Get/.Set is REQUIRED here: these columns were created at runtime and have no
+        // generated typed property in this still-running process (full typed access arrives on the
+        // post-promotion restart). This is the sanctioned exception to the no-.Get/.Set rule.
+        const overflow = this.parseOverflow(row.Get(CUSTOM_OVERFLOW_COLUMN));
+        if (!overflow)
+            return;
+        let changed = false;
+        for (const n of named) {
+            if (Object.prototype.hasOwnProperty.call(overflow, n.sourceKey)) {
+                row.Set(n.columnName, overflow[n.sourceKey]);
+                changed = true;
+            }
+        }
+        if (!changed)
+            return;
+        if (hasHashCol) {
+            // Re-baseline to the next-sync value: hash over all active mapped destination columns
+            // (now incl. the new ones) as they sit on the row — matches what the next sync computes.
+            const mapped = {};
+            for (const dest of mappedDestFields)
+                mapped[dest] = row.Get(dest);
+            row.Set(CONTENT_HASH_COLUMN, computeContentHash(mapped));
+        }
+        if (!await row.Save()) {
+            LogError(`[CustomColumnPromoter] Spread save failed: ${row.LatestResult?.CompleteMessage ?? 'unknown'}`);
+        }
+    }
+    /** Active field-map destination column names for an entity map (for hash re-baseline). */
+    async activeDestinationFields(entityMapID) {
+        const rv = new RunView();
+        const res = await rv.RunView({
+            EntityName: 'MJ: Company Integration Field Maps',
+            ExtraFilter: `EntityMapID='${entityMapID}' AND Status='Active'`,
+            Fields: ['DestinationFieldName'],
+            ResultType: 'simple',
+        }, this.user);
+        return res.Success ? (res.Results ?? []).map(r => r.DestinationFieldName).filter(Boolean) : [];
+    }
+    parseOverflow(raw) {
+        if (typeof raw !== 'string' || raw.length === 0)
+            return null;
+        try {
+            const parsed = JSON.parse(raw);
+            return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Loads the CompanyIntegration's IntegrationID. */
+    async resolveIntegrationID(companyIntegrationID) {
+        const ci = await this.provider.GetEntityObject('MJ: Company Integrations', this.user);
+        const loaded = await ci.Load(companyIntegrationID);
+        return loaded ? ci.IntegrationID : null;
+    }
+    /** Finds the entity map (ExternalObject↔Entity) for this CI + target entity. */
+    async findEntityMap(companyIntegrationID, entityName) {
+        const rv = new RunView();
+        const res = await rv.RunView({
+            EntityName: 'MJ: Company Integration Entity Maps',
+            ExtraFilter: `CompanyIntegrationID='${companyIntegrationID}' AND Entity='${this.escape(entityName)}'`,
+            ResultType: 'simple',
+            MaxRows: 1,
+        }, this.user);
+        const row = res.Success ? res.Results?.[0] : undefined;
+        return row ? { ID: row.ID, ExternalObjectName: row.ExternalObjectName } : null;
+    }
+    /** Existing IOF field names (lowercased) for an object — for idempotent IOF creation. */
+    async existingIOFsByName(objectID) {
+        const rv = new RunView();
+        const res = await rv.RunView({
+            EntityName: 'MJ: Integration Object Fields',
+            ExtraFilter: `IntegrationObjectID='${objectID}'`,
+            Fields: ['ID', 'Name', 'Status'],
+            ResultType: 'simple',
+        }, this.user);
+        const map = new Map();
+        if (res.Success)
+            for (const r of res.Results ?? []) {
+                map.set((r.Name ?? '').toLowerCase(), { ID: String(r.ID), Status: r.Status ?? 'Active' });
+            }
+        return map;
+    }
+    /** Resolves the IntegrationObject ID for an external object name under an integration. */
+    async resolveIntegrationObjectID(integrationID, externalObjectName) {
+        const rv = new RunView();
+        const res = await rv.RunView({
+            EntityName: 'MJ: Integration Objects',
+            ExtraFilter: `IntegrationID='${integrationID}' AND Name='${this.escape(externalObjectName)}'`,
+            Fields: ['ID', 'Name', 'IntegrationID'],
+            ResultType: 'simple',
+            MaxRows: 1,
+        }, this.user);
+        const row = res.Success ? res.Results?.[0] : undefined;
+        return row ? row.ID : null;
+    }
+    escape(value) {
+        return value.replace(/'/g, "''");
+    }
+    msg(err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+}
+//# sourceMappingURL=CustomColumnPromoter.js.map

package/dist/integration/CustomColumnPromoter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomColumnPromoter.js","sourceRoot":"","sources":["../../src/integration/CustomColumnPromoter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EACH,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EACR,OAAO,GAKV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GAGrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAkD,MAAM,4CAA4C,CAAC;AAC1H,OAAO,EAAE,oBAAoB,EAAyB,MAAM,+BAA+B,CAAC;AAS5F,oGAAoG;AACpG,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAenC,+FAA+F;AAC/F,MAAM,UAAU,uCAAuC;IACnD,iBAAiB,CAAC,QAAQ,CAAC,kCAAkC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACxE,MAAM,IAAI,GAAG,GAAG,CAAC,WAAuB,CAAC;QACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAyC,CAAC;QAC/D,gGAAgG;QAChG,kGAAkG;QAClG,iGAAiG;QACjG,2GAA2G;QAC3G,oGAAoG;QACpG,IAAI,CAAC,CAAC,MAAM,mBAAmB,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzE,SAAS,CACL,kDAAkD,GAAG,CAAC,oBAAoB,iCAAiC;gBAC3G,sFAAsF,CACzF,CAAC;YACF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;QAC7E,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,+BAA+B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrE,OAAO,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,oBAAoB,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IACH,0FAA0F;IAC1F,kGAAkG;IAClG,WAAW,CAAC,EAAE,OAAO,EAAE,8GAA8G,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAChK,CAAC;AAED,oHAAoH;AACpH,KAAK,UAAU,mBAAmB,CAAC,oBAA4B,EAAE,IAAc,EAAE,QAA4B;IACzG,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;QACzC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,eAAe,CAA6B,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAClG,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QAC9E,OAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,CAA4C,CAAC,wBAAwB,KAAK,IAAI,CAAC;IACtH,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC7B,CAAC;AAED,MAAM,YAAY,GAA0B,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;AAE9G;;;GAGG;AACH,MAAM,OAAO,+BAA+B;IACxC,YACqB,IAAc,EACd,gBAAoC;QADpC,SAAI,GAAJ,IAAI,CAAU;QACd,qBAAgB,GAAhB,gBAAgB,CAAoB;IACtD,CAAC;IAEJ,IAAY,QAAQ;QAChB,OAAO,IAAI,CAAC,gBAAgB,IAAI,QAAQ,CAAC,QAAQ,CAAC;IACtD,CAAC;IAED,IAAY,UAAU;QAClB,OAAO,IAAI,CAAC,QAA2C,CAAC;IAC5D,CAAC;IAED,gFAAgF;IACzE,KAAK,CAAC,cAAc,CACvB,oBAA4B,EAC5B,iBAA2B;QAE3B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;QAC5E,IAAI,CAAC,aAAa;YAAE,OAAO,YAAY,CAAC;QAExC,MAAM,YAAY,GAAsD,EAAE,CAAC;QAC3E,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;YACzC,IAAI,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;gBACxF,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,gFAAgF;gBAChF,QAAQ,CAAC,uDAAuD,UAAU,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrG,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACX,wFAAwF;YACxF,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBAAC,QAAQ,CAAC,mDAAmD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;QACxI,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IAC7F,CAAC;IAED,sFAAsF;IAC9E,KAAK,CAAC,aAAa,CACvB,oBAA4B,EAC5B,aAAqB,EACrB,UAAkB;QAElB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QAC/E,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,CAAC,kDAAkD;QACxG,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAC1C,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAExB,0FAA0F;QAC1F,IAAI,IAAI,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;YACxC,SAAS,CAAC,0BAA0B,IAAI,CAAC,MAAM,kBAAkB,UAAU,eAAe,uBAAuB,eAAe,IAAI,CAAC,MAAM,GAAG,uBAAuB,yBAAyB,CAAC,CAAC;YAChM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAClD,CAAC;QAED,sGAAsG;QACtG,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;YACjF,OAAO,EAAE,CAAC,CAAC,mFAAmF;QAClG,CAAC;QACD,MAAM,IAAI,CAAC,6BAA6B,CAAC,aAAa,EAAE,SAAS,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;QAC5F,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5E,iFAAiF;QACjF,yFAAyF;QACzF,8FAA8F;QAC9F,+FAA+F;QAC/F,+FAA+F;QAC/F,4FAA4F;QAC5F,0FAA0F;QAC1F,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YAAC,QAAQ,CAAC,qDAAqD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QACtI,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;QACjF,MAAM,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAEpF,SAAS,CAAC,6CAA6C,IAAI,CAAC,MAAM,wBAAwB,UAAU,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnJ,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,iBAAiB,CAC3B,oBAA4B,EAC5B,UAAkB;QAElB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,CAAC,UAAU,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAClE,gFAAgF;QAChF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,sBAAsB;QAElE,MAAM,OAAO,GAAG,cAAc,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,QAAQ,CAAC,4CAA4C,UAAU,UAAU,oBAAoB,GAAG,CAAC,CAAC;YAClG,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,qGAAqG;QACrG,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;QACzE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,cAAc,CACvB,oBAA4B,EAC5B,UAAkB;QAElB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QAC/E,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,UAAU,EAAE,UAAU;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe;YAClD,WAAW,EAAE,CAAC,CAAC,WAAW;SAC7B,CAAC,CAAC,CAAC;IACR,CAAC;IAED,8FAA8F;IACtF,KAAK,CAAC,YAAY,CAAC,UAAkB;QACzC,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAA0B;YAClD,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,CAAC,sBAAsB,CAAC;YAChC,WAAW,EAAE,GAAG,sBAAsB,cAAc;YACpD,OAAO,EAAE,oBAAoB;YAC7B,UAAU,EAAE,QAAQ;SACvB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACf,QAAQ,CAAC,mDAAmD,UAAU,KAAK,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;YAC/F,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC,sBAAsB,CAAmB,IAAI,IAAI,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CACpB,OAA6B,EAC7B,UAAsB,EACtB,eAAoC;QAEpC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACzF,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACrE,IAAI,SAAS,IAAI,WAAW;gBAAE,SAAS,CAAC,6BAA6B;YACrE,MAAM,UAAU,GAAG,WAAW,IAAI,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAClG,IAAI,CAAC,SAAS;gBAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1H,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,6GAA6G;IACrG,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QACnD,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAqC;YAC7D,UAAU,EAAE,oCAAoC;YAChD,WAAW,EAAE,gBAAgB,WAAW,uBAAuB;YAC/D,MAAM,EAAE,CAAC,iBAAiB,CAAC;YAC3B,UAAU,EAAE,QAAQ;SACvB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,kGAAkG;IAC1F,gBAAgB,CAAC,IAAY,EAAE,KAAkB;QACrD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC9D,CAAC;QACD,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,yCAAyC;IACtF,CAAC;IAED,oGAAoG;IAC5F,KAAK,CAAC,iBAAiB,CAAC,UAAsB,EAAE,KAAiB;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,WAA+B,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC7B,GAAG,CAAC,2BAA2B,CAC3B,UAAU,CAAC,UAAU,EACrB,UAAU,CAAC,SAAS,EACpB,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,EAChC,QAAQ,CACX,CACJ,CAAC;QACF,MAAM,KAAK,GAAqB;YAC5B,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE,WAAW,KAAK,CAAC,MAAM,wBAAwB,UAAU,CAAC,IAAI,EAAE;YAC7E,cAAc,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACpE,gFAAgF;YAChF,uFAAuF;YACvF,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI;SACtB,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,QAAQ,CAAC,mDAAmD,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;QAC5I,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,yEAAyE;IACjE,cAAc,CAAC,CAAW,EAAE,QAA0B;QAC1D,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACtC,OAAO;YACH,eAAe,EAAE,CAAC,CAAC,SAAS;YAC5B,gBAAgB,EAAE,CAAC,CAAC,UAAU;YAC9B,aAAa,EAAE,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY;YACxF,UAAU,EAAE,IAAI,EAAE,yDAAyD;YAC3E,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,IAAI;SACrB,CAAC;IACN,CAAC;IAED,qFAAqF;IAC7E,KAAK,CAAC,6BAA6B,CACvC,aAAqB,EACrB,kBAA0B,EAC1B,KAAiB;QAEjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;QAC1F,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,QAAQ,CAAC,gDAAgD,kBAAkB,qBAAqB,aAAa,qBAAqB,CAAC,CAAC;YACpI,OAAO;QACX,CAAC;QACD,iGAAiG;QACjG,kGAAkG;QAClG,oGAAoG;QACpG,sGAAsG;QACtG,oGAAoG;QACpG,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7D,IAAI,QAAQ,EAAE,CAAC;gBACX,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAiC,+BAA+B,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC9H,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;wBAChC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;wBACxB,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;wBAC9B,IAAI,CAAC,EAAE;4BAAE,QAAQ,CAAC,oDAAoD,CAAC,CAAC,SAAS,MAAM,KAAK,CAAC,YAAY,EAAE,eAAe,IAAI,SAAS,EAAE,CAAC,CAAC;oBAC/I,CAAC;gBACL,CAAC;gBACD,SAAS;YACb,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAiC,+BAA+B,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5H,GAAG,CAAC,SAAS,EAAE,CAAC;YAChB,GAAG,CAAC,mBAAmB,GAAG,QAAQ,CAAC;YACnC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC;YACvB,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC;YAC9B,GAAG,CAAC,WAAW,GAAG,2DAA2D,CAAC,CAAC,UAAU,GAAG,CAAC;YAC7F,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC;YAChD,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC5C,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;YACtB,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC,CAAG,gDAAgD;YAC5E,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC;YACxB,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC;YACvB,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC;YACvB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;YACpB,qFAAqF;YACrF,uFAAuF;YACvF,qFAAqF;YACrF,qFAAqF;YACrF,oEAAoE;YACpE,GAAG,CAAC,cAAc,GAAG,YAAY,CAAC;YAClC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC/B,YAAY,EAAE,UAAU;gBACxB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACjD,oBAAoB,EAAE,IAAI;aAC7B,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpB,QAAQ,CAAC,8CAA8C,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,EAAE,eAAe,IAAI,SAAS,EAAE,CAAC,CAAC;YAC7H,CAAC;QACL,CAAC;IACL,CAAC;IAED,gGAAgG;IACxF,KAAK,CAAC,eAAe,CAAC,WAAmB,EAAE,KAAiB;QAChE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAqC,oCAAoC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACpI,EAAE,CAAC,SAAS,EAAE,CAAC;YACf,EAAE,CAAC,WAAW,GAAG,WAAW,CAAC;YAC7B,EAAE,CAAC,eAAe,GAAG,CAAC,CAAC,SAAS,CAAC;YACjC,EAAE,CAAC,oBAAoB,GAAG,CAAC,CAAC,UAAU,CAAC;YACvC,EAAE,CAAC,UAAU,GAAG,KAAK,CAAC;YACtB,EAAE,CAAC,UAAU,GAAG,KAAK,CAAC;YACtB,EAAE,CAAC,MAAM,GAAG,QAAQ,CAAC;YACrB,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,QAAQ,CAAC,oDAAoD,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,YAAY,EAAE,eAAe,IAAI,SAAS,EAAE,CAAC,CAAC;YAClI,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,mBAAmB,CAC7B,UAAkB,EAClB,WAAmB,EACnB,UAAsB,EACtB,KAAiB;QAEjB,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;QAC/E,MAAM,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3F,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,QAAQ,GAAG,GAAG,CAAC;QACrB,SAAS,CAAC;YACN,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAa;gBACrC,UAAU,EAAE,UAAU;gBACtB,WAAW,EAAE,GAAG,sBAAsB,cAAc;gBACpD,UAAU,EAAE,eAAe;gBAC3B,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE,QAAQ;aACrB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACf,QAAQ,CAAC,iDAAiD,UAAU,KAAK,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC7F,OAAO;YACX,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ;gBAAE,MAAM;YAClC,QAAQ,IAAI,QAAQ,CAAC;QACzB,CAAC;IACL,CAAC;IAED,yFAAyF;IACjF,KAAK,CAAC,YAAY,CACtB,GAAe,EACf,KAAiB,EACjB,UAAmB,EACnB,gBAA0B;QAE1B,wFAAwF;QACxF,2FAA2F;QAC3F,sFAAsF;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC7C,OAAO,GAAG,IAAI,CAAC;YACnB,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,UAAU,EAAE,CAAC;YACb,sFAAsF;YACtF,yFAAyF;YACzF,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,gBAAgB;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClE,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,QAAQ,CAAC,8CAA8C,GAAG,CAAC,YAAY,EAAE,eAAe,IAAI,SAAS,EAAE,CAAC,CAAC;QAC7G,CAAC;IACL,CAAC;IAED,0FAA0F;IAClF,KAAK,CAAC,uBAAuB,CAAC,WAAmB;QACrD,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAqC;YAC7D,UAAU,EAAE,oCAAoC;YAChD,WAAW,EAAE,gBAAgB,WAAW,uBAAuB;YAC/D,MAAM,EAAE,CAAC,sBAAsB,CAAC;YAChC,UAAU,EAAE,QAAQ;SACvB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,CAAC;IAEO,aAAa,CAAC,GAAY;QAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7D,IAAI,CAAC;YACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAkC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvH,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,oDAAoD;IAC5C,KAAK,CAAC,oBAAoB,CAAC,oBAA4B;QAC3D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAA6B,0BAA0B,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAClH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,gFAAgF;IACxE,KAAK,CAAC,aAAa,CACvB,oBAA4B,EAC5B,UAAkB;QAElB,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAsC;YAC9D,UAAU,EAAE,qCAAqC;YACjD,WAAW,EAAE,yBAAyB,oBAAoB,iBAAiB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG;YACrG,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,CAAC;SACb,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACnF,CAAC;IAED,yFAAyF;IACjF,KAAK,CAAC,kBAAkB,CAAC,QAAgB;QAC7C,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAiC;YACzD,UAAU,EAAE,+BAA+B;YAC3C,WAAW,EAAE,wBAAwB,QAAQ,GAAG;YAChD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAChC,UAAU,EAAE,QAAQ;SACvB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,IAAI,GAAG,EAA0C,CAAC;QAC9D,IAAI,GAAG,CAAC,OAAO;YAAE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACjD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC;YAC9F,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,0FAA0F;IAClF,KAAK,CAAC,0BAA0B,CAAC,aAAqB,EAAE,kBAA0B;QACtF,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAA4B;YACpD,UAAU,EAAE,yBAAyB;YACrC,WAAW,EAAE,kBAAkB,aAAa,eAAe,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG;YAC7F,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;YACvC,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,CAAC;SACb,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/B,CAAC;IAEO,MAAM,CAAC,KAAa;QACxB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAEO,GAAG,CAAC,GAAY;QACpB,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;CACJ"}

package/dist/logging/StartupLogger.d.ts

@@ -34,6 +34,14 @@ export declare class StartupLogger {
     private readonly resolvedLevel;
     private readonly phaseTimings;
     private readonly summary;
+    /** Transient boot spinner — active only at `standard` level on a TTY (see {@link spinnerEnabled}). */
+    private spinner;
+    /** Interval that ticks the live elapsed counter on the spinner line. */
+    private bootTimer;
+    /** Wall-clock start of the boot indicator, for the live elapsed counter. */
+    private bootStartMs;
+    /** Most recent phase label, shown on the spinner line. */
+    private currentPhase?;
     /**
      * @param level Optional explicit level override (primarily for tests).
      *              When omitted, the level is resolved from config.
@@ -67,6 +75,41 @@ export declare class StartupLogger {
      * {@link EndPhase}.
      */
     StartPhase(): number;
+    /**
+     * 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.
+     */
+    private get spinnerEnabled();
+    /** Prefix for the transient boot indicator (no rocket — we haven't launched yet). */
+    private static readonly BOOT_LABEL;
+    /** Composes the boot label, plus the current phase when known (no elapsed counter). */
+    private bootText;
+    /** Repaints the spinner line with the current phase and a live elapsed counter. */
+    private refreshBootText;
+    /**
+     * 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(): void;
+    /**
+     * 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: string): number;
+    /** Stops and clears the boot spinner + its elapsed-counter interval. Safe to call when inactive. */
+    StopBoot(): void;
     /**
      * Records the elapsed time for a phase since `startedAt`, buffering it for the
      * summary. At `verbose`+ the phase is also printed immediately (matching the
@@ -78,6 +121,8 @@ export declare class StartupLogger {
     EndPhase(label: string, startedAt: number): number;
     /** Records the server package version for the summary header. */
     SetVersion(version: string | undefined): void;
+    /** Records the resolved config-file path for the summary `Config` line. */
+    SetConfigPath(path: string | undefined): void;
     /** Records DB platform + connection + entity count for the summary `DB` line. */
     SetDatabaseInfo(platform: string, connection: string, entityCount: number): void;
     /** Adds a registered auth-provider name to the summary `Auth` line. */
@@ -106,9 +151,20 @@ export declare class StartupLogger {
     private buildHeaderLine;
     /** `   DB        <platform> · <connection> · <N> entities`. */
     private buildDbLine;
+    /** `   Config    <path>` (omitted when no config file was resolved). */
+    private buildConfigLine;
     /** `   Auth      <providers>          REST <on/off> · <N> scheduled jobs`. */
     private buildAuthLine;
-    /** `   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.
+     */
     private buildStartupLine;
     /**
      * Abbreviates a verbose phase label into a compact token for the collapsed

package/dist/logging/StartupLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartupLogger.d.ts","sourceRoot":"","sources":["../../src/logging/StartupLogger.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AA8C1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE;;;OAGG;gBACS,KAAK,CAAC,EAAE,cAAc;IAIlC;;OAEG;IACH,IAAW,KAAK,IAAI,cAAc,CAEjC;IAED;;;;;;OAMG;WACW,sBAAsB,IAAI,cAAc;IAQtD;;;OAGG;IACI,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAInD;;;;OAIG;IACI,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7D;;;OAGG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;;;;OAOG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAUzD,iEAAiE;IAC1D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpD,iFAAiF;IAC1E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMvF,uEAAuE;IAChE,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1C,2EAA2E;IACpE,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C,0EAA0E;IACnE,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,0DAA0D;IACnD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;;OAMG;IACI,YAAY,IAAI,IAAI;IAQ3B,iDAAiD;IACjD,OAAO,CAAC,kBAAkB;IAO1B,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;IAMzB,yEAAyE;IACzE,OAAO,CAAC,iBAAiB;IAUzB,8EAA8E;IAC9E,OAAO,CAAC,eAAe;IAKvB,+DAA+D;IAC/D,OAAO,CAAC,WAAW;IAcnB,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAerB,gEAAgE;IAChE,OAAO,CAAC,gBAAgB;IAWxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAuBvB,4BAA4B;IAC5B,OAAO,CAAC,cAAc;CAMvB"}
+{"version":3,"file":"StartupLogger.d.ts","sourceRoot":"","sources":["../../src/logging/StartupLogger.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAgD1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,sGAAsG;IACtG,OAAO,CAAC,OAAO,CAAoB;IACnC,wEAAwE;IACxE,OAAO,CAAC,SAAS,CAA+C;IAChE,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAAK;IACxB,0DAA0D;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B;;;OAGG;gBACS,KAAK,CAAC,EAAE,cAAc;IAIlC;;OAEG;IACH,IAAW,KAAK,IAAI,cAAc,CAEjC;IAED;;;;;;OAMG;WACW,sBAAsB,IAAI,cAAc;IAQtD;;;OAGG;IACI,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAInD;;;;OAIG;IACI,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7D;;;OAGG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;;;OAMG;IACH,OAAO,KAAK,cAAc,GAEzB;IAED,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAyC;IAE3E,uFAAuF;IACvF,OAAO,CAAC,QAAQ;IAIhB,mFAAmF;IACnF,OAAO,CAAC,eAAe;IAOvB;;;;;;;;;OASG;IACI,SAAS,IAAI,IAAI;IAiBxB;;;;;;OAMG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMxC,oGAAoG;IAC7F,QAAQ,IAAI,IAAI;IAWvB;;;;;;;OAOG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAUzD,iEAAiE;IAC1D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpD,2EAA2E;IACpE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpD,iFAAiF;IAC1E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMvF,uEAAuE;IAChE,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1C,2EAA2E;IACpE,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C,0EAA0E;IACnE,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,0DAA0D;IACnD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;;OAMG;IACI,YAAY,IAAI,IAAI;IAW3B,iDAAiD;IACjD,OAAO,CAAC,kBAAkB;IAO1B,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;IAMzB,yEAAyE;IACzE,OAAO,CAAC,iBAAiB;IAWzB,8EAA8E;IAC9E,OAAO,CAAC,eAAe;IAKvB,+DAA+D;IAC/D,OAAO,CAAC,WAAW;IAcnB,wEAAwE;IACxE,OAAO,CAAC,eAAe;IAOvB,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAerB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAuBvB,4BAA4B;IAC5B,OAAO,CAAC,cAAc;CAMvB"}