Utils

@lunibee/utils provides a small set of general-purpose helpers.

Import

TypeScript

import { sleep, randomInt, isSnowflake } from "lunibee";
// or from the sub-package:
import { sleep, randomInt, isSnowflake } from "@lunibee/utils";

JavaScript

import { sleep, randomInt, isSnowflake } from "lunibee";
// or from the sub-package:
import { sleep, randomInt, isSnowflake } from "@lunibee/utils";

---

sleep(ms)

Returns a Promise that resolves after ms milliseconds.

TypeScript

async function delayedGreet(channel, name: string) {
  await channel.send({ content: `Hey ${name}, starting up...` });
  await sleep(2000); // wait 2 seconds
  await channel.send({ content: "Ready! 🐝" });
}

JavaScript

async function delayedGreet(channel, name) {
  await channel.send({ content: `Hey ${name}, starting up...` });
  await sleep(2000); // wait 2 seconds
  await channel.send({ content: "Ready 🐝" });
}

Signature:

TypeScript

function sleep(ms: number): Promise<void>

JavaScript

function sleep(ms)

---

randomInt(min, max)

Returns a random integer in the inclusive range [min, max].

TypeScript

const roll = randomInt(1, 6); // dice roll: 1–6
const item = items[randomInt(0, items.length - 1)];

JavaScript

const roll = randomInt(1, 6); // dice roll: 1–6
const item = items[randomInt(0, items.length - 1)];

Signature:

TypeScript

function randomInt(min: number, max: number): number

JavaScript

function randomInt(min, max)

---

isSnowflake(value)

Returns true if the string is a valid Discord snowflake (1–20 digit numeric string).

TypeScript

isSnowflake("123456789012345678")  // → true
isSnowflake("not-a-snowflake")     // → false
isSnowflake("99999999999999999999") // → true (20 digits)

JavaScript

isSnowflake("123456789012345678")  // → true
isSnowflake("not-a-snowflake")     // → false
isSnowflake("99999999999999999999") // → true (20 digits)

Signature:

TypeScript

function isSnowflake(value: string): boolean

JavaScript

function isSnowflake(value)

---

Examples

Validate user input before fetching

TypeScript

client.on("messageCreate", async (message) => {
  if (!message.content.startsWith("!user ")) return;
  const id = message.content.slice(6).trim();
  if (!isSnowflake(id)) {
    return message.reply("Invalid user ID.");
  }
  const user = await client.users.fetch(id);
  await message.reply(`Found: ${user.displayName}`);
});

JavaScript

client.on("messageCreate", async (message) => {
  if (!message.content.startsWith("!user ")) return;
  const id = message.content.slice(6).trim();
  if (!isSnowflake(id)) {
    return message.reply("Invalid user ID.");
  }
  const user = await client.users.fetch(id);
  await message.reply(`Found: ${user.displayName}`);
});

Rate-limit friendly bulk operation with delay

TypeScript

async function sendAll(channels: Channel[], content: string) {
  for (const channel of channels) {
    await channel.send({ content });
    await sleep(500); // 500ms between each send to avoid rate limits
  }
}

JavaScript

async function sendAll(channels , content) {
  for (const channel of channels) {
    await channel.send({ content });
    await sleep(500); // 500ms between each send to avoid rate limits
  }
}

Random pick from a list

TypeScript

const jokes = ["Why do bees hum? Because they don't know the words. 🎵", "What do you call a bee that can't make up its mind? A maybee! 🐝"];
const joke = jokes[randomInt(0, jokes.length - 1)];
await channel.send({ content: joke });

JavaScript

const jokes = ["Why do bees hum? Because they don't know the words. 🎵", "What do you call a bee that can't make up its mind? A maybee 🐝"];
const joke = jokes[randomInt(0, jokes.length - 1)];
await channel.send({ content: joke });