@wild-framework/queue 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/queue
+
+Job queue abstraction for [Wild Framework](https://github.com/your-org/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/queue
+```
+
+## Usage
+
+```ts
+import { Queue } from "@wild-framework/queue";
+
+class SendEmailJob {
+    constructor(private mail: MailService) {}
+    async handle(payload: { to: string }) {
+        await this.mail.send(payload.to);
+    }
+}
+
+await queue.dispatch(SendEmailJob, { to: "user@example.com" });
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { QueueProvider } from "./provider.js";
+export { Queue } from "./queue.js";
+export type { Job, JobConstructor } from "./queue.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,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { QueueProvider } from "./provider.js";
+export { Queue } from "./queue.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,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,12 @@
+import type { Provider, Application } from "@wild-framework/core";
+/**
+ * Registers the queue with the application.
+ *
+ * Binds an in-process `Queue` into the container. Swap for a
+ * distributed queue (e.g. BullMQ) by replacing this provider —
+ * the dispatch API stays the same.
+ */
+export declare class QueueProvider implements Provider {
+    register(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;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAKnC"}

package/dist/provider.js

@@ -0,0 +1,17 @@
+import { Container } from "@wild-framework/container";
+import { Queue } from "./queue.js";
+/**
+ * Registers the queue with the application.
+ *
+ * Binds an in-process `Queue` into the container. Swap for a
+ * distributed queue (e.g. BullMQ) by replacing this provider —
+ * the dispatch API stays the same.
+ */
+export class QueueProvider {
+    register(app) {
+        const container = app.resolve(Container);
+        const queue = new Queue(container);
+        container.singleton(Queue, () => queue);
+    }
+}
+//# 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,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACtB,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QACnC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;CACJ"}

package/dist/queue.d.ts

@@ -0,0 +1,36 @@
+import { Container } from "@wild-framework/container";
+/**
+ * A job that can be queued.
+ *
+ * Jobs are classes with a `handle()` method. The job class is resolved
+ * from the container (constructor DI), and `handle()` receives the
+ * dispatch payload.
+ */
+export interface Job<TPayload = unknown> {
+    handle(payload: TPayload): void | Promise<void>;
+}
+/**
+ * A job class constructor.
+ */
+export type JobConstructor<TPayload = unknown> = new () => Job<TPayload>;
+/**
+ * Queue.
+ *
+ * Currently an in-process queue — jobs are resolved from the container
+ * (so they get DI) and processed immediately on dispatch.
+ *
+ * Swapping to a distributed queue (e.g. BullMQ) later means replacing
+ * this implementation in QueueProvider — the dispatch API stays the same.
+ */
+export declare class Queue {
+    private container;
+    constructor(container: Container);
+    /**
+     * Dispatch a job with a payload.
+     *
+     * The job class is resolved from the container, then `handle(payload)`
+     * is called. Errors from the job propagate to the caller.
+     */
+    dispatch<TPayload>(job: JobConstructor<TPayload>, payload: TPayload): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,QAAQ,GAAG,OAAO;IACnC,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,GAAG,OAAO,IAAI,UAAU,GAAG,CAAC,QAAQ,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,qBAAa,KAAK;IACF,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAExC;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5F"}

package/dist/queue.js

@@ -0,0 +1,27 @@
+import { Container } from "@wild-framework/container";
+/**
+ * Queue.
+ *
+ * Currently an in-process queue — jobs are resolved from the container
+ * (so they get DI) and processed immediately on dispatch.
+ *
+ * Swapping to a distributed queue (e.g. BullMQ) later means replacing
+ * this implementation in QueueProvider — the dispatch API stays the same.
+ */
+export class Queue {
+    container;
+    constructor(container) {
+        this.container = container;
+    }
+    /**
+     * Dispatch a job with a payload.
+     *
+     * The job class is resolved from the container, then `handle(payload)`
+     * is called. Errors from the job propagate to the caller.
+     */
+    async dispatch(job, payload) {
+        const instance = this.container.resolve(job);
+        await instance.handle(payload);
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAkBtD;;;;;;;;GAQG;AACH,MAAM,OAAO,KAAK;IACM;IAApB,YAAoB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAE5C;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAW,GAA6B,EAAE,OAAiB;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAgB,GAAG,CAAC,CAAC;QAC5D,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@wild-framework/queue",
+  "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": "Job queue abstraction for Wild Framework.",
+  "keywords": [
+    "wild",
+    "framework",
+    "queue",
+    "jobs",
+    "worker"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.1.0",
+    "@wild-framework/container": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}