@memberjunction/metadata-sync 2.54.0 → 2.56.0

package/README.md

@@ -1,6 +1,19 @@
 # MemberJunction Metadata Sync
 
-A CLI tool for synchronizing MemberJunction database metadata with local file system representations. This tool enables developers and non-technical users to manage MJ metadata using their preferred editors and version control systems while maintaining the database as the source of truth.
+A library for synchronizing MemberJunction database metadata with local file system representations. This library is integrated into the MemberJunction CLI (`mj`) and is accessed through `mj sync` commands. It enables developers and non-technical users to manage MJ metadata using their preferred editors and version control systems while maintaining the database as the source of truth.
+
+## Installation
+
+MetadataSync is included with the MemberJunction CLI. Install the CLI globally:
+
+```bash
+npm install -g @memberjunction/cli
+```
+
+Then use the sync commands:
+```bash
+mj sync --help
+```
 
 ## Purpose
 
@@ -401,10 +414,10 @@ echo '{
 #### Step 4: Test and Validate
 ```bash
 # Dry run to check for errors
-mj-sync push --dir="templates" --dry-run
+mj sync push --dir="templates" --dry-run
 
 # If successful, do actual push
-mj-sync push --dir="templates"
+mj sync push --dir="templates"
 ```
 
 ### AI/LLM Guidelines
@@ -896,60 +909,65 @@ Templates can reference other templates:
 
 ## CLI Commands
 
+All MetadataSync functionality is accessed through the MemberJunction CLI (`mj`) under the `sync` namespace. The commands previously available through `mj-sync` are now integrated as `mj sync` commands:
+
 ```bash
 # Validate all metadata files
-mj-sync validate
+mj sync validate
 
 # Validate a specific directory
-mj-sync validate --dir="./metadata"
+mj sync validate --dir="./metadata"
 
 # Validate with detailed output
-mj-sync validate --verbose
+mj sync validate --verbose
 
 # Validate with JSON output for CI/CD
-mj-sync validate --format=json
+mj sync validate --format=json
 
 # Save validation report to markdown file
-mj-sync validate --save-report
+mj sync validate --save-report
 
 # Initialize a directory for metadata sync
-mj-sync init
+mj sync init
 
 # Pull all AI Prompts from database to ai-prompts directory
-mj-sync pull --entity="AI Prompts"
+mj sync pull --entity="AI Prompts"
 
 # Pull specific records by filter
-mj-sync pull --entity="AI Prompts" --filter="CategoryID='customer-service-id'"
+mj sync pull --entity="AI Prompts" --filter="CategoryID='customer-service-id'"
 
 # Pull multiple records into a single file (NEW)
-mj-sync pull --entity="AI Prompts" --multi-file="all-prompts"
-mj-sync pull --entity="AI Prompts" --filter="Status='Active'" --multi-file="active-prompts.json"
+mj sync pull --entity="AI Prompts" --multi-file="all-prompts"
+mj sync pull --entity="AI Prompts" --filter="Status='Active'" --multi-file="active-prompts.json"
 
 # Push all changes from current directory and subdirectories
-mj-sync push
+mj sync push
 
 # Push only specific entity directory
-mj-sync push --dir="ai-prompts"
+mj sync push --dir="ai-prompts"
 
 # Push with verbose output (NEW)
-mj-sync push -v
-mj-sync push --verbose
+mj sync push -v
+mj sync push --verbose
 
 # Dry run to see what would change
-mj-sync push --dry-run
+mj sync push --dry-run
 
 # Show status of local vs database
-mj-sync status
+mj sync status
 
 # Watch for changes and auto-push
-mj-sync watch
+mj sync watch
 
 # CI/CD mode (push with no prompts, fails on validation errors)
-mj-sync push --ci
+mj sync push --ci
 
 # Push/Pull without validation
-mj-sync push --no-validate
-mj-sync pull --entity="AI Prompts" --no-validate
+mj sync push --no-validate
+mj sync pull --entity="AI Prompts" --no-validate
+
+# Reset file checksums after manual edits
+mj sync file-reset
 ```
 
 ## Configuration
@@ -1103,7 +1121,7 @@ Migration files include:
 
 2. **Run push command** as normal:
    ```bash
-   mj-sync push
+   mj sync push
    ```
 
 3. **Review generated SQL** in the output directory:
@@ -1637,12 +1655,13 @@ Processing AI Prompts in demo/ai-prompts
 ## Use Cases
 
 ### Developer Workflow
-1. `mj-sync pull --entity="AI Prompts"` to get latest prompts with their models
-2. Edit prompts and adjust model configurations in VS Code
-3. Test locally with `mj-sync push --dry-run`
-4. Commit changes to Git
-5. PR review with diff visualization
-6. CI/CD runs `mj-sync push --ci` on merge
+1. Install the MJ CLI: `npm install -g @memberjunction/cli`
+2. `mj sync pull --entity="AI Prompts"` to get latest prompts with their models
+3. Edit prompts and adjust model configurations in VS Code
+4. Test locally with `mj sync push --dry-run`
+5. Commit changes to Git
+6. PR review with diff visualization
+7. CI/CD runs `mj sync push --ci` on merge
 
 ### Content Team Workflow
 1. Pull prompts to local directory
