@wild-framework/scheduling 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+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,28 @@
+# @wild-framework/scheduling
+
+Task scheduling for [Wild Framework](https://github.com/your-org/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/scheduling
+```
+
+## Usage
+
+```ts
+import { Scheduler } from "@wild-framework/scheduling";
+
+scheduler.every(60_000, async () => {
+    await cleanupExpiredSessions();
+});
+
+// Job class (resolved from the container for DI)
+scheduler.every(5 * 60_000, SyncProductsJob);
+```
+
+The `SchedulerProvider` starts tasks on boot and stops them on shutdown.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Scheduler } from "./scheduler.js";
+export { SchedulerProvider } from "./provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Scheduler } from "./scheduler.js";
+export { SchedulerProvider } from "./provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,13 @@
+import type { Provider, Application } from "@wild-framework/core";
+/**
+ * Registers the scheduler with the application.
+ *
+ * Binds a `Scheduler` into the container. Starts scheduled tasks
+ * on boot and stops them on shutdown.
+ */
+export declare class SchedulerProvider implements Provider {
+    register(app: Application): void;
+    boot(app: Application): void;
+    shutdown(app: Application): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIlE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAMhC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAK5B,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAInC"}

package/dist/provider.js

@@ -0,0 +1,24 @@
+import { Container } from "@wild-framework/container";
+import { Scheduler } from "./scheduler.js";
+/**
+ * Registers the scheduler with the application.
+ *
+ * Binds a `Scheduler` into the container. Starts scheduled tasks
+ * on boot and stops them on shutdown.
+ */
+export class SchedulerProvider {
+    register(app) {
+        const container = app.resolve(Container);
+        const scheduler = new Scheduler(container);
+        container.singleton(Scheduler, () => scheduler);
+    }
+    boot(app) {
+        const scheduler = app.resolve(Scheduler);
+        scheduler.start();
+    }
+    shutdown(app) {
+        const scheduler = app.resolve(Scheduler);
+        scheduler.stop();
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IAC1B,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,GAAgB;QACjB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAY,SAAS,CAAC,CAAC;QACpD,SAAS,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAY,SAAS,CAAC,CAAC;QACpD,SAAS,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACJ"}

package/dist/scheduler.d.ts

@@ -0,0 +1,45 @@
+import { Container } from "@wild-framework/container";
+/**
+ * A scheduled task's run logic.
+ */
+type TaskCallback = () => void | Promise<void>;
+/**
+ * A job class with a no-arg `handle()` method.
+ * Resolved from the container so jobs get DI.
+ */
+type JobConstructor = new () => {
+    handle(): void | Promise<void>;
+};
+/**
+ * Interval-based scheduler.
+ *
+ * Tasks are registered with `every()`, started via `start()`,
+ * and stopped via `stop()`. Job classes are resolved from the
+ * container, so scheduled jobs get constructor DI.
+ */
+export declare class Scheduler {
+    private container;
+    private tasks;
+    constructor(container: Container);
+    /**
+     * Schedule a task to run every `intervalMs`.
+     *
+     * Accepts either a callback or a job class (resolved from the container).
+     */
+    every(intervalMs: number, task: TaskCallback | JobConstructor): void;
+    /**
+     * Start all scheduled tasks.
+     */
+    start(): void;
+    /**
+     * Stop all scheduled tasks.
+     */
+    stop(): void;
+    /**
+     * Number of scheduled tasks.
+     */
+    taskCount(): number;
+    private resolveTask;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD;;GAEG;AACH,KAAK,YAAY,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/C;;;GAGG;AACH,KAAK,cAAc,GAAG,UAAU;IAAE,MAAM,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAWnE;;;;;;GAMG;AACH,qBAAa,SAAS;IAGN,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,KAAK,CAAc;gBAEP,SAAS,EAAE,SAAS;IAExC;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI;IAKpE;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB,OAAO,CAAC,WAAW;CAUtB"}

package/dist/scheduler.js

@@ -0,0 +1,64 @@
+import { Container } from "@wild-framework/container";
+/**
+ * Interval-based scheduler.
+ *
+ * Tasks are registered with `every()`, started via `start()`,
+ * and stopped via `stop()`. Job classes are resolved from the
+ * container, so scheduled jobs get constructor DI.
+ */
+export class Scheduler {
+    container;
+    tasks = [];
+    constructor(container) {
+        this.container = container;
+    }
+    /**
+     * Schedule a task to run every `intervalMs`.
+     *
+     * Accepts either a callback or a job class (resolved from the container).
+     */
+    every(intervalMs, task) {
+        const callback = this.resolveTask(task);
+        this.tasks.push({ intervalMs, callback });
+    }
+    /**
+     * Start all scheduled tasks.
+     */
+    start() {
+        for (const task of this.tasks) {
+            if (!task.timer) {
+                task.timer = setInterval(() => {
+                    void task.callback();
+                }, task.intervalMs);
+            }
+        }
+    }
+    /**
+     * Stop all scheduled tasks.
+     */
+    stop() {
+        for (const task of this.tasks) {
+            if (task.timer) {
+                clearInterval(task.timer);
+                task.timer = undefined;
+            }
+        }
+    }
+    /**
+     * Number of scheduled tasks.
+     */
+    taskCount() {
+        return this.tasks.length;
+    }
+    resolveTask(task) {
+        if (typeof task === "function" && task.prototype?.handle) {
+            // Job class — resolve from the container each run
+            return async () => {
+                const instance = this.container.resolve(task);
+                await instance.handle();
+            };
+        }
+        return task;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAsBtD;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAGE;IAFZ,KAAK,GAAW,EAAE,CAAC;IAE3B,YAAoB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAE5C;;;;OAIG;IACH,KAAK,CAAC,UAAkB,EAAE,IAAmC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;oBAC1B,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACzB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACxB,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI;QACA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAEO,WAAW,CAAC,IAAmC;QACnD,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvD,kDAAkD;YAClD,OAAO,KAAK,IAAI,EAAE;gBACd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAqC,IAAI,CAAC,CAAC;gBAClF,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC5B,CAAC,CAAC;QACN,CAAC;QACD,OAAO,IAAoB,CAAC;IAChC,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@wild-framework/scheduling",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Task scheduling for Wild Framework.",
+  "keywords": [
+    "wild",
+    "framework",
+    "scheduler",
+    "cron",
+    "tasks"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.1.0",
+    "@wild-framework/container": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}