@arox/framework 0.1.0 → 0.1.2-beta.1

package/dist/structures/builder/Builder.d.ts

@@ -0,0 +1,19 @@
+import { SlashCommandBuilder, RESTPostAPIChatInputApplicationCommandsJSONBody } from "discord.js";
+import { Client } from "../core";
+export interface ApplicationJSONBody extends RESTPostAPIChatInputApplicationCommandsJSONBody {
+    prefix_support: boolean;
+    slash_support: boolean;
+    aliases: string[];
+}
+export declare class ApplicationCommandBuilder extends SlashCommandBuilder {
+    constructor();
+    protected prefix_support: boolean;
+    protected slash_support: boolean;
+    protected aliases: string[];
+    setAliases(...alias: string[]): this;
+    addAliases(...alias: string[]): this;
+    setPrefixSupport(support: boolean): this;
+    setSlashSupport(support: boolean): this;
+    toJSON(): ApplicationJSONBody;
+    toClientJSON(_client: Client): ReturnType<ApplicationCommandBuilder["toJSON"]>;
+}

package/dist/structures/builder/Command.d.ts

@@ -0,0 +1,21 @@
+import { ChatInputCommandInteraction, Message } from "discord.js";
+import { Context, Client } from "../index";
+import { MaybePromise } from "#types/extra.js";
+import { Logger } from "../../utils/index";
+import { ApplicationCommandBuilder } from "./Builder";
+type MessageContext = NonNullable<ReturnType<Context<Message>["toJSON"]>>;
+type InteractionContext = NonNullable<ReturnType<Context<ChatInputCommandInteraction>["toJSON"]>>;
+export declare class CommandBuilder {
+    #private;
+    readonly data: ApplicationCommandBuilder;
+    readonly client: Client;
+    readonly logger: Logger;
+    _onMessage?: (ctx: MessageContext) => MaybePromise<void>;
+    _onInteraction?: (ctx: InteractionContext) => MaybePromise<void>;
+    get supportsSlash(): false | ((ctx: InteractionContext) => MaybePromise<void>) | undefined;
+    get supportsPrefix(): false | ((ctx: MessageContext) => MaybePromise<void>) | undefined;
+    constructor(data: ApplicationCommandBuilder);
+    onMessage(func: (ctx: MessageContext) => MaybePromise<void>): this;
+    onInteraction(func: (ctx: InteractionContext) => MaybePromise<void>): this;
+}
+export {};

package/dist/structures/{Context.d.ts → builder/Context.d.ts}

