401 add pagination helper

[sagarpatel211]

Summary of Changes

• This ticket addresses the implementation for an efficient pagination helper function.

Motivation and Explanation

• This feature improve the bot as it expands functionality, such as displaying long paragraphs of text in a paginated way

Related Issues

• Resolves Add Pagination Helper #401

Steps to Reproduce

• Run the discord bot and checkout to branch 401-add-pagination-helper
• Call .pg, .pagination, or .pgtest in your test channel to try out an example pagination I wrote

Demonstration of Changes

• A sample demo for using pagination is provided through src/commands/miscellaneous/pagination-test.ts and src/commandDetails/miscellaneous/pagination-test.ts, which can be removed.

Further Information and Comments

• Let me know if there's any changes I can make or improvements in my code style, documentation, etc.!

[probro27]

@sagarpatel211 Looks really good. My only issue with this is that the buttons tend to disappear after a while, leaving the embed stuck on a particular page.

Is there a way to fix this?

[hyperneutrino]

@probro27 if we want to avoid memory leaks we cannot keep the buttons around forever (except in cases where the page can be generated from the page number without needing to store the embeds in RAM, but that seems like a future enhancement). maybe to improve the intentionality we can disable the buttons before quitting the listener so it's more obvious that it was paginated and it was intentionally disabled, but that's an aesthetic decision

[probro27]

@sagarpatel211 Based on the comment by Alex, the only thing we need to add is a new function that overloads the existing one, except it takes the entire text or leaderboard data and divides it into pages itself.
We can keep the current function which is useful for specific page data.
Thanks!

[sagarpatel211]

New changes include:

• A default timeout of 300 seconds (5 min).
• A default max page count of 25.
• A default max newlines (ie. line height) of 10
• A default max character count per page of 2048.
• Navigator buttons disable for 3 seconds before disappearing for aesthetics.
• A new PaginationBuilderFromText function which allows for large multi-line strings as input, separating pages by newlines or reaching the max character count. I decided to have separate function names between the Embed list input one and text input one for clarity since it's an internal helper function. Pages using text as input have random-coloured embeds. Option to disable newlines page separation for better leaderboard support.

Let me know if there's more suggestions. If not, after removing the pagination-test command it can be merged.

[davidgan1218]

Only the user who invokes the pagination should be able to see the buttons to change pages. Right now, pressing the buttons as an "outside" user results in a "This interaction failed" message.