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

package/src/generic/OrphanedConversationDetailReconciler.ts

@@ -1,5 +1,6 @@
 import { LogError, LogStatus, RunView } from '@memberjunction/core';
-import { IndexByUUID } from '@memberjunction/global';
+import { IndexByUUID, ShutdownRegistry } from '@memberjunction/global';
+import { DEFAULT_CONVERSATION_DETAIL_RECONCILER_SETTINGS, type ConversationDetailReconcilerSettings } from '../backgroundSweepConfigUnits.js';
 import { UserCache } from '@memberjunction/sqlserver-dataprovider';
 import type { IMetadataProvider, UserInfo } from '@memberjunction/core';
 import type { MJAIAgentRunEntity, MJConversationDetailEntity, MJConversationDetailEntityExtended } from '@memberjunction/core-entities';
@@ -267,3 +268,33 @@ async function loadConversationOwners(
     }
     return owners;
 }
+
+/**
+ * Runs {@link ReconcileOrphanedConversationDetails} once now (closes what a restart orphaned) and,
+ * when `settings.enabled`, again every `settings.sweepIntervalMs` (closes mid-life orphans),
+ * registering the timer for graceful shutdown. With `enabled` false only the startup pass runs, so an
+ * idle server sends no periodic queries for it (`conversationDetailReconciler`; see the Serverless
+ * Database Auto-Pause guide). A failed pass is logged, never thrown.
+ *
+ * @returns The repeat timer, or `null` when no repeat was scheduled.
+ */
+export function StartOrphanedConversationDetailReconciler(
+    provider: IMetadataProvider,
+    contextUser: UserInfo,
+    settings: ConversationDetailReconcilerSettings = DEFAULT_CONVERSATION_DETAIL_RECONCILER_SETTINGS
+): ReturnType<typeof setInterval> | null {
+    const pass = (): void => {
+        void ReconcileOrphanedConversationDetails(provider, contextUser)
+            .catch(err => LogError(`[OrphanDetailReconciler] Pass failed: ${err instanceof Error ? err.message : String(err)}`));
+    };
+    pass();
+    if (!settings.enabled) {
+        return null;
+    }
+    const timer = setInterval(pass, settings.sweepIntervalMs);
+    ShutdownRegistry.Instance.Register({
+        ShutdownName: 'OrphanDetailReconciler',
+        Shutdown: () => { clearInterval(timer); },
+    });
+    return timer;
+}