wv3-discord.js 1.0.0

package/.wv3/discord-bot.json

@@ -0,0 +1,6 @@
+{
+  "token": "abc123",
+  "id": "999",
+  "guild": "777",
+  "savedAt": "2026-03-21T12:55:23.884Z"
+}

package/README.md

@@ -0,0 +1,45 @@
+# wv3-discord.js
+
+`wv3-discord.js` is a small Discord API library with a `discord.js`-inspired API.
+
+It does not depend on `discord.js`.
+
+Instead, it provides a focused compatibility layer for common bot patterns:
+
+- websocket-backed `Client` and `WV3Client`
+- `REST` and `Routes`
+- `Collection`
+- `GatewayIntentBits` and `Events`
+- `SlashCommandBuilder`, `EmbedBuilder`, and `AttachmentBuilder`
+
+## Install
+
+```bash
+npm install wv3-discord.js
+```
+
+## Usage
+
+```js
+const {
+  WV3Client,
+  GatewayIntentBits
+} = require("wv3-discord.js");
+
+const client = new WV3Client({
+  intents: [GatewayIntentBits.Guilds]
+});
+
+client.once("ready", () => {
+  console.log(`Logged in as ${client.user.tag}`);
+});
+
+client.start(process.env.DISCORD_TOKEN);
+```
+
+## API notes
+
+- `WV3Client` extends this package's local `Client`.
+- `createClient(options)` returns a new `WV3Client`.
+- `client.start(token)` is an alias for `client.login(token)`.
+- The current goal is practical compatibility for common slash-command bot flows, not a full one-to-one reimplementation of every `discord.js` feature.

package/index.d.ts

