@yossydev/entire 0.5.0

package/README.md

@@ -0,0 +1,31 @@
+# @yossydev/entire
+
+npm binary wrapper for the [Entire CLI](https://github.com/entireio/cli).
+
+## Installation
+
+```bash
+npm install -g @yossydev/entire
+```
+
+## Usage
+
+```bash
+entire --help
+entire --version
+```
+
+## How it works
+
+This package installs the correct native binary for your platform via `optionalDependencies`. Supported platforms:
+
+- macOS ARM64 (Apple Silicon)
+- macOS x64 (Intel)
+- Linux ARM64
+- Linux x64
+
+If `--no-optional` is used during installation, the `postinstall` script will download the binary directly from GitHub Releases as a fallback.
+
+## License
+
+MIT

package/bin/entire

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const { binPathForCurrentPlatform } = require("../platform");
+
+try {
+  const binPath = binPathForCurrentPlatform();
+  const result = execFileSync(binPath, process.argv.slice(2), {
+    stdio: "inherit",
+  });
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  if (err.signal) {
+    process.kill(process.pid, err.signal);
+  }
+  console.error(err.message);
+  process.exit(1);
+}

package/install.js

@@ -0,0 +1,124 @@
+"use strict";
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const zlib = require("zlib");
+const { pkgForCurrentPlatform } = require("./platform");
+
+const version = require("./package.json").version;
+
+const PKG_TO_ASSET = {
+  "@yossydev/entire-darwin-arm64": "entire_darwin_arm64.tar.gz",
+  "@yossydev/entire-darwin-x64": "entire_darwin_amd64.tar.gz",
+  "@yossydev/entire-linux-arm64": "entire_linux_arm64.tar.gz",
+  "@yossydev/entire-linux-x64": "entire_linux_amd64.tar.gz",
+};
+
+function alreadyInstalled() {
+  const pkg = pkgForCurrentPlatform();
+  try {
+    require.resolve(`${pkg}/bin/entire`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function fetch(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (res) => {
+        if (
+          (res.statusCode === 301 || res.statusCode === 302) &&
+          res.headers.location
+        ) {
+          return fetch(res.headers.location).then(resolve, reject);
+        }
+        if (res.statusCode !== 200) {
+          return reject(
+            new Error(`Server responded with ${res.statusCode} for ${url}`)
+          );
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+      })
+      .on("error", reject);
+  });
+}
+
+function extractBinaryFromTarGzip(buffer) {
+  const tar = zlib.gunzipSync(buffer);
+
+  let offset = 0;
+  while (offset < tar.length) {
+    const header = tar.subarray(offset, offset + 512);
+
+    // Check for end-of-archive (two consecutive zero blocks)
+    if (header.every((b) => b === 0)) {
+      break;
+    }
+
+    const name = header
+      .subarray(0, 100)
+      .toString()
+      .replace(/\0.*$/, "");
+    const sizeStr = header
+      .subarray(124, 136)
+      .toString()
+      .replace(/\0.*$/, "")
+      .trim();
+    const size = parseInt(sizeStr, 8);
+
+    offset += 512;
+
+    if (!isNaN(size) && size > 0) {
+      if (name === "entire" || name === "./entire") {
+        return tar.subarray(offset, offset + size);
+      }
+      offset += Math.ceil(size / 512) * 512;
+    }
+  }
+  throw new Error('Could not find "entire" binary in archive');
+}
+
+async function main() {
+  if (alreadyInstalled()) {
+    return;
+  }
+
+  const pkg = pkgForCurrentPlatform();
+  const asset = PKG_TO_ASSET[pkg];
+  if (!asset) {
+    console.error(`[entire] No download available for package "${pkg}"`);
+    process.exit(1);
+  }
+
+  const url = `https://github.com/entireio/cli/releases/download/v${version}/${asset}`;
+  console.error(
+    `[entire] Platform package not found. Downloading from ${url}`
+  );
+
+  try {
+    const tgz = await fetch(url);
+    const binary = extractBinaryFromTarGzip(tgz);
+
+    const binDir = path.join(__dirname, "bin");
+    const binPath = path.join(binDir, "entire-binary");
+
+    fs.mkdirSync(binDir, { recursive: true });
+    fs.writeFileSync(binPath, binary);
+    fs.chmodSync(binPath, 0o755);
+
+    console.error(`[entire] Successfully downloaded binary to ${binPath}`);
+  } catch (err) {
+    console.error(`[entire] Failed to download binary: ${err.message}`);
+    console.error(
+      `[entire] You can download manually from: https://github.com/entireio/cli/releases`
+    );
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@yossydev/entire",
+  "version": "0.5.0",
+  "description": "The Entire CLI - npm binary wrapper",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/entireio/cli.git"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "entire": "bin/entire"
+  },
+  "files": [
+    "bin/",
+    "platform.js",
+    "install.js"
+  ],
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "optionalDependencies": {
+    "@yossydev/entire-darwin-arm64": "0.5.0",
+    "@yossydev/entire-darwin-x64": "0.5.0",
+    "@yossydev/entire-linux-arm64": "0.5.0",
+    "@yossydev/entire-linux-x64": "0.5.0"
+  }
+}

package/platform.js

@@ -0,0 +1,44 @@
+"use strict";
+
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+const PLATFORMS = {
+  "darwin arm64": "@yossydev/entire-darwin-arm64",
+  "darwin x64": "@yossydev/entire-darwin-x64",
+  "linux arm64": "@yossydev/entire-linux-arm64",
+  "linux x64": "@yossydev/entire-linux-x64",
+};
+
+function pkgForCurrentPlatform() {
+  const key = `${process.platform} ${os.arch()}`;
+  const pkg = PLATFORMS[key];
+  if (!pkg) {
+    throw new Error(
+      `Unsupported platform: ${key}. Entire CLI supports: ${Object.keys(PLATFORMS).join(", ")}`
+    );
+  }
+  return pkg;
+}
+
+function binPathForCurrentPlatform() {
+  const pkg = pkgForCurrentPlatform();
+
+  // Try to resolve from optionalDependencies first
+  try {
+    return require.resolve(`${pkg}/bin/entire`);
+  } catch {
+    // Check if the fallback download placed the binary
+    const downloadedPath = path.join(__dirname, "bin", "entire-binary");
+    if (fs.existsSync(downloadedPath)) {
+      return downloadedPath;
+    }
+    throw new Error(
+      `Could not find the "${pkg}" package. Make sure it is installed. ` +
+        `If you use "--no-optional", run the postinstall script manually: node install.js`
+    );
+  }
+}
+
+module.exports = { pkgForCurrentPlatform, binPathForCurrentPlatform, PLATFORMS };