@bejibun/core 0.1.39 → 0.1.41

package/CHANGELOG.md

@@ -3,6 +3,57 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [v0.1.41](https://github.com/crenata/bejibun-core/compare/v0.1.40...v0.1.41) - 2025-10-20
+
+### 🩹 Fixes
+
+### 📖 Changes
+Chore :
+- Refactor some codes to bun native
+- Adding log when throwing exceptions
+
+### ❤️Contributors
+- Havea Crenata ([@crenata](https://github.com/crenata))
+- Ghulje ([@ghulje](https://github.com/ghulje))
+
+**Full Changelog**: https://github.com/crenata/bejibun-core/blob/master/CHANGELOG.md
+
+---
+
+## [v0.1.40](https://github.com/crenata/bejibun-core/compare/v0.1.39...v0.1.40) - 2025-10-19
+
+### 🩹 Fixes
+- Fix router any invalid route structure
+
+### 📖 Changes
+What's New :
+- Support commands from your root bejibun framework
+- Support nested directory commands
+- Adding router namespace
+
+### ❤️Contributors
+- Havea Crenata ([@crenata](https://github.com/crenata))
+- Ghulje ([@ghulje](https://github.com/ghulje))
+
+**Full Changelog**: https://github.com/crenata/bejibun-core/blob/master/CHANGELOG.md
+
+---
+
+## [v0.1.39](https://github.com/crenata/bejibun-core/compare/v0.1.38...v0.1.39) - 2025-10-17
+
+### 🩹 Fixes
+- Fix load database configuration on bootstrap & base model
+
+### 📖 Changes
+
+### ❤️Contributors
+- Havea Crenata ([@crenata](https://github.com/crenata))
+- Ghulje ([@ghulje](https://github.com/ghulje))
+
+**Full Changelog**: https://github.com/crenata/bejibun-core/blob/master/CHANGELOG.md
+
+---
+
 ## [v0.1.38](https://github.com/crenata/bejibun-core/compare/v0.1.36...v0.1.38) - 2025-10-17
 
 ### 🩹 Fixes

package/bases/BaseController.d.ts

@@ -1,8 +1,7 @@
 import { VineValidator } from "@vinejs/vine";
-import { BunRequest } from "bun";
 import Response from "../facades/Response";
 export default class BaseController {
-    parse(request: BunRequest): Promise<Record<string, any>>;
+    parse(request: Bun.BunRequest): Promise<Record<string, any>>;
     get response(): typeof Response;
     validate(validator: VineValidator<any, Record<string, any> | undefined>, body: Record<string, any>): Promise<any>;
     private serialize;

package/bases/BaseModel.js

@@ -1,3 +1,4 @@
+import App from "@bejibun/app";
 import { defineValue, isEmpty } from "@bejibun/utils";
 import Str from "@bejibun/utils/facades/Str";
 import { DateTime } from "luxon";
@@ -25,8 +26,7 @@ export default class BaseModel extends Model {
     static QueryBuilder = BunQueryBuilder;
     static get namespace() {
         const filePath = fileURLToPath(import.meta.url);
-        const appRoot = process.cwd();
-        const rel = relative(appRoot, filePath);
+        const rel = relative(App.rootPath(), filePath);
         const withoutExt = rel.replace(/\.[tj]s$/, "");
         const namespaces = withoutExt.split(sep);
         namespaces.pop();
@@ -63,7 +63,7 @@ export default class BaseModel extends Model {
     static async findOrFail(id) {
         const result = await this.find(id);
         if (isEmpty(result))
-            throw new ModelNotFoundException(`[ModelNotFoundException]: No query results for model [${this.namespace}] [${id}].`);
+            throw new ModelNotFoundException(`No query results for model [${this.namespace}] [${id}].`);
         return result;
     }
 }

package/builders/RouterBuilder.d.ts

@@ -8,11 +8,15 @@ export interface ResourceOptions {
 export default class RouterBuilder {
     private basePath;
     private middlewares;
+    private baseNamespace;
     prefix(basePath: string): RouterBuilder;
     middleware(...middlewares: Array<IMiddleware>): RouterBuilder;
+    namespace(baseNamespace: string): RouterBuilder;
     group(routes: RouterGroup | Array<RouterGroup>): RouterGroup;
     resources(controller: Record<string, HandlerType>, options?: ResourceOptions): RouterGroup;
     buildSingle(method: HttpMethodEnum, path: string, handler: string | HandlerType): RouterGroup;
+    match(methods: Array<HttpMethodEnum>, path: string, handler: string | HandlerType): RouterGroup;
+    any(path: string, handler: string | HandlerType): RouterGroup;
     private joinPaths;
     private resolveControllerString;
     private resolveIncludedActions;

package/builders/RouterBuilder.js

@@ -1,9 +1,13 @@
+import App from "@bejibun/app";
 import { isEmpty } from "@bejibun/utils";
+import HttpMethodEnum from "@bejibun/utils/enums/HttpMethodEnum";
+import Enum from "@bejibun/utils/facades/Enum";
 import path from "path";
 import RouterInvalidException from "../exceptions/RouterInvalidException";
 export default class RouterBuilder {
     basePath = "";
     middlewares = [];
+    baseNamespace = "app/controllers";
     prefix(basePath) {
         this.basePath = basePath;
         return this;
@@ -12,6 +16,10 @@ export default class RouterBuilder {
         this.middlewares.push(...middlewares);
         return this;
     }
+    namespace(baseNamespace) {
+        this.baseNamespace = baseNamespace;
+        return this;
+    }
     group(routes) {
         const routeList = Array.isArray(routes) ? routes : [routes];
         const newRoutes = {};
@@ -77,18 +85,33 @@ export default class RouterBuilder {
             }
         };
     }
+    match(methods, path, handler) {
+        const routeMap = {};
+        for (const method of methods) {
+            const single = this.buildSingle(method, path, handler);
+            const fullPath = Object.keys(single)[0];
+            const handlers = single[fullPath];
+            if (isEmpty(routeMap[fullPath]))
+                routeMap[fullPath] = {};
+            Object.assign(routeMap[fullPath], handlers);
+        }
+        return routeMap;
+    }
+    any(path, handler) {
+        return this.match(Enum.setEnums(HttpMethodEnum).toArray().map((value) => value.value), path, handler);
+    }
     joinPaths(base, path) {
         base = base.replace(/\/+$/, "");
         path = path.replace(/^\/+/, "");
-        return "/" + [base, path].filter(Boolean).join("/");
+        return `/${[base, path].filter(Boolean).join("/")}`;
     }
     resolveControllerString(definition) {
         const [controllerName, methodName] = definition.split("@");
         if (isEmpty(controllerName) || isEmpty(methodName)) {
-            throw new RouterInvalidException(`[RouterInvalidException]: Invalid router controller definition: ${definition}.`);
+            throw new RouterInvalidException(`Invalid router controller definition: ${definition}.`);
         }
-        const controllerPath = path.resolve(process.cwd(), "app/controllers");
-        const location = `${controllerPath}/${controllerName}`;
+        const controllerPath = path.resolve(App.rootPath(), this.baseNamespace);
+        const location = Bun.resolveSync(`${controllerName}.ts`, controllerPath);
         let ControllerClass;
         try {
             ControllerClass = require(location).default;
@@ -99,17 +122,17 @@ export default class RouterBuilder {
                 const ESMController = module.default;
                 const instance = new ESMController();
                 if (typeof instance[methodName] !== "function") {
-                    throw new RouterInvalidException(`[RouterInvalidException]: Method "${methodName}" not found in ${controllerName}.`);
+                    throw new RouterInvalidException(`Method "${methodName}" not found in ${controllerName}.`);
                 }
                 return instance[methodName](...args);
             };
         }
         if (isEmpty(ControllerClass)) {
-            throw new RouterInvalidException(`[RouterInvalidException]: Controller not found: ${controllerName}.`);
+            throw new RouterInvalidException(`Controller not found: ${controllerName}.`);
         }
         const instance = new ControllerClass();
         if (typeof instance[methodName] !== "function") {
-            throw new RouterInvalidException(`[RouterInvalidException]: Method "${methodName}" not found in ${controllerName}.`);
+            throw new RouterInvalidException(`Method "${methodName}" not found in ${controllerName}.`);
         }
         return instance[methodName].bind(instance);
     }

package/commands/Kernel.d.ts

@@ -1,4 +1,5 @@
 import type { Command } from "commander";
 export default class Kernel {
     static registerCommands(program: Command): void;
+    private static commands;
 }

package/commands/Kernel.js

@@ -1,24 +1,20 @@
+import App from "@bejibun/app";
 import { defineValue, isEmpty } from "@bejibun/utils";
 import { readdirSync } from "fs";
 import path from "path";
 export default class Kernel {
     static registerCommands(program) {
-        const commandsDir = path.resolve(__dirname);
-        const files = readdirSync(commandsDir).filter((file) => {
-            return (/\.(m?js|ts)$/.test(file) &&
-                !file.endsWith(".d.ts") &&
-                !file.includes("Kernel"));
-        });
+        const commandsDirectoryCore = path.resolve(__dirname);
+        const files = this.commands(commandsDirectoryCore)
+            .concat(this.commands(App.commandsPath()));
         for (const file of files) {
-            const modulePath = path.join(commandsDir, file);
-            const { default: CommandClass } = require(modulePath);
+            const { default: CommandClass } = require(file);
             const instance = new CommandClass();
             if (isEmpty(instance.$signature) || typeof instance.handle !== "function")
                 continue;
             const cmd = program
                 .command(instance.$signature)
-                .description(defineValue(instance.$description, ""))
-                .action(instance.handle);
+                .description(defineValue(instance.$description, ""));
             if (Array.isArray(instance.$options)) {
                 for (const option of instance.$options) {
                     cmd.option(...option);
@@ -30,10 +26,29 @@ export default class Kernel {
                 }
             }
             cmd.action(async (...args) => {
-                const lastArg = args[args.length - 1];
-                const options = defineValue(lastArg, {});
-                await instance.handle(options, args.slice(0, -1));
+                const commandObj = args[args.length - 1];
+                const options = typeof commandObj.opts === "function" ? commandObj.opts() : commandObj;
+                const positionalArgs = args.slice(0, -1);
+                await instance.handle(options, positionalArgs);
             });
         }
     }
+    static commands(directory) {
+        const entries = readdirSync(directory, {
+            withFileTypes: true
+        });
+        const files = [];
+        for (const entry of entries) {
+            const fullPath = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...this.commands(fullPath));
+            }
+            else if (/\.(m?js|ts)$/.test(entry.name) &&
+                !entry.name.endsWith(".d.ts") &&
+                !entry.name.includes("Kernel")) {
+                files.push(fullPath);
+            }
+        }
+        return files;
+    }
 }

package/commands/{DbSeedCommand.d.ts → db/DbSeedCommand.d.ts}

@@ -14,9 +14,9 @@ export default class DbSeedCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
-    protected $options: Array<Array<string>>;
+    protected $options: Array<Array<any>>;
     /**
      * The arguments of the console command.
      *

package/commands/{DbSeedCommand.js → db/DbSeedCommand.js}

@@ -1,7 +1,7 @@
 import Chalk from "@bejibun/logger/facades/Chalk";
 import ora from "ora";
 import path from "path";
-import { initDatabase } from "../config/database";
+import { initDatabase } from "../../config/database";
 export default class DbSeedCommand {
     /**
      * The name and signature of the console command.
@@ -18,7 +18,7 @@ export default class DbSeedCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
     $options = [];
     /**

package/commands/maintenance/MaintenanceDownCommand.d.ts

@@ -0,0 +1,27 @@
+export default class MaintenanceDownCommand {
+    /**
+     * The name and signature of the console command.
+     *
+     * @var $signature string
+     */
+    protected $signature: string;
+    /**
+     * The console command description.
+     *
+     * @var $description string
+     */
+    protected $description: string;
+    /**
+     * The options or optional flag of the console command.
+     *
+     * @var $options Array<Array<any>>
+     */
+    protected $options: Array<Array<any>>;
+    /**
+     * The arguments of the console command.
+     *
+     * @var $arguments Array<Array<string>>
+     */
+    protected $arguments: Array<Array<string>>;
+    handle(options: any, args: Array<string>): Promise<void>;
+}

package/commands/maintenance/MaintenanceDownCommand.js

@@ -0,0 +1,40 @@
+import App from "@bejibun/app";
+import Logger from "@bejibun/logger";
+import { DateTime } from "luxon";
+export default class MaintenanceDownCommand {
+    /**
+     * The name and signature of the console command.
+     *
+     * @var $signature string
+     */
+    $signature = "maintenance:down";
+    /**
+     * The console command description.
+     *
+     * @var $description string
+     */
+    $description = "Turn app into maintenance mode";
+    /**
+     * The options or optional flag of the console command.
+     *
+     * @var $options Array<Array<any>>
+     */
+    $options = [
+        ["-a, --allows <ips>", "Whitelist IPs from accessing application in maintenance mode. e.g. --allows=127.0.0.1,127.0.0.2", (value) => value.split(","), []]
+    ];
+    /**
+     * The arguments of the console command.
+     *
+     * @var $arguments Array<Array<string>>
+     */
+    $arguments = [];
+    async handle(options, args) {
+        await Bun.write(App.storagePath("framework/maintenance.down.json"), JSON.stringify({
+            message: "🚧 We're doing maintenance. Please check back soon.",
+            status: 503,
+            allows: options.allows,
+            unix: Math.floor(DateTime.now().toSeconds())
+        }, null, 2));
+        Logger.setContext("APP").info("Application turned into maintenance mode.");
+    }
+}

package/commands/{MigrateFreshCommand.d.ts → migrate/MigrateFreshCommand.d.ts}

@@ -14,9 +14,9 @@ export default class MigrateFreshCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
-    protected $options: Array<Array<string>>;
+    protected $options: Array<Array<any>>;
     /**
      * The arguments of the console command.
      *

package/commands/{MigrateFreshCommand.js → migrate/MigrateFreshCommand.js}

@@ -1,7 +1,8 @@
+import Logger from "@bejibun/logger";
 import Chalk from "@bejibun/logger/facades/Chalk";
 import { ask, isNotEmpty } from "@bejibun/utils";
 import ora from "ora";
-import { initDatabase } from "../config/database";
+import { initDatabase } from "../../config/database";
 export default class MigrateFreshCommand {
     /**
      * The name and signature of the console command.
@@ -18,10 +19,10 @@ export default class MigrateFreshCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
     $options = [
-        ["-f, --force", "Skip command confirmation."]
+        ["-f, --force", "Skip command confirmation"]
     ];
     /**
      * The arguments of the console command.
@@ -40,7 +41,7 @@ export default class MigrateFreshCommand {
                 .show());
         if (confirm.toUpperCase() === "Y") {
             if (!bypass)
-                console.log();
+                Logger.empty();
             const spinner = ora(Chalk.setValue("Rollback...")
                 .info()
                 .show()).start();

package/commands/{MigrateLatestCommand.d.ts → migrate/MigrateLatestCommand.d.ts}

@@ -14,9 +14,9 @@ export default class MigrateLatestCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
-    protected $options: Array<Array<string>>;
+    protected $options: Array<Array<any>>;
     /**
      * The arguments of the console command.
      *

package/commands/{MigrateLatestCommand.js → migrate/MigrateLatestCommand.js}

@@ -1,6 +1,6 @@
 import Chalk from "@bejibun/logger/facades/Chalk";
 import ora from "ora";
-import { initDatabase } from "../config/database";
+import { initDatabase } from "../../config/database";
 export default class MigrateLatestCommand {
     /**
      * The name and signature of the console command.
@@ -17,7 +17,7 @@ export default class MigrateLatestCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
     $options = [];
     /**

package/commands/{MigrateRollbackCommand.d.ts → migrate/MigrateRollbackCommand.d.ts}

@@ -14,9 +14,9 @@ export default class MigrateRollbackCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
-    protected $options: Array<Array<string>>;
+    protected $options: Array<Array<any>>;
     /**
      * The arguments of the console command.
      *

package/commands/{MigrateRollbackCommand.js → migrate/MigrateRollbackCommand.js}

@@ -1,7 +1,8 @@
+import Logger from "@bejibun/logger";
 import Chalk from "@bejibun/logger/facades/Chalk";
 import { ask, isNotEmpty } from "@bejibun/utils";
 import ora from "ora";
-import { initDatabase } from "../config/database";
+import { initDatabase } from "../../config/database";
 export default class MigrateRollbackCommand {
     /**
      * The name and signature of the console command.
@@ -18,10 +19,10 @@ export default class MigrateRollbackCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
     $options = [
-        ["-f, --force", "Skip command confirmation."]
+        ["-f, --force", "Skip command confirmation"]
     ];
     /**
      * The arguments of the console command.
@@ -40,7 +41,7 @@ export default class MigrateRollbackCommand {
                 .show());
         if (confirm.toUpperCase() === "Y") {
             if (!bypass)
-                console.log();
+                Logger.empty();
             const spinner = ora(Chalk.setValue("Rollback...")
                 .info()
                 .show()).start();

package/commands/{MigrateStatusCommand.d.ts → migrate/MigrateStatusCommand.d.ts}

@@ -14,9 +14,9 @@ export default class MigrateStatusCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
-    protected $options: Array<Array<string>>;
+    protected $options: Array<Array<any>>;
     /**
      * The arguments of the console command.
      *

package/commands/{MigrateStatusCommand.js → migrate/MigrateStatusCommand.js}

@@ -1,6 +1,7 @@
+import Logger from "@bejibun/logger";
 import Chalk from "@bejibun/logger/facades/Chalk";
 import ora from "ora";
-import { initDatabase } from "../config/database";
+import { initDatabase } from "../../config/database";
 export default class MigrateStatusCommand {
     /**
      * The name and signature of the console command.
@@ -17,10 +18,10 @@ export default class MigrateStatusCommand {
     /**
      * The options or optional flag of the console command.
      *
-     * @var $options Array<Array<string>>
+     * @var $options Array<Array<any>>
      */
     $options = [
-        ["-f, --force", "Skip command confirmation."]
+        ["-f, --force", "Skip command confirmation"]
     ];
     /**
      * The arguments of the console command.
@@ -40,7 +41,7 @@ export default class MigrateStatusCommand {
                 completed.forEach((migration) => spinner.succeed(migration.name));
             else
                 spinner.succeed("No migrations were completed.");
-            console.log();
+            Logger.empty();
             spinner.succeed("Pending Migrations :");
             if (pending.length > 0)
                 pending.forEach((migration) => spinner.succeed(migration.file));

package/config/database.js

@@ -1,6 +1,6 @@
+import App from "@bejibun/app";
 import fs from "fs";
 import knex from "knex";
-import path from "path";
 const config = {
     client: "pg",
     connection: {
@@ -25,7 +25,7 @@ const config = {
     }
 };
 export const initDatabase = () => {
-    const configPath = path.resolve(process.cwd(), "config/database.ts");
+    const configPath = App.configPath("database.ts");
     let _config;
     if (fs.existsSync(configPath))
         _config = require(configPath).default;

package/exceptions/ModelNotFoundException.js

@@ -1,3 +1,4 @@
+import Logger from "@bejibun/logger";
 import { defineValue } from "@bejibun/utils";
 export default class ModelNotFoundException extends Error {
     code;
@@ -5,6 +6,7 @@ export default class ModelNotFoundException extends Error {
         super(message);
         this.name = "ModelNotFoundException";
         this.code = defineValue(code, 404);
+        Logger.setContext(this.name).error(this.message).trace(this.stack);
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, ModelNotFoundException);
         }

package/exceptions/RouterInvalidException.js

@@ -1,3 +1,4 @@
+import Logger from "@bejibun/logger";
 import { defineValue } from "@bejibun/utils";
 export default class RouterInvalidException extends Error {
     code;
@@ -5,6 +6,7 @@ export default class RouterInvalidException extends Error {
         super(message);
         this.name = "RouterInvalidException";
         this.code = defineValue(code, 500);
+        Logger.setContext(this.name).error(this.message).trace(this.stack);
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, RouterInvalidException);
         }

package/exceptions/ValidatorException.js

@@ -1,3 +1,4 @@
+import Logger from "@bejibun/logger";
 import { defineValue } from "@bejibun/utils";
 export default class ValidatorException extends Error {
     code;
@@ -5,6 +6,7 @@ export default class ValidatorException extends Error {
         super(message);
         this.name = "ValidatorException";
         this.code = defineValue(code, 422);
+        Logger.setContext(this.name).error(this.message).trace(this.stack);
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, ValidatorException);
         }

package/facades/Router.d.ts

@@ -5,6 +5,7 @@ import RouterBuilder, { ResourceOptions } from "../builders/RouterBuilder";
 export default class Router {
     static prefix(basePath: string): RouterBuilder;
     static middleware(...middlewares: Array<IMiddleware>): RouterBuilder;
+    static namespace(baseNamespace: string): RouterBuilder;
     static resources(controller: Record<string, HandlerType>, options?: ResourceOptions): RouterGroup;
     static group(routes: RouterGroup, prefix?: string, middlewares?: Array<IMiddleware>): RouterGroup;
     static connect(path: string, handler: string | HandlerType): RouterGroup;

package/facades/Router.js

@@ -1,6 +1,4 @@
-import { isEmpty } from "@bejibun/utils";
 import HttpMethodEnum from "@bejibun/utils/enums/HttpMethodEnum";
-import Enum from "@bejibun/utils/facades/Enum";
 import RouterBuilder from "../builders/RouterBuilder";
 export default class Router {
     static prefix(basePath) {
@@ -9,6 +7,9 @@ export default class Router {
     static middleware(...middlewares) {
         return new RouterBuilder().middleware(...middlewares);
     }
+    static namespace(baseNamespace) {
+        return new RouterBuilder().namespace(baseNamespace);
+    }
     static resources(controller, options) {
         return new RouterBuilder().resources(controller, options);
     }
@@ -48,19 +49,9 @@ export default class Router {
         return new RouterBuilder().buildSingle(HttpMethodEnum.Trace, path, handler);
     }
     static match(methods, path, handler) {
-        const builder = new RouterBuilder();
-        const routeMap = {};
-        for (const method of methods) {
-            const single = builder.buildSingle(method, path, handler);
-            const fullPath = Object.keys(single)[0];
-            const handlers = single[fullPath];
-            if (isEmpty(routeMap[fullPath]))
-                routeMap[fullPath] = {};
-            Object.assign(routeMap[fullPath], handlers);
-        }
-        return routeMap;
+        return new RouterBuilder().match(methods, path, handler);
     }
     static any(path, handler) {
-        return this.match(Enum.setEnums(HttpMethodEnum).toArray(), path, handler);
+        return new RouterBuilder().any(path, handler);
     }
 }