Build blazingly fast Discord bots on top of Cloudflare Workers for free! :rocket:
Home Page: https://beta-discordcf-org.pages.dev
License: Apache License 2.0
Build blazing fast Discord bots on top of Cloudflare Workers for free! 🚀
Contribution is pretty simple. There are many ways of contributing to it:
Licensed under the Apache License 2.0.
These repo is brought to you by these people! Join us on Discord!
Been busy with getting the code refactored in a way that makes it easier for use and to help solve the issue of a large types file. (new ./applications folder with files breaking down the types by category). Also been busy with getting more types/interfaces and objects that implements, and handles more of the discord api when information is received. Will work on getting more done.
Can I use this also with javascript?
Currently if a error is encountered when attempting to setup a command the only info returned is that setup failed on that command as seen here:
https://github.com/alvgaona/cloudflare-discord-bot/blob/7adf8bc5219d5d4109b708e17924b7132c054a7b/src/setup.ts#L91-L99
Provide information from error encountered so its actually possible to debug issues.
Just add the error.message & error.stack to the result. Ideally return a json object with these as fields.
There have been some questions on how to set up the bots and we need to improve documentation on that matter.
The site is being built but we should also consider adding a FAQ section as well as explaining how the flow to install your bot in a given server.
test explaining how testing is done in discordcf.Discord expects a response within 3 seconds, otherwise it fails fails the interaction.
Some other packages support deferring the response while processing is going on, and immediately sends a preliminary response to stop Discord from failing the interaction.
Does this package support such a feature? I could not find it in the source or documentation.
We should not maintain the Discord objects that represent the Discord API. Instead, we should use discord-api-types.
The outcome should be:
discord-api-types types, interfaces, and whatnot.types.ts file.We should add in the project's dependency tree the latest version of discord-api-types.
When trying to do wrangler publish, I get this error:
✘ [ERROR] Could not resolve "cloudflare-discord-bot"
src/Discord/index.js:6:7:
6 │ } from "cloudflare-discord-bot"
╵ ~~~~~~~~~~~~~~~~~~~~~~~~~
You can mark the path "cloudflare-discord-bot" as external to exclude it from
the bundle, which will remove this error.
This is not the case with @glenstack/cf-workers-discord-bot package.
wrangler publish0.0.1 (latest)
Chrome
No response
Documentation on functions similar to other Discord Libraries.
Docs in production which can be used to find functions or how certain functions work.
Software such as WikiJS or Docasasaurus, etc.
index.ts imports helloHanlder instead of helloHandler
Install this per README instructions
0.0.1 (latest)
Microsoft Edge
none, it cannot compileI was wondering if it would be possible for you to make a cloudflare-revolt-bot project
https://developers.revolt.chat/stack/revolt.js/guide/overview
framework to make revolt bots using cloudflare workers
https://developers.revolt.chat/stack/revolt.js/guide/discord_js_migration
I'd like to be able to use this framework in a function in Cloudflare Pages, or potentially host multiple bots on the same worker. This requires adjusting the base path in the bot router, which currently isn't possible.
createApplicationCommandHandler should have an optional argument allowing the user to specify the base path, such as the path of their Cloudflare function.
(This could be an optional field in Application, an argument directly to createApplicationCommandHandler, whichever.)
The itty router should be called with e.g. const router = Router({ base: basePath }); inside createApplicationCommandHandler (and not be module-scoped).
Git hooks are pretty useful. We should look into husky.
We should be able to configure hooks for the following tasks:
Follow this documentation.
Currently a InteractionHandler function only gets passed the interaction object.
Ideally it would also be possible to access the environment variables by supporting passing in the env as a optional arg to applicationCommandHandler alongside the request as when using modules env variables are no longer global re https://blog.cloudflare.com/workers-javascript-modules/
Be able to access env variables as a argument provided to InteractionHandlers
This would look something like this (simplified example):
export default {
fetch: async (req: Request, env: EnvInterface) => applicationCommandHandler(req, env),
};And this for a InteractionHandler:
const helloHandler: InteractionHandler = async (interaction, env: EnvInterface) => {}The EnvInterface type is a defined type that is used by both pieces of code.
At the time of the writing, we don't have a good way to run integration tests or any other kind of tests in this project. We should focus on finding a good way to test out all the code layers.
I believe we should look for adding:
We need further investigation. Will update the description.
Discord release not long ago the possibility to add components to the messages. For more information, take a look at the Discord Developer Portal - Message Components.
This framework should certainly allow easy development of message components as it does for application commands.
The message components should be handled the same way as the application commands do.
The Application type and the createApplicationCommandHandler should support components in them.
Is there a way to make them?
I'm not sure if is because I don't have ssh access or it just needs the dist folder to be committed to work.
After forking and committing the dist folder everything works like charms, thanks!
No response
0.0.1 (latest)
No response
No response
A JS guide for this
Will be useful
The example TS code will be also in JS
After installing this module with the install command, I tried using the example provided in the README, but it didn't work here:
type ApplicationCommandHandler
I get a typescript error saying: '"cloudflare-discord-bot"' has no exported member named 'ApplicationCommandHandler'. Did you mean 'createApplicationCommandHandler'?
I am using version 0.0.4
No response
0.0.1 (latest)
No response
No response
At the moment this framework supports only a few Discord API resources such as Interactions and a few others.
The purpose of this issue is to track all of those to see what's been implemented, and left to implement.
As a framework to build Discord bots using Cloudflare Workers, we'd like to also provide an intuitive API to enhance the developer experience. This means hiding the low-level details that Discord API and Cloudflare Workers bring to the table. Ideally, you should be able to focus on your bot and nothing else than your bot—you'll also need to interact with other Cloudflare and external services if needed, but that's your job.
It's important to note that if it's not implemented by us, you could still call Discord API directly by just making a request with the proper parameters.
It's not updated
Go on https://www.npmjs.com/package/cloudflare-discord-bot and see, it says 7 bmonths ago also if you made a commit 10 days ago on github
0.0.1 (latest)
No response
No response
Having test bots to create E2E smoke tests is a good idea. For that, we need to deploy some bots.
Reference: https://github.com/marketplace/actions/deploy-to-cloudflare-workers-with-wrangler
A Github Actions workflow shall be created, which will create a Cloudflare worker in the discordcf account.
We should have the following use cases:
push event is registered in the main branch, the Worker will be published to the test environment.Currently all the types used in this project are manfully written and need to be maintained by this project.
There is a npm library with TS support for discord api types called discord-api-types. This contains both typescript definitions and actual values and is updated inline with the discord api.
Note the currently this projects types are outdated.
Ideally this project should switch to using this library for types.
Just swap existing types with those from the library.
I would be happy to work on a PR to implemented the requested changes.
https://github.com/alvgaona/cloudflare-discord-bot/blob/7adf8bc5219d5d4109b708e17924b7132c054a7b/src/authorize.ts#L13-L16
301 redirects are permanent and browsers will hard cache them to the point of not even touching the origin when encountering that url again. This means that if the bot client id changes its impossible for clients to get the new id without manually clearing browser data (and even then that sometimes wont work).
Instead you should use 302
Create a bot, publish the worker and go to its base url, change the bot's client id/recreate it, go to its base url and get the wrong client id.
0.0.1 (latest)
Chrome
No response
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.