@@ -1655,8 +1674,8 @@ Processing AI Prompts in demo/ai-prompts
 ```yaml
 - name: Push Metadata to Production
   run: |
-    npm install -g @memberjunction/metadata-sync
-    mj-sync push --ci --entity="AI Prompts"
+    npm install -g @memberjunction/cli
+    mj sync push --ci --entity="AI Prompts"
 ```
 
 ## Benefits
@@ -1691,31 +1710,31 @@ The MetadataSync tool includes a comprehensive validation system that checks you
 By default, validation runs automatically before push and pull operations:
 ```bash
 # These commands validate first, then proceed if valid
-mj-sync push
-mj-sync pull --entity="AI Prompts"
+mj sync push
+mj sync pull --entity="AI Prompts"
 ```
 
 #### Manual Validation
 Run validation without performing any sync operations:
 ```bash
 # Validate current directory
-mj-sync validate
+mj sync validate
 
 # Validate specific directory
-mj-sync validate --dir="./metadata"
+mj sync validate --dir="./metadata"
 
 # Verbose output shows all files checked
-mj-sync validate --verbose
+mj sync validate --verbose
 ```
 
 #### CI/CD Integration
 Get JSON output for automated pipelines:
 ```bash
 # JSON output for parsing
-mj-sync validate --format=json
+mj sync validate --format=json
 
 # In CI mode, validation failures cause immediate exit
-mj-sync push --ci
+mj sync push --ci
 ```
 
 #### Validation During Push
@@ -1730,8 +1749,8 @@ mj-sync push --ci
 For emergency fixes or when you know validation will fail:
 ```bash
 # Skip validation checks (USE WITH CAUTION!)
-mj-sync push --no-validate
-mj-sync pull --entity="AI Prompts" --no-validate
+mj sync push --no-validate
+mj sync pull --entity="AI Prompts" --no-validate
 ```
 
 ⚠️ **Warning:** Using `--no-validate` may push invalid metadata to your database, potentially breaking your application. Only use this flag when absolutely necessary.
@@ -1803,7 +1822,7 @@ Errors
    Entity: Templates
    Field: Status
    File: ./metadata/templates/.my-template.json
-   → Suggestion: Check spelling of 'Status'. Run 'mj-sync list-entities' to see available entities.
+   → Suggestion: Check spelling of 'Status'. Run 'mj sync list-entities' to see available entities.
 
 2. File not found: ./shared/footer.html
    Entity: Templates
@@ -1837,7 +1856,7 @@ Errors
       "field": "Status",
       "file": "./metadata/templates/.my-template.json",
       "message": "Field \"Status\" does not exist on entity \"Templates\"",
-      "suggestion": "Check spelling of 'Status'. Run 'mj-sync list-entities' to see available entities."
+      "suggestion": "Check spelling of 'Status'. Run 'mj sync list-entities' to see available entities."
     }
   ],
   "warnings": [...]
@@ -1931,9 +1950,9 @@ Control validation behavior in your workflow:
 
 ### Best Practices
 
-1. **Run validation during development**: `mj-sync validate` frequently
+1. **Run validation during development**: `mj sync validate` frequently
 2. **Fix errors before warnings**: Errors block operations, warnings don't
-3. **Use verbose mode** to understand issues: `mj-sync validate -v`
+3. **Use verbose mode** to understand issues: `mj sync validate -v`
 4. **Include in CI/CD**: Parse JSON output for automated checks
 5. **Don't skip validation** unless absolutely necessary
 
@@ -1945,7 +1964,7 @@ If validation fails:
 
 1. **Read the error message carefully** - It includes specific details
 2. **Check the suggestion** - Most errors include how to fix them
-3. **Use verbose mode** for more context: `mj-sync validate -v`
+3. **Use verbose mode** for more context: `mj sync validate -v`
 4. **Verify entity definitions** in generated entity files
 5. **Check file paths** are relative to the metadata directory
 
@@ -1953,9 +1972,9 @@ If validation fails:
 
 For large metadata sets:
 
-1. **Disable best practice checks**: `mj-sync validate --no-best-practices`
-2. **Validate specific directories**: `mj-sync validate --dir="./prompts"`
-3. **Reduce nesting depth warning**: `mj-sync validate --max-depth=20`
+1. **Disable best practice checks**: `mj sync validate --no-best-practices`
+2. **Validate specific directories**: `mj sync validate --dir="./prompts"`
+3. **Reduce nesting depth warning**: `mj sync validate --max-depth=20`
 
 ## Programmatic Usage
 
@@ -2074,8 +2093,8 @@ export async function validateBeforeDeploy(metadataPath: string): Promise<boolea
 # Example GitHub Actions workflow
 - name: Validate Metadata
   run: |
-    npm install @memberjunction/metadata-sync
-    npx mj-sync validate --dir=./metadata --format=json > validation-results.json
+    npm install @memberjunction/cli
+    npx mj sync validate --dir=./metadata --format=json > validation-results.json
     
 - name: Check Validation Results
   run: |
@@ -2096,3 +2115,25 @@ export async function validateBeforeDeploy(metadataPath: string): Promise<boolea
 - Team collaboration features
 - Bidirectional sync for related entities
 - Custom transformation pipelines
+
+## Migration from Standalone MetadataSync
+
+If you were previously using the standalone `mj-sync` command:
+
+1. **Update your installation**: Install the MJ CLI instead of standalone MetadataSync
+   ```bash
+   npm install -g @memberjunction/cli
+   ```
+
+2. **Update your scripts**: Replace `mj-sync` with `mj sync` in all scripts and documentation
+   ```bash
+   # Old command (standalone package)
+   mj-sync push --dir="metadata"
+   
+   # New command
+   mj sync push --dir="metadata"
+   ```
+
+3. **Configuration unchanged**: All `.mj-sync.json` configuration files work exactly the same
+
+4. **Same functionality**: The underlying MetadataSync library is identical, just accessed through the unified CLI

package/dist/index.d.ts

@@ -1,4 +1,24 @@
-export { run } from '@oclif/core';
 export { FileBackupManager } from './lib/file-backup-manager';
 export { SyncEngine } from './lib/sync-engine';
 export type { RecordData } from './lib/sync-engine';
+export { ConfigManager, configManager } from './lib/config-manager';
+export { getSyncEngine, resetSyncEngine } from './lib/singleton-manager';
+export { SQLLogger } from './lib/sql-logger';
+export { TransactionManager } from './lib/transaction-manager';
+export { InitService } from './services/InitService';
+export type { InitOptions, InitCallbacks } from './services/InitService';
+export { PullService } from './services/PullService';
+export type { PullOptions, PullCallbacks, PullResult } from './services/PullService';
+export { PushService } from './services/PushService';
+export type { PushOptions, PushCallbacks, PushResult } from './services/PushService';
+export { StatusService } from './services/StatusService';
+export type { StatusOptions, StatusCallbacks, StatusResult } from './services/StatusService';
+export { FileResetService } from './services/FileResetService';
+export type { FileResetOptions, FileResetCallbacks, FileResetResult } from './services/FileResetService';
+export { WatchService } from './services/WatchService';
+export type { WatchOptions, WatchCallbacks, WatchResult } from './services/WatchService';
+export { ValidationService } from './services/ValidationService';
+export { FormattingService } from './services/FormattingService';
+export { loadMJConfig, loadSyncConfig, loadEntityConfig, loadFolderConfig, type EntityConfig, type FolderConfig, type RelatedEntityConfig } from './config';
+export { initializeProvider, getSystemUser, findEntityDirectories, getDataProvider } from './lib/provider-utils';
+export type { ValidationResult, ValidationError, ValidationWarning, EntityDependency, FileValidationResult, ValidationOptions, ReferenceType, ParsedReference } from './types/validation';

package/dist/index.js

@@ -1,10 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SyncEngine = exports.FileBackupManager = exports.run = void 0;
-var core_1 = require("@oclif/core");
-Object.defineProperty(exports, "run", { enumerable: true, get: function () { return core_1.run; } });
+exports.getDataProvider = exports.findEntityDirectories = exports.getSystemUser = exports.initializeProvider = exports.loadFolderConfig = exports.loadEntityConfig = exports.loadSyncConfig = exports.loadMJConfig = exports.FormattingService = exports.ValidationService = exports.WatchService = exports.FileResetService = exports.StatusService = exports.PushService = exports.PullService = exports.InitService = exports.TransactionManager = exports.SQLLogger = exports.resetSyncEngine = exports.getSyncEngine = exports.configManager = exports.ConfigManager = exports.SyncEngine = exports.FileBackupManager = void 0;
+// Core library exports
 var file_backup_manager_1 = require("./lib/file-backup-manager");
 Object.defineProperty(exports, "FileBackupManager", { enumerable: true, get: function () { return file_backup_manager_1.FileBackupManager; } });
 var sync_engine_1 = require("./lib/sync-engine");
 Object.defineProperty(exports, "SyncEngine", { enumerable: true, get: function () { return sync_engine_1.SyncEngine; } });
