JSPM

node-dis-file

1.0.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • 0
  • Score
    100M100P100Q24850F
  • License ISC

Allows you to easily upload and retrieve files to/from Discord channels via webhooks.

Package Exports

  • node-dis-file
  • node-dis-file/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (node-dis-file) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

About

Welcome to node-dis-file, a simple Node.js module for uploading and downloading files using Discord Webhooks

node-dis-file is a Node.js package that simplifies file storage via Discord Webhooks. It allows you to send and retrieve files over 20 MB!

Important:

Ensure you are aware of the usage guidelines of Discord webhooks to avoid any misuse.

Features

  • [✅] Upload a file to Discord Webhooks
  • [✅] Supports file splitting to avoid Discord Limits
  • [✅] No API-Key required
  • [✅] 100MB Tested
  • [✅] Upload ReadableStream
  • [✅] Download as file
  • [✅] Download as buffer

Installation

npm install node-dis-file

Examples

Uploading

Here is an example of how to upload a file using file path.

const { DisFile } = require("node-dis-file");

const myWebhookURL = "https://discord.com/api/webhooks/webhook_id/webhook_token";
const disFile = new DisFile(myWebhookURL);

const filePath = "./testfile.pdf";

const fileDetails = await disFile.uploadFile(filePath, "testfile.pdf");
console.log(fileDetails);  // Logs the file details from the webhook response

Here is an example of how to upload a file using read stream.

const { DisFile, Utils } = require("node-dis-file")

const myWebhookURL = "https://discord.com/api/webhooks/webhook_id/webhook_token";
const disFile = new DisFile(myWebhookURL);

const response = await axios.get('https://example.com/image.jpg', { responseType: 'arraybuffer' });

// Convert the response data into a buffer
const imageBuffer = Buffer.from(response.data);
const readable = Utils.createChunkedStream(imageBuffer);

const fileDetails = await disFile.uploadFileStream(readable, "MyUploadedImage.jpg")
console.log(fileDetails)

This is how the output looks like

{
  primaryID: '1322358044503314546',
  fileName: 'MyUploadedImage.jpg',
  fileChunkIDs: [
    '1322358033661038643', // 20 MB
    '1322358038149070859',  // 20 MB
    '1322358044008644681'  // 4.5 MB
  ]
}

Downloading

Here is an example of how to download a file, file as output.

const { DisFile } = require("node-dis-file")

const myWebhookURL = "https://discord.com/api/webhooks/webhook_id/webhook_token";
const disFile = new DisFile(myWebhookURL);

const filePrimaryID = "1322358044503314546"; // ID gotten from the uploads
const downloadedFile = await disFile.downloadFile(filePrimaryID, "merged.jpg");
console.log(downloadedFile); // Image saved successfully

Here is an example of how to download a file, buffer as output.

const { DisFile } = require("node-dis-file")

const myWebhookURL = "https://discord.com/api/webhooks/webhook_id/webhook_token";
const disFile = new DisFile(myWebhookURL);

const filePrimaryID = "1322358044503314546"; // ID gotten from the uploads
const downloadedFile = await disFile.downloadFileBuffer(filePrimaryID); // Returns a buffer of the file
// Do whatever you want with the buffer.

Contributing

Feel free to contribute! Whether you're fixing a bug, adding a feature, or improving documentation, your contributions are always welcome.