@futdevpro/fsm-dynamo 1.20.88 → 1.20.93

package/build-esm/_modules/location/_collections/loc-country-divisions.const.js

@@ -0,0 +1,3 @@
+import { DyFM_Regions } from './loc-regions.util';
+/** List of country subdivisions indexed by ISO-3166 codes. */
+export const DyFM_countryDivisions = DyFM_Regions?.divisions ?? [];

package/build-esm/_modules/location/_collections/loc-country-isos.const.js

@@ -0,0 +1,2 @@
+import { DyFM_Regions } from './loc-regions.util';
+export const DyFM_countryISOs = DyFM_Regions?.countryISOs ?? [];

package/build-esm/_modules/location/_collections/loc-regions.util.js

@@ -0,0 +1,107 @@
+/* const ISOs = [];
+const PhoneCodes = [];
+const Divisions = []; */
+import * as ISOs from './assets/country-codes-ISO-3166.json';
+import * as PhoneCodes from './assets/country-phone-codes.json';
+import * as Divisions from './assets/country-divisions-ISO-3166-all-list.json';
+import { DyFM_Object } from '../../../_collections/utils/object.util';
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+/**
+ * Static utilities for retrieving country and region information
+ * from bundled ISO datasets.
+ */
+export class DyFM_Regions {
+    /* static divisions: DivisionCollection = DyFM_Regions.getSubdivisionCollection(); */
+    static divisions = DyFM_Regions.getAllDivisions();
+    static phoneCodes = DyFM_Regions.getAllPhoneCodes();
+    static countryISOs = DyFM_Regions.getAllCountryISO();
+    static getAllDivisions() {
+        if (!Divisions)
+            throw new DyFM_Error({ message: 'Cannot find ISO-3166 JSON file.' });
+        return DyFM_Object.JSONListify(Divisions);
+    }
+    static getAllPhoneCodes() {
+        if (!PhoneCodes)
+            throw new DyFM_Error({ message: 'Cannot find ISO-3166 JSON file.' });
+        return DyFM_Object.JSONListify(PhoneCodes);
+    }
+    /*  private static getSubdivisionCollection(): DivisionCollection {
+      return Divisions as DivisionCollection;
+    } */
+    static getAllCountryISO() {
+        if (!ISOs)
+            throw new DyFM_Error({ message: 'Cannot find ISO-3166 JSON file.' });
+        const result = DyFM_Object.JSONListify(ISOs);
+        result.forEach((iso) => {
+            iso.phoneCode = this.phoneCodes.find((pc) => pc.iso === iso.iso2)?.code;
+            iso.divisions = this.divisions.filter((d) => d.iso === iso.iso2);
+        });
+        return result;
+    }
+    /**
+     * Converts an ISO-3166 code to a country ISO object.
+     * @param iso2 The ISO-3166 code to convert.
+     * @returns The country ISO object.
+     *
+     * @example
+     * ```ts
+     * const country: DyFM_CountryISO = DyFM_Regions.isoToCountryIso('US');
+     * console.log(country.name); // United States
+     * ```
+     */
+    static isoToCountryIso(iso2) {
+        const country = this.countryISOs.find((iso) => iso.iso2 == iso2);
+        if (!country) {
+            throw new DyFM_Error({
+                message: `Cannot find ISO-3166 code for this: ${iso2}`,
+            });
+        }
+        else {
+            return country;
+        }
+    }
+    /**
+     * Converts an ISO-3166 code to a region.
+     * @param iso2 The ISO-3166 code to convert.
+     * @returns The region.
+     *
+     * @example
+     * ```ts
+     * const region: DyFM_Region = DyFM_Regions.isoToRegion('US');
+     * console.log(region); // North America
+     * ```
+     */
+    static isoToRegion(iso2) {
+        const region = this.countryISOs.find((iso) => iso.iso2 == iso2)?.region;
+        if (!region) {
+            throw new DyFM_Error({
+                message: `Cannot find ISO-3166 code for this: ${iso2}`,
+            });
+        }
+        else {
+            return region;
+        }
+    }
+    /**
+     * Converts an ISO-3166 code to a phone code.
+     * @param iso2 The ISO-3166 code to convert.
+     * @returns The phone code.
+     *
+     * @example
+     * ```ts
+     * const phoneCode: DyFM_CountryPhoneCode = DyFM_Regions.isoToPhoneCode('US');
+     * console.log(phoneCode.code); // +1
+     * ```
+     */
+    static isoToPhoneCode(iso2) {
+        const phoneCode = this.phoneCodes.find((code) => code.iso == iso2);
+        if (!phoneCode) {
+            throw new DyFM_Error({
+                message: `Cannot find ISO-3166 code for this: ${iso2}`,
+            });
+        }
+        else {
+            return phoneCode;
+        }
+    }
+}

package/build-esm/_modules/location/_collections/loc.util.js

@@ -0,0 +1,56 @@
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+import { DyFM_Trigonometry } from '../../../_collections/utils/math/trigonometry.util';
+/**
+ * Helper utilities for geographic calculations.
+ */
+export class DyFM_Location {
+    /**
+     * Calculates the distance between two coordinates using the haversine formula.
+     */
+    static getDistanceInKilometres(from, to) {
+        const R = 6371; // kilometres
+        const φ1 = DyFM_Trigonometry.angleToRadians(from.latitude);
+        const φ2 = DyFM_Trigonometry.angleToRadians(to.latitude);
+        const Δφ = DyFM_Trigonometry.angleToRadians(to.latitude - from.latitude);
+        const Δλ = DyFM_Trigonometry.angleToRadians(to.longitude - from.longitude);
+        const a = Math.sin(Δφ / 2) * Math.sin(Δφ / 2) +
+            Math.cos(φ1) * Math.cos(φ2) *
+                Math.sin(Δλ / 2) * Math.sin(Δλ / 2);
+        const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+        return R * c;
+    }
+    /**
+     * Converts a distance in kilometers to degree difference for latitude or longitude.
+     * @param latiOrLong The direction to convert to degrees.
+     * @param distanceInKm The distance in kilometers.
+     * @param latitude The latitude to use for the conversion.
+     * @returns The degree difference.
+     *
+     * @example
+     * ```ts
+     * const degreeChange = DyFM_Location.getLocationDegByKilometers('latitude', 110.574);
+     * console.log(degreeChange); // 1
+     * ```
+     */
+    static getLocationDegByKilometers(latiOrLong, distanceInKm, latitude) {
+        if (latiOrLong === 'latitude') {
+            return distanceInKm / 110.574;
+        }
+        else {
+            if (latitude) {
+                return distanceInKm / (Math.cos(DyFM_Trigonometry.angleToRadians(latitude)) * 111.320);
+            }
+            else {
+                throw new DyFM_Error({
+                    status: 417,
+                    errorCode: 'FSM-DSS-505',
+                    addECToUserMsg: true,
+                    message: `When using getLocationDegByKilometers for longitude, you need to give latitude! ` +
+                        `(latiOrLong: ${latiOrLong}, distanceInKm: ${distanceInKm}, latitude: ${latitude})`,
+                    userMessage: `We encountered an uncought BackEnd Error, ` +
+                        `please contact the responsible development team.`,
+                });
+            }
+        }
+    }
+}

package/build-esm/_modules/location/_enums/loc-region.enum.js

@@ -0,0 +1,11 @@
+/**
+ * Continents and large geographic regions.
+ */
+export var DyFM_Region;
+(function (DyFM_Region) {
+    DyFM_Region["europe"] = "Europe";
+    DyFM_Region["asia"] = "Asia";
+    DyFM_Region["africa"] = "Africa";
+    DyFM_Region["oceania"] = "Oceania";
+    DyFM_Region["americas"] = "Americas";
+})(DyFM_Region || (DyFM_Region = {}));

package/build-esm/_modules/location/_enums/loc-sub-region.enum.js

@@ -0,0 +1,23 @@
+/**
+ * List of geographic subregions.
+ */
+export var DyFM_SubRegion;
+(function (DyFM_SubRegion) {
+    DyFM_SubRegion["northernEurope"] = "Northern Europe";
+    DyFM_SubRegion["southernEurope"] = "Southern Europe";
+    DyFM_SubRegion["westernEurope"] = "Western Europe";
+    DyFM_SubRegion["easternEurope"] = "Eastern Europe";
+    DyFM_SubRegion["northernAfrica"] = "Northern Africa";
+    DyFM_SubRegion["subSaharanAfrica"] = "Sub-Saharan Africa";
+    DyFM_SubRegion["northernAmerica"] = "Northern America";
+    DyFM_SubRegion["latinAmericaAndTheCaribbean"] = "Latin America and the Caribbean";
+    DyFM_SubRegion["southEasternAsia"] = "South-eastern Asia";
+    DyFM_SubRegion["easternAsia"] = "Eastern Asia";
+    DyFM_SubRegion["southernAsia"] = "Southern Asia";
+    DyFM_SubRegion["westernAsia"] = "Western Asia";
+    DyFM_SubRegion["centralAsia"] = "Central Asia";
+    DyFM_SubRegion["australiaAndNewZealand"] = "Australia and New Zealand";
+    DyFM_SubRegion["melanesia"] = "Melanesia";
+    DyFM_SubRegion["micronesia"] = "Micronesia";
+    DyFM_SubRegion["polynesia"] = "Polynesia";
+})(DyFM_SubRegion || (DyFM_SubRegion = {}));

package/build-esm/_modules/location/_enums/loc-subdivision-region-type.enum.js

@@ -0,0 +1,45 @@
+/**
+ * Types of administrative divisions.
+ */
+export var DyFM_SubdivisionRegionType;
+(function (DyFM_SubdivisionRegionType) {
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["parish"] = 0] = "parish";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["emirate"] = 1] = "emirate";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["province"] = 2] = "province";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["dependency"] = 3] = "dependency";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["county"] = 4] = "county";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["city"] = 5] = "city";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["region"] = 6] = "region";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["state"] = 7] = "state";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["territory"] = 8] = "territory";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["autonomousRepublic"] = 9] = "autonomousRepublic";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["municipate"] = 10] = "municipate";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["rayon"] = 11] = "rayon";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["division"] = 12] = "division";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["district"] = 13] = "district";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["governorate"] = 14] = "governorate";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["department"] = 15] = "department";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["specialMunicipality"] = 16] = "specialMunicipality";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["federalDistrict"] = 17] = "federalDistrict";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["island"] = 18] = "island";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["town"] = 19] = "town";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["oblast"] = 20] = "oblast";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["commune"] = 21] = "commune";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["prefecture"] = 22] = "prefecture";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["economicPrefecture"] = 23] = "economicPrefecture";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["canton"] = 24] = "canton";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["autonomousRegion"] = 25] = "autonomousRegion";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["specialAdministrativeRegion"] = 26] = "specialAdministrativeRegion";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["capitalDistrict"] = 27] = "capitalDistrict";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["geographicalRegion"] = 28] = "geographicalRegion";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["capitalCity"] = 29] = "capitalCity";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["ruralMunicipality"] = 30] = "ruralMunicipality";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["urbanMunicipality"] = 31] = "urbanMunicipality";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["autonomousCommunity"] = 32] = "autonomousCommunity";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["autonomousCity"] = 33] = "autonomousCity";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["administration"] = 34] = "administration";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["regionalState"] = 35] = "regionalState";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["metropolitanRegion"] = 36] = "metropolitanRegion";
+    DyFM_SubdivisionRegionType[DyFM_SubdivisionRegionType["overseasCollectivity"] = 37] = "overseasCollectivity";
+    // ... reduce specials // non-finished
+})(DyFM_SubdivisionRegionType || (DyFM_SubdivisionRegionType = {}));

package/build-esm/_modules/location/_models/loc-coordinates.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/_models/loc-country-division.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/_models/loc-country-iso.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/_models/loc-country-phone-code.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/_models/loc-division-collection.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/_models/loc-division-region-data.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/_models/loc-geo-ip-location.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/location/index.js

@@ -0,0 +1,17 @@
+// ENUMS
+export * from './_enums/loc-region.enum';
+export * from './_enums/loc-sub-region.enum';
+export * from './_enums/loc-subdivision-region-type.enum';
+// COLLECTIONS
+export * from './_collections/loc-country-divisions.const';
+export * from './_collections/loc-country-isos.const';
+export * from './_collections/loc.util';
+export * from './_collections/loc-regions.util';
+// INTERFACES
+export * from './_models/loc-country-division.interface';
+export * from './_models/loc-country-iso.interface';
+export * from './_models/loc-country-phone-code.interface';
+export * from './_models/loc-division-collection.interface';
+export * from './_models/loc-division-region-data.interface';
+export * from './_models/loc-geo-ip-location.interface';
+export * from './_models/loc-coordinates.interface';

package/build-esm/_modules/messaging/_collections/msg-module-settings.const.js

@@ -0,0 +1,44 @@
+/**
+ * Available messaging routes/endpoints
+ */
+export var DyFM_MsgRoute;
+(function (DyFM_MsgRoute) {
+    DyFM_MsgRoute["getConversations"] = "getConversations";
+    DyFM_MsgRoute["getConversation"] = "getConversation";
+    DyFM_MsgRoute["createConversation"] = "createConversation";
+    DyFM_MsgRoute["updateConversation"] = "updateConversation";
+    DyFM_MsgRoute["deleteConversation"] = "deleteConversation";
+    DyFM_MsgRoute["getMessages"] = "getMessages";
+    DyFM_MsgRoute["sendMessage"] = "sendMessage";
+    DyFM_MsgRoute["editMessage"] = "editMessage";
+    DyFM_MsgRoute["deleteMessage"] = "deleteMessage";
+    DyFM_MsgRoute["markAsRead"] = "markAsRead";
+    DyFM_MsgRoute["addReaction"] = "addReaction";
+    DyFM_MsgRoute["removeReaction"] = "removeReaction";
+    DyFM_MsgRoute["addParticipant"] = "addParticipant";
+    DyFM_MsgRoute["removeParticipant"] = "removeParticipant";
+    DyFM_MsgRoute["getAgentProcess"] = "getAgentProcess";
+})(DyFM_MsgRoute || (DyFM_MsgRoute = {}));
+/**
+ * Messaging module route settings
+ */
+export const DyFM_msgModule_settings = {
+    mainRoute: '/messaging',
+    endPoints: {
+        [DyFM_MsgRoute.getConversations]: '/conversations',
+        [DyFM_MsgRoute.getConversation]: '/conversations/:conversationId',
+        [DyFM_MsgRoute.createConversation]: '/conversations/create',
+        [DyFM_MsgRoute.updateConversation]: '/conversations/:conversationId',
+        [DyFM_MsgRoute.deleteConversation]: '/conversations/:conversationId',
+        [DyFM_MsgRoute.getMessages]: '/conversations/:conversationId/messages',
+        [DyFM_MsgRoute.sendMessage]: '/conversations/:conversationId/messages/send',
+        [DyFM_MsgRoute.editMessage]: '/messages/:messageId/edit',
+        [DyFM_MsgRoute.deleteMessage]: '/messages/:messageId',
+        [DyFM_MsgRoute.markAsRead]: '/messages/mark-read',
+        [DyFM_MsgRoute.addReaction]: '/messages/:messageId/reactions',
+        [DyFM_MsgRoute.removeReaction]: '/messages/:messageId/reactions/:emoji',
+        [DyFM_MsgRoute.addParticipant]: '/conversations/:conversationId/participants',
+        [DyFM_MsgRoute.removeParticipant]: '/conversations/:conversationId/participants/:userId',
+        [DyFM_MsgRoute.getAgentProcess]: '/messages/:messageId/agent-process',
+    },
+};

package/build-esm/_modules/messaging/_enums/msg-attachment-type.enum.js

