@tywalk/pcf-helper 1.5.5 → 1.5.8

package/README.md

@@ -1,33 +1,257 @@
-# PCF Helper
+# PCF Helper Core 🔧
 
-A simple command-line tool that upgrades, builds, and imports your PCF control into your Dataverse environment.
+[![npm version](https://badge.fury.io/js/%40tywalk%2Fpcf-helper.svg)](https://badge.fury.io/js/%40tywalk%2Fpcf-helper)
+[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 
-You can run commands separately or run `pcf-helper-deploy` to upgrade, build, and import with just one command.
+**Individual CLI commands and core library for Power Platform Component Framework (PCF) development.**
 
-## Requirements
+This package provides discrete command-line utilities for each PCF operation, making it ideal for automation scripts and developers who prefer granular control over their PCF workflows.
 
-This tool requires the following:
+## 📋 Table of Contents
 
-* `pac` cli installed on your machine.
-* `dotnet` cli or Visual Studio installed on your machine.
+- [Installation](#installation)
+- [Available Commands](#available-commands)
+- [Command Reference](#command-reference)
+- [API Reference](#api-reference)
+- [Troubleshooting](#troubleshooting)
 
-## Instructions
+## 📦 Installation
 
-1. In your project, run `npm install --save @tywalk/pcf-helper`. Or, install globally `npm install --save --global @tywalk/pcf-helper`.
-2. In your project's `package.json` file, add commands as npm scripts:
+### Global Installation (Recommended)
 
-```json
-"scripts": {
-  "upgrade": "pcf-helper-upgrade --path <path to pcf project folder>",
-  "build": "pcf-helper-build --path <path to pcf project folder>",
-  "import": "pcf-helper-import --path <path to pcf project folder> --environment <environment guid or url>",
-  "deploy": "pcf-helper-deploy --path <path to pcf project folder> --environment <environment guid or url>",
-  "init": "pcf-helper-init --path <path to pcf project folder (optional)> --name <name of the pcf project> --publisher-name <powerapps publisher name> --publisher-prefix <powerapps publisher prefix>"
-},
+```bash
+npm install -g @tywalk/pcf-helper
 ```
 
-## Contributing
+### Local Installation
 
-### Deployment
+```bash
+npm install @tywalk/pcf-helper
+```
+
+## 🛠️ Available Commands
+
+Each command is available as a standalone executable:
+
+| Command | Purpose | Global Usage |
+|---------|---------|--------------|
+| `pcf-helper-init` | Initialize new PCF project | `pcf-helper-init [options]` |
+| `pcf-helper-build` | Build PCF controls | `pcf-helper-build [options]` |
+| `pcf-helper-import` | Import controls to solution | `pcf-helper-import [options]` |
+| `pcf-helper-deploy` | Deploy controls (upgrade + build + import) | `pcf-helper-deploy [options]` |
+| `pcf-helper-upgrade` | Upgrade project dependencies | `pcf-helper-upgrade [options]` |
+| `pcf-helper-session` | Manage development sessions | `pcf-helper-session [options]` |
+
+## 📖 Command Reference
+
+### 🏗️ pcf-helper-init
+
+Initialize a new PCF project with proper scaffolding.
+
+```bash
+pcf-helper-init -n <control-name> [options]
+```
+
+#### Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-n, --name <name>` | Name of the PCF control | ✅ | - |
+| `--publisher-name <name>` | Publisher name for the control | ❌ | - |
+| `--publisher-prefix <prefix>` | Publisher prefix | ❌ | - |
+| `-p, --path <path>` | Path to create the project | ❌ | Current directory |
+| `--run-npm-install` | Run npm install after init | ❌ | `true` |
+| `-V, --verbose` | Enable verbose logging | ❌ | `false` |
+| `-v, --version` | Display version | ❌ | - |
+
+#### Example
+
+```bash
+# Basic initialization
+pcf-helper-init -n MyCustomControl
+
+# Full initialization with custom settings
+pcf-helper-init -n MyCustomControl \
+  --publisher-name "Contoso" \
+  --publisher-prefix "con" \
+  -p ./my-pcf-project \
+  --verbose
+```
+
+### ⚡ pcf-helper-build
+
+Build and compile your PCF controls.
+
+```bash
+pcf-helper-build -p <solution-path> [options]
+```
+
+#### Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-p, --path <path>` | Path to solution folder | ✅ | - |
+| `-t, --timeout <ms>` | Timeout in milliseconds | ❌ | 300000 |
+| `-V, --verbose` | Enable verbose logging | ❌ | `false` |
+| `-v, --version` | Display version | ❌ | - |
+
+#### Example
+
+```bash
+# Build with default settings
+pcf-helper-build -p ./MySolution
+
+# Build with custom timeout and verbose output
+pcf-helper-build -p ./MySolution --timeout 120000 --verbose
+```
+
+### 📦 pcf-helper-import
+
+Import PCF controls into your Dataverse solution.
+
+```bash
+pcf-helper-import -p <solution-path> [options]
+```
+
+#### Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-p, --path <path>` | Path to solution folder | ✅ | - |
+| `-e, --environment <environment>` | Target environment | ❌ | - |
+| `-t, --timeout <ms>` | Timeout in milliseconds | ❌ | 300000 |
+| `-V, --verbose` | Enable verbose logging | ❌ | `false` |
+| `-v, --version` | Display version | ❌ | - |
+
+### 🚀 pcf-helper-deploy
+
+Deploy your PCF controls to the target environment. This command runs upgrade, build, and import in sequence.
+
+```bash
+pcf-helper-deploy -p <solution-path> [options]
+```
+
+#### Options
+
+Same as pcf-helper-import, but runs the full deployment pipeline.
+
+### 🔄 pcf-helper-upgrade
+
+Upgrade project dependencies and framework versions.
+
+```bash
+pcf-helper-upgrade -p <solution-path> [options]
+```
+
+#### Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-p, --path <path>` | Path to solution folder | ✅ | - |
+| `-V, --verbose` | Enable verbose logging | ❌ | `false` |
+| `-v, --version` | Display version | ❌ | - |
+
+### 🎯 pcf-helper-session
+
+Manage development sessions with live reloading capabilities.
+
+```bash
+pcf-helper-session [options]
+```
+
+#### Options
+
+| Option | Description | Required | Default |
+|--------|-------------|----------|---------|
+| `-u, --url <url>` | Remote environment URL | ❌ | - |
+| `-s, --script <path>` | Remote script to intercept | ❌ | - |
+| `-t, --stylesheet <path>` | Remote stylesheet to intercept | ❌ | - |
+| `-b, --bundle <path>` | Local bundle path | ❌ | - |
+| `-c, --css <path>` | Local CSS path | ❌ | - |
+| `-f, --config <path>` | Config file path | ❌ | `session.config.json` |
+| `-V, --verbose` | Enable verbose logging | ❌ | `false` |
+| `-v, --version` | Display version | ❌ | - |
+
+## 🔧 API Reference
+
+You can also use PCF Helper programmatically in your Node.js applications:
+
+```typescript
+import * as pcfHelper from '@tywalk/pcf-helper';
+
+// Build a PCF control
+const result = pcfHelper.runBuild('./my-solution', true, 120000);
+
+// Initialize a new project
+const initResult = pcfHelper.runInit(
+  './new-project',
+  'MyControl',
+  'My Publisher',
+  'mp',
+  true,
+  true
+);
+
+// Set logging level
+pcfHelper.setLogLevel('debug');
+```
+
+### Available Functions
+
+- `runBuild(path, verbose, timeout?)` - Build PCF controls
+- `runInit(path, name, publisherName, publisherPrefix, runNpmInstall, verbose)` - Initialize new PCF project
+- `runImport(path, environment, verbose, timeout?)` - Import controls to solution
+- `runUpgrade(path, verbose)` - Upgrade project
+- `runSession(...)` - Manage development sessions
+- `setLogLevel(level)` - Set logging verbosity ('debug' | 'info' | 'warn' | 'error')
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+#### Build Failures
+
+```bash
+# Enable verbose logging for detailed error information
+pcf-helper-build -p . --verbose
+
+# Check if PAC CLI is properly installed
+pac --version
+
+# Verify .NET SDK installation
+dotnet --version
+```
+
+#### Timeout Errors
+
+```bash
+# Increase timeout for large projects
+pcf-helper-build -p . --timeout 600000  # 10 minutes
+```
+
+### Getting Help
+
+```bash
+# Show help for any command
+pcf-helper-build --help
+pcf-helper-init --help
+
+# Show version
+pcf-helper-build --version
+```
+
+## 📚 Additional Resources
+
+- [Power Platform Component Framework Documentation](https://docs.microsoft.com/en-us/powerapps/developer/component-framework/)
+- [Power Platform CLI Reference](https://docs.microsoft.com/en-us/powerapps/developer/data-platform/powerapps-cli)
+
+## 🔗 Related Packages
+
+- **[@tywalk/pcf-helper-run](../pcf-helper-run/README.md)** - Unified CLI interface
+- **[@tywalk/color-logger](https://www.npmjs.com/package/@tywalk/color-logger)** - Enhanced logging utilities
+
+---
+
+## 🏠 [← Back to Main Package](../../README.md)
 
-  
+For questions or issues, please visit our [GitHub Issues](https://github.com/tywalk/pcf-helper/issues) page.

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

@@ -12,14 +12,18 @@ test('build displays version', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
-        expect(output).toContain(`v${package_json_1.version}`);
+        expect(output).toContain(package_json_1.version);
         expect(code).toBe(0);
         done();
     });
 });
 test('build errors if no path is provided', (done) => {
     const task = (0, child_process_1.spawn)('node', ['./dist/bin/build.js', '-p']);
+    // Add timeout  
+    const timeout = setTimeout(() => {
+        task.kill();
+        done.fail('Test timed out');
+    }, 5000);
     let output = '';
     task.stdout.on('data', (data) => {
         output += data.toString();
@@ -28,8 +32,8 @@ test('build errors if no path is provided', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
         expect(code).toBe(1);
+        clearTimeout(timeout);
         done();
     });
 });

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

@@ -12,14 +12,18 @@ test('deploy displays version', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
-        expect(output).toContain(`v${package_json_1.version}`);
+        expect(output).toContain(package_json_1.version);
         expect(code).toBe(0);
         done();
     });
 });
 test('deploy errors if no path is provided', (done) => {
     const task = (0, child_process_1.spawn)('node', ['./dist/bin/deploy.js', '-p']);
+    // Add timeout  
+    const timeout = setTimeout(() => {
+        task.kill();
+        done.fail('Test timed out');
+    }, 5000);
     let output = '';
     task.stdout.on('data', (data) => {
         output += data.toString();
@@ -28,8 +32,8 @@ test('deploy errors if no path is provided', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
         expect(code).toBe(1);
+        clearTimeout(timeout);
         done();
     });
 });

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

@@ -9,14 +9,18 @@ test('import displays version', (done) => {
         output += data.toString();
     });
     task.on('close', (code) => {
-        console.log(output);
-        expect(output).toContain(`v${package_json_1.version}`);
+        expect(output).toContain(package_json_1.version);
         expect(code).toBe(0);
         done();
     });
 });
 test('import errors if no path is provided', (done) => {
     const task = (0, child_process_1.spawn)('node', ['./dist/bin/import.js', '-p']);
+    // Add timeout  
+    const timeout = setTimeout(() => {
+        task.kill();
+        done.fail('Test timed out');
+    }, 5000);
     let output = '';
     task.stdout.on('data', (data) => {
         output += data.toString();
@@ -25,8 +29,8 @@ test('import errors if no path is provided', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
         expect(code).toBe(1);
+        clearTimeout(timeout);
         done();
     });
 });

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

@@ -9,14 +9,18 @@ test('init displays version', (done) => {
         output += data.toString();
     });
     task.on('close', (code) => {
-        console.log(output);
-        expect(output).toContain(`v${package_json_1.version}`);
+        expect(output).toContain(package_json_1.version);
         expect(code).toBe(0);
         done();
     });
 });
 test('init errors if no path is provided', (done) => {
     const task = (0, child_process_1.spawn)('node', ['./dist/bin/init.js', '-p']);
+    // Add timeout  
+    const timeout = setTimeout(() => {
+        task.kill();
+        done.fail('Test timed out');
+    }, 5000);
     let output = '';
     task.stdout.on('data', (data) => {
         output += data.toString();
@@ -25,8 +29,8 @@ test('init errors if no path is provided', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
         expect(code).toBe(1);
+        clearTimeout(timeout);
         done();
     });
 });

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

@@ -9,14 +9,18 @@ test('session displays version', (done) => {
         output += data.toString();
     });
     task.on('close', (code) => {
-        console.log(output);
-        expect(output).toContain(`v${package_json_1.version}`);
+        expect(output).toContain(package_json_1.version);
         expect(code).toBe(0);
         done();
     });
 });
 test('session errors if no args are provided', (done) => {
     const task = (0, child_process_1.spawn)('node', ['./dist/bin/session.js', '-e']);
+    // Add timeout  
+    const timeout = setTimeout(() => {
+        task.kill();
+        done.fail('Test timed out');
+    }, 5000);
     let output = '';
     task.stdout.on('data', (data) => {
         output += data.toString();
@@ -25,8 +29,8 @@ test('session errors if no args are provided', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
         expect(code).toBe(1);
+        clearTimeout(timeout);
         done();
     });
 });

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

@@ -9,14 +9,18 @@ test('upgrade displays version', (done) => {
         output += data.toString();
     });
     task.on('close', (code) => {
-        console.log(output);
-        expect(output).toContain(`v${package_json_1.version}`);
+        expect(output).toContain(package_json_1.version);
         expect(code).toBe(0);
         done();
     });
 });
 test('upgrade errors if no path is provided', (done) => {
     const task = (0, child_process_1.spawn)('node', ['./dist/bin/upgrade.js', '-p']);
+    // Add timeout  
+    const timeout = setTimeout(() => {
+        task.kill();
+        done.fail('Test timed out');
+    }, 5000);
     let output = '';
     task.stdout.on('data', (data) => {
         output += data.toString();
@@ -25,8 +29,8 @@ test('upgrade errors if no path is provided', (done) => {
         console.error(`stderr: ${data}`);
     });
     task.on('close', (code) => {
-        console.log(output);
         expect(code).toBe(1);
+        clearTimeout(timeout);
         done();
     });
 });

package/dist/bin/session.js

@@ -52,7 +52,7 @@ program
     .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')
+    .option('-f, --config <path>', 'config file path', 'session.config.json')
     .parse();
 const options = program.opts();
 if (options.verbose) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tywalk/pcf-helper",
-    "version": "1.5.5",
+    "version": "1.5.7",
     "description": "Command line helper for building and publishing PCF controls to Dataverse.",
     "main": "dist/index.js",
     "types": "./types/",
@@ -11,11 +11,17 @@
     "repository": {
         "url": "git+https://github.com/tywalk/pcf-helper.git"
     },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
     "scripts": {
         "test": "jest",
         "build": "tsc",
         "upgrade": "npm version patch --no-git-tag-version",
-        "ready": "npm run upgrade && npm run build && npm publish --access public"
+        "ready": "npm run upgrade && npm run build",
+        "update": "npm run ready && npm publish --access public",
+        "temp": "echo $version"
     },
     "keywords": [
         "pcf"
@@ -30,9 +36,13 @@
         "pcf-helper-session": "dist/bin/session.js"
     },
     "devDependencies": {
+        "@semantic-release/git": "^10.0.1",
+        "@semantic-release/github": "^12.0.6",
+        "@semantic-release/npm": "^13.1.5",
         "@types/jest": "^29.5.14",
         "@types/node": "^22.13.11",
         "jest": "^29.7.0",
+        "semantic-release": "^25.0.3",
         "ts-jest": "^29.2.6",
         "typescript": "^5.8.2"
     },

package/dist/tasks/session-pcf.js

@@ -18,10 +18,18 @@ 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");
+/**
+ * Loads configuration for the session task, supporting a combination of config file, environment variables, and CLI arguments.
+ * The priority order is: CLI arguments > environment variables > config file > defaults.
+ * It also handles constructing full URLs for the script and stylesheet to intercept, allowing for relative paths in the config that are combined with the base URL.
+ * @param config Optional path to a JSON config file. If not provided, it will look for 'session.config.json' in the current working directory.
+ * @returns An object containing the resolved configuration values for the session task.
+ */
 function loadConfig(config) {
+    var _a, _b;
     // Load file config if exists
     let fileConfig = {};
-    const configPath = path_1.default.join(process.cwd(), config || 'dev-config.json');
+    const configPath = path_1.default.join(process.cwd(), config || 'session.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'));
@@ -35,12 +43,10 @@ function loadConfig(config) {
     }
     // Get the base URL first
     const remoteEnvironmentUrl = process.env.REMOTE_ENVIRONMENT_URL ||
-        fileConfig.remoteEnvironmentUrl ||
-        'https://app.your-remote-environment.com';
+        fileConfig.remoteEnvironmentUrl;
     // Handle script argument - support both relative paths and full URLs
     let remoteScriptToIntercept = process.env.REMOTE_SCRIPT_TO_INTERCEPT ||
-        fileConfig.remoteScriptToIntercept ||
-        'https://app.your-remote-environment.com/static/js/remote-control-bundle.js';
+        fileConfig.remoteScriptToIntercept;
     // If script is a relative path (doesn't start with http/https), combine with base URL
     if (remoteScriptToIntercept && !remoteScriptToIntercept.startsWith('http')) {
         // Normalize the base URL (remove trailing slash)
@@ -52,8 +58,7 @@ function loadConfig(config) {
         remoteScriptToIntercept = `${baseUrl}${scriptPath}`;
     }
     let remoteStylesheetToIntercept = process.env.REMOTE_STYLESHEET_TO_INTERCEPT ||
-        fileConfig.remoteStylesheetToIntercept ||
-        'https://app.your-remote-environment.com/static/css/remote-control-styles.css';
+        fileConfig.remoteStylesheetToIntercept;
     // If stylesheet is a relative path (doesn't start with http/https), combine with base URL
     if (remoteStylesheetToIntercept && !remoteStylesheetToIntercept.startsWith('http')) {
         // Normalize the base URL (remove trailing slash)
@@ -69,19 +74,41 @@ function loadConfig(config) {
         remoteEnvironmentUrl: remoteEnvironmentUrl,
         remoteScriptToIntercept: remoteScriptToIntercept,
         remoteStylesheetToIntercept: remoteStylesheetToIntercept,
-        localCssPath: process.env.LOCAL_CSS_PATH ||
-            fileConfig.localCssPath ||
-            path_1.default.join(process.cwd(), 'dist', 'local-control-styles.css'),
-        localBundlePath: process.env.LOCAL_BUNDLE_PATH ||
-            fileConfig.localBundlePath ||
-            path_1.default.join(process.cwd(), 'dist', 'local-control-bundle.js')
+        localCssPath: (_a = process.env.LOCAL_CSS_PATH) !== null && _a !== void 0 ? _a : fileConfig.localCssPath,
+        localBundlePath: (_b = process.env.LOCAL_BUNDLE_PATH) !== null && _b !== void 0 ? _b : fileConfig.localBundlePath,
     };
 }
+/**
+ * Runs an ephemeral browser session that intercepts requests to the specified remote script and stylesheet URLs, serving local files instead.
+ * It also manages session state by saving cookies and local storage to a file, allowing for persistent login sessions across runs.
+ * The session will automatically clean up and save state on exit, including handling various exit signals and browser events.
+ * @param remoteEnvironmentUrl The URL of the remote environment to navigate to.
+ * @param remoteScriptToIntercept The full URL of the remote script to intercept (e.g., https://app.your-remote-environment.com/static/js/remote-control-bundle.js).
+ * @param remoteStylesheetToIntercept The full URL of the remote stylesheet to intercept (e.g., https://app.your-remote-environment.com/static/css/remote-control-styles.css).
+ * @param localBundlePath The local file path to the JavaScript bundle that should be served when the remote script URL is requested.
+ * @param localCssPath The local file path to the CSS file that should be served when the remote stylesheet URL is requested.
+ */
 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);
     }
+    if (!remoteScriptToIntercept) {
+        color_logger_1.default.error('❌ Remote script URL to intercept is required. Please provide it via CLI, config file, or environment variable.');
+        process.exit(1);
+    }
+    if (!remoteStylesheetToIntercept) {
+        color_logger_1.default.error('❌ Remote stylesheet URL to intercept is required. Please provide it via CLI, config file, or environment variable.');
+        process.exit(1);
+    }
+    if (!localBundlePath) {
+        color_logger_1.default.error('❌ Local bundle path is required. Please provide it via CLI, config file, or environment variable.');
+        process.exit(1);
+    }
+    if (!localCssPath) {
+        color_logger_1.default.error('❌ Local CSS path 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;
@@ -180,7 +207,7 @@ function runSession(remoteEnvironmentUrl, remoteScriptToIntercept, remoteStylesh
                 return false;
             }
             // Match script URLs that end with the same path structure
-            return route.href.includes(scriptPattern) && route.href.includes('bundle.js');
+            return route.href.includes(scriptPattern);
         }, (route) => __awaiter(this, void 0, void 0, function* () {
             color_logger_1.default.log(`✅ Intercepted script request: ${route.request().url()}`);
             color_logger_1.default.log(`   Serving local file: ${LOCAL_BUNDLE_PATH}`);
@@ -195,7 +222,7 @@ function runSession(remoteEnvironmentUrl, remoteScriptToIntercept, remoteStylesh
                 return false;
             }
             // Match CSS URLs that end with the same path structure  
-            return route.href.includes(stylesheetPattern) && route.href.includes('ItemDescriptionPCF.css');
+            return route.href.includes(stylesheetPattern);
         }, (route) => __awaiter(this, void 0, void 0, function* () {
             color_logger_1.default.log(`✅ Intercepted CSS request: ${route.request().url()}`);
             color_logger_1.default.log(`   Serving local file: ${LOCAL_CSS_PATH}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tywalk/pcf-helper",
-  "version": "1.5.5",
+  "version": "1.5.8",
   "description": "Command line helper for building and publishing PCF controls to Dataverse.",
   "main": "dist/index.js",
   "types": "./types/",
@@ -11,11 +11,17 @@
   "repository": {
     "url": "git+https://github.com/tywalk/pcf-helper.git"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "scripts": {
     "test": "jest",
     "build": "tsc",
     "upgrade": "npm version patch --no-git-tag-version",
-    "ready": "npm run upgrade && npm run build && npm publish --access public"
+    "ready": "npm run upgrade && npm run build",
+    "update": "npm run ready && npm publish --access public",
+    "temp": "echo $version"
   },
   "keywords": [
     "pcf"
@@ -30,9 +36,13 @@
     "pcf-helper-session": "dist/bin/session.js"
   },
   "devDependencies": {
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.5",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.13.11",
     "jest": "^29.7.0",
+    "semantic-release": "^25.0.3",
     "ts-jest": "^29.2.6",
     "typescript": "^5.8.2"
   },

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

@@ -1,3 +1,10 @@
+/**
+ * Loads configuration for the session task, supporting a combination of config file, environment variables, and CLI arguments.
+ * The priority order is: CLI arguments > environment variables > config file > defaults.
+ * It also handles constructing full URLs for the script and stylesheet to intercept, allowing for relative paths in the config that are combined with the base URL.
+ * @param config Optional path to a JSON config file. If not provided, it will look for 'session.config.json' in the current working directory.
+ * @returns An object containing the resolved configuration values for the session task.
+ */
 declare function loadConfig(config?: string): {
     remoteEnvironmentUrl?: undefined;
     remoteScriptToIntercept?: undefined;
@@ -11,5 +18,15 @@ declare function loadConfig(config?: string): {
     localCssPath: any;
     localBundlePath: any;
 };
+/**
+ * Runs an ephemeral browser session that intercepts requests to the specified remote script and stylesheet URLs, serving local files instead.
+ * It also manages session state by saving cookies and local storage to a file, allowing for persistent login sessions across runs.
+ * The session will automatically clean up and save state on exit, including handling various exit signals and browser events.
+ * @param remoteEnvironmentUrl The URL of the remote environment to navigate to.
+ * @param remoteScriptToIntercept The full URL of the remote script to intercept (e.g., https://app.your-remote-environment.com/static/js/remote-control-bundle.js).
+ * @param remoteStylesheetToIntercept The full URL of the remote stylesheet to intercept (e.g., https://app.your-remote-environment.com/static/css/remote-control-styles.css).
+ * @param localBundlePath The local file path to the JavaScript bundle that should be served when the remote script URL is requested.
+ * @param localCssPath The local file path to the CSS file that should be served when the remote stylesheet URL is requested.
+ */
 declare function runSession(remoteEnvironmentUrl: string, remoteScriptToIntercept: string, remoteStylesheetToIntercept: string, localBundlePath: string, localCssPath: string): void;
 export { runSession, loadConfig };