@ferricstore/ferricstore 0.13.3 → 0.13.5

package/dist/index.d.cts

@@ -597,6 +597,7 @@ interface WorkerConfig {
     /** Include Flow attributes in compact worker claims. Defaults to false. */
     claimAttributes?: boolean;
     valueMaxBytes?: number;
+    /** FLOW.CLAIM_DUE server block interval in integer milliseconds, from 0 through 4_294_967_295. */
     blockMs?: number;
     /** Maximum server block interval while signal is present, bounding safe shutdown latency. */
     abortPollMs?: number;
@@ -909,7 +910,7 @@ interface ClaimDueOptions {
     limit?: number;
     priority?: number;
     nowMs?: number;
-    blockMs?: number;
+    /** FLOW.CLAIM_DUE server block interval in integer milliseconds, from 0 through 4_294_967_295. */ blockMs?: number;
     reclaimExpired?: boolean;
     reclaimRatio?: number;
     jobOnly?: boolean;
@@ -2678,7 +2679,7 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.13.3";
+declare const FERRICSTORE_SDK_VERSION = "0.13.5";
 /** Oldest FerricStore server supported by this breaking beta contract. */
 declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */

package/dist/index.d.ts

@@ -597,6 +597,7 @@ interface WorkerConfig {
     /** Include Flow attributes in compact worker claims. Defaults to false. */
     claimAttributes?: boolean;
     valueMaxBytes?: number;
+    /** FLOW.CLAIM_DUE server block interval in integer milliseconds, from 0 through 4_294_967_295. */
     blockMs?: number;
     /** Maximum server block interval while signal is present, bounding safe shutdown latency. */
     abortPollMs?: number;
@@ -909,7 +910,7 @@ interface ClaimDueOptions {
     limit?: number;
     priority?: number;
     nowMs?: number;
-    blockMs?: number;
+    /** FLOW.CLAIM_DUE server block interval in integer milliseconds, from 0 through 4_294_967_295. */ blockMs?: number;
     reclaimExpired?: boolean;
     reclaimRatio?: number;
     jobOnly?: boolean;
@@ -2678,7 +2679,7 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.13.3";
+declare const FERRICSTORE_SDK_VERSION = "0.13.5";
 /** Oldest FerricStore server supported by this breaking beta contract. */
 declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */

package/dist/index.js

@@ -3884,6 +3884,78 @@ function expandFlowClaimStates(args) {
   return expanded;
 }
 
+// src/flow-block-validation.ts
+var MAX_FLOW_BLOCK_MS = 4294967295;
+var FLOW_BLOCK_MS_ERROR = "blockMs must be a safe non-negative integer no greater than 4294967295";
+function validateFlowBlockMs(value) {
+  if (value != null && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0 || value > MAX_FLOW_BLOCK_MS)) {
+    throw new TypeError(FLOW_BLOCK_MS_ERROR);
+  }
+}
+function validateRawFlowBlockMs(value) {
+  let parsed;
+  try {
+    parsed = integerArg(value);
+  } catch {
+    throw new TypeError(FLOW_BLOCK_MS_ERROR);
+  }
+  validateFlowBlockMs(parsed);
+}
+function validateRawFlowClaimBlockOptions(args) {
+  for (let index = 1; index < args.length; ) {
+    const token = asText(args[index]).toUpperCase();
+    switch (token) {
+      case "BLOCK":
+      case "BLOCK_MS":
+        validateRawFlowBlockMs(args[index + 1]);
+        index += 2;
+        break;
+      case "STATE":
+      case "PARTITION":
+      case "WORKER":
+      case "LEASE_MS":
+      case "LIMIT":
+      case "PRIORITY":
+      case "NOW":
+      case "RECLAIM_RATIO":
+      case "RETURN":
+      case "MAXBYTES":
+      case "VALUE":
+      case "VALUE_MAX_BYTES":
+        index += 2;
+        break;
+      case "STATES":
+      case "PARTITIONS": {
+        const count = Number(args[index + 1]);
+        const valuesStart = index + 2;
+        if (!Number.isSafeInteger(count) || count < 0 || count > args.length - valuesStart) {
+          validateRawFlowClaimBlockFallback(args, valuesStart);
+          return;
+        }
+        index = valuesStart + count;
+        break;
+      }
+      case "RECLAIM_EXPIRED":
+      case "INCLUDE_STATE":
+        index += index + 1 < args.length && isBoolToken(args[index + 1]) ? 2 : 1;
+        break;
+      case "PAYLOAD":
+      case "NOPAYLOAD":
+        index += 1;
+        break;
+      default:
+        validateRawFlowClaimBlockFallback(args, index);
+        return;
+    }
+  }
+}
+function validateRawFlowClaimBlockFallback(args, start) {
+  for (let index = start; index < args.length; index += 1) {
+    const token = asText(args[index]).toUpperCase();
+    if (token === "BLOCK" || token === "BLOCK_MS") validateRawFlowBlockMs(args[index + 1]);
+  }
+}
+
 // src/protocol-flow.ts
 function flowCreatePayload(args) {
   if (args.length < 7) return void 0;
@@ -4011,6 +4083,7 @@ function flowCreateManyPayload(args, maxBodyBytes, allowCompact) {
 }
 function flowClaimDuePayload(args, maxBodyBytes, allowCompact) {
   if (args.length < 1) return void 0;
+  validateRawFlowClaimBlockOptions(args);
   const options = parseFlowOptions(args, 1, args.length, {
     allowed: /* @__PURE__ */ new Set([
       "STATE",
@@ -4037,6 +4110,7 @@ function flowClaimDuePayload(args, maxBodyBytes, allowCompact) {
     readValues: true
   });
   if (options == null) return void 0;
+  validateFlowBlockMs(options.block_ms);
   const returnMode = options.return == null ? "" : asText(options.return).toUpperCase();
   if (!returnMode.startsWith("JOBS_COMPACT")) {
     const fallback = Array.isArray(options.states) ? commandExec(["FLOW.CLAIM_DUE", ...expandFlowClaimStates(args)]) : commandExec(["FLOW.CLAIM_DUE", ...args]);
@@ -18551,6 +18625,7 @@ var FerricStoreClaimClient = class extends FerricStoreMutationClient {
   }
   claimDueRequest(type, options, reusableAfterAwait = false) {
     const captured = snapshotClaimOptions(options, reusableAfterAwait);
+    validateFlowBlockMs(captured.blockMs);
     if (captured.state != null && captured.states != null) {
       throw new Error("state and states are mutually exclusive");
     }
@@ -19983,11 +20058,11 @@ function workerClaimBlockMs(options, useBlocking) {
   if (!useBlocking || options.blockMs == null) {
     return void 0;
   }
-  if (options.signal == null || !Number.isFinite(options.blockMs) || options.blockMs < 0) {
-    return options.blockMs;
-  }
-  const abortPollMs = positiveInteger5(options.abortPollMs, 1e3);
-  return options.blockMs === 0 ? abortPollMs : Math.min(Math.trunc(options.blockMs), abortPollMs);
+  validateFlowBlockMs(options.blockMs);
+  const blockMs = options.blockMs;
+  if (options.signal == null) return blockMs;
+  const abortPollMs = Math.min(positiveInteger5(options.abortPollMs, 1e3), MAX_FLOW_BLOCK_MS);
+  return blockMs === 0 ? abortPollMs : Math.min(blockMs, abortPollMs);
 }
 function workerMaxIdleSleepMs(options, idleSleepMs = workerIdleSleepMs(options)) {
   return Math.max(idleSleepMs, nonNegativeDuration(options.maxIdleSleepMs, 5e3));
@@ -21886,7 +21961,7 @@ function throwError(value) {
 }
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.13.3";
+var FERRICSTORE_SDK_VERSION = "0.13.5";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 export {