stoatx 0.3.0 → 0.5.0

package/dist/decorators/store.d.ts

@@ -0,0 +1,46 @@
+import type { RegisteredCommand } from "../registry";
+/**
+ * Global store for all decorated classes and commands
+ * This allows automatic registration without directory scanning
+ */
+export declare class DecoratorStore {
+    private static instance;
+    /** Stoat classes with their SimpleCommand methods */
+    private stoatClasses;
+    /** Registered commands from @Stoat/@SimpleCommand decorators */
+    private commands;
+    /** Whether the store has been initialized */
+    private initialized;
+    private constructor();
+    static getInstance(): DecoratorStore;
+    /**
+     * Register a @Stoat decorated class
+     */
+    registerStoatClass(classConstructor: Function): void;
+    /**
+     * Get all registered Stoat classes with their instances
+     */
+    getStoatClasses(): Map<Function, object>;
+    /**
+     * Add a registered command
+     */
+    addCommand(command: RegisteredCommand): void;
+    /**
+     * Get all registered commands
+     */
+    getCommands(): RegisteredCommand[];
+    /**
+     * Clear all registered classes (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Mark as initialized
+     */
+    markInitialized(): void;
+    /**
+     * Check if initialized
+     */
+    isInitialized(): boolean;
+}
+export declare const decoratorStore: DecoratorStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/decorators/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/decorators/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IAExC,qDAAqD;IACrD,OAAO,CAAC,YAAY,CAAoC;IAExD,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAA2B;IAE3C,6CAA6C;IAC7C,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;OAEG;IACH,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,GAAG,IAAI;IAQpD;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI5C;;OAEG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAED,eAAO,MAAM,cAAc,gBAA+B,CAAC"}

package/dist/decorators/store.js

