core-services-sdk 1.3.48 → 1.3.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.3.48",
+  "version": "1.3.49",
   "main": "src/index.js",
   "type": "module",
   "types": "types/index.d.ts",

package/src/instant-messages/message-types.js

@@ -7,54 +7,24 @@
  *
  * @readonly
  * @enum {string}
+ * @type {{ [key: string]: string }}
  *
  * @property {"text"} TEXT
- *   Represents plain text content.
- *
  * @property {"poll"} POLL
- *   Represents a Telegram poll (multiple-choice question).
- *
  * @property {"video"} VIDEO
- *   Represents a standard video file.
- *
  * @property {"photo"} PHOTO
- *   Represents a Telegram “photo” array (before mapping to IMAGE).
- *
  * @property {"image"} IMAGE
- *   Represents an image file (after normalization).
- *
  * @property {"voice"} VOICE
- *   Represents Telegram's "voice" messages (OGG encoded voice notes).
- *
  * @property {"audio"} AUDIO
- *   Represents general audio files (WhatsApp voice notes, audio uploads).
- *
  * @property {"sticker"} STICKER
- *   Represents sticker messages (Telegram or WhatsApp).
- *
  * @property {"contact"} CONTACT
- *   Represents a shared contact card.
- *
  * @property {"reaction"} REACTION
- *   Represents WhatsApp/Telegram reactions (emojis on messages).
- *
  * @property {"document"} DOCUMENT
- *   Represents generic uploaded files, including PDFs.
- *
  * @property {"location"} LOCATION
- *   Represents geographic coordinates.
- *
  * @property {"contacts"} CONTACTS
- *   Represents WhatsApp contacts array (before mapping to CONTACT).
- *
  * @property {"video_note"} VIDEO_NOTE
- *   Represents Telegram's circular "video note".
- *
  * @property {"button_click"} BUTTON_CLICK
- *   Represents a button press (interactive replies).
- *
  * @property {"button_click_multiple"} BUTTON_CLICK_MULTIPLE
