@sonoransoftware/sonoran.js 1.0.63 → 1.0.64

package/dist/libs/rest/src/lib/REST.js

@@ -264,12 +264,13 @@ class REST extends events_1.EventEmitter {
             case 'UNIT_PANIC': {
                 const payload = args[0];
                 if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
-                    const { apiId, account, isPanic } = payload;
-                    return { apiId, account, isPanic };
+                    const { apiId, account, isPanic, identIds } = payload;
+                    return { apiId, account, isPanic, identIds };
                 }
                 return {
                     apiId: args[0],
-                    isPanic: args[1]
+                    isPanic: args[1],
+                    identIds: args[2]
                 };
             }
             case 'IDENTS_TO_GROUP': {

package/dist/libs/rest/src/lib/utils/constants.d.ts

@@ -273,6 +273,7 @@ export interface CADUnitPanicStruct {
     apiId?: string;
     account?: string;
     isPanic: boolean;
+    identIds?: number[];
 }
 export declare enum CADDispatchOriginEnums {
     Caller = 0,
@@ -396,7 +397,8 @@ export interface RESTTypedAPIDataStructs {
     IDENTS_TO_GROUP: [data: CADIdentsToGroupStruct[]];
     UNIT_PANIC: [
         apiId: string | undefined,
-        isPanic: boolean
+        isPanic: boolean,
+        identIds?: number[]
     ] | [
         data: CADUnitPanicStruct
     ];

package/dist/managers/CADManager.d.ts

@@ -160,7 +160,7 @@ export declare class CADManager extends BaseManager {
     /**
      * Toggles panic state for a unit.
      */
-    setUnitPanic(apiId: string | undefined, isPanic: boolean): Promise<globalTypes.CADStandardResponse>;
+    setUnitPanic(apiId: string | undefined, isPanic: boolean, identIds?: number[]): Promise<globalTypes.CADStandardResponse>;
     setUnitPanic(params: CADUnitPanicStruct): Promise<globalTypes.CADStandardResponse>;
     /**
      * Updates a unit's status.

package/dist/managers/CADManager.js

@@ -407,22 +407,31 @@ class CADManager extends BaseManager_1.BaseManager {
         });
         return this.executeCadRequest('IDENTS_TO_GROUP', payload);
     }
-    async setUnitPanic(apiIdOrParams, isPanic) {
+    async setUnitPanic(apiIdOrParams, isPanic, identIds) {
         let payload;
         if (apiIdOrParams && typeof apiIdOrParams === 'object') {
             payload = { ...apiIdOrParams };
         }
         else {
-            payload = { apiId: apiIdOrParams, isPanic: isPanic };
+            payload = { apiId: apiIdOrParams, isPanic: isPanic, identIds };
         }
-        const { apiId, account, isPanic: resolvedPanic } = payload;
+        const { apiId, account, isPanic: resolvedPanic, identIds: resolvedIdentIds } = payload;
         if (resolvedPanic === undefined) {
             throw new Error('isPanic is required when setting unit panic.');
         }
-        if (!apiId && !account) {
-            throw new Error('Either apiId or account is required when setting unit panic.');
+        if (resolvedIdentIds !== undefined && (!Array.isArray(resolvedIdentIds) || resolvedIdentIds.some((id) => !Number.isInteger(id)))) {
+            throw new Error('identIds must be an array of integers when setting unit panic.');
+        }
+        const hasIdentIds = Array.isArray(resolvedIdentIds) && resolvedIdentIds.length > 0;
+        if (!apiId && !account && !hasIdentIds) {
+            throw new Error('Either apiId, account, or identIds is required when setting unit panic.');
         }
-        return this.executeCadRequest('UNIT_PANIC', { apiId, account, isPanic: resolvedPanic });
+        return this.executeCadRequest('UNIT_PANIC', {
+            apiId,
+            account,
+            isPanic: resolvedPanic,
+            identIds: hasIdentIds ? resolvedIdentIds : undefined
+        });
     }
     async setUnitStatus(apiIdOrParams, status, serverId, identIds) {
         let payload;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonoransoftware/sonoran.js",
-  "version": "1.0.63",
+  "version": "1.0.64",
   "description": "Sonoran.js is a library that allows you to interact with the Sonoran CAD and Sonoran CMS API. Based off of and utilizes several Discord.js library techniques for ease of use.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -105,7 +105,7 @@ const lookupByAccount = await instance.cad.lookupRecords({ account: 'd5663516-ee
 - **`getIdentifiers(apiId)`**
 - **`modifyIdentifier(change)`** / **`setIdentifier(apiId?, identId)`**
 - **`setIdentifiersToGroup(entries)`** - assigns identifiers to a group name (empty string clears).
-- **`setUnitPanic({ apiId?, account?, isPanic })`** / **`setUnitStatus({ status, serverId, apiId?, account?, identIds? })`**
+- **`setUnitPanic({ apiId?, account?, isPanic, identIds? })`** / **`setUnitStatus({ status, serverId, apiId?, account?, identIds? })`**
 - **`getActiveUnits(options)`** - direct CAD fetch for active units.
 - **`kickUnit(apiId?, reason, serverId)`**
 - **`updateUnitLocations(locations)`**
@@ -119,6 +119,8 @@ await instance.cad.setUnitStatus('1234567890', 2, 1);
 await instance.cad.setUnitStatus({ identIds: [101, 102], status: 2, serverId: 1 });
 // Trigger panic using account UUID
 await instance.cad.setUnitPanic({ account: '91de0ce8-c571-11e9-9714-5600023b2434', isPanic: true });
+// Trigger panic by identifier IDs
+await instance.cad.setUnitPanic({ identIds: [101, 102], isPanic: true });
 ```
 
 ### Map & Streetsigns

package/src/libs/rest/src/lib/REST.ts

@@ -374,12 +374,13 @@ export class REST extends EventEmitter {
 			case 'UNIT_PANIC': {
 				const payload = args[0];
 				if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
-					const { apiId, account, isPanic } = payload as { apiId?: string; account?: string; isPanic: boolean };
-					return { apiId, account, isPanic };
+					const { apiId, account, isPanic, identIds } = payload as { apiId?: string; account?: string; isPanic: boolean; identIds?: number[] };
+					return { apiId, account, isPanic, identIds };
 				}
 				return {
 					apiId: args[0],
-					isPanic: args[1]
+					isPanic: args[1],
+					identIds: args[2]
 				};
 			}
 			case 'IDENTS_TO_GROUP': {

package/src/libs/rest/src/lib/utils/constants.ts

@@ -970,6 +970,7 @@ export interface CADUnitPanicStruct {
 	apiId?: string;
 	account?: string;
 	isPanic: boolean;
+	identIds?: number[];
 }
 
 export enum CADDispatchOriginEnums {
@@ -1096,7 +1097,8 @@ export interface RESTTypedAPIDataStructs {
 	IDENTS_TO_GROUP: [data: CADIdentsToGroupStruct[]];
 	UNIT_PANIC: [
 		apiId: string | undefined,
-		isPanic: boolean
+		isPanic: boolean,
+		identIds?: number[]
 	] | [
 		data: CADUnitPanicStruct
 	];

package/src/managers/CADManager.ts

@@ -437,23 +437,32 @@ export class CADManager extends BaseManager {
   /**
    * Toggles panic state for a unit.
    */
-  public async setUnitPanic(apiId: string | undefined, isPanic: boolean): Promise<globalTypes.CADStandardResponse>;
+  public async setUnitPanic(apiId: string | undefined, isPanic: boolean, identIds?: number[]): Promise<globalTypes.CADStandardResponse>;
   public async setUnitPanic(params: CADUnitPanicStruct): Promise<globalTypes.CADStandardResponse>;
-  public async setUnitPanic(apiIdOrParams: string | CADUnitPanicStruct | undefined, isPanic?: boolean): Promise<globalTypes.CADStandardResponse> {
+  public async setUnitPanic(apiIdOrParams: string | CADUnitPanicStruct | undefined, isPanic?: boolean, identIds?: number[]): Promise<globalTypes.CADStandardResponse> {
     let payload: CADUnitPanicStruct;
     if (apiIdOrParams && typeof apiIdOrParams === 'object') {
       payload = { ...apiIdOrParams };
     } else {
-      payload = { apiId: apiIdOrParams as string | undefined, isPanic: isPanic as boolean };
+      payload = { apiId: apiIdOrParams as string | undefined, isPanic: isPanic as boolean, identIds };
     }
-    const { apiId, account, isPanic: resolvedPanic } = payload;
+    const { apiId, account, isPanic: resolvedPanic, identIds: resolvedIdentIds } = payload;
     if (resolvedPanic === undefined) {
       throw new Error('isPanic is required when setting unit panic.');
     }
-    if (!apiId && !account) {
-      throw new Error('Either apiId or account is required when setting unit panic.');
+    if (resolvedIdentIds !== undefined && (!Array.isArray(resolvedIdentIds) || resolvedIdentIds.some((id) => !Number.isInteger(id)))) {
+      throw new Error('identIds must be an array of integers when setting unit panic.');
+    }
+    const hasIdentIds = Array.isArray(resolvedIdentIds) && resolvedIdentIds.length > 0;
+    if (!apiId && !account && !hasIdentIds) {
+      throw new Error('Either apiId, account, or identIds is required when setting unit panic.');
     }
-    return this.executeCadRequest('UNIT_PANIC', { apiId, account, isPanic: resolvedPanic });
+    return this.executeCadRequest('UNIT_PANIC', {
+      apiId,
+      account,
+      isPanic: resolvedPanic,
+      identIds: hasIdentIds ? resolvedIdentIds : undefined
+    });
   }
 
   /**