@vived/host 4.9.1 → 4.11.0

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

@@ -1 +1 @@
-{"version":3,"file":"PrefetchAssetsUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/PrefetchAssetsUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,OAAgB,gBAAiB,SAAQ,WAAW;IAKxD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;;AANM,qBAAI,GAAG,kBAAkB,CAAC;AASnC,MAAM,UAAU,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,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,cAAc,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":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,OAAgB,gBAAiB,SAAQ,WAAW;IAKxD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;;AANM,qBAAI,GAAG,kBAAkB,CAAC;AASnC,MAAM,UAAU,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,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAY,cAAc;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,cAAc,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/esm/Assets/UCs/UpdateAppAssetMetaUC.js

@@ -1,9 +1,42 @@
+/**
+ * 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
+ */
 import { AppObjectUC } from "@vived/core";
 import { AppSandboxEntity, SandboxState } from "../../AppSandbox/Entities/AppSandboxEntity";
 import { MakeAlertDialogUC, MakeSpinnerDialogUC } from "../../Dialog/UCs";
 import { PatchAssetMetaUC } from "../../VivedAPI/UCs/PatchAssetMetaUC";
 import { AssetEntity } from "../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.
+ */
 export class UpdateAppAssetMetaUC extends 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) {
@@ -18,29 +51,71 @@ export class UpdateAppAssetMetaUC extends AppObjectUC {
         return uc;
     }
 }
+/** 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
+ */
 export 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(AssetEntity.type);
     }
+    /** Gets the spinner dialog factory for showing user feedback during operations */
     get spinnerFactory() {
         return this.getCachedSingleton(MakeSpinnerDialogUC.type);
     }
+    /** Gets the API use case for patching asset metadata on the backend */
     get patchAssetMeta() {
         return this.getCachedSingleton(PatchAssetMetaUC.type)
             ?.doPatch;
     }
+    /** Gets the alert dialog factory for showing error messages to users */
     get alertFactory() {
         return this.getCachedSingleton(MakeAlertDialogUC.type);
     }
