@erinjs/core 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/core/.changeset/README.md +8 -0
- package/core/.changeset/community-bootstrap-release.md +17 -0
- package/core/.changeset/config.json +11 -0
- package/core/.changeset/no-changelog.js +16 -0
- package/core/.changeset/pre.json +17 -0
- package/core/.editorconfig +13 -0
- package/core/.gitattributes +2 -0
- package/core/.github/CODE_OF_CONDUCT.md +23 -0
- package/core/.github/FUNDING.yml +7 -0
- package/core/.github/ISSUE_TEMPLATE/bug_report.md +31 -0
- package/core/.github/ISSUE_TEMPLATE/feature_request.md +23 -0
- package/core/.github/PULL_REQUEST_TEMPLATE.md +16 -0
- package/core/.github/dependabot.yml +16 -0
- package/core/.github/workflows/autoapp.yml +16 -0
- package/core/.github/workflows/ci.yml +187 -0
- package/core/.github/workflows/codeql.yml +30 -0
- package/core/.github/workflows/deploy-docs.yml +54 -0
- package/core/.github/workflows/publish.yml +43 -0
- package/core/.lintstagedrc.json +4 -0
- package/core/.nvmrc +1 -0
- package/core/.prettierignore +8 -0
- package/core/.prettierrc +11 -0
- package/core/CONTRIBUTING.md +70 -0
- package/core/LICENSE +203 -0
- package/core/README.md +61 -0
- package/core/SECURITY.md +21 -0
- package/core/apps/docs/index.html +28 -0
- package/core/apps/docs/middleware.ts +21 -0
- package/core/apps/docs/package.json +33 -0
- package/core/apps/docs/public/@flux.png +0 -0
- package/core/apps/docs/public/docs/latest/guides.json +1420 -0
- package/core/apps/docs/public/docs/latest/main.json +14981 -0
- package/core/apps/docs/public/docs/latest/rag-index.json +1 -0
- package/core/apps/docs/public/docs/v1.0.5/guides.json +226 -0
- package/core/apps/docs/public/docs/v1.0.5/main.json +7920 -0
- package/core/apps/docs/public/docs/v1.0.6/guides.json +226 -0
- package/core/apps/docs/public/docs/v1.0.6/main.json +7920 -0
- package/core/apps/docs/public/docs/v1.0.7/guides.json +259 -0
- package/core/apps/docs/public/docs/v1.0.7/main.json +8652 -0
- package/core/apps/docs/public/docs/v1.0.8/guides.json +313 -0
- package/core/apps/docs/public/docs/v1.0.8/main.json +9618 -0
- package/core/apps/docs/public/docs/v1.0.9/guides.json +319 -0
- package/core/apps/docs/public/docs/v1.0.9/main.json +10694 -0
- package/core/apps/docs/public/docs/v1.1.0/guides.json +589 -0
- package/core/apps/docs/public/docs/v1.1.0/main.json +12576 -0
- package/core/apps/docs/public/docs/v1.1.2/guides.json +650 -0
- package/core/apps/docs/public/docs/v1.1.2/main.json +13239 -0
- package/core/apps/docs/public/docs/v1.1.3/guides.json +650 -0
- package/core/apps/docs/public/docs/v1.1.3/main.json +13239 -0
- package/core/apps/docs/public/docs/v1.1.4/guides.json +708 -0
- package/core/apps/docs/public/docs/v1.1.4/main.json +13231 -0
- package/core/apps/docs/public/docs/v1.1.5/guides.json +1035 -0
- package/core/apps/docs/public/docs/v1.1.5/main.json +13838 -0
- package/core/apps/docs/public/docs/v1.1.6/guides.json +1041 -0
- package/core/apps/docs/public/docs/v1.1.6/main.json +14313 -0
- package/core/apps/docs/public/docs/v1.1.8/guides.json +1047 -0
- package/core/apps/docs/public/docs/v1.1.8/main.json +14421 -0
- package/core/apps/docs/public/docs/v1.1.9/guides.json +1047 -0
- package/core/apps/docs/public/docs/v1.1.9/main.json +14421 -0
- package/core/apps/docs/public/docs/v1.2.0/guides.json +1212 -0
- package/core/apps/docs/public/docs/v1.2.0/main.json +14663 -0
- package/core/apps/docs/public/docs/v1.2.1/guides.json +1293 -0
- package/core/apps/docs/public/docs/v1.2.1/main.json +14828 -0
- package/core/apps/docs/public/docs/v1.2.2/guides.json +1293 -0
- package/core/apps/docs/public/docs/v1.2.2/main.json +15025 -0
- package/core/apps/docs/public/docs/v1.2.3/guides.json +1420 -0
- package/core/apps/docs/public/docs/v1.2.3/main.json +14954 -0
- package/core/apps/docs/public/docs/v1.2.4/guides.json +1420 -0
- package/core/apps/docs/public/docs/v1.2.4/main.json +14981 -0
- package/core/apps/docs/public/docs/versions.json +24 -0
- package/core/apps/docs/public/flux.png +0 -0
- package/core/apps/docs/public/locales/en.json +50 -0
- package/core/apps/docs/public/locales/guides-en.json +512 -0
- package/core/apps/docs/public/robots.txt +4 -0
- package/core/apps/docs/public/sitemap.xml +33 -0
- package/core/apps/docs/src/App.vue +538 -0
- package/core/apps/docs/src/components/ApiCategorySection.vue +42 -0
- package/core/apps/docs/src/components/ApiDiscordCompat.vue +65 -0
- package/core/apps/docs/src/components/ApiEndpointCard.vue +313 -0
- package/core/apps/docs/src/components/ApiSchemaBlock.vue +131 -0
- package/core/apps/docs/src/components/CodeBlock.vue +177 -0
- package/core/apps/docs/src/components/CommunityCallout.vue +90 -0
- package/core/apps/docs/src/components/ConstructorSection.vue +82 -0
- package/core/apps/docs/src/components/DocDescription.vue +40 -0
- package/core/apps/docs/src/components/FluxerLogo.vue +3 -0
- package/core/apps/docs/src/components/Footer.vue +106 -0
- package/core/apps/docs/src/components/GuideCodeBlock.vue +102 -0
- package/core/apps/docs/src/components/GuideDiscordCompat.vue +77 -0
- package/core/apps/docs/src/components/GuideDiscordCompatCallout.vue +83 -0
- package/core/apps/docs/src/components/GuideTable.vue +77 -0
- package/core/apps/docs/src/components/GuideTip.vue +38 -0
- package/core/apps/docs/src/components/MethodsSection.vue +195 -0
- package/core/apps/docs/src/components/ParamsTable.vue +70 -0
- package/core/apps/docs/src/components/PropertiesSection.vue +143 -0
- package/core/apps/docs/src/components/SearchBar.vue +76 -0
- package/core/apps/docs/src/components/SearchModal.vue +361 -0
- package/core/apps/docs/src/components/SidebarNav.vue +225 -0
- package/core/apps/docs/src/components/SponsorBanner.vue +153 -0
- package/core/apps/docs/src/components/TypeSignature.vue +187 -0
- package/core/apps/docs/src/components/VersionPicker.vue +191 -0
- package/core/apps/docs/src/composables/useSearchIndex.ts +144 -0
- package/core/apps/docs/src/composables/useVersionedPath.ts +20 -0
- package/core/apps/docs/src/data/apiEndpoints.ts +1073 -0
- package/core/apps/docs/src/data/changelog.ts +717 -0
- package/core/apps/docs/src/data/guides.ts +2362 -0
- package/core/apps/docs/src/env.d.ts +7 -0
- package/core/apps/docs/src/locales/guides-en.json +512 -0
- package/core/apps/docs/src/main.ts +27 -0
- package/core/apps/docs/src/pages/ApiReferenceLayout.vue +175 -0
- package/core/apps/docs/src/pages/ApiReferencePage.vue +128 -0
- package/core/apps/docs/src/pages/Changelog.vue +288 -0
- package/core/apps/docs/src/pages/ClassPage.vue +319 -0
- package/core/apps/docs/src/pages/ClassesList.vue +100 -0
- package/core/apps/docs/src/pages/DocsLayout.vue +127 -0
- package/core/apps/docs/src/pages/GuidePage.vue +279 -0
- package/core/apps/docs/src/pages/GuidesIndex.vue +166 -0
- package/core/apps/docs/src/pages/GuidesLayout.vue +245 -0
- package/core/apps/docs/src/pages/Home.vue +125 -0
- package/core/apps/docs/src/pages/NotFound.vue +57 -0
- package/core/apps/docs/src/pages/TypedefPage.vue +230 -0
- package/core/apps/docs/src/pages/TypedefsList.vue +168 -0
- package/core/apps/docs/src/pages/VersionLayout.vue +15 -0
- package/core/apps/docs/src/router.ts +73 -0
- package/core/apps/docs/src/stores/docs.ts +54 -0
- package/core/apps/docs/src/stores/guides.ts +53 -0
- package/core/apps/docs/src/stores/version.ts +67 -0
- package/core/apps/docs/src/styles/main.css +278 -0
- package/core/apps/docs/src/styles/prism.css +95 -0
- package/core/apps/docs/src/types/doc-schema.ts +112 -0
- package/core/apps/docs/tsconfig.json +17 -0
- package/core/apps/docs/tsconfig.node.json +10 -0
- package/core/apps/docs/vite.config.d.ts +2 -0
- package/core/apps/docs/vite.config.js +26 -0
- package/core/apps/docs/vite.config.ts +28 -0
- package/core/apps/docs-vitepress/.vitepress/config.ts +141 -0
- package/core/apps/docs-vitepress/api-data/latest/main.json +15035 -0
- package/core/apps/docs-vitepress/api-data/v1.2.4/main.json +15035 -0
- package/core/apps/docs-vitepress/api-data/versions.json +6 -0
- package/core/apps/docs-vitepress/index.md +15 -0
- package/core/apps/docs-vitepress/package-lock.json +2924 -0
- package/core/apps/docs-vitepress/package.json +20 -0
- package/core/apps/docs-vitepress/public/CNAME +1 -0
- package/core/apps/docs-vitepress/scripts/generate-api.ts +243 -0
- package/core/apps/docs-vitepress/scripts/migrate-guides.ts +129 -0
- package/core/apps/docs-vitepress/tsconfig.json +11 -0
- package/core/apps/docs-vitepress/v/latest/guides/attachments-by-url.md +57 -0
- package/core/apps/docs-vitepress/v/latest/guides/attachments.md +62 -0
- package/core/apps/docs-vitepress/v/latest/guides/basic-bot.md +49 -0
- package/core/apps/docs-vitepress/v/latest/guides/channels.md +180 -0
- package/core/apps/docs-vitepress/v/latest/guides/deprecated-apis.md +58 -0
- package/core/apps/docs-vitepress/v/latest/guides/discord-js-compatibility.md +42 -0
- package/core/apps/docs-vitepress/v/latest/guides/editing-embeds.md +65 -0
- package/core/apps/docs-vitepress/v/latest/guides/embed-media.md +87 -0
- package/core/apps/docs-vitepress/v/latest/guides/embeds.md +166 -0
- package/core/apps/docs-vitepress/v/latest/guides/emojis.md +77 -0
- package/core/apps/docs-vitepress/v/latest/guides/events.md +202 -0
- package/core/apps/docs-vitepress/v/latest/guides/gifs.md +47 -0
- package/core/apps/docs-vitepress/v/latest/guides/installation.md +10 -0
- package/core/apps/docs-vitepress/v/latest/guides/moderation.md +89 -0
- package/core/apps/docs-vitepress/v/latest/guides/permissions.md +130 -0
- package/core/apps/docs-vitepress/v/latest/guides/prefix-commands.md +41 -0
- package/core/apps/docs-vitepress/v/latest/guides/profile-urls.md +58 -0
- package/core/apps/docs-vitepress/v/latest/guides/reactions.md +69 -0
- package/core/apps/docs-vitepress/v/latest/guides/roles.md +130 -0
- package/core/apps/docs-vitepress/v/latest/guides/sending-without-reply.md +172 -0
- package/core/apps/docs-vitepress/v/latest/guides/voice.md +109 -0
- package/core/apps/docs-vitepress/v/latest/guides/wait-for-guilds.md +37 -0
- package/core/apps/docs-vitepress/v/latest/guides/webhook-attachments-embeds.md +73 -0
- package/core/apps/docs-vitepress/v/latest/guides/webhooks.md +131 -0
- package/core/eslint.config.js +80 -0
- package/core/examples/.env.example +22 -0
- package/core/examples/README.md +68 -0
- package/core/examples/first-steps-bot.js +118 -0
- package/core/examples/minimal-bot.js +17 -0
- package/core/examples/moderation-bot.js +209 -0
- package/core/examples/package.json +14 -0
- package/core/examples/ping-bot.js +1146 -0
- package/core/examples/reaction-bot.js +70 -0
- package/core/examples/reaction-roles-bot.js +140 -0
- package/core/examples/webhook-bot.js +239 -0
- package/core/flux.png +0 -0
- package/core/package.json +78 -0
- package/core/packages/builders/package.json +51 -0
- package/core/packages/builders/src/index.ts +13 -0
- package/core/packages/builders/src/messages/AttachmentBuilder.test.ts +79 -0
- package/core/packages/builders/src/messages/AttachmentBuilder.ts +69 -0
- package/core/packages/builders/src/messages/EmbedBuilder.test.ts +266 -0
- package/core/packages/builders/src/messages/EmbedBuilder.ts +239 -0
- package/core/packages/builders/src/messages/MessagePayload.test.ts +118 -0
- package/core/packages/builders/src/messages/MessagePayload.ts +122 -0
- package/core/packages/builders/tsconfig.json +9 -0
- package/core/packages/builders/tsup.config.ts +9 -0
- package/core/packages/builders/vitest.config.ts +9 -0
- package/core/packages/collection/package.json +47 -0
- package/core/packages/collection/src/Collection.test.ts +232 -0
- package/core/packages/collection/src/Collection.ts +196 -0
- package/core/packages/collection/src/index.ts +1 -0
- package/core/packages/collection/tsconfig.json +9 -0
- package/core/packages/collection/tsup.config.ts +9 -0
- package/core/packages/collection/vitest.config.ts +9 -0
- package/core/packages/docgen/package.json +26 -0
- package/core/packages/docgen/src/extract.ts +262 -0
- package/core/packages/docgen/src/formatType.ts +24 -0
- package/core/packages/docgen/src/index.ts +103 -0
- package/core/packages/docgen/src/schema.ts +100 -0
- package/core/packages/docgen/src/visitor.ts +147 -0
- package/core/packages/docgen/tsconfig.json +9 -0
- package/core/packages/docgen/tsup.config.ts +9 -0
- package/core/packages/fluxer-core/README.md +26 -0
- package/core/packages/fluxer-core/package.json +60 -0
- package/core/packages/fluxer-core/src/client/ChannelManager.ts +143 -0
- package/core/packages/fluxer-core/src/client/Client.gateway.test.ts +84 -0
- package/core/packages/fluxer-core/src/client/Client.resolveEmoji.test.ts +45 -0
- package/core/packages/fluxer-core/src/client/Client.ts +558 -0
- package/core/packages/fluxer-core/src/client/ClientUser.ts +40 -0
- package/core/packages/fluxer-core/src/client/EventHandlerRegistry.ts +469 -0
- package/core/packages/fluxer-core/src/client/GuildManager.ts +79 -0
- package/core/packages/fluxer-core/src/client/GuildMemberManager.ts +91 -0
- package/core/packages/fluxer-core/src/client/MessageManager.ts +58 -0
- package/core/packages/fluxer-core/src/client/UsersManager.ts +122 -0
- package/core/packages/fluxer-core/src/errors/ErrorCodes.test.ts +19 -0
- package/core/packages/fluxer-core/src/errors/ErrorCodes.ts +12 -0
- package/core/packages/fluxer-core/src/errors/FluxerError.test.ts +32 -0
- package/core/packages/fluxer-core/src/errors/FluxerError.ts +15 -0
- package/core/packages/fluxer-core/src/index.ts +85 -0
- package/core/packages/fluxer-core/src/structures/Base.ts +7 -0
- package/core/packages/fluxer-core/src/structures/Channel.ts +508 -0
- package/core/packages/fluxer-core/src/structures/Guild.test.ts +189 -0
- package/core/packages/fluxer-core/src/structures/Guild.ts +734 -0
- package/core/packages/fluxer-core/src/structures/GuildBan.ts +35 -0
- package/core/packages/fluxer-core/src/structures/GuildEmoji.ts +57 -0
- package/core/packages/fluxer-core/src/structures/GuildMember.test.ts +203 -0
- package/core/packages/fluxer-core/src/structures/GuildMember.ts +213 -0
- package/core/packages/fluxer-core/src/structures/GuildMemberRoleManager.ts +121 -0
- package/core/packages/fluxer-core/src/structures/GuildSticker.ts +56 -0
- package/core/packages/fluxer-core/src/structures/Invite.test.ts +103 -0
- package/core/packages/fluxer-core/src/structures/Invite.ts +121 -0
- package/core/packages/fluxer-core/src/structures/Message.test.ts +109 -0
- package/core/packages/fluxer-core/src/structures/Message.ts +397 -0
- package/core/packages/fluxer-core/src/structures/MessageReaction.ts +72 -0
- package/core/packages/fluxer-core/src/structures/PartialMessage.ts +12 -0
- package/core/packages/fluxer-core/src/structures/Role.test.ts +77 -0
- package/core/packages/fluxer-core/src/structures/Role.ts +112 -0
- package/core/packages/fluxer-core/src/structures/User.test.ts +110 -0
- package/core/packages/fluxer-core/src/structures/User.ts +109 -0
- package/core/packages/fluxer-core/src/structures/Webhook.test.ts +109 -0
- package/core/packages/fluxer-core/src/structures/Webhook.ts +258 -0
- package/core/packages/fluxer-core/src/util/Constants.test.ts +16 -0
- package/core/packages/fluxer-core/src/util/Constants.ts +7 -0
- package/core/packages/fluxer-core/src/util/Events.ts +46 -0
- package/core/packages/fluxer-core/src/util/MessageCollector.ts +87 -0
- package/core/packages/fluxer-core/src/util/Options.ts +33 -0
- package/core/packages/fluxer-core/src/util/ReactionCollector.ts +116 -0
- package/core/packages/fluxer-core/src/util/cdn.test.ts +108 -0
- package/core/packages/fluxer-core/src/util/cdn.ts +130 -0
- package/core/packages/fluxer-core/src/util/guildUtils.ts +33 -0
- package/core/packages/fluxer-core/src/util/messageUtils.test.ts +74 -0
- package/core/packages/fluxer-core/src/util/messageUtils.ts +119 -0
- package/core/packages/fluxer-core/src/util/permissions.test.ts +95 -0
- package/core/packages/fluxer-core/src/util/permissions.ts +43 -0
- package/core/packages/fluxer-core/tsconfig.json +9 -0
- package/core/packages/fluxer-core/tsup.config.ts +9 -0
- package/core/packages/fluxer-core/vitest.config.ts +9 -0
- package/core/packages/rest/package.json +52 -0
- package/core/packages/rest/src/REST.test.ts +64 -0
- package/core/packages/rest/src/REST.ts +90 -0
- package/core/packages/rest/src/RateLimitManager.test.ts +71 -0
- package/core/packages/rest/src/RateLimitManager.ts +60 -0
- package/core/packages/rest/src/RequestManager.test.ts +87 -0
- package/core/packages/rest/src/RequestManager.ts +172 -0
- package/core/packages/rest/src/errors/FluxerAPIError.test.ts +57 -0
- package/core/packages/rest/src/errors/FluxerAPIError.ts +21 -0
- package/core/packages/rest/src/errors/HTTPError.test.ts +55 -0
- package/core/packages/rest/src/errors/HTTPError.ts +25 -0
- package/core/packages/rest/src/errors/RateLimitError.test.ts +41 -0
- package/core/packages/rest/src/errors/RateLimitError.ts +15 -0
- package/core/packages/rest/src/errors/index.ts +3 -0
- package/core/packages/rest/src/index.ts +6 -0
- package/core/packages/rest/src/utils/constants.test.ts +31 -0
- package/core/packages/rest/src/utils/constants.ts +5 -0
- package/core/packages/rest/src/utils/files.test.ts +37 -0
- package/core/packages/rest/src/utils/files.ts +75 -0
- package/core/packages/rest/tsconfig.json +9 -0
- package/core/packages/rest/tsup.config.ts +9 -0
- package/core/packages/rest/vitest.config.ts +9 -0
- package/core/packages/types/package.json +46 -0
- package/core/packages/types/src/api/ban.ts +8 -0
- package/core/packages/types/src/api/channel.ts +65 -0
- package/core/packages/types/src/api/embed.ts +82 -0
- package/core/packages/types/src/api/emoji.ts +12 -0
- package/core/packages/types/src/api/errors.ts +68 -0
- package/core/packages/types/src/api/gateway.ts +14 -0
- package/core/packages/types/src/api/guild.ts +123 -0
- package/core/packages/types/src/api/index.ts +15 -0
- package/core/packages/types/src/api/instance.ts +32 -0
- package/core/packages/types/src/api/interaction.ts +26 -0
- package/core/packages/types/src/api/invite.ts +28 -0
- package/core/packages/types/src/api/message.ts +140 -0
- package/core/packages/types/src/api/role.ts +41 -0
- package/core/packages/types/src/api/sticker.ts +14 -0
- package/core/packages/types/src/api/user.ts +79 -0
- package/core/packages/types/src/api/webhook.ts +41 -0
- package/core/packages/types/src/common/index.ts +1 -0
- package/core/packages/types/src/common/snowflake.test.ts +9 -0
- package/core/packages/types/src/common/snowflake.ts +8 -0
- package/core/packages/types/src/gateway/events.ts +189 -0
- package/core/packages/types/src/gateway/index.ts +3 -0
- package/core/packages/types/src/gateway/opcodes.ts +17 -0
- package/core/packages/types/src/gateway/payloads.ts +481 -0
- package/core/packages/types/src/index.ts +4 -0
- package/core/packages/types/src/rest/index.ts +1 -0
- package/core/packages/types/src/rest/routes.test.ts +169 -0
- package/core/packages/types/src/rest/routes.ts +109 -0
- package/core/packages/types/tsconfig.json +9 -0
- package/core/packages/types/tsup.config.ts +9 -0
- package/core/packages/types/vitest.config.ts +9 -0
- package/core/packages/util/package.json +51 -0
- package/core/packages/util/src/BitField.test.ts +96 -0
- package/core/packages/util/src/BitField.ts +105 -0
- package/core/packages/util/src/MessageFlagsBitField.test.ts +42 -0
- package/core/packages/util/src/MessageFlagsBitField.ts +20 -0
- package/core/packages/util/src/PermissionsBitField.test.ts +79 -0
- package/core/packages/util/src/PermissionsBitField.ts +97 -0
- package/core/packages/util/src/SnowflakeUtil.test.ts +69 -0
- package/core/packages/util/src/SnowflakeUtil.ts +65 -0
- package/core/packages/util/src/UserFlagsBitField.test.ts +39 -0
- package/core/packages/util/src/UserFlagsBitField.ts +48 -0
- package/core/packages/util/src/deprecation.test.ts +44 -0
- package/core/packages/util/src/deprecation.ts +28 -0
- package/core/packages/util/src/emojiShortcodes.generated.ts +5 -0
- package/core/packages/util/src/emojiShortcodes.test.ts +41 -0
- package/core/packages/util/src/emojiShortcodes.ts +22 -0
- package/core/packages/util/src/formatters.test.ts +65 -0
- package/core/packages/util/src/formatters.ts +35 -0
- package/core/packages/util/src/index.ts +34 -0
- package/core/packages/util/src/resolvers.test.ts +198 -0
- package/core/packages/util/src/resolvers.ts +127 -0
- package/core/packages/util/src/tenorUtils.test.ts +75 -0
- package/core/packages/util/src/tenorUtils.ts +86 -0
- package/core/packages/util/tsconfig.json +9 -0
- package/core/packages/util/tsup.config.ts +9 -0
- package/core/packages/util/vitest.config.ts +9 -0
- package/core/packages/voice/README.md +42 -0
- package/core/packages/voice/package.json +67 -0
- package/core/packages/voice/src/LiveKitRtcConnection.receive.test.ts +24 -0
- package/core/packages/voice/src/LiveKitRtcConnection.ts +1767 -0
- package/core/packages/voice/src/VoiceConnection.ts +413 -0
- package/core/packages/voice/src/VoiceManager.receive.test.ts +61 -0
- package/core/packages/voice/src/VoiceManager.test.ts +44 -0
- package/core/packages/voice/src/VoiceManager.ts +503 -0
- package/core/packages/voice/src/exports.test.ts +38 -0
- package/core/packages/voice/src/index.ts +51 -0
- package/core/packages/voice/src/livekit.test.ts +48 -0
- package/core/packages/voice/src/livekit.ts +33 -0
- package/core/packages/voice/src/mp4box.d.ts +32 -0
- package/core/packages/voice/src/opusUtils.test.ts +29 -0
- package/core/packages/voice/src/opusUtils.ts +86 -0
- package/core/packages/voice/src/streamPreviewPlaceholder.test.ts +16 -0
- package/core/packages/voice/src/streamPreviewPlaceholder.ts +8 -0
- package/core/packages/voice/src/ws.d.ts +1 -0
- package/core/packages/voice/tsconfig.json +5 -0
- package/core/packages/voice/tsup.config.ts +10 -0
- package/core/packages/voice/vitest.config.ts +9 -0
- package/core/packages/ws/package.json +52 -0
- package/core/packages/ws/src/WebSocketManager.ts +130 -0
- package/core/packages/ws/src/WebSocketShard.ts +296 -0
- package/core/packages/ws/src/index.ts +12 -0
- package/core/packages/ws/src/utils/constants.test.ts +46 -0
- package/core/packages/ws/src/utils/constants.ts +22 -0
- package/core/packages/ws/src/utils/getWebSocket.ts +55 -0
- package/core/packages/ws/src/ws.d.ts +10 -0
- package/core/packages/ws/tsconfig.json +9 -0
- package/core/packages/ws/tsup.config.ts +9 -0
- package/core/pnpm-lock.yaml +7033 -0
- package/core/pnpm-workspace.yaml +4 -0
- package/core/scripts/generate-ai-rag.ts +240 -0
- package/core/scripts/generate-docs.ts +143 -0
- package/core/scripts/generate-emoji-shortcodes.ts +58 -0
- package/core/scripts/generate-types.ts +6 -0
- package/core/scripts/publish-ordered.js +63 -0
- package/core/scripts/test-cjs-require.mjs +43 -0
- package/core/scripts/test-esm-imports.mjs +42 -0
- package/core/scripts/test-package-exports.mjs +98 -0
- package/core/scripts/test-smoke.mjs +103 -0
- package/core/tsconfig.json +18 -0
- package/core/turbo.json +30 -0
- package/core/vitest.config.ts +17 -0
- package/core/wrangler.jsonc +9 -0
- package/package.json +26 -0
|
@@ -0,0 +1,313 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"id": "installation",
|
|
4
|
+
"slug": "installation",
|
|
5
|
+
"title": "Installation",
|
|
6
|
+
"description": "Install the package and configure your bot token.",
|
|
7
|
+
"category": "getting-started",
|
|
8
|
+
"sections": [
|
|
9
|
+
{
|
|
10
|
+
"code": "npm install @fluxerjs/core\n\n# Run your bot (Node 18+)\nFLUXER_BOT_TOKEN=your_token node your-bot.js",
|
|
11
|
+
"language": "bash"
|
|
12
|
+
}
|
|
13
|
+
]
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"id": "basic-bot",
|
|
17
|
+
"slug": "basic-bot",
|
|
18
|
+
"title": "Basic Bot",
|
|
19
|
+
"description": "A minimal bot that responds to !ping with Pong.",
|
|
20
|
+
"category": "getting-started",
|
|
21
|
+
"sections": [
|
|
22
|
+
{
|
|
23
|
+
"code": "import { Client, Events } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.Ready, () => console.log('Ready!'));\nclient.on(Events.MessageCreate, async (message) => {\n if (message.content === '!ping') {\n await message.reply('Pong!');\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
24
|
+
"language": "javascript"
|
|
25
|
+
}
|
|
26
|
+
]
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"id": "sending-without-reply",
|
|
30
|
+
"slug": "sending-without-reply",
|
|
31
|
+
"title": "Sending Without Reply",
|
|
32
|
+
"description": "Send messages to the same channel or to specific channels. Covers message.send(), message.sendTo(), client.channels.send(), and client.channels.fetch().",
|
|
33
|
+
"category": "sending-messages",
|
|
34
|
+
"sections": [
|
|
35
|
+
{
|
|
36
|
+
"title": "message.send() vs message.reply()",
|
|
37
|
+
"description": "message.reply() sends a message that references another message (shows as a \"reply\" in Discord). message.send() sends to the same channel with no reference—a regular standalone message."
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"title": "Sending to the same channel",
|
|
41
|
+
"description": "Use message.send() when you want to post in the channel without replying. Same signature as reply(): pass a string or object with content and/or embeds.",
|
|
42
|
+
"code": "import { Client, Events } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.MessageCreate, async (message) => {\n if (message.content === '!hello') {\n await message.send('Hello! This is a regular message, not a reply.');\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
43
|
+
"language": "javascript"
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"title": "Sending to a specific channel (e.g. logging)",
|
|
47
|
+
"description": "Use message.sendTo(channelId, payload) to send to another channel—handy for logging, announcements, or forwarding. You only need the target channel ID.",
|
|
48
|
+
"code": "import { Client, Events, EmbedBuilder } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nconst LOG_CHANNEL_ID = process.env.LOG_CHANNEL_ID; // Your log channel's snowflake\n\nclient.on(Events.MessageCreate, async (message) => {\n if (message.content === '!report' && message.guildId && LOG_CHANNEL_ID) {\n const embed = new EmbedBuilder()\n .setTitle('User report')\n .setDescription(message.content)\n .addFields(\n { name: 'Author', value: message.author.username, inline: true },\n { name: 'Channel', value: `<#${message.channelId}>`, inline: true }\n )\n .setTimestamp();\n\n await message.sendTo(LOG_CHANNEL_ID, { embeds: [embed.toJSON()] });\n await message.send('Report logged.');\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
49
|
+
"language": "javascript"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"title": "client.channels.send() — send by channel ID",
|
|
53
|
+
"description": "Use client.channels.send(channelId, payload) when you have a channel ID. Works even if the channel is not cached. No need to fetch first when you only need to send.",
|
|
54
|
+
"code": "import { Client, Events } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nconst ANNOUNCE_CHANNEL_ID = process.env.ANNOUNCE_CHANNEL_ID;\n\nclient.on(Events.Ready, async () => {\n if (ANNOUNCE_CHANNEL_ID) {\n await client.channels.send(ANNOUNCE_CHANNEL_ID, 'Bot is online!');\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
55
|
+
"language": "javascript"
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
"title": "client.channels.fetch() — get channel by ID",
|
|
59
|
+
"description": "Fetch a channel by ID from the API (or cache). Use channel.isSendable() before sending. For sending when you only have an ID, prefer client.channels.send() which skips the fetch.",
|
|
60
|
+
"code": "import { Client } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nawait client.login(process.env.FLUXER_BOT_TOKEN);\n\n// Fetch channel (from API if not cached)\nconst channel = await client.channels.fetch(channelId);\nif (channel?.isSendable()) {\n await channel.send('Hello!');\n}\n// Or for webhooks: if (channel?.createWebhook) { ... }",
|
|
61
|
+
"language": "javascript"
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
"title": "fetch message by id",
|
|
65
|
+
"description": "Use channel.messages.fetch(messageId) when you have the channel. For IDs-only, fetch the channel first.",
|
|
66
|
+
"code": "// When you have the channel\nconst message = await channel.messages.fetch(messageId);\nif (message) {\n await message.edit({ content: 'Updated!' });\n await message.react('👍');\n}\n\n// When you only have IDs (e.g. from sqlite)\nconst ch = await client.channels.fetch(channelId);\nconst msg = await ch?.messages?.fetch(messageId);\nif (msg) await msg.delete();\n\n// When channel is cached\nconst m = client.channels.get(channelId);\nif (m?.isSendable()) {\n const mes = await m.messages.fetch(messageId);\n if (mes) await mes.edit({ content: 'Edited!' });\n}\n\n// Refresh a stale message instance\nconst updated = await message.fetch();\nif (updated) console.log(updated.content);",
|
|
67
|
+
"language": "javascript"
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
"title": "message.channel and message.guild",
|
|
71
|
+
"description": "Access the channel or guild from a message. Resolved from cache; null if not cached (e.g. DM channel).",
|
|
72
|
+
"code": "client.on(Events.MessageCreate, async (message) => {\n const channel = message.channel; // TextChannel or DMChannel | null\n const guild = message.guild; // Guild | null (null for DMs)\n if (message.channel?.isSendable()) {\n await message.channel.send('Same channel, different API');\n }\n});",
|
|
73
|
+
"language": "javascript"
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"title": "Quick reference",
|
|
77
|
+
"code": "// Same channel, no reply\nawait message.send('Pong!');\n\n// Reply to the message\nawait message.reply('Pong!');\n\n// Send to a specific channel\nawait message.sendTo(logChannelId, 'User joined!');\nawait client.channels.send(channelId, 'New update available!');",
|
|
78
|
+
"language": "javascript"
|
|
79
|
+
}
|
|
80
|
+
]
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"id": "embeds",
|
|
84
|
+
"slug": "embeds",
|
|
85
|
+
"title": "Embeds",
|
|
86
|
+
"description": "Send rich embeds with EmbedBuilder.",
|
|
87
|
+
"category": "sending-messages",
|
|
88
|
+
"sections": [
|
|
89
|
+
{
|
|
90
|
+
"code": "import { Client, Events, EmbedBuilder } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.MessageCreate, async (message) => {\n if (message.content === '!embed') {\n const embed = new EmbedBuilder()\n .setTitle('Hello!')\n .setDescription('This is a Fluxer embed.')\n .setColor(0x5865f2)\n .addFields(\n { name: 'Field 1', value: 'Value 1', inline: true },\n { name: 'Field 2', value: 'Value 2', inline: true }\n )\n .setFooter({ text: 'Powered by Fluxer.js' })\n .setTimestamp();\n\n await message.reply({ embeds: [embed.toJSON()] });\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
91
|
+
"language": "javascript"
|
|
92
|
+
}
|
|
93
|
+
]
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"id": "editing-embeds",
|
|
97
|
+
"slug": "editing-embeds",
|
|
98
|
+
"title": "Editing Embeds",
|
|
99
|
+
"description": "Edit existing message embeds with message.edit().",
|
|
100
|
+
"category": "sending-messages",
|
|
101
|
+
"sections": [
|
|
102
|
+
{
|
|
103
|
+
"title": "Overview",
|
|
104
|
+
"description": "The Fluxer API supports editing existing messages via PATCH. You can update the message content, embeds, or both. Only the message author (or admins with proper permissions) can edit messages."
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"title": "Edit Content",
|
|
108
|
+
"description": "Update the text content of a message you sent.",
|
|
109
|
+
"code": "const reply = await message.reply('Initial message');\nawait reply.edit({ content: 'Updated message!' });",
|
|
110
|
+
"language": "javascript"
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
"title": "Edit Embeds",
|
|
114
|
+
"description": "Replace or update embeds on an existing message. Pass an array of EmbedBuilder instances or APIEmbed objects.",
|
|
115
|
+
"code": "import { Client, Events, EmbedBuilder } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.MessageCreate, async (message) => {\n if (message.content === '!editembed') {\n const embed = new EmbedBuilder()\n .setTitle('Loading...')\n .setColor(0x5865f2)\n .setTimestamp();\n\n const reply = await message.reply({ embeds: [embed.toJSON()] });\n\n // Simulate loading, then update the embed\n await new Promise((r) => setTimeout(r, 2000));\n\n const updatedEmbed = new EmbedBuilder()\n .setTitle('Done!')\n .setDescription('This embed was edited after 2 seconds.')\n .setColor(0x57f287)\n .setTimestamp();\n\n await reply.edit({ embeds: [updatedEmbed] });\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
116
|
+
"language": "javascript"
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"title": "Edit Content and Embeds Together",
|
|
120
|
+
"description": "You can update both content and embeds in a single edit call.",
|
|
121
|
+
"code": "await message.edit({\n content: 'Updated text',\n embeds: [new EmbedBuilder().setTitle('Updated embed').setColor(0x5865f2).toJSON()],\n});",
|
|
122
|
+
"language": "javascript"
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"title": "API Reference",
|
|
126
|
+
"description": "The edit endpoint is PATCH /channels/{channel_id}/messages/{message_id}. See openapi.json for the full request body schema. The SDK Message.edit() accepts { content?: string; embeds?: (APIEmbed | EmbedBuilder)[] }."
|
|
127
|
+
}
|
|
128
|
+
]
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"id": "reactions",
|
|
132
|
+
"slug": "reactions",
|
|
133
|
+
"title": "Reactions",
|
|
134
|
+
"description": "Add, remove, and listen for message reactions with Message.react(), removeReaction(), and reaction events.",
|
|
135
|
+
"category": "sending-messages",
|
|
136
|
+
"sections": [
|
|
137
|
+
{
|
|
138
|
+
"title": "Add a Reaction",
|
|
139
|
+
"description": "Use message.react() to add an emoji reaction as the bot. Pass a unicode emoji string or custom emoji { name, id }.",
|
|
140
|
+
"code": "const reply = await message.reply('React to this!');\nawait reply.react('👍');\nawait reply.react({ name: 'customemoji', id: '123456789012345678' });",
|
|
141
|
+
"language": "javascript"
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"title": "Remove Reactions",
|
|
145
|
+
"description": "Remove the bot's reaction with removeReaction(emoji). Remove a specific user's reaction with removeReaction(emoji, userId). Clear all reactions with removeAllReactions() or removeReactionEmoji(emoji).",
|
|
146
|
+
"code": "// Remove the bot's reaction\nawait message.removeReaction('👍');\n\n// Remove a specific user's reaction (requires moderator permissions)\nawait message.removeReaction('👍', userId);\n\n// Remove all reactions of one emoji from the message\nawait message.removeReactionEmoji('👍');\n\n// Remove all reactions from the message\nawait message.removeAllReactions();",
|
|
147
|
+
"language": "javascript"
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
"title": "Listen for Reactions",
|
|
151
|
+
"description": "MessageReactionAdd and MessageReactionRemove emit (reaction, user). Use reaction.emoji, reaction.messageId, reaction.channelId, reaction.guildId, or reaction.fetchMessage() to get the full message.",
|
|
152
|
+
"code": "client.on(Events.MessageReactionAdd, async (reaction, user) => {\n if (reaction.emoji.name === '👍') {\n console.log(`User ${user.id} voted yes on message ${reaction.messageId}`);\n const message = await reaction.fetchMessage();\n if (message) await message.react('✅');\n }\n});\n\nclient.on(Events.MessageReactionRemove, (reaction, user) => {\n console.log(`User ${user.id} removed ${reaction.emoji.name} from message ${reaction.messageId}`);\n});",
|
|
153
|
+
"language": "javascript"
|
|
154
|
+
},
|
|
155
|
+
{
|
|
156
|
+
"title": "Reaction Roles Example",
|
|
157
|
+
"description": "See examples/reaction-roles-bot.js for a full bot that assigns roles when users react to a message. Uses (reaction, user), Guild.fetchMember(), and GuildMember.addRole()/removeRole().",
|
|
158
|
+
"code": "// Simplified reaction-roles logic\nclient.on(Events.MessageReactionAdd, async (reaction, user) => {\n if (!reaction.guildId || reaction.messageId !== rolesMessageId) return;\n const roleId = ROLE_EMOJI_MAP[reaction.emoji.name];\n if (!roleId) return;\n const guild = client.guilds.get(reaction.guildId);\n const member = await guild?.fetchMember(user.id);\n if (member && !member.roles.includes(roleId)) await member.addRole(roleId);\n});",
|
|
159
|
+
"language": "javascript"
|
|
160
|
+
}
|
|
161
|
+
]
|
|
162
|
+
},
|
|
163
|
+
{
|
|
164
|
+
"id": "webhooks",
|
|
165
|
+
"slug": "webhooks",
|
|
166
|
+
"title": "Webhooks",
|
|
167
|
+
"description": "A complete guide to Discord webhooks—sending messages without a gateway, creating webhooks, and managing them.",
|
|
168
|
+
"category": "webhooks",
|
|
169
|
+
"sections": [
|
|
170
|
+
{
|
|
171
|
+
"title": "What are Webhooks?",
|
|
172
|
+
"description": "Webhooks let you send messages to a channel using a URL (ID + token). You can use them in scripts, CI pipelines, or anywhere you need to post without a full bot connection. No gateway, no events—just REST."
|
|
173
|
+
},
|
|
174
|
+
{
|
|
175
|
+
"title": "Webhooks Without a Bot",
|
|
176
|
+
"description": "A Client with intents: 0 is enough. No need to connect to the gateway or handle events. Ideal for scripts or one-off sends.",
|
|
177
|
+
"code": "import { Client, Webhook } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nconst webhook = Webhook.fromToken(client, webhookId, webhookToken);\nawait webhook.send('Message from a script!');",
|
|
178
|
+
"language": "javascript"
|
|
179
|
+
},
|
|
180
|
+
{
|
|
181
|
+
"title": "Creating a Webhook",
|
|
182
|
+
"description": "Create a webhook on a text channel. Requires Manage Webhooks permission. The token is returned only when creating—store it securely. It will never be returned when listing or fetching.",
|
|
183
|
+
"code": "import { Client } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nawait client.login(process.env.FLUXER_BOT_TOKEN);\n\nconst channel = client.channels.get(channelId);\nif (!channel?.createWebhook) throw new Error('Channel does not support webhooks');\n\nconst webhook = await channel.createWebhook({ name: 'My Webhook' });\nconsole.log(webhook.id, webhook.token); // Store token—it won't be returned when listing",
|
|
184
|
+
"language": "javascript"
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"title": "Sending Messages",
|
|
188
|
+
"description": "Send text, embeds, or both. You can override the username and avatar for each message.",
|
|
189
|
+
"code": "import { Client, Webhook, EmbedBuilder } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nconst webhook = Webhook.fromToken(client, webhookId, webhookToken);\n\nawait webhook.send({\n content: 'Hello from webhook!',\n embeds: [\n new EmbedBuilder()\n .setTitle('Webhook Message')\n .setColor(0x5865f2)\n .setTimestamp()\n .toJSON(),\n ],\n username: 'Custom Name',\n avatar_url: 'https://example.com/avatar.png',\n});",
|
|
190
|
+
"language": "javascript"
|
|
191
|
+
},
|
|
192
|
+
{
|
|
193
|
+
"title": "Simple text only",
|
|
194
|
+
"code": "await webhook.send('Plain text message');",
|
|
195
|
+
"language": "javascript"
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
"title": "Fetching & Listing Webhooks",
|
|
199
|
+
"description": "Fetch by ID or list channel/guild webhooks. Requires a logged-in bot. Fetched webhooks have no token and cannot send—only manage (delete).",
|
|
200
|
+
"code": "import { Client, Webhook } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nawait client.login(process.env.FLUXER_BOT_TOKEN);\n\n// Fetch single webhook (no token)\nconst webhook = await Webhook.fetch(client, webhookId);\n\n// List channel webhooks\nconst channel = client.channels.get(channelId);\nconst channelWebhooks = await channel?.fetchWebhooks() ?? [];\n\n// List guild webhooks\nconst guild = client.guilds.get(guildId);\nconst guildWebhooks = await guild?.fetchWebhooks() ?? [];",
|
|
201
|
+
"language": "javascript"
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"title": "Deleting a Webhook",
|
|
205
|
+
"code": "const webhook = await Webhook.fetch(client, webhookId);\nawait webhook.delete();",
|
|
206
|
+
"language": "javascript"
|
|
207
|
+
}
|
|
208
|
+
]
|
|
209
|
+
},
|
|
210
|
+
{
|
|
211
|
+
"id": "voice",
|
|
212
|
+
"slug": "voice",
|
|
213
|
+
"title": "Voice",
|
|
214
|
+
"description": "Join voice channels and play audio with @fluxerjs/voice. Supports WebM/Opus streams—no FFmpeg required.",
|
|
215
|
+
"category": "voice",
|
|
216
|
+
"sections": [
|
|
217
|
+
{
|
|
218
|
+
"title": "Installation",
|
|
219
|
+
"description": "Add the voice package alongside the core library.",
|
|
220
|
+
"code": "pnpm add @fluxerjs/voice @fluxerjs/core",
|
|
221
|
+
"language": "bash"
|
|
222
|
+
},
|
|
223
|
+
{
|
|
224
|
+
"title": "Setup",
|
|
225
|
+
"description": "Create a VoiceManager before login so it receives VoiceStatesSync from READY/GUILD_CREATE. This lets the manager see users already in voice when the bot starts.",
|
|
226
|
+
"code": "import { Client, Events, VoiceChannel } from '@fluxerjs/core';\nimport { getVoiceManager } from '@fluxerjs/voice';\n\nconst client = new Client({ intents: 0 });\ngetVoiceManager(client); // Must be before login\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
227
|
+
"language": "javascript"
|
|
228
|
+
},
|
|
229
|
+
{
|
|
230
|
+
"title": "Join a Voice Channel",
|
|
231
|
+
"description": "Get the user's voice channel with getVoiceChannelId, then join. The connection resolves when ready.",
|
|
232
|
+
"code": "const voiceManager = getVoiceManager(client);\nconst voiceChannelId = voiceManager.getVoiceChannelId(guildId, userId);\nif (!voiceChannelId) return; // User not in voice\n\nconst channel = client.channels.get(voiceChannelId);\nif (!(channel instanceof VoiceChannel)) return;\n\nconst connection = await voiceManager.join(channel);",
|
|
233
|
+
"language": "javascript"
|
|
234
|
+
},
|
|
235
|
+
{
|
|
236
|
+
"title": "Play Audio",
|
|
237
|
+
"description": "Play a WebM/Opus URL or stream. The voice package does not use FFmpeg—input must be WebM with Opus. Use yt-dlp or similar to get direct stream URLs from YouTube.",
|
|
238
|
+
"code": "// URL (fetched and demuxed automatically)\nawait connection.play('https://example.com/audio.webm');\n\n// Or a Node.js ReadableStream of Opus\nawait connection.play(opusStream);",
|
|
239
|
+
"language": "javascript"
|
|
240
|
+
},
|
|
241
|
+
{
|
|
242
|
+
"title": "Getting Stream URLs from YouTube",
|
|
243
|
+
"description": "Use youtube-dl-exec or yt-dlp to extract a WebM/Opus URL.",
|
|
244
|
+
"code": "import youtubedl from 'youtube-dl-exec';\n\nconst result = await youtubedl(videoUrl, {\n getUrl: true,\n f: 'bestaudio[ext=webm][acodec=opus]/bestaudio[ext=webm]/bestaudio',\n}, { timeout: 15000 });\n\nconst streamUrl = String(result ?? '').trim();\nawait connection.play(streamUrl);",
|
|
245
|
+
"language": "javascript"
|
|
246
|
+
},
|
|
247
|
+
{
|
|
248
|
+
"title": "Stop and Leave",
|
|
249
|
+
"description": "Stop playback and disconnect from the guild's voice channel.",
|
|
250
|
+
"code": "const connection = voiceManager.getConnection(guildId);\nconnection?.stop();\nif (connection) voiceManager.leave(guildId);",
|
|
251
|
+
"language": "javascript"
|
|
252
|
+
},
|
|
253
|
+
{
|
|
254
|
+
"title": "LiveKit and serverLeave",
|
|
255
|
+
"description": "If using LiveKit, the server may emit serverLeave. Listen and reconnect if needed.",
|
|
256
|
+
"code": "connection.on?.('serverLeave', async () => {\n try {\n const conn = await voiceManager.join(channel);\n await conn.play(streamUrl);\n } catch (e) {\n console.error('Auto-reconnect failed:', e);\n }\n});",
|
|
257
|
+
"language": "javascript"
|
|
258
|
+
}
|
|
259
|
+
]
|
|
260
|
+
},
|
|
261
|
+
{
|
|
262
|
+
"id": "events",
|
|
263
|
+
"slug": "events",
|
|
264
|
+
"title": "Events",
|
|
265
|
+
"description": "Listen to gateway events with client.on. Handle messages, guild updates, voice state changes, and more.",
|
|
266
|
+
"category": "events",
|
|
267
|
+
"sections": [
|
|
268
|
+
{
|
|
269
|
+
"title": "Basic Usage",
|
|
270
|
+
"description": "Use client.on(Events.X, handler) to subscribe to events. Handlers receive event-specific payloads.",
|
|
271
|
+
"code": "import { Client, Events } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.Ready, () => {\n console.log('Bot is ready!');\n});\n\nclient.on(Events.MessageCreate, async (message) => {\n console.log(message.content);\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
272
|
+
"language": "javascript"
|
|
273
|
+
},
|
|
274
|
+
{
|
|
275
|
+
"title": "Common Events",
|
|
276
|
+
"description": "Essential events for most bots.",
|
|
277
|
+
"code": "// Bot finished loading\nclient.on(Events.Ready, () => {});\n\n// New message (DM or guild)\nclient.on(Events.MessageCreate, async (message) => {});\n\n// Reaction events\nclient.on(Events.MessageReactionAdd, (data) => {});\nclient.on(Events.MessageReactionRemove, (data) => {});\n\n// Guild joined/left/updated\nclient.on(Events.GuildCreate, (guild) => {});\nclient.on(Events.GuildDelete, (guild) => {});\n\n// Channel created/updated/deleted\nclient.on(Events.ChannelCreate, (channel) => {});\nclient.on(Events.ChannelDelete, (channel) => {});\n\n// Member joined/left/updated\nclient.on(Events.GuildMemberAdd, (member) => {});\nclient.on(Events.GuildMemberRemove, (member) => {});\n\n// Voice state changed (for @fluxerjs/voice)\nclient.on(Events.VoiceStateUpdate, (data) => {});\nclient.on(Events.VoiceServerUpdate, (data) => {});",
|
|
278
|
+
"language": "javascript"
|
|
279
|
+
},
|
|
280
|
+
{
|
|
281
|
+
"title": "Reaction Events",
|
|
282
|
+
"description": "Listen for when users add or remove reactions. The payload includes message_id, channel_id, user_id, and emoji (name and optional id for custom emojis). Use MessageReactionRemoveAll and MessageReactionRemoveEmoji for moderator actions.",
|
|
283
|
+
"code": "import { Client, Events } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.MessageReactionAdd, (data) => {\n const { message_id, channel_id, user_id, emoji } = data;\n const emojiStr = emoji.id ? `<:${emoji.name}:${emoji.id}>` : emoji.name;\n console.log(`User ${user_id} reacted with ${emojiStr} on message ${message_id}`);\n\n // Filter for specific message (e.g. poll) or emoji\n if (data.emoji.name === '👍') {\n console.log('Someone voted yes!');\n }\n});\n\nclient.on(Events.MessageReactionRemove, (data) => {\n const { message_id, user_id, emoji } = data;\n console.log(`User ${user_id} removed ${emoji.name} from message ${message_id}`);\n});\n\nclient.on(Events.MessageReactionRemoveAll, (data) => {\n console.log(`All reactions cleared from message ${data.message_id}`);\n});\n\nclient.on(Events.MessageReactionRemoveEmoji, (data) => {\n console.log(`All ${data.emoji.name} reactions removed from message ${data.message_id}`);\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
284
|
+
"language": "javascript"
|
|
285
|
+
},
|
|
286
|
+
{
|
|
287
|
+
"title": "Error Handling",
|
|
288
|
+
"code": "client.on(Events.Error, (err) => {\n console.error('Client error:', err);\n});",
|
|
289
|
+
"language": "javascript"
|
|
290
|
+
}
|
|
291
|
+
]
|
|
292
|
+
},
|
|
293
|
+
{
|
|
294
|
+
"id": "prefix-commands",
|
|
295
|
+
"slug": "prefix-commands",
|
|
296
|
+
"title": "Prefix Commands",
|
|
297
|
+
"description": "Handle !commands by listening to MessageCreate and parsing the content.",
|
|
298
|
+
"category": "events",
|
|
299
|
+
"sections": [
|
|
300
|
+
{
|
|
301
|
+
"title": "Basic Structure",
|
|
302
|
+
"description": "Check for a prefix, split args, and dispatch to command handlers.",
|
|
303
|
+
"code": "import { Client, Events } from '@fluxerjs/core';\n\nconst PREFIX = '!';\nconst client = new Client({ intents: 0 });\n\nclient.on(Events.MessageCreate, async (message) => {\n if (message.author.bot || !message.content) return;\n if (!message.content.startsWith(PREFIX)) return;\n\n const args = message.content.slice(PREFIX.length).trim().split(/\\s+/);\n const command = args.shift()?.toLowerCase();\n\n if (command === 'ping') {\n await message.reply('Pong!');\n }\n if (command === 'hello') {\n const name = args[0] ?? 'there';\n await message.reply(`Hello, ${name}!`);\n }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
|
|
304
|
+
"language": "javascript"
|
|
305
|
+
},
|
|
306
|
+
{
|
|
307
|
+
"title": "Guild-Only Commands",
|
|
308
|
+
"code": "if (!message.guildId) {\n await message.reply('This command only works in a server.');\n return;\n}",
|
|
309
|
+
"language": "javascript"
|
|
310
|
+
}
|
|
311
|
+
]
|
|
312
|
+
}
|
|
313
|
+
]
|