@posthog/types 1.372.9 → 1.373.0

package/dist/capture.d.ts

@@ -60,6 +60,13 @@ export interface CaptureOptions {
      * If set, overrides the current timestamp
      */
     timestamp?: Date;
+    /**
+     * If set, overrides the auto-generated event uuid. Useful for cross-source idempotency
+     * (e.g. a server webhook and a browser success page both firing for the same business
+     * transaction): emit both events with the same deterministic uuid so PostHog can dedupe
+     * them.
+     */
+    uuid?: string;
     /**
      * Internal flag set by captureException() / sendExceptionEvent() to indicate this $exception
      * event originated from the proper exception capture path. Used to warn users who call

package/dist/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACpB,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,aAAa,GACb,aAAa,GACb,cAAc,GACd,mBAAmB,GACnB,YAAY,CAAA;AAElB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAC9B,MAAM,GACN,WAAW,GACX,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,sBAAsB,CAAA;AAE5B,MAAM,MAAM,SAAS,GACf,wBAAwB,GACxB,cAAc,GAId,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,SAAS,CAAC,EAAE,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAA;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;OAEG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAA;IAEnC;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,YAAY,CAAA;IAE1C;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAA;IAEhB;;;;OAIG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAA;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,KAAK,aAAa,GAAG,IAAI,CAAA"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACpB,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,aAAa,GACb,aAAa,GACb,cAAc,GACd,mBAAmB,GACnB,YAAY,CAAA;AAElB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAC9B,MAAM,GACN,WAAW,GACX,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,sBAAsB,CAAA;AAE5B,MAAM,MAAM,SAAS,GACf,wBAAwB,GACxB,cAAc,GAId,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,SAAS,CAAC,EAAE,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAA;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;OAEG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAA;IAEnC;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,YAAY,CAAA;IAE1C;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAA;IAEhB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAA;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,KAAK,aAAa,GAAG,IAAI,CAAA"}

package/dist/posthog-config.d.ts

@@ -1195,7 +1195,7 @@ export interface PostHogConfig {
      * - **Disabled (0)**: No background refreshes. Flags only update on page load or manual `reloadFeatureFlags()` calls.
      *   Use this if you control flag updates manually or have infrequent flag changes.
      *
-     * Note: Refreshes are automatically skipped when the browser tab is hidden.
+     * Note: Refreshes are automatically skipped when the browser tab is hidden or no document is available.
      *
      * @default 300000 (5 minutes)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/types",
-  "version": "1.372.9",
+  "version": "1.373.0",
   "description": "Type definitions for the PostHog JavaScript SDK",
   "license": "MIT",
   "main": "dist/index.js",

package/src/capture.ts

@@ -97,6 +97,14 @@ export interface CaptureOptions {
      */
     timestamp?: Date
 
+    /**
+     * If set, overrides the auto-generated event uuid. Useful for cross-source idempotency
+     * (e.g. a server webhook and a browser success page both firing for the same business
+     * transaction): emit both events with the same deterministic uuid so PostHog can dedupe
+     * them.
+     */
+    uuid?: string
+
     /**
      * Internal flag set by captureException() / sendExceptionEvent() to indicate this $exception
      * event originated from the proper exception capture path. Used to warn users who call

package/src/posthog-config.ts

@@ -1350,7 +1350,7 @@ export interface PostHogConfig {
      * - **Disabled (0)**: No background refreshes. Flags only update on page load or manual `reloadFeatureFlags()` calls.
      *   Use this if you control flag updates manually or have infrequent flag changes.
      *
-     * Note: Refreshes are automatically skipped when the browser tab is hidden.
+     * Note: Refreshes are automatically skipped when the browser tab is hidden or no document is available.
      *
      * @default 300000 (5 minutes)
      */