parasor 0.1.0

package/server/ipc/socket-server.js

@@ -0,0 +1,206 @@
+import { chmodSync, existsSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { createConnection, createServer, } from "node:net";
+import { join } from "node:path";
+import lockfile from "proper-lockfile";
+const MAX_REQUEST_SIZE = 64 * 1024;
+const READ_TIMEOUT = 2000;
+const LOCK_STALE_MS = 5000;
+function isPidAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "EPERM")
+            return true;
+        return false;
+    }
+}
+export class IpcServer {
+    server = null;
+    socketPath;
+    lockPath;
+    lockRelease = null;
+    handlers = new Map();
+    constructor(opts) {
+        this.socketPath = join(opts.dir, "parasor.sock");
+        this.lockPath = join(opts.dir, "parasor.lock");
+    }
+    onCommand(cmd, handler) {
+        this.handlers.set(cmd, handler);
+    }
+    async start() {
+        /*
+         * proper-lockfile enforces exclusion via an atomically-created
+         * `parasor.lock.lock` directory next to this file (mkdir is atomic on
+         * POSIX/Win) and considers the lock stale once the directory's mtime
+         * is older than LOCK_STALE_MS. That replaces the previous hand-rolled
+         * PID-file check which had a TOCTOU race (pid could be recycled
+         * between readFileSync and kill(pid,0)) and required SIGKILL
+         * survivors to hand-delete the file.
+         *
+         * The file itself is kept as a human-readable diagnostic: on ELOCKED
+         * we read the existing PID to include in the error message.
+         */
+        if (!existsSync(this.lockPath)) {
+            writeFileSync(this.lockPath, "", { mode: 0o600 });
+        }
+        try {
+            this.lockRelease = await lockfile.lock(this.lockPath, {
+                stale: LOCK_STALE_MS,
+                retries: 0,
+                realpath: false,
+            });
+        }
+        catch (err) {
+            if (err.code === "ELOCKED") {
+                const holderPid = this.readHolderPid();
+                const socketExists = existsSync(this.socketPath);
+                const socketLive = socketExists
+                    ? await this.probeSocket(this.socketPath)
+                    : false;
+                const pidAlive = holderPid ? isPidAlive(Number(holderPid)) : false;
+                throw new Error(this.formatAlreadyRunningError({
+                    holderPid,
+                    socketLive,
+                    pidAlive,
+                }));
+            }
+            throw err;
+        }
+        writeFileSync(this.lockPath, `pid=${process.pid}`, { mode: 0o600 });
+        if (existsSync(this.socketPath)) {
+            const isLive = await this.probeSocket(this.socketPath);
+            if (isLive) {
+                await this.releaseLockSafely();
+                throw new Error("Another parasor listener is alive on the same socket.");
+            }
+            try {
+                unlinkSync(this.socketPath);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        await new Promise((resolve, reject) => {
+            this.server = createServer((socket) => this.handleConnection(socket));
+            this.server.on("error", reject);
+            this.server.listen(this.socketPath, () => {
+                chmodSync(this.socketPath, 0o600);
+                resolve();
+            });
+        });
+    }
+    async stop() {
+        if (this.server) {
+            await new Promise((resolve) => this.server?.close(() => resolve()));
+            this.server = null;
+        }
+        try {
+            unlinkSync(this.socketPath);
+        }
+        catch {
+            /* ignore */
+        }
+        await this.releaseLockSafely();
+        try {
+            unlinkSync(this.lockPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    probeSocket(path) {
+        return new Promise((resolve) => {
+            const client = createConnection(path, () => {
+                client.destroy();
+                resolve(true);
+            });
+            client.on("error", () => resolve(false));
+            client.setTimeout(250, () => {
+                client.destroy();
+                resolve(false);
+            });
+        });
+    }
+    readHolderPid() {
+        try {
+            const content = readFileSync(this.lockPath, "utf-8").trim();
+            const match = content.match(/^pid=(\d+)/);
+            return match ? match[1] : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    formatAlreadyRunningError(info) {
+        const who = info.holderPid ? ` (pid ${info.holderPid})` : "";
+        const lockHint = `${this.lockPath}.lock`;
+        if (info.socketLive) {
+            return `parasor is already running${who}. Stop it first, or set PARASOR_CONFIG_DIR to a different directory to run a separate instance.`;
+        }
+        if (info.pidAlive && info.holderPid) {
+            return `parasor socket file missing or unresponsive, but pid ${info.holderPid} is alive. Run \`parasor restart\` (or \`parasor service restart\` if installed as a service) to recover.`;
+        }
+        return `parasor lock held but no live holder. Wait a few seconds and retry, or remove ${lockHint}.`;
+    }
+    async releaseLockSafely() {
+        if (!this.lockRelease)
+            return;
+        const release = this.lockRelease;
+        this.lockRelease = null;
+        try {
+            await release();
+        }
+        catch {
+            /* already released or lock broken -- nothing we can do */
+        }
+    }
+    handleConnection(socket) {
+        let data = "";
+        socket.setTimeout(READ_TIMEOUT, () => {
+            socket.destroy();
+        });
+        socket.on("data", (chunk) => {
+            data += chunk.toString();
+            if (data.length > MAX_REQUEST_SIZE) {
+                this.respond(socket, { ok: false, error: "request-too-large" });
+                return;
+            }
+            const newlineIdx = data.indexOf("\n");
+            if (newlineIdx === -1)
+                return;
+            const line = data.slice(0, newlineIdx);
+            void this.processRequest(socket, line);
+        });
+    }
+    async processRequest(socket, line) {
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            this.respond(socket, { ok: false, error: "invalid-json" });
+            return;
+        }
+        const handler = this.handlers.get(request.cmd);
+        if (!handler) {
+            this.respond(socket, { ok: false, error: "unknown-command" });
+            return;
+        }
+        try {
+            const response = await handler(request.args ?? {});
+            this.respond(socket, response);
+        }
+        catch (err) {
+            this.respond(socket, { ok: false, error: String(err) });
+        }
+    }
+    respond(socket, response) {
+        socket.end(`${JSON.stringify(response)}\n`);
+    }
+}
+//# sourceMappingURL=socket-server.js.map

package/server/ipc/socket-server.js.map

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

package/server/lib/git-exec.d.ts

@@ -0,0 +1,38 @@
+import type { Worktree } from "@parasor/shared";
+export interface GitExecResult {
+    stdout: string;
+    stderr: string;
+}
+export interface GitExecOptions {
+    timeoutMs?: number;
+    maxBuffer?: number;
+    env?: NodeJS.ProcessEnv;
+}
+export declare class GitExecError extends Error {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    constructor(message: string, stdout: string, stderr: string, exitCode: number | null);
+}
+export declare class WorktreeNotRegisteredError extends Error {
+    constructor(worktreePath: string);
+}
+/**
+ * Run `git -C <worktreePath> <args>`. Throws `GitExecError` carrying the git
+ * stderr so route handlers can surface meaningful messages. Caller is
+ * responsible for fencing `worktreePath` via `resolveWorktreePath` before
+ * invoking -- this wrapper does not validate the path.
+ */
+export declare function runGit(worktreePath: string, args: string[], options?: GitExecOptions): Promise<GitExecResult>;
+/**
+ * Verify `worktreePath` belongs to the project and return the canonical
+ * (realpath-resolved) absolute path safe to pass to git. Resolution catches
+ * symlink and `..` traversal; the registered-worktrees check catches
+ * arbitrary paths a client may try to inject. The project root itself
+ * (the main worktree) is always allowed.
+ *
+ * Comparison is realpath-based so case-insensitive filesystems
+ * (`/private/tmp` vs `/tmp` on macOS) match correctly.
+ */
+export declare function resolveWorktreePath(projectPath: string, worktreePath: string, registeredWorktrees: Worktree[]): Promise<string>;
+//# sourceMappingURL=git-exec.d.ts.map

package/server/lib/git-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-exec.d.ts","sourceRoot":"","sources":["../../src/lib/git-exec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOhD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,qBAAa,YAAa,SAAQ,KAAK;IAGnC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;gBAHhC,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI;CAKnC;AAED,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,YAAY,EAAE,MAAM;CAIjC;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,QAAQ,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/server/lib/git-exec.js

@@ -0,0 +1,96 @@
+import { execFile } from "node:child_process";
+import { realpath } from "node:fs/promises";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_BUFFER = 16 * 1024 * 1024;
+export class GitExecError extends Error {
+    stdout;
+    stderr;
+    exitCode;
+    constructor(message, stdout, stderr, exitCode) {
+        super(message);
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.name = "GitExecError";
+    }
+}
+export class WorktreeNotRegisteredError extends Error {
+    constructor(worktreePath) {
+        super(`Worktree not registered: ${worktreePath}`);
+        this.name = "WorktreeNotRegisteredError";
+    }
+}
+/**
+ * Run `git -C <worktreePath> <args>`. Throws `GitExecError` carrying the git
+ * stderr so route handlers can surface meaningful messages. Caller is
+ * responsible for fencing `worktreePath` via `resolveWorktreePath` before
+ * invoking -- this wrapper does not validate the path.
+ */
+export async function runGit(worktreePath, args, options = {}) {
+    const timeout = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const maxBuffer = options.maxBuffer ?? DEFAULT_MAX_BUFFER;
+    // Force C locale: route handlers parse stderr (e.g. "does not have any
+    // commits yet") to detect specific git failure modes. Without this, a
+    // non-English LANG/LC_ALL on the host turns those messages into translated
+    // strings and breaks the detection.
+    const env = {
+        ...process.env,
+        ...options.env,
+        LC_ALL: "C",
+        LANG: "C",
+    };
+    try {
+        const { stdout, stderr } = await execFileAsync("git", ["-C", worktreePath, ...args], {
+            timeout,
+            maxBuffer,
+            env,
+        });
+        return { stdout, stderr };
+    }
+    catch (err) {
+        const e = err;
+        const stdout = typeof e.stdout === "string"
+            ? e.stdout
+            : (e.stdout?.toString("utf8") ?? "");
+        const stderr = typeof e.stderr === "string"
+            ? e.stderr
+            : (e.stderr?.toString("utf8") ?? "");
+        const exitCode = typeof e.code === "number" ? e.code : null;
+        throw new GitExecError(e.message, stdout, stderr, exitCode);
+    }
+}
+/**
+ * Verify `worktreePath` belongs to the project and return the canonical
+ * (realpath-resolved) absolute path safe to pass to git. Resolution catches
+ * symlink and `..` traversal; the registered-worktrees check catches
+ * arbitrary paths a client may try to inject. The project root itself
+ * (the main worktree) is always allowed.
+ *
+ * Comparison is realpath-based so case-insensitive filesystems
+ * (`/private/tmp` vs `/tmp` on macOS) match correctly.
+ */
+export async function resolveWorktreePath(projectPath, worktreePath, registeredWorktrees) {
+    let resolvedTarget;
+    try {
+        resolvedTarget = await realpath(worktreePath);
+    }
+    catch {
+        throw new WorktreeNotRegisteredError(worktreePath);
+    }
+    const candidates = [projectPath, ...registeredWorktrees.map((w) => w.path)];
+    for (const candidate of candidates) {
+        let resolvedCandidate;
+        try {
+            resolvedCandidate = await realpath(candidate);
+        }
+        catch {
+            continue;
+        }
+        if (resolvedCandidate === resolvedTarget)
+            return resolvedTarget;
+    }
+    throw new WorktreeNotRegisteredError(worktreePath);
+}
+//# sourceMappingURL=git-exec.js.map

package/server/lib/git-exec.js.map

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

package/server/lib/open-in-ide.d.ts

@@ -0,0 +1,22 @@
+import type { IdeCommandConfig } from "@parasor/shared";
+export declare const supportedIdeEditors: readonly ["cursor", "vscode"];
+export type BuiltInIdeEditor = (typeof supportedIdeEditors)[number];
+export type IdeEditor = string;
+export declare class OpenInIdeError extends Error {
+    constructor(message: string);
+}
+export interface OpenInIdeOptions {
+    customCommands?: IdeCommandConfig[];
+    platform?: NodeJS.Platform;
+    run?: (cmd: string, args: string[]) => Promise<unknown>;
+}
+export declare function isSupportedIdeEditor(value: unknown): value is BuiltInIdeEditor;
+export declare function ideEditorLabel(editor: string, customCommands?: IdeCommandConfig[]): string;
+/**
+ * Open `target` in a configured IDE on the parasor server host.
+ *
+ * The caller must fence `target` to a registered project/worktree path first.
+ * Custom commands are executed with fixed argv via execFile, never a shell.
+ */
+export declare function openInIde(target: string, editor: IdeEditor, opts?: OpenInIdeOptions): Promise<void>;
+//# sourceMappingURL=open-in-ide.d.ts.map

package/server/lib/open-in-ide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-ide.d.ts","sourceRoot":"","sources":["../../src/lib/open-in-ide.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIxD,eAAO,MAAM,mBAAmB,+BAAgC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAsB/B,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,gBAAgB,CAK3B;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,gBAAgB,EAAO,GACtC,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/server/lib/open-in-ide.js

@@ -0,0 +1,90 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export const supportedIdeEditors = ["cursor", "vscode"];
+const EDITOR_LABELS = {
+    cursor: "Cursor",
+    vscode: "VS Code",
+};
+const DARWIN_APP_NAMES = {
+    cursor: "Cursor",
+    vscode: "Visual Studio Code",
+};
+const CLI_COMMANDS = {
+    cursor: "cursor",
+    vscode: "code",
+};
+const WIN_COMMANDS = {
+    cursor: "cursor.cmd",
+    vscode: "code.cmd",
+};
+export class OpenInIdeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OpenInIdeError";
+    }
+}
+export function isSupportedIdeEditor(value) {
+    return (typeof value === "string" &&
+        supportedIdeEditors.includes(value));
+}
+export function ideEditorLabel(editor, customCommands = []) {
+    if (isSupportedIdeEditor(editor))
+        return EDITOR_LABELS[editor];
+    return (customCommands.find((command) => command.id === editor)?.label ?? editor);
+}
+/**
+ * Open `target` in a configured IDE on the parasor server host.
+ *
+ * The caller must fence `target` to a registered project/worktree path first.
+ * Custom commands are executed with fixed argv via execFile, never a shell.
+ */
+export async function openInIde(target, editor, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const customCommand = opts.customCommands?.find((command) => command.id === editor);
+    const run = opts.run ??
+        (async (cmd, args) => {
+            await execFileAsync(cmd, args, { timeout: 5_000 });
+        });
+    if (customCommand) {
+        await run(customCommand.command, buildCustomIdeArgs(customCommand, target));
+        return;
+    }
+    if (!isSupportedIdeEditor(editor)) {
+        throw new OpenInIdeError(`Unsupported editor: ${editor}`);
+    }
+    if (platform === "darwin") {
+        await run("open", ["-a", DARWIN_APP_NAMES[editor], target]);
+        return;
+    }
+    if (platform === "win32") {
+        await run("powershell.exe", [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            "Start-Process -FilePath $args[0] -ArgumentList @($args[1])",
+            WIN_COMMANDS[editor],
+            target,
+        ]);
+        return;
+    }
+    if (platform === "linux") {
+        await run(CLI_COMMANDS[editor], [target]);
+        return;
+    }
+    throw new OpenInIdeError(`Unsupported platform: ${platform}`);
+}
+function buildCustomIdeArgs(command, target) {
+    let usedPath = false;
+    const args = command.args.map((arg) => {
+        if (arg.includes("{path}")) {
+            usedPath = true;
+            return arg.replaceAll("{path}", target);
+        }
+        return arg;
+    });
+    if (!usedPath)
+        args.push(target);
+    return args;
+}
+//# sourceMappingURL=open-in-ide.js.map

package/server/lib/open-in-ide.js.map

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

package/server/lib/open-in-os.d.ts

@@ -0,0 +1,20 @@
+export declare class OpenInOsError extends Error {
+    constructor(message: string);
+}
+export interface OpenInOsOptions {
+    platform?: NodeJS.Platform;
+    run?: (cmd: string, args: string[]) => Promise<unknown>;
+}
+/**
+ * Reveal `target` (a directory or file) in the host's native file manager.
+ *
+ *   darwin -> `open <path>`              (Finder)
+ *   win32  -> `explorer <path>`          (exit code 1 is benign -- Explorer
+ *                                        emits it even on success)
+ *   linux  -> `xdg-open <path>`          (Files / Nautilus / Dolphin)
+ *
+ * The caller is expected to have already validated that `target` belongs to
+ * a registered worktree; this helper does no path-fence work itself.
+ */
+export declare function openInOs(target: string, opts?: OpenInOsOptions): Promise<void>;
+//# sourceMappingURL=open-in-os.d.ts.map

package/server/lib/open-in-os.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-os.d.ts","sourceRoot":"","sources":["../../src/lib/open-in-os.ts"],"names":[],"mappings":"AAKA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/server/lib/open-in-os.js

@@ -0,0 +1,51 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export class OpenInOsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OpenInOsError";
+    }
+}
+/**
+ * Reveal `target` (a directory or file) in the host's native file manager.
+ *
+ *   darwin -> `open <path>`              (Finder)
+ *   win32  -> `explorer <path>`          (exit code 1 is benign -- Explorer
+ *                                        emits it even on success)
+ *   linux  -> `xdg-open <path>`          (Files / Nautilus / Dolphin)
+ *
+ * The caller is expected to have already validated that `target` belongs to
+ * a registered worktree; this helper does no path-fence work itself.
+ */
+export async function openInOs(target, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const run = opts.run ??
+        (async (cmd, args) => {
+            await execFileAsync(cmd, args, { timeout: 5_000 });
+        });
+    if (platform === "darwin") {
+        await run("open", [target]);
+        return;
+    }
+    if (platform === "win32") {
+        try {
+            await run("explorer", [target]);
+        }
+        catch (err) {
+            // explorer.exe returns exit code 1 even on success -- treat any
+            // ExecFileException whose code is exactly 1 as ok.
+            const code = err?.code;
+            if (code === 1)
+                return;
+            throw new OpenInOsError(err instanceof Error ? err.message : "explorer failed");
+        }
+        return;
+    }
+    if (platform === "linux") {
+        await run("xdg-open", [target]);
+        return;
+    }
+    throw new OpenInOsError(`Unsupported platform: ${platform}`);
+}
+//# sourceMappingURL=open-in-os.js.map

package/server/lib/open-in-os.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-os.js","sourceRoot":"","sources":["../../src/lib/open-in-os.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAOD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,OAAwB,EAAE;IAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,GAAG,GACP,IAAI,CAAC,GAAG;QACR,CAAC,KAAK,EAAE,GAAW,EAAE,IAAc,EAAE,EAAE;YACrC,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IAEL,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,gEAAgE;YAChE,mDAAmD;YACnD,MAAM,IAAI,GAAI,GAAsC,EAAE,IAAI,CAAC;YAC3D,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO;YACvB,MAAM,IAAI,aAAa,CACrB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CACvD,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,aAAa,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/server/lib/path.d.ts

@@ -0,0 +1,2 @@
+export declare function expandUserHome(rawPath: string, home?: string): string;
+//# sourceMappingURL=path.d.ts.map

package/server/lib/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/lib/path.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAkB,GACvB,MAAM,CAIR"}

package/server/lib/path.js

@@ -0,0 +1,10 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function expandUserHome(rawPath, home = homedir()) {
+    if (rawPath === "~")
+        return home;
+    if (rawPath.startsWith("~/"))
+        return join(home, rawPath.slice(2));
+    return rawPath;
+}
+//# sourceMappingURL=path.js.map

package/server/lib/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/lib/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,OAAe,OAAO,EAAE;IAExB,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/server/lib/promise-mutex.d.ts

@@ -0,0 +1,7 @@
+export declare class PromiseMutex {
+    private locked;
+    private queue;
+    acquire(): Promise<() => void>;
+    private release;
+}
+//# sourceMappingURL=promise-mutex.d.ts.map

package/server/lib/promise-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-mutex.d.ts","sourceRoot":"","sources":["../../src/lib/promise-mutex.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAsB;IAE7B,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAapC,OAAO,CAAC,OAAO;CAQhB"}

package/server/lib/promise-mutex.js

@@ -0,0 +1,26 @@
+export class PromiseMutex {
+    locked = false;
+    queue = [];
+    async acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return () => this.release();
+        }
+        return new Promise((resolve) => {
+            this.queue.push(() => {
+                this.locked = true;
+                resolve(() => this.release());
+            });
+        });
+    }
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+}
+//# sourceMappingURL=promise-mutex.js.map

package/server/lib/promise-mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-mutex.js","sourceRoot":"","sources":["../../src/lib/promise-mutex.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IACf,MAAM,GAAG,KAAK,CAAC;IACf,KAAK,GAAmB,EAAE,CAAC;IAEnC,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/server/lib/sd-notify.d.ts

@@ -0,0 +1,8 @@
+type SpawnFn = (cmd: string, args: string[]) => void;
+export interface SdNotifyDeps {
+    spawn?: SpawnFn;
+}
+export declare function notifyReady(deps?: SdNotifyDeps): void;
+export declare function notifyWatchdog(deps?: SdNotifyDeps): void;
+export {};
+//# sourceMappingURL=sd-notify.d.ts.map

package/server/lib/sd-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-notify.d.ts","sourceRoot":"","sources":["../../src/lib/sd-notify.ts"],"names":[],"mappings":"AAcA,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAqBD,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAErD;AAED,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAExD"}