@gjsify/process 0.41.0 → 0.42.0

package/README.md

@@ -24,6 +24,22 @@ console.log(process.env.HOME);
 console.log(process.platform);
 ```
 
+## Signals
+
+`process.on('SIGINT' | 'SIGTERM' | 'SIGHUP', …)` is delivered under GJS through
+`GLibUnix.signal_add()`, so the handler runs on the JS thread and — as in Node —
+registering one replaces the kernel's default disposition. The source is armed on the
+first listener and removed with the last, so a process that never asks keeps the
+default behaviour.
+
+Delivery needs something driving the default main context, which is the same condition
+every other async source in a GJS process lives under: a program that must react while
+otherwise idle holds a loop (`holdMainLoop()` from `@gjsify/utils/main-loop`).
+
+The other signals are deliberately absent. `g_unix_signal_add()` also accepts
+`SIGUSR1`/`SIGUSR2`/`SIGWINCH`, but those are renumbered on some architectures, and a
+hardcoded table would arm the WRONG signal there rather than fail.
+
 ## Inspirations and credits
 
 - https://github.com/cgjs/cgjs/tree/master/packages/process

package/lib/esm/internal/signals.js

@@ -0,0 +1 @@
+import"../_virtual/_rolldown/runtime.js";import{getGjsGlobal as e}from"./gjs.js";const t={SIGHUP:1,SIGINT:2,SIGTERM:15},n=new Map;function resolveSignalAdd(){let t=e().imports?.gi;if(!t)return null;for(let[e,n]of[[`GLibUnix`,`signal_add`],[`GLib`,`unix_signal_add`]])try{let r=t[e]?.[n];if(typeof r==`function`)return r}catch{}return null}function isDeliverableSignal(e){return typeof e==`string`&&e in t}function armSignal(r,i){if(n.has(r))return;let a=t[r],o=resolveSignalAdd(),s=e().imports?.gi?.GLib;if(a===void 0||o===null||!s)return;let c=s.PRIORITY_DEFAULT,l=o(c,a,()=>(i(r),!0));n.set(r,l)}function disarmSignal(t){let r=n.get(t);if(r===void 0)return;n.delete(t);let i=e().imports?.gi?.GLib;i&&typeof i.source_remove==`function`&&i.source_remove(r)}export{armSignal,disarmSignal,isDeliverableSignal};

package/lib/esm/process-class.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{detectArch as e,detectPlatform as t,detectPpid as n,detectVersionInfo as r,getPid as i}from"./internal/detect.js";import{chdir as a,getArgv as o,getCwd as s,getEnvProxy as c,getExecPath as l}from"./internal/env.js";import{exitProcess as u}from"./internal/exit.js";import{hrtime as d,hrtimeBigint as f}from"./internal/hrtime.js";import{cpuUsage as p,killPid as m,memoryUsage as h,readUmask as g}from"./internal/system.js";import{ProcessReadStream as _,ProcessWriteStream as v}from"./streams.js";import{EventEmitter as y}from"@gjsify/events";const b=Date.now();function defineLazy(e,t,n){Object.defineProperty(e,t,{configurable:!0,enumerable:!0,get(){let r=n();return Object.defineProperty(e,t,{value:r,configurable:!0,enumerable:!0,writable:!1}),r}})}var Process=class extends y{platform;arch;env;argv;argv0;execPath;pid;ppid;version;versions;title;execArgv;config;exitCode;constructor(){super(),defineLazy(this,`platform`,t),defineLazy(this,`arch`,e),this.env=c(),this.argv=o(),this.argv0=this.argv[0]||`gjs`,this.execPath=l(),this.execArgv=globalThis.process?.execArgv??[],this.config=globalThis.process?.config??{target_defaults:{},variables:{}},this.pid=i(),this.ppid=n();let a=r();this.version=a.version,this.versions=a.versions,this.title=a.title}cwd(){return s()}chdir(e){a(e)}kill(e,t){return m(e,t)}exit(e){return this.exitCode=e??this.exitCode??0,this.emit(`exit`,this.exitCode),u(this.exitCode)}nextTick(e,...t){typeof queueMicrotask==`function`?queueMicrotask(()=>e(...t)):Promise.resolve().then(()=>e(...t))}hrtime(e){return d(e)}uptime(){return(Date.now()-b)/1e3}memoryUsage(){return h()}cpuUsage(e){return p(e)}stdout=new v(1);stderr=new v(2);stdin=new _(0);abort(){this.exit(1)}umask(e){let t=g();return e!==void 0&&!this._umaskWarned&&(this._umaskWarned=!0,this.emitWarning(`process.umask(0${e.toString(8)}) cannot change the file-creation mask under GJS — there is no umask(2) binding, so the mask is UNCHANGED. Pass an explicit \`mode\` to open/mkdir/writeFile instead; the kernel applies it atomically at creation.`,`UnsupportedWarning`)),t}_umaskWarned=!1;emitWarning(e,t){console.warn(typeof e==`string`?`(${t||`Warning`}): ${e}`:e.message)}};Process.prototype.hrtime.bigint=function(){return f()};export{Process};
+import"./_virtual/_rolldown/runtime.js";import{detectArch as e,detectPlatform as t,detectPpid as n,detectVersionInfo as r,getPid as i}from"./internal/detect.js";import{chdir as a,getArgv as o,getCwd as s,getEnvProxy as c,getExecPath as l}from"./internal/env.js";import{exitProcess as u}from"./internal/exit.js";import{hrtime as d,hrtimeBigint as f}from"./internal/hrtime.js";import{cpuUsage as p,killPid as m,memoryUsage as h,readUmask as g}from"./internal/system.js";import{armSignal as _,disarmSignal as v,isDeliverableSignal as y}from"./internal/signals.js";import{ProcessReadStream as b,ProcessWriteStream as x}from"./streams.js";import{EventEmitter as S}from"@gjsify/events";const C=Date.now();function defineLazy(e,t,n){Object.defineProperty(e,t,{configurable:!0,enumerable:!0,get(){let r=n();return Object.defineProperty(e,t,{value:r,configurable:!0,enumerable:!0,writable:!1}),r}})}var Process=class extends S{platform;arch;env;argv;argv0;execPath;pid;ppid;version;versions;title;execArgv;config;exitCode;constructor(){super(),defineLazy(this,`platform`,t),defineLazy(this,`arch`,e),this.env=c(),this.argv=o(),this.argv0=this.argv[0]||`gjs`,this.execPath=l(),this.execArgv=globalThis.process?.execArgv??[],this.config=globalThis.process?.config??{target_defaults:{},variables:{}},this.pid=i(),this.ppid=n();let a=r();this.version=a.version,this.versions=a.versions,this.title=a.title,this.on(`newListener`,e=>{y(e)&&_(e,e=>this.emit(e,e))}),this.on(`removeListener`,e=>{y(e)&&this.listenerCount(e)===0&&v(e)})}cwd(){return s()}chdir(e){a(e)}kill(e,t){return m(e,t)}exit(e){return this.exitCode=e??this.exitCode??0,this.emit(`exit`,this.exitCode),u(this.exitCode)}nextTick(e,...t){typeof queueMicrotask==`function`?queueMicrotask(()=>e(...t)):Promise.resolve().then(()=>e(...t))}hrtime(e){return d(e)}uptime(){return(Date.now()-C)/1e3}memoryUsage(){return h()}cpuUsage(e){return p(e)}stdout=new x(1);stderr=new x(2);stdin=new b(0);abort(){this.exit(1)}umask(e){let t=g();return e!==void 0&&!this._umaskWarned&&(this._umaskWarned=!0,this.emitWarning(`process.umask(0${e.toString(8)}) cannot change the file-creation mask under GJS — there is no umask(2) binding, so the mask is UNCHANGED. Pass an explicit \`mode\` to open/mkdir/writeFile instead; the kernel applies it atomically at creation.`,`UnsupportedWarning`)),t}_umaskWarned=!1;emitWarning(e,t){console.warn(typeof e==`string`?`(${t||`Warning`}): ${e}`:e.message)}};Process.prototype.hrtime.bigint=function(){return f()};export{Process};

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

