@memberjunction/metadata-sync 2.46.0 → 2.48.0

package/dist/lib/provider-utils.d.ts

@@ -1,13 +1,85 @@
+/**
+ * @fileoverview Database provider utilities for MetadataSync
+ * @module provider-utils
+ *
+ * This module provides utilities for initializing and managing the database
+ * connection, accessing system users, and finding entity directories. It handles
+ * the TypeORM DataSource lifecycle and MemberJunction provider initialization.
+ */
 import { SQLServerDataProvider } from '@memberjunction/sqlserver-dataprovider';
 import type { MJConfig } from '../config';
 import { UserInfo } from '@memberjunction/core';
+/**
+ * Initialize a SQLServerDataProvider with the given configuration
+ *
+ * Creates and initializes a TypeORM DataSource for SQL Server, then sets up
+ * the MemberJunction SQLServerDataProvider. The connection is stored globally
+ * for proper cleanup. Auto-detects Azure SQL databases for encryption settings.
+ *
+ * @param config - MemberJunction configuration with database connection details
+ * @returns Promise resolving to initialized SQLServerDataProvider instance
+ * @throws Error if database connection fails
+ *
+ * @example
+ * ```typescript
+ * const config = loadMJConfig();
+ * const provider = await initializeProvider(config);
+ * // Provider is ready for use
+ * ```
+ */
 export declare function initializeProvider(config: MJConfig): Promise<SQLServerDataProvider>;
+/**
+ * Clean up the global database connection
+ *
+ * Destroys the TypeORM DataSource if it exists and is initialized.
+ * Should be called when the CLI command completes to ensure proper cleanup.
+ *
+ * @returns Promise that resolves when cleanup is complete
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   // Do work with database
+ * } finally {
+ *   await cleanupProvider();
+ * }
+ * ```
+ */
 export declare function cleanupProvider(): Promise<void>;
+/**
+ * Get the system user from the UserCache
+ *
+ * Retrieves the "System" user from MemberJunction's UserCache. This user is
+ * typically used for CLI operations where no specific user context exists.
+ *
+ * @returns The System UserInfo object
+ * @throws Error if System user is not found in the cache
+ *
+ * @example
+ * ```typescript
+ * const systemUser = getSystemUser();
+ * const syncEngine = new SyncEngine(systemUser);
+ * ```
+ */
 export declare function getSystemUser(): UserInfo;
 /**
- * Recursively find all entity directories with .mj-sync.json files
- * @param dir Directory to search
- * @param specificDir Optional specific directory to limit search to
- * @returns Array of directory paths containing .mj-sync.json files
+ * Find entity directories at the immediate level only
+ *
+ * Searches for directories containing .mj-sync.json files, which indicate
+ * entity data directories. Only searches immediate subdirectories, not recursive.
+ * If a specific directory is provided, only checks that directory.
+ *
+ * @param dir - Base directory to search from
+ * @param specificDir - Optional specific subdirectory name to check
+ * @returns Array of absolute directory paths containing .mj-sync.json files
+ *
+ * @example
+ * ```typescript
+ * // Find all entity directories
+ * const dirs = findEntityDirectories(process.cwd());
+ *
+ * // Check specific directory
+ * const dirs = findEntityDirectories(process.cwd(), 'ai-prompts');
+ * ```
  */
 export declare function findEntityDirectories(dir: string, specificDir?: string): string[];

package/dist/lib/provider-utils.js

@@ -1,4 +1,12 @@
 "use strict";
+/**
+ * @fileoverview Database provider utilities for MetadataSync
+ * @module provider-utils
+ *
+ * This module provides utilities for initializing and managing the database
+ * connection, accessing system users, and finding entity directories. It handles
+ * the TypeORM DataSource lifecycle and MemberJunction provider initialization.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -28,47 +36,113 @@ const typeorm_1 = require("typeorm");
 const sqlserver_dataprovider_1 = require("@memberjunction/sqlserver-dataprovider");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+/** Global DataSource instance for connection lifecycle management */
