@tywalk/pcf-helper-run 1.0.0

package/README.md

@@ -0,0 +1,22 @@
+# PCF Helper Run
+
+A simple command-line utility for building and publishing PCF controls to Dataverse.
+
+## Requirements
+
+This tool requires the following:
+
+* `pac` cli installed on your machine.
+* `dotnet` cli or Visual Studio installed on your machine.
+
+## Instructions
+
+1. In a terminal, install globally `npm install --save --global @tywalk/pcf-helper-run`. Or,
+2. In a terminal, run `npx @tywalk/pcf-helper-run [command] --path <path to pcf project folder> --environment <environment guid or url>`.
+
+### Commands
+
+* `upgrade` - Upgrades PCF manifest and solution versions (--environment is not required). `npx @tywalk/pcf-helper-run upgrade --path <path to pcf project folder>`
+* `build` - Builds PCF control (--environment is not required). `npx @tywalk/pcf-helper-run build --path <path to pcf project folder>`
+* `import` - Imports PCF control into specified environment. Defaults to auth profile environment. `npx @tywalk/pcf-helper-run import --path <path to pcf project folder> --environment <environment guid or url>`
+* `deploy` - Upgrades, builds, and imports PCF control. `npx @tywalk/pcf-helper-run deploy--path <path to pcf project folder> --environment <environment guid or url>`

package/index.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+const upgradeTask = require('../../../tasks/upgrade-pcf');
+const buildTask = require('../../../tasks/build-pcf');
+const importTask = require('../../../tasks/import-pcf');
+const [, , ...args] = process.argv;
+
+const commandArgument = args.at(0)?.toLowerCase();
+if (typeof commandArgument === 'undefined' || !['upgrade', 'build', 'import', 'deploy'].includes(commandArgument)) {
+  console.error('Command [command] (upgrade, build, import, deploy) is required.');
+  return 0;
+}
+const runAll = commandArgument === 'deploy';
+
+const pathArgument = args.find(a => ['-p', '--path'].includes(a));
+if (typeof pathArgument === 'undefined') {
+  console.error('Path argument is required. Use --path to specify the path to solution folder.');
+  return 0;
+}
+
+const pathIndex = args.indexOf(pathArgument) + 1;
+const path = args.at(pathIndex);
+if (typeof path === 'undefined') {
+  console.error('Path argument is required. Use --path to specify the path to solution folder.');
+  return 0;
+}
+
+const envArgument = args.find(a => ['-env', '--environment'].includes(a));
+let envIndex = args.indexOf(envArgument) + 1;
+let env = '';
+if (envIndex > 0) {
+  env = args.at(envIndex);
+}
+
+if (commandArgument === 'upgrade' || runAll) {
+  upgradeTask.run(path);
+}
+if (commandArgument === 'build' || runAll) {
+  buildTask.run(path);
+}
+if (commandArgument === 'import' || runAll) {
+  importTask.run(path, env);
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@tywalk/pcf-helper-run",
+  "version": "1.0.0",
+  "description": "A simple command-line utility for building and publishing PCF controls to Dataverse.",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "pcf"
+  ],
+  "author": "tywalk",
+  "bin": {
+    "pcf-helper-run": "./index.js"
+  }
+}