1.1.0 • Published 3 years ago

discord-formatter v1.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

discord-formatter

A package that lets you easily do Discord message formatting.

All formats were sourced from here.

Documentation

formatChannel

ParameterTypeOptionalDefaultDescription
idSnowflakenononeThe channel's ID

Returns: <#${Snowflake}>, aka string

formatEmoji

ParameterTypeOptionalDefaultDescription
namestringnononeThe emoji's name
idSnowflakenononeThe emoji's ID
animatedbooleanyesfalseWhether the emoji is animated or not

Returns: <:${string}:${Snowflake}> for normal emojis and <a:${string}:${Snowflake}> for animated emojis, aka string

formatRole

ParameterTypeOptionalDefaultDescription
idSnowflakenononeThe role's ID

Returns: <@&${Snowflake}>, aka string

formatTimestamp

ParameterTypeOptionalDefaultDescription
dateDate | numbernononeThe Date for that timestamp, or a UNIX timestamp (in seconds)
styleTimestampStyleyesTimestampStyle.ShortDateTimeThe timestamp's display style

Returns: <t:${number}:${ShortTimestampStyle}>, aka string

formatUser

ParameterTypeOptionalDefaultDescription
idSnowflakenononeThe user's ID
hasNicknamebooleanyesfalseWhether the user has a nickname or not

Returns: <@${Snowflake}> for users without a nickname, <@!${Snowflake}> for users with a nickname, aka string

TimestampStyle

enum TimestampStyle {
    ShortTime = 'SHORT_TIME',
    LongTime = 'LONG_TIME',
    ShortDate = 'SHORT_DATE',
    LongDate = 'LONG_DATE',
    ShortDateTime = 'SHORT_DATE_TIME',
    LongDateTime = 'LONG_DATE_TIME',
    RelativeTime = 'RELATIVE_TIME',
}

ShortTimestampStyle

type ShortTimestampStyle = 't' | 'T' | 'd' | 'D' | 'f' | 'F' | 'R';

Snowflake

Discord's ID format.

type Snowflake = `${bigint}`; // aka string

Contributing

Code of Conduct

The code of conduct is described in CODE_OF_CONDUCT.md.

Development Process

All changes happen through pull requests. They're the best way to propose changes. We welcome your pull requests and after we review them, they can be merged into the project.

Standard Commit Messages

This project is using the conventional commits standard.
Please follow these steps to ensure your commit messages are standardized.

Pull Requests

  1. Fork the repository and create a new branch.
  2. Add your code (and tests if required).
  3. Describe the PR and open it.