npm - lightman-agent - Versions diffs - 1.0.0 - Mend

lightman-agent 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (54) hide show

package/agent.config.template.json +30 -0
package/bin/cms-agent.js +233 -0
package/nssm/nssm.exe +0 -0
package/package.json +52 -0
package/public/assets/index-CcBNCz6h.css +1 -0
package/public/assets/index-H-8HDl46.js +1 -0
package/public/index.html +19 -0
package/scripts/guardian.ps1 +75 -0
package/scripts/install-linux.sh +134 -0
package/scripts/install-rpi.sh +117 -0
package/scripts/install-windows.ps1 +529 -0
package/scripts/launch-kiosk.vbs +101 -0
package/scripts/lightman-agent.logrotate +12 -0
package/scripts/lightman-agent.service +38 -0
package/scripts/lightman-shell.bat +128 -0
package/scripts/reinstall-windows.ps1 +26 -0
package/scripts/restore-desktop.ps1 +32 -0
package/scripts/setup.ps1 +116 -0
package/scripts/setup.sh +115 -0
package/scripts/uninstall-linux.sh +50 -0
package/scripts/uninstall-windows.ps1 +54 -0
package/src/commands/display.ts +177 -0
package/src/commands/kiosk.ts +113 -0
package/src/commands/maintenance.ts +106 -0
package/src/commands/network.ts +129 -0
package/src/commands/power.ts +163 -0
package/src/commands/rpi.ts +45 -0
package/src/commands/screenshot.ts +166 -0
package/src/commands/serial.ts +17 -0
package/src/commands/update.ts +124 -0
package/src/index.ts +652 -0
package/src/lib/config.ts +69 -0
package/src/lib/identity.ts +40 -0
package/src/lib/logger.ts +137 -0
package/src/lib/platform.ts +10 -0
package/src/lib/rpi.ts +180 -0
package/src/lib/screens.ts +128 -0
package/src/lib/types.ts +176 -0
package/src/services/commands.ts +107 -0
package/src/services/health.ts +161 -0
package/src/services/kiosk.ts +395 -0
package/src/services/localEvents.ts +60 -0
package/src/services/logForwarder.ts +72 -0
package/src/services/multiScreenKiosk.ts +324 -0
package/src/services/oscBridge.ts +186 -0
package/src/services/powerScheduler.ts +260 -0
package/src/services/provisioning.ts +120 -0
package/src/services/serialBridge.ts +230 -0
package/src/services/serviceLauncher.ts +183 -0
package/src/services/staticServer.ts +226 -0
package/src/services/updater.ts +249 -0
package/src/services/watchdog.ts +310 -0
package/src/services/websocket.ts +152 -0
package/tsconfig.json +28 -0

