@ferricstore/ferricstore 0.13.1 → 0.13.3

package/README.md

@@ -34,13 +34,15 @@ covers every public adapter class and option.
 
 ## Compatibility
 
-TypeScript SDK `0.13.1` requires FerricStore server `0.11.4` or newer. With
+TypeScript SDK `0.13.3` requires FerricStore server `0.11.4` or newer. With
 FerricStore 0.11.11 it negotiates compact Stream mode 34 for homogeneous auto-ID
 `XADD` pipelines and compact Pub/Sub mode 35 for homogeneous `PUBLISH`
 pipelines. Native wire protocol v1 and the generic fallback are unchanged.
 Capabilities and response-size limits are negotiated
 per connection from the HELLO-shaped startup response rather than inferred from
-a server version table.
+a server version table. Durable rewind reason attribution requires FerricStore
+OSS `0.11.19` or newer; older supported servers still perform the rewind state
+transition without persisting the reason reference.
 
 ESM:
 
@@ -60,7 +62,7 @@ const { FerricStoreClient, JsonCodec } = require("@ferricstore/ferricstore");
 docker run -p 6388:6388 \
   -e FERRICSTORE_PROTECTED_MODE=false \
   -v ferricstore_data:/data \
-  quay.io/ferricstore/ferricstore:0.11.14@sha256:f7d29befefa15bce4b3755bf786cf7620c814f13bbd336c0d9955581b323b60e
+  quay.io/ferricstore/ferricstore:0.11.19@sha256:6275175c71a75f2d2a47c30c47a6561f994d8a5e31570fc8bd11a9f6ebcb6b31
 ```
 
 ## Query durable runs
@@ -150,7 +152,7 @@ Run the complete HTTP-compatible integration surface through a real TLS
 listener with ACL authentication using:
 
 ```bash
-FERRICSTORE_IMAGE=quay.io/ferricstore/ferricstore:0.11.14@sha256:f7d29befefa15bce4b3755bf786cf7620c814f13bbd336c0d9955581b323b60e \
+FERRICSTORE_IMAGE=quay.io/ferricstore/ferricstore:0.11.19@sha256:6275175c71a75f2d2a47c30c47a6561f994d8a5e31570fc8bd11a9f6ebcb6b31 \
   npm run test:integration:http
 ```
 
@@ -414,6 +416,16 @@ still need the same stable provider idempotency key. The closure runs in the
 calling worker's JavaScript execution context; the SDK does not move it to a
 global thread pool.
 
+A waiting workflow does not occupy a worker. Persist a timer, signal, approval,
+or scheduled state and return the waiting transition so the current claim is
+released. When the wait condition is satisfied, any available worker can acquire
+a fresh lease and continue from the stored state. If no worker is
+running, the workflow remains durable until one becomes available.
+
+`stepContinue()` remains available only as a deprecated low-level migration API.
+Use `advance(job, { toState })` for a state-only transition and
+`step(job, { name, run, toState })` when the closure result must be journaled.
+
 `nowMs` is an explicit client timestamp sent with a command. When omitted, the
 SDK samples the client wall clock separately for each request. It is intended
 mainly for deterministic tests and is not a server-response timestamp or a

package/dist/index.cjs

@@ -6985,7 +6985,8 @@ function buildProtocolCommand(args, maxBodyBytes = Number.MAX_SAFE_INTEGER, allo
       "NOW",
       "PARTITION",
       "TO_EVENT",
-      "EXPECT_STATE"
+      "EXPECT_STATE",
+      "REASON"
     ]));
   }
   if (command === "FLOW.COMPLETE_MANY") {
@@ -18071,6 +18072,7 @@ var FerricStoreFlowSupportClient = class extends FerricStoreFlowQueryClient {
     append(args, "PARTITION", partitionKey);
     append(args, "TO_EVENT", options.toEvent);
     append(args, "EXPECT_STATE", options.expectState);
+    appendEncoded(args, "REASON", this.codec, options.reason);
     const response = await this.commandArgs(args);
     if (returnRecord) {
       return await this.recordOrGet(response, id, partitionKey);
@@ -18681,6 +18683,8 @@ var FerricStoreClaimClient = class extends FerricStoreMutationClient {
     }
     if (jobOnly) {
       append(args, "RETURN", compactClaimReturnMode2(captured.includeState === true, captured.includeAttributes === true));
+    } else {
+      args.push("RETURN", "RECORDS");
     }
     append(args, "BLOCK", captured.blockMs);
     appendPayloadRead(args, captured.payload, captured.payloadMaxBytes);
@@ -18755,6 +18759,8 @@ var FerricStoreClaimClient = class extends FerricStoreMutationClient {
     append(args, "PRIORITY", captured.priority);
     if (jobOnly) {
       append(args, "RETURN", compactClaimReturnMode2(true, captured.includeAttributes === true));
+    } else {
+      args.push("RETURN", "RECORDS");
     }
     appendPayloadRead(args, captured.payload, captured.payloadMaxBytes);
     appendValueReturn(args, { values: captured.values, valueMaxBytes: captured.valueMaxBytes });
@@ -21982,7 +21988,7 @@ function throwError(value) {
 }
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.13.1";
+var FERRICSTORE_SDK_VERSION = "0.13.3";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 // Annotate the CommonJS export names for ESM import in node: