@ferricstore/ferricstore 0.11.10 → 0.11.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,7 +21,7 @@
21
21
  <li><span><span class="tsd-kind-parameter">name</span>: <span class="tsd-signature-type">string</span></span></li></ul></div>
22
22
  <h4 class="tsd-returns-title">Returns <a href="../types/HTTPCommandDisposition.html" class="tsd-signature-type tsd-kind-type-alias">HTTPCommandDisposition</a></h4><aside class="tsd-sources">
23
23
  <ul>
24
- <li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/http-command-policy.ts#L56">src/http-command-policy.ts:56</a></li></ul></aside></div></li></ul></section></div>
24
+ <li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/http-command-policy.ts#L59">src/http-command-policy.ts:59</a></li></ul></aside></div></li></ul></section></div>
25
25
  <div class="col-sidebar">
26
26
  <div class="page-menu">
27
27
  <div class="tsd-navigation settings">
@@ -20,8 +20,8 @@
20
20
 
21
21
  <p>Requires Node.js 22.22 or newer. The SDK ships ESM and CommonJS builds and is tested with Node 22, 24, and 26.</p>
22
22
  <h2 id="compatibility" class="tsd-anchor-link">Compatibility<a href="#compatibility" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
23
- <p>TypeScript SDK <code>0.11.10</code> requires FerricStore server <code>0.11.4</code> or newer. With
24
- FerricStore 0.11.10 it negotiates compact Stream mode 34 for homogeneous auto-ID
23
+ <p>TypeScript SDK <code>0.11.11</code> requires FerricStore server <code>0.11.4</code> or newer. With
24
+ FerricStore 0.11.11 it negotiates compact Stream mode 34 for homogeneous auto-ID
25
25
  <code>XADD</code> pipelines and compact Pub/Sub mode 35 for homogeneous <code>PUBLISH</code>
26
26
  pipelines. Native wire protocol v1 and the generic fallback are unchanged.
27
27
  Capabilities and response-size limits are negotiated
@@ -36,7 +36,7 @@ a server version table.</p>
36
36
  </code><button type="button">Copy</button></pre>
37
37
 
38
38
  <h2 id="run-ferricstore-locally" class="tsd-anchor-link">Run FerricStore Locally<a href="#run-ferricstore-locally" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
39
- <pre><code class="bash"><span class="hl-0">docker</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-5">-p</span><span class="hl-1"> </span><span class="hl-2">6388:6388</span><span class="hl-1"> </span><span class="hl-7">\</span><br/><span class="hl-1"> </span><span class="hl-5">-e</span><span class="hl-1"> </span><span class="hl-2">FERRICSTORE_PROTECTED_MODE=</span><span class="hl-5">false</span><span class="hl-1"> </span><span class="hl-7">\</span><br/><span class="hl-1"> </span><span class="hl-5">-v</span><span class="hl-1"> </span><span class="hl-2">ferricstore_data:/data</span><span class="hl-1"> </span><span class="hl-7">\</span><br/><span class="hl-1"> </span><span class="hl-2">quay.io/ferricstore/ferricstore:0.11.10@sha256:3af390b7429ea3fea2983938eb7adcdd3e8005d06c67473f769f29ebd48e8ab3</span>
39
+ <pre><code class="bash"><span class="hl-0">docker</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-5">-p</span><span class="hl-1"> </span><span class="hl-2">6388:6388</span><span class="hl-1"> </span><span class="hl-7">\</span><br/><span class="hl-1"> </span><span class="hl-5">-e</span><span class="hl-1"> </span><span class="hl-2">FERRICSTORE_PROTECTED_MODE=</span><span class="hl-5">false</span><span class="hl-1"> </span><span class="hl-7">\</span><br/><span class="hl-1"> </span><span class="hl-5">-v</span><span class="hl-1"> </span><span class="hl-2">ferricstore_data:/data</span><span class="hl-1"> </span><span class="hl-7">\</span><br/><span class="hl-1"> </span><span class="hl-2">quay.io/ferricstore/ferricstore:0.11.11@sha256:d9f488539f0d6c1a513d2315e7a9c2947cc795b393f3774c9de8ba5e5b5c21b5</span>
40
40
  </code><button type="button">Copy</button></pre>
41
41
 
