@rbbtsn0w/idocs 0.1.0-beta.1

package/README.md

@@ -0,0 +1,37 @@
+# idocs-cli (npm wrapper)
+
+This package distributes the `idocs` Swift CLI through npm.
+
+## Install
+
+```bash
+npm install -g idocs-cli
+```
+
+By default, `postinstall` downloads `idocs-darwin-arm64.tar.gz` from:
+
+`https://github.com/OWNER/REPO/releases/download/v{version}`
+
+Override the release URL if needed:
+
+```bash
+export IDOCS_RELEASE_BASE_URL="https://github.com/<owner>/<repo>/releases/download/v{version}"
+npm install -g idocs-cli
+```
+
+The archive is expected to contain:
+- `idocs-darwin-arm64/idocs`
+- `idocs-darwin-arm64/Frameworks/*.framework`
+
+## Local development
+
+```bash
+./scripts/tuist-silent.sh build iDocs
+npm --prefix npm run link-local
+npm --prefix npm link
+idocs --help
+```
+
+## Strict install mode
+
+Set `IDOCS_NPM_STRICT_INSTALL=1` to fail install when binary download fails.

package/bin/idocs.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { chmodSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const binaryPath = resolve(here, "../dist/idocs");
+const frameworksPath = resolve(here, "../dist/Frameworks");
+
+if (!existsSync(binaryPath)) {
+  console.error("iDocs binary not found at npm/dist/idocs.");
+  console.error("Try one of the following:");
+  console.error("  1) npm --prefix npm run fetch-binary");
+  console.error("  2) export IDOCS_RELEASE_BASE_URL='https://github.com/<owner>/<repo>/releases/download/v{version}'");
+  console.error("  3) npm --prefix npm run link-local");
+  process.exit(1);
+}
+
+try {
+  chmodSync(binaryPath, 0o755);
+} catch {
+  // Best effort.
+}
+
+const frameworkEnv = process.env.DYLD_FRAMEWORK_PATH
+  ? `${frameworksPath}:${process.env.DYLD_FRAMEWORK_PATH}`
+  : frameworksPath;
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    DYLD_FRAMEWORK_PATH: frameworkEnv
+  }
+});
+if (typeof result.status === "number") {
+  process.exit(result.status);
+}
+
+if (result.error) {
+  console.error(`Failed to execute iDocs binary: ${result.error.message}`);
+}
+process.exit(1);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@rbbtsn0w/idocs",
+  "version": "0.1.0-beta.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "npm distribution wrapper for the iDocs Swift CLI",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RbBtSn0w/Apple-iDocs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RbBtSn0w/Apple-iDocs/issues"
+  },
+  "homepage": "https://github.com/RbBtSn0w/Apple-iDocs#readme",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "idocs": "./bin/idocs.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.mjs",
+    "fetch-binary": "node ./scripts/postinstall.mjs --force",
+    "link-local": "node ./scripts/link-local.mjs",
+    "smoke": "idocs --help"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/scripts/link-local.mjs

@@ -0,0 +1,65 @@
+import { chmodSync, copyFileSync, cpSync, existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const npmRoot = resolve(here, "..");
+const repoRoot = resolve(npmRoot, "..");
+const distDir = resolve(npmRoot, "dist");
+const targetPath = resolve(distDir, "idocs");
+const frameworksTargetDir = resolve(distDir, "Frameworks");
+
+function info(msg) {
+  console.log(`[idocs-cli] ${msg}`);
+}
+
+function findFromDerivedData() {
+  const command = "find \"$HOME/Library/Developer/Xcode/DerivedData\" -path \"*/Build/Products/Debug/idocs\" -type f 2>/dev/null | head -n 1";
+  const result = spawnSync("bash", ["-lc", command], { encoding: "utf8" });
+  if (result.status !== 0) return null;
+  const value = result.stdout.trim();
+  return value.length > 0 ? value : null;
+}
+
+function resolveLocalBinary() {
+  const envPath = process.env.IDOCS_LOCAL_BINARY;
+  if (envPath && existsSync(envPath)) return envPath;
+
+  const candidates = [
+    resolve(process.env.HOME ?? "", "Library", "Developer", "Xcode", "DerivedData", "iDocs-codex", "Build", "Products", "Debug", "idocs"),
+    resolve(repoRoot, "build", "Debug", "idocs"),
+    resolve(repoRoot, ".build", "release", "iDocs"),
+    resolve(repoRoot, ".build", "debug", "iDocs")
+  ];
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) return candidate;
+  }
+
+  return findFromDerivedData();
+}
+
+const sourcePath = resolveLocalBinary();
+if (!sourcePath) {
+  console.error("[idocs-cli] Could not locate a local iDocs binary.");
+  console.error("[idocs-cli] Build first: ./scripts/tuist-silent.sh build iDocs");
+  console.error("[idocs-cli] Or set IDOCS_LOCAL_BINARY=/absolute/path/to/idocs");
+  process.exit(1);
+}
+
+mkdirSync(distDir, { recursive: true });
+copyFileSync(sourcePath, targetPath);
+chmodSync(targetPath, 0o755);
+
+const sourceDir = dirname(sourcePath);
+rmSync(frameworksTargetDir, { recursive: true, force: true });
+mkdirSync(frameworksTargetDir, { recursive: true });
+
+for (const entry of readdirSync(sourceDir)) {
+  if (!entry.endsWith(".framework")) continue;
+  cpSync(resolve(sourceDir, entry), resolve(frameworksTargetDir, entry), { recursive: true });
+}
+
+info(`Linked local binary: ${sourcePath} -> ${targetPath}`);
+info(`Copied local frameworks from: ${sourceDir} -> ${frameworksTargetDir}`);

package/scripts/postinstall.mjs

@@ -0,0 +1,119 @@
+import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const npmRoot = resolve(here, "..");
+const distDir = resolve(npmRoot, "dist");
+const binaryPath = resolve(distDir, "idocs");
+const frameworksPath = resolve(distDir, "Frameworks");
+const tmpArchive = resolve(distDir, "idocs-darwin-arm64.tar.gz");
+const force = process.argv.includes("--force");
+const strictInstall = process.env.IDOCS_NPM_STRICT_INSTALL === "1";
+
+function log(msg) {
+  console.log(`[@rbbtsn0w/idocs] ${msg}`);
+}
+
+function fail(msg, err) {
+  console.error(`[@rbbtsn0w/idocs] ${msg}`);
+  if (err?.message) {
+    console.error(`[@rbbtsn0w/idocs] ${err.message}`);
+  }
+  if (strictInstall) {
+    process.exit(1);
+  }
+}
+
+function getVersion() {
+  const pkg = JSON.parse(readFileSync(resolve(npmRoot, "package.json"), "utf8"));
+  return pkg.version;
+}
+
+function releaseBaseURL(version) {
+  const configured = process.env.IDOCS_RELEASE_BASE_URL;
+  if (configured && configured.trim().length > 0) {
+    return configured.replaceAll("{version}", version);
+  }
+  return `https://github.com/RbBtSn0w/Apple-iDocs/releases/download/v${version}`;
+}
+
+function normalizeExtractedLayout(root) {
+  const bundleDir = resolve(root, "idocs-darwin-arm64");
+  if (!existsSync(bundleDir)) {
+    return;
+  }
+
+  if (existsSync(resolve(bundleDir, "idocs"))) {
+    cpSync(resolve(bundleDir, "idocs"), binaryPath);
+  }
+
+  const frameworksDir = resolve(bundleDir, "Frameworks");
+  if (existsSync(frameworksDir)) {
+    rmSync(frameworksPath, { recursive: true, force: true });
+    cpSync(frameworksDir, frameworksPath, { recursive: true });
+  }
+
+  rmSync(bundleDir, { recursive: true, force: true });
+}
+
+async function main() {
+  mkdirSync(distDir, { recursive: true });
+
+  if (process.env.IDOCS_LOCAL_BINARY && existsSync(process.env.IDOCS_LOCAL_BINARY)) {
+    log("IDOCS_LOCAL_BINARY found; skipping download.");
+    return;
+  }
+
+  if (!force && existsSync(binaryPath)) {
+    chmodSync(binaryPath, 0o755);
+    log("Binary already present; skipping download.");
+    return;
+  }
+
+  const version = getVersion();
+  const assetName = "idocs-darwin-arm64.tar.gz";
+  const url = `${releaseBaseURL(version)}/${assetName}`;
+
+  log(`Downloading ${assetName} from ${url}`);
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status} when downloading ${url}`);
+    }
+
+    const data = Buffer.from(await response.arrayBuffer());
+    writeFileSync(tmpArchive, data);
+
+    const extract = spawnSync("tar", ["-xzf", tmpArchive, "-C", distDir], { stdio: "pipe" });
+    if (extract.status !== 0) {
+      throw new Error(`tar extraction failed: ${extract.stderr.toString("utf8").trim()}`);
+    }
+
+    normalizeExtractedLayout(distDir);
+
+    if (!existsSync(binaryPath)) {
+      throw new Error("archive extracted but npm/dist/idocs not found");
+    }
+
+    if (!existsSync(frameworksPath)) {
+      const entries = readdirSync(distDir).filter((item) => item.endsWith(".framework"));
+      if (entries.length > 0) {
+        mkdirSync(frameworksPath, { recursive: true });
+        for (const entry of entries) {
+          cpSync(resolve(distDir, entry), resolve(frameworksPath, entry), { recursive: true });
+          rmSync(resolve(distDir, entry), { recursive: true, force: true });
+        }
+      }
+    }
+
+    chmodSync(binaryPath, 0o755);
+    unlinkSync(tmpArchive);
+    log("Binary installed successfully.");
+  } catch (error) {
+    fail("Binary download failed. Install will continue in non-strict mode.", error);
+  }
+}
+
+main();