@inforge/migrations-tools-cli 1.1.0 → 1.2.0

package/README.md

@@ -103,6 +103,35 @@ Select "Logs" to see recent operations with status, timestamps, and details.
 
 All operations are logged to `.logs/operations.log` (JSON format, one per line).
 
+## Debugging
+
+### Debug Logs
+
+When errors occur, detailed error information including stack traces and API request/response data is automatically logged to `.logs/debug.log`. The error message will show you the exact path to the debug log file.
+
+**Example error message:**
+```
+Failed to apply changes: The requested resource does not exist
+
+Error details logged to: /path/to/your/project/.logs/debug.log
+```
+
+### Enable Verbose Debug Logging
+
+For more detailed troubleshooting, enable debug mode to see all API calls and internal operations:
+
+```bash
+DEBUG=true imigrate
+```
+
+This will log detailed information about:
+- API queries and their results
+- Request/response payloads
+- Internal state changes
+- Detailed error contexts
+
+Debug logs are written in JSON format with timestamps and structured context for easy analysis.
+
 ## Safety Features
 
 ### Atomic Operations

package/dist/index.js

@@ -248,12 +248,15 @@ var BackupManager = class {
 // src/core/logger.ts
 import * as fs2 from "fs/promises";
 import * as path2 from "path";
-var Logger = class {
+var Logger = class _Logger {
   logDir;
   logFile;
+  debugLogFile;
+  static debugEnabled = process.env.DEBUG === "true";
   constructor(logDir = ".logs") {
     this.logDir = logDir;
     this.logFile = path2.join(logDir, "operations.log");
+    this.debugLogFile = path2.join(logDir, "debug.log");
   }
   async log(operation) {
     await this.ensureLogDir();
@@ -277,6 +280,38 @@ var Logger = class {
     const random = Math.random().toString(36).substring(2, 9);
     return `op_${timestamp}${random}`;
   }
+  async debug(message, context) {
+    await this.writeDebugLog("DEBUG", message, context);
+  }
+  async info(message, context) {
+    await this.writeDebugLog("INFO", message, context);
+  }
+  async error(message, error, context) {
+    const errorDetails = error ? {
+      message: error.message || String(error),
+      stack: error.stack,
+      details: error.response?.data || error.details || error
+    } : void 0;
+    await this.writeDebugLog("ERROR", message, context, errorDetails);
+  }
+  getDebugLogPath() {
+    return path2.resolve(this.debugLogFile);
+  }
+  async writeDebugLog(level, message, context, error) {
+    if (!_Logger.debugEnabled && level === "DEBUG") {
+      return;
+    }
+    await this.ensureLogDir();
+    const entry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      message,
+      ...context && { context },
+      ...error && { error }
+    };
+    const logLine = JSON.stringify(entry, null, 2) + "\n---\n";
+    await fs2.appendFile(this.debugLogFile, logLine, "utf-8");
+  }
   async ensureLogDir() {
     try {
       await fs2.mkdir(this.logDir, { recursive: true });
@@ -427,6 +462,10 @@ var FlowsHandler = class {
 
 // src/core/metadata/triggers.ts
 var TriggersHandler = class {
+  logger;
+  constructor() {
+    this.logger = new Logger();
+  }
   async fetch(connection, objectName) {
     const query = `
       SELECT Id, Name, TableEnumOrId, Status, NamespacePrefix
@@ -465,17 +504,58 @@ var TriggersHandler = class {
     await this.updateStatus(connection, triggerNames, "Active");
   }
   async updateStatus(connection, triggerNames, status) {
-    const metadata = await connection.metadata.read("ApexTrigger", triggerNames);
-    const updates = metadata.map((trigger) => ({
-      ...trigger,
+    await this.logger.debug("TriggersHandler.updateStatus called", {
+      triggerNames,
       status
-    }));
-    const results = await connection.metadata.update("ApexTrigger", updates);
-    if (Array.isArray(results)) {
-      const failures = results.filter((r) => !r.success);
-      if (failures.length > 0) {
-        throw new Error(`Failed to update ${failures.length} trigger(s)`);
+    });
+    const query = `
+      SELECT Id, Name
+      FROM ApexTrigger
+      WHERE Name IN (${triggerNames.map((n) => `'${n}'`).join(", ")})
+    `;
+    await this.logger.debug("Executing Tooling API query", { query });
+    try {
+      const result = await connection.tooling.query(query);
+      await this.logger.debug("Query result", {
+        recordCount: result.records.length,
+        records: result.records
+      });
+      if (result.records.length === 0) {
+        await this.logger.error("No triggers found with specified names", null, {
+          triggerNames,
+          query
+        });
+        throw new Error("No triggers found with the specified names");
+      }
+      const updates = result.records.map((trigger) => ({
+        Id: trigger.Id,
+        Status: status
+      }));
+      await this.logger.debug("Preparing Tooling API update", { updates });
+      const results = await connection.tooling.update("ApexTrigger", updates);
+      await this.logger.debug("Tooling API update results", {
+        results: Array.isArray(results) ? results : [results]
+      });
+      if (Array.isArray(results)) {
+        const failures = results.filter((r) => !r.success);
+        if (failures.length > 0) {
+          await this.logger.error("Some triggers failed to update", null, {
+            failures,
+            totalAttempted: results.length
+          });
+          throw new Error(`Failed to update ${failures.length} trigger(s): ${JSON.stringify(failures)}`);
+        }
       }
+      await this.logger.info("Successfully updated trigger status", {
+        triggerCount: triggerNames.length,
+        status
+      });
+    } catch (error) {
+      await this.logger.error("Error in updateStatus", error, {
+        triggerNames,
+        status
+      });
+      throw error;
     }
   }
 };
@@ -1191,6 +1271,14 @@ Select items to toggle (Space to select, Enter to continue):`,
       );
     } catch (error) {
       applySpinner.stop("Changes failed");
+      await this.logger.error("Failed to apply changes in IndividualCommand", error, {
+        org: org.alias,
+        object: selectedObject,
+        automationType,
+        selectedFullNames,
+        toActivate,
+        toDeactivate
+      });
       await this.logger.log({
         id: operationId,
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -1204,7 +1292,10 @@ Select items to toggle (Space to select, Enter to continue):`,
         backupPath,
         error: error.message
       });
-      this.prompts.error(`Failed to apply changes: ${error.message}`);
+      const debugLogPath = this.logger.getDebugLogPath();
+      this.prompts.error(`Failed to apply changes: ${error.message}
+
+Error details logged to: ${debugLogPath}`);
       throw error;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inforge/migrations-tools-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Inforge's interactive CLI for side-effect-free Salesforce data operations by managing automation",
   "main": "index.js",
   "type": "module",