lightman-agent 1.0.18 → 1.0.21

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 (52) hide show
  1. package/agent.config.json +22 -23
  2. package/agent.config.template.json +30 -31
  3. package/bin/cms-agent.js +269 -248
  4. package/package.json +1 -1
  5. package/public/assets/index-CcBNCz6h.css +1 -1
  6. package/public/assets/index-D9QHMG8k.js +1 -1
  7. package/public/assets/index-H-8HDl46.js +1 -1
  8. package/public/assets/index-YodeiCia.css +1 -1
  9. package/public/assets/index-legacy-DWtNM8y7.js +41 -41
  10. package/public/assets/polyfills-legacy-DyVYWHbW.js +4 -4
  11. package/scripts/guardian.ps1 +50 -124
  12. package/scripts/install-windows.ps1 +60 -116
  13. package/scripts/lightman-agent.logrotate +12 -12
  14. package/scripts/lightman-agent.service +38 -38
  15. package/scripts/reinstall-windows.ps1 +26 -26
  16. package/scripts/restore-desktop.ps1 +32 -32
  17. package/scripts/setup.ps1 +17 -22
  18. package/scripts/sync-display.mjs +20 -20
  19. package/scripts/uninstall-windows.ps1 +54 -54
  20. package/src/commands/display.ts +177 -177
  21. package/src/commands/kiosk.ts +113 -113
  22. package/src/commands/maintenance.ts +106 -106
  23. package/src/commands/network.ts +129 -129
  24. package/src/commands/power.ts +163 -163
  25. package/src/commands/rpi.ts +45 -45
  26. package/src/commands/screenshot.ts +166 -166
  27. package/src/commands/serial.ts +17 -17
  28. package/src/commands/update.ts +124 -124
  29. package/src/index.ts +173 -90
  30. package/src/lib/config.ts +2 -3
  31. package/src/lib/identity.ts +40 -40
  32. package/src/lib/logger.ts +137 -137
  33. package/src/lib/platform.ts +10 -10
  34. package/src/lib/rpi.ts +180 -180
  35. package/src/lib/screenMap.ts +135 -0
  36. package/src/lib/screens.ts +128 -128
  37. package/src/lib/types.ts +176 -177
  38. package/src/services/commands.ts +107 -107
  39. package/src/services/health.ts +161 -161
  40. package/src/services/localEvents.ts +60 -60
  41. package/src/services/logForwarder.ts +72 -72
  42. package/src/services/multiScreenKiosk.ts +116 -83
  43. package/src/services/oscBridge.ts +186 -186
  44. package/src/services/powerScheduler.ts +260 -260
  45. package/src/services/provisioning.ts +120 -122
  46. package/src/services/serialBridge.ts +230 -230
  47. package/src/services/serviceLauncher.ts +183 -183
  48. package/src/services/staticServer.ts +226 -226
  49. package/src/services/updater.ts +249 -249
  50. package/src/services/watchdog.ts +310 -310
  51. package/src/services/websocket.ts +152 -152
  52. package/tsconfig.json +28 -28
