@vived/host 4.9.1 → 4.11.0

package/dist/cjs/Assets/UCs/GetAssetBlobURLUC.js

@@ -1,4 +1,24 @@
 "use strict";
+/**
+ * GetAssetBlobURLUC.ts
+ *
+ * This use case provides optimized asset file retrieval with caching support,
+ * returning blob URLs for immediate use in web applications.
+ *
+ * Key Concepts:
+ * - Provides blob URLs for asset files with multi-level caching optimization
+ * - Checks memory cache (existing entities) first for immediate access
+ * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval
+ * - Finally fetches from remote API when cache misses occur
+ * - Manages fetch state indicators for UI feedback
+ * - Automatically stores fetched files in cache for future access
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to retrieve blob URL for display or download
+ * - Handles async operations with comprehensive error handling
+ * - Optimizes performance through multi-level caching strategy
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetAssetBlobURLUC = void 0;
 exports.makeGetAssetBlobURLUC = makeGetAssetBlobURLUC;
@@ -7,34 +27,88 @@ const VivedAPI_1 = require("../../VivedAPI");
 const Cache_1 = require("../../Cache");
 const AssetRepo_1 = require("../Entities/AssetRepo");
 const GetAssetUC_1 = require("./GetAssetUC");
+/**
+ * GetAssetBlobURLUC handles optimized retrieval of asset files as blob URLs.
+ *
+ * This singleton use case implements a multi-level caching strategy to minimize
+ * network requests and provide fast access to asset files for web applications.
+ */
 class GetAssetBlobURLUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton GetAssetBlobURLUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetBlobURLUC instance or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(GetAssetBlobURLUC.type, appObjects);
     }
 }
 exports.GetAssetBlobURLUC = GetAssetBlobURLUC;
+/** Static type identifier for component registration */
 GetAssetBlobURLUC.type = "GetAssetBlobURLUC";
+/**
+ * Factory function to create a new GetAssetBlobURLUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new GetAssetBlobURLUC implementation instance
+ */
 function makeGetAssetBlobURLUC(appObject) {
     return new GetAssetBlobURLUCImp(appObject);
 }
+/**
+ * Private implementation of GetAssetBlobURLUC with multi-level caching strategy.
+ *
+ * Key Implementation Details:
+ * - Implements three-tier caching: memory (entities), persistent cache, and remote API
+ * - Manages fetch state indicators for user feedback during operations
+ * - Automatically caches fetched files for future access optimization
+ * - Handles cache failures gracefully with fallback to direct API access
+ * - Converts between Blob and File objects for compatibility
+ * - Provides detailed error handling and logging for debugging
+ */
 class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
+    /** Gets the asset repository for entity management and lookup */
     get assetRepo() {
         return this.getCachedSingleton(AssetRepo_1.AssetRepo.type);
     }
+    /** Gets the API use case for fetching asset files from remote sources */
     get fetchAssetFile() {
         return this.getCachedSingleton(VivedAPI_1.FetchAssetFileFromAPIUC.type)?.doFetch;
     }
+    /** Gets the use case for retrieving asset metadata */
     get getAsset() {
         return this.getCachedSingleton(GetAssetUC_1.GetAssetUC.type)?.getAsset;
     }
+    /** Gets the use case for retrieving assets from persistent cache */
     get getAssetFromCache() {
         return this.getCachedSingleton(Cache_1.GetAssetFromCacheUC.type)?.getAsset;
     }
+    /** Gets the use case for storing assets in persistent cache */
     get storeAssetInCache() {
         return this.getCachedSingleton(Cache_1.StoreAssetInCacheUC.type)?.storeAsset;
     }