+let globalDataSource = null;
+/** Global provider instance to ensure single initialization */
+let globalProvider = null;
+/** Promise to track ongoing initialization */
+let initializationPromise = null;
 /**
  * Initialize a SQLServerDataProvider with the given configuration
- * @param config MemberJunction configuration with database connection details
- * @returns Initialized SQLServerDataProvider instance
+ *
+ * Creates and initializes a TypeORM DataSource for SQL Server, then sets up
+ * the MemberJunction SQLServerDataProvider. The connection is stored globally
+ * for proper cleanup. Auto-detects Azure SQL databases for encryption settings.
+ *
+ * @param config - MemberJunction configuration with database connection details
+ * @returns Promise resolving to initialized SQLServerDataProvider instance
+ * @throws Error if database connection fails
+ *
+ * @example
+ * ```typescript
+ * const config = loadMJConfig();
+ * const provider = await initializeProvider(config);
+ * // Provider is ready for use
+ * ```
  */
-let globalDataSource = null;
 async function initializeProvider(config) {
-    // Create TypeORM DataSource
-    const dataSource = new typeorm_1.DataSource({
-        type: 'mssql',
-        host: config.dbHost,
-        port: config.dbPort ? Number(config.dbPort) : 1433,
-        database: config.dbDatabase,
-        username: config.dbUsername,
-        password: config.dbPassword,
-        synchronize: false,
-        logging: false,
-        options: {
-            encrypt: config.dbTrustServerCertificate !== 'Y' ? false : true,
-            trustServerCertificate: config.dbTrustServerCertificate === 'Y',
-            instanceName: config.dbInstanceName
-        }
-    });
-    // Initialize the data source
-    await dataSource.initialize();
-    // Store for cleanup
-    globalDataSource = dataSource;
-    // Create provider config
-    const providerConfig = new sqlserver_dataprovider_1.SQLServerProviderConfigData(dataSource, 'system@sync.cli', // Default user for CLI
-    config.mjCoreSchema || '__mj', 0);
-    // Use setupSQLServerClient to properly initialize
-    return await (0, sqlserver_dataprovider_1.setupSQLServerClient)(providerConfig);
+    // Return existing provider if already initialized
+    if (globalProvider) {
+        return globalProvider;
+    }
+    // Return ongoing initialization if in progress
+    if (initializationPromise) {
+        return initializationPromise;
+    }
+    // Start new initialization
+    initializationPromise = (async () => {
+        // Create TypeORM DataSource
+        const dataSource = new typeorm_1.DataSource({
+            type: 'mssql',
+            host: config.dbHost,
+            port: config.dbPort ? Number(config.dbPort) : 1433,
+            database: config.dbDatabase,
+            username: config.dbUsername,
+            password: config.dbPassword,
+            synchronize: false,
+            logging: false,
+            options: {
+                encrypt: config.dbEncrypt === 'Y' || config.dbEncrypt === 'true' ||
+                    config.dbHost.includes('.database.windows.net'), // Auto-detect Azure SQL
+                trustServerCertificate: config.dbTrustServerCertificate === 'Y',
+                instanceName: config.dbInstanceName
+            }
+        });
+        // Initialize the data source
+        await dataSource.initialize();
+        // Store for cleanup
+        globalDataSource = dataSource;
+        // Create provider config
+        const providerConfig = new sqlserver_dataprovider_1.SQLServerProviderConfigData(dataSource, 'system@sync.cli', // Default user for CLI
+        config.mjCoreSchema || '__mj', 0);
+        // Use setupSQLServerClient to properly initialize
+        globalProvider = await (0, sqlserver_dataprovider_1.setupSQLServerClient)(providerConfig);
+        return globalProvider;
+    })();
+    return initializationPromise;
 }
 exports.initializeProvider = initializeProvider;
+/**
+ * Clean up the global database connection
+ *
+ * Destroys the TypeORM DataSource if it exists and is initialized.
+ * Should be called when the CLI command completes to ensure proper cleanup.
+ *
+ * @returns Promise that resolves when cleanup is complete
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   // Do work with database
+ * } finally {
+ *   await cleanupProvider();
+ * }
+ * ```
+ */
 async function cleanupProvider() {
     if (globalDataSource && globalDataSource.isInitialized) {
         await globalDataSource.destroy();
         globalDataSource = null;
     }
+    globalProvider = null;
+    initializationPromise = null;
 }
 exports.cleanupProvider = cleanupProvider;
