@preference-sl/pref-viewer 2.13.0-beta.8 → 2.13.0-beta.9

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@preference-sl/pref-viewer",
-    "version": "2.13.0-beta.8",
+    "version": "2.13.0-beta.9",
     "description": "Web Component to preview GLTF models with Babylon.js",
     "author": "Alex Moreno Palacio <amoreno@preference.es>",
     "scripts": {

package/src/babylonjs-controller.js

@@ -39,6 +39,7 @@ import { translate } from "./localization/i18n.js";
  *  5. Use `setContainerVisibility`, `setMaterialOptions`, `setCameraOptions`, or `setIBLOptions` for targeted updates; these
  *     helpers stop/restart the render loop while they rebuild camera-dependent resources.
  *  6. Invoke `disable()` when the element disconnects to tear down scenes, XR sessions, observers, and handlers.
+ *     The controller also disposes the shared GLTF resolver, which closes its internal IndexedDB handle.
  *
  * Public API Highlights
  *  - constructor(canvas, containers, options)
@@ -1230,6 +1231,18 @@ export default class BabylonJSController {
         }
     }
 
+    /**
+     * Disposes the shared GLTFResolver instance and closes its underlying storage handle.
+     * @private
+     * @returns {void}
+     */
+    #disposeGLTFResolver() {
+        if (this.#gltfResolver) {
+            this.#gltfResolver.dispose();
+            this.#gltfResolver = null;
+        }
+    }
+
     /**
      * Disposes the Babylon.js WebXR experience if it exists.
      * @private
@@ -2258,13 +2271,14 @@ export default class BabylonJSController {
 
     /**
      * Disposes the Babylon.js engine and disconnects the canvas resize observer.
-     * Cleans up all scene, camera, light, and XR resources.
+     * Cleans up all scene, camera, light, XR, and GLTF resolver resources.
      * @public
      * @returns {void}
      */
     disable() {
         this.#disableInteraction();
         this.#disposeAnimationController();
+        this.#disposeGLTFResolver();
         this.#disposeXRExperience();
         this.#unloadCameraDependentEffects();
         this.#stopEngineRenderLoop();

package/src/file-storage.js

@@ -36,6 +36,7 @@ import { openDB } from "idb";
  *  - getBlob(uri): Retrieves file blob from cache or server.
  *  - get(uri): Gets file from cache with automatic server sync and cache versioning.
  *  - put(uri): Stores file from server in IndexedDB cache.
+ *  - dispose(): Closes the active IndexedDB handle held by the instance.
  *
  * Features:
  *  - Automatic Cache Versioning: Compares server and cached timestamps to update cache.
@@ -105,6 +106,7 @@ import { openDB } from "idb";
  *  - Supports both HTTPS and HTTP (HTTP not recommended for production)
  *  - Object URLs should be revoked after use to free memory
  *  - IndexedDB cache is auto-maintained (TTL, max entries, quota cleanup)
+ *  - Call dispose() when the owner is torn down to release the DB connection proactively.
  *
  * Error Handling:
  *  - Network failures: Returns undefined (get) or false (other methods)
@@ -782,4 +784,19 @@ export default class FileStorage {
         const fileToStore = await this.#getServerFile(uri);
         return fileToStore ? !!(await this.#putFile(fileToStore, uri)) : false;
     }
+
+    /**
+     * Closes the IndexedDB handle held by this storage instance.
+     * Safe to call multiple times; next storage operation will lazily reopen the DB.
+     * @public
+     * @returns {void}
+     */
+    dispose() {
+        if (this.#db) {
+            try {
+                this.#db.close();
+            } catch {}
+        }
+        this.#db = undefined;
+    }
 }

package/src/gltf-resolver.js

@@ -19,6 +19,7 @@ import { initDb, loadModel } from "./gltf-storage.js";
  * Public Methods:
  *  - getSource(storage, currentSize, currentTimeStamp): Resolves and prepares a glTF/GLB source for loading.
  *  - revokeObjectURLs(objectURLs): Releases temporary blob URLs generated during source resolution.
+ *  - dispose(): Releases resolver resources and closes the internal FileStorage DB handle.
  *
  * Private Methods:
  *  - #initializeStorage(db, table): Ensures IndexedDB store is initialized.
@@ -231,6 +232,16 @@ export default class GLTFResolver {
         objectURLs.length = 0;
     }
 
+    /**
+     * Disposes resolver-owned resources.
+     * @public
+     * @returns {void}
+     */
+    dispose() {
+        this.#fileStorage?.dispose?.();
+        this.#fileStorage = null;
+    }
+
     /**
      * Resolves and prepares a glTF/GLB source from various storage backends.
      * Supports IndexedDB, direct URLs, and base64-encoded data.