electrobun 0.0.18 → 0.0.19-beta.1

package/BETA_RELEASE.md

@@ -0,0 +1,67 @@
+# Electrobun Beta Releases
+
+## For Users
+
+### Installing Beta Versions
+
+```bash
+# Install latest beta
+npm install electrobun@beta
+
+# Install specific beta version
+npm install electrobun@0.0.19-beta.1
+
+# View available versions
+npm view electrobun versions --json
+```
+
+### Switching Between Stable and Beta
+
+```bash
+# Switch to stable
+npm install electrobun@latest
+
+# Switch to beta
+npm install electrobun@beta
+```
+
+## For Maintainers
+
+### Publishing Beta Releases
+
+1. **Update version:**
+   ```bash
+   # First beta of a new version
+   npm version 0.0.19-beta.1
+   
+   # Increment beta number
+   bun npm:version:beta
+   ```
+
+2. **Create GitHub Release:**
+   ```bash
+   git push origin v0.0.19-beta.1
+   ```
+   Or manually trigger the workflow with the beta tag.
+
+3. **Publish to npm:**
+   ```bash
+   bun npm:publish:beta
+   ```
+
+### Beta Release Workflow
+
+1. Beta versions use semantic versioning: `MAJOR.MINOR.PATCH-beta.NUMBER`
+2. GitHub Actions automatically marks releases with `-beta` as pre-releases
+3. npm publishes to the `beta` dist-tag (not `latest`)
+4. Users on stable versions won't get beta updates
+
+### Promoting Beta to Stable
+
+```bash
+# Update version to stable
+npm version 0.0.19
+
+# Publish as latest
+bun npm:publish
+```

package/README.md

@@ -8,7 +8,7 @@
 
 ## What is Electrobun?
 
-> Electrobun is in the **_very_** early stages. We currently only support development on arm macs, it has memory leaks, has no tests, it's not available in npm yet, and many core things are still missing.
+> Electrobun is in the **_very_** early stages. We currently support development on macOS, Windows, and Linux, but it has memory leaks, has no tests, and many core things are still missing. We're actively working on stabilizing cross-platform support.
 
 Electrobun aims to be a complete **solution-in-a-box** for building, updating, and shipping ultra fast, tiny, and cross-platform desktop applications written in Typescript.
 Under the hood it uses <a href="https://bun.sh">bun</a> to execute the main process and to bundle webview typescript, and has native bindings written in <a href="https://ziglang.org/">zig</a>.
@@ -29,21 +29,7 @@ Read about how Electrobun is designed, and why, in our <a href="https://www.elec
 
 ## Roadmap
 
-See the detailed <a href="https://github.com/blackboardsh/electrobun/issues/2">detailed Roadmap</a>.
-
-**High level roadmap**
-
-|     | Milestones            | Description                                                                                                                             |
-| :-- | :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
-| ✅  | Core Architecture     | Ship a working proof of concept with most of the core architecture wired up                                                             |
-| ✅  | Packaging and signing | Packaging and code signing for MacOS                                                                                                    |
-| ✅  | Shipping updates      | Integrated auto-updator                                                                                                                 |
-| ✅  | Webview Tag           | Cross browser electrobun implementation of the <webview> tag that electron has, for isolated nested webviews                            |
-| ✅  | Port co(lab)          | Harden implementation and enough electron parity to migrate <a href="https://colab.sh">https://colab.sh</a> from Electron to Electrobun |
-|     | Custom Web Runtime    | Optionally use a cross-platform web runtime (Chromium) instead of the system's native webview                                           |
-|     | Intel Mac Builds      | build on and distribute to intel macs                                                                                                   |
-|     | API Parity            | Accelerate development of Electrobun apis and native integrations to enable apps to migrate from Electron and Tauri                     |
-|     | Windows support       | build for and distribute to Windows                                                                                                     |
+See the <a href="https://github.com/orgs/blackboardsh/projects/5">roadmap</a>
 
 ## Contributing
 
@@ -53,14 +39,55 @@ As we get closer to 1.0.0 I'll probably make guidelines for PRs and stuff. In th
 
 Ways to get involved at this early stage:
 
-- Follow us on X for updates <a href="https://twitter.com/BlackboardTech">@BlackboardTech</a>
+- Follow us on X for updates <a href="https://twitter.com/BlackboardTech">@BlackboardTech</a> or <a href="https://bsky.app/profile/yoav.codes">@yoav.codes</a>
 - Join the conversation on <a href="https://discord.gg/ueKE4tjaCE">Discord</a>
 - Create and participate in Github issues and discussions
 
-## Building
+## Development Setup
+
+### Prerequisites
+
+**macOS:**
+- Xcode command line tools
+- cmake (install via homebrew: `brew install cmake`)
+
+**Windows:**
+- Visual Studio Build Tools or Visual Studio with C++ development tools
+- cmake
+
+**Linux:**
+- build-essential package
+- cmake
+- webkit2gtk and GTK development packages
+
+### First-time Setup
+
+```bash
+git clone <repo-url>
+cd electrobun
+bun install
+bun dev:playground:clean
+```
+
+### Development Workflow
+
+```bash
+# After making changes to source code
+bun dev:playground
+
+# If you only changed playground code (not electrobun source)
+bun dev:playground:rerun
+
+# If you need a completely fresh start
+bun dev:playground:clean
+```
+
+### Additional Commands
 
-run `bun run install-zig` to install the right version of zig to vendors/zig
+- `bun dev:playground:canary` - Build and run playground in canary mode
+- `bun build:dev` - Build electrobun in development mode
+- `bun build:release` - Build electrobun in release mode
 
-`bun dev:playground` and `bun dev:playground:canary` will compile everything in electrobun in either dev mode and then compile the playground app in either dev or canary modes and run it.
+### Debugging
 
-Note: use `lldb <path-to-bundle>/Contents/MacOS/launcher` and then `run` to debug release builds
+**macOS:** Use `lldb <path-to-bundle>/Contents/MacOS/launcher` and then `run` to debug release builds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electrobun",
-  "version": "0.0.18",
+  "version": "0.0.19-beta.1",
   "description": "Build ultra fast, tiny, and cross-platform desktop apps with Typescript.",
   "license": "MIT",
   "author": "Blackboard Technologies Inc.",
@@ -10,8 +10,9 @@
     "./bun": "./dist/api/bun/index.ts",
     "./view": "./dist/api/browser/index.ts"
   },