@@ -0,0 +1,21 @@
+/**
+ * Message Attachment Type Enum
+ * Defines the type of file attachment
+ */
+export var DyFM_Msg_AttachmentType;
+(function (DyFM_Msg_AttachmentType) {
+    /** Image files (jpg, png, gif, webp, etc.) */
+    DyFM_Msg_AttachmentType["image"] = "image";
+    /** Video files (mp4, webm, avi, etc.) */
+    DyFM_Msg_AttachmentType["video"] = "video";
+    /** Audio files (mp3, wav, ogg, etc.) */
+    DyFM_Msg_AttachmentType["audio"] = "audio";
+    /** Document files (pdf, doc, docx, txt, etc.) */
+    DyFM_Msg_AttachmentType["document"] = "document";
+    /** Archive files (zip, rar, 7z, etc.) */
+    DyFM_Msg_AttachmentType["archive"] = "archive";
+    /** Code files (js, ts, py, etc.) */
+    DyFM_Msg_AttachmentType["code"] = "code";
+    /** Generic file attachment */
+    DyFM_Msg_AttachmentType["file"] = "file";
+})(DyFM_Msg_AttachmentType || (DyFM_Msg_AttachmentType = {}));

package/build-esm/_modules/messaging/_enums/msg-conversation-type.enum.js

@@ -0,0 +1,17 @@
+/**
+ * Conversation Type Enum
+ * Defines the type of conversation/chat
+ */
+export var DyFM_Msg_ConversationType;
+(function (DyFM_Msg_ConversationType) {
+    /** Direct 1-on-1 conversation between two users */
+    DyFM_Msg_ConversationType["direct"] = "direct";
+    /** Group conversation with multiple users */
+    DyFM_Msg_ConversationType["group"] = "group";
+    /** User conversing with AI Assistant (simple LLM chat) */
+    DyFM_Msg_ConversationType["assistantChat"] = "assistant-chat";
+    /** User conversing with AI Agent (with tool usage and reasoning) */
+    DyFM_Msg_ConversationType["agentProcess"] = "agent-process";
+    /** Channel-based conversation (Discord, Slack, Teams) */
+    DyFM_Msg_ConversationType["channel"] = "channel";
+})(DyFM_Msg_ConversationType || (DyFM_Msg_ConversationType = {}));

package/build-esm/_modules/messaging/_enums/msg-delivery-status.enum.js

@@ -0,0 +1,15 @@
+/**
+ * Delivery Status Enum
+ * Tracks delivery status per recipient
+ */
+export var DyFM_Msg_DeliveryStatus;
+(function (DyFM_Msg_DeliveryStatus) {
+    /** Pending delivery */
+    DyFM_Msg_DeliveryStatus["pending"] = "pending";
+    /** Delivered successfully */
+    DyFM_Msg_DeliveryStatus["delivered"] = "delivered";
+    /** Failed to deliver */
+    DyFM_Msg_DeliveryStatus["failed"] = "failed";
+    /** Recipient read the message */
+    DyFM_Msg_DeliveryStatus["read"] = "read";
+})(DyFM_Msg_DeliveryStatus || (DyFM_Msg_DeliveryStatus = {}));

package/build-esm/_modules/messaging/_enums/msg-event-key.enum.js