- *   Represents list/menu selection (e.g., WhatsApp list_reply).
  */
 export const MESSAGE_MEDIA_TYPE = {
   TEXT: 'text',
@@ -75,7 +45,6 @@ export const MESSAGE_MEDIA_TYPE = {
   BUTTON_CLICK: 'button_click',
   BUTTON_CLICK_MULTIPLE: 'button_click_multiple',
 }
-
 /**
  * Additional high-level message categories.
  *
@@ -83,6 +52,7 @@ export const MESSAGE_MEDIA_TYPE = {
  *
  * @readonly
  * @enum {string}
+ * @type {{ [key: string]: string }}
  *
  * @property {"message"} MESSAGE
  *   Regular message container (base type in some providers).
@@ -125,3 +95,27 @@ export const MESSAGE_MEDIA_TYPE_MAPPER = {
   [MESSAGE_MEDIA_TYPE.PHOTO]: MESSAGE_MEDIA_TYPE.IMAGE,
   [MESSAGE_MEDIA_TYPE.CONTACTS]: MESSAGE_MEDIA_TYPE.CONTACT,
 }
+
+/**
+ * Unified message media types based on existing MESSAGE_MEDIA_TYPE and MESSAGE_TYPE.
+ *
+ * This enum flattens and merges all raw message media types
+ * into a single canonical type list.
+ *
+ * VOICE → AUDIO
+ * PHOTO → IMAGE
+ * CONTACTS → CONTACT
+ *
+ * @readonly
+ * @enum {string}
+ * @type {{ [key: string]: string }}
+ */
+export const UNIFIED_MESSAGE_MEDIA_TYPE = {
+  ...MESSAGE_MEDIA_TYPE,
+  ...MESSAGE_TYPE,
+
+  // Normalized equivalents
+  AUDIO: MESSAGE_MEDIA_TYPE.AUDIO,
+  IMAGE: MESSAGE_MEDIA_TYPE.IMAGE,
+  CONTACT: MESSAGE_MEDIA_TYPE.CONTACT,
+}

package/tests/instant-messages/message-unified-mapper-telegram.unit.test.js

@@ -39,7 +39,6 @@ describe('Telegram unified message mapper – all mock samples', () => {
 
         expect(unifiedMessage).toBeTypeOf('object')
         expect(unifiedType).toBeTypeOf('string')
-
         expect(unifiedMessage.type).toBe(
           MESSAGE_MEDIA_TYPE_MAPPER[unifiedType] || unifiedType,
         )

package/tests/instant-messages/unified-message-type.unit.test.js

@@ -0,0 +1,78 @@
+import { describe, it, expect } from 'vitest'
+import {
+  MESSAGE_TYPE,
+  MESSAGE_MEDIA_TYPE,
+  MESSAGE_MEDIA_TYPE_MAPPER,
+  UNIFIED_MESSAGE_MEDIA_TYPE,
+} from '../../src/instant-messages/message-types.js'
+
+describe('UNIFIED_MESSAGE_MEDIA_TYPE', () => {
+  it('should include all keys from MESSAGE_MEDIA_TYPE via spread', () => {
+    for (const key of Object.keys(MESSAGE_MEDIA_TYPE)) {
+      expect(UNIFIED_MESSAGE_MEDIA_TYPE).toHaveProperty(key)
+      expect(UNIFIED_MESSAGE_MEDIA_TYPE[key]).toBe(MESSAGE_MEDIA_TYPE[key])
+    }
+  })
+
+  it('should include all keys from MESSAGE_TYPE via spread', () => {
+    for (const key of Object.keys(MESSAGE_TYPE)) {
+      expect(UNIFIED_MESSAGE_MEDIA_TYPE).toHaveProperty(key)
+      expect(UNIFIED_MESSAGE_MEDIA_TYPE[key]).toBe(MESSAGE_TYPE[key])
+    }
+  })
+
+  it('should include normalized AUDIO mapped from VOICE', () => {
+    expect(UNIFIED_MESSAGE_MEDIA_TYPE.AUDIO).toBe(MESSAGE_MEDIA_TYPE.AUDIO)
+    expect(MESSAGE_MEDIA_TYPE_MAPPER[MESSAGE_MEDIA_TYPE.VOICE]).toBe(
+      MESSAGE_MEDIA_TYPE.AUDIO,
+    )
+  })
+
+  it('should include normalized IMAGE mapped from PHOTO', () => {
+    expect(UNIFIED_MESSAGE_MEDIA_TYPE.IMAGE).toBe(MESSAGE_MEDIA_TYPE.IMAGE)
+    expect(MESSAGE_MEDIA_TYPE_MAPPER[MESSAGE_MEDIA_TYPE.PHOTO]).toBe(
+      MESSAGE_MEDIA_TYPE.IMAGE,
+    )
+  })
+
+  it('should include normalized CONTACT mapped from CONTACTS', () => {
+    expect(UNIFIED_MESSAGE_MEDIA_TYPE.CONTACT).toBe(MESSAGE_MEDIA_TYPE.CONTACT)
+    expect(MESSAGE_MEDIA_TYPE_MAPPER[MESSAGE_MEDIA_TYPE.CONTACTS]).toBe(
+      MESSAGE_MEDIA_TYPE.CONTACT,
+    )
+  })
+
+  it('should define UNKNOWN correctly', () => {
+    expect(UNIFIED_MESSAGE_MEDIA_TYPE.UNKNOWN_MESSAGE_TYPE).toBe(
+      MESSAGE_TYPE.UNKNOWN_MESSAGE_TYPE,
+    )
+  })
+
+  it('should not contain unexpected duplicates', () => {
+    const values = Object.values(UNIFIED_MESSAGE_MEDIA_TYPE)
+    const uniqueValues = new Set(values)
+    expect(values.length).toBe(uniqueValues.size)
+  })
+
+  it('should contain required high-level unified types', () => {
+    const required = [
+      'TEXT',
+      'IMAGE',
+      'AUDIO',
+      'VIDEO',
+      'DOCUMENT',
+      'STICKER',
+      'CONTACT',
+      'LOCATION',
+      'POLL',
+      'VIDEO_NOTE',
+      'BUTTON_CLICK',
+      'BUTTON_CLICK_MULTIPLE',
+      'REACTION',
+    ]
+
+    for (const key of required) {
+      expect(UNIFIED_MESSAGE_MEDIA_TYPE).toHaveProperty(key)
+    }
+  })
+})

package/types/instant-messages/message-types.d.ts

@@ -2,37 +2,64 @@
  * *
  */
 export type MESSAGE_MEDIA_TYPE = string
-export namespace MESSAGE_MEDIA_TYPE {
-  let TEXT: string
-  let POLL: string
-  let VIDEO: string
-  let PHOTO: string
-  let IMAGE: string
-  let VOICE: string
-  let AUDIO: string
-  let STICKER: string
-  let CONTACT: string
-  let MESSAGE: string
-  let REACTION: string
-  let DOCUMENT: string
-  let LOCATION: string
-  let CONTACTS: string
-  let VIDEO_NOTE: string
-  let BUTTON_CLICK: string
-  let BUTTON_CLICK_MULTIPLE: string
+/**
+ * Enumerates all supported incoming media/content types
+ * across messaging platforms (Telegram, WhatsApp, etc).
+ *
+ * This is the unified taxonomy used inside the system
+ * after normalization of the raw message payload.
+ *
+ * @readonly
+ * @enum {string}
+ * @type {{ [key: string]: string }}
+ *
+ * @property {"text"} TEXT
+ * @property {"poll"} POLL
+ * @property {"video"} VIDEO
+ * @property {"photo"} PHOTO
+ * @property {"image"} IMAGE
+ * @property {"voice"} VOICE
+ * @property {"audio"} AUDIO
+ * @property {"sticker"} STICKER
+ * @property {"contact"} CONTACT
+ * @property {"reaction"} REACTION
+ * @property {"document"} DOCUMENT
+ * @property {"location"} LOCATION
+ * @property {"contacts"} CONTACTS
+ * @property {"video_note"} VIDEO_NOTE
+ * @property {"button_click"} BUTTON_CLICK
+ * @property {"button_click_multiple"} BUTTON_CLICK_MULTIPLE
+ */
+export const MESSAGE_MEDIA_TYPE: {
+  [key: string]: string
 }
 /**
  * *
  */
 export type MESSAGE_TYPE = string
-export namespace MESSAGE_TYPE {
-  let MESSAGE_1: string
-  export { MESSAGE_1 as MESSAGE }
-  import BUTTON_CLICK_1 = MESSAGE_MEDIA_TYPE.BUTTON_CLICK
-  export { BUTTON_CLICK_1 as BUTTON_CLICK }
-  import BUTTON_CLICK_MULTIPLE_1 = MESSAGE_MEDIA_TYPE.BUTTON_CLICK_MULTIPLE
-  export { BUTTON_CLICK_MULTIPLE_1 as BUTTON_CLICK_MULTIPLE }
-  export let UNKNOWN_MESSAGE_TYPE: string
+/**
+ * Additional high-level message categories.
+ *
+ * These represent logical groupings rather than raw media types.
+ *
+ * @readonly
+ * @enum {string}
+ * @type {{ [key: string]: string }}
+ *
+ * @property {"message"} MESSAGE
+ *   Regular message container (base type in some providers).
+ *
+ * @property {"button_click"} BUTTON_CLICK
+ *   A click on a single interactive button.
+ *
+ * @property {"button_click_multiple"} BUTTON_CLICK_MULTIPLE
+ *   A selection from a list of interactive reply choices.
+ *
+ * @property {"unknown_message_type"} UNKNOWN_MESSAGE_TYPE
+ *   Used when the system cannot identify or normalize the message type.
+ */
+export const MESSAGE_TYPE: {
+  [key: string]: string
 }
 /**
  * *
@@ -60,3 +87,24 @@ export const MESSAGE_MEDIA_TYPE_MAPPER: {
   [MESSAGE_MEDIA_TYPE.PHOTO]: string
   [MESSAGE_MEDIA_TYPE.CONTACTS]: string
 }
+/**
+ * *
+ */
+export type UNIFIED_MESSAGE_MEDIA_TYPE = string
+/**
+ * Unified message media types based on existing MESSAGE_MEDIA_TYPE and MESSAGE_TYPE.
+ *
+ * This enum flattens and merges all raw message media types
+ * into a single canonical type list.
+ *
+ * VOICE → AUDIO
+ * PHOTO → IMAGE
+ * CONTACTS → CONTACT
+ *
+ * @readonly
+ * @enum {string}
+ * @type {{ [key: string]: string }}
+ */
+export const UNIFIED_MESSAGE_MEDIA_TYPE: {
+  [key: string]: string
+}