@@ -1,5 +1,6 @@
-import { Message, User, ChatInputCommandInteraction } from "discord.js";
-import { Client } from "../structures/Client";
+import { Message, User, ChatInputCommandInteraction, Locale } from "discord.js";
+import { Client } from "../index";
+import { TOptions } from "i18next";
 type ContextPayload<T extends ChatInputCommandInteraction | Message> = T extends ChatInputCommandInteraction ? {
     interaction: T;
     args?: string[];
@@ -11,14 +12,19 @@ export declare class Context<T extends ChatInputCommandInteraction | Message> {
     readonly client: Client;
     readonly args: string[];
     readonly data: T;
+    locale?: `${Locale}`;
     constructor(client: Client, payload: ContextPayload<T>);
     isInteraction(): this is Context<ChatInputCommandInteraction>;
     isMessage(): this is Context<Message>;
     get author(): User | null;
+    t(key: string, options?: TOptions & {
+        defaultValue?: string;
+    }): string;
     toJSON(): {
         kind: "interaction";
         interaction: T;
         author: User | null;
+        t: any;
         message?: undefined;
         args?: undefined;
     } | {
@@ -26,6 +32,7 @@ export declare class Context<T extends ChatInputCommandInteraction | Message> {
         message: Message;
         args: string[];
         author: User | null;
+        t: any;
         interaction?: undefined;
     };
 }

package/dist/structures/{Event.d.ts → builder/Event.d.ts}

@@ -1,19 +1,16 @@
 import { ClientEvents } from "discord.js";
 import { MaybePromise } from "#types/extra.js";
-import { Client } from "./Client";
-import { Logger } from "../utils/logger/Logger";
+import { Client } from "../index";
+import { Logger } from "../../utils/index";
 type EventArgs<K extends keyof ClientEvents> = ClientEvents[K];
 type EventHandler<K extends keyof ClientEvents> = (context: EventBuilder<K>, ...args: EventArgs<K>) => MaybePromise<void>;
 export declare class EventBuilder<K extends keyof ClientEvents> {
+    #private;
     readonly name: K;
     readonly once: boolean;
     readonly client: Client;
     readonly logger: Logger;
-    private handler?;
-    private bound;
-    private readonly listener;
     constructor(name: K, once?: boolean, _handler?: EventHandler<K>);
-    private register;
     onExecute(func: EventHandler<K>): this;
 }
 export {};

package/dist/structures/builder/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./Command";
+export * from "./Context";
+export * from "./Event";
+export * from "./Builder";

package/dist/structures/{Client.d.ts → core/Client.d.ts}

@@ -1,17 +1,19 @@
 import { Client as DiscordClient, Collection, IntentsBitField } from "discord.js";
-import { CommandBuilder } from "./Command";
+import { CommandBuilder } from "../index";
+import { Logger } from "../../utils";
 import { FrameworkOptions } from "#types/client.js";
-import { Logger } from "../utils/logger/Logger";
+import { i18n } from "i18next";
 export declare class Client<Ready extends boolean = boolean> extends DiscordClient<Ready> {
+    #private;
     readonly logger: Logger;
     commands: Collection<string, CommandBuilder>;
     aliases: Collection<string, Set<string>>;
     readonly prefix: string | false;
+    i18n: i18n | undefined;
     options: Omit<FrameworkOptions, "intents"> & {
         intents: IntentsBitField;
     };
     constructor(opts: FrameworkOptions);
-    loadFiles(dir: string): Promise<void>;
-    loadFile(file: string): Promise<void>;
+    login(token?: string): Promise<string>;
     registerCommands(): Promise<void>;
 }

package/dist/structures/core/index.d.ts

@@ -0,0 +1 @@
+export * from "./Client";

package/dist/structures/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core";
+export * from "./builder";

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./util";
+export * from "./Files";
+export * from "./logger/Logger";

package/dist/utils/logger/Logger.d.ts

@@ -3,6 +3,8 @@ import type { Color } from "colorette";
 import { Timestamp } from "@sapphire/timestamp";
 import type { ILogger } from "./ILogger";
 import { LogLevel } from "./ILogger";
+import { LoggerModule } from "i18next";
+export { LogLevel } from "./ILogger";
 export declare class Logger implements ILogger {
     level: LogLevel;
     readonly formats: Map<LogLevel, LoggerLevel>;
@@ -140,3 +142,11 @@ export declare enum LoggerStyleBackground {
     CyanBright = "bgCyanBright",
     WhiteBright = "bgWhiteBright"
 }
+export declare class I18nLoggerAdapter implements LoggerModule {
+    private readonly logger;
+    readonly type = "logger";
+    constructor(logger: Logger);
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}

package/dist/utils/normalizeArray.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Normalizes data that is a rest parameter or an array into an array with a depth of 1.
+ *
+ * @typeParam ItemType - The data that must satisfy {@link RestOrArray}.
+ * @param arr - The (possibly variadic) data to normalize
+ */
+export declare function normalizeArray<ItemType>(arr: RestOrArray<ItemType>): ItemType[];
+/**
+ * Represents data that may be an array or came from a rest parameter.
+ *
+ * @remarks
+ * This type is used throughout builders to ensure both an array and variadic arguments
+ * may be used. It is normalized with {@link normalizeArray}.
+ */
+export type RestOrArray<Type> = Type[] | [Type[]];

package/dist/utils/util.d.ts

@@ -1,4 +1,4 @@
 import { PrefixOptions } from "#types/client.js";
 import { InteractionResponse, Message } from "discord.js";
-export declare function deleteMessage(message: Message | InteractionResponse, time?: number): Promise<void>;
+export declare function deleteMessageAfterSent(message: Message | InteractionResponse, time?: number): Promise<void>;
 export declare function getPrefix(opts: PrefixOptions): string | false;

package/package.json

@@ -1,57 +1 @@
-{
-  "name": "@arox/framework",
-  "version": "0.1.0",
-  "description": "",
-  "keywords": [
-    "discord.js",
-    "framework"
-  ],
-  "homepage": "https://github.com/AroxBot/framework#readme",
-  "bugs": {
-    "url": "https://github.com/AroxBot/framework/issues"
-  },
-  "license": "Apache-2.0",
-  "author": "vrdons",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AroxBot/framework.git"
-  },
-  "type": "commonjs",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "imports": {
-    "#types/*": "./types/*"
-  },
-  "scripts": {
-    "prepare": "node scripts/prepareHusky.js",
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "check": "oxfmt --check && oxlint --type-aware --type-check",
-    "format": "oxfmt",
-    "build:js": "swc src -d dist --strip-leading-paths --copy-files",
-    "build:dts": "tsc --emitDeclarationOnly",
-    "build": "npm run build:js && node ./scripts/actions/patch.js && npm run build:dts",
-    "release:git": "node scripts/actions/github.js",
-    "release:npm": "node scripts/actions/npm.js"
-  },
-  "dependencies": {
-    "@sapphire/timestamp": "^1.0.5",
-    "@swc/helpers": "^0.5.18",
-    "colorette": "^2.0.20",
-    "fast-glob": "^3.3.3",
-    "lodash": "^4.17.21"
-  },
-  "devDependencies": {
-    "@swc/cli": "^0.7.10",
-    "@types/lodash": "^4.17.23",
-    "@types/node": "^25.0.8",
-    "husky": "^9.1.7",
-    "libnpmpack": "^9.0.12",
-    "oxfmt": "^0.24.0",
-    "oxlint": "^1.39.0",
-    "oxlint-tsgolint": "^0.11.0",
-    "typescript": "^5.9.3"
-  },
-  "peerDependencies": {
-    "discord.js": ">=14.25.1"
-  }
-}
+{"name":"@arox/framework","version":"0.1.2-beta.1","description":"","keywords":["arox","discord.js","framework"],"homepage":"https://github.com/AroxBot/framework#readme","bugs":{"url":"https://github.com/AroxBot/framework/issues"},"license":"Apache-2.0","author":"vrdons","contributors":["fhyrox"],"repository":{"type":"git","url":"git+https://github.com/AroxBot/framework.git"},"type":"commonjs","main":"dist/index.js","types":"dist/index.d.ts","imports":{"#types/*":"./types/*"},"dependencies":{"@sapphire/timestamp":"^1.0.5","colorette":"^2.0.20","fast-glob":"^3.3.3","i18next":"^25.8.0"},"peerDependencies":{"discord.js":">=14.25.1"}}

package/types/client.d.ts

@@ -1,9 +1,11 @@
 import { ClientOptions } from "discord.js";
 import { LoggerOptions } from "../src/utils/logger/Logger";
+import { i18n } from "i18next";
 
 export interface FrameworkPaths {
 	events?: string;
 	commands?: string;
+	locales?: string;
 }
 
 export type PrefixOptions =
@@ -14,6 +16,7 @@ export type PrefixOptions =
 export interface FrameworkOptions extends ClientOptions {
 	logger?: LoggerOptions;
 	prefix?: PrefixOptions;
-	paths?: FrameworkPaths;
 	autoRegisterCommands?: boolean;
+	includePaths: string[];
+	i18n?: i18n;
 }

package/cliff.toml

@@ -1,48 +0,0 @@
-[changelog]
-header = """
-# Changelog\n
-All notable changes to this project will be documented in this file.\n
-"""
-body = """
-{% if version %}
-## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}\
-{% else %}\
-## Unreleased\
-{% endif %}
-
-{% for group, commits in commits | group_by(attribute="group") %}\
-### {{ group | upper_first }}
-{% for commit in commits %}
-- {% if commit.breaking %}[**breaking**] {% endif %}{{ commit.message | upper_first }} {% if commit.author.username %}by [@{{ commit.author.username }}](https://github.com/{{ commit.author.username }}){% else %}by {{ commit.author.name }}{% endif %} {% if commit.url %}([{{ commit.id | truncate(length=7, end="") }}]({{ commit.url }})){% else %}({{ commit.id | truncate(length=7, end="") }}){% endif %}\
-{% endfor %}\n
-{% endfor %}
-"""
-trim = true
-footer = """
-<!-- generated by git-cliff -->
-"""
-
-[git]
-conventional_commits = true
-filter_unconventional = true
-split_commits = false
-commit_preprocessors = [
-	{ pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](https://github.com/vrdons/zKitap2Pdf/pull/${2}))" },
-]
-commit_parsers = [
-	{ message = "^feat", group = "Features" },
-	{ message = "^fix", group = "Bug Fixes" },
-	{ message = "^doc", group = "Documentation" },
-	{ message = "^perf", group = "Performance" },
-	{ message = "^refactor", group = "Refactor" },
-	{ message = "^style", group = "Styling" },
-	{ message = "^test", group = "Testing" },
-	{ message = "^chore\\(release\\): prepare for", skip = true },
-	{ message = "^chore", group = "Miscellaneous Tasks" },
-	{ body = ".*security", group = "Security" },
-
-	{ message = "^deps|^build", group = "Dependencies" },
-	{ message = "^Merge pull request", group = "Pull Requests" },
-	{ message = "^Merge branch", group = "Merges" },
-	{ message = "^Revert", group = "Reverts" },
-]

package/dist/context.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get clearClient () {
-        return clearClient;
-    },
-    get currentClient () {
-        return currentClient;
-    },
-    get setClient () {
-        return setClient;
-    }
-});
-let currentClient = null;
-function setClient(client) {
-    currentClient = client;
-}
-function clearClient() {
-    currentClient = null;
-}

package/dist/events/interaction.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _discord = require("discord.js");
-const _Event = require("../structures/Event");
-const _Context = require("../structures/Context");
-new _Event.EventBuilder(_discord.Events.InteractionCreate, false).onExecute(async function(context, interaction) {
-    if (!interaction.isChatInputCommand()) return;
-    const command = context.client.commands.get(interaction.commandName);
-    if (!command || !command.supportsSlash) {
-        await interaction.reply({
-            content: "Command not found or disabled.",
-            ephemeral: true
-        });
-        return;
-    }
-    try {
-        const ctx = new _Context.Context(context.client, {
-            interaction
-        });
-        if (command._onInteraction) await command._onInteraction(ctx.toJSON());
-    } catch (error) {
-        context.client.logger.error(`Error executing command ${command.name}:`, error);
-        if (interaction.replied || interaction.deferred) {
-            await interaction.followUp({
-                content: "There was an error while executing this command!",
-                ephemeral: true
-            });
-        } else {
-            await interaction.reply({
-                content: "There was an error while executing this command!",
-                ephemeral: true
-            });
-        }
-    }
-});

package/dist/events/message.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _discord = require("discord.js");
-const _Event = require("../structures/Event");
-const _Context = require("../structures/Context");
-const _util = require("../utils/util");
-new _Event.EventBuilder(_discord.Events.MessageCreate, false, async function(context, message) {
-    if (message.author.bot) return;
-    const prefix = context.client.prefix;
-    if (typeof prefix !== "string" || prefix.length === 0 || !message.content.startsWith(prefix)) return;
-    const args = message.content.slice(prefix.length).trim().split(/ +/);
-    const commandName = args.shift()?.toLowerCase();
-    if (!commandName) return;
-    const commandAlias = context.client.aliases.findKey((cmd)=>cmd.has(commandName));
-    let command = context.client.commands.get(commandAlias ?? commandName);
-    if (!command || !command.supportsPrefix) {
-        await message.reply({
-            content: "Command not found or disabled.",
-            allowedMentions: {
-                repliedUser: false
-            }
-        }).then(_util.deleteMessage);
-        return;
-    }
-    try {
-        const ctx = new _Context.Context(context.client, {
-            message,
-            args
-        });
-        context.logger.debug(`${ctx.author?.tag ?? "Unknown"} used ${command.name}(message)`);
-        if (command._onMessage) await command._onMessage(ctx.toJSON());
-    } catch (error) {
-        context.client.logger.error(`Error executing command ${command.name}:`, error);
-    }
-});

package/dist/events/ready.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _discord = require("discord.js");
-const _Event = require("../structures/Event");
-new _Event.EventBuilder(_discord.Events.ClientReady).onExecute(async function(context) {
-    if (context.client.options.autoRegisterCommands) {
-        await context.client.registerCommands();
-    }
-});

package/dist/structures/Argument.d.ts

@@ -1,22 +0,0 @@
-import { ApplicationCommandOptionData, ApplicationCommandOptionType } from "discord.js";
-export declare class Argument {
-    readonly name: string;
-    readonly description: string;
-    readonly type: ApplicationCommandOptionType;
-    readonly required: boolean;
-    readonly choices?: {
-        name: string;
-        value: string | number;
-    }[];
-    constructor(data: {
-        name: string;
-        description: string;
-        type: ApplicationCommandOptionType;
-        required?: boolean;
-        choices?: {
-            name: string;
-            value: string | number;
-        }[];
-    });
-    toJSON(): ApplicationCommandOptionData;
-}

package/dist/structures/Argument.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Argument", {
-    enumerable: true,
-    get: function() {
-        return Argument;
-    }
-});
-class Argument {
-    name;
-    description;
-    type;
-    required;
-    choices;
-    constructor(data){
-        this.name = data.name;
-        this.description = data.description;
-        this.type = data.type;
-        this.required = data.required ?? false;
-        this.choices = data.choices;
-    }
-    toJSON() {
-        return {
-            name: this.name,
-            description: this.description,
-            type: this.type,
-            required: this.required,
-            choices: this.choices
-        };
-    }
-}

package/dist/structures/Client.js

@@ -1,99 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Client", {
-    enumerable: true,
-    get: function() {
-        return Client;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _discord = require("discord.js");
-const _path = /*#__PURE__*/ _interop_require_default._(require("path"));
-const _Files = require("../utils/Files");
-const _lodash = require("lodash");
-const _context = require("../context");
-const _util = require("../utils/util");
-const _Logger = require("../utils/logger/Logger");
-const defaultOpts = {
-    paths: {
-        events: "events",
-        commands: "commands"
-    },
-    autoRegisterCommands: true
-};
-class Client extends _discord.Client {
-    logger;
-    commands;
-    aliases;
-    prefix;
-    constructor(opts){
-        super((0, _lodash.merge)({}, defaultOpts, opts));
-        this.logger = new _Logger.Logger(opts.logger);
-        this.commands = new _discord.Collection();
-        this.aliases = new _discord.Collection();
-        this.prefix = (0, _util.getPrefix)(this.options.prefix ?? {
-            enabled: false
-        });
-        if (this.options.paths?.events) {
-            this.loadFiles(_path.default.join((0, _Files.getProjectRoot)(), this.options.paths?.events)).catch((error)=>this.logger.error("Error loading events:", error));
-        }
-        (0, _context.setClient)(this);
-        try {
-            require("../events/ready");
-            require("../events/interaction");
-            if (this.prefix) require("../events/message");
-        } finally{
-            (0, _context.clearClient)();
-        }
-    }
-    async loadFiles(dir) {
-        if (!require("fs").existsSync(dir)) {
-            this.logger.warn(`Directory not found: ${dir}`);
-            return;
-        }
-        const files = (0, _Files.getFiles)(dir);
-        for (const file of files){
-            await this.loadFile(file);
-        }
-    }
-    async loadFile(file) {
-        try {
-            delete require.cache[require.resolve(file)];
-            (0, _context.setClient)(this);
-            require(file);
-        } catch (error) {
-            this.logger.error(`Error loading file ${file}:`, error);
-        } finally{
-            (0, _context.clearClient)();
-        }
-    }
-    async registerCommands() {
-        if (!this.token) {
-            this.logger.warn("registerCommands skipped: client token is not set.");
-            return;
-        }
-        if (!this.application) {
-            this.logger.warn("registerCommands skipped: client application is not ready.");
-            return;
-        }
-        const slashCommands = this.commands.filter((cmd)=>cmd.supportsSlash).map((cmd)=>({
-                name: cmd.name,
-                description: cmd.description,
-                options: cmd.options
-            }));
-        const rest = new _discord.REST({
-            version: "10"
-        }).setToken(this.token);
-        try {
-            this.logger.debug(`Started refreshing ${slashCommands.length} application (/) commands.`);
-            await rest.put(_discord.Routes.applicationCommands(this.application.id), {
-                body: slashCommands
-            });
-            this.logger.info(`Loaded ${slashCommands.length} application (/) commands.`);
-        } catch (error) {
-            this.logger.error("Failed to register commands:", error);
-        }
-    }
-}

package/dist/structures/Command.d.ts

@@ -1,31 +0,0 @@
-import { ApplicationCommandOptionData, ChatInputCommandInteraction, Message } from "discord.js";
-import { Context } from "./Context";
-import { Client } from "./Client";
-import { Argument } from "./Argument";
-import { MaybePromise } from "#types/extra.js";
-import { Logger } from "../utils/logger/Logger";
-export interface CommandOptions {
-    name: string;
-    description: string;
-    aliases?: string[];
-    options?: (ApplicationCommandOptionData | Argument)[];
-    slash?: boolean;
-    prefix?: boolean;
-}
-export declare class CommandBuilder {
-    readonly client: Client;
-    readonly logger: Logger;
-    readonly name: string;
-    readonly description: string;
-    readonly aliases: string[];
-    readonly options: ApplicationCommandOptionData[];
-    private _supportsSlash;
-    private _supportsPrefix;
-    _onMessage?: (ctx: NonNullable<ReturnType<Context<Message>["toJSON"]>>) => MaybePromise<void>;
-    _onInteraction?: (ctx: NonNullable<ReturnType<Context<ChatInputCommandInteraction>["toJSON"]>>) => MaybePromise<void>;
-    get supportsSlash(): false | ((ctx: NonNullable<ReturnType<Context<ChatInputCommandInteraction>["toJSON"]>>) => MaybePromise<void>) | undefined;
-    get supportsPrefix(): false | ((ctx: NonNullable<ReturnType<Context<Message>["toJSON"]>>) => MaybePromise<void>) | undefined;
-    constructor(options: CommandOptions);
-    onMessage(func: (ctx: NonNullable<ReturnType<Context<Message>["toJSON"]>>) => MaybePromise<void>): this;
-    onInteraction(func: (ctx: NonNullable<ReturnType<Context<ChatInputCommandInteraction>["toJSON"]>>) => MaybePromise<void>): this;
-}