@fadhilp/lantern 0.0.0-stage → 0.4.0-bootstrap.0

package/bin/binary.js

@@ -0,0 +1,25 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const { platform, arch } = process;
+
+/** Platform directory names to try, best first. A static musl binary also runs on glibc. */
+function candidates() {
+  const base = `${platform}-${arch}`;
+  if (platform === "win32") return [`${base}-msvc`];
+  if (platform !== "linux") return [base];
+  const glibc = process.report?.getReport?.().header?.glibcVersionRuntime;
+  return glibc ? [`${base}-gnu`, `${base}-musl`] : [`${base}-musl`];
+}
+
+// The package holds one directory per platform next to this file.
+function findBinary() {
+  const exe = platform === "win32" ? "lantern.exe" : "lantern";
+  return candidates()
+    .map((directory) => path.join(__dirname, directory, exe))
+    .find((binary) => fs.existsSync(binary));
+}
+
+module.exports = { findBinary };

package/bin/lantern.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const { findBinary } = require("./binary.js");
+
+const binary = findBinary();
+if (!binary) {
+  console.error(
+    `lantern: no prebuilt binary for ${process.platform}-${process.arch}; ` +
+      "install from source with `cargo install --git https://github.com/fadhilp/lantern lantern-cli`",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`lantern: ${result.error.message}`);
+  process.exit(1);
+}
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 1);

package/bin/postinstall.js

@@ -0,0 +1,61 @@
+"use strict";
+
+// On a global npm install, npm's `lantern` command starts Node, which then starts the binary.
+// This script points the command at the binary. If it does nothing or fails, bin/lantern.js still works.
+const fs = require("node:fs");
+const path = require("node:path");
+const { findBinary } = require("./binary.js");
+
+function relinkUnix(prefix, binary) {
+  // The binary path is a real path, so the link directory must be one too, or the relative link is wrong.
+  const directory = fs.realpathSync(path.join(prefix, "bin"));
+  const link = path.join(directory, "lantern");
+  if (!fs.lstatSync(link).isSymbolicLink()) return;
+  const replacement = `${link}.${process.pid}.tmp`;
+  fs.symlinkSync(path.relative(directory, fs.realpathSync(binary)), replacement);
+  // A rename replaces the old link in one step, so the command never goes missing.
+  fs.renameSync(replacement, link);
+}
+
+function rewriteWindowsShims(prefix, binary) {
+  if (!fs.existsSync(path.join(prefix, "lantern.cmd"))) return;
+  const relative = path.relative(prefix, binary);
+  const posixRelative = relative.replaceAll("\\", "/");
+  // npm reads the target back from these files to check that they belong to this package
+  // (read-cmd-shim), so each keeps the shape npm writes: "%~dp0\<path>" %*, "$basedir/<path>" $args,
+  // and "$basedir/<path>" "$@".
+  const shims = {
+    "lantern.cmd": `@ECHO off\r\n"%~dp0\\${relative}" %*\r\n`,
+    // A script in a pipeline gets the piped text in $input; the binary needs it on stdin.
+    "lantern.ps1": [
+      "#!/usr/bin/env pwsh",
+      "$basedir = Split-Path $MyInvocation.MyCommand.Definition -Parent",
+      `if ($MyInvocation.ExpectingInput) { $input | & "$basedir/${posixRelative}" $args } else { & "$basedir/${posixRelative}" $args }`,
+      "exit $LASTEXITCODE",
+      "",
+    ].join("\r\n"),
+    // Git Bash and MSYS run this file, not lantern.cmd. ${0%/*} avoids a dirname process, which is slow on Windows.
+    lantern: [
+      "#!/bin/sh",
+      'case "$0" in */*) basedir="${0%/*}" ;; *) basedir=. ;; esac',
+      `exec "$basedir/${posixRelative}" "$@"`,
+      "",
+    ].join("\n"),
+  };
+  for (const [name, content] of Object.entries(shims)) {
+    fs.writeFileSync(path.join(prefix, name), content);
+  }
+}
+
+const prefix = process.env.npm_config_global_prefix;
+const binary = findBinary();
+const globalNpmInstall = process.env.npm_config_global === "true" && Boolean(prefix);
+
+if (globalNpmInstall && binary) {
+  try {
+    if (process.platform === "win32") rewriteWindowsShims(prefix, binary);
+    else relinkUnix(prefix, binary);
+  } catch (error) {
+    console.error(`lantern: the command will start through Node (${error.message}).`);
+  }
+}

package/package.json

@@ -1,6 +1,23 @@
-{
-  "name": "@fadhilp/lantern",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@fadhilp/lantern",
+  "version": "0.4.0-bootstrap.0",
+  "description": "Read-only code discovery for large codebases",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fadhilp/lantern.git"
+  },
+  "bin": {
+    "lantern": "bin/lantern.js"
+  },
+  "files": [
+    "bin",
+    "skills"
+  ],
+  "scripts": {
+    "postinstall": "node bin/postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.