@vibecook/ghosttead 0.5.1 → 0.6.0

package/README.md

@@ -32,5 +32,15 @@ supported targets and the `GHOSTTEAD_BIN` way out.
 ## Bundlers
 
 Resolution walks `node_modules` at runtime. An Electron main process that
-bundles its dependencies should keep this package external, or resolve the
-path at build time and carry it into the bundle.
+bundles its dependencies should keep this package external — the exports map
+carries a `require` condition, so a CommonJS bundle can `require()` it on
+Node 22.12+ — or call `ghostteadPath()` at build time and stage the binary
+beside the bundle, which a packaged application needs to do anyway.
+
+The resolver also tolerates being inlined: when the direct walk finds
+nothing — the platform packages are dependencies of this package, and
+pnpm's layout makes them visible only from beside its real directory — it
+locates the installed `@vibecook/ghosttead` from the bundle's own position
+and resolves the platform package from there. When even that fails, the
+error names bundling as the cause instead of a missing package. External
+remains the recommendation; it keeps resolution on Node's own semantics.

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export interface ResolveGhostteadOptions {
     env?: Readonly<Record<string, string | undefined>>;
     /** Defaults to resolving from this package; injectable so tests reach every failure without a registry. */
     resolvePackage?: (specifier: string) => string;
+    /** Defaults to `import.meta.url`; injectable so tests can stand where a bundler would put this code. */
+    resolutionBase?: string | URL;
 }
 /**
  * Absolute path of the daemon for the current platform.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAyD,CAAC;AAEzG,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,2GAA2G;IAC3G,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAqC3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAyD,CAAC;AAEzG,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,2GAA2G;IAC3G,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAC/B;AAsED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAoC3E"}

package/dist/index.js

@@ -5,12 +5,13 @@
  * carry it everywhere: each supported target ships in its own npm package,
  * gated by `os`/`cpu`, and installing this package pulls exactly the one
  * that matches. This module names the installed binary — or says precisely
- * which of the three possible reasons it cannot: the platform has no
- * prebuild, the optional dependency was pruned, or the platform package is
- * present with nothing staged into it, a state that exists only inside the
- * Ghosttea repository where these packages are workspace links.
+ * which of the four possible reasons it cannot: the platform has no
+ * prebuild, a bundler inlined this resolver and severed its view of
+ * `node_modules`, the optional dependency was pruned, or the platform
+ * package is present with nothing staged into it, a state that exists only
+ * inside the Ghosttea repository where these packages are workspace links.
  */
