@sonoransoftware/sonoran.js 1.0.35 → 1.0.37

package/src/managers/CMSManager.ts

@@ -25,8 +25,7 @@ export class CMSManager extends BaseManager {
   protected async buildManager(instance: Instance) {
     const mutableThis = this as globalTypes.Mutable<CMSManager>;
     try {
-      const versionResp: any = await this.rest?.request('GET_SUB_VERSION');
-      const version = Number.parseInt(versionResp.replace(/(^\d+)(.+$)/i,'$1'));
+      const version = await this.getSubscriptionVersion();
       if (version >= globalTypes.CMSSubscriptionVersionEnum.STANDARD) {
         this.servers = new CMSServerManager(instance, this);
       }
@@ -41,6 +40,15 @@ export class CMSManager extends BaseManager {
     }
   }
 
+  /**
+   * Retrieves the community's CMS subscription version.
+   */
+  public async getSubscriptionVersion(): Promise<number> {
+    const versionResp: any = await this.rest?.request('GET_SUB_VERSION');
+    const versionString = String(versionResp);
+    return Number.parseInt(versionString.replace(/(^\d+)(.+$)/i, '$1'), 10);
+  }
+
   /**
    * Verifies the whitelist of a given account with the given parameters to search of said account.
    * @param {Object | string} data The object or [accId | apiId as a string] that contains data to get a community account to verify if it has whitelist to the specified server. *If given as a string it will default to the set or default cms server id (1).
@@ -328,6 +336,46 @@ export class CMSManager extends BaseManager {
     });
   }
 
+  /**
+   * Triggers promotion flows for the specified users.
+   */
+  public async triggerPromotionFlows(flows: globalTypes.CMSTriggerPromotionFlowPayload[]): Promise<globalTypes.CMSTriggerPromotionFlowsPromiseResult> {
+    if (!Array.isArray(flows) || flows.length === 0) {
+      throw new Error('flows array must include at least one promotion flow payload.');
+    }
+
+    return new Promise(async (resolve, reject) => {
+      try {
+        const response: any = await this.rest?.request('TRIGGER_PROMOTION_FLOWS', flows);
+        resolve({ success: true, data: response });
+      } catch (err) {
+        if (err instanceof APIError) {
+          resolve({ success: false, reason: err.response });
+        } else {
+          reject(err);
+        }
+      }
+    });
+  }
+
+  /**
+   * Retrieves the available promotion flows configured in CMS.
+   */
+  public async getPromotionFlows(): Promise<globalTypes.CMSGetPromotionFlowsPromiseResult> {
+    return new Promise(async (resolve, reject) => {
+      try {
+        const response: any = await this.rest?.request('GET_PROMOTION_FLOWS');
+        resolve({ success: true, data: response });
+      } catch (err) {
+        if (err instanceof APIError) {
+          resolve({ success: false, reason: err.response });
+        } else {
+          reject(err);
+        }
+      }
+    });
+  }
+
   /**
    * Gets a list of online ERLC players for the given roblox join code.
    * @param {string} robloxJoinCode The roblox join code to get the online players for.
@@ -370,6 +418,31 @@ export class CMSManager extends BaseManager {
     });
   }
 
+  /**
+   * Updates the stage of a form for the specified account.
+   */
+  public async changeFormStage(params: { accId?: string, formId: number, newStageId: string, apiId?: string, username?: string, discord?: string, uniqueId: number }): Promise<globalTypes.CMSChangeFormStagePromiseResult> {
+    if (!params.formId || !params.newStageId) {
+      throw new Error('formId and newStageId are required to change a form stage.');
+    }
+    if (params.uniqueId === undefined || Number.isNaN(Number(params.uniqueId))) {
+      throw new Error('uniqueId is required to change a form stage.');
+    }
+
+    return new Promise(async (resolve, reject) => {
+      try {
+        const response: any = await this.rest?.request('CHANGE_FORM_STAGE', params.accId, params.formId, params.newStageId, params.apiId, params.username, params.discord, params.uniqueId);
+        resolve({ success: true, data: response });
+      } catch (err) {
+        if (err instanceof APIError) {
+          resolve({ success: false, reason: err.response });
+        } else {
+          reject(err);
+        }
+      }
+    });
+  }
+
   /**
    * Retrieves submissions for a specific form template.
    */

package/src/managers/CMSServerManager.ts

@@ -8,28 +8,39 @@ import { CMSManager } from './CMSManager';
 export class CMSServerManager extends CacheManager<number, CMSServer, CMSServerAPIStruct> {
   constructor(instance: Instance, private readonly manager: CMSManager) {
     super(instance, CMSServer, []);
-    (async () => {
-      const managerRef = this.manager;
-      while(!managerRef.ready) {
-        await new Promise((resolve) => {
-          setTimeout(resolve, 100);
-        });
-      } 
-      try {
-        const serversRes: any = await managerRef.rest?.request('GET_GAME_SERVERS');
-        const servers = serversRes.servers;
-        servers.forEach((server: CMSServerAPIStruct) => {
-          const serverStruct = {
-            id: server.id,
-            config: server
-          };
-          this._add(serverStruct, true, server.id);
-        });
-        console.log(`Found ${servers.length} servers`);
-      } catch (err) {
-        throw new Error(String(err));
-      }
-    })();
+    void this.initialize();
+  }
+
+  /**
+   * Retrieves the CMS game servers belonging to the community.
+   */
+  public async getGameServers(): Promise<CMSServerAPIStruct[]> {
+    const serversRes: any = await this.manager.rest?.request('GET_GAME_SERVERS');
+    const parsed = typeof serversRes === 'string' ? JSON.parse(serversRes) : serversRes;
+    const servers = Array.isArray(parsed?.servers) ? parsed.servers : [];
+    return servers;
+  }
+
+  private async initialize(): Promise<void> {
+    const managerRef = this.manager;
+    while(!managerRef.ready) {
+      await new Promise((resolve) => {
+        setTimeout(resolve, 100);
+      });
+    }
+    try {
+      const servers = await this.getGameServers();
+      servers.forEach((server: CMSServerAPIStruct) => {
+        const serverStruct = {
+          id: server.id,
+          config: server
+        };
+        this._add(serverStruct, true, server.id);
+      });
+      console.log(`Found ${servers.length} servers`);
+    } catch (err) {
+      throw new Error(String(err));
+    }
   }
 
   public async setGameServers(servers: globalTypes.CMSSetGameServerStruct[]): Promise<globalTypes.CMSSetGameServersPromiseResult> {

package/src/managers/RadioManager.ts

@@ -184,4 +184,25 @@ export class RadioManager extends BaseManager {
       }
     });
   }
+
+  /**
+   * Plays one or more tones to radio channels, groups, or in-game speakers.
+   * @param {number} roomId Multi-server room id for tone playback.
+   * @param {number[]} tones Tone identifiers to play.
+   * @param {globalTypes.RadioTonePlayTarget[]} playTo Targets that should receive the tones.
+   */
+  public async playTone(roomId: number, tones: number[], playTo: globalTypes.RadioTonePlayTarget[]): Promise<globalTypes.RadioPlayTonePromiseResult> {
+    return new Promise(async (resolve, reject) => {
+      try {
+        const response: any = await this.rest?.request('PLAY_TONE', roomId, tones, playTo);
+        resolve({ success: true, result: response?.result ?? response });
+      } catch (err) {
+        if (err instanceof APIError) {
+          resolve({ success: false, reason: err.response });
+        } else {
+          reject(err);
+        }
+      }
+    });
+  }
 }