dpaste-ts
Nodejs wrapper for dpaste.com written using Typescript. Creates & Gets pastes anonymously.
Now with Authentication support!
Usage
The functions are promise based. Use them inside async functions or you may use .then().catch().
All functions have an internal delay of 1 second. This is to prevent abuse of dpaste.com API
Disable delay
Set the environment variable as follows -
DPASTE_DISABLE_DELAY = trueNote: if the rate of requests exceeds 1 request per second, then you will be blocked from API to create new pastes. Same applies for reading pastes.
Authentication
Read more here under Authentication section.
Generate an API token key from your dashboard.
Set it into your environment with the variable name as DPASTE_API_TOKEN
Import
const { createPaste, getRawPaste } = require('dpaste-ts'); // in CJS style
import { createPaste, getRawPaste } from 'dpaste-ts'; // in ESM styleCreate Paste
Returns URL of dpaste.
There are 5 arguments:
| Arguments | Type | Range/Limit | Default values | Required? |
|---|---|---|---|---|
| content | string | 250,000 bytes |
Not Applicable | true |
| title | string | First 100 characters | date & time of paste creation in UTC | false |
| syntax | string | Check here | 'text' |
false |
| expiry_days | number |
1 to 365
|
7 |
false |
| APIToken | string | Not Applicable | Value set in environment variable DPASTE_API_TOKEN or undefined
|
false |
When inside async function:
const options = {
content: 'sample input',
title: 'sample title',
syntax: 'text',
expiry_days: 10,
};
// Will return dpaste link when successful
let url = await createPaste(options);
console.log(url);Using .then()
// Will return dpaste link to console
createPaste(options).then(console.log);Get Raw Paste
Returns Raw data of dpaste.
There are 2 arguments:
| Arguments | Type | Required? |
|---|---|---|
| url/id | string | true |
| APIToken | string | false |
You can either provide complete URL of the dpaste or the ID of the paste.
When inside async function:
// Will return "sample input" as raw data
let rawData = await getRawPaste(url);
console.log(rawData);Using .then()
// Will return raw data to console
getRawPaste(url).then(console.log);Complete example
const { createPaste, getRawPaste } = require('dpaste-ts');
const options = {
content: 'sample input',
title: 'sample title',
syntax: 'text',
expiry_days: 10,
APIToken: 'qwerty12345ag',
};
// This will set the API token into environment variable
process.env.DPASTE_API_TOKEN = options.APIToken;
// This will **not** disable internal delay of 1 second. Set it to true if you wish to disable it.
process.env.DPASTE_DISABLE_DELAY = 'false';
// Use the below code snippet inside async functions to get the data.
// Will return dpaste link when successful
let url = await createPaste(options);
console.log(url);
// Will return "sample input" as raw data
let rawData = await getRawPaste(url);
console.log(rawData);
// Use the below snippets if you wish to use .then()
// Put .catch() to catch any potential errors
// Will return dpaste link to console
createPaste(options).then(console.log);
// Will return raw data to console
getRawPaste(url).then(console.log);