-import { existsSync } from "node:fs";
+import { existsSync, realpathSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 /** Platform packages keyed by `${platform}-${arch}` — the targets release CI builds and validates. */
@@ -20,7 +21,69 @@ const PLATFORM_PACKAGES = Object.freeze({
 });
 /** Targets a prebuilt daemon exists for. */
 export const SUPPORTED_TARGETS = Object.freeze(Object.keys(PLATFORM_PACKAGES).sort());
-const defaultResolvePackage = (specifier) => createRequire(import.meta.url).resolve(specifier);
+function notInstalled(packageName, cause) {
+    return new Error(`${packageName} is not installed. It arrives as an optional dependency of @vibecook/ghosttead, so an ` +
+        "install that skips optional dependencies loses the daemon; reinstall with them enabled or set GHOSTTEAD_BIN.", { cause });
+}
+function inlinedByBundler(packageName, cause) {
+    return new Error(`${packageName} cannot be resolved, and no reachable node_modules contains @vibecook/ghosttead either — ` +
+        "the signature of this resolver having been inlined into a bundle, which severs the node_modules walk " +
+        "it depends on. Mark @vibecook/ghosttead external in the bundler (see its README) or set GHOSTTEAD_BIN.", { cause });
+}
+/**
+ * The platform package's manifest path, resolved the way installs actually
+ * lay packages out.
+ *
+ * The platform packages are dependencies of this package, not of the
+ * consumer, and pnpm's strict layout makes them visible only from beside
+ * this package's real directory. From the unbundled module that is one
+ * resolution — but a bundler that inlines this code moves it into the
+ * consumer's output, where the direct walk finds nothing. The consumer does
+ * depend on `@vibecook/ghosttead`, so its installed directory is usually
+ * still reachable from the bundle; resolving the platform package from that
+ * directory's real path restores exactly the walk the unbundled module
+ * would have done. The lookup scans `require.resolve.paths()` by hand
+ * because this package's `exports` map would otherwise stand between a
+ * `require`-based probe and its own `package.json`.
+ *
+ * A base that cannot see even `@vibecook/ghosttead` is not a layout problem
+ * at all, and is reported as what it is: bundling without `external`.
+ */
+function resolveInstalledManifest(packageName, base) {
+    let requireFromBase;
+    try {
+        requireFromBase = createRequire(base);
+    }
+    catch (cause) {
+        // A bundler that erased `import.meta.url` outright lands here.
+        throw inlinedByBundler(packageName, cause);
+    }
+    let directFailure;
+    try {
+        return requireFromBase.resolve(`${packageName}/package.json`);
+    }
+    catch (error) {
+        directFailure = error;
+    }
+    let selfManifest;
+    for (const directory of requireFromBase.resolve.paths("@vibecook/ghosttead") ?? []) {
+        const candidate = join(directory, "@vibecook", "ghosttead", "package.json");
+        if (existsSync(candidate)) {
+            // Follow the package manager's link so the sibling walk starts from
+            // the store directory that actually holds the platform packages.
+            selfManifest = realpathSync(candidate);
+            break;
+        }
+    }
+    if (!selfManifest)
+        throw inlinedByBundler(packageName, directFailure);
+    try {
+        return createRequire(selfManifest).resolve(`${packageName}/package.json`);
+    }
+    catch (cause) {
+        throw notInstalled(packageName, cause);
+    }
+}
 /**
  * Absolute path of the daemon for the current platform.
  *
@@ -33,7 +96,6 @@ export function ghostteadPath(options = {}) {
     const platform = options.platform ?? process.platform;
     const arch = options.arch ?? process.arch;
     const env = options.env ?? process.env;
-    const resolvePackage = options.resolvePackage ?? defaultResolvePackage;
     const override = env.GHOSTTEAD_BIN;
     if (override)
         return override;
@@ -44,12 +106,16 @@ export function ghostteadPath(options = {}) {
             "Set GHOSTTEAD_BIN to a daemon built from source to run on this platform.");
     }
     let manifest;
-    try {
-        manifest = resolvePackage(`${packageName}/package.json`);
+    if (options.resolvePackage) {
+        try {
+            manifest = options.resolvePackage(`${packageName}/package.json`);
+        }
+        catch (cause) {
+            throw notInstalled(packageName, cause);
+        }
     }
-    catch (cause) {
-        throw new Error(`${packageName} is not installed. It arrives as an optional dependency of @vibecook/ghosttead, so an ` +
-            "install that skips optional dependencies loses the daemon; reinstall with them enabled or set GHOSTTEAD_BIN.", { cause });
+    else {
+        manifest = resolveInstalledManifest(packageName, options.resolutionBase ?? import.meta.url);
     }
     const binary = join(dirname(manifest), "bin", platform === "win32" ? "ghosttead.exe" : "ghosttead");
     if (!existsSync(binary)) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,sGAAsG;AACtG,MAAM,iBAAiB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACxE,cAAc,EAAE,kCAAkC;IAClD,WAAW,EAAE,+BAA+B;CAC7C,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAazG,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAE/G;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAA4B,EAAE;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,qBAAqB,CAAC;IAEvE,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC;IACnC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,yBAAyB,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;YACxG,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,cAAc,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,wFAAwF;YACpG,8GAA8G,EAChH,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACpG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,iBAAiB,MAAM,+DAA+D;YAClG,8GAA8G,CACjH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,sGAAsG;AACtG,MAAM,iBAAiB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACxE,cAAc,EAAE,kCAAkC;IAClD,WAAW,EAAE,+BAA+B;CAC7C,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAezG,SAAS,YAAY,CAAC,WAAmB,EAAE,KAAc;IACvD,OAAO,IAAI,KAAK,CACd,GAAG,WAAW,wFAAwF;QACpG,8GAA8G,EAChH,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB,EAAE,KAAc;IAC3D,OAAO,IAAI,KAAK,CACd,GAAG,WAAW,2FAA2F;QACvG,uGAAuG;QACvG,wGAAwG,EAC1G,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAS,wBAAwB,CAAC,WAAmB,EAAE,IAAkB;IACvE,IAAI,eAAiD,CAAC;IACtD,IAAI,CAAC;QACH,eAAe,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+DAA+D;QAC/D,MAAM,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,aAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,IAAI,YAAgC,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC;QACnF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;QAC5E,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,oEAAoE;YACpE,iEAAiE;YACjE,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,CAAC,YAAY;QAAE,MAAM,gBAAgB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAA4B,EAAE;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAEvC,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC;IACnC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,yBAAyB,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;YACxG,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,wBAAwB,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACpG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,iBAAiB,MAAM,+DAA+D;YAClG,8GAA8G,CACjH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecook/ghosttead",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Prebuilt Ghosttea terminal daemon, resolved to the binary for the current platform.",
   "license": "MIT",
   "author": "James Yong",
@@ -11,7 +11,8 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
     }
   },
   "files": [
@@ -47,8 +48,8 @@
     "prepublishOnly": "npm run build"
   },
   "optionalDependencies": {
-    "@vibecook/ghosttead-darwin-arm64": "0.5.1",
-    "@vibecook/ghosttead-win32-x64": "0.5.1"
+    "@vibecook/ghosttead-darwin-arm64": "0.6.0",
+    "@vibecook/ghosttead-win32-x64": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "26.1.1",