@memberjunction/metadata-sync 2.46.0 → 2.48.0

package/dist/config.d.ts

@@ -1,44 +1,254 @@
+/**
+ * @fileoverview Configuration types and loaders for MetadataSync
+ * @module config
+ *
+ * This module defines configuration interfaces and provides utilities for loading
+ * various configuration files used by the MetadataSync tool. It supports:
+ * - MemberJunction database configuration (mj.config.cjs)
+ * - Sync configuration (.mj-sync.json)
+ * - Entity-specific configuration (.mj-sync.json with entity field)
+ * - Folder-level defaults (.mj-folder.json)
+ */
+/**
+ * MemberJunction database configuration
+ *
+ * Defines connection parameters and settings for connecting to the MemberJunction
+ * database. Typically loaded from mj.config.cjs in the project root.
+ */
 export interface MJConfig {
+    /** Database server hostname or IP address */
     dbHost: string;
+    /** Database server port (defaults to 1433 for SQL Server) */
     dbPort?: number;
+    /** Database name to connect to */
     dbDatabase: string;
+    /** Database authentication username */
     dbUsername: string;
+    /** Database authentication password */
     dbPassword: string;
+    /** Whether to trust the server certificate (Y/N) */
     dbTrustServerCertificate?: string;
+    /** Whether to encrypt the connection (Y/N, auto-detected for Azure SQL) */
+    dbEncrypt?: string;
+    /** SQL Server instance name (for named instances) */
     dbInstanceName?: string;
+    /** Schema name for MemberJunction core tables (defaults to __mj) */
     mjCoreSchema?: string;
+    /** Allow additional properties for extensibility */
     [key: string]: any;
 }
+/**
+ * Global sync configuration
+ *
+ * Defines settings that apply to the entire sync process, including push/pull
+ * behaviors and watch mode configuration. Stored in .mj-sync.json at the root.
+ */
 export interface SyncConfig {
+    /** Version of the sync configuration format */
     version: string;
+    /** Push command configuration */
     push?: {
+        /** Whether to validate records before pushing to database */
         validateBeforePush?: boolean;
+        /** Whether to require user confirmation before push */
         requireConfirmation?: boolean;
     };
+    /** Watch command configuration */
     watch?: {
+        /** Milliseconds to wait before processing file changes */
         debounceMs?: number;
+        /** File patterns to ignore during watch */
         ignorePatterns?: string[];
     };
 }
+/**
+ * Configuration for related entity synchronization
+ *
+ * Defines how to pull and push related entities that have foreign key relationships
+ * with a parent entity. Supports nested relationships for deep object graphs.
+ */
 export interface RelatedEntityConfig {
+    /** Name of the related entity to sync */
     entity: string;
+    /** Field name that contains the foreign key reference to parent (e.g., "PromptID") */
     foreignKey: string;
+    /** Optional SQL filter to apply when pulling related records */
     filter?: string;
+    /** Fields to externalize to separate files for this related entity */
+    externalizeFields?: string[] | {
+        [fieldName: string]: {
+            /** File extension to use (e.g., ".md", ".txt", ".html") */
+            extension?: string;
+        };
+    } | Array<{
+        /** Field name to externalize */
+        field: string;
+        /** Pattern for the output file. Supports placeholders from the entity */
+        pattern: string;
+    }>;
+    /** Fields to exclude from the pulled data for this related entity */
+    excludeFields?: string[];
+    /** Foreign key fields to convert to @lookup references for this related entity */
+    lookupFields?: {
+        [fieldName: string]: {
+            entity: string;
+            field: string;
+        };
+    };
+    /** Nested related entities for deep object graphs */
     relatedEntities?: Record<string, RelatedEntityConfig>;
 }
+/**
+ * Entity-specific configuration
+ *
+ * Defines settings for a specific entity type within a directory. Stored in
+ * .mj-sync.json files that contain an "entity" field. Supports defaults,
+ * file patterns, and related entity configuration.
+ */
 export interface EntityConfig {
+    /** Name of the entity this directory contains */
     entity: string;
+    /** Glob pattern for finding data files (defaults to "*.json") */
     filePattern?: string;
+    /** Default field values applied to all records in this directory */
     defaults?: Record<string, any>;
+    /** Pull command specific configuration */
     pull?: {
+        /** Glob pattern for finding existing files to update (defaults to filePattern) */
+        filePattern?: string;
+        /** Whether to create new files for records not found locally */
+        createNewFileIfNotFound?: boolean;
+        /** Filename for new records when createNewFileIfNotFound is true */
+        newFileName?: string;
+        /** Whether to append multiple new records to a single file */
+        appendRecordsToExistingFile?: boolean;
+        /** Whether to update existing records found in local files */
+        updateExistingRecords?: boolean;
+        /** Fields to preserve during updates (never overwrite these) */
+        preserveFields?: string[];
+        /** Strategy for merging updates: "overwrite" | "merge" | "skip" */
+        mergeStrategy?: 'overwrite' | 'merge' | 'skip';
+        /** Create backup files before updating existing files */
+        backupBeforeUpdate?: boolean;
+        /** Directory name for backup files (defaults to ".backups") */
+        backupDirectory?: string;
+        /** SQL filter to apply when pulling records from database */
         filter?: string;
+        /** Configuration for pulling related entities */
         relatedEntities?: Record<string, RelatedEntityConfig>;
+        /** Fields to externalize to separate files with optional configuration */
+        externalizeFields?: string[] | {
+            [fieldName: string]: {
+                /** File extension to use (e.g., ".md", ".txt", ".html") */
+                extension?: string;
+            };
+        } | Array<{
+            /** Field name to externalize */
+            field: string;
+            /** Pattern for the output file. Supports placeholders:
+             * - {Name}: Entity's name field value
+             * - {ID}: Entity's ID
+             * - {FieldName}: The field being externalized
+             * - Any other {FieldName} from the entity
+             * Example: "@file:templates/{Name}.template.md"
+             */
+            pattern: string;
+        }>;
+        /** Fields to exclude from the pulled data (e.g., ["TemplateID"]) */
+        excludeFields?: string[];
+        /** Foreign key fields to convert to @lookup references */
+        lookupFields?: {
+            /** Field name in this entity (e.g., "CategoryID") */
+            [fieldName: string]: {
+                /** Target entity name (e.g., "AI Prompt Categories") */
+                entity: string;
+                /** Field in target entity to use for lookup (e.g., "Name") */
+                field: string;
+            };
+        };
     };
 }
+/**
+ * Folder-level configuration
+ *
+ * Defines default values that cascade down to all subdirectories. Stored in
+ * .mj-folder.json files. Child folders can override parent defaults.
+ */
 export interface FolderConfig {
+    /** Default field values that apply to all entities in this folder and subfolders */
     defaults: Record<string, any>;
 }
+/**
+ * Load MemberJunction configuration from the filesystem
+ *
+ * Searches for mj.config.cjs starting from the current directory and walking up
+ * the directory tree. Uses cosmiconfig for flexible configuration loading.
+ *
+ * @returns MJConfig object if found, null if not found or invalid
+ *
+ * @example
+ * ```typescript
+ * const config = loadMJConfig();
+ * if (config) {
+ *   console.log(`Connecting to ${config.dbHost}:${config.dbPort || 1433}`);
+ * }
+ * ```
+ */
 export declare function loadMJConfig(): MJConfig | null;
+/**
+ * Load sync configuration from a directory
+ *
+ * Loads .mj-sync.json file from the specified directory. This file can contain
+ * either global sync configuration (no entity field) or entity-specific
+ * configuration (with entity field).
+ *
+ * @param dir - Directory path to load configuration from
+ * @returns Promise resolving to SyncConfig if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const syncConfig = await loadSyncConfig('/path/to/project');
+ * if (syncConfig?.push?.requireConfirmation) {
+ *   // Show confirmation prompt
+ * }
+ * ```
+ */
 export declare function loadSyncConfig(dir: string): Promise<SyncConfig | null>;
+/**
+ * Load entity-specific configuration from a directory
+ *
+ * Loads .mj-sync.json file that contains an "entity" field, indicating this
+ * directory contains data for a specific entity type. Returns null if the
+ * file doesn't exist or doesn't contain an entity field.
+ *
+ * @param dir - Directory path to load configuration from
+ * @returns Promise resolving to EntityConfig if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const entityConfig = await loadEntityConfig('./ai-prompts');
+ * if (entityConfig) {
+ *   console.log(`Directory contains ${entityConfig.entity} records`);
+ * }
+ * ```
+ */
 export declare function loadEntityConfig(dir: string): Promise<EntityConfig | null>;
+/**
+ * Load folder-level configuration
+ *
+ * Loads .mj-folder.json file that contains default values to be applied to
+ * all entities in this folder and its subfolders. Used for cascading defaults
+ * in deep directory structures.
+ *
+ * @param dir - Directory path to load configuration from
+ * @returns Promise resolving to FolderConfig if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const folderConfig = await loadFolderConfig('./templates');
+ * if (folderConfig?.defaults) {
+ *   // Apply folder defaults to records
+ * }
+ * ```
+ */
 export declare function loadFolderConfig(dir: string): Promise<FolderConfig | null>;

package/dist/config.js

@@ -1,27 +1,61 @@
 "use strict";
+/**
+ * @fileoverview Configuration types and loaders for MetadataSync
+ * @module config
+ *
+ * This module defines configuration interfaces and provides utilities for loading
+ * various configuration files used by the MetadataSync tool. It supports:
+ * - MemberJunction database configuration (mj.config.cjs)
+ * - Sync configuration (.mj-sync.json)
+ * - Entity-specific configuration (.mj-sync.json with entity field)
+ * - Folder-level defaults (.mj-folder.json)
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadFolderConfig = exports.loadEntityConfig = exports.loadSyncConfig = exports.loadMJConfig = void 0;
-const cosmiconfig_1 = require("cosmiconfig");
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
+const config_manager_1 = require("./lib/config-manager");
+/**
+ * Load MemberJunction configuration from the filesystem
+ *
+ * Searches for mj.config.cjs starting from the current directory and walking up
+ * the directory tree. Uses cosmiconfig for flexible configuration loading.
+ *
+ * @returns MJConfig object if found, null if not found or invalid
+ *
+ * @example
+ * ```typescript
+ * const config = loadMJConfig();
+ * if (config) {
+ *   console.log(`Connecting to ${config.dbHost}:${config.dbPort || 1433}`);
+ * }
+ * ```
+ */
 function loadMJConfig() {
-    try {
-        const explorer = (0, cosmiconfig_1.cosmiconfigSync)('mj');
-        const result = explorer.search(process.cwd());
-        if (!result || !result.config) {
-            throw new Error('No mj.config.cjs found');
-        }
-        return result.config;
-    }
-    catch (error) {
-        console.error('Error loading MJ config:', error);
-        return null;
-    }
+    return config_manager_1.configManager.loadMJConfig();
 }
 exports.loadMJConfig = loadMJConfig;
+/**
+ * Load sync configuration from a directory
+ *
+ * Loads .mj-sync.json file from the specified directory. This file can contain
+ * either global sync configuration (no entity field) or entity-specific
+ * configuration (with entity field).
+ *
+ * @param dir - Directory path to load configuration from
+ * @returns Promise resolving to SyncConfig if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const syncConfig = await loadSyncConfig('/path/to/project');
+ * if (syncConfig?.push?.requireConfirmation) {
+ *   // Show confirmation prompt
+ * }
+ * ```
+ */
 async function loadSyncConfig(dir) {
     const configPath = path_1.default.join(dir, '.mj-sync.json');
     if (await fs_extra_1.default.pathExists(configPath)) {
@@ -36,6 +70,24 @@ async function loadSyncConfig(dir) {
     return null;
 }
 exports.loadSyncConfig = loadSyncConfig;
+/**
+ * Load entity-specific configuration from a directory
+ *
+ * Loads .mj-sync.json file that contains an "entity" field, indicating this
+ * directory contains data for a specific entity type. Returns null if the
+ * file doesn't exist or doesn't contain an entity field.
+ *
+ * @param dir - Directory path to load configuration from
+ * @returns Promise resolving to EntityConfig if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const entityConfig = await loadEntityConfig('./ai-prompts');
+ * if (entityConfig) {
+ *   console.log(`Directory contains ${entityConfig.entity} records`);
+ * }
+ * ```
+ */
 async function loadEntityConfig(dir) {
     const configPath = path_1.default.join(dir, '.mj-sync.json');
     if (await fs_extra_1.default.pathExists(configPath)) {
@@ -52,6 +104,24 @@ async function loadEntityConfig(dir) {
     return null;
 }
 exports.loadEntityConfig = loadEntityConfig;
+/**
+ * Load folder-level configuration
+ *
+ * Loads .mj-folder.json file that contains default values to be applied to
+ * all entities in this folder and its subfolders. Used for cascading defaults
+ * in deep directory structures.
+ *
+ * @param dir - Directory path to load configuration from
+ * @returns Promise resolving to FolderConfig if found and valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const folderConfig = await loadFolderConfig('./templates');
+ * if (folderConfig?.defaults) {
+ *   // Apply folder defaults to records
+ * }
+ * ```
+ */
 async function loadFolderConfig(dir) {
     const configPath = path_1.default.join(dir, '.mj-folder.json');
     if (await fs_extra_1.default.pathExists(configPath)) {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA8C;AAC9C,gDAAwB;AACxB,wDAA0B;AA+C1B,SAAgB,YAAY;IAC1B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAA,6BAAe,EAAC,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAdD,oCAcC;AAEM,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,wCAaC;AAEM,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAfD,4CAeC;AAEM,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,4CAaC","sourcesContent":["import { cosmiconfigSync } from 'cosmiconfig';\nimport path from 'path';\nimport fs from 'fs-extra';\n\nexport interface MJConfig {\n  dbHost: string;\n  dbPort?: number;\n  dbDatabase: string;\n  dbUsername: string;\n  dbPassword: string;\n  dbTrustServerCertificate?: string;\n  dbInstanceName?: string;\n  mjCoreSchema?: string;\n  [key: string]: any; // Allow other properties\n}\n\nexport interface SyncConfig {\n  version: string;\n  push?: {\n    validateBeforePush?: boolean;\n    requireConfirmation?: boolean;\n  };\n  watch?: {\n    debounceMs?: number;\n    ignorePatterns?: string[];\n  };\n}\n\nexport interface RelatedEntityConfig {\n  entity: string;\n  foreignKey: string; // Field that links to parent (e.g., \"PromptID\")\n  filter?: string; // Additional filter\n  relatedEntities?: Record<string, RelatedEntityConfig>; // Nested related entities\n}\n\nexport interface EntityConfig {\n  entity: string;\n  filePattern?: string;\n  defaults?: Record<string, any>;\n  pull?: {\n    filter?: string; // Default filter for pulling records\n    relatedEntities?: Record<string, RelatedEntityConfig>;\n  };\n}\n\nexport interface FolderConfig {\n  defaults: Record<string, any>;\n}\n\nexport function loadMJConfig(): MJConfig | null {\n  try {\n    const explorer = cosmiconfigSync('mj');\n    const result = explorer.search(process.cwd());\n    \n    if (!result || !result.config) {\n      throw new Error('No mj.config.cjs found');\n    }\n    \n    return result.config;\n  } catch (error) {\n    console.error('Error loading MJ config:', error);\n    return null;\n  }\n}\n\nexport async function loadSyncConfig(dir: string): Promise<SyncConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading sync config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}\n\nexport async function loadEntityConfig(dir: string): Promise<EntityConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      const config = await fs.readJson(configPath);\n      if (config.entity) {\n        return config;\n      }\n    } catch (error) {\n      console.error('Error loading entity config:', error);\n    }\n  }\n  \n  return null;\n}\n\nexport async function loadFolderConfig(dir: string): Promise<FolderConfig | null> {\n  const configPath = path.join(dir, '.mj-folder.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading folder config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;AAGH,gDAAwB;AACxB,wDAA0B;AAC1B,yDAAqD;AAgLrD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY;IAC1B,OAAO,8BAAa,CAAC,YAAY,EAAE,CAAC;AACtC,CAAC;AAFD,oCAEC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,wCAaC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAfD,4CAeC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,4CAaC","sourcesContent":["/**\n * @fileoverview Configuration types and loaders for MetadataSync\n * @module config\n * \n * This module defines configuration interfaces and provides utilities for loading\n * various configuration files used by the MetadataSync tool. It supports:\n * - MemberJunction database configuration (mj.config.cjs)\n * - Sync configuration (.mj-sync.json)\n * - Entity-specific configuration (.mj-sync.json with entity field)\n * - Folder-level defaults (.mj-folder.json)\n */\n\nimport { cosmiconfigSync } from 'cosmiconfig';\nimport path from 'path';\nimport fs from 'fs-extra';\nimport { configManager } from './lib/config-manager';\n\n/**\n * MemberJunction database configuration\n * \n * Defines connection parameters and settings for connecting to the MemberJunction\n * database. Typically loaded from mj.config.cjs in the project root.\n */\nexport interface MJConfig {\n  /** Database server hostname or IP address */\n  dbHost: string;\n  /** Database server port (defaults to 1433 for SQL Server) */\n  dbPort?: number;\n  /** Database name to connect to */\n  dbDatabase: string;\n  /** Database authentication username */\n  dbUsername: string;\n  /** Database authentication password */\n  dbPassword: string;\n  /** Whether to trust the server certificate (Y/N) */\n  dbTrustServerCertificate?: string;\n  /** Whether to encrypt the connection (Y/N, auto-detected for Azure SQL) */\n  dbEncrypt?: string;\n  /** SQL Server instance name (for named instances) */\n  dbInstanceName?: string;\n  /** Schema name for MemberJunction core tables (defaults to __mj) */\n  mjCoreSchema?: string;\n  /** Allow additional properties for extensibility */\n  [key: string]: any;\n}\n\n/**\n * Global sync configuration\n * \n * Defines settings that apply to the entire sync process, including push/pull\n * behaviors and watch mode configuration. Stored in .mj-sync.json at the root.\n */\nexport interface SyncConfig {\n  /** Version of the sync configuration format */\n  version: string;\n  /** Push command configuration */\n  push?: {\n    /** Whether to validate records before pushing to database */\n    validateBeforePush?: boolean;\n    /** Whether to require user confirmation before push */\n    requireConfirmation?: boolean;\n  };\n  /** Watch command configuration */\n  watch?: {\n    /** Milliseconds to wait before processing file changes */\n    debounceMs?: number;\n    /** File patterns to ignore during watch */\n    ignorePatterns?: string[];\n  };\n}\n\n/**\n * Configuration for related entity synchronization\n * \n * Defines how to pull and push related entities that have foreign key relationships\n * with a parent entity. Supports nested relationships for deep object graphs.\n */\nexport interface RelatedEntityConfig {\n  /** Name of the related entity to sync */\n  entity: string;\n  /** Field name that contains the foreign key reference to parent (e.g., \"PromptID\") */\n  foreignKey: string;\n  /** Optional SQL filter to apply when pulling related records */\n  filter?: string;\n  /** Fields to externalize to separate files for this related entity */\n  externalizeFields?: string[] | {\n    [fieldName: string]: {\n      /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n      extension?: string;\n    }\n  } | Array<{\n    /** Field name to externalize */\n    field: string;\n    /** Pattern for the output file. Supports placeholders from the entity */\n    pattern: string;\n  }>;\n  /** Fields to exclude from the pulled data for this related entity */\n  excludeFields?: string[];\n  /** Foreign key fields to convert to @lookup references for this related entity */\n  lookupFields?: {\n    [fieldName: string]: {\n      entity: string;\n      field: string;\n    };\n  };\n  /** Nested related entities for deep object graphs */\n  relatedEntities?: Record<string, RelatedEntityConfig>;\n}\n\n/**\n * Entity-specific configuration\n * \n * Defines settings for a specific entity type within a directory. Stored in\n * .mj-sync.json files that contain an \"entity\" field. Supports defaults,\n * file patterns, and related entity configuration.\n */\nexport interface EntityConfig {\n  /** Name of the entity this directory contains */\n  entity: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** Default field values applied to all records in this directory */\n  defaults?: Record<string, any>;\n  /** Pull command specific configuration */\n  pull?: {\n    /** Glob pattern for finding existing files to update (defaults to filePattern) */\n    filePattern?: string;\n    /** Whether to create new files for records not found locally */\n    createNewFileIfNotFound?: boolean;\n    /** Filename for new records when createNewFileIfNotFound is true */\n    newFileName?: string;\n    /** Whether to append multiple new records to a single file */\n    appendRecordsToExistingFile?: boolean;\n    /** Whether to update existing records found in local files */\n    updateExistingRecords?: boolean;\n    /** Fields to preserve during updates (never overwrite these) */\n    preserveFields?: string[];\n    /** Strategy for merging updates: \"overwrite\" | \"merge\" | \"skip\" */\n    mergeStrategy?: 'overwrite' | 'merge' | 'skip';\n    /** Create backup files before updating existing files */\n    backupBeforeUpdate?: boolean;\n    /** Directory name for backup files (defaults to \".backups\") */\n    backupDirectory?: string;\n    /** SQL filter to apply when pulling records from database */\n    filter?: string;\n    /** Configuration for pulling related entities */\n    relatedEntities?: Record<string, RelatedEntityConfig>;\n    /** Fields to externalize to separate files with optional configuration */\n    externalizeFields?: string[] | {\n      [fieldName: string]: {\n        /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n        extension?: string;\n      }\n    } | Array<{\n      /** Field name to externalize */\n      field: string;\n      /** Pattern for the output file. Supports placeholders:\n       * - {Name}: Entity's name field value\n       * - {ID}: Entity's ID\n       * - {FieldName}: The field being externalized\n       * - Any other {FieldName} from the entity\n       * Example: \"@file:templates/{Name}.template.md\"\n       */\n      pattern: string;\n    }>;\n    /** Fields to exclude from the pulled data (e.g., [\"TemplateID\"]) */\n    excludeFields?: string[];\n    /** Foreign key fields to convert to @lookup references */\n    lookupFields?: {\n      /** Field name in this entity (e.g., \"CategoryID\") */\n      [fieldName: string]: {\n        /** Target entity name (e.g., \"AI Prompt Categories\") */\n        entity: string;\n        /** Field in target entity to use for lookup (e.g., \"Name\") */\n        field: string;\n      };\n    };\n  };\n}\n\n/**\n * Folder-level configuration\n * \n * Defines default values that cascade down to all subdirectories. Stored in\n * .mj-folder.json files. Child folders can override parent defaults.\n */\nexport interface FolderConfig {\n  /** Default field values that apply to all entities in this folder and subfolders */\n  defaults: Record<string, any>;\n}\n\n/**\n * Load MemberJunction configuration from the filesystem\n * \n * Searches for mj.config.cjs starting from the current directory and walking up\n * the directory tree. Uses cosmiconfig for flexible configuration loading.\n * \n * @returns MJConfig object if found, null if not found or invalid\n * \n * @example\n * ```typescript\n * const config = loadMJConfig();\n * if (config) {\n *   console.log(`Connecting to ${config.dbHost}:${config.dbPort || 1433}`);\n * }\n * ```\n */\nexport function loadMJConfig(): MJConfig | null {\n  return configManager.loadMJConfig();\n}\n\n/**\n * Load sync configuration from a directory\n * \n * Loads .mj-sync.json file from the specified directory. This file can contain\n * either global sync configuration (no entity field) or entity-specific\n * configuration (with entity field).\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to SyncConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const syncConfig = await loadSyncConfig('/path/to/project');\n * if (syncConfig?.push?.requireConfirmation) {\n *   // Show confirmation prompt\n * }\n * ```\n */\nexport async function loadSyncConfig(dir: string): Promise<SyncConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading sync config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load entity-specific configuration from a directory\n * \n * Loads .mj-sync.json file that contains an \"entity\" field, indicating this\n * directory contains data for a specific entity type. Returns null if the\n * file doesn't exist or doesn't contain an entity field.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to EntityConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const entityConfig = await loadEntityConfig('./ai-prompts');\n * if (entityConfig) {\n *   console.log(`Directory contains ${entityConfig.entity} records`);\n * }\n * ```\n */\nexport async function loadEntityConfig(dir: string): Promise<EntityConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      const config = await fs.readJson(configPath);\n      if (config.entity) {\n        return config;\n      }\n    } catch (error) {\n      console.error('Error loading entity config:', error);\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load folder-level configuration\n * \n * Loads .mj-folder.json file that contains default values to be applied to\n * all entities in this folder and its subfolders. Used for cascading defaults\n * in deep directory structures.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to FolderConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const folderConfig = await loadFolderConfig('./templates');\n * if (folderConfig?.defaults) {\n *   // Apply folder defaults to records\n * }\n * ```\n */\nexport async function loadFolderConfig(dir: string): Promise<FolderConfig | null> {\n  const configPath = path.join(dir, '.mj-folder.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading folder config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}"]}

package/dist/hooks/init.js

@@ -27,9 +27,17 @@ const core_entities_server_1 = require("@memberjunction/core-entities-server");
 const dotenv = __importStar(require("dotenv"));
 const path = __importStar(require("path"));
 const provider_utils_1 = require("../lib/provider-utils");
+const config_manager_1 = require("../lib/config-manager");
 const hook = async function () {
-    // Load .env from the repository root
+    // Capture the original working directory FIRST before any changes
+    config_manager_1.configManager.getOriginalCwd();
+    // Load .env from the repository root first
     dotenv.config({ path: path.join(__dirname, '../../../../.env') });
+    // Then load local .env from package directory to override
+    dotenv.config({
+        path: path.join(__dirname, '../../.env'),
+        override: true // This ensures local values override already loaded ones
+    });
     // Load core entities server subclasses
     (0, core_entities_server_1.LoadCoreEntitiesServerSubClasses)();
     // Register cleanup handlers

package/dist/hooks/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/hooks/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AACA,+EAAwF;AACxF,+CAAiC;AACjC,2CAA6B;AAC7B,0DAAwD;AAExD,MAAM,IAAI,GAAiB,KAAK;IAC9B,qCAAqC;IACrC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAElE,uCAAuC;IACvC,IAAA,uDAAgC,GAAE,CAAC;IAEnC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,IAAA,gCAAe,GAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAC3B,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,IAAA,gCAAe,GAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,IAAA,gCAAe,GAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,kBAAe,IAAI,CAAC","sourcesContent":["import { Hook } from '@oclif/core';\nimport { LoadCoreEntitiesServerSubClasses } from '@memberjunction/core-entities-server';\nimport * as dotenv from 'dotenv';\nimport * as path from 'path';\nimport { cleanupProvider } from '../lib/provider-utils';\n\nconst hook: Hook<'init'> = async function () {\n  // Load .env from the repository root\n  dotenv.config({ path: path.join(__dirname, '../../../../.env') });\n  \n  // Load core entities server subclasses\n  LoadCoreEntitiesServerSubClasses();\n  \n  // Register cleanup handlers\n  process.on('exit', () => {\n    cleanupProvider().catch(() => {\n      // Ignore errors during cleanup\n    });\n  });\n  \n  process.on('SIGINT', async () => {\n    await cleanupProvider();\n    process.exit(0);\n  });\n  \n  process.on('SIGTERM', async () => {\n    await cleanupProvider();\n    process.exit(0);\n  });\n};\n\nexport default hook;"]}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/hooks/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AACA,+EAAwF;AACxF,+CAAiC;AACjC,2CAA6B;AAC7B,0DAAwD;AACxD,0DAAsD;AAEtD,MAAM,IAAI,GAAiB,KAAK;IAC9B,kEAAkE;IAClE,8BAAa,CAAC,cAAc,EAAE,CAAC;IAE/B,2CAA2C;IAC3C,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAElE,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC;QACxC,QAAQ,EAAE,IAAI,CAAE,yDAAyD;KAC1E,CAAC,CAAC;IAEH,uCAAuC;IACvC,IAAA,uDAAgC,GAAE,CAAC;IAEnC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,IAAA,gCAAe,GAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAC3B,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,IAAA,gCAAe,GAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,IAAA,gCAAe,GAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,kBAAe,IAAI,CAAC","sourcesContent":["import { Hook } from '@oclif/core';\nimport { LoadCoreEntitiesServerSubClasses } from '@memberjunction/core-entities-server';\nimport * as dotenv from 'dotenv';\nimport * as path from 'path';\nimport { cleanupProvider } from '../lib/provider-utils';\nimport { configManager } from '../lib/config-manager';\n\nconst hook: Hook<'init'> = async function () {\n  // Capture the original working directory FIRST before any changes\n  configManager.getOriginalCwd();\n  \n  // Load .env from the repository root first\n  dotenv.config({ path: path.join(__dirname, '../../../../.env') });\n  \n  // Then load local .env from package directory to override\n  dotenv.config({ \n    path: path.join(__dirname, '../../.env'),\n    override: true  // This ensures local values override already loaded ones\n  });\n  \n  // Load core entities server subclasses\n  LoadCoreEntitiesServerSubClasses();\n  \n  // Register cleanup handlers\n  process.on('exit', () => {\n    cleanupProvider().catch(() => {\n      // Ignore errors during cleanup\n    });\n  });\n  \n  process.on('SIGINT', async () => {\n    await cleanupProvider();\n    process.exit(0);\n  });\n  \n  process.on('SIGTERM', async () => {\n    await cleanupProvider();\n    process.exit(0);\n  });\n};\n\nexport default hook;"]}

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

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Shared configuration manager for MetadataSync commands
+ * @module lib/config-manager
+ *
+ * This module provides a centralized configuration management system that handles
+ * loading MJ config from the original working directory, regardless of any
+ * directory changes made during command execution.
+ */
+import { MJConfig } from '../config';
+/**
+ * Configuration manager singleton for handling MJ configuration
+ *
+ * Stores the original working directory and MJ configuration to ensure
+ * consistent access across all commands, even when the current working
+ * directory changes during execution.
+ */
+export declare class ConfigManager {
+    private static instance;
+    private originalCwd;
+    private mjConfig;
+    private configLoaded;
+    private constructor();
+    /**
+     * Get the singleton instance of ConfigManager
+     */
+    static getInstance(): ConfigManager;
+    /**
+     * Get the original working directory from when the process started
+     *
+     * @returns The original working directory path
+     */
+    getOriginalCwd(): string;
+    /**
+     * Set the original working directory (for testing or special cases)
+     *
+     * @param cwd - The working directory to use as original
+     */
+    setOriginalCwd(cwd: string): void;
+    /**
+     * Load MemberJunction configuration
+     *
+     * Searches for mj.config.cjs starting from the original working directory
+     * and walking up the directory tree. Caches the result for subsequent calls.
+     *
+     * @param forceReload - Force reload the configuration even if cached
+     * @returns MJConfig object if found, null if not found or invalid
+     */
+    loadMJConfig(forceReload?: boolean): MJConfig | null;
+    /**
+     * Get the cached MJ configuration
+     *
+     * @returns The cached MJConfig or null if not loaded
+     */
+    getMJConfig(): MJConfig | null;
+}
+export declare const configManager: ConfigManager;

package/dist/lib/config-manager.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * @fileoverview Shared configuration manager for MetadataSync commands
+ * @module lib/config-manager
+ *
+ * This module provides a centralized configuration management system that handles
+ * loading MJ config from the original working directory, regardless of any
+ * directory changes made during command execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configManager = exports.ConfigManager = void 0;
+const cosmiconfig_1 = require("cosmiconfig");
+/**
+ * Configuration manager singleton for handling MJ configuration
+ *
+ * Stores the original working directory and MJ configuration to ensure
+ * consistent access across all commands, even when the current working
+ * directory changes during execution.
+ */
+class ConfigManager {
+    static instance;
+    originalCwd = null;
+    mjConfig = null;
+    configLoaded = false;
+    constructor() {
+        // Original cwd will be set on first access
+    }
+    /**
+     * Get the singleton instance of ConfigManager
+     */
+    static getInstance() {
+        if (!ConfigManager.instance) {
+            ConfigManager.instance = new ConfigManager();
+        }
+        return ConfigManager.instance;
+    }
+    /**
+     * Get the original working directory from when the process started
+     *
+     * @returns The original working directory path
+     */
+    getOriginalCwd() {
+        if (!this.originalCwd) {
+            // Capture on first access
+            this.originalCwd = process.cwd();
+        }
+        return this.originalCwd;
+    }
+    /**
+     * Set the original working directory (for testing or special cases)
+     *
+     * @param cwd - The working directory to use as original
+     */
+    setOriginalCwd(cwd) {
+        this.originalCwd = cwd;
+    }
+    /**
+     * Load MemberJunction configuration
+     *
+     * Searches for mj.config.cjs starting from the original working directory
+     * and walking up the directory tree. Caches the result for subsequent calls.
+     *
+     * @param forceReload - Force reload the configuration even if cached
+     * @returns MJConfig object if found, null if not found or invalid
+     */
+    loadMJConfig(forceReload = false) {
+        if (this.configLoaded && !forceReload) {
+            return this.mjConfig;
+        }
+        try {
+            const explorer = (0, cosmiconfig_1.cosmiconfigSync)('mj');
+            // Always search from the original working directory
+            const searchPath = this.getOriginalCwd();
+            const result = explorer.search(searchPath);
+            if (!result || !result.config) {
+                throw new Error('No mj.config.cjs found');
+            }
+            this.mjConfig = result.config;
+            this.configLoaded = true;
+            return this.mjConfig;
+        }
+        catch (error) {
+            console.error('Error loading MJ config:', error);
+            this.mjConfig = null;
+            this.configLoaded = true;
+            return null;
+        }
+    }
+    /**
+     * Get the cached MJ configuration
+     *
+     * @returns The cached MJConfig or null if not loaded
+     */
+    getMJConfig() {
+        if (!this.configLoaded) {
+            return this.loadMJConfig();
+        }
+        return this.mjConfig;
+    }
+}
+exports.ConfigManager = ConfigManager;
+// Export singleton instance for convenience
+exports.configManager = ConfigManager.getInstance();
+//# sourceMappingURL=config-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../src/lib/config-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,6CAA8C;AAG9C;;;;;;GAMG;AACH,MAAa,aAAa;IAChB,MAAM,CAAC,QAAQ,CAAgB;IAC/B,WAAW,GAAkB,IAAI,CAAC;IAClC,QAAQ,GAAoB,IAAI,CAAC;IACjC,YAAY,GAAG,KAAK,CAAC;IAE7B;QACE,2CAA2C;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,0BAA0B;YAC1B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,GAAW;QACxB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,WAAW,GAAG,KAAK;QAC9B,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAA,6BAAe,EAAC,IAAI,CAAC,CAAC;YACvC,oDAAoD;YACpD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAE3C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAxFD,sCAwFC;AAED,4CAA4C;AAC/B,QAAA,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC","sourcesContent":["/**\n * @fileoverview Shared configuration manager for MetadataSync commands\n * @module lib/config-manager\n * \n * This module provides a centralized configuration management system that handles\n * loading MJ config from the original working directory, regardless of any\n * directory changes made during command execution.\n */\n\nimport { cosmiconfigSync } from 'cosmiconfig';\nimport { MJConfig } from '../config';\n\n/**\n * Configuration manager singleton for handling MJ configuration\n * \n * Stores the original working directory and MJ configuration to ensure\n * consistent access across all commands, even when the current working\n * directory changes during execution.\n */\nexport class ConfigManager {\n  private static instance: ConfigManager;\n  private originalCwd: string | null = null;\n  private mjConfig: MJConfig | null = null;\n  private configLoaded = false;\n\n  private constructor() {\n    // Original cwd will be set on first access\n  }\n\n  /**\n   * Get the singleton instance of ConfigManager\n   */\n  static getInstance(): ConfigManager {\n    if (!ConfigManager.instance) {\n      ConfigManager.instance = new ConfigManager();\n    }\n    return ConfigManager.instance;\n  }\n\n  /**\n   * Get the original working directory from when the process started\n   * \n   * @returns The original working directory path\n   */\n  getOriginalCwd(): string {\n    if (!this.originalCwd) {\n      // Capture on first access\n      this.originalCwd = process.cwd();\n    }\n    return this.originalCwd;\n  }\n  \n  /**\n   * Set the original working directory (for testing or special cases)\n   * \n   * @param cwd - The working directory to use as original\n   */\n  setOriginalCwd(cwd: string): void {\n    this.originalCwd = cwd;\n  }\n\n  /**\n   * Load MemberJunction configuration\n   * \n   * Searches for mj.config.cjs starting from the original working directory\n   * and walking up the directory tree. Caches the result for subsequent calls.\n   * \n   * @param forceReload - Force reload the configuration even if cached\n   * @returns MJConfig object if found, null if not found or invalid\n   */\n  loadMJConfig(forceReload = false): MJConfig | null {\n    if (this.configLoaded && !forceReload) {\n      return this.mjConfig;\n    }\n\n    try {\n      const explorer = cosmiconfigSync('mj');\n      // Always search from the original working directory\n      const searchPath = this.getOriginalCwd();\n      const result = explorer.search(searchPath);\n      \n      if (!result || !result.config) {\n        throw new Error('No mj.config.cjs found');\n      }\n      \n      this.mjConfig = result.config;\n      this.configLoaded = true;\n      return this.mjConfig;\n    } catch (error) {\n      console.error('Error loading MJ config:', error);\n      this.mjConfig = null;\n      this.configLoaded = true;\n      return null;\n    }\n  }\n\n  /**\n   * Get the cached MJ configuration\n   * \n   * @returns The cached MJConfig or null if not loaded\n   */\n  getMJConfig(): MJConfig | null {\n    if (!this.configLoaded) {\n      return this.loadMJConfig();\n    }\n    return this.mjConfig;\n  }\n}\n\n// Export singleton instance for convenience\nexport const configManager = ConfigManager.getInstance();"]}