@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_modules/discord-bot/_collections/dibo-operations.util.ts

@@ -1,387 +0,0 @@
-import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-import { 
-  Client, Guild, GuildChannelManager, GuildBasedChannel, Message, TextBasedChannel, GuildMember, 
-  TextChannel,
-  VoiceChannel
-} from 'discord.js';
-import { Collection } from 'discord.js';
-import { DyNTS_DiBo_global_settings } from './dibo-global-settings.conts';
-import { DyNTS_DiBo_LastMessageDate } from '../_models/dibo-last-message-date.interface';
-import { DyNTS_DiBo_LastMentionDate } from '../_models/dibo-last-mention-date.inteface';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-
-export class DyNTS_DiBo_Operations_Util {
-
-  static findChannelByName(channels: GuildChannelManager, name: string): GuildBasedChannel {
-    const channel = channels.cache.find(
-      (ch) => ch.name === name && ch.isTextBased()
-    )
-
-    if (!channel) {
-      DyFM_Log.error(`No text channel found with name "${name}"`)
-      return
-    }
-
-    return channel
-  }
-
-  static findTextChannelByName(channels: GuildChannelManager, name: string): TextChannel {
-    const channel = this.findChannelByName(channels, name)
-    
-    if (!channel.isTextBased()) {
-      throw new Error(`Channel is not text based with name "${name}"`)
-    }
-
-    return channel as TextChannel
-  }
-
-  static findVoiceChannelByName(channels: GuildChannelManager, name: string): VoiceChannel {
-    const channel = this.findChannelByName(channels, name)
-    
-    if (!channel.isVoiceBased()) {
-      throw new Error(`Channel is not voice based with name "${name}"`)
-    }
-
-    return channel as VoiceChannel
-  }
-
-  static async reportIn(guild: Guild, client: Client): Promise<void> {
-    try {
-      const lastReportMessage = await this.getLastMessageInChannel(
-        guild,
-        DyNTS_DiBo_global_settings.channelSettings.reportChannelName
-      )
-      const reportMessage = `${client.user?.username} report for duty! ` +
-        `(v${DyNTS_global_settings.systemVersion} ${DyNTS_global_settings.env_settings?.environment})`;
-
-      if (lastReportMessage?.content === reportMessage) {
-        await this.deleteMessage(lastReportMessage).catch((error) => {
-          DyFM_Error.logSimple('Failed to delete message', error);
-        });
-      }
-
-      this.sendMessageToChannelByName(
-        guild, 
-        DyNTS_DiBo_global_settings.channelSettings.reportChannelName, 
-        reportMessage
-      )
-    } catch (error) {
-      DyFM_Error.logSimple('Failed to report in', error);
-    }
-  }
-
-  static sendMessageToChannelByName(guild: Guild, channelName: string, message: string) {
-    const channel = this.findChannelByName(guild.channels, channelName)
-
-    if (channel?.isTextBased()) {
-      channel.send(message)
-      DyFM_Log.success('Message sent to channel', channel.name)
-    } else {
-      DyFM_Log.error(`Channel is not text based "${channelName}"`)
-    }
-  }
-
-  static async readMembersInChannel(
-    guild: Guild, 
-    channelName: string
-  ): Promise<Collection<string, GuildMember>> {
-    const channel = this.findChannelByName(guild.channels, channelName)
-        
-    const members = await this.fetchMembersInGuild(guild)
-
-    const allowedMembers = members?.filter((member) =>
-      channel.permissionsFor(member)?.has('ViewChannel')
-    )
-
-    return allowedMembers
-  }
-
-  static async fetchMembersInGuild(guild: Guild): Promise<Collection<string, GuildMember>> {
-    try {
-      // Try to fetch with a limit to avoid timeout
-      return await guild?.members.fetch({ limit: 1000 })
-    } catch (fetchError) {
-      throw new DyFM_Error({
-        errorCode: 'DIB-OPS-FMI0',
-        message: 'Failed to fetch members',
-        error: fetchError,
-      })
-    }
-  }
-
-  static async readMemberNamesInChannel(guild: Guild, channelName: string): Promise<string[]> {
-    const members = await this.readMembersInChannel(guild, channelName)
-
-    const memberNames = members?.map((member) => member.user.username)
-
-    return memberNames
-  }
-
-  static async fetchAllMessagesWithPaging(
-    channel: TextBasedChannel,
-    maxFetch = 1000
-  ): Promise<Collection<string, Message<true>>> {
-    let lastId: string | undefined = undefined;
-    let fetched = 0;
-    const allMessages = new Collection<string, Message<true>>();
-
-    while (fetched < maxFetch) {
-      const options: any = { limit: 100 };
-      if (lastId) options.before = lastId;
-
-      const messages = await channel.messages.fetch(options) as unknown as Collection<string, Message<true>>;
-      if (messages.size === 0) break;
-
-      messages.forEach((msg: Message<true>) => {
-        allMessages.set(msg.id, msg);
-      });
-
-      lastId = messages.last()?.id;
-      fetched += messages.size;
-    }
-
-    DyFM_Log.success('Fetched messages with paging', allMessages.size);
-    return allMessages;
-  }
-
-  static async readLastMessageDatesByMembers(
-    guild: Guild, 
-    channelName: string,
-    memberNames: string[]
-  ): Promise<DyNTS_DiBo_LastMessageDate[]> {
-    const channel = this.findChannelByName(guild.channels, channelName)
-
-    if (!channel?.isTextBased()) {
-      DyFM_Log.error(`Channel is not text based "${channelName}"`)
-      return
-    }
-
-    // Prepare tracking for each member
-    const memberStatus: Record<string, { lastMessageDate: Date | null, allMessages: number }> = {};
-    memberNames.forEach(name => {
-      memberStatus[name] = { lastMessageDate: null, allMessages: 0 };
-    });
-
-    let lastId: string | undefined = undefined;
-    let done = false;
-    const cutoffTime = Date.now() - DyNTS_DiBo_global_settings.messageSettings.messageFetchTimeLimit;
-    let totalFetched = 0;
-
-    while (
-      !done && 
-      totalFetched < DyNTS_DiBo_global_settings.messageSettings.messageFetchCountLimit
-    ) {
-      const options: any = { limit: 100 };
-      if (lastId) options.before = lastId;
-      const messages = await channel.messages.fetch(options) as unknown as Collection<string, Message<true>>;
-      if (messages.size === 0) break;
-
-      let shouldStop = false;
-      messages.forEach((message) => {
-        // Check if message is too old
-        if (message.createdTimestamp < cutoffTime) {
-          shouldStop = true;
-
-          return;
-        }
-
-        const author = message.author.username;
-        if (memberStatus[author] !== undefined) {
-          memberStatus[author].allMessages++;
-
-          // Only set lastMessageDate if not already set (since we fetch newest first)
-          if (!memberStatus[author].lastMessageDate) {
-            memberStatus[author].lastMessageDate = message.createdAt;
-          }
-        }
-      });
-
-      if (shouldStop) {
-        DyFM_Log.warn('Reached time limit cutoff');
-        break;
-      }
-
-      // Check if all members have a lastMessageDate
-      done = memberNames.every(name => memberStatus[name].lastMessageDate !== null);
-      lastId = messages.last()?.id;
-      totalFetched += messages.size;
-    }
-
-    if (totalFetched >= DyNTS_DiBo_global_settings.messageSettings.messageFetchCountLimit) {
-      DyFM_Log.warn(
-        'Reached maximum fetch count limit', 
-        DyNTS_DiBo_global_settings.messageSettings.messageFetchCountLimit
-      );
-    }
-
-    const lastMessageDatesByMembers: DyNTS_DiBo_LastMessageDate[] = memberNames.map((memberName) => {
-      const status = memberStatus[memberName];
-      if (!status.lastMessageDate) {
-        DyFM_Log.warn('No last message date found for member', memberName);
-
-        return {
-          memberName: memberName,
-          allMessages: status.allMessages,
-          lastMessageDate: null/* new Date(0) */
-        }
-      }
-
-      return ({ 
-        memberName: memberName, 
-        allMessages: status.allMessages,
-        lastMessageDate: new Date(status.lastMessageDate)
-      })
-    });
-
-    return lastMessageDatesByMembers;
-  }
-
-  static async readLastMessageWithMemberNamePingInIt(
-    guild: Guild,
-    channelName: string,
-    members: Collection<string, GuildMember>
-  ): Promise<DyNTS_DiBo_LastMentionDate[]> {
-    const channel = this.findChannelByName(guild.channels, channelName)
-
-    if (!channel?.isTextBased()) {
-      DyFM_Log.error(`Channel is not text based "${channelName}"`)
-      return []
-    }
-
-    // Prepare tracking for each member
-    const memberStatus: Record<string, { lastMentionDate: Date | null, allMentions: number }> = {};
-    members.forEach(member => {
-      memberStatus[member.user.username] = { lastMentionDate: null, allMentions: 0 };
-    });
-
-    let lastId: string | undefined = undefined;
-    let done = false;
-    const cutoffTime = Date.now() - DyNTS_DiBo_global_settings.messageSettings.messageFetchTimeLimit;
-    let totalFetched = 0;
-
-    while (
-      !done && 
-      totalFetched < DyNTS_DiBo_global_settings.messageSettings.messageFetchCountLimit
-    ) {
-      const options: any = { limit: 100 };
-      if (lastId) options.before = lastId;
-      const messages = await channel.messages.fetch(options) as unknown as Collection<string, Message<true>>;
-      if (messages.size === 0) break;
-
-      let shouldStop = false;
-      messages.forEach((message) => {
-        // Check if message is too old
-        if (message.createdTimestamp < cutoffTime) {
-          shouldStop = true;
-          return;
-        }
-
-        // Check if message content contains "@Username" for any member
-        members.forEach(member => {
-          if (
-            message.content.includes(`@${member.user.id}`) && 
-            !memberStatus[member.user.username].lastMentionDate
-          ) {
-            memberStatus[member.user.username].lastMentionDate = message.createdAt;
-            memberStatus[member.user.username].allMentions++;
-            DyFM_Log.success(
-              'Found message with member ping', 
-              { 
-                memberName: member.user.username, 
-                messageId: message.id 
-              }
-            );
-          }
-        });
-      });
-
-      if (shouldStop) {
-        DyFM_Log.warn('Reached time limit cutoff while searching for member pings');
-        break;
-      }
-
-      // Check if all members have a lastMessageDate
-      done = members.every(member => memberStatus[member.user.username].lastMentionDate !== null);
-      lastId = messages.last()?.id;
-      totalFetched += messages.size;
-    }
-
-    if (totalFetched >= DyNTS_DiBo_global_settings.messageSettings.messageFetchCountLimit) {
-      DyFM_Log.warn(
-        'Reached maximum fetch count limit while searching for member pings', 
-        DyNTS_DiBo_global_settings.messageSettings.messageFetchCountLimit
-      );
-    }
-
-    const lastMentionDatesByMembers: DyNTS_DiBo_LastMentionDate[] = members.map((member) => {
-      const status = memberStatus[member.user.username];
-      if (!status.lastMentionDate) {
-        DyFM_Log.warn('No message found with member ping', member.user.username);
-        return {
-          memberId: member.user.id,
-          memberName: member.user.username,
-          allMentions: status.allMentions,
-          lastMentionDate: null/* new Date(0) */
-        }
-      }
-      return ({ 
-        memberId: member.user.id,
-        memberName: member.user.username, 
-        allMentions: status.allMentions,
-        lastMentionDate: new Date(status.lastMentionDate)
-      })
-    });
-
-    return lastMentionDatesByMembers;
-  }
-  static readMentionsInChannel = this.readLastMessageWithMemberNamePingInIt
-
-  static async readLastMessagesInChannel(
-    guild: Guild,
-    channelName: string,
-  ): Promise<Collection<string, Message<true>>> {
-    const channel = this.findChannelByName(guild.channels, channelName)
-
-    if (!channel?.isTextBased()) {
-      DyFM_Log.error(`Channel is not text based with name "${channelName}"`)
-      return
-    }
-
-    const messages = await channel.messages.fetch({ limit: 100 })
-
-    return messages
-  }
-  
-  static async getLastMessageInChannel(
-    guild: Guild,
-    channelName: string
-  ): Promise<Message<true>> {
-    const channel = this.findChannelByName(guild.channels, channelName)
-
-    if (!channel?.isTextBased()) {
-      DyFM_Log.error(`Channel is not text based with name "${channelName}"`)
-      return
-    }
-    
-    const messages = await channel.messages.fetch({ limit: 1 })
-
-    return messages.first()
-  }
-
-  static getMemberIdByName(
-    members: Collection<string, GuildMember>, 
-    username: string
-  ): string | undefined {
-    const member = members.find(m => m.user.username === username);
-    return member ? member.user.id : undefined;
-  }
-
-  static async deleteMessage(message: Message): Promise<void> {
-    await message.delete().catch((error) => {
-      DyFM_Error.logSimple('Failed to delete message', error);
-    });
-
-    DyFM_Log.success('Message deleted:', message.content);
-  }
-}

package/src/_modules/discord-bot/_models/dibo-command.interface.ts

@@ -1,12 +0,0 @@
-import { Message } from 'discord.js';
-
-
-
-
-export interface DyNTS_DiBo_Command {
-  command: string;
-  description: string;
-  commandHandler: (message: Message) => Promise<void>;
-  permissionNeeded?: (message: Message) => Promise<boolean>;
-}
-

package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts

@@ -1,98 +0,0 @@
-import { GatewayIntentBits, Partials } from 'discord.js';
-import { DyNTS_DiBo_Command } from './dibo-command.interface';
-
-export interface DyNTS_DiBo_Global_Settings {
-  /**
-   * this setting will set the debug level for the bot
-   * 
-   * 0 - no logs  
-   * 1 - errors sending to report channel  
-   * 2 - errors sending as response, will log events in console   
-   * 3 - errors sending as response, creating reports to report channel, debug events are in console (default)  
-   * 4 - errors and debug events are sending as response  
-   * 5 - all events are sending as response (that are set to send)  
-   * 6 - all debug logs are enabled  
-   *   
-   *   _
-   */
-  debugLevel: number;
-
-  /**
-   * this setting will set the intents for the bot
-   */
-  intents: GatewayIntentBits[];
-
-  /**
-   * this setting will set the partials for the bot
-   */
-  partials: Partials[];
-
-  allowedUsers: 'all' | string[];
-
-  messageSettings: {
-    /**
-     * this setting will set the time limit for message fetching
-     * so we will stop fetching messages sent later than this time
-     */
-    messageFetchTimeLimit: number;
-    /**
-     * this setting will set the count limit for message fetching
-     * so we will stop fetching messages after this count
-     */
-    messageFetchCountLimit: number;
-    /**
-     * this setting will set the delay for message sending,
-     * so we won't flood the channel too fast
-     */
-    messageSendDelay: number;
-
-    /**
-     * this setting will be used to skip answering to messages
-     * if the message contains any of these flags, the bot will not answer
-     * 
-     * @default [ '[BOT-SKIP]' ]
-     */
-    skipFlags: string[];
-  };
-
-  /**
-   * this setting will set the channel settings for the bot
-   */
-  channelSettings: {
-    /**
-     * this setting will set the name of the channel where the bot will send the reports
-     * 
-     * @default 'bot-report'
-     */
-    reportChannelName: string;
-
-    /**
-     * this setting will set the channels where the bot will answer automatically
-     * whenever a message is sent in one of these channels, that is not from the bot
-     * 
-     * it will be populated automatically from the default channels
-     */
-    allowedChannels: string[];
-    /**
-     * this setting will set if the bot can answer in Direct Messages Channels
-     * 
-     * @default false
-     */
-    dmIsAllowed: boolean;
-
-    /**
-     * this setting will set the default channels where the bot will answer automatically
-     * whenever a message is sent in one of these channels, that is not from the bot
-     * 
-     * @default [ 'bot-report' ]
-     */
-    defaultChannels: string[];
-  };
-
-  commandSettings: {
-    commandOperator: string;
-    commands: DyNTS_DiBo_Command[];
-  };
-
-  allowBotsInteractEachOther: boolean;
-}

package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts

@@ -1,8 +0,0 @@
-
-
-export interface DyNTS_DiBo_LastMentionDate {
-  memberId: string
-  memberName: string
-  allMentions: number
-  lastMentionDate: Date
-}

package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts

@@ -1,6 +0,0 @@
-
-export interface DyNTS_DiBo_LastMessageDate {
-  memberName: string
-  allMessages: number
-  lastMessageDate: Date
-}

package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts

@@ -1,154 +0,0 @@
-
-import { DyNTS_DiBo_Commands_ControlService } from './dibo-commands.control-service';
-import { DyNTS_DiBo_Main_ControlService } from './dibo-main.control-service';
-import { Message, Guild } from 'discord.js';
-import { DyFM_Error, DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_DiBo_global_settings } from '../_collections/dibo-global-settings.conts';
-
-class TestDiBoCommandsService extends DyNTS_DiBo_Commands_ControlService {
-  protected getMainDiscordBotControlService(): DyNTS_DiBo_Main_ControlService {
-    return this.diAs_CS;
-  }
-
-  static getInstance(): TestDiBoCommandsService {
-    return TestDiBoCommandsService.getSingletonInstance();
-  }
-}
-
-xdescribe('| DyNTS_DiBo_Commands_ControlService', () => {
-  let service: TestDiBoCommandsService;
-  let mockMain_CS: jasmine.SpyObj<DyNTS_DiBo_Main_ControlService>;
-  let mockGuild: jasmine.SpyObj<Guild>;
-  let mockMessage: jasmine.SpyObj<Message>;
-  let originalCommandSettings: typeof DyNTS_DiBo_global_settings.commandSettings;
-
-  beforeAll(() => {
-    if (!DyNTS_global_settings.systemShortCodeName) {
-      (DyNTS_global_settings as { systemShortCodeName?: string }).systemShortCodeName = 'TEST';
-    }
-    if (!DyNTS_global_settings.env_settings) {
-      (DyNTS_global_settings as { env_settings?: unknown }).env_settings = { environment: DyFM_EnvironmentFlag.local };
-    }
-    originalCommandSettings = { ...DyNTS_DiBo_global_settings.commandSettings };
-  });
-
-  afterEach(() => {
-    (DyNTS_DiBo_global_settings as { commandSettings: unknown }).commandSettings = originalCommandSettings;
-  });
-
-  beforeEach(() => {
-    mockGuild = jasmine.createSpyObj('Guild', [], {
-      id: 'guild-123',
-    });
-
-    mockMessage = jasmine.createSpyObj('Message', ['reply'], {
-      id: 'message-123',
-      content: '!test command',
-      author: {
-        id: 'user-123',
-      },
-    });
-
-    mockMain_CS = jasmine.createSpyObj('DyNTS_DiBo_Main_ControlService', [], {
-      discordServer: mockGuild,
-      client: {
-        user: {
-          id: 'bot-123',
-        },
-      },
-    });
-
-    service = new (TestDiBoCommandsService as any)();
-    (service as any).diAs_CS = mockMain_CS;
-  });
-
-  describe('| properties', () => {
-    it('| should return discordServer from main service', () => {
-      expect(service.discordServer).toBe(mockGuild);
-    });
-  });
-
-  describe('| setup', () => {
-    it('| should setup service with main service', async () => {
-      await service.setup('test-issuer');
-
-      expect((service as any).diAs_CS).toBe(mockMain_CS);
-    });
-
-    it('| should throw error if main service not found', async () => {
-      (service as any).getMainDiscordBotControlService = () => null;
-
-      try {
-        await service.setup('test-issuer');
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-CCS-S01');
-      }
-    });
-  });
-
-  describe('| start', () => {
-    it('| should start service successfully', async () => {
-      await service.start('test-issuer');
-
-      expect(service.discordServer).toBe(mockGuild);
-    });
-
-    it('| should throw error if discordServer not found', async () => {
-      (service as any).diAs_CS = null;
-
-      try {
-        await service.start('test-issuer');
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-CCS-ST00');
-      }
-    });
-  });
-
-  describe('| handleCommand', () => {
-    it('| should handle command successfully', async () => {
-      const commandHandlerSpy = jasmine.createSpy('commandHandler').and.returnValue(Promise.resolve());
-      (DyNTS_DiBo_global_settings as { commandSettings: { commandOperator: string; commands: unknown[] } }).commandSettings = {
-        commandOperator: '!',
-        commands: [
-          {
-            command: 'test',
-            commandHandler: commandHandlerSpy,
-          },
-        ],
-      };
-
-      await service.handleCommand(mockMessage, 'test-issuer');
-
-      expect(commandHandlerSpy).toHaveBeenCalled();
-      expect(mockMessage.reply).not.toHaveBeenCalled();
-    });
-
-    it('| should handle command errors', async () => {
-      const commandError = new Error('Command handler error');
-      (DyNTS_DiBo_global_settings as { commandSettings: { commandOperator: string; commands: unknown[] } }).commandSettings = {
-        commandOperator: '!',
-        commands: [
-          {
-            command: 'test',
-            commandHandler: jasmine.createSpy('commandHandler').and.returnValue(Promise.reject(commandError)),
-          },
-        ],
-      };
-      mockMessage.reply.and.returnValue(Promise.resolve(mockMessage as any));
-
-      try {
-        await service.handleCommand(mockMessage, 'test-issuer');
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect(mockMessage.reply).toHaveBeenCalled();
-      }
-    });
-  });
-});
-