@@ -0,0 +1,15 @@
+/** Whether `name` is a signal this module can deliver. */
+export declare function isDeliverableSignal(name: string | symbol): name is string;
+/**
+ * Start delivering `signal` to `emit`. Idempotent, and a no-op off GJS — where
+ * the host runtime already delivers signals to `globalThis.process`.
+ *
+ * The GLib source is attached to the DEFAULT main context, so nothing arrives
+ * until something drives it. That is the same condition every other async
+ * source in a GJS process lives under; a program that wants a handler to run
+ * while it is otherwise idle has to hold a main loop
+ * (`@gjsify/utils`'s `holdMainLoop()`).
+ */
+export declare function armSignal(signal: string, emit: (signal: string) => void): void;
+/** Stop delivering `signal`, restoring the default disposition. Idempotent. */
+export declare function disarmSignal(signal: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/process",
-    "version": "0.41.0",
+    "version": "0.42.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.41.0",
-        "@gjsify/string_decoder": "^0.41.0",
-        "@gjsify/terminal-native": "^0.41.0",
-        "@gjsify/utils": "^0.41.0"
+        "@gjsify/events": "^0.42.0",
+        "@gjsify/string_decoder": "^0.42.0",
+        "@gjsify/terminal-native": "^0.42.0",
+        "@gjsify/utils": "^0.42.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.41.0",
-        "@gjsify/unit": "^0.41.0",
+        "@gjsify/cli": "^0.42.0",
+        "@gjsify/unit": "^0.42.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },