@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/events/exit/intercept.js

@@ -1,75 +1,54 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var intercept_exports = {};
-__export(intercept_exports, {
-  processEmit: () => processEmit,
-  processReallyExit: () => processReallyExit
-});
-module.exports = __toCommonJS(intercept_exports);
-var import_error = require("../../primordials/error");
-var import_reflect = require("../../primordials/reflect");
-var import_internal = require("./_internal");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_error = require('../../primordials/error.js');
+const require_primordials_reflect = require('../../primordials/reflect.js');
+const require_events_exit__internal = require('./_internal.js');
+
+//#region src/events/exit/intercept.ts
+/**
+* @file Process-method interceptors — `processEmit` replaces `process.emit` and
+*   `processReallyExit` replaces `process.reallyExit` while `load()` is active.
+*   Both forward to the originals captured in `_internal` and broadcast `exit`
+*   / `afterexit` through the signal-exit emitter.
+*/
+/* c8 ignore start - processEmit + processReallyExit interceptors
+only fire on real process exit/emit; can't be triggered in-test. */
+/* @__NO_SIDE_EFFECTS__ */
 function processEmit(eventName, exitCode, ...args) {
-  if (eventName === "exit") {
-    let actualExitCode = exitCode;
-    if (actualExitCode === void 0) {
-      const processExitCode = import_internal.globalProcess?.exitCode;
-      actualExitCode = typeof processExitCode === "number" ? processExitCode : void 0;
-    } else if (import_internal.globalProcess) {
-      import_internal.globalProcess.exitCode = actualExitCode;
-    }
-    const result = (0, import_reflect.ReflectApply)(
-      import_internal.originalProcessEmit,
-      this,
-      [eventName, actualExitCode, ...args]
-    );
-    const numExitCode = typeof actualExitCode === "number" ? actualExitCode : void 0;
-    (0, import_internal.emit)("exit", numExitCode, void 0);
-    (0, import_internal.emit)("afterexit", numExitCode, void 0);
-    return result;
-  }
-  return (0, import_reflect.ReflectApply)(
-    import_internal.originalProcessEmit,
-    this,
-    [eventName, exitCode, ...args]
-  );
+	if (eventName === "exit") {
+		let actualExitCode = exitCode;
+		if (actualExitCode === void 0) {
+			const processExitCode = require_events_exit__internal.globalProcess?.exitCode;
+			actualExitCode = typeof processExitCode === "number" ? processExitCode : void 0;
+		} else if (require_events_exit__internal.globalProcess) require_events_exit__internal.globalProcess.exitCode = actualExitCode;
+		const result = require_primordials_reflect.ReflectApply(require_events_exit__internal.originalProcessEmit, this, [
+			eventName,
+			actualExitCode,
+			...args
+		]);
+		const numExitCode = typeof actualExitCode === "number" ? actualExitCode : void 0;
+		/* @__PURE__ */ require_events_exit__internal.emit("exit", numExitCode, void 0);
+		/* @__PURE__ */ require_events_exit__internal.emit("afterexit", numExitCode, void 0);
+		return result;
+	}
+	return require_primordials_reflect.ReflectApply(require_events_exit__internal.originalProcessEmit, this, [
+		eventName,
+		exitCode,
+		...args
+	]);
 }
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function processReallyExit(code) {
-  const exitCode = code || 0;
-  if (import_internal.globalProcess) {
-    import_internal.globalProcess.exitCode = exitCode;
-  }
-  (0, import_internal.emit)("exit", exitCode, void 0);
-  (0, import_internal.emit)("afterexit", exitCode, void 0);
-  (0, import_reflect.ReflectApply)(
-    import_internal.originalProcessReallyExit,
-    import_internal.globalProcess,
-    [exitCode]
-  );
-  throw new import_error.ErrorCtor("processReallyExit should never return");
+	const exitCode = code || 0;
+	if (require_events_exit__internal.globalProcess) require_events_exit__internal.globalProcess.exitCode = exitCode;
+	/* @__PURE__ */ require_events_exit__internal.emit("exit", exitCode, void 0);
+	/* @__PURE__ */ require_events_exit__internal.emit("afterexit", exitCode, void 0);
+	require_primordials_reflect.ReflectApply(require_events_exit__internal.originalProcessReallyExit, require_events_exit__internal.globalProcess, [exitCode]);
+	throw new require_primordials_error.ErrorCtor("processReallyExit should never return");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  processEmit,
-  processReallyExit
-});
+/* c8 ignore stop */
+
+//#endregion
+exports.processEmit = processEmit;
+exports.processReallyExit = processReallyExit;

package/dist/events/exit/lifecycle.js

@@ -1,109 +1,100 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var lifecycle_exports = {};
-__export(lifecycle_exports, {
-  getSignalListeners: () => getSignalListeners,
-  load: () => load,
-  unload: () => unload
-});
-module.exports = __toCommonJS(lifecycle_exports);
-var import_internal = require("./_internal");
-var import_intercept = require("./intercept");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_events_exit__internal = require('./_internal.js');
+const require_events_exit_intercept = require('./intercept.js');
+
+//#region src/events/exit/lifecycle.ts
+/**
+* @file `load` and `unload` — install and remove the `signal-exit` listeners.
+*   Co-located with `getSignalListeners` because the per-signal listener body
+*   calls `unload()`; keeping them in the same leaf avoids an inter-leaf import
+*   cycle.
+*/
 let _sigListeners;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getSignalListeners() {
-  if (_sigListeners === void 0) {
-    _sigListeners = { __proto__: null };
-    const emitter = (0, import_internal.getEmitter)();
-    const sigs = (0, import_internal.getSignals)();
-    for (const sig of sigs) {
-      _sigListeners[sig] = function listener() {
-        const listeners = import_internal.globalProcess?.listeners(sig) || [];
-        if (listeners.length === emitter.count) {
-          /* @__PURE__ */ unload();
-          (0, import_internal.emit)("exit", void 0, sig);
-          (0, import_internal.emit)("afterexit", void 0, sig);
-          const killSig = import_internal.WIN32 && sig === "SIGHUP" ? "SIGINT" : sig;
-          import_internal.globalProcess?.kill(import_internal.globalProcess?.pid, killSig);
-        }
-      };
-    }
-  }
-  return _sigListeners;
+	if (_sigListeners === void 0) {
+		_sigListeners = { __proto__: null };
+		const emitter = /* @__PURE__ */ require_events_exit__internal.getEmitter();
+		const sigs = /* @__PURE__ */ require_events_exit__internal.getSignals();
+		/* c8 ignore start - Signal-listener body fires only on real
+		process signals; can't be triggered in-test without subprocess
+		infrastructure. */
+		for (const sig of sigs) _sigListeners[sig] = function listener() {
+			if ((require_events_exit__internal.globalProcess?.listeners(sig) || []).length === emitter.count) {
+				/* @__PURE__ */ require_events_exit__internal.emit("exit", void 0, sig);
+				/* @__PURE__ */ require_events_exit__internal.emit("afterexit", void 0, sig);
+				const killSig = require_events_exit__internal.WIN32 && sig === "SIGHUP" ? "SIGINT" : sig;
+				require_events_exit__internal.globalProcess?.kill(require_events_exit__internal.globalProcess?.pid, killSig);
+			}
+		};
+	}
+	return _sigListeners;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Load signal handlers and hook into process exit events.
+*
+* @example
+*   ;```typescript
+*   load()
+*   // Signal handlers are now active
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function load() {
-  if ((0, import_internal.isLoaded)() || !import_internal.globalProcess) {
-    return;
-  }
-  (0, import_internal.setLoaded)(true);
-  const proc = import_internal.globalProcess;
-  const emitter = (0, import_internal.getEmitter)();
-  if (emitter.count !== void 0) {
-    emitter.count += 1;
-  }
-  const sigs = (0, import_internal.getSignals)();
-  const sigListeners = /* @__PURE__ */ getSignalListeners();
-  (0, import_internal.setSignals)(
-    sigs.filter((sig) => {
-      try {
-        proc.on(sig, sigListeners[sig]);
-        return true;
-      } catch {
-      }
-      return false;
-    })
-  );
-  proc.emit = import_intercept.processEmit;
-  proc.reallyExit = import_intercept.processReallyExit;
+	/* c8 ignore next - !globalProcess never fires in Node tests. */
+	if (require_events_exit__internal.isLoaded() || !require_events_exit__internal.globalProcess) return;
+	require_events_exit__internal.setLoaded(true);
+	const proc = require_events_exit__internal.globalProcess;
+	const emitter = /* @__PURE__ */ require_events_exit__internal.getEmitter();
+	/* c8 ignore start */
+	if (emitter.count !== void 0) emitter.count += 1;
+	/* c8 ignore stop */
+	const sigs = /* @__PURE__ */ require_events_exit__internal.getSignals();
+	const sigListeners = /* @__PURE__ */ getSignalListeners();
+	require_events_exit__internal.setSignals(sigs.filter((sig) => {
+		try {
+			proc.on(sig, sigListeners[sig]);
+			return true;
+		} catch {}
+		return false;
+		/* c8 ignore stop */
+	}));
+	proc.emit = require_events_exit_intercept.processEmit;
+	proc.reallyExit = require_events_exit_intercept.processReallyExit;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Unload signal handlers and restore original process behavior.
+*
+* @example
+*   ;```typescript
+*   unload()
+*   // Signal handlers are now removed
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function unload() {
-  if (!(0, import_internal.isLoaded)() || !import_internal.globalProcess) {
-    return;
-  }
-  (0, import_internal.setLoaded)(false);
-  const sigs = (0, import_internal.getSignals)();
-  const sigListeners = /* @__PURE__ */ getSignalListeners();
-  for (const sig of sigs) {
-    try {
-      import_internal.globalProcess.removeListener(
-        sig,
-        sigListeners[sig]
-      );
-    } catch {
-    }
-  }
-  import_internal.globalProcess.emit = import_internal.originalProcessEmit;
-  if (import_internal.originalProcessReallyExit !== void 0) {
-    import_internal.globalProcess.reallyExit = import_internal.originalProcessReallyExit;
-  }
-  const emitter = (0, import_internal.getEmitter)();
-  if (emitter.count !== void 0) {
-    emitter.count -= 1;
-  }
+	/* c8 ignore start */
+	if (!require_events_exit__internal.isLoaded() || !require_events_exit__internal.globalProcess) return;
+	/* c8 ignore stop */
+	require_events_exit__internal.setLoaded(false);
+	const sigs = /* @__PURE__ */ require_events_exit__internal.getSignals();
+	const sigListeners = /* @__PURE__ */ getSignalListeners();
+	for (const sig of sigs) try {
+		require_events_exit__internal.globalProcess.removeListener(sig, sigListeners[sig]);
+	} catch {}
+	require_events_exit__internal.globalProcess.emit = require_events_exit__internal.originalProcessEmit;
+	/* c8 ignore start */
+	if (require_events_exit__internal.originalProcessReallyExit !== void 0) require_events_exit__internal.globalProcess.reallyExit = require_events_exit__internal.originalProcessReallyExit;
+	/* c8 ignore stop */
+	const emitter = /* @__PURE__ */ require_events_exit__internal.getEmitter();
+	/* c8 ignore start */
+	if (emitter.count !== void 0) emitter.count -= 1;
+	/* c8 ignore stop */
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getSignalListeners,
-  load,
-  unload
-});
+
+//#endregion
+exports.getSignalListeners = getSignalListeners;
+exports.load = load;
+exports.unload = unload;

package/dist/events/exit/signals.js

@@ -1,34 +1,28 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var signals_exports = {};
-__export(signals_exports, {
-  signals: () => signals
-});
-module.exports = __toCommonJS(signals_exports);
-var import_internal = require("./_internal");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_events_exit__internal = require('./_internal.js');
+
+//#region src/events/exit/signals.ts
+/**
+* @file `signals()` — list the signals this process is watching. Before
+*   `load()` runs, returns the lazy-initialised default list; after `load()`
+*   runs, returns the filtered subset that was actually registered
+*   successfully.
+*/
+/**
+* Get the list of signals that are currently being monitored.
+*
+* @example
+*   ;```typescript
+*   const sigs = signals()
+*   console.log(sigs) // ['SIGABRT', 'SIGALRM', 'SIGHUP', ...]
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function signals() {
-  return (0, import_internal.getSignals)();
+	return /* @__PURE__ */ require_events_exit__internal.getSignals();
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  signals
-});
+
+//#endregion
+exports.signals = signals;

package/dist/events/exit/types.js

@@ -1,18 +1,2 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/events/warning/handler.js

@@ -1,43 +1,46 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var handler_exports = {};
-__export(handler_exports, {
-  setMaxEventTargetListeners: () => setMaxEventTargetListeners
-});
-module.exports = __toCommonJS(handler_exports);
-var import_object = require("../../primordials/object");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_object = require('../../primordials/object.js');
+
+//#region src/events/warning/handler.ts
+/**
+* @file Bump the max-listener cap on an EventTarget (or AbortSignal). Lives
+*   next to the suppress-warnings family because the goal is the same — silence
+*   Node's noise about exceeding the default 10-listener threshold — but the
+*   mechanism is different: here we set the symbol on the target itself, no
+*   `process.emitWarning` wrapping involved.
+*/
+/**
+* Set max listeners on an EventTarget (like AbortSignal) to avoid TypeError.
+*
+* By manually setting `kMaxEventTargetListeners` on the target we avoid:
+* TypeError [ERR_INVALID_ARG_TYPE]: The "emitter" argument must be an instance
+* of EventEmitter or EventTarget. Received an instance of AbortSignal.
+*
+* In some patch releases of Node 18-23 when calling events.getMaxListeners().
+* See https://github.com/nodejs/node/pull/56807.
+*
+* Instead of calling events.setMaxListeners(n, target) we set the symbol
+* property directly to avoid depending on 'node:events' module.
+*
+* @example
+*   import { setMaxEventTargetListeners } from '@socketsecurity/lib/events/warning/handler'
+*
+*   const controller = new AbortController()
+*   setMaxEventTargetListeners(controller.signal)
+*
+* @param target - The EventTarget or AbortSignal to configure.
+* @param maxListeners - Maximum number of listeners (defaults to 10, the
+*   Node.js default)
+*/
 function setMaxEventTargetListeners(target, maxListeners = 10) {
-  if (!target) {
-    return;
-  }
-  const symbols = (0, import_object.ObjectGetOwnPropertySymbols)(target);
-  const kMaxEventTargetListeners = symbols.find(
-    (s) => s.description === "events.maxEventTargetListeners"
-  );
-  if (kMaxEventTargetListeners) {
-    ;
-    target[kMaxEventTargetListeners] = maxListeners;
-  }
+	/* c8 ignore start */
+	if (!target) return;
+	const kMaxEventTargetListeners = require_primordials_object.ObjectGetOwnPropertySymbols(target).find((s) => s.description === "events.maxEventTargetListeners");
+	if (kMaxEventTargetListeners) target[kMaxEventTargetListeners] = maxListeners;
+	/* c8 ignore stop */
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  setMaxEventTargetListeners
-});
+
+//#endregion
+exports.setMaxEventTargetListeners = setMaxEventTargetListeners;