@@ -1,124 +1,124 @@
1
- import { z } from 'zod';
2
- import type { Logger } from '../lib/logger.js';
3
- import type { Updater } from '../services/updater.js';
4
- import type { WsClient } from '../services/websocket.js';
5
- import type { CommandHandler } from '../lib/types.js';
6
-
7
- type RegisterFn = (name: string, handler: CommandHandler) => void;
8
-
9
- // --- Zod Schemas ---
10
- const UpdateArgsSchema = z.object({
11
- url: z.string().url().refine(
12
- (val) => {
13
- try {
14
- const parsed = new URL(val);
15
- return parsed.protocol === 'http:' || parsed.protocol === 'https:';
16
- } catch {
17
- return false;
18
- }
19
- },
20
- { message: 'Only http/https URLs are supported' }
21
- ),
22
- version: z.string().min(1),
23
- checksum: z.string().regex(/^[a-f0-9]{64}$/i, 'Invalid checksum format (expected SHA256 hex)'),
24
- });
25
-
26
- export function registerUpdateCommands(
27
- register: RegisterFn,
28
- updater: Updater,
29
- wsClient: WsClient,
30
- logger: Logger
31
- ): void {
32
- /**
33
- * agent:update — Download, verify, install an update, then restart.
34
- * Args: { url: string, version: string, checksum: string }
35
- */
36
- register('agent:update', async (args) => {
37
- const parsed = UpdateArgsSchema.safeParse(args ?? {});
38
- if (!parsed.success) {
39
- const issues = parsed.error.issues;
40
- const urlIssue = issues.find((i) => i.path.includes('url'));
41
- const checksumIssue = issues.find((i) => i.path.includes('checksum'));
42
-
43
- if (urlIssue && urlIssue.code === 'invalid_string') {
44
- throw new Error('Invalid URL');
45
- }
46
- if (urlIssue && urlIssue.message === 'Only http/https URLs are supported') {
47
- throw new Error('Only http/https URLs are supported');
48
- }
49
- if (checksumIssue) {
50
- throw new Error('Invalid checksum format (expected SHA256 hex)');
51
- }
52
- throw new Error('Missing required args: url, version, checksum');
53
- }
54
-
55
- const { url, version, checksum } = parsed.data;
56
-
57
- // Send status update
58
- const sendStatus = (phase: string, detail?: Record<string, unknown>) => {
59
- wsClient.send({
60
- type: 'agent:update_status',
61
- payload: { phase, version, ...detail },
62
- timestamp: Date.now(),
63
- });
64
- };
65
-
66
- try {
67
- sendStatus('downloading');
68
- const filePath = await updater.download(url);
69
-
70
- sendStatus('verifying');
71
- const valid = await updater.verify(filePath, checksum);
72
- if (!valid) {
73
- sendStatus('error', { error: 'Checksum verification failed' });
74
- throw new Error('Checksum verification failed');
75
- }
76
-
77
- sendStatus('installing');
78
- await updater.install(filePath, version);
79
-
80
- // Clean old downloads
81
- updater.cleanDownloads();
82
-
83
- sendStatus('restarting');
84
- logger.info(`Update to v${version} complete. Restarting...`);
85
-
86
- // Delay restart to allow result to be sent
87
- setTimeout(() => process.exit(0), 2000);
88
-
89
- return { success: true, version, restarting: true };
90
- } catch (err) {
91
- const message = err instanceof Error ? err.message : String(err);
92
- sendStatus('error', { error: message });
93
- logger.error(`Update failed: ${message}`);
94
- throw new Error(`Update failed: ${message}`);
95
- }
96
- });
97
-
98
- /**
99
- * agent:rollback — Rollback to the previous backup version.
100
- */
101
- register('agent:rollback', async () => {
102
- try {
103
- await updater.rollback();
104
- logger.info('Rollback complete. Restarting...');
105
-
106
- // Delay restart to allow result to be sent
107
- setTimeout(() => process.exit(0), 2000);
108
-
109
- return { success: true, restarting: true };
110
- } catch (err) {
111
- const message = err instanceof Error ? err.message : String(err);
112
- logger.error(`Rollback failed: ${message}`);
113
- throw new Error(`Rollback failed: ${message}`);
114
- }
115
- });
116
-
117
- /**
118
- * agent:update-status — Get current update status.
119
- */
120
- register('agent:update-status', async () => {
121
- const status = updater.getStatus();
122
- return { ...status } as Record<string, unknown>;
123
- });
124
- }
1
+ import { z } from 'zod';
2
+ import type { Logger } from '../lib/logger.js';
3
+ import type { Updater } from '../services/updater.js';
4
+ import type { WsClient } from '../services/websocket.js';
5
+ import type { CommandHandler } from '../lib/types.js';
6
+
7
+ type RegisterFn = (name: string, handler: CommandHandler) => void;
8
+
9
+ // --- Zod Schemas ---
10
+ const UpdateArgsSchema = z.object({
11
+ url: z.string().url().refine(
12
+ (val) => {
13
+ try {
14
+ const parsed = new URL(val);
15
+ return parsed.protocol === 'http:' || parsed.protocol === 'https:';
16
+ } catch {
17
+ return false;
18
+ }
19
+ },
20
+ { message: 'Only http/https URLs are supported' }
21
+ ),
22
+ version: z.string().min(1),
23
+ checksum: z.string().regex(/^[a-f0-9]{64}$/i, 'Invalid checksum format (expected SHA256 hex)'),
24
+ });
25
+
26
+ export function registerUpdateCommands(
27
+ register: RegisterFn,
28
+ updater: Updater,
29
+ wsClient: WsClient,
30
+ logger: Logger
31
+ ): void {
32
+ /**
33
+ * agent:update — Download, verify, install an update, then restart.
34
+ * Args: { url: string, version: string, checksum: string }
35
+ */
36
+ register('agent:update', async (args) => {
37
+ const parsed = UpdateArgsSchema.safeParse(args ?? {});
38
+ if (!parsed.success) {
39
+ const issues = parsed.error.issues;
40
+ const urlIssue = issues.find((i) => i.path.includes('url'));
41
+ const checksumIssue = issues.find((i) => i.path.includes('checksum'));
42
+
43
+ if (urlIssue && urlIssue.code === 'invalid_string') {
44
+ throw new Error('Invalid URL');
45
+ }
46
+ if (urlIssue && urlIssue.message === 'Only http/https URLs are supported') {
47
+ throw new Error('Only http/https URLs are supported');
48
+ }
49
+ if (checksumIssue) {
50
+ throw new Error('Invalid checksum format (expected SHA256 hex)');
51
+ }
52
+ throw new Error('Missing required args: url, version, checksum');
53
+ }
54
+
55
+ const { url, version, checksum } = parsed.data;
56
+
57
+ // Send status update
58
+ const sendStatus = (phase: string, detail?: Record<string, unknown>) => {
59
+ wsClient.send({
60
+ type: 'agent:update_status',
61
+ payload: { phase, version, ...detail },
62
+ timestamp: Date.now(),
63
+ });
64
+ };
65
+
66
+ try {
67
+ sendStatus('downloading');
68
+ const filePath = await updater.download(url);
69
+
70
+ sendStatus('verifying');
71
+ const valid = await updater.verify(filePath, checksum);
72
+ if (!valid) {
73
+ sendStatus('error', { error: 'Checksum verification failed' });
74
+ throw new Error('Checksum verification failed');
75
+ }
76
+
77
+ sendStatus('installing');
78
+ await updater.install(filePath, version);
79
+
80
+ // Clean old downloads
81
+ updater.cleanDownloads();
82
+
83
+ sendStatus('restarting');
84
+ logger.info(`Update to v${version} complete. Restarting...`);
85
+
86
+ // Delay restart to allow result to be sent
87
+ setTimeout(() => process.exit(0), 2000);
88
+
89
+ return { success: true, version, restarting: true };
90
+ } catch (err) {
91
+ const message = err instanceof Error ? err.message : String(err);
92
+ sendStatus('error', { error: message });
93
+ logger.error(`Update failed: ${message}`);
94
+ throw new Error(`Update failed: ${message}`);
95
+ }
96
+ });
97
+
98
+ /**
99
+ * agent:rollback — Rollback to the previous backup version.
100
+ */
101
+ register('agent:rollback', async () => {
102
+ try {
103
+ await updater.rollback();
104
+ logger.info('Rollback complete. Restarting...');
105
+
106
+ // Delay restart to allow result to be sent
107
+ setTimeout(() => process.exit(0), 2000);
108
+
109
+ return { success: true, restarting: true };
110
+ } catch (err) {
111
+ const message = err instanceof Error ? err.message : String(err);
112
+ logger.error(`Rollback failed: ${message}`);
113
+ throw new Error(`Rollback failed: ${message}`);
114
+ }
115
+ });
116
+
117
+ /**
118
+ * agent:update-status — Get current update status.
119
+ */
120
+ register('agent:update-status', async () => {
121
+ const status = updater.getStatus();
122
+ return { ...status } as Record<string, unknown>;
123
+ });
124
+ }