@vived/host 4.11.1 → 4.12.0

package/dist/cjs/Apps/Factories/AppsFeatureFactory.js

@@ -19,9 +19,8 @@ class AppsFeatureFactory extends core_1.DomainFactory {
      * Sets up all entities required for the Apps system
      */
     setupEntities() {
-        this.appRepoAO = this.appObjects.getOrCreate("App Repository");
         // Initialize entities
-        (0, Entities_1.makeAppRepo)(this.appRepoAO);
+        (0, Entities_1.makeAppRepo)(this.appObject);
     }
     /**
      * Sets up all use cases for the Apps system
@@ -35,7 +34,7 @@ class AppsFeatureFactory extends core_1.DomainFactory {
      */
     setupPMs() {
         // App Repository PMs
-        (0, PMs_1.makeAppsListPM)(this.appRepoAO);
+        (0, PMs_1.makeAppsListPM)(this.appObject);
     }
     /**
      * Performs any final setup operations after all components are initialized

package/dist/cjs/Apps/Factories/AppsFeatureFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppsFeatureFactory.js","sourceRoot":"","sources":["../../../../src/Apps/Factories/AppsFeatureFactory.ts"],"names":[],"mappings":";;;AAAA,sCAAuD;AACvD,0CAAyD;AACzD,gCAAmD;AAEnD;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,oBAAa;IAOnD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAPnB,+BAA+B;QACtB,gBAAW,GAAG,oBAAoB,CAAC;IAO5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QAE/D,sBAAsB;QACtB,IAAA,sBAAW,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,+DAA+D;QAC/D,0EAA0E;IAC5E,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,qBAAqB;QACrB,IAAA,oBAAc,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,wCAAwC;IAC1C,CAAC;CACF;AA3CD,gDA2CC","sourcesContent":["import { AppObject, DomainFactory } from \"@vived/core\";\r\nimport { makeAppEntity, makeAppRepo } from \"../Entities\";\r\nimport { makeAppPM, makeAppsListPM } from \"../PMs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Apps domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Apps functionality.\r\n */\r\nexport class AppsFeatureFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AppsFeatureFactory\";\r\n\r\n  // Store references to key AppObjects needed across setup phases\r\n  private appRepoAO!: AppObject;\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Apps system\r\n   */\r\n  setupEntities(): void {\r\n    this.appRepoAO = this.appObjects.getOrCreate(\"App Repository\");\r\n\r\n    // Initialize entities\r\n    makeAppRepo(this.appRepoAO);\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Apps system\r\n   */\r\n  setupUCs(): void {\r\n    // Note: App UCs have complex dependencies and should be set up\r\n    // separately to avoid circular dependencies during factory initialization\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Apps system\r\n   */\r\n  setupPMs(): void {\r\n    // App Repository PMs\r\n    makeAppsListPM(this.appRepoAO);\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for apps\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppsFeatureFactory.js","sourceRoot":"","sources":["../../../../src/Apps/Factories/AppsFeatureFactory.ts"],"names":[],"mappings":";;;AAAA,sCAAuD;AACvD,0CAAyD;AACzD,gCAAmD;AAEnD;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,oBAAa;IAInD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAJnB,+BAA+B;QACtB,gBAAW,GAAG,oBAAoB,CAAC;IAI5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,sBAAsB;QACtB,IAAA,sBAAW,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,+DAA+D;QAC/D,0EAA0E;IAC5E,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,qBAAqB;QACrB,IAAA,oBAAc,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,wCAAwC;IAC1C,CAAC;CACF;AAtCD,gDAsCC","sourcesContent":["import { AppObject, DomainFactory } from \"@vived/core\";\r\nimport { makeAppEntity, makeAppRepo } from \"../Entities\";\r\nimport { makeAppPM, makeAppsListPM } from \"../PMs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Apps domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Apps functionality.\r\n */\r\nexport class AppsFeatureFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AppsFeatureFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Apps system\r\n   */\r\n  setupEntities(): void {\r\n    // Initialize entities\r\n    makeAppRepo(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Apps system\r\n   */\r\n  setupUCs(): void {\r\n    // Note: App UCs have complex dependencies and should be set up\r\n    // separately to avoid circular dependencies during factory initialization\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Apps system\r\n   */\r\n  setupPMs(): void {\r\n    // App Repository PMs\r\n    makeAppsListPM(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for apps\r\n  }\r\n}\r\n"]}

package/dist/cjs/Assets/Controllers/fetchAssetFile.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * fetchAssetFile.ts
+ *
+ * This controller function retrieves an asset file as a File object,
+ * handling caching and error management for file access operations.
+ *
+ * Key Concepts:
+ * - Retrieves asset files as File objects for download or processing
+ * - Uses GetAssetFileUC to handle caching and file retrieval logic
+ * - Provides error handling for missing components
+ * - Coordinates with asset file management workflows
+ *
+ * Usage Patterns:
+ * - Called from UI components when users need asset file access
+ * - Used in asset management workflows for file processing
+ * - Integrated with download and preview functionality
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAssetFile = fetchAssetFile;
+const GetAssetFileUC_1 = require("../UCs/GetAssetFileUC");
+/**
+ * Retrieves an asset file as a File object.
+ *
+ * This function provides a controller-level interface for asset file retrieval.
+ * It handles the complete file access workflow including caching optimization,
+ * error handling, and returns a File object ready for use in web applications.
+ *
+ * @param assetID - The unique identifier of the asset whose file should be retrieved
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns Promise<File> - A promise that resolves to the File object for the asset,
+ *                         or undefined if the operation cannot be completed
+ */
+function fetchAssetFile(assetID, appObjects) {
+    const uc = GetAssetFileUC_1.GetAssetFileUC.get(appObjects);
+    if (!uc) {
+        appObjects.submitWarning("fetchAssetFile", "Unable to find GetAssetFileUC");
+        return;
+    }
+    return uc.getAssetFile(assetID);
+}
+//# sourceMappingURL=fetchAssetFile.js.map

package/dist/cjs/Assets/Controllers/fetchAssetFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAssetFile.js","sourceRoot":"","sources":["../../../../src/Assets/Controllers/fetchAssetFile.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAiBH,wCAWC;AAzBD,0DAAuD;AAEvD;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAC5B,OAAe,EACf,UAAyB;IAEzB,MAAM,EAAE,GAAG,+BAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,UAAU,CAAC,aAAa,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC","sourcesContent":["/**\r\n * fetchAssetFile.ts\r\n *\r\n * This controller function retrieves an asset file as a File object,\r\n * handling caching and error management for file access operations.\r\n *\r\n * Key Concepts:\r\n * - Retrieves asset files as File objects for download or processing\r\n * - Uses GetAssetFileUC to handle caching and file retrieval logic\r\n * - Provides error handling for missing components\r\n * - Coordinates with asset file management workflows\r\n *\r\n * Usage Patterns:\r\n * - Called from UI components when users need asset file access\r\n * - Used in asset management workflows for file processing\r\n * - Integrated with download and preview functionality\r\n */\r\n\r\nimport { AppObjectRepo } from \"@vived/core\";\r\nimport { GetAssetFileUC } from \"../UCs/GetAssetFileUC\";\r\n\r\n/**\r\n * Retrieves an asset file as a File object.\r\n *\r\n * This function provides a controller-level interface for asset file retrieval.\r\n * It handles the complete file access workflow including caching optimization,\r\n * error handling, and returns a File object ready for use in web applications.\r\n *\r\n * @param assetID - The unique identifier of the asset whose file should be retrieved\r\n * @param appObjects - Repository for accessing asset-related app objects and components\r\n * @returns Promise<File> - A promise that resolves to the File object for the asset,\r\n *                         or undefined if the operation cannot be completed\r\n */\r\nexport function fetchAssetFile(\r\n  assetID: string,\r\n  appObjects: AppObjectRepo\r\n): Promise<File> | undefined {\r\n  const uc = GetAssetFileUC.get(appObjects);\r\n  if (!uc) {\r\n    appObjects.submitWarning(\"fetchAssetFile\", \"Unable to find GetAssetFileUC\");\r\n    return;\r\n  }\r\n\r\n  return uc.getAssetFile(assetID);\r\n}\r\n"]}

package/dist/cjs/Assets/Controllers/index.js

@@ -37,6 +37,7 @@ __exportStar(require("./archiveAsset"), exports);
 __exportStar(require("./deleteAsset"), exports);
 __exportStar(require("./downloadAssetFile"), exports);
 __exportStar(require("./editAppAsset"), exports);
+__exportStar(require("./fetchAssetFile"), exports);
 __exportStar(require("./getAppAssets"), exports);
 __exportStar(require("./newAppAsset"), exports);
 __exportStar(require("./toggleShowArchivedAssets"), exports);

package/dist/cjs/Assets/Controllers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,gDAA8B;AAC9B,sDAAoC;AACpC,iDAA+B;AAC/B,iDAA+B;AAC/B,gDAA8B;AAC9B,6DAA2C;AAC3C,uDAAqC;AACrC,oDAAkC","sourcesContent":["/**\r\n * Assets Controllers Index\r\n *\r\n * This module exports all controller functions for the Assets feature.\r\n * Controllers provide simple, stateless functions that serve as entry points\r\n * for asset-related operations from UI components and external systems.\r\n *\r\n * Key Concepts:\r\n * - Controllers act as the interface layer between UI components and business logic\r\n * - Each controller function handles a specific asset operation\r\n * - Controllers delegate to Use Cases (UCs) for actual business logic implementation\r\n * - Error handling and validation are performed at the controller level\r\n *\r\n * Available Operations:\r\n * - Asset lifecycle: create, edit, delete, archive\r\n * - File management: upload, download, update\r\n * - Collection management: get app assets, toggle archived visibility\r\n * - Metadata management: update asset information\r\n */\r\n\r\nexport * from \"./archiveAsset\";\r\nexport * from \"./deleteAsset\";\r\nexport * from \"./downloadAssetFile\";\r\nexport * from \"./editAppAsset\";\r\nexport * from \"./getAppAssets\";\r\nexport * from \"./newAppAsset\";\r\nexport * from \"./toggleShowArchivedAssets\";\r\nexport * from \"./updateAppAssetMeta\";\r\nexport * from \"./updateAssetFile\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,gDAA8B;AAC9B,sDAAoC;AACpC,iDAA+B;AAC/B,mDAAiC;AACjC,iDAA+B;AAC/B,gDAA8B;AAC9B,6DAA2C;AAC3C,uDAAqC;AACrC,oDAAkC","sourcesContent":["/**\r\n * Assets Controllers Index\r\n *\r\n * This module exports all controller functions for the Assets feature.\r\n * Controllers provide simple, stateless functions that serve as entry points\r\n * for asset-related operations from UI components and external systems.\r\n *\r\n * Key Concepts:\r\n * - Controllers act as the interface layer between UI components and business logic\r\n * - Each controller function handles a specific asset operation\r\n * - Controllers delegate to Use Cases (UCs) for actual business logic implementation\r\n * - Error handling and validation are performed at the controller level\r\n *\r\n * Available Operations:\r\n * - Asset lifecycle: create, edit, delete, archive\r\n * - File management: upload, download, update\r\n * - Collection management: get app assets, toggle archived visibility\r\n * - Metadata management: update asset information\r\n */\r\n\r\nexport * from \"./archiveAsset\";\r\nexport * from \"./deleteAsset\";\r\nexport * from \"./downloadAssetFile\";\r\nexport * from \"./editAppAsset\";\r\nexport * from \"./fetchAssetFile\";\r\nexport * from \"./getAppAssets\";\r\nexport * from \"./newAppAsset\";\r\nexport * from \"./toggleShowArchivedAssets\";\r\nexport * from \"./updateAppAssetMeta\";\r\nexport * from \"./updateAssetFile\";\r\n"]}

package/dist/cjs/Assets/Factories/AssetsFactory.js

@@ -20,12 +20,9 @@ class AssetsFactory extends core_1.DomainFactory {
      * Sets up all entities required for the Assets system
      */
     setupEntities() {
-        this.assetRepoAO = this.appObjects.getOrCreate("Asset Repository");
-        this.appAssetsAO = this.appObjects.getOrCreate("App Assets");
         // Initialize entities
-        this.assetRepo = (0, Entities_1.makeAssetRepo)(this.assetRepoAO);
-        this.assetRepo.assetFactory = this.makeAssetFactory();
-        (0, Entities_1.makeAppAssets)(this.appAssetsAO);
+        const assetRepo = (0, Entities_1.makeAssetRepo)(this.appObject);
+        assetRepo.assetFactory = this.makeAssetFactory();
     }
     /**
      * Creates an asset factory function that properly initializes assets with all required components
@@ -40,7 +37,6 @@ class AssetsFactory extends core_1.DomainFactory {
             (0, UCs_1.makeDeleteAssetUC)(ao);
             (0, UCs_1.makeDownloadAssetFileUC)(ao);
             (0, UCs_1.makeUpdateAssetFileUC)(ao);
-            (0, UCs_1.makeUpdateAppAssetMetaUC)(ao);
             // PMs for each asset
             (0, PMs_1.makeAssetPM)(ao);
             (0, PMs_1.makeAssetFilePM)(ao);
@@ -52,24 +48,17 @@ class AssetsFactory extends core_1.DomainFactory {
      */
     setupUCs() {
         // Repository UCs
-        (0, UCs_1.makeEditAppAsset)(this.assetRepoAO);
-        (0, UCs_1.makeGetAssetBlobURLUC)(this.assetRepoAO);
-        (0, UCs_1.makeGetAssetFileUC)(this.assetRepoAO);
-        (0, UCs_1.makeGetAssetUC)(this.assetRepoAO);
-        (0, UCs_1.makePrefetchAssets)(this.assetRepoAO);
-        (0, UCs_1.makeNewAssetUC)(this.assetRepoAO);
-        // App Assets UCs
-        (0, UCs_1.makeNewAppAssetUC)(this.appAssetsAO);
-        (0, UCs_1.makeGetAppAssetUC)(this.appAssetsAO);
+        (0, UCs_1.makeGetAssetBlobURLUC)(this.appObject);
+        (0, UCs_1.makeGetAssetFileUC)(this.appObject);
+        (0, UCs_1.makeGetAssetUC)(this.appObject);
+        (0, UCs_1.makePrefetchAssets)(this.appObject);
+        (0, UCs_1.makeNewAssetUC)(this.appObject);
     }
     /**
      * Sets up all presentation managers for the Assets system
      */
     setupPMs() {
-        // App Assets PMs
-        (0, PMs_1.makeAppAssetListPM)(this.appAssetsAO);
-        (0, PMs_1.makeShowArchivedAppAssetPM)(this.appAssetsAO);
-        (0, PMs_1.makeEditingAppAssetPM)(this.appAssetsAO);
+        // No PMs needed for core asset functionality
     }
     /**
      * Performs any final setup operations after all components are initialized

package/dist/cjs/Assets/Factories/AssetsFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetsFactory.js","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":";;;AAAA,sCAAsE;AACtE,0CAKqB;AACrB,gCAMgB;AAChB,gCAcgB;AAEhB;;;;GAIG;AACH,MAAa,aAAc,SAAQ,oBAAa;IAS9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QATnB,+BAA+B;QACtB,gBAAW,GAAG,eAAe,CAAC;IASvC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAE7D,sBAAsB;QACtB,IAAI,CAAC,SAAS,GAAG,IAAA,wBAAa,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtD,IAAA,wBAAa,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO,CAAC,EAAU,EAAe,EAAE;YACjC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAE3C,WAAW;YACX,MAAM,MAAM,GAAG,IAAA,0BAAe,EAAC,EAAE,CAAC,CAAC;YAEnC,qBAAqB;YACrB,IAAA,wBAAkB,EAAC,EAAE,CAAC,CAAC;YACvB,IAAA,uBAAiB,EAAC,EAAE,CAAC,CAAC;YACtB,IAAA,6BAAuB,EAAC,EAAE,CAAC,CAAC;YAC5B,IAAA,2BAAqB,EAAC,EAAE,CAAC,CAAC;YAC1B,IAAA,8BAAwB,EAAC,EAAE,CAAC,CAAC;YAE7B,qBAAqB;YACrB,IAAA,iBAAW,EAAC,EAAE,CAAC,CAAC;YAChB,IAAA,qBAAe,EAAC,EAAE,CAAC,CAAC;YAEpB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,iBAAiB;QACjB,IAAA,sBAAgB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,IAAA,2BAAqB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,IAAA,wBAAkB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,IAAA,oBAAc,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,IAAA,wBAAkB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,IAAA,oBAAc,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEjC,iBAAiB;QACjB,IAAA,uBAAiB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,IAAA,uBAAiB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,iBAAiB;QACjB,IAAA,wBAAkB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,IAAA,gCAA0B,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAA,2BAAqB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,0CAA0C;IAC5C,CAAC;CACF;AApFD,sCAoFC","sourcesContent":["import { AppObject, AppObjectRepo, DomainFactory } from \"@vived/core\";\r\nimport {\r\n  AssetEntity,\r\n  makeAppAssets,\r\n  makeAssetEntity,\r\n  makeAssetRepo\r\n} from \"../Entities\";\r\nimport {\r\n  makeAppAssetListPM,\r\n  makeAssetFilePM,\r\n  makeAssetPM,\r\n  makeEditingAppAssetPM,\r\n  makeShowArchivedAppAssetPM\r\n} from \"../PMs\";\r\nimport {\r\n  makeArchiveAssetUC,\r\n  makeDeleteAssetUC,\r\n  makeDownloadAssetFileUC,\r\n  makeEditAppAsset,\r\n  makeGetAppAssetUC,\r\n  makeGetAssetBlobURLUC,\r\n  makeGetAssetFileUC,\r\n  makeGetAssetUC,\r\n  makeNewAppAssetUC,\r\n  makeNewAssetUC,\r\n  makePrefetchAssets,\r\n  makeUpdateAppAssetMetaUC,\r\n  makeUpdateAssetFileUC\r\n} from \"../UCs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Assets domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Assets functionality.\r\n */\r\nexport class AssetsFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AssetsFactory\";\r\n\r\n  // Store references to key AppObjects needed across setup phases\r\n  private assetRepoAO!: AppObject;\r\n  private appAssetsAO!: AppObject;\r\n  private assetRepo: any; // This will hold the asset repository\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Assets system\r\n   */\r\n  setupEntities(): void {\r\n    this.assetRepoAO = this.appObjects.getOrCreate(\"Asset Repository\");\r\n    this.appAssetsAO = this.appObjects.getOrCreate(\"App Assets\");\r\n\r\n    // Initialize entities\r\n    this.assetRepo = makeAssetRepo(this.assetRepoAO);\r\n    this.assetRepo.assetFactory = this.makeAssetFactory();\r\n    makeAppAssets(this.appAssetsAO);\r\n  }\r\n\r\n  /**\r\n   * Creates an asset factory function that properly initializes assets with all required components\r\n   */\r\n  private makeAssetFactory() {\r\n    return (id: string): AssetEntity => {\r\n      const ao = this.appObjects.getOrCreate(id);\r\n\r\n      // Entities\r\n      const entity = makeAssetEntity(ao);\r\n\r\n      // UCs for each asset\r\n      makeArchiveAssetUC(ao);\r\n      makeDeleteAssetUC(ao);\r\n      makeDownloadAssetFileUC(ao);\r\n      makeUpdateAssetFileUC(ao);\r\n      makeUpdateAppAssetMetaUC(ao);\r\n\r\n      // PMs for each asset\r\n      makeAssetPM(ao);\r\n      makeAssetFilePM(ao);\r\n\r\n      return entity;\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Assets system\r\n   */\r\n  setupUCs(): void {\r\n    // Repository UCs\r\n    makeEditAppAsset(this.assetRepoAO);\r\n    makeGetAssetBlobURLUC(this.assetRepoAO);\r\n    makeGetAssetFileUC(this.assetRepoAO);\r\n    makeGetAssetUC(this.assetRepoAO);\r\n    makePrefetchAssets(this.assetRepoAO);\r\n    makeNewAssetUC(this.assetRepoAO);\r\n\r\n    // App Assets UCs\r\n    makeNewAppAssetUC(this.appAssetsAO);\r\n    makeGetAppAssetUC(this.appAssetsAO);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Assets system\r\n   */\r\n  setupPMs(): void {\r\n    // App Assets PMs\r\n    makeAppAssetListPM(this.appAssetsAO);\r\n    makeShowArchivedAppAssetPM(this.appAssetsAO);\r\n    makeEditingAppAssetPM(this.appAssetsAO);\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for assets\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AssetsFactory.js","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":";;;AAAA,sCAAsE;AACtE,0CAIqB;AACrB,gCAGgB;AAChB,gCAUgB;AAEhB;;;;GAIG;AACH,MAAa,aAAc,SAAQ,oBAAa;IAI9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAJnB,+BAA+B;QACtB,gBAAW,GAAG,eAAe,CAAC;IAIvC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAA,wBAAa,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO,CAAC,EAAU,EAAe,EAAE;YACjC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAE3C,WAAW;YACX,MAAM,MAAM,GAAG,IAAA,0BAAe,EAAC,EAAE,CAAC,CAAC;YAEnC,qBAAqB;YACrB,IAAA,wBAAkB,EAAC,EAAE,CAAC,CAAC;YACvB,IAAA,uBAAiB,EAAC,EAAE,CAAC,CAAC;YACtB,IAAA,6BAAuB,EAAC,EAAE,CAAC,CAAC;YAC5B,IAAA,2BAAqB,EAAC,EAAE,CAAC,CAAC;YAE1B,qBAAqB;YACrB,IAAA,iBAAW,EAAC,EAAE,CAAC,CAAC;YAChB,IAAA,qBAAe,EAAC,EAAE,CAAC,CAAC;YAEpB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,iBAAiB;QACjB,IAAA,2BAAqB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,IAAA,wBAAkB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,IAAA,oBAAc,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAA,wBAAkB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,IAAA,oBAAc,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,6CAA6C;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,0CAA0C;IAC5C,CAAC;CACF;AAlED,sCAkEC","sourcesContent":["import { AppObject, AppObjectRepo, DomainFactory } from \"@vived/core\";\r\nimport {\r\n  AssetEntity,\r\n  makeAssetEntity,\r\n  makeAssetRepo\r\n} from \"../Entities\";\r\nimport {\r\n  makeAssetFilePM,\r\n  makeAssetPM\r\n} from \"../PMs\";\r\nimport {\r\n  makeArchiveAssetUC,\r\n  makeDeleteAssetUC,\r\n  makeDownloadAssetFileUC,\r\n  makeGetAssetBlobURLUC,\r\n  makeGetAssetFileUC,\r\n  makeGetAssetUC,\r\n  makeNewAssetUC,\r\n  makePrefetchAssets,\r\n  makeUpdateAssetFileUC\r\n} from \"../UCs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Assets domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Assets functionality.\r\n */\r\nexport class AssetsFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AssetsFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Assets system\r\n   */\r\n  setupEntities(): void {\r\n    // Initialize entities\r\n    const assetRepo = makeAssetRepo(this.appObject);\r\n    assetRepo.assetFactory = this.makeAssetFactory();\r\n  }\r\n\r\n  /**\r\n   * Creates an asset factory function that properly initializes assets with all required components\r\n   */\r\n  private makeAssetFactory() {\r\n    return (id: string): AssetEntity => {\r\n      const ao = this.appObjects.getOrCreate(id);\r\n\r\n      // Entities\r\n      const entity = makeAssetEntity(ao);\r\n\r\n      // UCs for each asset\r\n      makeArchiveAssetUC(ao);\r\n      makeDeleteAssetUC(ao);\r\n      makeDownloadAssetFileUC(ao);\r\n      makeUpdateAssetFileUC(ao);\r\n\r\n      // PMs for each asset\r\n      makeAssetPM(ao);\r\n      makeAssetFilePM(ao);\r\n\r\n      return entity;\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Assets system\r\n   */\r\n  setupUCs(): void {\r\n    // Repository UCs\r\n    makeGetAssetBlobURLUC(this.appObject);\r\n    makeGetAssetFileUC(this.appObject);\r\n    makeGetAssetUC(this.appObject);\r\n    makePrefetchAssets(this.appObject);\r\n    makeNewAssetUC(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Assets system\r\n   */\r\n  setupPMs(): void {\r\n    // No PMs needed for core asset functionality\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for assets\r\n  }\r\n}\r\n"]}

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

@@ -107,9 +107,10 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
          * population of higher-level caches for future access optimization.
          *
          * @param assetID - The unique identifier of the asset
+         * @param useCache - Optional flag to control caching behavior (defaults to true)
          * @returns Promise resolving to a blob URL for the asset file
          */
-        this.getAssetBlobURL = (assetID) => {
+        this.getAssetBlobURL = (assetID, useCache = true) => {
             const assetRepo = this.assetRepo;
             const getAsset = this.getAsset;
             const fetchAssetFile = this.fetchAssetFile;
@@ -118,6 +119,12 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             if (!assetRepo || !getAsset || !fetchAssetFile) {
                 return Promise.reject();
             }
+            // If cache is disabled, skip all cache checks and go directly to API
+            if (!useCache) {
+                return new Promise((resolve, reject) => {
+                    this.fetchAssetNormally(assetID, resolve, reject);
+                });
+            }
             // Level 1: Check memory cache (existing entities with blob URLs)
             const existing = assetRepo.get(assetID);
             if (existing && existing.blobURL) {

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":["/**\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"]}
+{"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   * @param useCache - Optional flag to control caching behavior (defaults to true)\r\n   * @returns Promise resolving to a blob URL for immediate use\r\n   */\r\n  abstract getAssetBlobURL(\r\n    assetID: string,\r\n    useCache?: boolean\r\n  ): 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   * @param useCache - Optional flag to control caching behavior (defaults to true)\r\n   * @returns Promise resolving to a blob URL for the asset file\r\n   */\r\n  getAssetBlobURL = (\r\n    assetID: string,\r\n    useCache: boolean = true\r\n  ): 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    // If cache is disabled, skip all cache checks and go directly to API\r\n    if (!useCache) {\r\n      return new Promise((resolve, reject) => {\r\n        this.fetchAssetNormally(assetID, resolve, reject);\r\n      });\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/Cache/Factories/CacheFeatureFactory.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheFeatureFactory = void 0;
+const core_1 = require("@vived/core");
+const Entities_1 = require("../Entities");
+const UCs_1 = require("../UCs");
+/**
+ * Factory responsible for setting up the Cache domain components.
+ * This factory initializes all entities, use cases, and presentation models
+ * required for the Cache functionality.
+ */
+class CacheFeatureFactory extends core_1.DomainFactory {
+    constructor(appObject) {
+        super(appObject);
+        // Unique name for this factory
+        this.factoryName = "CacheFeatureFactory";
+    }
+    /**
+     * Sets up all entities required for the Cache system
+     */
+    setupEntities() {
+        // Initialize entities
+        (0, Entities_1.makeCacheEntity)(this.appObject);
+        (0, Entities_1.makeScriptCacheEntity)(this.appObject);
+        (0, Entities_1.makeAssetCacheEntity)(this.appObject);
+    }
+    /**
+     * Sets up all use cases for the Cache system
+     */
+    setupUCs() {
+        // Cache use cases
+        (0, UCs_1.makeGetScriptFromCacheUC)(this.appObject);
+        (0, UCs_1.makeStoreScriptInCacheUC)(this.appObject);
+        (0, UCs_1.makeGetAssetFromCacheUC)(this.appObject);
+        (0, UCs_1.makeStoreAssetInCacheUC)(this.appObject);
+    }
+    /**
+     * Sets up all presentation managers for the Cache system
+     */
+    setupPMs() {
+        // No presentation managers exist for the Cache system
+    }
+    /**
+     * Performs any final setup operations after all components are initialized
+     */
+    finalSetup() {
+        // No additional setup required for cache
+    }
+}
+exports.CacheFeatureFactory = CacheFeatureFactory;
+//# sourceMappingURL=CacheFeatureFactory.js.map

package/dist/cjs/Cache/Factories/CacheFeatureFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFeatureFactory.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/CacheFeatureFactory.ts"],"names":[],"mappings":";;;AAAA,sCAAuD;AACvD,0CAIqB;AACrB,gCAKgB;AAEhB;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,oBAAa;IAIpD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAJnB,+BAA+B;QACtB,gBAAW,GAAG,qBAAqB,CAAC;IAI7C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,sBAAsB;QACtB,IAAA,0BAAe,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,IAAA,gCAAqB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,IAAA,+BAAoB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,kBAAkB;QAClB,IAAA,8BAAwB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAA,8BAAwB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAA,6BAAuB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAA,6BAAuB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,sDAAsD;IACxD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,yCAAyC;IAC3C,CAAC;CACF;AA1CD,kDA0CC","sourcesContent":["import { AppObject, DomainFactory } from \"@vived/core\";\r\nimport {\r\n  makeCacheEntity,\r\n  makeAssetCacheEntity,\r\n  makeScriptCacheEntity\r\n} from \"../Entities\";\r\nimport {\r\n  makeGetAssetFromCacheUC,\r\n  makeGetScriptFromCacheUC,\r\n  makeStoreAssetInCacheUC,\r\n  makeStoreScriptInCacheUC\r\n} from \"../UCs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Cache domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Cache functionality.\r\n */\r\nexport class CacheFeatureFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"CacheFeatureFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Cache system\r\n   */\r\n  setupEntities(): void {\r\n    // Initialize entities\r\n    makeCacheEntity(this.appObject);\r\n    makeScriptCacheEntity(this.appObject);\r\n    makeAssetCacheEntity(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Cache system\r\n   */\r\n  setupUCs(): void {\r\n    // Cache use cases\r\n    makeGetScriptFromCacheUC(this.appObject);\r\n    makeStoreScriptInCacheUC(this.appObject);\r\n    makeGetAssetFromCacheUC(this.appObject);\r\n    makeStoreAssetInCacheUC(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Cache system\r\n   */\r\n  setupPMs(): void {\r\n    // No presentation managers exist for the Cache system\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for cache\r\n  }\r\n}\r\n"]}

package/dist/cjs/Cache/Factories/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./setupCache"), exports);
+__exportStar(require("./CacheFeatureFactory"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/Cache/Factories/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B","sourcesContent":["export * from \"./setupCache\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,wDAAsC","sourcesContent":["export * from \"./setupCache\";\r\nexport * from \"./CacheFeatureFactory\";\r\n"]}

package/dist/esm/Apps/Factories/AppsFeatureFactory.js

@@ -16,9 +16,8 @@ export class AppsFeatureFactory extends DomainFactory {
      * Sets up all entities required for the Apps system
      */
     setupEntities() {
-        this.appRepoAO = this.appObjects.getOrCreate("App Repository");
         // Initialize entities
-        makeAppRepo(this.appRepoAO);
+        makeAppRepo(this.appObject);
     }
     /**
      * Sets up all use cases for the Apps system
@@ -32,7 +31,7 @@ export class AppsFeatureFactory extends DomainFactory {
      */
     setupPMs() {
         // App Repository PMs
-        makeAppsListPM(this.appRepoAO);
+        makeAppsListPM(this.appObject);
     }
     /**
      * Performs any final setup operations after all components are initialized

package/dist/esm/Apps/Factories/AppsFeatureFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppsFeatureFactory.js","sourceRoot":"","sources":["../../../../src/Apps/Factories/AppsFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAa,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAOnD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAPnB,+BAA+B;QACtB,gBAAW,GAAG,oBAAoB,CAAC;IAO5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QAE/D,sBAAsB;QACtB,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,+DAA+D;QAC/D,0EAA0E;IAC5E,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,qBAAqB;QACrB,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,wCAAwC;IAC1C,CAAC;CACF","sourcesContent":["import { AppObject, DomainFactory } from \"@vived/core\";\r\nimport { makeAppEntity, makeAppRepo } from \"../Entities\";\r\nimport { makeAppPM, makeAppsListPM } from \"../PMs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Apps domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Apps functionality.\r\n */\r\nexport class AppsFeatureFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AppsFeatureFactory\";\r\n\r\n  // Store references to key AppObjects needed across setup phases\r\n  private appRepoAO!: AppObject;\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Apps system\r\n   */\r\n  setupEntities(): void {\r\n    this.appRepoAO = this.appObjects.getOrCreate(\"App Repository\");\r\n\r\n    // Initialize entities\r\n    makeAppRepo(this.appRepoAO);\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Apps system\r\n   */\r\n  setupUCs(): void {\r\n    // Note: App UCs have complex dependencies and should be set up\r\n    // separately to avoid circular dependencies during factory initialization\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Apps system\r\n   */\r\n  setupPMs(): void {\r\n    // App Repository PMs\r\n    makeAppsListPM(this.appRepoAO);\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for apps\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppsFeatureFactory.js","sourceRoot":"","sources":["../../../../src/Apps/Factories/AppsFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAa,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAInD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAJnB,+BAA+B;QACtB,gBAAW,GAAG,oBAAoB,CAAC;IAI5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,sBAAsB;QACtB,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,+DAA+D;QAC/D,0EAA0E;IAC5E,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,qBAAqB;QACrB,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,wCAAwC;IAC1C,CAAC;CACF","sourcesContent":["import { AppObject, DomainFactory } from \"@vived/core\";\r\nimport { makeAppEntity, makeAppRepo } from \"../Entities\";\r\nimport { makeAppPM, makeAppsListPM } from \"../PMs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Apps domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Apps functionality.\r\n */\r\nexport class AppsFeatureFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AppsFeatureFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Apps system\r\n   */\r\n  setupEntities(): void {\r\n    // Initialize entities\r\n    makeAppRepo(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Apps system\r\n   */\r\n  setupUCs(): void {\r\n    // Note: App UCs have complex dependencies and should be set up\r\n    // separately to avoid circular dependencies during factory initialization\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Apps system\r\n   */\r\n  setupPMs(): void {\r\n    // App Repository PMs\r\n    makeAppsListPM(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for apps\r\n  }\r\n}\r\n"]}

package/dist/esm/Assets/Controllers/fetchAssetFile.js

@@ -0,0 +1,39 @@
+/**
+ * fetchAssetFile.ts
+ *
+ * This controller function retrieves an asset file as a File object,
+ * handling caching and error management for file access operations.
+ *
+ * Key Concepts:
+ * - Retrieves asset files as File objects for download or processing
+ * - Uses GetAssetFileUC to handle caching and file retrieval logic
+ * - Provides error handling for missing components
+ * - Coordinates with asset file management workflows
+ *
+ * Usage Patterns:
+ * - Called from UI components when users need asset file access
+ * - Used in asset management workflows for file processing
+ * - Integrated with download and preview functionality
+ */
+import { GetAssetFileUC } from "../UCs/GetAssetFileUC";
+/**
+ * Retrieves an asset file as a File object.
+ *
+ * This function provides a controller-level interface for asset file retrieval.
+ * It handles the complete file access workflow including caching optimization,
+ * error handling, and returns a File object ready for use in web applications.
+ *
+ * @param assetID - The unique identifier of the asset whose file should be retrieved
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns Promise<File> - A promise that resolves to the File object for the asset,
+ *                         or undefined if the operation cannot be completed
+ */
+export function fetchAssetFile(assetID, appObjects) {
+    const uc = GetAssetFileUC.get(appObjects);
+    if (!uc) {
+        appObjects.submitWarning("fetchAssetFile", "Unable to find GetAssetFileUC");
+        return;
+    }
+    return uc.getAssetFile(assetID);
+}
+//# sourceMappingURL=fetchAssetFile.js.map

package/dist/esm/Assets/Controllers/fetchAssetFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAssetFile.js","sourceRoot":"","sources":["../../../../src/Assets/Controllers/fetchAssetFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,UAAyB;IAEzB,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,UAAU,CAAC,aAAa,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC","sourcesContent":["/**\r\n * fetchAssetFile.ts\r\n *\r\n * This controller function retrieves an asset file as a File object,\r\n * handling caching and error management for file access operations.\r\n *\r\n * Key Concepts:\r\n * - Retrieves asset files as File objects for download or processing\r\n * - Uses GetAssetFileUC to handle caching and file retrieval logic\r\n * - Provides error handling for missing components\r\n * - Coordinates with asset file management workflows\r\n *\r\n * Usage Patterns:\r\n * - Called from UI components when users need asset file access\r\n * - Used in asset management workflows for file processing\r\n * - Integrated with download and preview functionality\r\n */\r\n\r\nimport { AppObjectRepo } from \"@vived/core\";\r\nimport { GetAssetFileUC } from \"../UCs/GetAssetFileUC\";\r\n\r\n/**\r\n * Retrieves an asset file as a File object.\r\n *\r\n * This function provides a controller-level interface for asset file retrieval.\r\n * It handles the complete file access workflow including caching optimization,\r\n * error handling, and returns a File object ready for use in web applications.\r\n *\r\n * @param assetID - The unique identifier of the asset whose file should be retrieved\r\n * @param appObjects - Repository for accessing asset-related app objects and components\r\n * @returns Promise<File> - A promise that resolves to the File object for the asset,\r\n *                         or undefined if the operation cannot be completed\r\n */\r\nexport function fetchAssetFile(\r\n  assetID: string,\r\n  appObjects: AppObjectRepo\r\n): Promise<File> | undefined {\r\n  const uc = GetAssetFileUC.get(appObjects);\r\n  if (!uc) {\r\n    appObjects.submitWarning(\"fetchAssetFile\", \"Unable to find GetAssetFileUC\");\r\n    return;\r\n  }\r\n\r\n  return uc.getAssetFile(assetID);\r\n}\r\n"]}

package/dist/esm/Assets/Controllers/index.js

@@ -21,6 +21,7 @@ export * from "./archiveAsset";
 export * from "./deleteAsset";
 export * from "./downloadAssetFile";
 export * from "./editAppAsset";
+export * from "./fetchAssetFile";
 export * from "./getAppAssets";
 export * from "./newAppAsset";
 export * from "./toggleShowArchivedAssets";

package/dist/esm/Assets/Controllers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC","sourcesContent":["/**\r\n * Assets Controllers Index\r\n *\r\n * This module exports all controller functions for the Assets feature.\r\n * Controllers provide simple, stateless functions that serve as entry points\r\n * for asset-related operations from UI components and external systems.\r\n *\r\n * Key Concepts:\r\n * - Controllers act as the interface layer between UI components and business logic\r\n * - Each controller function handles a specific asset operation\r\n * - Controllers delegate to Use Cases (UCs) for actual business logic implementation\r\n * - Error handling and validation are performed at the controller level\r\n *\r\n * Available Operations:\r\n * - Asset lifecycle: create, edit, delete, archive\r\n * - File management: upload, download, update\r\n * - Collection management: get app assets, toggle archived visibility\r\n * - Metadata management: update asset information\r\n */\r\n\r\nexport * from \"./archiveAsset\";\r\nexport * from \"./deleteAsset\";\r\nexport * from \"./downloadAssetFile\";\r\nexport * from \"./editAppAsset\";\r\nexport * from \"./getAppAssets\";\r\nexport * from \"./newAppAsset\";\r\nexport * from \"./toggleShowArchivedAssets\";\r\nexport * from \"./updateAppAssetMeta\";\r\nexport * from \"./updateAssetFile\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC","sourcesContent":["/**\r\n * Assets Controllers Index\r\n *\r\n * This module exports all controller functions for the Assets feature.\r\n * Controllers provide simple, stateless functions that serve as entry points\r\n * for asset-related operations from UI components and external systems.\r\n *\r\n * Key Concepts:\r\n * - Controllers act as the interface layer between UI components and business logic\r\n * - Each controller function handles a specific asset operation\r\n * - Controllers delegate to Use Cases (UCs) for actual business logic implementation\r\n * - Error handling and validation are performed at the controller level\r\n *\r\n * Available Operations:\r\n * - Asset lifecycle: create, edit, delete, archive\r\n * - File management: upload, download, update\r\n * - Collection management: get app assets, toggle archived visibility\r\n * - Metadata management: update asset information\r\n */\r\n\r\nexport * from \"./archiveAsset\";\r\nexport * from \"./deleteAsset\";\r\nexport * from \"./downloadAssetFile\";\r\nexport * from \"./editAppAsset\";\r\nexport * from \"./fetchAssetFile\";\r\nexport * from \"./getAppAssets\";\r\nexport * from \"./newAppAsset\";\r\nexport * from \"./toggleShowArchivedAssets\";\r\nexport * from \"./updateAppAssetMeta\";\r\nexport * from \"./updateAssetFile\";\r\n"]}

package/dist/esm/Assets/Factories/AssetsFactory.js

@@ -1,7 +1,7 @@
 import { DomainFactory } from "@vived/core";
-import { makeAppAssets, makeAssetEntity, makeAssetRepo } from "../Entities";
-import { makeAppAssetListPM, makeAssetFilePM, makeAssetPM, makeEditingAppAssetPM, makeShowArchivedAppAssetPM } from "../PMs";
-import { makeArchiveAssetUC, makeDeleteAssetUC, makeDownloadAssetFileUC, makeEditAppAsset, makeGetAppAssetUC, makeGetAssetBlobURLUC, makeGetAssetFileUC, makeGetAssetUC, makeNewAppAssetUC, makeNewAssetUC, makePrefetchAssets, makeUpdateAppAssetMetaUC, makeUpdateAssetFileUC } from "../UCs";
+import { makeAssetEntity, makeAssetRepo } from "../Entities";
+import { makeAssetFilePM, makeAssetPM } from "../PMs";
+import { makeArchiveAssetUC, makeDeleteAssetUC, makeDownloadAssetFileUC, makeGetAssetBlobURLUC, makeGetAssetFileUC, makeGetAssetUC, makeNewAssetUC, makePrefetchAssets, makeUpdateAssetFileUC } from "../UCs";
 /**
  * Factory responsible for setting up the Assets domain components.
  * This factory initializes all entities, use cases, and presentation models
@@ -17,12 +17,9 @@ export class AssetsFactory extends DomainFactory {
      * Sets up all entities required for the Assets system
      */
     setupEntities() {
-        this.assetRepoAO = this.appObjects.getOrCreate("Asset Repository");
-        this.appAssetsAO = this.appObjects.getOrCreate("App Assets");
         // Initialize entities
-        this.assetRepo = makeAssetRepo(this.assetRepoAO);
-        this.assetRepo.assetFactory = this.makeAssetFactory();
-        makeAppAssets(this.appAssetsAO);
+        const assetRepo = makeAssetRepo(this.appObject);
+        assetRepo.assetFactory = this.makeAssetFactory();
     }
     /**
      * Creates an asset factory function that properly initializes assets with all required components
@@ -37,7 +34,6 @@ export class AssetsFactory extends DomainFactory {
             makeDeleteAssetUC(ao);
             makeDownloadAssetFileUC(ao);
             makeUpdateAssetFileUC(ao);
-            makeUpdateAppAssetMetaUC(ao);
             // PMs for each asset
             makeAssetPM(ao);
             makeAssetFilePM(ao);
@@ -49,24 +45,17 @@ export class AssetsFactory extends DomainFactory {
      */
     setupUCs() {
         // Repository UCs
-        makeEditAppAsset(this.assetRepoAO);
-        makeGetAssetBlobURLUC(this.assetRepoAO);
-        makeGetAssetFileUC(this.assetRepoAO);
-        makeGetAssetUC(this.assetRepoAO);
-        makePrefetchAssets(this.assetRepoAO);
-        makeNewAssetUC(this.assetRepoAO);
-        // App Assets UCs
-        makeNewAppAssetUC(this.appAssetsAO);
-        makeGetAppAssetUC(this.appAssetsAO);
+        makeGetAssetBlobURLUC(this.appObject);
+        makeGetAssetFileUC(this.appObject);
+        makeGetAssetUC(this.appObject);
+        makePrefetchAssets(this.appObject);
+        makeNewAssetUC(this.appObject);
     }
     /**
      * Sets up all presentation managers for the Assets system
      */
     setupPMs() {
-        // App Assets PMs
-        makeAppAssetListPM(this.appAssetsAO);
-        makeShowArchivedAppAssetPM(this.appAssetsAO);
-        makeEditingAppAssetPM(this.appAssetsAO);
+        // No PMs needed for core asset functionality
     }
     /**
      * Performs any final setup operations after all components are initialized

package/dist/esm/Assets/Factories/AssetsFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetsFactory.js","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,aAAa,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAEL,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,QAAQ,CAAC;AAEhB;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAS9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QATnB,+BAA+B;QACtB,gBAAW,GAAG,eAAe,CAAC;IASvC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAE7D,sBAAsB;QACtB,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtD,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO,CAAC,EAAU,EAAe,EAAE;YACjC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAE3C,WAAW;YACX,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;YAEnC,qBAAqB;YACrB,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACvB,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACtB,uBAAuB,CAAC,EAAE,CAAC,CAAC;YAC5B,qBAAqB,CAAC,EAAE,CAAC,CAAC;YAC1B,wBAAwB,CAAC,EAAE,CAAC,CAAC;YAE7B,qBAAqB;YACrB,WAAW,CAAC,EAAE,CAAC,CAAC;YAChB,eAAe,CAAC,EAAE,CAAC,CAAC;YAEpB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,iBAAiB;QACjB,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEjC,iBAAiB;QACjB,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,iBAAiB;QACjB,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,0BAA0B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7C,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,0CAA0C;IAC5C,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectRepo, DomainFactory } from \"@vived/core\";\r\nimport {\r\n  AssetEntity,\r\n  makeAppAssets,\r\n  makeAssetEntity,\r\n  makeAssetRepo\r\n} from \"../Entities\";\r\nimport {\r\n  makeAppAssetListPM,\r\n  makeAssetFilePM,\r\n  makeAssetPM,\r\n  makeEditingAppAssetPM,\r\n  makeShowArchivedAppAssetPM\r\n} from \"../PMs\";\r\nimport {\r\n  makeArchiveAssetUC,\r\n  makeDeleteAssetUC,\r\n  makeDownloadAssetFileUC,\r\n  makeEditAppAsset,\r\n  makeGetAppAssetUC,\r\n  makeGetAssetBlobURLUC,\r\n  makeGetAssetFileUC,\r\n  makeGetAssetUC,\r\n  makeNewAppAssetUC,\r\n  makeNewAssetUC,\r\n  makePrefetchAssets,\r\n  makeUpdateAppAssetMetaUC,\r\n  makeUpdateAssetFileUC\r\n} from \"../UCs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Assets domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Assets functionality.\r\n */\r\nexport class AssetsFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AssetsFactory\";\r\n\r\n  // Store references to key AppObjects needed across setup phases\r\n  private assetRepoAO!: AppObject;\r\n  private appAssetsAO!: AppObject;\r\n  private assetRepo: any; // This will hold the asset repository\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Assets system\r\n   */\r\n  setupEntities(): void {\r\n    this.assetRepoAO = this.appObjects.getOrCreate(\"Asset Repository\");\r\n    this.appAssetsAO = this.appObjects.getOrCreate(\"App Assets\");\r\n\r\n    // Initialize entities\r\n    this.assetRepo = makeAssetRepo(this.assetRepoAO);\r\n    this.assetRepo.assetFactory = this.makeAssetFactory();\r\n    makeAppAssets(this.appAssetsAO);\r\n  }\r\n\r\n  /**\r\n   * Creates an asset factory function that properly initializes assets with all required components\r\n   */\r\n  private makeAssetFactory() {\r\n    return (id: string): AssetEntity => {\r\n      const ao = this.appObjects.getOrCreate(id);\r\n\r\n      // Entities\r\n      const entity = makeAssetEntity(ao);\r\n\r\n      // UCs for each asset\r\n      makeArchiveAssetUC(ao);\r\n      makeDeleteAssetUC(ao);\r\n      makeDownloadAssetFileUC(ao);\r\n      makeUpdateAssetFileUC(ao);\r\n      makeUpdateAppAssetMetaUC(ao);\r\n\r\n      // PMs for each asset\r\n      makeAssetPM(ao);\r\n      makeAssetFilePM(ao);\r\n\r\n      return entity;\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Assets system\r\n   */\r\n  setupUCs(): void {\r\n    // Repository UCs\r\n    makeEditAppAsset(this.assetRepoAO);\r\n    makeGetAssetBlobURLUC(this.assetRepoAO);\r\n    makeGetAssetFileUC(this.assetRepoAO);\r\n    makeGetAssetUC(this.assetRepoAO);\r\n    makePrefetchAssets(this.assetRepoAO);\r\n    makeNewAssetUC(this.assetRepoAO);\r\n\r\n    // App Assets UCs\r\n    makeNewAppAssetUC(this.appAssetsAO);\r\n    makeGetAppAssetUC(this.appAssetsAO);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Assets system\r\n   */\r\n  setupPMs(): void {\r\n    // App Assets PMs\r\n    makeAppAssetListPM(this.appAssetsAO);\r\n    makeShowArchivedAppAssetPM(this.appAssetsAO);\r\n    makeEditingAppAssetPM(this.appAssetsAO);\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for assets\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AssetsFactory.js","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,aAAa,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAEL,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,WAAW,EACZ,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,QAAQ,CAAC;AAEhB;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAI9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAJnB,+BAA+B;QACtB,gBAAW,GAAG,eAAe,CAAC;IAIvC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,sBAAsB;QACtB,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO,CAAC,EAAU,EAAe,EAAE;YACjC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAE3C,WAAW;YACX,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;YAEnC,qBAAqB;YACrB,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACvB,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACtB,uBAAuB,CAAC,EAAE,CAAC,CAAC;YAC5B,qBAAqB,CAAC,EAAE,CAAC,CAAC;YAE1B,qBAAqB;YACrB,WAAW,CAAC,EAAE,CAAC,CAAC;YAChB,eAAe,CAAC,EAAE,CAAC,CAAC;YAEpB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,iBAAiB;QACjB,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,6CAA6C;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,0CAA0C;IAC5C,CAAC;CACF","sourcesContent":["import { AppObject, AppObjectRepo, DomainFactory } from \"@vived/core\";\r\nimport {\r\n  AssetEntity,\r\n  makeAssetEntity,\r\n  makeAssetRepo\r\n} from \"../Entities\";\r\nimport {\r\n  makeAssetFilePM,\r\n  makeAssetPM\r\n} from \"../PMs\";\r\nimport {\r\n  makeArchiveAssetUC,\r\n  makeDeleteAssetUC,\r\n  makeDownloadAssetFileUC,\r\n  makeGetAssetBlobURLUC,\r\n  makeGetAssetFileUC,\r\n  makeGetAssetUC,\r\n  makeNewAssetUC,\r\n  makePrefetchAssets,\r\n  makeUpdateAssetFileUC\r\n} from \"../UCs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Assets domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Assets functionality.\r\n */\r\nexport class AssetsFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"AssetsFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Assets system\r\n   */\r\n  setupEntities(): void {\r\n    // Initialize entities\r\n    const assetRepo = makeAssetRepo(this.appObject);\r\n    assetRepo.assetFactory = this.makeAssetFactory();\r\n  }\r\n\r\n  /**\r\n   * Creates an asset factory function that properly initializes assets with all required components\r\n   */\r\n  private makeAssetFactory() {\r\n    return (id: string): AssetEntity => {\r\n      const ao = this.appObjects.getOrCreate(id);\r\n\r\n      // Entities\r\n      const entity = makeAssetEntity(ao);\r\n\r\n      // UCs for each asset\r\n      makeArchiveAssetUC(ao);\r\n      makeDeleteAssetUC(ao);\r\n      makeDownloadAssetFileUC(ao);\r\n      makeUpdateAssetFileUC(ao);\r\n\r\n      // PMs for each asset\r\n      makeAssetPM(ao);\r\n      makeAssetFilePM(ao);\r\n\r\n      return entity;\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Assets system\r\n   */\r\n  setupUCs(): void {\r\n    // Repository UCs\r\n    makeGetAssetBlobURLUC(this.appObject);\r\n    makeGetAssetFileUC(this.appObject);\r\n    makeGetAssetUC(this.appObject);\r\n    makePrefetchAssets(this.appObject);\r\n    makeNewAssetUC(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Assets system\r\n   */\r\n  setupPMs(): void {\r\n    // No PMs needed for core asset functionality\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for assets\r\n  }\r\n}\r\n"]}

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

@@ -102,9 +102,10 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
          * population of higher-level caches for future access optimization.
          *
          * @param assetID - The unique identifier of the asset
+         * @param useCache - Optional flag to control caching behavior (defaults to true)
          * @returns Promise resolving to a blob URL for the asset file
          */
-        this.getAssetBlobURL = (assetID) => {
+        this.getAssetBlobURL = (assetID, useCache = true) => {
             const assetRepo = this.assetRepo;
             const getAsset = this.getAsset;
             const fetchAssetFile = this.fetchAssetFile;
@@ -113,6 +114,12 @@ class GetAssetBlobURLUCImp extends GetAssetBlobURLUC {
             if (!assetRepo || !getAsset || !fetchAssetFile) {
                 return Promise.reject();
             }
+            // If cache is disabled, skip all cache checks and go directly to API
+            if (!useCache) {
+                return new Promise((resolve, reject) => {
+                    this.fetchAssetNormally(assetID, resolve, reject);
+                });
+            }
             // Level 1: Check memory cache (existing entities with blob URLs)
             const existing = assetRepo.get(assetID);
             if (existing && existing.blobURL) {

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

@@ -1 +1 @@
-{"version":3,"file":"GetAssetBlobURLUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,WAAW;IAYzD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,iBAAiB,CAAC,IAAI,EACtB,UAAU,CACX,CAAC;IACJ,CAAC;;AAtBD,wDAAwD;AACjD,sBAAI,GAAG,mBAAmB,CAAC;AAwBpC;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,oBAAqB,SAAQ,iBAAiB;IAClD,iEAAiE;IACjE,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,yEAAyE;IACzE,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,uBAAuB,CAAC,IAAI,CAC7B,EAAE,OAAO,CAAC;IACb,CAAC;IAED,sDAAsD;IACtD,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAa,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACxE,CAAC;IAED,oEAAoE;IACpE,IAAY,iBAAiB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,CAC5B,mBAAmB,CAAC,IAAI,CACzB,EAAE,QAAQ,CAAC;IACd,CAAC;IAED,+DAA+D;IAC/D,IAAY,iBAAiB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,CAC5B,mBAAmB,CAAC,IAAI,CACzB,EAAE,UAAU,CAAC;IAChB,CAAC;IAoKD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAxK3C;;;;;;;;;;;;;WAaG;QACH,oBAAe,GAAG,CAAC,OAAe,EAAmB,EAAE;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAEjD,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC/C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,iEAAiE;YACjE,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,IAAI,YAAqC,CAAC;gBAE1C,kCAAkC;gBAClC,IAAI,iBAAiB,EAAE,CAAC;oBACtB,iBAAiB,CAAC,OAAO,CAAC;yBACvB,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;wBACnB,IAAI,UAAU,EAAE,CAAC;4BACf,qDAAqD;4BACrD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gCACtC,YAAY,GAAG,KAAK,CAAC;gCACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,cAAc,CAAC;gCAClD,OAAO,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE;oCACtC,IAAI,EAAE,UAAU,CAAC,IAAI;iCACtB,CAAC,CAAC;4BACL,CAAC,CAAC,CAAC;wBACL,CAAC;6BAAM,CAAC;4BACN,iCAAiC;4BACjC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gCACtC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;gCAC5B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;gCAC7B,YAAY,GAAG,KAAK,CAAC;gCACrB,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;4BAC/B,CAAC,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC,CAAC;yBACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;wBACb,IAAI,YAAY,EAAE,CAAC;4BACjB,oCAAoC;4BACpC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;4BAC3B,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC;4BAEpC,+DAA+D;4BAC/D,IAAI,iBAAiB,EAAE,CAAC;gCACtB,iBAAiB,CACf,OAAO,EACP,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EACrC,IAAI,CAAC,IAAI,CACV,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oCACZ,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gCACnD,CAAC,CAAC,CAAC;4BACL,CAAC;4BAED,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gCACzB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gCAC9B,OAAO;4BACT,CAAC;wBACH,CAAC;wBACD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;oBACzC,CAAC,CAAC;yBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;wBAClB,uCAAuC;wBACvC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;wBACtD,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;oBACpD,CAAC,CAAC,CAAC;gBACP,CAAC;qBAAM,CAAC;oBACN,4CAA4C;oBAC5C,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF;;;;;;;;;;WAUG;QACK,uBAAkB,GAAG,CAC3B,OAAe,EACf,OAAkC,EAClC,MAA8B,EACxB,EAAE;YACR,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAEjD,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;gBACrD,OAAO;YACT,CAAC;YAED,IAAI,YAAqC,CAAC;YAE1C,QAAQ,CAAC,OAAO,CAAC;iBACd,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,oCAAoC;gBACpC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;gBAC5B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC7B,YAAY,GAAG,KAAK,CAAC;gBACrB,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBACb,IAAI,YAAY,EAAE,CAAC;oBACjB,oCAAoC;oBACpC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3B,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC;oBAEpC,wDAAwD;oBACxD,IAAI,iBAAiB,EAAE,CAAC;wBACtB,iBAAiB,CACf,OAAO,EACP,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EACrC,IAAI,CAAC,IAAI,CACV,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;4BACZ,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;wBACnD,CAAC,CAAC,CAAC;oBACL,CAAC;oBAED,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;wBACzB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;wBAC9B,OAAO;oBACT,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;gBAClB,gDAAgD;gBAChD,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC;oBAC5B,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC;gBACtC,CAAC;gBACD,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QASA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","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"]}
+{"version":3,"file":"GetAssetBlobURLUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,WAAW;IAgBzD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,iBAAiB,CAAC,IAAI,EACtB,UAAU,CACX,CAAC;IACJ,CAAC;;AA1BD,wDAAwD;AACjD,sBAAI,GAAG,mBAAmB,CAAC;AA4BpC;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,oBAAqB,SAAQ,iBAAiB;IAClD,iEAAiE;IACjE,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,yEAAyE;IACzE,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,uBAAuB,CAAC,IAAI,CAC7B,EAAE,OAAO,CAAC;IACb,CAAC;IAED,sDAAsD;IACtD,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAa,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACxE,CAAC;IAED,oEAAoE;IACpE,IAAY,iBAAiB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,CAC5B,mBAAmB,CAAC,IAAI,CACzB,EAAE,QAAQ,CAAC;IACd,CAAC;IAED,+DAA+D;IAC/D,IAAY,iBAAiB;QAC3B,OAAO,IAAI,CAAC,kBAAkB,CAC5B,mBAAmB,CAAC,IAAI,CACzB,EAAE,UAAU,CAAC;IAChB,CAAC;IA+KD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAnL3C;;;;;;;;;;;;;;WAcG;QACH,oBAAe,GAAG,CAChB,OAAe,EACf,WAAoB,IAAI,EACP,EAAE;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAEjD,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC/C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,qEAAqE;YACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBACrC,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBACpD,CAAC,CAAC,CAAC;YACL,CAAC;YAED,iEAAiE;YACjE,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,IAAI,YAAqC,CAAC;gBAE1C,kCAAkC;gBAClC,IAAI,iBAAiB,EAAE,CAAC;oBACtB,iBAAiB,CAAC,OAAO,CAAC;yBACvB,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;wBACnB,IAAI,UAAU,EAAE,CAAC;4BACf,qDAAqD;4BACrD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gCACtC,YAAY,GAAG,KAAK,CAAC;gCACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,cAAc,CAAC;gCAClD,OAAO,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE;oCACtC,IAAI,EAAE,UAAU,CAAC,IAAI;iCACtB,CAAC,CAAC;4BACL,CAAC,CAAC,CAAC;wBACL,CAAC;6BAAM,CAAC;4BACN,iCAAiC;4BACjC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gCACtC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;gCAC5B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;gCAC7B,YAAY,GAAG,KAAK,CAAC;gCACrB,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;4BAC/B,CAAC,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC,CAAC;yBACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;wBACb,IAAI,YAAY,EAAE,CAAC;4BACjB,oCAAoC;4BACpC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;4BAC3B,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC;4BAEpC,+DAA+D;4BAC/D,IAAI,iBAAiB,EAAE,CAAC;gCACtB,iBAAiB,CACf,OAAO,EACP,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EACrC,IAAI,CAAC,IAAI,CACV,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oCACZ,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gCACnD,CAAC,CAAC,CAAC;4BACL,CAAC;4BAED,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gCACzB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gCAC9B,OAAO;4BACT,CAAC;wBACH,CAAC;wBACD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;oBACzC,CAAC,CAAC;yBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;wBAClB,uCAAuC;wBACvC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;wBACtD,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;oBACpD,CAAC,CAAC,CAAC;gBACP,CAAC;qBAAM,CAAC;oBACN,4CAA4C;oBAC5C,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF;;;;;;;;;;WAUG;QACK,uBAAkB,GAAG,CAC3B,OAAe,EACf,OAAkC,EAClC,MAA8B,EACxB,EAAE;YACR,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAEjD,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;gBACrD,OAAO;YACT,CAAC;YAED,IAAI,YAAqC,CAAC;YAE1C,QAAQ,CAAC,OAAO,CAAC;iBACd,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,oCAAoC;gBACpC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;gBAC5B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC7B,YAAY,GAAG,KAAK,CAAC;gBACrB,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBACb,IAAI,YAAY,EAAE,CAAC;oBACjB,oCAAoC;oBACpC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3B,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC;oBAEpC,wDAAwD;oBACxD,IAAI,iBAAiB,EAAE,CAAC;wBACtB,iBAAiB,CACf,OAAO,EACP,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EACrC,IAAI,CAAC,IAAI,CACV,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;4BACZ,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;wBACnD,CAAC,CAAC,CAAC;oBACL,CAAC;oBAED,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;wBACzB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;wBAC9B,OAAO;oBACT,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;gBAClB,gDAAgD;gBAChD,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC;oBAC5B,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC;gBACtC,CAAC;gBACD,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QASA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","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   * @param useCache - Optional flag to control caching behavior (defaults to true)\r\n   * @returns Promise resolving to a blob URL for immediate use\r\n   */\r\n  abstract getAssetBlobURL(\r\n    assetID: string,\r\n    useCache?: boolean\r\n  ): 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   * @param useCache - Optional flag to control caching behavior (defaults to true)\r\n   * @returns Promise resolving to a blob URL for the asset file\r\n   */\r\n  getAssetBlobURL = (\r\n    assetID: string,\r\n    useCache: boolean = true\r\n  ): 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    // If cache is disabled, skip all cache checks and go directly to API\r\n    if (!useCache) {\r\n      return new Promise((resolve, reject) => {\r\n        this.fetchAssetNormally(assetID, resolve, reject);\r\n      });\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/esm/Cache/Factories/CacheFeatureFactory.js

@@ -0,0 +1,47 @@
+import { DomainFactory } from "@vived/core";
+import { makeCacheEntity, makeAssetCacheEntity, makeScriptCacheEntity } from "../Entities";
+import { makeGetAssetFromCacheUC, makeGetScriptFromCacheUC, makeStoreAssetInCacheUC, makeStoreScriptInCacheUC } from "../UCs";
+/**
+ * Factory responsible for setting up the Cache domain components.
+ * This factory initializes all entities, use cases, and presentation models
+ * required for the Cache functionality.
+ */
+export class CacheFeatureFactory extends DomainFactory {
+    constructor(appObject) {
+        super(appObject);
+        // Unique name for this factory
+        this.factoryName = "CacheFeatureFactory";
+    }
+    /**
+     * Sets up all entities required for the Cache system
+     */
+    setupEntities() {
+        // Initialize entities
+        makeCacheEntity(this.appObject);
+        makeScriptCacheEntity(this.appObject);
+        makeAssetCacheEntity(this.appObject);
+    }
+    /**
+     * Sets up all use cases for the Cache system
+     */
+    setupUCs() {
+        // Cache use cases
+        makeGetScriptFromCacheUC(this.appObject);
+        makeStoreScriptInCacheUC(this.appObject);
+        makeGetAssetFromCacheUC(this.appObject);
+        makeStoreAssetInCacheUC(this.appObject);
+    }
+    /**
+     * Sets up all presentation managers for the Cache system
+     */
+    setupPMs() {
+        // No presentation managers exist for the Cache system
+    }
+    /**
+     * Performs any final setup operations after all components are initialized
+     */
+    finalSetup() {
+        // No additional setup required for cache
+    }
+}
+//# sourceMappingURL=CacheFeatureFactory.js.map

package/dist/esm/Cache/Factories/CacheFeatureFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFeatureFactory.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/CacheFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,QAAQ,CAAC;AAEhB;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,CAAC,CAAC;QAJnB,+BAA+B;QACtB,gBAAW,GAAG,qBAAqB,CAAC;IAI7C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,sBAAsB;QACtB,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,kBAAkB;QAClB,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,sDAAsD;IACxD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,yCAAyC;IAC3C,CAAC;CACF","sourcesContent":["import { AppObject, DomainFactory } from \"@vived/core\";\r\nimport {\r\n  makeCacheEntity,\r\n  makeAssetCacheEntity,\r\n  makeScriptCacheEntity\r\n} from \"../Entities\";\r\nimport {\r\n  makeGetAssetFromCacheUC,\r\n  makeGetScriptFromCacheUC,\r\n  makeStoreAssetInCacheUC,\r\n  makeStoreScriptInCacheUC\r\n} from \"../UCs\";\r\n\r\n/**\r\n * Factory responsible for setting up the Cache domain components.\r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Cache functionality.\r\n */\r\nexport class CacheFeatureFactory extends DomainFactory {\r\n  // Unique name for this factory\r\n  readonly factoryName = \"CacheFeatureFactory\";\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all entities required for the Cache system\r\n   */\r\n  setupEntities(): void {\r\n    // Initialize entities\r\n    makeCacheEntity(this.appObject);\r\n    makeScriptCacheEntity(this.appObject);\r\n    makeAssetCacheEntity(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all use cases for the Cache system\r\n   */\r\n  setupUCs(): void {\r\n    // Cache use cases\r\n    makeGetScriptFromCacheUC(this.appObject);\r\n    makeStoreScriptInCacheUC(this.appObject);\r\n    makeGetAssetFromCacheUC(this.appObject);\r\n    makeStoreAssetInCacheUC(this.appObject);\r\n  }\r\n\r\n  /**\r\n   * Sets up all presentation managers for the Cache system\r\n   */\r\n  setupPMs(): void {\r\n    // No presentation managers exist for the Cache system\r\n  }\r\n\r\n  /**\r\n   * Performs any final setup operations after all components are initialized\r\n   */\r\n  finalSetup(): void {\r\n    // No additional setup required for cache\r\n  }\r\n}\r\n"]}

package/dist/esm/Cache/Factories/index.js

@@ -1,2 +1,3 @@
 export * from "./setupCache";
+export * from "./CacheFeatureFactory";
 //# sourceMappingURL=index.js.map

package/dist/esm/Cache/Factories/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./setupCache\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC","sourcesContent":["export * from \"./setupCache\";\r\nexport * from \"./CacheFeatureFactory\";\r\n"]}

package/dist/types/Apps/Factories/AppsFeatureFactory.d.ts

@@ -6,7 +6,6 @@ import { AppObject, DomainFactory } from "@vived/core";
  */
 export declare class AppsFeatureFactory extends DomainFactory {
     readonly factoryName = "AppsFeatureFactory";
-    private appRepoAO;
     constructor(appObject: AppObject);
     /**
      * Sets up all entities required for the Apps system

package/dist/types/Apps/Factories/AppsFeatureFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppsFeatureFactory.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Factories/AppsFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvD;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IAEnD,QAAQ,CAAC,WAAW,wBAAwB;IAG5C,OAAO,CAAC,SAAS,CAAa;gBAElB,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"AppsFeatureFactory.d.ts","sourceRoot":"","sources":["../../../../src/Apps/Factories/AppsFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvD;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IAEnD,QAAQ,CAAC,WAAW,wBAAwB;gBAEhC,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/types/Assets/Controllers/fetchAssetFile.d.ts

@@ -0,0 +1,32 @@
+/**
+ * fetchAssetFile.ts
+ *
+ * This controller function retrieves an asset file as a File object,
+ * handling caching and error management for file access operations.
+ *
+ * Key Concepts:
+ * - Retrieves asset files as File objects for download or processing
+ * - Uses GetAssetFileUC to handle caching and file retrieval logic
+ * - Provides error handling for missing components
+ * - Coordinates with asset file management workflows
+ *
+ * Usage Patterns:
+ * - Called from UI components when users need asset file access
+ * - Used in asset management workflows for file processing
+ * - Integrated with download and preview functionality
+ */
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Retrieves an asset file as a File object.
+ *
+ * This function provides a controller-level interface for asset file retrieval.
+ * It handles the complete file access workflow including caching optimization,
+ * error handling, and returns a File object ready for use in web applications.
+ *
+ * @param assetID - The unique identifier of the asset whose file should be retrieved
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns Promise<File> - A promise that resolves to the File object for the asset,
+ *                         or undefined if the operation cannot be completed
+ */
+export declare function fetchAssetFile(assetID: string, appObjects: AppObjectRepo): Promise<File> | undefined;
+//# sourceMappingURL=fetchAssetFile.d.ts.map

package/dist/types/Assets/Controllers/fetchAssetFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAssetFile.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/fetchAssetFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAQ3B"}

package/dist/types/Assets/Controllers/index.d.ts

@@ -21,6 +21,7 @@ export * from "./archiveAsset";
 export * from "./deleteAsset";
 export * from "./downloadAssetFile";
 export * from "./editAppAsset";
+export * from "./fetchAssetFile";
 export * from "./getAppAssets";
 export * from "./newAppAsset";
 export * from "./toggleShowArchivedAssets";

package/dist/types/Assets/Controllers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/types/Assets/Factories/AssetsFactory.d.ts

@@ -6,9 +6,6 @@ import { AppObject, DomainFactory } from "@vived/core";
  */
 export declare class AssetsFactory extends DomainFactory {
     readonly factoryName = "AssetsFactory";
-    private assetRepoAO;
-    private appAssetsAO;
-    private assetRepo;
     constructor(appObject: AppObject);
     /**
      * Sets up all entities required for the Assets system

package/dist/types/Assets/Factories/AssetsFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetsFactory.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AA8BtE;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAE9C,QAAQ,CAAC,WAAW,mBAAmB;IAGvC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAM;gBAEX,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAUrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAchB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"AssetsFactory.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAsBtE;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAE9C,QAAQ,CAAC,WAAW,mBAAmB;gBAE3B,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAMrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAShB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/types/Assets/UCs/GetAssetBlobURLUC.d.ts

@@ -32,9 +32,10 @@ export declare abstract class GetAssetBlobURLUC extends AppObjectUC {
      * Retrieves a blob URL for the specified asset file.
      *
      * @param assetID - The unique identifier of the asset
+     * @param useCache - Optional flag to control caching behavior (defaults to true)
      * @returns Promise resolving to a blob URL for immediate use
      */
-    abstract getAssetBlobURL(assetID: string): Promise<string>;
+    abstract getAssetBlobURL(assetID: string, useCache?: boolean): Promise<string>;
     /**
      * Retrieves the singleton GetAssetBlobURLUC instance.
      *

package/dist/types/Assets/UCs/GetAssetBlobURLUC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GetAssetBlobURLUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB;;;;;GAKG;AACH,8BAAsB,iBAAkB,SAAQ,WAAW;IACzD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAuB;IAElC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE1D;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS;CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,iBAAiB,CAE7E"}
+{"version":3,"file":"GetAssetBlobURLUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB;;;;;GAKG;AACH,8BAAsB,iBAAkB,SAAQ,WAAW;IACzD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAuB;IAElC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,MAAM,CAAC;IAElB;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS;CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,iBAAiB,CAE7E"}

package/dist/types/Cache/Factories/CacheFeatureFactory.d.ts

@@ -0,0 +1,27 @@
+import { AppObject, DomainFactory } from "@vived/core";
+/**
+ * Factory responsible for setting up the Cache domain components.
+ * This factory initializes all entities, use cases, and presentation models
+ * required for the Cache functionality.
+ */
+export declare class CacheFeatureFactory extends DomainFactory {
+    readonly factoryName = "CacheFeatureFactory";
+    constructor(appObject: AppObject);
+    /**
+     * Sets up all entities required for the Cache system
+     */
+    setupEntities(): void;
+    /**
+     * Sets up all use cases for the Cache system
+     */
+    setupUCs(): void;
+    /**
+     * Sets up all presentation managers for the Cache system
+     */
+    setupPMs(): void;
+    /**
+     * Performs any final setup operations after all components are initialized
+     */
+    finalSetup(): void;
+}
+//# sourceMappingURL=CacheFeatureFactory.d.ts.map

package/dist/types/Cache/Factories/CacheFeatureFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFeatureFactory.d.ts","sourceRoot":"","sources":["../../../../src/Cache/Factories/CacheFeatureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAavD;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IAEpD,QAAQ,CAAC,WAAW,yBAAyB;gBAEjC,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/types/Cache/Factories/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./setupCache";
+export * from "./CacheFeatureFactory";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/Cache/Factories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Cache/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Cache/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vived/host",
-  "version": "4.11.1",
+  "version": "4.12.0",
   "description": "Public Host package for the VIVED Learning App system",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",