@ferricstore/ferricstore 0.11.10 → 0.12.0

package/README.md

@@ -16,10 +16,23 @@ npm install @ferricstore/ferricstore
 
 Requires Node.js 22.22 or newer. The SDK ships ESM and CommonJS builds and is tested with Node 22, 24, and 26.
 
+Agent framework adapters are optional:
+
+```bash
+npm install @ferricstore/ferricstore @langchain/langgraph @langchain/core
+# or
+npm install @ferricstore/ferricstore @openai/agents
+```
+
+Use `@ferricstore/ferricstore/langgraph` for a LangGraph.js checkpointer,
+long-term `BaseStore`, and FerricFlow handler bridge. Use
+`@ferricstore/ferricstore/openai-agents` for an atomic, idempotent OpenAI
+Agents SDK `Session`. See [docs/agent-frameworks.md](docs/agent-frameworks.md).
+
 ## Compatibility
 
-TypeScript SDK `0.11.10` requires FerricStore server `0.11.4` or newer. With
-FerricStore 0.11.10 it negotiates compact Stream mode 34 for homogeneous auto-ID
+TypeScript SDK `0.12.0` requires FerricStore server `0.11.4` or newer. With
+FerricStore 0.11.11 it negotiates compact Stream mode 34 for homogeneous auto-ID
 `XADD` pipelines and compact Pub/Sub mode 35 for homogeneous `PUBLISH`
 pipelines. Native wire protocol v1 and the generic fallback are unchanged.
 Capabilities and response-size limits are negotiated
@@ -44,7 +57,7 @@ const { FerricStoreClient, JsonCodec } = require("@ferricstore/ferricstore");
 docker run -p 6388:6388 \
   -e FERRICSTORE_PROTECTED_MODE=false \
   -v ferricstore_data:/data \
-  quay.io/ferricstore/ferricstore:0.11.10@sha256:3af390b7429ea3fea2983938eb7adcdd3e8005d06c67473f769f29ebd48e8ab3
+  quay.io/ferricstore/ferricstore:0.11.11@sha256:d9f488539f0d6c1a513d2315e7a9c2947cc795b393f3774c9de8ba5e5b5c21b5
 ```
 
 ## Query durable runs
@@ -130,6 +143,20 @@ headers across origins, so configure only endpoints and redirect targets you
 trust. Use `ferric://` or `ferrics://` whenever connection-local behavior is
 required.
 
+Run the complete HTTP-compatible integration surface through a real TLS
+listener with ACL authentication using:
+
+```bash
+FERRICSTORE_IMAGE=quay.io/ferricstore/ferricstore:0.11.11@sha256:d9f488539f0d6c1a513d2315e7a9c2947cc795b393f3774c9de8ba5e5b5c21b5 \
+  npm run test:integration:http
+```
+
+The runner creates a private CA, verifies that unauthenticated access and a
+restricted user's forbidden `SET` are rejected, and sets
+`FERRICSTORE_USERNAME`, `FERRICSTORE_PASSWORD`, and `FERRICSTORE_CA_FILE` for
+the tests. Native-only subscriptions, topology, and session controls stay in
+the native integration jobs.
+
 ## Cluster-aware client
 
 For a single node, use `fromUrl`. For a FerricStore cluster, pass multiple seed URLs. The SDK fetches the server `SHARDS` topology, routes keyed commands to the current shard leader, and refuses learned hosts outside the seed-host trust set by default. The creation promise resolves only after startup and authentication succeed; cluster creation also waits for the initial topology, so connection failures reject the corresponding `await` directly.
@@ -635,6 +662,8 @@ Runnable examples live in the `examples/` directory:
 - [signals.ts](examples/signals.ts)
 - [value-refs.ts](examples/value-refs.ts)
 - [kv-store.ts](examples/kv-store.ts)
+- [langgraph.ts](examples/langgraph.ts)
+- [openai-agents-session.ts](examples/openai-agents-session.ts)
 
 ## Codecs
 

package/dist/durability-DlDCsdlo.d.cts

@@ -0,0 +1,16 @@
+import { C as CommandArgument, a as Command } from './internal-lEEDZpPH.cjs';
+
+interface FerricStoreCommandClient {
+    command(...args: CommandArgument[]): Promise<unknown>;
+    pipeline?(commands: readonly Command[]): Promise<unknown[]>;
+}
+interface FerricStoreLockOptions {
+    /** Lease duration for adapter mutation locks. Defaults to five minutes. */
+    lockTtlMs?: number;
+    /** Maximum time to wait for a contended mutation lock. Defaults to 30 seconds. */
+    lockWaitMs?: number;
+    /** Delay between lock acquisition attempts. Defaults to 10 milliseconds. */
+    lockRetryMs?: number;
+}
+
+export type { FerricStoreCommandClient as F, FerricStoreLockOptions as a };

package/dist/durability-DplL0SbW.d.ts

@@ -0,0 +1,16 @@
+import { C as CommandArgument, a as Command } from './internal-lEEDZpPH.js';
+
+interface FerricStoreCommandClient {
+    command(...args: CommandArgument[]): Promise<unknown>;
+    pipeline?(commands: readonly Command[]): Promise<unknown[]>;
+}
+interface FerricStoreLockOptions {
+    /** Lease duration for adapter mutation locks. Defaults to five minutes. */
+    lockTtlMs?: number;
+    /** Maximum time to wait for a contended mutation lock. Defaults to 30 seconds. */
+    lockWaitMs?: number;
+    /** Delay between lock acquisition attempts. Defaults to 10 milliseconds. */
+    lockRetryMs?: number;
+}
+
+export type { FerricStoreCommandClient as F, FerricStoreLockOptions as a };

package/dist/index.cjs

@@ -8704,6 +8704,9 @@ var sessionOnlyCommands = /* @__PURE__ */ new Set([
   "CLIENT",
   "DISCARD",
   "EXEC",
+  "FETCH_OR_COMPUTE",
+  "FETCH_OR_COMPUTE_ERROR",
+  "FETCH_OR_COMPUTE_RESULT",
   "HELLO",
   "MONITOR",
   "MULTI",
@@ -8753,6 +8756,7 @@ var encoding = "ferricstore-json-v1";
 var bytesMarker = "$ferricstore_bytes";
 var mapMarker = "$ferricstore_map";
 var maxDepth = 64;
+var integerJSON = /^-?(?:0|[1-9][0-9]*)$/u;
 var bytesMarkerBaseBytes = import_node_buffer34.Buffer.byteLength(bytesMarker) + 7;
 var mapMarkerBaseBytes = import_node_buffer34.Buffer.byteLength(mapMarker) + 7;
 function encodeHTTPCommands(commands, maxBytes = Number.MAX_SAFE_INTEGER) {
@@ -8765,13 +8769,20 @@ function encodeHTTPCommands(commands, maxBytes = Number.MAX_SAFE_INTEGER) {
 function decodeHTTPEnvelope(source) {
   let parsed;
   try {
-    parsed = JSON.parse(source.toString("utf8"));
+    parsed = JSON.parse(source.toString("utf8"), preserveIntegerPrecision);
   } 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 preserveIntegerPrecision(_key, value, context) {
+  if (typeof value !== "number" || Number.isSafeInteger(value) || !Number.isInteger(value)) {
+    return value;
+  }
+  const literal = context?.source;
+  return literal != null && integerJSON.test(literal) ? BigInt(literal) : value;
+}
 function encodeValue(value, depth, budget) {
   if (depth > maxDepth) throw new TypeError("HTTP command value exceeds maximum depth");
   if (value == null) {
@@ -21367,7 +21378,7 @@ var WorkflowWorker = class {
 };
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.11.10";
+var FERRICSTORE_SDK_VERSION = "0.12.0";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 // Annotate the CommonJS export names for ESM import in node: