@vived/host 4.9.1 → 4.11.0

package/dist/esm/Assets/Entities/AppAssetsEntity.js

@@ -1,17 +1,99 @@
 import { AppObjectEntity, getSingletonComponent, MemoizedBoolean } from "@vived/core";
+/**
+ * AppAssetsEntity manages the collection of assets associated with a specific VIVED application.
+ *
+ * This singleton entity handles:
+ * 1. Asset collection management (add, remove, query operations)
+ * 2. Editing state management with automatic observer registration
+ * 3. Archive filtering functionality for showing/hiding archived assets
+ * 4. Global asset reference tracking for applications
+ *
+ * Key Concepts:
+ * - Singleton pattern ensures only one instance exists per application
+ * - Observer pattern integration for automatic UI updates when editing state changes
+ * - Smart observer management prevents memory leaks by properly registering/unregistering
+ * - Archive filtering support for improved user experience
+ *
+ * Usage Patterns:
+ * ```typescript
+ * // Get the global app assets entity
+ * const appAssets = AppAssetsEntity.get(appObjects);
+ * if (appAssets) {
+ *   // Manage asset collection
+ *   appAssets.add("asset123");
+ *   const allAssets = appAssets.getAll();
+ *   const hasAsset = appAssets.has("asset123");
+ *   appAssets.remove("asset123");
+ *
+ *   // Manage editing state
+ *   const assetEntity = AssetEntity.get(someAppObject);
+ *   appAssets.editingAsset = assetEntity; // Automatically registers observers
+ *
+ *   // Control archive visibility
+ *   appAssets.showArchived = true; // Show archived assets
+ *   appAssets.showArchived = false; // Hide archived assets
+ * }
+ * ```
+ *
+ * Integration Points:
+ * - Works with AssetRepo for asset lifecycle management
+ * - Integrates with AssetEntity for individual asset operations
+ * - Used by GetAppAssetsUC for bulk asset operations
+ * - Supports UI components through observer pattern notifications
+ */
 export class AppAssetsEntity extends AppObjectEntity {
+    /**
+     * Retrieves the singleton AppAssetsEntity from the host application objects
+     * @param hostAppObjects - The application object repository to search
+     * @returns AppAssetsEntity instance or undefined if not found
+     * Uses getSingletonComponent to ensure only one instance exists
+     */
     static get(hostAppObjects) {
         return getSingletonComponent(AppAssetsEntity.type, hostAppObjects);
     }
 }
+/** Static type identifier for component registration */
 AppAssetsEntity.type = "AppAssetsEntity";
+/**
+ * Factory function to create a new AppAssetsEntity instance
+ * @param appObj - The AppObject that will host this AppAssetsEntity
+ * @returns A new AppAssetsEntity implementation instance
+ */
 export function makeAppAssets(appObj) {
     return new AppAssetsImp(appObj);
 }
