Update build scripts and utilities

Author: jdalton

scripts/build.mjs

@@ -3,7 +3,7 @@
  */
 
 import { spawn } from 'node:child_process'
-import { existsSync } from 'node:fs'
+import { existsSync, statSync } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { parseArgs } from 'node:util'
@@ -230,6 +230,14 @@ async function main() {
           type: 'boolean',
           default: false,
         },
+        node: {
+          type: 'boolean',
+          default: false,
+        },
+        stub: {
+          type: 'boolean',
+          default: false,
+        },
       },
       allowPositionals: false,
       strict: false,
@@ -244,15 +252,66 @@ async function main() {
       console.log('  --types   Build TypeScript declarations only')
       console.log('  --watch   Watch mode for development')
       console.log('  --needed  Only build if dist files are missing')
+      console.log('  --node    Build custom Node.js binary (socket-node)')
+      console.log('  --stub    Build stub/SEA binary (includes Node build if needed)')
       console.log('\nExamples:')
       console.log('  pnpm build         # Full build (source + types)')
       console.log('  pnpm build --src   # Build source only')
       console.log('  pnpm build --types # Build types only')
       console.log('  pnpm build --watch # Watch mode')
+      console.log('  pnpm build --node  # Build custom Node.js binary')
+      console.log('  pnpm build --stub  # Build standalone executable')
       process.exitCode = 0
       return
     }
 
+    // Handle custom Node.js build.
+    if (values.node) {
+      printHeader('Custom Node.js Builder')
+      log.step('Building custom Node.js binary')
+
+      const buildNodeScript = path.join(__dirname, 'build', 'build-tiny-node.mjs')
+      const nodeArgs = ['exec', 'node', buildNodeScript]
+
+      const nodeExitCode = await runCommand('pnpm', nodeArgs)
+
+      if (nodeExitCode !== 0) {
+        log.error('Node build failed')
+        process.exitCode = nodeExitCode
+      } else {
+        // Report file size
+        const nodeBinary = WIN32 ? 'node.exe' : 'node'
+        const nodePath = path.join(rootPath, 'build', 'tiny-node', `node-v24.9.0-custom`, 'out', 'Release', nodeBinary)
+        if (existsSync(nodePath)) {
+          const stats = statSync(nodePath)
+          const sizeMB = (stats.size / 1024 / 1024).toFixed(1)
+          printFooter(`Node.js built successfully! Size: ${sizeMB}MB`)
+        } else {
+          printFooter('Node.js built successfully!')
+        }
+      }
+      return
+    }
+
+    // Handle stub/SEA build.
+    if (values.stub) {
+      printHeader('Stub/SEA Builder')
+      log.step('Building standalone executable')
+
+      const buildStubScript = path.join(__dirname, 'build', 'build-stub.mjs')
+      const stubArgs = ['exec', 'node', buildStubScript]
+
+      const stubExitCode = await runCommand('pnpm', stubArgs)
+
+      if (stubExitCode !== 0) {
+        log.error('Stub build failed')
+        process.exitCode = stubExitCode
+      } else {
+        printFooter('Stub/SEA binary built successfully!')
+      }
+      return
+    }
+
     // Detect build configuration.
     const config = detectBuildConfig()
 

scripts/build/build-stub.mjs

@@ -54,7 +54,7 @@ export async function buildStub(options = {}) {
     console.log('📦 Building distribution files first...')
 
     const buildExitCode = await new Promise((resolve) => {
-      const child = spawn('pnpm', ['run', 'build:dist:src'], {
+      const child = spawn('pnpm', ['run', 'build', '--src'], {
         cwd: ROOT_DIR,
         stdio: quiet ? 'pipe' : 'inherit'
       })

scripts/build/build-tiny-node.mjs

@@ -41,7 +41,7 @@ const logger = {
 
 // Configuration
 const ROOT_DIR = join(__dirname, '../..')
-const BUILD_DIR = join(ROOT_DIR, 'build', 'tiny-node')
+const BUILD_DIR = join(ROOT_DIR, 'build', 'socket-node')
 const CUSTOM_PATCHES_DIR = join(__dirname, 'stub', 'patches', 'socket')
 
 // Parse command line arguments
@@ -87,7 +87,7 @@ Options:
                       Examples: --version=v24.9.0, --version=v22.19.0
   --skip-download     Skip downloading if source already exists
   --skip-yao-patch    Skip applying yao-pkg patches
-  --custom-patches    Apply custom patches from build/tiny-node/patches/
+  --custom-patches    Apply custom patches from build/socket-node/patches/
   --skip-code-mods    Skip V8 flags and node-gyp modifications
   --help, -h          Show this help
 

scripts/build/ensure-node-in-cache.mjs

@@ -18,7 +18,7 @@ const PKG_CACHE_DIR = join(homedir(), '.pkg-cache', 'v3.5')
 /**
  * Ensure custom Node binary is in pkg cache
  *
- * This function looks for the custom Node.js binary built by build-tiny-node.mjs
+ * This function looks for the custom Node.js binary built by build-socket-node.mjs
  * and copies it to pkg's cache directory if not already there.
  *
  * @param {string} nodeVersion - Node version (e.g., 'v24.9.0')
@@ -46,9 +46,10 @@ export default async function ensureCustomNodeInCache(nodeVersion = 'v24.9.0', p
   const nodeBinary = platform === 'win32' ? 'node.exe' : 'node'
 
   const possiblePaths = [
-    join(rootDir, 'build', 'tiny-node', `node-${nodeVersion}-custom`, 'out', 'Release', nodeBinary),
-    join(rootDir, 'build', 'tiny-node', 'node-yao-pkg', 'out', 'Release', nodeBinary),
-    join(rootDir, 'build', 'tiny-node', 'node', 'out', 'Release', nodeBinary)
+    join(rootDir, 'binaries', 'socket-node', `node-${nodeVersion}-${platform}-${arch}${platform === 'win32' ? '.exe' : ''}`),
+    join(rootDir, 'build', 'socket-node', `node-${nodeVersion}-custom`, 'out', 'Release', nodeBinary),
+    join(rootDir, 'build', 'socket-node', 'node-yao-pkg', 'out', 'Release', nodeBinary),
+    join(rootDir, 'build', 'socket-node', 'node', 'out', 'Release', nodeBinary)
   ]
 
   let sourcePath = null

scripts/build/stub/patches/yao/.sync-cache.json

@@ -0,0 +1,9 @@
+{
+  "lastSync": "2025-10-09T12:32:10.950Z",
+  "versions": [
+    "v24.9.0",
+    "v22.19.0",
+    "v20.19.5"
+  ],
+  "source": "https://github.com/yao-pkg/pkg-fetch/tree/main/patches"
+}