@peernova/cuneiform-sf 1.0.1 → 1.0.3-beta.0

package/oclif.manifest.json

@@ -112,7 +112,174 @@
         "hello:world",
         "world:hello"
       ]
+    },
+    "cuneiform:definition:export": {
+      "aliases": [],
+      "args": {},
+      "description": "Exports profiling definition records to CSV files in SFDMU-compatible format for backup, version control, or cross-org migration.\n\nThe export creates a timestamped directory containing:\n\n- export.json: SFDMU configuration file\n- pnova**Profiling_Definition**c.csv: Definition records\n- export-metadata.json: Export statistics and metadata\n\nUse --exclude-ids for VCS-friendly output that excludes Salesforce IDs (Id, CreatedById, etc.), making the files suitable for version control.",
+      "examples": [
+        "Export all definitions to the default location:\n<%= config.bin %> <%= command.id %> --target-org myOrg",
+        "Export to a specific directory:\n<%= config.bin %> <%= command.id %> --target-org myOrg --output ./backup/definitions",
+        "Export with VCS-friendly mode (excludes IDs):\n<%= config.bin %> <%= command.id %> --target-org myOrg --exclude-ids --output ./config/definitions"
+      ],
+      "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",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Salesforce org to export definitions from.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "d",
+          "name": "output",
+          "summary": "Output directory path. Defaults to ./data/exports/definitions/{timestamp}.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "exclude-ids": {
+          "name": "exclude-ids",
+          "summary": "Exclude Salesforce IDs for VCS-friendly output.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "cuneiform:definition:export",
+      "pluginAlias": "@peernova/cuneiform-sf",
+      "pluginName": "@peernova/cuneiform-sf",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Export profiling definitions from a Salesforce org to SFDMU-compatible CSV files.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cuneiform",
+        "definition",
+        "export.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "cuneiform:definition:export",
+        "definition:cuneiform:export",
+        "definition:export:cuneiform",
+        "cuneiform:export:definition",
+        "export:cuneiform:definition",
+        "export:definition:cuneiform"
+      ]
+    },
+    "cuneiform:definition:import": {
+      "aliases": [],
+      "args": {},
+      "description": "Imports profiling definition records from CSV files exported by `sf cuneiform definition export` or manually created SFDMU-compatible files.\n\nThe source directory must contain:\n\n- pnova**Profiling_Definition**c.csv: Definition records to import\n\nThe import operation can be configured as:\n\n- Insert (default): Creates new records only. Fails if a record with the same Name exists.\n- Upsert: Creates new records or updates existing records matched by Name (external ID).\n\nUse --dry-run to validate the import without making changes to the org.",
+      "examples": [
+        "Import definitions from a backup directory:\n<%= config.bin %> <%= command.id %> --target-org myOrg --source ./backup/definitions",
+        "Import with upsert (update existing, insert new):\n<%= config.bin %> <%= command.id %> --target-org myOrg --source ./backup --operation Upsert",
+        "Preview import without making changes:\n<%= config.bin %> <%= command.id %> --target-org myOrg --source ./backup --dry-run"
+      ],
+      "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",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Salesforce org to import definitions into.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "source": {
+          "char": "s",
+          "name": "source",
+          "required": true,
+          "summary": "Source directory containing CSV files to import.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "operation": {
+          "name": "operation",
+          "summary": "SFDMU operation type: Insert (create only) or Upsert (create/update).",
+          "default": "Insert",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Insert",
+            "Upsert"
+          ],
+          "type": "option"
+        },
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Preview changes without making them (dry-run mode).",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "cuneiform:definition:import",
+      "pluginAlias": "@peernova/cuneiform-sf",
+      "pluginName": "@peernova/cuneiform-sf",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Import profiling definitions from SFDMU-compatible CSV files into a Salesforce org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cuneiform",
+        "definition",
+        "import.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "cuneiform:definition:import",
+        "definition:cuneiform:import",
+        "definition:import:cuneiform",
+        "cuneiform:import:definition",
+        "import:cuneiform:definition",
+        "import:definition:cuneiform"
+      ]
     }
   },
-  "version": "1.0.1"
+  "version": "1.0.3-beta.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@peernova/cuneiform-sf",
   "description": "Cuneiform for Salesforce CLI-Powered Data Profiling",
-  "version": "1.0.1",
+  "version": "1.0.3-beta.0",
   "dependencies": {
     "@oclif/core": "^4",
     "@salesforce/core": "^8",
@@ -9,9 +9,10 @@
   },
   "devDependencies": {
     "@oclif/plugin-command-snapshot": "^5.1.9",
-    "@types/node": "^22",
     "@salesforce/cli-plugins-testkit": "^5.3.10",
     "@salesforce/dev-scripts": "^10",
+    "@types/node": "^22",
+    "c8": "^10.1.3",
     "eslint-plugin-sf-plugin": "^1.20.33",
     "oclif": "^4.14.0",
     "ts-node": "^10.9.2",
@@ -55,7 +56,10 @@
         "description": "Commands to say hello."
       },
       "cuneiform": {
-        "description": "provides a description of the Cuneiform for Salesforce SFDX Plugin."
+        "description": "Cuneiform for Salesforce CLI-powered data profiling commands."
+      },
+      "cuneiform definition": {
+        "description": "Export and import profiling definitions."
       }
     },
     "flexibleTaxonomy": true
@@ -73,7 +77,7 @@
     "postpack": "sf-clean --ignore-signing-artifacts",
     "prepack": "sf-prepack",
     "test": "wireit",
-    "test:nuts": "nyc mocha \"**/*.nut.ts\" --slow 4500 --timeout 600000 --parallel",
+    "test:nuts": "c8 mocha \"**/*.nut.ts\" --slow 4500 --timeout 600000 --parallel",
     "test:only": "wireit",
     "version": "oclif readme"
   },
@@ -138,7 +142,7 @@
       ]
     },
     "test:only": {
-      "command": "nyc mocha \"test/**/*.test.ts\"",
+      "command": "c8 mocha \"test/**/*.test.ts\"",
       "env": {
         "FORCE_COLOR": "2"
       },
@@ -148,7 +152,7 @@
         "**/tsconfig.json",
         ".mocha*",
         "!*.nut.ts",
-        ".nycrc"
+        ".c8rc.json"
       ],
       "output": []
     },