@tywalk/pcf-helper 1.4.26 → 1.5.1

package/dist/bin/build.js

@@ -36,34 +36,29 @@ var __importStar = (this && this.__importStar) || (function () {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
 const task = __importStar(require("../tasks/build-pcf"));
 const package_json_1 = require("../package.json");
 const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
-const argumentUtil_1 = require("../util/argumentUtil");
-const [, , ...args] = process.argv;
-const commandArgument = (_b = (_a = args.at(0)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
-if (['-v', '--version'].includes(commandArgument)) {
-    console.log('v%s', package_json_1.version);
-    process.exit(0);
-}
-const timeout = (0, argumentUtil_1.getArgValue)(args, ['-t', '--timeout']);
-if (typeof timeout !== 'undefined') {
-    const timeoutNumber = Number(timeout);
-    if (isNaN(timeoutNumber) || timeoutNumber <= 0) {
-        color_logger_1.default.error('Timeout argument must be a positive number representing milliseconds.');
-        process.exit(1);
+const commander_1 = require("commander");
+const program = new commander_1.Command();
+program
+    .name('pcf-helper-build')
+    .description('Build PCF controls')
+    .version(package_json_1.version, '-v, --version')
+    .option('-V, --verbose', 'enable verbose logging')
+    .option('-t, --timeout <milliseconds>', 'timeout in milliseconds', (value) => {
+    const num = Number(value);
+    if (isNaN(num) || num <= 0) {
+        throw new Error('Timeout must be a positive number');
     }
-}
-const verboseArgument = args.find(a => ['-v', '--verbose'].includes(a));
-if (typeof verboseArgument !== 'undefined') {
+    return value;
+})
+    .requiredOption('-p, --path <path>', 'path to solution folder')
+    .parse();
+const options = program.opts();
+if (options.verbose) {
     color_logger_1.default.setDebug(true);
 }
 color_logger_1.default.log('PCF Helper version', package_json_1.version);
-const path = (0, argumentUtil_1.getArgValue)(args, ['-p', '--path']);
-if (typeof path === 'undefined') {
-    color_logger_1.default.error('Path argument is required. Use --path to specify the path to solution folder.');
-    process.exit(1);
-}
-task.runBuild(path, verboseArgument !== undefined, typeof timeout !== 'undefined' ? Number(timeout) : undefined);
+task.runBuild(options.path, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);

package/dist/bin/deploy.js

@@ -36,7 +36,6 @@ var __importStar = (this && this.__importStar) || (function () {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
 const upgradeTask = __importStar(require("../tasks/upgrade-pcf"));
 const buildTask = __importStar(require("../tasks/build-pcf"));
@@ -44,47 +43,29 @@ const importTask = __importStar(require("../tasks/import-pcf"));
 const performanceUtil_1 = require("../util/performanceUtil");
 const package_json_1 = require("../package.json");
 const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
+const commander_1 = require("commander");
 const argumentUtil_1 = require("../util/argumentUtil");
-const [, , ...args] = process.argv;
-const commandArgument = (_b = (_a = args.at(0)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
-if (['-v', '--version'].includes(commandArgument)) {
-    console.log('v%s', package_json_1.version);
-    process.exit(0);
-}
-const timeout = (0, argumentUtil_1.getArgValue)(args, ['-t', '--timeout']);
-if (typeof timeout !== 'undefined') {
-    const timeoutNumber = Number(timeout);
-    if (isNaN(timeoutNumber) || timeoutNumber <= 0) {
-        color_logger_1.default.error('Timeout argument must be a positive number representing milliseconds.');
-        process.exit(1);
-    }
-}
-const verboseArgument = args.find(a => ['-v', '--verbose'].includes(a));
-if (typeof verboseArgument !== 'undefined') {
-    color_logger_1.default.setDebug(true);
-}
+// Apply argument preprocessing for backward compatibility
+const { hadDeprecatedEnv } = (0, argumentUtil_1.applyArgumentPreprocessing)(process.argv);
+const program = new commander_1.Command();
+(0, argumentUtil_1.addPathAndEnvironmentOptions)(program)
+    .name('pcf-helper-deploy')
+    .description('Deploy PCF controls (runs upgrade, build, and import)')
+    .version(package_json_1.version, '-v, --version')
+    .parse();
+const options = program.opts();
+(0, argumentUtil_1.setupLogging)(options.verbose);
 color_logger_1.default.log('PCF Helper version', package_json_1.version);
-const pathArgument = args.find(a => ['-p', '--path'].includes(a));
-if (typeof pathArgument === 'undefined') {
-    color_logger_1.default.error('Path argument is required. Use --path to specify the path to solution folder.');
-    process.exit(1);
-}
-const pathIndex = args.indexOf(pathArgument) + 1;
-const path = args.at(pathIndex);
-if (typeof path === 'undefined') {
-    color_logger_1.default.error('Path argument is required. Use --path to specify the path to solution folder.');
-    process.exit(1);
-}
+const env = (0, argumentUtil_1.resolveEnvironment)(options, hadDeprecatedEnv);
 const tick = performance.now();
-const env = (_c = (0, argumentUtil_1.getArgValue)(args, ['-env', '--environment'])) !== null && _c !== void 0 ? _c : '';
 function executeTasks() {
-    const upgradeResult = upgradeTask.runUpgrade(path, typeof verboseArgument !== 'undefined');
+    const upgradeResult = upgradeTask.runUpgrade(options.path, options.verbose || false);
     if (upgradeResult === 1)
         return 1;
-    const buildResult = buildTask.runBuild(path, typeof verboseArgument !== 'undefined', typeof timeout !== 'undefined' ? Number(timeout) : undefined);
+    const buildResult = buildTask.runBuild(options.path, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
     if (buildResult === 1)
         return 1;
-    const importResult = importTask.runImport(path, env, typeof verboseArgument !== 'undefined', typeof timeout !== 'undefined' ? Number(timeout) : undefined);
+    const importResult = importTask.runImport(options.path, env, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
     if (importResult === 1)
         return 1;
     return 0;
@@ -97,7 +78,7 @@ try {
     }
 }
 catch (e) {
-    color_logger_1.default.error('One or more tasks failed while deploying: ', (e && e.message) || 'unkown error');
+    color_logger_1.default.error('One or more tasks failed while deploying: ', (e && e.message) || 'unknown error');
     result = 1;
 }
 finally {

package/dist/bin/import.js

@@ -36,35 +36,22 @@ var __importStar = (this && this.__importStar) || (function () {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
 const task = __importStar(require("../tasks/import-pcf"));
 const package_json_1 = require("../package.json");
 const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
+const commander_1 = require("commander");
 const argumentUtil_1 = require("../util/argumentUtil");
-const [, , ...args] = process.argv;
-const commandArgument = (_b = (_a = args.at(0)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
-if (['-v', '--version'].includes(commandArgument)) {
-    console.log('v%s', package_json_1.version);
-    process.exit(0);
-}
-const timeout = (0, argumentUtil_1.getArgValue)(args, ['-t', '--timeout']);
-if (typeof timeout !== 'undefined') {
-    const timeoutNumber = Number(timeout);
-    if (isNaN(timeoutNumber) || timeoutNumber <= 0) {
-        color_logger_1.default.error('Timeout argument must be a positive number representing milliseconds.');
-        process.exit(1);
-    }
-}
-const verboseArgument = args.find(a => ['-v', '--verbose'].includes(a));
-if (typeof verboseArgument !== 'undefined') {
-    color_logger_1.default.setDebug(true);
-}
+// Apply argument preprocessing for backward compatibility
+const { hadDeprecatedEnv } = (0, argumentUtil_1.applyArgumentPreprocessing)(process.argv);
+const program = new commander_1.Command();
+(0, argumentUtil_1.addPathAndEnvironmentOptions)(program)
+    .name('pcf-helper-import')
+    .description('Import PCF controls to Dataverse')
+    .version(package_json_1.version, '-v, --version')
+    .parse();
+const options = program.opts();
+(0, argumentUtil_1.setupLogging)(options.verbose);
 color_logger_1.default.log('PCF Helper version', package_json_1.version);
-const path = (0, argumentUtil_1.getArgValue)(args, ['-p', '--path']);
-if (typeof path === 'undefined') {
-    color_logger_1.default.error('Path argument is required. Use --path to specify the path to solution folder.');
-    process.exit(1);
-}
-const env = (_c = (0, argumentUtil_1.getArgValue)(args, ['-env', '--environment'])) !== null && _c !== void 0 ? _c : '';
-task.runImport(path, env, verboseArgument !== undefined, typeof timeout !== 'undefined' ? Number(timeout) : undefined);
+const env = (0, argumentUtil_1.resolveEnvironment)(options, hadDeprecatedEnv);
+task.runImport(options.path, env, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);

package/dist/bin/init.js

@@ -36,30 +36,26 @@ var __importStar = (this && this.__importStar) || (function () {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _a, _b, _c, _d, _e;
 Object.defineProperty(exports, "__esModule", { value: true });
 const task = __importStar(require("../tasks/init-pcf"));
 const package_json_1 = require("../package.json");
 const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
-const argumentUtil_1 = require("../util/argumentUtil");
-const [, , ...args] = process.argv;
-const commandArgument = (_b = (_a = args.at(0)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
-if (['-v', '--version'].includes(commandArgument)) {
-    console.log('v%s', package_json_1.version);
-    process.exit(0);
-}
-const verboseArgument = args.find(a => ['-v', '--verbose'].includes(a));
-if (typeof verboseArgument !== 'undefined') {
+const commander_1 = require("commander");
+const program = new commander_1.Command();
+program
+    .name('pcf-helper-init')
+    .description('Initialize a new PCF project')
+    .version(package_json_1.version, '-v, --version')
+    .option('-V, --verbose', 'enable verbose logging')
+    .requiredOption('-n, --name <name>', 'name of the PCF control')
+    .option('--publisher-name <publisherName>', 'publisher name')
+    .option('--publisher-prefix <publisherPrefix>', 'publisher prefix')
+    .option('-p, --path <path>', 'path to create the PCF project')
+    .option('--run-npm-install', 'run npm install after initialization', true)
+    .parse();
+const options = program.opts();
+if (options.verbose) {
     color_logger_1.default.setDebug(true);
 }
 color_logger_1.default.log('PCF Helper version', package_json_1.version);
-const name = (0, argumentUtil_1.getArgValue)(args, ['-n', '--name']);
-if (typeof name === 'undefined') {
-    color_logger_1.default.error('Name argument is required. Use --name to specify the name of the PCF control.');
-    process.exit(1);
-}
-const publisherName = (_c = (0, argumentUtil_1.getArgValue)(args, ['-pn', '--publisher-name'])) !== null && _c !== void 0 ? _c : '';
-const publisherPrefix = (_d = (0, argumentUtil_1.getArgValue)(args, ['-pp', '--publisher-prefix'])) !== null && _d !== void 0 ? _d : '';
-const path = (_e = (0, argumentUtil_1.getArgValue)(args, ['-p', '--path'])) !== null && _e !== void 0 ? _e : '';
-const npm = (0, argumentUtil_1.getArgValue)(args, ['-npm', '--run-npm-install'], 'true');
-task.runInit(path, name, publisherName, publisherPrefix, npm === 'true', verboseArgument !== undefined);
+task.runInit(options.path || '', options.name, options.publisherName || '', options.publisherPrefix || '', options.runNpmInstall !== false, options.verbose || false);

package/dist/bin/session.js

@@ -43,18 +43,22 @@ const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
 const commander_1 = require("commander");
 const program = new commander_1.Command();
 program
-    .option('-v, --version', 'output the version number')
-    .option('-vv, --verbose', 'enable verbose logging')
+    .name('pcf-helper-session')
+    .description('Run development session')
+    .version(package_json_1.version, '-v, --version')
+    .option('-V, --verbose', 'enable verbose logging')
+    .option('-u, --url <url>', 'remote environment URL')
+    .option('-s, --script <script>', 'remote script to intercept')
+    .option('-t, --stylesheet <stylesheet>', 'remote stylesheet to intercept')
+    .option('-b, --bundle <path>', 'local bundle path')
+    .option('-c, --css <path>', 'local CSS path')
+    .option('-f, --config <path>', 'config file path', 'dev-config.json')
     .parse();
 const options = program.opts();
-if (options.version) {
-    console.log('v%s', package_json_1.version);
-    process.exit(0);
-}
 if (options.verbose) {
-    color_logger_1.default.setLevel('debug');
+    color_logger_1.default.setDebug(true);
     color_logger_1.default.debug('Verbose logging enabled');
 }
 color_logger_1.default.log('PCF Helper version', package_json_1.version);
-const config = task.loadConfig();
+const config = task.loadConfig(options.config);
 task.runSession(config.remoteEnvironmentUrl, config.remoteScriptToIntercept, config.remoteStylesheetToIntercept, config.localBundlePath, config.localCssPath);

package/dist/bin/upgrade.js

@@ -36,26 +36,22 @@ var __importStar = (this && this.__importStar) || (function () {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
 const task = __importStar(require("../tasks/upgrade-pcf"));
 const package_json_1 = require("../package.json");
 const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
-const argumentUtil_1 = require("../util/argumentUtil");
-const [, , ...args] = process.argv;
-const commandArgument = (_b = (_a = args.at(0)) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
-if (['-v', '--version'].includes(commandArgument)) {
-    console.log('v%s', package_json_1.version);
-    process.exit(0);
-}
-const verboseArgument = args.find(a => ['-v', '--verbose'].includes(a));
-if (typeof verboseArgument !== 'undefined') {
+const commander_1 = require("commander");
+const program = new commander_1.Command();
+program
+    .name('pcf-helper-upgrade')
+    .description('Upgrade PCF controls')
+    .version(package_json_1.version, '-v, --version')
+    .option('-V, --verbose', 'enable verbose logging')
+    .requiredOption('-p, --path <path>', 'path to solution folder')
+    .parse();
+const options = program.opts();
+if (options.verbose) {
     color_logger_1.default.setDebug(true);
 }
 color_logger_1.default.log('PCF Helper version', package_json_1.version);
-const path = (0, argumentUtil_1.getArgValue)(args, ['-p', '--path']);
-if (typeof path === 'undefined') {
-    color_logger_1.default.error('Path argument is required. Use --path to specify the path to solution folder.');
-    process.exit(1);
-}
-task.runUpgrade(path, verboseArgument !== undefined);
+task.runUpgrade(options.path, options.verbose || false);

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tywalk/pcf-helper",
-    "version": "1.4.26",
+    "version": "1.5.1",
     "description": "Command line helper for building and publishing PCF controls to Dataverse.",
     "main": "dist/index.js",
     "types": "./types/",
@@ -15,7 +15,7 @@
         "test": "jest",
         "build": "tsc",
         "upgrade": "npm version patch --no-git-tag-version",
-        "ready": "npm run upgrade"
+        "ready": "npm run upgrade && npm run build && npm publish --access public"
     },
     "keywords": [
         "pcf"

package/dist/tasks/session-pcf.js

@@ -18,37 +18,27 @@ const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const playwright_1 = require("playwright");
-const commander_1 = require("commander");
-function loadConfig() {
-    const program = new commander_1.Command();
-    program
-        .option('-u, --url <url>', 'remote environment URL')
-        .option('-s, --script <script>', 'remote script to intercept')
-        .option('-t, --stylesheet <stylesheet>', 'remote stylesheet to intercept')
-        .option('-b, --bundle <path>', 'local bundle path')
-        .option('-c, --css <path>', 'local CSS path')
-        .option('-f, --config <path>', 'config file path', 'dev-config.json')
-        .parse();
-    const options = program.opts();
+function loadConfig(config) {
     // Load file config if exists
     let fileConfig = {};
-    const configPath = path_1.default.join(__dirname, options.config);
-    console.log(`📁 Looking for config file at: ${configPath}`);
+    const configPath = path_1.default.join(process.cwd(), config || 'dev-config.json');
+    color_logger_1.default.log(`📁 Looking for config file at: ${configPath}`);
     if (fs_1.default.existsSync(configPath)) {
         fileConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-        console.log(`✅ Loaded config file: ${JSON.stringify(fileConfig, null, 2)}`);
+        color_logger_1.default.log(`✅ Loaded config file: ${JSON.stringify(fileConfig, null, 2)}`);
+    }
+    else if (process.env.REMOTE_ENVIRONMENT_URL) {
+        color_logger_1.default.warn(`⚠️ Config file not found, using defaults or CLI/env options.`);
     }
     else {
-        console.log(`⚠️ Config file not found, using defaults or CLI/env options.`);
+        return {}; // No config file and no env vars, return empty config to use defaults
     }
     // Get the base URL first
-    const remoteEnvironmentUrl = options.url ||
-        process.env.REMOTE_ENVIRONMENT_URL ||
+    const remoteEnvironmentUrl = process.env.REMOTE_ENVIRONMENT_URL ||
         fileConfig.remoteEnvironmentUrl ||
         'https://app.your-remote-environment.com';
     // Handle script argument - support both relative paths and full URLs
-    let remoteScriptToIntercept = options.script ||
-        process.env.REMOTE_SCRIPT_TO_INTERCEPT ||
+    let remoteScriptToIntercept = process.env.REMOTE_SCRIPT_TO_INTERCEPT ||
         fileConfig.remoteScriptToIntercept ||
         'https://app.your-remote-environment.com/static/js/remote-control-bundle.js';
     // If script is a relative path (doesn't start with http/https), combine with base URL
@@ -61,8 +51,7 @@ function loadConfig() {
             : '/' + remoteScriptToIntercept;
         remoteScriptToIntercept = `${baseUrl}${scriptPath}`;
     }
-    let remoteStylesheetToIntercept = options.stylesheet ||
-        process.env.REMOTE_STYLESHEET_TO_INTERCEPT ||
+    let remoteStylesheetToIntercept = process.env.REMOTE_STYLESHEET_TO_INTERCEPT ||
         fileConfig.remoteStylesheetToIntercept ||
         'https://app.your-remote-environment.com/static/css/remote-control-styles.css';
     // If stylesheet is a relative path (doesn't start with http/https), combine with base URL
@@ -80,17 +69,19 @@ function loadConfig() {
         remoteEnvironmentUrl: remoteEnvironmentUrl,
         remoteScriptToIntercept: remoteScriptToIntercept,
         remoteStylesheetToIntercept: remoteStylesheetToIntercept,
-        localCssPath: options.css ||
-            process.env.LOCAL_CSS_PATH ||
+        localCssPath: process.env.LOCAL_CSS_PATH ||
             fileConfig.localCssPath ||
             path_1.default.join(__dirname, 'dist', 'local-control-styles.css'),
-        localBundlePath: options.bundle ||
-            process.env.LOCAL_BUNDLE_PATH ||
+        localBundlePath: process.env.LOCAL_BUNDLE_PATH ||
             fileConfig.localBundlePath ||
             path_1.default.join(__dirname, 'dist', 'local-control-bundle.js')
     };
 }
 function runSession(remoteEnvironmentUrl, remoteScriptToIntercept, remoteStylesheetToIntercept, localBundlePath, localCssPath) {
+    if (!remoteEnvironmentUrl) {
+        color_logger_1.default.error('❌ Remote environment URL is required. Please provide it via CLI, config file, or environment variable.');
+        process.exit(1);
+    }
     const REMOTE_ENVIRONMENT_URL = remoteEnvironmentUrl;
     const REMOTE_SCRIPT_TO_INTERCEPT = remoteScriptToIntercept;
     const REMOTE_STYLESHEET_TO_INTERCEPT = remoteStylesheetToIntercept;

package/dist/util/argumentUtil.js

@@ -1,7 +1,17 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getArg = getArg;
 exports.getArgValue = getArgValue;
+exports.preprocessArgs = preprocessArgs;
+exports.resolveEnvironment = resolveEnvironment;
+exports.applyArgumentPreprocessing = applyArgumentPreprocessing;
+exports.addCommonOptions = addCommonOptions;
+exports.addPathAndEnvironmentOptions = addPathAndEnvironmentOptions;
+exports.setupLogging = setupLogging;
+const color_logger_1 = __importDefault(require("@tywalk/color-logger"));
 function getArg(args, arg) {
     const index = args.indexOf(arg);
     if (index !== -1 && index + 1 < args.length) {
@@ -18,3 +28,90 @@ function getArgValue(args, argOpts, defaultIfExists) {
     const argIndex = args.indexOf(arg) + 1;
     return (_a = args.at(argIndex)) !== null && _a !== void 0 ? _a : defaultIfExists;
 }
+/**
+ * Preprocesses command line arguments to handle deprecated flags
+ * @param args - Raw command line arguments
+ * @returns Object containing processed args and deprecation flags
+ */
+function preprocessArgs(args) {
+    const processed = [...args];
+    let hadDeprecatedEnv = false;
+    // Handle deprecated -env flag (single dash) by converting to --env (double dash)
+    for (let i = 0; i < processed.length; i++) {
+        if (processed[i] === '-env') {
+            hadDeprecatedEnv = true;
+            processed[i] = '--env';
+        }
+    }
+    return { args: processed, hadDeprecatedEnv };
+}
+/**
+ * Resolves environment value from options with proper deprecation warnings
+ * @param options - Parsed Commander.js options
+ * @param hadDeprecatedEnv - Whether the deprecated -env flag was used
+ * @returns Resolved environment string
+ */
+function resolveEnvironment(options, hadDeprecatedEnv) {
+    // Check if deprecated --env flag was used
+    if (options.env && options.environment) {
+        color_logger_1.default.warn('⚠️  Both --env (deprecated) and --environment flags provided. Using --environment value.');
+        return options.environment;
+    }
+    else if (options.env) {
+        if (hadDeprecatedEnv) {
+            color_logger_1.default.warn('⚠️  The -env flag is DEPRECATED. Please use -e or --environment instead.');
+        }
+        else {
+            color_logger_1.default.warn('⚠️  The --env flag is DEPRECATED. Please use -e or --environment instead.');
+        }
+        return options.env;
+    }
+    else {
+        return options.environment || '';
+    }
+}
+/**
+ * Applies argument preprocessing for backward compatibility
+ * @param originalArgv - The original process.argv
+ */
+function applyArgumentPreprocessing(originalArgv) {
+    const { args: processedArgs, hadDeprecatedEnv } = preprocessArgs(originalArgv.slice(2));
+    process.argv = [...originalArgv.slice(0, 2), ...processedArgs];
+    return { hadDeprecatedEnv };
+}
+/**
+ * Adds common CLI options to a Commander.js command
+ * @param command - Commander.js command instance
+ * @returns The command with common options added
+ */
+function addCommonOptions(command) {
+    return command
+        .option('-V, --verbose', 'enable verbose logging')
+        .option('-t, --timeout <milliseconds>', 'timeout in milliseconds', (value) => {
+        const num = Number(value);
+        if (isNaN(num) || num <= 0) {
+            throw new Error('Timeout must be a positive number');
+        }
+        return value;
+    });
+}
+/**
+ * Adds path and environment options to a Commander.js command
+ * @param command - Commander.js command instance
+ * @returns The command with path and environment options added
+ */
+function addPathAndEnvironmentOptions(command) {
+    return addCommonOptions(command)
+        .requiredOption('-p, --path <path>', 'path to solution folder')
+        .option('-e, --environment <environment>', 'environment name')
+        .option('--env <environment>', '[DEPRECATED: use -e/--environment] environment name (deprecated)');
+}
+/**
+ * Sets up logging based on verbose option
+ * @param verbose - Whether verbose logging is enabled
+ */
+function setupLogging(verbose) {
+    if (verbose) {
+        color_logger_1.default.setDebug(true);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tywalk/pcf-helper",
-  "version": "1.4.26",
+  "version": "1.5.1",
   "description": "Command line helper for building and publishing PCF controls to Dataverse.",
   "main": "dist/index.js",
   "types": "./types/",
@@ -15,7 +15,7 @@
     "test": "jest",
     "build": "tsc",
     "upgrade": "npm version patch --no-git-tag-version",
-    "ready": "npm run upgrade"
+    "ready": "npm run upgrade && npm run build && npm publish --access public"
   },
   "keywords": [
     "pcf"

package/types/tasks/session-pcf.d.ts

@@ -1,4 +1,10 @@
-declare function loadConfig(): {
+declare function loadConfig(config?: string): {
+    remoteEnvironmentUrl?: undefined;
+    remoteScriptToIntercept?: undefined;
+    remoteStylesheetToIntercept?: undefined;
+    localCssPath?: undefined;
+    localBundlePath?: undefined;
+} | {
     remoteEnvironmentUrl: any;
     remoteScriptToIntercept: any;
     remoteStylesheetToIntercept: any;

package/types/util/argumentUtil.d.ts

@@ -1,2 +1,46 @@
+import { Command } from 'commander';
 export declare function getArg(args: string[], arg: string): string | undefined;
 export declare function getArgValue(args: string[], argOpts: string[], defaultIfExists?: any): string | undefined;
+/**
+ * Preprocesses command line arguments to handle deprecated flags
+ * @param args - Raw command line arguments
+ * @returns Object containing processed args and deprecation flags
+ */
+export declare function preprocessArgs(args: string[]): {
+    args: string[];
+    hadDeprecatedEnv: boolean;
+};
+/**
+ * Resolves environment value from options with proper deprecation warnings
+ * @param options - Parsed Commander.js options
+ * @param hadDeprecatedEnv - Whether the deprecated -env flag was used
+ * @returns Resolved environment string
+ */
+export declare function resolveEnvironment(options: {
+    env?: string;
+    environment?: string;
+}, hadDeprecatedEnv: boolean): string;
+/**
+ * Applies argument preprocessing for backward compatibility
+ * @param originalArgv - The original process.argv
+ */
+export declare function applyArgumentPreprocessing(originalArgv: string[]): {
+    hadDeprecatedEnv: boolean;
+};
+/**
+ * Adds common CLI options to a Commander.js command
+ * @param command - Commander.js command instance
+ * @returns The command with common options added
+ */
+export declare function addCommonOptions(command: Command): Command;
+/**
+ * Adds path and environment options to a Commander.js command
+ * @param command - Commander.js command instance
+ * @returns The command with path and environment options added
+ */
+export declare function addPathAndEnvironmentOptions(command: Command): Command;
+/**
+ * Sets up logging based on verbose option
+ * @param verbose - Whether verbose logging is enabled
+ */
+export declare function setupLogging(verbose?: boolean): void;