@ferricstore/ferricstore 0.13.0 → 0.13.1

package/dist/index.js

@@ -30,9 +30,16 @@ var FerricStoreError = class extends Error {
 };
 var HTTPTransportError = class extends FerricStoreError {
   code = "http_transport";
+  requestDisposition;
   statusCode;
   constructor(message, options = {}) {
-    super(message, options);
+    const disposition = options.requestDisposition;
+    super(message, {
+      ...options,
+      retryable: options.retryable ?? (disposition === "unsent" ? false : void 0),
+      safeToRetry: options.safeToRetry ?? (disposition === "unsent" ? true : disposition === "possibly_sent" ? false : void 0)
+    });
+    this.requestDisposition = disposition;
     this.statusCode = options.statusCode;
   }
 };
@@ -57,6 +64,20 @@ var RequestTimeoutError = class extends FerricStoreError {
     this.timeoutMs = timeoutMs;
   }
 };
+var RequestNotSentError = class extends FerricStoreError {
+  code = "request_not_sent";
+  requestDisposition = "unsent";
+  constructor(message, options = {}) {
+    super(message, { ...options, retryable: false, safeToRetry: true });
+  }
+};
+function requestNotSentError(error, message) {
+  if (error instanceof RequestNotSentError) return error;
+  return new RequestNotSentError(
+    message ?? (error instanceof Error ? error.message : String(error)),
+    { cause: error, raw: error }
+  );
+}
 var FlowNotFoundError = class extends FerricStoreError {
   code = "flow_not_found";
 };
@@ -6315,7 +6336,10 @@ function decodeCompactPipeline(data, budget, claimModes) {
       );
       offset = read.offset;
     } else {
-      throw new FerricStoreError("unknown compact pipeline status");
+      throw new FerricStoreError(`unknown compact pipeline status ${status}`, {
+        retryable: false,
+        safeToRetry: false
+      });
     }
   }
   if (offset !== data.byteLength) throw new FerricStoreError("trailing compact pipeline bytes");
@@ -6485,6 +6509,7 @@ var COUNTED_COMPACT_TAGS = /* @__PURE__ */ new Set([
 ]);
 
 // src/protocol-response.ts