package/public/index.html ADDED Viewed

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
+    <meta name="mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black" />
+    <title>LIGHTMAN Display</title>
+    <style>
+      body { margin: 0; padding: 0; background: #000; overflow: hidden; }
+    </style>
+    <script type="module" crossorigin src="/display/assets/index-H-8HDl46.js"></script>
+    <link rel="stylesheet" crossorigin href="/display/assets/index-CcBNCz6h.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/scripts/guardian.ps1 ADDED Viewed

@@ -0,0 +1,75 @@
+# LIGHTMAN Guardian - Service Health Monitor
+# Runs every 5 minutes via Task Scheduler.
+# Restarts the NSSM service if it's down. Checks Chrome kiosk health.
+$LogDir = "C:\ProgramData\Lightman\logs"
+$LogFile = Join-Path $LogDir "guardian.log"
+$ServiceName = "LightmanAgent"
+$NssmExe = "C:\ProgramData\Lightman\nssm\nssm.exe"
+function Write-GuardianLog($msg) {
+    $ts = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    try {
+        if (-not (Test-Path $LogDir)) { New-Item -ItemType Directory -Force -Path $LogDir | Out-Null }
+        Add-Content -Path $LogFile -Value "[$ts] $msg" -ErrorAction SilentlyContinue
+        if ((Get-Item $LogFile -ErrorAction SilentlyContinue).Length -gt 1MB) {
+            $rotated = "$LogFile.old"
+            if (Test-Path $rotated) { Remove-Item $rotated -Force }
+            Rename-Item $LogFile $rotated -Force
+        }
+    } catch { }
+}
+try {
+    # 1. Check LIGHTMAN service
+    $svc = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
+    if (-not $svc) {
+        $svc = Get-Service -DisplayName "LIGHTMAN*" -ErrorAction SilentlyContinue | Select-Object -First 1
+    }
+    if (-not $svc) {
+        Write-GuardianLog "CRITICAL: Service not found!"
+        exit 1
+    }
+    if ($svc.Status -ne 'Running') {
+        Write-GuardianLog "WARNING: Service is $($svc.Status). Restarting..."
+        if ($svc.Status -eq 'Stopped') {
+            if (Test-Path $NssmExe) {
+                & $NssmExe start $ServiceName 2>$null
+            } else {
+                Start-Service -Name $svc.Name -ErrorAction SilentlyContinue
+            }
+            Start-Sleep -Seconds 5
+            $svc.Refresh()
+            Write-GuardianLog "After restart: $($svc.Status)"
+        }
+        elseif ($svc.Status -in @('StartPending', 'StopPending')) {
+            Write-GuardianLog "Service stuck in $($svc.Status). Force killing node.exe..."
+            Get-Process -Name "node" -ErrorAction SilentlyContinue | Stop-Process -Force -ErrorAction SilentlyContinue
+            Start-Sleep -Seconds 3
+            if (Test-Path $NssmExe) { & $NssmExe start $ServiceName 2>$null }
+            else { Start-Service -Name $svc.Name -ErrorAction SilentlyContinue }
+            Start-Sleep -Seconds 5
+            $svc.Refresh()
+            Write-GuardianLog "After force restart: $($svc.Status)"
+        }
+    }
+    # 2. Check Chrome kiosk
+    $chrome = Get-Process -Name "chrome" -ErrorAction SilentlyContinue
+    if (-not $chrome) {
+        $vbsPath = "C:\Program Files\Lightman\Agent\launch-kiosk.vbs"
+        if (Test-Path $vbsPath) {
+            Start-Sleep -Seconds 10
+            $chromeRecheck = Get-Process -Name "chrome" -ErrorAction SilentlyContinue
+            if (-not $chromeRecheck) {
+                Write-GuardianLog "Chrome not running. Launching via VBS..."
+                Start-Process "wscript.exe" -ArgumentList """$vbsPath""" -WindowStyle Hidden
+            }
+        }
+    }
+} catch {
+    Write-GuardianLog "Guardian error: $_"
+}

package/scripts/install-linux.sh ADDED Viewed

@@ -0,0 +1,134 @@
+#!/usr/bin/env bash
+# LIGHTMAN Agent — Linux Installer
+# Run as root:
+#   sudo bash install-linux.sh --slug f-av01 --server http://192.168.1.100:3401
+set -euo pipefail
+INSTALL_DIR="/opt/lightman/agent"
+LOG_DIR="/var/log/lightman"
+SERVICE_NAME="lightman-agent"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AGENT_DIR="$(dirname "$SCRIPT_DIR")"
+# Defaults
+SLUG=""
+SERVER=""
+TIMEZONE="Asia/Kolkata"
+# ── Parse arguments ──
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --slug)     SLUG="$2";     shift 2 ;;
+        --server)   SERVER="$2";   shift 2 ;;
+        --timezone) TIMEZONE="$2"; shift 2 ;;
+        -h|--help)
+            echo "Usage: sudo bash install-linux.sh --slug f-av01 --server http://192.168.1.100:3401 [--timezone Asia/Kolkata]"
+            exit 0
+            ;;
+        *) echo "Unknown option: $1"; exit 1 ;;
+    esac
+done
+# ── Validate required args ──
+if [[ -z "$SLUG" ]]; then
+    echo "Error: --slug is required"
+    echo "Usage: sudo bash install-linux.sh --slug f-av01 --server http://192.168.1.100:3401"
+    exit 1
+fi
+if [[ -z "$SERVER" ]]; then
+    echo "Error: --server is required"
+    echo "Usage: sudo bash install-linux.sh --slug f-av01 --server http://192.168.1.100:3401"
+    exit 1
+fi
+# ── Pre-checks ──
+if [[ $EUID -ne 0 ]]; then
+    echo "Error: This script must be run as root (use sudo)."
+    exit 1
+fi
+if ! command -v node &> /dev/null; then
+    echo "Error: Node.js is not installed. Install Node.js 20+ first."
+    exit 1
+fi
+NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
+if [[ "$NODE_VERSION" -lt 20 ]]; then
+    echo "Error: Node.js 20+ required, found v${NODE_VERSION}."
+    exit 1
+fi
+echo ""
+echo "=== LIGHTMAN Agent — Linux Installer ==="
+echo "  Device slug : $SLUG"
+echo "  Server URL  : $SERVER"
+echo ""
+# --- Create user/group ---
+if ! id -u lightman &> /dev/null; then
+    echo "[1/7] Creating lightman user and group..."
+    groupadd --system lightman
+    useradd --system --gid lightman --home-dir /opt/lightman --shell /usr/sbin/nologin lightman
+else
+    echo "[1/7] User 'lightman' already exists, skipping."
+fi
+# --- Create directories ---
+echo "[2/7] Creating directories..."
+mkdir -p "$INSTALL_DIR"
+mkdir -p "$LOG_DIR"
+# --- Copy agent files ---
+echo "[3/7] Copying agent files to ${INSTALL_DIR}..."
+cp -r "$AGENT_DIR/dist"                         "$INSTALL_DIR/"
+cp    "$AGENT_DIR/package.json"                 "$INSTALL_DIR/"
+cp    "$AGENT_DIR/package-lock.json"            "$INSTALL_DIR/" 2>/dev/null || true
+# Copy template so setup.sh can use it post-install
+cp    "$AGENT_DIR/agent.config.template.json"   "$INSTALL_DIR/"
+# Install production dependencies
+echo "[4/7] Installing production dependencies..."
+cd "$INSTALL_DIR"
+npm ci --omit=dev --ignore-scripts 2>/dev/null || npm install --omit=dev --ignore-scripts
+# --- Configure this device (generates agent.config.json, clears any stale identity) ---
+echo "[5/7] Configuring device '$SLUG'..."
+bash "$SCRIPT_DIR/setup.sh" \
+    --slug     "$SLUG" \
+    --server   "$SERVER" \
+    --timezone "$TIMEZONE" \
+    --dir      "$INSTALL_DIR"
+# --- Set permissions ---
+echo "[6/7] Setting permissions..."
+chown -R lightman:lightman "$INSTALL_DIR"
+chown -R lightman:lightman "$LOG_DIR"
+chmod 750 "$INSTALL_DIR"
+chmod 750 "$LOG_DIR"
+# --- Install systemd service ---
+echo "[7/7] Installing systemd service..."
+cp "$SCRIPT_DIR/lightman-agent.service" "/etc/systemd/system/${SERVICE_NAME}.service"
+systemctl daemon-reload
+systemctl enable "$SERVICE_NAME"
+# --- Install logrotate config ---
+cp "$SCRIPT_DIR/lightman-agent.logrotate" "/etc/logrotate.d/${SERVICE_NAME}" 2>/dev/null || true
+echo ""
+echo "=== Installation Complete ==="
+echo ""
+echo "  Device slug : $SLUG"
+echo "  Server      : $SERVER"
+echo "  Install dir : ${INSTALL_DIR}"
+echo "  Log dir     : ${LOG_DIR}"
+echo "  Service     : ${SERVICE_NAME}"
+echo ""
+echo "  Start   :  sudo systemctl start ${SERVICE_NAME}"
+echo "  Status  :  sudo systemctl status ${SERVICE_NAME}"
+echo "  Logs    :  sudo journalctl -u ${SERVICE_NAME} -f"
+echo ""
+echo "The agent will now provision with the LIGHTMAN server."
+echo "If pairing is needed, a 6-digit code will appear in the logs."
+echo ""

