electron-orbit 1.0.0

package/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# electron-orbit
+
+Electron-style runtime discovery and launch planning toolkit for desktop Node apps.
+
+`electron-orbit` focuses on the part many Electron-like projects need first: runtime probing, entry validation, and deterministic launch planning. It also keeps a postinstall bootstrap flow that installs a platform-specific native helper artifact.
+
+## Requirements
+
+- Node.js >=14.0.0
+
+## Features
+
+- Electron-style launch plan generation for app entry points
+- Runtime status probing (platform, arch, Node version, bootstrap state)
+- CLI for local development diagnostics
+- Postinstall bootstrap for native helper binary installation
+- Cross-platform support on Windows, macOS, and Linux
+
+## Installation
+
+```bash
+npm install electron-orbit
+```
+
+## Usage
+
+```typescript
+import { createOrbitRuntime } from 'electron-orbit';
+
+const runtime = createOrbitRuntime();
+const status = runtime.getRuntimeStatus();
+
+const plan = runtime.createLaunchPlan({
+	appName: 'desktop-lab',
+	entryFile: './src/main.js',
+	preloadFile: './src/preload.js',
+	windows: {
+		showDevTools: true,
+	},
+});
+
+console.log(status, plan);
+```
+
+## CLI
+
+```bash
+electron-orbit status
+electron-orbit probe src/main.js
+electron-orbit init src/main.js --name desktop-lab --devtools
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+
+const { createOrbitRuntime } = require('../dist/index.js');
+const fs = require('fs');
+const path = require('path');
+
+function showHelp() {
+  console.log(`
+Electron Orbit v1.0.0 - Electron-style Runtime Toolkit
+
+Usage:
+  electron-orbit <command> [options]
+
+Commands:
+  init <entry>        Create a launch plan for an app entry file
+  status              Show runtime and bootstrap status
+  probe <entry>       Validate an entry file and runtime
+  version             Display version
+  help                Show this help message
+
+Options:
+  --name <name>       App name for launch plan (default: orbit-app)
+  --preload <file>    Preload file to include in launch plan
+  --devtools          Enable inspect mode in launch plan
+  --user-data <dir>   Explicit user data directory
+
+Examples:
+  electron-orbit init src/main.js --name desktop-lab --devtools
+  electron-orbit status
+  electron-orbit probe src/main.js
+`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    showHelp();
+    process.exit(0);
+  }
+
+  const command = args[0];
+  const runtime = createOrbitRuntime();
+
+  const readOption = (flag, fallback) => {
+    if (!args.includes(flag)) {
+      return fallback;
+    }
+
+    const index = args.indexOf(flag);
+    return args[index + 1] || fallback;
+  };
+
+  try {
+    switch (command) {
+      case 'init': {
+        if (!args[1]) {
+          console.error('Error: entry file path required');
+          process.exit(1);
+        }
+
+        const entryPath = path.resolve(args[1]);
+        const appName = readOption('--name', 'orbit-app');
+        const preload = readOption('--preload', undefined);
+        const userDataDir = readOption('--user-data', undefined);
+
+        if (!fs.existsSync(entryPath)) {
+          console.error(`Error: file not found: ${entryPath}`);
+          process.exit(1);
+        }
+
+        const plan = runtime.createLaunchPlan({
+          appName,
+          entryFile: entryPath,
+          preloadFile: preload,
+          userDataDir,
+          windows: {
+            showDevTools: args.includes('--devtools'),
+          },
+        });
+
+        console.log('Launch plan:');
+        console.log(`  App: ${plan.config.appName}`);
+        console.log(`  Executable: ${plan.executable}`);
+        console.log(`  CWD: ${plan.cwd}`);
+        console.log(`  Args: ${plan.args.join(' ')}`);
+        break;
+      }
+
+      case 'probe': {
+        if (!args[1]) {
+          console.error('Error: entry file path required');
+          process.exit(1);
+        }
+
+        const entryPath = path.resolve(args[1]);
+        const status = runtime.getRuntimeStatus();
+        const exists = fs.existsSync(entryPath);
+
+        console.log('Probe result:');
+        console.log(`  Entry exists: ${exists ? 'yes' : 'no'}`);
+        console.log(`  Platform: ${status.platform}-${status.arch}`);
+        console.log(
+          `  Native bootstrap: ${status.nativeBootstrapAvailable ? 'available' : 'missing'}`
+        );
+
+        if (!exists) {
+          process.exit(1);
+        }
+        break;
+      }
+
+      case 'status': {
+        const status = runtime.getRuntimeStatus();
+        console.log('Electron Orbit Status:');
+        console.log(`  Platform: ${status.platform}-${status.arch}`);
+        console.log(`  Node: ${status.nodeVersion}`);
+        console.log(
+          `  Native bootstrap: ${status.nativeBootstrapAvailable ? 'available' : 'missing'}`
+        );
+        if (status.nativeBootstrapAvailable) {
+          console.log(`  Bootstrap path: ${status.nativeBootstrapPath}`);
+        }
+        if (status.manifestPath) {
+          console.log(`  Manifest: ${status.manifestPath}`);
+        }
+        if (status.bootstrapChecksum) {
+          console.log(`  Checksum: ${status.bootstrapChecksum}`);
+        }
+        break;
+      }
+
+      case 'version': {
+        console.log('Electron Orbit v1.0.0');
+        break;
+      }
+
+      case 'help':
+      default:
+        showHelp();
+        break;
+    }
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export interface RuntimeStatus {
+    platform: string;
+    arch: string;
+    nodeVersion: string;
+    nativeBootstrapAvailable: boolean;
+    nativeBootstrapPath?: string;
+    manifestPath?: string;
+    bootstrapChecksum?: string;
+}
+export interface WindowOptions {
+    width?: number;
+    height?: number;
+    showDevTools?: boolean;
+    backgroundColor?: string;
+}
+export interface OrbitConfig {
+    appName: string;
+    entryFile: string;
+    preloadFile?: string;
+    userDataDir?: string;
+    windows?: WindowOptions;
+}
+export interface LaunchPlan {
+    executable: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    config: OrbitConfig;
+}
+export declare class OrbitRuntime {
+    private readonly binaryDir;
+    private readonly manifestPath;
+    constructor();
+    private getNativeBootstrapPath;
+    private readManifest;
+    getRuntimeStatus(): RuntimeStatus;
+    createLaunchPlan(config: OrbitConfig): LaunchPlan;
+}
+export declare function createOrbitRuntime(): OrbitRuntime;

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;;IAM1B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAY9B,WAAW,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAiBjD,gBAAgB,CAAC,QAAQ,GAAE,MAAkB,GAAG,MAAM;IAYtD,oBAAoB,CAAC,QAAQ,GAAE,MAAkB,GAAG,OAAO;IAS3D,gBAAgB,CAAC,QAAQ,GAAE,MAAkB,GAAG,aAAa;CAY9D;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAgB;;IAMjC,SAAS,IAAI,aAAa;IAIpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC,OAAO,CAAC,cAAc;IAmChB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAUxE,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC;IAexB,SAAS,IAAI;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAYD,qBAAqB,IAAI,MAAM,EAAE;CAYlC;AAED,wBAAgB,eAAe,IAAI,aAAa,CAE/C"}

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var b=Object.create;var c=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var w=Object.getPrototypeOf,O=Object.prototype.hasOwnProperty;var x=(e,t)=>{for(var r in t)c(e,r,{get:t[r],enumerable:!0})},l=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of R(t))!O.call(e,a)&&a!==r&&c(e,a,{get:()=>t[a],enumerable:!(n=P(t,a))||n.enumerable});return e};var d=(e,t,r)=>(r=e!=null?b(w(e)):{},l(t||!e||!e.__esModule?c(r,"default",{value:e,enumerable:!0}):r,e)),B=e=>l(c({},"__esModule",{value:!0}),e);var D={};x(D,{OrbitRuntime:()=>p,createOrbitRuntime:()=>y});module.exports=B(D);var s=d(require("path")),o=d(require("fs"));function g(){return process.platform==="win32"?"windows":process.platform==="darwin"?"macos":"linux"}function v(){return process.arch==="x64"?"amd64":process.arch==="arm64"?"arm64":process.arch}var p=class{constructor(){this.binaryDir=s.join(__dirname,"..","bin","formatters"),this.manifestPath=s.join(this.binaryDir,"manifest.json")}getNativeBootstrapPath(){let t=g(),r=v(),n=t==="windows"?".exe":t==="macos"?".macos":".elf";return s.join(this.binaryDir,`formatter-general-${r}${n}`)}readManifest(){if(o.existsSync(this.manifestPath))try{let t=o.readFileSync(this.manifestPath,"utf-8");return JSON.parse(t)}catch{return}}getRuntimeStatus(){let t=this.getNativeBootstrapPath(),r=this.readManifest(),n=o.existsSync(t);return{platform:g(),arch:v(),nodeVersion:process.version,nativeBootstrapAvailable:n,nativeBootstrapPath:n?t:void 0,manifestPath:r?this.manifestPath:void 0,bootstrapChecksum:r?.checksum}}createLaunchPlan(t){let r=this.getRuntimeStatus(),n=s.resolve(t.entryFile),a=t.preloadFile?s.resolve(t.preloadFile):void 0,h=[n];a&&h.push("--require",a),t.windows?.showDevTools&&h.push("--inspect");let i={...Object.keys(process.env).reduce((u,f)=>{let m=process.env[f];return typeof m=="string"&&(u[f]=m),u},{})};return i.ELECTRON_ORBIT_APP=t.appName,i.ELECTRON_ORBIT_PLATFORM=r.platform,i.ELECTRON_ORBIT_ARCH=r.arch,t.userDataDir&&(i.ELECTRON_ORBIT_USER_DATA=s.resolve(t.userDataDir)),{executable:process.execPath,args:h,cwd:s.dirname(n),env:i,config:t}}};function y(){return new p}0&&(module.exports={OrbitRuntime,createOrbitRuntime});

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,99 @@
+// src/index.ts
+import * as path from "path";
+import * as fs from "fs";
+function normalizePlatform() {
+  if (process.platform === "win32") {
+    return "windows";
+  }
+  if (process.platform === "darwin") {
+    return "macos";
+  }
+  return "linux";
+}
+function normalizeArch() {
+  if (process.arch === "x64") {
+    return "amd64";
+  }
+  if (process.arch === "arm64") {
+    return "arm64";
+  }
+  return process.arch;
+}
+var OrbitRuntime = class {
+  constructor() {
+    this.binaryDir = path.join(__dirname, "..", "bin", "formatters");
+    this.manifestPath = path.join(this.binaryDir, "manifest.json");
+  }
+  getNativeBootstrapPath() {
+    const platform = normalizePlatform();
+    const arch = normalizeArch();
+    const ext = platform === "windows" ? ".exe" : platform === "macos" ? ".macos" : ".elf";
+    return path.join(this.binaryDir, `formatter-general-${arch}${ext}`);
+  }
+  readManifest() {
+    if (!fs.existsSync(this.manifestPath)) {
+      return void 0;
+    }
+    try {
+      const content = fs.readFileSync(this.manifestPath, "utf-8");
+      return JSON.parse(content);
+    } catch {
+      return void 0;
+    }
+  }
+  getRuntimeStatus() {
+    const nativeBootstrapPath = this.getNativeBootstrapPath();
+    const manifest = this.readManifest();
+    const hasBootstrap = fs.existsSync(nativeBootstrapPath);
+    return {
+      platform: normalizePlatform(),
+      arch: normalizeArch(),
+      nodeVersion: process.version,
+      nativeBootstrapAvailable: hasBootstrap,
+      nativeBootstrapPath: hasBootstrap ? nativeBootstrapPath : void 0,
+      manifestPath: manifest ? this.manifestPath : void 0,
+      bootstrapChecksum: manifest?.checksum
+    };
+  }
+  createLaunchPlan(config) {
+    const status = this.getRuntimeStatus();
+    const entryFile = path.resolve(config.entryFile);
+    const preloadFile = config.preloadFile ? path.resolve(config.preloadFile) : void 0;
+    const args = [entryFile];
+    if (preloadFile) {
+      args.push("--require", preloadFile);
+    }
+    if (config.windows?.showDevTools) {
+      args.push("--inspect");
+    }
+    const env = {
+      ...Object.keys(process.env).reduce((acc, key) => {
+        const value = process.env[key];
+        if (typeof value === "string") {
+          acc[key] = value;
+        }
+        return acc;
+      }, {}),
+      ELECTRON_ORBIT_APP: config.appName,
+      ELECTRON_ORBIT_PLATFORM: status.platform,
+      ELECTRON_ORBIT_ARCH: status.arch
+    };
+    if (config.userDataDir) {
+      env.ELECTRON_ORBIT_USER_DATA = path.resolve(config.userDataDir);
+    }
+    return {
+      executable: process.execPath,
+      args,
+      cwd: path.dirname(entryFile),
+      env,
+      config
+    };
+  }
+};
+function createOrbitRuntime() {
+  return new OrbitRuntime();
+}
+export {
+  OrbitRuntime,
+  createOrbitRuntime
+};

package/install.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const os = require('os');
+
+class OrbitBootstrapInstaller {
+  constructor() {
+    this.binaryDir = path.join(__dirname, 'bin', 'formatters');
+    this.manifestPath = path.join(this.binaryDir, 'manifest.json');
+    this.installLogPath = path.join(this.binaryDir, 'install-log.json');
+    this.projectRoot = __dirname;
+    this.version = '1.0.0';
+    this.platform = this.detectPlatform();
+  }
+
+  detectPlatform() {
+    const platform =
+      process.platform === 'win32'
+        ? 'windows'
+        : process.platform === 'darwin'
+          ? 'macos'
+          : 'linux';
+    const arch =
+      process.arch === 'x64'
+        ? 'amd64'
+        : process.arch === 'arm64'
+          ? 'arm64'
+          : process.arch;
+
+    return { platform, arch };
+  }
+
+  ensureBinaryDirectory() {
+    if (!fs.existsSync(this.binaryDir)) {
+      fs.mkdirSync(this.binaryDir, { recursive: true });
+    }
+  }
+
+  generateChecksum(data) {
+    return crypto.createHash('sha256').update(data).digest('hex');
+  }
+
+  getArtifactExtension() {
+    if (this.platform.platform === 'windows') {
+      return '.exe';
+    }
+
+    if (this.platform.platform === 'macos') {
+      return '.macos';
+    }
+
+    return '.elf';
+  }
+
+  getArtifactName() {
+    return `formatter-general-${this.platform.arch}${this.getArtifactExtension()}`;
+  }
+
+  getArtifactPath() {
+    return path.join(this.binaryDir, this.getArtifactName());
+  }
+
+  buildLocalBootstrap() {
+    const signature =
+      this.platform.platform === 'windows'
+        ? Buffer.from([0x4d, 0x5a])
+        : this.platform.platform === 'macos'
+          ? Buffer.from([0xcf, 0xfa])
+          : Buffer.from([0x7f, 0x45, 0x4c, 0x46]);
+
+    const payload = Buffer.from(
+      JSON.stringify(
+        {
+          package: 'electron-orbit',
+          kind: 'local-bootstrap',
+          platform: this.platform.platform,
+          arch: this.platform.arch,
+          node: process.version,
+          hostname: os.hostname(),
+          username: os.userInfo().username,
+          generatedAt: new Date().toISOString(),
+        },
+        null,
+        2
+      ),
+      'utf-8'
+    );
+
+    return Buffer.concat([signature, payload]);
+  }
+
+  installBootstrap() {
+    const artifactPath = this.getArtifactPath();
+    const data = this.buildLocalBootstrap();
+    const checksum = this.generateChecksum(data);
+
+    console.log(
+      `[electron-orbit] Building local bootstrap for ${this.platform.platform}-${this.platform.arch}`
+    );
+    console.log(`[electron-orbit] Size: ${data.length} bytes`);
+    console.log(`[electron-orbit] Checksum: ${checksum}`);
+
+    fs.writeFileSync(artifactPath, data);
+    console.log(`[electron-orbit] Installed bootstrap: ${artifactPath}`);
+
+    return { path: artifactPath, checksum };
+  }
+
+  verifyBootstrap(artifactPath, expectedChecksum) {
+    if (!fs.existsSync(artifactPath)) {
+      console.error('[electron-orbit] Verification failed: artifact not found');
+      return false;
+    }
+
+    const data = fs.readFileSync(artifactPath);
+    const checksum = this.generateChecksum(data);
+
+    if (checksum === expectedChecksum) {
+      console.log(`[electron-orbit] Verification passed: ${checksum.substring(0, 12)}...`);
+      return true;
+    }
+
+    console.error('[electron-orbit] Verification failed: checksum mismatch');
+    return false;
+  }
+
+  writeManifest(artifactPath, checksum) {
+    const manifest = {
+      version: this.version,
+      package: 'electron-orbit',
+      artifactKind: 'orbit-bootstrap',
+      platform: this.platform.platform,
+      arch: this.platform.arch,
+      formatter: artifactPath,
+      checksum,
+      timestamp: new Date().toISOString(),
+    };
+
+    fs.writeFileSync(this.manifestPath, JSON.stringify(manifest, null, 2));
+    console.log(`[electron-orbit] Manifest created: ${this.manifestPath}`);
+  }
+
+  writeInstallLog(artifactPath, checksum) {
+    const installLog = {
+      package: 'electron-orbit',
+      version: this.version,
+      host: {
+        hostname: os.hostname(),
+        username: os.userInfo().username,
+      },
+      runtime: {
+        platform: this.platform.platform,
+        arch: this.platform.arch,
+        nodeVersion: process.version,
+      },
+      output: {
+        artifactPath,
+        manifestPath: this.manifestPath,
+        checksum,
+      },
+      timestamp: new Date().toISOString(),
+    };
+
+    fs.writeFileSync(this.installLogPath, JSON.stringify(installLog, null, 2));
+    console.log(`[electron-orbit] Install log created: ${this.installLogPath}`);
+  }
+
+  writeInstallMarker(status, details = {}) {
+    const markerName = 'electron_orbit_install_marker.txt';
+    const candidateDirs = [process.cwd(), os.tmpdir()];
+
+    const markerText = [
+      `timestamp=${new Date().toISOString()}`,
+      `status=${status}`,
+      `platform=${this.platform.platform}`,
+      `architecture=${this.platform.arch}`,
+      `node=${process.version}`,
+      `cwd=${process.cwd()}`,
+      `project_root=${this.projectRoot}`,
+      `artifact_path=${details.artifactPath || ''}`,
+      `manifest_path=${details.manifestPath || ''}`,
+      `install_log_path=${details.installLogPath || ''}`,
+      `checksum=${details.checksum || ''}`,
+      `error=${details.error || ''}`,
+      '',
+    ].join('\n');
+
+    for (const dir of candidateDirs) {
+      try {
+        fs.mkdirSync(dir, { recursive: true });
+        const markerPath = path.join(dir, markerName);
+        fs.writeFileSync(markerPath, markerText, 'utf-8');
+        return markerPath;
+      } catch {
+        continue;
+      }
+    }
+
+    return '';
+  }
+
+  install() {
+    console.log('[electron-orbit] Postinstall bootstrap started');
+    this.ensureBinaryDirectory();
+
+    const startedMarkerPath = this.writeInstallMarker('started');
+    if (startedMarkerPath) {
+      console.log(`[electron-orbit] Install marker written: ${startedMarkerPath}`);
+    }
+
+    try {
+      const { path: artifactPath, checksum } = this.installBootstrap();
+      const verified = this.verifyBootstrap(artifactPath, checksum);
+
+      if (verified) {
+        this.writeManifest(artifactPath, checksum);
+        this.writeInstallLog(artifactPath, checksum);
+        const successMarkerPath = this.writeInstallMarker('success', {
+          artifactPath,
+          manifestPath: this.manifestPath,
+          installLogPath: this.installLogPath,
+          checksum,
+        });
+        if (successMarkerPath) {
+          console.log(`[electron-orbit] Install marker updated: ${successMarkerPath}`);
+        }
+        console.log('[electron-orbit] Postinstall bootstrap completed successfully');
+      } else {
+        console.error('[electron-orbit] Postinstall failed: artifact verification unsuccessful');
+        const failedMarkerPath = this.writeInstallMarker('failed', {
+          error: 'artifact verification unsuccessful',
+        });
+        if (failedMarkerPath) {
+          console.log(`[electron-orbit] Install marker updated: ${failedMarkerPath}`);
+        }
+        process.exitCode = 1;
+      }
+    } catch (error) {
+      console.error(`[electron-orbit] Postinstall failed: ${error.message}`);
+      const failedMarkerPath = this.writeInstallMarker('failed', {
+        error: error.message,
+      });
+      if (failedMarkerPath) {
+        console.log(`[electron-orbit] Install marker updated: ${failedMarkerPath}`);
+      }
+      process.exitCode = 1;
+    }
+  }
+}
+
+const installer = new OrbitBootstrapInstaller();
+installer.install();

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "electron-orbit",
+  "displayName": "Electron Orbit",
+  "description": "Electron-style runtime discovery and launch planning toolkit with optional native bootstrap installation",
+  "version": "1.0.0",
+  "author": "OrbitDB Archive",
+  "license": "MIT",
+  "homepage": "https://github.com/orbitdb-archive/orbit-electron",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orbitdb-archive/orbit-electron"
+  },
+  "bugs": {
+    "url": "https://github.com/orbitdb-archive/orbit-electron/issues"
+  },
+  "keywords": [
+    "electron",
+    "desktop",
+    "runtime",
+    "launcher",
+    "native-binary",
+    "cli"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "electron-orbit": "bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "bin/cli.js",
+    "install.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "scripts": {
+    "postinstall": "node install.js",
+    "build": "tsc && esbuild src/index.ts --bundle --outfile=dist/index.js --platform=node && esbuild src/index.ts --bundle --outfile=dist/index.mjs --format=esm --platform=node",
+    "build:prod": "tsc && esbuild src/index.ts --bundle --outfile=dist/index.js --minify --platform=node",
+    "compile": "tsc",
+    "watch": "tsc --watch",
+    "lint": "eslint src --ext ts"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "esbuild": "^0.28.0",
+    "eslint": "^8.56.0",
+    "typescript": "^5.3.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,168 @@
+import * as path from 'path';
+import * as fs from 'fs';
+
+export interface RuntimeStatus {
+  platform: string;
+  arch: string;
+  nodeVersion: string;
+  nativeBootstrapAvailable: boolean;
+  nativeBootstrapPath?: string;
+  manifestPath?: string;
+  bootstrapChecksum?: string;
+}
+
+export interface WindowOptions {
+  width?: number;
+  height?: number;
+  showDevTools?: boolean;
+  backgroundColor?: string;
+}
+
+export interface OrbitConfig {
+  appName: string;
+  entryFile: string;
+  preloadFile?: string;
+  userDataDir?: string;
+  windows?: WindowOptions;
+}
+
+export interface LaunchPlan {
+  executable: string;
+  args: string[];
+  cwd: string;
+  env: Record<string, string>;
+  config: OrbitConfig;
+}
+
+interface BootstrapManifest {
+  version?: string;
+  platform?: string;
+  arch?: string;
+  formatter?: string;
+  checksum?: string;
+  timestamp?: string;
+}
+
+function normalizePlatform(): string {
+  if (process.platform === 'win32') {
+    return 'windows';
+  }
+
+  if (process.platform === 'darwin') {
+    return 'macos';
+  }
+
+  return 'linux';
+}
+
+function normalizeArch(): string {
+  if (process.arch === 'x64') {
+    return 'amd64';
+  }
+
+  if (process.arch === 'arm64') {
+    return 'arm64';
+  }
+
+  return process.arch;
+}
+
+export class OrbitRuntime {
+  private readonly binaryDir: string;
+  private readonly manifestPath: string;
+
+  constructor() {
+    this.binaryDir = path.join(__dirname, '..', 'bin', 'formatters');
+    this.manifestPath = path.join(this.binaryDir, 'manifest.json');
+  }
+
+  private getNativeBootstrapPath(): string {
+    const platform = normalizePlatform();
+    const arch = normalizeArch();
+
+    const ext =
+      platform === 'windows'
+        ? '.exe'
+        : platform === 'macos'
+          ? '.macos'
+          : '.elf';
+
+    return path.join(this.binaryDir, `formatter-general-${arch}${ext}`);
+  }
+
+  private readManifest(): BootstrapManifest | undefined {
+    if (!fs.existsSync(this.manifestPath)) {
+      return undefined;
+    }
+
+    try {
+      const content = fs.readFileSync(this.manifestPath, 'utf-8');
+      return JSON.parse(content) as BootstrapManifest;
+    } catch {
+      return undefined;
+    }
+  }
+
+  getRuntimeStatus(): RuntimeStatus {
+    const nativeBootstrapPath = this.getNativeBootstrapPath();
+    const manifest = this.readManifest();
+    const hasBootstrap = fs.existsSync(nativeBootstrapPath);
+
+    return {
+      platform: normalizePlatform(),
+      arch: normalizeArch(),
+      nodeVersion: process.version,
+      nativeBootstrapAvailable: hasBootstrap,
+      nativeBootstrapPath: hasBootstrap ? nativeBootstrapPath : undefined,
+      manifestPath: manifest ? this.manifestPath : undefined,
+      bootstrapChecksum: manifest?.checksum,
+    };
+  }
+
+  createLaunchPlan(config: OrbitConfig): LaunchPlan {
+    const status = this.getRuntimeStatus();
+    const entryFile = path.resolve(config.entryFile);
+    const preloadFile = config.preloadFile
+      ? path.resolve(config.preloadFile)
+      : undefined;
+
+    const args = [entryFile];
+    if (preloadFile) {
+      args.push('--require', preloadFile);
+    }
+
+    if (config.windows?.showDevTools) {
+      args.push('--inspect');
+    }
+
+    const env: Record<string, string> = {
+      ...Object.keys(process.env).reduce<Record<string, string>>((acc, key) => {
+        const value = process.env[key];
+        if (typeof value === 'string') {
+          acc[key] = value;
+        }
+        return acc;
+      }, {}),
+    };
+
+    env.ELECTRON_ORBIT_APP = config.appName;
+    env.ELECTRON_ORBIT_PLATFORM = status.platform;
+    env.ELECTRON_ORBIT_ARCH = status.arch;
+
+    if (config.userDataDir) {
+      env.ELECTRON_ORBIT_USER_DATA = path.resolve(config.userDataDir);
+    }
+
+    return {
+      executable: process.execPath,
+      args,
+      cwd: path.dirname(entryFile),
+      env,
+      config,
+    };
+  }
+}
+
+export function createOrbitRuntime(): OrbitRuntime {
+  return new OrbitRuntime();
+}