@tywalk/pcf-helper-run 1.2.14 → 1.2.16

package/README.md

@@ -250,6 +250,7 @@ pcf-helper-run session [options]
 - `-b, --bundle <path>` - Local bundle path
 - `-c, --css <path>` - Local CSS path
 - `-f, --config <path>` - Config file path (default: `session.config.json`)
+- `-w, --watch` - Start pcf-scripts watch process to automatically rebuild on changes
 
 #### Examples
 
@@ -259,6 +260,9 @@ pcf-helper-run session
 
 # Session with custom configuration
 pcf-helper-run session -u "https://contoso.crm.dynamics.com" -s ./bundle.js
+
+# Session with watch mode for automatic rebuilds
+pcf-helper-run session --watch
 ```
 
 ## ⚙️ Global Options
@@ -390,8 +394,8 @@ pcf-helper-run deploy --help
 
 ### Documentation Links
 
-- [Power Platform Component Framework Documentation](https://docs.microsoft.com/en-us/powerapps/developer/component-framework/)
-- [Power Platform CLI Documentation](https://docs.microsoft.com/en-us/powerapps/developer/data-platform/powerapps-cli)
+- [Power Platform Component Framework Documentation](https://learn.microsoft.com/en-us/power-apps/developer/component-framework/overview)
+- [Power Platform CLI Documentation](https://learn.microsoft.com/en-us/power-platform/developer/cli/introduction)
 - [PCF Community Gallery](https://pcf.gallery/)
 
 ## 🔗 Related Packages

package/dist/index.js

@@ -33,6 +33,15 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const tasks = __importStar(require("@tywalk/pcf-helper"));
@@ -113,7 +122,7 @@ const setupExecutionContext = (options) => {
     return { logger, tick: performance.now() };
 };
 // Helper function to execute tasks and handle results
-const executeTask = (taskName, logger, tick, result) => {
+const handleResults = (taskName, logger, tick, result) => {
     if (taskName !== 'session') {
         if (result === 0) {
             logger.log(`[PCF Helper Run] ${taskName} completed successfully!`);
@@ -143,10 +152,10 @@ addPathOptions(commander_1.program.command('upgrade'))
         result = tasks.runUpgrade(options.path, options.verbose || false);
     }
     catch (e) {
-        logger.error('[PCF Helper Run] One or more tasks failed while upgrading: ', (e && e.message) || 'unknown error');
+        logger.error('[PCF Helper Run] One or more tasks failed while upgrading: ', e instanceof Error ? e.message : 'unknown error');
         result = 1;
     }
-    executeTask('upgrade', logger, tick, result);
+    handleResults('upgrade', logger, tick, result);
 });
 // Define the build command  
 addPathOptions(commander_1.program.command('build'))
@@ -163,10 +172,10 @@ addPathOptions(commander_1.program.command('build'))
         result = tasks.runBuild(options.path, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
     }
     catch (e) {
-        logger.error('[PCF Helper Run] One or more tasks failed while building: ', (e && e.message) || 'unknown error');
+        logger.error('[PCF Helper Run] One or more tasks failed while building: ', e instanceof Error ? e.message : 'unknown error');
         result = 1;
     }
-    executeTask('build', logger, tick, result);
+    handleResults('build', logger, tick, result);
 });
 // Define the import command
 addPathOptions(commander_1.program.command('import'))
@@ -187,10 +196,10 @@ addPathOptions(commander_1.program.command('import'))
         result = tasks.runImport(options.path, env, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
     }
     catch (e) {
-        logger.error('[PCF Helper Run] One or more tasks failed while importing: ', (e && e.message) || 'unknown error');
+        logger.error('[PCF Helper Run] One or more tasks failed while importing: ', e instanceof Error ? e.message : 'unknown error');
         result = 1;
     }
-    executeTask('import', logger, tick, result);
+    handleResults('import', logger, tick, result);
 });
 // Define the deploy command (runs upgrade, build, and import)
 addPathOptions(commander_1.program.command('deploy'))
@@ -229,10 +238,10 @@ addPathOptions(commander_1.program.command('deploy'))
         }
     }
     catch (e) {
-        logger.error('[PCF Helper Run] One or more tasks failed while deploying: ', (e && e.message) || 'unknown error');
+        logger.error('[PCF Helper Run] One or more tasks failed while deploying: ', e instanceof Error ? e.message : 'unknown error');
         result = 1;
     }
-    executeTask('deploy', logger, tick, result);
+    handleResults('deploy', logger, tick, result);
 });
 // Define the init command
 addCommonOptions(commander_1.program.command('init'))
@@ -250,10 +259,10 @@ addCommonOptions(commander_1.program.command('init'))
         result = tasks.runInit(options.path, options.name, options.publisherName, options.publisherPrefix, options.runNpmInstall !== false, options.verbose || false);
     }
     catch (e) {
-        logger.error('[PCF Helper Run] One or more tasks failed while initializing: ', (e && e.message) || 'unknown error');
+        logger.error('[PCF Helper Run] One or more tasks failed while initializing: ', e instanceof Error ? e.message : 'unknown error');
         result = 1;
     }
-    executeTask('init', logger, tick, result);
+    handleResults('init', logger, tick, result);
 });
 // Define the session command
 addCommonOptions(commander_1.program.command('session'))
@@ -265,25 +274,24 @@ addCommonOptions(commander_1.program.command('session'))
     .option('-c, --local-css <path>', 'local CSS path')
     .option('-f, --config <path>', 'config file path', 'session.config.json')
     .option('-w, --watch', 'start pcf-scripts watch process')
-    .action((options) => {
+    .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b, _c, _d, _e;
     const { logger, tick } = setupExecutionContext(options);
-    let result = 0;
     try {
         logger.log('[PCF Helper Run] ' + (0, performanceUtil_1.formatTime)(new Date()) + ' session started.\n');
         if (!options.url || options.config) {
             const config = tasks.loadConfig(options.config || 'session.config.json');
-            tasks.runSession((_a = config.remoteEnvironmentUrl) !== null && _a !== void 0 ? _a : options.url, (_b = config.remoteScriptToIntercept) !== null && _b !== void 0 ? _b : options.script, (_c = config.remoteStylesheetToIntercept) !== null && _c !== void 0 ? _c : options.stylesheet, (_d = config.localBundlePath) !== null && _d !== void 0 ? _d : options.bundle, (_e = config.localCssPath) !== null && _e !== void 0 ? _e : options.css, config.startWatch || options.watch);
+            yield tasks.runSession((_a = config.remoteEnvironmentUrl) !== null && _a !== void 0 ? _a : options.url, (_b = config.remoteScriptToIntercept) !== null && _b !== void 0 ? _b : options.script, (_c = config.remoteStylesheetToIntercept) !== null && _c !== void 0 ? _c : options.stylesheet, (_d = config.localBundlePath) !== null && _d !== void 0 ? _d : options.bundle, (_e = config.localCssPath) !== null && _e !== void 0 ? _e : options.css, config.startWatch || options.watch);
         }
         else {
-            tasks.runSession(options.url, options.script, options.stylesheet, options.bundle, options.css, options.watch);
+            yield tasks.runSession(options.url, options.script, options.stylesheet, options.bundle, options.css, options.watch);
         }
+        const tock = performance.now();
+        logger.log((0, performanceUtil_1.formatMsToSec)('Session started successfully in %is.', tock - tick));
     }
     catch (e) {
-        logger.error('[PCF Helper Run] One or more tasks failed during session: ', (e && e.message) || 'unknown error');
-        result = 1;
+        logger.error('[PCF Helper Run] One or more tasks failed during session or session startup: ', e instanceof Error ? e.message : 'unknown error');
     }
-    executeTask('session', logger, tick, result);
-});
+}));
 // Parse the command line arguments
 commander_1.program.parse();

package/dist/package.json

@@ -1,7 +1,8 @@
 {
     "name": "@tywalk/pcf-helper-run",
-    "version": "1.2.13",
-    "description": "A simple command-line utility for building and publishing PCF controls to Dataverse.",
+    "version": "1.2.15",
+    "description": "Unified CLI interface for Power Platform Component Framework (PCF) development — init, build, import, deploy, and manage PCF controls in Dataverse.",
+    "main": "dist/index.js",
     "types": "./types/",
     "files": [
         "dist",
@@ -22,9 +23,30 @@
         "update": "npm run ready && npm publish --access public"
     },
     "keywords": [
-        "pcf"
+        "pcf",
+        "pcf-control",
+        "pcf-component",
+        "power-platform",
+        "powerapps",
+        "power-apps",
+        "dataverse",
+        "dynamics-365",
+        "microsoft",
+        "cli",
+        "command-line",
+        "developer-tools",
+        "build-tool",
+        "deployment",
+        "automation",
+        "typescript",
+        "pac"
     ],
+    "license": "MIT",
     "author": "tywalk",
+    "homepage": "https://github.com/tywalk/pcf-helper#readme",
+    "engines": {
+        "node": ">=16.0.0"
+    },
     "bin": {
         "pcf-helper-run": "dist/index.js"
     },

package/dist/util/performanceUtil.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatMsToSec = formatMsToSec;
 exports.formatTime = formatTime;
 const util_1 = __importDefault(require("util"));
-var formatter = new Intl.DateTimeFormat('en-US', {
+const formatter = new Intl.DateTimeFormat('en-US', {
     hour: '2-digit',
     minute: '2-digit',
     second: '2-digit',

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@tywalk/pcf-helper-run",
-  "version": "1.2.14",
-  "description": "A simple command-line utility for building and publishing PCF controls to Dataverse.",
+  "version": "1.2.16",
+  "description": "Unified CLI interface for Power Platform Component Framework (PCF) development — init, build, import, deploy, and manage PCF controls in Dataverse.",
+  "main": "dist/index.js",
   "types": "./types/",
   "files": [
     "dist",
@@ -22,9 +23,30 @@
     "update": "npm run ready && npm publish --access public"
   },
   "keywords": [
-    "pcf"
+    "pcf",
+    "pcf-control",
+    "pcf-component",
+    "power-platform",
+    "powerapps",
+    "power-apps",
+    "dataverse",
+    "dynamics-365",
+    "microsoft",
+    "cli",
+    "command-line",
+    "developer-tools",
+    "build-tool",
+    "deployment",
+    "automation",
+    "typescript",
+    "pac"
   ],
+  "license": "MIT",
   "author": "tywalk",
+  "homepage": "https://github.com/tywalk/pcf-helper#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
   "bin": {
     "pcf-helper-run": "dist/index.js"
   },

package/types/util/argumentUtil.d.ts

@@ -1,2 +1,2 @@
 export declare function getArg(args: string[], arg: string): string | undefined;
-export declare function getArgValue(args: string[], argOpts: string[], defaultIfExists?: any): string | undefined;
+export declare function getArgValue(args: string[], argOpts: string[], defaultIfExists?: string): string | undefined;