@digisglobal/omnivox-sdk 0.8.0 → 0.10.0

package/dist/index.js

@@ -117,6 +117,15 @@ var getConversationsControllerUpdateStatusUrl = (id) => {
 var getConversationsControllerAssignUrl = (id) => {
   return `/api/v1/conversations/${id}/assign`;
 };
+var getConversationsControllerAddParticipantUrl = (id) => {
+  return `/api/v1/conversations/${id}/participants`;
+};
+var getConversationsControllerListParticipantsUrl = (id) => {
+  return `/api/v1/conversations/${id}/participants`;
+};
+var getConversationsControllerRemoveParticipantUrl = (id, agentId) => {
+  return `/api/v1/conversations/${id}/participants/${agentId}`;
+};
 var getConversationsControllerListLobbyUrl = (params) => {
   const normalizedParams = new URLSearchParams();
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -277,12 +286,38 @@ var getCannedResponsesControllerPatchUrl = (id) => {
 var getCannedResponsesControllerDeleteUrl = (id) => {
   return `/api/v1/canned-responses/${id}`;
 };
+var getCannedResponsesControllerDuplicateUrl = (id) => {
+  return `/api/v1/canned-responses/${id}/duplicate`;
+};
 var getAttachmentsControllerUploadUrl = () => {
   return `/api/v1/attachments`;
 };
 var getAttachmentsControllerGetDownloadUrlUrl = (id) => {
   return `/api/v1/attachments/${id}/url`;
 };
+var getDashboardControllerGetStatsUrl = () => {
+  return `/api/v1/dashboard/stats`;
+};
+var getDashboardControllerGetRecentActivityUrl = (params) => {
+  const normalizedParams = new URLSearchParams();
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== void 0) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+  const stringifiedParams = normalizedParams.toString();
+  return stringifiedParams.length > 0 ? `/api/v1/dashboard/recent-activity?${stringifiedParams}` : `/api/v1/dashboard/recent-activity`;
+};
+var getAuditLogControllerListUrl = (params) => {
+  const normalizedParams = new URLSearchParams();
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== void 0) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+  const stringifiedParams = normalizedParams.toString();
+  return stringifiedParams.length > 0 ? `/api/v1/audit-log?${stringifiedParams}` : `/api/v1/audit-log`;
+};
 
 // src/pagination/pagination.ts
 var MAX_PAGE_SIZE = 100;
@@ -699,6 +734,60 @@ function createConversationsModule(options) {
   };
 }
 
