epicenter-libs 3.33.0 → 3.34.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+# [3.34.0](https://github.com/forio/epicenter-libs/compare/v3.33.0...v3.34.0) (2026-02-12)
+
+
+### Features
+
+* added chat endpoints for admin ([bd252cb](https://github.com/forio/epicenter-libs/commit/bd252cb03d5cc841ea43914651d951bba4c1ab65))
+
+
+
 # [3.33.0](https://github.com/forio/epicenter-libs/compare/v3.32.0...v3.33.0) (2025-11-20)
 
 

package/dist/browser/epicenter.js

@@ -9243,13 +9243,112 @@ async function getMessages(chatKey, optionals = {}) {
   }) => body);
 }
 
+/**
+ * Retrieves messages for a given user; requires facilitator authentication; works with an admin user
+ * Base URL: GET `https://forio.com/api/v3/{ACCOUNT}/{PROJECT}/chat/message/{CHAT_KEY}/{PSEUDONYM_KEY}`
+ *
+ * @example
+ * import { chatAdapter } from 'epicenter-libs';
+ * // gets the chat message with id: 5
+ * const message = await chatAdapter.getMessagesForUser('0000017dd3bf540e5ada5b1e058f08f20461', '000001796733eef0842f4d6d960997018a33', { horizon: 5, maxRecords: 1 });
+ * // gets the 10 chat messages starting from id 5 (inclusive)
+ * const messages = await chatAdapter.getMessagesForUser('0000017dd3bf540e5ada5b1e058f08f20461', '000001796733eef0842f4d6d960997018a33', { horizon: 5, maxRecords: 10 });
+ *
+ * @param chatKey                   Key associated with the chat
+ * @param pseudonymKey             Key associated with the user whose messages are being retrieved
+ * @param [optionals]               Optional arguments; pass network call options overrides here. Special arguments specific to this method are listed below if they exist.
+ * @param [optionals.maxRecords]    Maximum number of messages to get
+ * @param [optionals.horizon]       The message ID from which to start with; works backwards so if `maxRecords=20` and `horizon=50`, it will get the 20 messages starting from message ID 50, working backwards (50, 49, 48..., etc.). If this value is omitted the platform assumes it is the most recent message in the chat
+ * @returns promise that resolves to the list of chat messages requested
+ */
+async function getMessagesForUser(chatKey, pseudonymKey, optionals = {}) {
+  const {
+    maxRecords,
+    horizon,
+    ...routingOptions
+  } = optionals;
+  return new Router().withSearchParams({
+    maxRecords,
+    horizon
+  }).get(`/chat/message/${chatKey}/${pseudonymKey}`, routingOptions).then(({
+    body
+  }) => body);
+}
+
+/**
+ * Retrieves messages from for a given chat for an admin user; requires support authentication
+ * Base URL: GET `https://forio.com/api/v3/{ACCOUNT}/{PROJECT}/chat/message/all/{CHAT_KEY}`
+ *
+ * @example
+ * import { chatAdapter } from 'epicenter-libs';
+ * // gets the chat message with id: 5
+ * const message = await chatAdapter.getMessagesAdmin('0000017dd3bf540e5ada5b1e058f08f20461', { horizon: 5, maxRecords: 1 });
+ * // gets the 10 chat messages starting from id 5 (inclusive)
+ * const messages = await chatAdapter.getMessagesAdmin('0000017dd3bf540e5ada5b1e058f08f20461', { horizon: 5, maxRecords: 10 });
+ *
+ * @param chatKey                   Key associated with the chat
+ * @param [optionals]               Optional arguments; pass network call options overrides here. Special arguments specific to this method are listed below if they exist.
+ * @param [optionals.maxRecords]    Maximum number of messages to get
+ * @param [optionals.horizon]       The message ID from which to start with; works backwards so if `maxRecords=20` and `horizon=50`, it will get the 20 messages starting from message ID 50, working backwards (50, 49, 48..., etc.). If this value is omitted the platform assumes it is the most recent message in the chat
+ * @returns promise that resolves to the list of chat messages requested
+ */
+async function getMessagesAdmin(chatKey, optionals = {}) {
+  const {
+    maxRecords,
+    horizon,
+    ...routingOptions
+  } = optionals;
+  return new Router().withSearchParams({
+    maxRecords,
+    horizon
+  }).get(`/chat/message/all/${chatKey}`, routingOptions).then(({
+    body
+  }) => body);
+}
+
+/**
+ * Sends a message to a chat as an admin user; requires support authentication
+ * Base URL: PUT `https://forio.com/api/v3/{ACCOUNT}/{PROJECT}/chat/message/system/{CHAT_KEY}` or PUT `https://forio.com/api/v3/{ACCOUNT}/{PROJECT}/chat/message/system/{CHAT_KEY}/{USER_KEY}`
+ *
+ * @example
+ * import { chatAdapter } from 'epicenter-libs';
+ * // Send a public message to the chat
+ * await chatAdapter.sendMessageAdmin('0000017dd3bf540e5ada5b1e058f08f20461', 'hello');
+ * // Send a private message to a specific user
+ * await chatAdapter.sendMessageAdmin('0000017dd3bf540e5ada5b1e058f08f20461', 'hello, privately', { userKey: '000001796733eef0842f4d6d960997018a33' });
+ *
+ * @param chatKey               Key associated with the chat
+ * @param message               Message text to send
+ * @param [optionals]           Optional arguments; pass network call options overrides here. Special arguments specific to this method are listed below if they exist.
+ * @param [optionals.userKey]   Key of the user to send the message to. If omitted, will send as a public message
+ * @returns promise that resolves to the chat message created
+ */
+async function sendMessageAdmin(chatKey, message, optionals = {}) {
+  const {
+    userKey,
+    ...routingOptions
+  } = optionals;
+  const uriComponent = userKey ? `/${userKey}` : '';
+  return new Router().put(`/chat/message/system/${chatKey}${uriComponent}`, {
+    body: {
+      message
+    },
+    ...routingOptions
+  }).then(({
+    body
+  }) => body);
+}
+
 var chat = /*#__PURE__*/Object.freeze({
 	__proto__: null,
 	create: create$3,
 	get: get$3,
 	getMessages: getMessages,
+	getMessagesAdmin: getMessagesAdmin,
+	getMessagesForUser: getMessagesForUser,
 	query: query,
 	sendMessage: sendMessage,
+	sendMessageAdmin: sendMessageAdmin,
 	updatePermit: updatePermit
 });
 
@@ -10654,8 +10753,8 @@ var utilities = /*#__PURE__*/Object.freeze({
 });
 
 /* yes, this string template literal is weird;
- * it's cause rollup does not recogize 3.33.0 as an individual token otherwise */
-const version = `Epicenter (v${'3.33.0'}) for Browsers | Build Date: 2025-11-20T19:19:07.204Z`;
+ * it's cause rollup does not recogize 3.34.0 as an individual token otherwise */
+const version = `Epicenter (v${'3.34.0'}) for Browsers | Build Date: 2026-02-12T21:41:02.367Z`;
 const UNAUTHORIZED = 401;
 const FORBIDDEN = 403;
 const DEFAULT_ERROR_HANDLERS = {};