@uptimizr/replay 0.1.2 → 0.2.1

package/AGENTS.md

@@ -42,9 +42,23 @@ player.play(); // play / pause / seek(ms) / stop
 
 The replay endpoint requires `ENABLE_RAW_SESSION_RETENTION` on the collector.
 
+## Scene backdrop
+
+`loadSceneBackdrop(scene, source, options?)` from `@uptimizr/replay/babylon` loads an arbitrary
+asset (URL or dropped `File`, e.g. a `.glb`) into the scene as a backdrop, then the normal replay
+path re-drives the session over it. It returns `{ rootNodes, meshes, container, dispose() }`;
+`dispose()` removes everything it added so a hosted viewer can swap one dropped model for the next.
+The default loader **lazily** imports Babylon's glTF `SceneLoader`, keeping the lean replay path
+free of it. The global `replayInScene({ backdropUrl })` reuses the host page's Babylon loader
+(`window.BABYLON.LoadAssetContainerAsync` or an explicit `loadBackdrop`), so the IIFE build never
+bundles a second `SceneLoader`; it warns and replays without a backdrop when no loader is found.
+
 ## Rules for agents
 
 - Replay is **read-only** on the data side: a driver must never emit analytics events (ADR 0006).
+- The backdrop loader only **adds scene geometry**; it must not touch the event stream.
+- Keep the glTF `SceneLoader` out of the lean/global paths: the npm default loader imports it
+  dynamically, and the global path resolves the host's loader instead of bundling one.
 - `ReplayPlayer` is driven by a pure `update(elapsedMs)`; seeking backward resets the driver and
   replays from the start, so playback stays deterministic — preserve this contract.
 - To support another engine, implement the `ReplayDriver` `{ reset, apply }` interface and pass it

package/README.md

@@ -42,6 +42,49 @@ const player = new ReplayPlayer(events, driver, { speed: 1, onComplete: () => {}
 player.play(); // play / pause / seek(ms) / stop
 ```
 
+### Scene backdrop (load a `.glb` to re-drive over)
+
+Replay normally re-drives into your **existing** scene. When you only have the
+captured stream and no scene to host it (e.g. a hosted drag-and-drop viewer),
+load an arbitrary asset as a **backdrop** first, then replay over it. The Babylon
+helper accepts a URL **or** a dropped `File`:
+
+```ts
+import { loadSceneBackdrop } from "@uptimizr/replay/babylon";
+
+// from a URL…
+const backdrop = await loadSceneBackdrop(scene, "https://example.com/room.glb");
+// …or from a dropped File:
+// const backdrop = await loadSceneBackdrop(scene, file);
+
+console.log(`${backdrop.meshes.length} meshes added`);
+
+// later — swap one model for another:
+backdrop.dispose();
+```
+
+`loadSceneBackdrop(scene, source, options?)` returns a handle
+(`{ rootNodes, meshes, container, dispose() }`). Its `dispose()` removes
+everything it added and releases the GPU resources, so the hosted slice can
+replace one dropped model with the next. The default loader lazily imports
+Babylon's glTF `SceneLoader`, so the lean replay path never pulls it in unless a
+backdrop is actually requested; pass `options.load` to supply your own loader, or
+`options.pluginExtension` to force a parser. Loaded actor/subtree nodes re-drive
+exactly like any other scene node (`node_transform`, ADR 0033).
+
+With the **global** one-call entry point, pass `backdropUrl` (it reuses the host
+page's Babylon loader so the IIFE never bundles a second `SceneLoader`):
+
+```ts
+await replayInScene({
+  scene,
+  endpoint: "https://collect.example.com",
+  apiKey: "utk_…",
+  sessionId: "…",
+  backdropUrl: "https://example.com/room.glb",
+});
+```
+
 ### three.js
 
 The three driver lives at `@uptimizr/replay/three`. three has no

package/dist/drivers/babylon.d.ts

@@ -1,6 +1,9 @@
 import type { Camera, Scene } from "@babylonjs/core";
 import type { CustomPropValue } from "@uptimizr/schema";
 import type { ReplayDriver } from "../types.js";
+export { loadSceneBackdrop } from "./babylonBackdrop.js";
+export type { LoadBabylonBackdropOptions } from "./babylonBackdrop.js";
+export type { BackdropAssetContainer, SceneBackdrop } from "./backdrop.js";
 export interface BabylonReplayDriverOptions {
     /** Scene to re-drive. */
     scene: Scene;

package/dist/drivers/babylon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babylon.d.ts","sourceRoot":"","sources":["../../src/drivers/babylon.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"babylon.d.ts","sourceRoot":"","sources":["../../src/drivers/babylon.ts"],"names":[],"mappings":"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"}

package/dist/drivers/babylon.js

@@ -1,5 +1,6 @@
 import { Vector3 } from "@babylonjs/core/Maths/math.vector.js";
 import { Quaternion } from "@babylonjs/core/Maths/math.vector.js";
+export { loadSceneBackdrop } from "./babylonBackdrop.js";
 /** Resolve a node entry (direct ref or `() => node`) to a live node, or `null`. */
 function resolveReplayNode(entry) {
     if (!entry)

package/dist/drivers/babylon.js.map

@@ -1 +1 @@
-{"version":3,"file":"babylon.js","sourceRoot":"","sources":["../../src/drivers/babylon.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"babylon.js","sourceRoot":"","sources":["../../src/drivers/babylon.ts"],"names":[],"mappings":"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"}

package/dist/drivers/babylonBackdrop.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Babylon **scene-backdrop** loader for replay — the npm (`@uptimizr/replay/babylon`)
+ * entry point's `loadSceneBackdrop`.
+ *
+ * Kept in its own module (re-exported from `./babylon`) so the standalone (IIFE)
+ * build, which only needs `createBabylonReplayDriver`, tree-shakes this away and
+ * never bundles Babylon's `SceneLoader`. The default loader imports
+ * `@babylonjs/core` lazily, keeping it an optional peer dependency.
+ */
+import type { Scene } from "@babylonjs/core";
+import { type BackdropAssetContainer, type LoadSceneBackdropOptions, type SceneBackdrop } from "./backdrop.js";
+/** Options for {@link loadSceneBackdrop}. */
+export interface LoadBabylonBackdropOptions extends LoadSceneBackdropOptions {
+    /**
+     * Custom asset loader, e.g. to use `ImportMeshAsync`, a cache, or a CDN-pinned
+     * Babylon. Receives the same `source`/`scene` and the resolved `pluginExtension`,
+     * and must resolve a Babylon `AssetContainer` (not yet added to the scene).
+     * Defaults to Babylon's `LoadAssetContainerAsync`.
+     */
+    load?: (source: string | File, scene: Scene, pluginExtension: string | undefined) => Promise<BackdropAssetContainer>;
+}
+/**
+ * Load an arbitrary asset (e.g. a `.glb`) into `scene` as a replay **backdrop**,
+ * then re-drive a captured session over it. `source` is a URL or a `File` (so a
+ * drag-and-dropped model works directly).
+ *
+ * Returns a {@link SceneBackdrop} handle — call `dispose()` to remove the backdrop
+ * (e.g. to swap one dropped model for another). Loading only *adds* geometry;
+ * replay never emits analytics (ADR 0006).
+ *
+ * The host app must have a glTF (or relevant) loader registered, e.g.
+ * `import "@babylonjs/loaders/glTF";`. `@babylonjs/core` stays an optional peer
+ * dependency: the default loader is imported lazily, so this is the only path that
+ * pulls in Babylon's `SceneLoader`.
+ *
+ * @example
+ * ```ts
+ * import { createBabylonReplayDriver, loadSceneBackdrop } from "@uptimizr/replay/babylon";
+ * import "@babylonjs/loaders/glTF";
+ *
+ * const backdrop = await loadSceneBackdrop(scene, "https://cdn.example.com/room.glb");
+ * const driver = createBabylonReplayDriver({ scene, nodes });
+ * new ReplayPlayer(events, driver).play();
+ * // later: backdrop.dispose();
+ * ```
+ */
+export declare function loadSceneBackdrop(scene: Scene, source: string | File, options?: LoadBabylonBackdropOptions): Promise<SceneBackdrop>;
+//# sourceMappingURL=babylonBackdrop.d.ts.map

package/dist/drivers/babylonBackdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"babylonBackdrop.d.ts","sourceRoot":"","sources":["../../src/drivers/babylonBackdrop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,6CAA6C;AAC7C,MAAM,WAAW,0BAA2B,SAAQ,wBAAwB;IAC1E;;;;;OAKG;IACH,IAAI,CAAC,EAAE,CACL,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,MAAM,GAAG,SAAS,KAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,aAAa,CAAC,CAGxB"}

package/dist/drivers/babylonBackdrop.js

@@ -0,0 +1,37 @@
+import { loadSceneBackdropWith, } from "./backdrop.js";
+/**
+ * Load an arbitrary asset (e.g. a `.glb`) into `scene` as a replay **backdrop**,
+ * then re-drive a captured session over it. `source` is a URL or a `File` (so a
+ * drag-and-dropped model works directly).
+ *
+ * Returns a {@link SceneBackdrop} handle — call `dispose()` to remove the backdrop
+ * (e.g. to swap one dropped model for another). Loading only *adds* geometry;
+ * replay never emits analytics (ADR 0006).
+ *
+ * The host app must have a glTF (or relevant) loader registered, e.g.
+ * `import "@babylonjs/loaders/glTF";`. `@babylonjs/core` stays an optional peer
+ * dependency: the default loader is imported lazily, so this is the only path that
+ * pulls in Babylon's `SceneLoader`.
+ *
+ * @example
+ * ```ts
+ * import { createBabylonReplayDriver, loadSceneBackdrop } from "@uptimizr/replay/babylon";
+ * import "@babylonjs/loaders/glTF";
+ *
+ * const backdrop = await loadSceneBackdrop(scene, "https://cdn.example.com/room.glb");
+ * const driver = createBabylonReplayDriver({ scene, nodes });
+ * new ReplayPlayer(events, driver).play();
+ * // later: backdrop.dispose();
+ * ```
+ */
+export function loadSceneBackdrop(scene, source, options) {
+    const load = options?.load ?? defaultBabylonBackdropLoader;
+    return loadSceneBackdropWith((pluginExtension) => load(source, scene, pluginExtension), options);
+}
+/** Lazily import Babylon's unified asset loader so the driver path stays lean. */
+async function defaultBabylonBackdropLoader(source, scene, pluginExtension) {
+    const { LoadAssetContainerAsync } = await import("@babylonjs/core/Loading/sceneLoader.js");
+    const container = await LoadAssetContainerAsync(source, scene, pluginExtension ? { pluginExtension } : undefined);
+    return container;
+}
+//# sourceMappingURL=babylonBackdrop.js.map

package/dist/drivers/babylonBackdrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"babylonBackdrop.js","sourceRoot":"","sources":["../../src/drivers/babylonBackdrop.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,qBAAqB,GAItB,MAAM,eAAe,CAAC;AAiBvB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAY,EACZ,MAAqB,EACrB,OAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,4BAA4B,CAAC;IAC3D,OAAO,qBAAqB,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;AACnG,CAAC;AAED,kFAAkF;AAClF,KAAK,UAAU,4BAA4B,CACzC,MAAqB,EACrB,KAAY,EACZ,eAAmC;IAEnC,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAC7C,MAAM,EACN,KAAK,EACL,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAClD,CAAC;IACF,OAAO,SAA8C,CAAC;AACxD,CAAC"}

package/dist/drivers/backdrop.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Engine-agnostic **scene-backdrop** core for replay.
+ *
+ * A replay re-drives a captured session into the host's scene; this loads an
+ * arbitrary asset (e.g. a `.glb`) as that scene's backdrop so the recorded camera
+ * / pointer / picks and actor (`node_transform`, ADR 0033) transforms can be
+ * re-driven over a real model. It only *adds* geometry — replay stays read-only on
+ * the data side (ADR 0006).
+ *
+ * This module deliberately has **no** `@babylonjs/core` import so the standalone
+ * (IIFE) build can reuse the host page's loader instead of bundling a second copy
+ * of Babylon's glTF `SceneLoader`. The Babylon entry (`./babylon`) supplies a
+ * loader that constructs an asset container; the global build resolves one from
+ * the host. Both feed {@link loadSceneBackdropWith}.
+ */
+/**
+ * Structural view of the Babylon `AssetContainer` the backdrop core consumes —
+ * just the members it reads/calls, so no Babylon type import is needed.
+ */
+export interface BackdropAssetContainer {
+    /** All meshes the asset contributed. */
+    meshes?: object[];
+    /** Top-level nodes (meshes/transform nodes) with no parent in the asset. */
+    rootNodes?: object[];
+    /** Transform nodes the asset contributed. */
+    transformNodes?: object[];
+    /** Add everything the container holds to the scene it was loaded against. */
+    addAllToScene(): void;
+    /** Remove everything the container added back out of the scene. */
+    removeAllFromScene?(): void;
+    /** Release the GPU resources the container owns. */
+    dispose?(): void;
+}
+/**
+ * A loaded scene backdrop. Hold onto it to remove the backdrop later (e.g. to swap
+ * one dropped model for another) via {@link SceneBackdrop.dispose}.
+ */
+export interface SceneBackdrop {
+    /** Top-level nodes the backdrop added to the scene. */
+    rootNodes: object[];
+    /** All meshes the backdrop added to the scene. */
+    meshes: object[];
+    /** The underlying asset container, for advanced host use. */
+    container: BackdropAssetContainer;
+    /** Remove every node this backdrop added and release its GPU resources. */
+    dispose(): void;
+}
+/** Options shared by the backdrop loaders. */
+export interface LoadSceneBackdropOptions {
+    /**
+     * Force a loader plugin when the URL/`File` has no recognizable extension
+     * (e.g. a `blob:`/`data:` URL from a drag-and-drop). Pass `".glb"`/`".gltf"`.
+     */
+    pluginExtension?: string;
+}
+/**
+ * A loader that resolves an asset (already bound to a target scene) to a
+ * {@link BackdropAssetContainer}, without adding it to the scene yet.
+ */
+export type BackdropLoader = (pluginExtension: string | undefined) => Promise<BackdropAssetContainer>;
+/**
+ * Core backdrop loader: run `load`, add the resulting container to the scene, and
+ * return a {@link SceneBackdrop} handle whose `dispose()` removes everything it
+ * added and frees the GPU resources. Engine-specific entries wrap this with a
+ * concrete loader.
+ */
+export declare function loadSceneBackdropWith(load: BackdropLoader, options?: LoadSceneBackdropOptions): Promise<SceneBackdrop>;
+//# sourceMappingURL=backdrop.d.ts.map

package/dist/drivers/backdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../src/drivers/backdrop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,aAAa,IAAI,IAAI,CAAC;IACtB,mEAAmE;IACnE,kBAAkB,CAAC,IAAI,IAAI,CAAC;IAC5B,oDAAoD;IACpD,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,sBAAsB,CAAC;IAClC,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,eAAe,EAAE,MAAM,GAAG,SAAS,KAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/dist/drivers/backdrop.js

@@ -0,0 +1,39 @@
+/**
+ * Engine-agnostic **scene-backdrop** core for replay.
+ *
+ * A replay re-drives a captured session into the host's scene; this loads an
+ * arbitrary asset (e.g. a `.glb`) as that scene's backdrop so the recorded camera
+ * / pointer / picks and actor (`node_transform`, ADR 0033) transforms can be
+ * re-driven over a real model. It only *adds* geometry — replay stays read-only on
+ * the data side (ADR 0006).
+ *
+ * This module deliberately has **no** `@babylonjs/core` import so the standalone
+ * (IIFE) build can reuse the host page's loader instead of bundling a second copy
+ * of Babylon's glTF `SceneLoader`. The Babylon entry (`./babylon`) supplies a
+ * loader that constructs an asset container; the global build resolves one from
+ * the host. Both feed {@link loadSceneBackdropWith}.
+ */
+/**
+ * Core backdrop loader: run `load`, add the resulting container to the scene, and
+ * return a {@link SceneBackdrop} handle whose `dispose()` removes everything it
+ * added and frees the GPU resources. Engine-specific entries wrap this with a
+ * concrete loader.
+ */
+export async function loadSceneBackdropWith(load, options) {
+    const container = await load(options?.pluginExtension);
+    container.addAllToScene();
+    let disposed = false;
+    return {
+        rootNodes: container.rootNodes ?? [],
+        meshes: container.meshes ?? [],
+        container,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            container.removeAllFromScene?.();
+            container.dispose?.();
+        },
+    };
+}
+//# sourceMappingURL=backdrop.js.map

package/dist/drivers/backdrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backdrop.js","sourceRoot":"","sources":["../../src/drivers/backdrop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqDH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAoB,EACpB,OAAkC;IAElC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACvD,SAAS,CAAC,aAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,EAAE;QACpC,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,EAAE;QAC9B,SAAS;QACT,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS,CAAC,kBAAkB,EAAE,EAAE,CAAC;YACjC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/global.d.ts

@@ -11,6 +11,7 @@
  */
 import type { Camera, Scene } from "@babylonjs/core";
 import { createBabylonReplayDriver, type BabylonReplayDriverOptions } from "./drivers/babylon.js";
+import { type BackdropAssetContainer } from "./drivers/backdrop.js";
 import { fetchSessionEvents, fetchSessionEventsStream } from "./fetchSession.js";
 import { ReplayPlayer } from "./player.js";
 import type { ReplayHandle } from "./types.js";
@@ -26,6 +27,27 @@ export interface ReplayInSceneOptions {
     sessionId: string;
     /** Camera to move. Defaults to `scene.activeCamera`. */
     camera?: Camera;
+    /**
+     * Optional asset to load into the scene as a **backdrop** (URL or `File`) before
+     * replay starts — e.g. a `.glb` to re-drive the recorded session over. The host
+     * page's Babylon owns the scene, so this build does **not** bundle a glTF
+     * `SceneLoader`; it reuses the page's loader. Provide one via {@link loadBackdrop},
+     * or expose Babylon globally (`window.BABYLON` with `LoadAssetContainerAsync`).
+     * If no loader can be found, a warning is logged and replay continues without a
+     * backdrop.
+     */
+    backdropUrl?: string | File;
+    /**
+     * Force a loader plugin when {@link backdropUrl} has no recognizable extension
+     * (e.g. a `blob:`/`data:` URL). Pass `".glb"`/`".gltf"`.
+     */
+    backdropPluginExtension?: string;
+    /**
+     * Custom backdrop loader. Receives the {@link backdropUrl}, the `scene`, and the
+     * resolved plugin extension, and must resolve a Babylon `AssetContainer` (not yet
+     * added to the scene). Overrides the `window.BABYLON` auto-detection.
+     */
+    loadBackdrop?: (source: string | File, scene: Scene, pluginExtension: string | undefined) => Promise<BackdropAssetContainer>;
     /** Playback speed multiplier. Default 1. */
     speed?: number;
     /** Per pointer event, so the host can render a cursor/marker. */

package/dist/global.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,KAAK,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,SAAS,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACpD,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,CAAC;IACpE,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,0BAA0B,CAAC,UAAU,CAAC,CAAC;IAClD,oFAAoF;IACpF,WAAW,CAAC,EAAE,0BAA0B,CAAC,aAAa,CAAC,CAAC;IACxD,2DAA2D;IAC3D,OAAO,CAAC,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAChD,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,oFAAoF;IACpF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyFxF;AAED,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,YAAY,EAAE,CAAC;AACjG,YAAY,EAAE,0BAA0B,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,KAAK,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,MAAM,GAAG,SAAS,KAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,SAAS,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACpD,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,CAAC;IACpE,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,0BAA0B,CAAC,UAAU,CAAC,CAAC;IAClD,oFAAoF;IACpF,WAAW,CAAC,EAAE,0BAA0B,CAAC,aAAa,CAAC,CAAC;IACxD,2DAA2D;IAC3D,OAAO,CAAC,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAChD,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,oFAAoF;IACpF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiGxF;AAkFD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,YAAY,EAAE,CAAC;AACjG,YAAY,EAAE,0BAA0B,EAAE,YAAY,EAAE,CAAC"}

package/dist/global.js

@@ -1,4 +1,5 @@
 import { createBabylonReplayDriver } from "./drivers/babylon.js";
+import { loadSceneBackdropWith, } from "./drivers/backdrop.js";
 import { fetchSessionEvents, fetchSessionEventsStream } from "./fetchSession.js";
 import { ReplayPlayer } from "./player.js";
 const LOG_PREFIX = "[UptimizrReplay]";
@@ -69,6 +70,13 @@ export async function replayInScene(options) {
         console.warn(`${LOG_PREFIX} scene has no active camera and none was provided — camera pose ` +
             `won't be applied. Pass a \`camera\`, or set \`scene.activeCamera\` before replaying.`);
     }
+    // Load an optional backdrop (e.g. a .glb) before playback so the recorded
+    // camera/pointer/picks and actor transforms re-drive over a real model. This
+    // reuses the host page's Babylon loader — the global build never bundles a glTF
+    // SceneLoader of its own.
+    if (options.backdropUrl !== undefined) {
+        await loadBackdropFromHost(options, log);
+    }
     const driver = createBabylonReplayDriver({
         scene: options.scene,
         camera: options.camera,
@@ -91,5 +99,51 @@ export async function replayInScene(options) {
     player.play();
     return player;
 }
+/**
+ * Resolve a Babylon asset loader from the host page and load {@link
+ * ReplayInSceneOptions.backdropUrl} into the scene. Prefers an explicit
+ * `loadBackdrop`, then a global `BABYLON.LoadAssetContainerAsync` (Babylon 7+) or
+ * `BABYLON.SceneLoader.LoadAssetContainerAsync` (legacy). Logs a warning and skips
+ * (without throwing) when no loader is available — replay still runs.
+ */
+async function loadBackdropFromHost(options, log) {
+    const source = options.backdropUrl;
+    if (source === undefined)
+        return undefined;
+    const loader = resolveHostBackdropLoader(options);
+    if (!loader) {
+        console.warn(`${LOG_PREFIX} a backdrop was requested but no Babylon loader was found. ` +
+            `Pass \`loadBackdrop\`, or expose Babylon as \`window.BABYLON\` with ` +
+            `\`LoadAssetContainerAsync\` (and a glTF loader registered). Replaying without a backdrop.`);
+        return undefined;
+    }
+    const label = typeof source === "string" ? source : (source.name ?? "dropped file");
+    log(`loading backdrop "${label}"`);
+    try {
+        const backdrop = await loadSceneBackdropWith((pluginExtension) => loader(source, options.scene, pluginExtension), { pluginExtension: options.backdropPluginExtension });
+        log(`backdrop loaded (${backdrop.meshes.length} meshes)`);
+        return backdrop;
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} failed to load backdrop "${label}":`, err);
+        return undefined;
+    }
+}
+/** Build a `(source, scene, pluginExtension) => Promise<AssetContainer>` loader. */
+function resolveHostBackdropLoader(options) {
+    if (options.loadBackdrop)
+        return options.loadBackdrop;
+    const babylon = globalThis.BABYLON;
+    if (babylon?.LoadAssetContainerAsync) {
+        const load = babylon.LoadAssetContainerAsync.bind(babylon);
+        return (source, scene, pluginExtension) => load(source, scene, pluginExtension ? { pluginExtension } : undefined);
+    }
+    const legacy = babylon?.SceneLoader?.LoadAssetContainerAsync;
+    if (legacy) {
+        const load = legacy.bind(babylon.SceneLoader);
+        return (source, scene, pluginExtension) => load(source, "", scene, null, pluginExtension);
+    }
+    return null;
+}
 export { createBabylonReplayDriver, fetchSessionEvents, fetchSessionEventsStream, ReplayPlayer };
 //# sourceMappingURL=global.js.map

package/dist/global.js.map

@@ -1 +1 @@
-{"version":3,"file":"global.js","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"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"}