+    /**
+     * Initializes the GetAssetBlobURLUC and registers it as a singleton.
+     *
+     * @param appObject - The AppObject that will host this singleton use case
+     */
     constructor(appObject) {
         super(appObject, GetAssetBlobURLUC.type);
+        /**
+         * Retrieves an asset blob URL using optimized multi-level caching.
+         *
+         * This method implements a three-tier caching strategy:
+         * 1. Memory cache: Check if asset entity already has a blob URL
+         * 2. Persistent cache: Check IndexedDB/localStorage for cached file
+         * 3. Remote API: Fetch from backend as last resort
+         *
+         * Each level provides progressively better performance, with automatic
+         * population of higher-level caches for future access optimization.
+         *
+         * @param assetID - The unique identifier of the asset
+         * @returns Promise resolving to a blob URL for the asset file
+         */
         this.getAssetBlobURL = (assetID) => {
             const assetRepo = this.assetRepo;
             const getAsset = this.getAsset;
@@ -44,22 +118,21 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             if (!assetRepo || !getAsset || !fetchAssetFile) {
                 return Promise.reject();
             }
-            // Check if asset already exists in memory with a blob URL
+            // Level 1: Check memory cache (existing entities with blob URLs)
             const existing = assetRepo.get(assetID);
             if (existing && existing.blobURL) {
                 return Promise.resolve(existing.blobURL);
             }
             return new Promise((resolve, reject) => {
                 let fetchedAsset;
-                // First check if the asset exists in cache
+                // Level 2: Check persistent cache
                 if (getAssetFromCache) {
                     getAssetFromCache(assetID)
                         .then((cachedBlob) => {
                         if (cachedBlob) {
-                            // Asset found in cache, get metadata
+                            // Asset found in cache, get metadata and create file
                             return getAsset(assetID).then((asset) => {
                                 fetchedAsset = asset;
-                                // Convert Blob to File
                                 const filename = asset.filename || "cached-asset";
                                 return new File([cachedBlob], filename, {
                                     type: cachedBlob.type
@@ -67,7 +140,7 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                             });
                         }
                         else {
-                            // Not in cache, get asset and fetch from API
+                            // Level 3: Fetch from remote API
                             return getAsset(assetID).then((asset) => {
                                 asset.isFetchingFile = true;
                                 asset.fetchError = undefined;
@@ -78,9 +151,10 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                     })
                         .then((file) => {
                         if (fetchedAsset) {
+                            // Create blob URL and update entity
                             fetchedAsset.setFile(file);
                             fetchedAsset.isFetchingFile = false;
-                            // Store the fetched file in cache if not from cache already
+                            // Store in cache for future access (if not from cache already)
                             if (storeAssetInCache) {
                                 storeAssetInCache(assetID, new Blob([file], { type: file.type }), file.type).catch((e) => {
                                     this.warn(`Failed to cache asset: ${e.message}`);
@@ -94,18 +168,28 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                         reject(new Error("Blob URL is empty"));
                     })
                         .catch((e) => {
-                        // Cache error or fetch error, try normal flow
+                        // Cache error, fallback to normal flow
                         this.warn(`Cache error or fetch error: ${e.message}`);
                         this.fetchAssetNormally(assetID, resolve, reject);
                     });
                 }
                 else {
-                    // No cache available, use normal flow
+                    // No cache available, use direct API access
                     this.fetchAssetNormally(assetID, resolve, reject);
                 }
             });
         };
-        // Helper method for the normal asset fetching flow without cache
+        /**
+         * Helper method for direct asset fetching without cache support.
+         *
+         * This method handles the direct API fetch workflow when caching
+         * is not available or has failed. It still attempts to store the
+         * result in cache for future optimization.
+         *
+         * @param assetID - The unique identifier of the asset
+         * @param resolve - Success callback with blob URL
+         * @param reject - Error callback with error details
+         */
         this.fetchAssetNormally = (assetID, resolve, reject) => {
             const getAsset = this.getAsset;
             const fetchAssetFile = this.fetchAssetFile;
@@ -117,6 +201,7 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             let fetchedAsset;
             getAsset(assetID)
                 .then((asset) => {
+                // Set loading state for UI feedback
                 asset.isFetchingFile = true;
                 asset.fetchError = undefined;
                 fetchedAsset = asset;
@@ -124,9 +209,10 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             })
                 .then((file) => {
                 if (fetchedAsset) {
+                    // Create blob URL and update entity
                     fetchedAsset.setFile(file);
                     fetchedAsset.isFetchingFile = false;
-                    // Store the fetched file in cache if caching is available
+                    // Store in cache for future optimization (if available)
                     if (storeAssetInCache) {
                         storeAssetInCache(assetID, new Blob([file], { type: file.type }), file.type).catch((e) => {
                             this.warn(`Failed to cache asset: ${e.message}`);
@@ -140,6 +226,7 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
                 reject(new Error("Blob URL is empty"));
             })
                 .catch((e) => {
+                // Handle fetch errors with proper state cleanup
                 if (fetchedAsset) {
                     fetchedAsset.fetchError = e;
                     fetchedAsset.isFetchingFile = false;

package/dist/cjs/Assets/UCs/GetAssetBlobURLUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"GetAssetBlobURLUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetFileFromAPIUC } from \"../../VivedAPI\";\r\nimport { GetAssetFromCacheUC, StoreAssetInCacheUC } from \"../../Cache\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\nimport { GetAssetUC } from \"./GetAssetUC\";\r\n\r\nexport abstract class GetAssetBlobURLUC extends AppObjectUC {\r\n  static type = \"GetAssetBlobURLUC\";\r\n\r\n  abstract getAssetBlobURL(assetID: string): Promise<string>;\r\n\r\n  static get(appObjects: AppObjectRepo): GetAssetBlobURLUC | undefined {\r\n    return getSingletonComponent<GetAssetBlobURLUC>(\r\n      GetAssetBlobURLUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeGetAssetBlobURLUC(appObject: AppObject): GetAssetBlobURLUC {\r\n  return new GetAssetBlobURLUCImp(appObject);\r\n}\r\n\r\nclass GetAssetBlobURLUCImp extends GetAssetBlobURLUC {\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<FetchAssetFileFromAPIUC>(\r\n      FetchAssetFileFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  private get getAsset() {\r\n    return this.getCachedSingleton<GetAssetUC>(GetAssetUC.type)?.getAsset;\r\n  }\r\n\r\n  private get getAssetFromCache() {\r\n    return this.getCachedSingleton<GetAssetFromCacheUC>(\r\n      GetAssetFromCacheUC.type\r\n    )?.getAsset;\r\n  }\r\n\r\n  private get storeAssetInCache() {\r\n    return this.getCachedSingleton<StoreAssetInCacheUC>(\r\n      StoreAssetInCacheUC.type\r\n    )?.storeAsset;\r\n  }\r\n\r\n  getAssetBlobURL = (assetID: string): Promise<string> => {\r\n    const assetRepo = this.assetRepo;\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const getAssetFromCache = this.getAssetFromCache;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!assetRepo || !getAsset || !fetchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Check if asset already exists in memory with a blob URL\r\n    const existing = assetRepo.get(assetID);\r\n    if (existing && existing.blobURL) {\r\n      return Promise.resolve(existing.blobURL);\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      let fetchedAsset: AssetEntity | undefined;\r\n\r\n      // First check if the asset exists in cache\r\n      if (getAssetFromCache) {\r\n        getAssetFromCache(assetID)\r\n          .then((cachedBlob) => {\r\n            if (cachedBlob) {\r\n              // Asset found in cache, get metadata\r\n              return getAsset(assetID).then((asset) => {\r\n                fetchedAsset = asset;\r\n                // Convert Blob to File\r\n                const filename = asset.filename || \"cached-asset\";\r\n                return new File([cachedBlob], filename, {\r\n                  type: cachedBlob.type\r\n                });\r\n              });\r\n            } else {\r\n              // Not in cache, get asset and fetch from API\r\n              return getAsset(assetID).then((asset) => {\r\n                asset.isFetchingFile = true;\r\n                asset.fetchError = undefined;\r\n                fetchedAsset = asset;\r\n                return fetchAssetFile(asset);\r\n              });\r\n            }\r\n          })\r\n          .then((file) => {\r\n            if (fetchedAsset) {\r\n              fetchedAsset.setFile(file);\r\n              fetchedAsset.isFetchingFile = false;\r\n\r\n              // Store the fetched file in cache if not from cache already\r\n              if (storeAssetInCache) {\r\n                storeAssetInCache(\r\n                  assetID,\r\n                  new Blob([file], { type: file.type }),\r\n                  file.type\r\n                ).catch((e) => {\r\n                  this.warn(`Failed to cache asset: ${e.message}`);\r\n                });\r\n              }\r\n\r\n              if (fetchedAsset.blobURL) {\r\n                resolve(fetchedAsset.blobURL);\r\n                return;\r\n              }\r\n            }\r\n            reject(new Error(\"Blob URL is empty\"));\r\n          })\r\n          .catch((e: Error) => {\r\n            // Cache error or fetch error, try normal flow\r\n            this.warn(`Cache error or fetch error: ${e.message}`);\r\n            this.fetchAssetNormally(assetID, resolve, reject);\r\n          });\r\n      } else {\r\n        // No cache available, use normal flow\r\n        this.fetchAssetNormally(assetID, resolve, reject);\r\n      }\r\n    });\r\n  };\r\n\r\n  // Helper method for the normal asset fetching flow without cache\r\n  private fetchAssetNormally = (\r\n    assetID: string,\r\n    resolve: (blobURL: string) => void,\r\n    reject: (error: Error) => void\r\n  ): void => {\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!getAsset || !fetchAssetFile) {\r\n      reject(new Error(\"Required dependencies not found\"));\r\n      return;\r\n    }\r\n\r\n    let fetchedAsset: AssetEntity | undefined;\r\n\r\n    getAsset(assetID)\r\n      .then((asset) => {\r\n        asset.isFetchingFile = true;\r\n        asset.fetchError = undefined;\r\n        fetchedAsset = asset;\r\n        return fetchAssetFile(asset);\r\n      })\r\n      .then((file) => {\r\n        if (fetchedAsset) {\r\n          fetchedAsset.setFile(file);\r\n          fetchedAsset.isFetchingFile = false;\r\n\r\n          // Store the fetched file in cache if caching is available\r\n          if (storeAssetInCache) {\r\n            storeAssetInCache(\r\n              assetID,\r\n              new Blob([file], { type: file.type }),\r\n              file.type\r\n            ).catch((e) => {\r\n              this.warn(`Failed to cache asset: ${e.message}`);\r\n            });\r\n          }\r\n\r\n          if (fetchedAsset.blobURL) {\r\n            resolve(fetchedAsset.blobURL);\r\n            return;\r\n          }\r\n        }\r\n        reject(new Error(\"Blob URL is empty\"));\r\n      })\r\n      .catch((e: Error) => {\r\n        if (fetchedAsset) {\r\n          fetchedAsset.fetchError = e;\r\n          fetchedAsset.isFetchingFile = false;\r\n        }\r\n        reject(e);\r\n      });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetBlobURLUC.type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"GetAssetBlobURLUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * GetAssetBlobURLUC.ts\r\n *\r\n * This use case provides optimized asset file retrieval with caching support,\r\n * returning blob URLs for immediate use in web applications.\r\n *\r\n * Key Concepts:\r\n * - Provides blob URLs for asset files with multi-level caching optimization\r\n * - Checks memory cache (existing entities) first for immediate access\r\n * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval\r\n * - Finally fetches from remote API when cache misses occur\r\n * - Manages fetch state indicators for UI feedback\r\n * - Automatically stores fetched files in cache for future access\r\n *\r\n * Usage Patterns:\r\n * - Singleton use case accessed through static get() method\r\n * - Called with asset ID to retrieve blob URL for display or download\r\n * - Handles async operations with comprehensive error handling\r\n * - Optimizes performance through multi-level caching strategy\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetFileFromAPIUC } from \"../../VivedAPI\";\r\nimport { GetAssetFromCacheUC, StoreAssetInCacheUC } from \"../../Cache\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\nimport { GetAssetUC } from \"./GetAssetUC\";\r\n\r\n/**\r\n * GetAssetBlobURLUC handles optimized retrieval of asset files as blob URLs.\r\n *\r\n * This singleton use case implements a multi-level caching strategy to minimize\r\n * network requests and provide fast access to asset files for web applications.\r\n */\r\nexport abstract class GetAssetBlobURLUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"GetAssetBlobURLUC\";\r\n\r\n  /**\r\n   * Retrieves a blob URL for the specified asset file.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a blob URL for immediate use\r\n   */\r\n  abstract getAssetBlobURL(assetID: string): Promise<string>;\r\n\r\n  /**\r\n   * Retrieves the singleton GetAssetBlobURLUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns GetAssetBlobURLUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): GetAssetBlobURLUC | undefined {\r\n    return getSingletonComponent<GetAssetBlobURLUC>(\r\n      GetAssetBlobURLUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new GetAssetBlobURLUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case\r\n * @returns A new GetAssetBlobURLUC implementation instance\r\n */\r\nexport function makeGetAssetBlobURLUC(appObject: AppObject): GetAssetBlobURLUC {\r\n  return new GetAssetBlobURLUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of GetAssetBlobURLUC with multi-level caching strategy.\r\n *\r\n * Key Implementation Details:\r\n * - Implements three-tier caching: memory (entities), persistent cache, and remote API\r\n * - Manages fetch state indicators for user feedback during operations\r\n * - Automatically caches fetched files for future access optimization\r\n * - Handles cache failures gracefully with fallback to direct API access\r\n * - Converts between Blob and File objects for compatibility\r\n * - Provides detailed error handling and logging for debugging\r\n */\r\nclass GetAssetBlobURLUCImp extends GetAssetBlobURLUC {\r\n  /** Gets the asset repository for entity management and lookup */\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  /** Gets the API use case for fetching asset files from remote sources */\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<FetchAssetFileFromAPIUC>(\r\n      FetchAssetFileFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  /** Gets the use case for retrieving asset metadata */\r\n  private get getAsset() {\r\n    return this.getCachedSingleton<GetAssetUC>(GetAssetUC.type)?.getAsset;\r\n  }\r\n\r\n  /** Gets the use case for retrieving assets from persistent cache */\r\n  private get getAssetFromCache() {\r\n    return this.getCachedSingleton<GetAssetFromCacheUC>(\r\n      GetAssetFromCacheUC.type\r\n    )?.getAsset;\r\n  }\r\n\r\n  /** Gets the use case for storing assets in persistent cache */\r\n  private get storeAssetInCache() {\r\n    return this.getCachedSingleton<StoreAssetInCacheUC>(\r\n      StoreAssetInCacheUC.type\r\n    )?.storeAsset;\r\n  }\r\n\r\n  /**\r\n   * Retrieves an asset blob URL using optimized multi-level caching.\r\n   *\r\n   * This method implements a three-tier caching strategy:\r\n   * 1. Memory cache: Check if asset entity already has a blob URL\r\n   * 2. Persistent cache: Check IndexedDB/localStorage for cached file\r\n   * 3. Remote API: Fetch from backend as last resort\r\n   *\r\n   * Each level provides progressively better performance, with automatic\r\n   * population of higher-level caches for future access optimization.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a blob URL for the asset file\r\n   */\r\n  getAssetBlobURL = (assetID: string): Promise<string> => {\r\n    const assetRepo = this.assetRepo;\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const getAssetFromCache = this.getAssetFromCache;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!assetRepo || !getAsset || !fetchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Level 1: Check memory cache (existing entities with blob URLs)\r\n    const existing = assetRepo.get(assetID);\r\n    if (existing && existing.blobURL) {\r\n      return Promise.resolve(existing.blobURL);\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      let fetchedAsset: AssetEntity | undefined;\r\n\r\n      // Level 2: Check persistent cache\r\n      if (getAssetFromCache) {\r\n        getAssetFromCache(assetID)\r\n          .then((cachedBlob) => {\r\n            if (cachedBlob) {\r\n              // Asset found in cache, get metadata and create file\r\n              return getAsset(assetID).then((asset) => {\r\n                fetchedAsset = asset;\r\n                const filename = asset.filename || \"cached-asset\";\r\n                return new File([cachedBlob], filename, {\r\n                  type: cachedBlob.type\r\n                });\r\n              });\r\n            } else {\r\n              // Level 3: Fetch from remote API\r\n              return getAsset(assetID).then((asset) => {\r\n                asset.isFetchingFile = true;\r\n                asset.fetchError = undefined;\r\n                fetchedAsset = asset;\r\n                return fetchAssetFile(asset);\r\n              });\r\n            }\r\n          })\r\n          .then((file) => {\r\n            if (fetchedAsset) {\r\n              // Create blob URL and update entity\r\n              fetchedAsset.setFile(file);\r\n              fetchedAsset.isFetchingFile = false;\r\n\r\n              // Store in cache for future access (if not from cache already)\r\n              if (storeAssetInCache) {\r\n                storeAssetInCache(\r\n                  assetID,\r\n                  new Blob([file], { type: file.type }),\r\n                  file.type\r\n                ).catch((e) => {\r\n                  this.warn(`Failed to cache asset: ${e.message}`);\r\n                });\r\n              }\r\n\r\n              if (fetchedAsset.blobURL) {\r\n                resolve(fetchedAsset.blobURL);\r\n                return;\r\n              }\r\n            }\r\n            reject(new Error(\"Blob URL is empty\"));\r\n          })\r\n          .catch((e: Error) => {\r\n            // Cache error, fallback to normal flow\r\n            this.warn(`Cache error or fetch error: ${e.message}`);\r\n            this.fetchAssetNormally(assetID, resolve, reject);\r\n          });\r\n      } else {\r\n        // No cache available, use direct API access\r\n        this.fetchAssetNormally(assetID, resolve, reject);\r\n      }\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Helper method for direct asset fetching without cache support.\r\n   *\r\n   * This method handles the direct API fetch workflow when caching\r\n   * is not available or has failed. It still attempts to store the\r\n   * result in cache for future optimization.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param resolve - Success callback with blob URL\r\n   * @param reject - Error callback with error details\r\n   */\r\n  private fetchAssetNormally = (\r\n    assetID: string,\r\n    resolve: (blobURL: string) => void,\r\n    reject: (error: Error) => void\r\n  ): void => {\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!getAsset || !fetchAssetFile) {\r\n      reject(new Error(\"Required dependencies not found\"));\r\n      return;\r\n    }\r\n\r\n    let fetchedAsset: AssetEntity | undefined;\r\n\r\n    getAsset(assetID)\r\n      .then((asset) => {\r\n        // Set loading state for UI feedback\r\n        asset.isFetchingFile = true;\r\n        asset.fetchError = undefined;\r\n        fetchedAsset = asset;\r\n        return fetchAssetFile(asset);\r\n      })\r\n      .then((file) => {\r\n        if (fetchedAsset) {\r\n          // Create blob URL and update entity\r\n          fetchedAsset.setFile(file);\r\n          fetchedAsset.isFetchingFile = false;\r\n\r\n          // Store in cache for future optimization (if available)\r\n          if (storeAssetInCache) {\r\n            storeAssetInCache(\r\n              assetID,\r\n              new Blob([file], { type: file.type }),\r\n              file.type\r\n            ).catch((e) => {\r\n              this.warn(`Failed to cache asset: ${e.message}`);\r\n            });\r\n          }\r\n\r\n          if (fetchedAsset.blobURL) {\r\n            resolve(fetchedAsset.blobURL);\r\n            return;\r\n          }\r\n        }\r\n        reject(new Error(\"Blob URL is empty\"));\r\n      })\r\n      .catch((e: Error) => {\r\n        // Handle fetch errors with proper state cleanup\r\n        if (fetchedAsset) {\r\n          fetchedAsset.fetchError = e;\r\n          fetchedAsset.isFetchingFile = false;\r\n        }\r\n        reject(e);\r\n      });\r\n  };\r\n\r\n  /**\r\n   * Initializes the GetAssetBlobURLUC and registers it as a singleton.\r\n   *\r\n   * @param appObject - The AppObject that will host this singleton use case\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetBlobURLUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/cjs/Assets/UCs/GetAssetFileUC.js

@@ -1,4 +1,24 @@
 "use strict";
+/**
+ * GetAssetFileUC.ts
+ *
+ * This use case handles retrieval of asset files with advanced caching strategies,
+ * returning File objects for use in web applications and file operations.
+ *
+ * Key Concepts:
+ * - Retrieves asset files as File objects with multi-level caching optimization
+ * - Checks memory cache (existing entities) first for immediate access
+ * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval
+ * - Finally fetches from remote API when cache misses occur
+ * - Manages fetch state indicators and error handling for user feedback
+ * - Automatically stores fetched files in cache for future access
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to retrieve File object for processing or display
+ * - Handles async operations with comprehensive error handling
+ * - Optimizes performance through intelligent caching strategies
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetAssetFileUC = void 0;
 exports.makeGetAssetFileUC = makeGetAssetFileUC;
@@ -7,32 +27,74 @@ const VivedAPI_1 = require("../../VivedAPI");
 const Cache_1 = require("../../Cache");
 const AssetRepo_1 = require("../Entities/AssetRepo");
 const GetAssetUC_1 = require("./GetAssetUC");
+/**
+ * GetAssetFileUC handles optimized retrieval of asset files as File objects.
+ *
+ * This singleton use case implements a multi-level caching strategy to minimize
+ * network requests and provide fast access to asset files for web applications.
+ */
 class GetAssetFileUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton GetAssetFileUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetFileUC instance or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(GetAssetFileUC.type, appObjects);
     }
 }
 exports.GetAssetFileUC = GetAssetFileUC;
+/** Static type identifier for component registration */
 GetAssetFileUC.type = "GetAssetFileUC";
+/**
+ * Factory function to create a new GetAssetFileUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new GetAssetFileUC implementation instance
+ */
 function makeGetAssetFileUC(appObject) {
     return new GetAssetFileUCImp(appObject);
 }
+/**
+ * Private implementation of GetAssetFileUC with advanced caching and error handling.
+ *
+ * Key Implementation Details:
+ * - Implements three-tier caching: memory (entities), persistent cache, and remote API
+ * - Uses async/await for cleaner error handling and flow control
+ * - Manages fetch state indicators for user feedback during operations
+ * - Automatically caches fetched files for future access optimization
+ * - Handles cache failures gracefully with fallback to direct API access
+ * - Converts between Blob and File objects maintaining metadata integrity
+ * - Provides detailed error handling and logging for debugging
+ */
 class GetAssetFileUCImp extends GetAssetFileUC {
+    /** Gets the asset repository for entity management and lookup */
     get assetRepo() {
         return this.getCachedSingleton(AssetRepo_1.AssetRepo.type);
     }
+    /** Gets the API use case for fetching asset files from remote sources */
     get fetchAssetFile() {
         return this.getCachedSingleton(VivedAPI_1.FetchAssetFileFromAPIUC.type)?.doFetch;
     }
+    /** Gets the use case for retrieving asset metadata */
     get getAsset() {
         return this.getCachedSingleton(GetAssetUC_1.GetAssetUC.type)?.getAsset;
     }
+    /** Gets the use case for retrieving assets from persistent cache */
     get getAssetFromCache() {
         return this.getCachedSingleton(Cache_1.GetAssetFromCacheUC.type)?.getAsset;
     }
+    /** Gets the use case for storing assets in persistent cache */
     get storeAssetInCache() {
         return this.getCachedSingleton(Cache_1.StoreAssetInCacheUC.type)?.storeAsset;
     }
+    /**
+     * Attempts to retrieve from cache or falls back to direct API fetch.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @returns Promise resolving to a File object
+     */
     async tryGetFromCacheOrFetch(assetID) {
         const getAssetFromCache = this.getAssetFromCache;
         // If no cache is available, go straight to normal fetching
@@ -50,6 +112,13 @@ class GetAssetFileUCImp extends GetAssetFileUC {
             return this.fetchAssetDirectly(assetID);
         }
     }
+    /**
+     * Creates a File object from cached blob data and asset metadata.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param cachedBlob - The cached blob data
+     * @returns Promise resolving to a File object with proper metadata
+     */
     async createFileFromCachedBlob(assetID, cachedBlob) {
         const getAsset = this.getAsset;
         if (!getAsset) {
@@ -57,7 +126,7 @@ class GetAssetFileUCImp extends GetAssetFileUC {
         }
         // Get asset metadata
         const asset = await getAsset(assetID);
-        // Convert blob to file
+        // Convert blob to file with proper metadata
         const filename = asset.filename || "cached-asset";
         const file = new File([cachedBlob], filename, {
             type: cachedBlob.type
@@ -67,6 +136,12 @@ class GetAssetFileUCImp extends GetAssetFileUC {
         asset.isFetchingFile = false;
         return file;
     }
+    /**
+     * Fetches asset file directly from API with state management.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @returns Promise resolving to a File object
+     */
     async fetchAssetDirectly(assetID) {
         const getAsset = this.getAsset;
         const fetchAssetFile = this.fetchAssetFile;
@@ -83,7 +158,7 @@ class GetAssetFileUCImp extends GetAssetFileUC {
             // Update asset state
             asset.setFile(file);
             asset.isFetchingFile = false;
-            // Try to store in cache
+            // Try to store in cache for future optimization
             await this.tryCacheAssetFile(assetID, file);
             return file;
         }
@@ -92,6 +167,12 @@ class GetAssetFileUCImp extends GetAssetFileUC {
             throw error;
         }
     }
+    /**
+     * Handles fetch errors by updating asset state appropriately.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param error - The error that occurred during fetching
+     */
     async handleFetchError(assetID, error) {
         const getAsset = this.getAsset;
         if (!getAsset) {
@@ -106,6 +187,12 @@ class GetAssetFileUCImp extends GetAssetFileUC {
             // If we can't get the asset, we can't update its error state
         }
     }
+    /**
+     * Attempts to cache the fetched file for future optimization.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param file - The file to cache
+     */
     async tryCacheAssetFile(assetID, file) {
         const storeAssetInCache = this.storeAssetInCache;
         if (!storeAssetInCache) {
@@ -118,8 +205,27 @@ class GetAssetFileUCImp extends GetAssetFileUC {
             this.warn(`Failed to cache asset: ${e.message}`);
         }
     }
+    /**
+     * Initializes the GetAssetFileUC and registers it as a singleton.
+     *
+     * @param appObject - The AppObject that will host this singleton use case
+     */
     constructor(appObject) {
         super(appObject, GetAssetFileUC.type);
+        /**
+         * Retrieves an asset file using optimized multi-level caching.
+         *
+         * This method implements a three-tier caching strategy:
+         * 1. Memory cache: Check if asset entity already has a File object
+         * 2. Persistent cache: Check IndexedDB/localStorage for cached file
+         * 3. Remote API: Fetch from backend as last resort
+         *
+         * Each level provides progressively better performance, with automatic
+         * population of higher-level caches for future access optimization.
+         *
+         * @param assetID - The unique identifier of the asset
+         * @returns Promise resolving to a File object for the asset
+         */
         this.getAssetFile = async (assetID) => {
             const assetRepo = this.assetRepo;
             const getAsset = this.getAsset;
@@ -128,12 +234,12 @@ class GetAssetFileUCImp extends GetAssetFileUC {
             if (!assetRepo || !getAsset || !fetchAssetFile) {
                 return Promise.reject(new Error("Missing required dependencies"));
             }
-            // Check if asset already exists in memory with a file
+            // Level 1: Check memory cache (existing entities with File objects)
             const existingAsset = assetRepo.get(assetID);
             if (existingAsset?.file) {
                 return existingAsset.file;
             }
-            // Try to get from cache first, then fall back to normal fetching if needed
+            // Level 2 & 3: Try cache then API with comprehensive error handling
             try {
                 return await this.tryGetFromCacheOrFetch(assetID);
             }

package/dist/cjs/Assets/UCs/GetAssetFileUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"GetAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetFileUC.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetFileFromAPIUC } from \"../../VivedAPI\";\r\nimport { GetAssetFromCacheUC, StoreAssetInCacheUC } from \"../../Cache\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\nimport { GetAssetUC } from \"./GetAssetUC\";\r\n\r\nexport abstract class GetAssetFileUC extends AppObjectUC {\r\n  static type = \"GetAssetFileUC\";\r\n\r\n  abstract getAssetFile(assetID: string): Promise<File>;\r\n\r\n  static get(appObjects: AppObjectRepo): GetAssetFileUC | undefined {\r\n    return getSingletonComponent<GetAssetFileUC>(\r\n      GetAssetFileUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeGetAssetFileUC(appObject: AppObject): GetAssetFileUC {\r\n  return new GetAssetFileUCImp(appObject);\r\n}\r\n\r\nclass GetAssetFileUCImp extends GetAssetFileUC {\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<FetchAssetFileFromAPIUC>(\r\n      FetchAssetFileFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  private get getAsset() {\r\n    return this.getCachedSingleton<GetAssetUC>(GetAssetUC.type)?.getAsset;\r\n  }\r\n\r\n  private get getAssetFromCache() {\r\n    return this.getCachedSingleton<GetAssetFromCacheUC>(\r\n      GetAssetFromCacheUC.type\r\n    )?.getAsset;\r\n  }\r\n\r\n  private get storeAssetInCache() {\r\n    return this.getCachedSingleton<StoreAssetInCacheUC>(\r\n      StoreAssetInCacheUC.type\r\n    )?.storeAsset;\r\n  }\r\n\r\n  getAssetFile = async (assetID: string): Promise<File> => {\r\n    const assetRepo = this.assetRepo;\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n\r\n    // Check for required dependencies\r\n    if (!assetRepo || !getAsset || !fetchAssetFile) {\r\n      return Promise.reject(new Error(\"Missing required dependencies\"));\r\n    }\r\n\r\n    // Check if asset already exists in memory with a file\r\n    const existingAsset = assetRepo.get(assetID);\r\n    if (existingAsset?.file) {\r\n      return existingAsset.file;\r\n    }\r\n\r\n    // Try to get from cache first, then fall back to normal fetching if needed\r\n    try {\r\n      return await this.tryGetFromCacheOrFetch(assetID);\r\n    } catch (error) {\r\n      // If cache access failed, try the normal flow\r\n      this.warn(`Cache error: ${(error as Error).message}`);\r\n      return this.fetchAssetDirectly(assetID);\r\n    }\r\n  };\r\n\r\n  private async tryGetFromCacheOrFetch(assetID: string): Promise<File> {\r\n    const getAssetFromCache = this.getAssetFromCache;\r\n\r\n    // If no cache is available, go straight to normal fetching\r\n    if (!getAssetFromCache) {\r\n      return this.fetchAssetDirectly(assetID);\r\n    }\r\n\r\n    // Try to get the asset from cache\r\n    const cachedBlob = await getAssetFromCache(assetID);\r\n\r\n    if (cachedBlob) {\r\n      // Asset found in cache, get metadata and create file\r\n      return this.createFileFromCachedBlob(assetID, cachedBlob);\r\n    } else {\r\n      // Not in cache, fetch directly\r\n      return this.fetchAssetDirectly(assetID);\r\n    }\r\n  }\r\n\r\n  private async createFileFromCachedBlob(\r\n    assetID: string,\r\n    cachedBlob: Blob\r\n  ): Promise<File> {\r\n    const getAsset = this.getAsset;\r\n\r\n    if (!getAsset) {\r\n      throw new Error(\"Required dependencies not found\");\r\n    }\r\n\r\n    // Get asset metadata\r\n    const asset = await getAsset(assetID);\r\n\r\n    // Convert blob to file\r\n    const filename = asset.filename || \"cached-asset\";\r\n    const file = new File([cachedBlob], filename, {\r\n      type: cachedBlob.type\r\n    });\r\n\r\n    // Update asset state\r\n    asset.setFile(file);\r\n    asset.isFetchingFile = false;\r\n\r\n    return file;\r\n  }\r\n\r\n  private async fetchAssetDirectly(assetID: string): Promise<File> {\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n\r\n    if (!getAsset || !fetchAssetFile) {\r\n      throw new Error(\"Required dependencies not found\");\r\n    }\r\n\r\n    try {\r\n      // Get asset and prepare for fetching\r\n      const asset = await getAsset(assetID);\r\n      asset.isFetchingFile = true;\r\n      asset.fetchError = undefined;\r\n\r\n      // Fetch the file\r\n      const file = await fetchAssetFile(asset);\r\n\r\n      // Update asset state\r\n      asset.setFile(file);\r\n      asset.isFetchingFile = false;\r\n\r\n      // Try to store in cache\r\n      await this.tryCacheAssetFile(assetID, file);\r\n\r\n      return file;\r\n    } catch (error) {\r\n      await this.handleFetchError(assetID, error as Error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  private async handleFetchError(assetID: string, error: Error): Promise<void> {\r\n    const getAsset = this.getAsset;\r\n\r\n    if (!getAsset) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const asset = await getAsset(assetID);\r\n      asset.fetchError = error;\r\n      asset.isFetchingFile = false;\r\n    } catch {\r\n      // If we can't get the asset, we can't update its error state\r\n    }\r\n  }\r\n\r\n  private async tryCacheAssetFile(assetID: string, file: File): Promise<void> {\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!storeAssetInCache) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      await storeAssetInCache(\r\n        assetID,\r\n        new Blob([file], { type: file.type }),\r\n        file.type\r\n      );\r\n    } catch (e) {\r\n      this.warn(`Failed to cache asset: ${(e as Error).message}`);\r\n    }\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetFileUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"GetAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetFileUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * GetAssetFileUC.ts\r\n *\r\n * This use case handles retrieval of asset files with advanced caching strategies,\r\n * returning File objects for use in web applications and file operations.\r\n *\r\n * Key Concepts:\r\n * - Retrieves asset files as File objects with multi-level caching optimization\r\n * - Checks memory cache (existing entities) first for immediate access\r\n * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval\r\n * - Finally fetches from remote API when cache misses occur\r\n * - Manages fetch state indicators and error handling for user feedback\r\n * - Automatically stores fetched files in cache for future access\r\n *\r\n * Usage Patterns:\r\n * - Singleton use case accessed through static get() method\r\n * - Called with asset ID to retrieve File object for processing or display\r\n * - Handles async operations with comprehensive error handling\r\n * - Optimizes performance through intelligent caching strategies\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetFileFromAPIUC } from \"../../VivedAPI\";\r\nimport { GetAssetFromCacheUC, StoreAssetInCacheUC } from \"../../Cache\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\nimport { GetAssetUC } from \"./GetAssetUC\";\r\n\r\n/**\r\n * GetAssetFileUC handles optimized retrieval of asset files as File objects.\r\n *\r\n * This singleton use case implements a multi-level caching strategy to minimize\r\n * network requests and provide fast access to asset files for web applications.\r\n */\r\nexport abstract class GetAssetFileUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"GetAssetFileUC\";\r\n\r\n  /**\r\n   * Retrieves a File object for the specified asset.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a File object for the asset\r\n   */\r\n  abstract getAssetFile(assetID: string): Promise<File>;\r\n\r\n  /**\r\n   * Retrieves the singleton GetAssetFileUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns GetAssetFileUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): GetAssetFileUC | undefined {\r\n    return getSingletonComponent<GetAssetFileUC>(\r\n      GetAssetFileUC.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new GetAssetFileUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case\r\n * @returns A new GetAssetFileUC implementation instance\r\n */\r\nexport function makeGetAssetFileUC(appObject: AppObject): GetAssetFileUC {\r\n  return new GetAssetFileUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of GetAssetFileUC with advanced caching and error handling.\r\n *\r\n * Key Implementation Details:\r\n * - Implements three-tier caching: memory (entities), persistent cache, and remote API\r\n * - Uses async/await for cleaner error handling and flow control\r\n * - Manages fetch state indicators for user feedback during operations\r\n * - Automatically caches fetched files for future access optimization\r\n * - Handles cache failures gracefully with fallback to direct API access\r\n * - Converts between Blob and File objects maintaining metadata integrity\r\n * - Provides detailed error handling and logging for debugging\r\n */\r\nclass GetAssetFileUCImp extends GetAssetFileUC {\r\n  /** Gets the asset repository for entity management and lookup */\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  /** Gets the API use case for fetching asset files from remote sources */\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<FetchAssetFileFromAPIUC>(\r\n      FetchAssetFileFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  /** Gets the use case for retrieving asset metadata */\r\n  private get getAsset() {\r\n    return this.getCachedSingleton<GetAssetUC>(GetAssetUC.type)?.getAsset;\r\n  }\r\n\r\n  /** Gets the use case for retrieving assets from persistent cache */\r\n  private get getAssetFromCache() {\r\n    return this.getCachedSingleton<GetAssetFromCacheUC>(\r\n      GetAssetFromCacheUC.type\r\n    )?.getAsset;\r\n  }\r\n\r\n  /** Gets the use case for storing assets in persistent cache */\r\n  private get storeAssetInCache() {\r\n    return this.getCachedSingleton<StoreAssetInCacheUC>(\r\n      StoreAssetInCacheUC.type\r\n    )?.storeAsset;\r\n  }\r\n\r\n  /**\r\n   * Retrieves an asset file using optimized multi-level caching.\r\n   *\r\n   * This method implements a three-tier caching strategy:\r\n   * 1. Memory cache: Check if asset entity already has a File object\r\n   * 2. Persistent cache: Check IndexedDB/localStorage for cached file\r\n   * 3. Remote API: Fetch from backend as last resort\r\n   *\r\n   * Each level provides progressively better performance, with automatic\r\n   * population of higher-level caches for future access optimization.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a File object for the asset\r\n   */\r\n  getAssetFile = async (assetID: string): Promise<File> => {\r\n    const assetRepo = this.assetRepo;\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n\r\n    // Check for required dependencies\r\n    if (!assetRepo || !getAsset || !fetchAssetFile) {\r\n      return Promise.reject(new Error(\"Missing required dependencies\"));\r\n    }\r\n\r\n    // Level 1: Check memory cache (existing entities with File objects)\r\n    const existingAsset = assetRepo.get(assetID);\r\n    if (existingAsset?.file) {\r\n      return existingAsset.file;\r\n    }\r\n\r\n    // Level 2 & 3: Try cache then API with comprehensive error handling\r\n    try {\r\n      return await this.tryGetFromCacheOrFetch(assetID);\r\n    } catch (error) {\r\n      // If cache access failed, try the normal flow\r\n      this.warn(`Cache error: ${(error as Error).message}`);\r\n      return this.fetchAssetDirectly(assetID);\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Attempts to retrieve from cache or falls back to direct API fetch.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a File object\r\n   */\r\n  private async tryGetFromCacheOrFetch(assetID: string): Promise<File> {\r\n    const getAssetFromCache = this.getAssetFromCache;\r\n\r\n    // If no cache is available, go straight to normal fetching\r\n    if (!getAssetFromCache) {\r\n      return this.fetchAssetDirectly(assetID);\r\n    }\r\n\r\n    // Try to get the asset from cache\r\n    const cachedBlob = await getAssetFromCache(assetID);\r\n\r\n    if (cachedBlob) {\r\n      // Asset found in cache, get metadata and create file\r\n      return this.createFileFromCachedBlob(assetID, cachedBlob);\r\n    } else {\r\n      // Not in cache, fetch directly\r\n      return this.fetchAssetDirectly(assetID);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Creates a File object from cached blob data and asset metadata.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param cachedBlob - The cached blob data\r\n   * @returns Promise resolving to a File object with proper metadata\r\n   */\r\n  private async createFileFromCachedBlob(\r\n    assetID: string,\r\n    cachedBlob: Blob\r\n  ): Promise<File> {\r\n    const getAsset = this.getAsset;\r\n\r\n    if (!getAsset) {\r\n      throw new Error(\"Required dependencies not found\");\r\n    }\r\n\r\n    // Get asset metadata\r\n    const asset = await getAsset(assetID);\r\n\r\n    // Convert blob to file with proper metadata\r\n    const filename = asset.filename || \"cached-asset\";\r\n    const file = new File([cachedBlob], filename, {\r\n      type: cachedBlob.type\r\n    });\r\n\r\n    // Update asset state\r\n    asset.setFile(file);\r\n    asset.isFetchingFile = false;\r\n\r\n    return file;\r\n  }\r\n\r\n  /**\r\n   * Fetches asset file directly from API with state management.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to a File object\r\n   */\r\n  private async fetchAssetDirectly(assetID: string): Promise<File> {\r\n    const getAsset = this.getAsset;\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n\r\n    if (!getAsset || !fetchAssetFile) {\r\n      throw new Error(\"Required dependencies not found\");\r\n    }\r\n\r\n    try {\r\n      // Get asset and prepare for fetching\r\n      const asset = await getAsset(assetID);\r\n      asset.isFetchingFile = true;\r\n      asset.fetchError = undefined;\r\n\r\n      // Fetch the file\r\n      const file = await fetchAssetFile(asset);\r\n\r\n      // Update asset state\r\n      asset.setFile(file);\r\n      asset.isFetchingFile = false;\r\n\r\n      // Try to store in cache for future optimization\r\n      await this.tryCacheAssetFile(assetID, file);\r\n\r\n      return file;\r\n    } catch (error) {\r\n      await this.handleFetchError(assetID, error as Error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Handles fetch errors by updating asset state appropriately.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param error - The error that occurred during fetching\r\n   */\r\n  private async handleFetchError(assetID: string, error: Error): Promise<void> {\r\n    const getAsset = this.getAsset;\r\n\r\n    if (!getAsset) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const asset = await getAsset(assetID);\r\n      asset.fetchError = error;\r\n      asset.isFetchingFile = false;\r\n    } catch {\r\n      // If we can't get the asset, we can't update its error state\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Attempts to cache the fetched file for future optimization.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param file - The file to cache\r\n   */\r\n  private async tryCacheAssetFile(assetID: string, file: File): Promise<void> {\r\n    const storeAssetInCache = this.storeAssetInCache;\r\n\r\n    if (!storeAssetInCache) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      await storeAssetInCache(\r\n        assetID,\r\n        new Blob([file], { type: file.type }),\r\n        file.type\r\n      );\r\n    } catch (e) {\r\n      this.warn(`Failed to cache asset: ${(e as Error).message}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Initializes the GetAssetFileUC and registers it as a singleton.\r\n   *\r\n   * @param appObject - The AppObject that will host this singleton use case\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetFileUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}