@futdevpro/fsm-dynamo 1.20.9 → 1.20.12

package/src/_modules/messaging/_enums/msg-event-key.enum.ts

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

package/src/_modules/messaging/_enums/msg-participant-role.enum.ts

@@ -1,20 +0,0 @@
-/**
- * Participant Role Enum
- * Defines the role of a participant in a conversation
- */
-export enum DyFM_Msg_ParticipantRole {
-  /** Conversation owner/creator */
-  owner = 'owner',
-  
-  /** Administrator with full permissions */
-  admin = 'admin',
-  
-  /** Regular participant */
-  member = 'member',
-  
-  /** AI Assistant participant */
-  assistant = 'assistant',
-  
-  /** AI Agent participant */
-  agent = 'agent',
-}

package/src/_modules/messaging/_enums/msg-provider-type.enum.ts

@@ -1,7 +0,0 @@
-export enum DyFM_Msg_Provider_Type {
-  discord = 'discord',
-  slack = 'slack',
-  teams = 'teams',
-  dynamo = 'dynamo',
-  custom = 'custom'
-}

package/src/_modules/messaging/_enums/msg-status.enum.ts

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

package/src/_modules/messaging/_enums/msg-type.enum.ts

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

package/src/_modules/messaging/_models/msg-attachment.interface.ts

@@ -1,46 +0,0 @@
-import { DyFM_Msg_AttachmentType } from '../_enums/msg-attachment-type.enum';
-
-/**
- * Message Attachment Interface
- * Represents files, images, or other media attached to a message
- */
-export interface DyFM_Msg_Attachment {
-  /** Unique attachment ID */
-  id: string;
-  
-  /** Attachment type */
-  type: DyFM_Msg_AttachmentType;
-  
-  /** File name */
-  filename: string;
-  
-  /** MIME type */
-  mimeType: string;
-  
-  /** File size in bytes */
-  size: number;
-  
-  /** URL to access the file */
-  url: string;
-  
-  /** Thumbnail URL (for images/videos) */
-  thumbnailUrl?: string;
-  
-  /** Width (for images/videos) */
-  width?: number;
-  
-  /** Height (for images/videos) */
-  height?: number;
-  
-  /** Duration in seconds (for audio/video) */
-  duration?: number;
-  
-  /** Alt text for accessibility */
-  altText?: string;
-  
-  /** Upload timestamp */
-  uploadedAt: Date;
-  
-  /** Uploader user ID */
-  uploadedBy: string;
-}

package/src/_modules/messaging/_models/msg-conversation.data-model.spec.ts