+/**
+ * Get the system user from the UserCache
+ *
+ * Retrieves the "System" user from MemberJunction's UserCache. This user is
+ * typically used for CLI operations where no specific user context exists.
+ *
+ * @returns The System UserInfo object
+ * @throws Error if System user is not found in the cache
+ *
+ * @example
+ * ```typescript
+ * const systemUser = getSystemUser();
+ * const syncEngine = new SyncEngine(systemUser);
+ * ```
+ */
 function getSystemUser() {
     const sysUser = sqlserver_dataprovider_1.UserCache.Instance.UserByName("System", false);
     if (!sysUser) {
@@ -78,38 +152,48 @@ function getSystemUser() {
 }
 exports.getSystemUser = getSystemUser;
 /**
- * Recursively find all entity directories with .mj-sync.json files
- * @param dir Directory to search
- * @param specificDir Optional specific directory to limit search to
- * @returns Array of directory paths containing .mj-sync.json files
+ * Find entity directories at the immediate level only
+ *
+ * Searches for directories containing .mj-sync.json files, which indicate
+ * entity data directories. Only searches immediate subdirectories, not recursive.
+ * If a specific directory is provided, only checks that directory.
+ *
+ * @param dir - Base directory to search from
+ * @param specificDir - Optional specific subdirectory name to check
+ * @returns Array of absolute directory paths containing .mj-sync.json files
+ *
+ * @example
+ * ```typescript
+ * // Find all entity directories
+ * const dirs = findEntityDirectories(process.cwd());
+ *
+ * // Check specific directory
+ * const dirs = findEntityDirectories(process.cwd(), 'ai-prompts');
+ * ```
  */
 function findEntityDirectories(dir, specificDir) {
     const results = [];
-    function search(currentDir) {
-        const entries = fs.readdirSync(currentDir, { withFileTypes: true });
-        // Check if this directory has .mj-sync.json (and it's not the root)
-        const hasSyncConfig = entries.some(e => e.name === '.mj-sync.json');
-        const isRoot = currentDir === dir;
-        if (hasSyncConfig && !isRoot) {
-            results.push(currentDir);
-        }
-        // Recursively search subdirectories
-        for (const entry of entries) {
-            if (entry.isDirectory() && !entry.name.startsWith('.')) {
-                search(path.join(currentDir, entry.name));
-            }
-        }
-    }
-    // If specific directory is provided, only search within it
+    // If specific directory is provided, check if it's an entity directory
     if (specificDir) {
-        // Handle both absolute and relative paths
         const targetDir = path.isAbsolute(specificDir) ? specificDir : path.join(dir, specificDir);
         if (fs.existsSync(targetDir)) {
-            search(targetDir);
+            const hasSyncConfig = fs.existsSync(path.join(targetDir, '.mj-sync.json'));
+            if (hasSyncConfig) {
+                results.push(targetDir);
+            }
         }
+        return results;
     }
-    else {
-        search(dir);
+    // Otherwise, find all immediate subdirectories with .mj-sync.json
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+            const subDir = path.join(dir, entry.name);
+            const hasSyncConfig = fs.existsSync(path.join(subDir, '.mj-sync.json'));
+            if (hasSyncConfig) {
+                results.push(subDir);
+            }
+        }
     }
     return results;
 }

package/dist/lib/provider-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-utils.js","sourceRoot":"","sources":["../../src/lib/provider-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { DataSource } from 'typeorm';\nimport { SQLServerDataProvider, SQLServerProviderConfigData, UserCache, setupSQLServerClient } from '@memberjunction/sqlserver-dataprovider';\nimport type { MJConfig } from '../config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { UserInfo } from '@memberjunction/core';\n\n/**\n * Initialize a SQLServerDataProvider with the given configuration\n * @param config MemberJunction configuration with database connection details\n * @returns Initialized SQLServerDataProvider instance\n */\nlet globalDataSource: DataSource | null = null;\n\nexport async function initializeProvider(config: MJConfig): Promise<SQLServerDataProvider> {\n  // Create TypeORM DataSource\n  const dataSource = new DataSource({\n    type: 'mssql',\n    host: config.dbHost,\n    port: config.dbPort ? Number(config.dbPort) : 1433,\n    database: config.dbDatabase,\n    username: config.dbUsername,\n    password: config.dbPassword,\n    synchronize: false,\n    logging: false,\n    options: {\n      encrypt: config.dbTrustServerCertificate !== 'Y' ? false : true,\n      trustServerCertificate: config.dbTrustServerCertificate === 'Y',\n      instanceName: config.dbInstanceName\n    }\n  });\n  \n  // Initialize the data source\n  await dataSource.initialize();\n  \n  // Store for cleanup\n  globalDataSource = dataSource;\n  \n  // Create provider config\n  const providerConfig = new SQLServerProviderConfigData(\n    dataSource,\n    'system@sync.cli', // Default user for CLI\n    config.mjCoreSchema || '__mj',\n    0\n  );\n  \n  // Use setupSQLServerClient to properly initialize\n  return await setupSQLServerClient(providerConfig);\n}\n\nexport async function cleanupProvider(): Promise<void> {\n  if (globalDataSource && globalDataSource.isInitialized) {\n    await globalDataSource.destroy();\n    globalDataSource = null;\n  }\n}\n\nexport function getSystemUser(): UserInfo {\n  const sysUser = UserCache.Instance.UserByName(\"System\", false);\n  if (!sysUser) {\n    throw new Error(\"System user not found in cache. Ensure the system user exists in the database.\");    \n  }\n  return sysUser;\n}\n\n/**\n * Recursively find all entity directories with .mj-sync.json files\n * @param dir Directory to search\n * @param specificDir Optional specific directory to limit search to\n * @returns Array of directory paths containing .mj-sync.json files\n */\nexport function findEntityDirectories(dir: string, specificDir?: string): string[] {\n  const results: string[] = [];\n  \n  function search(currentDir: string) {\n    const entries = fs.readdirSync(currentDir, { withFileTypes: true });\n    \n    // Check if this directory has .mj-sync.json (and it's not the root)\n    const hasSyncConfig = entries.some(e => e.name === '.mj-sync.json');\n    const isRoot = currentDir === dir;\n    \n    if (hasSyncConfig && !isRoot) {\n      results.push(currentDir);\n    }\n    \n    // Recursively search subdirectories\n    for (const entry of entries) {\n      if (entry.isDirectory() && !entry.name.startsWith('.')) {\n        search(path.join(currentDir, entry.name));\n      }\n    }\n  }\n  \n  // If specific directory is provided, only search within it\n  if (specificDir) {\n    // Handle both absolute and relative paths\n    const targetDir = path.isAbsolute(specificDir) ? specificDir : path.join(dir, specificDir);\n    if (fs.existsSync(targetDir)) {\n      search(targetDir);\n    }\n  } else {\n    search(dir);\n  }\n  \n  return results;\n}"]}
+{"version":3,"file":"provider-utils.js","sourceRoot":"","sources":["../../src/lib/provider-utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Database provider utilities for MetadataSync\n * @module provider-utils\n * \n * This module provides utilities for initializing and managing the database\n * connection, accessing system users, and finding entity directories. It handles\n * the TypeORM DataSource lifecycle and MemberJunction provider initialization.\n */\n\nimport { DataSource } from 'typeorm';\nimport { SQLServerDataProvider, SQLServerProviderConfigData, UserCache, setupSQLServerClient } from '@memberjunction/sqlserver-dataprovider';\nimport type { MJConfig } from '../config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { UserInfo } from '@memberjunction/core';\nimport { configManager } from './config-manager';\n\n/** Global DataSource instance for connection lifecycle management */\nlet globalDataSource: DataSource | null = null;\n\n/** Global provider instance to ensure single initialization */\nlet globalProvider: SQLServerDataProvider | null = null;\n\n/** Promise to track ongoing initialization */\nlet initializationPromise: Promise<SQLServerDataProvider> | null = null;\n\n/**\n * Initialize a SQLServerDataProvider with the given configuration\n * \n * Creates and initializes a TypeORM DataSource for SQL Server, then sets up\n * the MemberJunction SQLServerDataProvider. The connection is stored globally\n * for proper cleanup. Auto-detects Azure SQL databases for encryption settings.\n * \n * @param config - MemberJunction configuration with database connection details\n * @returns Promise resolving to initialized SQLServerDataProvider instance\n * @throws Error if database connection fails\n * \n * @example\n * ```typescript\n * const config = loadMJConfig();\n * const provider = await initializeProvider(config);\n * // Provider is ready for use\n * ```\n */\nexport async function initializeProvider(config: MJConfig): Promise<SQLServerDataProvider> {\n  // Return existing provider if already initialized\n  if (globalProvider) {\n    return globalProvider;\n  }\n  \n  // Return ongoing initialization if in progress\n  if (initializationPromise) {\n    return initializationPromise;\n  }\n  \n  // Start new initialization\n  initializationPromise = (async () => {\n    // Create TypeORM DataSource\n    const dataSource = new DataSource({\n      type: 'mssql',\n      host: config.dbHost,\n      port: config.dbPort ? Number(config.dbPort) : 1433,\n      database: config.dbDatabase,\n      username: config.dbUsername,\n      password: config.dbPassword,\n      synchronize: false,\n      logging: false,\n      options: {\n        encrypt: config.dbEncrypt === 'Y' || config.dbEncrypt === 'true' || \n                 config.dbHost.includes('.database.windows.net'), // Auto-detect Azure SQL\n        trustServerCertificate: config.dbTrustServerCertificate === 'Y',\n        instanceName: config.dbInstanceName\n      }\n    });\n    \n    // Initialize the data source\n    await dataSource.initialize();\n    \n    // Store for cleanup\n    globalDataSource = dataSource;\n    \n    // Create provider config\n    const providerConfig = new SQLServerProviderConfigData(\n      dataSource,\n      'system@sync.cli', // Default user for CLI\n      config.mjCoreSchema || '__mj',\n      0\n    );\n    \n    // Use setupSQLServerClient to properly initialize\n    globalProvider = await setupSQLServerClient(providerConfig);\n    return globalProvider;\n  })();\n  \n  return initializationPromise;\n}\n\n/**\n * Clean up the global database connection\n * \n * Destroys the TypeORM DataSource if it exists and is initialized.\n * Should be called when the CLI command completes to ensure proper cleanup.\n * \n * @returns Promise that resolves when cleanup is complete\n * \n * @example\n * ```typescript\n * try {\n *   // Do work with database\n * } finally {\n *   await cleanupProvider();\n * }\n * ```\n */\nexport async function cleanupProvider(): Promise<void> {\n  if (globalDataSource && globalDataSource.isInitialized) {\n    await globalDataSource.destroy();\n    globalDataSource = null;\n  }\n  globalProvider = null;\n  initializationPromise = null;\n}\n\n/**\n * Get the system user from the UserCache\n * \n * Retrieves the \"System\" user from MemberJunction's UserCache. This user is\n * typically used for CLI operations where no specific user context exists.\n * \n * @returns The System UserInfo object\n * @throws Error if System user is not found in the cache\n * \n * @example\n * ```typescript\n * const systemUser = getSystemUser();\n * const syncEngine = new SyncEngine(systemUser);\n * ```\n */\nexport function getSystemUser(): UserInfo {\n  const sysUser = UserCache.Instance.UserByName(\"System\", false);\n  if (!sysUser) {\n    throw new Error(\"System user not found in cache. Ensure the system user exists in the database.\");    \n  }\n  return sysUser;\n}\n\n/**\n * Find entity directories at the immediate level only\n * \n * Searches for directories containing .mj-sync.json files, which indicate\n * entity data directories. Only searches immediate subdirectories, not recursive.\n * If a specific directory is provided, only checks that directory.\n * \n * @param dir - Base directory to search from\n * @param specificDir - Optional specific subdirectory name to check\n * @returns Array of absolute directory paths containing .mj-sync.json files\n * \n * @example\n * ```typescript\n * // Find all entity directories\n * const dirs = findEntityDirectories(process.cwd());\n * \n * // Check specific directory\n * const dirs = findEntityDirectories(process.cwd(), 'ai-prompts');\n * ```\n */\nexport function findEntityDirectories(dir: string, specificDir?: string): string[] {\n  const results: string[] = [];\n  \n  // If specific directory is provided, check if it's an entity directory\n  if (specificDir) {\n    const targetDir = path.isAbsolute(specificDir) ? specificDir : path.join(dir, specificDir);\n    if (fs.existsSync(targetDir)) {\n      const hasSyncConfig = fs.existsSync(path.join(targetDir, '.mj-sync.json'));\n      if (hasSyncConfig) {\n        results.push(targetDir);\n      }\n    }\n    return results;\n  }\n  \n  // Otherwise, find all immediate subdirectories with .mj-sync.json\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n  \n  for (const entry of entries) {\n    if (entry.isDirectory() && !entry.name.startsWith('.')) {\n      const subDir = path.join(dir, entry.name);\n      const hasSyncConfig = fs.existsSync(path.join(subDir, '.mj-sync.json'));\n      \n      if (hasSyncConfig) {\n        results.push(subDir);\n      }\n    }\n  }\n  \n  return results;\n}"]}

