@skalfa/skalfa-cron 1.0.0 → 1.0.3

package/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+      - master
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Publish if version bumped
+        run: |
+          LOCAL_VER=$(node -p "require('./package.json').version")
+          NPM_VER=$(npm view @skalfa/skalfa-cron version 2>/dev/null || echo "0.0.0")
+          if [ "$LOCAL_VER" != "$NPM_VER" ]; then
+            echo "Publishing @skalfa/skalfa-cron $LOCAL_VER (Registry version: $NPM_VER)"
+            bun install
+            npm run build
+            npm publish --access public
+          else
+            echo "@skalfa/skalfa-cron is up to date ($LOCAL_VER)"
+          fi
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contributing to @skalfa/skalfa-cron
+
+Thank you for your interest in contributing to Skalfa! We welcome contributions from the community to help make Skalfa the premier development framework.
+
+## How to Contribute
+
+To contribute to this package, please follow these standard open-source steps:
+
+### 1. Fork the Repository
+Fork the official Skalfa repository on GitHub to your personal account.
+
+### 2. Clone Your Fork
+Clone your personal fork to your local machine:
+```bash
+git clone https://github.com/your-username/skalfa.git
+cd skalfa
+```
+
+### 3. Create a Feature Branch
+Create a new branch for your feature or bugfix:
+```bash
+git checkout -b feature/amazing-new-feature
+```
+*(Use `bugfix/issue-description` for bugfixes).*
+
+### 4. Implement and Commit Your Changes
+Make your changes in the codebase. Write clean, formatted code and ensure all tests and typechecks pass. Commit your changes using semantic commit messages:
+```bash
+git commit -m "feat: add amazing new feature"
+```
+*(Use `fix: description` for bugfixes, and `docs: description` for documentation updates).*
+
+### 5. Push to GitHub
+Push your branch to your personal fork on GitHub:
+```bash
+git push origin feature/amazing-new-feature
+```
+
+### 6. Submit a Pull Request (PR)
+Go to the official Skalfa repository on GitHub. You will see a prompt to submit a pull request. Click "New Pull Request", describe your changes in detail, link any related issues, and submit it for review by the maintainers.
+
+## Guidelines
+* **Code Style**: Ensure your code conforms to the project's ESLint rules and formatting guidelines.
+* **Type Safety**: Write strict, type-safe TypeScript. Do not bypass the compiler.
+* **Testing**: Run local tests and verify that the build compiles with 0 errors before submitting a PR.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skalfa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+<p align="center">
+  <img src="https://skalfa.sejedigital.com/images/logo-skalfa.png" alt="Skalfa Logo" width="300" />
+</p>
+
+# @skalfa/skalfa-cron
+
+> Automated background cron job scheduling and task worker utility extension for Skalfa backend services.
+
+---
+
+## About this Package
+
+This package is part of the **Skalfa Framework**, a premium development ecosystem designed to build high-performance, modular web applications and APIs.
+
+### Usage Scope & Standalone Status
+> 🔒 **Skalfa Ecosystem Integration:** This package is designed to run **integrated within the Skalfa ecosystem** (such as Skalfa API or Skalfa App). It relies on the global service registry and core framework abstractions to operate.
+
+---
+
+## Documentation
+
+See the usage documentation at [Documentation](https://skalfa.sejedigital.com).
+
+---
+
+## Installation
+
+You can install this package using your preferred package manager:
+
+```bash
+# Using npm
+npm install @skalfa/skalfa-cron
+
+# Using bun
+bun add @skalfa/skalfa-cron
+```
+
+---
+
+## Pre-installed Dependencies
+
+The following key dependencies are packaged and managed within this project:
+
+| Dependency | Scope | Version |
+| :--- | :--- | :--- |
+| `@skalfa/skalfa-api-core` | runtime | `file:../skalfa-api-core` |
+| `@types/node` | development | `^26.0.0` |
+| `typescript` | development | `^6.0.3` |
+
+---
+
+## License
+
+This package is licensed under the **MIT License**. For full license text, see the [LICENSE](LICENSE) file.

package/dist/add.d.ts

@@ -0,0 +1,2 @@
+import { CronJob } from "./state";
+export declare const add: (schedule: string, handler: CronJob["handler"], jobName?: string) => void;

package/dist/add.js

@@ -0,0 +1,6 @@
+import { jobs } from "./state";
+export const add = (schedule, handler, jobName) => {
+    const name = jobName || `Cronjob(${jobs.length + 1})`;
+    jobs.push({ name, schedule, handler, last: null });
+};
+//# sourceMappingURL=add.js.map

package/dist/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../src/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAW,MAAM,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,QAAoB,EACpB,OAAgC,EAChC,OAAoB,EACpB,EAAE;IACF,MAAM,IAAI,GAAG,OAAO,IAAI,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAA;IACrD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;AACpD,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,12 +1,9 @@
-export type CronJob = {
-    name: string;
-    schedule: string;
-    handler: () => Promise<void> | void;
-    last?: string | null;
-};
+import { parseSchedule } from "./parse-schedule";
+import { isScheduleMatch } from "./is-schedule-match";
+export type { CronJob } from "./state";
 export declare const cron: {
-    add: (schedule: string, handler: CronJob["handler"], jobName?: string) => void;
+    add: (schedule: string, handler: import("./state").CronJob["handler"], jobName?: string) => void;
     worker: () => void;
-    parseSchedule(value: number, pattern: string): boolean;
-    isScheduleMatch(schedule: string, date: Date): boolean;
+    parseSchedule: typeof parseSchedule;
+    isScheduleMatch: typeof isScheduleMatch;
 };

package/dist/index.js

@@ -1,69 +1,23 @@
-import { logger } from "@skalfa/skalfa-api-core";
-const jobs = [];
-const interval = Number(process.env.CRON_INTERVAL) || 10000;
+import { add } from "./add";
+import { worker } from "./worker";
+import { parseSchedule } from "./parse-schedule";
+import { isScheduleMatch } from "./is-schedule-match";
 export const cron = {
     // ===========================>
     // ## Cron: add new job
     // ===========================>
-    add: (schedule, handler, jobName) => {
-        const name = jobName || `Cronjob(${jobs.length + 1})`;
-        jobs.push({ name, schedule, handler, last: null });
-    },
+    add,
     // ===========================>
     // ## Cron: job worker
     // ===========================>
-    worker: () => {
-        setInterval(async () => {
-            const now = new Date();
-            const minuteKey = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()} ` + `${now.getHours()}:${now.getMinutes()}`;
-            for (const job of jobs) {
-                if (!cron.isScheduleMatch(job.schedule, now))
-                    continue;
-                if (job.last === minuteKey)
-                    continue;
-                job.last = minuteKey;
-                try {
-                    await job.handler();
-                    logger.cron(`${job.name} at (${now}) success!`);
-                }
-                catch (err) {
-                    const em = err instanceof Error ? err.message : String(err);
-                    logger.cronError(`${job.name} at (${now}) error : ${em}`, { error: em, reference: job.name, at: minuteKey });
-                }
-            }
-        }, interval);
-    },
+    worker,
     // ===========================>
     // ## Cron: job schedule parser
     // ===========================>
-    parseSchedule(value, pattern) {
-        if (pattern === "*")
-            return true;
-        if (pattern.includes(",")) {
-            return pattern.split(",").some((p) => this.parseSchedule(value, p));
-        }
-        if (pattern.includes("/")) {
-            const [base, step] = pattern.split("/");
-            const stepNum = Number(step);
-            if (base === "*")
-                return value % stepNum === 0;
-        }
-        if (pattern.includes("-")) {
-            const [start, end] = pattern.split("-").map(Number);
-            return value >= start && value <= end;
-        }
-        return Number(pattern) === value;
-    },
+    parseSchedule,
     // ===========================>
     // ## Cron: check job schedule
     // ===========================>
-    isScheduleMatch(schedule, date) {
-        const [min, hour, day, month, week] = schedule.split(" ");
-        return (this.parseSchedule(date.getMinutes(), min) &&
-            this.parseSchedule(date.getHours(), hour) &&
-            this.parseSchedule(date.getDate(), day) &&
-            this.parseSchedule(date.getMonth() + 1, month) &&
-            this.parseSchedule(date.getDay(), week));
-    },
+    isScheduleMatch,
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,+BAA+B;IAC/B,uBAAuB;IACvB,+BAA+B;IAC/B,GAAG;IAEH,+BAA+B;IAC/B,sBAAsB;IACtB,+BAA+B;IAC/B,MAAM;IAEN,+BAA+B;IAC/B,+BAA+B;IAC/B,+BAA+B;IAC/B,aAAa;IAEb,+BAA+B;IAC/B,8BAA8B;IAC9B,+BAA+B;IAC/B,eAAe;CAChB,CAAA"}

package/dist/is-schedule-match.d.ts

@@ -0,0 +1 @@
+export declare function isScheduleMatch(schedule: string, date: Date): boolean;

package/dist/is-schedule-match.js

@@ -0,0 +1,10 @@
+import { parseSchedule } from "./parse-schedule";
+export function isScheduleMatch(schedule, date) {
+    const [min, hour, day, month, week] = schedule.split(" ");
+    return (parseSchedule(date.getMinutes(), min) &&
+        parseSchedule(date.getHours(), hour) &&
+        parseSchedule(date.getDate(), day) &&
+        parseSchedule(date.getMonth() + 1, month) &&
+        parseSchedule(date.getDay(), week));
+}
+//# sourceMappingURL=is-schedule-match.js.map

package/dist/is-schedule-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-schedule-match.js","sourceRoot":"","sources":["../src/is-schedule-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAU;IAC1D,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEzD,OAAO,CACL,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC;QACrC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC;QAClC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC;QACzC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CACnC,CAAA;AACH,CAAC"}

package/dist/parse-schedule.d.ts

@@ -0,0 +1 @@
+export declare function parseSchedule(value: number, pattern: string): boolean;

package/dist/parse-schedule.js

@@ -0,0 +1,19 @@
+export function parseSchedule(value, pattern) {
+    if (pattern === "*")
+        return true;
+    if (pattern.includes(",")) {
+        return pattern.split(",").some((p) => parseSchedule(value, p));
+    }
+    if (pattern.includes("/")) {
+        const [base, step] = pattern.split("/");
+        const stepNum = Number(step);
+        if (base === "*")
+            return value % stepNum === 0;
+    }
+    if (pattern.includes("-")) {
+        const [start, end] = pattern.split("-").map(Number);
+        return value >= start && value <= end;
+    }
+    return Number(pattern) === value;
+}
+//# sourceMappingURL=parse-schedule.js.map

package/dist/parse-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-schedule.js","sourceRoot":"","sources":["../src/parse-schedule.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,OAAe;IAC1D,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAEhC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,KAAK,GAAG,OAAO,KAAK,CAAC,CAAA;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACnD,OAAO,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAA;IACvC,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,CAAA;AAClC,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,8 @@
+export type CronJob = {
+    name: string;
+    schedule: string;
+    handler: () => Promise<void> | void;
+    last?: string | null;
+};
+export declare const jobs: CronJob[];
+export declare const interval: number;

package/dist/state.js

@@ -0,0 +1,3 @@
+export const jobs = [];
+export const interval = Number(process.env.CRON_INTERVAL) || 10000;
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,IAAI,GAAgB,EAAE,CAAA;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAY,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK,CAAA"}

package/dist/worker.d.ts

@@ -0,0 +1 @@
+export declare const worker: () => void;

package/dist/worker.js

@@ -0,0 +1,25 @@
+import { logger } from "@skalfa/skalfa-api-core";
+import { jobs, interval } from "./state";
+import { isScheduleMatch } from "./is-schedule-match";
+export const worker = () => {
+    setInterval(async () => {
+        const now = new Date();
+        const minuteKey = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()} ` + `${now.getHours()}:${now.getMinutes()}`;
+        for (const job of jobs) {
+            if (!isScheduleMatch(job.schedule, now))
+                continue;
+            if (job.last === minuteKey)
+                continue;
+            job.last = minuteKey;
+            try {
+                await job.handler();
+                logger.cron(`${job.name} at (${now}) success!`);
+            }
+            catch (err) {
+                const em = err instanceof Error ? err.message : String(err);
+                logger.cronError(`${job.name} at (${now}) error : ${em}`, { error: em, reference: job.name, at: minuteKey });
+            }
+        }
+    }, interval);
+};
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE;IACzB,WAAW,CAAC,KAAK,IAAI,EAAE;QACrB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QAEtB,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAA;QAE1H,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC;gBAAE,SAAQ;YAEjD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAQ;YAEpC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAA;YAEpB,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,OAAO,EAAE,CAAA;gBACnB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,QAAQ,GAAG,YAAY,CAAC,CAAA;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,EAAE,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAC3D,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,QAAQ,GAAG,aAAa,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAC/G,CAAC;QACH,CAAC;IACH,CAAC,EAAE,QAAQ,CAAC,CAAA;AACd,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@skalfa/skalfa-cron",
-  "version": "1.0.0",
-  "description": "Cron utility package for Skalfa API framework.",
+  "version": "1.0.3",
+  "description": "Automated background cron job scheduling and task worker utility extension for Skalfa backend services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -15,7 +15,7 @@
   "author": "",
   "license": "UNLICENSED",
   "dependencies": {
-    "@skalfa/skalfa-api-core": "file:../skalfa-api-core"
+    "@skalfa/skalfa-api-core": "^1.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",

package/src/add.ts

@@ -0,0 +1,10 @@
+import { jobs, CronJob } from "./state";
+
+export const add = (
+  schedule   :  string,
+  handler    :  CronJob["handler"],
+  jobName   ?:  string
+) => {
+  const name = jobName || `Cronjob(${jobs.length + 1})`
+  jobs.push({ name, schedule, handler, last: null })
+};

package/src/index.ts

@@ -1,97 +1,28 @@
-import { logger } from "@skalfa/skalfa-api-core";
+import { add } from "./add";
+import { worker } from "./worker";
+import { parseSchedule } from "./parse-schedule";
+import { isScheduleMatch } from "./is-schedule-match";
 
-export type CronJob = {
-  name       :  string
-  schedule   :  string
-  handler    :  () => Promise<void> | void
-  last      ?:  string | null
-}
-
-const jobs: CronJob[]  =  []
-const interval         =  Number(process.env.CRON_INTERVAL) || 10000
+export type { CronJob } from "./state";
 
 export const cron = {
   // ===========================>
   // ## Cron: add new job
   // ===========================>
-  add: (
-    schedule   :  string,
-    handler    :  CronJob["handler"],
-    jobName   ?:  string
-  ) => {
-    const name = jobName || `Cronjob(${jobs.length + 1})`
-    jobs.push({ name, schedule, handler, last: null })
-  },
-
-
+  add,
 
   // ===========================>
   // ## Cron: job worker
   // ===========================>
-  worker: () => {
-    setInterval(async () => {
-      const now = new Date()
-
-      const minuteKey = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()} ` + `${now.getHours()}:${now.getMinutes()}`
-
-      for (const job of jobs) {
-        if (!cron.isScheduleMatch(job.schedule, now)) continue
-
-        if (job.last === minuteKey) continue
-
-        job.last = minuteKey
-
-        try {
-          await job.handler()
-          logger.cron(`${job.name} at (${now}) success!`)
-        } catch (err) {
-          const em = err instanceof Error ? err.message : String(err)
-          logger.cronError(`${job.name} at (${now}) error : ${em}`, { error: em, reference: job.name, at: minuteKey });
-        }
-      }
-    }, interval)
-  },
-
-
+  worker,
 
   // ===========================>
   // ## Cron: job schedule parser
   // ===========================>
-  parseSchedule(value: number, pattern: string): boolean {
-    if (pattern === "*") return true
-
-    if (pattern.includes(",")) {
-      return pattern.split(",").some((p) => this.parseSchedule(value, p))
-    }
-
-    if (pattern.includes("/")) {
-      const [base, step] = pattern.split("/")
-      const stepNum = Number(step)
-      if (base === "*") return value % stepNum === 0
-    }
-
-    if (pattern.includes("-")) {
-      const [start, end] = pattern.split("-").map(Number)
-      return value >= start && value <= end
-    }
-
-    return Number(pattern) === value
-  },
-
-
+  parseSchedule,
 
   // ===========================>
   // ## Cron: check job schedule
   // ===========================>
-  isScheduleMatch(schedule: string, date: Date): boolean {
-    const [min, hour, day, month, week] = schedule.split(" ")
-
-    return (
-      this.parseSchedule(date.getMinutes(), min) &&
-      this.parseSchedule(date.getHours(), hour) &&
-      this.parseSchedule(date.getDate(), day) &&
-      this.parseSchedule(date.getMonth() + 1, month) &&
-      this.parseSchedule(date.getDay(), week)
-    )
-  },
+  isScheduleMatch,
 }

package/src/is-schedule-match.ts

@@ -0,0 +1,13 @@
+import { parseSchedule } from "./parse-schedule";
+
+export function isScheduleMatch(schedule: string, date: Date): boolean {
+  const [min, hour, day, month, week] = schedule.split(" ")
+
+  return (
+    parseSchedule(date.getMinutes(), min) &&
+    parseSchedule(date.getHours(), hour) &&
+    parseSchedule(date.getDate(), day) &&
+    parseSchedule(date.getMonth() + 1, month) &&
+    parseSchedule(date.getDay(), week)
+  )
+}

package/src/parse-schedule.ts

@@ -0,0 +1,20 @@
+export function parseSchedule(value: number, pattern: string): boolean {
+  if (pattern === "*") return true
+
+  if (pattern.includes(",")) {
+    return pattern.split(",").some((p) => parseSchedule(value, p))
+  }
+
+  if (pattern.includes("/")) {
+    const [base, step] = pattern.split("/")
+    const stepNum = Number(step)
+    if (base === "*") return value % stepNum === 0
+  }
+
+  if (pattern.includes("-")) {
+    const [start, end] = pattern.split("-").map(Number)
+    return value >= start && value <= end
+  }
+
+  return Number(pattern) === value
+}

package/src/state.ts

@@ -0,0 +1,9 @@
+export type CronJob = {
+  name       :  string
+  schedule   :  string
+  handler    :  () => Promise<void> | void
+  last      ?:  string | null
+}
+
+export const jobs: CronJob[]  =  []
+export const interval         =  Number(process.env.CRON_INTERVAL) || 10000

package/src/worker.ts

@@ -0,0 +1,27 @@
+import { logger } from "@skalfa/skalfa-api-core";
+import { jobs, interval } from "./state";
+import { isScheduleMatch } from "./is-schedule-match";
+
+export const worker = () => {
+  setInterval(async () => {
+    const now = new Date()
+
+    const minuteKey = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()} ` + `${now.getHours()}:${now.getMinutes()}`
+
+    for (const job of jobs) {
+      if (!isScheduleMatch(job.schedule, now)) continue
+
+      if (job.last === minuteKey) continue
+
+      job.last = minuteKey
+
+      try {
+        await job.handler()
+        logger.cron(`${job.name} at (${now}) success!`)
+      } catch (err) {
+        const em = err instanceof Error ? err.message : String(err)
+        logger.cronError(`${job.name} at (${now}) error : ${em}`, { error: em, reference: job.name, at: minuteKey });
+      }
+    }
+  }, interval)
+};

package/bun.lock

@@ -1,82 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "@skalfa/skalfa-cron",
-      "dependencies": {
-        "@skalfa/skalfa-api-core": "file:../skalfa-api-core",
-      },
-      "devDependencies": {
-        "@types/node": "^26.0.0",
-        "typescript": "^6.0.3",
-      },
-    },
-  },
-  "packages": {
-    "@borewit/text-codec": ["@borewit/text-codec@0.2.2", "", {}, "sha512-DDaRehssg1aNrH4+2hnj1B7vnUGEjU6OIlyRdkMd0aUdIUvKXrJfXsy8LVtXAy7DRvYVluWbMspsRhz2lcW0mQ=="],
-
-    "@sinclair/typebox": ["@sinclair/typebox@0.34.49", "", {}, "sha512-brySQQs7Jtn0joV8Xh9ZV/hZb9Ozb0pmazDIASBkYKCjXrXU3mpcFahmK/z4YDhGkQvP9mWJbVyahdtU5wQA+A=="],
-
-    "@skalfa/skalfa-api-core": ["@skalfa/skalfa-api-core@file:../skalfa-api-core", { "dependencies": { "@skalfa/skalfa-orm": "file:../skalfa-orm", "bcrypt": "^6.0.0", "commander": "^12.1.0", "dotenv": "^17.2.2", "elysia": "latest", "nodemailer": "^7.0.9", "validator": "^13.15.15" }, "devDependencies": { "@types/bcrypt": "^6.0.0", "@types/node": "^26.0.0", "@types/nodemailer": "^7.0.2", "@types/validator": "^13.15.3", "bun-types": "latest", "typescript": "^6.0.3" } }],
-
-    "@tokenizer/inflate": ["@tokenizer/inflate@0.4.1", "", { "dependencies": { "debug": "^4.4.3", "token-types": "^6.1.1" } }, "sha512-2mAv+8pkG6GIZiF1kNg1jAjh27IDxEPKwdGul3snfztFerfPGI1LjDezZp3i7BElXompqEtPmoPx6c2wgtWsOA=="],
-
-    "@tokenizer/token": ["@tokenizer/token@0.3.0", "", {}, "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A=="],
-
-    "@types/bcrypt": ["@types/bcrypt@6.0.0", "", { "dependencies": { "@types/node": "*" } }, "sha512-/oJGukuH3D2+D+3H4JWLaAsJ/ji86dhRidzZ/Od7H/i8g+aCmvkeCc6Ni/f9uxGLSQVCRZkX2/lqEFG2BvWtlQ=="],
-
-    "@types/node": ["@types/node@26.0.0", "", { "dependencies": { "undici-types": "~8.3.0" } }, "sha512-vf2YFi1iY9lHGwNJMs01biZFbKJkrZR1T6/MlzjhJLPdntOHLhTrDSnSVcdtvjihi4VQNlrFRIxLsDBlQpAipA=="],
-
-    "@types/nodemailer": ["@types/nodemailer@7.0.12", "", { "dependencies": { "@types/node": "*" } }, "sha512-80vKwiIsVSyFA1rRovH59jNPLBOuc6dRZIHEu40gXTkBkZnQv8vog1xSGEb9j5q/tdMAs5ivvDR2pLTU0hGHXA=="],
-
-    "@types/validator": ["@types/validator@13.15.10", "", {}, "sha512-T8L6i7wCuyoK8A/ZeLYt1+q0ty3Zb9+qbSSvrIVitzT3YjZqkTZ40IbRsPanlB4h1QB3JVL1SYCdR6ngtFYcuA=="],
-
-    "bcrypt": ["bcrypt@6.0.0", "", { "dependencies": { "node-addon-api": "^8.3.0", "node-gyp-build": "^4.8.4" } }, "sha512-cU8v/EGSrnH+HnxV2z0J7/blxH8gq7Xh2JFT6Aroax7UohdmiJJlxApMxtKfuI7z68NvvVcmR78k2LbT6efhRg=="],
-
-    "bun-types": ["bun-types@1.3.14", "", { "dependencies": { "@types/node": "*" } }, "sha512-4N0ig0fEomHt5R0KCFWjovxow98rIoRwKolrYdCcknNwMekCXRnWEUvgu5soYV8QXtVsrUD8B95MBOZGPvr6KQ=="],
-
-    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
-
-    "cookie": ["cookie@1.1.1", "", {}, "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ=="],
-
-    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
-
-    "dotenv": ["dotenv@17.4.2", "", {}, "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw=="],
-
-    "elysia": ["elysia@1.4.29", "", { "dependencies": { "cookie": "^1.1.1", "exact-mirror": "^0.2.7", "fast-decode-uri-component": "^1.0.1", "memoirist": "^0.4.0" }, "peerDependencies": { "@sinclair/typebox": ">= 0.34.0 < 1", "@types/bun": ">= 1.2.0", "file-type": ">= 20.0.0", "openapi-types": ">= 12.0.0", "typescript": ">= 5.0.0" }, "optionalPeers": ["@types/bun", "typescript"] }, "sha512-GwMRGGwSdjfPt+w3LA0fqTuYJtS8uVRJicvoar98/HrO5qdFKDc9CwjIb6Kja+v39lkY+58hr2JvdR9jQzlUuA=="],
-
-    "exact-mirror": ["exact-mirror@0.2.7", "", { "peerDependencies": { "@sinclair/typebox": "^0.34.15" }, "optionalPeers": ["@sinclair/typebox"] }, "sha512-+MeEmDcLA4o/vjK2zujgk+1VTxPR4hdp23qLqkWfStbECtAq9gmsvQa3LW6z/0GXZyHJobrCnmy1cdeE7BjsYg=="],
-
-    "fast-decode-uri-component": ["fast-decode-uri-component@1.0.1", "", {}, "sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg=="],
-
-    "file-type": ["file-type@22.0.1", "", { "dependencies": { "@tokenizer/inflate": "^0.4.1", "strtok3": "^10.3.5", "token-types": "^6.1.2", "uint8array-extras": "^1.5.0" } }, "sha512-ww5Mhre0EE+jmBvOXTmXAbEMuZE7uX4a3+oRCQFNj8w++g3ev913N6tXQz0XTXbueQ5TWQfm6BdaViEHHn8bhA=="],
-
-    "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
-
-    "memoirist": ["memoirist@0.4.0", "", {}, "sha512-zxTgA0mSYELa66DimuNQDvyLq36AwDlTuVRbnQtB+VuTcKWm5Qc4z3WkSpgsFWHNhexqkIooqpv4hdcqrX5Nmg=="],
-
-    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
-
-    "node-addon-api": ["node-addon-api@8.8.0", "", {}, "sha512-c5Ko1fZJIJmzhFIkhRN76WTq+fC6tWnGy9CXA0fA+XygsWZmEwG8vmbkNqxMyoaa0Tin4djul49NzdVcJJcjeA=="],
-
-    "node-gyp-build": ["node-gyp-build@4.8.4", "", { "bin": { "node-gyp-build": "bin.js", "node-gyp-build-optional": "optional.js", "node-gyp-build-test": "build-test.js" } }, "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ=="],
-
-    "nodemailer": ["nodemailer@7.0.13", "", {}, "sha512-PNDFSJdP+KFgdsG3ZzMXCgquO7I6McjY2vlqILjtJd0hy8wEvtugS9xKRF2NWlPNGxvLCXlTNIae4serI7dinw=="],
-
-    "openapi-types": ["openapi-types@12.1.3", "", {}, "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw=="],
-
-    "strtok3": ["strtok3@10.3.5", "", { "dependencies": { "@tokenizer/token": "^0.3.0" } }, "sha512-ki4hZQfh5rX0QDLLkOCj+h+CVNkqmp/CMf8v8kZpkNVK6jGQooMytqzLZYUVYIZcFZ6yDB70EfD8POcFXiF5oA=="],
-
-    "token-types": ["token-types@6.1.2", "", { "dependencies": { "@borewit/text-codec": "^0.2.1", "@tokenizer/token": "^0.3.0", "ieee754": "^1.2.1" } }, "sha512-dRXchy+C0IgK8WPC6xvCHFRIWYUbqqdEIKPaKo/AcTUNzwLTK6AH7RjdLWsEZcAN/TBdtfUw3PYEgPr5VPr6ww=="],
-
-    "typescript": ["typescript@6.0.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw=="],
-
-    "uint8array-extras": ["uint8array-extras@1.5.0", "", {}, "sha512-rvKSBiC5zqCCiDZ9kAOszZcDvdAHwwIKJG33Ykj43OKcWsnmcBRL09YTU4nOeHZ8Y2a7l1MgTd08SBe9A8Qj6A=="],
-
-    "undici-types": ["undici-types@8.3.0", "", {}, "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ=="],
-
-    "validator": ["validator@13.15.35", "", {}, "sha512-TQ5pAGhd5whStmqWvYF4OjQROlmv9SMFVt37qoCBdqRffuuklWYQlCNnEs2ZaIBD1kZRNnikiZOS1eqgkar0iw=="],
-
-    "@skalfa/skalfa-api-core/@skalfa/skalfa-orm": ["@skalfa/skalfa-orm@file:..\\skalfa-orm", {}],
-  }
-}