package/scripts/install-rpi.sh ADDED Viewed

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+# LIGHTMAN Agent — Raspberry Pi Installer
+# Extends the standard Linux install with RPi-specific optimizations.
+# Run as root: sudo bash install-rpi.sh
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+INSTALL_DIR="/opt/lightman/agent"
+# --- Pre-checks ---
+if [[ $EUID -ne 0 ]]; then
+  echo "Error: This script must be run as root (use sudo)."
+  exit 1
+fi
+if [[ ! -f /proc/device-tree/model ]]; then
+  echo "Error: This does not appear to be a Raspberry Pi."
+  exit 1
+fi
+MODEL=$(tr -d '\0' < /proc/device-tree/model)
+echo "=== LIGHTMAN Agent — Raspberry Pi Installer ==="
+echo "  Detected: ${MODEL}"
+echo ""
+# --- Run standard Linux install first ---
+echo "[RPi 1/6] Running standard Linux install..."
+bash "$SCRIPT_DIR/install-linux.sh"
+echo ""
+# --- GPU memory split ---
+echo "[RPi 2/6] Configuring GPU memory..."
+CONFIG_FILE="/boot/config.txt"
+if [[ -f /boot/firmware/config.txt ]]; then
+  CONFIG_FILE="/boot/firmware/config.txt"
+fi
+if ! grep -q "^gpu_mem=" "$CONFIG_FILE" 2>/dev/null; then
+  echo "gpu_mem=128" >> "$CONFIG_FILE"
+  echo "  Set gpu_mem=128 in ${CONFIG_FILE}"
+else
+  echo "  gpu_mem already configured in ${CONFIG_FILE}"
+fi
+# --- Disable screensaver / screen blanking ---
+echo "[RPi 3/6] Disabling screen blanking..."
+# For console blanking
+if ! grep -q "consoleblank=0" /boot/cmdline.txt 2>/dev/null; then
+  if [[ -f /boot/cmdline.txt ]]; then
+    sed -i 's/$/ consoleblank=0/' /boot/cmdline.txt
+    echo "  Added consoleblank=0 to /boot/cmdline.txt"
+  fi
+fi
+# For X11 screensaver
+LIGHTDM_CONF="/etc/lightdm/lightdm.conf"
+if [[ -f "$LIGHTDM_CONF" ]]; then
+  if ! grep -q "xserver-command.*-s 0" "$LIGHTDM_CONF" 2>/dev/null; then
+    sed -i '/^\[Seat:\*\]/a xserver-command=X -s 0 -dpms' "$LIGHTDM_CONF" 2>/dev/null || true
+    echo "  Disabled X11 screensaver via lightdm"
+  fi
+fi
+# --- Hardware watchdog ---
+echo "[RPi 4/6] Configuring hardware watchdog..."
+if ! grep -q "^dtparam=watchdog=on" "$CONFIG_FILE" 2>/dev/null; then
+  echo "dtparam=watchdog=on" >> "$CONFIG_FILE"
+  echo "  Enabled BCM2835 watchdog in ${CONFIG_FILE}"
+fi
+# Load watchdog module
+if ! lsmod | grep -q bcm2835_wdt 2>/dev/null; then
+  modprobe bcm2835_wdt 2>/dev/null || true
+fi
+if ! grep -q "bcm2835_wdt" /etc/modules 2>/dev/null; then
+  echo "bcm2835_wdt" >> /etc/modules
+fi
+# Set watchdog device permissions for lightman user
+if [[ -e /dev/watchdog ]]; then
+  chown root:lightman /dev/watchdog
+  chmod 660 /dev/watchdog
+  echo "  Set /dev/watchdog permissions for lightman group"
+fi
+# --- tmpfs for logs (reduce SD card wear) ---
+echo "[RPi 5/6] Configuring tmpfs for logs..."
+FSTAB_ENTRY="tmpfs /var/log/lightman tmpfs defaults,noatime,nosuid,nodev,noexec,mode=0750,size=50M,uid=lightman,gid=lightman 0 0"
+if ! grep -q "/var/log/lightman" /etc/fstab 2>/dev/null; then
+  echo "$FSTAB_ENTRY" >> /etc/fstab
+  mount -a 2>/dev/null || true
+  echo "  Added tmpfs mount for /var/log/lightman"
+fi
+# --- Sudoers for agent power commands ---
+echo "[RPi 6/6] Configuring sudoers..."
+SUDOERS_FILE="/etc/sudoers.d/lightman-agent"
+cat > "$SUDOERS_FILE" << 'SUDOERS'
+# LIGHTMAN Agent - allow power commands without password
+lightman ALL=(ALL) NOPASSWD: /sbin/shutdown
+lightman ALL=(ALL) NOPASSWD: /sbin/reboot
+lightman ALL=(ALL) NOPASSWD: /usr/bin/vcgencmd
+SUDOERS
+chmod 440 "$SUDOERS_FILE"
+echo "  Installed sudoers for lightman agent"
+echo ""
+echo "=== Raspberry Pi Setup Complete ==="
+echo ""
+echo "  IMPORTANT: Reboot required for:"
+echo "    - GPU memory allocation"
+echo "    - Hardware watchdog"
+echo "    - Screen blanking changes"
+echo ""
+echo "  Reboot now:  sudo reboot"
+echo ""