@sonoransoftware/sonoran.js 1.0.41 → 1.0.42

package/dist/constants.d.ts

@@ -111,6 +111,29 @@ 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;
@@ -119,7 +142,7 @@ export interface CMSGetClockInTypesPromiseResult {
 export interface CMSGetLatestActivityPromiseResult {
     success: boolean;
     reason?: string;
-    data?: string | null;
+    data?: AccountClockInLog[] | AccountActivityLog[];
 }
 export interface CMSClockInOutParams {
     accId?: string;

package/dist/managers/CMSManager.js

@@ -578,7 +578,8 @@ class CMSManager extends BaseManager_1.BaseManager {
             var _a;
             try {
                 const response = await ((_a = this.rest) === null || _a === void 0 ? void 0 : _a.request('GET_LATEST_ACTIVITY', params));
-                resolve({ success: true, data: response });
+                const data = response && typeof response === 'object' && 'data' in response ? response.data : response;
+                resolve({ success: true, data });
             }
             catch (err) {
                 if (err instanceof src_1.APIError) {

package/package.json

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

@@ -127,6 +127,31 @@ export interface CMSClockInType {
 	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;
@@ -136,7 +161,7 @@ export interface CMSGetClockInTypesPromiseResult {
 export interface CMSGetLatestActivityPromiseResult {
 	success: boolean;
 	reason?: string;
-	data?: string | null;
+	data?: AccountClockInLog[] | AccountActivityLog[];
 }
 
 export interface CMSClockInOutParams {

package/src/managers/CMSManager.ts

@@ -520,7 +520,8 @@ export class CMSManager extends BaseManager {
     return new Promise(async (resolve, reject) => {
       try {
         const response: any = await this.rest?.request('GET_LATEST_ACTIVITY', params);
-        resolve({ success: true, data: response });
+        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 });