lightman-agent 1.0.0

package/agent.config.template.json

@@ -0,0 +1,30 @@
+{
+  "serverUrl": "__SERVER_URL__",
+  "deviceSlug": "__DEVICE_SLUG__",
+  "healthIntervalMs": 60000,
+  "logLevel": "info",
+  "logFile": "agent.log",
+  "identityFile": ".lightman-identity.json",
+  "localServices": false,
+  "kiosk": {
+    "browserPath": "__BROWSER_PATH__",
+    "defaultUrl": "__KIOSK_URL__",
+    "extraArgs": [
+      "--start-fullscreen",
+      "--disable-translate",
+      "--disable-extensions",
+      "--autoplay-policy=no-user-gesture-required",
+      "--user-data-dir=__CHROME_DATA_DIR__"
+    ],
+    "pollIntervalMs": 10000,
+    "maxCrashesInWindow": 10,
+    "crashWindowMs": 300000,
+    "shellMode": false
+  },
+  "powerSchedule": {
+    "shutdownCron": "0 19 * * *",
+    "startupCron": "0 8 * * *",
+    "timezone": "Asia/Kolkata",
+    "shutdownWarningSeconds": 60
+  }
+}

package/bin/cms-agent.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+
+import { existsSync, readFileSync } from 'fs';
+import { networkInterfaces } from 'os';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { spawnSync } from 'child_process';
+import { createInterface } from 'readline/promises';
+import { stdin as input, stdout as output, cwd, platform, exit } from 'process';
+
+const DEFAULT_SERVER = 'http://192.168.1.181:3401';
+const INSTALL_CONFIG_PATH = 'C:\\Program Files\\Lightman\\Agent\\agent.config.json';
+
+function printUsage() {
+  console.log(`
+cms-agent <command> [options]
+
+Commands:
+  install             Prompt slug, install agent with ShellReplace, reboot
+  setup               Alias of install
+  update              Reinstall/update using installed config, reboot
+
+Options:
+  --slug <value>      Device slug (example: C-AV01)
+  --server <url>      Server URL (example: http://192.168.1.181:3401)
+  --timezone <tz>     Timezone override (default: Asia/Kolkata)
+  --no-restart        Skip reboot after successful install/update
+  -h, --help          Show help
+`);
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i += 1) {
+    const part = argv[i];
+    if (!part.startsWith('-')) {
+      continue;
+    }
+    if (part === '--no-restart') {
+      args.noRestart = true;
+      continue;
+    }
+    if (part === '--help' || part === '-h') {
+      args.help = true;
+      continue;
+    }
+    const next = argv[i + 1];
+    if (!next || next.startsWith('-')) {
+      continue;
+    }
+    if (part === '--slug') {
+      args.slug = next.trim();
+      i += 1;
+    } else if (part === '--server') {
+      args.server = next.trim();
+      i += 1;
+    } else if (part === '--timezone') {
+      args.timezone = next.trim();
+      i += 1;
+    }
+  }
+  return args;
+}
+
+function safeReadJson(path) {
+  try {
+    if (!existsSync(path)) return null;
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function isValidSlug(slug) {
+  return /^[A-Za-z0-9][A-Za-z0-9-]{0,62}$/.test(slug);
+}
+
+function collectMacAddresses() {
+  const nets = networkInterfaces();
+  const macs = new Set();
+  for (const netName of Object.keys(nets)) {
+    const ifaceList = nets[netName] || [];
+    for (const iface of ifaceList) {
+      const mac = (iface.mac || '').trim().toUpperCase();
+      if (!iface.internal && mac && mac !== '00:00:00:00:00:00') {
+        macs.add(`${netName}: ${mac}`);
+      }
+    }
+  }
+  return [...macs];
+}
+
+function isWindowsAdmin() {
+  const cmd = '[bool]([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)';
+  const result = spawnSync('powershell.exe', ['-NoProfile', '-Command', cmd], { encoding: 'utf8' });
+  return result.status === 0 && result.stdout.trim().toLowerCase() === 'true';
+}
+
+function runOrFail(command, args) {
+  const result = spawnSync(command, args, { stdio: 'inherit', shell: false });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`Command failed with exit code ${result.status}: ${command} ${args.join(' ')}`);
+  }
+}
+
+async function promptSlug(defaultSlug) {
+  const rl = createInterface({ input, output });
+  try {
+    while (true) {
+      const prompt = defaultSlug
+        ? `Enter device slug [${defaultSlug}]: `
+        : 'Enter device slug (example C-AV01): ';
+      const answer = (await rl.question(prompt)).trim();
+      const slug = answer || defaultSlug || '';
+      if (isValidSlug(slug)) {
+        return slug;
+      }
+      console.error('Invalid slug. Use letters, numbers, and hyphens only.');
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+function resolveInstallScript() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const packaged = resolve(here, '../scripts/install-windows.ps1');
+  const localRepo = resolve(cwd(), 'scripts/install-windows.ps1');
+  if (existsSync(packaged)) return packaged;
+  if (existsSync(localRepo)) return localRepo;
+  throw new Error('install-windows.ps1 not found. Expected in package scripts/ or current folder scripts/.');
+}
+
+function installUsingPowerShell({ scriptPath, slug, server, timezone, noRestart }) {
+  console.log(`powershell -ExecutionPolicy Bypass -File scripts\\install-windows.ps1 -Slug "${slug}" -Server "${server}" -ShellReplace`);
+  const args = ['-ExecutionPolicy', 'Bypass', '-File', scriptPath, '-Slug', slug, '-Server', server, '-ShellReplace'];
+  if (timezone) {
+    args.push('-Timezone', timezone);
+  }
+  runOrFail('powershell.exe', args);
+
+  if (!noRestart) {
+    console.log('Installation completed. Rebooting in 10 seconds...');
+    runOrFail('shutdown.exe', ['/r', '/t', '10', '/c', 'CMS Agent installation complete']);
+  }
+}
+
+async function runInstall(opts) {
+  if (platform !== 'win32') {
+    throw new Error('cms-agent install is currently supported on Windows only.');
+  }
+  if (!isWindowsAdmin()) {
+    throw new Error('Please run this command from an Administrator PowerShell or CMD.');
+  }
+
+  const localConfig = safeReadJson(resolve(cwd(), 'agent.config.json')) || {};
+  const installedConfig = safeReadJson(INSTALL_CONFIG_PATH) || {};
+  const defaultSlug = opts.slug || localConfig.deviceSlug || installedConfig.deviceSlug || '';
+  const server = opts.server || localConfig.serverUrl || installedConfig.serverUrl || DEFAULT_SERVER;
+  const timezone = opts.timezone || localConfig?.powerSchedule?.timezone || installedConfig?.powerSchedule?.timezone || 'Asia/Kolkata';
+  const noRestart = Boolean(opts.noRestart);
+
+  console.log('Detected MAC addresses:');
+  const macs = collectMacAddresses();
+  if (macs.length === 0) {
+    console.log('  (no active external interface found)');
+  } else {
+    for (const item of macs) {
+      console.log(`  ${item}`);
+    }
+  }
+  console.log('');
+
+  const slug = opts.slug || await promptSlug(defaultSlug);
+  const scriptPath = resolveInstallScript();
+
+  console.log(`Installing with slug=${slug}, server=${server}, shellReplace=true`);
+  installUsingPowerShell({ scriptPath, slug, server, timezone, noRestart });
+}
+
+async function runUpdate(opts) {
+  if (platform !== 'win32') {
+    throw new Error('cms-agent update is currently supported on Windows only.');
+  }
+  if (!isWindowsAdmin()) {
+    throw new Error('Please run this command from an Administrator PowerShell or CMD.');
+  }
+
+  const installedConfig = safeReadJson(INSTALL_CONFIG_PATH) || {};
+  const slug = opts.slug || installedConfig.deviceSlug;
+  const server = opts.server || installedConfig.serverUrl || DEFAULT_SERVER;
+  const timezone = opts.timezone || installedConfig?.powerSchedule?.timezone || 'Asia/Kolkata';
+  const noRestart = Boolean(opts.noRestart);
+  const scriptPath = resolveInstallScript();
+
+  if (!slug) {
+    throw new Error('No installed slug found. Use cms-agent install first or pass --slug.');
+  }
+
+  console.log(`Updating with slug=${slug}, server=${server}, shellReplace=true`);
+  installUsingPowerShell({ scriptPath, slug, server, timezone, noRestart });
+}
+
+async function main() {
+  const [, , commandRaw, ...rest] = process.argv;
+  const command = commandRaw || '';
+  const opts = parseArgs(rest);
+
+  if (!command || opts.help || command === 'help' || command === '--help' || command === '-h') {
+    printUsage();
+    return;
+  }
+
+  if (command === 'install' || command === 'setup') {
+    await runInstall(opts);
+    return;
+  }
+  if (command === 'update') {
+    await runUpdate(opts);
+    return;
+  }
+
+  printUsage();
+  throw new Error(`Unknown command: ${command}`);
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "lightman-agent",
+  "version": "1.0.0",
+  "description": "LIGHTMAN Agent - System-level daemon for museum display machines",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "cms-agent": "bin/cms-agent.js",
+    "lightman-agent": "bin/cms-agent.js"
+  },
+  "files": [
+    "bin/",
+    "nssm/",
+    "public/",
+    "scripts/",
+    "src/index.ts",
+    "src/commands/",
+    "src/lib/",
+    "src/services/",
+    "agent.config.template.json",
+    "package-lock.json",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "cms-agent": "node ./bin/cms-agent.js",
+    "sync-display": "node -e \"const{cpSync,rmSync,mkdirSync}=require('fs');rmSync('public',{recursive:true,force:true});mkdirSync('public',{recursive:true});cpSync('../display/dist','public',{recursive:true});console.log('Display synced to agent/public/')\"",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "systeminformation": "^5.23.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.5.13",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/public/assets/index-CcBNCz6h.css

@@ -0,0 +1 @@
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--ease-out:cubic-bezier(0,0,.2,1);--ease-in-out:cubic-bezier(.4,0,.2,1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.container{width:100%}@media(min-width:40rem){.container{max-width:40rem}}@media(min-width:48rem){.container{max-width:48rem}}@media(min-width:64rem){.container{max-width:64rem}}@media(min-width:80rem){.container{max-width:80rem}}@media(min-width:96rem){.container{max-width:96rem}}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.transform{transform:var(--tw-rotate-x,)var(--tw-rotate-y,)var(--tw-rotate-z,)var(--tw-skew-x,)var(--tw-skew-y,)}.resize{resize:both}.border{border-style:var(--tw-border-style);border-width:1px}.uppercase{text-transform:uppercase}.italic{font-style:italic}.underline{text-decoration-line:underline}.filter{filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}}html,body,#root{color:#fff;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;background-color:#000;width:100%;height:100%;margin:0;padding:0;font-family:system-ui,-apple-system,sans-serif;overflow:hidden}body{overscroll-behavior:none;-webkit-overflow-scrolling:touch;touch-action:manipulation}::-webkit-scrollbar{display:none}*{scrollbar-width:none}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}