+  "type": "module",
   "bin": {
-    "electrobun": "dist/electrobun"
+    "electrobun": "dist/npmbin.js"
   },
   "homepage": "https://electrobun.dev",
   "repository": {
@@ -19,36 +20,24 @@
     "url": "git+https://github.com/blackboardsh/electrobun.git"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "start": "bun src/bun/index.ts",
     "check-zig-version": "vendors/zig/zig version",
-    "install-zig": "mkdir -p vendors/zig && curl -L https://ziglang.org/download/0.13.0/zig-macos-aarch64-0.13.0.tar.xz | tar -xJ --strip-components=1 -C vendors/zig zig-macos-aarch64-0.13.0/zig zig-macos-aarch64-0.13.0/lib  zig-macos-aarch64-0.13.0/doc",
-    "build:objc:object": "mkdir -p src/objc/build && clang -c src/objc/objcWrapper.m -o src/objc/build/objcWrapper.o -fobjc-arc -fno-objc-msgsend-selector-stubs",
-    "build:objc:staticlib": "ar rcs src/zig/build/libObjcWrapper.a src/objc/build/objcWrapper.o",
-    "build:objc": "bun build:objc:object && bun build:objc:staticlib",
-    "build:zig": "cd src/zig && ../../vendors/zig/zig build",
-    "build:zig:trdiff": "cd src/bsdiff && ../../vendors/zig/zig build",
-    "build:launcher": "cd src/launcher && ../../vendors/zig/zig build",
-    "build:extractor": "cd src/extractor && ../../vendors/zig/zig build",
-    "build:zig:release": "cd src/zig && ../../vendors/zig/zig build -Doptimize=ReleaseFast",
-    "build:zig:trdiff:release": "cd src/bsdiff && ../../vendors/zig/zig build -Doptimize=ReleaseFast",
-    "build:launcher:release": "cd src/launcher && ../../vendors/zig/zig build -Doptimize=ReleaseSmall",
-    "build:extractor:release": "cd src/extractor && ../../vendors/zig/zig build -Doptimize=ReleaseSmall",
-    "build:cli": "bun build src/cli/index.ts --compile --outfile src/cli/build/electrobun",
-    "build:debug": "npm install && bun build:zig:trdiff && bun build:objc && bun build:zig && bun build:launcher && bun build:extractor && bun build:cli",
-    "build:release": "bun build:objc && bun build:zig:trdiff:release && bun build:zig:release && bun build:launcher:release && bun build:extractor:release && bun build:cli",
-    "build:package": "bun build:release && bun ./scripts/copy-to-dist.ts",
-    "build:dev": "bun build:debug && bun ./scripts/copy-to-dist.ts",
-    "build:electrobun": "bun build:objc && bun build:zig && bun build:bun",
+    "build:dev": "bun build.ts",
+    "build:release": "bun build.ts --release",
     "dev:playground": "bun build:dev && cd playground && npm install && bun build:dev && bun start",
+    "dev:playground:linux": "bun build:dev && npm link && cd playground && npm link electrobun && bun build:dev && bun start",
+    "dev:playground:clean": "cd playground && rm -rf node_modules && npm install && cd .. && bun dev:playground",
     "dev:playground:rerun": "cd playground && bun start",
-    "dev:playground:canary": "bun build:package && cd playground && npm install && bun build:canary && bun start:canary",
+    "dev:playground:canary": "bun build:release && cd playground && npm install && bun build:canary && bun start:canary",
     "dev:docs": "cd documentation && bun start",
     "build:docs:release": "cd documentation && bun run build",
-    "npm:publish": "bun build:package && npm publish"
+    "npm:publish": "bun build:release && npm publish",
+    "npm:publish:beta": "bun build:release && npm publish --tag beta",
+    "npm:version:beta": "npm version prerelease --preid=beta"
   },
   "devDependencies": {
-    "@types/bun": "1.1.9",
-    "bun": "1.1.29"
+    "@types/bun": "1.1.9"
   },
   "dependencies": {
     "@oneidentity/zstd-js": "^1.0.3",

package/scripts/postinstall.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import https from 'https';
+import { createWriteStream } from 'fs';
+import { pipeline } from 'stream';
+import { promisify } from 'util';
+import tar from 'tar';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const pipelineAsync = promisify(pipeline);
+
+const REPO = 'blackboardsh/electrobun';
+const DIST_DIR = path.join(__dirname, '..', 'dist');
+
+function getPlatform() {
+  const platform = process.platform;
+  const arch = process.arch;
+  
+  // Map Node.js platform/arch to our naming
+  const platformMap = {
+    'darwin': 'darwin',
+    'linux': 'linux',
+    'win32': 'win32'
+  };
+  
+  const archMap = {
+    'x64': 'x64',
+    'arm64': 'arm64'
+  };
+  
+  return {
+    platform: platformMap[platform] || platform,
+    arch: archMap[arch] || arch
+  };
+}
+
+async function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    https.get(url, { headers: { 'User-Agent': 'electrobun-installer' } }, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        // Follow redirect
+        downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+        return;
+      }
+      
+      if (response.statusCode !== 200) {
+        reject(new Error(`Failed to download: ${response.statusCode}`));
+        return;
+      }
+      
+      const file = createWriteStream(dest);
+      response.pipe(file);
+      
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+      
+      file.on('error', (err) => {
+        fs.unlinkSync(dest);
+        reject(err);
+      });
+    }).on('error', reject);
+  });
+}
+
+async function getLatestRelease() {
+  return new Promise((resolve, reject) => {
+    const options = {
+      hostname: 'api.github.com',
+      path: `/repos/${REPO}/releases/latest`,
+      headers: {
+        'User-Agent': 'electrobun-installer',
+        'Accept': 'application/vnd.github.v3+json'
+      }
+    };
+    
+    https.get(options, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        try {
+          const release = JSON.parse(data);
+          resolve(release.tag_name);
+        } catch (err) {
+          reject(err);
+        }
+      });
+    }).on('error', reject);
+  });
+}
+
+async function main() {
+  try {
+    // Skip if running in CI or if binaries already exist
+    if (process.env.CI || process.env.ELECTROBUN_SKIP_DOWNLOAD) {
+      console.log('Skipping binary download');
+      return;
+    }
+    
+    // Check if dist already exists with binaries
+    if (fs.existsSync(path.join(DIST_DIR, 'electrobun'))) {
+      console.log('Binaries already exist, skipping download');
+      return;
+    }
+    
+    const { platform, arch } = getPlatform();
+    const binaryName = `electrobun-${platform}-${arch}`;
+    
+    console.log(`Downloading Electrobun binaries for ${platform}-${arch}...`);
+    
+    // Get the latest release tag
+    const version = process.env.ELECTROBUN_VERSION || await getLatestRelease();
+    
+    const downloadUrl = `https://github.com/${REPO}/releases/download/${version}/${binaryName}.tar.gz`;
+    const tempFile = path.join(__dirname, `${binaryName}.tar.gz`);
+    
+    // Download the tarball
+    console.log(`Downloading from ${downloadUrl}...`);
+    await downloadFile(downloadUrl, tempFile);
+    
+    // Create dist directory if it doesn't exist
+    if (!fs.existsSync(DIST_DIR)) {
+      fs.mkdirSync(DIST_DIR, { recursive: true });
+    }
+    
+    // Extract the tarball
+    console.log('Extracting binaries...');
+    await tar.x({
+      file: tempFile,
+      cwd: DIST_DIR
+    });
+    
+    // Clean up
+    fs.unlinkSync(tempFile);
+    
+    // Make binaries executable on Unix-like systems
+    if (platform !== 'win32') {
+      const binaries = ['bun', 'electrobun', 'launcher', 'extractor', 'bsdiff', 'bspatch', 'process_helper'];
+      binaries.forEach(bin => {
+        const binPath = path.join(DIST_DIR, bin);
+        if (fs.existsSync(binPath)) {
+          fs.chmodSync(binPath, 0o755);
+        }
+      });
+    }
+    
+    console.log('Electrobun installed successfully!');
+    
+  } catch (error) {
+    console.error('Failed to download Electrobun binaries:', error.message);
+    console.error('You can manually download from: https://github.com/blackboardsh/electrobun/releases');
+    // Don't fail the installation
+    process.exit(0);
+  }
+}
+
+// Run main function
+main();

package/test-npm-install.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+# Test npm installation locally
+echo "Testing Electrobun npm installation..."
+
+# Create a temporary test directory
+TEST_DIR=$(mktemp -d)
+cd $TEST_DIR
+
+echo "Test directory: $TEST_DIR"
+
+# Initialize a test project
+npm init -y
+
+# Set environment variable to use specific version
+export ELECTROBUN_VERSION=v0.0.19-beta.1
+
+# Install electrobun (will use local package.json)
+npm install file:///home/yoav/code/electrobun
+
+# Check if installation worked
+if [ -f "node_modules/electrobun/dist/electrobun" ]; then
+    echo "✓ Electrobun CLI installed successfully"
+    ./node_modules/.bin/electrobun --version
+else
+    echo "✗ Electrobun CLI not found"
+fi
+
+# List installed files
+echo -e "\nInstalled files:"
+find node_modules/electrobun -type f -name "*.ts" | head -10
+find node_modules/electrobun/dist -type f | head -10
+
+echo -e "\nTest complete. Directory: $TEST_DIR"

package/dist/api/browser/builtinrpcSchema.ts

@@ -1,10 +0,0 @@
-// consider just makeing a shared types file
-
-export type BuiltinBunToWebviewSchema = {
-  requests: {
-    evaluateJavascriptWithResponse: {
-      params: { script: string };
-      response: any;
-    };
-  };
-};