sandboxbox 2.0.0 → 2.0.2

package/README.md

@@ -6,16 +6,25 @@ Run your projects in isolated containers using Podman. Works on **Windows, macOS
 
 ## Installation
 
-No installation required! Use with `npx`:
+No installation required! **Podman binaries auto-download** on first use:
 
 ```bash
 npx sandboxbox build
 npx sandboxbox run ./my-project
 ```
 
-## Quick Start
+### Auto-Download Feature
+
+SandboxBox automatically downloads portable Podman binaries when you run it:
+- ✅ **Windows** - Downloads podman.exe (v4.9.3)
+- ✅ **macOS** - Downloads podman remote client
+- ✅ **Linux** - Downloads static podman binary
+
+Just like sqlite or Playwright, no manual installation needed!
 
-### 1. Install Podman (One-time)
+### Manual Installation (Optional)
+
+If you prefer to install Podman system-wide:
 
 **Windows:**
 ```powershell
@@ -36,7 +45,9 @@ sudo dnf install podman          # Fedora
 sudo apk add podman              # Alpine
 ```
 
-### 2. Build Container
+## Quick Start
+
+### 1. Build Container
 
 ```bash
 npx sandboxbox build
@@ -48,7 +59,7 @@ This builds a container with:
 - Playwright with all browser dependencies
 - Git, npm, and essential build tools
 
-### 3. Run Your Project
+### 2. Run Your Project
 
 ```bash
 # Run with default shell
@@ -64,7 +75,7 @@ npx sandboxbox run ./my-project "claude --help"
 npx sandboxbox run ./my-project "npx playwright test"
 ```
 
-### 4. Interactive Shell
+### 3. Interactive Shell
 
 ```bash
 npx sandboxbox shell ./my-project

package/bin/.gitkeep

@@ -0,0 +1 @@
+# Downloaded Podman binaries will go here

package/cli.js

@@ -66,32 +66,53 @@ function showHelp() {
   console.log(color('magenta', '🚀 Fast startup • True isolation • Cross-platform'));
 }
 
+function getPodmanPath() {
+  // Check for bundled podman first
+  const platform = process.platform;
+  let bundledPodman;
+
+  if (platform === 'win32') {
+    bundledPodman = resolve(__dirname, 'bin', 'podman.exe');
+  } else if (platform === 'darwin') {
+    bundledPodman = resolve(__dirname, 'bin', 'podman');
+  } else {
+    bundledPodman = resolve(__dirname, 'bin', 'podman-remote-static-linux_amd64');
+  }
+
+  if (existsSync(bundledPodman)) {
+    return bundledPodman;
+  }
+  // Fall back to system podman
+  return 'podman';
+}
+
 function checkPodman() {
+  const podmanPath = getPodmanPath();
+  const isBundled = podmanPath.includes('bin');
+
   try {
-    const version = execSync('podman --version', { encoding: 'utf-8', stdio: 'pipe' }).trim();
-    console.log(color('green', `✅ ${version}`));
-    return true;
+    const version = execSync(`"${podmanPath}" --version`, { encoding: 'utf-8', stdio: 'pipe' }).trim();
+    console.log(color('green', `✅ ${version}${isBundled ? ' (bundled)' : ''}`));
+    return podmanPath;
   } catch (error) {
     console.log(color('red', '❌ Podman not found'));
-    console.log(color('yellow', '\n📦 Please install Podman:'));
+    console.log(color('yellow', '\n📦 Podman will be auto-downloaded on first install'));
+    console.log(color('yellow', '   Or you can install manually:'));
     console.log('');
     if (process.platform === 'win32') {
       console.log(color('cyan', '   Windows:'));
-      console.log('   1. Download from https://podman.io/getting-started/installation');
-      console.log('   2. Or use: winget install RedHat.Podman');
+      console.log('   winget install RedHat.Podman');
     } else if (process.platform === 'darwin') {
       console.log(color('cyan', '   macOS:'));
       console.log('   brew install podman');
-      console.log('   podman machine init');
-      console.log('   podman machine start');
+      console.log('   podman machine init && podman machine start');
     } else {
       console.log(color('cyan', '   Linux:'));
       console.log('   sudo apt-get install podman       # Ubuntu/Debian');
       console.log('   sudo dnf install podman           # Fedora');
-      console.log('   sudo apk add podman               # Alpine');
     }
     console.log('');
-    return false;
+    return null;
   }
 }
 
@@ -120,11 +141,12 @@ async function main() {
       console.log(color('blue', '🏗️  Building container...'));
       console.log(color('yellow', `Dockerfile: ${dockerfilePath}\n`));
 
-      if (!checkPodman()) process.exit(1);
+      const buildPodman = checkPodman();
+      if (!buildPodman) process.exit(1);
 
       try {
         console.log('');
-        execSync(`podman build -f "${dockerfilePath}" -t sandboxbox:latest .`, {
+        execSync(`"${buildPodman}" build -f "${dockerfilePath}" -t sandboxbox:latest .`, {
           stdio: 'inherit',
           cwd: __dirname
         });
@@ -157,11 +179,12 @@ async function main() {
       console.log(color('yellow', `Project: ${projectDir}`));
       console.log(color('yellow', `Command: ${cmd}\n`));
 
-      if (!checkPodman()) process.exit(1);
+      const runPodman = checkPodman();
+      if (!runPodman) process.exit(1);
 
       try {
         console.log('');
-        execSync(`podman run --rm -it -v "${projectDir}:/workspace" -w /workspace sandboxbox:latest ${cmd}`, {
+        execSync(`"${runPodman}" run --rm -it -v "${projectDir}:/workspace" -w /workspace sandboxbox:latest ${cmd}`, {
           stdio: 'inherit'
         });
         console.log('');
@@ -189,11 +212,12 @@ async function main() {
       console.log(color('blue', '🐚 Starting interactive shell...'));
       console.log(color('yellow', `Project: ${shellProjectDir}\n`));
 
-      if (!checkPodman()) process.exit(1);
+      const shellPodman = checkPodman();
+      if (!shellPodman) process.exit(1);
 
       try {
         console.log('');
-        execSync(`podman run --rm -it -v "${shellProjectDir}:/workspace" -w /workspace sandboxbox:latest /bin/bash`, {
+        execSync(`"${shellPodman}" run --rm -it -v "${shellProjectDir}:/workspace" -w /workspace sandboxbox:latest /bin/bash`, {
           stdio: 'inherit'
         });
       } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandboxbox",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Portable container runner with Podman - Claude Code & Playwright support. Works on Windows, macOS, and Linux.",
   "type": "module",
   "main": "cli.js",
@@ -8,7 +8,8 @@
     "sandboxbox": "./cli.js"
   },
   "scripts": {
-    "start": "node cli.js"
+    "start": "node cli.js",
+    "postinstall": "node scripts/download-podman.js"
   },
   "keywords": [
     "containers",

package/scripts/download-podman.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+
+/**
+ * Auto-download Podman portable binaries
+ * Similar to how sqlite/playwright auto-downloads platform-specific binaries
+ */
+
+import { createWriteStream, existsSync, mkdirSync, chmodSync, unlinkSync } from 'fs';
+import { get as httpsGet } from 'https';
+import { get as httpGet } from 'http';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const binDir = join(__dirname, '..', 'bin');
+
+// Podman remote client versions
+const PODMAN_VERSION = '4.9.3';
+
+const DOWNLOADS = {
+  win32: {
+    url: `https://github.com/containers/podman/releases/download/v${PODMAN_VERSION}/podman-remote-release-windows_amd64.zip`,
+    binary: 'podman.exe',
+    extract: 'unzip'
+  },
+  darwin: {
+    url: `https://github.com/containers/podman/releases/download/v${PODMAN_VERSION}/podman-remote-release-darwin_amd64.tar.gz`,
+    binary: 'podman',
+    extract: 'tar'
+  },
+  linux: {
+    url: `https://github.com/containers/podman/releases/download/v${PODMAN_VERSION}/podman-remote-static-linux_amd64.tar.gz`,
+    binary: 'podman-remote-static-linux_amd64',
+    extract: 'tar'
+  }
+};
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const get = url.startsWith('https') ? httpsGet : httpGet;
+
+    get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        return download(response.headers.location, dest).then(resolve).catch(reject);
+      }
+
+      if (response.statusCode !== 200) {
+        reject(new Error(`Download failed: ${response.statusCode}`));
+        return;
+      }
+
+      const file = createWriteStream(dest);
+      response.pipe(file);
+
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+
+      file.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+async function main() {
+  const platform = process.platform;
+
+  console.log(`\n📦 Setting up Podman portable binaries for ${platform}...`);
+
+  if (!DOWNLOADS[platform]) {
+    console.log(`⚠️  Platform ${platform} not supported for auto-download`);
+    console.log(`   Skipping auto-download (will use system Podman if available)`);
+    return;
+  }
+
+  // Create bin directory
+  if (!existsSync(binDir)) {
+    mkdirSync(binDir, { recursive: true });
+  }
+
+  const { url, binary, extract } = DOWNLOADS[platform];
+  const binaryPath = join(binDir, binary);
+
+  // Check if already downloaded
+  if (existsSync(binaryPath)) {
+    console.log(`✅ Podman already installed at ${binaryPath}`);
+    return;
+  }
+
+  console.log(`📥 Downloading Podman remote v${PODMAN_VERSION}...`);
+
+  const archiveName = url.split('/').pop();
+  const archivePath = join(binDir, archiveName);
+
+  try {
+    // Download archive
+    console.log(`   Downloading from GitHub releases...`);
+    await download(url, archivePath);
+    console.log(`✅ Downloaded successfully`);
+
+    // Extract based on platform
+    console.log(`📦 Extracting...`);
+    if (extract === 'tar') {
+      execSync(`tar -xzf "${archivePath}" -C "${binDir}" --strip-components=1`, {
+        stdio: 'pipe'
+      });
+    } else if (extract === 'unzip') {
+      execSync(`unzip -q "${archivePath}" -d "${binDir}"`, {
+        stdio: 'pipe'
+      });
+    }
+
+    // Make executable on Unix
+    if (platform !== 'win32' && existsSync(binaryPath)) {
+      chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`✅ Podman remote installed successfully!`);
+    console.log(`   Binary: ${binaryPath}\n`);
+
+    // Clean up archive
+    if (existsSync(archivePath)) {
+      unlinkSync(archivePath);
+    }
+
+  } catch (error) {
+    console.error(`⚠️  Auto-download failed: ${error.message}`);
+    console.log(`\n💡 No problem! You can install Podman manually:`);
+    if (platform === 'win32') {
+      console.log(`   winget install RedHat.Podman`);
+    } else if (platform === 'darwin') {
+      console.log(`   brew install podman && podman machine init && podman machine start`);
+    } else {
+      console.log(`   sudo apt-get install podman  # Ubuntu/Debian`);
+    }
+    console.log(`\n   Or it will use system Podman if installed.\n`);
+    // Don't fail the npm install
+  }
+}
+
+main().catch(() => {
+  // Silently fail - will use system Podman
+});