@@ -0,0 +1,28 @@
+/**
+ * Socket event keys for real-time messaging
+ * Following existing socket event pattern with camelCase = 'kebab-case'
+ */
+export var DyFM_Msg_EventKey;
+(function (DyFM_Msg_EventKey) {
+    // Message events
+    DyFM_Msg_EventKey["messageSent"] = "msg:message-sent";
+    DyFM_Msg_EventKey["messageUpdated"] = "msg:message-updated";
+    DyFM_Msg_EventKey["messageDeleted"] = "msg:message-deleted";
+    DyFM_Msg_EventKey["messageDelivered"] = "msg:message-delivered";
+    DyFM_Msg_EventKey["messageRead"] = "msg:message-read";
+    // Conversation events
+    DyFM_Msg_EventKey["conversationCreated"] = "msg:conversation-created";
+    DyFM_Msg_EventKey["conversationUpdated"] = "msg:conversation-updated";
+    DyFM_Msg_EventKey["conversationDeleted"] = "msg:conversation-deleted";
+    DyFM_Msg_EventKey["participantAdded"] = "msg:participant-added";
+    DyFM_Msg_EventKey["participantRemoved"] = "msg:participant-removed";
+    // Typing indicators
+    DyFM_Msg_EventKey["typingStart"] = "msg:typing-start";
+    DyFM_Msg_EventKey["typingStop"] = "msg:typing-stop";
+    // Reactions
+    DyFM_Msg_EventKey["reactionAdded"] = "msg:reaction-added";
+    DyFM_Msg_EventKey["reactionRemoved"] = "msg:reaction-removed";
+    // Agent process (for visualization)
+    DyFM_Msg_EventKey["agentStepAdded"] = "msg:agent-step-added";
+    DyFM_Msg_EventKey["agentProcessComplete"] = "msg:agent-process-complete";
+})(DyFM_Msg_EventKey || (DyFM_Msg_EventKey = {}));

package/build-esm/_modules/messaging/_enums/msg-participant-role.enum.js

@@ -0,0 +1,17 @@
+/**
+ * Participant Role Enum
+ * Defines the role of a participant in a conversation
+ */
+export var DyFM_Msg_ParticipantRole;
+(function (DyFM_Msg_ParticipantRole) {
+    /** Conversation owner/creator */
+    DyFM_Msg_ParticipantRole["owner"] = "owner";
+    /** Administrator with full permissions */
+    DyFM_Msg_ParticipantRole["admin"] = "admin";
+    /** Regular participant */
+    DyFM_Msg_ParticipantRole["member"] = "member";
+    /** AI Assistant participant */
+    DyFM_Msg_ParticipantRole["assistant"] = "assistant";
+    /** AI Agent participant */
+    DyFM_Msg_ParticipantRole["agent"] = "agent";
+})(DyFM_Msg_ParticipantRole || (DyFM_Msg_ParticipantRole = {}));

package/build-esm/_modules/messaging/_enums/msg-provider-type.enum.js

@@ -0,0 +1,8 @@
+export var DyFM_Msg_Provider_Type;
+(function (DyFM_Msg_Provider_Type) {
+    DyFM_Msg_Provider_Type["discord"] = "discord";
+    DyFM_Msg_Provider_Type["slack"] = "slack";
+    DyFM_Msg_Provider_Type["teams"] = "teams";
+    DyFM_Msg_Provider_Type["dynamo"] = "dynamo";
+    DyFM_Msg_Provider_Type["custom"] = "custom";
+})(DyFM_Msg_Provider_Type || (DyFM_Msg_Provider_Type = {}));

package/build-esm/_modules/messaging/_enums/msg-status.enum.js

@@ -0,0 +1,21 @@
+/**
+ * Message Status Enum
+ * Tracks the delivery and read status of messages
+ */
+export var DyFM_Msg_Status;
+(function (DyFM_Msg_Status) {
+    /** Message is being composed, not yet sent */
+    DyFM_Msg_Status["draft"] = "draft";
+    /** Message is in the process of being sent */
+    DyFM_Msg_Status["sending"] = "sending";
+    /** Message has been sent successfully */
+    DyFM_Msg_Status["sent"] = "sent";
+    /** Message has been delivered to recipient(s) */
+    DyFM_Msg_Status["delivered"] = "delivered";
+    /** Message has been read by recipient(s) */
+    DyFM_Msg_Status["read"] = "read";
+    /** Message failed to send */
+    DyFM_Msg_Status["failed"] = "failed";
+    /** Message has been deleted (soft delete) */
+    DyFM_Msg_Status["deleted"] = "deleted";
+})(DyFM_Msg_Status || (DyFM_Msg_Status = {}));

package/build-esm/_modules/messaging/_enums/msg-type.enum.js

