sf-raven 1.2.2 → 1.3.0

package/oclif.manifest.json

@@ -130,15 +130,12 @@
         "display.js"
       ]
     },
-    "raven:event:subscribe": {
+    "raven:deploy:cancel": {
       "aliases": [],
       "args": {},
-      "description": "Platform Events are printed to the terminal. An optional flag can be used to relay events from a given relayid. Defaut timeout is 3 minutes, but can be extended to 30 minutes.",
+      "description": "Query the target org for pending or in-progress deploy requests, select one from an interactive list, confirm the cancellation, and submit an asynchronous deploy cancel request.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e",
-        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --replayid 21980378",
-        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --timeout 10",
-        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --replayid 21980378 --timeout 10"
+        "Cancel a deploy in the default org:\n\n<%= config.bin %> <%= command.id %>\n\nCancel a deploy in a specific org:\n\n<%= config.bin %> <%= command.id %> --target-org dev"
       ],
       "flags": {
         "json": {
@@ -160,63 +157,39 @@
           "char": "o",
           "name": "target-org",
           "noCacheDefault": true,
-          "required": true,
-          "summary": "Login username or alias for the target org.",
+          "summary": "Login username or alias for the target org. Uses the default org when omitted.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "event": {
-          "char": "e",
-          "name": "event",
-          "required": true,
-          "summary": "The name of the Platform Event that you want to subscribe with '/event/' prefix eg. /event/My_Event\\_\\_e.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "replayid": {
-          "char": "r",
-          "name": "replayid",
-          "summary": "The replay id to replay events from eg. 21980378.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "timeout": {
-          "char": "t",
-          "name": "timeout",
-          "summary": "How long to subscribe for before timing out in minutes eg. 10. Default is 3 minutes.",
-          "default": 3,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "raven:event:subscribe",
+      "id": "raven:deploy:cancel",
       "pluginAlias": "sf-raven",
       "pluginName": "sf-raven",
       "pluginType": "core",
       "strict": true,
-      "summary": "Subscribe to Platform Events.",
+      "summary": "Cancel a pending or in-progress Salesforce deploy.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "raven",
-        "event",
-        "subscribe.js"
+        "deploy",
+        "cancel.js"
       ]
     },
-    "raven:deploy:cancel": {
+    "raven:event:subscribe": {
       "aliases": [],
       "args": {},
-      "description": "Query the target org for pending or in-progress deploy requests, select one from an interactive list, confirm the cancellation, and submit an asynchronous deploy cancel request.",
+      "description": "Platform Events are printed to the terminal. An optional flag can be used to relay events from a given relayid. Defaut timeout is 3 minutes, but can be extended to 30 minutes.",
       "examples": [
-        "Cancel a deploy in the default org:\n\n<%= config.bin %> <%= command.id %>\n\nCancel a deploy in a specific org:\n\n<%= config.bin %> <%= command.id %> --target-org dev"
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e",
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --replayid 21980378",
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --timeout 10",
+        "<%= config.bin %> <%= command.id %> --target-org dev --event /event/My_Event\\_\\_e --replayid 21980378 --timeout 10"
       ],
       "flags": {
         "json": {
@@ -238,34 +211,61 @@
           "char": "o",
           "name": "target-org",
           "noCacheDefault": true,
-          "summary": "Login username or alias for the target org. Uses the default org when omitted.",
+          "required": true,
+          "summary": "Login username or alias for the target org.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
+        },
+        "event": {
+          "char": "e",
+          "name": "event",
+          "required": true,
+          "summary": "The name of the Platform Event that you want to subscribe with '/event/' prefix eg. /event/My_Event\\_\\_e.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "replayid": {
+          "char": "r",
+          "name": "replayid",
+          "summary": "The replay id to replay events from eg. 21980378.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "char": "t",
+          "name": "timeout",
+          "summary": "How long to subscribe for before timing out in minutes eg. 10. Default is 3 minutes.",
+          "default": 3,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "raven:deploy:cancel",
+      "id": "raven:event:subscribe",
       "pluginAlias": "sf-raven",
       "pluginName": "sf-raven",
       "pluginType": "core",
       "strict": true,
-      "summary": "Cancel a pending or in-progress Salesforce deploy.",
+      "summary": "Subscribe to Platform Events.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "raven",
-        "deploy",
-        "cancel.js"
+        "event",
+        "subscribe.js"
       ]
     },
     "raven:pull:remote": {
       "aliases": [],
       "args": {},
-      "description": "List supported metadata components that exist in the target org but are not present in the local project. Org-only components are prefixed with a cloud marker in fzf. Press Tab to select multiple components, then Enter to retrieve them.",
+      "description": "Select a configured metadata type, then list components of that type that exist in the target org but are not present in the local project. Org-only components are prefixed with a cloud marker in fzf. Press Tab to select multiple components, then Enter to retrieve them.",
       "examples": [
         "Retrieve selected remote-only metadata from the default org:\n\n<%= config.bin %> <%= command.id %>\n\nRetrieve selected remote-only metadata from a specific org:\n\n<%= config.bin %> <%= command.id %> --target-org dev"
       ],
@@ -552,7 +552,148 @@
         "display",
         "recordtypes.js"
       ]
+    },
+    "raven:pull:remote:type:add": {
+      "aliases": [],
+      "args": {},
+      "description": "List metadata types available in the target org and select one or more to add to this project's `sf raven pull remote` configuration. Press Tab to select multiple types in fzf, then Enter to save them.",
+      "examples": [
+        "Add metadata types from the default org:\n\n<%= config.bin %> <%= command.id %>\n\nAdd metadata types from a specific org:\n\n<%= config.bin %> <%= command.id %> --target-org dev"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "required": false,
+          "summary": "Login username or alias for the target org. Uses the default org when omitted.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "raven:pull:remote:type:add",
+      "pluginAlias": "sf-raven",
+      "pluginName": "sf-raven",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Add metadata types supported by remote pull.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "raven",
+        "pull",
+        "remote",
+        "type",
+        "add.js"
+      ]
+    },
+    "raven:pull:remote:type:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Display the metadata types that `sf raven pull remote` can inspect. If no project configuration has been saved yet, the list is derived from metadata types already present in the local project.",
+      "examples": [
+        "List supported remote pull metadata types:\n\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "raven:pull:remote:type:list",
+      "pluginAlias": "sf-raven",
+      "pluginName": "sf-raven",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List metadata types supported by remote pull.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "raven",
+        "pull",
+        "remote",
+        "type",
+        "list.js"
+      ]
+    },
+    "raven:pull:remote:type:remove": {
+      "aliases": [],
+      "args": {},
+      "description": "Select one or more metadata types to remove from this project's `sf raven pull remote` configuration. Press Tab to select multiple types in fzf, then Enter to save the updated list.",
+      "examples": [
+        "Remove metadata types from remote pull:\n\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "raven:pull:remote:type:remove",
+      "pluginAlias": "sf-raven",
+      "pluginName": "sf-raven",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Remove metadata types supported by remote pull.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "raven",
+        "pull",
+        "remote",
+        "type",
+        "remove.js"
+      ]
     }
   },
-  "version": "1.2.2"
+  "version": "1.3.0"
 }

package/package.json

@@ -1,33 +1,46 @@
 {
   "name": "sf-raven",
   "description": "A custom sf plugin built by @tomcarman",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "dependencies": {
-    "@inquirer/select": "^2.4.2",
+    "@inquirer/select": "2.4.2",
     "@oclif/core": "^4.0.14",
     "@salesforce/core": "^8.2.3",
     "@salesforce/kit": "^3.1.6",
     "@salesforce/sf-plugins-core": "^11.3.12",
+    "@salesforce/source-deploy-retrieve": "^12.36.1",
     "@salesforce/ts-types": "^2.0.10",
-    "dayjs": "^1.11.10",
+    "dayjs": "^1.11.20",
     "jsforce": "^3.3.1",
     "node-emoji": "^2.1.3",
     "pinst": "^3.0.0"
   },
   "private": false,
   "devDependencies": {
-    "@oclif/plugin-command-snapshot": "^5.2.3",
+    "@oclif/plugin-command-snapshot": "^5.3.21",
     "@salesforce/cli-plugins-testkit": "^5.3.58",
     "@salesforce/dev-scripts": "^10.2.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.19.41",
-    "eslint-plugin-sf-plugin": "^1.19.1",
+    "eslint-plugin-sf-plugin": "^1.20.33",
     "husky": "^9.1.1",
     "oclif": "^4.23.7",
-    "shx": "0.3.4",
+    "shx": "0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "wireit": "^0.14.5"
+    "wireit": "^0.14.12"
+  },
+  "overrides": {
+    "linkinator": {
+      "glob": "12.0.0"
+    },
+    "wireit": {
+      "brace-expansion": "5.0.6"
+    }
+  },
+  "resolutions": {
+    "linkinator/glob": "12.0.0",
+    "wireit/brace-expansion": "5.0.6"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -94,6 +107,30 @@
               }
             }
           },
+          "pull": {
+            "description": "Commands relating to retrieving metadata.",
+            "subtopics": {
+              "remote": {
+                "description": "Commands relating to retrieving metadata that exists in the org but not locally.",
+                "subtopics": {
+                  "type": {
+                    "description": "Commands relating to remote pull metadata types.",
+                    "subtopics": {
+                      "add": {
+                        "description": "Add metadata types supported by remote pull."
+                      },
+                      "list": {
+                        "description": "List metadata types supported by remote pull."
+                      },
+                      "remove": {
+                        "description": "Remove metadata types supported by remote pull."
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
           "query": {
             "description": "Commands relating to SOQL queries.",
             "subtopics": {