@vived/host 4.9.1 → 4.11.0

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

@@ -1,38 +1,112 @@
 "use strict";
+/**
+ * GetAssetUC.ts
+ *
+ * This use case handles retrieval of asset metadata, managing both local
+ * repository cache and remote API fetching to ensure asset entities exist
+ * and are properly configured.
+ *
+ * Key Concepts:
+ * - Retrieves asset entities with metadata from local cache or remote API
+ * - Maintains asset repository consistency for entity management
+ * - Uses lazy loading to fetch assets only when needed
+ * - Transforms API DTOs to local asset entities automatically
+ * - Provides singleton access for system-wide asset retrieval
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to ensure asset entity exists and is loaded
+ * - Returns existing entities immediately or fetches from API as needed
+ * - Used by other UCs that need asset entities for operations
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetAssetUC = void 0;
 exports.makeGetAssetUC = makeGetAssetUC;
 const core_1 = require("@vived/core");
 const VivedAPI_1 = require("../../VivedAPI");
 const AssetRepo_1 = require("../Entities/AssetRepo");
+/**
+ * GetAssetUC handles retrieval and caching of asset entities with metadata.
+ *
+ * This singleton use case ensures asset entities exist in the local repository,
+ * fetching from the API when necessary and maintaining consistent entity state.
+ */
 class GetAssetUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton GetAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetUC instance or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(GetAssetUC.type, appObjects);
     }
 }
 exports.GetAssetUC = GetAssetUC;
+/** Static type identifier for component registration */
 GetAssetUC.type = "GetAssetUC";
+/**
+ * Factory function to create a new GetAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case (must have AssetRepo)
+ * @returns A new GetAssetUC implementation instance
+ */
 function makeGetAssetUC(appObject) {
     return new GetAssetUCImp(appObject);
 }
+/**
+ * Private implementation of GetAssetUC with caching and API integration.
+ *
+ * Key Implementation Details:
+ * - Checks local asset repository first for immediate access
+ * - Falls back to API fetch when asset is not cached locally
+ * - Transforms API DTOs to asset entities using repository methods
+ * - Provides error handling and logging for debugging
+ * - Validates required dependencies during initialization
+ */
 class GetAssetUCImp extends GetAssetUC {
+    /**
+     * Gets the API use case for fetching asset metadata from remote sources
+     * Used when assets are not available in the local repository
+     */
     get fetchAssetMeta() {
         return this.getCachedSingleton(VivedAPI_1.FetchAssetMetaFromAPIUC.type)?.doFetch;
     }
+    /**
+     * Initializes the GetAssetUC with required dependencies and validation.
+     *
+     * @param appObject - The AppObject that should contain the AssetRepo for entity management
+     */
     constructor(appObject) {
         super(appObject, GetAssetUC.type);
+        /**
+         * Retrieves an asset entity with intelligent caching.
+         *
+         * This method implements a two-tier strategy:
+         * 1. Check local repository for existing entity (immediate return)
+         * 2. Fetch from API and create entity if not cached
+         *
+         * The method ensures all requested assets are available as entities
+         * in the local repository for subsequent operations.
+         *
+         * @param assetID - The unique identifier of the asset
+         * @returns Promise resolving to the asset entity with loaded metadata
+         */
         this.getAsset = (assetID) => {
             const assetRepo = this.assetRepo;
             const fetchAssetMeta = this.fetchAssetMeta;
             if (!assetRepo || !fetchAssetMeta) {
                 return Promise.reject();
             }
+            // Check local repository first for immediate access
             if (assetRepo.has(assetID)) {
                 return Promise.resolve(assetRepo.get(assetID));
             }
+            // Asset not cached, fetch from API
             return new Promise((resolve, reject) => {
                 fetchAssetMeta(assetID)
                     .then((baseDTO) => {
+                    // Transform DTO to entity and add to repository
                     const baseAsset = assetRepo.addFromDTO(baseDTO);
                     resolve(baseAsset);
                 })
@@ -43,6 +117,7 @@ class GetAssetUCImp extends GetAssetUC {
             });
         };
         this.appObjects.registerSingleton(this);
+        // Validate and cache the asset repository dependency
         this.assetRepo = appObject.getComponent(AssetRepo_1.AssetRepo.type);
         if (!this.assetRepo) {
             this.error("UC added to an App Object that does not have AssetRepo");

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

@@ -1 +1 @@
-{"version":3,"file":"GetAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetUC.ts"],"names":[],"mappings":";;;AAoBA,wCAEC;AAtBD,sCAKqB;AACrB,6CAAyD;AAEzD,qDAAkD;AAElD,MAAsB,UAAW,SAAQ,kBAAW;IAKlD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAPH,gCAQC;AAPQ,eAAI,GAAG,YAAY,CAAC;AAS7B,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IAGpC,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,kCAAuB,CAAC,IAAI,CAC7B,EAAE,OAAO,CAAC;IACb,CAAC;IA0BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAzBpC,aAAQ,GAAG,CAAC,OAAe,EAAwB,EAAE;YACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAE3C,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,cAAc,CAAC,OAAO,CAAC;qBACpB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;oBAChB,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBAChD,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CAAY,qBAAS,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { FetchAssetMetaFromAPIUC } from \"../../VivedAPI\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\nexport abstract class GetAssetUC extends AppObjectUC {\r\n  static type = \"GetAssetUC\";\r\n\r\n  abstract getAsset(assetID: string): Promise<AssetEntity>;\r\n\r\n  static get(appObjects: AppObjectRepo): GetAssetUC | undefined {\r\n    return getSingletonComponent<GetAssetUC>(GetAssetUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeGetAssetUC(appObject: AppObject): GetAssetUC {\r\n  return new GetAssetUCImp(appObject);\r\n}\r\n\r\nclass GetAssetUCImp extends GetAssetUC {\r\n  private assetRepo?: AssetRepo;\r\n\r\n  private get fetchAssetMeta() {\r\n    return this.getCachedSingleton<FetchAssetMetaFromAPIUC>(\r\n      FetchAssetMetaFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  getAsset = (assetID: string): Promise<AssetEntity> => {\r\n    const assetRepo = this.assetRepo;\r\n    const fetchAssetMeta = this.fetchAssetMeta;\r\n\r\n    if (!assetRepo || !fetchAssetMeta) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    if (assetRepo.has(assetID)) {\r\n      return Promise.resolve(assetRepo.get(assetID)!);\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      fetchAssetMeta(assetID)\r\n        .then((baseDTO) => {\r\n          const baseAsset = assetRepo.addFromDTO(baseDTO);\r\n          resolve(baseAsset);\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetUC.type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.assetRepo = appObject.getComponent<AssetRepo>(AssetRepo.type);\r\n    if (!this.assetRepo) {\r\n      this.error(\"UC added to an App Object that does not have AssetRepo\");\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"GetAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetUC.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AA+CH,wCAEC;AA/CD,sCAKqB;AACrB,6CAAyD;AAEzD,qDAAkD;AAElD;;;;;GAKG;AACH,MAAsB,UAAW,SAAQ,kBAAW;IAYlD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AApBH,gCAqBC;AApBC,wDAAwD;AACjD,eAAI,GAAG,YAAY,CAAC;AAqB7B;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,aAAc,SAAQ,UAAU;IAIpC;;;OAGG;IACH,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,kCAAuB,CAAC,IAAI,CAC7B,EAAE,OAAO,CAAC;IACb,CAAC;IA2CD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QA/CpC;;;;;;;;;;;;WAYG;QACH,aAAQ,GAAG,CAAC,OAAe,EAAwB,EAAE;YACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAE3C,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,oDAAoD;YACpD,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,CAAC;YAClD,CAAC;YAED,mCAAmC;YACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,cAAc,CAAC,OAAO,CAAC;qBACpB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;oBAChB,gDAAgD;oBAChD,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBAChD,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QASA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,qDAAqD;QACrD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CAAY,qBAAS,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\r\n * GetAssetUC.ts\r\n *\r\n * This use case handles retrieval of asset metadata, managing both local\r\n * repository cache and remote API fetching to ensure asset entities exist\r\n * and are properly configured.\r\n *\r\n * Key Concepts:\r\n * - Retrieves asset entities with metadata from local cache or remote API\r\n * - Maintains asset repository consistency for entity management\r\n * - Uses lazy loading to fetch assets only when needed\r\n * - Transforms API DTOs to local asset entities automatically\r\n * - Provides singleton access for system-wide asset retrieval\r\n *\r\n * Usage Patterns:\r\n * - Singleton use case accessed through static get() method\r\n * - Called with asset ID to ensure asset entity exists and is loaded\r\n * - Returns existing entities immediately or fetches from API as needed\r\n * - Used by other UCs that need asset entities for operations\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 { FetchAssetMetaFromAPIUC } from \"../../VivedAPI\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\n/**\r\n * GetAssetUC handles retrieval and caching of asset entities with metadata.\r\n *\r\n * This singleton use case ensures asset entities exist in the local repository,\r\n * fetching from the API when necessary and maintaining consistent entity state.\r\n */\r\nexport abstract class GetAssetUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"GetAssetUC\";\r\n\r\n  /**\r\n   * Retrieves an asset entity, fetching from API if not already cached.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to the asset entity with loaded metadata\r\n   */\r\n  abstract getAsset(assetID: string): Promise<AssetEntity>;\r\n\r\n  /**\r\n   * Retrieves the singleton GetAssetUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns GetAssetUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): GetAssetUC | undefined {\r\n    return getSingletonComponent<GetAssetUC>(GetAssetUC.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new GetAssetUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case (must have AssetRepo)\r\n * @returns A new GetAssetUC implementation instance\r\n */\r\nexport function makeGetAssetUC(appObject: AppObject): GetAssetUC {\r\n  return new GetAssetUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of GetAssetUC with caching and API integration.\r\n *\r\n * Key Implementation Details:\r\n * - Checks local asset repository first for immediate access\r\n * - Falls back to API fetch when asset is not cached locally\r\n * - Transforms API DTOs to asset entities using repository methods\r\n * - Provides error handling and logging for debugging\r\n * - Validates required dependencies during initialization\r\n */\r\nclass GetAssetUCImp extends GetAssetUC {\r\n  /** The asset repository for entity management and caching */\r\n  private assetRepo?: AssetRepo;\r\n\r\n  /**\r\n   * Gets the API use case for fetching asset metadata from remote sources\r\n   * Used when assets are not available in the local repository\r\n   */\r\n  private get fetchAssetMeta() {\r\n    return this.getCachedSingleton<FetchAssetMetaFromAPIUC>(\r\n      FetchAssetMetaFromAPIUC.type\r\n    )?.doFetch;\r\n  }\r\n\r\n  /**\r\n   * Retrieves an asset entity with intelligent caching.\r\n   *\r\n   * This method implements a two-tier strategy:\r\n   * 1. Check local repository for existing entity (immediate return)\r\n   * 2. Fetch from API and create entity if not cached\r\n   *\r\n   * The method ensures all requested assets are available as entities\r\n   * in the local repository for subsequent operations.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns Promise resolving to the asset entity with loaded metadata\r\n   */\r\n  getAsset = (assetID: string): Promise<AssetEntity> => {\r\n    const assetRepo = this.assetRepo;\r\n    const fetchAssetMeta = this.fetchAssetMeta;\r\n\r\n    if (!assetRepo || !fetchAssetMeta) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Check local repository first for immediate access\r\n    if (assetRepo.has(assetID)) {\r\n      return Promise.resolve(assetRepo.get(assetID)!);\r\n    }\r\n\r\n    // Asset not cached, fetch from API\r\n    return new Promise((resolve, reject) => {\r\n      fetchAssetMeta(assetID)\r\n        .then((baseDTO) => {\r\n          // Transform DTO to entity and add to repository\r\n          const baseAsset = assetRepo.addFromDTO(baseDTO);\r\n          resolve(baseAsset);\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Initializes the GetAssetUC with required dependencies and validation.\r\n   *\r\n   * @param appObject - The AppObject that should contain the AssetRepo for entity management\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, GetAssetUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    // Validate and cache the asset repository dependency\r\n    this.assetRepo = appObject.getComponent<AssetRepo>(AssetRepo.type);\r\n    if (!this.assetRepo) {\r\n      this.error(\"UC added to an App Object that does not have AssetRepo\");\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}

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

@@ -1,4 +1,10 @@
 "use strict";
+/**
+ * NewAppAssetUC.ts
+ *
+ * This use case handles creation of new assets within application contexts,
+ * managing the complete workflow from file upload to UI state transitions.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NewAppAssetUC = void 0;
 exports.makeNewAppAssetUC = makeNewAppAssetUC;
@@ -7,16 +13,37 @@ const Entities_1 = require("../../AppSandbox/Entities");
 const Dialog_1 = require("../../Dialog");
 const UCs_1 = require("../../VivedAPI/UCs");
 const Entities_2 = require("../Entities");
+/**
+ * NewAppAssetUC handles creation of new assets within application contexts.
+ *
+ * This singleton use case manages asset creation with UI feedback and state transitions.
+ */
 class NewAppAssetUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton NewAppAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns NewAppAssetUC instance or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(NewAppAssetUC.type, appObjects);
     }
 }
 exports.NewAppAssetUC = NewAppAssetUC;
+/** Static type identifier for component registration */
 NewAppAssetUC.type = "NewAppAssetUC";
+/**
+ * Factory function to create a new NewAppAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new NewAppAssetUC implementation instance
+ */
 function makeNewAppAssetUC(appObject) {
     return new NewAppAssetUCImp(appObject);
 }
+/**
+ * Private implementation of NewAppAssetUC with app context and state management.
+ */
 class NewAppAssetUCImp extends NewAppAssetUC {
     get postNewAsset() {
         return this.getCachedSingleton(UCs_1.PostNewAssetUC.type)?.doPost;

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

@@ -1 +1 @@
-{"version":3,"file":"NewAppAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAppAssetUC.ts"],"names":[],"mappings":";;;AA+BA,8CAEC;AAjCD,sCAKqB;AACrB,wDAA2E;AAC3E,yCAIsB;AACtB,4CAAoE;AACpE,0CAAyD;AAQzD,MAAsB,aAAc,SAAQ,kBAAW;IAKrD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;;AAPH,sCAQC;AAPQ,kBAAI,GAAG,eAAe,CAAC;AAShC,SAAgB,iBAAiB,CAAC,SAAoB;IACpD,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,gBAAiB,SAAQ,aAAa;IAG1C,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,oBAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9E,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,oBAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,2BAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,4BAAmB,CAAC,IAAI,CACzB,CAAC;IACJ,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAoB,0BAAiB,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC;IA2DD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QA1DvC,WAAM,GAAG,CAAC,IAAoB,EAAiB,EAAE;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAEjC,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1D,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACnC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;gBAEzC,MAAM,YAAY,GAAmB;oBACnC,WAAW;oBACX,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,OAAO,CAAC,KAAK;iBACvB,CAAC;gBAEF,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC;oBAC9C,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,0BAA0B;iBACpC,CAAC,CAAC;gBAEH,YAAY,CAAC,YAAY,CAAC;qBACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACb,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAEvB,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACjD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBACvB,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;oBACnC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;oBACrB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;oBAElC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACxB,IAAI,CAAC,OAAQ,CAAC,KAAK,GAAG,uBAAY,CAAC,OAAO,CAAC;oBAE3C,aAAa,EAAE,KAAK,EAAE,CAAC;oBACvB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;oBACnD,aAAa,EAAE,KAAK,EAAE,CAAC;oBAEvB,MAAM,SAAS,GAAmB;wBAChC,WAAW,EAAE,IAAI;wBACjB,OAAO,EAAE,0EAA0E,CAAC,CAAC,OAAO,EAAE;wBAC9F,KAAK,EAAE,qBAAqB;qBAC7B,CAAC;oBACF,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;oBAEnC,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,0BAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CACR,8DAA8D,CAC/D,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { AppSandboxEntity, SandboxState } from \"../../AppSandbox/Entities\";\r\nimport {\r\n  DialogAlertDTO,\r\n  MakeAlertDialogUC,\r\n  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { NewAssetApiDto, PostNewAssetUC } from \"../../VivedAPI/UCs\";\r\nimport { AppAssetsEntity, AssetRepo } from \"../Entities\";\r\n\r\nexport interface NewAppAssetDTO {\r\n  file: File;\r\n  name: string;\r\n  description: string;\r\n}\r\n\r\nexport abstract class NewAppAssetUC extends AppObjectUC {\r\n  static type = \"NewAppAssetUC\";\r\n\r\n  abstract create(data: NewAppAssetDTO): Promise<void>;\r\n\r\n  static get(appObjects: AppObjectRepo): NewAppAssetUC | undefined {\r\n    return getSingletonComponent(NewAppAssetUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeNewAppAssetUC(appObject: AppObject): NewAppAssetUC {\r\n  return new NewAppAssetUCImp(appObject);\r\n}\r\n\r\nclass NewAppAssetUCImp extends NewAppAssetUC {\r\n  private appAssets?: AppAssetsEntity;\r\n\r\n  private get postNewAsset() {\r\n    return this.getCachedSingleton<PostNewAssetUC>(PostNewAssetUC.type)?.doPost;\r\n  }\r\n\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  private get spinnerFactory() {\r\n    return this.getCachedSingleton<MakeSpinnerDialogUC>(\r\n      MakeSpinnerDialogUC.type\r\n    );\r\n  }\r\n\r\n  private get alertFactory() {\r\n    return this.getCachedSingleton<MakeAlertDialogUC>(MakeAlertDialogUC.type);\r\n  }\r\n\r\n  create = (data: NewAppAssetDTO): Promise<void> => {\r\n    const appAssets = this.appAssets;\r\n    const postNewAsset = this.postNewAsset;\r\n    const sandbox = this.sandbox;\r\n    const assetRepo = this.assetRepo;\r\n\r\n    if (!appAssets || !postNewAsset || !sandbox || !assetRepo) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    return new Promise<void>((resolve) => {\r\n      const { description, file, name } = data;\r\n\r\n      const newAssetData: NewAssetApiDto = {\r\n        description,\r\n        name,\r\n        file,\r\n        ownerID: sandbox.appID\r\n      };\r\n\r\n      const spinnerDialog = this.spinnerFactory?.make({\r\n        title: \"New App Asset\",\r\n        message: \"Posting new app asset...\"\r\n      });\r\n\r\n      postNewAsset(newAssetData)\r\n        .then((resp) => {\r\n          appAssets.add(resp.id);\r\n\r\n          const newAsset = assetRepo.assetFactory(resp.id);\r\n          newAsset.setFile(file);\r\n          newAsset.description = description;\r\n          newAsset.name = name;\r\n          newAsset.filename = resp.filename;\r\n\r\n          assetRepo.add(newAsset);\r\n          this.sandbox!.state = SandboxState.MOUNTED;\r\n\r\n          spinnerDialog?.close();\r\n          resolve();\r\n        })\r\n        .catch((e: Error) => {\r\n          this.error(\"create new asset error: \" + e.message);\r\n          spinnerDialog?.close();\r\n\r\n          const dialogDTO: DialogAlertDTO = {\r\n            buttonLabel: \"OK\",\r\n            message: `Something went wrong when creating a new app asset. Check the console. ${e.message}`,\r\n            title: \"New App Asset Error\"\r\n          };\r\n          this.alertFactory?.make(dialogDTO);\r\n\r\n          resolve();\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, NewAppAssetUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n      AppAssetsEntity.type\r\n    );\r\n    if (!this.appAssets) {\r\n      this.error(\r\n        \"UC added to an App Object that does not have AppAssetsEntity\"\r\n      );\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NewAppAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAppAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * NewAppAssetUC.ts\r\n *\r\n * This use case handles creation of new assets within application contexts,\r\n * managing the complete workflow from file upload to UI state transitions.\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 { AppSandboxEntity, SandboxState } from \"../../AppSandbox/Entities\";\r\nimport {\r\n  DialogAlertDTO,\r\n  MakeAlertDialogUC,\r\n  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { NewAssetApiDto, PostNewAssetUC } from \"../../VivedAPI/UCs\";\r\nimport { AppAssetsEntity, AssetRepo } from \"../Entities\";\r\n\r\n/**\r\n * Data transfer object for new application asset creation requests.\r\n */\r\nexport interface NewAppAssetDTO {\r\n  /** The file object to be uploaded and stored as the asset */\r\n  file: File;\r\n  /** Display name for the asset */\r\n  name: string;\r\n  /** Detailed description of the asset's purpose or content */\r\n  description: string;\r\n}\r\n\r\n/**\r\n * NewAppAssetUC handles creation of new assets within application contexts.\r\n *\r\n * This singleton use case manages asset creation with UI feedback and state transitions.\r\n */\r\nexport abstract class NewAppAssetUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"NewAppAssetUC\";\r\n\r\n  /**\r\n   * Creates a new asset with the provided data.\r\n   *\r\n   * @param data - Complete asset information including file and metadata\r\n   * @returns Promise that resolves when the asset is successfully created\r\n   */\r\n  abstract create(data: NewAppAssetDTO): Promise<void>;\r\n\r\n  /**\r\n   * Retrieves the singleton NewAppAssetUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns NewAppAssetUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): NewAppAssetUC | undefined {\r\n    return getSingletonComponent(NewAppAssetUC.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new NewAppAssetUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case\r\n * @returns A new NewAppAssetUC implementation instance\r\n */\r\nexport function makeNewAppAssetUC(appObject: AppObject): NewAppAssetUC {\r\n  return new NewAppAssetUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of NewAppAssetUC with app context and state management.\r\n */\r\nclass NewAppAssetUCImp extends NewAppAssetUC {\r\n  private appAssets?: AppAssetsEntity;\r\n\r\n  private get postNewAsset() {\r\n    return this.getCachedSingleton<PostNewAssetUC>(PostNewAssetUC.type)?.doPost;\r\n  }\r\n\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  private get spinnerFactory() {\r\n    return this.getCachedSingleton<MakeSpinnerDialogUC>(\r\n      MakeSpinnerDialogUC.type\r\n    );\r\n  }\r\n\r\n  private get alertFactory() {\r\n    return this.getCachedSingleton<MakeAlertDialogUC>(MakeAlertDialogUC.type);\r\n  }\r\n\r\n  create = (data: NewAppAssetDTO): Promise<void> => {\r\n    const appAssets = this.appAssets;\r\n    const postNewAsset = this.postNewAsset;\r\n    const sandbox = this.sandbox;\r\n    const assetRepo = this.assetRepo;\r\n\r\n    if (!appAssets || !postNewAsset || !sandbox || !assetRepo) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    return new Promise<void>((resolve) => {\r\n      const { description, file, name } = data;\r\n\r\n      const newAssetData: NewAssetApiDto = {\r\n        description,\r\n        name,\r\n        file,\r\n        ownerID: sandbox.appID\r\n      };\r\n\r\n      const spinnerDialog = this.spinnerFactory?.make({\r\n        title: \"New App Asset\",\r\n        message: \"Posting new app asset...\"\r\n      });\r\n\r\n      postNewAsset(newAssetData)\r\n        .then((resp) => {\r\n          appAssets.add(resp.id);\r\n\r\n          const newAsset = assetRepo.assetFactory(resp.id);\r\n          newAsset.setFile(file);\r\n          newAsset.description = description;\r\n          newAsset.name = name;\r\n          newAsset.filename = resp.filename;\r\n\r\n          assetRepo.add(newAsset);\r\n          this.sandbox!.state = SandboxState.MOUNTED;\r\n\r\n          spinnerDialog?.close();\r\n          resolve();\r\n        })\r\n        .catch((e: Error) => {\r\n          this.error(\"create new asset error: \" + e.message);\r\n          spinnerDialog?.close();\r\n\r\n          const dialogDTO: DialogAlertDTO = {\r\n            buttonLabel: \"OK\",\r\n            message: `Something went wrong when creating a new app asset. Check the console. ${e.message}`,\r\n            title: \"New App Asset Error\"\r\n          };\r\n          this.alertFactory?.make(dialogDTO);\r\n\r\n          resolve();\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, NewAppAssetUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n      AppAssetsEntity.type\r\n    );\r\n    if (!this.appAssets) {\r\n      this.error(\r\n        \"UC added to an App Object that does not have AppAssetsEntity\"\r\n      );\r\n      return;\r\n    }\r\n  }\r\n}\r\n"]}

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

@@ -1,29 +1,105 @@
 "use strict";
+/**
+ * NewAssetUC.ts
+ *
+ * This use case handles the creation of new assets, managing the complete workflow
+ * from file upload through API persistence to local entity creation and storage.
+ *
+ * Key Concepts:
+ * - Singleton use case that handles asset creation operations
+ * - Coordinates file upload with metadata persistence via API
+ * - Creates and configures new asset entities in the local repository
+ * - Transforms between DTO formats for API and internal use
+ * - Provides unique asset IDs for tracking and reference
+ *
+ * Usage Patterns:
+ * - Accessed as a singleton through static get() method
+ * - Called with complete asset data including file and metadata
+ * - Returns asset ID for immediate reference by calling code
+ * - Handles async operations with proper error propagation
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NewAssetUC = void 0;
 exports.makeNewAssetUC = makeNewAssetUC;
 const core_1 = require("@vived/core");
 const UCs_1 = require("../../VivedAPI/UCs");
 const Entities_1 = require("../Entities");
+/**
+ * NewAssetUC handles the creation of new assets in the VIVED system.
+ *
+ * This singleton use case manages the complete asset creation workflow,
+ * from initial file upload through API persistence to local entity creation.
+ */
 class NewAssetUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton NewAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns NewAssetUC instance or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(NewAssetUC.type, appObjects);
     }
 }
 exports.NewAssetUC = NewAssetUC;
+/** Static type identifier for component registration */
 NewAssetUC.type = "NewAssetUC";
+/**
+ * Factory function to create a new NewAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new NewAssetUC implementation instance
+ */
 function makeNewAssetUC(appObject) {
     return new NewAssetUCImp(appObject);
 }
+/**
+ * Private implementation of NewAssetUC that handles the concrete asset creation operations.
+ *
+ * Key Implementation Details:
+ * - Validates required dependencies (API and repository components)
+ * - Transforms NewAssetDto to NewAssetApiDto for API communication
+ * - Creates and configures new asset entities with file and metadata
+ * - Adds created assets to the repository for management and access
+ * - Handles async operations with proper error propagation
+ * - Registers itself as a singleton for system-wide access
+ */
 class NewAssetUCImp extends NewAssetUC {
+    /**
+     * Gets the API use case for posting new assets to the backend
+     * Cached for efficient repeated access during operations
+     */
     get postNewAsset() {
         return this.getCachedSingleton(UCs_1.PostNewAssetUC.type)?.doPost;
     }
+    /**
+     * Gets the asset repository for entity creation and management
+     * Cached for efficient repeated access during operations
+     */
     get assetRepo() {
         return this.getCachedSingleton(Entities_1.AssetRepo.type);
     }
+    /**
+     * Initializes the NewAssetUC and registers it as a singleton.
+     *
+     * @param appObject - The AppObject that will host this singleton use case
+     */
     constructor(appObject) {
         super(appObject, NewAssetUC.type);
+        /**
+         * Creates a new asset with complete workflow handling.
+         *
+         * This method handles the complete asset creation process:
+         * 1. Validates required dependencies are available
+         * 2. Transforms the DTO to API format
+         * 3. Posts the asset data to the backend API
+         * 4. Creates a new asset entity with the returned information
+         * 5. Configures the entity with file and metadata
+         * 6. Adds the entity to the repository for management
+         *
+         * @param data - Complete asset creation data
+         * @returns Promise resolving to the unique asset ID
+         */
         this.create = (data) => {
             const postNewAsset = this.postNewAsset;
             const assetRepo = this.assetRepo;
@@ -38,11 +114,13 @@ class NewAssetUCImp extends NewAssetUC {
                 ownerID: owner
             };
             return postNewAsset(newAssetData).then((resp) => {
+                // Create and configure the new asset entity
                 const newAsset = assetRepo.assetFactory(resp.id);
                 newAsset.setFile(file);
                 newAsset.description = description;
                 newAsset.name = name;
                 newAsset.filename = resp.filename;
+                // Add to repository for management
                 assetRepo.add(newAsset);
                 return resp.id;
             });

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

@@ -1 +1 @@
-{"version":3,"file":"NewAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAssetUC.ts"],"names":[],"mappings":";;;AA0BA,wCAEC;AA5BD,sCAKqB;AACrB,4CAAoE;AACpE,0CAAwC;AASxC,MAAsB,UAAW,SAAQ,kBAAW;IAKlD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;;AAPH,gCAQC;AAPQ,eAAI,GAAG,YAAY,CAAC;AAS7B,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IACpC,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,oBAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9E,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,oBAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IA8BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QA7BpC,WAAM,GAAG,CAAC,IAAiB,EAAmB,EAAE;YAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAEjC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YAChD,MAAM,YAAY,GAAmB;gBACnC,WAAW;gBACX,IAAI;gBACJ,IAAI;gBACJ,OAAO,EAAE,KAAK;aACf,CAAC;YAEF,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvB,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;gBACnC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;gBACrB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAElC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { NewAssetApiDto, PostNewAssetUC } from \"../../VivedAPI/UCs\";\r\nimport { AssetRepo } from \"../Entities\";\r\n\r\nexport interface NewAssetDto {\r\n  file: File;\r\n  name: string;\r\n  description: string;\r\n  owner: string;\r\n}\r\n\r\nexport abstract class NewAssetUC extends AppObjectUC {\r\n  static type = \"NewAssetUC\";\r\n\r\n  abstract create(data: NewAssetDto): Promise<string>;\r\n\r\n  static get(appObjects: AppObjectRepo): NewAssetUC | undefined {\r\n    return getSingletonComponent(NewAssetUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeNewAssetUC(appObject: AppObject): NewAssetUC {\r\n  return new NewAssetUCImp(appObject);\r\n}\r\n\r\nclass NewAssetUCImp extends NewAssetUC {\r\n  private get postNewAsset() {\r\n    return this.getCachedSingleton<PostNewAssetUC>(PostNewAssetUC.type)?.doPost;\r\n  }\r\n\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  create = (data: NewAssetDto): Promise<string> => {\r\n    const postNewAsset = this.postNewAsset;\r\n    const assetRepo = this.assetRepo;\r\n\r\n    if (!postNewAsset || !assetRepo) {\r\n      return Promise.reject(new Error(\"Missing dependencies\"));\r\n    }\r\n\r\n    const { description, file, name, owner } = data;\r\n    const newAssetData: NewAssetApiDto = {\r\n      description,\r\n      name,\r\n      file,\r\n      ownerID: owner\r\n    };\r\n\r\n    return postNewAsset(newAssetData).then((resp) => {\r\n      const newAsset = assetRepo.assetFactory(resp.id);\r\n      newAsset.setFile(file);\r\n      newAsset.description = description;\r\n      newAsset.name = name;\r\n      newAsset.filename = resp.filename;\r\n\r\n      assetRepo.add(newAsset);\r\n      return resp.id;\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, NewAssetUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NewAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAssetUC.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AA6DH,wCAEC;AA7DD,sCAKqB;AACrB,4CAAoE;AACpE,0CAAwC;AAiBxC;;;;;GAKG;AACH,MAAsB,UAAW,SAAQ,kBAAW;IAYlD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;;AApBH,gCAqBC;AApBC,wDAAwD;AACjD,eAAI,GAAG,YAAY,CAAC;AAqB7B;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC;;;OAGG;IACH,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,oBAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9E,CAAC;IAED;;;OAGG;IACH,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,oBAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IA8CD;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAlDpC;;;;;;;;;;;;;WAaG;QACH,WAAM,GAAG,CAAC,IAAiB,EAAmB,EAAE;YAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAEjC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YAChD,MAAM,YAAY,GAAmB;gBACnC,WAAW;gBACX,IAAI;gBACJ,IAAI;gBACJ,OAAO,EAAE,KAAK;aACf,CAAC;YAEF,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC9C,4CAA4C;gBAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvB,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;gBACnC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;gBACrB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAElC,mCAAmC;gBACnC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QASA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\r\n * NewAssetUC.ts\r\n *\r\n * This use case handles the creation of new assets, managing the complete workflow\r\n * from file upload through API persistence to local entity creation and storage.\r\n *\r\n * Key Concepts:\r\n * - Singleton use case that handles asset creation operations\r\n * - Coordinates file upload with metadata persistence via API\r\n * - Creates and configures new asset entities in the local repository\r\n * - Transforms between DTO formats for API and internal use\r\n * - Provides unique asset IDs for tracking and reference\r\n *\r\n * Usage Patterns:\r\n * - Accessed as a singleton through static get() method\r\n * - Called with complete asset data including file and metadata\r\n * - Returns asset ID for immediate reference by calling code\r\n * - Handles async operations with proper error propagation\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { NewAssetApiDto, PostNewAssetUC } from \"../../VivedAPI/UCs\";\r\nimport { AssetRepo } from \"../Entities\";\r\n\r\n/**\r\n * Data transfer object for new asset creation requests.\r\n * Contains all necessary information to create a new asset in the system.\r\n */\r\nexport interface NewAssetDto {\r\n  /** The file object to be uploaded and stored as the asset */\r\n  file: File;\r\n  /** Display name for the asset */\r\n  name: string;\r\n  /** Detailed description of the asset's purpose or content */\r\n  description: string;\r\n  /** ID of the user or entity that owns this asset */\r\n  owner: string;\r\n}\r\n\r\n/**\r\n * NewAssetUC handles the creation of new assets in the VIVED system.\r\n *\r\n * This singleton use case manages the complete asset creation workflow,\r\n * from initial file upload through API persistence to local entity creation.\r\n */\r\nexport abstract class NewAssetUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"NewAssetUC\";\r\n\r\n  /**\r\n   * Creates a new asset with the provided data.\r\n   *\r\n   * @param data - Complete asset information including file and metadata\r\n   * @returns Promise resolving to the unique ID of the newly created asset\r\n   */\r\n  abstract create(data: NewAssetDto): Promise<string>;\r\n\r\n  /**\r\n   * Retrieves the singleton NewAssetUC instance.\r\n   *\r\n   * @param appObjects - Repository for accessing the singleton component\r\n   * @returns NewAssetUC instance or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): NewAssetUC | undefined {\r\n    return getSingletonComponent(NewAssetUC.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new NewAssetUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this singleton use case\r\n * @returns A new NewAssetUC implementation instance\r\n */\r\nexport function makeNewAssetUC(appObject: AppObject): NewAssetUC {\r\n  return new NewAssetUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of NewAssetUC that handles the concrete asset creation operations.\r\n *\r\n * Key Implementation Details:\r\n * - Validates required dependencies (API and repository components)\r\n * - Transforms NewAssetDto to NewAssetApiDto for API communication\r\n * - Creates and configures new asset entities with file and metadata\r\n * - Adds created assets to the repository for management and access\r\n * - Handles async operations with proper error propagation\r\n * - Registers itself as a singleton for system-wide access\r\n */\r\nclass NewAssetUCImp extends NewAssetUC {\r\n  /**\r\n   * Gets the API use case for posting new assets to the backend\r\n   * Cached for efficient repeated access during operations\r\n   */\r\n  private get postNewAsset() {\r\n    return this.getCachedSingleton<PostNewAssetUC>(PostNewAssetUC.type)?.doPost;\r\n  }\r\n\r\n  /**\r\n   * Gets the asset repository for entity creation and management\r\n   * Cached for efficient repeated access during operations\r\n   */\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  /**\r\n   * Creates a new asset with complete workflow handling.\r\n   *\r\n   * This method handles the complete asset creation process:\r\n   * 1. Validates required dependencies are available\r\n   * 2. Transforms the DTO to API format\r\n   * 3. Posts the asset data to the backend API\r\n   * 4. Creates a new asset entity with the returned information\r\n   * 5. Configures the entity with file and metadata\r\n   * 6. Adds the entity to the repository for management\r\n   *\r\n   * @param data - Complete asset creation data\r\n   * @returns Promise resolving to the unique asset ID\r\n   */\r\n  create = (data: NewAssetDto): Promise<string> => {\r\n    const postNewAsset = this.postNewAsset;\r\n    const assetRepo = this.assetRepo;\r\n\r\n    if (!postNewAsset || !assetRepo) {\r\n      return Promise.reject(new Error(\"Missing dependencies\"));\r\n    }\r\n\r\n    const { description, file, name, owner } = data;\r\n    const newAssetData: NewAssetApiDto = {\r\n      description,\r\n      name,\r\n      file,\r\n      ownerID: owner\r\n    };\r\n\r\n    return postNewAsset(newAssetData).then((resp) => {\r\n      // Create and configure the new asset entity\r\n      const newAsset = assetRepo.assetFactory(resp.id);\r\n      newAsset.setFile(file);\r\n      newAsset.description = description;\r\n      newAsset.name = name;\r\n      newAsset.filename = resp.filename;\r\n\r\n      // Add to repository for management\r\n      assetRepo.add(newAsset);\r\n      return resp.id;\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Initializes the NewAssetUC 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, NewAssetUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"PrefetchAssetsUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/PrefetchAssetsUC.ts"],"names":[],"mappings":";;;AAmBA,gDAEC;AArBD,sCAKqB;AACrB,0DAA+D;AAC/D,qDAAkD;AAElD,MAAsB,gBAAiB,SAAQ,kBAAW;IAKxD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;;AAPH,4CAQC;AAPQ,qBAAI,GAAG,kBAAkB,CAAC;AASnC,SAAgB,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,gBAAgB;IACjD,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,2BAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC;YACjE,EAAE,YAAY,CAAC;IACnB,CAAC;IAsCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QArC1C,mBAAc,GAAG,KAAK,IAAmB,EAAE;YACzC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC1C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CACnD,CAAC,QAAkB,EAAE,OAAe,EAAE,EAAE;gBACtC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,EACD,EAAE,CACH,CAAC;YAEF,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;YAE1D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;oBACnD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC,CAAC,CAAC;gBAEH,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;qBACvB,IAAI,CAAC,GAAG,EAAE;oBACT,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { HostStateMachine } from \"../../StateMachine/Entities\";\r\nimport { GetAssetFileUC } from \"./GetAssetFileUC\";\r\n\r\nexport abstract class PrefetchAssetsUC extends AppObjectUC {\r\n  static type = \"PrefetchAssetsUC\";\r\n\r\n  abstract prefetchAssets(): Promise<void>;\r\n\r\n  static get(appObjects: AppObjectRepo): PrefetchAssetsUC | undefined {\r\n    return getSingletonComponent(PrefetchAssetsUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makePrefetchAssets(appObject: AppObject): PrefetchAssetsUC {\r\n  return new HostAppObjectRepoImp(appObject);\r\n}\r\n\r\nclass HostAppObjectRepoImp extends PrefetchAssetsUC {\r\n  private get stateMachine() {\r\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n  }\r\n\r\n  private get fetchAssetFile() {\r\n    return this.getCachedSingleton<GetAssetFileUC>(GetAssetFileUC.type)\r\n      ?.getAssetFile;\r\n  }\r\n\r\n  prefetchAssets = async (): Promise<void> => {\r\n    const fetchAssetFile = this.fetchAssetFile;\r\n    if (!this.stateMachine || !fetchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    const totalAssetIds = this.stateMachine.states.reduce(\r\n      (assetIds: string[], stateID: string) => {\r\n        const state = this.stateMachine?.getStateByID(stateID);\r\n        if (state) {\r\n          return assetIds.concat(state.assets);\r\n        } else {\r\n          return [];\r\n        }\r\n      },\r\n      []\r\n    );\r\n\r\n    const uniqueAssetIds = Array.from(new Set(totalAssetIds));\r\n\r\n    return new Promise<void>((resolve, reject) => {\r\n      const fetchPromises = uniqueAssetIds.map((assetID) => {\r\n        return fetchAssetFile(assetID);\r\n      });\r\n\r\n      Promise.all(fetchPromises)\r\n        .then(() => {\r\n          resolve();\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, PrefetchAssetsUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"PrefetchAssetsUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/PrefetchAssetsUC.ts"],"names":[],"mappings":";;;AAmBA,gDAEC;AArBD,sCAKqB;AACrB,0DAA+D;AAC/D,qDAAkD;AAElD,MAAsB,gBAAiB,SAAQ,kBAAW;IAKxD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;;AAPH,4CAQC;AAPQ,qBAAI,GAAG,kBAAkB,CAAC;AASnC,SAAgB,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,gBAAgB;IACjD,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAmB,2BAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC;YACjE,EAAE,YAAY,CAAC;IACnB,CAAC;IAsCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QArC1C,mBAAc,GAAG,KAAK,IAAmB,EAAE;YACzC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC1C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CACnD,CAAC,QAAkB,EAAE,OAAe,EAAE,EAAE;gBACtC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,EACD,EAAE,CACH,CAAC;YAEF,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;YAE1D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;oBACnD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC,CAAC,CAAC;gBAEH,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;qBACvB,IAAI,CAAC,GAAG,EAAE;oBACT,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectRepo,\n  AppObjectUC\n} from \"@vived/core\";\nimport { HostStateMachine } from \"../../StateMachine/Entities\";\nimport { GetAssetFileUC } from \"./GetAssetFileUC\";\n\nexport abstract class PrefetchAssetsUC extends AppObjectUC {\n  static type = \"PrefetchAssetsUC\";\n\n  abstract prefetchAssets(): Promise<void>;\n\n  static get(appObjects: AppObjectRepo): PrefetchAssetsUC | undefined {\n    return getSingletonComponent(PrefetchAssetsUC.type, appObjects);\n  }\n}\n\nexport function makePrefetchAssets(appObject: AppObject): PrefetchAssetsUC {\n  return new HostAppObjectRepoImp(appObject);\n}\n\nclass HostAppObjectRepoImp extends PrefetchAssetsUC {\n  private get stateMachine() {\n    return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\n  }\n\n  private get fetchAssetFile() {\n    return this.getCachedSingleton<GetAssetFileUC>(GetAssetFileUC.type)\n      ?.getAssetFile;\n  }\n\n  prefetchAssets = async (): Promise<void> => {\n    const fetchAssetFile = this.fetchAssetFile;\n    if (!this.stateMachine || !fetchAssetFile) {\n      return Promise.reject();\n    }\n\n    const totalAssetIds = this.stateMachine.states.reduce(\n      (assetIds: string[], stateID: string) => {\n        const state = this.stateMachine?.getStateByID(stateID);\n        if (state) {\n          return assetIds.concat(state.assets);\n        } else {\n          return [];\n        }\n      },\n      []\n    );\n\n    const uniqueAssetIds = Array.from(new Set(totalAssetIds));\n\n    return new Promise<void>((resolve, reject) => {\n      const fetchPromises = uniqueAssetIds.map((assetID) => {\n        return fetchAssetFile(assetID);\n      });\n\n      Promise.all(fetchPromises)\n        .then(() => {\n          resolve();\n        })\n        .catch((e: Error) => {\n          this.warn(e.message);\n          reject(e);\n        });\n    });\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, PrefetchAssetsUC.type);\n    this.appObjects.registerSingleton(this);\n  }\n}\n"]}

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

@@ -1,4 +1,24 @@
 "use strict";
+/**
+ * UpdateAppAssetMetaUC.ts
+ *
+ * This use case handles updating asset metadata (name, description, archived status)
+ * for existing assets. It provides a complete workflow for modifying asset information
+ * with user feedback and sandbox state management.
+ *
+ * Key Concepts:
+ * - Updates asset metadata without affecting the actual file content
+ * - Uses API calls to persist metadata changes on the backend
+ * - Provides user feedback through spinner and error dialogs
+ * - Manages sandbox state transitions after successful updates
+ * - Supports partial metadata updates through DTO pattern
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Called with metadata DTO containing updated field values
+ * - Handles async operations with proper error handling and user feedback
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateAppAssetMetaUC = void 0;
 exports.makeUpdateAppAssetMetaUC = makeUpdateAppAssetMetaUC;
@@ -7,7 +27,20 @@ const AppSandboxEntity_1 = require("../../AppSandbox/Entities/AppSandboxEntity")
 const UCs_1 = require("../../Dialog/UCs");
 const PatchAssetMetaUC_1 = require("../../VivedAPI/UCs/PatchAssetMetaUC");
 const Entities_1 = require("../Entities");
+/**
+ * UpdateAppAssetMetaUC manages updating the metadata of individual assets.
+ *
+ * This use case provides the business logic for modifying asset metadata,
+ * handling API persistence, and managing user feedback during the operation.
+ */
 class UpdateAppAssetMetaUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves an UpdateAppAssetMetaUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns UpdateAppAssetMetaUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -23,29 +56,71 @@ class UpdateAppAssetMetaUC extends core_1.AppObjectUC {
     }
 }
 exports.UpdateAppAssetMetaUC = UpdateAppAssetMetaUC;
+/** Static type identifier for component registration */
 UpdateAppAssetMetaUC.type = "UpdateAppAssetMetaUC";
+/**
+ * Factory function to create a new UpdateAppAssetMetaUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new UpdateAppAssetMetaUC implementation instance
+ */
 function makeUpdateAppAssetMetaUC(appObject) {
     return new UpdateAppAssetMetaUCImp(appObject);
 }
+/**
+ * Private implementation of UpdateAppAssetMetaUC that handles the concrete metadata update operations.
+ *
+ * Key Implementation Details:
+ * - Gets asset entity from local AppObject components
+ * - Uses PatchAssetMetaUC for backend API persistence
+ * - Shows spinner dialogs during metadata update operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Updates local asset state after successful API operations
+ * - Manages sandbox state transitions for UI consistency
+ */
 class UpdateAppAssetMetaUCImp extends UpdateAppAssetMetaUC {
+    /** Gets the asset entity from the local AppObject this UC operates on */
     get asset() {
         return this.getCachedLocalComponent(Entities_1.AssetEntity.type);
     }
+    /** Gets the spinner dialog factory for showing user feedback during operations */
     get spinnerFactory() {
         return this.getCachedSingleton(UCs_1.MakeSpinnerDialogUC.type);
     }
+    /** Gets the API use case for patching asset metadata on the backend */
     get patchAssetMeta() {
         return this.getCachedSingleton(PatchAssetMetaUC_1.PatchAssetMetaUC.type)
             ?.doPatch;
     }
+    /** Gets the alert dialog factory for showing error messages to users */
     get alertFactory() {
         return this.getCachedSingleton(UCs_1.MakeAlertDialogUC.type);
     }
+    /** Gets the sandbox entity for managing application state transitions */
     get sandbox() {
         return this.getCachedSingleton(AppSandboxEntity_1.AppSandboxEntity.type);
     }
+    /**
+     * Initializes the UpdateAppAssetMetaUC.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, UpdateAppAssetMetaUC.type);
+        /**
+         * Updates the asset metadata with full error handling and user feedback.
+         *
+         * This method handles the complete metadata update workflow:
+         * 1. Validates the asset exists and required dependencies are available
+         * 2. Shows a spinner dialog during the API operation
+         * 3. Patches the metadata on the backend via API
+         * 4. Updates the local asset entity with the new metadata
+         * 5. Manages sandbox state transitions for UI consistency
+         * 6. Shows error dialogs and logs failures appropriately
+         *
+         * @param data - DTO containing the updated metadata fields
+         * @returns Promise that resolves when the operation completes (successfully or with handled error)
+         */
         this.updateMeta = (data) => {
             const asset = this.asset;
             if (!asset) {
@@ -56,6 +131,7 @@ class UpdateAppAssetMetaUCImp extends UpdateAppAssetMetaUC {
                 return Promise.reject(new Error("No Patch UC"));
             }
             const { archived, description, name } = data;
+            // Show user feedback during operation
             const spinnerDialog = this.spinnerFactory?.make({
                 title: "Asset Meta",
                 message: "Updating asset's meta..."
@@ -68,15 +144,18 @@ class UpdateAppAssetMetaUCImp extends UpdateAppAssetMetaUC {
                     name
                 })
                     .then(() => {
+                    // Update local asset state with new metadata
                     asset.archived = archived;
                     asset.name = name;
                     asset.description = description;
                     spinnerDialog?.close();
+                    // Manage sandbox state for UI consistency
                     if (this.sandbox)
                         this.sandbox.state = AppSandboxEntity_1.SandboxState.MOUNTED;
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Patch asset error: " + e.message);
                     spinnerDialog?.close();
                     const dialogDTO = {
@@ -85,7 +164,7 @@ class UpdateAppAssetMetaUCImp extends UpdateAppAssetMetaUC {
                         title: "Update Asset Error"
                     };
                     this.alertFactory?.make(dialogDTO);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };

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

@@ -1 +1 @@
-{"version":3,"file":"UpdateAppAssetMetaUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/UpdateAppAssetMetaUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n  AppSandboxEntity,\r\n  SandboxState\r\n} from \"../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { DialogAlertDTO } from \"../../Dialog/Entities\";\r\nimport { MakeAlertDialogUC, MakeSpinnerDialogUC } from \"../../Dialog/UCs\";\r\nimport { PatchAssetMetaUC } from \"../../VivedAPI/UCs/PatchAssetMetaUC\";\r\nimport { AssetEntity } from \"../Entities\";\r\n\r\nexport interface UpdateAppAssetMetaDTO {\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n}\r\n\r\nexport abstract class UpdateAppAssetMetaUC extends AppObjectUC {\r\n  static type = \"UpdateAppAssetMetaUC\";\r\n\r\n  abstract updateMeta(data: UpdateAppAssetMetaDTO): Promise<void>;\r\n\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): UpdateAppAssetMetaUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAppAssetMetaUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<UpdateAppAssetMetaUC>(\r\n      UpdateAppAssetMetaUC.type\r\n    );\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAppAssetMetaUC.get\",\r\n        \"App Object does not have UpdateAssetMetaUC\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return uc;\r\n  }\r\n}\r\n\r\nexport function makeUpdateAppAssetMetaUC(\r\n  appObject: AppObject\r\n): UpdateAppAssetMetaUC {\r\n  return new UpdateAppAssetMetaUCImp(appObject);\r\n}\r\n\r\nclass UpdateAppAssetMetaUCImp extends UpdateAppAssetMetaUC {\r\n  private get asset() {\r\n    return this.getCachedLocalComponent<AssetEntity>(AssetEntity.type);\r\n  }\r\n\r\n  private get spinnerFactory() {\r\n    return this.getCachedSingleton<MakeSpinnerDialogUC>(\r\n      MakeSpinnerDialogUC.type\r\n    );\r\n  }\r\n\r\n  private get patchAssetMeta() {\r\n    return this.getCachedSingleton<PatchAssetMetaUC>(PatchAssetMetaUC.type)\r\n      ?.doPatch;\r\n  }\r\n\r\n  private get alertFactory() {\r\n    return this.getCachedSingleton<MakeAlertDialogUC>(MakeAlertDialogUC.type);\r\n  }\r\n\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  updateMeta = (data: UpdateAppAssetMetaDTO): Promise<void> => {\r\n    const asset = this.asset;\r\n\r\n    if (!asset) {\r\n      return Promise.reject(new Error(\"No Asset Entity\"));\r\n    }\r\n\r\n    const patchAssetMeta = this.patchAssetMeta;\r\n    if (!patchAssetMeta) {\r\n      return Promise.reject(new Error(\"No Patch UC\"));\r\n    }\r\n\r\n    const { archived, description, name } = data;\r\n\r\n    const spinnerDialog = this.spinnerFactory?.make({\r\n      title: \"Asset Meta\",\r\n      message: \"Updating asset's meta...\"\r\n    });\r\n\r\n    return new Promise((resolve, reject) => {\r\n      patchAssetMeta({\r\n        archived,\r\n        description,\r\n        id: asset.id,\r\n        name\r\n      })\r\n        .then(() => {\r\n          asset.archived = archived;\r\n          asset.name = name;\r\n          asset.description = description;\r\n\r\n          spinnerDialog?.close();\r\n          if (this.sandbox) this.sandbox.state = SandboxState.MOUNTED;\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          this.error(\"Patch asset error: \" + e.message);\r\n          spinnerDialog?.close();\r\n          const dialogDTO: DialogAlertDTO = {\r\n            buttonLabel: \"OK\",\r\n            message: `Something went wrong when updating the assets meta. Check the console. ${e.message}`,\r\n            title: \"Update Asset Error\"\r\n          };\r\n          this.alertFactory?.make(dialogDTO);\r\n          resolve();\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UpdateAppAssetMetaUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"UpdateAppAssetMetaUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/UpdateAppAssetMetaUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * UpdateAppAssetMetaUC.ts\r\n *\r\n * This use case handles updating asset metadata (name, description, archived status)\r\n * for existing assets. It provides a complete workflow for modifying asset information\r\n * with user feedback and sandbox state management.\r\n *\r\n * Key Concepts:\r\n * - Updates asset metadata without affecting the actual file content\r\n * - Uses API calls to persist metadata changes on the backend\r\n * - Provides user feedback through spinner and error dialogs\r\n * - Manages sandbox state transitions after successful updates\r\n * - Supports partial metadata updates through DTO pattern\r\n *\r\n * Usage Patterns:\r\n * - Created per-asset during factory setup\r\n * - Accessed through static get() method with asset ID\r\n * - Called with metadata DTO containing updated field values\r\n * - Handles async operations with proper error handling and user feedback\r\n */\r\n\r\nimport { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n  AppSandboxEntity,\r\n  SandboxState\r\n} from \"../../AppSandbox/Entities/AppSandboxEntity\";\r\nimport { DialogAlertDTO } from \"../../Dialog/Entities\";\r\nimport { MakeAlertDialogUC, MakeSpinnerDialogUC } from \"../../Dialog/UCs\";\r\nimport { PatchAssetMetaUC } from \"../../VivedAPI/UCs/PatchAssetMetaUC\";\r\nimport { AssetEntity } from \"../Entities\";\r\n\r\n/**\r\n * Data transfer object for asset metadata updates.\r\n * Contains all the metadata fields that can be modified for an asset.\r\n */\r\nexport interface UpdateAppAssetMetaDTO {\r\n  /** Display name for the asset */\r\n  name: string;\r\n  /** Detailed description of the asset's purpose or content */\r\n  description: string;\r\n  /** Whether the asset should be archived (hidden from normal views) */\r\n  archived: boolean;\r\n}\r\n\r\n/**\r\n * UpdateAppAssetMetaUC manages updating the metadata of individual assets.\r\n *\r\n * This use case provides the business logic for modifying asset metadata,\r\n * handling API persistence, and managing user feedback during the operation.\r\n */\r\nexport abstract class UpdateAppAssetMetaUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"UpdateAppAssetMetaUC\";\r\n\r\n  /**\r\n   * Updates the metadata of the associated asset.\r\n   *\r\n   * @param data - DTO containing the updated metadata fields\r\n   * @returns Promise that resolves when the operation completes successfully\r\n   */\r\n  abstract updateMeta(data: UpdateAppAssetMetaDTO): Promise<void>;\r\n\r\n  /**\r\n   * Retrieves an UpdateAppAssetMetaUC component for a specific asset.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param appObjects - Repository for accessing app objects and components\r\n   * @returns UpdateAppAssetMetaUC instance or undefined if not found\r\n   */\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): UpdateAppAssetMetaUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAppAssetMetaUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<UpdateAppAssetMetaUC>(\r\n      UpdateAppAssetMetaUC.type\r\n    );\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAppAssetMetaUC.get\",\r\n        \"App Object does not have UpdateAssetMetaUC\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return uc;\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new UpdateAppAssetMetaUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)\r\n * @returns A new UpdateAppAssetMetaUC implementation instance\r\n */\r\nexport function makeUpdateAppAssetMetaUC(\r\n  appObject: AppObject\r\n): UpdateAppAssetMetaUC {\r\n  return new UpdateAppAssetMetaUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of UpdateAppAssetMetaUC that handles the concrete metadata update operations.\r\n *\r\n * Key Implementation Details:\r\n * - Gets asset entity from local AppObject components\r\n * - Uses PatchAssetMetaUC for backend API persistence\r\n * - Shows spinner dialogs during metadata update operations\r\n * - Handles errors gracefully with alert dialogs and logging\r\n * - Updates local asset state after successful API operations\r\n * - Manages sandbox state transitions for UI consistency\r\n */\r\nclass UpdateAppAssetMetaUCImp extends UpdateAppAssetMetaUC {\r\n  /** Gets the asset entity from the local AppObject this UC operates on */\r\n  private get asset() {\r\n    return this.getCachedLocalComponent<AssetEntity>(AssetEntity.type);\r\n  }\r\n\r\n  /** Gets the spinner dialog factory for showing user feedback during operations */\r\n  private get spinnerFactory() {\r\n    return this.getCachedSingleton<MakeSpinnerDialogUC>(\r\n      MakeSpinnerDialogUC.type\r\n    );\r\n  }\r\n\r\n  /** Gets the API use case for patching asset metadata on the backend */\r\n  private get patchAssetMeta() {\r\n    return this.getCachedSingleton<PatchAssetMetaUC>(PatchAssetMetaUC.type)\r\n      ?.doPatch;\r\n  }\r\n\r\n  /** Gets the alert dialog factory for showing error messages to users */\r\n  private get alertFactory() {\r\n    return this.getCachedSingleton<MakeAlertDialogUC>(MakeAlertDialogUC.type);\r\n  }\r\n\r\n  /** Gets the sandbox entity for managing application state transitions */\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<AppSandboxEntity>(AppSandboxEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Updates the asset metadata with full error handling and user feedback.\r\n   *\r\n   * This method handles the complete metadata update workflow:\r\n   * 1. Validates the asset exists and required dependencies are available\r\n   * 2. Shows a spinner dialog during the API operation\r\n   * 3. Patches the metadata on the backend via API\r\n   * 4. Updates the local asset entity with the new metadata\r\n   * 5. Manages sandbox state transitions for UI consistency\r\n   * 6. Shows error dialogs and logs failures appropriately\r\n   *\r\n   * @param data - DTO containing the updated metadata fields\r\n   * @returns Promise that resolves when the operation completes (successfully or with handled error)\r\n   */\r\n  updateMeta = (data: UpdateAppAssetMetaDTO): Promise<void> => {\r\n    const asset = this.asset;\r\n\r\n    if (!asset) {\r\n      return Promise.reject(new Error(\"No Asset Entity\"));\r\n    }\r\n\r\n    const patchAssetMeta = this.patchAssetMeta;\r\n    if (!patchAssetMeta) {\r\n      return Promise.reject(new Error(\"No Patch UC\"));\r\n    }\r\n\r\n    const { archived, description, name } = data;\r\n\r\n    // Show user feedback during operation\r\n    const spinnerDialog = this.spinnerFactory?.make({\r\n      title: \"Asset Meta\",\r\n      message: \"Updating asset's meta...\"\r\n    });\r\n\r\n    return new Promise((resolve, reject) => {\r\n      patchAssetMeta({\r\n        archived,\r\n        description,\r\n        id: asset.id,\r\n        name\r\n      })\r\n        .then(() => {\r\n          // Update local asset state with new metadata\r\n          asset.archived = archived;\r\n          asset.name = name;\r\n          asset.description = description;\r\n\r\n          spinnerDialog?.close();\r\n\r\n          // Manage sandbox state for UI consistency\r\n          if (this.sandbox) this.sandbox.state = SandboxState.MOUNTED;\r\n\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          // Handle errors with user feedback\r\n          this.error(\"Patch asset error: \" + e.message);\r\n          spinnerDialog?.close();\r\n          const dialogDTO: DialogAlertDTO = {\r\n            buttonLabel: \"OK\",\r\n            message: `Something went wrong when updating the assets meta. Check the console. ${e.message}`,\r\n            title: \"Update Asset Error\"\r\n          };\r\n          this.alertFactory?.make(dialogDTO);\r\n          resolve(); // Resolve to prevent unhandled rejections, error is already handled\r\n        });\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Initializes the UpdateAppAssetMetaUC.\r\n   *\r\n   * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UpdateAppAssetMetaUC.type);\r\n  }\r\n}\r\n"]}