prismcast 1.12.0 → 1.13.0

package/dist/utils/format.js

@@ -1,22 +1,25 @@
+import { isIP } from "node:net";
+import { systemClock } from "homebridge-plugin-utils";
 /**
  * Formats the current date and time as a log timestamp string: `yyyy/mm/dd hh:mm:ss.mmm AM/PM`. Uses 12-hour time with decimalized seconds and AM/PM.
  * Single source of truth for all log timestamp formatting - used by the console wrapper in app.ts, the file logger, the Morgan HTTP request logger, and the SSE log
  * emitter.
+ * @param now - The instant to format, as epoch milliseconds; defaults to the system clock's reading.
  * @returns Formatted timestamp string.
  */
-export function formatTimestamp() {
-    const now = new Date();
-    const yyyy = String(now.getFullYear());
-    const mm = String(now.getMonth() + 1).padStart(2, "0");
-    const dd = String(now.getDate()).padStart(2, "0");
-    let hours = now.getHours();
+export function formatTimestamp(now = systemClock.now()) {
+    const stamp = new Date(now);
+    const yyyy = String(stamp.getFullYear());
+    const mm = String(stamp.getMonth() + 1).padStart(2, "0");
+    const dd = String(stamp.getDate()).padStart(2, "0");
+    let hours = stamp.getHours();
     const ampm = (hours >= 12) ? "PM" : "AM";
     hours = hours % 12;
     hours ||= 12;
     const hh = String(hours).padStart(2, "0");
-    const min = String(now.getMinutes()).padStart(2, "0");
-    const ss = String(now.getSeconds()).padStart(2, "0");
-    const ms = String(now.getMilliseconds()).padStart(3, "0");
+    const min = String(stamp.getMinutes()).padStart(2, "0");
+    const ss = String(stamp.getSeconds()).padStart(2, "0");
+    const ms = String(stamp.getMilliseconds()).padStart(3, "0");
     return yyyy + "/" + mm + "/" + dd + " " + hh + ":" + min + ":" + ss + "." + ms + " " + ampm;
 }
 /**
@@ -47,10 +50,11 @@ export function formatDuration(value, unit = "ms") {
  * Formats a Unix millisecond timestamp as a human-readable relative time string (e.g., "2 minutes ago", "3 hours ago", "5 days ago"). Used for health indicator
  * tooltips where absolute timestamps would be harder to interpret at a glance.
  * @param timestamp - Unix millisecond timestamp.
+ * @param now - The instant the distance is measured from, as epoch milliseconds; defaults to the system clock's reading.
  * @returns Relative time string.
  */
-export function formatTimeAgo(timestamp) {
-    const seconds = Math.floor((Date.now() - timestamp) / 1000);
+export function formatTimeAgo(timestamp, now = systemClock.now()) {
+    const seconds = Math.floor((now - timestamp) / 1000);
     if (seconds < 60) {
         return "just now";
     }
@@ -65,15 +69,50 @@ export function formatTimeAgo(timestamp) {
     const days = Math.floor(hours / 24);
     return String(days) + (days === 1 ? " day ago" : " days ago");
 }
+/**
+ * Display labels for the standard vertical resolutions, keyed by the height in pixels. This is the single source of truth for the label a resolution is shown
+ * under: the native HLS quality suffix in the log, the stream detail's codec line in the web UI, and anything else that renders a resolution to a person all
+ * read it from here. A height with no entry has no standard label, and its caller falls back to the raw resolution string.
+ */
+export const RESOLUTION_LABELS = { "1080": "1080p", "2160": "4K", "360": "360p", "480": "480p", "720": "720p" };
+/**
+ * Formats a pixel size as the "WIDTHxHEIGHT" string the codebase carries resolutions in. This is the one producer of that form, and it matches the shape the
+ * native probe reads verbatim out of a manifest's RESOLUTION attribute, so a resolution that came off the wire and one this function built are the same string
+ * to every consumer downstream - the label lookup below included.
+ * @param width - The width in pixels.
+ * @param height - The height in pixels.
+ * @returns The size as "WIDTHxHEIGHT".
+ */
+export function formatResolution(width, height) {
+    return String(width) + "x" + String(height);
+}
+/**
+ * Formats a "WIDTHxHEIGHT" resolution string as its standard display label, falling back to the resolution string itself when the height carries no standard
+ * label. The fallback is what keeps a non-standard rendition visible rather than dropped: a 1234x999 variant renders as "1234x999" instead of disappearing.
+ * @param resolution - The resolution as "WIDTHxHEIGHT".
+ * @returns The display label, or the resolution string when the height has no label.
+ */
+export function formatResolutionLabel(resolution) {
+    const height = resolution.split("x")[1];
+    return (height ? RESOLUTION_LABELS[height] : undefined) ?? resolution;
+}
 /**
  * Extracts a concise domain from a URL by keeping only the last two portions of the hostname (e.g., "watch.foodnetwork.com" becomes "foodnetwork.com",
- * "www.hulu.com" becomes "hulu.com"). Used as a standard domain key for DOMAIN_CONFIG lookups and as a display fallback when no service name is configured.
+ * "www.hulu.com" becomes "hulu.com"). An IP-literal host is returned whole, because an address has no registrable domain to shorten. Used as a standard domain key
+ * for DOMAIN_CONFIG lookups and as a display fallback when no service name is configured.
  * @param url - The URL to extract the domain from.
  * @returns The concise domain, or the original URL if parsing fails.
  */
 export function extractDomain(url) {
     try {
         const hostname = new URL(url).hostname;
+        /* An IP literal has no registrable domain to shorten, so it is returned whole: "10.0.1.50" names one host, and its last two parts ("1.50") name nothing. Only
+         * the dotted-quad form needs the check - an IPv6 literal arrives from URL.hostname bracketed and with no dots at all, so the part count below already returns
+         * it unchanged - but isIP covers both and states the rule the code is actually applying.
+         */
+        if (isIP(hostname) !== 0) {
+            return hostname;
+        }
         const parts = hostname.split(".");
         // Keep only the last two parts (e.g., "foodnetwork.com"). For single-part hostnames (e.g., "localhost"), return as-is.
         if (parts.length > 2) {
@@ -102,6 +141,21 @@ export function extractPathname(url) {
         return null;
     }
 }
+/**
+ * Resolves a potentially relative URL against a base URL. Handles both absolute and relative URLs.
+ *
+ * @param url - The URL to resolve (may be relative or absolute).
+ * @param baseUrl - The base URL for resolving relative references.
+ * @returns The resolved absolute URL.
+ */
+export function resolveUrl(url, baseUrl) {
+    // If the URL is already absolute, return it directly.
+    if (url.startsWith("http://") || url.startsWith("https://")) {
+        return url;
+    }
+    // Use the URL constructor to resolve relative URLs against the base.
+    return new URL(url, baseUrl).href;
+}
 /**
  * Capitalizes the first letter of a string.
  * @param str - The string to capitalize.

package/dist/utils/format.js.map

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

package/dist/utils/index.d.ts

@@ -1,7 +1,6 @@
 export * from "./bootSession.ts";
 export * from "./chromeFetch.ts";
 export * from "./cliOutput.ts";
-export * from "./clock.ts";
 export * from "./debugFilter.ts";
 export * from "./delay.ts";
 export * from "./errors.ts";
@@ -14,6 +13,7 @@ export * from "./m3u.ts";
 export * from "./markup.ts";
 export * from "./morganStream.ts";
 export * from "./network.ts";
+export * from "./never.ts";
 export * from "./pid.ts";
 export * from "./platform.ts";
 export * from "./processInspector.ts";
@@ -23,4 +23,3 @@ export * from "./sanitize.ts";
 export * from "./streamContext.ts";
 export * from "./timing.ts";
 export * from "./version.ts";
-//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -5,7 +5,6 @@
 export * from "./bootSession.js";
 export * from "./chromeFetch.js";
 export * from "./cliOutput.js";
-export * from "./clock.js";
 export * from "./debugFilter.js";
 export * from "./delay.js";
 export * from "./errors.js";
@@ -18,6 +17,7 @@ export * from "./m3u.js";
 export * from "./markup.js";
 export * from "./morganStream.js";
 export * from "./network.js";
+export * from "./never.js";
 export * from "./pid.js";
 export * from "./platform.js";
 export * from "./processInspector.js";

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/utils/logEmitter.d.ts

@@ -15,4 +15,3 @@ export declare function emitLogEntry(entry: LogEntry): void;
  * @returns A function to unsubscribe the callback.
  */
 export declare function subscribeToLogs(callback: (entry: LogEntry) => void): () => void;
-//# sourceMappingURL=logEmitter.d.ts.map

package/dist/utils/logger.d.ts

@@ -89,4 +89,3 @@ export declare const LOG: {
     withStreamId: (streamId: string) => BoundLogger;
 };
 export {};
-//# sourceMappingURL=logger.d.ts.map

package/dist/utils/m3u.d.ts

@@ -45,4 +45,3 @@ export declare function generateChannelKey(name: string): string;
  * @returns Parse result containing channels and any errors encountered.
  */
 export declare function parseM3U(content: string): M3UParseResult;
-//# sourceMappingURL=m3u.d.ts.map

package/dist/utils/markup.d.ts

@@ -21,4 +21,3 @@ export declare function escapeXml(value: string): string;
  * @returns The serialized attribute fragment, or the empty string when no attribute would be emitted.
  */
 export declare function serializeAttrs(attrs: Readonly<Record<string, string | boolean | undefined>>): string;
-//# sourceMappingURL=markup.d.ts.map

package/dist/utils/memo.d.ts

@@ -17,4 +17,3 @@
  * @returns A function that returns the same Promise<T> on every call.
  */
 export declare function memoizeAsync<T>(probe: () => Promise<T>): () => Promise<T>;
-//# sourceMappingURL=memo.d.ts.map

package/dist/utils/morganStream.d.ts

@@ -1,8 +1,7 @@
 import type { StreamOptions } from "morgan";
 /**
- * Creates a Morgan stream options object that routes log output based on the logging mode. When console logging is active, output goes to stdout with a timestamp
- * prefix. When file logging is active, output goes to the file logger which adds its own timestamp.
+ * Creates a Morgan stream options object that routes log output based on the logging mode. When console logging is active, the payload goes to stdout, which the
+ * entry path's console wrapper stamps. When file logging is active, it goes to the file logger, which stamps the entry it appends.
  * @returns StreamOptions object for Morgan configuration.
  */
 export declare function createMorganStream(): StreamOptions;
-//# sourceMappingURL=morganStream.d.ts.map

package/dist/utils/morganStream.js

@@ -1,15 +1,14 @@
-import { formatTimestamp } from "./format.js";
 import { isConsoleLogging } from "./logger.js";
 import { writeLogEntry } from "./fileLogger.js";
 /* Morgan HTTP request logger needs a writable stream to output log entries. By default, Morgan writes to stdout. This adapter routes Morgan output to either the
  * console or the file logger based on the current logging mode, ensuring HTTP request logs follow the same path as application logs.
  *
- * Timestamps are added here rather than in the Morgan format string to ensure consistency: the file logger adds timestamps via writeLogEntry(), so we add them
- * manually for console mode to match.
+ * The adapter stamps nothing itself, because both destinations stamp for it: in console mode the entry path wraps console.log to prepend a timestamp to every
+ * console line in the process, and in file mode writeLogEntry() prefixes the entry it appends. A stamp added here would be the second one on the line.
  */
 /**
- * Creates a Morgan stream options object that routes log output based on the logging mode. When console logging is active, output goes to stdout with a timestamp
- * prefix. When file logging is active, output goes to the file logger which adds its own timestamp.
+ * Creates a Morgan stream options object that routes log output based on the logging mode. When console logging is active, the payload goes to stdout, which the
+ * entry path's console wrapper stamps. When file logging is active, it goes to the file logger, which stamps the entry it appends.
  * @returns StreamOptions object for Morgan configuration.
  */
 export function createMorganStream() {
@@ -18,10 +17,9 @@ export function createMorganStream() {
             // Remove trailing newline that Morgan adds since our loggers handle newlines.
             const trimmedMessage = message.trim();
             if (isConsoleLogging()) {
-                // Console logging mode - add timestamp prefix and write to stdout.
-                const timestamp = formatTimestamp();
+                // Console logging mode - the console wrapper installed at startup supplies the timestamp, so the payload goes out as it came in.
                 // eslint-disable-next-line no-console
-                console.log("[" + timestamp + "] " + trimmedMessage);
+                console.log(trimmedMessage);
             }
             else {
                 // File logging mode - route through the file logger which adds its own timestamp. HTTP request logs use the default terminal color, matching info-level output.

package/dist/utils/morganStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"morganStream.js","sourceRoot":"","sources":["../../src/utils/morganStream.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAEhC,OAAO;QAEL,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE;YAE/B,8EAA8E;YAC9E,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAEtC,IAAG,gBAAgB,EAAE,EAAE,CAAC;gBAEtB,mEAAmE;gBACnE,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;gBAEpC,sCAAsC;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,GAAG,IAAI,GAAG,cAAc,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBAEN,gKAAgK;gBAChK,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"morganStream.js","sourceRoot":"","sources":["../../src/utils/morganStream.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAEhC,OAAO;QAEL,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE;YAE/B,8EAA8E;YAC9E,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAEtC,IAAG,gBAAgB,EAAE,EAAE,CAAC;gBAEtB,iIAAiI;gBACjI,sCAAsC;gBACtC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBAEN,gKAAgK;gBAChK,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/network.d.ts

@@ -6,4 +6,3 @@
  * @returns The canonical client address - IPv6 addresses pass through unchanged; IPv4 addresses are returned without the IPv6 mapping prefix.
  */
 export declare function normalizeClientAddress(address: string): string;
-//# sourceMappingURL=network.d.ts.map

package/dist/utils/never.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Exhaustiveness guard for a switch over a union. A switch's default arm calls it with the narrowed value, which is what makes a member without an arm fail
+ * to compile; the throw reports a value that reaches it at runtime rather than letting the switch fall through in silence.
+ * @param value - The value the switch did not handle. Narrowed to never when every member of the union has an arm.
+ * @returns Never returns.
+ * @throws Always, naming the value that was not handled.
+ */
+export declare function assertNever(value: never): never;

package/dist/utils/never.js

@@ -0,0 +1,20 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * never.ts: Exhaustiveness guard for switches over discriminated unions.
+ */
+/* A switch over a discriminated union is only as complete as the arms someone remembered to write, and a union grows. Calling this from the default arm is
+ * what turns a forgotten arm into a compile error: once every member is handled, the value that reaches the default is narrowed to `never` and satisfies the
+ * parameter, and a member added later widens it to a type the parameter rejects. The throw is the runtime half, for a value that entered from outside the type
+ * system - parsed JSON, a wire payload, a hand-edited file - where the compile-time proof cannot reach.
+ */
+/**
+ * Exhaustiveness guard for a switch over a union. A switch's default arm calls it with the narrowed value, which is what makes a member without an arm fail
+ * to compile; the throw reports a value that reaches it at runtime rather than letting the switch fall through in silence.
+ * @param value - The value the switch did not handle. Narrowed to never when every member of the union has an arm.
+ * @returns Never returns.
+ * @throws Always, naming the value that was not handled.
+ */
+export function assertNever(value) {
+    throw new Error("Unhandled value: " + JSON.stringify(value) + ".");
+}
+//# sourceMappingURL=never.js.map

package/dist/utils/never.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"never.js","sourceRoot":"","sources":["../../src/utils/never.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IAEtC,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AACrE,CAAC"}

package/dist/utils/pid.d.ts

@@ -15,4 +15,3 @@ export declare function isProcessRunning(pid: number): boolean;
 export declare function clearPidFile(filePath: string, label: string, log?: {
     warn: (message: string, ...args: unknown[]) => void;
 }): void;
-//# sourceMappingURL=pid.d.ts.map

package/dist/utils/platform.d.ts

@@ -42,4 +42,3 @@ export declare function getPrismCastEntryPoint(): string;
  * @returns The absolute path to the PrismCast working directory.
  */
 export declare function getPrismCastWorkingDirectory(): string;
-//# sourceMappingURL=platform.d.ts.map

package/dist/utils/processInspector.context.d.ts

@@ -1,8 +1,38 @@
-import type { ProcessInspectorContext } from "./processInspector.ts";
+import type { ProcessInfo, ProcessInspectorContext } from "./processInspector.ts";
+import type { Nullable } from "../types/index.ts";
 /**
  * Builds the default ProcessInspectorContext from real runtime I/O. Dispatches to the platform-appropriate enumerator at adapter-creation time so the chosen
  * branch is captured in a closure for every subsequent enumerate() call.
  * @returns A ProcessInspectorContext wired to the current platform's process table reader.
  */
 export declare function createDefaultProcessInspectorContext(): ProcessInspectorContext;
-//# sourceMappingURL=processInspector.context.d.ts.map
+/**
+ * Parses a single /proc/<pid>/cmdline payload. The on-disk format separates argv entries with NUL bytes and may or may not include a trailing NUL. Empty
+ * payloads (kernel threads, zombie processes) yield an empty command line - callers decide whether to drop those entries.
+ * @param raw - The /proc/<pid>/cmdline payload.
+ * @returns The decoded command line.
+ */
+export declare function parseLinuxProcCmdline(raw: string): string;
+/**
+ * Parses the ppid (field 4) from a /proc/<pid>/stat payload. The format embeds the executable name in parentheses at field 2; that name can contain
+ * whitespace and parentheses itself, so we anchor on the last closing paren before splitting. After the closing paren, the first field is field 3 (state) and
+ * the second is field 4 (ppid).
+ * @param raw - The /proc/<pid>/stat payload.
+ * @returns The parent process ID, or null when the payload is malformed.
+ */
+export declare function parseLinuxProcStat(raw: string): Nullable<number>;
+/**
+ * Parses the output of `ps -axww -o pid=,ppid=,command=` (or equivalent shape). Each non-empty line begins with leading whitespace, then the PID and PPID as
+ * integers, then whitespace, then the full command. Lines that do not match this shape are silently dropped.
+ * @param raw - The raw ps output.
+ * @returns The parsed process table.
+ */
+export declare function parseMacOsPsOutput(raw: string): ProcessInfo[];
+/**
+ * Parses the output of PowerShell's `Get-CimInstance Win32_Process | Format-List ProcessId,ParentProcessId,CommandLine` (or equivalent shape). The format
+ * places each property on its own line as "Name : Value", with blank lines separating records. CommandLine may be blank (system processes) or contain
+ * embedded colons - we split on the first " : " separator only.
+ * @param raw - The raw Format-List output.
+ * @returns The parsed process table.
+ */
+export declare function parseWindowsFormatListOutput(raw: string): ProcessInfo[];

package/dist/utils/processInspector.context.js

@@ -1,4 +1,3 @@
-import { parseLinuxProcCmdline, parseLinuxProcStat, parseMacOsPsOutput, parseWindowsFormatListOutput } from "./processInspector.js";
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
@@ -103,4 +102,121 @@ function enumerateWindows() {
         return [];
     }
 }
+/**
+ * Parses a single /proc/<pid>/cmdline payload. The on-disk format separates argv entries with NUL bytes and may or may not include a trailing NUL. Empty
+ * payloads (kernel threads, zombie processes) yield an empty command line - callers decide whether to drop those entries.
+ * @param raw - The /proc/<pid>/cmdline payload.
+ * @returns The decoded command line.
+ */
+export function parseLinuxProcCmdline(raw) {
+    // Drop a trailing NUL if present so the join does not produce a phantom blank arg.
+    const trimmed = raw.endsWith("\0") ? raw.slice(0, -1) : raw;
+    return trimmed.split("\0").join(" ");
+}
+/**
+ * Parses the ppid (field 4) from a /proc/<pid>/stat payload. The format embeds the executable name in parentheses at field 2; that name can contain
+ * whitespace and parentheses itself, so we anchor on the last closing paren before splitting. After the closing paren, the first field is field 3 (state) and
+ * the second is field 4 (ppid).
+ * @param raw - The /proc/<pid>/stat payload.
+ * @returns The parent process ID, or null when the payload is malformed.
+ */
+export function parseLinuxProcStat(raw) {
+    const rparen = raw.lastIndexOf(")");
+    if (rparen === -1) {
+        return null;
+    }
+    const fields = raw.slice(rparen + 1).trim().split(/\s+/);
+    // We want field 4 (ppid), which lands at index 1 in the post-paren split: index 0 is state (field 3), index 1 is ppid (field 4).
+    if (fields.length < 2) {
+        return null;
+    }
+    const ppid = parseInt(fields[1] ?? "", 10);
+    return Number.isNaN(ppid) ? null : ppid;
+}
+/**
+ * Parses the output of `ps -axww -o pid=,ppid=,command=` (or equivalent shape). Each non-empty line begins with leading whitespace, then the PID and PPID as
+ * integers, then whitespace, then the full command. Lines that do not match this shape are silently dropped.
+ * @param raw - The raw ps output.
+ * @returns The parsed process table.
+ */
+export function parseMacOsPsOutput(raw) {
+    const results = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed === "") {
+            continue;
+        }
+        // Three captures: pid, ppid, and the rest. The command line is the rest of the line verbatim (may contain spaces).
+        const match = /^(\d+)\s+(\d+)\s+(.+)$/.exec(trimmed);
+        if (match === null) {
+            continue;
+        }
+        const pid = parseInt(match[1] ?? "", 10);
+        const ppid = parseInt(match[2] ?? "", 10);
+        const commandLine = match[3] ?? "";
+        if (Number.isNaN(pid) || Number.isNaN(ppid)) {
+            continue;
+        }
+        results.push({ commandLine, pid, ppid });
+    }
+    return results;
+}
+/**
+ * Parses the output of PowerShell's `Get-CimInstance Win32_Process | Format-List ProcessId,ParentProcessId,CommandLine` (or equivalent shape). The format
+ * places each property on its own line as "Name : Value", with blank lines separating records. CommandLine may be blank (system processes) or contain
+ * embedded colons - we split on the first " : " separator only.
+ * @param raw - The raw Format-List output.
+ * @returns The parsed process table.
+ */
+export function parseWindowsFormatListOutput(raw) {
+    const results = [];
+    let currentPid = null;
+    let currentPpid = null;
+    let currentCommandLine = null;
+    // A record is only committed once both pid and ppid have been seen, since ownership decisions depend on both being present and trustworthy. A missing
+    // command line is tolerated and recorded as an empty string.
+    const flush = () => {
+        if ((currentPid !== null) && (currentPpid !== null)) {
+            results.push({ commandLine: currentCommandLine ?? "", pid: currentPid, ppid: currentPpid });
+        }
+        currentPid = null;
+        currentPpid = null;
+        currentCommandLine = null;
+    };
+    for (const line of raw.split(/\r?\n/)) {
+        if (line.trim() === "") {
+            flush();
+            continue;
+        }
+        // Format-List output is "Name : Value" with the colon surrounded by spaces. We split on the first " : " so values containing colons survive intact.
+        const sep = line.indexOf(" : ");
+        if (sep === -1) {
+            continue;
+        }
+        const key = line.slice(0, sep).trim();
+        const value = line.slice(sep + 3);
+        switch (key) {
+            case "ProcessId": {
+                const parsed = parseInt(value.trim(), 10);
+                currentPid = Number.isNaN(parsed) ? null : parsed;
+                break;
+            }
+            case "ParentProcessId": {
+                const parsed = parseInt(value.trim(), 10);
+                currentPpid = Number.isNaN(parsed) ? null : parsed;
+                break;
+            }
+            case "CommandLine": {
+                currentCommandLine = value;
+                break;
+            }
+            default: {
+                // Other Format-List keys (Name, Path, ...) are ignored. Tolerating extra fields keeps the parser robust to upstream additions.
+            }
+        }
+    }
+    // Flush the trailing record if the output did not end with a blank line.
+    flush();
+    return results;
+}
 //# sourceMappingURL=processInspector.context.js.map

package/dist/utils/processInspector.context.js.map

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

package/dist/utils/processInspector.d.ts

@@ -1,4 +1,3 @@
-import type { Nullable } from "../types/index.ts";
 /**
  * One row of the OS process table. The fields let domain code identify a process by intent and verify its ownership via the parent-child relationship. The
  * ppid in particular is what lets killStaleChrome safely run from any context: a process whose Chrome is matched by profile but whose ppid points at a live
@@ -22,34 +21,3 @@ export interface ProcessInspectorContext {
  * @returns The current process table.
  */
 export declare function listProcesses(ctx?: ProcessInspectorContext): ProcessInfo[];
-/**
- * Parses a single /proc/<pid>/cmdline payload. The on-disk format separates argv entries with NUL bytes and may or may not include a trailing NUL. Empty
- * payloads (kernel threads, zombie processes) yield an empty command line - callers decide whether to drop those entries.
- * @param raw - The /proc/<pid>/cmdline payload.
- * @returns The decoded command line.
- */
-export declare function parseLinuxProcCmdline(raw: string): string;
-/**
- * Parses the ppid (field 4) from a /proc/<pid>/stat payload. The format embeds the executable name in parentheses at field 2; that name can contain
- * whitespace and parentheses itself, so we anchor on the last closing paren before splitting. After the closing paren, the first field is field 3 (state) and
- * the second is field 4 (ppid).
- * @param raw - The /proc/<pid>/stat payload.
- * @returns The parent process ID, or null when the payload is malformed.
- */
-export declare function parseLinuxProcStat(raw: string): Nullable<number>;
-/**
- * Parses the output of `ps -axww -o pid=,ppid=,command=` (or equivalent shape). Each non-empty line begins with leading whitespace, then the PID and PPID as
- * integers, then whitespace, then the full command. Lines that do not match this shape are silently dropped.
- * @param raw - The raw ps output.
- * @returns The parsed process table.
- */
-export declare function parseMacOsPsOutput(raw: string): ProcessInfo[];
-/**
- * Parses the output of PowerShell's `Get-CimInstance Win32_Process | Format-List ProcessId,ParentProcessId,CommandLine` (or equivalent shape). The format
- * places each property on its own line as "Name : Value", with blank lines separating records. CommandLine may be blank (system processes) or contain
- * embedded colons - we split on the first " : " separator only.
- * @param raw - The raw Format-List output.
- * @returns The parsed process table.
- */
-export declare function parseWindowsFormatListOutput(raw: string): ProcessInfo[];
-//# sourceMappingURL=processInspector.d.ts.map