seabox 0.1.0-beta.2 → 0.1.0-beta.3

package/README.md

@@ -69,6 +69,7 @@ Add a `sea` configuration to your `package.json`:
 - **encryptAssets**: Enable encryption for assets (default: false)
 - **encryptExclude**: Patterns to exclude from encryption (e.g., `['*.txt']`)
 - **rebuild**: Automatically rebuild native modules for the target platform before building the SEA (default: false)
+- **rcedit**: (Windows only) Customize executable icon and version information. See [rcedit options](#windows-executable-customization-rcedit)
 - **cacheLocation**: Custom cache directory for extracted binaries (default: `'./.sea-cache'`). Supports environment variable expansion (e.g., `'%LOCALAPPDATA%\\myapp-cache'` on Windows or `'$HOME/.cache/myapp'` on Unix)
 
 ## Usage
@@ -188,6 +189,52 @@ The rebuilder will:
 
 **Note**: Cross-compilation may require additional platform-specific build tools installed.
 
+## Windows Executable Customization (rcedit)
+
+For Windows executables, you can customize the icon and version information using the `rcedit` configuration option:
+
+```json
+{
+  "sea": {
+    "output": "myapp.exe",
+    "targets": ["node24.11.0-win32-x64"],
+    "rcedit": {
+      "icon": ".\\assets\\myapp.ico",
+      "file-version": "1.2.3.4",
+      "product-version": "1.2.3.4",
+      "version-string": {
+        "CompanyName": "My Company",
+        "FileDescription": "My Application",
+        "ProductName": "MyApp",
+        "InternalName": "myapp.exe",
+        "OriginalFilename": "myapp.exe",
+        "LegalCopyright": "Copyright (C) 2025 My Company"
+      }
+    }
+  }
+}
+```
+
+### rcedit Options
+
+- **icon**: Path to `.ico` file for the executable icon
+- **file-version**: File version in `X.X.X.X` format
+- **product-version**: Product version in `X.X.X.X` format
+- **version-string**: Object containing version string properties:
+  - `CompanyName`: Company name
+  - `FileDescription`: Description of the file
+  - `ProductName`: Product name
+  - `InternalName`: Internal name
+  - `OriginalFilename`: Original filename
+  - `LegalCopyright`: Copyright notice
+  - `LegalTrademarks`: Trademark information (optional)
+  - `PrivateBuild`: Private build description (optional)
+  - `SpecialBuild`: Special build description (optional)
+
+The rcedit step runs after signature removal and before the SEA blob injection. This only works for Windows (`win32`) targets.
+
+For more details, see the [rcedit documentation](https://github.com/electron/rcedit).
+
 ## Asset Encryption
 
 seabox supports optional AES-256-GCM encryption of embedded assets to protect your application code and data:

package/bin/seabox.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * CLI entry point for SEA builder

package/lib/build.js

@@ -249,7 +249,7 @@ const SEA_ENCRYPTED_ASSETS = new Set(${encryptedKeysJson});
 
   if (verbose) console.log('\n[8/8] Injecting SEA blob into Node binary');
   const outputExe = path.join(projectRoot, config.outputPath, config.output);
-  await injectBlob(nodeBinary, blobOutputPath, outputExe, platform, verbose);
+  await injectBlob(nodeBinary, blobOutputPath, outputExe, platform, verbose, config.rcedit);
 
   if (!debug) {
     if (verbose) console.log('\nCleaning up temporary files');

package/lib/config.js

@@ -23,6 +23,7 @@ const path = require('path');
  * @property {boolean} [rebuild] - Automatically rebuild native modules for target platform (default: false)
  * @property {boolean} [verbose] - Enable diagnostic logging
  * @property {string} [cacheLocation] - Cache directory for extracted binaries (default: './.sea-cache', supports env vars like '%LOCALAPPDATA%\\path')
+ * @property {Object} [rcedit] - Windows executable resource editor options (icon, version info, etc.)
  */
 
 /**

package/lib/inject.js

@@ -17,9 +17,11 @@ const execFileAsync = promisify(execFile);
  * @param {string} blobPath - Path to the SEA blob file
  * @param {string} outputPath - Path for the output executable
  * @param {string} platform - Target platform (win32, linux, darwin)
+ * @param {boolean} verbose - Enable verbose logging
+ * @param {Object} [rceditOptions] - Optional rcedit configuration for Windows executables
  * @returns {Promise<void>}
  */
-async function injectBlob(nodeBinaryPath, blobPath, outputPath, platform, verbose) {
+async function injectBlob(nodeBinaryPath, blobPath, outputPath, platform, verbose, rceditOptions) {
   // Copy node binary to output location
   fs.copyFileSync(nodeBinaryPath, outputPath);
 
@@ -27,6 +29,11 @@ async function injectBlob(nodeBinaryPath, blobPath, outputPath, platform, verbos
   // The downloaded Node.js binary is signed, and postject will corrupt this signature
   await removeSignature(outputPath, platform);
 
+  // Apply rcedit changes (Windows only, before postject)
+  if (platform === 'win32' && rceditOptions && typeof rceditOptions === 'object') {
+    await applyRcedit(outputPath, rceditOptions, verbose);
+  }
+
   // Prepare postject command
   const sentinel = 'NODE_SEA_BLOB';
   const sentinelFuse = 'NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2';
@@ -66,6 +73,31 @@ async function injectBlob(nodeBinaryPath, blobPath, outputPath, platform, verbos
   //console.log('\nNote: Executable is now ready for signing with your certificate');
 }
 
+/**
+ * Apply rcedit to modify Windows executable resources.
+ * @param {string} exePath - Path to the executable
+ * @param {Object} options - rcedit options (icon, version-string, file-version, product-version, etc.)
+ * @param {boolean} verbose - Enable verbose logging
+ * @returns {Promise<void>}
+ */
+async function applyRcedit(exePath, options, verbose) {
+  if (verbose) {
+    console.log('\nApplying rcedit to modify executable resources...');
+    console.log('Options:', JSON.stringify(options, null, 2));
+  }
+
+  const rcedit = require('rcedit');
+  
+  try {
+    await rcedit(exePath, options);
+    if (verbose) {
+      console.log('✓ rcedit applied successfully');
+    }
+  } catch (error) {
+    throw new Error(`rcedit failed: ${error.message}`);
+  }
+}
+
 /**
  * Resolve the postject executable path.
  * @returns {string}
@@ -77,5 +109,6 @@ function resolvePostject() {
 
 module.exports = {
   injectBlob,
-  resolvePostject
+  resolvePostject,
+  applyRcedit
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seabox",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.3",
   "description": "Node.js Single Executable Application (SEA) builder tool with native and library extraction",
   "main": "lib/index.js",
   "types": "dist/index.d.ts",
@@ -37,6 +37,7 @@
     "adm-zip": "^0.5.16",
     "glob": "^10.0.0",
     "postject": "^1.0.0-alpha.6",
+    "rcedit": "^4.0.1",
     "tar": "^6.2.1"
   },
   "devDependencies": {