@ai4b-team/fsaos-gateway-sdk 3.19.0 → 3.20.0

package/README.md

@@ -40,6 +40,7 @@ Rule of thumb: if the answer should differ depending on *who is asking* or *whic
 
 ### Session Management
 - `initSession()` — Initialize domain-scoped session via `GET /d/{hostname}/init`
+- `initializeFsaos()` — Canonical one-call domain session + tracking bootstrap
 - `clearSession()` — Clear cached session
 - `getSessionEntry()` — Get current session entry (or null)
 - `getAccessToken()` — Get current auth token (waits for first auth event)
@@ -200,6 +201,26 @@ src/
   index.ts             — Barrel export
 ```
 
+## Application bootstrap
+
+Set the registered application configuration before importing the SDK, then
+initialize it once. Tracking starts by default; custom business events remain
+explicit.
+
+```ts
+window.__FSAOS_CONFIG__ = {
+  hostname: 'app.example.com',
+  gatewayUrl: 'https://fsaos-mcp-gw-rust.fly.dev',
+};
+
+const { initializeFsaos } = await import('@ai4b-team/fsaos-gateway-sdk');
+const fsaos = await initializeFsaos();
+```
+
+Use `initializeFsaos({ tracking: false })` when consent or product policy
+requires tracking to remain disabled. Published FSAOS IIFE pages call the same
+bootstrap automatically.
+
 ## Build
 
 ```bash