@alwaysmeticulous/sdk-bundles-api 2.316.0 → 2.321.0

package/dist/backend-recorder/bundle-to-sdk/init-backend-recorder.d.ts

@@ -21,6 +21,13 @@ export interface MeticulousPrismaExtension {
  * to call across the bundle boundary.
  */
 export type MeticulousIORedisWrapper = <T>(client: T) => T;
+/**
+ * Wraps a postgres.js `sql` instance so its queries are recorded (record mode) or served from
+ * recordings (replay mode), returning the same instance. Apply it where you construct the
+ * client: `const sql = handle.withMeticulousPostgres(postgres(connectionString))`. Safe to call
+ * across the bundle boundary.
+ */
+export type MeticulousPostgresJsWrapper = <T>(sql: T) => T;
 export interface BackendRecorderHandle {
     stopRecording: () => Promise<void>;
     /**
@@ -68,5 +75,29 @@ export interface BackendRecorderHandle {
      * guard with `handle?.withMeticulousIORedis`.
      */
     withMeticulousIORedis?: MeticulousIORedisWrapper;
+    /**
+     * The Meticulous postgres.js wrapper. Apply it to your `sql` instance
+     * (`const sql = handle.withMeticulousPostgres(postgres(connectionString))`) so its queries
+     * are recorded (record mode) or served from recordings (replay mode).
+     *
+     * Required to capture postgres.js in apps whose bundler inlines it — a Vite SSR graph
+     * (React Router, TanStack Start), Next.js / Turbopack and similar — because `postgres` then
+     * never passes through Node's module loader and the recorder's require-hook instrumentation
+     * can never fire. The only seam is the app's own code, so wrap the instance where you
+     * construct it.
+     *
+     * Every postgres.js query funnels through one internal method, so the wrapper instruments
+     * that rather than the instance: one call therefore also covers read-replica clients and any
+     * other client in the process. The instrumentation dispatches at query time, so it is safe to
+     * apply at module-load time; when the recorder is disabled or uninitialised it passes through
+     * (no-op).
+     *
+     * Apply it outermost if other instrumentation also wraps the client (e.g. Sentry's
+     * `instrumentPostgresJsSql`).
+     *
+     * Optional so older recorder bundles (which predate this field) still satisfy the type;
+     * guard with `handle?.withMeticulousPostgres`.
+     */
+    withMeticulousPostgres?: MeticulousPostgresJsWrapper;
 }
 //# sourceMappingURL=init-backend-recorder.d.ts.map

package/dist/backend-recorder/bundle-to-sdk/init-backend-recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-backend-recorder.d.ts","sourceRoot":"","sources":["../../../src/backend-recorder/bundle-to-sdk/init-backend-recorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,cAAc,EAAE,CAAC,MAAM,EAAE;YACvB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE,OAAO,CAAC;YACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC5C,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACxB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IAEtD;;;;;;;;;;;;;;;;OAgBG;IACH,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;CAClD"}
+{"version":3,"file":"init-backend-recorder.d.ts","sourceRoot":"","sources":["../../../src/backend-recorder/bundle-to-sdk/init-backend-recorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,cAAc,EAAE,CAAC,MAAM,EAAE;YACvB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE,OAAO,CAAC;YACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC5C,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACxB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IAEtD;;;;;;;;;;;;;;;;OAgBG;IACH,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;IAEjD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;CACtD"}

package/dist/index.d.ts

@@ -14,5 +14,5 @@ export { MeticulousPublicApi, MeticulousPressureObserver, MeticulousPressureObse
 export { MeticulousPrivateApi } from "./window-api/private-window-api";
 export { RunCrawlOptions, RunCrawlResult, } from "./crawler/sdk-to-bundle/run-crawl";
 export { BackendRecorderConfig } from "./backend-recorder/sdk-to-bundle/init-backend-recorder";
-export { BackendRecorderHandle, MeticulousPrismaExtension, MeticulousIORedisWrapper, } from "./backend-recorder/bundle-to-sdk/init-backend-recorder";
+export { BackendRecorderHandle, MeticulousPrismaExtension, MeticulousIORedisWrapper, MeticulousPostgresJsWrapper, } from "./backend-recorder/bundle-to-sdk/init-backend-recorder";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,6BAA6B,EAC7B,eAAe,EACf,+BAA+B,EAC/B,sBAAsB,EACtB,uCAAuC,EACvC,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,EAClC,oBAAoB,EACpB,kCAAkC,EAClC,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,mCAAmC,EAAE,MAAM,sEAAsE,CAAC;AAC3H,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,GACvB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AACnG,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,sEAAsE,CAAC;AAC9E,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,qCAAqC,EACrC,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,wDAAwD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,6BAA6B,EAC7B,eAAe,EACf,+BAA+B,EAC/B,sBAAsB,EACtB,uCAAuC,EACvC,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,EAClC,oBAAoB,EACpB,kCAAkC,EAClC,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,mCAAmC,EAAE,MAAM,sEAAsE,CAAC;AAC3H,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,GACvB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AACnG,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,sEAAsE,CAAC;AAC9E,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,qCAAqC,EACrC,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wDAAwD,CAAC"}

package/dist/replay-orchestrator/bundle-to-sdk/execute-replay.d.ts

@@ -60,6 +60,13 @@ export interface ReplayAndStoreResultsResult {
      * Only present on replays from March 2025 and later.
      */
     comparedAgainstReplayWithDifferentLogicVersion?: boolean;
+    /**
+     * How long this replay spent blocked waiting for its base session to finish,
+     * after its own replay work was done. The orchestrator uses it to work out
+     * whether base waits extended the chunk's wall clock, which is what makes
+     * them cost compute.
+     */
+    baseSessionWaitMs?: number;
 }
 export interface BeforeUserEventResult {
     /**

package/dist/replay-orchestrator/bundle-to-sdk/execute-replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-replay.d.ts","sourceRoot":"","sources":["../../../src/replay-orchestrator/bundle-to-sdk/execute-replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,eAAe,EACf,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAElD;;;;;OAKG;IACH,mBAAmB,EAAE,sBAAsB,EAAE,CAAC;IAE9C;;OAEG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhC;;OAEG;IACH,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAErE;;;OAGG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;OAMG;IACH,8CAA8C,CAAC,EAAE,OAAO,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"execute-replay.d.ts","sourceRoot":"","sources":["../../../src/replay-orchestrator/bundle-to-sdk/execute-replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,eAAe,EACf,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAElD;;;;;OAKG;IACH,mBAAmB,EAAE,sBAAsB,EAAE,CAAC;IAE9C;;OAEG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhC;;OAEG;IACH,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAErE;;;OAGG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;OAMG;IACH,8CAA8C,CAAC,EAAE,OAAO,CAAC;IAEzD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B"}

package/package.json

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