+/**
+ * Private implementation of AppAssetsEntity that handles all concrete functionality.
+ *
+ * Key Implementation Details:
+ * - Maintains an array of asset IDs for the application
+ * - Smart observer management for editing asset changes
+ * - Memoized archive visibility flag with change notifications
+ * - Automatic singleton registration ensures global accessibility
+ *
+ * Observer Management Pattern:
+ * The editing asset property automatically manages observer registration to ensure
+ * that UI components are notified when the currently edited asset changes.
+ * When a new asset is set for editing, observers from the previous asset are
+ * properly removed to prevent memory leaks and duplicate notifications.
+ */
 class AppAssetsImp extends AppAssetsEntity {
+    /**
+     * Returns the currently editing asset
+     * @returns The AssetEntity being edited, or undefined if none
+     */
     get editingAsset() {
         return this._editingAsset;
     }
+    /**
+     * Sets the currently editing asset with smart observer management
+     * Automatically handles observer registration/deregistration to prevent memory leaks
+     * @param val - The AssetEntity to edit, or undefined to clear editing state
+     * Side effects:
+     * - Removes observers from previous editing asset
+     * - Adds observers to new editing asset
+     * - Triggers change notifications for UI updates
+     */
     set editingAsset(val) {
         if (val?.id === this._editingAsset?.id)
             return;
@@ -24,9 +106,19 @@ class AppAssetsImp extends AppAssetsEntity {
         }
         this.notifyOnChange();
     }
+    /**
+     * Checks if an asset ID exists in the collection
+     * @param assetID - The asset ID to check for
+     * @returns true if asset exists in collection, false otherwise
+     */
     has(assetID) {
         return this.appAssets.includes(assetID);
     }
+    /**
+     * Removes an asset ID from the collection if present
+     * @param assetID - The asset ID to remove
+     * Side effects: Triggers change notifications if asset was removed
+     */
     remove(assetID) {
         const index = this.appAssets.indexOf(assetID, 0);
         if (index > -1) {
@@ -34,24 +126,55 @@ class AppAssetsImp extends AppAssetsEntity {
             this.notifyOnChange();
         }
     }
+    /**
+     * Returns the current archive visibility setting
+     * @returns true if archived assets should be shown, false to hide them
+     */
     get showArchived() {
         return this.memoizedShowArchived.val;
     }
+    /**
+     * Sets the archive visibility with change notification
+     * @param show - true to show archived assets, false to hide them
+     * Side effects: Triggers change notifications for UI updates
+     */
     set showArchived(show) {
         this.memoizedShowArchived.val = show;
     }
+    /**
+     * Initializes the AppAssetsEntity with singleton registration
+     * @param appObj - The AppObject that will host this entity
+     * Side effects: Registers this instance as a singleton for global access
+     */
     constructor(appObj) {
         super(appObj, AppAssetsEntity.type);
+        /** Internal storage for the collection of asset IDs */
         this.appAssets = [];
+        /**
+         * Retrieves all asset IDs in the collection
+         * Returns a copy to prevent external modification of internal state
+         * @returns Array of asset IDs
+         */
         this.getAll = () => {
             return [...this.appAssets];
         };
+        /**
+         * Adds an asset ID to the collection if not already present
+         * Prevents duplicate entries and maintains collection integrity
+         * @param assetID - The asset ID to add
+         * Side effects: Triggers change notifications if asset was added
+         */
         this.add = (assetID) => {
             if (this.appAssets.includes(assetID))
                 return;
             this.appAssets.push(assetID);
             this.notifyOnChange();
         };
+        /**
+         * Memoized archive visibility flag with change notification
+         * Controls whether archived assets should be shown in UI components
+         * Defaults to false (archived assets hidden)
+         */
         this.memoizedShowArchived = new MemoizedBoolean(false, this.notifyOnChange);
         this.appObjects.registerSingleton(this);
     }

package/dist/esm/Assets/Entities/AppAssetsEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppAssetsEntity.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/AppAssetsEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEf,qBAAqB,EACrB,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB,MAAM,OAAgB,eAAgB,SAAQ,eAAe;IAc3D,MAAM,CAAC,GAAG,CAAC,cAA6B;QACtC,OAAO,qBAAqB,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACrE,CAAC;;AAfM,oBAAI,GAAG,iBAAiB,CAAC;AAkBlC,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,YAAa,SAAQ,eAAe;IAIxC,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,YAAY,CAAC,GAA4B;QAC3C,IAAI,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,aAAa,EAAE,EAAE;YAAE,OAAO;QAE/C,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QAEzB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAaD,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjD,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAMD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC;IACvC,CAAC;IACD,IAAI,YAAY,CAAC,IAAa;QAC5B,IAAI,CAAC,oBAAoB,CAAC,GAAG,GAAG,IAAI,CAAC;IACvC,CAAC;IAED,YAAY,MAAiB;QAC3B,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QA1D9B,cAAS,GAAa,EAAE,CAAC;QAuBjC,WAAM,GAAG,GAAa,EAAE;YACtB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,QAAG,GAAG,CAAC,OAAe,EAAQ,EAAE;YAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO;YAE7C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAcM,yBAAoB,GAAG,IAAI,eAAe,CAChD,KAAK,EACL,IAAI,CAAC,cAAc,CACpB,CAAC;QAUA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent,\r\n  MemoizedBoolean\r\n} from \"@vived/core\";\r\nimport { AssetEntity } from \"./AssetEntity\";\r\n\r\nexport abstract class AppAssetsEntity extends AppObjectEntity {\r\n  static type = \"AppAssetsEntity\";\r\n\r\n  abstract getAll(): string[];\r\n  abstract add(assetID: string): void;\r\n  abstract has(assetID: string): boolean;\r\n  abstract remove(assetID: string): void;\r\n\r\n  abstract get editingAsset(): AssetEntity | undefined;\r\n  abstract set editingAsset(val: AssetEntity | undefined);\r\n\r\n  abstract get showArchived(): boolean;\r\n  abstract set showArchived(show: boolean);\r\n\r\n  static get(hostAppObjects: AppObjectRepo): AppAssetsEntity | undefined {\r\n    return getSingletonComponent(AppAssetsEntity.type, hostAppObjects);\r\n  }\r\n}\r\n\r\nexport function makeAppAssets(appObj: AppObject): AppAssetsEntity {\r\n  return new AppAssetsImp(appObj);\r\n}\r\n\r\nclass AppAssetsImp extends AppAssetsEntity {\r\n  private appAssets: string[] = [];\r\n\r\n  private _editingAsset: AssetEntity | undefined;\r\n  get editingAsset(): AssetEntity | undefined {\r\n    return this._editingAsset;\r\n  }\r\n\r\n  set editingAsset(val: AssetEntity | undefined) {\r\n    if (val?.id === this._editingAsset?.id) return;\r\n\r\n    if (this._editingAsset) {\r\n      this._editingAsset.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this._editingAsset = val;\r\n\r\n    if (this._editingAsset) {\r\n      this._editingAsset.addChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  getAll = (): string[] => {\r\n    return [...this.appAssets];\r\n  };\r\n\r\n  add = (assetID: string): void => {\r\n    if (this.appAssets.includes(assetID)) return;\r\n\r\n    this.appAssets.push(assetID);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  has(assetID: string): boolean {\r\n    return this.appAssets.includes(assetID);\r\n  }\r\n\r\n  remove(assetID: string): void {\r\n    const index = this.appAssets.indexOf(assetID, 0);\r\n    if (index > -1) {\r\n      this.appAssets.splice(index, 1);\r\n      this.notifyOnChange();\r\n    }\r\n  }\r\n\r\n  private memoizedShowArchived = new MemoizedBoolean(\r\n    false,\r\n    this.notifyOnChange\r\n  );\r\n  get showArchived(): boolean {\r\n    return this.memoizedShowArchived.val;\r\n  }\r\n  set showArchived(show: boolean) {\r\n    this.memoizedShowArchived.val = show;\r\n  }\r\n\r\n  constructor(appObj: AppObject) {\r\n    super(appObj, AppAssetsEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppAssetsEntity.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/AppAssetsEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent,\r\n  MemoizedBoolean\r\n} from \"@vived/core\";\r\nimport { AssetEntity } from \"./AssetEntity\";\r\n\r\n/**\r\n * AppAssetsEntity manages the collection of assets associated with a specific VIVED application.\r\n *\r\n * This singleton entity handles:\r\n * 1. Asset collection management (add, remove, query operations)\r\n * 2. Editing state management with automatic observer registration\r\n * 3. Archive filtering functionality for showing/hiding archived assets\r\n * 4. Global asset reference tracking for applications\r\n *\r\n * Key Concepts:\r\n * - Singleton pattern ensures only one instance exists per application\r\n * - Observer pattern integration for automatic UI updates when editing state changes\r\n * - Smart observer management prevents memory leaks by properly registering/unregistering\r\n * - Archive filtering support for improved user experience\r\n *\r\n * Usage Patterns:\r\n * ```typescript\r\n * // Get the global app assets entity\r\n * const appAssets = AppAssetsEntity.get(appObjects);\r\n * if (appAssets) {\r\n *   // Manage asset collection\r\n *   appAssets.add(\"asset123\");\r\n *   const allAssets = appAssets.getAll();\r\n *   const hasAsset = appAssets.has(\"asset123\");\r\n *   appAssets.remove(\"asset123\");\r\n *\r\n *   // Manage editing state\r\n *   const assetEntity = AssetEntity.get(someAppObject);\r\n *   appAssets.editingAsset = assetEntity; // Automatically registers observers\r\n *\r\n *   // Control archive visibility\r\n *   appAssets.showArchived = true; // Show archived assets\r\n *   appAssets.showArchived = false; // Hide archived assets\r\n * }\r\n * ```\r\n *\r\n * Integration Points:\r\n * - Works with AssetRepo for asset lifecycle management\r\n * - Integrates with AssetEntity for individual asset operations\r\n * - Used by GetAppAssetsUC for bulk asset operations\r\n * - Supports UI components through observer pattern notifications\r\n */\r\nexport abstract class AppAssetsEntity extends AppObjectEntity {\r\n  /** Static type identifier for component registration */\r\n  static type = \"AppAssetsEntity\";\r\n\r\n  /**\r\n   * Retrieves all asset IDs in this application's collection\r\n   * @returns Array of asset IDs, returned as a copy to prevent external modification\r\n   */\r\n  abstract getAll(): string[];\r\n\r\n  /**\r\n   * Adds an asset ID to the collection if not already present\r\n   * @param assetID - The unique identifier of the asset to add\r\n   * Side effects: Triggers change notifications for UI updates\r\n   */\r\n  abstract add(assetID: string): void;\r\n\r\n  /**\r\n   * Checks if an asset ID exists in the collection\r\n   * @param assetID - The unique identifier to check for\r\n   * @returns true if the asset is in the collection, false otherwise\r\n   */\r\n  abstract has(assetID: string): boolean;\r\n\r\n  /**\r\n   * Removes an asset ID from the collection if present\r\n   * @param assetID - The unique identifier of the asset to remove\r\n   * Side effects: Triggers change notifications for UI updates\r\n   */\r\n  abstract remove(assetID: string): void;\r\n\r\n  /**\r\n   * The asset currently being edited, if any\r\n   * When set, automatically manages observer registration for change notifications\r\n   * Setting to undefined clears the editing state\r\n   */\r\n  abstract get editingAsset(): AssetEntity | undefined;\r\n  abstract set editingAsset(val: AssetEntity | undefined);\r\n\r\n  /**\r\n   * Controls whether archived assets are shown in UI components\r\n   * When true, archived assets are included in queries and displays\r\n   * When false, archived assets are filtered out for better UX\r\n   */\r\n  abstract get showArchived(): boolean;\r\n  abstract set showArchived(show: boolean);\r\n\r\n  /**\r\n   * Retrieves the singleton AppAssetsEntity from the host application objects\r\n   * @param hostAppObjects - The application object repository to search\r\n   * @returns AppAssetsEntity instance or undefined if not found\r\n   * Uses getSingletonComponent to ensure only one instance exists\r\n   */\r\n  static get(hostAppObjects: AppObjectRepo): AppAssetsEntity | undefined {\r\n    return getSingletonComponent(AppAssetsEntity.type, hostAppObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new AppAssetsEntity instance\r\n * @param appObj - The AppObject that will host this AppAssetsEntity\r\n * @returns A new AppAssetsEntity implementation instance\r\n */\r\nexport function makeAppAssets(appObj: AppObject): AppAssetsEntity {\r\n  return new AppAssetsImp(appObj);\r\n}\r\n\r\n/**\r\n * Private implementation of AppAssetsEntity that handles all concrete functionality.\r\n *\r\n * Key Implementation Details:\r\n * - Maintains an array of asset IDs for the application\r\n * - Smart observer management for editing asset changes\r\n * - Memoized archive visibility flag with change notifications\r\n * - Automatic singleton registration ensures global accessibility\r\n *\r\n * Observer Management Pattern:\r\n * The editing asset property automatically manages observer registration to ensure\r\n * that UI components are notified when the currently edited asset changes.\r\n * When a new asset is set for editing, observers from the previous asset are\r\n * properly removed to prevent memory leaks and duplicate notifications.\r\n */\r\nclass AppAssetsImp extends AppAssetsEntity {\r\n  /** Internal storage for the collection of asset IDs */\r\n  private appAssets: string[] = [];\r\n\r\n  /** Internal reference to the currently editing asset */\r\n  private _editingAsset: AssetEntity | undefined;\r\n\r\n  /**\r\n   * Returns the currently editing asset\r\n   * @returns The AssetEntity being edited, or undefined if none\r\n   */\r\n  get editingAsset(): AssetEntity | undefined {\r\n    return this._editingAsset;\r\n  }\r\n\r\n  /**\r\n   * Sets the currently editing asset with smart observer management\r\n   * Automatically handles observer registration/deregistration to prevent memory leaks\r\n   * @param val - The AssetEntity to edit, or undefined to clear editing state\r\n   * Side effects:\r\n   * - Removes observers from previous editing asset\r\n   * - Adds observers to new editing asset\r\n   * - Triggers change notifications for UI updates\r\n   */\r\n  set editingAsset(val: AssetEntity | undefined) {\r\n    if (val?.id === this._editingAsset?.id) return;\r\n\r\n    if (this._editingAsset) {\r\n      this._editingAsset.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this._editingAsset = val;\r\n\r\n    if (this._editingAsset) {\r\n      this._editingAsset.addChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  /**\r\n   * Retrieves all asset IDs in the collection\r\n   * Returns a copy to prevent external modification of internal state\r\n   * @returns Array of asset IDs\r\n   */\r\n  getAll = (): string[] => {\r\n    return [...this.appAssets];\r\n  };\r\n\r\n  /**\r\n   * Adds an asset ID to the collection if not already present\r\n   * Prevents duplicate entries and maintains collection integrity\r\n   * @param assetID - The asset ID to add\r\n   * Side effects: Triggers change notifications if asset was added\r\n   */\r\n  add = (assetID: string): void => {\r\n    if (this.appAssets.includes(assetID)) return;\r\n\r\n    this.appAssets.push(assetID);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Checks if an asset ID exists in the collection\r\n   * @param assetID - The asset ID to check for\r\n   * @returns true if asset exists in collection, false otherwise\r\n   */\r\n  has(assetID: string): boolean {\r\n    return this.appAssets.includes(assetID);\r\n  }\r\n\r\n  /**\r\n   * Removes an asset ID from the collection if present\r\n   * @param assetID - The asset ID to remove\r\n   * Side effects: Triggers change notifications if asset was removed\r\n   */\r\n  remove(assetID: string): void {\r\n    const index = this.appAssets.indexOf(assetID, 0);\r\n    if (index > -1) {\r\n      this.appAssets.splice(index, 1);\r\n      this.notifyOnChange();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Memoized archive visibility flag with change notification\r\n   * Controls whether archived assets should be shown in UI components\r\n   * Defaults to false (archived assets hidden)\r\n   */\r\n  private memoizedShowArchived = new MemoizedBoolean(\r\n    false,\r\n    this.notifyOnChange\r\n  );\r\n\r\n  /**\r\n   * Returns the current archive visibility setting\r\n   * @returns true if archived assets should be shown, false to hide them\r\n   */\r\n  get showArchived(): boolean {\r\n    return this.memoizedShowArchived.val;\r\n  }\r\n\r\n  /**\r\n   * Sets the archive visibility with change notification\r\n   * @param show - true to show archived assets, false to hide them\r\n   * Side effects: Triggers change notifications for UI updates\r\n   */\r\n  set showArchived(show: boolean) {\r\n    this.memoizedShowArchived.val = show;\r\n  }\r\n\r\n  /**\r\n   * Initializes the AppAssetsEntity with singleton registration\r\n   * @param appObj - The AppObject that will host this entity\r\n   * Side effects: Registers this instance as a singleton for global access\r\n   */\r\n  constructor(appObj: AppObject) {\r\n    super(appObj, AppAssetsEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/esm/Assets/Entities/AssetEntity.js

@@ -1,5 +1,60 @@
 import { AppObjectEntity, MemoizedBoolean, MemoizedString } from "@vived/core";
+/**
+ * AssetEntity manages individual file-based resources in VIVED applications.
+ *
+ * This entity handles:
+ * 1. Asset metadata (name, description, owner, archive status)
+ * 2. File management (filename, fileURL, blob URL creation)
+ * 3. Linked asset relationships for hierarchical asset structures
+ * 4. Fetch state management (loading indicators, error handling)
+ * 5. Observer pattern implementation for UI updates
+ *
+ * Key Concepts:
+ * - Uses memoized properties for efficient change tracking and notifications
+ * - Supports both file URLs (remote) and blob URLs (local) for flexible file access
+ * - Maintains linked asset relationships to support complex asset hierarchies
+ * - Implements observer pattern to notify UI components of changes
+ *
+ * Usage Patterns:
+ * ```typescript
+ * // Get an asset entity from an app object
+ * const asset = AssetEntity.get(appObject);
+ * if (asset) {
+ *   // Set asset metadata
+ *   asset.name = "My Asset";
+ *   asset.description = "A sample asset";
+ *
+ *   // Handle file operations
+ *   asset.setFile(fileObject);
+ *   const blobURL = asset.blobURL; // Access local blob URL
+ *
+ *   // Manage linked assets
+ *   asset.addLinkedAsset("texture", "texture123");
+ *   const textures = asset.getLinkedAssetByType("texture");
+ *
+ *   // Monitor fetch state
+ *   if (asset.isFetchingFile) {
+ *     console.log("File is being downloaded...");
+ *   }
+ *   if (asset.fetchError) {
+ *     console.error("Failed to fetch file:", asset.fetchError.message);
+ *   }
+ * }
+ * ```
+ *
+ * Integration Points:
+ * - Works with AssetRepo for asset lifecycle management
+ * - Integrates with AppAssetsEntity for collection management
+ * - Used by GetAssetBlobURLUC for file retrieval operations
+ * - Supports caching mechanisms for optimized file access
+ */
 export class AssetEntity extends AppObjectEntity {
+    /**
+     * Retrieves an AssetEntity component from an AppObject
+     * @param appObject - The AppObject to search for the AssetEntity component
+     * @returns AssetEntity instance or undefined if not found
+     * Logs warning if component is not found to aid in debugging
+     */
     static get(appObject) {
         const asset = appObject.getComponent(AssetEntity.type);
         if (!asset) {
@@ -8,11 +63,33 @@ export class AssetEntity extends AppObjectEntity {
         return asset;
     }
 }
+/** Static type identifier for component registration */
 AssetEntity.type = "AssetEntity";
+/**
+ * Factory function to create a new AssetEntity instance
+ * @param appObject - The AppObject that will host this AssetEntity
+ * @returns A new AssetEntity implementation instance
+ */
 export function makeAssetEntity(appObject) {
     return new AssetImp(appObject);
 }
+/**
+ * Private implementation of AssetEntity that handles all the concrete functionality.
+ *
+ * Key Implementation Details:
+ * - Uses MemoizedString and MemoizedBoolean for efficient change tracking
+ * - All memoized properties automatically trigger change notifications when modified
+ * - Blob URL management with proper cleanup on disposal
+ * - Linked asset management with duplicate prevention
+ * - File fetch state management for async operations
+ *
+ * Memoization Pattern:
+ * The implementation uses memoized properties that only trigger change notifications
+ * when values actually change, preventing unnecessary UI updates and improving performance.
+ * Each memoized property is initialized with a default value and a change callback.
+ */
 class AssetImp extends AssetEntity {
+    /** Returns the unique ID from the underlying AppObject */
     get id() {
         return this.appObject.id;
     }
@@ -52,15 +129,25 @@ class AssetImp extends AssetEntity {
     set fileURL(name) {
         this._memoizedFileURL.val = name;
     }
+    /** Returns the locally stored file object, if any */
     get file() {
         return this._file;
     }
+    /** Returns the blob URL for local file access, if available */
     get blobURL() {
         return this._blobURL;
     }
+    /**
+     * Indicates whether a file has been successfully fetched and stored locally
+     * Used to determine if file operations can proceed without network requests
+     */
     get fileHasBeenFetched() {
         return this._file !== undefined;
     }
+    /**
+     * Returns a copy of all linked assets to prevent external modification
+     * This ensures the internal state cannot be corrupted by external code
+     */
     get linkedAssets() {
         return [...this._linkedAssets];
     }
@@ -70,9 +157,16 @@ class AssetImp extends AssetEntity {
     set isFetchingFile(archived) {
         this._memoizedIsFetchingFile.val = archived;
     }
+    /** Returns the current fetch error, if any */
     get fetchError() {
         return this._fetchError;
     }
+    /**
+     * Sets the fetch error with smart change detection
+     * Only triggers change notifications if the error actually changes
+     * This prevents unnecessary UI updates when the same error is set multiple times
+     * @param fetchError - The error that occurred, or undefined to clear the error
+     */
     set fetchError(fetchError) {
         if (fetchError === undefined && this.fetchError === undefined)
             return;
@@ -83,22 +177,68 @@ class AssetImp extends AssetEntity {
         this._fetchError = fetchError;
         this.notifyOnChange();
     }
+    /**
+     * Initializes the AssetEntity with proper component registration
+     * @param appObject - The AppObject that will host this entity
+     */
     constructor(appObject) {
         super(appObject, AssetEntity.type);
+        /**
+         * Memoized asset name with change notification
+         * Initialized to empty string, triggers notifyOnChange when modified
+         */
         this._memoizedName = new MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized asset owner with change notification
+         * Stores the ID of the user/entity that owns this asset
+         */
         this._memoizedOwner = new MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized asset description with change notification
+         * Stores detailed information about the asset's purpose or content
+         */
         this._memoizedDescription = new MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized archive status with change notification
+         * Used for soft deletion and filtering of assets
+         */
         this._memoizedArchived = new MemoizedBoolean(false, this.notifyOnChange);
+        /**
+         * Memoized file URL for remote asset access
+         * Points to where the actual file can be downloaded from
+         */
         this._memoizedFileURL = new MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized filename for display and download purposes
+         * Preserves the original name of the uploaded file
+         */
         this._memoizedFilename = new MemoizedString("", this.notifyOnChange);
+        /** Local file object storage */
         this._file = undefined;
+        /** Local blob URL for immediate file access */
         this._blobURL = undefined;
+        /**
+         * Sets a local file and creates a blob URL for immediate access
+         * This is typically called after successfully downloading a file
+         * @param file - The file object to store locally
+         * Side effects: Creates blob URL, triggers change notifications to update UI
+         */
         this.setFile = (file) => {
             this._file = file;
             this._blobURL = URL.createObjectURL(file);
             this.notifyOnChange();
         };
+        /**
+         * Storage for linked asset relationships
+         * Supports hierarchical asset structures where assets depend on other assets
+         */
         this._linkedAssets = [];
+        /**
+         * Adds a linked asset relationship if it doesn't already exist
+         * Prevents duplicate relationships and maintains data integrity
+         * @param type - Category of the linked asset (e.g., "texture", "sound", "model")
+         * @param id - Unique identifier of the linked asset
+         */
         this.addLinkedAsset = (type, id) => {
             const existingAsset = this._linkedAssets.find((asset) => {
                 return asset.id === id;
@@ -111,6 +251,12 @@ class AssetImp extends AssetEntity {
                 this.notifyOnChange();
             }
         };
+        /**
+         * Removes a linked asset relationship if it exists
+         * Maintains referential integrity by only removing exact matches
+         * @param type - Category of the linked asset to remove
+         * @param id - Unique identifier of the linked asset to remove
+         */
         this.removeLinkedAsset = (type, id) => {
             let foundAsset = false;
             this._linkedAssets.forEach((asset) => {
@@ -123,6 +269,12 @@ class AssetImp extends AssetEntity {
                 this.notifyOnChange();
             }
         };
+        /**
+         * Retrieves all linked asset IDs of a specific type
+         * Useful for finding all assets of a particular category (e.g., all textures)
+         * @param type - The asset type to filter by
+         * @returns Array of asset IDs matching the specified type
+         */
         this.getLinkedAssetByType = (type) => {
             const rVal = [];
             this._linkedAssets.forEach((asset) => {
@@ -132,8 +284,22 @@ class AssetImp extends AssetEntity {
             });
             return rVal;
         };
+        /**
+         * Memoized fetch state indicator with change notification
+         * Used to show loading states in UI during file download operations
+         */
         this._memoizedIsFetchingFile = new MemoizedBoolean(false, this.notifyOnChange);
+        /**
+         * Storage for the most recent fetch error
+         * Helps with error handling and user feedback in UI components
+         */
         this._fetchError = undefined;
+        /**
+         * Cleanup method that properly releases blob URL resources
+         * Important: Blob URLs must be revoked to prevent memory leaks
+         * This is automatically called when the entity is disposed
+         * Side effects: Revokes blob URL, triggers change notification, calls parent dispose
+         */
         this.dispose = () => {
             if (this._blobURL !== undefined) {
                 URL.revokeObjectURL(this._blobURL);

package/dist/esm/Assets/Entities/AssetEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetEntity.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  MemoizedBoolean,\r\n  MemoizedString\r\n} from \"@vived/core\";\r\n\r\nexport abstract class AssetEntity extends AppObjectEntity {\r\n  static type = \"AssetEntity\";\r\n\r\n  abstract readonly id: string;\r\n\r\n  abstract get name(): string;\r\n  abstract set name(name: string);\r\n\r\n  abstract get description(): string;\r\n  abstract set description(description: string);\r\n\r\n  abstract get owner(): string;\r\n  abstract set owner(val: string);\r\n\r\n  abstract get archived(): boolean;\r\n  abstract set archived(archived: boolean);\r\n\r\n  abstract get filename(): string;\r\n  abstract set filename(filename: string);\r\n\r\n  abstract get fileURL(): string;\r\n  abstract set fileURL(fileURL: string);\r\n\r\n  abstract setFile(file: File): void;\r\n  abstract get file(): File | undefined;\r\n  abstract get blobURL(): string | undefined;\r\n  abstract get fileHasBeenFetched(): boolean;\r\n\r\n  abstract get linkedAssets(): { type: string; id: string }[];\r\n  abstract addLinkedAsset(type: string, id: string): void;\r\n  abstract removeLinkedAsset(type: string, id: string): void;\r\n  abstract getLinkedAssetByType(type: string): string[];\r\n\r\n  abstract get isFetchingFile(): boolean;\r\n  abstract set isFetchingFile(isFetchingFile: boolean);\r\n\r\n  abstract get fetchError(): Error | undefined;\r\n  abstract set fetchError(fetchError: Error | undefined);\r\n\r\n  static get(appObject: AppObject): AssetEntity | undefined {\r\n    const asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"AssetEntity.get\",\r\n        \"Unable to find AssetEntity on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n}\r\n\r\nexport function makeAssetEntity(appObject: AppObject): AssetEntity {\r\n  return new AssetImp(appObject);\r\n}\r\n\r\nclass AssetImp extends AssetEntity {\r\n  get id(): string {\r\n    return this.appObject.id;\r\n  }\r\n\r\n  private _memoizedName: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  get name(): string {\r\n    return this._memoizedName.val;\r\n  }\r\n\r\n  set name(name: string) {\r\n    this._memoizedName.val = name;\r\n  }\r\n\r\n  private _memoizedOwner: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  get owner(): string {\r\n    return this._memoizedOwner.val;\r\n  }\r\n\r\n  set owner(val: string) {\r\n    this._memoizedOwner.val = val;\r\n  }\r\n\r\n  private _memoizedDescription: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  get description(): string {\r\n    return this._memoizedDescription.val;\r\n  }\r\n\r\n  set description(description: string) {\r\n    this._memoizedDescription.val = description;\r\n  }\r\n\r\n  private _memoizedArchived: MemoizedBoolean = new MemoizedBoolean(\r\n    false,\r\n    this.notifyOnChange\r\n  );\r\n  get archived(): boolean {\r\n    return this._memoizedArchived.val;\r\n  }\r\n\r\n  set archived(archived: boolean) {\r\n    this._memoizedArchived.val = archived;\r\n  }\r\n\r\n  private _memoizedFileURL: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  private _memoizedFilename: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n\r\n  get filename(): string {\r\n    return this._memoizedFilename.val;\r\n  }\r\n  set filename(name: string) {\r\n    this._memoizedFilename.val = name;\r\n  }\r\n  get fileURL(): string {\r\n    return this._memoizedFileURL.val;\r\n  }\r\n\r\n  set fileURL(name: string) {\r\n    this._memoizedFileURL.val = name;\r\n  }\r\n\r\n  private _file: File | undefined = undefined;\r\n  private _blobURL: string | undefined = undefined;\r\n\r\n  setFile = (file: File) => {\r\n    this._file = file;\r\n    this._blobURL = URL.createObjectURL(file);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  get file(): File | undefined {\r\n    return this._file;\r\n  }\r\n\r\n  get blobURL(): string | undefined {\r\n    return this._blobURL;\r\n  }\r\n\r\n  get fileHasBeenFetched(): boolean {\r\n    return this._file !== undefined;\r\n  }\r\n\r\n  private _linkedAssets: { type: string; id: string }[] = [];\r\n  get linkedAssets(): { type: string; id: string }[] {\r\n    return [...this._linkedAssets];\r\n  }\r\n\r\n  addLinkedAsset = (type: string, id: string) => {\r\n    const existingAsset = this._linkedAssets.find((asset) => {\r\n      return asset.id === id;\r\n    });\r\n\r\n    if (existingAsset === undefined) {\r\n      this._linkedAssets.push({\r\n        id,\r\n        type\r\n      });\r\n      this.notifyOnChange();\r\n    }\r\n  };\r\n\r\n  removeLinkedAsset = (type: string, id: string) => {\r\n    let foundAsset: boolean = false;\r\n    this._linkedAssets.forEach((asset) => {\r\n      if (asset.type === type && asset.id === id) {\r\n        foundAsset = true;\r\n      }\r\n    });\r\n\r\n    if (foundAsset) {\r\n      this._linkedAssets = this._linkedAssets.filter(\r\n        (asset) => asset.id !== id\r\n      );\r\n      this.notifyOnChange();\r\n    }\r\n  };\r\n\r\n  getLinkedAssetByType = (type: string): string[] => {\r\n    const rVal: string[] = [];\r\n\r\n    this._linkedAssets.forEach((asset) => {\r\n      if (asset.type === type) {\r\n        rVal.push(asset.id);\r\n      }\r\n    });\r\n\r\n    return rVal;\r\n  };\r\n\r\n  private _memoizedIsFetchingFile: MemoizedBoolean = new MemoizedBoolean(\r\n    false,\r\n    this.notifyOnChange\r\n  );\r\n  get isFetchingFile(): boolean {\r\n    return this._memoizedIsFetchingFile.val;\r\n  }\r\n  set isFetchingFile(archived: boolean) {\r\n    this._memoizedIsFetchingFile.val = archived;\r\n  }\r\n\r\n  private _fetchError: Error | undefined = undefined;\r\n  get fetchError(): Error | undefined {\r\n    return this._fetchError;\r\n  }\r\n  set fetchError(fetchError: Error | undefined) {\r\n    if (fetchError === undefined && this.fetchError === undefined) return;\r\n\r\n    if (\r\n      fetchError !== undefined &&\r\n      this.fetchError !== undefined &&\r\n      fetchError.message === this.fetchError.message\r\n    )\r\n      return;\r\n\r\n    this._fetchError = fetchError;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  dispose = () => {\r\n    if (this._blobURL !== undefined) {\r\n      URL.revokeObjectURL(this._blobURL);\r\n      this._blobURL = undefined;\r\n      this.notifyOnChange();\r\n    }\r\n    super.dispose();\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AssetEntity.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AssetEntity.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  MemoizedBoolean,\r\n  MemoizedString\r\n} from \"@vived/core\";\r\n\r\n/**\r\n * AssetEntity manages individual file-based resources in VIVED applications.\r\n *\r\n * This entity handles:\r\n * 1. Asset metadata (name, description, owner, archive status)\r\n * 2. File management (filename, fileURL, blob URL creation)\r\n * 3. Linked asset relationships for hierarchical asset structures\r\n * 4. Fetch state management (loading indicators, error handling)\r\n * 5. Observer pattern implementation for UI updates\r\n *\r\n * Key Concepts:\r\n * - Uses memoized properties for efficient change tracking and notifications\r\n * - Supports both file URLs (remote) and blob URLs (local) for flexible file access\r\n * - Maintains linked asset relationships to support complex asset hierarchies\r\n * - Implements observer pattern to notify UI components of changes\r\n *\r\n * Usage Patterns:\r\n * ```typescript\r\n * // Get an asset entity from an app object\r\n * const asset = AssetEntity.get(appObject);\r\n * if (asset) {\r\n *   // Set asset metadata\r\n *   asset.name = \"My Asset\";\r\n *   asset.description = \"A sample asset\";\r\n *\r\n *   // Handle file operations\r\n *   asset.setFile(fileObject);\r\n *   const blobURL = asset.blobURL; // Access local blob URL\r\n *\r\n *   // Manage linked assets\r\n *   asset.addLinkedAsset(\"texture\", \"texture123\");\r\n *   const textures = asset.getLinkedAssetByType(\"texture\");\r\n *\r\n *   // Monitor fetch state\r\n *   if (asset.isFetchingFile) {\r\n *     console.log(\"File is being downloaded...\");\r\n *   }\r\n *   if (asset.fetchError) {\r\n *     console.error(\"Failed to fetch file:\", asset.fetchError.message);\r\n *   }\r\n * }\r\n * ```\r\n *\r\n * Integration Points:\r\n * - Works with AssetRepo for asset lifecycle management\r\n * - Integrates with AppAssetsEntity for collection management\r\n * - Used by GetAssetBlobURLUC for file retrieval operations\r\n * - Supports caching mechanisms for optimized file access\r\n */\r\nexport abstract class AssetEntity extends AppObjectEntity {\r\n  /** Static type identifier for component registration */\r\n  static type = \"AssetEntity\";\r\n\r\n  /**\r\n   * Unique identifier for this asset, derived from the underlying AppObject\r\n   * @readonly\r\n   */\r\n  abstract readonly id: string;\r\n\r\n  /**\r\n   * Display name of the asset\r\n   * Triggers change notifications when modified for UI updates\r\n   */\r\n  abstract get name(): string;\r\n  abstract set name(name: string);\r\n\r\n  /**\r\n   * Detailed description of the asset's purpose or content\r\n   * Triggers change notifications when modified for UI updates\r\n   */\r\n  abstract get description(): string;\r\n  abstract set description(description: string);\r\n\r\n  /**\r\n   * ID of the user or entity that owns this asset\r\n   * Used for permission and filtering operations\r\n   */\r\n  abstract get owner(): string;\r\n  abstract set owner(val: string);\r\n\r\n  /**\r\n   * Whether this asset is archived (hidden from normal views)\r\n   * Used for soft deletion and filtering capabilities\r\n   */\r\n  abstract get archived(): boolean;\r\n  abstract set archived(archived: boolean);\r\n\r\n  /**\r\n   * Original filename of the uploaded file\r\n   * Preserved for download operations and display purposes\r\n   */\r\n  abstract get filename(): string;\r\n  abstract set filename(filename: string);\r\n\r\n  /**\r\n   * Remote URL where the file can be accessed\r\n   * Used for fetching the actual file content from external storage\r\n   */\r\n  abstract get fileURL(): string;\r\n  abstract set fileURL(fileURL: string);\r\n\r\n  /**\r\n   * Sets the local file object and creates a blob URL for immediate access\r\n   * @param file - The file object to associate with this asset\r\n   * Side effects: Creates blob URL, triggers change notifications\r\n   */\r\n  abstract setFile(file: File): void;\r\n\r\n  /**\r\n   * The local file object if one has been set\r\n   * @returns File object or undefined if no file has been loaded locally\r\n   */\r\n  abstract get file(): File | undefined;\r\n\r\n  /**\r\n   * Local blob URL for immediate file access without network requests\r\n   * @returns Blob URL string or undefined if no local file is available\r\n   */\r\n  abstract get blobURL(): string | undefined;\r\n\r\n  /**\r\n   * Indicates whether the file has been successfully fetched and stored locally\r\n   * @returns true if file is available locally, false otherwise\r\n   */\r\n  abstract get fileHasBeenFetched(): boolean;\r\n\r\n  /**\r\n   * Array of linked assets that have relationships with this asset\r\n   * Supports hierarchical asset structures (e.g., models with textures)\r\n   * @returns Array of linked asset references with type and ID\r\n   */\r\n  abstract get linkedAssets(): { type: string; id: string }[];\r\n\r\n  /**\r\n   * Adds a linked asset relationship\r\n   * @param type - The type/category of the linked asset (e.g., \"texture\", \"sound\")\r\n   * @param id - The unique ID of the linked asset\r\n   * Side effects: Triggers change notifications if asset is not already linked\r\n   */\r\n  abstract addLinkedAsset(type: string, id: string): void;\r\n\r\n  /**\r\n   * Removes a linked asset relationship\r\n   * @param type - The type/category of the linked asset to remove\r\n   * @param id - The unique ID of the linked asset to remove\r\n   * Side effects: Triggers change notifications if asset was previously linked\r\n   */\r\n  abstract removeLinkedAsset(type: string, id: string): void;\r\n\r\n  /**\r\n   * Retrieves all linked asset IDs of a specific type\r\n   * @param type - The type/category to filter by (e.g., \"texture\", \"sound\")\r\n   * @returns Array of asset IDs that match the specified type\r\n   */\r\n  abstract getLinkedAssetByType(type: string): string[];\r\n\r\n  /**\r\n   * Indicates whether a file fetch operation is currently in progress\r\n   * Used for showing loading states in UI components\r\n   */\r\n  abstract get isFetchingFile(): boolean;\r\n  abstract set isFetchingFile(isFetchingFile: boolean);\r\n\r\n  /**\r\n   * Any error that occurred during the most recent fetch operation\r\n   * Used for error handling and user feedback in UI components\r\n   */\r\n  abstract get fetchError(): Error | undefined;\r\n  abstract set fetchError(fetchError: Error | undefined);\r\n\r\n  /**\r\n   * Retrieves an AssetEntity component from an AppObject\r\n   * @param appObject - The AppObject to search for the AssetEntity component\r\n   * @returns AssetEntity instance or undefined if not found\r\n   * Logs warning if component is not found to aid in debugging\r\n   */\r\n  static get(appObject: AppObject): AssetEntity | undefined {\r\n    const asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!asset) {\r\n      appObject.appObjectRepo.submitWarning(\r\n        \"AssetEntity.get\",\r\n        \"Unable to find AssetEntity on app object \" + appObject.id\r\n      );\r\n    }\r\n    return asset;\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new AssetEntity instance\r\n * @param appObject - The AppObject that will host this AssetEntity\r\n * @returns A new AssetEntity implementation instance\r\n */\r\nexport function makeAssetEntity(appObject: AppObject): AssetEntity {\r\n  return new AssetImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of AssetEntity that handles all the concrete functionality.\r\n *\r\n * Key Implementation Details:\r\n * - Uses MemoizedString and MemoizedBoolean for efficient change tracking\r\n * - All memoized properties automatically trigger change notifications when modified\r\n * - Blob URL management with proper cleanup on disposal\r\n * - Linked asset management with duplicate prevention\r\n * - File fetch state management for async operations\r\n *\r\n * Memoization Pattern:\r\n * The implementation uses memoized properties that only trigger change notifications\r\n * when values actually change, preventing unnecessary UI updates and improving performance.\r\n * Each memoized property is initialized with a default value and a change callback.\r\n */\r\nclass AssetImp extends AssetEntity {\r\n  /** Returns the unique ID from the underlying AppObject */\r\n  get id(): string {\r\n    return this.appObject.id;\r\n  }\r\n\r\n  /**\r\n   * Memoized asset name with change notification\r\n   * Initialized to empty string, triggers notifyOnChange when modified\r\n   */\r\n  private _memoizedName: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  get name(): string {\r\n    return this._memoizedName.val;\r\n  }\r\n\r\n  set name(name: string) {\r\n    this._memoizedName.val = name;\r\n  }\r\n\r\n  /**\r\n   * Memoized asset owner with change notification\r\n   * Stores the ID of the user/entity that owns this asset\r\n   */\r\n  private _memoizedOwner: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  get owner(): string {\r\n    return this._memoizedOwner.val;\r\n  }\r\n\r\n  set owner(val: string) {\r\n    this._memoizedOwner.val = val;\r\n  }\r\n\r\n  /**\r\n   * Memoized asset description with change notification\r\n   * Stores detailed information about the asset's purpose or content\r\n   */\r\n  private _memoizedDescription: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n  get description(): string {\r\n    return this._memoizedDescription.val;\r\n  }\r\n\r\n  set description(description: string) {\r\n    this._memoizedDescription.val = description;\r\n  }\r\n\r\n  /**\r\n   * Memoized archive status with change notification\r\n   * Used for soft deletion and filtering of assets\r\n   */\r\n  private _memoizedArchived: MemoizedBoolean = new MemoizedBoolean(\r\n    false,\r\n    this.notifyOnChange\r\n  );\r\n  get archived(): boolean {\r\n    return this._memoizedArchived.val;\r\n  }\r\n\r\n  set archived(archived: boolean) {\r\n    this._memoizedArchived.val = archived;\r\n  }\r\n\r\n  /**\r\n   * Memoized file URL for remote asset access\r\n   * Points to where the actual file can be downloaded from\r\n   */\r\n  private _memoizedFileURL: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n\r\n  /**\r\n   * Memoized filename for display and download purposes\r\n   * Preserves the original name of the uploaded file\r\n   */\r\n  private _memoizedFilename: MemoizedString = new MemoizedString(\r\n    \"\",\r\n    this.notifyOnChange\r\n  );\r\n\r\n  get filename(): string {\r\n    return this._memoizedFilename.val;\r\n  }\r\n  set filename(name: string) {\r\n    this._memoizedFilename.val = name;\r\n  }\r\n  get fileURL(): string {\r\n    return this._memoizedFileURL.val;\r\n  }\r\n\r\n  set fileURL(name: string) {\r\n    this._memoizedFileURL.val = name;\r\n  }\r\n\r\n  /** Local file object storage */\r\n  private _file: File | undefined = undefined;\r\n\r\n  /** Local blob URL for immediate file access */\r\n  private _blobURL: string | undefined = undefined;\r\n\r\n  /**\r\n   * Sets a local file and creates a blob URL for immediate access\r\n   * This is typically called after successfully downloading a file\r\n   * @param file - The file object to store locally\r\n   * Side effects: Creates blob URL, triggers change notifications to update UI\r\n   */\r\n  setFile = (file: File) => {\r\n    this._file = file;\r\n    this._blobURL = URL.createObjectURL(file);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /** Returns the locally stored file object, if any */\r\n  get file(): File | undefined {\r\n    return this._file;\r\n  }\r\n\r\n  /** Returns the blob URL for local file access, if available */\r\n  get blobURL(): string | undefined {\r\n    return this._blobURL;\r\n  }\r\n\r\n  /**\r\n   * Indicates whether a file has been successfully fetched and stored locally\r\n   * Used to determine if file operations can proceed without network requests\r\n   */\r\n  get fileHasBeenFetched(): boolean {\r\n    return this._file !== undefined;\r\n  }\r\n\r\n  /**\r\n   * Storage for linked asset relationships\r\n   * Supports hierarchical asset structures where assets depend on other assets\r\n   */\r\n  private _linkedAssets: { type: string; id: string }[] = [];\r\n\r\n  /**\r\n   * Returns a copy of all linked assets to prevent external modification\r\n   * This ensures the internal state cannot be corrupted by external code\r\n   */\r\n  get linkedAssets(): { type: string; id: string }[] {\r\n    return [...this._linkedAssets];\r\n  }\r\n\r\n  /**\r\n   * Adds a linked asset relationship if it doesn't already exist\r\n   * Prevents duplicate relationships and maintains data integrity\r\n   * @param type - Category of the linked asset (e.g., \"texture\", \"sound\", \"model\")\r\n   * @param id - Unique identifier of the linked asset\r\n   */\r\n  addLinkedAsset = (type: string, id: string) => {\r\n    const existingAsset = this._linkedAssets.find((asset) => {\r\n      return asset.id === id;\r\n    });\r\n\r\n    if (existingAsset === undefined) {\r\n      this._linkedAssets.push({\r\n        id,\r\n        type\r\n      });\r\n      this.notifyOnChange();\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Removes a linked asset relationship if it exists\r\n   * Maintains referential integrity by only removing exact matches\r\n   * @param type - Category of the linked asset to remove\r\n   * @param id - Unique identifier of the linked asset to remove\r\n   */\r\n  removeLinkedAsset = (type: string, id: string) => {\r\n    let foundAsset: boolean = false;\r\n    this._linkedAssets.forEach((asset) => {\r\n      if (asset.type === type && asset.id === id) {\r\n        foundAsset = true;\r\n      }\r\n    });\r\n\r\n    if (foundAsset) {\r\n      this._linkedAssets = this._linkedAssets.filter(\r\n        (asset) => asset.id !== id\r\n      );\r\n      this.notifyOnChange();\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Retrieves all linked asset IDs of a specific type\r\n   * Useful for finding all assets of a particular category (e.g., all textures)\r\n   * @param type - The asset type to filter by\r\n   * @returns Array of asset IDs matching the specified type\r\n   */\r\n  getLinkedAssetByType = (type: string): string[] => {\r\n    const rVal: string[] = [];\r\n\r\n    this._linkedAssets.forEach((asset) => {\r\n      if (asset.type === type) {\r\n        rVal.push(asset.id);\r\n      }\r\n    });\r\n\r\n    return rVal;\r\n  };\r\n\r\n  /**\r\n   * Memoized fetch state indicator with change notification\r\n   * Used to show loading states in UI during file download operations\r\n   */\r\n  private _memoizedIsFetchingFile: MemoizedBoolean = new MemoizedBoolean(\r\n    false,\r\n    this.notifyOnChange\r\n  );\r\n  get isFetchingFile(): boolean {\r\n    return this._memoizedIsFetchingFile.val;\r\n  }\r\n  set isFetchingFile(archived: boolean) {\r\n    this._memoizedIsFetchingFile.val = archived;\r\n  }\r\n\r\n  /**\r\n   * Storage for the most recent fetch error\r\n   * Helps with error handling and user feedback in UI components\r\n   */\r\n  private _fetchError: Error | undefined = undefined;\r\n\r\n  /** Returns the current fetch error, if any */\r\n  get fetchError(): Error | undefined {\r\n    return this._fetchError;\r\n  }\r\n\r\n  /**\r\n   * Sets the fetch error with smart change detection\r\n   * Only triggers change notifications if the error actually changes\r\n   * This prevents unnecessary UI updates when the same error is set multiple times\r\n   * @param fetchError - The error that occurred, or undefined to clear the error\r\n   */\r\n  set fetchError(fetchError: Error | undefined) {\r\n    if (fetchError === undefined && this.fetchError === undefined) return;\r\n\r\n    if (\r\n      fetchError !== undefined &&\r\n      this.fetchError !== undefined &&\r\n      fetchError.message === this.fetchError.message\r\n    )\r\n      return;\r\n\r\n    this._fetchError = fetchError;\r\n    this.notifyOnChange();\r\n  }\r\n\r\n  /**\r\n   * Cleanup method that properly releases blob URL resources\r\n   * Important: Blob URLs must be revoked to prevent memory leaks\r\n   * This is automatically called when the entity is disposed\r\n   * Side effects: Revokes blob URL, triggers change notification, calls parent dispose\r\n   */\r\n  dispose = () => {\r\n    if (this._blobURL !== undefined) {\r\n      URL.revokeObjectURL(this._blobURL);\r\n      this._blobURL = undefined;\r\n      this.notifyOnChange();\r\n    }\r\n    super.dispose();\r\n  };\r\n\r\n  /**\r\n   * Initializes the AssetEntity with proper component registration\r\n   * @param appObject - The AppObject that will host this entity\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AssetEntity.type);\r\n  }\r\n}\r\n"]}