@memberjunction/metadata-sync 2.112.0 → 2.113.0

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":["/**\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 mssql ConnectionPool lifecycle and MemberJunction provider initialization.\n */\n\nimport * as sql from 'mssql';\nimport {\n  SQLServerDataProvider,\n  SQLServerProviderConfigData,\n  UserCache,\n  setupSQLServerClient,\n} from '@memberjunction/sqlserver-dataprovider';\nimport type { MJConfig } from '../config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { DatabaseProviderBase, UserInfo } from '@memberjunction/global';\n\n/** Global ConnectionPool instance for connection lifecycle management */\nlet globalPool: sql.ConnectionPool | 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 mssql ConnectionPool 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 mssql config\n    const poolConfig: sql.config = {\n      server: config.dbHost,\n      port: config.dbPort ? Number(config.dbPort) : 1433,\n      database: config.dbDatabase,\n      user: config.dbUsername,\n      password: config.dbPassword,\n      options: {\n        encrypt: config.dbEncrypt === 'Y' || config.dbEncrypt === 'true' || config.dbHost.includes('.database.windows.net'), // Auto-detect Azure SQL\n        trustServerCertificate: config.dbTrustServerCertificate === 'Y',\n        instanceName: config.dbInstanceName,\n        enableArithAbort: true,\n      },\n    };\n\n    // Create and connect pool\n    const pool = new sql.ConnectionPool(poolConfig);\n    await pool.connect();\n\n    // Store for cleanup\n    globalPool = pool;\n\n    // Create provider config\n    const providerConfig = new SQLServerProviderConfigData(pool, config.mjCoreSchema || '__mj');\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 * Closes the mssql ConnectionPool if it exists and is connected.\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 (globalPool && globalPool.connected) {\n    await globalPool.close();\n    globalPool = 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 * The System user must have the Developer role to perform metadata sync operations.\n *\n * @returns The System UserInfo object\n * @throws Error if System user is not found in the cache or doesn't have Developer role\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\n  // Check if the System user has the Developer role\n  const hasDeveloperRole = sysUser.UserRoles && sysUser.UserRoles.some((userRole) => userRole.Role.trim().toLowerCase() === 'developer');\n\n  if (!hasDeveloperRole) {\n    throw new Error(\n      \"System user does not have the 'Developer' role. \" +\n        'The Developer role is required for metadata sync operations. ' +\n        'Please ensure the System user is assigned the Developer role in the database:\\n' +\n        '* Add a record to the __mj.UserRole table linking the System user to the Developer role'\n    );\n  }\n\n  return sysUser;\n}\n\n/**\n * Get the current data provider instance\n *\n * Returns the global SQLServerDataProvider instance that was initialized by\n * initializeProvider. This allows access to data provider features like SQL logging.\n *\n * @returns The global SQLServerDataProvider instance or null if not initialized\n *\n * @example\n * ```typescript\n * const provider = getDataProvider();\n * if (provider?.CreateSqlLogger) {\n *   const logger = await provider.CreateSqlLogger('/path/to/log.sql');\n * }\n * ```\n */\nexport function getDataProvider(): DatabaseProviderBase | null {\n  return globalProvider;\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 * @param directoryOrder - Optional array specifying the order directories should be processed\n * @param ignoreDirectories - Optional array of directory patterns to ignore\n * @returns Array of absolute directory paths containing .mj-sync.json files, ordered according to directoryOrder\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 * // Find directories with custom ordering\n * const dirs = findEntityDirectories(process.cwd(), undefined, ['prompts', 'agent-types']);\n * ```\n */\nexport function findEntityDirectories(\n  dir: string,\n  specificDir?: string,\n  directoryOrder?: string[],\n  ignoreDirectories?: string[]\n): string[] {\n  const results: string[] = [];\n\n  // If specific directory is provided, check if it's an entity directory or root config directory\n  if (specificDir) {\n    const targetDir = path.isAbsolute(specificDir) ? specificDir : path.join(dir, specificDir);\n    if (fs.existsSync(targetDir)) {\n      const syncConfigPath = path.join(targetDir, '.mj-sync.json');\n      const hasSyncConfig = fs.existsSync(syncConfigPath);\n\n      if (hasSyncConfig) {\n        try {\n          const config = JSON.parse(fs.readFileSync(syncConfigPath, 'utf8'));\n\n          // If this config has an entity field, it's an entity directory\n          if (config.entity) {\n            results.push(targetDir);\n            return results;\n          }\n\n          // If this config has directoryOrder but no entity, treat it as a root config\n          // and look for entity directories in its subdirectories\n          if (config.directoryOrder) {\n            // Merge ignore directories from parent with current config\n            const mergedIgnoreDirectories = [...(ignoreDirectories || []), ...(config.ignoreDirectories || [])];\n            return findEntityDirectories(targetDir, undefined, config.directoryOrder, mergedIgnoreDirectories);\n          }\n        } catch (error) {\n          // If we can't parse the config, treat it as a regular directory\n        }\n      }\n\n      // Fallback: look for entity subdirectories in the target directory\n      return findEntityDirectories(targetDir, undefined, directoryOrder, ignoreDirectories);\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  const foundDirectories: string[] = [];\n\n  for (const entry of entries) {\n    if (entry.isDirectory() && !entry.name.startsWith('.')) {\n      // Check if this directory should be ignored\n      if (\n        ignoreDirectories &&\n        ignoreDirectories.some((pattern) => {\n          // Simple pattern matching: exact name or ends with pattern\n          return entry.name === pattern || entry.name.endsWith(pattern);\n        })\n      ) {\n        continue;\n      }\n\n      const subDir = path.join(dir, entry.name);\n      const hasSyncConfig = fs.existsSync(path.join(subDir, '.mj-sync.json'));\n\n      if (hasSyncConfig) {\n        foundDirectories.push(subDir);\n      }\n    }\n  }\n\n  // If directoryOrder is specified, sort directories according to it\n  if (directoryOrder && directoryOrder.length > 0) {\n    const orderedDirs: string[] = [];\n    const unorderedDirs: string[] = [];\n\n    // First, add directories in the specified order\n    for (const dirName of directoryOrder) {\n      const matchingDir = foundDirectories.find((fullPath) => path.basename(fullPath) === dirName);\n      if (matchingDir) {\n        orderedDirs.push(matchingDir);\n      }\n    }\n\n    // Then, add any remaining directories in alphabetical order\n    for (const foundDir of foundDirectories) {\n      const dirName = path.basename(foundDir);\n      if (!directoryOrder.includes(dirName)) {\n        unorderedDirs.push(foundDir);\n      }\n    }\n\n    // Sort unordered directories alphabetically\n    unorderedDirs.sort((a, b) => path.basename(a).localeCompare(path.basename(b)));\n\n    return [...orderedDirs, ...unorderedDirs];\n  }\n\n  // No ordering specified, return in alphabetical order (existing behavior)\n  return foundDirectories.sort((a, b) => path.basename(a).localeCompare(path.basename(b)));\n}\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 mssql ConnectionPool lifecycle and MemberJunction provider initialization.\n */\n\nimport * as sql from 'mssql';\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 { DatabaseProviderBase, UserInfo } from '@memberjunction/core';\n\n/** Global ConnectionPool instance for connection lifecycle management */\nlet globalPool: sql.ConnectionPool | 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 mssql ConnectionPool 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 mssql config\n    const poolConfig: sql.config = {\n      server: config.dbHost,\n      port: config.dbPort ? Number(config.dbPort) : 1433,\n      database: config.dbDatabase,\n      user: config.dbUsername,\n      password: config.dbPassword,\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        enableArithAbort: true\n      }\n    };\n    \n    // Create and connect pool\n    const pool = new sql.ConnectionPool(poolConfig);\n    await pool.connect();\n    \n    // Store for cleanup\n    globalPool = pool;\n    \n    // Create provider config\n    const providerConfig = new SQLServerProviderConfigData(\n      pool,\n      config.mjCoreSchema || '__mj' \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 * Closes the mssql ConnectionPool if it exists and is connected.\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 (globalPool && globalPool.connected) {\n    await globalPool.close();\n    globalPool = 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 * The System user must have the Developer role to perform metadata sync operations.\n * \n * @returns The System UserInfo object\n * @throws Error if System user is not found in the cache or doesn't have Developer role\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  \n  // Check if the System user has the Developer role\n  const hasDeveloperRole = sysUser.UserRoles && sysUser.UserRoles.some(\n    userRole => userRole.Role.trim().toLowerCase() === 'developer'\n  );\n  \n  if (!hasDeveloperRole) {\n    throw new Error(\n      \"System user does not have the 'Developer' role. \" +\n      \"The Developer role is required for metadata sync operations. \" +\n      \"Please ensure the System user is assigned the Developer role in the database:\\n\" +\n      \"* Add a record to the __mj.UserRole table linking the System user to the Developer role\"\n    );\n  }\n  \n  return sysUser;\n}\n\n/**\n * Get the current data provider instance\n * \n * Returns the global SQLServerDataProvider instance that was initialized by\n * initializeProvider. This allows access to data provider features like SQL logging.\n * \n * @returns The global SQLServerDataProvider instance or null if not initialized\n * \n * @example\n * ```typescript\n * const provider = getDataProvider();\n * if (provider?.CreateSqlLogger) {\n *   const logger = await provider.CreateSqlLogger('/path/to/log.sql');\n * }\n * ```\n */\nexport function getDataProvider(): DatabaseProviderBase | null {\n  return globalProvider;\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 * @param directoryOrder - Optional array specifying the order directories should be processed\n * @param ignoreDirectories - Optional array of directory patterns to ignore\n * @returns Array of absolute directory paths containing .mj-sync.json files, ordered according to directoryOrder\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 * // Find directories with custom ordering\n * const dirs = findEntityDirectories(process.cwd(), undefined, ['prompts', 'agent-types']);\n * ```\n */\nexport function findEntityDirectories(dir: string, specificDir?: string, directoryOrder?: string[], ignoreDirectories?: string[]): string[] {\n  const results: string[] = [];\n  \n  // If specific directory is provided, check if it's an entity directory or root config directory\n  if (specificDir) {\n    const targetDir = path.isAbsolute(specificDir) ? specificDir : path.join(dir, specificDir);\n    if (fs.existsSync(targetDir)) {\n      const syncConfigPath = path.join(targetDir, '.mj-sync.json');\n      const hasSyncConfig = fs.existsSync(syncConfigPath);\n      \n      if (hasSyncConfig) {\n        try {\n          const config = JSON.parse(fs.readFileSync(syncConfigPath, 'utf8'));\n          \n          // If this config has an entity field, it's an entity directory\n          if (config.entity) {\n            results.push(targetDir);\n            return results;\n          }\n          \n          // If this config has directoryOrder but no entity, treat it as a root config\n          // and look for entity directories in its subdirectories\n          if (config.directoryOrder) {\n            // Merge ignore directories from parent with current config\n            const mergedIgnoreDirectories = [\n              ...(ignoreDirectories || []),\n              ...(config.ignoreDirectories || [])\n            ];\n            return findEntityDirectories(targetDir, undefined, config.directoryOrder, mergedIgnoreDirectories);\n          }\n        } catch (error) {\n          // If we can't parse the config, treat it as a regular directory\n        }\n      }\n      \n      // Fallback: look for entity subdirectories in the target directory\n      return findEntityDirectories(targetDir, undefined, directoryOrder, ignoreDirectories);\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  const foundDirectories: string[] = [];\n  \n  for (const entry of entries) {\n    if (entry.isDirectory() && !entry.name.startsWith('.')) {\n      // Check if this directory should be ignored\n      if (ignoreDirectories && ignoreDirectories.some(pattern => {\n        // Simple pattern matching: exact name or ends with pattern\n        return entry.name === pattern || entry.name.endsWith(pattern);\n      })) {\n        continue;\n      }\n      \n      const subDir = path.join(dir, entry.name);\n      const hasSyncConfig = fs.existsSync(path.join(subDir, '.mj-sync.json'));\n      \n      if (hasSyncConfig) {\n        foundDirectories.push(subDir);\n      }\n    }\n  }\n  \n  // If directoryOrder is specified, sort directories according to it\n  if (directoryOrder && directoryOrder.length > 0) {\n    const orderedDirs: string[] = [];\n    const unorderedDirs: string[] = [];\n    \n    // First, add directories in the specified order\n    for (const dirName of directoryOrder) {\n      const matchingDir = foundDirectories.find(fullPath => \n        path.basename(fullPath) === dirName\n      );\n      if (matchingDir) {\n        orderedDirs.push(matchingDir);\n      }\n    }\n    \n    // Then, add any remaining directories in alphabetical order\n    for (const foundDir of foundDirectories) {\n      const dirName = path.basename(foundDir);\n      if (!directoryOrder.includes(dirName)) {\n        unorderedDirs.push(foundDir);\n      }\n    }\n    \n    // Sort unordered directories alphabetically\n    unorderedDirs.sort((a, b) => path.basename(a).localeCompare(path.basename(b)));\n    \n    return [...orderedDirs, ...unorderedDirs];\n  }\n  \n  // No ordering specified, return in alphabetical order (existing behavior)\n  return foundDirectories.sort((a, b) => path.basename(a).localeCompare(path.basename(b)));\n}"]}

