Security News
ESLint is Now Language-Agnostic: Linting JSON, Markdown, and Beyond
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
@spectacles/rest
Advanced tools
A REST router and ratelimiter for the Discord API. Supports local and distributed ratelimit handling; as such, requests are not sent in order.
const { Rest } = require('@spectacles/rest');
const rest = new Rest('token here');
rest.get(`/channels/${someID}`).then(console.log);
The rest instance has the following methods:
get
patch
put
delete
post
PATCH, PUT, and POST take the request body as the second parameter. All methods take options as the last parameter: options are just an extension of the Fetch API init
parameters.
interface File {
name: string;
file: string | Buffer | NodeJS.ReadableStream;
}
interface Request extends RequestInit {
files?: File | File[];
reason?: string;
endpoint?: string;
}
For example, you could create a guild ban like so:
rest.put(`/guilds/${guildID}/bans/${userID}`, {}, { reason: 'bad memes' });
All REST calls resolve with the JSON parsed response from the Discord API or a Buffer if the Discord API did not send JSON. The library will attempt to retry all ratelimited or 5xx errors up to the retryLimit
specified in the Rest constructor options.
enum TokenType {
BOT = 'Bot',
BEARER = 'Bearer',
}
interface Options {
tokenType: TokenType,
base: string,
version: number,
agent: https.Agent,
ua: string,
mutex: RatelimitMutex,
retryLimit: number,
}
By default, the library uses a built-in local ratelimiter. To use the built-in Redis ratelimiter:
const { RedisMutex, Rest } = require('@spectacles/rest');
const Redis = require('ioredis');
const redis = new Redis();
const rest = new Rest('token', {
mutex: new RedisMutex(redis, 'optional key prefix'),
});
// use rest normally
You can use anything as a mutex that fulfills the RatelimitMutex
interface.
FAQs
The Discord REST client library.
We found that @spectacles/rest demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
Security News
Members Hub is conducting large-scale campaigns to artificially boost Discord server metrics, undermining community trust and platform integrity.
Security News
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.