Installation

Install the package using npm:

npm install djs-helpers

Then import it in your code:

const { embeds, buttons, send, reply, timestamps } = require('djs-helpers');

Message Sending

Send messages easily with automatic context detection for both regular messages and interactions.

Basic Usage

// For messages
send(message, { content: "Hello!" });
reply(message, { content: "This is a reply" });

// For interactions
send(interaction, { content: "Hello!" });
reply(interaction, { 
    content: "This is a hidden reply",
    hide: true 
});

Combined Usage

// With embeds and buttons
send(message, {
    content: "Welcome!",
    embed: embeds.generate({
        title: "My Embed",
        description: "Click the button below"
    }),
    component: buttons.generate({
        label: "Click Me",
        id: "click-btn",
        style: "PRIMARY"
    })
});

All Options

• content - Text content of the message
• embed - Single embed object
• embeds - Array of embed objects
• component - Single component (like a button)
• components - Array of components
• file - Single file attachment
• files - Array of file attachments
• attachment - Single Discord attachment
• attachments - Array of Discord attachments
• hide - (Interactions only) Whether the reply should be hidden

Introduction

A simple package to create Discord.js embeds and buttons with ease.

const { embeds, buttons } = require('djs-helpers');

Embeds Helper

Create embeds easily with a simple object structure.

Basic Usage

const myEmbed = embeds.generate({
    title: 'My Embed',
    description: 'This is a description',
    color: 'RED'
});

All Options

• title - Embed title (max 256 characters)
• description - Embed description (max 4096 characters)
• color - Embed color (name, hex, or decimal)
• timestamp - Add current timestamp if true
• footerText - Footer text
• footerIcon - Footer icon URL
• authorName - Author name
• authorIcon - Author icon URL
• thumbnail - Thumbnail image URL
• image - Main image URL
• fields - Array or object of fields

Fields Example

// Array format
fields: [
    ['Field Name', 'Field Value', true], // inline
    ['Another Field', 'Another Value', false] // not inline
]

// Object format
fields: {
    1: ['Field Name', 'Field Value', true],
    2: ['Another Field', 'Another Value', false]
}

Embed Example

Buttons Helper

Create buttons with automatic action row wrapping.

Basic Usage

const myButton = buttons.generate({
    id: 'my-button',
    label: 'Click Me',
    style: 'PRIMARY'
});

All Options

• id - Button custom ID (required for non-link buttons)
• label - Button text (max 80 characters)
• style - Button style (PRIMARY/BLUE, SECONDARY/GREY, SUCCESS/GREEN, DANGER/RED, LINK)
• disabled - Whether the button is disabled
• emoji - Button emoji
• url - URL for link buttons

Link Button Example

const linkButton = buttons.generate({
    label: 'Visit Website',
    style: 'LINK',
    url: 'https://example.com'
});

Button Example

Timestamps Helper

Generate Discord timestamps easily.

Basic Usage

const timestamp = timestamps.generate('02/13/2025', 'SHORT_DATE');

All Formats

• SHORT_DATE - Short date format (e.g., 02/13/2025)
• LONG_DATE - Long date format (e.g., February 13, 2025)
• SHORT_TIME - Short time format (e.g., 1:11 PM)
• LONG_TIME - Long time format (e.g., 1:11:00 PM)
• SHORT_DATE_TIME - Short date and time format (e.g., 02/13/2025 1:11 PM)
• LONG_DATE_TIME - Long date and time format (e.g., February 13, 2025 1:11 PM)
• RELATIVE - Relative time format (e.g., in 2 days)

Color Support

Colors can be specified in multiple formats:

• Named colors (e.g., 'RED', 'BLUE', 'GREEN')
• Hex colors (e.g., '#FF0000')
• Decimal numbers (e.g., 16711680)