@astrale-os/sdk 0.5.0-beta.41 → 0.5.0-beta.43

package/dist/tooling/cli/bun.d.ts

@@ -10,3 +10,5 @@ export type BunOutcome = {
 };
 /** Re-enter the published executable under Bun only when authored TypeScript must be imported. */
 export declare function runWithBun(executable: string, argv: readonly string[]): Promise<BunOutcome>;
+/** Prefer the generated project's exact Bun package binary over an ambient executable or shim. */
+export declare function resolveBunExecutable(cwd: string): string;

package/dist/tooling/cli/bun.js

@@ -1,4 +1,7 @@
 import { spawn } from 'node:child_process';
+import { lstatSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
 const FORWARDED_SIGNALS = ['SIGINT', 'SIGTERM'];
 export class BunRequiredError extends Error {
     constructor(options) {
@@ -9,7 +12,9 @@ export class BunRequiredError extends Error {
 /** Re-enter the published executable under Bun only when authored TypeScript must be imported. */
 export function runWithBun(executable, argv) {
     return new Promise((resolve, reject) => {
-        const child = spawn('bun', [executable, ...argv], { stdio: 'inherit' });
+        const child = spawn(resolveBunExecutable(process.cwd()), [executable, ...argv], {
+            stdio: 'inherit',
+        });
         const handlers = FORWARDED_SIGNALS.map((signal) => [signal, () => child.kill(signal)]);
         for (const [signal, handler] of handlers)
             process.on(signal, handler);
@@ -35,3 +40,62 @@ export function runWithBun(executable, argv) {
         });
     });
 }
+/** Prefer the generated project's exact Bun package binary over an ambient executable or shim. */
+export function resolveBunExecutable(cwd) {
+    const projectRequire = createRequire(join(cwd, 'package.json'));
+    let manifestPath;
+    try {
+        manifestPath = projectRequire.resolve('bun/package.json');
+    }
+    catch (cause) {
+        if (isMissingPackage(cause) && !hasBunPackageEntry(projectRequire))
+            return 'bun';
+        throw new BunRequiredError({ cause });
+    }
+    try {
+        const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+        const declared = typeof manifest.bin === 'string' ? manifest.bin : manifest.bin?.bun;
+        if (typeof declared !== 'string' || declared.length === 0 || isAbsolute(declared)) {
+            throw new Error('The project-local Bun package has an invalid bun binary declaration.');
+        }
+        const root = dirname(manifestPath);
+        const candidate = resolve(root, declared);
+        const physicalRoot = realpathSync(root);
+        const physicalCandidate = realpathSync(candidate);
+        const fromRoot = relative(physicalRoot, physicalCandidate);
+        if (fromRoot === '' || fromRoot.startsWith('..') || isAbsolute(fromRoot)) {
+            throw new Error('The project-local Bun binary escapes its package directory.');
+        }
+        if (!statSync(physicalCandidate).isFile()) {
+            throw new Error('The project-local Bun binary is not a regular file.');
+        }
+        return physicalCandidate;
+    }
+    catch (cause) {
+        throw new BunRequiredError({ cause });
+    }
+}
+function hasBunPackageEntry(projectRequire) {
+    for (const searchRoot of projectRequire.resolve.paths('bun') ?? []) {
+        try {
+            lstatSync(join(searchRoot, 'bun'));
+            return true;
+        }
+        catch (error) {
+            if (!isMissingEntry(error))
+                throw error;
+        }
+    }
+    return false;
+}
+function isMissingEntry(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        (error.code === 'ENOENT' ||
+            error.code === 'ENOTDIR'));
+}
+function isMissingPackage(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        error.code === 'MODULE_NOT_FOUND');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/sdk",
-  "version": "0.5.0-beta.41",
+  "version": "0.5.0-beta.43",
   "description": "Schema-first SDK for defining, composing, and deploying Astrale domains",
   "keywords": [
     "astrale",