@@ -0,0 +1,19 @@
+/**
+ * Message Type Enum
+ * Defines the type of message being sent/received
+ */
+export var DyFM_Msg_Type;
+(function (DyFM_Msg_Type) {
+    /** Regular text message between users */
+    DyFM_Msg_Type["text"] = "text";
+    /** Message from one user to another user */
+    DyFM_Msg_Type["userToUser"] = "user-to-user";
+    /** Message from user to AI assistant/agent */
+    DyFM_Msg_Type["userToAi"] = "user-to-ai";
+    /** Message from AI assistant/agent to user */
+    DyFM_Msg_Type["aiToUser"] = "ai-to-user";
+    /** System-generated message (notifications, status updates) */
+    DyFM_Msg_Type["system"] = "system";
+    /** Agent process message with reasoning/tool usage */
+    DyFM_Msg_Type["agentProcess"] = "agent-process";
+})(DyFM_Msg_Type || (DyFM_Msg_Type = {}));

package/build-esm/_modules/messaging/_models/msg-attachment.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/messaging/_models/msg-conversation.data-model.js

@@ -0,0 +1,80 @@
+import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
+import { DyFM_DataModel_Params } from '../../../_models/control-models/data-model-params.control-model';
+/**
+ * Conversation/chat container.
+ * Groups messages together for user-user, user-AI, or group chats.
+ */
+export class DyFM_Msg_Conversation_DataModel extends DyFM_Metadata {
+    title;
+    type;
+    // Participants
+    participants;
+    // Last Activity
+    lastMessageId;
+    lastMessageAt;
+    lastMessagePreview;
+    // Settings
+    isArchived;
+    isMuted;
+    isPinned;
+    // Platform Integration
+    platformSource;
+    platformChannelId;
+    platformChannelName;
+    // AI-Specific Settings
+    aiProvider;
+    aiModel;
+    systemPrompt;
+    // Metadata
+    messageCount;
+    unreadCount;
+    constructor(set) {
+        super(set);
+        if (set) {
+            Object.assign(this, set);
+        }
+    }
+}
+export const DyFM_msgConversation_dataParams = new DyFM_DataModel_Params({
+    dataName: 'msg_conversation',
+    properties: {
+        title: { key: 'title', type: 'string' },
+        type: { key: 'type', type: 'string',
+            required: true, index: true,
+        },
+        participants: {
+            key: 'participants', type: 'DyFM_Msg_Participant[]',
+            required: true,
+            subObjectParams: {
+                userId: { key: 'userId', type: 'string' },
+                role: { key: 'role', type: 'string' },
+                joinedAt: { key: 'joinedAt', type: 'Date' },
+            }
+        },
+        lastMessageId: { key: 'lastMessageId', type: 'string' },
+        lastMessageAt: { key: 'lastMessageAt', type: 'Date',
+            index: true,
+        },
+        lastMessagePreview: { key: 'lastMessagePreview', type: 'string' },
+        isArchived: { key: 'isArchived', type: 'boolean',
+        },
+        isMuted: { key: 'isMuted', type: 'boolean' },
+        isPinned: { key: 'isPinned', type: 'boolean',
+        },
+        platformSource: { key: 'platformSource', type: 'string',
+            index: true,
+        },
+        platformChannelId: { key: 'platformChannelId', type: 'string',
+            index: true,
+        },
+        platformChannelName: { key: 'platformChannelName', type: 'string' },
+        aiProvider: { key: 'aiProvider', type: 'string' },
+        aiModel: { key: 'aiModel', type: 'string' },
+        systemPrompt: { key: 'systemPrompt', type: 'string' },
+        messageCount: { key: 'messageCount', type: 'number' },
+        unreadCount: { key: 'unreadCount', type: 'number' },
+    },
+});
+Object.defineProperty(DyFM_Msg_Conversation_DataModel, 'name', { value: 'DyFM_Msg_Conversation' });
+/** @deprecated Use DyFM_Msg_Conversation_DataModel. Same constructor; no API removal. */
+export { DyFM_Msg_Conversation_DataModel as DyFM_Msg_Conversation };

package/build-esm/_modules/messaging/_models/msg-mention.interface.js

@@ -0,0 +1 @@
+export {};