@volter/world-runtime 3.0.159 → 3.0.161

package/dist/src/pack-facts.d.ts

@@ -74,6 +74,7 @@ export type PackFacts = {
         option: string;
         flag: string;
         path?: string;
+        scheme?: string;
         note: string;
     }>;
     /** R16: the protocol major the package targets and its standing against the kernel that compiled the artifact. */

package/dist/src/runtime.js

@@ -1562,7 +1562,7 @@ async function sidePortsFor(vendor, args, allocatedPorts) {
         const given = at >= 0 ? Number(args[at + 1]) : Number.NaN;
         const pinned = Number.isInteger(given) && given > 0;
         const port = pinned ? given : await allocatePort(allocatedPorts);
-        out.push({ name: side.name, option: side.option, flag: side.flag, port, pinned, url: `http://127.0.0.1:${port}${side.path ?? ''}` });
+        out.push({ name: side.name, option: side.option, flag: side.flag, port, pinned, url: `${side.scheme ?? 'http'}://127.0.0.1:${port}${side.path ?? ''}` });
     }
     return out;
 }

package/dist/src/service-command.d.ts

@@ -0,0 +1,3 @@
+/** Resolve only the known npm Bun layout, never execute or interpret a command
+ *  script. Keep explicit paths, other commands and non-Windows behavior intact. */
+export declare function serviceExecutable(command: string, env: NodeJS.ProcessEnv): string;

package/dist/src/service-command.js

@@ -0,0 +1,38 @@
+// Process services run without a shell. On Windows npm's Bun command is a .cmd
+// shim, whose native package executable must be selected before Node spawns it.
+import { readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const file = (path) => {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+/** Resolve only the known npm Bun layout, never execute or interpret a command
+ *  script. Keep explicit paths, other commands and non-Windows behavior intact. */
+export function serviceExecutable(command, env) {
+    if (process.platform !== 'win32' || command.toLowerCase() !== 'bun')
+        return command;
+    const path = Object.entries(env).find(([key]) => key.toUpperCase() === 'PATH')?.[1] ?? '';
+    const directories = [process.cwd(), ...path.split(';').map((value) => value.replace(/^"(.*)"$/, '$1'))];
+    for (const directory of directories) {
+        const native = resolve(directory, 'bun.exe');
+        if (file(native))
+            return native;
+        if (!file(resolve(directory, 'bun.cmd')))
+            continue;
+        const installed = resolve(directory, 'node_modules', 'bun');
+        const executable = join(installed, 'bin', 'bun.exe');
+        if (!file(executable))
+            continue;
+        try {
+            const manifest = JSON.parse(readFileSync(join(installed, 'package.json'), 'utf8'));
+            if (manifest.name === 'bun' && manifest.bin?.bun === 'bin/bun.exe')
+                return executable;
+        }
+        catch { /* An incomplete installation follows the ordinary spawn-error path. */ }
+    }
+    return command;
+}

package/dist/src/service-recorder.js

@@ -17,6 +17,7 @@
 // The World's NODE_OPTIONS (the injector) is for the service, not this parent: it arrives renamed and is restored.
 import { signalChild } from './process-signal.mjs';
 import { errorMessage } from "./error-message.js";
+import { serviceExecutable } from "./service-command.js";
 import { spawn } from 'node:child_process';
 import { constants } from 'node:os';
 import { appendFileSync, closeSync, fstatSync, openSync, readSync, statSync, truncateSync, writeFileSync } from 'node:fs';
@@ -61,7 +62,7 @@ const record = (entry, then) => {
     process.stdout.write(`${logEnd().atLineStart ? '' : '\n'}${line}`, () => then?.());
 };
 const started = Date.now();
-const child = spawn(command, args, { windowsHide: true, stdio: 'inherit', env });
+const child = spawn(serviceExecutable(command, env), args, { windowsHide: true, stdio: 'inherit', env });
 if (child.pid !== undefined)
     record({ event: 'world.service.started', pid: child.pid, parentPid: process.pid });
 /** The log's last `bytes` (from a line start) as the rotation `<log>.1`: however far a runaway writer overshot the cap,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "3.0.159",
+  "version": "3.0.161",
   "description": "World configs for twins: boot named local runtimes, allocate ports, generate world.env/instance.json, and run apps against fake-key twin worlds.",
   "keywords": [
     "twin",
@@ -70,7 +70,7 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.151",
+    "@volter/world-core": "3.0.153",
     "@volter/world-console": "3.0.150"
   },
   "dependencies": {
@@ -80,7 +80,7 @@
     "@volter/browser-runtime": "0.1.104",
     "@volter/browser-sandboxes": "0.1.84",
     "@volter/world-access": "3.0.1",
-    "@volter/world-core": "3.0.151",
+    "@volter/world-core": "3.0.153",
     "modern-screenshot": "4.7.0",
     "mongodb": "~6.20.0",
     "pg-gateway": "0.3.0-beta.4",

package/src/pack-facts.ts

@@ -38,7 +38,7 @@ export type PackFacts = {
   /** The World's managed database the runtime binds the twin to at boot (TwinPack.managedDatabase). */
   managedDatabase?: { kind: 'postgres'; arg: string; note: string };
   /** Listeners the twin opens beside its main port, allocated and recorded by the runtime (TwinPack.sidePorts). */
-  sidePorts?: Array<{ name: string; option: string; flag: string; path?: string; note: string }>;
+  sidePorts?: Array<{ name: string; option: string; flag: string; path?: string; scheme?: string; note: string }>;
   /** R16: the protocol major the package targets and its standing against the kernel that compiled the artifact. */
   protocol?: { declared?: string; major: number; standing: 'current' | 'deprecated' | 'refused' | 'assumed' };
 };

package/src/runtime.ts

@@ -1535,7 +1535,7 @@ async function sidePortsFor(vendor: string, args: readonly string[], allocatedPo
     const given = at >= 0 ? Number(args[at + 1]) : Number.NaN;
     const pinned = Number.isInteger(given) && given > 0;
     const port = pinned ? given : await allocatePort(allocatedPorts);
-    out.push({ name: side.name, option: side.option, flag: side.flag, port, pinned, url: `http://127.0.0.1:${port}${side.path ?? ''}` });
+    out.push({ name: side.name, option: side.option, flag: side.flag, port, pinned, url: `${side.scheme ?? 'http'}://127.0.0.1:${port}${side.path ?? ''}` });
   }
   return out;
 }

package/src/service-command.ts

@@ -0,0 +1,29 @@
+// Process services run without a shell. On Windows npm's Bun command is a .cmd
+// shim, whose native package executable must be selected before Node spawns it.
+import { readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+const file = (path: string): boolean => {
+  try { return statSync(path).isFile(); } catch { return false; }
+};
+
+/** Resolve only the known npm Bun layout, never execute or interpret a command
+ *  script. Keep explicit paths, other commands and non-Windows behavior intact. */
+export function serviceExecutable(command: string, env: NodeJS.ProcessEnv): string {
+  if (process.platform !== 'win32' || command.toLowerCase() !== 'bun') return command;
+  const path = Object.entries(env).find(([key]) => key.toUpperCase() === 'PATH')?.[1] ?? '';
+  const directories = [process.cwd(), ...path.split(';').map((value) => value.replace(/^"(.*)"$/, '$1'))];
+  for (const directory of directories) {
+    const native = resolve(directory, 'bun.exe');
+    if (file(native)) return native;
+    if (!file(resolve(directory, 'bun.cmd'))) continue;
+    const installed = resolve(directory, 'node_modules', 'bun');
+    const executable = join(installed, 'bin', 'bun.exe');
+    if (!file(executable)) continue;
+    try {
+      const manifest = JSON.parse(readFileSync(join(installed, 'package.json'), 'utf8')) as { name?: unknown; bin?: { bun?: unknown } };
+      if (manifest.name === 'bun' && manifest.bin?.bun === 'bin/bun.exe') return executable;
+    } catch { /* An incomplete installation follows the ordinary spawn-error path. */ }
+  }
+  return command;
+}

package/src/service-recorder.ts

@@ -17,6 +17,7 @@
 // The World's NODE_OPTIONS (the injector) is for the service, not this parent: it arrives renamed and is restored.
 import { signalChild } from './process-signal.mjs';
 import { errorMessage } from './error-message.ts';
+import { serviceExecutable } from './service-command.ts';
 import { spawn } from 'node:child_process';
 import { constants } from 'node:os';
 import { appendFileSync, closeSync, fstatSync, openSync, readSync, statSync, truncateSync, writeFileSync } from 'node:fs';
@@ -48,7 +49,7 @@ const record = (entry: Record<string, unknown>, then?: () => void): void => {
 };
 
 const started = Date.now();
-const child = spawn(command, args, { windowsHide: true, stdio: 'inherit', env });
+const child = spawn(serviceExecutable(command, env), args, { windowsHide: true, stdio: 'inherit', env });
 if (child.pid !== undefined) record({ event: 'world.service.started', pid: child.pid, parentPid: process.pid });
 
 /** The log's last `bytes` (from a line start) as the rotation `<log>.1`: however far a runaway writer overshot the cap,