+// src/conversations/participants.ts
+function createParticipantsModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit(method, body) {
+    return {
+      method,
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    };
+  }
+  return {
+    /**
+     * Add (or re-add) an agent as a conversation participant with a role.
+     * Idempotent per active membership — re-adding an active participant
+     * updates its role; a second OWNER co-owns (no demotion of other owners).
+     * Calls POST /api/v1/conversations/:id/participants.
+     */
+    async add(conversationId, input) {
+      const path = getConversationsControllerAddParticipantUrl(conversationId);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("POST", input));
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * End an active membership for an agent. Idempotent — removing a
+     * non-participant is a no-op ({ removed: 0 }).
+     * Calls DELETE /api/v1/conversations/:id/participants/:agentId.
+     */
+    async remove(conversationId, agentId) {
+      const path = getConversationsControllerRemoveParticipantUrl(
+        conversationId,
+        agentId
+      );
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("DELETE"));
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * List the ACTIVE (leftAt IS NULL) participants of a conversation.
+     * Calls GET /api/v1/conversations/:id/participants.
+     */
+    async list(conversationId) {
+      const path = getConversationsControllerListParticipantsUrl(conversationId);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("GET"));
+      return parseEnvelopedResponse(res);
+    }
+  };
+}
+
 // src/messages/messages.ts
 function createMessagesModule(options) {
   const baseUrl = options.baseUrl;
@@ -982,7 +1071,12 @@ function createCannedResponsesModule(options) {
      */
     async list(opts) {
       const { page, pageSize } = buildPageParams(opts);
-      const path = getCannedResponsesControllerListUrl({ page, pageSize });
+      const path = getCannedResponsesControllerListUrl({
+        page,
+        pageSize,
+        ...opts.category ? { category: opts.category } : {},
+        ...opts.channel ? { channel: opts.channel } : {}
+      });
       const url = `${baseUrl}${path}`;
       const res = await fetch(url, buildInit("GET"));
       return parseResponse(res);
@@ -997,7 +1091,9 @@ function createCannedResponsesModule(options) {
       const path = getCannedResponsesControllerListUrl({
         page,
         pageSize,
-        q: opts.q
+        q: opts.q,
+        ...opts.category ? { category: opts.category } : {},
+        ...opts.channel ? { channel: opts.channel } : {}
       });
       const url = `${baseUrl}${path}`;
       const res = await fetch(url, buildInit("GET"));
@@ -1014,7 +1110,7 @@ function createCannedResponsesModule(options) {
       return parseEnvelopedResponse(res);
     },
     /**
-     * Partially update a canned response — title, body, and/or keywords.
+     * Partially update a canned response — title, shortcut, category, channel, and/or body.
      * Calls PATCH /api/v1/canned-responses/:id.
      */
     async update(id, input) {
@@ -1034,6 +1130,16 @@ function createCannedResponsesModule(options) {
       if (!res.ok) {
         return parseResponse(res);
       }
+    },
+    /**
+     * Duplicate a canned response. The server generates a unique title and
+     * shortcut. Calls POST /api/v1/canned-responses/:id/duplicate.
+     */
+    async duplicate(id) {
+      const path = getCannedResponsesControllerDuplicateUrl(id);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit("POST"));
+      return parseEnvelopedResponse(res);
     }
   };
 }
@@ -1177,6 +1283,89 @@ function createWhatsAppBusinessAccountsModule(options) {
   };
 }
 
+// src/dashboard/dashboard.ts
+function createDashboardModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit() {
+    return {
+      method: "GET",
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      }
+    };
+  }
+  return {
+    /**
+     * Fetch the tenant dashboard KPIs.
+     * Calls GET /api/v1/dashboard/stats.
+     */
+    async stats() {
+      const path = getDashboardControllerGetStatsUrl();
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseEnvelopedResponse(res);
+    },
+    /**
+     * List the tenant's recent conversation/message activity feed
+     * (newest first, paginated). pageSize is clamped to 100 per the API
+     * contract. Calls GET /api/v1/dashboard/recent-activity.
+     */
+    async recentActivity(opts = { page: 1, pageSize: 25 }) {
+      const { page, pageSize } = buildPageParams(opts);
+      const path = getDashboardControllerGetRecentActivityUrl({
+        page,
+        pageSize
+      });
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseResponse(res);
+    }
+  };
+}
+
+// src/audit/audit.ts
+function createAuditModule(options) {
+  const baseUrl = options.baseUrl;
+  function buildInit() {
+    return {
+      method: "GET",
+      credentials: options.getCredentials(),
+      headers: {
+        "Content-Type": "application/json",
+        ...options.getHeaders()
+      }
+    };
+  }
+  return {
+    /**
+     * List the tenant audit trail (newest first, paginated).
+     * pageSize is clamped to 100 per the API contract.
+     * Calls GET /api/v1/audit-log.
+     */
+    async list(opts = {}) {
+      const { page, pageSize } = buildPageParams({
+        page: opts.page ?? 1,
+        pageSize: opts.pageSize ?? 25
+      });
+      const params = {
+        ...opts.resourceType !== void 0 ? { resourceType: opts.resourceType } : {},
+        ...opts.resourceId !== void 0 ? { resourceId: opts.resourceId } : {},
+        ...opts.actorId !== void 0 ? { actorId: opts.actorId } : {},
+        ...opts.from !== void 0 ? { from: opts.from } : {},
+        ...opts.to !== void 0 ? { to: opts.to } : {},
+        page,
+        pageSize
+      };
+      const path = getAuditLogControllerListUrl(params);
+      const url = `${baseUrl}${path}`;
+      const res = await fetch(url, buildInit());
+      return parseResponse(res);
+    }
+  };
+}
+
 // src/ws/ws-client.ts
 import { io } from "socket.io-client";
 function createWsClient(options) {
@@ -1267,11 +1456,14 @@ function createOmnivoxClient(options) {
     channels: createChannelsModule(moduleOptions),
     contacts: createContactsModule(moduleOptions),
     conversations: createConversationsModule(moduleOptions),
+    participants: createParticipantsModule(moduleOptions),
     messages: createMessagesModule(moduleOptions),
     templates: createTemplatesModule(moduleOptions),
     cannedResponses: createCannedResponsesModule(moduleOptions),
     attachments: createAttachmentsModule(moduleOptions),
     whatsappBusinessAccounts: createWhatsAppBusinessAccountsModule(moduleOptions),
+    dashboard: createDashboardModule(moduleOptions),
+    audit: createAuditModule(moduleOptions),
     /**
      * Creates a WebSocket client connected to the `/ws/chat` namespace.
      *
@@ -1326,13 +1518,16 @@ export {
   createAgentsModule,
   createApiKeyTokenProvider,
   createAttachmentsModule,
+  createAuditModule,
   createAuthMeModule,
   createCannedResponsesModule,
   createChannelsModule,
   createContactsModule,
   createConversationsModule,
+  createDashboardModule,
   createMessagesModule,
   createOmnivoxClient,
+  createParticipantsModule,
   createSessionTokenProvider,
   createTemplatesModule,
   createTenantsModule,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digisglobal/omnivox-sdk",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {