@sonoransoftware/sonoran.js 1.0.40 → 1.0.42

package/dist/constants.d.ts

@@ -107,10 +107,50 @@ export interface CMSClockInOutPromiseResult {
     reason?: string;
     clockedIn?: boolean;
 }
+export interface CMSClockInType {
+    id: string;
+    label: string;
+}
+export interface AccountActivityLog {
+    id: string;
+    status: boolean;
+    accId: string;
+    serverId: number;
+    start: string;
+    end: string | null;
+    clearReason: string | null;
+    metadata: Record<string, any>;
+    objKey: string;
+}
+export interface AccountClockInLog {
+    id: number;
+    startTime: string | null;
+    endTime: string | null;
+    completed: boolean;
+    notes: {
+        timestamp: string;
+        message: string;
+    }[];
+    type?: string;
+    objKey: string;
+}
+export interface CMSGetClockInTypesPromiseResult {
+    success: boolean;
+    reason?: string;
+    data?: CMSClockInType[];
+}
+export interface CMSGetLatestActivityPromiseResult {
+    success: boolean;
+    reason?: string;
+    data?: AccountClockInLog[] | AccountActivityLog[];
+}
 export interface CMSClockInOutParams {
     accId?: string;
     apiId?: string;
     forceClockIn?: boolean;
+    discord?: string;
+    uniqueId?: string;
+    type?: string;
 }
 export interface CMSCheckComApiIdPromiseResult {
     success: boolean;

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

@@ -118,6 +118,21 @@ class REST extends events_1.EventEmitter {
                     uniqueId: args[4]
                 };
             }
+            case 'GET_CLOCKIN_TYPES': {
+                return {};
+            }
+            case 'GET_LATEST_ACTIVITY': {
+                const payload = args[0];
+                if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
+                    return payload;
+                }
+                return {
+                    accId: args[0],
+                    type: args[1],
+                    serverId: args[2],
+                    clockInType: args[3]
+                };
+            }
             case 'GET_ACCOUNTS': {
                 return (_b = args[0]) !== null && _b !== void 0 ? _b : {};
             }
@@ -168,12 +183,16 @@ class REST extends events_1.EventEmitter {
                 };
             }
             case 'CLOCK_IN_OUT': {
+                if (args[0] && typeof args[0] === 'object' && !Array.isArray(args[0])) {
+                    return args[0];
+                }
                 return {
                     apiId: args[0],
                     accId: args[1],
                     forceClockIn: args[2],
                     discord: args[3],
-                    uniqueId: args[4]
+                    uniqueId: args[4],
+                    type: args[5]
                 };
             }
             case 'CHECK_COM_APIID': {

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

@@ -101,6 +101,10 @@ class RequestManager extends events_1.EventEmitter {
                     apiData.data.data = [];
                     break;
                 }
+                case 'GET_CLOCKIN_TYPES': {
+                    apiData.data.data = [];
+                    break;
+                }
                 case 'ERLC_EXECUTE_COMMAND': {
                     apiData.data.data = clonedData;
                     break;

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

@@ -38,7 +38,7 @@ export declare const CommunitiesCMSAPITypes: APITypeData[];
 export declare const ERLCMSAPITypes: APITypeData[];
 export declare const RadioAPITypes: APITypeData[];
 export declare const AllAPITypes: AllAPITypeData[];
-export type AllAPITypesType = 'GET_SERVERS' | 'SET_SERVERS' | 'GET_VERSION' | 'SET_PENAL_CODES' | 'SET_API_ID' | 'GET_TEMPLATES' | 'NEW_RECORD' | 'EDIT_RECORD' | 'REMOVE_RECORD' | 'LOOKUP_INT' | 'LOOKUP' | 'GET_ACCOUNT' | 'CHECK_APIID' | 'APPLY_PERMISSION_KEY' | 'SET_ACCOUNT_PERMISSIONS' | 'BAN_USER' | 'VERIFY_SECRET' | 'AUTH_STREETSIGNS' | 'SET_POSTALS' | 'SEND_PHOTO' | 'SET_CLOCK' | 'JOIN_COMMUNITY' | 'LEAVE_COMMUNITY' | 'GET_CHARACTERS' | 'NEW_CHARACTER' | 'EDIT_CHARACTER' | 'REMOVE_CHARACTER' | 'GET_IDENTIFIERS' | 'MODIFY_IDENTIFIER' | 'SET_IDENTIFIER' | 'UNIT_PANIC' | 'UNIT_STATUS' | 'GET_BLIPS' | 'ADD_BLIP' | 'MODIFY_BLIP' | 'REMOVE_BLIP' | '911_CALL' | 'REMOVE_911' | 'GET_CALLS' | 'GET_ACTIVE_UNITS' | 'KICK_UNIT' | 'NEW_DISPATCH' | 'ATTACH_UNIT' | 'DETACH_UNIT' | 'SET_CALL_POSTAL' | 'SET_CALL_PRIMARY' | 'ADD_CALL_NOTE' | 'CLOSE_CALL' | 'UNIT_LOCATION' | 'SET_STREETSIGN_CONFIG' | 'UPDATE_STREETSIGN' | 'GET_COM_ACCOUNT' | 'GET_DEPARTMENTS' | 'GET_SUB_VERSION' | 'GET_CURRENT_CLOCK_IN' | 'GET_ACCOUNTS' | 'GET_PROFILE_FIELDS' | 'CHECK_COM_APIID' | 'VERIFY_WHITELIST' | 'CLOCK_IN_OUT' | 'FULL_WHITELIST' | 'GET_ACCOUNT_RANKS' | 'SET_ACCOUNT_RANKS' | 'RSVP' | 'CHANGE_FORM_STAGE' | 'GET_FORM_TEMPLATE_SUBMISSIONS' | 'KICK_ACCOUNT' | 'BAN_ACCOUNT' | 'LOOKUP' | 'EDIT_ACC_PROFLIE_FIELDS' | 'SET_ACCOUNT_NAME' | 'FORCE_SYNC' | 'TRIGGER_PROMOTION_FLOWS' | 'GET_PROMOTION_FLOWS' | 'SET_GAME_SERVERS' | 'ERLC_GET_ONLINE_PLAYERS' | 'ERLC_GET_PLAYER_QUEUE' | 'ERLC_ADD_NEW_RECORD' | 'ERLC_EXECUTE_COMMAND' | 'RADIO_GET_COMMUNITY_CHANNELS' | 'RADIO_GET_CONNECTED_USERS' | 'RADIO_GET_CONNECTED_USER' | 'RADIO_SET_USER_CHANNELS' | 'RADIO_SET_USER_DISPLAY_NAME' | 'RADIO_GET_SERVER_SUBSCRIPTION_FROM_IP' | 'RADIO_SET_SERVER_IP' | 'RADIO_SET_IN_GAME_SPEAKER_LOCATIONS' | 'PLAY_TONE';
+export type AllAPITypesType = 'GET_SERVERS' | 'SET_SERVERS' | 'GET_VERSION' | 'SET_PENAL_CODES' | 'SET_API_ID' | 'GET_TEMPLATES' | 'NEW_RECORD' | 'EDIT_RECORD' | 'REMOVE_RECORD' | 'LOOKUP_INT' | 'LOOKUP' | 'GET_ACCOUNT' | 'CHECK_APIID' | 'APPLY_PERMISSION_KEY' | 'SET_ACCOUNT_PERMISSIONS' | 'BAN_USER' | 'VERIFY_SECRET' | 'AUTH_STREETSIGNS' | 'SET_POSTALS' | 'SEND_PHOTO' | 'SET_CLOCK' | 'JOIN_COMMUNITY' | 'LEAVE_COMMUNITY' | 'GET_CHARACTERS' | 'NEW_CHARACTER' | 'EDIT_CHARACTER' | 'REMOVE_CHARACTER' | 'GET_IDENTIFIERS' | 'MODIFY_IDENTIFIER' | 'SET_IDENTIFIER' | 'UNIT_PANIC' | 'UNIT_STATUS' | 'GET_BLIPS' | 'ADD_BLIP' | 'MODIFY_BLIP' | 'REMOVE_BLIP' | '911_CALL' | 'REMOVE_911' | 'GET_CALLS' | 'GET_ACTIVE_UNITS' | 'KICK_UNIT' | 'NEW_DISPATCH' | 'ATTACH_UNIT' | 'DETACH_UNIT' | 'SET_CALL_POSTAL' | 'SET_CALL_PRIMARY' | 'ADD_CALL_NOTE' | 'CLOSE_CALL' | 'UNIT_LOCATION' | 'SET_STREETSIGN_CONFIG' | 'UPDATE_STREETSIGN' | 'GET_COM_ACCOUNT' | 'GET_DEPARTMENTS' | 'GET_SUB_VERSION' | 'GET_CURRENT_CLOCK_IN' | 'GET_CLOCKIN_TYPES' | 'GET_LATEST_ACTIVITY' | 'GET_ACCOUNTS' | 'GET_PROFILE_FIELDS' | 'CHECK_COM_APIID' | 'VERIFY_WHITELIST' | 'CLOCK_IN_OUT' | 'FULL_WHITELIST' | 'GET_ACCOUNT_RANKS' | 'SET_ACCOUNT_RANKS' | 'RSVP' | 'CHANGE_FORM_STAGE' | 'GET_FORM_TEMPLATE_SUBMISSIONS' | 'KICK_ACCOUNT' | 'BAN_ACCOUNT' | 'LOOKUP' | 'EDIT_ACC_PROFLIE_FIELDS' | 'SET_ACCOUNT_NAME' | 'FORCE_SYNC' | 'TRIGGER_PROMOTION_FLOWS' | 'GET_PROMOTION_FLOWS' | 'SET_GAME_SERVERS' | 'ERLC_GET_ONLINE_PLAYERS' | 'ERLC_GET_PLAYER_QUEUE' | 'ERLC_ADD_NEW_RECORD' | 'ERLC_EXECUTE_COMMAND' | 'RADIO_GET_COMMUNITY_CHANNELS' | 'RADIO_GET_CONNECTED_USERS' | 'RADIO_GET_CONNECTED_USER' | 'RADIO_SET_USER_CHANNELS' | 'RADIO_SET_USER_DISPLAY_NAME' | 'RADIO_GET_SERVER_SUBSCRIPTION_FROM_IP' | 'RADIO_SET_SERVER_IP' | 'RADIO_SET_IN_GAME_SPEAKER_LOCATIONS' | 'PLAY_TONE';
 export interface CMSServerAPIStruct {
     id: number;
     name: string;
@@ -428,6 +428,15 @@ export interface RESTTypedAPIDataStructs {
         discord?: string,
         uniqueId?: string
     ];
+    GET_CLOCKIN_TYPES: [];
+    GET_LATEST_ACTIVITY: [
+        data: {
+            accId: string;
+            type: 'clockin' | 'activity';
+            serverId?: number;
+            clockInType?: string;
+        }
+    ];
     GET_ACCOUNTS: [
         options?: {
             skip?: number;
@@ -445,7 +454,8 @@ export interface RESTTypedAPIDataStructs {
         accId?: string,
         forceClockIn?: boolean,
         discord?: string,
-        uniqueId?: string
+        uniqueId?: string,
+        type?: string
     ];
     GET_DEPARTMENTS: [];
     GET_ACCOUNT_RANKS: [
@@ -684,8 +694,17 @@ export type PossibleRequestData = undefined | {
     apiId: string;
     serverId: number;
 } | {
-    apiId: string;
-    forceClockIn: boolean;
+    apiId?: string;
+    accId?: string;
+    forceClockIn?: boolean;
+    discord?: string;
+    uniqueId?: string;
+    type?: string;
+} | {
+    accId: string;
+    type: 'clockin' | 'activity';
+    serverId?: number;
+    clockInType?: string;
 } | {
     accountId: string;
     set?: {

package/dist/libs/rest/src/lib/utils/constants.js

@@ -346,6 +346,18 @@ exports.GeneralCMSAPITypes = [
         method: 'POST',
         minVersion: 0
     },
+    {
+        type: 'GET_CLOCKIN_TYPES',
+        path: 'general/get_clockin_types',
+        method: 'POST',
+        minVersion: 0
+    },
+    {
+        type: 'GET_LATEST_ACTIVITY',
+        path: 'general/get_latest_activity',
+        method: 'POST',
+        minVersion: 0
+    },
     {
         type: 'GET_ACCOUNTS',
         path: 'general/get_accounts',

package/dist/managers/CMSManager.d.ts

@@ -78,15 +78,15 @@ export declare class CMSManager extends BaseManager {
      * @param {string} [data.apiId] (Optional) The api id to clock in or out.
      * @param {boolean} [data.forceClockIn] If true, it will override any current clock in with a new clock in at the time of the request.
      * @param {string} [data.discord] (Optional) The discord ID to clock in or out.
+     * @param {string} [data.uniqueId] (Optional) The unique ID to clock in or out.
+     * @param {string} [data.type] (Optional) The UUID of a specific clock-in type to use.
      * @returns {Promise} Promise object represents if the request was successful with reason for failure if needed.
      */
-    clockInOut(data: {
-        accId?: string;
-        apiId?: string;
-        forceClockIn?: boolean;
-        discord?: string;
-        uniqueId?: string;
-    }): Promise<globalTypes.CMSClockInOutPromiseResult>;
+    clockInOut(data: globalTypes.CMSClockInOutParams): Promise<globalTypes.CMSClockInOutPromiseResult>;
+    /**
+     * Retrieves configured clock-in types for the community.
+     */
+    getClockInTypes(): Promise<globalTypes.CMSGetClockInTypesPromiseResult>;
     /**
      * Check if a given [apiId] is attached to any account within the community CMS.
      * @param {string} apiId The api id to check for an account.
@@ -228,6 +228,15 @@ export declare class CMSManager extends BaseManager {
         uniqueId?: string;
         profileFields: globalTypes.CMSProfileFieldUpdate[];
     }): Promise<globalTypes.CMSEditAccountProfileFieldsPromiseResult>;
+    /**
+     * Gets the latest clock-in or activity timestamp for the provided account.
+     */
+    getLatestActivity(params: {
+        accId: string;
+        type: 'clockin' | 'activity';
+        serverId?: number;
+        clockInType?: string;
+    }): Promise<globalTypes.CMSGetLatestActivityPromiseResult>;
     /**
      * Gets the current clock in entry for a community member.
      * @param {Object} params Identification parameters for the account.

package/dist/managers/CMSManager.js

@@ -177,13 +177,15 @@ class CMSManager extends BaseManager_1.BaseManager {
      * @param {string} [data.apiId] (Optional) The api id to clock in or out.
      * @param {boolean} [data.forceClockIn] If true, it will override any current clock in with a new clock in at the time of the request.
      * @param {string} [data.discord] (Optional) The discord ID to clock in or out.
+     * @param {string} [data.uniqueId] (Optional) The unique ID to clock in or out.
+     * @param {string} [data.type] (Optional) The UUID of a specific clock-in type to use.
      * @returns {Promise} Promise object represents if the request was successful with reason for failure if needed.
      */
     async clockInOut(data) {
         return new Promise(async (resolve, reject) => {
             var _a;
             try {
-                const clockInOutRequest = await ((_a = this.rest) === null || _a === void 0 ? void 0 : _a.request('CLOCK_IN_OUT', data.apiId, data.accId, !!data.forceClockIn, data.discord, data.uniqueId));
+                const clockInOutRequest = await ((_a = this.rest) === null || _a === void 0 ? void 0 : _a.request('CLOCK_IN_OUT', data.apiId, data.accId, !!data.forceClockIn, data.discord, data.uniqueId, data.type));
                 const clockInOutResponse = clockInOutRequest;
                 if (!clockInOutResponse)
                     resolve({ success: false, reason: clockInOutRequest });
@@ -199,6 +201,26 @@ class CMSManager extends BaseManager_1.BaseManager {
             }
         });
     }
+    /**
+     * Retrieves configured clock-in types for the community.
+     */
+    async getClockInTypes() {
+        return new Promise(async (resolve, reject) => {
+            var _a;
+            try {
+                const response = await ((_a = this.rest) === null || _a === void 0 ? void 0 : _a.request('GET_CLOCKIN_TYPES'));
+                resolve({ success: true, data: response });
+            }
+            catch (err) {
+                if (err instanceof src_1.APIError) {
+                    resolve({ success: false, reason: err.response });
+                }
+                else {
+                    reject(err);
+                }
+            }
+        });
+    }
     /**
      * Check if a given [apiId] is attached to any account within the community CMS.
      * @param {string} apiId The api id to check for an account.
@@ -539,6 +561,36 @@ class CMSManager extends BaseManager_1.BaseManager {
             }
         });
     }
+    /**
+     * Gets the latest clock-in or activity timestamp for the provided account.
+     */
+    async getLatestActivity(params) {
+        if (!(params === null || params === void 0 ? void 0 : params.accId)) {
+            throw new Error('accId is required to get latest activity.');
+        }
+        if (params.type !== 'clockin' && params.type !== 'activity') {
+            throw new Error('type must be either "clockin" or "activity".');
+        }
+        if (params.type === 'activity' && params.serverId === undefined) {
+            throw new Error('serverId is required when type is "activity".');
+        }
+        return new Promise(async (resolve, reject) => {
+            var _a;
+            try {
+                const response = await ((_a = this.rest) === null || _a === void 0 ? void 0 : _a.request('GET_LATEST_ACTIVITY', params));
+                const data = response && typeof response === 'object' && 'data' in response ? response.data : response;
+                resolve({ success: true, data });
+            }
+            catch (err) {
+                if (err instanceof src_1.APIError) {
+                    resolve({ success: false, reason: err.response });
+                }
+                else {
+                    reject(err);
+                }
+            }
+        });
+    }
     /**
      * Gets the current clock in entry for a community member.
      * @param {Object} params Identification parameters for the account.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonoransoftware/sonoran.js",
-  "version": "1.0.40",
+  "version": "1.0.42",
   "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

@@ -232,7 +232,7 @@ const getRanks = await instance.cms.getAccountRanks(params);
 ### clockInOut(obj)
 Clock a user in or out in the CMS system
 #### Arugment `obj`
-##### Type `object` `{accId?: string, apiId?: string, forceClockIn?: boolean, discord?: string, uniqueId?: string}`
+##### Type `object` `{accId?: string, apiId?: string, forceClockIn?: boolean, discord?: string, uniqueId?: string, type?: string}`
 ```js
 const params = {
  accId: '',
@@ -240,11 +240,19 @@ const params = {
  forceClockIn: true,
  discord: '',
  uniqueId: '1234',
+ type: 'clockin-type-uuid'
 };
 // Clocks a user in or out
 const clock = await instance.cms.clockInOut(params);
 ```
 
+### getClockInTypes()
+Returns the configured clock-in types.
+```js
+const types = await instance.cms.getClockInTypes();
+// [{ id: 'uuid', label: 'Patrol' }]
+```
+
 ### checkComApiId(apiId)
 Checks if a given API ID is attatched to any account within the community, and if true, returns the username of the associated account.
 #### Arugment `apiId`
@@ -327,6 +335,16 @@ Fetches the current clock-in entry for the account if one exists.
 const currentEntry = await instance.cms.getCurrentClockIn({ apiId: '1234' });
 ```
 
+### getLatestActivity(params)
+Gets the latest clock-in or activity entries for an account.
+```js
+// Clock-in history
+const clockins = await instance.cms.getLatestActivity({ accId: 'account-uuid', type: 'clockin' });
+// Activity history (requires serverId)
+const activity = await instance.cms.getLatestActivity({ accId: 'account-uuid', type: 'activity', serverId: 1 });
+```
+*Returns an array of clock-in logs (`AccountClockInLog`) or activity logs (`AccountActivityLog`); each item includes `objKey` alongside the other fields.*
+
 ### getAccounts(options)
 Retrieves CMS accounts with optional pagination and status filters.
 ```js

package/src/constants.ts

@@ -122,10 +122,55 @@ export interface CMSClockInOutPromiseResult {
 	clockedIn?: boolean;
 }
 
+export interface CMSClockInType {
+	id: string;
+	label: string;
+}
+
+export interface AccountActivityLog {
+	id: string;
+	status: boolean;
+	accId: string;
+	serverId: number;
+	start: string;
+	end: string | null;
+	clearReason: string | null;
+	metadata: Record<string, any>;
+	objKey: string;
+}
+
+export interface AccountClockInLog {
+	id: number;
+	startTime: string | null;
+	endTime: string | null;
+	completed: boolean;
+	notes: {
+		timestamp: string;
+		message: string;
+	}[];
+	type?: string;
+	objKey: string;
+}
+
+export interface CMSGetClockInTypesPromiseResult {
+	success: boolean;
+	reason?: string;
+	data?: CMSClockInType[];
+}
+
+export interface CMSGetLatestActivityPromiseResult {
+	success: boolean;
+	reason?: string;
+	data?: AccountClockInLog[] | AccountActivityLog[];
+}
+
 export interface CMSClockInOutParams {
 	accId?: string;
 	apiId?: string;
 	forceClockIn?: boolean;
+	discord?: string;
+	uniqueId?: string;
+	type?: string;
 }
 
 export interface CMSCheckComApiIdPromiseResult {

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

@@ -224,6 +224,21 @@ export class REST extends EventEmitter {
 					uniqueId: args[4]
 				};
 			}
+			case 'GET_CLOCKIN_TYPES': {
+				return {};
+			}
+			case 'GET_LATEST_ACTIVITY': {
+				const payload = args[0];
+				if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
+					return payload;
+				}
+				return {
+					accId: args[0],
+					type: args[1],
+					serverId: args[2],
+					clockInType: args[3]
+				};
+			}
 			case 'GET_ACCOUNTS': {
 				return args[0] ?? {};
 			}
@@ -272,12 +287,16 @@ export class REST extends EventEmitter {
 				};
 			}
 			case 'CLOCK_IN_OUT': {
+				if (args[0] && typeof args[0] === 'object' && !Array.isArray(args[0])) {
+					return args[0];
+				}
 				return {
 					apiId: args[0],
 					accId: args[1],
 					forceClockIn: args[2],
 					discord: args[3],
-					uniqueId: args[4]
+					uniqueId: args[4],
+					type: args[5]
 				};
 			}
 			case 'CHECK_COM_APIID': {

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

@@ -174,6 +174,10 @@ export class RequestManager extends EventEmitter {
           apiData.data.data = [];
           break;
         }
+        case 'GET_CLOCKIN_TYPES': {
+          apiData.data.data = [];
+          break;
+        }
         case 'ERLC_EXECUTE_COMMAND': {
           apiData.data.data = clonedData;
           break;

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

@@ -378,6 +378,18 @@ export const GeneralCMSAPITypes: APITypeData[] = [
 		method: 'POST', // Would've been 'GET' but fetch doesn't allow body with GET requests.
 		minVersion: 0
 	},
+	{
+		type: 'GET_CLOCKIN_TYPES',
+		path: 'general/get_clockin_types',
+		method: 'POST',
+		minVersion: 0
+	},
+	{
+		type: 'GET_LATEST_ACTIVITY',
+		path: 'general/get_latest_activity',
+		method: 'POST',
+		minVersion: 0
+	},
 	{
 		type: 'GET_ACCOUNTS',
 		path: 'general/get_accounts',
@@ -625,7 +637,7 @@ function formatForAll(array: APITypeData[], product: productEnums): AllAPITypeDa
 
 export const AllAPITypes: AllAPITypeData[] = [ ...formatForAll(GeneralCADAPITypes, productEnums.CAD), ...formatForAll(CivilianCADAPITypes, productEnums.CAD), ...formatForAll(EmergencyCADAPITypes, productEnums.CAD), ...formatForAll(GeneralCMSAPITypes, productEnums.CMS), ...formatForAll(ServersCMSAPITypes, productEnums.CMS), ...formatForAll(EventsCMSAPITypes, productEnums.CMS),  ...formatForAll(FormsCMSAPITypes, productEnums.CMS), ...formatForAll(CommunitiesCMSAPITypes, productEnums.CMS), ...formatForAll(ERLCMSAPITypes, productEnums.CMS), ...formatForAll(RadioAPITypes, productEnums.RADIO) ];
 
-export type AllAPITypesType = 'GET_SERVERS' | 'SET_SERVERS' | 'GET_VERSION' | 'SET_PENAL_CODES' | 'SET_API_ID' | 'GET_TEMPLATES' | 'NEW_RECORD' | 'EDIT_RECORD' | 'REMOVE_RECORD' | 'LOOKUP_INT' | 'LOOKUP' | 'GET_ACCOUNT' | 'CHECK_APIID' | 'APPLY_PERMISSION_KEY' | 'SET_ACCOUNT_PERMISSIONS' | 'BAN_USER' | 'VERIFY_SECRET' | 'AUTH_STREETSIGNS' | 'SET_POSTALS' | 'SEND_PHOTO' | 'SET_CLOCK' | 'JOIN_COMMUNITY' | 'LEAVE_COMMUNITY' | 'GET_CHARACTERS' | 'NEW_CHARACTER' | 'EDIT_CHARACTER' | 'REMOVE_CHARACTER' | 'GET_IDENTIFIERS' | 'MODIFY_IDENTIFIER' | 'SET_IDENTIFIER' | 'UNIT_PANIC' | 'UNIT_STATUS' | 'GET_BLIPS' | 'ADD_BLIP' | 'MODIFY_BLIP' | 'REMOVE_BLIP' | '911_CALL' | 'REMOVE_911' | 'GET_CALLS' | 'GET_ACTIVE_UNITS' | 'KICK_UNIT' | 'NEW_DISPATCH' | 'ATTACH_UNIT' | 'DETACH_UNIT' | 'SET_CALL_POSTAL' | 'SET_CALL_PRIMARY' | 'ADD_CALL_NOTE' | 'CLOSE_CALL' | 'UNIT_LOCATION' | 'SET_STREETSIGN_CONFIG' | 'UPDATE_STREETSIGN' | 'GET_COM_ACCOUNT' | 'GET_DEPARTMENTS' | 'GET_SUB_VERSION' | 'GET_CURRENT_CLOCK_IN' | 'GET_ACCOUNTS' | 'GET_PROFILE_FIELDS' | 'CHECK_COM_APIID' | 'VERIFY_WHITELIST' | 'CLOCK_IN_OUT' | 'FULL_WHITELIST' | 'GET_ACCOUNT_RANKS' | 'SET_ACCOUNT_RANKS' | 'RSVP' | 'CHANGE_FORM_STAGE' | 'GET_FORM_TEMPLATE_SUBMISSIONS' | 'KICK_ACCOUNT' | 'BAN_ACCOUNT' | 'LOOKUP' | 'EDIT_ACC_PROFLIE_FIELDS' | 'SET_ACCOUNT_NAME' | 'FORCE_SYNC' | 'TRIGGER_PROMOTION_FLOWS' | 'GET_PROMOTION_FLOWS' | 'SET_GAME_SERVERS' | 'ERLC_GET_ONLINE_PLAYERS' | 'ERLC_GET_PLAYER_QUEUE' | 'ERLC_ADD_NEW_RECORD' | 'ERLC_EXECUTE_COMMAND' | 'RADIO_GET_COMMUNITY_CHANNELS' | 'RADIO_GET_CONNECTED_USERS' | 'RADIO_GET_CONNECTED_USER' | 'RADIO_SET_USER_CHANNELS' | 'RADIO_SET_USER_DISPLAY_NAME' | 'RADIO_GET_SERVER_SUBSCRIPTION_FROM_IP' | 'RADIO_SET_SERVER_IP' | 'RADIO_SET_IN_GAME_SPEAKER_LOCATIONS' | 'PLAY_TONE';
+export type AllAPITypesType = 'GET_SERVERS' | 'SET_SERVERS' | 'GET_VERSION' | 'SET_PENAL_CODES' | 'SET_API_ID' | 'GET_TEMPLATES' | 'NEW_RECORD' | 'EDIT_RECORD' | 'REMOVE_RECORD' | 'LOOKUP_INT' | 'LOOKUP' | 'GET_ACCOUNT' | 'CHECK_APIID' | 'APPLY_PERMISSION_KEY' | 'SET_ACCOUNT_PERMISSIONS' | 'BAN_USER' | 'VERIFY_SECRET' | 'AUTH_STREETSIGNS' | 'SET_POSTALS' | 'SEND_PHOTO' | 'SET_CLOCK' | 'JOIN_COMMUNITY' | 'LEAVE_COMMUNITY' | 'GET_CHARACTERS' | 'NEW_CHARACTER' | 'EDIT_CHARACTER' | 'REMOVE_CHARACTER' | 'GET_IDENTIFIERS' | 'MODIFY_IDENTIFIER' | 'SET_IDENTIFIER' | 'UNIT_PANIC' | 'UNIT_STATUS' | 'GET_BLIPS' | 'ADD_BLIP' | 'MODIFY_BLIP' | 'REMOVE_BLIP' | '911_CALL' | 'REMOVE_911' | 'GET_CALLS' | 'GET_ACTIVE_UNITS' | 'KICK_UNIT' | 'NEW_DISPATCH' | 'ATTACH_UNIT' | 'DETACH_UNIT' | 'SET_CALL_POSTAL' | 'SET_CALL_PRIMARY' | 'ADD_CALL_NOTE' | 'CLOSE_CALL' | 'UNIT_LOCATION' | 'SET_STREETSIGN_CONFIG' | 'UPDATE_STREETSIGN' | 'GET_COM_ACCOUNT' | 'GET_DEPARTMENTS' | 'GET_SUB_VERSION' | 'GET_CURRENT_CLOCK_IN' | 'GET_CLOCKIN_TYPES' | 'GET_LATEST_ACTIVITY' | 'GET_ACCOUNTS' | 'GET_PROFILE_FIELDS' | 'CHECK_COM_APIID' | 'VERIFY_WHITELIST' | 'CLOCK_IN_OUT' | 'FULL_WHITELIST' | 'GET_ACCOUNT_RANKS' | 'SET_ACCOUNT_RANKS' | 'RSVP' | 'CHANGE_FORM_STAGE' | 'GET_FORM_TEMPLATE_SUBMISSIONS' | 'KICK_ACCOUNT' | 'BAN_ACCOUNT' | 'LOOKUP' | 'EDIT_ACC_PROFLIE_FIELDS' | 'SET_ACCOUNT_NAME' | 'FORCE_SYNC' | 'TRIGGER_PROMOTION_FLOWS' | 'GET_PROMOTION_FLOWS' | 'SET_GAME_SERVERS' | 'ERLC_GET_ONLINE_PLAYERS' | 'ERLC_GET_PLAYER_QUEUE' | 'ERLC_ADD_NEW_RECORD' | 'ERLC_EXECUTE_COMMAND' | 'RADIO_GET_COMMUNITY_CHANNELS' | 'RADIO_GET_CONNECTED_USERS' | 'RADIO_GET_CONNECTED_USER' | 'RADIO_SET_USER_CHANNELS' | 'RADIO_SET_USER_DISPLAY_NAME' | 'RADIO_GET_SERVER_SUBSCRIPTION_FROM_IP' | 'RADIO_SET_SERVER_IP' | 'RADIO_SET_IN_GAME_SPEAKER_LOCATIONS' | 'PLAY_TONE';
 
 export interface CMSServerAPIStruct {
 	id: number;
@@ -1046,6 +1058,15 @@ export interface RESTTypedAPIDataStructs {
 		discord?: string,
 		uniqueId?: string
 	];
+	GET_CLOCKIN_TYPES: [];
+	GET_LATEST_ACTIVITY: [
+		data: {
+			accId: string,
+			type: 'clockin' | 'activity',
+			serverId?: number,
+			clockInType?: string,
+		}
+	];
 	GET_ACCOUNTS: [
 		options?: {
 			skip?: number,
@@ -1063,7 +1084,8 @@ export interface RESTTypedAPIDataStructs {
 		accId?: string,
 		forceClockIn?: boolean,
 		discord?: string,
-		uniqueId?: string
+		uniqueId?: string,
+		type?: string
 	];
 	GET_DEPARTMENTS: [];
 	GET_ACCOUNT_RANKS: [
@@ -1335,8 +1357,18 @@ export type PossibleRequestData =
 		serverId: number;
 	} |
 	{
-		apiId: string;
-		forceClockIn: boolean;
+		apiId?: string;
+		accId?: string;
+		forceClockIn?: boolean;
+		discord?: string;
+		uniqueId?: string;
+		type?: string;
+	} |
+	{
+		accId: string;
+		type: 'clockin' | 'activity';
+		serverId?: number;
+		clockInType?: string;
 	} |
 	{
 		accountId: string,

package/src/managers/CMSManager.ts

@@ -150,12 +150,14 @@ export class CMSManager extends BaseManager {
    * @param {string} [data.apiId] (Optional) The api id to clock in or out.
    * @param {boolean} [data.forceClockIn] If true, it will override any current clock in with a new clock in at the time of the request.
    * @param {string} [data.discord] (Optional) The discord ID to clock in or out.
+   * @param {string} [data.uniqueId] (Optional) The unique ID to clock in or out.
+   * @param {string} [data.type] (Optional) The UUID of a specific clock-in type to use.
    * @returns {Promise} Promise object represents if the request was successful with reason for failure if needed.
    */
-  public async clockInOut(data: { accId?: string, apiId?: string, forceClockIn?: boolean, discord?: string, uniqueId?: string }): Promise<globalTypes.CMSClockInOutPromiseResult> {
+  public async clockInOut(data: globalTypes.CMSClockInOutParams): Promise<globalTypes.CMSClockInOutPromiseResult> {
     return new Promise(async (resolve, reject) => {
       try {
-        const clockInOutRequest = await this.rest?.request('CLOCK_IN_OUT', data.apiId, data.accId, !!data.forceClockIn, data.discord, data.uniqueId);
+        const clockInOutRequest = await this.rest?.request('CLOCK_IN_OUT', data.apiId, data.accId, !!data.forceClockIn, data.discord, data.uniqueId, data.type);
         const clockInOutResponse = clockInOutRequest as globalTypes.clockInOutRequest;
         if (!clockInOutResponse) resolve({ success: false, reason: clockInOutRequest as string });
         resolve({ success: true, clockedIn: clockInOutResponse.completed });
@@ -169,6 +171,24 @@ export class CMSManager extends BaseManager {
     });
   }
 
+  /**
+   * Retrieves configured clock-in types for the community.
+   */
+  public async getClockInTypes(): Promise<globalTypes.CMSGetClockInTypesPromiseResult> {
+    return new Promise(async (resolve, reject) => {
+      try {
+        const response: any = await this.rest?.request('GET_CLOCKIN_TYPES');
+        resolve({ success: true, data: response });
+      } catch (err) {
+        if (err instanceof APIError) {
+          resolve({ success: false, reason: err.response });
+        } else {
+          reject(err);
+        }
+      }
+    });
+  }
+
   /**
    * Check if a given [apiId] is attached to any account within the community CMS.
    * @param {string} apiId The api id to check for an account.
@@ -483,6 +503,35 @@ export class CMSManager extends BaseManager {
     });
   }
 
+  /**
+   * Gets the latest clock-in or activity timestamp for the provided account.
+   */
+  public async getLatestActivity(params: { accId: string, type: 'clockin' | 'activity', serverId?: number, clockInType?: string }): Promise<globalTypes.CMSGetLatestActivityPromiseResult> {
+    if (!params?.accId) {
+      throw new Error('accId is required to get latest activity.');
+    }
+    if (params.type !== 'clockin' && params.type !== 'activity') {
+      throw new Error('type must be either "clockin" or "activity".');
+    }
+    if (params.type === 'activity' && params.serverId === undefined) {
+      throw new Error('serverId is required when type is "activity".');
+    }
+
+    return new Promise(async (resolve, reject) => {
+      try {
+        const response: any = await this.rest?.request('GET_LATEST_ACTIVITY', params);
+        const data = response && typeof response === 'object' && 'data' in response ? (response as any).data : response;
+        resolve({ success: true, data });
+      } catch (err) {
+        if (err instanceof APIError) {
+          resolve({ success: false, reason: err.response });
+        } else {
+          reject(err);
+        }
+      }
+    });
+  }
+
   /**
    * Gets the current clock in entry for a community member.
    * @param {Object} params Identification parameters for the account.