@tywalk/pcf-helper-run 1.3.6 → 1.4.0

package/README.md

@@ -251,6 +251,7 @@ pcf-helper-run session [options]
 - `-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
+- `--watch-retry <true|false>` - Controls watch failure behavior when `--watch` is enabled: `true` auto-retries, `false` prompts for manual restart (default: `true`)
 
 #### Configuration File
 
@@ -263,7 +264,8 @@ Create a `session.config.json` file in your project root to avoid passing parame
   "remoteStylesheetToIntercept": "/webresources/pub_MyControl/css/MyControl.css",
   "localBundlePath": "./out/controls/MyControl/bundle.js",
   "localCssPath": "./out/controls/MyControl/css/MyControl.css",
-  "startWatch": false
+  "startWatch": false,
+  "watchRetry": true
 }
 ```
 

package/dist/__tests__/pcf-helper-run.test.js

@@ -99,3 +99,17 @@ test('runBuild exists', () => {
     const exists = typeof (tasks === null || tasks === void 0 ? void 0 : tasks.runBuild) === 'function';
     expect(exists).toBe(true);
 });
+test('session errors when watch retry flag is used without watch', (done) => {
+    const task = (0, child_process_1.spawn)('node', ['./dist/index.js', 'session', '--watch-retry', 'false']);
+    let output = '';
+    task.stdout.on('data', (data) => {
+        output += data.toString();
+    });
+    task.stderr.on('data', (data) => {
+        output += data.toString();
+    });
+    task.on('close', (code) => {
+        expect(code).toBe(1);
+        done();
+    });
+}, 10000);

package/dist/index.js

@@ -64,6 +64,16 @@ const preprocessArgs = (args) => {
 // Preprocess arguments and track if deprecated flags were used  
 const { args: processedArgs, hadDeprecatedEnv } = preprocessArgs(process.argv.slice(2));
 process.argv = [...process.argv.slice(0, 2), ...processedArgs];
+const parseWatchRetry = (value) => {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'true') {
+        return true;
+    }
+    if (normalized === 'false') {
+        return false;
+    }
+    throw new Error('watch-retry must be either true or false');
+};
 // Configure the CLI program
 commander_1.program
     .name('pcf-helper-run')
@@ -280,18 +290,32 @@ withCommonOptions(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) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e;
+    .option('--watch-retry <enabled>', 'automatically retry watch process on failure (true|false)', parseWatchRetry)
+    .action((options, command) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     const { logger, tick } = setupExecutionContext(options);
     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');
+            const configWithWatchRetry = config;
+            const startWatch = (_b = (_a = options.watch) !== null && _a !== void 0 ? _a : config.startWatch) !== null && _b !== void 0 ? _b : false;
+            const watchRetryFlagWasSet = command.getOptionValueSource('watchRetry') === 'cli';
+            if (watchRetryFlagWasSet && !startWatch) {
+                logger.error('❌ --watch-retry can only be used when --watch is enabled.');
+                process.exit(1);
+            }
+            const watchRetry = (_d = (_c = options.watchRetry) !== null && _c !== void 0 ? _c : configWithWatchRetry.watchRetry) !== null && _d !== void 0 ? _d : true;
             // Use the config values from the config file, falling back to the CLI options if the config values are not set
-            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);
+            yield tasks.runSession((_e = config.remoteEnvironmentUrl) !== null && _e !== void 0 ? _e : options.url, (_f = config.remoteScriptToIntercept) !== null && _f !== void 0 ? _f : options.script, (_g = config.remoteStylesheetToIntercept) !== null && _g !== void 0 ? _g : options.stylesheet, (_h = config.localBundlePath) !== null && _h !== void 0 ? _h : options.bundle, (_j = config.localCssPath) !== null && _j !== void 0 ? _j : options.css, startWatch, watchRetry);
         }
         else {
-            yield tasks.runSession(options.url, options.script, options.stylesheet, options.bundle, options.css, options.watch);
+            const watchRetryFlagWasSet = command.getOptionValueSource('watchRetry') === 'cli';
+            if (watchRetryFlagWasSet && !options.watch) {
+                logger.error('❌ --watch-retry can only be used when --watch is enabled.');
+                process.exit(1);
+            }
+            yield tasks.runSession(options.url, options.script, options.stylesheet, options.bundle, options.css, options.watch, (_k = options.watchRetry) !== null && _k !== void 0 ? _k : true);
         }
         const tock = performance.now();
         logger.log((0, performanceUtil_1.formatMsToSec)('Session started successfully in %is.', tock - tick));

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tywalk/pcf-helper-run",
-    "version": "1.3.5",
+    "version": "1.3.7",
     "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/",
@@ -52,7 +52,7 @@
     },
     "dependencies": {
         "@tywalk/color-logger": "^1.0.3",
-        "@tywalk/pcf-helper": "^1.11.0"
+        "@tywalk/pcf-helper": "^1.13.0"
     },
     "devDependencies": {
         "@semantic-release/git": "^10.0.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tywalk/pcf-helper-run",
-  "version": "1.3.6",
+  "version": "1.4.0",
   "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/",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@tywalk/color-logger": "^1.0.3",
-    "@tywalk/pcf-helper": "^1.11.0"
+    "@tywalk/pcf-helper": "^1.13.0"
   },
   "devDependencies": {
     "@semantic-release/git": "^10.0.1",