enqiu 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -3,7 +3,22 @@
 All notable changes to this project are documented here. The project follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.0] - Unreleased
+## [0.1.2] - 2026-08-02
+
+### Added
+
+- Added runnable Vitest consumer examples for the in-memory driver and an
+  opt-in Redis integration using isolated namespaces and deterministic cleanup.
+- Added `pnpm test:example` and README guidance for testing application jobs
+  through Enqiu's public API.
+
+## [0.1.1] - 2026-08-02
+
+### Changed
+
+- Updated the package contact email to `it@worksonmy.dev`.
+
+## [0.1.0] - 2026-07-27
 
 ### Changed
 

package/README.md

@@ -63,6 +63,48 @@ const jobs = enqiu({
 });
 ```
 
+## Testing in your project
+
+Create a fresh queue for each test so workers and queued state never leak
+between cases. This Vitest example uses the in-memory driver, awaits the public
+job handle, checks the persisted status, and always closes the worker:
+
+```ts
+import { afterEach, describe, expect, it } from "vitest";
+import { createJobs } from "./jobs.js";
+
+let jobs: ReturnType<typeof createJobs> | undefined;
+
+afterEach(async () => {
+  await jobs?.worker.close();
+  jobs = undefined;
+});
+
+describe("email jobs", () => {
+  it("returns and stores the handler result", async () => {
+    jobs = createJobs();
+    const handle = await jobs.sendWelcome({ name: "Ada" });
+
+    await expect(handle.result).resolves.toEqual({ subject: "Welcome, Ada" });
+    expect((await handle.refresh()).status).toBe("succeeded");
+  });
+});
+```
+
+Install and run it with:
+
+```bash
+pnpm add enqiu
+pnpm add -D vitest
+pnpm vitest run
+```
+
+The repository keeps the complete, runnable
+[memory and opt-in Redis examples](https://github.com/moji2002/enqiu/tree/main/examples/testing).
+The Redis test runs only when `ENQIU_TEST_REDIS_URL` is set, uses a unique
+namespace instead of flushing the database, and closes the worker before the
+injected Redis client.
+
 ## Redis
 
 Inject an existing client; Enqiu does not create connections or install a Redis

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "enqiu",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A type-safe job queue for Node.js and Bun with memory and Redis drivers",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -22,6 +22,7 @@
     "typecheck": "tsc --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json",
     "test": "vitest run",
+    "test:example": "pnpm run build && vitest run examples/testing",
     "test:watch": "vitest",
     "check": "pnpm run typecheck && pnpm run typecheck:test && pnpm run test && pnpm run build",
     "prepack": "pnpm run check"