@futdevpro/nts-dynamo 1.14.29 → 1.14.32

package/src/_modules/bot/_services/bot-messaging-provider.service-base.ts

@@ -0,0 +1,153 @@
+import { DyNTS_Bot_ChannelWrapper } from '../_models/bot-channel-wrapper.interface';
+import { DyNTS_Bot_LastMessageDate } from '../_models/bot-last-message-date.interface';
+import { DyNTS_Bot_LastMentionDate } from '../_models/bot-last-mention-date.interface';
+import { DyNTS_Bot_MessagingProvider_Type } from '../_enums/bot-message-provider.enum';
+import { DyNTS_Bot_Global_Settings } from '../_models/bot-global-settings.interface';
+import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+import { DyFM_AnyError, DyFM_Object } from '@futdevpro/fsm-dynamo';
+import { DyNTS_Bot_MessageWrapper } from '../_models/bot-message-wrapper.interface';
+import { DyNTS_Bot_UserWrapper } from '../_models/bot-user-wrapper.interface';
+
+//export interface DyNTS_Bot_MessagingProvider_Config<
+//  T_MessagingProviderConfig = any
+//> extends DyNTS_Bot_Global_Settings {
+//  /** Unique identifier for this provider instance (required when using multiple providers) */
+//  /* messagingProviderId?: string; */
+//  /* messagingProvider: DyNTS_Bot_MessagingProvider_Type | string; */
+//  /* messagingProviderInstance?: DyNTS_Bot_MessagingProvider; */
+//  config: T_MessagingProviderConfig; /* MessagingProvider_DiscordConfig | MessagingProvider_SlackConfig | MessagingProvider_TeamsConfig | MessagingProvider_DynamoConfig; */
+//}
+
+export interface DyNTS_Bot_MessagingProvider_Config {
+  reportChannelName: string;
+}
+
+export interface Slack_MessagingProviderConfig extends DyNTS_Bot_MessagingProvider_Config {
+  token: string;
+  workspace: string;
+}
+
+export interface Teams_MessagingProviderConfig extends DyNTS_Bot_MessagingProvider_Config {
+  appId: string;
+  appPassword: string;
+  tenantId: string;
+}
+
+export interface Dynamo_MessagingProviderConfig extends DyNTS_Bot_MessagingProvider_Config {
+  defaultConversationId?: string; // Optional default conversation
+  botUserId?: string; // Bot user ID in messaging system
+  botDisplayName?: string; // Bot display name
+}
+
+export abstract class DyNTS_Bot_MessagingProvider_ServiceBase<
+  T_MessagingPlatformChannel extends any = any,
+  T_MessagingPlatformMessage extends any = any,
+  T_MessagingPlatformUser extends any = any,
+  T_MessagingProviderConfig extends DyNTS_Bot_MessagingProvider_Config = DyNTS_Bot_MessagingProvider_Config,
+  T_MessagingPlatformRole extends any = any,
+> extends DyNTS_SingletonService {
+
+  abstract readonly name: string;
+  /** used as id as well */
+  abstract readonly type: DyNTS_Bot_MessagingProvider_Type | string;
+
+  abstract get botId(): string;
+  abstract get botDisplayName(): string;
+  /* abstract get providerId(): string; */
+  /* abstract isReady(): boolean; */
+
+  /* get id(): DyNTS_Bot_MessagingProvider_Type | string {
+    return this.type;
+  } */
+  
+  abstract readonly config: T_MessagingProviderConfig;
+
+  /* protected _channelsByNames: {
+    [key: string]: DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>;
+  } = {};
+  protected _rolesByNames: {
+    [key: string]: any[];
+  } = {}; */
+
+  protected readonly channelCache: Map<string, T_MessagingPlatformChannel> = new Map();
+  protected readonly roleCache: Map<string, T_MessagingPlatformRole> = new Map();
+
+  /* constructor(
+    setConfig?: T_MessagingProviderConfig
+  ) {
+    super();
+
+    if (setConfig) {
+      this.config = setConfig;
+    }
+  } */
+
+  // Initialization
+  //abstract preInitialize(): Promise<void>;
+  //abstract initialize(): Promise<void>;
+  abstract setup(issuer: string): Promise<void>;
+  abstract start(issuer: string): Promise<void>;
+  //abstract login(): Promise<void>;
+  //abstract getToken(): string;
+  
+  // Channel operations
+  abstract getChannelByName(name: string): Promise<DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>>;
+  abstract getChannelById(id: string): Promise<DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>>;
+  abstract sendMessageToChannelByName(channelName: string, message: string, issuer: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract getMessagesFromChannelByChannelName(channelName: string, limit?: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]>;
+  abstract getLastMessageInChannel(channelName: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract clearChannel(channelWrapper: DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>): Promise<void>;
+  
+  // Message operations
+  abstract sendMessage(channelWrapper: DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>, content: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract replyToMessage(messageWrapper: DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>, content: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract sendTyping(channelWrapper: DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>): Promise<void>;
+  abstract sendTypingForMessage(messageWrapper: DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>): Promise<void>;
+  abstract fetchMessages(channelWrapper: DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>, limit: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]>;
+  abstract fetchMessagesById(id: string, limit: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]>;
+  abstract fetchMessagesForMessage(messageWrapper: DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>, limit: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]>;
+  abstract fetchAllMessagesWithPaging(channelWrapper: DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>, maxFetch?: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]>;
+  abstract deleteMessage(messageWrapper: DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>): Promise<void>;
+  
+  // User operations
+  abstract getUserByName(username: string): Promise<DyNTS_Bot_UserWrapper<T_MessagingPlatformUser>>;
+  abstract getUserMention(userId: string): string;
+  abstract readMembersInChannel(channelName: string): Promise<DyNTS_Bot_UserWrapper<T_MessagingPlatformUser>[]>;
+  abstract readMemberNamesInChannel(channelName: string): Promise<string[]>;
+  
+  // Advanced message queries
+  abstract getLastMessageSentBy(channelName: string, username: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract getLastMentionOf(channelName: string, username: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract readLastMessageDatesByMembers(channelName: string, memberNames: string[]): Promise<DyNTS_Bot_LastMessageDate[]>;
+  abstract readLastMessageWithMemberNamePingInIt(channelName: string, users: DyNTS_Bot_UserWrapper<T_MessagingPlatformUser>[]): Promise<DyNTS_Bot_LastMentionDate[]>;
+  
+  // Platform-specific features (optional, may return null/undefined for unsupported platforms)
+  abstract getRoleByName?(roleName: string): any;
+  abstract getRolePingByName?(roleName: string): Promise<string>;
+  abstract getRolePingsByName?(roleNames: string[]): Promise<string>;
+  
+  // Event binding
+  //abstract onMessage(
+  //  message: T_MessagingPlatformMessage,
+  //  /* handler: (message: DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>, issuer: string, providerId?: string) => void */
+  //): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>; /* void; */
+  abstract create_onMessageEventListener(
+    handler: (message: DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>, issuer: string) => void
+  ): void;
+  //abstract create_onReadyEventListener(handler: () => void): void;
+  abstract create_onErrorEventListener(handler: (error: DyFM_AnyError) => void): void;
+
+  abstract sendReport(message: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+  abstract sendReportIn(message: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>>;
+
+  abstract wrapMessage(message: T_MessagingPlatformMessage): DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>;
+  abstract wrapChannel(channel: T_MessagingPlatformChannel): DyNTS_Bot_ChannelWrapper<T_MessagingPlatformChannel>;
+  abstract wrapUser(user: T_MessagingPlatformUser): DyNTS_Bot_UserWrapper<T_MessagingPlatformUser>;
+  
+  // Metadata
+  //abstract getBotId(): string;
+  //abstract getBotDisplayName(): string;
+  ////abstract getProviderName(): string;
+  //abstract getProviderId(): string;
+  //abstract isReady(): boolean;
+}

package/src/_modules/bot/_services/bot-routines.control-service.ts

@@ -5,42 +5,19 @@ import { DyFM_Async, DyFM_Error } from '@futdevpro/fsm-dynamo';
 import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
 import { DyNTS_Bot_Main_ControlService } from './bot-main.control-service';
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_Bot_Channel } from '../_models/bot-channel.interface';
-import { DyNTS_Bot_Message } from '../_models/bot-message.interface';
-import { DyNTS_Bot_User } from '../_models/bot-user.interface';
-import { DyNTS_Bot_MessagingProvider } from '../_models/bot-messaging-provider.interface';
+import { DyNTS_Bot_MessagingProvider_ServiceBase } from './bot-messaging-provider.service-base';
 
-export abstract class DyNTS_Bot_Routines_ControlService<
-  T_PlatformChannel extends DyNTS_Bot_Channel<any> = DyNTS_Bot_Channel<any>,
-  T_PlatformMessage extends DyNTS_Bot_Message<any> = DyNTS_Bot_Message<any>,
-  T_PlatformUser extends DyNTS_Bot_User<any> = DyNTS_Bot_User<any>,
-  T_PlatformProvider extends DyNTS_Bot_MessagingProvider<
-    T_PlatformChannel, 
-    T_PlatformMessage, 
-    T_PlatformUser
-  > = DyNTS_Bot_MessagingProvider<
-    T_PlatformChannel, 
-    T_PlatformMessage, 
-    T_PlatformUser
-  >
-> extends DyNTS_SingletonService {
+export abstract class DyNTS_Bot_Routines_ControlService extends DyNTS_SingletonService {
+  
+  protected mainBot_CS: DyNTS_Bot_Main_ControlService;
+  protected abstract getMainBotControlService(): DyNTS_Bot_Main_ControlService;
 
-  protected abstract getMainBotControlService(): DyNTS_Bot_Main_ControlService<
-    T_PlatformChannel, 
-    T_PlatformMessage, 
-    T_PlatformUser, 
-    T_PlatformProvider
-  >;
-
-  protected readonly mainBot_CS: DyNTS_Bot_Main_ControlService<
-    T_PlatformChannel, 
-    T_PlatformMessage, 
-    T_PlatformUser, 
-    T_PlatformProvider
-  > = this.getMainBotControlService();
-
-  get provider(): any {
+  /* get provider(): any {
     return this.mainBot_CS?.provider;
+  } */
+
+  get defaultProvider(): DyNTS_Bot_MessagingProvider_ServiceBase<any, any, any> {
+    return this.mainBot_CS.defaultProvider;
   }
 
   private _routinesStarted: boolean;
@@ -48,26 +25,44 @@ export abstract class DyNTS_Bot_Routines_ControlService<
     return this._routinesStarted;
   }
 
-  protected constructor() {
+  /* protected constructor() {
     super();
+  } */
 
-    if (!this.provider) {
+  async setup(issuer: string): Promise<void> {
+    try {
+      this.mainBot_CS = this.getMainBotControlService();
+
+      if (!this.mainBot_CS) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings('setup', new Error('Main Bot Control Service not found'), issuer),
+          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-S01`,
+        })
+      }
+    } catch (error) {
       throw new DyFM_Error({
-        ...this.getDefaultErrorSettings(
-          'constructor', 
-          new Error(
-            'Bot provider not yet initialized, ' +
-            'should only be called after DyNTS_Bot_Main_ControlService.start'
-          ), 
-          'system-init'
-        ),
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-C000`,
+        ...this.getDefaultErrorSettings('setup', error, issuer),
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-S000`,
       })
     }
   }
 
   async start(issuer: string): Promise<void> {
     try {
+      if (!this.defaultProvider) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'start', 
+            new Error(
+              'Bot routines not yet started, ' +
+              'should only be called after DyNTS_Bot_Main_ControlService.start'
+            ), 
+            'system-init'
+          ),
+          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-Bot-RCS-ST00`,
+        })
+      }
+
       await this.startRoutines(issuer);
 
       this._routinesStarted = true;

package/src/_modules/bot/index.ts

@@ -9,18 +9,20 @@
 export * from './_enums/bot-message-provider.enum';
 
 // MODELS
-export * from './_models/bot-message.interface';
+/* export * from './_models/bot-message.interface'; */
 export * from './_models/bot-message-wrapper.interface';
-export * from './_models/bot-channel.interface';
-export * from './_models/bot-user.interface';
-export * from './_models/bot-messaging-provider.interface';
+/* export * from './_models/bot-channel.interface'; */
+export * from './_models/bot-channel-wrapper.interface';
+/* export * from './_models/bot-user.interface'; */
+export * from './_models/bot-user-wrapper.interface';
+export * from './_services/bot-messaging-provider.service-base';
 export * from './_models/bot-command.interface';
 export * from './_models/bot-global-settings.interface';
 export * from './_models/bot-last-message-date.interface';
 export * from './_models/bot-last-mention-date.interface';
 
 // COLLECTIONS
-export * from './_collections/bot-operations.util';
+/* export * from './_collections/bot-operations.util'; */
 export * from './_collections/bot-global-settings.const';
 export * from './_collections/bot-default-commands.const';
 
@@ -29,10 +31,10 @@ export * from './_services/bot-main.control-service';
 export * from './_services/bot-io.control-service';
 export * from './_services/bot-commands.control-service';
 export * from './_services/bot-routines.control-service';
-export * from './_services/bot-messaging-provider-factory.service';
+/* export * from './_services/bot-messaging-provider-factory.service'; */
 
 // PROVIDERS
 export * from './_modules/discord-bot';
 export * from './_modules/slack-bot';
 export * from './_modules/teams-bot';
-export * from './_modules/dynamo-bot';
+/* export * from './_modules/dynamo-bot'; */

package/src/_modules/messaging/README.md

@@ -154,7 +154,7 @@ class DyNTS_Msg_Integration_ControlService extends DyNTS_SingletonService {
   static getInstance(): DyNTS_Msg_Integration_ControlService;
   
   // Bot integration
-  async syncBotMessage<T>(botMessage: DyNTS_Bot_Message<T>, conversationId: string, issuer: string): Promise<DyFM_Msg_Message>;
+  async syncBotMessage<T>(botMessage: DyNTS_Bot_MessageWrapper<T>, conversationId: string, issuer: string): Promise<DyFM_Msg_Message>;
   
   // Assistant integration
   async syncAssistantMessage(content: string, conversationId: string, aiProvider: string, aiModel: string, senderId: string, issuer: string): Promise<DyFM_Msg_Message>;
@@ -225,11 +225,6 @@ export const DyNTS_global_settings = {
     enableMentions: true,
     enableReadReceipts: true,
     enableTypingIndicators: true,
-    integration: {
-      syncBotMessages: true,
-      syncAssistantMessages: true,
-      enableAgentProcessViz: true
-    },
     retry: {
       maxRetries: 3,
       retryDelay: 1000
@@ -260,7 +255,7 @@ The messaging system integrates with the bot module to sync messages:
 
 ```typescript
 import { DyNTS_Msg_Integration_ControlService } from '@futdevpro/dynamo-nts/messaging';
-import { DyNTS_Bot_Message } from '@futdevpro/dynamo-nts/bot';
+import { DyNTS_Bot_MessageWrapper } from '@futdevpro/dynamo-nts/bot';
 
 const integrationService = DyNTS_Msg_Integration_ControlService.getInstance();
 

package/src/_modules/messaging/_collections/msg-global-settings.const.ts

@@ -14,12 +14,6 @@ export const DyNTS_Msg_global_settings: DyNTS_Msg_Global_Settings = {
   enableReadReceipts: true,
   enableTypingIndicators: true,
   
-  integration: {
-    syncBotMessages: true,
-    syncAssistantMessages: true,
-    enableAgentProcessViz: true,
-  },
-  
   retry: {
     maxRetries: 3,
     retryDelay: 1000, // 1 second

package/src/_modules/messaging/_collections/msg.util.ts

@@ -4,7 +4,7 @@ import {
   DyFM_Msg_Type,
   DyFM_Msg_Status,
 } from '@futdevpro/fsm-dynamo/messaging';
-import { DyNTS_Bot_Message } from '../../bot/_models/bot-message.interface';
+import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
 
 /**
  * Messaging utility functions
@@ -15,7 +15,7 @@ export class DyNTS_Msg_Util {
    * Convert bot message to messaging system message
    */
   static botMessageToMsgMessage<T>(
-    botMessage: DyNTS_Bot_Message<T>,
+    botMessage: DyNTS_Bot_MessageWrapper<T>,
     conversationId: string,
     issuer: string
   ): DyFM_Msg_Message {

package/src/_modules/messaging/_models/msg-global-settings.interface.ts

@@ -29,18 +29,6 @@ export interface DyNTS_Msg_Global_Settings {
   /** Enable typing indicators */
   enableTypingIndicators?: boolean;
   
-  /** Integration settings */
-  integration?: {
-    /** Auto-sync bot messages to messaging system */
-    syncBotMessages?: boolean;
-    
-    /** Auto-sync assistant messages to messaging system */
-    syncAssistantMessages?: boolean;
-    
-    /** Enable agent process visualization */
-    enableAgentProcessViz?: boolean;
-  };
-  
   /** Retry settings for failed messages */
   retry?: {
     maxRetries?: number;