+var config_manager_1 = require("./lib/config-manager");
+Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return config_manager_1.ConfigManager; } });
+Object.defineProperty(exports, "configManager", { enumerable: true, get: function () { return config_manager_1.configManager; } });
+var singleton_manager_1 = require("./lib/singleton-manager");
+Object.defineProperty(exports, "getSyncEngine", { enumerable: true, get: function () { return singleton_manager_1.getSyncEngine; } });
+Object.defineProperty(exports, "resetSyncEngine", { enumerable: true, get: function () { return singleton_manager_1.resetSyncEngine; } });
+var sql_logger_1 = require("./lib/sql-logger");
+Object.defineProperty(exports, "SQLLogger", { enumerable: true, get: function () { return sql_logger_1.SQLLogger; } });
+var transaction_manager_1 = require("./lib/transaction-manager");
+Object.defineProperty(exports, "TransactionManager", { enumerable: true, get: function () { return transaction_manager_1.TransactionManager; } });
+// Service exports
+var InitService_1 = require("./services/InitService");
+Object.defineProperty(exports, "InitService", { enumerable: true, get: function () { return InitService_1.InitService; } });
+var PullService_1 = require("./services/PullService");
+Object.defineProperty(exports, "PullService", { enumerable: true, get: function () { return PullService_1.PullService; } });
+var PushService_1 = require("./services/PushService");
+Object.defineProperty(exports, "PushService", { enumerable: true, get: function () { return PushService_1.PushService; } });
+var StatusService_1 = require("./services/StatusService");
+Object.defineProperty(exports, "StatusService", { enumerable: true, get: function () { return StatusService_1.StatusService; } });
+var FileResetService_1 = require("./services/FileResetService");
+Object.defineProperty(exports, "FileResetService", { enumerable: true, get: function () { return FileResetService_1.FileResetService; } });
+var WatchService_1 = require("./services/WatchService");
+Object.defineProperty(exports, "WatchService", { enumerable: true, get: function () { return WatchService_1.WatchService; } });
+var ValidationService_1 = require("./services/ValidationService");
+Object.defineProperty(exports, "ValidationService", { enumerable: true, get: function () { return ValidationService_1.ValidationService; } });
+var FormattingService_1 = require("./services/FormattingService");
+Object.defineProperty(exports, "FormattingService", { enumerable: true, get: function () { return FormattingService_1.FormattingService; } });
+// Configuration types
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadMJConfig", { enumerable: true, get: function () { return config_1.loadMJConfig; } });
+Object.defineProperty(exports, "loadSyncConfig", { enumerable: true, get: function () { return config_1.loadSyncConfig; } });
+Object.defineProperty(exports, "loadEntityConfig", { enumerable: true, get: function () { return config_1.loadEntityConfig; } });
+Object.defineProperty(exports, "loadFolderConfig", { enumerable: true, get: function () { return config_1.loadFolderConfig; } });
+// Provider utilities
+var provider_utils_1 = require("./lib/provider-utils");
+Object.defineProperty(exports, "initializeProvider", { enumerable: true, get: function () { return provider_utils_1.initializeProvider; } });
+Object.defineProperty(exports, "getSystemUser", { enumerable: true, get: function () { return provider_utils_1.getSystemUser; } });
+Object.defineProperty(exports, "findEntityDirectories", { enumerable: true, get: function () { return provider_utils_1.findEntityDirectories; } });
+Object.defineProperty(exports, "getDataProvider", { enumerable: true, get: function () { return provider_utils_1.getDataProvider; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oCAAkC;AAAzB,2FAAA,GAAG,OAAA;AACZ,iEAA8D;AAArD,wHAAA,iBAAiB,OAAA;AAC1B,iDAA+C;AAAtC,yGAAA,UAAU,OAAA","sourcesContent":["export { run } from '@oclif/core';\nexport { FileBackupManager } from './lib/file-backup-manager';\nexport { SyncEngine } from './lib/sync-engine';\nexport type { RecordData } from './lib/sync-engine';"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAuB;AACvB,iEAA8D;AAArD,wHAAA,iBAAiB,OAAA;AAC1B,iDAA+C;AAAtC,yGAAA,UAAU,OAAA;AAEnB,uDAAoE;AAA3D,+GAAA,aAAa,OAAA;AAAE,+GAAA,aAAa,OAAA;AACrC,6DAAyE;AAAhE,kHAAA,aAAa,OAAA;AAAE,oHAAA,eAAe,OAAA;AACvC,+CAA6C;AAApC,uGAAA,SAAS,OAAA;AAClB,iEAA+D;AAAtD,yHAAA,kBAAkB,OAAA;AAE3B,kBAAkB;AAClB,sDAAqD;AAA5C,0GAAA,WAAW,OAAA;AAGpB,sDAAqD;AAA5C,0GAAA,WAAW,OAAA;AAGpB,sDAAqD;AAA5C,0GAAA,WAAW,OAAA;AAGpB,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AAGtB,gEAA+D;AAAtD,oHAAA,gBAAgB,OAAA;AAGzB,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AAGrB,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAE1B,sBAAsB;AACtB,mCAQkB;AAPhB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,0GAAA,gBAAgB,OAAA;AAChB,0GAAA,gBAAgB,OAAA;AAMlB,qBAAqB;AACrB,uDAK8B;AAJ5B,oHAAA,kBAAkB,OAAA;AAClB,+GAAA,aAAa,OAAA;AACb,uHAAA,qBAAqB,OAAA;AACrB,iHAAA,eAAe,OAAA","sourcesContent":["// Core library exports\nexport { FileBackupManager } from './lib/file-backup-manager';\nexport { SyncEngine } from './lib/sync-engine';\nexport type { RecordData } from './lib/sync-engine';\nexport { ConfigManager, configManager } from './lib/config-manager';\nexport { getSyncEngine, resetSyncEngine } from './lib/singleton-manager';\nexport { SQLLogger } from './lib/sql-logger';\nexport { TransactionManager } from './lib/transaction-manager';\n\n// Service exports\nexport { InitService } from './services/InitService';\nexport type { InitOptions, InitCallbacks } from './services/InitService';\n\nexport { PullService } from './services/PullService';\nexport type { PullOptions, PullCallbacks, PullResult } from './services/PullService';\n\nexport { PushService } from './services/PushService';\nexport type { PushOptions, PushCallbacks, PushResult } from './services/PushService';\n\nexport { StatusService } from './services/StatusService';\nexport type { StatusOptions, StatusCallbacks, StatusResult } from './services/StatusService';\n\nexport { FileResetService } from './services/FileResetService';\nexport type { FileResetOptions, FileResetCallbacks, FileResetResult } from './services/FileResetService';\n\nexport { WatchService } from './services/WatchService';\nexport type { WatchOptions, WatchCallbacks, WatchResult } from './services/WatchService';\n\nexport { ValidationService } from './services/ValidationService';\nexport { FormattingService } from './services/FormattingService';\n\n// Configuration types\nexport {\n  loadMJConfig,\n  loadSyncConfig,\n  loadEntityConfig,\n  loadFolderConfig,\n  type EntityConfig,\n  type FolderConfig,\n  type RelatedEntityConfig\n} from './config';\n\n// Provider utilities\nexport {\n  initializeProvider,\n  getSystemUser,\n  findEntityDirectories,\n  getDataProvider\n} from './lib/provider-utils';\n\n// Validation types\nexport type {\n  ValidationResult,\n  ValidationError,\n  ValidationWarning,\n  EntityDependency,\n  FileValidationResult,\n  ValidationOptions,\n  ReferenceType,\n  ParsedReference\n} from './types/validation';"]}

package/dist/lib/file-backup-manager.js

@@ -15,7 +15,7 @@ exports.FileBackupManager = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
-const global_1 = require("@memberjunction/global");
+const uuid_1 = require("uuid");
 /**
  * Manages file backups and rollback operations for MetadataSync
  *
@@ -61,7 +61,7 @@ class FileBackupManager {
         }
         // Create a unique temporary directory for this session
         const tempRoot = os_1.default.tmpdir();
-        const sessionId = (0, global_1.uuidv4)();
+        const sessionId = (0, uuid_1.v4)();
         this.backupDir = path_1.default.join(tempRoot, 'mj-metadata-sync', sessionId);
         await fs_extra_1.default.ensureDir(this.backupDir);
         this.initialized = true;

package/dist/lib/file-backup-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-backup-manager.js","sourceRoot":"","sources":["../../src/lib/file-backup-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview File backup and rollback manager for MetadataSync operations\n * @module file-backup-manager\n * \n * This module provides functionality to create backups of files before modification\n * and allows rolling back all changes if any operation fails. It ensures atomic\n * file operations by maintaining a temporary backup directory during push operations.\n */\n\nimport fs from 'fs-extra';\nimport path from 'path';\nimport os from 'os';\nimport { uuidv4 } from '@memberjunction/global';\n\n/**\n * Represents a backed-up file with its original and backup paths\n */\ninterface BackupEntry {\n  /** Original file path that was backed up */\n  originalPath: string;\n  /** Path to the backup copy of the file */\n  backupPath: string;\n  /** Whether the file existed before modification */\n  existed: boolean;\n}\n\n/**\n * Manages file backups and rollback operations for MetadataSync\n * \n * Creates temporary backups of all modified files during a push operation,\n * allowing atomic rollback of all file changes if any error occurs.\n * \n * @class FileBackupManager\n * @example\n * ```typescript\n * const backupManager = new FileBackupManager();\n * await backupManager.initialize();\n * \n * try {\n *   await backupManager.backupFile('/path/to/file.json');\n *   // Modify the file\n *   await fs.writeJson('/path/to/file.json', newData);\n *   \n *   // If all operations succeed\n *   await backupManager.cleanup();\n * } catch (error) {\n *   // Rollback all file changes\n *   await backupManager.rollback();\n *   throw error;\n * }\n * ```\n */\nexport class FileBackupManager {\n  private backupDir: string = '';\n  private backups: BackupEntry[] = [];\n  private initialized: boolean = false;\n  \n  /**\n   * Initialize the backup manager by creating a temporary directory\n   * \n   * Creates a unique temporary directory for storing file backups during\n   * the current operation. Must be called before any backup operations.\n   * \n   * @returns Promise that resolves when initialization is complete\n   * @throws Error if temporary directory creation fails\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      throw new Error('FileBackupManager already initialized');\n    }\n    \n    // Create a unique temporary directory for this session\n    const tempRoot = os.tmpdir();\n    const sessionId = uuidv4();\n    this.backupDir = path.join(tempRoot, 'mj-metadata-sync', sessionId);\n    \n    await fs.ensureDir(this.backupDir);\n    this.initialized = true;\n  }\n  \n  /**\n   * Create a backup of a file before modification\n   * \n   * Copies the current state of a file to the backup directory. If the file\n   * doesn't exist, records that fact for proper rollback handling.\n   * \n   * @param filePath - Absolute path to the file to backup\n   * @returns Promise that resolves when backup is complete\n   * @throws Error if backup operation fails\n   */\n  async backupFile(filePath: string): Promise<void> {\n    if (!this.initialized) {\n      throw new Error('FileBackupManager not initialized. Call initialize() first.');\n    }\n    \n    // Check if we already have a backup for this file\n    const existingBackup = this.backups.find(b => b.originalPath === filePath);\n    if (existingBackup) {\n      // Already backed up, don't backup again\n      return;\n    }\n    \n    const exists = await fs.pathExists(filePath);\n    const backupFileName = `${path.basename(filePath)}_${Date.now()}_${this.backups.length}`;\n    const backupPath = path.join(this.backupDir, backupFileName);\n    \n    const backupEntry: BackupEntry = {\n      originalPath: filePath,\n      backupPath: backupPath,\n      existed: exists\n    };\n    \n    if (exists) {\n      // Copy the file to backup location\n      await fs.copy(filePath, backupPath);\n    }\n    \n    this.backups.push(backupEntry);\n  }\n  \n  /**\n   * Rollback all file changes by restoring from backups\n   * \n   * Restores all backed-up files to their original state. Files that didn't\n   * exist before the operation are deleted. This operation is atomic - either\n   * all files are restored or none are.\n   * \n   * @returns Promise that resolves when rollback is complete\n   * @throws Error if any rollback operation fails\n   */\n  async rollback(): Promise<void> {\n    if (!this.initialized) {\n      return; // Nothing to rollback\n    }\n    \n    const errors: string[] = [];\n    \n    // Process backups in reverse order (last modified first)\n    for (const backup of this.backups.reverse()) {\n      try {\n        if (backup.existed) {\n          // Restore the original file\n          await fs.copy(backup.backupPath, backup.originalPath, { overwrite: true });\n        } else {\n          // File didn't exist before, remove it\n          if (await fs.pathExists(backup.originalPath)) {\n            await fs.remove(backup.originalPath);\n          }\n        }\n      } catch (error) {\n        const errorMsg = `Failed to rollback ${backup.originalPath}: ${error instanceof Error ? error.message : String(error)}`;\n        errors.push(errorMsg);\n        console.error(errorMsg);\n      }\n    }\n    \n    // Clean up backup directory\n    try {\n      await this.cleanup();\n    } catch (error) {\n      console.error('Failed to cleanup backup directory during rollback:', error);\n    }\n    \n    if (errors.length > 0) {\n      throw new Error(`Rollback completed with errors:\\n${errors.join('\\n')}`);\n    }\n  }\n  \n  /**\n   * Clean up backup directory after successful operation\n   * \n   * Removes all temporary backup files and the backup directory. Should be\n   * called after all operations complete successfully.\n   * \n   * @returns Promise that resolves when cleanup is complete\n   */\n  async cleanup(): Promise<void> {\n    if (!this.initialized || !this.backupDir) {\n      return;\n    }\n    \n    try {\n      await fs.remove(this.backupDir);\n    } catch (error) {\n      // Log but don't throw - cleanup errors shouldn't fail the operation\n      console.warn(`Failed to cleanup backup directory ${this.backupDir}:`, error);\n    }\n    \n    this.backups = [];\n    this.initialized = false;\n    this.backupDir = '';\n  }\n  \n  /**\n   * Get statistics about current backup session\n   * \n   * @returns Object containing backup statistics\n   */\n  getStats(): { totalBackups: number; backupDir: string; initialized: boolean } {\n    return {\n      totalBackups: this.backups.length,\n      backupDir: this.backupDir,\n      initialized: this.initialized\n    };\n  }\n}"]}
+{"version":3,"file":"file-backup-manager.js","sourceRoot":"","sources":["../../src/lib/file-backup-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview File backup and rollback manager for MetadataSync operations\n * @module file-backup-manager\n * \n * This module provides functionality to create backups of files before modification\n * and allows rolling back all changes if any operation fails. It ensures atomic\n * file operations by maintaining a temporary backup directory during push operations.\n */\n\nimport fs from 'fs-extra';\nimport path from 'path';\nimport os from 'os';\nimport { v4 as uuidv4 } from 'uuid';\n\n/**\n * Represents a backed-up file with its original and backup paths\n */\ninterface BackupEntry {\n  /** Original file path that was backed up */\n  originalPath: string;\n  /** Path to the backup copy of the file */\n  backupPath: string;\n  /** Whether the file existed before modification */\n  existed: boolean;\n}\n\n/**\n * Manages file backups and rollback operations for MetadataSync\n * \n * Creates temporary backups of all modified files during a push operation,\n * allowing atomic rollback of all file changes if any error occurs.\n * \n * @class FileBackupManager\n * @example\n * ```typescript\n * const backupManager = new FileBackupManager();\n * await backupManager.initialize();\n * \n * try {\n *   await backupManager.backupFile('/path/to/file.json');\n *   // Modify the file\n *   await fs.writeJson('/path/to/file.json', newData);\n *   \n *   // If all operations succeed\n *   await backupManager.cleanup();\n * } catch (error) {\n *   // Rollback all file changes\n *   await backupManager.rollback();\n *   throw error;\n * }\n * ```\n */\nexport class FileBackupManager {\n  private backupDir: string = '';\n  private backups: BackupEntry[] = [];\n  private initialized: boolean = false;\n  \n  /**\n   * Initialize the backup manager by creating a temporary directory\n   * \n   * Creates a unique temporary directory for storing file backups during\n   * the current operation. Must be called before any backup operations.\n   * \n   * @returns Promise that resolves when initialization is complete\n   * @throws Error if temporary directory creation fails\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      throw new Error('FileBackupManager already initialized');\n    }\n    \n    // Create a unique temporary directory for this session\n    const tempRoot = os.tmpdir();\n    const sessionId = uuidv4();\n    this.backupDir = path.join(tempRoot, 'mj-metadata-sync', sessionId);\n    \n    await fs.ensureDir(this.backupDir);\n    this.initialized = true;\n  }\n  \n  /**\n   * Create a backup of a file before modification\n   * \n   * Copies the current state of a file to the backup directory. If the file\n   * doesn't exist, records that fact for proper rollback handling.\n   * \n   * @param filePath - Absolute path to the file to backup\n   * @returns Promise that resolves when backup is complete\n   * @throws Error if backup operation fails\n   */\n  async backupFile(filePath: string): Promise<void> {\n    if (!this.initialized) {\n      throw new Error('FileBackupManager not initialized. Call initialize() first.');\n    }\n    \n    // Check if we already have a backup for this file\n    const existingBackup = this.backups.find(b => b.originalPath === filePath);\n    if (existingBackup) {\n      // Already backed up, don't backup again\n      return;\n    }\n    \n    const exists = await fs.pathExists(filePath);\n    const backupFileName = `${path.basename(filePath)}_${Date.now()}_${this.backups.length}`;\n    const backupPath = path.join(this.backupDir, backupFileName);\n    \n    const backupEntry: BackupEntry = {\n      originalPath: filePath,\n      backupPath: backupPath,\n      existed: exists\n    };\n    \n    if (exists) {\n      // Copy the file to backup location\n      await fs.copy(filePath, backupPath);\n    }\n    \n    this.backups.push(backupEntry);\n  }\n  \n  /**\n   * Rollback all file changes by restoring from backups\n   * \n   * Restores all backed-up files to their original state. Files that didn't\n   * exist before the operation are deleted. This operation is atomic - either\n   * all files are restored or none are.\n   * \n   * @returns Promise that resolves when rollback is complete\n   * @throws Error if any rollback operation fails\n   */\n  async rollback(): Promise<void> {\n    if (!this.initialized) {\n      return; // Nothing to rollback\n    }\n    \n    const errors: string[] = [];\n    \n    // Process backups in reverse order (last modified first)\n    for (const backup of this.backups.reverse()) {\n      try {\n        if (backup.existed) {\n          // Restore the original file\n          await fs.copy(backup.backupPath, backup.originalPath, { overwrite: true });\n        } else {\n          // File didn't exist before, remove it\n          if (await fs.pathExists(backup.originalPath)) {\n            await fs.remove(backup.originalPath);\n          }\n        }\n      } catch (error) {\n        const errorMsg = `Failed to rollback ${backup.originalPath}: ${error instanceof Error ? error.message : String(error)}`;\n        errors.push(errorMsg);\n        console.error(errorMsg);\n      }\n    }\n    \n    // Clean up backup directory\n    try {\n      await this.cleanup();\n    } catch (error) {\n      console.error('Failed to cleanup backup directory during rollback:', error);\n    }\n    \n    if (errors.length > 0) {\n      throw new Error(`Rollback completed with errors:\\n${errors.join('\\n')}`);\n    }\n  }\n  \n  /**\n   * Clean up backup directory after successful operation\n   * \n   * Removes all temporary backup files and the backup directory. Should be\n   * called after all operations complete successfully.\n   * \n   * @returns Promise that resolves when cleanup is complete\n   */\n  async cleanup(): Promise<void> {\n    if (!this.initialized || !this.backupDir) {\n      return;\n    }\n    \n    try {\n      await fs.remove(this.backupDir);\n    } catch (error) {\n      // Log but don't throw - cleanup errors shouldn't fail the operation\n      console.warn(`Failed to cleanup backup directory ${this.backupDir}:`, error);\n    }\n    \n    this.backups = [];\n    this.initialized = false;\n    this.backupDir = '';\n  }\n  \n  /**\n   * Get statistics about current backup session\n   * \n   * @returns Object containing backup statistics\n   */\n  getStats(): { totalBackups: number; backupDir: string; initialized: boolean } {\n    return {\n      totalBackups: this.backups.length,\n      backupDir: this.backupDir,\n      initialized: this.initialized\n    };\n  }\n}"]}

package/dist/lib/sql-logger.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview SQL Logger for capturing database operations during metadata sync
+ * @module sql-logger
+ *
+ * This module provides SQL logging functionality to capture all database operations
+ * during push commands. It supports both raw SQL logging and migration-formatted output.
+ */
+import { SyncConfig } from '../config';
+export interface SQLLoggerOptions {
+    enabled: boolean;
+    outputDirectory: string;
+    formatAsMigration: boolean;
+}
+export declare class SQLLogger {
+    private options;
+    private statements;
+    private isInitialized;
+    constructor(syncConfig: SyncConfig | null);
+    get enabled(): boolean;
+    /**
+     * Initialize the SQL logger and prepare output directory
+     */
+    initialize(): Promise<void>;
+    /**
+     * Log a SQL statement
+     */
+    logStatement(sql: string, params?: any[]): void;
+    /**
+     * Log a transaction boundary
+     */
+    logTransaction(action: 'BEGIN' | 'COMMIT' | 'ROLLBACK'): void;
+    /**
+     * Write the collected SQL statements to file
+     */
+    writeLog(): Promise<string | undefined>;
+    /**
+     * Clear all logged statements
+     */
+    clear(): void;
+    /**
+     * Format a parameter value for SQL
+     */
+    private formatParamValue;
+}

package/dist/lib/sql-logger.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * @fileoverview SQL Logger for capturing database operations during metadata sync
+ * @module sql-logger
+ *
+ * This module provides SQL logging functionality to capture all database operations
+ * during push commands. It supports both raw SQL logging and migration-formatted output.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLLogger = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+class SQLLogger {
+    options;
+    statements = [];
+    isInitialized = false;
+    constructor(syncConfig) {
+        this.options = {
+            enabled: syncConfig?.sqlLogging?.enabled || false,
+            outputDirectory: syncConfig?.sqlLogging?.outputDirectory || './sql_logging',
+            formatAsMigration: syncConfig?.sqlLogging?.formatAsMigration || false
+        };
+    }
+    get enabled() {
+        return this.options.enabled;
+    }
+    /**
+     * Initialize the SQL logger and prepare output directory
+     */
+    async initialize() {
+        if (!this.options.enabled || this.isInitialized) {
+            return;
+        }
+        // Ensure output directory exists
+        await fs_extra_1.default.ensureDir(this.options.outputDirectory);
+        this.isInitialized = true;
+    }
+    /**
+     * Log a SQL statement
+     */
+    logStatement(sql, params) {
+        if (!this.options.enabled) {
+            return;
+        }
+        // Format SQL with parameters inline for readability
+        let formattedSql = sql;
+        if (params && params.length > 0) {
+            // Replace parameter placeholders with actual values
+            params.forEach((param, index) => {
+                const placeholder = `@param${index + 1}`;
+                const value = this.formatParamValue(param);
+                formattedSql = formattedSql.replace(new RegExp(placeholder, 'g'), value);
+            });
+        }
+        this.statements.push(formattedSql);
+    }
+    /**
+     * Log a transaction boundary
+     */
+    logTransaction(action) {
+        if (!this.options.enabled) {
+            return;
+        }
+        this.statements.push(`${action} TRANSACTION;`);
+    }
+    /**
+     * Write the collected SQL statements to file
+     */
+    async writeLog() {
+        if (!this.options.enabled || this.statements.length === 0) {
+            return undefined;
+        }
+        await this.initialize();
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        let filename;
+        let content;
+        if (this.options.formatAsMigration) {
+            // Format as Flyway migration
+            const migrationTimestamp = timestamp.replace(/[-T]/g, '').substring(0, 14);
+            filename = `V${migrationTimestamp}__MetadataSync_Push.sql`;
+            content = [
+                '-- MemberJunction MetadataSync Push Migration',
+                `-- Generated at: ${new Date().toISOString()}`,
+                '-- Description: Metadata changes pushed via mj sync push command',
+                '',
+                '-- Note: Schema placeholders can be replaced during deployment',
+                '-- Replace ${flyway:defaultSchema} with your target schema name',
+                '',
+                ...this.statements.map(stmt => {
+                    // Add schema placeholders for migration format
+                    return stmt.replace(/(\[?)__mj(\]?)\./g, '${flyway:defaultSchema}.');
+                })
+            ].join('\n');
+        }
+        else {
+            // Regular SQL log format
+            filename = `metadatasync-push-${timestamp}.sql`;
+            content = [
+                '-- MemberJunction MetadataSync SQL Log',
+                `-- Generated at: ${new Date().toISOString()}`,
+                `-- Total statements: ${this.statements.length}`,
+                '',
+                ...this.statements
+            ].join('\n');
+        }
+        const filePath = path_1.default.join(this.options.outputDirectory, filename);
+        await fs_extra_1.default.writeFile(filePath, content, 'utf8');
+        return filePath;
+    }
+    /**
+     * Clear all logged statements
+     */
+    clear() {
+        this.statements = [];
+    }
+    /**
+     * Format a parameter value for SQL
+     */
+    formatParamValue(value) {
+        if (value === null) {
+            return 'NULL';
+        }
+        if (typeof value === 'string') {
+            // Escape single quotes and wrap in quotes
+            return `'${value.replace(/'/g, "''")}'`;
+        }
+        if (typeof value === 'boolean') {
+            return value ? '1' : '0';
+        }
+        if (value instanceof Date) {
+            return `'${value.toISOString()}'`;
+        }
+        return String(value);
+    }
+}
+exports.SQLLogger = SQLLogger;
+//# sourceMappingURL=sql-logger.js.map