@geolonia/geonicdb-sdk 0.19.3 → 0.20.0

package/geonicdb.d.ts

@@ -481,14 +481,21 @@ export interface RegisterWebPushSubscriptionOptions extends WebPushSubscribeOpti
 	/** NGSI-LD `q` filter (ignored for NGSIv2). */
 	q?: string;
 	/**
-	 * Override the localStorage key used for idempotency. Default includes
-	 * baseUrl + tenant + protocol.
+	 * Override the localStorage key used for idempotency. Default is
+	 * `buildWebPushSubscriptionStorageKey(baseUrl, tenant, protocol)` — it does
+	 * **not** include login principal. On a shared browser (kiosk, shared profile)
+	 * or when registering multiple distinct filters from the same origin, pass a
+	 * key that still includes that default scope plus app-managed suffixes
+	 * (e.g. `` `${buildWebPushSubscriptionStorageKey(...)}:${userId}:${filterId}` ``).
+	 * See docs/SDK.md → Web Push (#3097).
 	 */
 	storageKey?: string;
 }
 /**
- * Build the default localStorage key for a Web Push GeonicDB subscription id.
- * Exported for tests and for callers that want to clear the persisted id.
+ * Build the default localStorage key for a Web Push GeonicDB subscription id
+ * (`baseUrl` + `tenant` + `protocol` only — not principal). Exported so callers
+ * can append user/filter suffixes for shared-browser isolation (#3097) or clear
+ * the persisted id.
  */
 export declare function buildWebPushSubscriptionStorageKey(baseUrl: string, tenant: string, protocol: WebPushRegisterProtocol): string;
 /**