zumito-framework 1.23.1 → 1.23.3

package/dist/ZumitoFramework.js

@@ -1,5 +1,6 @@
 import * as fs from 'fs';
 import * as url from 'url';
+import { createRequire } from 'module';
 import { Client, Events, } from 'discord.js';
 import { ApiResponse } from './definitions/api/ApiResponse.js';
 import { EventEmitter } from "tseep";
@@ -317,16 +318,41 @@ export class ZumitoFramework {
         }
         const __dirname = url.fileURLToPath(new URL('.', import.meta.url));
         const moduleEntries = [];
+        const require = createRequire(import.meta.url);
+        // New format: modules as array of package names or ModuleEntry objects
+        if (this.settings.modules) {
+            for (const entry of this.settings.modules) {
+                if (typeof entry === 'string') {
+                    const resolvedPath = require.resolve(entry, { paths: [process.cwd()] });
+                    moduleEntries.push({ rootPath: resolvedPath + '/..', name: entry });
+                }
+                else {
+                    const resolvedPath = entry.path ?? require.resolve(entry.name, { paths: [process.cwd()] });
+                    moduleEntries.push({
+                        rootPath: resolvedPath + '/..',
+                        options: entry.config,
+                        name: entry.name,
+                    });
+                }
+            }
+        }
+        // Backwards compat: old bundles format
         if (this.settings.bundles && this.settings.bundles.length > 0) {
             for (const bundle of this.settings.bundles) {
-                moduleEntries.push({
-                    rootPath: bundle.path,
-                    options: bundle.options,
-                });
+                if (typeof bundle === 'string') {
+                    const resolvedPath = require.resolve(bundle, { paths: [process.cwd()] });
+                    moduleEntries.push({ rootPath: resolvedPath + '/..', name: bundle });
+                }
+                else {
+                    moduleEntries.push({
+                        rootPath: bundle.path,
+                        options: bundle.options,
+                    });
+                }
             }
         }
         moduleEntries.push({
-            rootPath: path.join(__dirname, 'modules', 'core'),
+            rootPath: path.join(__dirname, 'modules', 'core', 'baseModule'),
             name: 'baseModule',
         });
         if (fs.existsSync(`${process.cwd()}/node_modules/.zumitoBundles`)) {

package/dist/definitions/FrameworkSettings.d.ts

@@ -1,4 +1,4 @@
 /**
  * @deprecated
  */
-export { FrameworkSettings } from "./settings/FrameworkSettings";
+export { FrameworkSettings, ModuleEntry } from "./settings/FrameworkSettings";

package/dist/definitions/Module.d.ts

@@ -19,6 +19,7 @@ export type ModuleDeclaration = {
 export declare abstract class Module {
     protected path: string;
     protected parameters: ModuleParameters;
+    protected moduleConfig: Record<string, any>;
     protected framework: ZumitoFramework;
     protected events: Map<string, FrameworkEvent>;
     static moduleName?: string;

package/dist/definitions/Module.js

@@ -9,6 +9,7 @@ import { getModelMetadata } from 'zumito-db';
 export class Module {
     path;
     parameters;
+    moduleConfig;
     framework;
     events = new Map();
     static moduleName;
@@ -21,6 +22,7 @@ export class Module {
         this.parameters = parameters;
         this.framework = ServiceContainer.getService(ZumitoFramework);
         this.errorHandler = ServiceContainer.getService(ErrorHandler);
+        this.moduleConfig = parameters ?? {};
     }
     async initialize() {
         await this.registerCommands();
@@ -92,7 +94,9 @@ export class Module {
             client: this.framework.client,
         };
         args.forEach((arg) => {
-            finalArgs[arg.constructor.name.toLowerCase()] = arg;
+            if (arg && arg.constructor) {
+                finalArgs[arg.constructor.name.toLowerCase()] = arg;
+            }
         });
         const interaction = args.find((arg) => arg instanceof StringSelectMenuInteraction ||
             arg instanceof CommandInteraction ||

package/dist/definitions/config/defineConfig.d.ts

@@ -0,0 +1,9 @@
+import type { LauncherConfig } from './LauncherConfig.js';
+/**
+ * Type-safe helper for writing `zumito.config.ts`.
+ * Provides autocompletion for all framework settings and module-specific
+ * configs contributed via declaration merging on `ModuleConfigs`.
+ *
+ * Does not modify the config object — it's a pure identity function.
+ */
+export declare function defineConfig(config: LauncherConfig): LauncherConfig;

package/dist/definitions/config/defineConfig.js

@@ -0,0 +1,10 @@
+/**
+ * Type-safe helper for writing `zumito.config.ts`.
+ * Provides autocompletion for all framework settings and module-specific
+ * configs contributed via declaration merging on `ModuleConfigs`.
+ *
+ * Does not modify the config object — it's a pure identity function.
+ */
+export function defineConfig(config) {
+    return config;
+}

package/dist/definitions/parameters/ModuleParameters.d.ts

@@ -1,7 +1,11 @@
+/**
+ * Module parameters passed to the Module constructor.
+ * Includes base framework fields plus any module-specific config.
+ */
 export type ModuleParameters = {
+    path?: string;
     commandWhitelist?: string[];
     commandBlacklist?: string[];
-    commandRenames?: {
-        [key: string]: string;
-    };
+    commandRenames?: Record<string, string>;
+    [key: string]: any;
 };

package/dist/definitions/settings/FrameworkSettings.d.ts

@@ -1,6 +1,17 @@
-import { ModuleParameters } from "../parameters/ModuleParameters";
 import { StatusManagerOptions } from "../StatusManagerOptions";
 import type { DatabaseConfig } from 'zumito-db';
+/**
+ * A module entry returned by a module factory function like `adminModule()`.
+ * Provides typed configuration and optional path override.
+ */
+export interface ModuleEntry {
+    /** Package name or module identifier (e.g., '@zumito-team/admin-module'). */
+    name: string;
+    /** Module-specific configuration. Typed by the factory function. */
+    config?: Record<string, any>;
+    /** Optional filesystem path override. Defaults to `require.resolve(name)`. */
+    path?: string;
+}
 export interface FrameworkSettings {
     mongoQueryString?: string;
     logLevel?: number;
@@ -18,10 +29,31 @@ export interface FrameworkSettings {
      * @experimental
      */
     srcMode?: 'multiBundle' | 'monoBundle' | undefined;
-    bundles?: {
+    /**
+     * @deprecated Use `modules` instead.
+     */
+    bundles?: (string | {
         path: string;
-        options?: ModuleParameters;
-    }[];
+        options?: Record<string, any>;
+    })[];
+    /**
+     * Modules to load. Each entry is either a package name string or a
+     * `ModuleEntry` object returned by a module factory function (e.g., `adminModule({...})`).
+     *
+     * Strings are resolved via `require.resolve()`.
+     * Factory functions provide type-safe autocompletion for module-specific config.
+     *
+     * @example
+     * ```ts
+     * import { adminModule } from '@zumito-team/admin-module';
+     *
+     * modules: [
+     *     adminModule({ colors: { primary: '#ff0000' } }),
+     *     '@zumito-team/canvas-module',
+     * ]
+     * ```
+     */
+    modules?: (string | ModuleEntry)[];
     webServer?: {
         port?: number;
         disableNotFoundHandler?: boolean;

package/dist/index.d.ts

@@ -41,5 +41,7 @@ export { ModalSubmitParameters } from './definitions/parameters/ModalSubmitParam
 export { CommandBinds } from './definitions/commands/CommandBinds.js';
 export { Injectable } from './definitions/decorators/Injectable.decorator.js';
 export { LauncherConfig } from './definitions/config/LauncherConfig.js';
+export { defineConfig } from './definitions/config/defineConfig.js';
+export type { ModuleEntry } from './definitions/settings/FrameworkSettings.js';
 export { ModuleParameters } from './definitions/parameters/ModuleParameters.js';
 export { ZumitoFramework, FrameworkSettings, Command, Module, ModuleDeclaration, ModuleRequeriments, CommandParameters, CommandArguments, FrameworkEvent, Translation, TranslationManager, ApiResponse, SelectMenuParameters, CommandType, CommandArgDefinition, CommandChoiceDefinition, ButtonPressed, ButtonPressedParams, TextFormatter, EmojiFallback, DatabaseConfigLoader, PresenceDataRule, RuledPresenceData, StatusManagerOptions, discord, EventParameters, ServiceContainer, GuildDataGetter, SlashCommandRefresher, CommandParser, ErrorHandler, ErrorType, Route, RouteMethod, InteractionHandler, CommandManager, InviteUrlGenerator, PrefixResolver, CommandExecutionChecker, DatabaseManager, };

package/dist/index.js

@@ -28,6 +28,7 @@ import { CommandExecutionChecker } from './services/CommandExecutionChecker.js';
 import { DatabaseManager } from 'zumito-db';
 export { Collection, Field, HasMany, BelongsTo, HasOne, Migration, Repository, QueryBuilder } from 'zumito-db';
 export { Injectable } from './definitions/decorators/Injectable.decorator.js';
+export { defineConfig } from './definitions/config/defineConfig.js';
 ServiceContainer.addService(TextFormatter, []);
 ServiceContainer.addService(EmojiFallback, [discord.Client.name, TranslationManager.name]);
 ServiceContainer.addService(GuildDataGetter, [ZumitoFramework.name]);

package/dist/launcher.js

@@ -29,7 +29,12 @@ if (!fs.existsSync(configFilePath)) {
     process.exit(1);
 }
 import(pathToFileURL(configFilePath).href)
-    .then(({ config: userConfig }) => {
+    .then((mod) => {
+    const userConfig = mod.config ?? mod.default;
+    if (!userConfig) {
+        console.error(`Config file at ${configFilePath} must export 'config' (named) or 'default' (default export).`);
+        process.exit(1);
+    }
     const config = RecursiveObjectMerger.merge(defaultConfig, userConfig);
     new ZumitoFramework(config, (bot) => {
         BotReadyLogger.log(bot);

package/dist/modules/core/baseModule/index.d.ts

@@ -0,0 +1,4 @@
+import { Module } from '../../../definitions/Module.js';
+export declare class BaseModule extends Module {
+    initialize(): Promise<void>;
+}

package/dist/modules/core/baseModule/index.js

@@ -0,0 +1,6 @@
+import { Module } from '../../../definitions/Module.js';
+export class BaseModule extends Module {
+    async initialize() {
+        await super.initialize();
+    }
+}

package/dist/services/managers/CommandManager.js

@@ -62,6 +62,7 @@ export class CommandManager {
             return command;
         }
         catch (error) {
+            console.error('[🆕🔴 ] Error instanciating command ' + chalk.blue(baseName) + ' from ' + filePath);
             this.errorHandler.handleError(error, {
                 type: ErrorType.CommandInstance,
                 command: command,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zumito-framework",
-  "version": "1.23.1",
+  "version": "1.23.3",
   "description": "Discord.js bot framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,7 +42,7 @@
     "source-fragment": "^1.1.0",
     "tingodb": "^0.6.1",
     "tseep": "^1.2.2",
-    "zumito-db": "^2.0.3"
+    "zumito-db": "^2.0.4"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",