package/dist/lib/singleton-manager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Singleton manager for shared instances across MetadataSync
+ * @module singleton-manager
+ *
+ * This module ensures that expensive resources like SyncEngine are only
+ * initialized once per process, preventing duplicate metadata refreshes
+ * and improving performance.
+ */
+import { SyncEngine } from './sync-engine';
+import { UserInfo } from '@memberjunction/core';
+/**
+ * Get or create a singleton SyncEngine instance
+ *
+ * Ensures that only one SyncEngine is created and initialized per process,
+ * preventing duplicate metadata refreshes that cause the double GetAllMetadata()
+ * console output.
+ *
+ * @param contextUser - The user context for database operations
+ * @returns Promise resolving to initialized SyncEngine instance
+ *
+ * @example
+ * ```typescript
+ * const syncEngine = await getSyncEngine(getSystemUser());
+ * // Use syncEngine for operations
+ * ```
+ */
+export declare function getSyncEngine(contextUser: UserInfo): Promise<SyncEngine>;
+/**
+ * Reset the singleton SyncEngine instance
+ *
+ * Should be called when cleaning up resources to ensure a fresh
+ * instance is created on the next request.
+ */
+export declare function resetSyncEngine(): void;

package/dist/lib/singleton-manager.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * @fileoverview Singleton manager for shared instances across MetadataSync
+ * @module singleton-manager
+ *
+ * This module ensures that expensive resources like SyncEngine are only
+ * initialized once per process, preventing duplicate metadata refreshes
+ * and improving performance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetSyncEngine = exports.getSyncEngine = void 0;
+const sync_engine_1 = require("./sync-engine");
+/** Global SyncEngine instance */
+let globalSyncEngine = null;
+/** Promise to track ongoing SyncEngine initialization */
+let syncEngineInitPromise = null;
+/**
+ * Get or create a singleton SyncEngine instance
+ *
+ * Ensures that only one SyncEngine is created and initialized per process,
+ * preventing duplicate metadata refreshes that cause the double GetAllMetadata()
+ * console output.
+ *
+ * @param contextUser - The user context for database operations
+ * @returns Promise resolving to initialized SyncEngine instance
+ *
+ * @example
+ * ```typescript
+ * const syncEngine = await getSyncEngine(getSystemUser());
+ * // Use syncEngine for operations
+ * ```
+ */
+async function getSyncEngine(contextUser) {
+    // Return existing engine if already initialized
+    if (globalSyncEngine) {
+        return globalSyncEngine;
+    }
+    // Return ongoing initialization if in progress
+    if (syncEngineInitPromise) {
+        return syncEngineInitPromise;
+    }
+    // Start new initialization
+    syncEngineInitPromise = (async () => {
+        globalSyncEngine = new sync_engine_1.SyncEngine(contextUser);
+        await globalSyncEngine.initialize();
+        return globalSyncEngine;
+    })();
+    return syncEngineInitPromise;
+}
+exports.getSyncEngine = getSyncEngine;
+/**
+ * Reset the singleton SyncEngine instance
+ *
+ * Should be called when cleaning up resources to ensure a fresh
+ * instance is created on the next request.
+ */
+function resetSyncEngine() {
+    globalSyncEngine = null;
+    syncEngineInitPromise = null;
+}
+exports.resetSyncEngine = resetSyncEngine;
+//# sourceMappingURL=singleton-manager.js.map

