@gjsify/process 0.53.0 → 0.54.0

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{armSignal as _,disarmSignal as v,isDeliverableSignal as y}from"./internal/signals.js";import{restoreClaimedRawModes as b}from"./raw-mode.js";import{ProcessReadStream as x,ProcessWriteStream as S}from"./streams.js";import{EventEmitter as C}from"@gjsify/events";const w=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 C{platform;arch;env;argv;argv0;execPath;pid;ppid;version;versions;title;execArgv;config;exitCode;constructor(){super(),this.on(`exit`,()=>{try{b()}catch(e){console.error(`@gjsify/process: raw mode could not be restored:`,e)}}),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()-w)/1e3}memoryUsage(){return h()}cpuUsage(e){return p(e)}stdout=new S(1);stderr=new S(2);stdin=new x(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{restoreClaimedRawModes as S}from"@gjsify/terminal-native";import{EventEmitter as C}from"@gjsify/events";const w=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 C{platform;arch;env;argv;argv0;execPath;pid;ppid;version;versions;title;execArgv;config;exitCode;constructor(){super(),this.on(`exit`,()=>{try{S()}catch(e){console.error(`@gjsify/process: raw mode could not be restored:`,e)}}),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()-w)/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/esm/streams.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{getGioNamespace as e,getGjsGlobal as t}from"./internal/gjs.js";import{claimRawMode as n,releaseRawMode as r}from"./raw-mode.js";import{nativeTerminal as i}from"@gjsify/terminal-native";import{EventEmitter as a}from"@gjsify/events";import{ensureMainLoop as o,quitMainLoop as s}from"@gjsify/utils/core";import{StringDecoder as c}from"@gjsify/string_decoder";const l=new TextEncoder;var ProcessWriteStream=class extends a{fd;writable=!0;_outGio=null;constructor(t){super(),this.fd=t;let n=e();if(n){let e=n.UnixOutputStream??n.OutputStream;if(e)try{this._outGio=e.new(this.fd,!1)}catch{}}}write(e){if(this._outGio)try{let t=typeof e==`string`?l.encode(e):e;return this._outGio.write_all(t,null),!0}catch{}return this.fd===2?console.error(e):console.log(e),!0}get isTTY(){if(i)return i.Terminal.is_tty(this.fd);try{let e=t().imports?.gi?.GLib;if(e)return!!e.log_writer_supports_color(this.fd)}catch{}return!1}get columns(){if(i){let[e,,t]=i.Terminal.get_size(this.fd);if(e&&t>0)return t}try{let e=t().imports?.gi?.GLib;if(e){let t=parseInt(e.getenv(`COLUMNS`)??`0`,10);if(t>0)return t}}catch{}return 80}end(){}destroy(){}get rows(){if(i){let[e,t]=i.Terminal.get_size(this.fd);if(e&&t>0)return t}try{let e=t().imports?.gi?.GLib;if(e){let t=parseInt(e.getenv(`LINES`)??`0`,10);if(t>0)return t}}catch{}return 24}},ProcessReadStream=class extends a{fd;isRaw=!1;_gio=null;_stdinGio=null;_reading=!1;_flowing=!1;_mainLoopHeld=!1;_pendingRead=!1;_decoder=null;constructor(t){super(),this.fd=t,this._gio=e()}get isTTY(){return i?i.Terminal.is_tty(this.fd):!1}setRawMode(e){return i&&i.Terminal.set_raw_mode(this.fd,e)?(this.isRaw=e,this._noteRawMode(e,()=>{i.Terminal.set_raw_mode(this.fd,!1)}),this):(this._setRawModeViaStty(e),this.isRaw=e,this)}_noteRawMode(e,t){e?n(this.fd,t):r(this.fd)}_setRawModeViaStty(e){try{let t=globalThis.imports?.gi,n=t?.Gio??t?.Gio;if(!n)return;let r=n.SubprocessFlags?.STDIN_INHERIT??2,i=e?[`stty`,`-icanon`,`-echo`,`-icrnl`,`-isig`,`min`,`1`,`time`,`0`]:[`stty`,`icanon`,`echo`,`icrnl`,`isig`];new n.SubprocessLauncher({flags:r}).spawnv(i).wait(null),this._noteRawMode(e,()=>this._setRawModeViaStty(!1))}catch{}}setEncoding(e){return this._decoder=new c(e),this}_pushData(e){if(this._decoder){let t=this._decoder.write(e);t.length>0&&this.emit(`data`,t)}else this.emit(`data`,e)}on(e,t){let n=e===`data`&&this.listenerCount(`data`)===0;return super.on(e,t),n&&e===`data`&&this.resume(),this}addListener(e,t){return this.on(e,t)}once(e,t){return super.once(e,t),this}removeListener(e,t){return super.removeListener(e,t),e===`data`&&this.listenerCount(`data`)===0&&this.pause(),this}off(e,t){return this.removeListener(e,t)}removeAllListeners(e){let t=e===void 0||e===`data`?this.listenerCount(`data`)>0:!1;return super.removeAllListeners(e),t&&this.listenerCount(`data`)===0&&this.pause(),this}resume(){return this._flowing=!0,this._gio&&this.fd===0&&!this._reading&&this._startReading(),this}pause(){if(this._flowing=!1,this._reading=!1,this._mainLoopHeld){this._mainLoopHeld=!1;let e=globalThis.imports?.gi,t=e?.GLib??e?.GLib;t?.idle_add?t.idle_add(300,()=>(this._mainLoopHeld||s(),!1)):s()}return this}read(){return null}_startReading(){if(!this._gio||this._reading)return;if(this._pendingRead){this._reading=!0,this._mainLoopHeld||(this._mainLoopHeld=!0,o());return}if(this._reading=!0,this._mainLoopHeld||(this._mainLoopHeld=!0,o()),!this._stdinGio){let e=this._gio.UnixInputStream??this._gio.InputStream;if(!e){this._reading=!1;return}try{this._stdinGio=e.new(this.fd,!1)}catch{this._reading=!1;return}}let loop=()=>{if(!this._reading){this._pendingRead=!1;return}this._pendingRead=!0,this._stdinGio.read_bytes_async(4096,0,null,(e,t)=>{this._pendingRead=!1;try{let n=e.read_bytes_finish(t)?.get_data?.()??null;if(n&&n.byteLength>0)this._pushData(Buffer.from(n));else if(n!==null&&n.byteLength===0){if(this._reading=!1,this._decoder){let e=this._decoder.end();e.length>0&&this.emit(`data`,e)}this.emit(`end`);return}}catch{this._reading=!1;return}this._reading&&loop()})};loop()}};export{ProcessReadStream,ProcessWriteStream};
+import"./_virtual/_rolldown/runtime.js";import{getGioNamespace as e,getGjsGlobal as t}from"./internal/gjs.js";import{nativeIsTty as n,nativeSetRawMode as r,nativeTerminalSize as i,noteRawMode as a}from"@gjsify/terminal-native";import{EventEmitter as o}from"@gjsify/events";import{ensureMainLoop as s,quitMainLoop as c}from"@gjsify/utils/core";import{StringDecoder as l}from"@gjsify/string_decoder";const u=new TextEncoder;var ProcessWriteStream=class extends o{fd;writable=!0;_outGio=null;constructor(t){super(),this.fd=t;let n=e();if(n){let e=n.UnixOutputStream??n.OutputStream;if(e)try{this._outGio=e.new(this.fd,!1)}catch{}}}write(e){if(this._outGio)try{let t=typeof e==`string`?u.encode(e):e;return this._outGio.write_all(t,null),!0}catch{}return this.fd===2?console.error(e):console.log(e),!0}get isTTY(){let e=n(this.fd);if(e!==null)return e;try{let e=t().imports?.gi?.GLib;if(e)return!!e.log_writer_supports_color(this.fd)}catch{}return!1}get columns(){let e=i(this.fd);if(e)return e.columns;try{let e=t().imports?.gi?.GLib;if(e){let t=parseInt(e.getenv(`COLUMNS`)??`0`,10);if(t>0)return t}}catch{}return 80}end(){}destroy(){}get rows(){let e=i(this.fd);if(e)return e.rows;try{let e=t().imports?.gi?.GLib;if(e){let t=parseInt(e.getenv(`LINES`)??`0`,10);if(t>0)return t}}catch{}return 24}},ProcessReadStream=class extends o{fd;isRaw=!1;_gio=null;_stdinGio=null;_reading=!1;_flowing=!1;_mainLoopHeld=!1;_pendingRead=!1;_decoder=null;constructor(t){super(),this.fd=t,this._gio=e()}get isTTY(){return n(this.fd)??!1}setRawMode(e){return a(this.fd,e,e=>r(this.fd,e)===!0)?(this.isRaw=e,this):(a(this.fd,e,e=>this._setRawModeViaStty(e)),this.isRaw=e,this)}_setRawModeViaStty(e){try{let t=globalThis.imports?.gi,n=t?.Gio??t?.Gio;if(!n)return!1;let r=n.SubprocessFlags?.STDIN_INHERIT??2,i=e?[`stty`,`-icanon`,`-echo`,`-icrnl`,`-isig`,`min`,`1`,`time`,`0`]:[`stty`,`icanon`,`echo`,`icrnl`,`isig`],a=new n.SubprocessLauncher({flags:r}).spawnv(i);return a.wait(null),a.get_successful()}catch{return!1}}setEncoding(e){return this._decoder=new l(e),this}_pushData(e){if(this._decoder){let t=this._decoder.write(e);t.length>0&&this.emit(`data`,t)}else this.emit(`data`,e)}on(e,t){let n=e===`data`&&this.listenerCount(`data`)===0;return super.on(e,t),n&&e===`data`&&this.resume(),this}addListener(e,t){return this.on(e,t)}once(e,t){return super.once(e,t),this}removeListener(e,t){return super.removeListener(e,t),e===`data`&&this.listenerCount(`data`)===0&&this.pause(),this}off(e,t){return this.removeListener(e,t)}removeAllListeners(e){let t=e===void 0||e===`data`?this.listenerCount(`data`)>0:!1;return super.removeAllListeners(e),t&&this.listenerCount(`data`)===0&&this.pause(),this}resume(){return this._flowing=!0,this._gio&&this.fd===0&&!this._reading&&this._startReading(),this}pause(){if(this._flowing=!1,this._reading=!1,this._mainLoopHeld){this._mainLoopHeld=!1;let e=globalThis.imports?.gi,t=e?.GLib??e?.GLib;t?.idle_add?t.idle_add(300,()=>(this._mainLoopHeld||c(),!1)):c()}return this}read(){return null}_startReading(){if(!this._gio||this._reading)return;if(this._pendingRead){this._reading=!0,this._mainLoopHeld||(this._mainLoopHeld=!0,s());return}if(this._reading=!0,this._mainLoopHeld||(this._mainLoopHeld=!0,s()),!this._stdinGio){let e=this._gio.UnixInputStream??this._gio.InputStream;if(!e){this._reading=!1;return}try{this._stdinGio=e.new(this.fd,!1)}catch{this._reading=!1;return}}let loop=()=>{if(!this._reading){this._pendingRead=!1;return}this._pendingRead=!0,this._stdinGio.read_bytes_async(4096,0,null,(e,t)=>{this._pendingRead=!1;try{let n=e.read_bytes_finish(t)?.get_data?.()??null;if(n&&n.byteLength>0)this._pushData(Buffer.from(n));else if(n!==null&&n.byteLength===0){if(this._reading=!1,this._decoder){let e=this._decoder.end();e.length>0&&this.emit(`data`,e)}this.emit(`end`);return}}catch{this._reading=!1;return}this._reading&&loop()})};loop()}};export{ProcessReadStream,ProcessWriteStream};

package/lib/types/streams.d.ts

@@ -24,14 +24,9 @@ export declare class ProcessReadStream extends EventEmitter {
     constructor(fd: number);
     get isTTY(): boolean;
     setRawMode(mode: boolean): this;
-    /**
-     * Record what this stream owes the terminal, or clear the debt.
-     *
-     * `releaseRawMode` matters as much as the claim: the owner turning raw mode
-     * off in the normal `close()` path has PAID, and an exit hook that ran the
-     * stale undo afterwards could fight a later owner that wanted raw mode.
-     */
-    private _noteRawMode;
+    /** Whether the spawn left the terminal in the state asked for, which is what
+     * makes a claim on it honest: `stty` exits non-zero without touching a
+     * descriptor that is not a TTY, and that must claim nothing. */
     private _setRawModeViaStty;
     setEncoding(enc: string): this;
     protected _pushData(buf: Buffer): void;

package/package.json

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

package/lib/esm/raw-mode.js

@@ -1 +0,0 @@
-import"./_virtual/_rolldown/runtime.js";const e=new Map;function claimRawMode(t,n){e.set(t,n)}function releaseRawMode(t){e.delete(t)}function isRawModeClaimed(t){return e.has(t)}function restoreClaimedRawModes(){let t=[...e.entries()];e.clear();let n=0,r;for(let[,e]of t)try{e(),n+=1}catch(e){r??=e}if(r!==void 0)throw r;return n}export{claimRawMode,isRawModeClaimed,releaseRawMode,restoreClaimedRawModes};

package/lib/types/raw-mode.d.ts

@@ -1,26 +0,0 @@
-/**
- * Record that this process put `fd` into raw mode, and how to undo it.
- *
- * Called by whoever performs the transition, on EVERY path — a path that forgets
- * to claim is a terminal nobody will restore, which is the bug this exists for.
- */
-export declare function claimRawMode(fd: number, restore: () => void): void;
-/**
- * Record that the owner turned `fd` back itself, in the normal close() path.
- *
- * A paid debt: nothing is owed at exit, so the exit hook must not run a restore
- * that could fight whoever claimed the descriptor afterwards.
- */
-export declare function releaseRawMode(fd: number): void;
-/** Whether this process still owes `fd` a restore. */
-export declare function isRawModeClaimed(fd: number): boolean;
-/**
- * Pay every outstanding debt, and report how many were paid.
- *
- * The map is emptied BEFORE anything runs, so a restore that claims again — or
- * throws — cannot be undone by this same pass. One descriptor failing does not
- * strand the others: every restore is attempted, and the first failure is
- * rethrown afterwards so the caller can see it. A silently empty restore is the
- * exact failure this module exists to remove, so the error is never swallowed.
- */
-export declare function restoreClaimedRawModes(): number;