stacktape 2.23.0 → 2.24.0-beta.25

package/bin/stacktape.js

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+
+/**
+ * Stacktape CLI launcher
+ * Downloads and caches the platform-specific binary on first run
+ */
+
+const { spawnSync, execSync } = require('node:child_process');
+const { createWriteStream, existsSync, chmodSync, mkdirSync } = require('node:fs');
+const { get: httpsGet } = require('node:https');
+const { platform, arch, homedir } = require('node:os');
+const { join } = require('node:path');
+
+// Get version from package.json
+const PACKAGE_VERSION = require('../package.json').version;
+
+const GITHUB_REPO = 'stacktape/stacktape';
+
+// Platform detection and mapping
+const PLATFORM_MAP = {
+  'win32-x64': { fileName: 'windows.zip', extract: extractZip },
+  'linux-x64': { fileName: 'linux.tar.gz', extract: extractTarGz },
+  'linux-arm64': { fileName: 'linux-arm.tar.gz', extract: extractTarGz },
+  'darwin-x64': { fileName: 'macos.tar.gz', extract: extractTarGz },
+  'darwin-arm64': { fileName: 'macos-arm.tar.gz', extract: extractTarGz },
+  'linux-x64-musl': { fileName: 'alpine.tar.gz', extract: extractTarGz }
+};
+
+/**
+ * Detects the current platform
+ */
+function detectPlatform() {
+  const currentPlatform = platform();
+  const currentArch = arch();
+
+  // Detect Alpine Linux (uses musl instead of glibc)
+  if (currentPlatform === 'linux' && currentArch === 'x64') {
+    try {
+      const ldd = execSync('ldd --version 2>&1 || true', { encoding: 'utf8' });
+      if (ldd.includes('musl')) {
+        return 'linux-x64-musl';
+      }
+    } catch {
+      // If ldd fails, assume glibc
+    }
+  }
+
+  const platformKey = `${currentPlatform}-${currentArch}`;
+
+  if (!PLATFORM_MAP[platformKey]) {
+    console.error(`Error: Unsupported platform ${currentPlatform}-${currentArch}`);
+    console.error('Stacktape binaries are available for:');
+    Object.keys(PLATFORM_MAP).forEach((key) => {
+      console.error(`  - ${key}`);
+    });
+    process.exit(1);
+  }
+
+  return platformKey;
+}
+
+/**
+ * Downloads a file from a URL with retry logic
+ */
+async function downloadFile(url, destPath, retries = 3) {
+  for (let i = 0; i < retries; i++) {
+    try {
+      await new Promise((resolve, reject) => {
+        const fileStream = createWriteStream(destPath);
+
+        httpsGet(url, (response) => {
+          // Follow redirects
+          if (response.statusCode === 301 || response.statusCode === 302) {
+            httpsGet(response.headers.location, (redirectResponse) => {
+              if (redirectResponse.statusCode !== 200) {
+                reject(new Error(`Failed to download: ${redirectResponse.statusCode}`));
+                return;
+              }
+
+              const totalBytes = Number.parseInt(redirectResponse.headers['content-length'], 10);
+              let downloadedBytes = 0;
+
+              redirectResponse.on('data', (chunk) => {
+                downloadedBytes += chunk.length;
+                const percent = totalBytes ? ((downloadedBytes / totalBytes) * 100).toFixed(1) : '?';
+                process.stdout.write(`\rDownloading... ${percent}%`);
+              });
+
+              redirectResponse.pipe(fileStream);
+              fileStream.on('finish', () => {
+                fileStream.close();
+                process.stdout.write('\n');
+                resolve();
+              });
+            }).on('error', reject);
+            return;
+          }
+
+          if (response.statusCode !== 200) {
+            reject(new Error(`Failed to download: ${response.statusCode}`));
+            return;
+          }
+
+          const totalBytes = Number.parseInt(response.headers['content-length'], 10);
+          let downloadedBytes = 0;
+
+          response.on('data', (chunk) => {
+            downloadedBytes += chunk.length;
+            const percent = totalBytes ? ((downloadedBytes / totalBytes) * 100).toFixed(1) : '?';
+            process.stdout.write(`\rDownloading... ${percent}%`);
+          });
+
+          response.pipe(fileStream);
+          fileStream.on('finish', () => {
+            fileStream.close();
+            process.stdout.write('\n');
+            resolve();
+          });
+        }).on('error', reject);
+      });
+
+      return; // Success
+    } catch (error) {
+      if (i === retries - 1) {
+        throw error;
+      }
+      console.info(`\nRetrying download (${i + 1}/${retries})...`);
+    }
+  }
+}
+
+/**
+ * Extracts a tar.gz archive
+ */
+async function extractTarGz(archivePath, destDir) {
+  const tar = require('tar');
+  await tar.x({
+    file: archivePath,
+    cwd: destDir
+  });
+}
+
+/**
+ * Extracts a zip archive
+ */
+async function extractZip(archivePath, destDir) {
+  const AdmZip = require('adm-zip');
+  const zip = new AdmZip(archivePath);
+  zip.extractAllTo(destDir, true);
+}
+
+/**
+ * Sets executable permissions on Unix systems
+ */
+function setExecutablePermissions(binDir) {
+  if (platform() === 'win32') {
+    return; // Windows doesn't need chmod
+  }
+
+  const executables = [
+    join(binDir, 'stacktape'),
+    join(binDir, 'esbuild', 'exec'),
+    join(binDir, 'session-manager-plugin', 'smp'),
+    join(binDir, 'pack', 'pack'),
+    join(binDir, 'nixpacks', 'nixpacks')
+  ];
+
+  for (const exe of executables) {
+    if (existsSync(exe)) {
+      try {
+        chmodSync(exe, 0o755);
+      } catch {
+        // Ignore chmod errors
+      }
+    }
+  }
+}
+
+/**
+ * Ensures the binary is downloaded and cached
+ */
+async function ensureBinary() {
+  const platformKey = detectPlatform();
+  const platformInfo = PLATFORM_MAP[platformKey];
+  const version = PACKAGE_VERSION;
+
+  // Cache directory: ~/.stacktape/bin/{version}/
+  const cacheDir = join(homedir(), '.stacktape', 'bin', version);
+  const binaryName = platform() === 'win32' ? 'stacktape.exe' : 'stacktape';
+  const binaryPath = join(cacheDir, binaryName);
+
+  // Check if binary is already cached
+  if (existsSync(binaryPath)) {
+    return binaryPath;
+  }
+
+  console.info(`Installing Stacktape ${version} for ${platformKey}...`);
+
+  // Create cache directory
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
+  }
+
+  // Download URL
+  const downloadUrl = `https://github.com/${GITHUB_REPO}/releases/download/${version}/${platformInfo.fileName}`;
+  const archivePath = join(cacheDir, platformInfo.fileName);
+
+  try {
+    // Download the archive
+    console.info(`Downloading from ${downloadUrl}...`);
+    await downloadFile(downloadUrl, archivePath);
+
+    // Extract the archive
+    console.info('Extracting...');
+    await platformInfo.extract(archivePath, cacheDir);
+
+    // Set executable permissions
+    setExecutablePermissions(cacheDir);
+
+    // Remove the archive
+    const { unlinkSync } = require('node:fs');
+    unlinkSync(archivePath);
+
+    // Verify the binary exists
+    if (!existsSync(binaryPath)) {
+      throw new Error(`Binary not found after extraction: ${binaryPath}`);
+    }
+
+    console.info(`✓ Stacktape ${version} installed successfully`);
+
+    return binaryPath;
+  } catch (error) {
+    console.error(`
+Error installing Stacktape:
+${error.message}
+
+You can also install Stacktape directly using:
+${getManualInstallCommand(platformKey)}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Gets the manual installation command for the platform
+ */
+function getManualInstallCommand(platformKey) {
+  const commands = {
+    'win32-x64': 'iwr https://installs.stacktape.com/windows.ps1 -useb | iex',
+    'linux-x64': 'curl -L https://installs.stacktape.com/linux.sh | sh',
+    'linux-arm64': 'curl -L https://installs.stacktape.com/linux-arm.sh | sh',
+    'linux-x64-musl': 'curl -L https://installs.stacktape.com/alpine.sh | sh',
+    'darwin-x64': 'curl -L https://installs.stacktape.com/macos.sh | sh',
+    'darwin-arm64': 'curl -L https://installs.stacktape.com/macos-arm.sh | sh'
+  };
+  return commands[platformKey] || 'See https://docs.stacktape.com for installation instructions';
+}
+
+/**
+ * Main execution
+ */
+async function main() {
+  try {
+    const binaryPath = await ensureBinary();
+    const args = process.argv.slice(2);
+
+    const result = spawnSync(binaryPath, args, {
+      stdio: 'inherit',
+      env: process.env
+    });
+
+    if (result.error) {
+      console.error(`Error executing Stacktape binary: ${result.error.message}`);
+      process.exit(1);
+    }
+
+    process.exit(result.status || 0);
+  } catch (error) {
+    console.error('Unexpected error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();