package/dist/lib/record-dependency-analyzer.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RecordDependencyAnalyzer = void 0;
-const global_1 = require("@memberjunction/global");
+const core_1 = require("@memberjunction/core");
+const metadata_keywords_1 = require("../constants/metadata-keywords");
 /**
  * Analyzes and sorts records based on their dependencies
  */
@@ -12,7 +13,7 @@ class RecordDependencyAnalyzer {
     entityInfoCache = new Map();
     recordCounter = 0;
     constructor() {
-        this.metadata = new global_1.Metadata();
+        this.metadata = new core_1.Metadata();
     }
     /**
      * Main entry point: analyzes all records in a file and returns them in dependency order
@@ -41,7 +42,7 @@ class RecordDependencyAnalyzer {
             sortedRecords,
             circularDependencies: circularDeps,
             dependencyGraph,
-            dependencyLevels,
+            dependencyLevels
         };
     }
     /**
@@ -60,7 +61,7 @@ class RecordDependencyAnalyzer {
                 path,
                 dependencies: new Set(),
                 id: recordId,
-                originalIndex: i,
+                originalIndex: i
             };
             // If this has a parent, add dependency on the parent
             if (parentRecordId) {
@@ -74,7 +75,7 @@ class RecordDependencyAnalyzer {
                     this.flattenRecords(relatedRecords, relatedEntityName, {
                         entityName,
                         record,
-                        recordIndex: i,
+                        recordIndex: i
                     }, depth + 1, path, recordId // Pass current record ID as parent for children
                     );
                 }
@@ -95,14 +96,14 @@ class RecordDependencyAnalyzer {
                 for (const [fieldName, fieldValue] of Object.entries(record.record.fields)) {
                     if (typeof fieldValue === 'string') {
                         // Handle @lookup references
-                        if (fieldValue.startsWith('@lookup:')) {
+                        if (fieldValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.LOOKUP)) {
                             const dependency = this.findLookupDependency(fieldValue, record);
                             if (dependency) {
                                 record.dependencies.add(dependency);
                             }
                         }
                         // Handle @root references - these create dependencies on the root record
-                        else if (fieldValue.startsWith('@root:')) {
+                        else if (fieldValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.ROOT)) {
                             const rootDependency = this.findRootDependency(record);
                             if (rootDependency) {
                                 record.dependencies.add(rootDependency);
@@ -166,7 +167,7 @@ class RecordDependencyAnalyzer {
                 let resolvedValue = value.trim();
                 // Special handling for nested @lookup references in lookup criteria
                 // This creates a dependency on the looked-up record
-                if (resolvedValue.startsWith('@lookup:')) {
+                if (resolvedValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.LOOKUP)) {
                     const nestedDependency = this.findLookupDependency(resolvedValue, currentRecord);
                     if (nestedDependency) {
                         // Add this as a dependency of the current record
@@ -176,7 +177,7 @@ class RecordDependencyAnalyzer {
                     }
                 }
                 // Special handling for @root references in lookup criteria
-                else if (resolvedValue.startsWith('@root:')) {
+                else if (resolvedValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.ROOT)) {
                     // Add dependency on root record
                     const rootDep = this.findRootDependency(currentRecord);
                     if (rootDep) {
@@ -186,17 +187,19 @@ class RecordDependencyAnalyzer {
                 }
                 // Special handling for @parent references in lookup criteria
                 // If the value is @parent:field, we need to resolve it from the parent context
-                else if (resolvedValue.startsWith('@parent:') && currentRecord.parentContext) {
-                    const parentField = resolvedValue.substring(8);
+                else if (resolvedValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {
+                    const parentField = resolvedValue.substring(metadata_keywords_1.METADATA_KEYWORDS.PARENT.length);
                     // Try to resolve from parent context
-                    const parentValue = currentRecord.parentContext.record.fields?.[parentField] || currentRecord.parentContext.record.primaryKey?.[parentField];
+                    const parentValue = currentRecord.parentContext.record.fields?.[parentField] ||
+                        currentRecord.parentContext.record.primaryKey?.[parentField];
                     if (parentValue && typeof parentValue === 'string') {
                         // Check if parent value is also a @parent reference (nested parent refs)
-                        if (parentValue.startsWith('@parent:')) {
+                        if (parentValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT)) {
                             // Find the parent record to get its parent context
-                            const parentRecord = this.flattenedRecords.find((r) => r.record === currentRecord.parentContext.record && r.entityName === currentRecord.parentContext.entityName);
+                            const parentRecord = this.flattenedRecords.find(r => r.record === currentRecord.parentContext.record &&
+                                r.entityName === currentRecord.parentContext.entityName);
                             if (parentRecord && parentRecord.parentContext) {
-                                const grandParentField = parentValue.substring(8);
+                                const grandParentField = parentValue.substring(metadata_keywords_1.METADATA_KEYWORDS.PARENT.length);
                                 const grandParentValue = parentRecord.parentContext.record.fields?.[grandParentField] ||
                                     parentRecord.parentContext.record.primaryKey?.[grandParentField];
                                 if (grandParentValue && typeof grandParentValue === 'string' && !grandParentValue.startsWith('@')) {
@@ -221,47 +224,49 @@ class RecordDependencyAnalyzer {
             // Check if all criteria match
             let allMatch = true;
             for (const [field, value] of criteriaMap) {
-                let candidateValue = candidate.record.fields?.[field] || candidate.record.primaryKey?.[field];
+                let candidateValue = candidate.record.fields?.[field] ||
+                    candidate.record.primaryKey?.[field];
                 let lookupValue = value;
                 // Resolve candidate value if it's a @parent reference
-                if (typeof candidateValue === 'string' && candidateValue.startsWith('@parent:') && candidate.parentContext) {
-                    const parentField = candidateValue.substring(8);
+                if (typeof candidateValue === 'string' && candidateValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT) && candidate.parentContext) {
+                    const parentField = candidateValue.substring(metadata_keywords_1.METADATA_KEYWORDS.PARENT.length);
                     const parentRecord = candidate.parentContext.record;
                     candidateValue = parentRecord.fields?.[parentField] || parentRecord.primaryKey?.[parentField];
                     // If the parent field is also a @parent reference, resolve it recursively
-                    if (typeof candidateValue === 'string' && candidateValue.startsWith('@parent:')) {
+                    if (typeof candidateValue === 'string' && candidateValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT)) {
                         // Find the candidate's parent in our flattened list
-                        const candidateParent = this.flattenedRecords.find((r) => r.record === candidate.parentContext.record && r.entityName === candidate.parentContext.entityName);
+                        const candidateParent = this.flattenedRecords.find(r => r.record === candidate.parentContext.record &&
+                            r.entityName === candidate.parentContext.entityName);
                         if (candidateParent?.parentContext) {
                             const grandParentField = candidateValue.substring(8);
-                            candidateValue =
-                                candidateParent.parentContext.record.fields?.[grandParentField] ||
-                                    candidateParent.parentContext.record.primaryKey?.[grandParentField];
+                            candidateValue = candidateParent.parentContext.record.fields?.[grandParentField] ||
+                                candidateParent.parentContext.record.primaryKey?.[grandParentField];
                         }
                     }
                 }
                 // Resolve lookup value if it contains @parent reference
-                if (typeof lookupValue === 'string' && lookupValue.includes('@parent:')) {
+                if (typeof lookupValue === 'string' && lookupValue.includes(metadata_keywords_1.METADATA_KEYWORDS.PARENT)) {
                     // Handle cases like "@parent:AgentID" or embedded references
-                    if (lookupValue.startsWith('@parent:') && currentRecord.parentContext) {
-                        const parentField = lookupValue.substring(8);
-                        lookupValue =
-                            currentRecord.parentContext.record.fields?.[parentField] || currentRecord.parentContext.record.primaryKey?.[parentField];
+                    if (lookupValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {
+                        const parentField = lookupValue.substring(metadata_keywords_1.METADATA_KEYWORDS.PARENT.length);
+                        lookupValue = currentRecord.parentContext.record.fields?.[parentField] ||
+                            currentRecord.parentContext.record.primaryKey?.[parentField];
                         // If still a reference, try to resolve from the parent's parent
-                        if (typeof lookupValue === 'string' && lookupValue.startsWith('@parent:')) {
-                            const currentParent = this.flattenedRecords.find((r) => r.record === currentRecord.parentContext.record && r.entityName === currentRecord.parentContext.entityName);
+                        if (typeof lookupValue === 'string' && lookupValue.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT)) {
+                            const currentParent = this.flattenedRecords.find(r => r.record === currentRecord.parentContext.record &&
+                                r.entityName === currentRecord.parentContext.entityName);
                             if (currentParent?.parentContext) {
-                                const grandParentField = lookupValue.substring(8);
-                                lookupValue =
-                                    currentParent.parentContext.record.fields?.[grandParentField] ||
-                                        currentParent.parentContext.record.primaryKey?.[grandParentField];
+                                const grandParentField = lookupValue.substring(metadata_keywords_1.METADATA_KEYWORDS.PARENT.length);
+                                lookupValue = currentParent.parentContext.record.fields?.[grandParentField] ||
+                                    currentParent.parentContext.record.primaryKey?.[grandParentField];
                             }
                         }
                     }
                 }
                 // Special case: if both values are @parent references pointing to the same parent field,
                 // and they have the same parent context, they match
-                if (value.startsWith('@parent:') && candidateValue === value && currentRecord.parentContext && candidate.parentContext) {
+                if (value.startsWith(metadata_keywords_1.METADATA_KEYWORDS.PARENT) && candidateValue === value &&
+                    currentRecord.parentContext && candidate.parentContext) {
                     // Check if they share the same parent
                     if (currentRecord.parentContext.record === candidate.parentContext.record) {
                         // Same parent, same reference - they will resolve to the same value
@@ -291,7 +296,8 @@ class RecordDependencyAnalyzer {
         let current = record;
         while (current.parentContext) {
             // Try to find the parent record in our flattened list
-            const parentRecord = this.flattenedRecords.find((r) => r.record === current.parentContext.record && r.entityName === current.parentContext.entityName);
+            const parentRecord = this.flattenedRecords.find(r => r.record === current.parentContext.record &&
+                r.entityName === current.parentContext.entityName);
             if (!parentRecord) {
                 // Parent not found, something is wrong
                 return null;
@@ -315,7 +321,8 @@ class RecordDependencyAnalyzer {
         for (const candidate of this.flattenedRecords) {
             if (candidate.entityName !== entityName)
                 continue;
-            const candidateValue = candidate.record.primaryKey?.[primaryKeyField] || candidate.record.fields?.[primaryKeyField];
+            const candidateValue = candidate.record.primaryKey?.[primaryKeyField] ||
+                candidate.record.fields?.[primaryKeyField];
             if (candidateValue === primaryKeyValue) {
                 return candidate.id;
             }

package/dist/lib/record-dependency-analyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-dependency-analyzer.js","sourceRoot":"","sources":["../../src/lib/record-dependency-analyzer.ts"],"names":[],"mappings":"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","sourcesContent":["import { Metadata, EntityInfo } from '@memberjunction/global';\nimport { RecordData } from './sync-engine';\n\n/**\n * Represents a flattened record with its context and dependencies\n */\nexport interface FlattenedRecord {\n  record: RecordData;\n  entityName: string;\n  parentContext?: {\n    entityName: string;\n    record: RecordData;\n    recordIndex: number;\n  };\n  depth: number;\n  path: string; // Path to this record for debugging\n  dependencies: Set<string>; // Set of record IDs this record depends on\n  id: string; // Unique identifier for this record in the flattened list\n  originalIndex: number; // Original index in the source array\n}\n\n/**\n * Result of dependency analysis\n */\nexport interface DependencyAnalysisResult {\n  sortedRecords: FlattenedRecord[];\n  circularDependencies: string[][];\n  dependencyGraph: Map<string, Set<string>>;\n  dependencyLevels?: FlattenedRecord[][]; // Records grouped by dependency level for parallel processing\n}\n\n/**\n * Analyzes and sorts records based on their dependencies\n */\nexport class RecordDependencyAnalyzer {\n  private metadata: Metadata;\n  private flattenedRecords: FlattenedRecord[] = [];\n  private recordIdMap: Map<string, FlattenedRecord> = new Map();\n  private entityInfoCache: Map<string, EntityInfo> = new Map();\n  private recordCounter: number = 0;\n\n  constructor() {\n    this.metadata = new Metadata();\n  }\n\n  /**\n   * Main entry point: analyzes all records in a file and returns them in dependency order\n   */\n  public async analyzeFileRecords(records: RecordData[], entityName: string): Promise<DependencyAnalysisResult> {\n    // Reset state\n    this.flattenedRecords = [];\n    this.recordIdMap.clear();\n    this.recordCounter = 0;\n\n    // Step 1: Flatten all records (including nested relatedEntities)\n    this.flattenRecords(records, entityName);\n\n    // Step 2: Analyze dependencies between all flattened records\n    this.analyzeDependencies();\n\n    // Step 3: Detect circular dependencies\n    const circularDeps = this.detectCircularDependencies();\n\n    // Step 4: Perform topological sort\n    const sortedRecords = this.topologicalSort();\n\n    // Step 5: Build dependency graph for debugging\n    const dependencyGraph = new Map<string, Set<string>>();\n    for (const record of this.flattenedRecords) {\n      dependencyGraph.set(record.id, record.dependencies);\n    }\n\n    // Step 6: Group records into dependency levels for parallel processing\n    const dependencyLevels = this.groupByDependencyLevels(sortedRecords, dependencyGraph);\n\n    return {\n      sortedRecords,\n      circularDependencies: circularDeps,\n      dependencyGraph,\n      dependencyLevels,\n    };\n  }\n\n  /**\n   * Flattens all records including nested relatedEntities\n   */\n  private flattenRecords(\n    records: RecordData[],\n    entityName: string,\n    parentContext?: FlattenedRecord['parentContext'],\n    depth: number = 0,\n    pathPrefix: string = '',\n    parentRecordId?: string\n  ): void {\n    for (let i = 0; i < records.length; i++) {\n      const record = records[i];\n      const recordId = `${entityName}_${this.recordCounter++}`;\n      const path = pathPrefix ? `${pathPrefix}/${entityName}[${i}]` : `${entityName}[${i}]`;\n\n      const flattenedRecord: FlattenedRecord = {\n        record,\n        entityName,\n        parentContext,\n        depth,\n        path,\n        dependencies: new Set(),\n        id: recordId,\n        originalIndex: i,\n      };\n\n      // If this has a parent, add dependency on the parent\n      if (parentRecordId) {\n        flattenedRecord.dependencies.add(parentRecordId);\n      }\n\n      this.flattenedRecords.push(flattenedRecord);\n      this.recordIdMap.set(recordId, flattenedRecord);\n\n      // Recursively flatten related entities\n      if (record.relatedEntities) {\n        for (const [relatedEntityName, relatedRecords] of Object.entries(record.relatedEntities)) {\n          this.flattenRecords(\n            relatedRecords,\n            relatedEntityName,\n            {\n              entityName,\n              record,\n              recordIndex: i,\n            },\n            depth + 1,\n            path,\n            recordId // Pass current record ID as parent for children\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Analyzes dependencies between all flattened records\n   */\n  private analyzeDependencies(): void {\n    for (const record of this.flattenedRecords) {\n      // Get entity info for foreign key relationships\n      const entityInfo = this.getEntityInfo(record.entityName);\n      if (!entityInfo) continue;\n\n      // Analyze field dependencies\n      if (record.record.fields) {\n        for (const [fieldName, fieldValue] of Object.entries(record.record.fields)) {\n          if (typeof fieldValue === 'string') {\n            // Handle @lookup references\n            if (fieldValue.startsWith('@lookup:')) {\n              const dependency = this.findLookupDependency(fieldValue, record);\n              if (dependency) {\n                record.dependencies.add(dependency);\n              }\n            }\n            // Handle @root references - these create dependencies on the root record\n            else if (fieldValue.startsWith('@root:')) {\n              const rootDependency = this.findRootDependency(record);\n              if (rootDependency) {\n                record.dependencies.add(rootDependency);\n              }\n            }\n            // @parent references don't create explicit dependencies in our flattened structure\n            // because parent is guaranteed to be processed before children due to the way\n            // we flatten records (parent always comes before its children)\n          }\n        }\n      }\n\n      // Check foreign key dependencies\n      this.analyzeForeignKeyDependencies(record, entityInfo);\n    }\n  }\n\n  /**\n   * Analyzes foreign key dependencies based on EntityInfo\n   */\n  private analyzeForeignKeyDependencies(record: FlattenedRecord, entityInfo: EntityInfo): void {\n    // Check all foreign key fields\n    for (const field of entityInfo.ForeignKeys) {\n      const fieldValue = record.record.fields?.[field.Name];\n      if (fieldValue && typeof fieldValue === 'string' && !fieldValue.startsWith('@')) {\n        // This is a direct foreign key value, find the referenced record\n        const relatedEntityInfo = this.getEntityInfo(field.RelatedEntity);\n        if (relatedEntityInfo) {\n          const dependency = this.findRecordByPrimaryKey(field.RelatedEntity, fieldValue, relatedEntityInfo);\n          if (dependency) {\n            record.dependencies.add(dependency);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Finds a record that matches a @lookup reference\n   */\n  private findLookupDependency(lookupValue: string, currentRecord: FlattenedRecord): string | null {\n    // Parse lookup format: @lookup:EntityName.Field=Value or @lookup:Field=Value\n    const lookupStr = lookupValue.substring(8); // Remove '@lookup:'\n\n    // Handle the ?create syntax by removing it\n    const cleanLookup = lookupStr.split('?')[0];\n\n    // Parse entity name if present\n    let targetEntity: string;\n    let criteria: string;\n\n    if (cleanLookup.includes('.')) {\n      const parts = cleanLookup.split('.');\n      targetEntity = parts[0];\n      criteria = parts.slice(1).join('.');\n    } else {\n      // Same entity if not specified\n      targetEntity = currentRecord.entityName;\n      criteria = cleanLookup;\n    }\n\n    // Parse criteria (can be multiple with &)\n    const criteriaMap = new Map<string, string>();\n    for (const pair of criteria.split('&')) {\n      const [field, value] = pair.split('=');\n      if (field && value) {\n        let resolvedValue = value.trim();\n\n        // Special handling for nested @lookup references in lookup criteria\n        // This creates a dependency on the looked-up record\n        if (resolvedValue.startsWith('@lookup:')) {\n          const nestedDependency = this.findLookupDependency(resolvedValue, currentRecord);\n          if (nestedDependency) {\n            // Add this as a dependency of the current record\n            currentRecord.dependencies.add(nestedDependency);\n            // Continue processing - we can't resolve the actual value here\n            // but we've recorded the dependency\n          }\n        }\n        // Special handling for @root references in lookup criteria\n        else if (resolvedValue.startsWith('@root:')) {\n          // Add dependency on root record\n          const rootDep = this.findRootDependency(currentRecord);\n          if (rootDep) {\n            currentRecord.dependencies.add(rootDep);\n          }\n          // Note: We can't resolve the actual value here, but we've recorded the dependency\n        }\n        // Special handling for @parent references in lookup criteria\n        // If the value is @parent:field, we need to resolve it from the parent context\n        else if (resolvedValue.startsWith('@parent:') && currentRecord.parentContext) {\n          const parentField = resolvedValue.substring(8);\n\n          // Try to resolve from parent context\n          const parentValue =\n            currentRecord.parentContext.record.fields?.[parentField] || currentRecord.parentContext.record.primaryKey?.[parentField];\n\n          if (parentValue && typeof parentValue === 'string') {\n            // Check if parent value is also a @parent reference (nested parent refs)\n            if (parentValue.startsWith('@parent:')) {\n              // Find the parent record to get its parent context\n              const parentRecord = this.flattenedRecords.find(\n                (r) => r.record === currentRecord.parentContext!.record && r.entityName === currentRecord.parentContext!.entityName\n              );\n\n              if (parentRecord && parentRecord.parentContext) {\n                const grandParentField = parentValue.substring(8);\n                const grandParentValue =\n                  parentRecord.parentContext.record.fields?.[grandParentField] ||\n                  parentRecord.parentContext.record.primaryKey?.[grandParentField];\n                if (grandParentValue && typeof grandParentValue === 'string' && !grandParentValue.startsWith('@')) {\n                  resolvedValue = grandParentValue;\n                }\n              }\n            } else if (!parentValue.startsWith('@')) {\n              resolvedValue = parentValue;\n            }\n          }\n        }\n\n        criteriaMap.set(field.trim(), resolvedValue);\n      }\n    }\n\n    // Find matching record in our flattened list\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== targetEntity) continue;\n      if (candidate.id === currentRecord.id) continue; // Skip self\n\n      // Check if all criteria match\n      let allMatch = true;\n      for (const [field, value] of criteriaMap) {\n        let candidateValue = candidate.record.fields?.[field] || candidate.record.primaryKey?.[field];\n        let lookupValue = value;\n\n        // Resolve candidate value if it's a @parent reference\n        if (typeof candidateValue === 'string' && candidateValue.startsWith('@parent:') && candidate.parentContext) {\n          const parentField = candidateValue.substring(8);\n          const parentRecord = candidate.parentContext.record;\n          candidateValue = parentRecord.fields?.[parentField] || parentRecord.primaryKey?.[parentField];\n\n          // If the parent field is also a @parent reference, resolve it recursively\n          if (typeof candidateValue === 'string' && candidateValue.startsWith('@parent:')) {\n            // Find the candidate's parent in our flattened list\n            const candidateParent = this.flattenedRecords.find(\n              (r) => r.record === candidate.parentContext!.record && r.entityName === candidate.parentContext!.entityName\n            );\n            if (candidateParent?.parentContext) {\n              const grandParentField = candidateValue.substring(8);\n              candidateValue =\n                candidateParent.parentContext.record.fields?.[grandParentField] ||\n                candidateParent.parentContext.record.primaryKey?.[grandParentField];\n            }\n          }\n        }\n\n        // Resolve lookup value if it contains @parent reference\n        if (typeof lookupValue === 'string' && lookupValue.includes('@parent:')) {\n          // Handle cases like \"@parent:AgentID\" or embedded references\n          if (lookupValue.startsWith('@parent:') && currentRecord.parentContext) {\n            const parentField = lookupValue.substring(8);\n            lookupValue =\n              currentRecord.parentContext.record.fields?.[parentField] || currentRecord.parentContext.record.primaryKey?.[parentField];\n\n            // If still a reference, try to resolve from the parent's parent\n            if (typeof lookupValue === 'string' && lookupValue.startsWith('@parent:')) {\n              const currentParent = this.flattenedRecords.find(\n                (r) => r.record === currentRecord.parentContext!.record && r.entityName === currentRecord.parentContext!.entityName\n              );\n              if (currentParent?.parentContext) {\n                const grandParentField = lookupValue.substring(8);\n                lookupValue =\n                  currentParent.parentContext.record.fields?.[grandParentField] ||\n                  currentParent.parentContext.record.primaryKey?.[grandParentField];\n              }\n            }\n          }\n        }\n\n        // Special case: if both values are @parent references pointing to the same parent field,\n        // and they have the same parent context, they match\n        if (value.startsWith('@parent:') && candidateValue === value && currentRecord.parentContext && candidate.parentContext) {\n          // Check if they share the same parent\n          if (currentRecord.parentContext.record === candidate.parentContext.record) {\n            // Same parent, same reference - they will resolve to the same value\n            continue; // This criterion matches\n          }\n        }\n\n        if (candidateValue !== lookupValue) {\n          allMatch = false;\n          break;\n        }\n      }\n\n      if (allMatch) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Finds the root record for a given record\n   */\n  private findRootDependency(record: FlattenedRecord): string | null {\n    // If this record has no parent, it IS the root, no dependency\n    if (!record.parentContext) {\n      return null;\n    }\n\n    // Walk up the parent chain to find the root\n    let current = record;\n    while (current.parentContext) {\n      // Try to find the parent record in our flattened list\n      const parentRecord = this.flattenedRecords.find(\n        (r) => r.record === current.parentContext!.record && r.entityName === current.parentContext!.entityName\n      );\n\n      if (!parentRecord) {\n        // Parent not found, something is wrong\n        return null;\n      }\n\n      // If this parent has no parent, it's the root\n      if (!parentRecord.parentContext) {\n        return parentRecord.id;\n      }\n\n      current = parentRecord;\n    }\n\n    return null;\n  }\n\n  /**\n   * Finds a record by its primary key value\n   */\n  private findRecordByPrimaryKey(entityName: string, primaryKeyValue: string, entityInfo: EntityInfo): string | null {\n    // Get primary key field name\n    const primaryKeyField = entityInfo.PrimaryKeys[0]?.Name;\n    if (!primaryKeyField) return null;\n\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== entityName) continue;\n\n      const candidateValue = candidate.record.primaryKey?.[primaryKeyField] || candidate.record.fields?.[primaryKeyField];\n      if (candidateValue === primaryKeyValue) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets EntityInfo from cache or metadata\n   */\n  private getEntityInfo(entityName: string): EntityInfo | null {\n    if (!this.entityInfoCache.has(entityName)) {\n      const info = this.metadata.EntityByName(entityName);\n      if (info) {\n        this.entityInfoCache.set(entityName, info);\n      }\n    }\n    return this.entityInfoCache.get(entityName) || null;\n  }\n\n  /**\n   * Detects circular dependencies in the dependency graph\n   */\n  private detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const detectCycle = (recordId: string, path: string[]): boolean => {\n      visited.add(recordId);\n      recursionStack.add(recordId);\n      path.push(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        for (const depId of record.dependencies) {\n          if (!visited.has(depId)) {\n            if (detectCycle(depId, [...path])) {\n              return true;\n            }\n          } else if (recursionStack.has(depId)) {\n            // Found a cycle\n            const cycleStart = path.indexOf(depId);\n            const cycle = path.slice(cycleStart);\n            cycle.push(depId); // Complete the cycle\n            cycles.push(cycle);\n            return true;\n          }\n        }\n      }\n\n      recursionStack.delete(recordId);\n      return false;\n    };\n\n    // Check all records for cycles\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        detectCycle(record.id, []);\n      }\n    }\n\n    return cycles;\n  }\n\n  /**\n   * Performs topological sort on the dependency graph\n   */\n  private topologicalSort(): FlattenedRecord[] {\n    const result: FlattenedRecord[] = [];\n    const visited = new Set<string>();\n    const tempStack = new Set<string>();\n\n    const visit = (recordId: string): boolean => {\n      if (tempStack.has(recordId)) {\n        // Circular dependency - we've already detected these\n        return false;\n      }\n\n      if (visited.has(recordId)) {\n        return true;\n      }\n\n      tempStack.add(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        // Visit dependencies first\n        for (const depId of record.dependencies) {\n          visit(depId);\n        }\n      }\n\n      tempStack.delete(recordId);\n      visited.add(recordId);\n\n      if (record) {\n        result.push(record);\n      }\n\n      return true;\n    };\n\n    // Process all records, starting with those that have no dependencies\n    // First, process records with no dependencies\n    for (const record of this.flattenedRecords) {\n      if (record.dependencies.size === 0 && !visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    // Then process any remaining records (handles disconnected components)\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Groups sorted records into dependency levels for parallel processing\n   * Records in the same level have no dependencies on each other and can be processed in parallel\n   */\n  private groupByDependencyLevels(sortedRecords: FlattenedRecord[], dependencyGraph: Map<string, Set<string>>): FlattenedRecord[][] {\n    const levels: FlattenedRecord[][] = [];\n    const recordLevels = new Map<string, number>();\n\n    // Calculate the level for each record\n    for (const record of sortedRecords) {\n      let maxDependencyLevel = -1;\n\n      // Find the maximum level of all dependencies\n      for (const depId of record.dependencies) {\n        const depLevel = recordLevels.get(depId);\n        if (depLevel !== undefined && depLevel > maxDependencyLevel) {\n          maxDependencyLevel = depLevel;\n        }\n      }\n\n      // This record's level is one more than its highest dependency\n      const recordLevel = maxDependencyLevel + 1;\n      recordLevels.set(record.id, recordLevel);\n\n      // Add to the appropriate level array\n      if (!levels[recordLevel]) {\n        levels[recordLevel] = [];\n      }\n      levels[recordLevel].push(record);\n    }\n\n    return levels;\n  }\n}\n"]}
+{"version":3,"file":"record-dependency-analyzer.js","sourceRoot":"","sources":["../../src/lib/record-dependency-analyzer.ts"],"names":[],"mappings":"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","sourcesContent":["import { Metadata, EntityInfo } from '@memberjunction/core';\nimport { RecordData } from './sync-engine';\nimport { METADATA_KEYWORDS, isNonKeywordAtSymbol } from '../constants/metadata-keywords';\n\n/**\n * Represents a flattened record with its context and dependencies\n */\nexport interface FlattenedRecord {\n  record: RecordData;\n  entityName: string;\n  parentContext?: {\n    entityName: string;\n    record: RecordData;\n    recordIndex: number;\n  };\n  depth: number;\n  path: string; // Path to this record for debugging\n  dependencies: Set<string>; // Set of record IDs this record depends on\n  id: string; // Unique identifier for this record in the flattened list\n  originalIndex: number; // Original index in the source array\n}\n\n/**\n * Result of dependency analysis\n */\nexport interface DependencyAnalysisResult {\n  sortedRecords: FlattenedRecord[];\n  circularDependencies: string[][];\n  dependencyGraph: Map<string, Set<string>>;\n  dependencyLevels?: FlattenedRecord[][]; // Records grouped by dependency level for parallel processing\n}\n\n/**\n * Analyzes and sorts records based on their dependencies\n */\nexport class RecordDependencyAnalyzer {\n  private metadata: Metadata;\n  private flattenedRecords: FlattenedRecord[] = [];\n  private recordIdMap: Map<string, FlattenedRecord> = new Map();\n  private entityInfoCache: Map<string, EntityInfo> = new Map();\n  private recordCounter: number = 0;\n\n  constructor() {\n    this.metadata = new Metadata();\n  }\n\n  /**\n   * Main entry point: analyzes all records in a file and returns them in dependency order\n   */\n  public async analyzeFileRecords(\n    records: RecordData[],\n    entityName: string\n  ): Promise<DependencyAnalysisResult> {\n    // Reset state\n    this.flattenedRecords = [];\n    this.recordIdMap.clear();\n    this.recordCounter = 0;\n\n    // Step 1: Flatten all records (including nested relatedEntities)\n    this.flattenRecords(records, entityName);\n\n    // Step 2: Analyze dependencies between all flattened records\n    this.analyzeDependencies();\n\n    // Step 3: Detect circular dependencies\n    const circularDeps = this.detectCircularDependencies();\n\n    // Step 4: Perform topological sort\n    const sortedRecords = this.topologicalSort();\n\n    // Step 5: Build dependency graph for debugging\n    const dependencyGraph = new Map<string, Set<string>>();\n    for (const record of this.flattenedRecords) {\n      dependencyGraph.set(record.id, record.dependencies);\n    }\n\n    // Step 6: Group records into dependency levels for parallel processing\n    const dependencyLevels = this.groupByDependencyLevels(sortedRecords, dependencyGraph);\n\n    return {\n      sortedRecords,\n      circularDependencies: circularDeps,\n      dependencyGraph,\n      dependencyLevels\n    };\n  }\n\n  /**\n   * Flattens all records including nested relatedEntities\n   */\n  private flattenRecords(\n    records: RecordData[],\n    entityName: string,\n    parentContext?: FlattenedRecord['parentContext'],\n    depth: number = 0,\n    pathPrefix: string = '',\n    parentRecordId?: string\n  ): void {\n    for (let i = 0; i < records.length; i++) {\n      const record = records[i];\n      const recordId = `${entityName}_${this.recordCounter++}`;\n      const path = pathPrefix ? `${pathPrefix}/${entityName}[${i}]` : `${entityName}[${i}]`;\n\n      const flattenedRecord: FlattenedRecord = {\n        record,\n        entityName,\n        parentContext,\n        depth,\n        path,\n        dependencies: new Set(),\n        id: recordId,\n        originalIndex: i\n      };\n\n      // If this has a parent, add dependency on the parent\n      if (parentRecordId) {\n        flattenedRecord.dependencies.add(parentRecordId);\n      }\n\n      this.flattenedRecords.push(flattenedRecord);\n      this.recordIdMap.set(recordId, flattenedRecord);\n\n      // Recursively flatten related entities\n      if (record.relatedEntities) {\n        for (const [relatedEntityName, relatedRecords] of Object.entries(record.relatedEntities)) {\n          this.flattenRecords(\n            relatedRecords,\n            relatedEntityName,\n            {\n              entityName,\n              record,\n              recordIndex: i\n            },\n            depth + 1,\n            path,\n            recordId  // Pass current record ID as parent for children\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Analyzes dependencies between all flattened records\n   */\n  private analyzeDependencies(): void {\n    for (const record of this.flattenedRecords) {\n      // Get entity info for foreign key relationships\n      const entityInfo = this.getEntityInfo(record.entityName);\n      if (!entityInfo) continue;\n\n      // Analyze field dependencies\n      if (record.record.fields) {\n        for (const [fieldName, fieldValue] of Object.entries(record.record.fields)) {\n          if (typeof fieldValue === 'string') {\n            // Handle @lookup references\n            if (fieldValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n              const dependency = this.findLookupDependency(fieldValue, record);\n              if (dependency) {\n                record.dependencies.add(dependency);\n              }\n            }\n            // Handle @root references - these create dependencies on the root record\n            else if (fieldValue.startsWith(METADATA_KEYWORDS.ROOT)) {\n              const rootDependency = this.findRootDependency(record);\n              if (rootDependency) {\n                record.dependencies.add(rootDependency);\n              }\n            }\n            // @parent references don't create explicit dependencies in our flattened structure\n            // because parent is guaranteed to be processed before children due to the way\n            // we flatten records (parent always comes before its children)\n          }\n        }\n      }\n\n      // Check foreign key dependencies\n      this.analyzeForeignKeyDependencies(record, entityInfo);\n    }\n  }\n\n  /**\n   * Analyzes foreign key dependencies based on EntityInfo\n   */\n  private analyzeForeignKeyDependencies(record: FlattenedRecord, entityInfo: EntityInfo): void {\n    // Check all foreign key fields\n    for (const field of entityInfo.ForeignKeys) {\n      const fieldValue = record.record.fields?.[field.Name];\n      if (fieldValue && typeof fieldValue === 'string' && !fieldValue.startsWith('@')) {\n        // This is a direct foreign key value, find the referenced record\n        const relatedEntityInfo = this.getEntityInfo(field.RelatedEntity);\n        if (relatedEntityInfo) {\n          const dependency = this.findRecordByPrimaryKey(\n            field.RelatedEntity,\n            fieldValue,\n            relatedEntityInfo\n          );\n          if (dependency) {\n            record.dependencies.add(dependency);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Finds a record that matches a @lookup reference\n   */\n  private findLookupDependency(lookupValue: string, currentRecord: FlattenedRecord): string | null {\n    // Parse lookup format: @lookup:EntityName.Field=Value or @lookup:Field=Value\n    const lookupStr = lookupValue.substring(8); // Remove '@lookup:'\n    \n    // Handle the ?create syntax by removing it\n    const cleanLookup = lookupStr.split('?')[0];\n    \n    // Parse entity name if present\n    let targetEntity: string;\n    let criteria: string;\n    \n    if (cleanLookup.includes('.')) {\n      const parts = cleanLookup.split('.');\n      targetEntity = parts[0];\n      criteria = parts.slice(1).join('.');\n    } else {\n      // Same entity if not specified\n      targetEntity = currentRecord.entityName;\n      criteria = cleanLookup;\n    }\n\n    // Parse criteria (can be multiple with &)\n    const criteriaMap = new Map<string, string>();\n    for (const pair of criteria.split('&')) {\n      const [field, value] = pair.split('=');\n      if (field && value) {\n        let resolvedValue = value.trim();\n        \n        // Special handling for nested @lookup references in lookup criteria\n        // This creates a dependency on the looked-up record\n        if (resolvedValue.startsWith(METADATA_KEYWORDS.LOOKUP)) {\n          const nestedDependency = this.findLookupDependency(resolvedValue, currentRecord);\n          if (nestedDependency) {\n            // Add this as a dependency of the current record\n            currentRecord.dependencies.add(nestedDependency);\n            // Continue processing - we can't resolve the actual value here\n            // but we've recorded the dependency\n          }\n        }\n        // Special handling for @root references in lookup criteria\n        else if (resolvedValue.startsWith(METADATA_KEYWORDS.ROOT)) {\n          // Add dependency on root record\n          const rootDep = this.findRootDependency(currentRecord);\n          if (rootDep) {\n            currentRecord.dependencies.add(rootDep);\n          }\n          // Note: We can't resolve the actual value here, but we've recorded the dependency\n        }\n        // Special handling for @parent references in lookup criteria\n        // If the value is @parent:field, we need to resolve it from the parent context\n        else if (resolvedValue.startsWith(METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {\n          const parentField = resolvedValue.substring(METADATA_KEYWORDS.PARENT.length);\n          \n          // Try to resolve from parent context\n          const parentValue = currentRecord.parentContext.record.fields?.[parentField] ||\n                             currentRecord.parentContext.record.primaryKey?.[parentField];\n          \n          if (parentValue && typeof parentValue === 'string') {\n            // Check if parent value is also a @parent reference (nested parent refs)\n            if (parentValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n              // Find the parent record to get its parent context\n              const parentRecord = this.flattenedRecords.find(r =>\n                r.record === currentRecord.parentContext!.record &&\n                r.entityName === currentRecord.parentContext!.entityName\n              );\n\n              if (parentRecord && parentRecord.parentContext) {\n                const grandParentField = parentValue.substring(METADATA_KEYWORDS.PARENT.length);\n                const grandParentValue = parentRecord.parentContext.record.fields?.[grandParentField] ||\n                                        parentRecord.parentContext.record.primaryKey?.[grandParentField];\n                if (grandParentValue && typeof grandParentValue === 'string' && !grandParentValue.startsWith('@')) {\n                  resolvedValue = grandParentValue;\n                }\n              }\n            } else if (!parentValue.startsWith('@')) {\n              resolvedValue = parentValue;\n            }\n          }\n        }\n        \n        criteriaMap.set(field.trim(), resolvedValue);\n      }\n    }\n\n    // Find matching record in our flattened list\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== targetEntity) continue;\n      if (candidate.id === currentRecord.id) continue; // Skip self\n\n      // Check if all criteria match\n      let allMatch = true;\n      for (const [field, value] of criteriaMap) {\n        let candidateValue = candidate.record.fields?.[field] || \n                             candidate.record.primaryKey?.[field];\n        let lookupValue = value;\n        \n        // Resolve candidate value if it's a @parent reference\n        if (typeof candidateValue === 'string' && candidateValue.startsWith(METADATA_KEYWORDS.PARENT) && candidate.parentContext) {\n          const parentField = candidateValue.substring(METADATA_KEYWORDS.PARENT.length);\n          const parentRecord = candidate.parentContext.record;\n          candidateValue = parentRecord.fields?.[parentField] || parentRecord.primaryKey?.[parentField];\n\n          // If the parent field is also a @parent reference, resolve it recursively\n          if (typeof candidateValue === 'string' && candidateValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n            // Find the candidate's parent in our flattened list\n            const candidateParent = this.flattenedRecords.find(r => \n              r.record === candidate.parentContext!.record && \n              r.entityName === candidate.parentContext!.entityName\n            );\n            if (candidateParent?.parentContext) {\n              const grandParentField = candidateValue.substring(8);\n              candidateValue = candidateParent.parentContext.record.fields?.[grandParentField] || \n                              candidateParent.parentContext.record.primaryKey?.[grandParentField];\n            }\n          }\n        }\n        \n        // Resolve lookup value if it contains @parent reference\n        if (typeof lookupValue === 'string' && lookupValue.includes(METADATA_KEYWORDS.PARENT)) {\n          // Handle cases like \"@parent:AgentID\" or embedded references\n          if (lookupValue.startsWith(METADATA_KEYWORDS.PARENT) && currentRecord.parentContext) {\n            const parentField = lookupValue.substring(METADATA_KEYWORDS.PARENT.length);\n            lookupValue = currentRecord.parentContext.record.fields?.[parentField] ||\n                         currentRecord.parentContext.record.primaryKey?.[parentField];\n\n            // If still a reference, try to resolve from the parent's parent\n            if (typeof lookupValue === 'string' && lookupValue.startsWith(METADATA_KEYWORDS.PARENT)) {\n              const currentParent = this.flattenedRecords.find(r =>\n                r.record === currentRecord.parentContext!.record &&\n                r.entityName === currentRecord.parentContext!.entityName\n              );\n              if (currentParent?.parentContext) {\n                const grandParentField = lookupValue.substring(METADATA_KEYWORDS.PARENT.length);\n                lookupValue = currentParent.parentContext.record.fields?.[grandParentField] ||\n                             currentParent.parentContext.record.primaryKey?.[grandParentField];\n              }\n            }\n          }\n        }\n\n        // Special case: if both values are @parent references pointing to the same parent field,\n        // and they have the same parent context, they match\n        if (value.startsWith(METADATA_KEYWORDS.PARENT) && candidateValue === value && \n            currentRecord.parentContext && candidate.parentContext) {\n          // Check if they share the same parent\n          if (currentRecord.parentContext.record === candidate.parentContext.record) {\n            // Same parent, same reference - they will resolve to the same value\n            continue; // This criterion matches\n          }\n        }\n        \n        if (candidateValue !== lookupValue) {\n          allMatch = false;\n          break;\n        }\n      }\n\n      if (allMatch) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Finds the root record for a given record\n   */\n  private findRootDependency(record: FlattenedRecord): string | null {\n    // If this record has no parent, it IS the root, no dependency\n    if (!record.parentContext) {\n      return null;\n    }\n    \n    // Walk up the parent chain to find the root\n    let current = record;\n    while (current.parentContext) {\n      // Try to find the parent record in our flattened list\n      const parentRecord = this.flattenedRecords.find(r => \n        r.record === current.parentContext!.record && \n        r.entityName === current.parentContext!.entityName\n      );\n      \n      if (!parentRecord) {\n        // Parent not found, something is wrong\n        return null;\n      }\n      \n      // If this parent has no parent, it's the root\n      if (!parentRecord.parentContext) {\n        return parentRecord.id;\n      }\n      \n      current = parentRecord;\n    }\n    \n    return null;\n  }\n\n  /**\n   * Finds a record by its primary key value\n   */\n  private findRecordByPrimaryKey(\n    entityName: string,\n    primaryKeyValue: string,\n    entityInfo: EntityInfo\n  ): string | null {\n    // Get primary key field name\n    const primaryKeyField = entityInfo.PrimaryKeys[0]?.Name;\n    if (!primaryKeyField) return null;\n\n    for (const candidate of this.flattenedRecords) {\n      if (candidate.entityName !== entityName) continue;\n\n      const candidateValue = candidate.record.primaryKey?.[primaryKeyField] ||\n                            candidate.record.fields?.[primaryKeyField];\n      if (candidateValue === primaryKeyValue) {\n        return candidate.id;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets EntityInfo from cache or metadata\n   */\n  private getEntityInfo(entityName: string): EntityInfo | null {\n    if (!this.entityInfoCache.has(entityName)) {\n      const info = this.metadata.EntityByName(entityName);\n      if (info) {\n        this.entityInfoCache.set(entityName, info);\n      }\n    }\n    return this.entityInfoCache.get(entityName) || null;\n  }\n\n  /**\n   * Detects circular dependencies in the dependency graph\n   */\n  private detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const detectCycle = (recordId: string, path: string[]): boolean => {\n      visited.add(recordId);\n      recursionStack.add(recordId);\n      path.push(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        for (const depId of record.dependencies) {\n          if (!visited.has(depId)) {\n            if (detectCycle(depId, [...path])) {\n              return true;\n            }\n          } else if (recursionStack.has(depId)) {\n            // Found a cycle\n            const cycleStart = path.indexOf(depId);\n            const cycle = path.slice(cycleStart);\n            cycle.push(depId); // Complete the cycle\n            cycles.push(cycle);\n            return true;\n          }\n        }\n      }\n\n      recursionStack.delete(recordId);\n      return false;\n    };\n\n    // Check all records for cycles\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        detectCycle(record.id, []);\n      }\n    }\n\n    return cycles;\n  }\n\n  /**\n   * Performs topological sort on the dependency graph\n   */\n  private topologicalSort(): FlattenedRecord[] {\n    const result: FlattenedRecord[] = [];\n    const visited = new Set<string>();\n    const tempStack = new Set<string>();\n\n    const visit = (recordId: string): boolean => {\n      if (tempStack.has(recordId)) {\n        // Circular dependency - we've already detected these\n        return false;\n      }\n\n      if (visited.has(recordId)) {\n        return true;\n      }\n\n      tempStack.add(recordId);\n\n      const record = this.recordIdMap.get(recordId);\n      if (record) {\n        // Visit dependencies first\n        for (const depId of record.dependencies) {\n          visit(depId);\n        }\n      }\n\n      tempStack.delete(recordId);\n      visited.add(recordId);\n      \n      if (record) {\n        result.push(record);\n      }\n\n      return true;\n    };\n\n    // Process all records, starting with those that have no dependencies\n    // First, process records with no dependencies\n    for (const record of this.flattenedRecords) {\n      if (record.dependencies.size === 0 && !visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    // Then process any remaining records (handles disconnected components)\n    for (const record of this.flattenedRecords) {\n      if (!visited.has(record.id)) {\n        visit(record.id);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Groups sorted records into dependency levels for parallel processing\n   * Records in the same level have no dependencies on each other and can be processed in parallel\n   */\n  private groupByDependencyLevels(\n    sortedRecords: FlattenedRecord[],\n    dependencyGraph: Map<string, Set<string>>\n  ): FlattenedRecord[][] {\n    const levels: FlattenedRecord[][] = [];\n    const recordLevels = new Map<string, number>();\n    \n    // Calculate the level for each record\n    for (const record of sortedRecords) {\n      let maxDependencyLevel = -1;\n      \n      // Find the maximum level of all dependencies\n      for (const depId of record.dependencies) {\n        const depLevel = recordLevels.get(depId);\n        if (depLevel !== undefined && depLevel > maxDependencyLevel) {\n          maxDependencyLevel = depLevel;\n        }\n      }\n      \n      // This record's level is one more than its highest dependency\n      const recordLevel = maxDependencyLevel + 1;\n      recordLevels.set(record.id, recordLevel);\n      \n      // Add to the appropriate level array\n      if (!levels[recordLevel]) {\n        levels[recordLevel] = [];\n      }\n      levels[recordLevel].push(record);\n    }\n    \n    return levels;\n  }\n}"]}

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

@@ -7,7 +7,7 @@
  * and improving performance.
  */
 import { SyncEngine } from './sync-engine';
-import { UserInfo } from '@memberjunction/global';
+import { UserInfo } from '@memberjunction/core';
 /**
  * Get or create a singleton SyncEngine instance
  *

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

@@ -1 +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/global';\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}\n"]}
+{"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}"]}

package/dist/lib/sync-engine.d.ts

@@ -7,7 +7,7 @@
  * special reference types (@file, @url, @lookup, @env, @parent, @root, @template),
  * manages entity operations, and provides utilities for data transformation.
  */
-import { EntityInfo, BaseEntity, UserInfo } from '@memberjunction/global';
+import { EntityInfo, BaseEntity, UserInfo } from '@memberjunction/core';
 import { EntityConfig } from '../config';
 /**
  * Represents the structure of a metadata record with optional sync tracking