@tywalk/pcf-helper-run 1.5.0 → 1.7.0

package/README.md

@@ -13,6 +13,7 @@ This package provides a single, consolidated command-line interface that brings
 - [Quick Start](#-quick-start)
 - [Command Structure](#️-command-structure)
 - [Available Subcommands](#️-available-subcommands)
+- [Profiles](#-profiles)
 - [Usage Examples](#-detailed-command-reference)
 - [Workflow Examples](#-workflow-examples)
 - [Global Options](#️-global-options)
@@ -83,6 +84,104 @@ Each subcommand corresponds to a specific PCF operation, with consistent option
 | `deploy` | Deploy to environment (upgrade + build + import) | `pcf-helper-deploy` |
 | `upgrade` | Upgrade project dependencies | `pcf-helper-upgrade` |
 | `session` | Manage development sessions | `pcf-helper-session` |
+| `profile` | Inspect named profiles (`list`, `show`, `current`, `paths`) | `pcf-helper-profile` |
+
+## 🧭 Profiles
+
+Every command accepts `-P, --profile <name>` so you don't have to retype `--environment`, `--path`, `--publisher-name`, or `--publisher-prefix` on every run. Profiles are defined in a JSON config file that's merged from two places (project overrides global):
+
+1. `~/.pcf-helper/config.json` — global defaults for this machine.
+2. `./pcf-helper.config.json` — project-specific overrides.
+
+Example config:
+
+```json
+{
+  "defaultProfile": "dev",
+  "profiles": {
+    "dev":  { "environment": "DevEnv",  "publisherName": "Tyler W", "publisherPrefix": "tyw" },
+    "test": { "environment": "TestEnv" },
+    "prod": { "environment": "ProdEnv" }
+  },
+  "session": {
+    "remoteEnvironmentUrl": "https://org.crm.dynamics.com",
+    "localBundlePath": "out/controls/MyControl/bundle.js",
+    "startWatch": true
+  }
+}
+```
+
+### Precedence (highest wins)
+
+For `build`, `deploy`, `import`, `upgrade`, `init`:
+1. Explicit CLI flags
+2. Active profile (`--profile <name>` or `defaultProfile`)
+3. Defaults
+
+For `session`:
+1. Explicit CLI flags
+2. Environment variables
+3. Active profile's `session` block
+4. Top-level `session` block in `pcf-helper.config.json`
+5. Legacy `session.config.json` (kept for backward compatibility)
+6. Defaults
+
+### Usage
+
+```bash
+# Use the default profile
+pcf-helper-run deploy -p ./MySolution
+
+# Pick a specific profile
+pcf-helper-run deploy -p ./MySolution --profile prod
+
+# CLI flags always win
+pcf-helper-run deploy -p ./MySolution --profile prod --environment HotfixEnv
+
+# Inspect what is configured
+pcf-helper-run profile list
+pcf-helper-run profile show prod
+pcf-helper-run profile current
+pcf-helper-run profile paths
+
+# Create a profile without editing JSON (see below for the full flag list)
+pcf-helper-run profile init dev \
+  --environment MyDevOrg \
+  --publisher-name "Tyler W" \
+  --publisher-prefix tyw \
+  --path ./MySolution \
+  --set-default \
+  --no-interactive
+```
+
+### Creating a profile from the CLI
+
+`profile init <name>` creates or updates a profile without hand-editing
+`pcf-helper.config.json`. Project-level by default; pass `--global` to write to
+`~/.pcf-helper/config.json` (parent directory is created on first use).
+
+Interactive by default — each missing field prompts at the terminal, pre-filled
+with whatever you passed as a flag. Pass `--no-interactive` to skip the prompts
+entirely and write only what was supplied.
+
+| Flag | Description |
+|------|-------------|
+| `-e, --environment <env>` | Dataverse environment name |
+| `--publisher-name <name>` | Publisher display name |
+| `--publisher-prefix <prefix>` | Publisher prefix (2-8 chars) |
+| `-p, --path <path>` | Path to PCF solution folder |
+| `--template <template>` | `field` or `dataset` |
+| `--framework <framework>` | `none` or `react` |
+| `--session-url <url>` | Session: remote environment URL |
+| `--session-script <path>` | Session: remote script to intercept |
+| `--session-bundle <path>` | Session: local bundle path |
+| `-g, --global` | Write to `~/.pcf-helper/config.json` |
+| `-d, --set-default` | Also set `defaultProfile: <name>` |
+| `-f, --force` | Overwrite an existing profile of the same name |
+| `--no-interactive` | Skip prompts; only use passed flags |
+
+The write is atomic (temp file + rename), so an interrupted run never corrupts
+your config.
 
 ## 📖 Detailed Command Reference
 

package/dist/index.js

@@ -45,6 +45,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const tasks = __importStar(require("@tywalk/pcf-helper"));
+const pcf_helper_1 = require("@tywalk/pcf-helper");
 const color_logger_1 = require("@tywalk/color-logger");
 const package_json_1 = require("./package.json");
 const performanceUtil_1 = require("./util/performanceUtil");
@@ -61,7 +62,7 @@ const preprocessArgs = (args) => {
     }
     return { args: processed, hadDeprecatedEnv };
 };
-// Preprocess arguments and track if deprecated flags were used  
+// 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) => {
@@ -93,7 +94,8 @@ const withCommonOptions = (command) => {
             throw new Error('Timeout must be a positive number');
         }
         return value;
-    });
+    })
+        .option('-P, --profile <name>', 'named profile from pcf-helper.config.json to use for defaults');
 };
 const withPathOptions = (command) => {
     return withCommonOptions(command)
@@ -103,18 +105,16 @@ const withPathOptions = (command) => {
 };
 // Helper function to resolve environment value with deprecation warning
 const resolveEnvironment = (options, logger) => {
-    // Check if deprecated --env flag was used
     if (options.env && options.environment) {
-        logger.warn('⚠️  Both --env (deprecated) and --environment flags provided. Using --environment value.');
+        logger.warn('WARN: Both --env (deprecated) and --environment flags provided. Using --environment value.');
         return options.environment;
     }
     else if (options.env) {
-        // Show deprecation warning using the proper logger
         if (hadDeprecatedEnv) {
-            logger.warn('⚠️  The -env flag is DEPRECATED. Please use -e or --environment instead.');
+            logger.warn('WARN: The -env flag is DEPRECATED. Please use -e or --environment instead.');
         }
         else {
-            logger.warn('⚠️  The --env flag is DEPRECATED. Please use -e or --environment instead.');
+            logger.warn('WARN: The --env flag is DEPRECATED. Please use -e or --environment instead.');
         }
         return options.env;
     }
@@ -122,6 +122,15 @@ const resolveEnvironment = (options, logger) => {
         return options.environment || '';
     }
 };
+// Loads a profile (if any) and logs which one is in use.
+const loadProfile = (profileName, logger) => {
+    const { merged } = (0, pcf_helper_1.loadPcfHelperConfig)();
+    const { name, profile } = (0, pcf_helper_1.resolveProfile)(profileName, merged);
+    if (name) {
+        logger.log(`Using profile "${name}" from pcf-helper config.`);
+    }
+    return profile;
+};
 // Helper function to setup logger and performance tracking
 const setupExecutionContext = (options) => {
     const logger = new color_logger_1.Logger('log');
@@ -151,19 +160,22 @@ const handleResults = (taskName, logger, tick, result) => {
         process.exit(result);
     }
 };
-// Define the upgrade command
+// upgrade
 withPathOptions(commander_1.program.command('upgrade'))
     .description('upgrade PCF controls')
     .action((options) => {
+    var _a, _b;
     const { logger, tick } = setupExecutionContext(options);
-    if (!options.path) {
-        logger.error('Path argument is required. Use --path to specify the path to solution folder.');
+    const profile = loadProfile(options.profile, logger);
+    const resolvedPath = (_b = (_a = options.path) !== null && _a !== void 0 ? _a : profile === null || profile === void 0 ? void 0 : profile.path) !== null && _b !== void 0 ? _b : '';
+    if (!resolvedPath) {
+        logger.error('Path argument is required. Use --path or set `path` in the active profile.');
         process.exit(1);
     }
     let result = 0;
     try {
         logger.log('[PCF Helper Run] ' + (0, performanceUtil_1.formatTime)(new Date()) + ' upgrade started.\n');
-        result = tasks.runUpgrade(options.path, options.verbose || false);
+        result = tasks.runUpgrade(resolvedPath, options.verbose || false);
     }
     catch (e) {
         logger.error('[PCF Helper Run] One or more tasks failed while upgrading: ', e instanceof Error ? e.message : 'unknown error');
@@ -171,19 +183,22 @@ withPathOptions(commander_1.program.command('upgrade'))
     }
     handleResults('upgrade', logger, tick, result);
 });
-// Define the build command  
+// build
 withPathOptions(commander_1.program.command('build'))
     .description('build PCF controls')
     .action((options) => {
+    var _a, _b;
     const { logger, tick } = setupExecutionContext(options);
-    if (!options.path) {
-        logger.error('Path argument is required. Use --path to specify the path to solution folder.');
+    const profile = loadProfile(options.profile, logger);
+    const resolvedPath = (_b = (_a = options.path) !== null && _a !== void 0 ? _a : profile === null || profile === void 0 ? void 0 : profile.path) !== null && _b !== void 0 ? _b : '';
+    if (!resolvedPath) {
+        logger.error('Path argument is required. Use --path or set `path` in the active profile.');
         process.exit(1);
     }
     let result = 0;
     try {
         logger.log('[PCF Helper Run] ' + (0, performanceUtil_1.formatTime)(new Date()) + ' build started.\n');
-        result = tasks.runBuild(options.path, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
+        result = tasks.runBuild(resolvedPath, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
     }
     catch (e) {
         logger.error('[PCF Helper Run] One or more tasks failed while building: ', e instanceof Error ? e.message : 'unknown error');
@@ -191,23 +206,27 @@ withPathOptions(commander_1.program.command('build'))
     }
     handleResults('build', logger, tick, result);
 });
-// Define the import command
+// import
 withPathOptions(commander_1.program.command('import'))
     .description('import PCF controls')
     .action((options) => {
+    var _a, _b, _c;
     const { logger, tick } = setupExecutionContext(options);
-    if (!options.path) {
-        logger.error('Path argument is required. Use --path to specify the path to solution folder.');
+    const profile = loadProfile(options.profile, logger);
+    const resolvedPath = (_b = (_a = options.path) !== null && _a !== void 0 ? _a : profile === null || profile === void 0 ? void 0 : profile.path) !== null && _b !== void 0 ? _b : '';
+    if (!resolvedPath) {
+        logger.error('Path argument is required. Use --path or set `path` in the active profile.');
         process.exit(1);
     }
-    const env = resolveEnvironment(options, logger);
+    const explicitEnv = resolveEnvironment(options, logger);
+    const env = explicitEnv !== '' ? explicitEnv : (_c = profile === null || profile === void 0 ? void 0 : profile.environment) !== null && _c !== void 0 ? _c : '';
     if (env === '') {
         logger.warn('No environment specified. Defaulting to "local".');
     }
     let result = 0;
     try {
         logger.log('[PCF Helper Run] ' + (0, performanceUtil_1.formatTime)(new Date()) + ' import started.\n');
-        result = tasks.runImport(options.path, env, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
+        result = tasks.runImport(resolvedPath, 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 instanceof Error ? e.message : 'unknown error');
@@ -215,36 +234,37 @@ withPathOptions(commander_1.program.command('import'))
     }
     handleResults('import', logger, tick, result);
 });
-// Define the deploy command (runs upgrade, build, and import)
+// deploy
 withPathOptions(commander_1.program.command('deploy'))
     .description('deploy PCF controls (runs upgrade, build, and import)')
     .action((options) => {
+    var _a, _b, _c;
     const { logger, tick } = setupExecutionContext(options);
-    if (!options.path) {
-        logger.error('Path argument is required. Use --path to specify the path to solution folder.');
+    const profile = loadProfile(options.profile, logger);
+    const resolvedPath = (_b = (_a = options.path) !== null && _a !== void 0 ? _a : profile === null || profile === void 0 ? void 0 : profile.path) !== null && _b !== void 0 ? _b : '';
+    if (!resolvedPath) {
+        logger.error('Path argument is required. Use --path or set `path` in the active profile.');
         process.exit(1);
     }
-    const env = resolveEnvironment(options, logger);
+    const explicitEnv = resolveEnvironment(options, logger);
+    const env = explicitEnv !== '' ? explicitEnv : (_c = profile === null || profile === void 0 ? void 0 : profile.environment) !== null && _c !== void 0 ? _c : '';
     if (env === '') {
         logger.warn('No environment specified. Defaulting to "local".');
     }
     let result = 0;
     try {
         logger.log('[PCF Helper Run] ' + (0, performanceUtil_1.formatTime)(new Date()) + ' deploy started.\n');
-        // Run upgrade
-        const upgradeResult = tasks.runUpgrade(options.path, options.verbose || false);
+        const upgradeResult = tasks.runUpgrade(resolvedPath, options.verbose || false);
         if (upgradeResult === 1) {
             result = 1;
         }
         else {
-            // Run build
-            const buildResult = tasks.runBuild(options.path, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
+            const buildResult = tasks.runBuild(resolvedPath, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
             if (buildResult === 1) {
                 result = 1;
             }
             else {
-                // Run import
-                const importResult = tasks.runImport(options.path, env, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
+                const importResult = tasks.runImport(resolvedPath, env, options.verbose || false, options.timeout ? Number(options.timeout) : undefined);
                 if (importResult === 1) {
                     result = 1;
                 }
@@ -257,22 +277,25 @@ withPathOptions(commander_1.program.command('deploy'))
     }
     handleResults('deploy', logger, tick, result);
 });
-// Define the init command
+// init
 withVerboseOption(commander_1.program.command('init'))
     .description('initialize a new PCF project')
-    .requiredOption('-p, --path <path>', 'path to PCF folder')
     .requiredOption('-n, --name <name>', 'name of the control')
-    .requiredOption('--publisher-name <publisherName>', 'publisher name')
-    .requiredOption('--publisher-prefix <publisherPrefix>', 'publisher prefix')
-    .option('-t, --template <template>', 'template for the component (field|dataset)', 'field')
-    .option('-f, --framework <framework>', 'rendering framework for control (none|react)', 'react')
+    .option('-p, --path <path>', 'path to PCF folder')
+    .option('--publisher-name <publisherName>', 'publisher name')
+    .option('--publisher-prefix <publisherPrefix>', 'publisher prefix')
+    .option('-t, --template <template>', 'template for the component (field|dataset)')
+    .option('-f, --framework <framework>', 'rendering framework for control (none|react)')
     .option('--run-npm-install', 'run npm install after initialization', true)
+    .option('-P, --profile <name>', 'named profile from pcf-helper.config.json to use for defaults')
     .action((options) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     const { logger, tick } = setupExecutionContext(options);
+    const profile = loadProfile(options.profile, logger);
     let result = 0;
     try {
         logger.log('[PCF Helper Run] ' + (0, performanceUtil_1.formatTime)(new Date()) + ' init started.\n');
-        result = tasks.runInit(options.path, options.name, options.publisherName, options.publisherPrefix, options.template || 'field', options.framework || 'react', options.runNpmInstall !== false, options.verbose || false);
+        result = tasks.runInit((_b = (_a = options.path) !== null && _a !== void 0 ? _a : profile === null || profile === void 0 ? void 0 : profile.path) !== null && _b !== void 0 ? _b : '', options.name, (_d = (_c = options.publisherName) !== null && _c !== void 0 ? _c : profile === null || profile === void 0 ? void 0 : profile.publisherName) !== null && _d !== void 0 ? _d : '', (_f = (_e = options.publisherPrefix) !== null && _e !== void 0 ? _e : profile === null || profile === void 0 ? void 0 : profile.publisherPrefix) !== null && _f !== void 0 ? _f : '', (_h = (_g = options.template) !== null && _g !== void 0 ? _g : profile === null || profile === void 0 ? void 0 : profile.template) !== null && _h !== void 0 ? _h : 'field', (_k = (_j = options.framework) !== null && _j !== void 0 ? _j : profile === null || profile === void 0 ? void 0 : profile.framework) !== null && _k !== void 0 ? _k : 'react', options.runNpmInstall !== false, options.verbose || false);
     }
     catch (e) {
         logger.error('[PCF Helper Run] One or more tasks failed while initializing: ', e instanceof Error ? e.message : 'unknown error');
@@ -280,7 +303,7 @@ withVerboseOption(commander_1.program.command('init'))
     }
     handleResults('init', logger, tick, result);
 });
-// Define the session command
+// session
 withCommonOptions(commander_1.program.command('session'))
     .description('run development session')
     .option('-u, --url <url>', 'remote environment URL')
@@ -292,31 +315,20 @@ withCommonOptions(commander_1.program.command('session'))
     .option('-w, --watch', 'start pcf-scripts watch process')
     .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;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     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((_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 {
-            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 config = tasks.loadConfig(options.config, options.profile);
+        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('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;
+        yield tasks.runSession((_e = options.url) !== null && _e !== void 0 ? _e : config.remoteEnvironmentUrl, (_f = options.script) !== null && _f !== void 0 ? _f : config.remoteScriptToIntercept, (_g = options.stylesheet) !== null && _g !== void 0 ? _g : config.remoteStylesheetToIntercept, (_h = options.bundle) !== null && _h !== void 0 ? _h : config.localBundlePath, (_j = options.css) !== null && _j !== void 0 ? _j : config.localCssPath, startWatch, watchRetry);
         const tock = performance.now();
         logger.log((0, performanceUtil_1.formatMsToSec)('Session started successfully in %is.', tock - tick));
     }
@@ -324,5 +336,108 @@ withCommonOptions(commander_1.program.command('session'))
         logger.error('[PCF Helper Run] One or more tasks failed during session or session startup: ', e instanceof Error ? e.message : 'unknown error');
     }
 }));
-// Parse the command line arguments
-commander_1.program.parse();
+// profile subcommand
+const profileCmd = commander_1.program.command('profile').description('inspect pcf-helper profiles from pcf-helper.config.json');
+profileCmd
+    .command('list')
+    .description('list all available profile names')
+    .action(() => {
+    var _a;
+    const { merged, sources } = (0, pcf_helper_1.loadPcfHelperConfig)();
+    const names = Object.keys((_a = merged.profiles) !== null && _a !== void 0 ? _a : {});
+    const isDefault = (n) => (merged.defaultProfile === n ? ' (default)' : '');
+    if (sources.length === 0) {
+        console.log('No pcf-helper config files found.');
+        console.log('Looked at:');
+        console.log('  - global: ~/.pcf-helper/config.json');
+        console.log('  - project: ./pcf-helper.config.json');
+        return;
+    }
+    console.log('Loaded config from:');
+    for (const s of sources)
+        console.log(`  - ${s}`);
+    if (names.length === 0) {
+        console.log('\nNo profiles defined.');
+        return;
+    }
+    console.log('\nProfiles:');
+    for (const n of names)
+        console.log(`  - ${n}${isDefault(n)}`);
+});
+profileCmd
+    .command('show <name>')
+    .description('print the resolved contents of a profile')
+    .action((name) => {
+    var _a, _b;
+    const { merged } = (0, pcf_helper_1.loadPcfHelperConfig)();
+    const profile = (_a = merged.profiles) === null || _a === void 0 ? void 0 : _a[name];
+    if (!profile) {
+        const available = Object.keys((_b = merged.profiles) !== null && _b !== void 0 ? _b : {});
+        console.error(`Profile "${name}" not found. Available: ${available.join(', ') || '(none)'}`);
+        process.exit(1);
+    }
+    console.log(JSON.stringify(profile, null, 2));
+});
+profileCmd
+    .command('current')
+    .description('print the profile that would be used by default')
+    .action(() => {
+    const { merged } = (0, pcf_helper_1.loadPcfHelperConfig)();
+    if (!merged.defaultProfile) {
+        console.log('No defaultProfile set.');
+        return;
+    }
+    console.log(merged.defaultProfile);
+});
+profileCmd
+    .command('paths')
+    .description('print the global and project config paths')
+    .action(() => {
+    const { projectPath, globalPath, sources } = (0, pcf_helper_1.loadPcfHelperConfig)();
+    console.log(`global:  ${globalPath}`);
+    console.log(`project: ${projectPath}`);
+    console.log(`loaded:  ${sources.length ? sources.join(', ') : '(none)'}`);
+});
+profileCmd
+    .command('init <name>')
+    .description('create a new profile in pcf-helper.config.json (project or global)')
+    .option('-e, --environment <env>', 'Dataverse environment name')
+    .option('--publisher-name <name>', 'publisher display name')
+    .option('--publisher-prefix <prefix>', 'publisher prefix (2-8 chars)')
+    .option('-p, --path <path>', 'path to PCF solution folder')
+    .option('--template <template>', 'control template (field|dataset)')
+    .option('--framework <framework>', 'rendering framework (none|react)')
+    .option('--session-url <url>', 'session: remote environment URL')
+    .option('--session-script <path>', 'session: remote script to intercept')
+    .option('--session-bundle <path>', 'session: local bundle path')
+    .option('-g, --global', 'write to ~/.pcf-helper/config.json instead of project-level')
+    .option('-d, --set-default', 'set this profile as the defaultProfile')
+    .option('-f, --force', 'overwrite an existing profile of the same name')
+    .option('--no-interactive', 'skip prompts for missing fields')
+    .action((name, flags) => __awaiter(void 0, void 0, void 0, function* () {
+    const options = {
+        name,
+        environment: flags.environment,
+        publisherName: flags.publisherName,
+        publisherPrefix: flags.publisherPrefix,
+        path: flags.path,
+        template: flags.template,
+        framework: flags.framework,
+        sessionUrl: flags.sessionUrl,
+        sessionScript: flags.sessionScript,
+        sessionBundle: flags.sessionBundle,
+        global: !!flags.global,
+        setDefault: !!flags.setDefault,
+        force: !!flags.force,
+        nonInteractive: flags.interactive === false,
+    };
+    try {
+        yield (0, pcf_helper_1.runProfileInit)(options);
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        console.error(`Error: ${message}`);
+        process.exit(1);
+    }
+}));
+commander_1.program.parseAsync();

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tywalk/pcf-helper-run",
-    "version": "1.4.1",
+    "version": "1.6.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.14.0"
+        "@tywalk/pcf-helper": "^1.16.0"
     },
     "devDependencies": {
         "@semantic-release/git": "^10.0.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tywalk/pcf-helper-run",
-  "version": "1.5.0",
+  "version": "1.7.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.14.0"
+    "@tywalk/pcf-helper": "^1.16.0"
   },
   "devDependencies": {
     "@semantic-release/git": "^10.0.1",