@wrldent/better-discordjs

A production-ready kernel for Discord bot projects.

Included modules:

• Sessions: create/update/delete bot profile sessions (JSON persistence)
• REST Logs: structured REST request logging with redaction
• discordjs-security: optional adapter wrapper (loads only if installed)
• scripts: hook registry for *-hook.js and *-hook.min.js

Install

npm i @wrldent/better-discordjs

Quick start (kernel)

const { BetterDiscordJs } = require("@wrldent/better-discordjs");

const bdj = new BetterDiscordJs({
  sessions: { storagePath: "./.bdj/sessions.json" },
  restLogs: { logsDir: "./.bdj/rest-logs", redactKeys: ["token", "authorization"] },
  scripts: { scriptsDir: "./scripts" }
});

(async () => {
  await bdj.init(); // scans hooks (safe if scripts dir missing)

  await bdj.sessions.create("bot-1", { id: "123", name: "MyBot", token: "SECRET" });

  await bdj.rest.logRequest({
    label: "login",
    method: "POST",
    url: "https://discord.com/api/v10/oauth2/token",
    headers: { authorization: "Bot SECRET" },
    body: { token: "SECRET" },
    status: 200,
    durationMs: 120
  });

  await bdj.hooks.runHooks("login", { botId: "bot-1" });
})();

Hook rules

• *-hook.min.js → registered as a datafile (not executed)
• *-hook.js → registered as executable (exports a function or { run() })

Examples:

• login-hook.js => hook name login
• guildCreate-hook.min.js => hook name guildCreate

Exports

const pkg = require("@wrldent/better-discordjs");

pkg.BetterDiscordJs   // kernel
pkg.Sessions          // module group
pkg.RestLogs          // module group
pkg.Scripts           // module group
pkg.Security          // module group

Publish notes

This package is scoped and configured for public publishing:

• name: @wrldent/better-discordjs
• publishConfig.access: public

Publish:

npm login
npm publish --access public