@alwaysmeticulous/sdk-bundles-api 2.293.0 → 2.295.0

package/dist/record/record-settings.d.ts

@@ -10,6 +10,17 @@ export interface MeticulousWindowConfig {
     METICULOUS_RECORDER_MIDDLEWARE_V1: RecorderMiddleware[];
     METICULOUS_DISABLE_ERROR_REPORTING?: boolean;
     METICULOUS_DISABLE_TRACKER_ID?: boolean;
+    /**
+     * Maximum size in bytes of a single session payload upload.
+     *
+     * Without a cap, long or network-heavy sessions can produce payloads large
+     * enough to exceed V8's maximum string length (~512 MB), causing a
+     * "Cannot create a string longer than 0x1fffffe8 characters" crash in any
+     * Node.js process that buffers the upload body (e.g. Playwright's CDP layer).
+     *
+     * @see {@link LoaderOptions.maxPayloadSize}
+     */
+    METICULOUS_MAX_PAYLOAD_SIZE?: number;
 }
 /**
  * Allows sanitizing network responses before they are sent to Meticulous's servers.

package/dist/window-api/public-window-api.d.ts

@@ -218,6 +218,49 @@ export interface MeticulousPublicReplayApi {
              */
             measureUserAgentSpecificMemory?: () => Promise<any>;
         };
+        /**
+         * Schedules a callback using the real wall-clock timer (not virtual time).
+         * Uses the native setTimeout() that was captured before stubbing.
+         *
+         * Callbacks run on real time and are not synchronized with Meticulous's
+         * screenshot points (which advance on virtual time). Scheduling work here
+         * from application logic can fire at unpredictable moments relative to
+         * screenshots and cause nondeterministic visual diffs.
+         *
+         * Intended for custom snapshot listeners and other Meticulous hooks (e.g.
+         * {@link addOnBeforeScreenshotListener}), not as a general timer replacement
+         * during replay.
+         *
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout
+         */
+        setTimeout: typeof window.setTimeout;
+        /**
+         * Schedules a repeating callback using the real wall-clock timer (not virtual
+         * time). Uses the native setInterval() that was captured before stubbing.
+         *
+         * Like {@link setTimeout}, callbacks are not synchronized with screenshot
+         * points and can cause nondeterministic visual diffs if used from application
+         * logic. Prefer Meticulous hooks (e.g.
+         * {@link addOnBeforeScreenshotListener}) over app-level intervals during
+         * replay.
+         *
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval
+         */
+        setInterval: typeof window.setInterval;
+        /**
+         * Cancels a timeout scheduled with {@link setTimeout}.
+         * Uses the native clearTimeout() that was captured before stubbing.
+         *
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/clearTimeout
+         */
+        clearTimeout: typeof window.clearTimeout;
+        /**
+         * Cancels an interval scheduled with {@link setInterval}.
+         * Uses the native clearInterval() that was captured before stubbing.
+         *
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/clearInterval
+         */
+        clearInterval: typeof window.clearInterval;
         /**
          * The native PerformanceObserver API for monitoring real performance metrics.
          * Use this to observe actual performance entries (e.g., navigation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/sdk-bundles-api",
-  "version": "2.293.0",
+  "version": "2.295.0",
   "description": "Meticulous common types",
   "license": "ISC",
   "main": "dist/index.js",
@@ -9,7 +9,7 @@
     "dist"
   ],
   "dependencies": {
-    "@alwaysmeticulous/api": "2.293.0"
+    "@alwaysmeticulous/api": "2.295.0"
   },
   "author": {
     "name": "The Meticulous Team",