@bejibun/core 0.2.0 → 0.2.11

package/CHANGELOG.md

@@ -3,7 +3,38 @@ All notable changes to this project will be documented in this file.
 
 ---
 
-## [v0.2.0](https://github.com/Bejibun-Framework/bejibun-core/compare/v0.1.73...v0.2.0) - 2026-02-02
+## [v0.2.11](https://github.com/Bejibun-Framework/bejibun-core/compare/v0.2.1...v0.2.11) - 2026-02-13
+
+### 🩹 Fixes
+
+### 📖 Changes
+#### Upgrade [@bejibun/cors](https://github.com/Bejibun-Framework/bejibun-cors) to v0.1.17
+[https://github.com/Bejibun-Framework/bejibun-cors/releases/tag/v0.1.17](https://github.com/Bejibun-Framework/bejibun-cors/releases/tag/v0.1.17)
+
+### ❤️Contributors
+- Havea Crenata ([@crenata](https://github.com/crenata))
+
+**Full Changelog**: https://github.com/Bejibun-Framework/bejibun-core/blob/master/CHANGELOG.md
+
+---
+
+## [v0.2.1](https://github.com/Bejibun-Framework/bejibun-core/compare/v0.2.0...v0.2.1) - 2026-02-13
+
+### 🩹 Fixes
+
+### 📖 Changes
+- Added `queue:flush` to flush all failed queue jobs.
+- Added `queue:retry` to retry a failed queue job.
+- Close database connection after using command.
+
+### ❤️Contributors
+- Havea Crenata ([@crenata](https://github.com/crenata))
+
+**Full Changelog**: https://github.com/Bejibun-Framework/bejibun-core/blob/master/CHANGELOG.md
+
+---
+
+## [v0.2.0](https://github.com/Bejibun-Framework/bejibun-core/compare/v0.1.73...v0.2.0) - 2026-02-12
 
 ### 🩹 Fixes
 - Invalid namespace for model - [#15](https://github.com/Bejibun-Framework/bejibun-core/issues/15)
@@ -16,7 +47,8 @@ All notable changes to this project will be documented in this file.
 
 #### What's New :
 - Epoch Timestamp Trait
-- Queue Jobs
+- Job Dispatch
+- Queue Worker
 
 #### What is Epoch Timestamp Trait?
 Override default model timestamps for `created_at`, `updated_at`, and `deleted_at` to unix timestamp.

package/README.md

@@ -562,6 +562,17 @@ await Storage.build({
 }).delete("path/to/your/file.ext");
 ```
 
+### Queue
+Run processes at background.
+
+```ts
+// Immediately
+await TestJob.dispatch(/*any params here*/).send();
+
+// With delay
+await TestJob.dispatch(/*any params here*/).delay(60 * 10 /*10 minutes*/).send();
+```
+
 ### Cors
 Documentation : [@bejibun/cors](https://github.com/Bejibun-Framework/bejibun-cors/blob/master/README.md)
 
@@ -589,6 +600,7 @@ Commands:
   maintenance:up               Turn app into live mode
   make:command <file>          Create a new command file
   make:controller <file>       Create a new controller file
+  make:job <file>              Create a new job file
   make:middleware <file>       Create a new middleware file
   make:migration <file>        Create a new migration file
   make:model <file>            Create a new model file
@@ -599,6 +611,9 @@ Commands:
   migrate:rollback [options]   Rollback the latest migrations
   migrate:status [options]     List migrations status
   package:configure [options]  Configure package after installation
+  queue:flush                  Flush all of the failed queue jobs
+  queue:retry                  Retry a failed queue job
+  queue:work                   Start processing jobs on the queue as a daemon
   help [command]               display help for command
 
 Examples:

package/ace.js

@@ -1,8 +1,10 @@
+import App from "@bejibun/app";
 import Str from "@bejibun/utils/facades/Str";
 import { program } from "commander";
 import os from "os";
 import Kernel from "./commands/Kernel";
 import { version } from "package.json";
+await import(App.Path.rootPath("bootstrap.ts"));
 const commandExec = "ace";
 program
     .name(commandExec)

package/commands/Kernel.js

@@ -1,5 +1,6 @@
 import App from "@bejibun/app";
 import { defineValue, isEmpty } from "@bejibun/utils";
+import BaseModel from "../bases/BaseModel";
 export default class Kernel {
     static registerCommands(program) {
         const rootCommands = require(App.Path.configPath("command.ts")).default;
@@ -55,7 +56,12 @@ export default class Kernel {
                 const commandObj = args[args.length - 1];
                 const options = typeof commandObj.opts === "function" ? commandObj.opts() : commandObj;
                 const positionalArgs = args[0];
-                await instance.handle(options, positionalArgs);
+                try {
+                    await instance.handle(options, positionalArgs);
+                }
+                finally {
+                    await BaseModel.knex().destroy();
+                }
             });
         }
     }

package/commands/queue/QueueFlushCommand.d.ts

@@ -0,0 +1,27 @@
+export default class QueueFlushCommand {
+    /**
+     * 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: string): Promise<void>;
+}

package/commands/queue/QueueFlushCommand.js

@@ -0,0 +1,32 @@
+import Logger from "@bejibun/logger";
+import JobModel from "../../models/JobModel";
+export default class QueueFlushCommand {
+    /**
+     * The name and signature of the console command.
+     *
+     * @var $signature string
+     */
+    $signature = "queue:flush";
+    /**
+     * The console command description.
+     *
+     * @var $description string
+     */
+    $description = "Flush all of the failed queue jobs";
+    /**
+     * 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) {
+        await JobModel.query().where("attempts", ">=", 3).delete();
+        Logger.setContext("Queue").info("All failed jobs deleted successfully.");
+    }
+}

package/commands/queue/QueueRetryCommand.d.ts

@@ -0,0 +1,27 @@
+export default class QueueRetryCommand {
+    /**
+     * 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: string): Promise<void>;
+}

package/commands/queue/QueueRetryCommand.js

@@ -0,0 +1,74 @@
+import App from "@bejibun/app";
+import Logger from "@bejibun/logger";
+import { defineValue, isEmpty } from "@bejibun/utils";
+import RuntimeException from "../../exceptions/RuntimeException";
+import JobModel from "../../models/JobModel";
+export default class QueueRetryCommand {
+    /**
+     * The name and signature of the console command.
+     *
+     * @var $signature string
+     */
+    $signature = "queue:retry";
+    /**
+     * The console command description.
+     *
+     * @var $description string
+     */
+    $description = "Retry a failed queue job";
+    /**
+     * 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) {
+        let running = true;
+        process.on("exit", async () => {
+            running = false;
+            Logger.setContext("Queue").info("Queue worker stopped.");
+        });
+        process.on("SIGINT", async () => {
+            running = false;
+            Logger.setContext("Queue").info("Stopping queue worker, SIGINT sent.");
+        });
+        process.on("SIGTERM", async () => {
+            running = false;
+            Logger.setContext("Queue").info("Stopping queue worker, SIGTERM sent.");
+        });
+        while (running) {
+            const job = await JobModel.query().where("attempts", ">=", 3).orderBy("id", "asc").first();
+            if (isEmpty(job?.id)) {
+                running = false;
+            }
+            else {
+                const handler = async () => {
+                    const module = await import(App.Path.rootPath(job.queue));
+                    const Class = module.default;
+                    if (isEmpty(Class))
+                        throw new RuntimeException(`Job class not found [${job.queue}].`);
+                    const instance = new Class();
+                    if (typeof instance.handle !== "function")
+                        throw new RuntimeException(`Job class has no handle function in [${job.queue}].`);
+                    instance.handle(JSON.parse(job.payload));
+                };
+                try {
+                    await handler();
+                    await JobModel.query().findById(job.id).delete();
+                }
+                catch {
+                    await JobModel.query().findById(job.id).update({
+                        attempts: defineValue(Number(job.attempts), 0) + 1
+                    });
+                }
+            }
+        }
+        Logger.setContext("Queue").info("All failed jobs retried successfully.");
+    }
+}

package/commands/queue/QueueWorkCommand.js

@@ -29,7 +29,6 @@ export default class QueueWorkCommand {
      */
     $arguments = [];
     async handle(options, args) {
-        await import(App.Path.rootPath("bootstrap.ts"));
         let running = true;
         process.on("exit", async () => {
             running = false;
@@ -67,6 +66,5 @@ export default class QueueWorkCommand {
                 }
             }
         }
-        process.exit(0);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bejibun/core",
-    "version": "0.2.0",
+    "version": "0.2.11",
     "author": "Havea Crenata <havea.crenata@gmail.com>",
     "repository": {
         "type": "git",
@@ -11,7 +11,7 @@
     "dependencies": {
         "@bejibun/app": "^0.1.23",
         "@bejibun/cache": "^0.1.18",
-        "@bejibun/cors": "^0.1.16",
+        "@bejibun/cors": "^0.1.17",
         "@bejibun/database": "^0.1.19",
         "@bejibun/logger": "^0.1.22",
         "@bejibun/utils": "^0.1.28",

package/server.js

@@ -5,7 +5,7 @@ import RuntimeException from "./exceptions/RuntimeException";
 import Router from "./facades/Router";
 import MaintenanceMiddleware from "./middlewares/MaintenanceMiddleware";
 import RateLimiterMiddleware from "./middlewares/RateLimiterMiddleware";
-import(App.Path.rootPath("bootstrap.ts"));
+await import(App.Path.rootPath("bootstrap.ts"));
 export default class Server {
     get exceptionHandler() {
         const exceptionHandlerPath = App.Path.appPath("exceptions/handler.ts");