package/dist/lib/singleton-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton-manager.js","sourceRoot":"","sources":["../../src/lib/singleton-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,+CAA2C;AAG3C,iCAAiC;AACjC,IAAI,gBAAgB,GAAsB,IAAI,CAAC;AAE/C,yDAAyD;AACzD,IAAI,qBAAqB,GAA+B,IAAI,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,aAAa,CAAC,WAAqB;IACvD,gDAAgD;IAChD,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,+CAA+C;IAC/C,IAAI,qBAAqB,EAAE,CAAC;QAC1B,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,2BAA2B;IAC3B,qBAAqB,GAAG,CAAC,KAAK,IAAI,EAAE;QAClC,gBAAgB,GAAG,IAAI,wBAAU,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,gBAAgB,CAAC,UAAU,EAAE,CAAC;QACpC,OAAO,gBAAgB,CAAC;IAC1B,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAnBD,sCAmBC;AAED;;;;;GAKG;AACH,SAAgB,eAAe;IAC7B,gBAAgB,GAAG,IAAI,CAAC;IACxB,qBAAqB,GAAG,IAAI,CAAC;AAC/B,CAAC;AAHD,0CAGC","sourcesContent":["/**\n * @fileoverview Singleton manager for shared instances across MetadataSync\n * @module singleton-manager\n * \n * This module ensures that expensive resources like SyncEngine are only\n * initialized once per process, preventing duplicate metadata refreshes\n * and improving performance.\n */\n\nimport { SyncEngine } from './sync-engine';\nimport { UserInfo } from '@memberjunction/core';\n\n/** Global SyncEngine instance */\nlet globalSyncEngine: SyncEngine | null = null;\n\n/** Promise to track ongoing SyncEngine initialization */\nlet syncEngineInitPromise: Promise<SyncEngine> | null = null;\n\n/**\n * Get or create a singleton SyncEngine instance\n * \n * Ensures that only one SyncEngine is created and initialized per process,\n * preventing duplicate metadata refreshes that cause the double GetAllMetadata()\n * console output.\n * \n * @param contextUser - The user context for database operations\n * @returns Promise resolving to initialized SyncEngine instance\n * \n * @example\n * ```typescript\n * const syncEngine = await getSyncEngine(getSystemUser());\n * // Use syncEngine for operations\n * ```\n */\nexport async function getSyncEngine(contextUser: UserInfo): Promise<SyncEngine> {\n  // Return existing engine if already initialized\n  if (globalSyncEngine) {\n    return globalSyncEngine;\n  }\n  \n  // Return ongoing initialization if in progress\n  if (syncEngineInitPromise) {\n    return syncEngineInitPromise;\n  }\n  \n  // Start new initialization\n  syncEngineInitPromise = (async () => {\n    globalSyncEngine = new SyncEngine(contextUser);\n    await globalSyncEngine.initialize();\n    return globalSyncEngine;\n  })();\n  \n  return syncEngineInitPromise;\n}\n\n/**\n * Reset the singleton SyncEngine instance\n * \n * Should be called when cleaning up resources to ensure a fresh\n * instance is created on the next request.\n */\nexport function resetSyncEngine(): void {\n  globalSyncEngine = null;\n  syncEngineInitPromise = null;\n}"]}