@posthog/browser-common 0.6.2 → 0.7.0

package/README.md

@@ -65,9 +65,10 @@ What an extension is given in `setup` — the adapter shared by extensions on th
 
 Identity, session, SDK metadata, capture permission, and the public project token are always-ready synchronous reads.
 `capture` and `sendRequest` are awaitable. For `sendRequest`, `sentAt` controls `sent_at` placement on POST requests; GET query mode
-uses the cache-busting `_` parameter instead, and GET body mode has no effect. `onRemoteConfig` immediately replays the
-latest known success or failure and then reports subsequent outcomes. Extensions that want a named log prefix can
-create a child with `client.logger.createLogger('[myExtension]')`.
+uses the cache-busting `_` parameter instead, and GET body mode has no effect. `onRemoteConfig` replays the latest
+available success or failure and then reports subsequent outcomes. Configuration timing is host-owned, and the
+subscription remains active until disposed. Extensions that want a named log prefix can create a child with
+`client.logger.createLogger('[myExtension]')`.
 
 Extensions that expose controls to other extensions should export a typed stable-name token:
 
@@ -123,7 +124,7 @@ Use `Publisher<T>` when an extension exposes an event stream. Keep the publisher
 private, expose only its listener, and dispose it with the extension:
 
 ```ts
-import { Publisher, type Listener } from '@posthog/browser-common'
+import { Publisher, type Listener } from '@posthog/browser-common/pubsub'
 
 const changes = new Publisher<{ enabled: boolean }>()
 export const onChange: Listener<{ enabled: boolean }> = changes.listener

package/dist/client.d.ts

@@ -65,7 +65,10 @@ export interface SendRequestInit {
     query?: Record<string, string>;
     /** Additional headers merged with the host SDK's configured request headers. */
     headers?: Record<string, string>;
-    /** Browser transport to prefer. `sendBeacon` returns a best-effort response immediately. */
+    /**
+     * Browser transport to prefer. Fetch is the normal runtime transport. Use `sendBeacon` only for an eligible
+     * best-effort teardown POST. Its response confirms browser handoff, not delivery.
+     */
     transport?: RequestTransport;
     /** Abort the request if it does not complete within this many milliseconds. */
     timeoutMs?: number;
@@ -109,7 +112,7 @@ export interface Client {
     getExtension<T extends Extension = Extension>(name: string): T | undefined;
     /** Fires for every captured event through a deeply readonly view. */
     readonly onEvent: Listener<CapturedEventInfo>;
-    /** Replays the latest remote-config outcome on subscription and fires for subsequent outcomes. */
+    /** Replays the latest available remote-config outcome and fires subsequent outcomes when the host makes them available. */
     readonly onRemoteConfig: Listener<DeepReadonly<RemoteConfigResult>>;
     /** Public project token used to authenticate endpoint-specific requests. */
     readonly projectToken: string;

package/dist/config.js

@@ -26,7 +26,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     default: ()=>__WEBPACK_DEFAULT_EXPORT__
 });
-const packageVersion = "0.6.2";
+const packageVersion = "0.7.0";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/config.mjs

@@ -1,4 +1,4 @@
-const packageVersion = "0.6.2";
+const packageVersion = "0.7.0";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/pubsub.d.ts

@@ -1,4 +1,4 @@
-import { type Disposable } from './disposable';
+import type { Disposable } from './disposable';
 /**
  * Call it with a handler to start listening; dispose the returned
  * {@link Disposable} to stop. There is one `Listener` per event type, so every
@@ -17,6 +17,9 @@ export type Listener<T> = (handler: (payload: T) => void) => Disposable;
 export declare class Publisher<T> implements Disposable {
     /** Subscriptions currently registered with this publisher. */
     private _subscriptions;
+    private _disposed;
+    private readonly _onError;
+    constructor(onError?: (error: unknown) => void);
     /**
      * Register a handler for future payloads. The returned disposable
      * subscription unregisters this handler.

package/dist/pubsub.js

@@ -26,35 +26,48 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     Publisher: ()=>Publisher
 });
-const external_disposable_js_namespaceObject = require("./disposable.js");
 class Publisher {
+    constructor(onError){
+        this._subscriptions = [];
+        this._disposed = false;
+        this.listener = (handler)=>{
+            if (this._disposed) return {
+                dispose () {}
+            };
+            const subscription = [
+                handler,
+                true
+            ];
+            this._subscriptions.push(subscription);
+            let active = true;
+            return {
+                dispose: ()=>{
+                    if (!active) return;
+                    active = false;
+                    subscription[1] = false;
+                    const index = this._subscriptions.indexOf(subscription);
+                    if (-1 !== index) this._subscriptions.splice(index, 1);
+                }
+            };
+        };
+        this._onError = onError;
+    }
     publish(payload) {
         const subscriptions = this._subscriptions.slice();
-        subscriptions.forEach((subscription)=>{
-            if (subscription.isActive) subscription.handler(payload);
-        });
+        for (const subscription of subscriptions)if (subscription[1]) try {
+            subscription[0](payload);
+        } catch (error) {
+            if (!this._onError) throw error;
+            this._onError(error);
+        }
     }
     dispose() {
+        this._disposed = true;
         this._subscriptions.forEach((subscription)=>{
-            subscription.isActive = false;
+            subscription[1] = false;
         });
         this._subscriptions = [];
     }
-    constructor(){
-        this._subscriptions = [];
-        this.listener = (handler)=>{
-            const subscription = {
-                handler,
-                isActive: true
-            };
-            this._subscriptions.push(subscription);
-            return (0, external_disposable_js_namespaceObject.createDisposable)(()=>{
-                subscription.isActive = false;
-                const index = this._subscriptions.indexOf(subscription);
-                if (-1 !== index) this._subscriptions.splice(index, 1);
-            });
-        };
-    }
 }
 exports.Publisher = __webpack_exports__.Publisher;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [

package/dist/pubsub.mjs

@@ -1,31 +1,44 @@
-import { createDisposable } from "./disposable.mjs";
 class Publisher {
+    constructor(onError){
+        this._subscriptions = [];
+        this._disposed = false;
+        this.listener = (handler)=>{
+            if (this._disposed) return {
+                dispose () {}
+            };
+            const subscription = [
+                handler,
+                true
+            ];
+            this._subscriptions.push(subscription);
+            let active = true;
+            return {
+                dispose: ()=>{
+                    if (!active) return;
+                    active = false;
+                    subscription[1] = false;
+                    const index = this._subscriptions.indexOf(subscription);
+                    if (-1 !== index) this._subscriptions.splice(index, 1);
+                }
+            };
+        };
+        this._onError = onError;
+    }
     publish(payload) {
         const subscriptions = this._subscriptions.slice();
-        subscriptions.forEach((subscription)=>{
-            if (subscription.isActive) subscription.handler(payload);
-        });
+        for (const subscription of subscriptions)if (subscription[1]) try {
+            subscription[0](payload);
+        } catch (error) {
+            if (!this._onError) throw error;
+            this._onError(error);
+        }
     }
     dispose() {
+        this._disposed = true;
         this._subscriptions.forEach((subscription)=>{
-            subscription.isActive = false;
+            subscription[1] = false;
         });
         this._subscriptions = [];
     }
-    constructor(){
-        this._subscriptions = [];
-        this.listener = (handler)=>{
-            const subscription = {
-                handler,
-                isActive: true
-            };
-            this._subscriptions.push(subscription);
-            return createDisposable(()=>{
-                subscription.isActive = false;
-                const index = this._subscriptions.indexOf(subscription);
-                if (-1 !== index) this._subscriptions.splice(index, 1);
-            });
-        };
-    }
 }
 export { Publisher };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/browser-common",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Internal shared browser utilities and extension primitives for PostHog Browser SDKs",
   "license": "MIT",
   "repository": {
@@ -32,6 +32,9 @@
       "extension-runtime": [
         "dist/extension-runtime.d.ts"
       ],
+      "pubsub": [
+        "dist/pubsub.d.ts"
+      ],
       "utils/*": [
         "dist/utils/*.d.ts"
       ]
@@ -58,6 +61,11 @@
       "require": "./dist/extension-runtime.js",
       "import": "./dist/extension-runtime.mjs"
     },
+    "./pubsub": {
+      "types": "./dist/pubsub.d.ts",
+      "require": "./dist/pubsub.js",
+      "import": "./dist/pubsub.mjs"
+    },
     "./utils/*": {
       "types": "./dist/utils/*.d.ts",
       "require": "./dist/utils/*.js",
@@ -65,7 +73,7 @@
     }
   },
   "dependencies": {
-    "@posthog/core": "^1.49.1",
+    "@posthog/core": "^1.49.2",
     "@posthog/types": "^1.407.1"
   },
   "devDependencies": {