@@ -0,0 +1,212 @@
+/// <reference types="node" />
+
+import { EventEmitter } from "events";
+
+export interface ClientOptions {
+    intents?: number[] | number;
+    rest?: {
+        version?: string;
+        api?: string;
+    };
+}
+
+export interface RESTRequestOptions {
+    body?: unknown;
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | boolean | null | undefined>;
+    auth?: boolean;
+}
+
+export declare class DiscordHTTPError extends Error {
+    readonly status: number;
+    readonly data: unknown;
+}
+
+export declare class REST {
+    constructor(options?: { version?: string; api?: string });
+    setToken(token: string): this;
+    request(method: string, route: string, options?: RESTRequestOptions): Promise<any>;
+    get(route: string, options?: Omit<RESTRequestOptions, "body">): Promise<any>;
+    post(route: string, options?: RESTRequestOptions): Promise<any>;
+    put(route: string, options?: RESTRequestOptions): Promise<any>;
+    patch(route: string, options?: RESTRequestOptions): Promise<any>;
+    delete(route: string, options?: RESTRequestOptions): Promise<any>;
+}
+
+export declare class Collection<K, V> extends Map<K, V> {
+    first(): V | undefined;
+    map<T>(fn: (value: V, key: K, collection: Collection<K, V>) => T): T[];
+    filter(fn: (value: V, key: K, collection: Collection<K, V>) => boolean): Collection<K, V>;
+    find(fn: (value: V, key: K, collection: Collection<K, V>) => boolean): V | undefined;
+    toJSON(): V[];
+}
+
+export declare class EmbedBuilder {
+    constructor(data?: Record<string, unknown>);
+    setTitle(value: string): this;
+    setDescription(value: string): this;
+    setURL(value: string): this;
+    setColor(value: number): this;
+    setTimestamp(value?: string | number | Date): this;
+    setImage(value: string): this;
+    setThumbnail(value: string): this;
+    setFooter(value: { text: string; icon_url?: string }): this;
+    setAuthor(value: { name: string; icon_url?: string; url?: string }): this;
+    addFields(...fields: Array<{ name: string; value: string; inline?: boolean } | Array<{ name: string; value: string; inline?: boolean }>>): this;
+    toJSON(): Record<string, unknown>;
+}
+
+export declare class AttachmentBuilder {
+    constructor(attachment: unknown, options?: { name?: string; description?: string });
+    setName(name: string): this;
+    setDescription(description: string): this;
+}
+
+export interface CommandOptionChoice {
+    name: string;
+    value: string | number;
+}
+
+export interface CommandOptionData {
+    type: number;
+    name?: string;
+    description?: string;
+    required?: boolean;
+    min_value?: number;
+    max_value?: number;
+    choices?: CommandOptionChoice[];
+    options?: CommandOptionData[];
+}
+
+export declare class SlashCommandOptionBuilder {
+    setName(name: string): this;
+    setDescription(description: string): this;
+    setRequired(required?: boolean): this;
+    setMinValue(value: number): this;
+    setMaxValue(value: number): this;
+    addChoices(...choices: CommandOptionChoice[]): this;
+    toJSON(): CommandOptionData;
+}
+
+export declare class SlashCommandSubcommandBuilder {
+    setName(name: string): this;
+    setDescription(description: string): this;
+    addStringOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addIntegerOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addNumberOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addBooleanOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addAttachmentOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    toJSON(): CommandOptionData;
+}
+
+export declare class SlashCommandBuilder {
+    setName(name: string): this;
+    setDescription(description: string): this;
+    addStringOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addIntegerOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addNumberOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addBooleanOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addUserOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addChannelOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addRoleOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addMentionableOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addAttachmentOption(builder: (option: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    addSubcommand(builder: (option: SlashCommandSubcommandBuilder) => SlashCommandSubcommandBuilder): this;
+    toJSON(): { name?: string; description?: string; options?: CommandOptionData[] };
+}
+
+export declare class User {
+    id: string | null;
+    username: string;
+    discriminator: string;
+    avatar: string | null;
+    bot: boolean;
+    globalName: string | null;
+    readonly tag: string;
+}
+
+export declare class Message {
+    id: string | null;
+    content: string;
+    channelId: string | null;
+    author: User | null;
+}
+
+export declare class CommandInteractionOptionResolver {
+    getSubcommand(required?: boolean): string | null;
+    getAttachment(name: string, required?: boolean): any;
+    getInteger(name: string, required?: boolean): number | null;
+    getNumber(name: string, required?: boolean): number | null;
+    getString(name: string, required?: boolean): string | null;
+    getBoolean(name: string, required?: boolean): boolean | null;
+}
+
+export declare class ChatInputCommandInteraction {
+    readonly client: Client;
+    readonly commandName: string | null;
+    readonly user: User | null;
+    readonly deferred: boolean;
+    readonly replied: boolean;
+    readonly options: CommandInteractionOptionResolver;
+    isChatInputCommand(): boolean;
+    reply(payload: Record<string, unknown> | string): Promise<this>;
+    deferReply(payload?: Record<string, unknown>): Promise<this>;
+    editReply(payload: Record<string, unknown> | string): Promise<Message>;
+    followUp(payload: Record<string, unknown> | string): Promise<Message>;
+}
+
+export declare class TextChannel {
+    readonly id: string | null;
+    isTextBased(): boolean;
+    send(payload: Record<string, unknown> | string): Promise<Message>;
+}
+
+export declare class Client extends EventEmitter {
+    constructor(options?: ClientOptions);
+    readonly rest: REST;
+    readonly channels: {
+        fetch(id: string): Promise<TextChannel>;
+    };
+    commands: Collection<string, any>;
+    user: User | null;
+    login(token?: string): Promise<string>;
+    destroy(): Promise<void>;
+    isReady(): boolean;
+}
+
+export declare class WV3Client extends Client {
+    readonly brand: string;
+    readonly packageName: string;
+    wv3: {
+        token: string | null;
+        id: string | null;
+        guild: string | null;
+    };
+    constructor(options?: ClientOptions);
+    setWV3Config(options?: {
+        token?: string;
+        id?: string;
+        clientId?: string;
+        guild?: string;
+        guildId?: string;
+    }): this;
+    initWV3(options?: {
+        token?: string;
+        id?: string;
+        clientId?: string;
+        guild?: string;
+        guildId?: string;
+    }): Promise<this>;
+    start(token?: string): Promise<string>;
+}
+
+export declare function createClient(options?: ClientOptions): WV3Client;
+
+export declare const GatewayIntentBits: Readonly<Record<string, number>>;
+export declare const Events: Readonly<Record<string, string>>;
+export declare const InteractionType: Readonly<Record<string, number>>;
+export declare const ApplicationCommandOptionType: Readonly<Record<string, number>>;
+export declare const MessageFlags: Readonly<Record<string, number>>;
+export declare const Routes: Readonly<Record<string, (...args: string[]) => string>>;
+export declare const brand: "wv3-discord.js";
+export declare const version: "1.0.0";

package/index.js

@@ -0,0 +1,53 @@
+const { Client, WV3Client, createClient } = require("./src/WV3Client");
+const { REST, DiscordHTTPError } = require("./src/rest/REST");
+const { Routes } = require("./src/rest/Routes");
+const { Collection } = require("./src/utils/Collection");
+const {
+    GatewayIntentBits,
+    Events,
+    InteractionType,
+    ApplicationCommandOptionType,
+    MessageFlags
+} = require("./src/utils/Constants");
+const { EmbedBuilder } = require("./src/builders/EmbedBuilder");
+const { AttachmentBuilder } = require("./src/builders/AttachmentBuilder");
+const {
+    SlashCommandBuilder,
+    SlashCommandOptionBuilder,
+    SlashCommandSubcommandBuilder
+} = require("./src/builders/SlashCommandBuilder");
+const { User, ClientUser } = require("./src/structures/User");
+const { Message } = require("./src/structures/Message");
+const { TextChannel } = require("./src/structures/Channel");
+const {
+    ChatInputCommandInteraction,
+    CommandInteractionOptionResolver
+} = require("./src/structures/Interaction");
+
+module.exports = {
+    Client,
+    WV3Client,
+    createClient,
+    REST,
+    Routes,
+    Collection,
+    GatewayIntentBits,
+    Events,
+    InteractionType,
+    ApplicationCommandOptionType,
+    MessageFlags,
+    EmbedBuilder,
+    AttachmentBuilder,
+    SlashCommandBuilder,
+    SlashCommandOptionBuilder,
+    SlashCommandSubcommandBuilder,
+    User,
+    ClientUser,
+    Message,
+    TextChannel,
+    ChatInputCommandInteraction,
+    CommandInteractionOptionResolver,
+    DiscordHTTPError,
+    version: "1.0.0",
+    brand: "wv3-discord.js"
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "wv3-discord.js",
+  "version": "1.0.0",
+  "description": "A lightweight Discord API client with a discord.js-inspired API.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "type": "commonjs",
+  "keywords": [
+    "discord",
+    "discord.js",
+    "bot",
+    "wrapper",
+    "wv3"
+  ],
+  "author": "",
+  "license": "MIT",
+  "scripts": {
+    "savor": "node scripts/discord-savor.js",
+    "smoke": "node scripts/smoke.js"
+  },
+  "dependencies": {
+    "axios": "^1.13.6",
+    "discord.js": "^14.25.1"
+  }
+}