@@ -1,69 +0,0 @@
-import { DyFM_Msg_Conversation } from './msg-conversation.data-model';
-import { DyFM_Msg_ConversationType } from '../_enums/msg-conversation-type.enum';
-import { DyFM_Msg_Participant } from './msg-participant.interface';
-import { DyFM_Msg_ParticipantRole } from '../_enums/msg-participant-role.enum';
-
-describe('| DyFM_Msg_Conversation', (): void => {
-  it('| should create an instance without initial data', (): void => {
-    const conversation = new DyFM_Msg_Conversation();
-
-    expect(conversation).toBeTruthy();
-    expect(conversation.__created).toBeInstanceOf(Date);
-    expect(conversation.__lastModified).toBeInstanceOf(Date);
-  });
-
-  it('| should create an instance with initial data', (): void => {
-    const participants: DyFM_Msg_Participant[] = [
-      { userId: 'user1', role: DyFM_Msg_ParticipantRole.owner, joinedAt: new Date() },
-      { userId: 'user2', role: DyFM_Msg_ParticipantRole.member, joinedAt: new Date() },
-    ];
-
-    const initialData: DyFM_Msg_Conversation = {
-      title: 'Test Conversation',
-      type: DyFM_Msg_ConversationType.direct,
-      participants: participants,
-      lastMessageId: 'msg1',
-      lastMessageAt: new Date('2023-01-01'),
-      lastMessagePreview: 'Hello world',
-      isArchived: false,
-      isMuted: false,
-      isPinned: true,
-      platformSource: 'test',
-      platformChannelId: 'channel1',
-      platformChannelName: 'Test Channel',
-      aiProvider: 'openai',
-      aiModel: 'gpt-4',
-      systemPrompt: 'You are a helpful assistant',
-      messageCount: 10,
-      unreadCount: 2,
-    };
-
-    const conversation = new DyFM_Msg_Conversation(initialData);
-
-    expect(conversation.title).toBe('Test Conversation');
-    expect(conversation.type).toBe(DyFM_Msg_ConversationType.direct);
-    expect(conversation.participants).toEqual(participants);
-    expect(conversation.lastMessageId).toBe('msg1');
-    expect(conversation.lastMessageAt).toEqual(new Date('2023-01-01'));
-    expect(conversation.lastMessagePreview).toBe('Hello world');
-    expect(conversation.isArchived).toBe(false);
-    expect(conversation.isMuted).toBe(false);
-    expect(conversation.isPinned).toBe(true);
-    expect(conversation.platformSource).toBe('test');
-    expect(conversation.platformChannelId).toBe('channel1');
-    expect(conversation.platformChannelName).toBe('Test Channel');
-    expect(conversation.aiProvider).toBe('openai');
-    expect(conversation.aiModel).toBe('gpt-4');
-    expect(conversation.systemPrompt).toBe('You are a helpful assistant');
-    expect(conversation.messageCount).toBe(10);
-    expect(conversation.unreadCount).toBe(2);
-  });
-
-  it('| should have dataParams defined', (): void => {
-    const { DyFM_msgConversation_dataParams } = require('./msg-conversation.data-model');
-
-    expect(DyFM_msgConversation_dataParams).toBeTruthy();
-    expect(DyFM_msgConversation_dataParams.dataName).toBe('msg_conversation');
-  });
-});
-

package/src/_modules/messaging/_models/msg-conversation.data-model.ts

@@ -1,96 +0,0 @@
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-import { DyFM_DataModel_Params } from '../../../_models/control-models/data-model-params.control-model';
-import { DyFM_Msg_ConversationType } from '../_enums/msg-conversation-type.enum';
-import { DyFM_Msg_Participant } from './msg-participant.interface';
-
-/**
- * Conversation/chat container.
- * Groups messages together for user-user, user-AI, or group chats.
- */
-export class DyFM_Msg_Conversation extends DyFM_Metadata {
-  title?: string;
-  type: DyFM_Msg_ConversationType;
-  
-  // Participants
-  participants: DyFM_Msg_Participant[];
-  
-  // Last Activity
-  lastMessageId?: string;
-  lastMessageAt?: Date;
-  lastMessagePreview?: string;
-  
-  // Settings
-  isArchived?: boolean;
-  isMuted?: boolean;
-  isPinned?: boolean;
-  
-  // Platform Integration
-  platformSource?: string;
-  platformChannelId?: string;
-  platformChannelName?: string;
-  
-  // AI-Specific Settings
-  aiProvider?: string;
-  aiModel?: string;
-  systemPrompt?: string;
-  
-  // Metadata
-  messageCount?: number;
-  unreadCount?: number;
-  
-  constructor(set?: DyFM_Msg_Conversation) {
-    super(set);
-    
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const DyFM_msgConversation_dataParams: DyFM_DataModel_Params<DyFM_Msg_Conversation> = 
-  new DyFM_DataModel_Params<DyFM_Msg_Conversation>({
-    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' },
-    },
-  });

package/src/_modules/messaging/_models/msg-mention.interface.ts

@@ -1,29 +0,0 @@
-/**
- * Message Mention Interface
- * Represents a user mention (@username) in a message
- */
-export interface DyFM_Msg_Mention {
-  /** ID of the mentioned user */
-  userId: string;
-  
-  /** Display name at time of mention */
-  displayName?: string;
-  
-  /** Username at time of mention */
-  username?: string;
-  
-  /** Position in message content where mention occurs */
-  startIndex?: number;
-  
-  /** Length of mention text */
-  length?: number;
-  
-  /** When the mention was created */
-  timestamp: Date;
-  
-  /** Whether the mentioned user has been notified */
-  notified?: boolean;
-  
-  /** Whether the mention has been read */
-  read?: boolean;
-}

package/src/_modules/messaging/_models/msg-message.data-model.spec.ts

@@ -1,79 +0,0 @@
-import { DyFM_Msg_Message } from './msg-message.data-model';
-import { DyFM_Msg_Type } from '../_enums/msg-type.enum';
-import { DyFM_Msg_Status } from '../_enums/msg-status.enum';
-
-describe('| DyFM_Msg_Message', (): void => {
-  it('| should create an instance without initial data', (): void => {
-    const message = new DyFM_Msg_Message();
-
-    expect(message).toBeTruthy();
-    expect(message.__created).toBeInstanceOf(Date);
-    expect(message.__lastModified).toBeInstanceOf(Date);
-  });
-
-  it('| should create an instance with initial data', (): void => {
-    const initialData: DyFM_Msg_Message = {
-      conversationId: 'conv1',
-      content: 'Hello world',
-      type: DyFM_Msg_Type.text,
-      status: DyFM_Msg_Status.sent,
-      senderId: 'user1',
-      senderName: 'John Doe',
-      senderDisplayName: 'John',
-      recipientIds: ['user2'],
-      parentMessageId: 'parent1',
-      threadId: 'thread1',
-      attachments: [],
-      mentions: [],
-      reactions: [],
-      aiProvider: 'openai',
-      aiModel: 'gpt-4',
-      isAIGenerated: false,
-      systemPrompt: 'You are helpful',
-      agentProcessSteps: [],
-      platformSource: 'test',
-      platformMessageId: 'platform1',
-      platformChannelId: 'channel1',
-      sentAt: new Date('2023-01-01'),
-      deliveredAt: new Date('2023-01-01'),
-      readAt: new Date('2023-01-01'),
-      editedAt: new Date('2023-01-01'),
-    };
-
-    const message = new DyFM_Msg_Message(initialData);
-
-    expect(message.conversationId).toBe('conv1');
-    expect(message.content).toBe('Hello world');
-    expect(message.type).toBe(DyFM_Msg_Type.text);
-    expect(message.status).toBe(DyFM_Msg_Status.sent);
-    expect(message.senderId).toBe('user1');
-    expect(message.senderName).toBe('John Doe');
-    expect(message.senderDisplayName).toBe('John');
-    expect(message.recipientIds).toEqual(['user2']);
-    expect(message.parentMessageId).toBe('parent1');
-    expect(message.threadId).toBe('thread1');
-    expect(message.attachments).toEqual([]);
-    expect(message.mentions).toEqual([]);
-    expect(message.reactions).toEqual([]);
-    expect(message.aiProvider).toBe('openai');
-    expect(message.aiModel).toBe('gpt-4');
-    expect(message.isAIGenerated).toBe(false);
-    expect(message.systemPrompt).toBe('You are helpful');
-    expect(message.agentProcessSteps).toEqual([]);
-    expect(message.platformSource).toBe('test');
-    expect(message.platformMessageId).toBe('platform1');
-    expect(message.platformChannelId).toBe('channel1');
-    expect(message.sentAt).toEqual(new Date('2023-01-01'));
-    expect(message.deliveredAt).toEqual(new Date('2023-01-01'));
-    expect(message.readAt).toEqual(new Date('2023-01-01'));
-    expect(message.editedAt).toEqual(new Date('2023-01-01'));
-  });
-
-  it('| should have dataParams defined', (): void => {
-    const { DyFM_msgMessage_dataParams } = require('./msg-message.data-model');
-
-    expect(DyFM_msgMessage_dataParams).toBeTruthy();
-    expect(DyFM_msgMessage_dataParams.dataName).toBe('msg_message');
-  });
-});
-

package/src/_modules/messaging/_models/msg-message.data-model.ts

@@ -1,127 +0,0 @@
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-import { DyFM_DataModel_Params } from '../../../_models/control-models/data-model-params.control-model';
-import { DyFM_Msg_Type } from '../_enums/msg-type.enum';
-import { DyFM_Msg_Status } from '../_enums/msg-status.enum';
-import { DyFM_Msg_Attachment } from './msg-attachment.interface';
-import { DyFM_Msg_Mention } from './msg-mention.interface';
-import { DyFM_Msg_Reaction } from './msg-reaction.interface';
-import { DyFM_Msg_ThreadInfo } from './msg-thread-info.interface';
-import { DyFM_Agt_ProcessStep } from '../_modules/agent/_models/agt-process-step.interface';
-
-/**
- * Core message model for unified messaging system.
- * Supports user↔user, user↔AI, and agent process communications.
- */
-export class DyFM_Msg_Message extends DyFM_Metadata {
-  conversationId: string;
-  
-  // Content
-  content: string;
-  type: DyFM_Msg_Type;
-  status: DyFM_Msg_Status;
-  
-  // Sender/Recipient
-  senderId: string;
-  senderName?: string;
-  senderDisplayName?: string;
-  recipientIds?: string[];
-  
-  // Threading
-  parentMessageId?: string;
-  threadId?: string;
-  threadInfo?: DyFM_Msg_ThreadInfo;
-  
-  // Rich Content
-  attachments?: DyFM_Msg_Attachment[];
-  mentions?: DyFM_Msg_Mention[];
-  reactions?: DyFM_Msg_Reaction[];
-  
-  // AI-Specific Fields
-  aiProvider?: string;
-  aiModel?: string;
-  isAIGenerated?: boolean;
-  systemPrompt?: string;
-  
-  // Agent Process Fields
-  agentProcessSteps?: DyFM_Agt_ProcessStep[];
-  
-  // Platform Integration
-  platformSource?: string;
-  platformMessageId?: string;
-  platformChannelId?: string;
-  
-  // Timestamps
-  sentAt?: Date;
-  deliveredAt?: Date;
-  readAt?: Date;
-  editedAt?: Date;
-  
-  constructor(set?: DyFM_Msg_Message) {
-    super(set);
-    
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const DyFM_msgMessage_dataParams: DyFM_DataModel_Params<DyFM_Msg_Message> = 
-  new DyFM_DataModel_Params<DyFM_Msg_Message>({
-    dataName: 'msg_message',
-    properties: {
-      conversationId: { key: 'conversationId', type: 'string', 
-        required: true, index: true,
-      },
-      
-      content: { key: 'content', type: 'string', 
-        required: true,
-      },
-      type: { key: 'type', type: 'string', 
-        required: true,
-      },
-      status: { key: 'status', type: 'string', 
-        required: true, index: true,
-      },
-      
-      senderId: { key: 'senderId', type: 'string', 
-        required: true, index: true,
-      },
-      senderName: { key: 'senderName', type: 'string' },
-      senderDisplayName: { key: 'senderDisplayName', type: 'string' },
-      recipientIds: { key: 'recipientIds', type: 'string[]' },
-      
-      parentMessageId: { key: 'parentMessageId', type: 'string', 
-        index: true,
-      },
-      threadId: { key: 'threadId', type: 'string', 
-        index: true,
-      },
-      threadInfo: { key: 'threadInfo', type: 'object' },
-      
-      attachments: { key: 'attachments', type: 'object[]' },
-      mentions: { key: 'mentions', type: 'object[]' },
-      reactions: { key: 'reactions', type: 'object[]' },
-      
-      aiProvider: { key: 'aiProvider', type: 'string' },
-      aiModel: { key: 'aiModel', type: 'string' },
-      isAIGenerated: { key: 'isAIGenerated', type: 'boolean' },
-      systemPrompt: { key: 'systemPrompt', type: 'string' },
-      
-      agentProcessSteps: { key: 'agentProcessSteps', type: 'object[]' },
-      
-      platformSource: { key: 'platformSource', type: 'string' },
-      platformMessageId: { key: 'platformMessageId', type: 'string', 
-        index: true,
-      },
-      platformChannelId: { key: 'platformChannelId', type: 'string', 
-        index: true,
-      },
-      
-      sentAt: { key: 'sentAt', type: 'Date', 
-        index: true,
-      },
-      deliveredAt: { key: 'deliveredAt', type: 'Date' },
-      readAt: { key: 'readAt', type: 'Date' },
-      editedAt: { key: 'editedAt', type: 'Date' },
-    },
-  });

package/src/_modules/messaging/_models/msg-participant.interface.ts

@@ -1,46 +0,0 @@
-import { DyFM_Msg_ParticipantRole } from '../_enums/msg-participant-role.enum';
-
-/**
- * Message Participant Interface
- * Represents a participant in a conversation
- */
-export interface DyFM_Msg_Participant {
-  /** User/bot/AI ID */
-  userId: string;
-  
-  /** Display name */
-  displayName?: string;
-  
-  /** Username */
-  username?: string;
-  
-  /** Role in the conversation */
-  role: DyFM_Msg_ParticipantRole;
-  
-  /** When the participant joined */
-  joinedAt: Date;
-  
-  /** Last time the participant was active */
-  lastActiveAt?: Date;
-  
-  /** Last message ID read by this participant */
-  lastReadMessageId?: string;
-  
-  /** Timestamp of last read */
-  lastReadAt?: Date;
-  
-  /** Whether participant has muted this conversation */
-  isMuted?: boolean;
-  
-  /** Custom notification settings */
-  notificationSettings?: {
-    muteUntil?: Date;
-    onlyMentions?: boolean;
-  };
-  
-  /** Platform-specific participant ID (Discord, Slack, etc.) */
-  platformUserId?: string;
-  
-  /** Is this participant currently typing? (real-time state) */
-  isTyping?: boolean;
-}

package/src/_modules/messaging/_models/msg-reaction.interface.ts

@@ -1,20 +0,0 @@
-/**
- * Message Reaction Interface
- * Represents an individual emoji reaction to a message
- */
-export interface DyFM_Msg_Reaction {
-  /** Emoji or reaction identifier */
-  emoji: string;
-  
-  /** User ID who reacted */
-  userId: string;
-  
-  /** Timestamp when user reacted */
-  reactedAt: Date;
-  
-  /** Unicode representation of emoji */
-  unicode?: string;
-  
-  /** Custom emoji ID (if custom emoji) */
-  customEmojiId?: string;
-}

package/src/_modules/messaging/_models/msg-thread-info.interface.ts

@@ -1,35 +0,0 @@
-/**
- * Message Thread Info Interface
- * Represents metadata about a message thread
- */
-export interface DyFM_Msg_ThreadInfo {
-  /** Unique thread ID */
-  threadId: string;
-  
-  /** ID of the parent message that started the thread */
-  parentMessageId: string;
-  
-  /** Thread title (optional) */
-  title?: string;
-  
-  /** Number of messages in the thread */
-  messageCount: number;
-  
-  /** IDs of participants in the thread */
-  participantIds: string[];
-  
-  /** Last message in the thread */
-  lastMessageId?: string;
-  
-  /** Timestamp of last message */
-  lastMessageAt?: Date;
-  
-  /** Preview of last message */
-  lastMessagePreview?: string;
-  
-  /** Whether thread is locked (no new messages) */
-  isLocked?: boolean;
-  
-  /** Whether thread is resolved (for support threads) */
-  isResolved?: boolean;
-}