@gjsify/process 0.30.0 → 0.31.0

package/lib/esm/internal/detect.js

@@ -1 +1 @@
-import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";import{probeUname as t}from"./uname.js";function detectGjsVersion(){try{let t=e().imports?.system;if(t?.version!==void 0){let e=Number(t.version);return`${Math.floor(e/1e4)}.${Math.floor(e%1e4/100)}.${e%100}`}}catch{}}function detectNodeVersion(){if(typeof globalThis.process?.versions?.node==`string`)return globalThis.process.versions.node}function detectVersionInfo(){if(detectNodeVersion())return{version:globalThis.process.version,versions:{...globalThis.process.versions},title:globalThis.process?.title||`node`};let e=detectGjsVersion(),t={node:`20.0.0`};return e&&(t.gjs=e),{version:`v20.0.0`,versions:t,title:`gjs`}}function detectPpid(){if(typeof globalThis.process?.ppid==`number`)return globalThis.process.ppid;try{let t=e().imports?.gi?.GLib;if(t){let[,e]=t.file_get_contents(`/proc/self/status`);if(e){let t=new TextDecoder().decode(e).match(/PPid:\s+(\d+)/);if(t)return parseInt(t[1],10)}}}catch{}return 0}function onGjs(){try{return e().imports?.gi!==void 0}catch{return!1}}function detectPlatform(){if(onGjs()){let e=t();return e?e.platform:`linux`}let e=globalThis.process;return typeof e?.platform==`string`?e.platform:`linux`}function detectArch(){if(onGjs()){let e=t();return e?e.arch:`x64`}let e=globalThis.process;return typeof e?.arch==`string`?e.arch:`x64`}function getPid(){if(typeof globalThis.process?.pid==`number`)return globalThis.process.pid;try{let t=e().imports?.gi?.GLib;if(t){let[,e]=t.file_get_contents(`/proc/self/stat`);if(e){let t=new TextDecoder().decode(e),n=parseInt(t,10);if(!isNaN(n))return n}}}catch{}return 0}export{detectArch,detectGjsVersion,detectNodeVersion,detectPlatform,detectPpid,detectVersionInfo,getPid};
+import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";import{probeUname as t}from"./uname.js";import{hostPid as n,hostPpid as r}from"@gjsify/utils/core";function detectGjsVersion(){try{let t=e().imports?.system;if(t?.version!==void 0){let e=Number(t.version);return`${Math.floor(e/1e4)}.${Math.floor(e%1e4/100)}.${e%100}`}}catch{}}function detectNodeVersion(){if(typeof globalThis.process?.versions?.node==`string`)return globalThis.process.versions.node}function detectVersionInfo(){if(detectNodeVersion())return{version:globalThis.process.version,versions:{...globalThis.process.versions},title:globalThis.process?.title||`node`};let e=detectGjsVersion(),t={node:`20.0.0`};return e&&(t.gjs=e),{version:`v20.0.0`,versions:t,title:`gjs`}}function detectPpid(){return!onGjs()&&typeof globalThis.process?.ppid==`number`?globalThis.process.ppid:r()??0}function onGjs(){try{return e().imports?.gi!==void 0}catch{return!1}}function detectPlatform(){if(onGjs()){let e=t();return e?e.platform:`linux`}let e=globalThis.process;return typeof e?.platform==`string`?e.platform:`linux`}function detectArch(){if(onGjs()){let e=t();return e?e.arch:`x64`}let e=globalThis.process;return typeof e?.arch==`string`?e.arch:`x64`}function getPid(){return!onGjs()&&typeof globalThis.process?.pid==`number`?globalThis.process.pid:n()??0}export{detectArch,detectGjsVersion,detectNodeVersion,detectPlatform,detectPpid,detectVersionInfo,getPid};

package/lib/esm/internal/env.js

@@ -1 +1 @@
-import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";function getEnvProxy(){if(typeof globalThis.process?.env==`object`)return globalThis.process.env;try{let t=e().imports?.gi?.GLib;if(t)return new Proxy({},{get(e,n){if(typeof n==`string`)return t.getenv(n)??void 0},set(e,n,r){return typeof n==`string`?(t.setenv(n,String(r),!0),!0):!1},deleteProperty(e,n){return typeof n==`string`?(t.unsetenv(n),!0):!1},has(e,n){return typeof n==`string`?t.getenv(n)!==null:!1},ownKeys(e){return t.listenv()},getOwnPropertyDescriptor(e,n){if(typeof n!=`string`)return;let r=t.getenv(n);if(r!==null)return{configurable:!0,enumerable:!0,writable:!0,value:r}}})}catch{}return{}}function getArgv(){if(globalThis.process?.argv!==void 0)return globalThis.process.argv;try{let t=e().imports?.system;if(t?.programArgs)return[`gjs`,t.programInvocationName||``,...t.programArgs]}catch{}return[`gjs`]}function getExecPath(){if(typeof globalThis.process?.execPath==`string`)return globalThis.process.execPath;try{let t=e().imports?.system;if(t?.programInvocationName)return t.programInvocationName}catch{}return`/usr/bin/gjs`}function getCwd(){try{let t=e().imports?.gi?.GLib;if(t?.get_current_dir)return t.get_current_dir()}catch{}return`/`}function chdir(t){let n=e().imports?.gi?.GLib;try{if(n?.chdir){if(!n.file_test(t,16)){let e=Error(`ENOENT: no such file or directory, chdir '${t}'`);throw e.code=`ENOENT`,e.syscall=`chdir`,e.path=t,e}n.chdir(t);return}}catch(e){if(e&&typeof e==`object`&&e.code===`ENOENT`)throw e}if(!n){let e=globalThis.process;if(e&&typeof e.chdir==`function`){e.chdir(t);return}}throw Error(`process.chdir() is not supported in this environment`)}export{chdir,getArgv,getCwd,getEnvProxy,getExecPath};
+import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";import{hostExecPath as t}from"@gjsify/utils/core";function getEnvProxy(){if(typeof globalThis.process?.env==`object`)return globalThis.process.env;try{let t=e().imports?.gi?.GLib;if(t)return new Proxy({},{get(e,n){if(typeof n==`string`)return t.getenv(n)??void 0},set(e,n,r){return typeof n==`string`?(t.setenv(n,String(r),!0),!0):!1},deleteProperty(e,n){return typeof n==`string`?(t.unsetenv(n),!0):!1},has(e,n){return typeof n==`string`?t.getenv(n)!==null:!1},ownKeys(e){return t.listenv()},getOwnPropertyDescriptor(e,n){if(typeof n!=`string`)return;let r=t.getenv(n);if(r!==null)return{configurable:!0,enumerable:!0,writable:!0,value:r}}})}catch{}return{}}function getArgv(){if(globalThis.process?.argv!==void 0)return globalThis.process.argv;try{let t=e().imports?.system;if(t?.programArgs)return[`gjs`,t.programInvocationName||``,...t.programArgs]}catch{}return[`gjs`]}function getExecPath(){let e=globalThis.process;return!isGjsHost()&&typeof e?.execPath==`string`?e.execPath:t()??`/usr/bin/gjs`}function isGjsHost(){try{return e().imports?.gi!==void 0}catch{return!1}}function getCwd(){try{let t=e().imports?.gi?.GLib;if(t?.get_current_dir)return t.get_current_dir()}catch{}return`/`}function chdir(t){let n=e().imports?.gi?.GLib;try{if(n?.chdir){if(!n.file_test(t,16)){let e=Error(`ENOENT: no such file or directory, chdir '${t}'`);throw e.code=`ENOENT`,e.syscall=`chdir`,e.path=t,e}n.chdir(t);return}}catch(e){if(e&&typeof e==`object`&&e.code===`ENOENT`)throw e}if(!n){let e=globalThis.process;if(e&&typeof e.chdir==`function`){e.chdir(t);return}}throw Error(`process.chdir() is not supported in this environment`)}export{chdir,getArgv,getCwd,getEnvProxy,getExecPath};

package/lib/esm/internal/system.js

@@ -1 +1 @@
-import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";function isGjs(){return e().imports?.gi?.GLib!==void 0}function killPid(t,n){try{let r=e().imports?.gi?.GLib;if(r){let e=typeof n==`number`?String(n):n||`SIGTERM`,i=e.startsWith(`SIG`)?`-${e.slice(3)}`:`-${e}`;return r.spawn_command_line_sync(`kill ${i} ${t}`),!0}}catch{}if(!isGjs()){let e=globalThis.process;if(e&&typeof e.kill==`function`)return e.kill(t,n)}throw Error(`process.kill() is not supported in this environment`)}function memoryUsage(){try{let t=e().imports?.gi?.GLib;if(t){let[,e]=t.file_get_contents(`/proc/self/status`);if(e){let t=new TextDecoder().decode(e).match(/VmRSS:\s+(\d+)/),n=t?parseInt(t[1],10)*1024:0;return{rss:n,heapTotal:n,heapUsed:n,external:0,arrayBuffers:0}}}}catch{}if(!isGjs()){let e=globalThis.process;if(e&&typeof e.memoryUsage==`function`)return e.memoryUsage()}return{rss:0,heapTotal:0,heapUsed:0,external:0,arrayBuffers:0}}function cpuUsage(e){if(!isGjs()){let t=globalThis.process;if(t&&typeof t.cpuUsage==`function`)return t.cpuUsage(e)}return{user:0,system:0}}export{cpuUsage,killPid,memoryUsage};
+import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";import{readProcessMemory as t}from"@gjsify/utils/core";function isGjs(){return e().imports?.gi?.GLib!==void 0}function killPid(t,n){try{let r=e().imports?.gi?.GLib;if(r){let e=typeof n==`number`?String(n):n||`SIGTERM`,i=e.startsWith(`SIG`)?`-${e.slice(3)}`:`-${e}`;return r.spawn_command_line_sync(`kill ${i} ${t}`),!0}}catch{}if(!isGjs()){let e=globalThis.process;if(e&&typeof e.kill==`function`)return e.kill(t,n)}throw Error(`process.kill() is not supported in this environment`)}function memoryUsage(){let e=t();if(e)return{rss:e.resident,heapTotal:e.resident,heapUsed:e.resident,external:0,arrayBuffers:0};if(!isGjs()){let e=globalThis.process;if(e&&typeof e.memoryUsage==`function`)return e.memoryUsage()}return{rss:0,heapTotal:0,heapUsed:0,external:0,arrayBuffers:0}}function cpuUsage(e){if(!isGjs()){let t=globalThis.process;if(t&&typeof t.cpuUsage==`function`)return t.cpuUsage(e)}return{user:0,system:0}}export{cpuUsage,killPid,memoryUsage};

package/lib/types/internal/env.d.ts

@@ -1,5 +1,24 @@
 export declare function getEnvProxy(): Record<string, string | undefined>;
 export declare function getArgv(): string[];
+/**
+ * Node's `process.execPath` — the absolute path of the INTERPRETER, not of the
+ * script it is running.
+ *
+ * This used to return `imports.system.programInvocationName`, which is the
+ * ENTRY MODULE (the same value `getArgv()` above puts in `argv[1]`, and says so).
+ * The two are different questions and the wrong answer is load-bearing:
+ * `spawn(process.execPath, […])` is the documented portable way to start a
+ * second copy of the current runtime, and against a bundle path it fails
+ * `ENOENT` — or, because `g_spawn` retries a non-executable text file through
+ * `/bin/sh`, hands a megabyte of JavaScript to the shell.
+ *
+ * Nor is `/usr/bin/gjs` a defensible fallback: no macOS host has that path
+ * (Homebrew installs to `/usr/local/bin` or `/opt/homebrew/bin`), so the
+ * "default" was a Linux literal wearing a default's clothes. `hostExecPath()`
+ * resolves the real one; the literal remains only as the last resort for a host
+ * that answers nothing at all, where any string is equally wrong and Node's
+ * type says it must be a string.
+ */
 export declare function getExecPath(): string;
 export declare function getCwd(): string;
 export declare function chdir(directory: string): void;

package/lib/types/internal/system.d.ts

@@ -6,6 +6,16 @@ export interface MemoryUsage {
     external: number;
     arrayBuffers: number;
 }
+/**
+ * Node-shaped `process.memoryUsage()`.
+ *
+ * SpiderMonkey exposes no per-heap accounting to JS, so `heapTotal`/`heapUsed`
+ * are approximated from the OS's view of the whole process — the same
+ * approximation `@gjsify/v8`'s `getHeapStatistics()` makes, from the same
+ * reader, which is why the reader lives in `@gjsify/utils/core` and not here.
+ * Before that lift this function read `/proc/self/status` inline and therefore
+ * reported `rss: 0` on every macOS host.
+ */
 export declare function memoryUsage(): MemoryUsage;
 export interface CpuUsage {
     user: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/process",
-    "version": "0.30.0",
+    "version": "0.31.0",
     "description": "Node.js process module for Gjs",
     "module": "lib/esm/index.js",
     "types": "lib/types/index.d.ts",
@@ -40,14 +40,14 @@
         "process"
     ],
     "dependencies": {
-        "@gjsify/events": "^0.30.0",
-        "@gjsify/string_decoder": "^0.30.0",
-        "@gjsify/terminal-native": "^0.30.0",
-        "@gjsify/utils": "^0.30.0"
+        "@gjsify/events": "^0.31.0",
+        "@gjsify/string_decoder": "^0.31.0",
+        "@gjsify/terminal-native": "^0.31.0",
+        "@gjsify/utils": "^0.31.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.30.0",
-        "@gjsify/unit": "^0.30.0",
+        "@gjsify/cli": "^0.31.0",
+        "@gjsify/unit": "^0.31.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -58,7 +58,15 @@
             "browser": "polyfill",
             "nativescript": "polyfill"
         },
-        "tier": 1
+        "tier": 1,
+        "os": {
+            "linux": "supported",
+            "darwin": "supported",
+            "win32": "partial"
+        },
+        "osNotes": {
+            "win32": "Under Node the platform comes from the host itself and is authoritative. Under GJS it comes from a `uname` probe, which is POSIX-only — `mapSysname` maps a MINGW/MSYS sysname to `win32`, but no GJS host exists on Windows to produce one, so that path is unexercised. Measured on the win11-gjsify VM: 6 of 167 specs fail, all POSIX assumptions in the SPECS."
+        }
     },
     "license": "MIT",
     "repository": {