@ni-kismet/sl-webapp-nipkg 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 National Instruments Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,518 @@
+# SL WebApp NIPKG
+
+[![npm version](https://badge.fury.io/js/sl-webapp-nipkg.svg)](https://badge.fury.io/js/sl-webapp-nipkg)
+[![Tests](https://github.com/ni/sl-webapp-nipkg/actions/workflows/ci.yml/badge.svg)](https://github.com/ni/sl-webapp-nipkg/actions)
+![GitHub commit activity](https://img.shields.io/github/commit-activity/m/ni/sl-webapp-nipkg?style=flat-square)
+[![license](https://img.shields.io/github/license/ni/sl-webapp-nipkg.svg)](LICENSE)
+
+A flexible tool for packaging web applications into SystemLink WebApp `.nipkg` format for National Instruments Package Manager. Works with any web application framework including Node.js (React, Angular, Vue), Python (Pyodide), .NET (Blazor), and static HTML sites.
+
+## Features
+
+- 🚀 **Easy Integration**: Works seamlessly with any web application
+- 📦 **Automated Packaging**: Builds and packages your app in one command  
+- ⚙️ **Flexible Configuration**: Optional config files - use CLI flags or JSON config
+- 🎯 **TypeScript Support**: Written in TypeScript with full type definitions
+- 🌈 **Beautiful CLI**: Colorful, informative command-line interface
+- 🔧 **CI/CD Ready**: Easy integration with build pipelines
+- 🌍 **Cross-Platform**: Works on Windows, macOS, and Linux without external dependencies
+- 🔌 **Framework Agnostic**: Works with React, Angular, Vue, Blazor, Pyodide, static HTML, and more
+- 🎨 **Zero Config**: No config files required - just point to your build directory
+
+## Prerequisites
+
+- Node.js 16 or higher (only to run the packaging tool)
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @ni-kismet/sl-webapp-nipkg
+```
+
+### Project-specific Installation
+
+```bash
+# As a dev dependency in your project
+npm install --save-dev @ni-kismet/sl-webapp-nipkg
+```
+
+## Quick Start
+
+### Option 1: Minimal Usage (No Config Files)
+
+```bash
+# Package any web application - just point to the build directory
+sl-webapp-nipkg build --build-dir ./dist --name my-app
+
+# With full metadata
+sl-webapp-nipkg build \
+  --build-dir ./dist \
+  --name "My WebApp" \
+  --version "1.0.0" \
+  --maintainer "Your Name <name@example.com>"
+```
+
+### Option 2: With Configuration File (Recommended for Node.js projects)
+
+1. **Navigate to your project**:
+
+   ```bash
+   cd my-webapp-project
+   ```
+
+2. **Initialize configuration** (optional):
+
+   ```bash
+   sl-webapp-nipkg init
+   ```
+
+3. **Edit the generated `nipkg.config.json`** (all fields optional):
+
+   ```json
+   {
+     "maintainer": "John Doe <john.doe@company.com>",
+     "displayName": "My WebApp",
+     "buildDir": "dist",
+     "buildCommand": "npm run build",
+     "userVisible": true
+   }
+   ```
+
+   **Note:** The `name`, `version`, and `description` are auto-detected from your `package.json` if present.
+
+4. **Build and package**:
+
+   ```bash
+   sl-webapp-nipkg build --build
+   ```
+
+## CLI Commands
+
+### `sl-webapp-nipkg build`
+
+Build and package your web application.
+
+#### Options
+
+**Core Options:**
+
+- `--build-dir <path>` - Build output directory to package (required if not in config)
+- `--name <name>` - Package name (auto-detected from package.json or directory name)
+- `--version <version>` - Package version (auto-detected from package.json or defaults to 1.0.0)
+- `--description <description>` - Package description (optional)
+- `--maintainer <maintainer>` - Maintainer info (defaults to 'Unknown')
+- `--output-dir <path>` - Output directory for nipkg files (default: dist/nipkg)
+
+**Build Options:**
+
+- `-b, --build [command]` - Run build command before packaging (optionally specify custom command to override config)
+- `-v, --verbose` - Enable verbose output
+- `--skip-cleanup` - Skip cleanup of existing packages
+- `--build-suffix <suffix>` - Add a suffix to the package name (e.g., build ID for CI/CD)
+- `--config <path>` - Custom config file path (default: 'nipkg.config.json')
+
+**Note:** CLI options override config file values, which override package.json values.
+
+#### Examples
+
+**Node.js Projects:**
+
+```bash
+# Build and package (runs buildCommand from config)
+sl-webapp-nipkg build --build
+
+# Build with custom command (overrides config)
+sl-webapp-nipkg build --build "npm run build:production"
+
+# Use existing build output (no build step)
+sl-webapp-nipkg build
+
+# Build with build ID suffix for CI/CD
+sl-webapp-nipkg build --build --build-suffix "${BUILD_ID}"
+
+# Verbose output with custom config  
+sl-webapp-nipkg build --build --verbose --config my-nipkg.config.json
+```
+
+**Non-Node.js Projects (Python, Blazor, Static Sites):**
+
+```bash
+# Python Pyodide webapp
+sl-webapp-nipkg build --build-dir ./public --name my-pyodide-app
+
+# .NET Blazor webapp
+sl-webapp-nipkg build \
+  --build-dir ./bin/Release/net8.0/publish \
+  --name "My Blazor App" \
+  --version "2.0.0"
+
+# Static HTML site
+sl-webapp-nipkg build --build-dir ./dist --name my-static-site --version 1.0.0
+
+# With full metadata
+sl-webapp-nipkg build \
+  --build-dir ./output \
+  --name "My WebApp" \
+  --version "1.5.0" \
+  --description "My awesome webapp" \
+  --maintainer "Team <team@company.com>"
+```
+
+### `sl-webapp-nipkg init`
+
+Initialize a `nipkg.config.json` file in the current directory.
+
+## Configuration
+
+### Configuration File (`nipkg.config.json`)
+
+**All fields are optional.** CLI options override config file values. Config file values override package.json auto-detection.
+
+| Property | Type | Required | Description |
+| -------- | ---- | -------- | ----------- |
+| `name` | string | ❌ | Package name (auto-detected from package.json or directory name) |
+| `version` | string | ❌ | Package version (auto-detected from package.json, defaults to 1.0.0) |
+| `description` | string | ❌ | Package description (auto-detected from package.json, defaults to empty) |
+| `maintainer` | string | ❌ | Maintainer information (defaults to 'Unknown') |
+| `architecture` | string | ❌ | Target architecture (default: 'all') |
+| `displayName` | string | ❌ | Display name for the package |
+| `buildDir` | string | ❌* | Build output directory (e.g., 'dist', 'build') - *Required if not provided via CLI |
+| `buildCommand` | string | ❌ | Custom build command (default: 'npm run build') |
+| `outputDir` | string | ❌ | Custom nipkg output directory (default: 'dist/nipkg') |
+| `buildSuffix` | string | ❌ | Optional suffix for package filename (e.g., build ID for CI/CD) |
+| `depends` | string[] | ❌ | Package dependencies |
+| `userVisible` | boolean | ❌ | Whether package is user visible |
+
+### Example Configuration
+
+```json
+{
+  "name": "my-webapp",
+  "version": "1.2.3",
+  "description": "A SystemLink WebApp for National Instruments", 
+  "maintainer": "John Doe <john.doe@company.com>",
+  "architecture": "all",
+  "displayName": "My WebApp",
+  "buildDir": "dist",
+  "buildCommand": "npm run build",
+  "userVisible": true,
+  "depends": [
+    "ni-systemlink-server >= 2023.1"
+  ],
+  "outputDir": "packages"
+}
+```
+
+## Framework Examples
+
+### Non-Node.js Projects
+
+**Python Pyodide:**
+
+```bash
+# No config file needed
+sl-webapp-nipkg build \
+  --build-dir ./public \
+  --name my-pyodide-app \
+  --version 1.0.0 \
+  --maintainer "Python Team <team@example.com>"
+```
+
+**.NET Blazor:**
+
+```bash
+# Package Blazor WebAssembly output
+sl-webapp-nipkg build \
+  --build-dir ./bin/Release/net8.0/publish/wwwroot \
+  --name my-blazor-app \
+  --version 2.0.0
+```
+
+**Static HTML:**
+
+```bash
+# Package any static web content
+sl-webapp-nipkg build --build-dir ./dist --name my-static-site
+```
+
+### Node.js Projects
+
+**React:**
+
+```json
+{
+  "maintainer": "Your Name <your.email@company.com>",
+  "buildDir": "build",
+  "buildCommand": "npm run build"
+}
+```
+
+### Vue
+
+```json
+{
+  "maintainer": "Your Name <your.email@company.com>",
+  "buildDir": "dist",
+  "buildCommand": "npm run build"
+}
+```
+
+### Angular
+
+```json
+{
+  "maintainer": "Your Name <your.email@company.com>",
+  "buildDir": "dist/my-app/browser",
+  "buildCommand": "npm run build"
+}
+```
+
+**Note:** For Angular projects, specify the build configuration in `buildCommand`: `"buildCommand": "ng build --configuration production"` or use an npm script like `"build": "ng build --configuration production"` and let the default `npm run build` work.
+
+### Next.js
+
+```json
+{
+  "maintainer": "Your Name <your.email@company.com>",
+  "buildDir": "out",
+  "buildCommand": "npm run build && npm run export"
+}
+```
+
+## Integration with Node.js Projects
+
+### Add to package.json Scripts
+
+```json
+{
+  "scripts": {
+    "start": "npm run dev",
+    "dev": "vite",
+    "build": "vite build",
+    "build:nipkg": "sl-webapp-nipkg build --build",
+    "package:nipkg": "sl-webapp-nipkg build"
+  }
+}
+```
+
+### Use in npm Scripts
+
+```bash
+# Build and package for production
+npm run build:nipkg
+
+# Package existing build
+npm run package:nipkg
+```
+
+## Programmatic Usage
+
+```typescript
+import { SystemLinkNipkgBuilder, NipkgConfig, BuildOptions } from '@ni-kismet/sl-webapp-nipkg';
+
+const config: NipkgConfig = {
+  name: 'my-app',
+  version: '1.0.0',
+  description: 'My SystemLink WebApp',
+  maintainer: 'John Doe <john@example.com>',
+  buildDir: 'dist',
+  userVisible: true
+};
+
+const options: BuildOptions = {
+  build: true,
+  verbose: true
+};
+
+const builder = new SystemLinkNipkgBuilder(config, options);
+await builder.build();
+```
+
+## CI/CD Integration
+
+The `--build-suffix` option allows you to create unique package names for PR/branch builds while keeping clean names for production releases.
+
+**Output examples:**
+
+- PR builds: `my-app_1.0.0_12345_all.nipkg` (includes build ID)
+- Main/production: `my-app_1.0.0_all.nipkg` (standard naming)
+
+### GitHub Actions
+
+```yaml
+name: Build and Package
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: windows-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Build and Package (PR)
+      if: github.event_name == 'pull_request'
+      run: sl-webapp-nipkg build --build --build-suffix "${{ github.run_number }}"
+    
+    - name: Build and Package (Main)
+      if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+      run: sl-webapp-nipkg build --build
+    
+    - name: Upload Package
+      uses: actions/upload-artifact@v3
+      with:
+        name: nipkg-package
+        path: dist/nipkg/*.nipkg
+```
+
+### Azure DevOps
+
+```yaml
+trigger:
+- main
+
+pool:
+  vmImage: 'windows-latest'
+
+steps:
+- task: NodeTool@0
+  inputs:
+    versionSpec: '18.x'
+
+- script: npm ci
+  displayName: 'Install dependencies'
+
+- script: |
+    if [ "$(Build.SourceBranch)" = "refs/heads/main" ]; then
+      npm run build
+      sl-webapp-nipkg build
+    else
+      npm run build
+      sl-webapp-nipkg build --build-suffix "$(Build.BuildId)"
+    fi
+  displayName: 'Build and package'
+
+- task: PublishBuildArtifacts@1
+  inputs:
+    PathtoPublish: 'dist/nipkg'
+    ArtifactName: 'nipkg-package'
+```
+
+## Package Structure
+
+After packaging, your project will have this structure:
+
+```text
+your-webapp-project/
+├── dist/                            # Your build output
+│   ├── index.html
+│   ├── assets/
+│   └── ...
+├── dist/nipkg/                      # NIPKG packaging
+│   ├── your-app_1.0.0_all.nipkg    # Final package
+│   └── temp-source/                # Temporary (auto-cleaned)
+├── nipkg.config.json                # Package configuration  
+└── package.json                     # NPM scripts
+```
+
+## Requirements
+
+- Node.js 16+
+- National Instruments Package Manager (nipkg)
+
+## Development
+
+### Building from Source
+
+```bash
+git clone https://github.com/ni/sl-webapp-nipkg.git
+cd sl-webapp-nipkg
+npm install
+npm run build
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+### Local Development
+
+```bash
+# Link globally for testing
+npm link
+
+# Use in any Node.js project
+cd /path/to/your/project
+sl-webapp-nipkg --help
+```
+
+## Troubleshooting
+
+### Common Issues
+
+#### "Build directory not found"
+
+- Provide build directory via CLI: `--build-dir ./dist`
+- Or run with `--build` flag to build before packaging
+- Check that your build command runs successfully
+- Verify `buildDir` in nipkg.config.json points to the correct directory
+
+#### "buildDir is required"
+
+- Provide via CLI: `sl-webapp-nipkg build --build-dir ./dist`
+- Or add to nipkg.config.json: `"buildDir": "dist"`
+
+#### Package dependencies missing
+
+- Add required NI runtime dependencies to `depends` array in config
+- Example: `"depends": ["ni-systemlink-server >= 2023.1"]`
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Make your changes
+4. Add tests for your changes
+5. Ensure tests pass: `npm test`
+6. Commit your changes: `git commit -m 'Add amazing feature'`
+7. Push to the branch: `git push origin feature/amazing-feature`
+8. Submit a pull request
+
+## License
+
+MIT © National Instruments
+
+## Support
+
+- 📚 [Documentation](https://github.com/ni/sl-webapp-nipkg/wiki)
+- 🐛 [Report Issues](https://github.com/ni/sl-webapp-nipkg/issues)
+- 💬 [Discussions](https://github.com/ni/sl-webapp-nipkg/discussions)
+
+---
+
+*Made with ❤️ for the National Instruments community*

package/dist/builder.d.ts

@@ -0,0 +1,40 @@
+import { NipkgConfig, BuildOptions } from './types.js';
+export declare class SystemLinkNipkgBuilder {
+    private readonly config;
+    private readonly options;
+    private readonly projectRoot;
+    constructor(config: NipkgConfig, options?: BuildOptions);
+    /**
+     * Build the complete nipkg package
+     */
+    build(): Promise<void>;
+    /**
+     * Get the package name from CLI options, config, or package.json
+     */
+    private getName;
+    /**
+     * Get the package description from CLI options, config, or package.json
+     */
+    private getDescription;
+    /**
+     * Get the package version from CLI options, config, or package.json
+     */
+    private getVersion;
+    /**
+     * Get the maintainer from CLI options, config, or use default
+     */
+    private getMaintainer;
+    /**
+     * Run project build command
+     */
+    private runProjectBuild;
+    /**
+     * Prepare source directory with ApplicationFiles_64 structure
+     */
+    private prepareSourceDirectory;
+    /**
+     * Package the application into .nipkg format
+     */
+    private packageApplication;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMvD,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB;IAM3D;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBnC;;OAEG;IACH,OAAO,CAAC,OAAO;IA4Bf;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACH,OAAO,CAAC,UAAU;IA2BlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB;;OAEG;YACW,sBAAsB;IAwCpC;;OAEG;YACW,kBAAkB;CAkEnC"}

package/dist/builder.js

@@ -0,0 +1,264 @@
+/* eslint-disable no-console */
+import fs from 'fs-extra';
+import path from 'path';
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const { Deboa } = require('deboa');
+export class SystemLinkNipkgBuilder {
+    config;
+    options;
+    projectRoot;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.options = options;
+        this.projectRoot = process.cwd();
+    }
+    /**
+     * Build the complete nipkg package
+     */
+    async build() {
+        try {
+            console.log(chalk.cyan('🚀 Starting nipkg build process...'));
+            // Run custom build command if requested
+            this.runProjectBuild();
+            // Set up output directory
+            const outputDir = this.options.outputDir || this.config.outputDir || path.join(this.projectRoot, 'dist');
+            await fs.ensureDir(outputDir);
+            const nipkgDir = path.join(outputDir, 'nipkg');
+            await fs.ensureDir(nipkgDir);
+            // Package the application
+            await this.packageApplication(nipkgDir);
+            console.log(chalk.green.bold('🎯 Nipkg build completed successfully!'));
+        }
+        catch (error) {
+            console.error(chalk.red.bold('❌ Build failed:'), error.message);
+            process.exit(1);
+        }
+    }
+    /**
+     * Get the package name from CLI options, config, or package.json
+     */
+    getName() {
+        // Priority: CLI option > config > package.json > directory name
+        if (this.options.name) {
+            return this.options.name;
+        }
+        // If name is explicitly set in config, use it
+        if (this.config.name) {
+            return this.config.name;
+        }
+        // Otherwise, try to read from package.json
+        try {
+            const packageJson = fs.readJsonSync(path.join(this.projectRoot, 'package.json'));
+            if (packageJson.name !== undefined && packageJson.name !== '') {
+                console.log(chalk.cyan(`📦 Using name "${packageJson.name}" from package.json`));
+                return packageJson.name;
+            }
+        }
+        catch (_error) {
+            // Fall through
+        }
+        // Default to current directory name
+        const dirName = path.basename(this.projectRoot);
+        console.log(chalk.yellow(`⚠️  No package name found, using directory name: "${dirName}"`));
+        return dirName;
+    }
+    /**
+     * Get the package description from CLI options, config, or package.json
+     */
+    getDescription() {
+        // Priority: CLI option > config > package.json > empty string
+        if (this.options.description) {
+            return this.options.description;
+        }
+        // If description is explicitly set in config, use it
+        if (this.config.description) {
+            return this.config.description;
+        }
+        // Otherwise, try to read from package.json
+        try {
+            const packageJson = fs.readJsonSync(path.join(this.projectRoot, 'package.json'));
+            if (packageJson.description !== undefined && packageJson.description !== '') {
+                console.log(chalk.cyan('📦 Using description from package.json'));
+                return packageJson.description;
+            }
+        }
+        catch (_error) {
+            // Fall through
+        }
+        // Default to empty string if not found anywhere
+        return '';
+    }
+    /**
+     * Get the package version from CLI options, config, or package.json
+     */
+    getVersion() {
+        // Priority: CLI option > config > package.json > default
+        if (this.options.version) {
+            return this.options.version;
+        }
+        // If version is explicitly set in config, use it
+        if (this.config.version) {
+            return this.config.version;
+        }
+        // Otherwise, try to read from package.json
+        try {
+            const packageJson = fs.readJsonSync(path.join(this.projectRoot, 'package.json'));
+            if (packageJson.version !== undefined && packageJson.version !== '') {
+                console.log(chalk.cyan(`📦 Using version ${packageJson.version} from package.json`));
+                return packageJson.version;
+            }
+        }
+        catch (_error) {
+            // Fall through
+        }
+        // Default to 1.0.0 if not found anywhere
+        console.log(chalk.yellow('⚠️  No version found, defaulting to 1.0.0'));
+        return '1.0.0';
+    }
+    /**
+     * Get the maintainer from CLI options, config, or use default
+     */
+    getMaintainer() {
+        // Priority: CLI option > config > default
+        if (this.options.maintainer) {
+            return this.options.maintainer;
+        }
+        if (this.config.maintainer) {
+            return this.config.maintainer;
+        }
+        // Default maintainer if not specified
+        console.log(chalk.yellow('⚠️  No maintainer specified, using default'));
+        return 'Unknown <unknown@example.com>';
+    }
+    /**
+     * Run project build command
+     */
+    runProjectBuild() {
+        // Skip if build option not provided (undefined) or explicitly false
+        // build can be: undefined (not provided), true (--build), or string (--build "cmd")
+        if (this.options.build === false || this.options.build === undefined) {
+            return;
+        }
+        console.log(chalk.blue('🔨 Building application...'));
+        try {
+            // Priority: CLI option (if string) > config > default
+            let buildCmd = 'npm run build';
+            let cmdSource = 'default';
+            if (typeof this.config.buildCommand === 'string' && this.config.buildCommand !== '') {
+                buildCmd = this.config.buildCommand;
+                cmdSource = 'config';
+            }
+            if (typeof this.options.build === 'string' && this.options.build !== '') {
+                buildCmd = this.options.build;
+                cmdSource = 'CLI';
+            }
+            if (cmdSource === 'default') {
+                console.log(chalk.yellow('⚠️  No build command specified, using default: npm run build'));
+                console.log(chalk.gray('   💡 Tip: Add "buildCommand" to nipkg.config.json or use --build "your-command"'));
+            }
+            else {
+                console.log(chalk.cyan(`🔧 Using build command from ${cmdSource}: ${buildCmd}`));
+            }
+            execSync(buildCmd, { stdio: this.options.verbose ? 'inherit' : 'pipe' });
+            console.log(chalk.green('✅ Build completed successfully'));
+        }
+        catch (error) {
+            throw new Error(`Build failed: ${error.message}`);
+        }
+    }
+    /**
+     * Prepare source directory with ApplicationFiles_64 structure
+     */
+    async prepareSourceDirectory(nipkgDir) {
+        // Priority: CLI option > config
+        const buildDir = this.options.buildDir || this.config.buildDir;
+        if (!buildDir) {
+            throw new Error('buildDir is required.\n'
+                + 'Provide it via CLI: --build-dir <path>\n'
+                + 'Or add it to nipkg.config.json:\n'
+                + '  "buildDir": "dist"\n'
+                + '  or "buildDir": "build"\n\n'
+                + 'This should point to your application\'s build output directory.');
+        }
+        if (!fs.existsSync(buildDir)) {
+            throw new Error(`Build directory not found: ${buildDir}\n`
+                + 'Run your build command first or use --build flag.');
+        }
+        // Create temporary source directory with the required structure
+        const sourceDir = path.join(nipkgDir, 'temp-source');
+        const applicationFilesDir = path.join(sourceDir, 'ApplicationFiles_64');
+        // Clean up if exists
+        if (await fs.pathExists(sourceDir)) {
+            await fs.remove(sourceDir);
+        }
+        await fs.ensureDir(applicationFilesDir);
+        console.log(chalk.blue('📋 Copying build files...'));
+        await fs.copy(buildDir, applicationFilesDir, { overwrite: true });
+        console.log(chalk.green('✅ Build files copied'));
+        return sourceDir;
+    }
+    /**
+     * Package the application into .nipkg format
+     */
+    async packageApplication(nipkgDir) {
+        // Clean up existing packages
+        if (!this.options.skipCleanup) {
+            const existingPackages = (await fs.readdir(nipkgDir))
+                .filter((file) => file.endsWith('.nipkg') || file.endsWith('.deb'));
+            await Promise.all(existingPackages.map(async (pkg) => {
+                await fs.remove(path.join(nipkgDir, pkg));
+                console.log(chalk.yellow(`🗑️  Removed existing package: ${pkg}`));
+            }));
+        }
+        console.log(chalk.blue('📦 Packaging application...'));
+        try {
+            // Prepare source directory with ApplicationFiles_64 structure
+            const sourceDir = await this.prepareSourceDirectory(nipkgDir);
+            const architecture = this.config.architecture || 'all';
+            // Build package name with optional suffix (CLI option takes precedence over config)
+            const suffix = this.options.buildSuffix || this.config.buildSuffix;
+            const packageName = suffix
+                ? `${this.getName()}_${this.getVersion()}.${suffix}_${architecture}`
+                : `${this.getName()}_${this.getVersion()}_${architecture}`;
+            const debPath = path.join(nipkgDir, `${packageName}.deb`);
+            const nipkgPath = path.join(nipkgDir, `${packageName}.nipkg`);
+            // Build control file options
+            const depends = this.config.depends ? this.config.depends.join(', ') : undefined;
+            const controlFileOptions = {
+                maintainer: this.getMaintainer(),
+                packageName: this.getName(),
+                shortDescription: this.getDescription(),
+                version: this.getVersion(),
+                architecture,
+                ...(depends && { depends }),
+                ...(this.config.displayName && { displayName: this.config.displayName }),
+                ...(this.config.userVisible && { userVisible: String(this.config.userVisible) }),
+            };
+            // Use Deboa to create the .deb file
+            if (this.options.verbose) {
+                console.log(chalk.gray('  Creating .deb package...'));
+            }
+            const deboa = new Deboa({
+                controlFileOptions,
+                sourceDir,
+                targetDir: nipkgDir,
+                targetFileName: `${packageName}`,
+            });
+            await deboa.package();
+            // Clean up temp source directory
+            await fs.remove(sourceDir);
+            // Rename .deb to .nipkg
+            await fs.rename(debPath, nipkgPath);
+            console.log(chalk.green(`🎉 Successfully created package: ${packageName}.nipkg`));
+            console.log(chalk.cyan(`📍 Package location: ${nipkgPath}`));
+        }
+        catch (error) {
+            throw new Error(`Packaging failed: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import { Command } from 'commander';
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+import { SystemLinkNipkgBuilder } from './builder.js';
+const filename = fileURLToPath(import.meta.url);
+const dirname = path.dirname(filename);
+// Read version from package.json
+const packageJson = await fs.readJson(path.join(dirname, '../package.json'));
+const program = new Command();
+program
+    .name('sl-webapp-nipkg')
+    .description('Build tool for packaging Node.js applications into SystemLink WebApp .nipkg format')
+    .version(packageJson.version);
+program
+    .command('build')
+    .description('Build and package application as SystemLink WebApp .nipkg')
+    .option('-b, --build [command]', 'Run build command before packaging (optionally specify custom command)')
+    .option('-v, --verbose', 'Verbose output', false)
+    .option('--skip-cleanup', 'Skip cleanup of existing packages', false)
+    .option('--build-suffix <suffix>', 'Add a suffix to the package name (e.g., build ID)')
+    .option('--config <path>', 'Path to nipkg config file', 'nipkg.config.json')
+    .option('--build-dir <path>', 'Build output directory to package')
+    .option('--name <name>', 'Package name')
+    .option('--version <version>', 'Package version')
+    .option('--description <description>', 'Package description')
+    .option('--maintainer <maintainer>', 'Maintainer information')
+    .option('--output-dir <path>', 'Output directory for nipkg files')
+    .action(async (options) => {
+    try {
+        const configPath = path.resolve(options.config);
+        let config = {};
+        if (fs.existsSync(configPath)) {
+            config = await fs.readJson(configPath);
+            console.log(chalk.blue(`📋 Using config from: ${configPath}`));
+        }
+        else if (options.config !== 'nipkg.config.json') {
+            // If user specified a custom config path and it doesn't exist, throw error
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        else {
+            // No config file found, will rely on CLI options and defaults
+            console.log(chalk.yellow('⚠️  No nipkg.config.json found, using CLI options and defaults'));
+        }
+        const buildOptions = {
+            build: options.build,
+            verbose: options.verbose,
+            skipCleanup: options.skipCleanup,
+            buildSuffix: options.buildSuffix,
+            buildDir: options.buildDir,
+            name: options.name,
+            version: options.version,
+            description: options.description,
+            maintainer: options.maintainer,
+            outputDir: options.outputDir
+        };
+        const builder = new SystemLinkNipkgBuilder(config, buildOptions);
+        await builder.build();
+    }
+    catch (error) {
+        console.error(chalk.red.bold('❌ Error:'), error.message);
+        process.exit(1);
+    }
+});
+program
+    .command('init')
+    .description('Initialize nipkg.config.json in current directory')
+    .action(async () => {
+    try {
+        const configPath = path.resolve('nipkg.config.json');
+        if (fs.existsSync(configPath)) {
+            console.log(chalk.yellow('⚠️  nipkg.config.json already exists'));
+            return;
+        }
+        const config = await generateConfigFromPackageJson();
+        await fs.writeJson(configPath, config, { spaces: 2 });
+        console.log(chalk.green('✅ Created nipkg.config.json'));
+        console.log(chalk.cyan('💡 Edit the file to customize your package configuration'));
+    }
+    catch (error) {
+        console.error(chalk.red.bold('❌ Error:'), error.message);
+        process.exit(1);
+    }
+});
+async function generateConfigFromPackageJson() {
+    const packageJsonPath = path.resolve('package.json');
+    let projectPackageJson = {};
+    if (fs.existsSync(packageJsonPath)) {
+        projectPackageJson = await fs.readJson(packageJsonPath);
+    }
+    const projectName = projectPackageJson.name || path.basename(process.cwd());
+    const maintainer = projectPackageJson.author;
+    return {
+        ...(maintainer && { maintainer }),
+        architecture: 'all',
+        displayName: projectName,
+        buildDir: 'dist',
+        buildCommand: 'npm run build',
+        userVisible: true
+    };
+}
+// Handle unhandled promise rejections
+process.on('unhandledRejection', (error) => {
+    console.error(chalk.red.bold('❌ Unhandled error:'), error);
+    process.exit(1);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './builder.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './builder.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,119 @@
+export interface NipkgConfig {
+    /**
+     * Package name.
+     * @remarks Auto-detected from package.json if not provided. Falls back to directory name if package.json is not found.
+     */
+    name?: string;
+    /**
+     * Package version.
+     * @remarks Auto-detected from package.json if not provided.
+     * @defaultValue `1.0.0`
+     */
+    version?: string;
+    /**
+     * Package description.
+     * @remarks Auto-detected from package.json if not provided.
+     */
+    description?: string;
+    /**
+     * Maintainer information.
+     * @remarks Optional.
+     * @defaultValue `Unknown <unknown@example.com>`
+     */
+    maintainer?: string;
+    /**
+     * Package architecture.
+     * @defaultValue `all`
+     */
+    architecture?: string;
+    /**
+     * Display name for the package.
+     * @remarks Used in the package metadata.
+     */
+    displayName?: string;
+    /**
+     * Build output directory (e.g., 'dist' or 'build').
+     * @remarks Required unless provided via CLI option `--build-dir`.
+     */
+    buildDir?: string;
+    /**
+     * Custom build command.
+     * @remarks Can be overridden via CLI option `--build "command"`.
+     * @defaultValue `npm run build`
+     */
+    buildCommand?: string;
+    /**
+     * Custom output directory for nipkg files.
+     * @defaultValue `dist/nipkg`
+     */
+    outputDir?: string;
+    /**
+     * Additional package dependencies.
+     * @remarks Array of dependency strings (e.g., ['ni-systemlink-server \>= 2023.1']).
+     */
+    depends?: string[];
+    /**
+     * Whether the package is user visible.
+     * @remarks Controls visibility in package managers.
+     */
+    userVisible?: boolean;
+    /**
+     * Optional build suffix for the output filename.
+     * @remarks Useful for CI/CD to append build IDs (e.g., '12345' becomes 'package_1.0.0_12345_all.nipkg').
+     */
+    buildSuffix?: string;
+}
+export interface BuildOptions {
+    /**
+     * Run build command before packaging.
+     * @remarks Can be a boolean (true = use default/config command) or a string (custom command to run).
+     * When provided as string, overrides buildCommand from config.
+     */
+    build?: boolean | string;
+    /**
+     * Enable verbose output.
+     * @remarks Shows detailed build and packaging information.
+     */
+    verbose?: boolean;
+    /**
+     * Skip cleanup of existing packages.
+     * @remarks Prevents deletion of previous nipkg files in output directory.
+     */
+    skipCleanup?: boolean;
+    /**
+     * Optional build suffix for the output filename.
+     * @remarks CLI override for config buildSuffix. Useful for CI/CD build identifiers.
+     */
+    buildSuffix?: string;
+    /**
+     * Build output directory path.
+     * @remarks CLI override for config buildDir.
+     */
+    buildDir?: string;
+    /**
+     * Package name.
+     * @remarks CLI override for config name and package.json auto-detection.
+     */
+    name?: string;
+    /**
+     * Package version.
+     * @remarks CLI override for config version and package.json auto-detection.
+     */
+    version?: string;
+    /**
+     * Package description.
+     * @remarks CLI override for config description and package.json auto-detection.
+     */
+    description?: string;
+    /**
+     * Maintainer information.
+     * @remarks CLI override for config maintainer.
+     */
+    maintainer?: string;
+    /**
+     * Output directory for nipkg files.
+     * @remarks CLI override for config outputDir.
+     */
+    outputDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@ni-kismet/sl-webapp-nipkg",
+  "version": "0.1.0",
+  "description": "Build tool for packaging web applications into SystemLink WebApp .nipkg format. Supports Node.js, Python, .NET Blazor, and static sites.",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js"
+    },
+    "./*": {
+      "types": "./dist/esm/*.d.ts",
+      "import": "./dist/esm/*/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/esm/*",
+        "dist/esm/*/index.d.ts"
+      ]
+    }
+  },
+  "bin": {
+    "sl-webapp-nipkg": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "change": "beachball change",
+    "check": "beachball check --changehint \"Run 'npm run change' to generate a change file\"",
+    "sync": "beachball sync",
+    "invoke-publish": "beachball publish --yes --access public --message \"applying package updates [skip ci]\""
+  },
+  "keywords": [
+    "systemlink",
+    "nipkg",
+    "national-instruments",
+    "packaging",
+    "webapp",
+    "nodejs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ni/sl-webapp-nipkg.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": {
+    "name": "National Instruments"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ni/sl-webapp-nipkg/issues"
+  },
+  "homepage": "https://github.com/ni/sl-webapp-nipkg#readme",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "deboa": "^1.2.0",
+    "fs-extra": "^11.3.3"
+  },
+  "devDependencies": {
+    "@ni/eslint-config-javascript": "^5.1.4",
+    "@ni/eslint-config-typescript": "^5.0.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.2.1",
+    "beachball": "^2.63.0",
+    "eslint": "^9.39.2",
+    "eslint-plugin-tsdoc": "^0.5.0",
+    "typescript": "^5.9.3"
+  }
+}