@ferricstore/ferricstore 0.11.8 → 0.11.10

package/dist/index.js

@@ -28,6 +28,14 @@ var FerricStoreError = class extends Error {
     this.retryAfterMs = options.retryAfterMs ?? structuredIntegerField(options.raw, "retry_after_ms");
   }
 };
+var HTTPTransportError = class extends FerricStoreError {
+  code = "http_transport";
+  statusCode;
+  constructor(message, options = {}) {
+    super(message, options);
+    this.statusCode = options.statusCode;
+  }
+};
 var ConnectionClosedError = class extends FerricStoreError {
   code = "connection_closed";
   requestDisposition;
@@ -1448,6 +1456,7 @@ var neverAutoBatchCommandPrefixes = /* @__PURE__ */ new Set([
   "BLPOP",
   "BRPOP",
   "BRPOPLPUSH",
+  "BZMPOP",
   "BZPOPMAX",
   "BZPOPMIN",
   "CLIENT",
@@ -1559,6 +1568,9 @@ var connectionBlockingCommands = /* @__PURE__ */ new Set([
   "BLPOP",
   "BRPOP",
   "BRPOPLPUSH",
+  "BZMPOP",
+  "BZPOPMAX",
+  "BZPOPMIN",
   "XREAD",
   "XREADGROUP"
 ]);
@@ -2427,8 +2439,10 @@ function serverBlockMetadata(args) {
     serverBlockMs = blockDurationMs(args[3], 1e3);
   } else if (command === "BLMOVE" && args.length >= 6) {
     serverBlockMs = blockDurationMs(args[args.length - 1], 1e3);
-  } else if (command === "BLMPOP" && args.length >= 2) {
+  } else if ((command === "BLMPOP" || command === "BZMPOP") && args.length >= 2) {
     serverBlockMs = blockDurationMs(args[1], 1e3);
+  } else if ((command === "BZPOPMAX" || command === "BZPOPMIN") && args.length >= 3) {
+    serverBlockMs = blockDurationMs(args[args.length - 1], 1e3);
   } else if (command === "XREAD" || command === "XREADGROUP") {
     serverBlockMs = optionBlockDurationMs(args, ["BLOCK"], "STREAMS");
   } else if (command === "WAIT" && args.length === 3) {
@@ -7488,6 +7502,24 @@ async function executeIndividually(host, commands, laneId, options) {
   }, commands, options);
 }
 
+// src/server-response-timeout.ts
+function serverResponseTimeoutMs(requestTimeoutMs, serverBlockMs) {
+  if (serverBlockMs == null) return requestTimeoutMs;
+  if (serverBlockMs === 0) return void 0;
+  return saturatingAdd(requestTimeoutMs, serverBlockMs);
+}
+function combinedServerBlockMs(values) {
+  let total;
+  for (const value of values) {
+    if (value === 0) return 0;
+    if (value != null) total = saturatingAdd(total ?? 0, value);
+  }
+  return total;
+}
+function saturatingAdd(left, right) {
+  return Math.min(Number.MAX_SAFE_INTEGER, left + right);
+}
+
 // src/native-pending-timeout.ts
 function timeoutNativePendingRequest(operations, requestId, timeoutMs) {
   const pending = operations.getPending(requestId);
@@ -7516,10 +7548,7 @@ function timeoutNativePendingRequest(operations, requestId, timeoutMs) {
   pending.reject(new RequestTimeoutError(timeoutMs, "possibly_sent"));
 }
 function nativeResponseTimeoutMs(command, requestTimeoutMs) {
-  const blockMs = command.serverBlockMs;
-  if (blockMs == null) return requestTimeoutMs;
-  if (blockMs === 0) return void 0;
-  return Math.min(Number.MAX_SAFE_INTEGER, requestTimeoutMs + blockMs);
+  return serverResponseTimeoutMs(requestTimeoutMs, command.serverBlockMs);
 }
 
 // src/native-chunk-assembler.ts
@@ -8546,6 +8575,800 @@ var NativeAdapter = class _NativeAdapter {
   }
 };
 
+// src/http-command-policy.ts
+import { Buffer as Buffer33 } from "buffer";
+var nativeOnlyCommands = /* @__PURE__ */ new Set([
+  "AUTH",
+  "BACKPRESSURE",
+  "CLIENT",
+  "CLIENT.INFO",
+  "CLIENT.SETNAME",
+  "COMMAND_EXEC",
+  "EVENT",
+  "GOAWAY",
+  "HELLO",
+  "OPTIONS",
+  "PIPELINE",
+  "QUIT",
+  "ROUTE",
+  "ROUTE_BATCH",
+  "SHARDS",
+  "STARTUP",
+  "SUBSCRIBE_EVENTS",
+  "UNSUBSCRIBE_EVENTS",
+  "WINDOW_UPDATE"
+]);
+var sessionOnlyCommands = /* @__PURE__ */ new Set([
+  "ASKING",
+  "AUTH",
+  "CLIENT",
+  "DISCARD",
+  "EXEC",
+  "HELLO",
+  "MONITOR",
+  "MULTI",
+  "PSUBSCRIBE",
+  "PSYNC",
+  "PUNSUBSCRIBE",
+  "QUIT",
+  "READONLY",
+  "READWRITE",
+  "REPLCONF",
+  "RESET",
+  "SANDBOX",
+  "SELECT",
+  "SSUBSCRIBE",
+  "SUBSCRIBE",
+  "SUNSUBSCRIBE",
+  "SYNC",
+  "UNSUBSCRIBE",
+  "UNWATCH",
+  "WATCH"
+]);
+function httpCommandDisposition(name) {
+  const normalized = name.toUpperCase();
+  return nativeOnlyCommands.has(normalized) || sessionOnlyCommands.has(normalized) ? "native_only" : "supported";
+}
+function assertHTTPCommandSupported(name) {
+  const normalized = normalizedCommandName(name);
+  if (normalized == null || normalized === "") throw new TypeError("HTTP command must have a name");
+  if (sessionOnlyCommands.has(normalized)) {
+    throw new InvalidCommandError(`${normalized} requires a persistent native TCP session`);
+  }
+  if (nativeOnlyCommands.has(normalized)) {
+    throw new InvalidCommandError(`${normalized} is a native TCP transport control command`);
+  }
+}
+function normalizedCommandName(value) {
+  if (typeof value === "string") return value.toUpperCase();
+  if (Buffer33.isBuffer(value) || value instanceof Uint8Array) {
+    return Buffer33.from(value).toString("utf8").toUpperCase();
+  }
+  return void 0;
+}
+
+// src/http-envelope.ts
+import { Buffer as Buffer34 } from "buffer";
+var encoding = "ferricstore-json-v1";
+var bytesMarker = "$ferricstore_bytes";
+var mapMarker = "$ferricstore_map";
+var maxDepth = 64;
+var bytesMarkerBaseBytes = Buffer34.byteLength(bytesMarker) + 7;
+var mapMarkerBaseBytes = Buffer34.byteLength(mapMarker) + 7;
+function encodeHTTPCommands(commands, maxBytes = Number.MAX_SAFE_INTEGER) {
+  const budget = { remaining: maxBytes };
+  return Buffer34.from(JSON.stringify({
+    encoding,
+    commands: commands.map((command) => encodeValue(command, 0, budget))
+  }));
+}
+function decodeHTTPEnvelope(source) {
+  let parsed;
+  try {
+    parsed = JSON.parse(source.toString("utf8"));
+  } catch (error) {
+    throw new TypeError("invalid HTTP command response JSON", { cause: error });
+  }
+  if (!isRecord(parsed)) throw new TypeError("HTTP command response must be an object");
+  return decodePlainRecord(parsed, 0);
+}
+function encodeValue(value, depth, budget) {
+  if (depth > maxDepth) throw new TypeError("HTTP command value exceeds maximum depth");
+  if (value == null) {
+    consumeBudget(budget, 1);
+    return value;
+  }
+  if (typeof value === "string") {
+    consumeBudget(budget, Buffer34.byteLength(value) + 2);
+    return value;
+  }
+  if (typeof value === "boolean") {
+    consumeBudget(budget, 1);
+    return value;
+  }
+  if (Buffer34.isBuffer(value) || value instanceof Uint8Array) {
+    consumeBudget(budget, bytesMarkerBaseBytes + 4 * Math.ceil(value.byteLength / 3));
+    return { [bytesMarker]: Buffer34.from(value).toString("base64") };
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) throw new TypeError("HTTP command numbers must be finite");
+    consumeBudget(budget, 1);
+    return value;
+  }
+  if (typeof value === "bigint") {
+    const encoded = value >= BigInt(Number.MIN_SAFE_INTEGER) && value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : value.toString();
+    consumeBudget(budget, typeof encoded === "number" ? 1 : Buffer34.byteLength(encoded) + 2);
+    return encoded;
+  }
+  if (Array.isArray(value)) {
+    consumeBudget(budget, 2 + Math.max(0, value.length - 1));
+    return denseArray(value, depth + 1, (item, itemDepth) => encodeValue(item, itemDepth, budget));
+  }
+  if (value instanceof Map) {
+    consumeBudget(budget, mapMarkerBaseBytes + value.size);
+    const pairs = [];
+    for (const [key, item] of value.entries()) {
+      pairs.push([
+        encodeValue(key, depth + 1, budget),
+        encodeValue(item, depth + 1, budget)
+      ]);
+    }
+    return { [mapMarker]: pairs };
+  }
+  if (isRecord(value)) {
+    const keys = Object.keys(value);
+    consumeBudget(budget, mapMarkerBaseBytes + keys.length);
+    return { [mapMarker]: keys.map((key) => [
+      encodeValue(key, depth + 1, budget),
+      encodeValue(value[key], depth + 1, budget)
+    ]) };
+  }
+  throw new TypeError(`unsupported HTTP command value: ${typeof value}`);
+}
+function decodeValue2(value, depth) {
+  if (depth > maxDepth) throw new TypeError("HTTP response value exceeds maximum depth");
+  if (Array.isArray(value)) return denseArray(value, depth + 1, decodeValue2);
+  if (!isRecord(value)) return value;
+  if (Object.keys(value).length === 1 && typeof value[bytesMarker] === "string") {
+    return decodeBase64(value[bytesMarker]);
+  }
+  if (Object.keys(value).length === 1 && Array.isArray(value[mapMarker])) {
+    const result = /* @__PURE__ */ new Map();
+    for (const pair of value[mapMarker]) {
+      if (!Array.isArray(pair) || pair.length !== 2) throw new TypeError("invalid HTTP map marker");
+      result.set(decodeValue2(pair[0], depth + 1), decodeValue2(pair[1], depth + 1));
+    }
+    return result;
+  }
+  return decodePlainRecord(value, depth + 1);
+}
+function decodeBase64(value) {
+  if (value.length % 4 !== 0 || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value)) {
+    throw new TypeError("invalid HTTP bytes marker");
+  }
+  const decoded = Buffer34.from(value, "base64");
+  if (decoded.toString("base64") !== value) throw new TypeError("invalid HTTP bytes marker");
+  return decoded;
+}
+function decodePlainRecord(value, depth) {
+  const result = {};
+  for (const [key, item] of Object.entries(value)) {
+    Object.defineProperty(result, key, {
+      configurable: true,
+      enumerable: true,
+      value: decodeValue2(item, depth),
+      writable: true
+    });
+  }
+  return result;
+}
+function consumeBudget(budget, amount) {
+  if (amount > budget.remaining) {
+    throw new HTTPTransportError("HTTP command request exceeds maxRequestBytes");
+  }
+  budget.remaining -= amount;
+}
+function denseArray(values, depth, transform) {
+  const result = new Array(values.length);
+  for (let index = 0; index < values.length; index += 1) {
+    if (!Object.hasOwn(values, index)) throw new TypeError("HTTP command arrays must be dense");
+    result[index] = transform(values[index], depth);
+  }
+  return result;
+}
+function isRecord(value) {
+  return typeof value === "object" && value != null && !Array.isArray(value) && !Buffer34.isBuffer(value);
+}
+
+// src/http-options.ts
+import { Buffer as Buffer35 } from "buffer";
+import { validateHeaderName, validateHeaderValue } from "http";
+function normalizeHTTPOptions(value, options) {
+  const url = new URL(value);
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new TypeError(`unsupported HTTP URL scheme: ${url.protocol}`);
+  }
+  if (url.username !== "" || url.password !== "") throw new TypeError("HTTP URL userinfo is not allowed");
+  if (url.search !== "" || url.hash !== "") throw new TypeError("HTTP base URL cannot contain query or fragment");
+  const headers = normalizedHeaders(options.headers ?? {});
+  const authorization = authorizationHeader(url, options, headers.authorization);
+  if (authorization != null) headers.authorization = authorization;
+  url.pathname = `${url.pathname.replace(/\/$/u, "")}/v1/commands`;
+  return Object.freeze({
+    commandUrl: url,
+    headers: Object.freeze(headers),
+    http2: booleanOption(options.http2, false, "http2"),
+    maxBatchItems: positiveInteger(options.maxBatchItems, 1e3, "maxBatchItems"),
+    maxConnections: positiveInteger(options.maxConnections, 100, "maxConnections"),
+    maxRedirects: nonNegativeInteger(options.maxRedirects, 20, "maxRedirects"),
+    maxRequestBytes: positiveInteger(options.maxRequestBytes, 1024 * 1024, "maxRequestBytes"),
+    maxResponseBytes: positiveInteger(options.maxResponseBytes, 16 * 1024 * 1024, "maxResponseBytes"),
+    timeoutMs: positiveInteger(options.timeoutMs, 3e4, "timeoutMs"),
+    tlsOptions: Object.freeze({ ...options.tlsOptions ?? {} })
+  });
+}
+function normalizedHeaders(source) {
+  const headers = /* @__PURE__ */ Object.create(null);
+  for (const [rawName, value] of Object.entries(source)) {
+    const name = rawName.toLowerCase();
+    if (typeof value !== "string" || !validHeader(name, value)) {
+      throw new TypeError(`invalid HTTP header: ${rawName}`);
+    }
+    headers[name] = value;
+  }
+  return headers;
+}
+function authorizationHeader(url, options, custom) {
+  const basic = options.username != null || options.password != null;
+  const count = Number(custom != null) + Number(options.bearerToken != null) + Number(basic);
+  if (count > 1) throw new TypeError("HTTP credentials are mutually exclusive");
+  if (options.bearerToken != null) {
+    if (options.bearerToken === "" || !validHeader("authorization", `Bearer ${options.bearerToken}`)) {
+      throw new TypeError("invalid bearer token");
+    }
+    return `Bearer ${options.bearerToken}`;
+  }
+  if (!basic) return custom;
+  if (url.protocol !== "https:") throw new TypeError("Basic authentication requires HTTPS");
+  if (typeof options.password !== "string") throw new TypeError("Basic authentication requires a password");
+  const username = options.username ?? "default";
+  if (username === "" || username.includes(":") || !safeHeader(username) || !safeHeader(options.password)) {
+    throw new TypeError("invalid Basic authentication credentials");
+  }
+  return `Basic ${Buffer35.from(`${username}:${options.password}`).toString("base64")}`;
+}
+function positiveInteger(value, fallback, name) {
+  const result = value ?? fallback;
+  if (!Number.isSafeInteger(result) || result <= 0) throw new TypeError(`${name} must be a positive integer`);
+  return result;
+}
+function nonNegativeInteger(value, fallback, name) {
+  const result = value ?? fallback;
+  if (!Number.isSafeInteger(result) || result < 0) throw new TypeError(`${name} must be a non-negative integer`);
+  return result;
+}
+function booleanOption(value, fallback, name) {
+  const result = value ?? fallback;
+  if (typeof result !== "boolean") throw new TypeError(`${name} must be a boolean`);
+  return result;
+}
+function safeHeader(value) {
+  return !value.includes("\r") && !value.includes("\n");
+}
+function validHeader(name, value) {
+  try {
+    validateHeaderName(name);
+    validateHeaderValue(name, value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/http-transport.ts
+import http from "http";
+import http2 from "http2";
+import https from "https";
+import { Buffer as Buffer36 } from "buffer";
+
+// src/http2-slot-pool.ts
+var HTTP2SessionRetiredError = class extends Error {
+  constructor(message, cause) {
+    super(message, { cause });
+    this.name = "HTTP2SessionRetiredError";
+  }
+};
+var HTTP2SlotPool = class {
+  active = 0;
+  idleCallback;
+  limit;
+  retiredError;
+  waiterHead;
+  waiterTail;
+  acquire(signal) {
+    if (signal.aborted) return Promise.reject(signalAbortError(signal));
+    if (this.retiredError != null) return Promise.reject(this.retiredError);
+    if (this.limit != null && this.active < this.limit) {
+      this.active += 1;
+      return Promise.resolve(this.releaseOnce());
+    }
+    return new Promise((resolve, reject) => {
+      const waiter = {
+        abort: () => {
+          if (waiter.settled) return;
+          waiter.settled = true;
+          this.removeWaiter(waiter);
+          reject(signalAbortError(signal));
+        },
+        queued: true,
+        reject,
+        resolve,
+        settled: false,
+        signal
+      };
+      this.enqueueWaiter(waiter);
+      signal.addEventListener("abort", waiter.abort, { once: true });
+    });
+  }
+  updateLimit(limit) {
+    if (this.retiredError != null) return;
+    this.limit = limit;
+    this.drain();
+  }
+  retire(error) {
+    if (this.retiredError != null) return;
+    this.retiredError = error;
+    while (this.waiterHead != null) {
+      const waiter = this.waiterHead;
+      this.removeWaiter(waiter);
+      if (waiter.settled) continue;
+      waiter.settled = true;
+      waiter.signal.removeEventListener("abort", waiter.abort);
+      waiter.reject(error);
+    }
+  }
+  whenIdle(callback) {
+    if (this.active === 0) callback();
+    else this.idleCallback = callback;
+  }
+  drain() {
+    while (this.retiredError == null && this.limit != null && this.active < this.limit) {
+      const waiter = this.waiterHead;
+      if (waiter == null) return;
+      this.removeWaiter(waiter);
+      if (waiter.settled) continue;
+      waiter.settled = true;
+      waiter.signal.removeEventListener("abort", waiter.abort);
+      this.active += 1;
+      waiter.resolve(this.releaseOnce());
+    }
+  }
+  enqueueWaiter(waiter) {
+    waiter.previous = this.waiterTail;
+    if (this.waiterTail == null) this.waiterHead = waiter;
+    else this.waiterTail.next = waiter;
+    this.waiterTail = waiter;
+  }
+  removeWaiter(waiter) {
+    if (!waiter.queued) return;
+    if (waiter.previous == null) this.waiterHead = waiter.next;
+    else waiter.previous.next = waiter.next;
+    if (waiter.next == null) this.waiterTail = waiter.previous;
+    else waiter.next.previous = waiter.previous;
+    waiter.next = void 0;
+    waiter.previous = void 0;
+    waiter.queued = false;
+  }
+  releaseOnce() {
+    let released = false;
+    return () => {
+      if (released) return;
+      released = true;
+      this.active -= 1;
+      this.drain();
+      if (this.active === 0) {
+        const callback = this.idleCallback;
+        this.idleCallback = void 0;
+        callback?.();
+      }
+    };
+  }
+};
+function signalAbortError(signal) {
+  return signal.reason instanceof Error ? signal.reason : new HTTPTransportError("HTTP request was aborted", { raw: signal.reason });
+}
+
+// src/http-transport.ts
+var HTTPTransport = class {
+  constructor(config) {
+    this.config = config;
+    this.#httpAgent = new http.Agent({
+      keepAlive: true,
+      maxFreeSockets: config.maxConnections,
+      maxSockets: config.maxConnections,
+      maxTotalSockets: config.maxConnections
+    });
+    this.#httpsAgent = new https.Agent({
+      ...config.tlsOptions,
+      keepAlive: true,
+      maxFreeSockets: config.maxConnections,
+      maxSockets: config.maxConnections,
+      maxTotalSockets: config.maxConnections
+    });
+  }
+  config;
+  #httpAgent;
+  #httpsAgent;
+  #allSessions = /* @__PURE__ */ new Set();
+  #sessions = /* @__PURE__ */ new Map();
+  #sessionSlots = /* @__PURE__ */ new WeakMap();
+  #requests = /* @__PURE__ */ new Set();
+  #closed = false;
+  async post(body, timeoutMs) {
+    if (this.#closed) throw new HTTPTransportError("HTTP transport is closed");
+    const controller = new AbortController();
+    this.#requests.add(controller);
+    const timer = timeoutMs == null ? void 0 : setLongTimeout(() => controller.abort(requestTimeoutReason), timeoutMs);
+    timer?.unref();
+    try {
+      return await this.request(this.config.commandUrl, "POST", body, 0, controller.signal);
+    } catch (error) {
+      if (controller.signal.aborted) {
+        if (controller.signal.reason instanceof HTTPTransportError) throw controller.signal.reason;
+        throw new RequestTimeoutError(timeoutMs ?? this.config.timeoutMs, "possibly_sent", {
+          cause: error,
+          raw: { retryable: true, safe_to_retry: false }
+        });
+      }
+      if (error instanceof HTTPTransportError || error instanceof RequestTimeoutError) throw error;
+      throw new HTTPTransportError("HTTP command request failed", {
+        cause: error,
+        retryable: true,
+        safeToRetry: false
+      });
+    } finally {
+      timer?.cancel();
+      this.#requests.delete(controller);
+    }
+  }
+  async close() {
+    if (this.#closed) return;
+    this.#closed = true;
+    const error = new HTTPTransportError("HTTP transport is closed");
+    for (const controller of this.#requests) controller.abort(error);
+    this.#httpAgent.destroy();
+    this.#httpsAgent.destroy();
+    for (const session of this.#allSessions) session.destroy();
+    this.#allSessions.clear();
+    this.#sessions.clear();
+  }
+  async request(url, method, body, redirects, signal) {
+    const response = this.config.http2 ? await this.http2Request(url, method, body, signal) : await this.http1Request(url, method, body, signal);
+    if (![301, 302, 303, 307, 308].includes(response.status)) return response;
+    if (redirects >= this.config.maxRedirects) throw new HTTPTransportError("too many HTTP redirects");
+    const location = response.headers.location;
+    if (location == null || location === "") throw new HTTPTransportError("HTTP redirect has no location");
+    const target = new URL(location, url);
+    if (target.protocol !== "http:" && target.protocol !== "https:") {
+      throw new HTTPTransportError("HTTP redirect has an unsupported scheme");
+    }
+    const switchToGet = [301, 302, 303].includes(response.status);
+    return await this.request(
+      target,
+      switchToGet ? "GET" : method,
+      switchToGet ? void 0 : body,
+      redirects + 1,
+      signal
+    );
+  }
+  async http1Request(url, method, body, signal) {
+    const request = url.protocol === "https:" ? https.request : http.request;
+    const agent = url.protocol === "https:" ? this.#httpsAgent : this.#httpAgent;
+    const headers = this.requestHeaders(body);
+    return await new Promise((resolve, reject) => {
+      const outgoing = request(url, { agent, headers, method, signal }, (response) => {
+        void this.collectHttp1(response).then(resolve, reject);
+      });
+      outgoing.once("error", reject);
+      outgoing.end(body);
+    });
+  }
+  async collectHttp1(response) {
+    const declared = headerValue(response.headers["content-length"]);
+    if (declared != null && Number(declared) > this.config.maxResponseBytes) {
+      response.destroy();
+      throw new HTTPTransportError("HTTP response exceeds maxResponseBytes");
+    }
+    return await collectBody(
+      response,
+      response.statusCode ?? 0,
+      normalizeHeaders(response.headers),
+      this.config.maxResponseBytes
+    );
+  }
+  async http2Request(url, method, body, signal) {
+    const headers = {
+      ...this.requestHeaders(body),
+      ":authority": url.host,
+      ":method": method,
+      ":path": `${url.pathname}${url.search}`,
+      ":scheme": url.protocol.slice(0, -1)
+    };
+    if (signal.aborted) throw signalAbortError(signal);
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      const session = this.session(url);
+      let release;
+      try {
+        release = await this.slotPool(session).acquire(signal);
+      } catch (error) {
+        if (attempt === 0 && error instanceof HTTP2SessionRetiredError && !signal.aborted) continue;
+        throw error;
+      }
+      try {
+        let stream;
+        try {
+          stream = session.request(headers);
+        } catch (error) {
+          if (attempt === 0 && retryableSessionOpenError(error) && !signal.aborted) {
+            this.retireSession(url.origin, session, true, error);
+            continue;
+          }
+          throw error;
+        }
+        try {
+          return await this.collectHttp2(stream, body, signal);
+        } catch (error) {
+          if (attempt === 0 && refusedStreamError(error) && !signal.aborted) continue;
+          throw error;
+        }
+      } finally {
+        release();
+      }
+    }
+    throw new HTTPTransportError("HTTP/2 session could not accept the request");
+  }
+  async collectHttp2(stream, body, signal) {
+    return await new Promise((resolve, reject) => {
+      let responseHeaders = {};
+      const abort = () => stream.close(http2.constants.NGHTTP2_CANCEL);
+      signal.addEventListener("abort", abort, { once: true });
+      stream.once("response", (value) => responseHeaders = value);
+      stream.once("error", reject);
+      void collectBody(stream, 0, {}, this.config.maxResponseBytes).then((response) => {
+        const status = Number(responseHeaders[":status"] ?? 0);
+        resolve({ body: response.body, headers: normalizeHeaders(responseHeaders), status });
+      }, reject).finally(() => signal.removeEventListener("abort", abort));
+      if (signal.aborted) abort();
+      else stream.end(body);
+    });
+  }
+  session(url) {
+    const origin = url.origin;
+    const current = this.#sessions.get(origin);
+    if (current != null && !current.closed && !current.destroyed) return current;
+    const session = http2.connect(origin, {
+      ...this.config.tlsOptions,
+      settings: { enablePush: false }
+    });
+    const slots = new HTTP2SlotPool();
+    this.#allSessions.add(session);
+    this.#sessionSlots.set(session, slots);
+    session.on("remoteSettings", (settings) => {
+      const remoteLimit = settings.maxConcurrentStreams;
+      const limit = typeof remoteLimit === "number" && Number.isFinite(remoteLimit) ? Math.max(0, Math.floor(remoteLimit)) : this.config.maxConnections;
+      slots.updateLimit(Math.min(this.config.maxConnections, limit));
+    });
+    session.on("error", (error) => this.retireSession(origin, session, true, error));
+    session.once("goaway", () => {
+      this.retireSession(
+        origin,
+        session,
+        "when_idle",
+        new HTTP2SessionRetiredError("HTTP/2 session received GOAWAY")
+      );
+    });
+    session.once("close", () => {
+      if (session.destroyed) this.#allSessions.delete(session);
+      this.retireSession(origin, session);
+    });
+    this.#sessions.set(origin, session);
+    return session;
+  }
+  retireSession(origin, session, destroy = false, cause) {
+    if (this.#sessions.get(origin) === session) this.#sessions.delete(origin);
+    const slots = this.#sessionSlots.get(session);
+    slots?.retire(
+      cause instanceof HTTP2SessionRetiredError ? cause : new HTTP2SessionRetiredError("HTTP/2 session is unavailable", cause)
+    );
+    if (destroy === true && !session.destroyed) session.destroy();
+    else if (destroy === "when_idle") {
+      slots?.whenIdle(() => {
+        if (!session.destroyed) session.destroy();
+      });
+    }
+  }
+  slotPool(session) {
+    const slots = this.#sessionSlots.get(session);
+    if (slots == null) throw new HTTP2SessionRetiredError("HTTP/2 session is unavailable");
+    return slots;
+  }
+  requestHeaders(body) {
+    const headers = { ...this.config.headers };
+    delete headers["content-length"];
+    delete headers["content-type"];
+    return {
+      ...headers,
+      accept: "application/json",
+      ...body == null ? {} : { "content-length": body.byteLength, "content-type": "application/json" }
+    };
+  }
+};
+var requestTimeoutReason = /* @__PURE__ */ Symbol("ferricstore-http-request-timeout");
+function retryableSessionOpenError(error) {
+  if (typeof error !== "object" || error == null || !("code" in error)) return false;
+  const code = error.code;
+  return code === "ERR_HTTP2_GOAWAY_SESSION" || code === "ERR_HTTP2_INVALID_SESSION";
+}
+function refusedStreamError(error) {
+  if (!(error instanceof Error)) return false;
+  return error.code === "ERR_HTTP2_STREAM_ERROR" && error.message.includes("NGHTTP2_REFUSED_STREAM");
+}
+async function collectBody(source, status, headers, maximum) {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of source) {
+    const bytes2 = Buffer36.from(chunk);
+    size += bytes2.byteLength;
+    if (size > maximum) {
+      const destroy = source.destroy;
+      if (destroy != null) destroy.call(source);
+      throw new HTTPTransportError("HTTP response exceeds maxResponseBytes");
+    }
+    chunks.push(bytes2);
+  }
+  return { body: Buffer36.concat(chunks, size), headers, status };
+}
+function normalizeHeaders(headers) {
+  const result = /* @__PURE__ */ Object.create(null);
+  for (const [name, raw] of Object.entries(headers)) {
+    const value = headerValue(raw);
+    if (value != null) result[name.toLowerCase()] = value;
+  }
+  return result;
+}
+function headerValue(value) {
+  if (Array.isArray(value)) return value.join(", ");
+  return value == null ? void 0 : String(value);
+}
+
+// src/http-adapter.ts
+var HTTPAdapter = class _HTTPAdapter {
+  #config;
+  #transport;
+  static async fromUrl(url, options = {}) {
+    return new _HTTPAdapter(normalizeHTTPOptions(url, options));
+  }
+  constructor(config) {
+    this.#config = config;
+    this.#transport = new HTTPTransport(config);
+  }
+  async executeCommand(...args) {
+    return await this.executeCommandArgs(args);
+  }
+  async executeCommandArgs(args) {
+    const [result] = await this.executeBatch([args]);
+    if (result == null) throw new HTTPTransportError("HTTP response omitted a command result");
+    if (result.status === "error") throw commandError(result.error);
+    return result.value;
+  }
+  async executePipeline(commands, options = {}) {
+    const results = await this.executeBatch(commands);
+    const values = results.map((result) => result.status === "ok" ? result.value : commandError(result.error));
+    if (options.throwOnItemError !== false) {
+      const failure = values.find((value) => value instanceof Error);
+      if (failure instanceof Error) throw failure;
+    }
+    return values;
+  }
+  async executeFusedPipeline(commands, options = {}) {
+    return await this.executePipeline(commands, options);
+  }
+  async close() {
+    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");
+    }
+    const serverBlockMs = combinedServerBlockMs(prepared.map((command) => command.serverBlockMs));
+    const response = await this.#transport.post(
+      body,
+      serverResponseTimeoutMs(this.#config.timeoutMs, serverBlockMs)
+    );
+    let envelope = {};
+    try {
+      if (response.body.byteLength > 0) envelope = decodeHTTPEnvelope(response.body);
+    } catch (error) {
+      if (response.status >= 200 && response.status < 300) throw error;
+    }
+    if (response.status < 200 || response.status >= 300) throw topLevelError(
+      response.status,
+      envelope,
+      response.headers["retry-after"]
+    );
+    if (envelope.encoding !== "ferricstore-json-v1") {
+      throw new HTTPTransportError("HTTP response has an unsupported encoding");
+    }
+    if (!Array.isArray(envelope.results) || envelope.results.length !== commands.length) {
+      throw new HTTPTransportError("HTTP response result count does not match the command batch");
+    }
+    return envelope.results.map((result) => validatedResult(result));
+  }
+};
+var commandNamesByOpcode = new Map(
+  Object.entries(COMMAND_OPCODES).map(([name, opcode]) => [opcode, name])
+);
+function prepareHTTPCommand(command, maxRequestBytes) {
+  const protocol = buildProtocolCommand(command, maxRequestBytes, false);
+  if (protocol.opcode === OPCODES.commandExec) {
+    return { encoded: command, serverBlockMs: protocol.serverBlockMs };
+  }
+  const name = commandNamesByOpcode.get(protocol.opcode);
+  if (name == null) throw new HTTPTransportError(`HTTP command has unknown opcode ${protocol.opcode}`);
+  return {
+    encoded: { command: name, opcode: protocol.opcode, payload: protocol.payload ?? {} },
+    serverBlockMs: protocol.serverBlockMs
+  };
+}
+function validatedResult(value) {
+  if (!isRecord2(value)) throw new HTTPTransportError("HTTP response has an invalid result item");
+  if (value.status === "ok" && Object.hasOwn(value, "value")) {
+    return { status: "ok", value: value.value };
+  }
+  if (value.status === "error" && isRecord2(value.error)) {
+    return { error: value.error, status: "error" };
+  }
+  throw new HTTPTransportError("HTTP response has an invalid result item");
+}
+function commandError(value) {
+  const message = isRecord2(value) && typeof value.message === "string" ? value.message : "FerricStore command failed";
+  const code = isRecord2(value) && typeof value.code === "string" ? value.code : void 0;
+  return classifyServerError(message, value, void 0, code);
+}
+function topLevelError(status, envelope, retryAfter) {
+  const details = isRecord2(envelope.error) ? envelope.error : {};
+  const message = typeof details.message === "string" ? details.message : `HTTP command request failed with status ${status}`;
+  const retryAfterMs2 = retryAfterMilliseconds(retryAfter);
+  return new HTTPTransportError(message, {
+    raw: details,
+    retryable: status === 408 || status === 425 || status === 429 || status >= 500,
+    retryAfterMs: retryAfterMs2,
+    safeToRetry: false,
+    statusCode: status
+  });
+}
+function retryAfterMilliseconds(value) {
+  if (value == null) return void 0;
+  if (/^\d+$/u.test(value)) {
+    const seconds = Number.parseInt(value, 10);
+    const milliseconds2 = seconds * 1e3;
+    return Number.isSafeInteger(milliseconds2) ? milliseconds2 : void 0;
+  }
+  const deadline = Date.parse(value);
+  if (!Number.isFinite(deadline)) return void 0;
+  const milliseconds = Math.max(0, deadline - Date.now());
+  return Number.isSafeInteger(milliseconds) ? milliseconds : void 0;
+}
+function isRecord2(value) {
+  return typeof value === "object" && value != null && !Array.isArray(value);
+}
+
 // src/adapters.ts
 function executeCommandArgs(executor, args) {
   if (executor.executeCommandArgs != null) return executor.executeCommandArgs(args);
@@ -8557,7 +9380,7 @@ function executeCommandArgs(executor, args) {
 import "buffer";
 
 // src/command-retry-policy.ts
-import { Buffer as Buffer33 } from "buffer";
+import { Buffer as Buffer37 } from "buffer";
 function isCasMutation(args) {
   const offset = commandName2(args[0]) === "COMMAND_EXEC" ? 1 : 0;
   const name = commandName2(args[offset]);
@@ -8571,8 +9394,8 @@ function isCasMutation(args) {
 }
 function commandName2(value) {
   if (typeof value === "string") return value.toUpperCase();
-  if (Buffer33.isBuffer(value) || value instanceof Uint8Array) {
-    return Buffer33.from(value).toString("utf8").toUpperCase();
+  if (Buffer37.isBuffer(value) || value instanceof Uint8Array) {
+    return Buffer37.from(value).toString("utf8").toUpperCase();
   }
   return void 0;
 }
@@ -8787,12 +9610,12 @@ function normalizeNonNegativeInteger2(value, fallback) {
 import "buffer";
 
 // src/topology-routing.ts
-import { Buffer as Buffer36 } from "buffer";
+import { Buffer as Buffer40 } from "buffer";
 
 // src/flow-partition-route-cache.ts
-import { Buffer as Buffer35 } from "buffer";
+import { Buffer as Buffer39 } from "buffer";
 import { createHash } from "crypto";
-var AUTO_PREFIX = Buffer35.from("__flow_auto__:", "ascii");
+var AUTO_PREFIX = Buffer39.from("__flow_auto__:", "ascii");
 var MAX_CACHEABLE_PARTITION_BYTES = 4 * 1024;
 var MAX_CACHE_BYTES = 1 * 1024 * 1024;
 var MAX_CACHE_ENTRIES = 1024;
@@ -8802,10 +9625,10 @@ var cacheBytes = 0;
 var cacheHits = 0;
 var cacheMisses = 0;
 function flowLogicalPartitionRoutingKey(value) {
-  if (typeof value !== "string" && !Buffer35.isBuffer(value)) return void 0;
+  if (typeof value !== "string" && !Buffer39.isBuffer(value)) return void 0;
   const autoBucket = flowAutoBucket(value);
   if (autoBucket != null) return `{fa:${autoBucket}}`;
-  const bytes2 = Buffer35.isBuffer(value) ? value : Buffer35.from(value);
+  const bytes2 = Buffer39.isBuffer(value) ? value : Buffer39.from(value);
   if (bytes2.byteLength > MAX_CACHEABLE_PARTITION_BYTES) return hashRoute(bytes2);
   const cacheKey = bytes2.toString("base64");
   const cached = routeCache.get(cacheKey);
@@ -8879,7 +9702,7 @@ function routingKeyFromProtocolPayload(name, command) {
       "scope"
     ]) {
       const value = getField(command.payload, field3);
-      if (typeof value === "string" || Buffer36.isBuffer(value)) {
+      if (typeof value === "string" || Buffer40.isBuffer(value)) {
         return value;
       }
     }
@@ -8927,7 +9750,7 @@ function flowRoutingData(name, args) {
     if (typeof partition === "string" && partition.toUpperCase() !== "AUTO" && partition.toUpperCase() !== "MIXED") {
       return flowRoutingResult(flowLogicalPartitionRoutingKey(partition));
     }
-    if (Buffer36.isBuffer(partition)) {
+    if (Buffer40.isBuffer(partition)) {
       const text3 = partition.toString("utf8").toUpperCase();
       if (text3 !== "AUTO" && text3 !== "MIXED") {
         return flowRoutingResult(flowLogicalPartitionRoutingKey(partition));
@@ -9018,17 +9841,17 @@ function flowPartitionRoutingKeyFromCommand(command, claim) {
   return { handled: false };
 }
 function isRoutingKey(value) {
-  return typeof value === "string" || Buffer36.isBuffer(value);
+  return typeof value === "string" || Buffer40.isBuffer(value);
 }
 function flowAutoIdRoutingKey(value) {
-  if (typeof value !== "string" && !Buffer36.isBuffer(value)) {
+  if (typeof value !== "string" && !Buffer40.isBuffer(value)) {
     return void 0;
   }
-  const bucket = (Buffer36.isBuffer(value) ? crc32(value) : crc32Utf8(value)) & 255;
+  const bucket = (Buffer40.isBuffer(value) ? crc32(value) : crc32Utf8(value)) & 255;
   return `{fa:${bucket}}`;
 }
 function flowClaimLogicalPartitionRoutingKey(value) {
-  if (typeof value !== "string" && !Buffer36.isBuffer(value)) return void 0;
+  if (typeof value !== "string" && !Buffer40.isBuffer(value)) return void 0;
   const selector = commandPart(value);
   if (selector === "AUTO" || selector === "ANY") return void 0;
   if (selector === "GLOBAL") return "{f}";
@@ -9043,7 +9866,7 @@ function singleShardFlowClaimPartitionKey(values) {
   return keys.some((key) => key == null) ? void 0 : singleShardKey(keys);
 }
 function singleShardKey(keys) {
-  if (keys.length === 0 || keys.some((key) => typeof key !== "string" && !Buffer36.isBuffer(key))) {
+  if (keys.length === 0 || keys.some((key) => typeof key !== "string" && !Buffer40.isBuffer(key))) {
     return void 0;
   }
   const usable = keys;
@@ -9076,7 +9899,7 @@ function routedKeyGroups(keys, routeKey) {
   const groups = /* @__PURE__ */ new Map();
   for (let index = 0; index < keys.length; index += 1) {
     const key = keys[index];
-    if (typeof key !== "string" && !Buffer36.isBuffer(key)) return void 0;
+    if (typeof key !== "string" && !Buffer40.isBuffer(key)) return void 0;
     const route = routeKey(key);
     const groupKey = `${route.endpointKey}\0${route.laneId}`;
     const group = groups.get(groupKey);
@@ -10165,7 +10988,7 @@ var TopologyNativeAdapterPool = class _TopologyNativeAdapterPool {
 };
 
 // src/response-map-preservation.ts
-import { Buffer as Buffer38 } from "buffer";
+import { Buffer as Buffer42 } from "buffer";
 function toStringKeyMapPreservingValues(value) {
   if (value == null) return void 0;
   const result = {};
@@ -10175,7 +10998,7 @@ function toStringKeyMapPreservingValues(value) {
     }
     return result;
   }
-  if (typeof value === "object" && !Array.isArray(value) && !Buffer38.isBuffer(value) && !(value instanceof Uint8Array)) {
+  if (typeof value === "object" && !Array.isArray(value) && !Buffer42.isBuffer(value) && !(value instanceof Uint8Array)) {
     for (const [key, item] of Object.entries(value)) {
       setOwnValue(result, text(key), normalizeMapStructurePreservingBytes(item));
     }
@@ -10184,7 +11007,7 @@ function toStringKeyMapPreservingValues(value) {
   return void 0;
 }
 function normalizeMapStructurePreservingBytes(value) {
-  if (Buffer38.isBuffer(value) || value instanceof Uint8Array) return value;
+  if (Buffer42.isBuffer(value) || value instanceof Uint8Array) return value;
   if (value instanceof Map) {
     const result = {};
     for (const [key, item] of value.entries()) {
@@ -10206,7 +11029,7 @@ function normalizeMapStructurePreservingBytes(value) {
 }
 
 // src/native-kv-responses.ts
-import { Buffer as Buffer39 } from "buffer";
+import { Buffer as Buffer43 } from "buffer";
 function rateLimitResultFromResp(value) {
   if (!Array.isArray(value) || value.length !== 4) {
     throw new TypeError("RATELIMIT.ADD returned an unexpected response");
@@ -10263,13 +11086,13 @@ function fetchOrComputeResultFromResp(value, codec) {
 }
 function decodePayload(codec, value) {
   if (value == null) return null;
-  if (Buffer39.isBuffer(value)) return codec.decode(value);
-  if (value instanceof Uint8Array) return codec.decode(Buffer39.from(value));
-  if (typeof value === "string") return codec.decode(Buffer39.from(value));
+  if (Buffer43.isBuffer(value)) return codec.decode(value);
+  if (value instanceof Uint8Array) return codec.decode(Buffer43.from(value));
+  if (typeof value === "string") return codec.decode(Buffer43.from(value));
   return normalizeRefMeta(value);
 }
 function requiredResponseString(value, context) {
-  if (typeof value !== "string" && !Buffer39.isBuffer(value) && !(value instanceof Uint8Array)) {
+  if (typeof value !== "string" && !Buffer43.isBuffer(value) && !(value instanceof Uint8Array)) {
     throw new TypeError(`${context} returned an unexpected response`);
   }
   const result = text(value);
@@ -10286,7 +11109,7 @@ function requiredNonNegativeInteger(value, context) {
   return result;
 }
 function responseBytes(value, context) {
-  if (typeof value !== "string" && !Buffer39.isBuffer(value) && !(value instanceof Uint8Array)) {
+  if (typeof value !== "string" && !Buffer43.isBuffer(value) && !(value instanceof Uint8Array)) {
     throw new TypeError(`${context} returned an unexpected response`);
   }
   return bytes(value);
@@ -10969,7 +11792,7 @@ function groupAutoPartitionItems(items) {
 }
 
 // src/client-values.ts
-import { Buffer as Buffer40 } from "buffer";
+import { Buffer as Buffer44 } from "buffer";
 async function valueMGetEntries(client, refs, options = {}) {
   const refCount = refs.length;
   if (refCount === 0) {
@@ -11004,12 +11827,12 @@ async function valueMGetEntries(client, refs, options = {}) {
     const item = response[index];
     if (item == null) {
       entries[index] = { found: false };
-    } else if (Buffer40.isBuffer(item)) {
+    } else if (Buffer44.isBuffer(item)) {
       entries[index] = { found: true, value: client.codec.decode(item) };
     } else if (item instanceof Uint8Array) {
-      entries[index] = { found: true, value: client.codec.decode(Buffer40.from(item)) };
+      entries[index] = { found: true, value: client.codec.decode(Buffer44.from(item)) };
     } else if (typeof item === "string") {
-      entries[index] = { found: true, value: client.codec.decode(Buffer40.from(item)) };
+      entries[index] = { found: true, value: client.codec.decode(Buffer44.from(item)) };
     } else {
       entries[index] = { found: true, value: item };
     }
@@ -11021,7 +11844,7 @@ async function valueMGetEntries(client, refs, options = {}) {
 import "buffer";
 
 // src/auto-batch-ordering.ts
-import { Buffer as Buffer41 } from "buffer";
+import { Buffer as Buffer45 } from "buffer";
 function autoBatchOrderingPlan(batch) {
   const accesses = /* @__PURE__ */ new Map();
   const fallbackDependencies = [];
@@ -11136,13 +11959,13 @@ function flowManyAutoBatchIds(command, name) {
     return fixedFlowItemIds(
       command,
       mixed ? 4 : 3,
-      (itemIndex) => isAutoBatchResourceValue(command[itemIndex]) && (!mixed || isAutoBatchResourceValue(command[itemIndex + 1])) && isFencingToken(command[itemIndex + (mixed ? 2 : 1)]) && Buffer41.isBuffer(command[itemIndex + (mixed ? 3 : 2)])
+      (itemIndex) => isAutoBatchResourceValue(command[itemIndex]) && (!mixed || isAutoBatchResourceValue(command[itemIndex + 1])) && isFencingToken(command[itemIndex + (mixed ? 2 : 1)]) && Buffer45.isBuffer(command[itemIndex + (mixed ? 3 : 2)])
     );
   }
   return fixedFlowItemIds(
     command,
     mixed ? 4 : 3,
-    (itemIndex) => isAutoBatchResourceValue(command[itemIndex]) && (!mixed || isAutoBatchResourceValue(command[itemIndex + 1])) && Buffer41.isBuffer(command[itemIndex + (mixed ? 2 : 1)]) && isFencingToken(command[itemIndex + (mixed ? 3 : 2)])
+    (itemIndex) => isAutoBatchResourceValue(command[itemIndex]) && (!mixed || isAutoBatchResourceValue(command[itemIndex + 1])) && Buffer45.isBuffer(command[itemIndex + (mixed ? 2 : 1)]) && isFencingToken(command[itemIndex + (mixed ? 3 : 2)])
   );
 }
 function createManyAutoBatchIds(command) {
@@ -11155,7 +11978,7 @@ function createManyAutoBatchIds(command) {
       const ids = fixedFlowItemIds(
         command,
         width,
-        (itemIndex) => isAutoBatchResourceValue(command[itemIndex]) && (!mixed || isAutoBatchResourceValue(command[itemIndex + 1])) && Buffer41.isBuffer(command[itemIndex + width - 1]),
+        (itemIndex) => isAutoBatchResourceValue(command[itemIndex]) && (!mixed || isAutoBatchResourceValue(command[itemIndex + 1])) && Buffer45.isBuffer(command[itemIndex + width - 1]),
         markerIndex
       );
       if (ids != null) return ids;
@@ -11173,7 +11996,7 @@ function extendedCreateManyAutoBatchIds(command, markerIndex) {
   let cursor = markerIndex + 2;
   for (let itemIndex = 0; itemIndex < itemCount; itemIndex += 1) {
     const id = command[cursor];
-    if (!isAutoBatchResourceValue(id) || !isAutoBatchResourceValue(command[cursor + 1]) || !Buffer41.isBuffer(command[cursor + 2])) return void 0;
+    if (!isAutoBatchResourceValue(id) || !isAutoBatchResourceValue(command[cursor + 1]) || !Buffer45.isBuffer(command[cursor + 2])) return void 0;
     ids.push(id);
     cursor += 3;
     const afterValues = skipExtendedNamedItems(command, cursor, true);
@@ -11192,7 +12015,7 @@ function skipExtendedNamedItems(command, countIndex, encodedValues) {
   for (let index = 0; index < count; index += 1) {
     const name = command[firstItem + index * 2];
     const value = command[firstItem + index * 2 + 1];
-    if (!isAutoBatchResourceValue(name) || (encodedValues ? !Buffer41.isBuffer(value) : !isAutoBatchResourceValue(value))) return void 0;
+    if (!isAutoBatchResourceValue(name) || (encodedValues ? !Buffer45.isBuffer(value) : !isAutoBatchResourceValue(value))) return void 0;
   }
   return firstItem + count * 2;
 }
@@ -11207,7 +12030,7 @@ function runStepsManyAutoBatchIds(command) {
         ids.push(item);
         continue;
       }
-      if (typeof item !== "object" || item == null || Array.isArray(item) || Buffer41.isBuffer(item)) return void 0;
+      if (typeof item !== "object" || item == null || Array.isArray(item) || Buffer45.isBuffer(item)) return void 0;
       const id = item.id;
       if (!isAutoBatchResourceValue(id)) return void 0;
       ids.push(id);
@@ -11248,7 +12071,7 @@ function flowValuePutOwner(command, start) {
 }
 var flowValuePutOptionTokens = /* @__PURE__ */ new Set(["NAME", "NOW", "OVERRIDE", "OWNER_FLOW_ID", "PARTITION", "TTL", "TTL_MS"]);
 function isAutoBatchResourceValue(value) {
-  return typeof value === "string" || Buffer41.isBuffer(value);
+  return typeof value === "string" || Buffer45.isBuffer(value);
 }
 function isFencingToken(value) {
   return typeof value === "number" && Number.isSafeInteger(value) || typeof value === "bigint";
@@ -11257,7 +12080,7 @@ function nonNegativeItemCount(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : void 0;
 }
 function autoBatchResourceKey(namespace, value) {
-  return `${namespace}:${Buffer41.from(value).toString("base64")}`;
+  return `${namespace}:${Buffer45.from(value).toString("base64")}`;
 }
 function autoBatchCommandName(command) {
   return commandView(command).name ?? null;
@@ -11669,10 +12492,10 @@ function claimFailure(error) {
 import "buffer";
 
 // src/flow-query-builder.ts
-import { Buffer as Buffer44 } from "buffer";
+import { Buffer as Buffer48 } from "buffer";
 
 // src/flow-query-metadata.ts
-import { Buffer as Buffer43 } from "buffer";
+import { Buffer as Buffer47 } from "buffer";
 var MAX_FLOW_QUERY_METADATA_KEY_BYTES = 64;
 function normalizeStateMeta(value, state) {
   if (value == null) return {};
@@ -11697,7 +12520,7 @@ function normalizeStateMeta(value, state) {
 function metadataEntries(value, context) {
   const entries = objectEntries(value ?? {}, context).map(([rawName, item]) => {
     const name = rawName.trim();
-    const size = Buffer43.byteLength(name, "utf8");
+    const size = Buffer47.byteLength(name, "utf8");
     if (size === 0 || size > MAX_FLOW_QUERY_METADATA_KEY_BYTES || name.startsWith("__")) {
       throw new TypeError(`${context} key is invalid or reserved`);
     }
@@ -11721,7 +12544,7 @@ function objectEntries(value, context) {
   return keys.map((key) => [key, value[key]]);
 }
 function isPlainRecord(value) {
-  if (typeof value !== "object" || value == null || Array.isArray(value) || Buffer43.isBuffer(value)) {
+  if (typeof value !== "object" || value == null || Array.isArray(value) || Buffer47.isBuffer(value)) {
     return false;
   }
   const prototype = Object.getPrototypeOf(value);
@@ -11791,7 +12614,7 @@ var FlowCollectionQuery = class {
     const states = /* @__PURE__ */ new Set();
     for (const [rawState, metadata] of objectEntries(values, "stateMeta")) {
       const state = requiredText(rawState, "stateMeta state").trim();
-      const stateBytes = Buffer44.byteLength(state, "utf8");
+      const stateBytes = Buffer48.byteLength(state, "utf8");
       if (stateBytes === 0 || stateBytes > MAX_FLOW_QUERY_STATE_BYTES) {
         throw new TypeError(
           `stateMeta state names must be 1..${MAX_FLOW_QUERY_STATE_BYTES} bytes`
@@ -11970,7 +12793,7 @@ function requiredPartition(value) {
       "FLOW.QUERY convenience methods require a partition key"
     );
   }
-  const size = Buffer44.byteLength(value, "utf8");
+  const size = Buffer48.byteLength(value, "utf8");
   if (size === 0 || size > MAX_FLOW_QUERY_PARTITION_BYTES) {
     throw new TypeError(
       `FLOW.QUERY partition key must be 1..${MAX_FLOW_QUERY_PARTITION_BYTES} bytes`
@@ -12018,23 +12841,23 @@ function requiredText(value, context) {
   return value;
 }
 function queryParameter(value, context) {
-  if (typeof value === "string" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "number" || Buffer44.isBuffer(value)) {
+  if (typeof value === "string" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "number" || Buffer48.isBuffer(value)) {
     return value;
   }
   throw new TypeError(`${context} must be a scalar FLOW.QUERY parameter`);
 }
 
 // src/flow-query-response.ts
-import { Buffer as Buffer48 } from "buffer";
+import { Buffer as Buffer52 } from "buffer";
 
 // src/flow-query-diagnostic-response.ts
-import { Buffer as Buffer46 } from "buffer";
+import { Buffer as Buffer50 } from "buffer";
 
 // src/flow-query-response-validation.ts
-import { Buffer as Buffer45 } from "buffer";
+import { Buffer as Buffer49 } from "buffer";
 function requiredMap2(value, context) {
   if (value instanceof Map) return value;
-  if (typeof value !== "object" || value == null || Array.isArray(value) || Buffer45.isBuffer(value) || value instanceof Uint8Array) {
+  if (typeof value !== "object" || value == null || Array.isArray(value) || Buffer49.isBuffer(value) || value instanceof Uint8Array) {
     throw decodeError(`${context} must be a map`, value);
   }
   return value;
@@ -12091,7 +12914,7 @@ function normalizeMetadataValue(value, context, budget, ancestors, depth) {
     if (!value.isWellFormed()) throw decodeError(`${context} contains invalid text`, value);
     return value;
   }
-  if (Buffer45.isBuffer(value) || value instanceof Uint8Array) {
+  if (Buffer49.isBuffer(value) || value instanceof Uint8Array) {
     const decoded = strictText2(value);
     if (decoded == null) throw decodeError(`${context} contains invalid UTF-8`, value);
     return decoded;
@@ -12170,7 +12993,7 @@ function optionalText2(mapping2, name, context) {
 }
 function requiredBoundedText2(mapping2, name, context, maximumBytes) {
   const value = requiredText2(mapping2, name, context);
-  if (Buffer45.byteLength(value, "utf8") > maximumBytes) {
+  if (Buffer49.byteLength(value, "utf8") > maximumBytes) {
     throw decodeError(
       `${context} ${name} exceeds ${maximumBytes} bytes`,
       mapping2
@@ -12183,7 +13006,7 @@ function boundedText(value, context, maximumBytes) {
   if (decoded == null || decoded.length === 0) {
     throw decodeError(`${context} must be non-empty text`, value);
   }
-  if (Buffer45.byteLength(decoded, "utf8") > maximumBytes) {
+  if (Buffer49.byteLength(decoded, "utf8") > maximumBytes) {
     throw decodeError(`${context} exceeds ${maximumBytes} bytes`, value);
   }
   return decoded;
@@ -12195,7 +13018,7 @@ function requiredBoolean(mapping2, name, context) {
   }
   return value;
 }
-function nonNegativeInteger(value, context) {
+function nonNegativeInteger2(value, context) {
   if (typeof value === "bigint") {
     if (value >= 0n && value <= BigInt(Number.MAX_SAFE_INTEGER))
       return Number(value);
@@ -12204,8 +13027,8 @@ function nonNegativeInteger(value, context) {
   }
   throw decodeError(`${context} must be a non-negative safe integer`, value);
 }
-function positiveInteger(value, context) {
-  const parsed = nonNegativeInteger(value, context);
+function positiveInteger2(value, context) {
+  const parsed = nonNegativeInteger2(value, context);
   if (parsed === 0) throw decodeError(`${context} must be positive`, value);
   return parsed;
 }
@@ -12237,10 +13060,10 @@ function positiveBoundedInteger(value, maximum, context) {
 function hasKey(mapping2, name) {
   if (!(mapping2 instanceof Map)) return Object.hasOwn(mapping2, name);
   if (mapping2.has(name)) return true;
-  const binaryName = Buffer45.from(name);
+  const binaryName = Buffer49.from(name);
   for (const key of mapping2.keys()) {
-    if (Buffer45.isBuffer(key) && key.equals(binaryName)) return true;
-    if (key instanceof Uint8Array && Buffer45.from(key).equals(binaryName))
+    if (Buffer49.isBuffer(key) && key.equals(binaryName)) return true;
+    if (key instanceof Uint8Array && Buffer49.from(key).equals(binaryName))
       return true;
   }
   return false;
@@ -12251,7 +13074,7 @@ function decodeError(message, raw) {
 function strictText2(value) {
   if (typeof value === "string")
     return value.isWellFormed() ? value : void 0;
-  if (Buffer45.isBuffer(value) || value instanceof Uint8Array) {
+  if (Buffer49.isBuffer(value) || value instanceof Uint8Array) {
     try {
       return new TextDecoder("utf-8", { fatal: true }).decode(value);
     } catch {
@@ -12315,7 +13138,7 @@ function tryDecodeFlowQueryError(value, cause) {
       hint: optionalDiagnosticText(mapping2, "hint"),
       retryable: requiredBoolean(mapping2, "retryable", "FLOW.QUERY diagnostic"),
       safeToRetry: requiredBoolean(mapping2, "safe_to_retry", "FLOW.QUERY diagnostic"),
-      retryAfterMs: nonNegativeInteger(
+      retryAfterMs: nonNegativeInteger2(
         field(mapping2, "retry_after_ms"),
         "FLOW.QUERY diagnostic retry_after_ms"
       ),
@@ -12331,7 +13154,7 @@ function tryDecodeFlowQueryError(value, cause) {
 }
 function optionalDiagnosticText(mapping2, name) {
   const value = optionalText2(mapping2, name, "FLOW.QUERY diagnostic");
-  if (value != null && Buffer46.byteLength(value, "utf8") > DIAGNOSTIC_TEXT_BYTES) {
+  if (value != null && Buffer50.byteLength(value, "utf8") > DIAGNOSTIC_TEXT_BYTES) {
     throw decodeError(
       `FLOW.QUERY diagnostic ${name} exceeds ${DIAGNOSTIC_TEXT_BYTES} bytes`,
       mapping2
@@ -12366,7 +13189,7 @@ function validateDiagnosticContextValue(value, depth, budget) {
   }
   const text3 = diagnosticContextText(value);
   if (text3 != null) {
-    if (Buffer46.byteLength(text3, "utf8") <= DIAGNOSTIC_TEXT_BYTES) return;
+    if (Buffer50.byteLength(text3, "utf8") <= DIAGNOSTIC_TEXT_BYTES) return;
     throw decodeError("FLOW.QUERY diagnostic context contains oversized text", value);
   }
   if (depth <= 0) {
@@ -12392,7 +13215,7 @@ function validateDiagnosticContextValue(value, depth, budget) {
     }
     for (const [rawKey, item] of entries) {
       const key = diagnosticContextText(rawKey);
-      if (key == null || key.length === 0 || Buffer46.byteLength(key, "utf8") > DIAGNOSTIC_CONTEXT_KEY_BYTES) {
+      if (key == null || key.length === 0 || Buffer50.byteLength(key, "utf8") > DIAGNOSTIC_CONTEXT_KEY_BYTES) {
         throw decodeError("FLOW.QUERY diagnostic context contains an invalid key", value);
       }
       validateDiagnosticContextValue(item, depth - 1, budget);
@@ -12409,7 +13232,7 @@ function consumeDiagnosticContextNode(value, budget) {
 }
 function diagnosticContextText(value) {
   if (typeof value === "string") return value.isWellFormed() ? value : void 0;
-  if (!Buffer46.isBuffer(value) && !(value instanceof Uint8Array)) return void 0;
+  if (!Buffer50.isBuffer(value) && !(value instanceof Uint8Array)) return void 0;
   try {
     return new TextDecoder("utf-8", { fatal: true }).decode(value);
   } catch {
@@ -12425,9 +13248,9 @@ function decodePosition(value) {
   if (value == null) return void 0;
   const mapping2 = requiredMap2(value, "FLOW.QUERY diagnostic position");
   return Object.freeze({
-    byte: positiveInteger(field(mapping2, "byte"), "FLOW.QUERY diagnostic position byte"),
-    line: positiveInteger(field(mapping2, "line"), "FLOW.QUERY diagnostic position line"),
-    column: positiveInteger(
+    byte: positiveInteger2(field(mapping2, "byte"), "FLOW.QUERY diagnostic position byte"),
+    line: positiveInteger2(field(mapping2, "line"), "FLOW.QUERY diagnostic position line"),
+    column: positiveInteger2(
       field(mapping2, "column"),
       "FLOW.QUERY diagnostic position column"
     )
@@ -12435,7 +13258,7 @@ function decodePosition(value) {
 }
 
 // src/flow-query-index-contract.ts
-import { Buffer as Buffer47 } from "buffer";
+import { Buffer as Buffer51 } from "buffer";
 var FLOW_QUERY_BUILD_PHASES = ["pending", "snapshot", "backfill", "done"];
 var FLOW_QUERY_VALIDATION_PHASES = [
   "pending",
@@ -12681,10 +13504,10 @@ function fieldKind(name) {
   return void 0;
 }
 function validUnquoted(value) {
-  return !value.startsWith("__") && UNQUOTED_METADATA.test(value) && Buffer47.byteLength(value, "ascii") <= 64;
+  return !value.startsWith("__") && UNQUOTED_METADATA.test(value) && Buffer51.byteLength(value, "ascii") <= 64;
 }
 function validMetadata(value, rejectReserved) {
-  return value.length > 0 && Buffer47.byteLength(value, "utf8") <= 64 && (!rejectReserved || !value.startsWith("__"));
+  return value.length > 0 && Buffer51.byteLength(value, "utf8") <= 64 && (!rejectReserved || !value.startsWith("__"));
 }
 function externalSelector(root, ...segments) {
   return segments.every(validUnquoted) ? [root, ...segments].join(".") : root + segments.map((segment) => `['${segment.replaceAll("'", "''")}']`).join("");
@@ -13194,7 +14017,7 @@ function decodeCountPrefixes(value, fieldCount) {
     if (!Object.hasOwn(value, index)) {
       throw decodeError(`${context} must be dense`, value);
     }
-    const prefix = positiveInteger(value[index], `${context} entry`);
+    const prefix = positiveInteger2(value[index], `${context} entry`);
     if (prefix > fieldCount || prefix <= previous) {
       throw decodeError(`${context} are invalid`, value);
     }
@@ -13576,7 +14399,7 @@ function decodeUsage(value) {
   const mapping2 = requiredMap2(value, "FLOW.QUERY usage");
   const usage = /* @__PURE__ */ Object.create(null);
   for (const [wireName, property] of USAGE_FIELDS2) {
-    usage[property] = nonNegativeInteger(
+    usage[property] = nonNegativeInteger2(
       field(mapping2, wireName),
       `FLOW.QUERY usage ${wireName}`
     );
@@ -13591,7 +14414,7 @@ function decodePage(value) {
   const mapping2 = requiredMap2(value, "FLOW.QUERY page");
   const hasMore = requiredBoolean(mapping2, "has_more", "FLOW.QUERY page");
   const cursor = optionalText2(mapping2, "cursor", "FLOW.QUERY page");
-  if (cursor != null && (!cursor.startsWith("fqc1_") || Buffer48.byteLength(cursor) < 16 || Buffer48.byteLength(cursor) > 4096)) {
+  if (cursor != null && (!cursor.startsWith("fqc1_") || Buffer52.byteLength(cursor) < 16 || Buffer52.byteLength(cursor) > 4096)) {
     throw decodeError("FLOW.QUERY page cursor is invalid", value);
   }
   if (hasMore !== (cursor != null)) {
@@ -13604,9 +14427,9 @@ function decodePage(value) {
 import "buffer";
 
 // src/client-core-helpers.ts
-import { Buffer as Buffer49 } from "buffer";
+import { Buffer as Buffer53 } from "buffer";
 function bgsaveResponse(response) {
-  if ((typeof response === "string" || Buffer49.isBuffer(response) || response instanceof Uint8Array) && text(response) === "Background saving started") {
+  if ((typeof response === "string" || Buffer53.isBuffer(response) || response instanceof Uint8Array) && text(response) === "Background saving started") {
     return true;
   }
   return okResponse(response);
@@ -13620,7 +14443,7 @@ function fetchOrComputeCompletionToken(options) {
       "fetch-or-compute completion requires computeToken"
     );
   }
-  if (!Buffer49.isBuffer(options.computeToken)) {
+  if (!Buffer53.isBuffer(options.computeToken)) {
     throw new TypeError("fetch-or-compute computeToken must be a Buffer");
   }
   return options.computeToken;
@@ -13711,7 +14534,14 @@ function snapshotClientOptions(options) {
     ...own2,
     ...typeof own2.autoBatch === "object" && own2.autoBatch != null ? { autoBatch: Object.freeze({ ...own2.autoBatch }) } : {},
     ...own2.backpressure == null ? {} : { backpressure: Object.freeze({ ...own2.backpressure }) },
-    ...typeof own2.reconnect === "object" && own2.reconnect != null ? { reconnect: Object.freeze({ ...own2.reconnect }) } : {}
+    ...typeof own2.reconnect === "object" && own2.reconnect != null ? { reconnect: Object.freeze({ ...own2.reconnect }) } : {},
+    ...own2.httpOptions == null ? {} : {
+      httpOptions: Object.freeze({
+        ...own2.httpOptions,
+        ...own2.httpOptions.headers == null ? {} : { headers: Object.freeze({ ...own2.httpOptions.headers }) },
+        ...own2.httpOptions.tlsOptions == null ? {} : { tlsOptions: Object.freeze({ ...own2.httpOptions.tlsOptions }) }
+      })
+    }
   };
   return Object.freeze(snapshot);
 }
@@ -13980,14 +14810,14 @@ var FerricStoreAdministrationClient = class extends FerricStoreClientBase {
 };
 
 // src/store-utilities.ts
-import { Buffer as Buffer52 } from "buffer";
+import { Buffer as Buffer56 } from "buffer";
 function encode(codec, value) {
   return codec.encode(value);
 }
 function decode(codec, value) {
   if (value == null) return null;
-  if (Buffer52.isBuffer(value)) return codec.decode(value);
-  if (value instanceof Uint8Array) return codec.decode(Buffer52.from(value));
+  if (Buffer56.isBuffer(value)) return codec.decode(value);
+  if (value instanceof Uint8Array) return codec.decode(Buffer56.from(value));
   return value;
 }
 function number(value) {
@@ -14008,7 +14838,7 @@ function array(value, expectedItems, command) {
   }
   return value;
 }
-function denseArray(value, command) {
+function denseArray2(value, command) {
   return assertDenseArray(array(value), command);
 }
 function denseArrayResponse(value, expectedItems, command) {
@@ -14296,7 +15126,7 @@ var BloomFilterStore = class {
     return integerReply(await this.client.command("BF.CARD", key));
   }
   async info(key) {
-    return denseArray(await this.client.command("BF.INFO", key), "BF.INFO");
+    return denseArray2(await this.client.command("BF.INFO", key), "BF.INFO");
   }
 };
 var CuckooFilterStore = class {
@@ -14335,7 +15165,7 @@ var CuckooFilterStore = class {
     return integerReply(await this.client.command("CF.COUNT", key, encode(this.client.codec, element)));
   }
   async info(key) {
-    return denseArray(await this.client.command("CF.INFO", key), "CF.INFO");
+    return denseArray2(await this.client.command("CF.INFO", key), "CF.INFO");
   }
 };
 var CountMinSketchStore = class {
@@ -14380,7 +15210,7 @@ var CountMinSketchStore = class {
     return okResponse(await commandArgs(this.client, args));
   }
   async info(key) {
-    return denseArray(await this.client.command("CMS.INFO", key), "CMS.INFO");
+    return denseArray2(await this.client.command("CMS.INFO", key), "CMS.INFO");
   }
 };
 var TopKStore = class {
@@ -14463,7 +15293,7 @@ var TopKStore = class {
     );
   }
   async info(key) {
-    return denseArray(await this.client.command("TOPK.INFO", key), "TOPK.INFO");
+    return denseArray2(await this.client.command("TOPK.INFO", key), "TOPK.INFO");
   }
 };
 var TDigestStore = class {
@@ -14554,7 +15384,7 @@ var TDigestStore = class {
     return string(await this.client.command("TDIGEST.MAX", key));
   }
   async info(key) {
-    return denseArray(await this.client.command("TDIGEST.INFO", key), "TDIGEST.INFO");
+    return denseArray2(await this.client.command("TDIGEST.INFO", key), "TDIGEST.INFO");
   }
   async merge(destination, sources, options = {}) {
     requireNonEmpty(sources, "TDIGEST.MERGE", "source");
@@ -14946,7 +15776,7 @@ var KeyValueStore = class {
     return response == null ? null : string(response);
   }
   async objectHelp() {
-    return denseArray(await this.client.command("OBJECT", "HELP"), "OBJECT HELP");
+    return denseArray2(await this.client.command("OBJECT", "HELP"), "OBJECT HELP");
   }
   async objectFreq(key) {
     return number(await this.client.command("OBJECT", "FREQ", key));
@@ -15954,14 +16784,14 @@ function validateScheduleCreate(id, options) {
   validateTiming(kind, options);
   const recurring = RECURRING_KINDS.has(kind);
   validateTarget(options.target, recurring);
-  nonNegativeInteger2(options.atMs, "at_ms");
-  nonNegativeInteger2(options.delayMs, "delay_ms");
-  nonNegativeInteger2(options.startAtMs, "start_at_ms");
-  positiveInteger2(options.everyMs, "every_ms");
-  positiveInteger2(options.overlapRetryMs, "overlap_retry_ms");
-  positiveInteger2(options.maxFires, "max_fires");
-  nonNegativeInteger2(options.endAtMs, "end_at_ms");
-  nonNegativeInteger2(options.nowMs, "now_ms");
+  nonNegativeInteger3(options.atMs, "at_ms");
+  nonNegativeInteger3(options.delayMs, "delay_ms");
+  nonNegativeInteger3(options.startAtMs, "start_at_ms");
+  positiveInteger3(options.everyMs, "every_ms");
+  positiveInteger3(options.overlapRetryMs, "overlap_retry_ms");
+  positiveInteger3(options.maxFires, "max_fires");
+  nonNegativeInteger3(options.endAtMs, "end_at_ms");
+  nonNegativeInteger3(options.nowMs, "now_ms");
   optionalBoolean(options.overwrite, "overwrite");
   if (kind === "delay") {
     if (options.delayMs == null) throw new TypeError("delay_ms is required for delay schedules");
@@ -16018,20 +16848,20 @@ function validateScheduleID(id) {
 }
 function validateScheduleFire(id, options) {
   validateScheduleID(id);
-  nonNegativeInteger2(options.fireAtMs, "fire_at_ms");
-  nonNegativeInteger2(options.nowMs, "now_ms");
+  nonNegativeInteger3(options.fireAtMs, "fire_at_ms");
+  nonNegativeInteger3(options.nowMs, "now_ms");
 }
 function validateScheduleStatus(id, nowMs2) {
   validateScheduleID(id);
-  nonNegativeInteger2(nowMs2, "now_ms");
+  nonNegativeInteger3(nowMs2, "now_ms");
 }
 function validateScheduleFireDue(options) {
   if (!mapping(options)) throw new TypeError("schedule fire-due options must be a mapping");
-  nonNegativeInteger2(options.nowMs, "now_ms");
+  nonNegativeInteger3(options.nowMs, "now_ms");
   optionalText3(options.worker, "worker");
-  positiveInteger2(options.leaseMs, "lease_ms");
-  nonNegativeInteger2(options.blockMs, "block_ms");
-  positiveInteger2(options.limit, "limit");
+  positiveInteger3(options.leaseMs, "lease_ms");
+  nonNegativeInteger3(options.blockMs, "block_ms");
+  positiveInteger3(options.limit, "limit");
   const leaseMs = options.leaseMs ?? 3e4;
   if (options.nowMs != null && options.nowMs > MAX_EXACT_INTEGER - leaseMs) {
     throw new TypeError("now_ms plus lease_ms exceeds the exact integer range");
@@ -16047,12 +16877,12 @@ function validateScheduleList(options) {
   }
   optionalText3(options.timezone, "timezone");
   optionalText3(options.targetType, "target_type");
-  nonNegativeInteger2(options.fromMs, "from_ms");
-  nonNegativeInteger2(options.toMs, "to_ms");
+  nonNegativeInteger3(options.fromMs, "from_ms");
+  nonNegativeInteger3(options.toMs, "to_ms");
   if (options.fromMs != null && options.toMs != null && options.fromMs > options.toMs) {
     throw new TypeError("from_ms must not exceed to_ms");
   }
-  positiveInteger2(options.count, "count");
+  positiveInteger3(options.count, "count");
   optionalBoolean(options.rev, "rev");
 }
 function effectiveKind(options) {
@@ -16110,7 +16940,7 @@ function validateTarget(value, recurring) {
   if (typeof idPrefix === "string" && idPrefix.startsWith(INTERNAL_SCHEDULE_ID_PREFIX)) {
     throw new TypeError("target id_prefix is reserved for internal use");
   }
-  nonNegativeInteger2(own(target, "run_at_ms"), "target run_at_ms");
+  nonNegativeInteger3(own(target, "run_at_ms"), "target run_at_ms");
   const priority = own(target, "priority");
   if (priority != null && (typeof priority !== "number" || !Number.isSafeInteger(priority) || priority < 0 || priority > 2)) {
     throw new TypeError("target priority must be an integer between 0 and 2");
@@ -16132,12 +16962,12 @@ function requiredText3(value, name) {
 function optionalText3(value, name) {
   if (value != null) requiredText3(value, name);
 }
-function nonNegativeInteger2(value, name) {
+function nonNegativeInteger3(value, name) {
   if (value != null && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)) {
     throw new TypeError(`${name} must be a non-negative exact integer`);
   }
 }
-function positiveInteger2(value, name) {
+function positiveInteger3(value, name) {
   if (value != null && (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0)) {
     throw new TypeError(`${name} must be a positive exact integer`);
   }
@@ -16843,7 +17673,7 @@ function throwIfClosed(signal) {
 }
 
 // src/flow-policy.ts
-import { Buffer as Buffer54 } from "buffer";
+import { Buffer as Buffer58 } from "buffer";
 var MAX_FLOW_POLICY_GENERATION = Number.MAX_SAFE_INTEGER;
 function assertFlowPolicyGeneration(value) {
   if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
@@ -16861,7 +17691,7 @@ function flowPolicySnapshotFromResp(value) {
   const states = optionalStates(field(policy, "states"));
   return {
     type: requiredText4(field(policy, "type"), "type"),
-    generation: nonNegativeInteger3(field(policy, "generation"), "generation"),
+    generation: nonNegativeInteger4(field(policy, "generation"), "generation"),
     ...state == null ? {} : { state },
     ...version == null ? {} : { version },
     ...mode == null ? {} : { mode },
@@ -16879,12 +17709,12 @@ function retrySnapshot(value, context) {
   const retry2 = requiredRecord(value, `FLOW policy ${context}`);
   const backoff = requiredRecord(field(retry2, "backoff"), `FLOW policy ${context}.backoff`);
   return {
-    maxRetries: nonNegativeInteger3(field(retry2, "max_retries"), `${context}.max_retries`),
+    maxRetries: nonNegativeInteger4(field(retry2, "max_retries"), `${context}.max_retries`),
     backoff: {
       kind: backoffKind(field(backoff, "kind"), `${context}.backoff.kind`),
-      baseMs: nonNegativeInteger3(field(backoff, "base_ms"), `${context}.backoff.base_ms`),
-      maxMs: nonNegativeInteger3(field(backoff, "max_ms"), `${context}.backoff.max_ms`),
-      jitterPct: nonNegativeInteger3(field(backoff, "jitter_pct"), `${context}.backoff.jitter_pct`)
+      baseMs: nonNegativeInteger4(field(backoff, "base_ms"), `${context}.backoff.base_ms`),
+      maxMs: nonNegativeInteger4(field(backoff, "max_ms"), `${context}.backoff.max_ms`),
+      jitterPct: nonNegativeInteger4(field(backoff, "jitter_pct"), `${context}.backoff.jitter_pct`)
     },
     exhaustedTo: requiredText4(field(retry2, "exhausted_to"), `${context}.exhausted_to`)
   };
@@ -16892,8 +17722,8 @@ function retrySnapshot(value, context) {
 function retentionSnapshot(value, context) {
   const retention = requiredRecord(value, `FLOW policy ${context}`);
   return {
-    ttlMs: nonNegativeInteger3(field(retention, "ttl_ms"), `${context}.ttl_ms`),
-    historyMaxEvents: nonNegativeInteger3(
+    ttlMs: nonNegativeInteger4(field(retention, "ttl_ms"), `${context}.ttl_ms`),
+    historyMaxEvents: nonNegativeInteger4(
       field(retention, "history_max_events"),
       `${context}.history_max_events`
     )
@@ -16933,7 +17763,7 @@ function requiredRecord(value, context) {
     }
     return result;
   }
-  if (typeof value === "object" && value != null && !Array.isArray(value) && !Buffer54.isBuffer(value) && !(value instanceof Uint8Array)) return value;
+  if (typeof value === "object" && value != null && !Array.isArray(value) && !Buffer58.isBuffer(value) && !(value instanceof Uint8Array)) return value;
   throw new TypeError(`${context} returned an unexpected response`);
 }
 function optionalRecord(value, context) {
@@ -16954,15 +17784,15 @@ function stringArray(value, context) {
 }
 function requiredText4(value, context) {
   if (typeof value === "string") return value;
-  if (Buffer54.isBuffer(value) || value instanceof Uint8Array) {
-    return Buffer54.from(value).toString("utf8");
+  if (Buffer58.isBuffer(value) || value instanceof Uint8Array) {
+    return Buffer58.from(value).toString("utf8");
   }
   throw new TypeError(`FLOW policy ${context} returned an unexpected response`);
 }
 function optionalText4(value, context) {
   return value == null ? void 0 : requiredText4(value, context);
 }
-function nonNegativeInteger3(value, context) {
+function nonNegativeInteger4(value, context) {
   let parsed;
   try {
     parsed = integer(value);
@@ -16974,14 +17804,14 @@ function nonNegativeInteger3(value, context) {
 }
 function optionalPositiveInteger(value, context) {
   if (value == null) return void 0;
-  const parsed = nonNegativeInteger3(value, context);
+  const parsed = nonNegativeInteger4(value, context);
   if (parsed === 0) throw new TypeError(`FLOW policy ${context} returned an unexpected response`);
   return parsed;
 }
 function optionalVersion(value) {
   if (value == null) return void 0;
   if (typeof value === "number" || typeof value === "bigint") {
-    return nonNegativeInteger3(value, "version");
+    return nonNegativeInteger4(value, "version");
   }
   return requiredText4(value, "version");
 }
@@ -17211,7 +18041,7 @@ var FerricStoreFlowSupportClient = class extends FerricStoreFlowQueryClient {
 };
 
 // src/flow-many-snapshot.ts
-import { Buffer as Buffer56 } from "buffer";
+import { Buffer as Buffer60 } from "buffer";
 var encodedOptionFields = ["error", "payload", "reason", "result"];
 function snapshotCreateItem(item, codec) {
   const snapshot = {
@@ -17251,7 +18081,7 @@ function snapshotFlowManyOptions(options, codec) {
 }
 function snapshotClaimedItem(item) {
   const wire = item[CLAIMED_ITEM_WIRE];
-  const leaseToken = Buffer56.from(wire?.leaseToken ?? item.leaseToken);
+  const leaseToken = Buffer60.from(wire?.leaseToken ?? item.leaseToken);
   const snapshot = {
     ...item,
     fencingToken: wire?.fencingToken ?? item.fencingToken,
@@ -17268,15 +18098,15 @@ function snapshotClaimedItem(item) {
 function snapshotFencedItem(item) {
   return Object.freeze({
     ...item,
-    ...item.leaseToken == null ? {} : { leaseToken: Buffer56.from(item.leaseToken) }
+    ...item.leaseToken == null ? {} : { leaseToken: Buffer60.from(item.leaseToken) }
   });
 }
 function snapshotClaimedItemWire(wire, leaseToken) {
   return Object.freeze({
     fencingToken: wire.fencingToken,
-    id: Buffer56.from(wire.id),
+    id: Buffer60.from(wire.id),
     leaseToken,
-    partitionKey: wire.partitionKey == null ? wire.partitionKey : Buffer56.from(wire.partitionKey)
+    partitionKey: wire.partitionKey == null ? wire.partitionKey : Buffer60.from(wire.partitionKey)
   });
 }
 function snapshotArray(values) {
@@ -17287,7 +18117,7 @@ function snapshotArray(values) {
   return Object.freeze(snapshot);
 }
 function snapshotStateMeta(stateMeta) {
-  return snapshotRecord(stateMeta, (value) => Buffer56.isBuffer(value) ? Buffer56.from(value) : value);
+  return snapshotRecord(stateMeta, (value) => Buffer60.isBuffer(value) ? Buffer60.from(value) : value);
 }
 function snapshotCommandRecord(values) {
   const seen = /* @__PURE__ */ new WeakMap();
@@ -17305,7 +18135,7 @@ function snapshotRecord(values, capture) {
 }
 function snapshotCommandArgument(value, seen) {
   if (typeof value !== "object" || value == null) return value;
-  if (Buffer56.isBuffer(value) || value instanceof Uint8Array) return Buffer56.from(value);
+  if (Buffer60.isBuffer(value) || value instanceof Uint8Array) return Buffer60.from(value);
   const objectValue = value;
   const existing = seen.get(objectValue);
   if (existing != null) return existing;
@@ -18070,6 +18900,14 @@ var FerricStoreProducerClient = class extends FerricStoreClaimClient {
 var FerricStoreClient = class _FerricStoreClient extends FerricStoreProducerClient {
   static async fromUrl(url, options = {}) {
     const clientOptions = snapshotClientOptions(options);
+    const scheme = new URL(url).protocol;
+    if (scheme === "http:" || scheme === "https:") {
+      if (clientOptions.nativeOptions != null) {
+        throw new TypeError("nativeOptions are not valid for an HTTP FerricStore URL");
+      }
+      const executor2 = await HTTPAdapter.fromUrl(url, clientOptions.httpOptions);
+      return new _FerricStoreClient(executor2, clientOptions);
+    }
     const nativeOptions = snapshotNativeClientOptions(clientOptions.nativeOptions ?? {});
     const reconnectOptions = clientOptions.reconnect ?? nativeOptions.autoReconnect ?? true;
     const seeds = nativeOptions.seeds ?? [];
@@ -18293,7 +19131,7 @@ function nativeOptionsForBootstrap(options, signal) {
 }
 
 // src/flow-query-projection.ts
-import { Buffer as Buffer57 } from "buffer";
+import { Buffer as Buffer61 } from "buffer";
 var MAX_PROJECTION_FIELDS = 32;
 var MAX_DYNAMIC_NAME_BYTES = 64;
 var FIELD_BRAND = /* @__PURE__ */ Symbol("FerricStoreFlowProjectionField");
@@ -18363,7 +19201,7 @@ function projectFlowQuery(query, shape, ...fields) {
   }
   const base = stripOptionalTerminator(query);
   const result = `${base} RETURN ${shape.toUpperCase()} (${selectors.join(", ")})`;
-  if (Buffer57.byteLength(result, "utf8") > FLOW_QUERY_MAX_BYTES) {
+  if (Buffer61.byteLength(result, "utf8") > FLOW_QUERY_MAX_BYTES) {
     throw new TypeError(`FLOW.QUERY query exceeds ${FLOW_QUERY_MAX_BYTES} bytes`);
   }
   return result;
@@ -18423,7 +19261,7 @@ function quoteName(value, allowPrivate) {
     throw new TypeError("Flow query projection metadata name must be text");
   }
   validateUnicodeScalarText2(value);
-  const size = Buffer57.byteLength(value, "utf8");
+  const size = Buffer61.byteLength(value, "utf8");
   if (size === 0 || size > MAX_DYNAMIC_NAME_BYTES || !allowPrivate && value.startsWith("__")) {
     throw new TypeError(
       `Flow query projection metadata names must be 1..${MAX_DYNAMIC_NAME_BYTES} UTF-8 bytes`
@@ -18525,7 +19363,7 @@ var LeaseRenewalGuard = class {
     if (options.leaseRenewal === false) {
       return;
     }
-    const intervalMs = positiveInteger3(options.leaseRenewIntervalMs, Math.max(1, Math.trunc(leaseMs / 2)));
+    const intervalMs = positiveInteger4(options.leaseRenewIntervalMs, Math.max(1, Math.trunc(leaseMs / 2)));
     this.timer = setLongInterval(() => this.renew(), intervalMs);
     this.timer.unref();
   }
@@ -18597,7 +19435,7 @@ function snapshotLeasedJob(job) {
   return snapshot;
 }
 function workerConcurrency(options) {
-  return positiveInteger3(options.concurrency ?? options.workers, 1);
+  return positiveInteger4(options.concurrency ?? options.workers, 1);
 }
 function workerRefillStrategy(options) {
   return options.refillStrategy === "wave" ? "wave" : "continuous";
@@ -18640,18 +19478,18 @@ function workerErrorPayload(error, options, codec) {
 }
 function workerBatchSize(options, flowManyBatchLimit = DEFAULT_FLOW_MANY_BATCH_LIMIT2) {
   return Math.min(
-    positiveInteger3(options.batchSize, 10),
-    positiveInteger3(flowManyBatchLimit, DEFAULT_FLOW_MANY_BATCH_LIMIT2)
+    positiveInteger4(options.batchSize, 10),
+    positiveInteger4(flowManyBatchLimit, DEFAULT_FLOW_MANY_BATCH_LIMIT2)
   );
 }
 function workerClaimLimit(options, flowManyBatchLimit = DEFAULT_FLOW_MANY_BATCH_LIMIT2) {
   return Math.min(workerBatchSize(options, flowManyBatchLimit), workerConcurrency(options));
 }
 function workerDrainBatches(options) {
-  return positiveInteger3(options.claimDrainBatches, 1);
+  return positiveInteger4(options.claimDrainBatches, 1);
 }
 function workerLeaseMs(options, fallback = 3e4) {
-  return positiveInteger3(options.leaseMs, positiveInteger3(fallback, 3e4));
+  return positiveInteger4(options.leaseMs, positiveInteger4(fallback, 3e4));
 }
 function workerIdleSleepMs(options) {
   return nonNegativeDuration(options.idleSleepMs, 250);
@@ -18663,7 +19501,7 @@ function workerClaimBlockMs(options, useBlocking) {
   if (options.signal == null || !Number.isFinite(options.blockMs) || options.blockMs < 0) {
     return options.blockMs;
   }
-  const abortPollMs = positiveInteger3(options.abortPollMs, 1e3);
+  const abortPollMs = positiveInteger4(options.abortPollMs, 1e3);
   return options.blockMs === 0 ? abortPollMs : Math.min(Math.trunc(options.blockMs), abortPollMs);
 }
 function workerMaxIdleSleepMs(options, idleSleepMs = workerIdleSleepMs(options)) {
@@ -18674,14 +19512,14 @@ function nextWorkerIdleSleepMs(currentIdleSleepMs, maxIdleSleepMs) {
   return Math.min(maxIdleSleepMs, Math.max(1, currentIdleSleepMs * 2));
 }
 async function runContinuousWorkerPool(options) {
-  const concurrency = positiveInteger3(options.concurrency, 1);
-  const maxClaimSize = positiveInteger3(options.maxClaimSize, concurrency);
+  const concurrency = positiveInteger4(options.concurrency, 1);
+  const maxClaimSize = positiveInteger4(options.maxClaimSize, concurrency);
   const initialIdleSleepMs = nonNegativeDuration(options.idleSleepMs, 250);
   const maxIdleSleepMs = Math.max(
     initialIdleSleepMs,
     nonNegativeDuration(options.maxIdleSleepMs, 5e3)
   );
-  const refillDelayMs = nonNegativeInteger4(options.refillDelayMs, 0);
+  const refillDelayMs = nonNegativeInteger5(options.refillDelayMs, 0);
   const active = /* @__PURE__ */ new Set();
   const pending = [];
   let pendingIndex = 0;
@@ -18797,10 +19635,10 @@ function normalizeWorkflowWorkerConfig(options) {
     ...captured
   });
 }
-function positiveInteger3(value, fallback) {
+function positiveInteger4(value, fallback) {
   return value == null || !Number.isFinite(value) ? fallback : Math.max(1, Math.trunc(value));
 }
-function nonNegativeInteger4(value, fallback) {
+function nonNegativeInteger5(value, fallback) {
   return value == null || !Number.isFinite(value) ? fallback : Math.max(0, Math.trunc(value));
 }
 function nonNegativeDuration(value, fallback) {
@@ -20429,7 +21267,7 @@ var WorkflowWorker = class {
 };
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.11.8";
+var FERRICSTORE_SDK_VERSION = "0.11.10";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 export {
@@ -20452,6 +21290,8 @@ export {
   FlowQueryError,
   FlowWrongStateError,
   GeoStore,
+  HTTPAdapter,
+  HTTPTransportError,
   HashStore,
   HyperLogLogStore,
   InvalidCommandError,
@@ -20489,6 +21329,7 @@ export {
   classifyServerError,
   complete,
   fail2 as fail,
+  httpCommandDisposition,
   isOutcome,
   isReconnectableClosedConnectionError,
   mapException,