@bluelibs/runner 5.3.0 → 5.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluelibs/runner",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "BlueLibs Runner",
   "sideEffects": false,
   "main": "dist/universal/index.cjs",
@@ -110,7 +110,6 @@
     "@types/benchmark": "^2.1.5",
     "@types/busboy": "^1.5.4",
     "@types/express": "^5.0.3",
-    "@types/graphql": "^0.11.3",
     "@types/jest": "^27.0.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "8.39.0",

package/readmes/AI.md

@@ -4,7 +4,7 @@
 
 For the landing overview, see [README.md](../README.md). For the complete guide, see [FULL_GUIDE.md](./FULL_GUIDE.md).
 
-**Durable Workflows (Node-only):** For persistence and crash recovery, see `DURABLE_WORKFLOWS.md`. Includes `ctx.switch()` (replay-safe branching) and `durable.describe()` (DI-accurate flow shape export) — see `DURABLE_WORKFLOWS_AI.md` for quick reference.
+**Durable Workflows (Node-only):** For persistence and crash recovery, see `DURABLE_WORKFLOWS.md`. Includes `ctx.switch()` (replay-safe branching), `durable.describe()` (DI-accurate flow shape export), and `durableWorkflowTag.defaults` (default input for `describe(task)` when omitted) — see `DURABLE_WORKFLOWS_AI.md` for quick reference.
 
 ## Serializer Safety
 
@@ -298,9 +298,9 @@ const getUser = r
 
 ## Async Context
 
-Async Context provides per-request/thread-local state via the platform's `AsyncLocalStorage` (Node). Use the fluent builder under `r.asyncContext` or the classic `asyncContext({ ... })` export.
+Async Context provides per-request/thread-local state via the platform's `AsyncLocalStorage` (Node, and Deno when `AsyncLocalStorage` is available). Use the fluent builder under `r.asyncContext` or the classic `asyncContext({ ... })` export.
 
-> **Platform Note**: `AsyncLocalStorage` is Node.js-only. Async Context is unavailable in browsers/edge runtimes.
+> **Platform Note**: Async Context requires `AsyncLocalStorage`. It is available in Node.js and Deno (when exposed), and unavailable in browser runtimes.
 
 ```ts
 import { r } from "@bluelibs/runner";
@@ -339,6 +339,37 @@ const whoAmI = r
 const app = r.resource("app").register([requestContext, whoAmI]).build();
 ```
 
+## Queue
+
+`Queue` is a cooperative FIFO task queue. Tasks run one-after-another, with dead-lock detection and graceful disposal.
+
+The global resource `globals.resources.queue` provides a named queue factory — each `id` gets its own isolated `Queue` instance.
+
+**Key methods:**
+
+- `queue.run(id, task)` — schedule `task` (receives an `AbortSignal`) on the queue identified by `id`; creates the queue lazily.
+
+**Event lifecycle:** `enqueue` → `start` → `finish` | `error`. On disposal: `disposed`. On cancel: `cancel`.
+
+```ts
+import { r, run, globals } from "@bluelibs/runner";
+
+const processOrder = r
+  .task("app.tasks.processOrder")
+  .dependencies({ queue: globals.resources.queue })
+  .run(async (input: { orderId: string }, { queue }) => {
+    // Tasks with the same orderId run sequentially
+    return queue.run(input.orderId, async (signal) => {
+      if (signal.aborted) return;
+      // ... process order
+      return { processed: true };
+    });
+  })
+  .build();
+```
+
+For advanced usage, import `Queue` directly and use `on(type, handler)` / `once(type, handler)` to observe lifecycle events. Call `dispose({ cancel: true })` to abort in-flight work via the `AbortSignal`.
+
 ## Errors
 
 Define typed, namespaced errors with a fluent builder. Built helpers expose `throw` and `is`: