@vielzeug/codex 2.3.0 → 2.3.1

package/data/catalog.json

@@ -124,7 +124,7 @@
         "refine"
       ],
       "slug": "assay",
-      "version": "2.1.0"
+      "version": "2.1.1"
     },
     {
       "availableDocPages": [
@@ -167,7 +167,7 @@
         "ward"
       ],
       "slug": "clockwork",
-      "version": "2.1.0"
+      "version": "2.2.0"
     },
     {
       "availableDocPages": [
@@ -196,7 +196,7 @@
         "refine"
       ],
       "slug": "codex",
-      "version": "2.2.9"
+      "version": "2.3.0"
     },
     {
       "availableDocPages": [
@@ -242,7 +242,7 @@
         "spell"
       ],
       "slug": "coins",
-      "version": "2.1.0"
+      "version": "2.1.1"
     },
     {
       "availableDocPages": [
@@ -281,7 +281,7 @@
         "rune"
       ],
       "slug": "conduit",
-      "version": "2.0.1"
+      "version": "2.1.0"
     },
     {
       "availableDocPages": [
@@ -327,7 +327,7 @@
         "spell"
       ],
       "slug": "courier",
-      "version": "2.2.2"
+      "version": "2.3.0"
     },
     {
       "availableDocPages": [
@@ -372,7 +372,7 @@
         "refine"
       ],
       "slug": "dnd",
-      "version": "2.0.1"
+      "version": "2.1.0"
     },
     {
       "availableDocPages": [
@@ -415,7 +415,7 @@
         "herald"
       ],
       "slug": "familiar",
-      "version": "2.0.2"
+      "version": "2.1.0"
     },
     {
       "availableDocPages": [
@@ -479,7 +479,7 @@
         "courier"
       ],
       "slug": "flux",
-      "version": "2.3.2"
+      "version": "2.3.3"
     },
     {
       "availableDocPages": [
@@ -514,7 +514,7 @@
         "ore"
       ],
       "slug": "focus",
-      "version": "2.1.0"
+      "version": "2.1.1"
     },
     {
       "availableDocPages": [
@@ -559,7 +559,7 @@
         "courier"
       ],
       "slug": "forge",
-      "version": "2.2.1"
+      "version": "2.3.0"
     },
     {
       "availableDocPages": [
@@ -592,7 +592,7 @@
         "keymap"
       ],
       "slug": "gesture",
-      "version": "1.1.0"
+      "version": "1.1.1"
     },
     {
       "availableDocPages": [
@@ -643,7 +643,7 @@
         "familiar"
       ],
       "slug": "herald",
-      "version": "2.1.0"
+      "version": "2.2.0"
     },
     {
       "availableDocPages": [
@@ -686,7 +686,7 @@
         "tempo"
       ],
       "slug": "illusionist",
-      "version": "2.3.0"
+      "version": "2.3.1"
     },
     {
       "availableDocPages": [
@@ -733,7 +733,7 @@
         "ore"
       ],
       "slug": "keymap",
-      "version": "2.1.0"
+      "version": "2.2.0"
     },
     {
       "availableDocPages": [
@@ -774,7 +774,7 @@
         "vault"
       ],
       "slug": "ledger",
-      "version": "2.2.2"
+      "version": "2.2.3"
     },
     {
       "availableDocPages": [
@@ -820,7 +820,7 @@
         "courier"
       ],
       "slug": "lingua",
-      "version": "2.3.0"
+      "version": "2.4.0"
     },
     {
       "availableDocPages": [
@@ -857,7 +857,7 @@
         "ore"
       ],
       "slug": "necromancer",
-      "version": "2.0.2"
+      "version": "2.1.0"
     },
     {
       "availableDocPages": [
@@ -897,7 +897,7 @@
         "prism"
       ],
       "slug": "orbit",
-      "version": "2.1.2"
+      "version": "2.1.3"
     },
     {
       "availableDocPages": [
@@ -961,7 +961,7 @@
         "orbit"
       ],
       "slug": "ore",
-      "version": "2.0.11"
+      "version": "2.1.0"
     },
     {
       "availableDocPages": [
@@ -973,7 +973,8 @@
       "category": "Async",
       "description": "Typed durable job outbox with leased processing, retries, and dead-letter recovery for browser applications.",
       "exampleIds": [
-        "define-jobs"
+        "define-jobs",
+        "delayed-enqueue"
       ],
       "exports": [
         "createPostmaster",
@@ -1004,7 +1005,7 @@
         "ripple"
       ],
       "slug": "postmaster",
-      "version": "1.0.0"
+      "version": "2.0.0"
     },
     {
       "availableDocPages": [
@@ -1061,7 +1062,7 @@
         "orbit"
       ],
       "slug": "prism",
-      "version": "2.2.3"
+      "version": "2.2.4"
     },
     {
       "availableDocPages": [
@@ -1124,7 +1125,7 @@
         "clockwork"
       ],
       "slug": "pulse",
-      "version": "2.2.2"
+      "version": "2.3.0"
     },
     {
       "availableDocPages": [
@@ -1222,7 +1223,7 @@
         "keymap"
       ],
       "slug": "refine",
-      "version": "2.2.4"
+      "version": "2.2.5"
     },
     {
       "availableDocPages": [
@@ -1274,7 +1275,7 @@
         "ledger"
       ],
       "slug": "ripple",
-      "version": "2.2.3"
+      "version": "2.2.4"
     },
     {
       "availableDocPages": [
@@ -1328,7 +1329,7 @@
         "familiar"
       ],
       "slug": "rune",
-      "version": "2.1.0"
+      "version": "2.1.1"
     },
     {
       "availableDocPages": [
@@ -1427,7 +1428,7 @@
         "ripple"
       ],
       "slug": "scout",
-      "version": "2.2.2"
+      "version": "2.3.0"
     },
     {
       "availableDocPages": [
@@ -1480,7 +1481,7 @@
         "refine"
       ],
       "slug": "scroll",
-      "version": "2.1.2"
+      "version": "2.2.0"
     },
     {
       "availableDocPages": [
@@ -1522,7 +1523,7 @@
         "gesture"
       ],
       "slug": "sentinel",
-      "version": "2.0.1"
+      "version": "2.0.2"
     },
     {
       "availableDocPages": [
@@ -1589,7 +1590,7 @@
         "wayfinder"
       ],
       "slug": "sourcerer",
-      "version": "2.2.0"
+      "version": "2.2.1"
     },
     {
       "availableDocPages": [
@@ -1648,7 +1649,7 @@
         "vault"
       ],
       "slug": "spell",
-      "version": "2.1.2"
+      "version": "2.2.0"
     },
     {
       "availableDocPages": [
@@ -1715,7 +1716,7 @@
         "vault"
       ],
       "slug": "tempo",
-      "version": "2.1.1"
+      "version": "2.1.2"
     },
     {
       "availableDocPages": [
@@ -1767,7 +1768,7 @@
         "ripple"
       ],
       "slug": "vault",
-      "version": "2.3.1"
+      "version": "2.4.0"
     },
     {
       "availableDocPages": [
@@ -1826,7 +1827,7 @@
         "herald"
       ],
       "slug": "ward",
-      "version": "2.1.0"
+      "version": "2.2.0"
     },
     {
       "availableDocPages": [
@@ -1878,8 +1879,8 @@
         "herald"
       ],
       "slug": "wayfinder",
-      "version": "2.1.0"
+      "version": "2.2.0"
     }
   ],
-  "version": "2.2.9"
+  "version": "2.3.0"
 }

package/data/llms-full.txt

@@ -1,6 +1,6 @@
 # Vielzeug — Full Documentation
 
-> Complete documentation for 37 packages. Version: 2.2.9
+> Complete documentation for 37 packages. Version: 2.3.0
 
 ---
 
@@ -14450,7 +14450,7 @@ await store.dispose();
 
 - `defineJobs()` — Typed job registry with payload inference and validation.
 - `createPostmaster()` — Processor with leased claims, heartbeat renewal, and crash recovery.
-- `enqueue()` — Persist a job and wake the processor.
+- `enqueue()` — Persist a job and wake the processor, with optional delayed eligibility via `availableAt`.
 - `flush()` — Process every available job until the queue is empty.
 - `retry()` / `remove()` — Recover or discard dead-letter jobs.
 - `tap()` — Typed runtime events for enqueued, started, completed, retry-scheduled, dead-lettered, removed, lease-lost, and processor-error.
@@ -14617,10 +14617,28 @@ await store.dispose();
 ### `enqueue()`
 
 ```ts
-enqueue(name: K, payload: InferJobPayload): Promise;
+enqueue(
+  name: K,
+  payload: InferJobPayload,
+  options?: EnqueueOptions,
+): Promise;
 ```
 
-Validates the payload (if `validate` is defined), derives the key, persists the job, and wakes the processor. Throws `PostmasterError` for an empty key or non-JSON-serializable payload.
+Validates the payload (if `validate` is defined), derives the key, persists the job, and wakes the processor. Throws `PostmasterError` for an empty key, non-JSON-serializable payload, or invalid `availableAt`.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `name` | `K` | Registered job name |
+| `payload` | `InferJobPayload` | Job payload (validated if `validate` is defined) |
+| `options.availableAt` | `number` | Earliest epoch timestamp (ms) the job may be claimed. Defaults to the Postmaster clock. Must be a finite non-negative safe integer. |
+
+**Delayed eligibility.** The job persists immediately but cannot be claimed before `availableAt`. Postmaster does not guarantee execution at that time — only that the job will not be claimed earlier. A live processor (`start()` or `flush()`) is required for execution. Past timestamps remain immediately eligible.
+
+**Example**
+
+```ts
+await postmaster.enqueue('sendDigest', { userId }, { availableAt: Date.now() + 60_000 });
+```
 
 ---
 
@@ -14705,6 +14723,18 @@ Aborts owned work, releases all active leases, and tears down subscriptions. Ide
 
 ## Types
 
+### `EnqueueOptions`
+
+```ts
+interface EnqueueOptions {
+  readonly availableAt?: number;
+}
+```
+
+Options for `enqueue()`. `availableAt` is the earliest epoch timestamp (ms) at which the job may be claimed. Defaults to the Postmaster clock at enqueue time. Past timestamps remain immediately eligible. Postmaster does not guarantee execution at the requested time — only that the job will not be claimed before it. A live processor is required for execution.
+
+---
+
 ### `JobDefinition`
 
 ```ts
@@ -15054,6 +15084,16 @@ const jobs = defineJobs({
 - Delay must be finite and non-negative.
 - Lifecycle aborts caused by disposal are not classified as job failures.
 
+## Delayed eligibility
+
+`enqueue()` accepts an optional `availableAt` timestamp. The job persists immediately but cannot be claimed before that time. Use this for scheduled writes, cooldowns, or any work that must survive a reload but should not run yet.
+
+```ts
+await postmaster.enqueue('sendDigest', { userId }, { availableAt: Date.now() + 60_000 });
+```
+
+Postmaster does not guarantee execution at `availableAt` — only that the job will not be claimed earlier. A live processor (`start()` or `flush()`) is required for execution. In a browser, a closed page or suspended service worker will run the job when the processor next becomes active. Past timestamps remain immediately eligible. The same mechanism already backs retry delays, so delayed eligibility reuses the existing claim, wake, and persistence paths.
+
 ## Dead-letter recovery
 
 Jobs that exhaust retries or hit a terminal failure move to dead-letter. Inspect, retry, or remove them.
@@ -15327,12 +15367,14 @@ The IndexedDB adapter is built on Vault. Use Vault directly for unrelated storag
 
 - [Queue Offline Courier Mutations](./examples/queue-offline-courier-mutations.md)
 - [Resume When Network Returns](./examples/resume-when-network-returns.md)
+- [Delayed Eligibility](./examples/delayed-eligibility.md)
 - [Recover Dead-Letter Jobs](./examples/recover-dead-letter-jobs.md)
 - [Service Worker Background Sync](./examples/service-worker-background-sync.md)
 
 ### REPL Examples
 
 - defineJobs - Basic Outbox (id: `define-jobs`)
+- delayedEnqueue - Delayed Eligibility (id: `delayed-enqueue`)
 
 ---
 

package/data/llms.txt

@@ -1,6 +1,6 @@
 # Vielzeug
 
-> 37 focused TypeScript packages. Version: 2.2.9
+> 37 focused TypeScript packages. Version: 2.3.0
 
 Install any package independently: `pnpm add @vielzeug/<name>`
 

package/data/manifest.json

@@ -4,5 +4,5 @@
   "refine": "refine.json",
   "schemaVersion": 1,
   "search": "search.json",
-  "version": "2.2.9"
+  "version": "2.3.0"
 }