@@ -0,0 +1,70 @@
+/**
+ * Global store for all decorated classes and commands
+ * This allows automatic registration without directory scanning
+ */
+export class DecoratorStore {
+    static instance;
+    /** Stoat classes with their SimpleCommand methods */
+    stoatClasses = new Map();
+    /** Registered commands from @Stoat/@SimpleCommand decorators */
+    commands = [];
+    /** Whether the store has been initialized */
+    initialized = false;
+    constructor() { }
+    static getInstance() {
+        if (!DecoratorStore.instance) {
+            DecoratorStore.instance = new DecoratorStore();
+        }
+        return DecoratorStore.instance;
+    }
+    /**
+     * Register a @Stoat decorated class
+     */
+    registerStoatClass(classConstructor) {
+        if (!this.stoatClasses.has(classConstructor)) {
+            // Create instance immediately when decorated
+            const instance = new classConstructor();
+            this.stoatClasses.set(classConstructor, instance);
+        }
+    }
+    /**
+     * Get all registered Stoat classes with their instances
+     */
+    getStoatClasses() {
+        return this.stoatClasses;
+    }
+    /**
+     * Add a registered command
+     */
+    addCommand(command) {
+        this.commands.push(command);
+    }
+    /**
+     * Get all registered commands
+     */
+    getCommands() {
+        return this.commands;
+    }
+    /**
+     * Clear all registered classes (useful for testing)
+     */
+    clear() {
+        this.stoatClasses.clear();
+        this.commands = [];
+        this.initialized = false;
+    }
+    /**
+     * Mark as initialized
+     */
+    markInitialized() {
+        this.initialized = true;
+    }
+    /**
+     * Check if initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+export const decoratorStore = DecoratorStore.getInstance();
+//# sourceMappingURL=store.js.map

package/dist/decorators/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/decorators/store.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,CAAiB;IAExC,qDAAqD;IAC7C,YAAY,GAA0B,IAAI,GAAG,EAAE,CAAC;IAExD,gEAAgE;IACxD,QAAQ,GAAwB,EAAE,CAAC;IAE3C,6CAA6C;IACrC,WAAW,GAAG,KAAK,CAAC;IAE5B,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,gBAA0B;QAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC7C,6CAA6C;YAC7C,MAAM,QAAQ,GAAG,IAAK,gBAAqC,EAAE,CAAC;YAC9D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAA0B;QACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC"}

package/dist/decorators/utils.d.ts

@@ -0,0 +1,6 @@
+import type { CommandMetadata, SimpleCommandOptions } from "../types";
+/**
+ * Build CommandMetadata from SimpleCommandOptions
+ */
+export declare function buildSimpleCommandMetadata(options: SimpleCommandOptions, methodName: string, category?: string): CommandMetadata;
+//# sourceMappingURL=utils.d.ts.map

package/dist/decorators/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/decorators/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEtE;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CAWjB"}

package/dist/decorators/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Build CommandMetadata from SimpleCommandOptions
+ */
+export function buildSimpleCommandMetadata(options, methodName, category) {
+    return {
+        name: options.name ?? methodName.toLowerCase(),
+        description: options.description ?? "No description provided",
+        aliases: options.aliases ?? [],
+        permissions: options.permissions ?? [],
+        category: options.category ?? category ?? "uncategorized",
+        cooldown: options.cooldown ?? 0,
+        nsfw: options.nsfw ?? false,
+        ownerOnly: options.ownerOnly ?? false,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/decorators/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/decorators/utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA6B,EAC7B,UAAkB,EAClB,QAAiB;IAEjB,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,WAAW,EAAE;QAC9C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,yBAAyB;QAC7D,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ,IAAI,eAAe;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;KACtC,CAAC;AACJ,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decorators module - Re-exports all decorators from the decorators folder
+ *
+ * This file maintains backward compatibility while the actual implementations
+ * are organized in separate files under the decorators/ folder.
+ */
+export { Stoat, isStoatClass, SimpleCommand, getSimpleCommands, Guard, getGuards, buildSimpleCommandMetadata, METADATA_KEYS, On, Once, getEventsMetadata, } from "./decorators/index";
+export type { SimpleCommandDefinition, EventDefinition } from "./decorators/index";
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,KAAK,EACL,YAAY,EAGZ,aAAa,EACb,iBAAiB,EAGjB,KAAK,EACL,SAAS,EAGT,0BAA0B,EAG1B,aAAa,EAGb,EAAE,EACF,IAAI,EACJ,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/decorators.js

@@ -0,0 +1,21 @@
+/**
+ * Decorators module - Re-exports all decorators from the decorators folder
+ *
+ * This file maintains backward compatibility while the actual implementations
+ * are organized in separate files under the decorators/ folder.
+ */
+// Re-export everything from the decorators folder
+export { 
+// Stoat (discordx-style class decorator)
+Stoat, isStoatClass, 
+// SimpleCommand (method decorator for @Stoat classes)
+SimpleCommand, getSimpleCommands, 
+// Guard
+Guard, getGuards, 
+// Utilities
+buildSimpleCommandMetadata, 
+// Metadata keys
+METADATA_KEYS, 
+// Events
+On, Once, getEventsMetadata, } from "./decorators/index";
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kDAAkD;AAClD,OAAO;AACL,yCAAyC;AACzC,KAAK,EACL,YAAY;AAEZ,sDAAsD;AACtD,aAAa,EACb,iBAAiB;AAEjB,QAAQ;AACR,KAAK,EACL,SAAS;AAET,YAAY;AACZ,0BAA0B;AAE1B,gBAAgB;AAChB,aAAa;AAEb,SAAS;AACT,EAAE,EACF,IAAI,EACJ,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/handler.d.ts

@@ -0,0 +1,145 @@
+import "reflect-metadata";
+import { CommandRegistry, RegisteredCommand } from "./registry";
+import type { CommandContext, StoatxHandlerOptions } from "./types";
+import { Client as StoatClient, Message } from "stoat.js";
+/**
+ * Client - An extended Client that integrates StoatxHandler directly
+ *
+ * @example
+ * ```ts
+ * import { Client } from 'stoatx';
+ *
+ * const client = new Client({
+ *   prefix: '!',
+ *   owners: ['owner-user-id'],
+ * });
+ *
+ * await client.initCommands();
+ * ```
+ */
+export declare class Client extends StoatClient {
+    readonly handler: StoatxHandler;
+    constructor(options: Omit<StoatxHandlerOptions, "client">);
+    /**
+     * Initialize the StoatxHandler commands
+     */
+    initCommands(): Promise<void>;
+}
+/**
+ * StoatxHandler - The execution engine for commands
+ *
+ * Handles message parsing, middleware execution, and command dispatching
+ *
+ * @internal This class is not intended to be instantiated directly. Use the `Client` from `stoatx` instead.
+ */
+export declare class StoatxHandler {
+    private readonly commandsDir;
+    private readonly discoveryOptions;
+    private readonly prefixResolver;
+    private readonly owners;
+    private readonly registry;
+    private readonly cooldowns;
+    private readonly disableMentionPrefix;
+    private readonly client;
+    constructor(options: StoatxHandlerOptions);
+    /**
+     * Initialize the handler - load all commands
+     */
+    init(): Promise<void>;
+    /**
+     * Attach registered events to the client
+     */
+    private attachEvents;
+    /**
+     * Parse a raw message into command context
+     */
+    parseMessage(rawContent: string, message: Message, meta: {
+        authorId: string;
+        channelId: string;
+        serverId?: string;
+        reply: (content: string) => Promise<Message>;
+    }): Promise<CommandContext | null>;
+    /**
+     * Handle a message object using the configured message adapter
+     *
+     * @example
+     * ```ts
+     * // With message adapter configured
+     * client.on('messageCreate', (message) => {
+     *   handler.handle(message);
+     * });
+     * ```
+     */
+    handle(message: any): Promise<boolean>;
+    /**
+     * Handle a raw message string with metadata
+     *
+     * @example
+     * ```ts
+     * // Manual usage without message adapter
+     * client.on('messageCreate', (message) => {
+     *   handler.handleMessage(message.content, message, {
+     *     authorId: message.author.id,
+     *     channelId: message.channel.id,
+     *     serverId: message.server?.id,
+     *     reply: (content) => message.channel.sendMessage(content),
+     *   });
+     * });
+     * ```
+     */
+    handleMessage(rawContent: string, message: Message, meta: {
+        authorId: string;
+        channelId: string;
+        serverId?: string;
+        reply: (content: string) => Promise<Message>;
+    }): Promise<boolean>;
+    /**
+     * Execute a command with the given context
+     */
+    execute(ctx: CommandContext): Promise<boolean>;
+    /**
+     * Get the command registry
+     */
+    getRegistry(): CommandRegistry;
+    /**
+     * Get a command by name or alias
+     */
+    getCommand(name: string): RegisteredCommand | undefined;
+    /**
+     * Get all commands
+     */
+    getCommands(): RegisteredCommand[];
+    /**
+     * Reload all commands
+     */
+    reload(): Promise<void>;
+    /**
+     * Check if a user is an owner
+     */
+    isOwner(userId: string): boolean;
+    /**
+     * Add an owner
+     */
+    addOwner(userId: string): void;
+    /**
+     * Remove an owner
+     */
+    removeOwner(userId: string): void;
+    /**
+     * Resolve the prefix for a context
+     */
+    private resolvePrefix;
+    /**
+     * Check if user is on cooldown
+     */
+    private checkCooldown;
+    /**
+     * Get remaining cooldown time in ms
+     */
+    private getRemainingCooldown;
+    /**
+     * Set cooldown for a user
+     */
+    private setCooldown;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAA2C,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC7G,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IAUzD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsE;IACrG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IACzE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBACzB,OAAO,EAAE,oBAAoB;IAUzC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9C,GACA,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAkDjC;;;;;;;;;;OAUG;IACG,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IA0B5C;;;;;;;;;;;;;;;OAeG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9C,GACA,OAAO,CAAC,OAAO,CAAC;IAUnB;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAkEpD;;OAEG;IACH,WAAW,IAAI,eAAe;IAI9B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD;;OAEG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAIlC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAW7B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;YACW,aAAa;IAO3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,WAAW;CAQpB"}