+var KNOWN_NATIVE_RESPONSE_STATUSES = /* @__PURE__ */ new Set([0, 1, 2, 3, 4, 5, 6]);
 function decodeResponse(frame, expectedOpcode, hints = {}) {
   if (frame.opcode !== expectedOpcode) {
     throw new FerricStoreError(
@@ -6509,6 +6534,13 @@ function decodeResponse(frame, expectedOpcode, hints = {}) {
     customPayload
   );
   if (status === STATUS_OK) return value;
+  if (!KNOWN_NATIVE_RESPONSE_STATUSES.has(status)) {
+    throw new FerricStoreError(`unknown native response status ${status}`, {
+      raw: value,
+      retryable: false,
+      safeToRetry: false
+    });
+  }
   const message = protocolErrorMessage(status, value);
   throw classifyServerError(message, value, void 0, status);
 }
@@ -6548,7 +6580,7 @@ function unwrapPipelineResponse(value, options = {}, expectedItems) {
           continue;
         }
         const error = classifyServerError(
-          protocolErrorMessage(status === "busy" ? 4 : 1, payload),
+          protocolErrorMessage(pipelineStatusCode(status), payload),
           payload,
           void 0,
           status
@@ -6557,15 +6589,46 @@ function unwrapPipelineResponse(value, options = {}, expectedItems) {
         out[index] = error;
         continue;
       }
+      if (pipelineStatusToken(item[0]) != null) {
+        const unknown = pipelineStatusToken(item[0]) ?? "unknown";
+        const error = new FerricStoreError(`unknown native pipeline status ${JSON.stringify(unknown)}`, {
+          raw: item,
+          retryable: false,
+          safeToRetry: false
+        });
+        if (options.throwOnItemError !== false) throw error;
+        out[index] = error;
+        continue;
+      }
     }
     out[index] = item;
   }
   return out;
 }
 function pipelineStatus(value) {
+  const status = pipelineStatusToken(value);
+  if (status == null) return null;
+  return status === "ok" || status === "error" || status === "auth" || status === "noperm" || status === "busy" || status === "reroute" || status === "bad_request" ? status : null;
+}
+function pipelineStatusToken(value) {
   if (typeof value !== "string" && !Buffer26.isBuffer(value) && !(value instanceof Uint8Array)) return null;
-  const status = asText(value).toLowerCase();
-  return status === "ok" || status === "busy" || status === "error" ? status : null;
+  return asText(value).toLowerCase();
+}
+function pipelineStatusCode(status) {
+  switch (status) {
+    case "error":
+      return 1;
+    case "auth":
+      return 2;
+    case "noperm":
+      return 3;
+    case "busy":
+      return 4;
+    case "reroute":
+      return 5;
+    case "bad_request":
+      return 6;
+  }
 }
 function decodeResponseValue(opcode, body, hints, allowCompact, customPayload) {
   if (customPayload && allowCompact) {
@@ -8225,6 +8288,22 @@ function plainRecord(value) {
   return value;
 }
 
+// src/native-command-preparation.ts
+function prepareNativeCommand(args, maxFrameBytes) {
+  try {
+    return buildProtocolCommand(args, maxFrameBytes);
+  } catch (error) {
+    throw requestNotSentError(error);
+  }
+}
+function encodeNativeRequest(command, requestId, maxFrameBytes) {
+  try {
+    return encodeRequest(command, requestId, maxFrameBytes);
+  } catch (error) {
+    throw requestNotSentError(error);
+  }
+}
+
 // src/native-adapter.ts
 var NativeAdapter = class _NativeAdapter {
   socket;
@@ -8332,15 +8411,13 @@ var NativeAdapter = class _NativeAdapter {
     return await this.executeCommandArgs(args);
   }
   async executeCommandArgs(args) {
-    const command = buildProtocolCommand(args, this.capabilities.requestFrameBytes);
+    const command = prepareNativeCommand(args, this.capabilities.requestFrameBytes);
     return await this.request(command);
   }
   /** @internal Execute raw command arguments on a topology-selected lane. */
   async executeCommandOnLane(args, laneId) {
-    return await this.executeProtocolCommand(
-      buildProtocolCommand(args, this.capabilities.requestFrameBytes),
-      laneId
-    );
+    const command = prepareNativeCommand(args, this.capabilities.requestFrameBytes);
+    return await this.executeProtocolCommand(command, laneId);
   }
   async executeProtocolCommand(command, laneId) {
     return await this.request(laneId == null ? command : { ...command, laneId });
@@ -8434,14 +8511,14 @@ var NativeAdapter = class _NativeAdapter {
     let frame;
     try {
       requestId = this.requestScheduler.nextRequestId();
-      frame = encodeRequest(
+      frame = encodeNativeRequest(
         withFlowQueryDeadline(command, timeoutMs),
         requestId,
         this.capabilities.requestFrameBytes
       );
     } catch (error) {
       if (hasFlowControlCredit) this.flowControl.release(laneId);
-      return Promise.reject(error instanceof Error ? error : new FerricStoreError(String(error), { raw: error }));
+      return Promise.reject(error instanceof Error ? error : requestNotSentError(error));
     }
     return new Promise((resolve, reject) => {
       const timer = timeoutMs == null ? void 0 : setLongTimeout(() => {
@@ -9016,7 +9093,9 @@ var HTTPTransport = class {
   #requests = /* @__PURE__ */ new Set();
   #closed = false;
   async post(body, timeoutMs) {
-    if (this.#closed) throw new HTTPTransportError("HTTP transport is closed");
+    if (this.#closed) {
+      throw new HTTPTransportError("HTTP transport is closed", { requestDisposition: "unsent" });
+    }
     const controller = new AbortController();
     this.#requests.add(controller);
     const timer = timeoutMs == null ? void 0 : setLongTimeout(() => controller.abort(requestTimeoutReason), timeoutMs);
@@ -9033,9 +9112,22 @@ var HTTPTransport = class {
           raw: { retryable: true, safe_to_retry: false }
         });
       }
-      if (error instanceof HTTPTransportError || error instanceof RequestTimeoutError) throw error;
+      if (error instanceof RequestTimeoutError) throw error;
+      if (error instanceof HTTPTransportError) {
+        if (error.requestDisposition != null) throw error;
+        throw new HTTPTransportError(error.message, {
+          cause: error.cause ?? error,
+          raw: error.raw,
+          requestDisposition: "possibly_sent",
+          retryAfterMs: error.retryAfterMs,
+          retryable: error.retryable,
+          safeToRetry: false,
+          statusCode: error.statusCode
+        });
+      }
       throw new HTTPTransportError("HTTP command request failed", {
         cause: error,
+        requestDisposition: "possibly_sent",
         retryable: true,
         safeToRetry: false
       });
@@ -9047,7 +9139,9 @@ var HTTPTransport = class {
   async close() {
     if (this.#closed) return;
     this.#closed = true;
-    const error = new HTTPTransportError("HTTP transport is closed");
+    const error = new HTTPTransportError("HTTP transport is closed", {
+      requestDisposition: "possibly_sent"
+    });
     for (const controller of this.#requests) controller.abort(error);
     this.#httpAgent.destroy();
     this.#httpsAgent.destroy();
@@ -9290,16 +9384,22 @@ var HTTPAdapter = class _HTTPAdapter {
     await this.#transport.close();
   }
   async executeBatch(commands) {
-    if (commands.length > this.#config.maxBatchItems) {
-      throw new HTTPTransportError("HTTP command batch exceeds maxBatchItems");
-    }
-    for (const command of commands) assertHTTPCommandSupported(command[0]);
-    const prepared = commands.map((command) => prepareHTTPCommand(command, this.#config.maxRequestBytes));
-    const body = encodeHTTPCommands(prepared.map((command) => command.encoded), this.#config.maxRequestBytes);
-    if (body.byteLength > this.#config.maxRequestBytes) {
-      throw new HTTPTransportError("HTTP command request exceeds maxRequestBytes");
+    let body;
+    let serverBlockMs;
+    try {
+      if (commands.length > this.#config.maxBatchItems) {
+        throw new HTTPTransportError("HTTP command batch exceeds maxBatchItems");
+      }
+      for (const command of commands) assertHTTPCommandSupported(command[0]);
+      const prepared = commands.map((command) => prepareHTTPCommand(command, this.#config.maxRequestBytes));
+      body = encodeHTTPCommands(prepared.map((command) => command.encoded), this.#config.maxRequestBytes);
+      if (body.byteLength > this.#config.maxRequestBytes) {
+        throw new HTTPTransportError("HTTP command request exceeds maxRequestBytes");
+      }
+      serverBlockMs = combinedServerBlockMs(prepared.map((command) => command.serverBlockMs));
+    } catch (error) {
+      throw unsentHTTPError(error);
     }
-    const serverBlockMs = combinedServerBlockMs(prepared.map((command) => command.serverBlockMs));
     const response = await this.#transport.post(
       body,
       serverResponseTimeoutMs(this.#config.timeoutMs, serverBlockMs)
@@ -9356,16 +9456,32 @@ function commandError(value) {
 }
 function topLevelError(status, envelope, retryAfter) {
   const details = isRecord2(envelope.error) ? envelope.error : {};
+  const code = typeof details.code === "string" ? details.code.toLowerCase() : void 0;
   const message = typeof details.message === "string" ? details.message : `HTTP command request failed with status ${status}`;
   const retryAfterMs2 = retryAfterMilliseconds(retryAfter);
+  const ambiguousTimeout = status === 408 || code === "request_timeout";
+  const safeToRetry = !ambiguousTimeout && (details.safe_to_retry === true || definitelyRejectedHTTPStatus(status));
   return new HTTPTransportError(message, {
     raw: details,
     retryable: status === 408 || status === 425 || status === 429 || status >= 500,
     retryAfterMs: retryAfterMs2,
-    safeToRetry: false,
+    requestDisposition: "possibly_sent",
+    safeToRetry,
     statusCode: status
   });
 }
+function definitelyRejectedHTTPStatus(status) {
+  return status === 400 || status === 401 || status === 403 || status === 404 || status === 405 || status === 406 || status === 411 || status === 413 || status === 414 || status === 415 || status === 422 || status === 426 || status === 431;
+}
+function unsentHTTPError(error) {
+  if (error instanceof HTTPTransportError && error.requestDisposition === "unsent") return error;
+  const message = error instanceof Error ? error.message : String(error);
+  return new HTTPTransportError(message, {
+    cause: error,
+    raw: error instanceof FerricStoreError ? error.raw ?? error : error,
+    requestDisposition: "unsent"
+  });
+}
 function retryAfterMilliseconds(value) {
   if (value == null) return void 0;
   if (/^\d+$/u.test(value)) {
@@ -9458,9 +9574,9 @@ var ReconnectingExecutor = class {
     const snapshot = snapshotPipelineCommands(commands);
     const snapshotOptions = snapshotPipelineOptions(options) ?? {};
     for (const command of snapshot) assertCommandHasStableConnectionState(command);
-    if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
     const initialExecutor = await this.executorPromise;
-    if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
     if (initialExecutor.executePipeline == null) {
       return await executeCommandArraysIndividually(
         async (command) => await this.executeCommandArgs(command),
@@ -9481,9 +9597,9 @@ var ReconnectingExecutor = class {
     const snapshot = snapshotPipelineCommands(commands);
     const snapshotOptions = snapshotPipelineOptions(options) ?? {};
     for (const command of snapshot) assertCommandHasStableConnectionState(command);
-    if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
     const initialExecutor = await this.executorPromise;
-    if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
     if (initialExecutor.executeFusedPipeline == null) return void 0;
     try {
       return await initialExecutor.executeFusedPipeline(snapshot, snapshotOptions);
@@ -9516,7 +9632,7 @@ var ReconnectingExecutor = class {
       return;
     }
     this.closed = true;
-    this.retryAbortController.abort(new FerricStoreError("FerricStore client is closed"));
+    this.retryAbortController.abort(new RequestNotSentError("FerricStore client is closed"));
     const executorPromise = this.executorPromise;
     const reconnectPromise = this.reconnectPromise;
     this.closePromise = (async () => {
@@ -9538,7 +9654,7 @@ var ReconnectingExecutor = class {
     let executor = await this.executorPromise;
     let retries = 0;
     for (; ; ) {
-      if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+      if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
       try {
         return await operation(executor);
       } catch (error) {
@@ -9567,17 +9683,17 @@ var ReconnectingExecutor = class {
     try {
       await sleep(Math.min(this.maxDelayMs, base + jitter), this.retryAbortController.signal);
     } catch (error) {
-      if (this.closed) throw new FerricStoreError("FerricStore client is closed", { cause: error });
+      if (this.closed) throw new RequestNotSentError("FerricStore client is closed", { cause: error });
       throw error;
     }
   }
   async reconnect(staleExecutor) {
-    if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
     const competingReconnect = this.reconnectPromise;
     if (competingReconnect != null) return await competingReconnect;
     const observedExecutorPromise = this.executorPromise;
     const currentExecutor = await observedExecutorPromise.catch(() => void 0);
-    if (this.closed) throw new FerricStoreError("FerricStore client is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore client is closed");
     if (this.reconnectPromise != null) return await this.reconnectPromise;
     if (this.executorPromise !== observedExecutorPromise) return await this.executorPromise;
     if (currentExecutor != null && currentExecutor !== staleExecutor) return currentExecutor;
@@ -9586,7 +9702,7 @@ var ReconnectingExecutor = class {
       const nextExecutor = await this.createExecutor(this.retryAbortController.signal);
       if (this.closed) {
         await Promise.resolve(nextExecutor.close?.()).catch(() => void 0);
-        throw new FerricStoreError("FerricStore client is closed");
+        throw new RequestNotSentError("FerricStore client is closed");
       }
       this.executorPromise = Promise.resolve(nextExecutor);
       return nextExecutor;
@@ -10996,7 +11112,7 @@ var TopologyNativeAdapterPool = class _TopologyNativeAdapterPool {
     );
   }
   assertOpen() {
-    if (this.closed) throw new FerricStoreError("FerricStore topology adapter pool is closed");
+    if (this.closed) throw new RequestNotSentError("FerricStore topology adapter pool is closed");
   }
 };
 
@@ -12122,7 +12238,7 @@ var AutoBatchExecutor = class {
   }
   async executeCommandArgs(args) {
     if (this.closed) {
-      throw new FerricStoreError("FerricStore client is closed");
+      throw new RequestNotSentError("FerricStore client is closed");
     }
     const command = snapshotCommandArguments(args);
     if (this.executor.executePipeline == null) {
@@ -12142,7 +12258,7 @@ var AutoBatchExecutor = class {
     if (orderingBarrier != null) {
       await orderingBarrier;
       if (this.closed) {
-        throw new FerricStoreError("FerricStore client is closed");
+        throw new RequestNotSentError("FerricStore client is closed");
       }
     }
     return await new Promise((resolve, reject) => {
@@ -12156,7 +12272,7 @@ var AutoBatchExecutor = class {
   }
   async executePipeline(commands, options) {
     if (this.closed) {
-      throw new FerricStoreError("FerricStore client is closed");
+      throw new RequestNotSentError("FerricStore client is closed");
     }
     const snapshot = snapshotPipelineCommands(commands);
     const snapshotOptions = snapshotPipelineOptions(options);
@@ -12173,7 +12289,7 @@ var AutoBatchExecutor = class {
   }
   async executeFusedPipeline(commands, options) {
     if (this.closed) {
-      throw new FerricStoreError("FerricStore client is closed");
+      throw new RequestNotSentError("FerricStore client is closed");
     }
     if (this.executor.executeFusedPipeline == null) return void 0;
     const snapshot = snapshotPipelineCommands(commands);
@@ -12184,7 +12300,7 @@ var AutoBatchExecutor = class {
   }
   async refreshTopology() {
     if (this.closed) {
-      throw new FerricStoreError("FerricStore client is closed");
+      throw new RequestNotSentError("FerricStore client is closed");
     }
     const refreshTopology = this.executor.refreshTopology?.bind(this.executor);
     if (refreshTopology == null) {
@@ -12194,7 +12310,7 @@ var AutoBatchExecutor = class {
   }
   async route(key) {
     if (this.closed) {
-      throw new FerricStoreError("FerricStore client is closed");
+      throw new RequestNotSentError("FerricStore client is closed");
     }
     const route = this.executor.route?.bind(this.executor);
     if (route == null) {
@@ -12214,7 +12330,7 @@ var AutoBatchExecutor = class {
         this.timer.cancel();
         this.timer = void 0;
       }
-      this.failPending(new Error("FerricStore client closed before auto-batch flush"));
+      this.failPending(new RequestNotSentError("FerricStore client closed before auto-batch flush"));
       await this.orderingBarrier;
       await this.waitForInFlightBatches();
       await Promise.allSettled([...this.inFlightHelpers]);
@@ -12224,7 +12340,7 @@ var AutoBatchExecutor = class {
   }
   async executeAfterPendingBatches(operation) {
     if (this.closed) {
-      throw new FerricStoreError("FerricStore client is closed");
+      throw new RequestNotSentError("FerricStore client is closed");
     }
     const previousBarrier = this.orderingBarrier;
     let releaseBarrier;
@@ -12245,7 +12361,7 @@ var AutoBatchExecutor = class {
   }
   executeHelper(operation) {
     if (this.closed) {
-      return Promise.reject(new FerricStoreError("FerricStore client is closed"));
+      return Promise.reject(new RequestNotSentError("FerricStore client is closed"));
     }
     const task = Promise.resolve().then(operation);
     this.inFlightHelpers.add(task);
@@ -12267,7 +12383,7 @@ var AutoBatchExecutor = class {
       await previousBarrier;
       await this.flushNow();
       if (this.closed) {
-        throw new FerricStoreError("FerricStore client is closed");
+        throw new RequestNotSentError("FerricStore client is closed");
       }
       dispatched = operation();
     } finally {
@@ -14606,7 +14722,7 @@ var FerricStoreClientBase = class {
     return validatePipelineResponse(results, snapshot.length);
   }
   async close() {
-    this.closeAbortController.abort(new FerricStoreError("FerricStore client is closed"));
+    this.closeAbortController.abort(new RequestNotSentError("FerricStore client is closed"));
     this.closePromise ??= (async () => await this.executor.close?.())();
     await this.closePromise;
   }
@@ -17682,7 +17798,7 @@ async function executeProducerWriteWithBackpressure(execute, policy, signal) {
 function throwIfClosed(signal) {
   if (!signal.aborted) return;
   if (signal.reason instanceof Error) throw signal.reason;
-  throw new FerricStoreError("FerricStore client is closed", { raw: signal.reason });
+  throw new RequestNotSentError("FerricStore client is closed", { raw: signal.reason });
 }
 
 // src/flow-policy.ts
@@ -18999,6 +19115,8 @@ async function runDurableStep(client, job, options, hooks = {}) {
   const run2 = options.run;
   const continuation = snapshotAdvanceOptions(options);
   assertNonEmptyString(name, "name");
+  if (name.trim().length === 0) throw new TypeError("name must not be blank");
+  if (!name.isWellFormed()) throw new TypeError("name must contain valid Unicode");
   assertNonEmptyString(continuation.toState, "toState");
   if (typeof run2 !== "function") throw new TypeError("run must be a function");
   const resultName = durableStepValueName(name);
@@ -19026,7 +19144,7 @@ async function runDurableStep(client, job, options, hooks = {}) {
       throw new FerricStoreError("committed durable step result is missing");
     }
     const replayedJob = claimedItemFromRecord(validated);
-    hooks.replayed?.(replayedJob);
+    notifyWithoutReplacingOutcome(hooks.replayed, replayedJob);
     return { job: replayedJob, result: entry.value };
   }
   const result = normalizeStepResult(client, await run2());
@@ -19039,12 +19157,18 @@ async function runDurableStep(client, job, options, hooks = {}) {
       values: { ...continuation.values, [resultName]: result }
     });
   } catch (error) {
-    hooks.commitFailed?.(error);
+    notifyWithoutReplacingOutcome(hooks.commitFailed, error);
     throw error;
   }
-  hooks.committed?.(refreshed);
+  notifyWithoutReplacingOutcome(hooks.committed, refreshed);
   return { job: refreshed, result };
 }
+function notifyWithoutReplacingOutcome(callback, value) {
+  try {
+    callback?.(value);
+  } catch {
+  }
+}
 function normalizeStepResult(client, value) {
   return client.codec.decode(client.codec.encode(value));
 }
@@ -19165,6 +19289,35 @@ function claimedItemFromRecord(record) {
   };
 }
 
+// src/client-step-continue.ts
+function stepContinueArguments(id, options, codec) {
+  try {
+    const args = [
+      "FLOW.STEP_CONTINUE",
+      id,
+      options.leaseToken,
+      options.fromState,
+      options.toState,
+      "FENCING",
+      options.fencingToken,
+      "LEASE_MS",
+      options.leaseMs ?? 3e4,
+      "NOW",
+      options.nowMs ?? nowMs()
+    ];
+    append(args, "PARTITION", options.partitionKey);
+    append(args, "WORKER", options.worker);
+    appendEncoded(args, "PAYLOAD", codec, options.payload);
+    if (options.returnJob === true) args.push("RETURN", "JOBS_COMPACT");
+    appendStateMeta(args, options.stateMeta);
+    appendNamedValues(args, codec, options);
+    appendAttributeMutations(args, options);
+    return args;
+  } catch (error) {
+    throw requestNotSentError(error);
+  }
+}
+
 // src/client.ts
 var FerricStoreClient = class _FerricStoreClient extends FerricStoreProducerClient {
   static async fromUrl(url, options = {}) {
@@ -19287,26 +19440,7 @@ var FerricStoreClient = class _FerricStoreClient extends FerricStoreProducerClie
     const partitionKey = options.partitionKey;
     const returnJob = options.returnJob === true;
     const type = options.type;
-    const args = [
-      "FLOW.STEP_CONTINUE",
-      id,
-      options.leaseToken,
-      options.fromState,
-      options.toState,
-      "FENCING",
-      options.fencingToken,
-      "LEASE_MS",
-      options.leaseMs ?? 3e4,
-      "NOW",
-      options.nowMs ?? nowMs()
-    ];
-    append(args, "PARTITION", partitionKey);
-    append(args, "WORKER", options.worker);
-    appendEncoded(args, "PAYLOAD", this.codec, options.payload);
-    if (returnJob) args.push("RETURN", "JOBS_COMPACT");
-    appendStateMeta(args, options.stateMeta);
-    appendNamedValues(args, this.codec, options);
-    appendAttributeMutations(args, options);
+    const args = stepContinueArguments(id, options, this.codec);
     const response = await this.commandArgs(args);
     return returnJob ? claimedItemFromResp(response, this.codec, { type }) : await this.recordOrGet(response, id, partitionKey);
   }
@@ -20945,15 +21079,6 @@ function createWorkflowStateRegistration(name, handler, options, defaultValueMax
 // src/workflow-context.ts
 var MISSING_VALUE = /* @__PURE__ */ Symbol("ferricstore.missingValue");
 var WorkflowContext = class {
-  constructor(workflow, job, stateName, leaseJob = job, mutationCoordinator) {
-    this.mutationCoordinator = mutationCoordinator;
-    this.workflow = workflow;
-    this.job = job;
-    this.leaseJob = leaseJob;
-    this.currentStateName = stateName;
-    this.flow = new WorkflowFlowCommands(this);
-  }
-  mutationCoordinator;
   workflow;
   job;
   flow;
@@ -20962,7 +21087,20 @@ var WorkflowContext = class {
   leaseJob;
   mutationFailure;
   mutationPhase = "idle";
+  mutationCoordinator;
   valueCache = /* @__PURE__ */ new Map();
+  constructor(workflow, job, stateName) {
+    this.workflow = workflow;
+    this.job = job;
+    this.leaseJob = job;
+    this.currentStateName = stateName;
+    this.flow = new WorkflowFlowCommands(this);
+  }
+  /** @internal */
+  configureWorkerMutation(leaseJob, coordinator) {
+    this.leaseJob = leaseJob;
+    this.mutationCoordinator = coordinator;
+  }
   get client() {
     return this.workflow.client;
   }
@@ -21386,10 +21524,18 @@ async function applyFail(client, ctx, outcome, returnRecord) {
   });
 }
 
+// src/workflow-worker-context.ts
+var WorkerWorkflowContext = class extends WorkflowContext {
+  constructor(workflow, job, stateName, leaseJob, mutationCoordinator) {
+    super(workflow, job, stateName);
+    this.configureWorkerMutation(leaseJob, mutationCoordinator);
+  }
+};
+
 // src/workflow-job-execution.ts
 async function executeWorkflowJob(workflow, workerOptions, job, registration, guard) {
   guard.assertActive();
-  const ctx = new WorkflowContext(workflow, job, registration.name, guard.job, {
+  const ctx = new WorkerWorkflowContext(workflow, job, registration.name, guard.job, {
     pause: async () => await guard.pauseForLeaseMutation(),
     resume: (refreshed) => guard.resumeWith(refreshed)
   });
@@ -21734,7 +21880,7 @@ function throwError(value) {
 }
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.12.0";
+var FERRICSTORE_SDK_VERSION = "0.13.1";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 export {
@@ -21777,6 +21923,7 @@ export {
   QueueWorker,
   RawCodec,
   ReconnectingExecutor,
+  RequestNotSentError,
   RequestTimeoutError,
   RerouteError,
   RoutingTopology,