@memberjunction/metadata-sync 2.47.0 → 2.48.0

package/dist/lib/provider-utils.js

@@ -38,6 +38,10 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 /** Global DataSource instance for connection lifecycle management */
 let globalDataSource = null;
+/** Global provider instance to ensure single initialization */
+let globalProvider = null;
+/** Promise to track ongoing initialization */
+let initializationPromise = null;
 /**
  * Initialize a SQLServerDataProvider with the given configuration
  *
@@ -57,32 +61,45 @@ let globalDataSource = null;
  * ```
  */
 async function initializeProvider(config) {
-    // Create TypeORM DataSource
-    const dataSource = new typeorm_1.DataSource({
-        type: 'mssql',
-        host: config.dbHost,
-        port: config.dbPort ? Number(config.dbPort) : 1433,
-        database: config.dbDatabase,
-        username: config.dbUsername,
-        password: config.dbPassword,
-        synchronize: false,
-        logging: false,
-        options: {
-            encrypt: config.dbEncrypt === 'Y' || config.dbEncrypt === 'true' ||
-                config.dbHost.includes('.database.windows.net'), // Auto-detect Azure SQL
-            trustServerCertificate: config.dbTrustServerCertificate === 'Y',
-            instanceName: config.dbInstanceName
-        }
-    });
-    // Initialize the data source
-    await dataSource.initialize();
-    // Store for cleanup
-    globalDataSource = dataSource;
-    // Create provider config
-    const providerConfig = new sqlserver_dataprovider_1.SQLServerProviderConfigData(dataSource, 'system@sync.cli', // Default user for CLI
-    config.mjCoreSchema || '__mj', 0);
-    // Use setupSQLServerClient to properly initialize
-    return await (0, sqlserver_dataprovider_1.setupSQLServerClient)(providerConfig);
+    // Return existing provider if already initialized
+    if (globalProvider) {
+        return globalProvider;
+    }
+    // Return ongoing initialization if in progress
+    if (initializationPromise) {
+        return initializationPromise;
+    }
+    // Start new initialization
+    initializationPromise = (async () => {
+        // Create TypeORM DataSource
+        const dataSource = new typeorm_1.DataSource({
+            type: 'mssql',
+            host: config.dbHost,
+            port: config.dbPort ? Number(config.dbPort) : 1433,
+            database: config.dbDatabase,
+            username: config.dbUsername,
+            password: config.dbPassword,
+            synchronize: false,
+            logging: false,
+            options: {
+                encrypt: config.dbEncrypt === 'Y' || config.dbEncrypt === 'true' ||
+                    config.dbHost.includes('.database.windows.net'), // Auto-detect Azure SQL
+                trustServerCertificate: config.dbTrustServerCertificate === 'Y',
+                instanceName: config.dbInstanceName
+            }
+        });
+        // Initialize the data source
+        await dataSource.initialize();
+        // Store for cleanup
+        globalDataSource = dataSource;
+        // Create provider config
+        const providerConfig = new sqlserver_dataprovider_1.SQLServerProviderConfigData(dataSource, 'system@sync.cli', // Default user for CLI
+        config.mjCoreSchema || '__mj', 0);
+        // Use setupSQLServerClient to properly initialize
+        globalProvider = await (0, sqlserver_dataprovider_1.setupSQLServerClient)(providerConfig);
+        return globalProvider;
+    })();
+    return initializationPromise;
 }
 exports.initializeProvider = initializeProvider;
 /**
@@ -107,6 +124,8 @@ async function cleanupProvider() {
         await globalDataSource.destroy();
         globalDataSource = null;
     }
+    globalProvider = null;
+    initializationPromise = null;
 }
 exports.cleanupProvider = cleanupProvider;
 /**

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

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

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

package/dist/lib/singleton-manager.js

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

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

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

package/oclif.manifest.json

@@ -24,47 +24,47 @@
         "index.js"
       ]
     },
-    "pull": {
+    "push": {
       "aliases": [],
       "args": {},
-      "description": "Pull metadata from database to local files",
+      "description": "Push local file changes to the database",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\"",
-        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\" --filter=\"CategoryID='customer-service-id'\""
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dry-run",
+        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
+        "<%= config.bin %> <%= command.id %> --ci"
       ],
       "flags": {
-        "entity": {
-          "description": "Entity name to pull",
-          "name": "entity",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter": {
-          "description": "Additional filter for pulling specific records",
-          "name": "filter",
+        "dir": {
+          "description": "Specific entity directory to push",
+          "name": "dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "dry-run": {
-          "description": "Show what would be pulled without actually pulling",
+          "description": "Show what would be pushed without actually pushing",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
-        "multi-file": {
-          "description": "Create a single file with multiple records (provide filename)",
-          "name": "multi-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "ci": {
+          "description": "CI mode - no prompts, fail on issues",
+          "name": "ci",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed field-level output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pull",
+      "id": "push",
       "pluginAlias": "@memberjunction/metadata-sync",
       "pluginName": "@memberjunction/metadata-sync",
       "pluginType": "core",
@@ -74,43 +74,50 @@
       "relativePath": [
         "dist",
         "commands",
-        "pull",
+        "push",
         "index.js"
       ]
     },
-    "push": {
+    "pull": {
       "aliases": [],
       "args": {},
-      "description": "Push local file changes to the database",
+      "description": "Pull metadata from database to local files",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dry-run",
-        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --ci"
+        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\"",
+        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\" --filter=\"CategoryID='customer-service-id'\""
       ],
       "flags": {
-        "dir": {
-          "description": "Specific entity directory to push",
-          "name": "dir",
+        "entity": {
+          "description": "Entity name to pull",
+          "name": "entity",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Additional filter for pulling specific records",
+          "name": "filter",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "dry-run": {
-          "description": "Show what would be pushed without actually pushing",
+          "description": "Show what would be pulled without actually pulling",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
-        "ci": {
-          "description": "CI mode - no prompts, fail on issues",
-          "name": "ci",
-          "allowNo": false,
-          "type": "boolean"
+        "multi-file": {
+          "description": "Create a single file with multiple records (provide filename)",
+          "name": "multi-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "verbose": {
           "char": "v",
-          "description": "Show detailed field-level output",
+          "description": "Show detailed output",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -118,7 +125,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "push",
+      "id": "pull",
       "pluginAlias": "@memberjunction/metadata-sync",
       "pluginName": "@memberjunction/metadata-sync",
       "pluginType": "core",
@@ -128,7 +135,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "push",
+        "pull",
         "index.js"
       ]
     },
@@ -199,5 +206,5 @@
       ]
     }
   },
-  "version": "2.47.0"
+  "version": "2.48.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/metadata-sync",
-  "version": "2.47.0",
+  "version": "2.48.0",
   "description": "MemberJunction metadata synchronization CLI tool",
   "keywords": [
     "oclif",
@@ -51,11 +51,11 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^5.0.1",
-    "@memberjunction/core": "2.47.0",
-    "@memberjunction/core-entities": "2.47.0",
-    "@memberjunction/core-entities-server": "2.47.0",
-    "@memberjunction/sqlserver-dataprovider": "2.47.0",
-    "@memberjunction/graphql-dataprovider": "2.47.0",
+    "@memberjunction/core": "2.48.0",
+    "@memberjunction/core-entities": "2.48.0",
+    "@memberjunction/core-entities-server": "2.48.0",
+    "@memberjunction/sqlserver-dataprovider": "2.48.0",
+    "@memberjunction/graphql-dataprovider": "2.48.0",
     "@oclif/core": "^3",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-version": "^2.0.17",