relay-studio 1.0.0

package/bin/relay-studio.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const { pipeline } = require('stream/promises');
+const { Readable } = require('stream');
+const extract = require('extract-zip');
+const { resolveTarget, assetName, assetUrl, cacheDir } = require('../lib');
+const { version } = require('../package.json');
+
+async function download(url, dest) {
+    const res = await fetch(url, { redirect: 'follow' });
+    if (!res.ok) {
+        throw new Error(`Download failed (${res.status} ${res.statusText})\n  ${url}`);
+    }
+    process.stdout.write(`Downloading Relay Studio ${version}...\n`);
+    await pipeline(Readable.fromWeb(res.body), fs.createWriteStream(dest));
+}
+
+// Returns the path to the executable/app/AppImage to launch, installing if needed.
+async function ensureInstalled() {
+    const t = resolveTarget(process.platform, process.arch);
+    const dir = cacheDir(version);
+    const marker = path.join(dir, '.installed');
+
+    if (!fs.existsSync(marker)) {
+        fs.mkdirSync(dir, { recursive: true });
+        try {
+            const url = assetUrl(version, t);
+
+            if (t.ext === 'AppImage') {
+                const appImage = path.join(dir, 'Relay-Studio.AppImage');
+                await download(url, appImage);
+                fs.chmodSync(appImage, 0o755);
+            } else {
+                const zip = path.join(dir, assetName(version, t));
+                await download(url, zip);
+                await extract(zip, { dir });
+                fs.rmSync(zip, { force: true });
+            }
+            fs.writeFileSync(marker, new Date().toISOString());
+        } catch (err) {
+            fs.rmSync(dir, { recursive: true, force: true });
+            throw err;
+        }
+    }
+    return locateLaunchTarget(dir, t);
+}
+
+function locateLaunchTarget(dir, t) {
+    if (t.os === 'mac') {
+        const app = fs.readdirSync(dir).find((f) => f.endsWith('.app'));
+        if (!app) throw new Error(`No .app bundle found in ${dir}`);
+        return { kind: 'mac', appPath: path.join(dir, app) };
+    }
+    if (t.os === 'win') {
+        const exe = findFile(dir, (f) => f.toLowerCase().endsWith('.exe'));
+        if (!exe) throw new Error(`No .exe found in ${dir}`);
+        return { kind: 'win', exePath: exe };
+    }
+    const appImage = path.join(dir, 'Relay-Studio.AppImage');
+    if (!fs.existsSync(appImage)) throw new Error(`AppImage not found in ${dir}`);
+    return { kind: 'linux', appImage };
+}
+
+// Shallow + one-level search (electron-builder win zip may nest in a subfolder).
+function findFile(dir, pred) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isFile() && pred(entry.name)) return full;
+        if (entry.isDirectory()) {
+            const nested = fs.readdirSync(full, { withFileTypes: true })
+                .find((e) => e.isFile() && pred(e.name));
+            if (nested) return path.join(full, nested.name);
+        }
+    }
+    return null;
+}
+
+function launch(target) {
+    let child;
+    if (target.kind === 'mac') {
+        child = spawn('open', ['-a', target.appPath], { detached: true, stdio: 'ignore' });
+    } else if (target.kind === 'win') {
+        child = spawn(target.exePath, [], { detached: true, stdio: 'ignore' });
+    } else {
+        child = spawn(target.appImage, [], { detached: true, stdio: 'ignore' });
+    }
+    child.on('error', (err) => {
+        process.stderr.write(`\nFailed to launch Relay Studio: ${err.message}\n`);
+        process.exitCode = 1;
+    });
+    child.unref();
+}
+
+(async () => {
+    try {
+        const target = await ensureInstalled();
+        launch(target);
+        process.stdout.write('Relay Studio launched.\n');
+    } catch (err) {
+        process.stderr.write(`\nFailed to start Relay Studio: ${err.message}\n`);
+        process.exit(1);
+    }
+})();

package/lib.js

@@ -0,0 +1,40 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+
+const REPO = 'YoniRaviv/Relay';
+
+function resolveTarget(platform, arch) {
+    if (platform === 'darwin') {
+        if (arch !== 'arm64') {
+            throw new Error(
+                `Intel Macs are not supported via npm. Download the .dmg from https://github.com/${REPO}/releases/latest`
+            );
+        }
+        return { os: 'mac', arch: 'arm64', ext: 'zip' };
+    }
+    if (platform === 'win32') {
+        return { os: 'win', arch: 'x64', ext: 'zip' };
+    }
+    if (platform === 'linux') {
+        if (arch !== 'x64') {
+            throw new Error(`Unsupported platform: ${platform} (${arch})`);
+        }
+        return { os: 'linux', arch: 'x64', ext: 'AppImage' };
+    }
+    throw new Error(`Unsupported platform: ${platform} (${arch})`);
+}
+
+function assetName(version, t) {
+    return `Relay-Studio-${t.os}-${t.arch}-${version}.${t.ext}`;
+}
+
+function assetUrl(version, t) {
+    return `https://github.com/${REPO}/releases/download/${version}/${assetName(version, t)}`;
+}
+
+function cacheDir(version) {
+    return path.join(os.homedir(), '.relay-studio', version);
+}
+
+module.exports = { resolveTarget, assetName, assetUrl, cacheDir, REPO };

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "relay-studio",
+  "version": "1.0.0",
+  "description": "Installer/launcher for Relay Studio — a visual Kanban build loop for Claude Code & Codex.",
+  "bin": {
+    "relay-studio": "bin/relay-studio.js"
+  },
+  "type": "commonjs",
+  "files": [
+    "bin",
+    "lib.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YoniRaviv/Relay.git"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "Yoni Raviv",
+  "dependencies": {
+    "extract-zip": "^2.0.1"
+  }
+}