@ac-kit/app-system 0.1.0

package/dist/os/ps.js

@@ -0,0 +1,165 @@
+import { EOL } from "node:os";
+import { MS_PER_DAY, MS_PER_HOUR, MS_PER_MINUTE, MS_PER_SECOND, defaults, } from "@ac-kit/core";
+import { escapeCommandArg, execAsync, ProcessExitWithOutputError, } from "@ac-kit/node";
+export const PS_DEFAULT_OPTIONS = {
+    selector: "all",
+    fields: null,
+    extraArgs: null,
+    execOptions: null,
+};
+const PS_RESULT_FIELDS = [
+    "args",
+    "comm",
+    "etime",
+    "group",
+    "nice",
+    "pcpu",
+    "pgid",
+    "pid",
+    "ppid",
+    "rgroup",
+    "ruser",
+    "time",
+    "tty",
+    "user",
+    "vsz",
+];
+/**
+ * Get the list of running processes using the `ps` command.
+ *
+ * @param options Options for filtering and selecting fields.
+ * @returns A promise that resolves to an array of process information objects.
+ */
+export async function ps(options) {
+    const effectiveOptions = defaults(options, PS_DEFAULT_OPTIONS);
+    const columns = !effectiveOptions.fields || effectiveOptions.fields.length === 0
+        ? PS_RESULT_FIELDS
+        : effectiveOptions.fields;
+    // Ensure args is the last column, so that splitting by whitespace works correctly
+    if (columns.includes("args")) {
+        columns.splice(columns.indexOf("args"), 1);
+        columns.push("args");
+    }
+    const commandArgs = [
+        "-ww",
+        ...buildPsSelectorArgs(effectiveOptions.selector ?? "all"),
+        "-o",
+        escapeCommandArg(columns.join(",")),
+    ];
+    let output;
+    try {
+        const result = await execAsync(`ps ${commandArgs.join(" ")}`, {
+            ...effectiveOptions.execOptions,
+            encoding: "utf-8",
+            env: {
+                ...effectiveOptions.execOptions?.env,
+                PS_PERSONALITY: "posix",
+                LANG: "C",
+                LC_ALL: "C",
+            },
+        });
+        output = result.stdout;
+    }
+    catch (error) {
+        // If `ps` fails with exit code 1 but produces output (header), return an empty list
+        if (error instanceof ProcessExitWithOutputError &&
+            error.code === 1 &&
+            error.stdout.length > 0) {
+            return [];
+        }
+        throw error;
+    }
+    const [_, ...rows] = output.trim().split(EOL);
+    return rows.map((row) => {
+        const rowColumns = row.trim().split(/\s+/);
+        if (rowColumns.length > columns.length) {
+            // The args column may contain spaces, so merge any extra cells into the last column
+            const args = rowColumns.slice(columns.length - 1).join(" ");
+            rowColumns.splice(columns.length - 1, rowColumns.length - columns.length + 1, args);
+        }
+        const entry = {};
+        for (let c = 0; c < rowColumns.length; c++) {
+            const field = columns[c];
+            if (!field) {
+                continue;
+            }
+            let value = rowColumns[c];
+            const intValue = parseInt(value, 10);
+            if (!Number.isNaN(intValue) && `${intValue}` === value) {
+                // Exact match, use integer value
+                value = intValue;
+            }
+            entry[field] = value;
+        }
+        return entry;
+    });
+}
+function buildPsFiltersArgs(filters) {
+    const args = [];
+    if (filters.group?.length) {
+        args.push("-G", ...filters.group.map((n) => escapeCommandArg(`${n}`)));
+    }
+    if (filters.pid?.length) {
+        args.push("-p", ...filters.pid.map((n) => escapeCommandArg(`${n}`)));
+    }
+    if (filters.tty?.length) {
+        args.push("-t", ...filters.tty.map(escapeCommandArg));
+    }
+    if (filters.user?.length) {
+        args.push("-U", ...filters.user.map((n) => escapeCommandArg(`${n}`)));
+    }
+    return args;
+}
+function buildPsSelectorArgs(selector) {
+    if (typeof selector === "string") {
+        if (selector === "all") {
+            // Select all processes (argument: -A)
+            return ["-A"];
+        }
+        // Select processes associated with a terminal (argument: -a)
+        return ["-a"];
+    }
+    const args = buildPsFiltersArgs(selector);
+    if (args.length === 0) {
+        // If no filters are specified, select all processes
+        return ["-A"];
+    }
+    return args;
+}
+/**
+ * Parse a duration string in the format [[[dd-]hh:]mm:]ss to milliseconds.
+ *
+ * @param duration Duration string in the format [[[dd-]hh:]mm:]ss
+ * @returns The duration in milliseconds.
+ */
+export function psParseDuration(duration) {
+    const parts = duration.split("-");
+    let days = 0;
+    let timePart = duration;
+    if (parts.length === 2) {
+        days = +parts[0];
+        timePart = parts[1];
+    }
+    const timeParts = timePart.split(":").reverse();
+    if ((parts.length === 2 && timeParts.length !== 3) || timeParts.length > 3) {
+        throw new Error(`Invalid duration format: ${duration}`);
+    }
+    const seconds = timeParts[0].length === 2 ? +timeParts[0] : NaN;
+    let minutes = 0;
+    if (timeParts.length > 1) {
+        minutes = timeParts[1].length === 2 ? +timeParts[1] : NaN;
+    }
+    let hours = 0;
+    if (timeParts.length > 2) {
+        hours = timeParts[2].length === 2 ? +timeParts[2] : NaN;
+    }
+    const result = days * MS_PER_DAY +
+        hours * MS_PER_HOUR +
+        minutes * MS_PER_MINUTE +
+        seconds * MS_PER_SECOND;
+    if (Number.isNaN(result)) {
+        throw new Error(`Invalid duration format: ${duration}`);
+    }
+    return result;
+}
+//# sourceMappingURL=ps.js.map