+    /** Gets the sandbox entity for managing application state transitions */
     get sandbox() {
         return this.getCachedSingleton(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) {
@@ -51,6 +126,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..."
@@ -63,15 +139,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 = SandboxState.MOUNTED;
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Patch asset error: " + e.message);
                     spinnerDialog?.close();
                     const dialogDTO = {
@@ -80,7 +159,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/esm/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"]}

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

@@ -1,8 +1,41 @@
+/**
+ * UpdateAssetFileUC.ts
+ *
+ * This use case handles updating the file content of existing assets while
+ * preserving metadata and relationships. It provides a complete workflow
+ * for replacing asset files with user feedback and error handling.
+ *
+ * Key Concepts:
+ * - Updates asset file content while preserving metadata and relationships
+ * - Uses API calls to persist file changes on the backend
+ * - Provides user feedback through spinner and error dialogs
+ * - Manages local asset state updates after successful operations
+ * - Handles filename updates from backend processing
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Called with new File object to replace existing asset content
+ * - Handles async operations with proper error handling and user feedback
+ */
 import { AppObjectUC } from "@vived/core";
 import { MakeAlertDialogUC, MakeSpinnerDialogUC } from "../../Dialog";
 import { PatchAssetFileUC } from "../../VivedAPI";
 import { AssetEntity } from "../Entities/AssetEntity";
+/**
+ * UpdateAssetFileUC manages updating the file content of individual assets.
+ *
+ * This use case provides the business logic for replacing asset files,
+ * handling API persistence, and managing user feedback during the operation.
+ */
 export class UpdateAssetFileUC extends AppObjectUC {
+    /**
+     * Retrieves an UpdateAssetFileUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns UpdateAssetFileUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -17,17 +50,57 @@ export class UpdateAssetFileUC extends AppObjectUC {
         return uc;
     }
 }
+/** Static type identifier for component registration */
 UpdateAssetFileUC.type = "UpdateAssetFileUC";
+/**
+ * Factory function to create a new UpdateAssetFileUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new UpdateAssetFileUC implementation instance
+ */
 export function makeUpdateAssetFileUC(appObject) {
     return new UpdateAssetFileUCImp(appObject);
 }
+/**
+ * Private implementation of UpdateAssetFileUC that handles the concrete file update operations.
+ *
+ * Key Implementation Details:
+ * - Validates asset entity existence before operations
+ * - Uses PatchAssetFileUC for backend API persistence
+ * - Shows spinner dialogs during file upload operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Updates local asset state including file content and filename
+ * - Preserves asset metadata and relationships during file replacement
+ */
 class UpdateAssetFileUCImp extends UpdateAssetFileUC {
+    /**
+     * Gets the API use case for patching asset files on the backend
+     * Cached for efficient repeated access during operations
+     */
     get patchAssetFile() {
         return this.getCachedSingleton(PatchAssetFileUC.type)
             ?.doPatch;
     }
+    /**
+     * Initializes the UpdateAssetFileUC with validation of required components.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, UpdateAssetFileUC.type);
+        /**
+         * Updates the asset file with full error handling and user feedback.
+         *
+         * This method handles the complete file update workflow:
+         * 1. Validates the asset exists
+         * 2. Shows a spinner dialog during the API operation
+         * 3. Uploads the new file to the backend via API
+         * 4. Updates the local asset with the new file and filename
+         * 5. Shows error dialogs and logs failures appropriately
+         *
+         * @param file - The new file to replace the existing asset content
+         * @returns Promise that resolves when the operation completes (successfully or with handled error)
+         */
         this.updateFile = (file) => {
             const asset = this.asset;
             if (!asset) {
@@ -37,6 +110,7 @@ class UpdateAssetFileUCImp extends UpdateAssetFileUC {
             if (!patchAssetFile) {
                 return Promise.reject();
             }
+            // Show user feedback during operation
             const spinnerDialog = MakeSpinnerDialogUC.make({
                 title: "Asset File",
                 message: "Updating asset's file..."
@@ -44,12 +118,14 @@ class UpdateAssetFileUCImp extends UpdateAssetFileUC {
             return new Promise((resolve, reject) => {
                 patchAssetFile(asset.id, file)
                     .then((newFilename) => {
+                    // Update local asset state with new file and filename
                     asset.setFile(file);
                     asset.filename = newFilename;
                     spinnerDialog?.close();
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Patch asset file error: " + e.message);
                     spinnerDialog?.close();
                     const dialogDTO = {
@@ -58,7 +134,7 @@ class UpdateAssetFileUCImp extends UpdateAssetFileUC {
                         title: "Update Asset File Error"
                     };
                     MakeAlertDialogUC.make(dialogDTO, this.appObjects);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };

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

@@ -1 +1 @@
-{"version":3,"file":"UpdateAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/UpdateAssetFileUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n  DialogAlertDTO,\r\n  DialogQueue,\r\n  MakeAlertDialogUC,\r\n  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { PatchAssetFileUC } from \"../../VivedAPI\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\nexport interface UpdateAssetMetaDTO {\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n}\r\n\r\nexport abstract class UpdateAssetFileUC extends AppObjectUC {\r\n  static type = \"UpdateAssetFileUC\";\r\n\r\n  abstract updateFile(file: File): Promise<void>;\r\n\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): UpdateAssetFileUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAssetFileUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<UpdateAssetFileUC>(\r\n      UpdateAssetFileUC.type\r\n    );\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAssetFileUC.get\",\r\n        \"App Object does not have UpdateAssetFileUC\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return uc;\r\n  }\r\n}\r\n\r\nexport function makeUpdateAssetFileUC(appObject: AppObject): UpdateAssetFileUC {\r\n  return new UpdateAssetFileUCImp(appObject);\r\n}\r\n\r\nclass UpdateAssetFileUCImp extends UpdateAssetFileUC {\r\n  private asset?: AssetEntity;\r\n\r\n  private get patchAssetFile() {\r\n    return this.getCachedSingleton<PatchAssetFileUC>(PatchAssetFileUC.type)\r\n      ?.doPatch;\r\n  }\r\n\r\n  updateFile = (file: File): 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 patchAssetFile = this.patchAssetFile;\r\n    if (!patchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    const spinnerDialog = MakeSpinnerDialogUC.make(\r\n      {\r\n        title: \"Asset File\",\r\n        message: \"Updating asset's file...\"\r\n      },\r\n      this.appObjects\r\n    );\r\n\r\n    return new Promise((resolve, reject) => {\r\n      patchAssetFile(asset.id, file)\r\n        .then((newFilename) => {\r\n          asset.setFile(file);\r\n          asset.filename = newFilename;\r\n\r\n          spinnerDialog?.close();\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          this.error(\"Patch asset file 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 asset's file. Check the console. ${e.message}`,\r\n            title: \"Update Asset File Error\"\r\n          };\r\n          MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n          resolve();\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UpdateAssetFileUC.type);\r\n\r\n    this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!this.asset) {\r\n      this.error(\r\n        \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n      );\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"UpdateAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/UpdateAssetFileUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * UpdateAssetFileUC.ts\r\n *\r\n * This use case handles updating the file content of existing assets while\r\n * preserving metadata and relationships. It provides a complete workflow\r\n * for replacing asset files with user feedback and error handling.\r\n *\r\n * Key Concepts:\r\n * - Updates asset file content while preserving metadata and relationships\r\n * - Uses API calls to persist file changes on the backend\r\n * - Provides user feedback through spinner and error dialogs\r\n * - Manages local asset state updates after successful operations\r\n * - Handles filename updates from backend processing\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 new File object to replace existing asset content\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  DialogAlertDTO,\r\n  DialogQueue,\r\n  MakeAlertDialogUC,\r\n  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { PatchAssetFileUC } from \"../../VivedAPI\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/**\r\n * Data transfer object for asset metadata updates.\r\n * Contains the basic metadata fields that can be modified for an asset.\r\n */\r\nexport interface UpdateAssetMetaDTO {\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 * UpdateAssetFileUC manages updating the file content of individual assets.\r\n *\r\n * This use case provides the business logic for replacing asset files,\r\n * handling API persistence, and managing user feedback during the operation.\r\n */\r\nexport abstract class UpdateAssetFileUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"UpdateAssetFileUC\";\r\n\r\n  /**\r\n   * Updates the file content of the associated asset.\r\n   *\r\n   * @param file - The new file to replace the existing asset content\r\n   * @returns Promise that resolves when the operation completes successfully\r\n   */\r\n  abstract updateFile(file: File): Promise<void>;\r\n\r\n  /**\r\n   * Retrieves an UpdateAssetFileUC 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 UpdateAssetFileUC instance or undefined if not found\r\n   */\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): UpdateAssetFileUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAssetFileUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<UpdateAssetFileUC>(\r\n      UpdateAssetFileUC.type\r\n    );\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"UpdateAssetFileUC.get\",\r\n        \"App Object does not have UpdateAssetFileUC\"\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 UpdateAssetFileUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)\r\n * @returns A new UpdateAssetFileUC implementation instance\r\n */\r\nexport function makeUpdateAssetFileUC(appObject: AppObject): UpdateAssetFileUC {\r\n  return new UpdateAssetFileUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of UpdateAssetFileUC that handles the concrete file update operations.\r\n *\r\n * Key Implementation Details:\r\n * - Validates asset entity existence before operations\r\n * - Uses PatchAssetFileUC for backend API persistence\r\n * - Shows spinner dialogs during file upload operations\r\n * - Handles errors gracefully with alert dialogs and logging\r\n * - Updates local asset state including file content and filename\r\n * - Preserves asset metadata and relationships during file replacement\r\n */\r\nclass UpdateAssetFileUCImp extends UpdateAssetFileUC {\r\n  /** The asset entity this use case operates on */\r\n  private asset?: AssetEntity;\r\n\r\n  /**\r\n   * Gets the API use case for patching asset files on the backend\r\n   * Cached for efficient repeated access during operations\r\n   */\r\n  private get patchAssetFile() {\r\n    return this.getCachedSingleton<PatchAssetFileUC>(PatchAssetFileUC.type)\r\n      ?.doPatch;\r\n  }\r\n\r\n  /**\r\n   * Updates the asset file with full error handling and user feedback.\r\n   *\r\n   * This method handles the complete file update workflow:\r\n   * 1. Validates the asset exists\r\n   * 2. Shows a spinner dialog during the API operation\r\n   * 3. Uploads the new file to the backend via API\r\n   * 4. Updates the local asset with the new file and filename\r\n   * 5. Shows error dialogs and logs failures appropriately\r\n   *\r\n   * @param file - The new file to replace the existing asset content\r\n   * @returns Promise that resolves when the operation completes (successfully or with handled error)\r\n   */\r\n  updateFile = (file: File): 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 patchAssetFile = this.patchAssetFile;\r\n    if (!patchAssetFile) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Show user feedback during operation\r\n    const spinnerDialog = MakeSpinnerDialogUC.make(\r\n      {\r\n        title: \"Asset File\",\r\n        message: \"Updating asset's file...\"\r\n      },\r\n      this.appObjects\r\n    );\r\n\r\n    return new Promise((resolve, reject) => {\r\n      patchAssetFile(asset.id, file)\r\n        .then((newFilename) => {\r\n          // Update local asset state with new file and filename\r\n          asset.setFile(file);\r\n          asset.filename = newFilename;\r\n\r\n          spinnerDialog?.close();\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          // Handle errors with user feedback\r\n          this.error(\"Patch asset file 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 asset's file. Check the console. ${e.message}`,\r\n            title: \"Update Asset File Error\"\r\n          };\r\n          MakeAlertDialogUC.make(dialogDTO, this.appObjects);\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 UpdateAssetFileUC with validation of required components.\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, UpdateAssetFileUC.type);\r\n\r\n    this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!this.asset) {\r\n      this.error(\r\n        \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n      );\r\n    }\r\n  }\r\n}\r\n"]}

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

@@ -1,3 +1,24 @@
+/**
+ * Assets Use Cases Index
+ *
+ * This module exports all use case classes for the Assets feature.
+ * Use cases contain the business logic for asset operations and coordinate
+ * between entities, external services, and user interface components.
+ *
+ * Key Concepts:
+ * - Use cases implement specific business operations and workflows
+ * - They coordinate between entities, APIs, and UI components
+ * - Each UC handles validation, error management, and state updates
+ * - Singleton UCs manage system-wide operations, per-asset UCs handle individual items
+ * - UCs provide clean interfaces for controllers and other components
+ *
+ * Available Use Cases:
+ * - Asset lifecycle: create, archive, delete, update
+ * - File management: download, fetch, update file content
+ * - Metadata management: update asset information and properties
+ * - Collection management: get assets for apps, prefetch for performance
+ * - Caching and optimization: blob URL generation, file caching strategies
+ */
 export * from "./ArchiveAssetUC";
 export * from "./DeleteAssetUC";
 export * from "./DownloadAssetFileUC";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC","sourcesContent":["export * from \"./ArchiveAssetUC\";\r\nexport * from \"./DeleteAssetUC\";\r\nexport * from \"./DownloadAssetFileUC\";\r\nexport * from \"./EditAppAssetUC\";\r\nexport * from \"./GetAppAssetsUC\";\r\nexport * from \"./GetAssetBlobURLUC\";\r\nexport * from \"./GetAssetFileUC\";\r\nexport * from \"./GetAssetUC\";\r\nexport * from \"./NewAppAssetUC\";\r\nexport * from \"./NewAssetUC\";\r\nexport * from \"./PrefetchAssetsUC\";\r\nexport * from \"./UpdateAppAssetMetaUC\";\r\nexport * from \"./UpdateAssetFileUC\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC","sourcesContent":["/**\r\n * Assets Use Cases Index\r\n *\r\n * This module exports all use case classes for the Assets feature.\r\n * Use cases contain the business logic for asset operations and coordinate\r\n * between entities, external services, and user interface components.\r\n *\r\n * Key Concepts:\r\n * - Use cases implement specific business operations and workflows\r\n * - They coordinate between entities, APIs, and UI components\r\n * - Each UC handles validation, error management, and state updates\r\n * - Singleton UCs manage system-wide operations, per-asset UCs handle individual items\r\n * - UCs provide clean interfaces for controllers and other components\r\n *\r\n * Available Use Cases:\r\n * - Asset lifecycle: create, archive, delete, update\r\n * - File management: download, fetch, update file content\r\n * - Metadata management: update asset information and properties\r\n * - Collection management: get assets for apps, prefetch for performance\r\n * - Caching and optimization: blob URL generation, file caching strategies\r\n */\r\n\r\nexport * from \"./ArchiveAssetUC\";\r\nexport * from \"./DeleteAssetUC\";\r\nexport * from \"./DownloadAssetFileUC\";\r\nexport * from \"./EditAppAssetUC\";\r\nexport * from \"./GetAppAssetsUC\";\r\nexport * from \"./GetAssetBlobURLUC\";\r\nexport * from \"./GetAssetFileUC\";\r\nexport * from \"./GetAssetUC\";\r\nexport * from \"./NewAppAssetUC\";\r\nexport * from \"./NewAssetUC\";\r\nexport * from \"./PrefetchAssetsUC\";\r\nexport * from \"./UpdateAppAssetMetaUC\";\r\nexport * from \"./UpdateAssetFileUC\";\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Assets/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["export * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Factories\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Assets/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["export * from \"./Adapters\";\nexport * from \"./Controllers\";\nexport * from \"./Entities\";\nexport * from \"./Factories\";\nexport * from \"./Mocks\";\nexport * from \"./PMs\";\nexport * from \"./UCs\";\n"]}

package/dist/esm/Cache/Controllers/clearCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"clearCache.js","sourceRoot":"","sources":["../../../../src/Cache/Controllers/clearCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,UAAU,UAAU,CAAC,UAAyB;IAClD,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,UAAU,CAAC,aAAa,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { CacheEntity } from \"../Entities/CacheEntity\";\r\n\r\nexport function clearCache(appObjects: AppObjectRepo): Promise<void> {\r\n  const cacheEntity = CacheEntity.get(appObjects);\r\n  if (!cacheEntity) {\r\n    appObjects.submitWarning(\"clearCache\", \"Unable to find CacheEntity\");\r\n    return Promise.reject();\r\n  }\r\n\r\n  return cacheEntity.clear();\r\n}\r\n"]}
+{"version":3,"file":"clearCache.js","sourceRoot":"","sources":["../../../../src/Cache/Controllers/clearCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,UAAU,UAAU,CAAC,UAAyB;IAClD,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,UAAU,CAAC,aAAa,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\nimport { CacheEntity } from \"../Entities/CacheEntity\";\n\nexport function clearCache(appObjects: AppObjectRepo): Promise<void> {\n  const cacheEntity = CacheEntity.get(appObjects);\n  if (!cacheEntity) {\n    appObjects.submitWarning(\"clearCache\", \"Unable to find CacheEntity\");\n    return Promise.reject();\n  }\n\n  return cacheEntity.clear();\n}\n"]}

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

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

package/dist/esm/Cache/Entities/AssetCacheEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetCacheEntity.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/AssetCacheEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { CacheEntity } from \"./CacheEntity\";\r\n\r\n/**\r\n * AssetCacheEntity provides functionality for caching binary assets in the application.\r\n * It serves as a specialized cache storage for assets such as images, videos, or other binary content.\r\n * This entity is implemented as a singleton component and requires a CacheEntity instance to function.\r\n */\r\nexport abstract class AssetCacheEntity extends AppObjectEntity {\r\n  static readonly type = \"AssetCacheEntity\";\r\n\r\n  /**\r\n   * Retrieves an asset from the cache by its unique identifier.\r\n   * @param assetId - The unique identifier of the asset to retrieve\r\n   * @returns A Promise that resolves to the cached Blob if found, otherwise undefined\r\n   */\r\n  abstract getAsset(assetId: string): Promise<Blob | undefined>;\r\n\r\n  /**\r\n   * Stores an asset in the cache with the specified identifier.\r\n   * @param assetId - The unique identifier to associate with the asset\r\n   * @param content - The binary content to cache as a Blob\r\n   * @param contentType - Optional MIME type of the content\r\n   * @returns A Promise that resolves when the asset has been stored\r\n   */\r\n  abstract storeAsset(\r\n    assetId: string,\r\n    content: Blob,\r\n    contentType?: string\r\n  ): Promise<void>;\r\n\r\n  /**\r\n   * Checks if an asset exists in the cache.\r\n   * @param assetId - The unique identifier of the asset to check\r\n   * @returns A Promise that resolves to true if the asset exists, otherwise false\r\n   */\r\n  abstract hasAsset(assetId: string): Promise<boolean>;\r\n\r\n  /**\r\n   * Removes an asset from the cache.\r\n   * @param assetId - The unique identifier of the asset to invalidate\r\n   * @returns A Promise that resolves when the asset has been invalidated\r\n   */\r\n  abstract invalidateAsset(assetId: string): Promise<void>;\r\n\r\n  /**\r\n   * Gets the singleton instance of AssetCacheEntity from the app objects repository.\r\n   * @param appObjects - The app objects repository\r\n   * @returns The AssetCacheEntity instance if found, otherwise undefined\r\n   */\r\n  static get(appObjects: AppObjectRepo): AssetCacheEntity | undefined {\r\n    return getSingletonComponent<AssetCacheEntity>(\r\n      AssetCacheEntity.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\nexport function makeAssetCacheEntity(appObject: AppObject): AssetCacheEntity {\r\n  return new AssetCacheEntityImp(appObject);\r\n}\r\n\r\ntype AssetCacheMetadata = {\r\n  assetId: string;\r\n  timestamp: number;\r\n  contentType?: string;\r\n};\r\n\r\nclass AssetCacheEntityImp extends AssetCacheEntity {\r\n  private get cacheEntity(): CacheEntity | undefined {\r\n    return this.getCachedSingleton<CacheEntity>(CacheEntity.type);\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AssetCacheEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  async getAsset(assetId: string): Promise<Blob | undefined> {\r\n    const cacheKey = this.generateCacheKey(assetId);\r\n\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return undefined;\r\n    }\r\n\r\n    try {\r\n      const { value, metadata } = await cacheEntity.get(cacheKey);\r\n      if (value instanceof Blob) {\r\n        return value;\r\n      }\r\n\r\n      // Handle case where the value is stored as an ArrayBuffer\r\n      if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {\r\n        const contentType = metadata?.contentType || \"application/octet-stream\";\r\n        return new Blob([value], { type: contentType });\r\n      }\r\n\r\n      this.warn(\"Cached asset is not a Blob or ArrayBuffer\");\r\n      return undefined;\r\n    } catch (e) {\r\n      return undefined;\r\n    }\r\n  }\r\n\r\n  async storeAsset(\r\n    assetId: string,\r\n    content: Blob,\r\n    contentType?: string\r\n  ): Promise<void> {\r\n    const cacheKey = this.generateCacheKey(assetId);\r\n\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return;\r\n    }\r\n\r\n    const metadata: AssetCacheMetadata = {\r\n      assetId,\r\n      timestamp: Date.now(),\r\n      contentType: contentType || content.type\r\n    };\r\n\r\n    await cacheEntity.store(cacheKey, content, metadata);\r\n  }\r\n\r\n  async hasAsset(assetId: string): Promise<boolean> {\r\n    const cacheKey = this.generateCacheKey(assetId);\r\n\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return false;\r\n    }\r\n\r\n    return await cacheEntity.has(cacheKey);\r\n  }\r\n\r\n  async invalidateAsset(assetId: string): Promise<void> {\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return;\r\n    }\r\n\r\n    const cacheKey = this.generateCacheKey(assetId);\r\n    await cacheEntity.invalidate(cacheKey);\r\n  }\r\n\r\n  private generateCacheKey(assetId: string): string {\r\n    return `asset:${assetId}`;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AssetCacheEntity.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/AssetCacheEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  AppObject,\n  AppObjectEntity,\n  AppObjectRepo,\n  getSingletonComponent\n} from \"@vived/core\";\nimport { CacheEntity } from \"./CacheEntity\";\n\n/**\n * AssetCacheEntity provides functionality for caching binary assets in the application.\n * It serves as a specialized cache storage for assets such as images, videos, or other binary content.\n * This entity is implemented as a singleton component and requires a CacheEntity instance to function.\n */\nexport abstract class AssetCacheEntity extends AppObjectEntity {\n  static readonly type = \"AssetCacheEntity\";\n\n  /**\n   * Retrieves an asset from the cache by its unique identifier.\n   * @param assetId - The unique identifier of the asset to retrieve\n   * @returns A Promise that resolves to the cached Blob if found, otherwise undefined\n   */\n  abstract getAsset(assetId: string): Promise<Blob | undefined>;\n\n  /**\n   * Stores an asset in the cache with the specified identifier.\n   * @param assetId - The unique identifier to associate with the asset\n   * @param content - The binary content to cache as a Blob\n   * @param contentType - Optional MIME type of the content\n   * @returns A Promise that resolves when the asset has been stored\n   */\n  abstract storeAsset(\n    assetId: string,\n    content: Blob,\n    contentType?: string\n  ): Promise<void>;\n\n  /**\n   * Checks if an asset exists in the cache.\n   * @param assetId - The unique identifier of the asset to check\n   * @returns A Promise that resolves to true if the asset exists, otherwise false\n   */\n  abstract hasAsset(assetId: string): Promise<boolean>;\n\n  /**\n   * Removes an asset from the cache.\n   * @param assetId - The unique identifier of the asset to invalidate\n   * @returns A Promise that resolves when the asset has been invalidated\n   */\n  abstract invalidateAsset(assetId: string): Promise<void>;\n\n  /**\n   * Gets the singleton instance of AssetCacheEntity from the app objects repository.\n   * @param appObjects - The app objects repository\n   * @returns The AssetCacheEntity instance if found, otherwise undefined\n   */\n  static get(appObjects: AppObjectRepo): AssetCacheEntity | undefined {\n    return getSingletonComponent<AssetCacheEntity>(\n      AssetCacheEntity.type,\n      appObjects\n    );\n  }\n}\n\nexport function makeAssetCacheEntity(appObject: AppObject): AssetCacheEntity {\n  return new AssetCacheEntityImp(appObject);\n}\n\ntype AssetCacheMetadata = {\n  assetId: string;\n  timestamp: number;\n  contentType?: string;\n};\n\nclass AssetCacheEntityImp extends AssetCacheEntity {\n  private get cacheEntity(): CacheEntity | undefined {\n    return this.getCachedSingleton<CacheEntity>(CacheEntity.type);\n  }\n\n  constructor(appObject: AppObject) {\n    super(appObject, AssetCacheEntity.type);\n    this.appObjects.registerSingleton(this);\n  }\n\n  async getAsset(assetId: string): Promise<Blob | undefined> {\n    const cacheKey = this.generateCacheKey(assetId);\n\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return undefined;\n    }\n\n    try {\n      const { value, metadata } = await cacheEntity.get(cacheKey);\n      if (value instanceof Blob) {\n        return value;\n      }\n\n      // Handle case where the value is stored as an ArrayBuffer\n      if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {\n        const contentType = metadata?.contentType || \"application/octet-stream\";\n        return new Blob([value], { type: contentType });\n      }\n\n      this.warn(\"Cached asset is not a Blob or ArrayBuffer\");\n      return undefined;\n    } catch (e) {\n      return undefined;\n    }\n  }\n\n  async storeAsset(\n    assetId: string,\n    content: Blob,\n    contentType?: string\n  ): Promise<void> {\n    const cacheKey = this.generateCacheKey(assetId);\n\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return;\n    }\n\n    const metadata: AssetCacheMetadata = {\n      assetId,\n      timestamp: Date.now(),\n      contentType: contentType || content.type\n    };\n\n    await cacheEntity.store(cacheKey, content, metadata);\n  }\n\n  async hasAsset(assetId: string): Promise<boolean> {\n    const cacheKey = this.generateCacheKey(assetId);\n\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return false;\n    }\n\n    return await cacheEntity.has(cacheKey);\n  }\n\n  async invalidateAsset(assetId: string): Promise<void> {\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return;\n    }\n\n    const cacheKey = this.generateCacheKey(assetId);\n    await cacheEntity.invalidate(cacheKey);\n  }\n\n  private generateCacheKey(assetId: string): string {\n    return `asset:${assetId}`;\n  }\n}\n"]}

package/dist/esm/Cache/Entities/CacheEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"CacheEntity.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/CacheEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,OAAgB,WAAY,SAAQ,eAAe;IAoDvD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AA1De,gBAAI,GAAG,aAAa,CAAC;AA6DvC,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,cAAe,SAAQ,WAAW;IAItC,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAJ7B,UAAK,GACX,IAAI,GAAG,EAAE,CAAC;QAIV,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW;QAEX,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAGxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,KAAU,EACV,QAA8B;QAE9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\n\r\n/**\r\n * Abstract entity that provides caching functionality for the application.\r\n * CacheEntity is a singleton component that stores key-value pairs with optional metadata.\r\n * It provides methods for storing, retrieving, checking existence, and invalidating cached values.\r\n */\r\nexport abstract class CacheEntity extends AppObjectEntity {\r\n  static readonly type = \"CacheEntity\";\r\n\r\n  /**\r\n   * Retrieves a value from the cache by its key.\r\n   * @param key - The unique identifier for the cached item\r\n   * @returns Promise resolving to an object containing the cached value and optional metadata\r\n   * @throws Error if the key does not exist in the cache\r\n   */\r\n  abstract get(\r\n    key: string\r\n  ): Promise<{ value: any; metadata?: Record<string, any> }>;\r\n\r\n  /**\r\n   * Stores a value in the cache with an associated key and optional metadata.\r\n   * @param key - The unique identifier for the cached item\r\n   * @param value - The value to cache\r\n   * @param metadata - Optional metadata associated with the cached value\r\n   * @returns Promise that resolves when the value has been stored\r\n   */\r\n  abstract store(\r\n    key: string,\r\n    value: any,\r\n    metadata?: Record<string, any>\r\n  ): Promise<void>;\r\n\r\n  /**\r\n   * Checks if a key exists in the cache.\r\n   * @param key - The key to check\r\n   * @returns Promise resolving to boolean indicating if the key exists\r\n   */\r\n  abstract has(key: string): Promise<boolean>;\r\n\r\n  /**\r\n   * Removes an item from the cache by its key.\r\n   * @param key - The key to remove\r\n   * @returns Promise that resolves when the key has been invalidated\r\n   */\r\n  abstract invalidate(key: string): Promise<void>;\r\n\r\n  /**\r\n   * Removes all items from the cache.\r\n   * @returns Promise that resolves when the cache has been cleared\r\n   */\r\n  abstract clear(): Promise<void>;\r\n\r\n  /**\r\n   * Gets the number of items in the cache.\r\n   * @returns Promise resolving to the number of cached items\r\n   */\r\n  abstract size(): Promise<number>;\r\n\r\n  /**\r\n   * Gets the singleton instance of CacheEntity from the AppObjectRepo.\r\n   * @param appObjects - The application object repository\r\n   * @returns The CacheEntity instance or undefined if not registered\r\n   */\r\n  static get(appObjects: AppObjectRepo): CacheEntity | undefined {\r\n    return getSingletonComponent<CacheEntity>(CacheEntity.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeCacheEntity(appObject: AppObject): CacheEntity {\r\n  return new CacheEntityImp(appObject);\r\n}\r\n\r\nclass CacheEntityImp extends CacheEntity {\r\n  private cache: Map<string, { value: any; metadata?: Record<string, any> }> =\r\n    new Map();\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, CacheEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  async get(\r\n    key: string\r\n  ): Promise<{ value: any; metadata?: Record<string, any> }> {\r\n    if (!this.cache.has(key)) {\r\n      throw new Error(`Cache key not found: ${key}`);\r\n    }\r\n    return this.cache.get(key) as {\r\n      value: any;\r\n      metadata?: Record<string, any>;\r\n    };\r\n  }\r\n\r\n  async store(\r\n    key: string,\r\n    value: any,\r\n    metadata?: Record<string, any>\r\n  ): Promise<void> {\r\n    this.cache.set(key, { value, metadata });\r\n  }\r\n\r\n  async has(key: string): Promise<boolean> {\r\n    return this.cache.has(key);\r\n  }\r\n\r\n  async invalidate(key: string): Promise<void> {\r\n    this.cache.delete(key);\r\n  }\r\n\r\n  async clear(): Promise<void> {\r\n    this.cache.clear();\r\n  }\r\n\r\n  async size(): Promise<number> {\r\n    return this.cache.size;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"CacheEntity.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/CacheEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,OAAgB,WAAY,SAAQ,eAAe;IAoDvD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AA1De,gBAAI,GAAG,aAAa,CAAC;AA6DvC,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,cAAe,SAAQ,WAAW;IAItC,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAJ7B,UAAK,GACX,IAAI,GAAG,EAAE,CAAC;QAIV,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW;QAEX,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAGxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,KAAU,EACV,QAA8B;QAE9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF","sourcesContent":["import {\n  AppObject,\n  AppObjectEntity,\n  AppObjectRepo,\n  getSingletonComponent\n} from \"@vived/core\";\n\n/**\n * Abstract entity that provides caching functionality for the application.\n * CacheEntity is a singleton component that stores key-value pairs with optional metadata.\n * It provides methods for storing, retrieving, checking existence, and invalidating cached values.\n */\nexport abstract class CacheEntity extends AppObjectEntity {\n  static readonly type = \"CacheEntity\";\n\n  /**\n   * Retrieves a value from the cache by its key.\n   * @param key - The unique identifier for the cached item\n   * @returns Promise resolving to an object containing the cached value and optional metadata\n   * @throws Error if the key does not exist in the cache\n   */\n  abstract get(\n    key: string\n  ): Promise<{ value: any; metadata?: Record<string, any> }>;\n\n  /**\n   * Stores a value in the cache with an associated key and optional metadata.\n   * @param key - The unique identifier for the cached item\n   * @param value - The value to cache\n   * @param metadata - Optional metadata associated with the cached value\n   * @returns Promise that resolves when the value has been stored\n   */\n  abstract store(\n    key: string,\n    value: any,\n    metadata?: Record<string, any>\n  ): Promise<void>;\n\n  /**\n   * Checks if a key exists in the cache.\n   * @param key - The key to check\n   * @returns Promise resolving to boolean indicating if the key exists\n   */\n  abstract has(key: string): Promise<boolean>;\n\n  /**\n   * Removes an item from the cache by its key.\n   * @param key - The key to remove\n   * @returns Promise that resolves when the key has been invalidated\n   */\n  abstract invalidate(key: string): Promise<void>;\n\n  /**\n   * Removes all items from the cache.\n   * @returns Promise that resolves when the cache has been cleared\n   */\n  abstract clear(): Promise<void>;\n\n  /**\n   * Gets the number of items in the cache.\n   * @returns Promise resolving to the number of cached items\n   */\n  abstract size(): Promise<number>;\n\n  /**\n   * Gets the singleton instance of CacheEntity from the AppObjectRepo.\n   * @param appObjects - The application object repository\n   * @returns The CacheEntity instance or undefined if not registered\n   */\n  static get(appObjects: AppObjectRepo): CacheEntity | undefined {\n    return getSingletonComponent<CacheEntity>(CacheEntity.type, appObjects);\n  }\n}\n\nexport function makeCacheEntity(appObject: AppObject): CacheEntity {\n  return new CacheEntityImp(appObject);\n}\n\nclass CacheEntityImp extends CacheEntity {\n  private cache: Map<string, { value: any; metadata?: Record<string, any> }> =\n    new Map();\n\n  constructor(appObject: AppObject) {\n    super(appObject, CacheEntity.type);\n    this.appObjects.registerSingleton(this);\n  }\n\n  async get(\n    key: string\n  ): Promise<{ value: any; metadata?: Record<string, any> }> {\n    if (!this.cache.has(key)) {\n      throw new Error(`Cache key not found: ${key}`);\n    }\n    return this.cache.get(key) as {\n      value: any;\n      metadata?: Record<string, any>;\n    };\n  }\n\n  async store(\n    key: string,\n    value: any,\n    metadata?: Record<string, any>\n  ): Promise<void> {\n    this.cache.set(key, { value, metadata });\n  }\n\n  async has(key: string): Promise<boolean> {\n    return this.cache.has(key);\n  }\n\n  async invalidate(key: string): Promise<void> {\n    this.cache.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n  }\n\n  async size(): Promise<number> {\n    return this.cache.size;\n  }\n}\n"]}

package/dist/esm/Cache/Entities/ScriptCacheEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScriptCacheEntity.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/ScriptCacheEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { CacheEntity } from \"./CacheEntity\";\r\n\r\n/**\r\n * Entity responsible for managing script caching operations.\r\n * Provides functionality to store, retrieve, check existence, and invalidate scripts\r\n * in the cache based on app ID, version, and script path.\r\n */\r\nexport abstract class ScriptCacheEntity extends AppObjectEntity {\r\n  static readonly type = \"ScriptCacheEntity\";\r\n\r\n  /**\r\n   * Retrieves a script from the cache.\r\n   * @param appId - Unique identifier of the app\r\n   * @param version - Version of the app\r\n   * @param scriptPath - Path of the script within the app\r\n   * @returns Promise with the script content if found, undefined otherwise\r\n   */\r\n  abstract getScript(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string\r\n  ): Promise<string | undefined>;\r\n\r\n  /**\r\n   * Stores a script in the cache.\r\n   * @param appId - Unique identifier of the app\r\n   * @param version - Version of the app\r\n   * @param scriptPath - Path of the script within the app\r\n   * @param content - Content of the script to store\r\n   */\r\n  abstract storeScript(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string,\r\n    content: string\r\n  ): Promise<void>;\r\n\r\n  /**\r\n   * Checks if a script exists in the cache.\r\n   * @param appId - Unique identifier of the app\r\n   * @param version - Version of the app\r\n   * @param scriptPath - Path of the script within the app\r\n   * @returns Promise resolving to true if script exists, false otherwise\r\n   */\r\n  abstract hasScript(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string\r\n  ): Promise<boolean>;\r\n\r\n  /**\r\n   * Invalidates scripts in the cache.\r\n   * Can invalidate a specific script, all scripts for a version, or all scripts for an app.\r\n   * @param appId - Unique identifier of the app\r\n   * @param version - Optional version of the app\r\n   * @param scriptPath - Optional path of the script within the app\r\n   */\r\n  abstract invalidateScript(\r\n    appId: string,\r\n    version?: string,\r\n    scriptPath?: string\r\n  ): Promise<void>;\r\n\r\n  /**\r\n   * Extracts app ID, version, and script path from a script URL.\r\n   * @param url - The URL to parse\r\n   * @returns Object containing extracted appId, version, and scriptPath\r\n   */\r\n  abstract extractScriptInfo(url: string): {\r\n    appId: string;\r\n    version: string;\r\n    scriptPath: string;\r\n  };\r\n\r\n  /**\r\n   * Gets the singleton ScriptCacheEntity instance from the AppObjectRepo.\r\n   * @param appObjects - Repository of application objects\r\n   * @returns ScriptCacheEntity instance if registered, undefined otherwise\r\n   */\r\n  static get(appObjects: AppObjectRepo): ScriptCacheEntity | undefined {\r\n    return getSingletonComponent<ScriptCacheEntity>(\r\n      ScriptCacheEntity.type,\r\n      appObjects\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ScriptCacheEntity instance.\r\n * @param appObject - The parent AppObject\r\n * @returns A new ScriptCacheEntity instance\r\n */\r\nexport function makeScriptCacheEntity(appObject: AppObject): ScriptCacheEntity {\r\n  return new ScriptCacheEntityImp(appObject);\r\n}\r\n\r\ntype CacheMetadata = {\r\n  appId: string;\r\n  version: string;\r\n  scriptPath: string;\r\n  timestamp: number;\r\n};\r\n\r\nclass ScriptCacheEntityImp extends ScriptCacheEntity {\r\n  private get cacheEntity(): CacheEntity | undefined {\r\n    return this.getCachedSingleton<CacheEntity>(CacheEntity.type);\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ScriptCacheEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  async getScript(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string\r\n  ): Promise<string | undefined> {\r\n    const cacheKey = this.generateCacheKey(appId, version, scriptPath);\r\n\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return undefined;\r\n    }\r\n\r\n    try {\r\n      const { value } = await cacheEntity.get(cacheKey);\r\n      return value as string;\r\n    } catch (e) {\r\n      return undefined;\r\n    }\r\n  }\r\n\r\n  async storeScript(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string,\r\n    content: string\r\n  ): Promise<void> {\r\n    const cacheKey = this.generateCacheKey(appId, version, scriptPath);\r\n\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return;\r\n    }\r\n\r\n    const metadata: CacheMetadata = {\r\n      appId,\r\n      version,\r\n      scriptPath,\r\n      timestamp: Date.now()\r\n    };\r\n\r\n    await cacheEntity.store(cacheKey, content, metadata);\r\n  }\r\n\r\n  async hasScript(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string\r\n  ): Promise<boolean> {\r\n    const cacheKey = this.generateCacheKey(appId, version, scriptPath);\r\n\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return false;\r\n    }\r\n\r\n    return await cacheEntity.has(cacheKey);\r\n  }\r\n\r\n  async invalidateScript(\r\n    appId: string,\r\n    version?: string,\r\n    scriptPath?: string\r\n  ): Promise<void> {\r\n    const cacheEntity = this.cacheEntity;\r\n    if (!cacheEntity) {\r\n      this.warn(\"CacheEntity not found\");\r\n      return;\r\n    }\r\n\r\n    // If all parameters are provided, invalidate a specific script\r\n    if (appId && version && scriptPath) {\r\n      const cacheKey = this.generateCacheKey(appId, version, scriptPath);\r\n      await cacheEntity.invalidate(cacheKey);\r\n      return;\r\n    }\r\n\r\n    // For now, in our implementation we're just using a simple approach\r\n    // where we only invalidate the specific script or app+version combination\r\n    // A more sophisticated approach would be to iterate through all cache entries\r\n    // and check metadata, but that would require extra cache entity functionality\r\n\r\n    // For this simplified implementation, we only support full invalidation\r\n    // and specific script invalidation (all 3 parameters)\r\n    if (!version && !scriptPath) {\r\n      this.warn(\"Partial invalidation not fully implemented\");\r\n      return;\r\n    }\r\n  }\r\n\r\n  extractScriptInfo(url: string): {\r\n    appId: string;\r\n    version: string;\r\n    scriptPath: string;\r\n  } {\r\n    try {\r\n      // Parse URL to extract components\r\n      const urlObj = new URL(url);\r\n      const pathSegments = urlObj.pathname.split(\"/\");\r\n\r\n      // Find 'apps' segment index\r\n      const appsIndex = pathSegments.findIndex((segment) => segment === \"apps\");\r\n\r\n      if (appsIndex === -1 || appsIndex + 2 >= pathSegments.length) {\r\n        throw new Error(`Invalid app URL format: ${url}`);\r\n      }\r\n\r\n      // Extract app ID, version, and path\r\n      const appId = pathSegments[appsIndex + 1];\r\n      const version = pathSegments[appsIndex + 2];\r\n\r\n      // Extract script path (everything after the version segment)\r\n      const scriptPathSegments = pathSegments.slice(appsIndex + 3);\r\n      const scriptPath = scriptPathSegments.join(\"/\");\r\n\r\n      return {\r\n        appId,\r\n        version,\r\n        scriptPath\r\n      };\r\n    } catch (e) {\r\n      this.error(`Failed to extract script info from URL: ${url}`);\r\n      return {\r\n        appId: \"unknown\",\r\n        version: \"unknown\",\r\n        scriptPath: \"unknown\"\r\n      };\r\n    }\r\n  }\r\n\r\n  private generateCacheKey(\r\n    appId: string,\r\n    version: string,\r\n    scriptPath: string\r\n  ): string {\r\n    return `script:${appId}:${version}:${scriptPath}`;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ScriptCacheEntity.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/ScriptCacheEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,eAAe;IAmE7D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,iBAAiB,CAAC,IAAI,EACtB,UAAU,CACX,CAAC;IACJ,CAAC;;AA5Ee,sBAAI,GAAG,mBAAmB,CAAC;AA+E7C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AASD,MAAM,oBAAqB,SAAQ,iBAAiB;IAClD,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAa,EACb,OAAe,EACf,UAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEnE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO,KAAe,CAAC;QACzB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CACf,KAAa,EACb,OAAe,EACf,UAAkB,EAClB,OAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEnE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAkB;YAC9B,KAAK;YACL,OAAO;YACP,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,MAAM,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAa,EACb,OAAe,EACf,UAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEnE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,KAAa,EACb,OAAgB,EAChB,UAAmB;QAEnB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,+DAA+D;QAC/D,IAAI,KAAK,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YACnE,MAAM,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QAED,oEAAoE;QACpE,0EAA0E;QAC1E,8EAA8E;QAC9E,8EAA8E;QAE9E,wEAAwE;QACxE,sDAAsD;QACtD,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,GAAW;QAK3B,IAAI,CAAC;YACH,kCAAkC;YAClC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEhD,4BAA4B;YAC5B,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;YAE1E,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,oCAAoC;YACpC,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAE5C,6DAA6D;YAC7D,MAAM,kBAAkB,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAC7D,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEhD,OAAO;gBACL,KAAK;gBACL,OAAO;gBACP,UAAU;aACX,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;YAC7D,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,SAAS;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,gBAAgB,CACtB,KAAa,EACb,OAAe,EACf,UAAkB;QAElB,OAAO,UAAU,KAAK,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;IACpD,CAAC;CACF","sourcesContent":["import {\n  AppObject,\n  AppObjectEntity,\n  AppObjectRepo,\n  getSingletonComponent\n} from \"@vived/core\";\nimport { CacheEntity } from \"./CacheEntity\";\n\n/**\n * Entity responsible for managing script caching operations.\n * Provides functionality to store, retrieve, check existence, and invalidate scripts\n * in the cache based on app ID, version, and script path.\n */\nexport abstract class ScriptCacheEntity extends AppObjectEntity {\n  static readonly type = \"ScriptCacheEntity\";\n\n  /**\n   * Retrieves a script from the cache.\n   * @param appId - Unique identifier of the app\n   * @param version - Version of the app\n   * @param scriptPath - Path of the script within the app\n   * @returns Promise with the script content if found, undefined otherwise\n   */\n  abstract getScript(\n    appId: string,\n    version: string,\n    scriptPath: string\n  ): Promise<string | undefined>;\n\n  /**\n   * Stores a script in the cache.\n   * @param appId - Unique identifier of the app\n   * @param version - Version of the app\n   * @param scriptPath - Path of the script within the app\n   * @param content - Content of the script to store\n   */\n  abstract storeScript(\n    appId: string,\n    version: string,\n    scriptPath: string,\n    content: string\n  ): Promise<void>;\n\n  /**\n   * Checks if a script exists in the cache.\n   * @param appId - Unique identifier of the app\n   * @param version - Version of the app\n   * @param scriptPath - Path of the script within the app\n   * @returns Promise resolving to true if script exists, false otherwise\n   */\n  abstract hasScript(\n    appId: string,\n    version: string,\n    scriptPath: string\n  ): Promise<boolean>;\n\n  /**\n   * Invalidates scripts in the cache.\n   * Can invalidate a specific script, all scripts for a version, or all scripts for an app.\n   * @param appId - Unique identifier of the app\n   * @param version - Optional version of the app\n   * @param scriptPath - Optional path of the script within the app\n   */\n  abstract invalidateScript(\n    appId: string,\n    version?: string,\n    scriptPath?: string\n  ): Promise<void>;\n\n  /**\n   * Extracts app ID, version, and script path from a script URL.\n   * @param url - The URL to parse\n   * @returns Object containing extracted appId, version, and scriptPath\n   */\n  abstract extractScriptInfo(url: string): {\n    appId: string;\n    version: string;\n    scriptPath: string;\n  };\n\n  /**\n   * Gets the singleton ScriptCacheEntity instance from the AppObjectRepo.\n   * @param appObjects - Repository of application objects\n   * @returns ScriptCacheEntity instance if registered, undefined otherwise\n   */\n  static get(appObjects: AppObjectRepo): ScriptCacheEntity | undefined {\n    return getSingletonComponent<ScriptCacheEntity>(\n      ScriptCacheEntity.type,\n      appObjects\n    );\n  }\n}\n\n/**\n * Factory function to create a new ScriptCacheEntity instance.\n * @param appObject - The parent AppObject\n * @returns A new ScriptCacheEntity instance\n */\nexport function makeScriptCacheEntity(appObject: AppObject): ScriptCacheEntity {\n  return new ScriptCacheEntityImp(appObject);\n}\n\ntype CacheMetadata = {\n  appId: string;\n  version: string;\n  scriptPath: string;\n  timestamp: number;\n};\n\nclass ScriptCacheEntityImp extends ScriptCacheEntity {\n  private get cacheEntity(): CacheEntity | undefined {\n    return this.getCachedSingleton<CacheEntity>(CacheEntity.type);\n  }\n\n  constructor(appObject: AppObject) {\n    super(appObject, ScriptCacheEntity.type);\n    this.appObjects.registerSingleton(this);\n  }\n\n  async getScript(\n    appId: string,\n    version: string,\n    scriptPath: string\n  ): Promise<string | undefined> {\n    const cacheKey = this.generateCacheKey(appId, version, scriptPath);\n\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return undefined;\n    }\n\n    try {\n      const { value } = await cacheEntity.get(cacheKey);\n      return value as string;\n    } catch (e) {\n      return undefined;\n    }\n  }\n\n  async storeScript(\n    appId: string,\n    version: string,\n    scriptPath: string,\n    content: string\n  ): Promise<void> {\n    const cacheKey = this.generateCacheKey(appId, version, scriptPath);\n\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return;\n    }\n\n    const metadata: CacheMetadata = {\n      appId,\n      version,\n      scriptPath,\n      timestamp: Date.now()\n    };\n\n    await cacheEntity.store(cacheKey, content, metadata);\n  }\n\n  async hasScript(\n    appId: string,\n    version: string,\n    scriptPath: string\n  ): Promise<boolean> {\n    const cacheKey = this.generateCacheKey(appId, version, scriptPath);\n\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return false;\n    }\n\n    return await cacheEntity.has(cacheKey);\n  }\n\n  async invalidateScript(\n    appId: string,\n    version?: string,\n    scriptPath?: string\n  ): Promise<void> {\n    const cacheEntity = this.cacheEntity;\n    if (!cacheEntity) {\n      this.warn(\"CacheEntity not found\");\n      return;\n    }\n\n    // If all parameters are provided, invalidate a specific script\n    if (appId && version && scriptPath) {\n      const cacheKey = this.generateCacheKey(appId, version, scriptPath);\n      await cacheEntity.invalidate(cacheKey);\n      return;\n    }\n\n    // For now, in our implementation we're just using a simple approach\n    // where we only invalidate the specific script or app+version combination\n    // A more sophisticated approach would be to iterate through all cache entries\n    // and check metadata, but that would require extra cache entity functionality\n\n    // For this simplified implementation, we only support full invalidation\n    // and specific script invalidation (all 3 parameters)\n    if (!version && !scriptPath) {\n      this.warn(\"Partial invalidation not fully implemented\");\n      return;\n    }\n  }\n\n  extractScriptInfo(url: string): {\n    appId: string;\n    version: string;\n    scriptPath: string;\n  } {\n    try {\n      // Parse URL to extract components\n      const urlObj = new URL(url);\n      const pathSegments = urlObj.pathname.split(\"/\");\n\n      // Find 'apps' segment index\n      const appsIndex = pathSegments.findIndex((segment) => segment === \"apps\");\n\n      if (appsIndex === -1 || appsIndex + 2 >= pathSegments.length) {\n        throw new Error(`Invalid app URL format: ${url}`);\n      }\n\n      // Extract app ID, version, and path\n      const appId = pathSegments[appsIndex + 1];\n      const version = pathSegments[appsIndex + 2];\n\n      // Extract script path (everything after the version segment)\n      const scriptPathSegments = pathSegments.slice(appsIndex + 3);\n      const scriptPath = scriptPathSegments.join(\"/\");\n\n      return {\n        appId,\n        version,\n        scriptPath\n      };\n    } catch (e) {\n      this.error(`Failed to extract script info from URL: ${url}`);\n      return {\n        appId: \"unknown\",\n        version: \"unknown\",\n        scriptPath: \"unknown\"\n      };\n    }\n  }\n\n  private generateCacheKey(\n    appId: string,\n    version: string,\n    scriptPath: string\n  ): string {\n    return `script:${appId}:${version}:${scriptPath}`;\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC","sourcesContent":["/**\r\n * Cache Entities\r\n *\r\n * Core domain models for the Cache feature\r\n */\r\n\r\nexport * from \"./CacheEntity\";\r\nexport * from \"./ScriptCacheEntity\";\r\nexport * from \"./AssetCacheEntity\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Cache/Entities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC","sourcesContent":["/**\n * Cache Entities\n *\n * Core domain models for the Cache feature\n */\n\nexport * from \"./CacheEntity\";\nexport * from \"./ScriptCacheEntity\";\nexport * from \"./AssetCacheEntity\";\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"setupCache.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/setupCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,UAAyB;IAClD,iCAAiC;IACjC,MAAM,aAAa,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAEtD,kBAAkB;IAClB,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACrC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAEpC,mBAAmB;IACnB,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxC,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxC,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACvC,uBAAuB,CAAC,aAAa,CAAC,CAAC;AACzC,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { makeAssetCacheEntity } from \"../Entities/AssetCacheEntity\";\r\nimport { makeScriptCacheEntity } from \"../Entities/ScriptCacheEntity\";\r\nimport { makeGetAssetFromCacheUC } from \"../UCs/GetAssetFromCacheUC\";\r\nimport { makeGetScriptFromCacheUC } from \"../UCs/GetScriptFromCacheUC\";\r\nimport { makeStoreAssetInCacheUC } from \"../UCs/StoreAssetInCacheUC\";\r\nimport { makeStoreScriptInCacheUC } from \"../UCs/StoreScriptInCacheUC\";\r\n\r\n/**\r\n * Sets up the Cache feature components\r\n */\r\nexport function setupCache(appObjects: AppObjectRepo): void {\r\n  // Create Cache Entity app object\r\n  const cacheEntityAO = appObjects.getOrCreate(\"Cache\");\r\n\r\n  // Create entities\r\n  makeScriptCacheEntity(cacheEntityAO);\r\n  makeAssetCacheEntity(cacheEntityAO);\r\n\r\n  // Create use cases\r\n  makeGetScriptFromCacheUC(cacheEntityAO);\r\n  makeStoreScriptInCacheUC(cacheEntityAO);\r\n  makeGetAssetFromCacheUC(cacheEntityAO);\r\n  makeStoreAssetInCacheUC(cacheEntityAO);\r\n}\r\n"]}
+{"version":3,"file":"setupCache.js","sourceRoot":"","sources":["../../../../src/Cache/Factories/setupCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,UAAyB;IAClD,iCAAiC;IACjC,MAAM,aAAa,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAEtD,kBAAkB;IAClB,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACrC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAEpC,mBAAmB;IACnB,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxC,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxC,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACvC,uBAAuB,CAAC,aAAa,CAAC,CAAC;AACzC,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\nimport { makeAssetCacheEntity } from \"../Entities/AssetCacheEntity\";\nimport { makeScriptCacheEntity } from \"../Entities/ScriptCacheEntity\";\nimport { makeGetAssetFromCacheUC } from \"../UCs/GetAssetFromCacheUC\";\nimport { makeGetScriptFromCacheUC } from \"../UCs/GetScriptFromCacheUC\";\nimport { makeStoreAssetInCacheUC } from \"../UCs/StoreAssetInCacheUC\";\nimport { makeStoreScriptInCacheUC } from \"../UCs/StoreScriptInCacheUC\";\n\n/**\n * Sets up the Cache feature components\n */\nexport function setupCache(appObjects: AppObjectRepo): void {\n  // Create Cache Entity app object\n  const cacheEntityAO = appObjects.getOrCreate(\"Cache\");\n\n  // Create entities\n  makeScriptCacheEntity(cacheEntityAO);\n  makeAssetCacheEntity(cacheEntityAO);\n\n  // Create use cases\n  makeGetScriptFromCacheUC(cacheEntityAO);\n  makeStoreScriptInCacheUC(cacheEntityAO);\n  makeGetAssetFromCacheUC(cacheEntityAO);\n  makeStoreAssetInCacheUC(cacheEntityAO);\n}\n"]}