@ai4b-team/fsaos-gateway-sdk 3.38.1 → 3.40.0

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.
package/README.md CHANGED
@@ -257,7 +257,10 @@ src/
257
257
 
258
258
  Set the registered application configuration before importing the SDK, then
259
259
  initialize it once. Tracking starts by default; custom business events remain
260
- explicit.
260
+ explicit. Automatic page and declared-action capture runs for every published
261
+ source that declares those adapters. A successful public form submission sends
262
+ its receipt to each source that declares `form_receipt`; the default source
263
+ continues to supply the durable form row's visitor and session attribution.
261
264
 
262
265
  ```ts
263
266
  window.__FSAOS_CONFIG__ = {
@@ -348,3 +351,22 @@ coalesced item-change events and reconnects, with no polling.
348
351
 
349
352
  Requires the `personal-sections` kernel method from migration `0793523446ad`.
350
353
  Projects are protocol-ready; a consumer must supply its Project UI separately.
354
+
355
+ ### Bound browser read traffic
356
+
357
+ Hosts sharing the SDK's QueryClient can opt into transport scheduling before mounting readers:
358
+
359
+ ```ts
360
+ configureGatewayReads({ concurrency: 6, timeoutMs: 15_000, onTiming: recordTiming });
361
+ useInfiniteItems(filter, { priority: 'foreground' });
362
+ gatewayCall('query', params, { signal, priority: 'background' });
363
+ ```
364
+
365
+ Equivalent in-flight reads share one transport request, scoped by credentials,
366
+ session generation, hostname, and effective parameters. Each observer receives its
367
+ own result object and may cancel independently. The last cancellation aborts the
368
+ fetch; identity reset cancels queued and active reads. The deadline includes queue
369
+ time. `onTiming` reports only method, priority, queue/request duration and outcome.
370
+ Commands, writes, materializing queries and subscriptions bypass the queue. The
371
+ scheduler never retries a request; retry/cooldown policy remains with the host's
372
+ existing QueryClient. Without configuration, transport behavior is unchanged.