package/dist/os/ps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps.js","sourceRoot":"","sources":["../../src/os/ps.ts"],"names":[],"mappings":"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"}

package/dist/os/sysfs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Raw readers over Linux's sysfs pseudo-filesystem. Every reader answers `null`
+ * rather than throwing when the node is absent or unreadable: sysfs layout
+ * varies with the kernel configuration, and an absent node is a normal outcome,
+ * not a failure. Nothing read here is privileged.
+ */
+export declare const SYSFS_DEFAULT_ROOT = "/sys";
+/**
+ * `scaling_cur_freq / cpuinfo_max_freq` for every core exposing both, in
+ * `/sys/devices/system/cpu/cpu*\/cpufreq`. Empty when `cpufreq` is not
+ * configured.
+ */
+export declare function sysfsCpuFrequencyRatios(sysfsRoot?: string): Promise<number[]>;
+/**
+ * Temperature of every readable zone in `/sys/class/thermal`, converted from
+ * the millidegrees Celsius the nodes report. Empty when no zone is exposed.
+ */
+export declare function sysfsThermalZoneTemperaturesC(sysfsRoot?: string): Promise<number[]>;
+//# sourceMappingURL=sysfs.d.ts.map

package/dist/os/sysfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sysfs.d.ts","sourceRoot":"","sources":["../../src/os/sysfs.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAczC;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,SAAS,SAAqB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CAClD,SAAS,SAAqB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB"}

package/dist/os/sysfs.js

@@ -0,0 +1,66 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { walkPaths } from "@ac-kit/node";
+/**
+ * Raw readers over Linux's sysfs pseudo-filesystem. Every reader answers `null`
+ * rather than throwing when the node is absent or unreadable: sysfs layout
+ * varies with the kernel configuration, and an absent node is a normal outcome,
+ * not a failure. Nothing read here is privileged.
+ */
+export const SYSFS_DEFAULT_ROOT = "/sys";
+const CPU_DIRECTORY = /^cpu\d+$/;
+const THERMAL_ZONE_DIRECTORY = /^thermal_zone\d+$/;
+async function readNumberNode(path) {
+    try {
+        const value = Number.parseFloat(await readFile(path, "utf8"));
+        return Number.isFinite(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * `scaling_cur_freq / cpuinfo_max_freq` for every core exposing both, in
+ * `/sys/devices/system/cpu/cpu*\/cpufreq`. Empty when `cpufreq` is not
+ * configured.
+ */
+export async function sysfsCpuFrequencyRatios(sysfsRoot = SYSFS_DEFAULT_ROOT) {
+    const cpuRoot = join(sysfsRoot, "devices", "system", "cpu");
+    const ratios = [];
+    for await (const { path } of walkPaths({
+        root: cpuRoot,
+        include: CPU_DIRECTORY,
+        unreadable: "skip",
+    })) {
+        const cpufreq = join(cpuRoot, path, "cpufreq");
+        const [current, max] = await Promise.all([
+            readNumberNode(join(cpufreq, "scaling_cur_freq")),
+            readNumberNode(join(cpufreq, "cpuinfo_max_freq")),
+        ]);
+        if (current === null || max === null || max <= 0) {
+            continue;
+        }
+        ratios.push(current / max);
+    }
+    return ratios;
+}
+/**
+ * Temperature of every readable zone in `/sys/class/thermal`, converted from
+ * the millidegrees Celsius the nodes report. Empty when no zone is exposed.
+ */
+export async function sysfsThermalZoneTemperaturesC(sysfsRoot = SYSFS_DEFAULT_ROOT) {
+    const thermalRoot = join(sysfsRoot, "class", "thermal");
+    const temperatures = [];
+    for await (const { path } of walkPaths({
+        root: thermalRoot,
+        include: THERMAL_ZONE_DIRECTORY,
+        unreadable: "skip",
+    })) {
+        const milliDegrees = await readNumberNode(join(thermalRoot, path, "temp"));
+        if (milliDegrees !== null) {
+            temperatures.push(milliDegrees / 1000);
+        }
+    }
+    return temperatures;
+}
+//# sourceMappingURL=sysfs.js.map

package/dist/os/sysfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sysfs.js","sourceRoot":"","sources":["../../src/os/sysfs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,MAAM,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAEnD,KAAK,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,SAAS,GAAG,kBAAkB;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACtC,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,MAAM;KAClB,CAAC,EAAE,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;YACjD,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;SACjD,CAAC,CAAC;QAEH,IAAI,OAAO,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YAClD,SAAS;QACV,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,SAAS,GAAG,kBAAkB;IAE9B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACtC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,sBAAsB;QAC/B,UAAU,EAAE,MAAM;KAClB,CAAC,EAAE,CAAC;QACJ,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3E,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QACxC,CAAC;IACF,CAAC;IAED,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/process/child-process-message-sink.d.ts

@@ -0,0 +1,21 @@
+import type { ISink, SerializeReportEventOptions } from "@ac-kit/app-report";
+export type ChildProcessMessageSinkOptions = {
+    readonly serialize?: SerializeReportEventOptions;
+    /**
+     * Called when the IPC channel refuses a message (typically because it has
+     * closed). Without it a delivery failure is silent, which for a measurement
+     * stream is data loss with no signal.
+     */
+    readonly onSendError?: (error: unknown) => void;
+};
+/** The subset of `process`/`ChildProcess` a message sink needs. */
+export type MessageTarget = {
+    send?: (message: unknown, callback: (error: unknown) => void) => boolean;
+};
+/**
+ * Binds a Node IPC channel to `@ac-kit/app-report`'s portable
+ * `createMessageSink`: pass `process` in a forked child, or the child handle in
+ * the parent.
+ */
+export declare function createChildProcessMessageSink<TData>(target: MessageTarget, options?: ChildProcessMessageSinkOptions): ISink<TData>;
+//# sourceMappingURL=child-process-message-sink.d.ts.map

package/dist/process/child-process-message-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-process-message-sink.d.ts","sourceRoot":"","sources":["../../src/process/child-process-message-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAG7E,MAAM,MAAM,8BAA8B,GAAG;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,OAAO,CAAC;CACzE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAClD,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,8BAA8B,GACtC,KAAK,CAAC,KAAK,CAAC,CAWd"}

package/dist/process/child-process-message-sink.js

@@ -0,0 +1,16 @@
+import { createMessageSink } from "@ac-kit/app-report";
+/**
+ * Binds a Node IPC channel to `@ac-kit/app-report`'s portable
+ * `createMessageSink`: pass `process` in a forked child, or the child handle in
+ * the parent.
+ */
+export function createChildProcessMessageSink(target, options) {
+    return createMessageSink((message) => {
+        target.send?.(message, (error) => {
+            if (error) {
+                options?.onSendError?.(error);
+            }
+        });
+    }, { serialize: options?.serialize });
+}
+//# sourceMappingURL=child-process-message-sink.js.map

package/dist/process/child-process-message-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-process-message-sink.js","sourceRoot":"","sources":["../../src/process/child-process-message-sink.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAiBvD;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC5C,MAAqB,EACrB,OAAwC;IAExC,OAAO,iBAAiB,CACvB,CAAC,OAAO,EAAE,EAAE;QACX,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,EACD,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CACjC,CAAC;AACH,CAAC"}

package/dist/process/error-listeners.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The origin of an uncaught exception. Matches Node.js process
+ * 'uncaughtException' event callback.
+ */
+export type UncaughtExceptionOrigin = "uncaughtException" | "unhandledRejection";
+export declare class UnhandledRejectionError extends Error {
+    readonly promise: Promise<unknown> | null;
+    constructor(reason: unknown, promise?: Promise<unknown> | null);
+}
+export declare class UncaughtExceptionError extends Error {
+    constructor(error: Error);
+}
+export type ErrorListenersOptions = {
+    silent?: boolean;
+    onError?: ((error: UnhandledRejectionError | UncaughtExceptionError) => void) | null;
+};
+/**
+ * A utility class that listens for unhandled promise rejections and uncaught
+ * exceptions, logs them to a specified file, or if that fails, to stderr.
+ */
+export declare class ErrorListeners {
+    private readonly filePath;
+    private readonly options;
+    private detacher;
+    /**
+     * Creates a new instance of LoggerErrorListeners.
+     *
+     * @param filePath The path to the file where errors will be logged.
+     * @param options The options for the LoggerErrorListeners.
+     */
+    constructor(filePath: string, options?: ErrorListenersOptions);
+    /**
+     * Checks if the listeners are currently attached.
+     *
+     * @returns True if the listeners are currently attached, false otherwise.
+     */
+    isAttached(): boolean;
+    /**
+     * Attaches the listeners for unhandled promise rejections and uncaught
+     * exceptions.
+     *
+     * If the listeners are already attached, this method does nothing.
+     */
+    attach(): void;
+    /**
+     * Detaches the listeners for unhandled promise rejections and uncaught
+     * exceptions.
+     *
+     * If the listeners are not attached, this method does nothing.
+     */
+    detach(): void;
+    private handleError;
+    private handleUnhandledRejection;
+    private handleUncaughtException;
+}
+//# sourceMappingURL=error-listeners.d.ts.map

package/dist/process/error-listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-listeners.d.ts","sourceRoot":"","sources":["../../src/process/error-listeners.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAChC,mBAAmB,GACnB,oBAAoB,CAAC;AAExB,qBAAa,uBAAwB,SAAQ,KAAK;IAGhD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAF1C,YACC,MAAM,EAAE,OAAO,EACN,OAAO,GAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAW,EAKhD;CACD;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,YAAY,KAAK,EAAE,KAAK,EAMvB;CACD;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,OAAO,CAAC,EACL,CAAC,CAAC,KAAK,EAAE,uBAAuB,GAAG,sBAAsB,KAAK,IAAI,CAAC,GACnE,IAAI,CAAC;CACR,CAAC;AAOF;;;GAGG;AACH,qBAAa,cAAc;IAWzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;;;;OAKG;IACH,YACkB,QAAQ,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE,qBAAqB,EAG/B;IAED;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAEpB;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAeb;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAGb;IAED,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,uBAAuB;CAiB/B"}

package/dist/process/error-listeners.js

@@ -0,0 +1,113 @@
+import { writeFileSync } from "node:fs";
+import { EOL } from "node:os";
+import { defaults, formatError } from "@ac-kit/core";
+export class UnhandledRejectionError extends Error {
+    promise;
+    constructor(reason, promise = null) {
+        super("Unhandled rejection", { cause: reason });
+        this.promise = promise;
+        this.name = "UnhandledRejectionError";
+    }
+}
+export class UncaughtExceptionError extends Error {
+    constructor(error) {
+        super("Uncaught exception", {
+            cause: error,
+        });
+        this.name = "UncaughtExceptionError";
+    }
+}
+const ERROR_LISTENERS_DEFAULT_OPTIONS = {
+    silent: false,
+    onError: null,
+};
+/**
+ * A utility class that listens for unhandled promise rejections and uncaught
+ * exceptions, logs them to a specified file, or if that fails, to stderr.
+ */
+export class ErrorListeners {
+    filePath;
+    options;
+    detacher = null;
+    /**
+     * Creates a new instance of LoggerErrorListeners.
+     *
+     * @param filePath The path to the file where errors will be logged.
+     * @param options The options for the LoggerErrorListeners.
+     */
+    constructor(filePath, options) {
+        this.filePath = filePath;
+        this.options = defaults(options, ERROR_LISTENERS_DEFAULT_OPTIONS);
+    }
+    /**
+     * Checks if the listeners are currently attached.
+     *
+     * @returns True if the listeners are currently attached, false otherwise.
+     */
+    isAttached() {
+        return this.detacher !== null;
+    }
+    /**
+     * Attaches the listeners for unhandled promise rejections and uncaught
+     * exceptions.
+     *
+     * If the listeners are already attached, this method does nothing.
+     */
+    attach() {
+        if (this.isAttached()) {
+            return;
+        }
+        const unhandledRejectionHandler = this.handleUnhandledRejection.bind(this);
+        const uncaughtExceptionHandler = this.handleUncaughtException.bind(this);
+        process.on("unhandledRejection", unhandledRejectionHandler);
+        process.on("uncaughtException", uncaughtExceptionHandler);
+        this.detacher = () => {
+            process.removeListener("unhandledRejection", unhandledRejectionHandler);
+            process.removeListener("uncaughtException", uncaughtExceptionHandler);
+        };
+    }
+    /**
+     * Detaches the listeners for unhandled promise rejections and uncaught
+     * exceptions.
+     *
+     * If the listeners are not attached, this method does nothing.
+     */
+    detach() {
+        this.detacher?.();
+        this.detacher = null;
+    }
+    handleError(error) {
+        const message = `[${new Date().toISOString()}] ${formatError(error, { stackTrace: true })}${EOL}`;
+        try {
+            writeFileSync(this.filePath, message, { flag: "a" });
+        }
+        catch {
+            if (!this.options.silent) {
+                process.stderr.write(message);
+            }
+        }
+    }
+    handleUnhandledRejection(reason, promise) {
+        try {
+            const wrappedError = new UnhandledRejectionError(reason, promise);
+            this.handleError(wrappedError);
+            this.options.onError?.(wrappedError);
+        }
+        catch { }
+    }
+    handleUncaughtException(error, origin) {
+        try {
+            let wrappedError;
+            if (origin === "unhandledRejection") {
+                wrappedError = new UnhandledRejectionError(error);
+            }
+            else {
+                wrappedError = new UncaughtExceptionError(error);
+            }
+            this.handleError(wrappedError);
+            this.options.onError?.(wrappedError);
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=error-listeners.js.map

package/dist/process/error-listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-listeners.js","sourceRoot":"","sources":["../../src/process/error-listeners.ts"],"names":[],"mappings":"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"}

package/dist/process/exit-manager.d.ts

@@ -0,0 +1,58 @@
+import { type Callable, type MaybeAsyncCallable } from "@ac-kit/core";
+export declare enum ExitManagerPriority {
+    VERY_EARLY = 300,
+    EARLY = 200,
+    VERY_HIGH = 100,
+    HIGH = 50,
+    NORMAL = 0,
+    LOW = -50,
+    VERY_LOW = -100,
+    LATE = -200,
+    VERY_LATE = -300
+}
+export declare class ExitManager {
+    private static instance;
+    static getInstance(): ExitManager;
+    private exitHandlers;
+    private cleanUpHandlers;
+    private constructor();
+    /**
+     * Register a possibly asynchronous clean-up handler to be called when the
+     * process is exiting.
+     *
+     * Note: The handler can be an asynchronous function. The process will wait
+     * for the promise to resolve before exiting.
+     *
+     * @param handler A function to be called on process exit.
+     * @param priority The priority of the clean-up handler.
+     */
+    registerCleanUpHandler(handler: MaybeAsyncCallable, priority?: ExitManagerPriority): Callable;
+    /**
+     * Unregister a previously registered clean-up handler.
+     *
+     * @param handler A function to be removed from the clean-up handlers.
+     * @param priority The priority of the clean-up handler. (optional, for
+     *   disambiguation)
+     */
+    unregisterCleanUpHandler(handler: MaybeAsyncCallable, priority?: ExitManagerPriority): void;
+    /**
+     * Registers a synchronous exit handler to be called when the process is
+     * exiting.
+     *
+     * Note: The handler should be a synchronous function. Asynchronous operations
+     * may not complete before the process exits.
+     *
+     * @param handler A synchronous function to be called on process exit.
+     * @param priority The priority of the exit handler.
+     */
+    registerExitHandler(handler: Callable, priority?: ExitManagerPriority): Callable;
+    /**
+     * Unregister a previously registered exit handler.
+     *
+     * @param handler A function to be removed from the exit handlers.
+     * @param priority The priority of the exit handler. (optional, for
+     *   disambiguation)
+     */
+    unregisterExitHandler(handler: Callable, priority?: ExitManagerPriority): void;
+}
+//# sourceMappingURL=exit-manager.d.ts.map

package/dist/process/exit-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-manager.d.ts","sourceRoot":"","sources":["../../src/process/exit-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,MAAM,cAAc,CAAC;AAGtB,oBAAY,mBAAmB;IAC9B,UAAU,MAAM;IAChB,KAAK,MAAM;IACX,SAAS,MAAM;IACf,IAAI,KAAK;IACT,MAAM,IAAI;IACV,GAAG,MAAM;IACT,QAAQ,OAAO;IACf,IAAI,OAAO;IACX,SAAS,OAAO;CAChB;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,MAAM,CAAC,WAAW,IAAI,WAAW,CAKhC;IAED,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,eAAe,CAA2C;IAElE,OAAO,eAcN;IAED;;;;;;;;;OASG;IACH,sBAAsB,CACrB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,GAAE,mBAAuB,GAC/B,QAAQ,CAIV;IAED;;;;;;OAMG;IACH,wBAAwB,CACvB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAIN;IAED;;;;;;;;;OASG;IACH,mBAAmB,CAClB,OAAO,EAAE,QAAQ,EACjB,QAAQ,GAAE,mBAAgD,GACxD,QAAQ,CAIV;IAED;;;;;;OAMG;IACH,qBAAqB,CACpB,OAAO,EAAE,QAAQ,EACjB,QAAQ,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAIN;CACD"}

package/dist/process/exit-manager.js

@@ -0,0 +1,88 @@
+import { catchOutOfBand, catchOutOfBandAsync, } from "@ac-kit/core";
+import { PriorityQueue } from "@ac-kit/data";
+export var ExitManagerPriority;
+(function (ExitManagerPriority) {
+    ExitManagerPriority[ExitManagerPriority["VERY_EARLY"] = 300] = "VERY_EARLY";
+    ExitManagerPriority[ExitManagerPriority["EARLY"] = 200] = "EARLY";
+    ExitManagerPriority[ExitManagerPriority["VERY_HIGH"] = 100] = "VERY_HIGH";
+    ExitManagerPriority[ExitManagerPriority["HIGH"] = 50] = "HIGH";
+    ExitManagerPriority[ExitManagerPriority["NORMAL"] = 0] = "NORMAL";
+    ExitManagerPriority[ExitManagerPriority["LOW"] = -50] = "LOW";
+    ExitManagerPriority[ExitManagerPriority["VERY_LOW"] = -100] = "VERY_LOW";
+    ExitManagerPriority[ExitManagerPriority["LATE"] = -200] = "LATE";
+    ExitManagerPriority[ExitManagerPriority["VERY_LATE"] = -300] = "VERY_LATE";
+})(ExitManagerPriority || (ExitManagerPriority = {}));
+export class ExitManager {
+    static instance = null;
+    static getInstance() {
+        if (!ExitManager.instance) {
+            ExitManager.instance = new ExitManager();
+        }
+        return ExitManager.instance;
+    }
+    exitHandlers = new PriorityQueue();
+    cleanUpHandlers = new PriorityQueue();
+    constructor() {
+        process.on("beforeExit", async () => {
+            let handler;
+            while ((handler = this.cleanUpHandlers.extract()) !== undefined) {
+                await catchOutOfBandAsync(handler);
+            }
+        });
+        process.on("exit", () => {
+            let handler;
+            while ((handler = this.exitHandlers.extract()) !== undefined) {
+                catchOutOfBand(handler);
+            }
+        });
+    }
+    /**
+     * Register a possibly asynchronous clean-up handler to be called when the
+     * process is exiting.
+     *
+     * Note: The handler can be an asynchronous function. The process will wait
+     * for the promise to resolve before exiting.
+     *
+     * @param handler A function to be called on process exit.
+     * @param priority The priority of the clean-up handler.
+     */
+    registerCleanUpHandler(handler, priority = 0) {
+        this.cleanUpHandlers.insert(priority, handler);
+        return () => this.unregisterCleanUpHandler(handler);
+    }
+    /**
+     * Unregister a previously registered clean-up handler.
+     *
+     * @param handler A function to be removed from the clean-up handlers.
+     * @param priority The priority of the clean-up handler. (optional, for
+     *   disambiguation)
+     */
+    unregisterCleanUpHandler(handler, priority) {
+        this.cleanUpHandlers.remove((f, p) => f === handler && (priority === undefined || p === priority));
+    }
+    /**
+     * Registers a synchronous exit handler to be called when the process is
+     * exiting.
+     *
+     * Note: The handler should be a synchronous function. Asynchronous operations
+     * may not complete before the process exits.
+     *
+     * @param handler A synchronous function to be called on process exit.
+     * @param priority The priority of the exit handler.
+     */
+    registerExitHandler(handler, priority = ExitManagerPriority.NORMAL) {
+        this.exitHandlers.insert(priority, handler);
+        return () => this.unregisterExitHandler(handler);
+    }
+    /**
+     * Unregister a previously registered exit handler.
+     *
+     * @param handler A function to be removed from the exit handlers.
+     * @param priority The priority of the exit handler. (optional, for
+     *   disambiguation)
+     */
+    unregisterExitHandler(handler, priority) {
+        this.exitHandlers.remove((f, p) => f === handler && (priority === undefined || p === priority));
+    }
+}
+//# sourceMappingURL=exit-manager.js.map

package/dist/process/exit-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-manager.js","sourceRoot":"","sources":["../../src/process/exit-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,mBAAmB,GAGnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAN,IAAY,mBAUX;AAVD,WAAY,mBAAmB;IAC9B,2EAAgB,CAAA;IAChB,iEAAW,CAAA;IACX,yEAAe,CAAA;IACf,8DAAS,CAAA;IACT,iEAAU,CAAA;IACV,6DAAS,CAAA;IACT,wEAAe,CAAA;IACf,gEAAW,CAAA;IACX,0EAAgB,CAAA;AACjB,CAAC,EAVW,mBAAmB,KAAnB,mBAAmB,QAU9B;AAED,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,QAAQ,GAAuB,IAAI,CAAC;IACnD,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC3B,WAAW,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAEO,YAAY,GAAG,IAAI,aAAa,EAAY,CAAC;IAC7C,eAAe,GAAG,IAAI,aAAa,EAAsB,CAAC;IAElE;QACC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;YACnC,IAAI,OAAuC,CAAC;YAC5C,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBACjE,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACvB,IAAI,OAA6B,CAAC;YAClC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9D,cAAc,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,sBAAsB,CACrB,OAA2B,EAC3B,QAAQ,GAAwB,CAAC;QAEjC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE/C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,wBAAwB,CACvB,OAA2B,EAC3B,QAA8B;QAE9B,IAAI,CAAC,eAAe,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,CAAC,CACrE,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,mBAAmB,CAClB,OAAiB,EACjB,QAAQ,GAAwB,mBAAmB,CAAC,MAAM;QAE1D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE5C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CACpB,OAAiB,EACjB,QAA8B;QAE9B,IAAI,CAAC,YAAY,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,CAAC,CACrE,CAAC;IACH,CAAC;CACD"}