42
42
  <h2 id="query-durable-runs" class="tsd-anchor-link">Query durable runs<a href="#query-durable-runs" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
@@ -84,6 +84,16 @@ are not auto-coalesced. Redirects intentionally retain authentication and custom
84
84
  headers across origins, so configure only endpoints and redirect targets you
85
85
  trust. Use <code>ferric://</code> or <code>ferrics://</code> whenever connection-local behavior is
86
86
  required.</p>
87
+ <p>Run the complete HTTP-compatible integration surface through a real TLS
88
+ listener with ACL authentication using:</p>
89
+ <pre><code class="bash"><span class="hl-4">FERRICSTORE_IMAGE</span><span class="hl-1">=</span><span class="hl-2">quay.io/ferricstore/ferricstore:0.11.11@sha256:d9f488539f0d6c1a513d2315e7a9c2947cc795b393f3774c9de8ba5e5b5c21b5</span><span class="hl-1"> </span><span class="hl-0">\</span><br/><span class="hl-1"> </span><span class="hl-2">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">test:integration:http</span>
90
+ </code><button type="button">Copy</button></pre>
91
+
92
+ <p>The runner creates a private CA, verifies that unauthenticated access and a
93
+ restricted user's forbidden <code>SET</code> are rejected, and sets
94
+ <code>FERRICSTORE_USERNAME</code>, <code>FERRICSTORE_PASSWORD</code>, and <code>FERRICSTORE_CA_FILE</code> for
95
+ the tests. Native-only subscriptions, topology, and session controls stay in
96
+ the native integration jobs.</p>
87
97
  <h2 id="cluster-aware-client" class="tsd-anchor-link">Cluster-aware client<a href="#cluster-aware-client" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
88
98
  <p>For a single node, use <code>fromUrl</code>. For a FerricStore cluster, pass multiple seed URLs. The SDK fetches the server <code>SHARDS</code> 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 <code>await</code> directly.</p>
89
99
  <p>Cross-shard pipelines are grouped into one native pipeline per leader/lane and
@@ -12,7 +12,7 @@
12
12
  <h1>Type Alias HTTPCommandDisposition</h1></div>
13
13
  <div class="tsd-signature"><span class="tsd-kind-type-alias">HTTPCommandDisposition</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">&quot;supported&quot;</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;native_only&quot;</span></div><aside class="tsd-sources">
14
14
  <ul>
15
- <li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/http-command-policy.ts#L54">src/http-command-policy.ts:54</a></li></ul></aside></div>
15
+ <li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/http-command-policy.ts#L57">src/http-command-policy.ts:57</a></li></ul></aside></div>
16
16
  <div class="col-sidebar">
17
17
  <div class="page-menu">
18
18
  <div class="tsd-navigation settings">
@@ -10,7 +10,7 @@
10
10
  <ul class="tsd-breadcrumb" aria-label="Breadcrumb">
11
11
  <li><a href="" aria-current="page">FERRICSTORE_SDK_VERSION</a></li></ul>
12
12
  <h1>Variable FERRICSTORE_SDK_VERSION<code class="tsd-tag">Const</code></h1></div>
13
- <div class="tsd-signature"><span class="tsd-kind-variable">FERRICSTORE_SDK_VERSION</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">&quot;0.11.10&quot;</span></div>
13
+ <div class="tsd-signature"><span class="tsd-kind-variable">FERRICSTORE_SDK_VERSION</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">&quot;0.11.11&quot;</span></div>
14
14
  <div class="tsd-comment tsd-typography"><p>TypeScript SDK package version.</p>
15
15
  </div><aside class="tsd-sources">
16
16
  <ul>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ferricstore/ferricstore",
3
- "version": "0.11.10",
3
+ "version": "0.11.11",
4
4
  "description": "TypeScript SDK for FerricStore and FerricFlow",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -72,6 +72,7 @@
72
72
  "test": "vitest run tests/*.test.ts",
73
73
  "test:exports": "node scripts/check-package-exports.mjs",
74
74
  "test:integration": "vitest run tests/integration",
75
+ "test:integration:http": "scripts/run-http-integration.sh",
75
76
  "test:integration:isolated": "node scripts/run-isolated-integration.mjs",
76
77
  "test:integration:deployment": "vitest run tests/integration/deployment.test.ts",
77
78
  "typecheck": "tsc --noEmit",