@posthog/browser-common 0.8.3 → 0.9.1

package/README.md

@@ -64,7 +64,8 @@ What an extension is given in `setup` — the adapter shared by extensions on th
 - **storage and logging**: `kv`, `logger`
 
 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
+`capture` synchronously admits an event to the host pipeline; use host lifecycle APIs when delivery completion matters.
+`sendRequest` is awaitable. Its `sentAt` option controls `sent_at` placement on POST requests; GET query mode
 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

package/dist/client.d.ts

@@ -102,8 +102,8 @@ export interface Client {
     readonly session: SessionContext;
     /** Whether the host currently permits data capture. */
     readonly canCapture: boolean;
-    /** Records an analytics event through the client's normal pipeline. */
-    capture(event: string, properties?: Properties | null, options?: CaptureOptions): Promise<void>;
+    /** Synchronously admits an analytics event to the client's normal pipeline. */
+    capture(event: string, properties?: Properties | null, options?: CaptureOptions): void;
     /** Registers a synchronous producer of properties merged into every captured event. */
     registerDynamicEventProperties(producer: () => Record<string, unknown>): Disposable;
     /** Returns the extension registered under a typed stable name, or `undefined` when it is not installed. */

package/dist/config.js

@@ -27,7 +27,7 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
-const packageVersion = "0.8.3";
+const packageVersion = "0.9.1";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/config.mjs

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

package/dist/types/compression.d.ts

@@ -1,5 +1,5 @@
 export declare const Compression: {
-    readonly GZipJS: "gzip-js";
-    readonly Base64: "base64";
+    readonly GZipJS: 'gzip-js';
+    readonly Base64: 'base64';
 };
 export type Compression = (typeof Compression)[keyof typeof Compression];

package/dist/types/surveys.d.ts

@@ -1,89 +1,89 @@
 import type { PropertyMatchType, SurveyAppearance as CoreSurveyAppearance, SurveyEventWithFilters, SurveyQuestionTranslation, SurveyTranslation, SurveyValidationRule } from '@posthog/core';
 export type { PropertyFilters, PropertyMatchType, PropertyOperator, SurveyEventWithFilters } from '@posthog/core';
 export declare const SurveyEventType: {
-    readonly Activation: "events";
-    readonly Cancellation: "cancelEvents";
+    readonly Activation: 'events';
+    readonly Cancellation: 'cancelEvents';
 };
 export type SurveyEventType = (typeof SurveyEventType)[keyof typeof SurveyEventType];
 export declare const SurveyWidgetType: {
-    readonly Button: "button";
-    readonly Tab: "tab";
-    readonly Selector: "selector";
+    readonly Button: 'button';
+    readonly Tab: 'tab';
+    readonly Selector: 'selector';
 };
 export type SurveyWidgetType = (typeof SurveyWidgetType)[keyof typeof SurveyWidgetType];
 export declare const SurveyPosition: {
-    readonly TopLeft: "top_left";
-    readonly TopRight: "top_right";
-    readonly TopCenter: "top_center";
-    readonly MiddleLeft: "middle_left";
-    readonly MiddleRight: "middle_right";
-    readonly MiddleCenter: "middle_center";
-    readonly Left: "left";
-    readonly Center: "center";
-    readonly Right: "right";
-    readonly NextToTrigger: "next_to_trigger";
+    readonly TopLeft: 'top_left';
+    readonly TopRight: 'top_right';
+    readonly TopCenter: 'top_center';
+    readonly MiddleLeft: 'middle_left';
+    readonly MiddleRight: 'middle_right';
+    readonly MiddleCenter: 'middle_center';
+    readonly Left: 'left';
+    readonly Center: 'center';
+    readonly Right: 'right';
+    readonly NextToTrigger: 'next_to_trigger';
 };
 export type SurveyPosition = (typeof SurveyPosition)[keyof typeof SurveyPosition];
 export declare const SurveyTabPosition: {
-    readonly Top: "top";
-    readonly Left: "left";
-    readonly Right: "right";
-    readonly Bottom: "bottom";
+    readonly Top: 'top';
+    readonly Left: 'left';
+    readonly Right: 'right';
+    readonly Bottom: 'bottom';
 };
 export type SurveyTabPosition = (typeof SurveyTabPosition)[keyof typeof SurveyTabPosition];
 export declare const SurveyType: {
-    readonly Popover: "popover";
-    readonly API: "api";
-    readonly Widget: "widget";
-    readonly ExternalSurvey: "external_survey";
+    readonly Popover: 'popover';
+    readonly API: 'api';
+    readonly Widget: 'widget';
+    readonly ExternalSurvey: 'external_survey';
 };
 export type SurveyType = (typeof SurveyType)[keyof typeof SurveyType];
 export declare const SurveyQuestionType: {
-    readonly Open: "open";
-    readonly MultipleChoice: "multiple_choice";
-    readonly SingleChoice: "single_choice";
-    readonly Rating: "rating";
-    readonly Link: "link";
+    readonly Open: 'open';
+    readonly MultipleChoice: 'multiple_choice';
+    readonly SingleChoice: 'single_choice';
+    readonly Rating: 'rating';
+    readonly Link: 'link';
 };
 export type SurveyQuestionType = (typeof SurveyQuestionType)[keyof typeof SurveyQuestionType];
 export declare const SurveyQuestionBranchingType: {
-    readonly NextQuestion: "next_question";
-    readonly End: "end";
-    readonly ResponseBased: "response_based";
-    readonly SpecificQuestion: "specific_question";
+    readonly NextQuestion: 'next_question';
+    readonly End: 'end';
+    readonly ResponseBased: 'response_based';
+    readonly SpecificQuestion: 'specific_question';
 };
 export type SurveyQuestionBranchingType = (typeof SurveyQuestionBranchingType)[keyof typeof SurveyQuestionBranchingType];
 export declare const SurveySchedule: {
-    readonly Once: "once";
-    readonly Recurring: "recurring";
-    readonly Always: "always";
+    readonly Once: 'once';
+    readonly Recurring: 'recurring';
+    readonly Always: 'always';
 };
 export type SurveySchedule = (typeof SurveySchedule)[keyof typeof SurveySchedule];
 export declare const SurveyEventName: {
-    readonly SHOWN: "survey shown";
-    readonly DISMISSED: "survey dismissed";
-    readonly SENT: "survey sent";
-    readonly ABANDONED: "survey abandoned";
+    readonly SHOWN: 'survey shown';
+    readonly DISMISSED: 'survey dismissed';
+    readonly SENT: 'survey sent';
+    readonly ABANDONED: 'survey abandoned';
 };
 export type SurveyEventName = (typeof SurveyEventName)[keyof typeof SurveyEventName];
 export declare const SurveyEventProperties: {
-    readonly SURVEY_ID: "$survey_id";
-    readonly SURVEY_NAME: "$survey_name";
-    readonly SURVEY_RESPONSE: "$survey_response";
-    readonly SURVEY_ITERATION: "$survey_iteration";
-    readonly SURVEY_ITERATION_START_DATE: "$survey_iteration_start_date";
-    readonly SURVEY_PARTIALLY_COMPLETED: "$survey_partially_completed";
-    readonly SURVEY_SUBMISSION_ID: "$survey_submission_id";
-    readonly SURVEY_QUESTIONS: "$survey_questions";
-    readonly SURVEY_COMPLETED: "$survey_completed";
-    readonly PRODUCT_TOUR_ID: "$product_tour_id";
-    readonly SURVEY_LAST_SEEN_DATE: "$survey_last_seen_date";
-    readonly SURVEY_LANGUAGE: "$survey_language";
+    readonly SURVEY_ID: '$survey_id';
+    readonly SURVEY_NAME: '$survey_name';
+    readonly SURVEY_RESPONSE: '$survey_response';
+    readonly SURVEY_ITERATION: '$survey_iteration';
+    readonly SURVEY_ITERATION_START_DATE: '$survey_iteration_start_date';
+    readonly SURVEY_PARTIALLY_COMPLETED: '$survey_partially_completed';
+    readonly SURVEY_SUBMISSION_ID: '$survey_submission_id';
+    readonly SURVEY_QUESTIONS: '$survey_questions';
+    readonly SURVEY_COMPLETED: '$survey_completed';
+    readonly PRODUCT_TOUR_ID: '$product_tour_id';
+    readonly SURVEY_LAST_SEEN_DATE: '$survey_last_seen_date';
+    readonly SURVEY_LANGUAGE: '$survey_language';
 };
 export type SurveyEventProperties = (typeof SurveyEventProperties)[keyof typeof SurveyEventProperties];
 export declare const DisplaySurveyType: {
-    readonly Popover: "popover";
-    readonly Inline: "inline";
+    readonly Popover: 'popover';
+    readonly Inline: 'inline';
 };
 export type DisplaySurveyType = (typeof DisplaySurveyType)[keyof typeof DisplaySurveyType];
 export type SurveyQuestionDescriptionContentType = 'html' | 'text';

package/dist/utils/event-utils.js

@@ -82,6 +82,7 @@ const PERSONAL_DATA_CAMPAIGN_PARAMS = [
     'epik',
     'qclid',
     'sccid',
+    'oppref',
     'irclid',
     '_kx'
 ];

package/dist/utils/event-utils.mjs

@@ -22,6 +22,7 @@ const PERSONAL_DATA_CAMPAIGN_PARAMS = [
     'epik',
     'qclid',
     'sccid',
+    'oppref',
     'irclid',
     '_kx'
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/browser-common",
-  "version": "0.8.3",
+  "version": "0.9.1",
   "description": "Internal shared browser utilities and extension primitives for PostHog Browser SDKs",
   "license": "MIT",
   "repository": {
@@ -73,13 +73,13 @@
     }
   },
   "dependencies": {
-    "@posthog/types": "^1.411.1",
-    "@posthog/core": "^1.53.2"
+    "@posthog/core": "^1.55.3",
+    "@posthog/types": "^1.413.0"
   },
   "devDependencies": {
     "@rslib/core": "0.23.2",
     "jsdom": "^26.1.0",
-    "typescript": "5.8.2",
+    "typescript": "7.0.2",
     "vitest": "^1.6.1",
     "@posthog-tooling/tsconfig-base": "1.1.1"
   },