feat(core): Centralize timeouts/constants, add CLI prompt helpers, and introduce webhook/script actions with safety and SNMP refactors

ts/actions/webhook-action.ts

@@ -3,6 +3,32 @@ import * as https from 'node:https';
 import { URL } from 'node:url';
 import { Action, type IActionConfig, type IActionContext } from './base-action.ts';
 import { logger } from '../logger.ts';
+import { WEBHOOK } from '../constants.ts';
+
+/**
+ * Payload sent to webhook endpoints
+ */
+export interface IWebhookPayload {
+  /** UPS ID */
+  upsId: string;
+  /** UPS name */
+  upsName: string;
+  /** Current power status */
+  powerStatus: 'online' | 'onBattery' | 'unknown';
+  /** Current battery capacity percentage */
+  batteryCapacity: number;
+  /** Current battery runtime in minutes */
+  batteryRuntime: number;
+  /** Reason this webhook was triggered */
+  triggerReason: 'powerStatusChange' | 'thresholdViolation';
+  /** Timestamp when webhook was triggered */
+  timestamp: number;
+  /** Thresholds configured for this action (if any) */
+  thresholds?: {
+    battery: number;
+    runtime: number;
+  };
+}
 
 /**
  * WebhookAction - Calls an HTTP webhook with UPS state information
@@ -30,7 +56,7 @@ export class WebhookAction extends Action {
     }
 
     const method = this.config.webhookMethod || 'POST';
-    const timeout = this.config.webhookTimeout || 10000;
+    const timeout = this.config.webhookTimeout || WEBHOOK.DEFAULT_TIMEOUT_MS;
 
     logger.info(`Calling webhook: ${method} ${this.config.webhookUrl}`);
 
@@ -56,7 +82,7 @@ export class WebhookAction extends Action {
     method: 'GET' | 'POST',
     timeout: number,
   ): Promise<void> {
-    const payload: any = {
+    const payload: IWebhookPayload = {
       upsId: context.upsId,
       upsName: context.upsName,
       powerStatus: context.powerStatus,