@bejibun/core 0.1.41 → 0.1.43

package/CHANGELOG.md

@@ -3,6 +3,43 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [v0.1.43](https://github.com/crenata/bejibun-core/compare/v0.1.42...v0.1.43) - 2025-10-21
+
+### 🩹 Fixes
+
+### 📖 Changes
+What's New :
+- Adding `maintenance:down` to turn app into maintenance mode
+- Adding `maintenance:up` to turn app into live mode
+- Adding maintenance middleware
+
+### ❤️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.42](https://github.com/crenata/bejibun-core/compare/v0.1.41...v0.1.42) - 2025-10-21
+
+### 🩹 Fixes
+- Fix controller path on router builder
+
+### 📖 Changes
+What's New :
+- Adding base exception handler
+- Adding runtime exception
+- Adding `server.ts` for init serve
+
+### ❤️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.41](https://github.com/crenata/bejibun-core/compare/v0.1.40...v0.1.41) - 2025-10-20
 
 ### 🩹 Fixes

package/bases/BaseModel.js

@@ -26,7 +26,7 @@ export default class BaseModel extends Model {
     static QueryBuilder = BunQueryBuilder;
     static get namespace() {
         const filePath = fileURLToPath(import.meta.url);
-        const rel = relative(App.rootPath(), filePath);
+        const rel = relative(App.Path.rootPath(), filePath);
         const withoutExt = rel.replace(/\.[tj]s$/, "");
         const namespaces = withoutExt.split(sep);
         namespaces.pop();

package/builders/RouterBuilder.js

@@ -110,8 +110,8 @@ export default class RouterBuilder {
         if (isEmpty(controllerName) || isEmpty(methodName)) {
             throw new RouterInvalidException(`Invalid router controller definition: ${definition}.`);
         }
-        const controllerPath = path.resolve(App.rootPath(), this.baseNamespace);
-        const location = Bun.resolveSync(`${controllerName}.ts`, controllerPath);
+        const controllerPath = path.resolve(App.Path.rootPath(), this.baseNamespace);
+        const location = Bun.resolveSync(`./${controllerName}.ts`, controllerPath);
         let ControllerClass;
         try {
             ControllerClass = require(location).default;

package/commands/Kernel.d.ts

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

package/commands/Kernel.js

@@ -1,12 +1,18 @@
 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 commandsDirectoryCore = path.resolve(__dirname);
-        const files = this.commands(commandsDirectoryCore)
-            .concat(this.commands(App.commandsPath()));
+        const rootCommands = Array.from(new Bun.Glob("**/*.ts").scanSync({
+            absolute: true,
+            cwd: App.Path.commandsPath()
+        }));
+        const internalCommands = Array.from(new Bun.Glob("**/*").scanSync({
+            absolute: true,
+            cwd: __dirname
+        }));
+        const files = internalCommands.concat(rootCommands).filter(value => (/\.(m?js|ts)$/.test(value) &&
+            !value.endsWith(".d.ts") &&
+            !value.includes("Kernel"))).reverse();
         for (const file of files) {
             const { default: CommandClass } = require(file);
             const instance = new CommandClass();
@@ -33,22 +39,4 @@ export default class Kernel {
             });
         }
     }
-    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/maintenance/MaintenanceDownCommand.js

@@ -1,4 +1,4 @@
-import App from "@bejibun/app";
+import AppConfig from "@bejibun/app/config/app";
 import Logger from "@bejibun/logger";
 import { DateTime } from "luxon";
 export default class MaintenanceDownCommand {
@@ -29,7 +29,7 @@ export default class MaintenanceDownCommand {
      */
     $arguments = [];
     async handle(options, args) {
-        await Bun.write(App.storagePath("framework/maintenance.down.json"), JSON.stringify({
+        await Bun.write(AppConfig.maintenance.file, JSON.stringify({
             message: "🚧 We're doing maintenance. Please check back soon.",
             status: 503,
             allows: options.allows,

package/commands/maintenance/MaintenanceUpCommand.d.ts

@@ -0,0 +1,27 @@
+export default class MaintenanceUpCommand {
+    /**
+     * 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/MaintenanceUpCommand.js

@@ -0,0 +1,33 @@
+import AppConfig from "@bejibun/app/config/app";
+import Logger from "@bejibun/logger";
+export default class MaintenanceUpCommand {
+    /**
+     * The name and signature of the console command.
+     *
+     * @var $signature string
+     */
+    $signature = "maintenance:up";
+    /**
+     * The console command description.
+     *
+     * @var $description string
+     */
+    $description = "Turn app into live mode";
+    /**
+     * The options or optional flag of the console command.
+     *
+     * @var $options Array<Array<any>>
+     */
+    $options = [];
+    /**
+     * The arguments of the console command.
+     *
+     * @var $arguments Array<Array<string>>
+     */
+    $arguments = [];
+    async handle(options, args) {
+        if (await Bun.file(AppConfig.maintenance.file).exists())
+            await Bun.file(AppConfig.maintenance.file).delete();
+        Logger.setContext("APP").info("Application turned into live mode.");
+    }
+}

package/config/database.js

@@ -25,7 +25,7 @@ const config = {
     }
 };
 export const initDatabase = () => {
-    const configPath = App.configPath("database.ts");
+    const configPath = App.Path.configPath("database.ts");
     let _config;
     if (fs.existsSync(configPath))
         _config = require(configPath).default;

package/exceptions/ExceptionHandler.d.ts

@@ -0,0 +1,7 @@
+import { ValidationError } from "objection";
+import ModelNotFoundException from "../exceptions/ModelNotFoundException";
+import ValidatorException from "../exceptions/ValidatorException";
+export default class ExceptionHandler {
+    handle(error: Bun.ErrorLike | ModelNotFoundException | ValidatorException | ValidationError): globalThis.Response;
+    route(request: Bun.BunRequest): globalThis.Response;
+}

package/exceptions/ExceptionHandler.js

@@ -0,0 +1,33 @@
+import Logger from "@bejibun/logger";
+import { defineValue } from "@bejibun/utils";
+import HttpMethodEnum from "@bejibun/utils/enums/HttpMethodEnum";
+import { ValidationError } from "objection";
+import ModelNotFoundException from "../exceptions/ModelNotFoundException";
+import ValidatorException from "../exceptions/ValidatorException";
+import Response from "../facades/Response";
+export default class ExceptionHandler {
+    handle(error) {
+        Logger.setContext("APP").error(error.message).trace(error.stack);
+        if (error instanceof ModelNotFoundException ||
+            error instanceof ValidatorException)
+            return Response
+                .setMessage(error.message)
+                .setStatus(error.code)
+                .send();
+        if (error instanceof ValidationError)
+            return Response
+                .setMessage(error.message)
+                .setStatus(error.statusCode)
+                .send();
+        return Response
+            .setMessage(defineValue(error.message, "Internal server error."))
+            .setStatus(500)
+            .send();
+    }
+    route(request) {
+        return Response
+            .setMessage("What are you looking for doesn't exists.")
+            .setStatus(request.method === HttpMethodEnum.Options ? 204 : 404)
+            .send();
+    }
+}

package/exceptions/RuntimeException.d.ts

@@ -0,0 +1,4 @@
+export default class RuntimeException extends Error {
+    code: number;
+    constructor(message?: string, code?: number);
+}

package/exceptions/RuntimeException.js

@@ -0,0 +1,14 @@
+import Logger from "@bejibun/logger";
+import { defineValue } from "@bejibun/utils";
+export default class RuntimeException extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "RuntimeException";
+        this.code = defineValue(code, 500);
+        Logger.setContext(this.name).error(this.message).trace(this.stack);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, RuntimeException);
+        }
+    }
+}

package/exceptions/index.d.ts

@@ -1,3 +1,4 @@
+export * from "../exceptions/ExceptionHandler";
 export * from "../exceptions/ModelNotFoundException";
 export * from "../exceptions/RouterInvalidException";
 export * from "../exceptions/ValidatorException";

package/exceptions/index.js

@@ -1,3 +1,4 @@
+export * from "../exceptions/ExceptionHandler";
 export * from "../exceptions/ModelNotFoundException";
 export * from "../exceptions/RouterInvalidException";
 export * from "../exceptions/ValidatorException";

package/middlewares/MaintenanceMiddleware.d.ts

@@ -0,0 +1,4 @@
+import type { HandlerType } from "../types/router";
+export default class MaintenanceMiddleware {
+    handle(handler: HandlerType): HandlerType;
+}

package/middlewares/MaintenanceMiddleware.js

@@ -0,0 +1,16 @@
+import App from "@bejibun/app";
+import Response from "../facades/Response";
+export default class MaintenanceMiddleware {
+    handle(handler) {
+        return async (request) => {
+            if (await App.Maintenance.isMaintenanceMode()) {
+                const maintenance = await App.Maintenance.getData();
+                return Response
+                    .setMessage(maintenance.message)
+                    .setStatus(maintenance.status)
+                    .send();
+            }
+            return handler(request);
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bejibun/core",
-    "version": "0.1.41",
+    "version": "0.1.43",
     "author": "Havea Crenata <havea.crenata@gmail.com>",
     "repository": {
         "type": "git",
@@ -9,8 +9,8 @@
     "main": "index.js",
     "module": "index.js",
     "dependencies": {
-        "@bejibun/app": "^0.1.12",
-        "@bejibun/cors": "^0.1.11",
+        "@bejibun/app": "^0.1.19",
+        "@bejibun/cors": "^0.1.12",
         "@bejibun/logger": "^0.1.18",
         "@bejibun/utils": "^0.1.14",
         "@vinejs/vine": "^3.0.1",

package/server.d.ts

@@ -0,0 +1 @@
+export {};

package/server.js

@@ -0,0 +1,49 @@
+import App from "@bejibun/app";
+import Logger from "@bejibun/logger";
+import RuntimeException from "./exceptions/RuntimeException";
+import Router from "./facades/Router";
+import MaintenanceMiddleware from "./middlewares/MaintenanceMiddleware";
+import(App.Path.rootPath("bootstrap.ts"));
+const exceptionHandlerPath = App.Path.appPath("exceptions/handler.ts");
+let ExceptionHandler;
+try {
+    ExceptionHandler = require(exceptionHandlerPath).default;
+}
+catch {
+    throw new RuntimeException(`Missing exception handler class [${exceptionHandlerPath}].`);
+}
+const apiRoutesPath = App.Path.routesPath("api.ts");
+let ApiRoutes;
+try {
+    ApiRoutes = require(apiRoutesPath).default;
+}
+catch {
+    throw new RuntimeException(`Missing api file on routes directory [${apiRoutesPath}].`);
+}
+const webRoutesPath = App.Path.routesPath("web.ts");
+let WebRoutes;
+try {
+    WebRoutes = require(webRoutesPath).default;
+}
+catch {
+    throw new RuntimeException(`Missing web file on routes directory [${webRoutesPath}].`);
+}
+const server = Bun.serve({
+    development: Bun.env.NODE_ENV !== "production" && {
+        // Enable browser hot reloading in development
+        hmr: true,
+        // Echo console logs from the browser to the server
+        console: true
+    },
+    error: new ExceptionHandler().handle,
+    port: Bun.env.APP_PORT,
+    routes: {
+        "/": require(App.Path.publicPath("index.html")),
+        ...Router.middleware(new MaintenanceMiddleware()).group([
+            Router.namespace("app/exceptions").any("/*", "Handler@route"),
+            ApiRoutes,
+            WebRoutes
+        ])
+    }
+});
+Logger.setContext("APP").info(`🚀 Server running at ${server.url.origin}`);

package/types/router.d.ts

@@ -1,5 +1,3 @@
-import type {BunRequest} from "bun";
-
-export type HandlerType = (request: BunRequest) => Promise<Response>;
+export type HandlerType = (request: Bun.BunRequest) => Promise<Response>;
 export type RouterGroup = Record<string, Record<string, HandlerType>>;
 export type ResourceAction = "index" | "store" | "show" | "update" | "destroy";