@vived/host 4.10.0 → 4.11.1

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

@@ -3,7 +3,62 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AssetEntity = void 0;
 exports.makeAssetEntity = makeAssetEntity;
 const core_1 = require("@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
+ */
 class AssetEntity extends core_1.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) {
@@ -13,11 +68,33 @@ class AssetEntity extends core_1.AppObjectEntity {
     }
 }
 exports.AssetEntity = AssetEntity;
+/** 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
+ */
 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;
     }
@@ -57,15 +134,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];
     }
@@ -75,9 +162,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;
@@ -88,22 +182,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 core_1.MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized asset owner with change notification
+         * Stores the ID of the user/entity that owns this asset
+         */
         this._memoizedOwner = new core_1.MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized asset description with change notification
+         * Stores detailed information about the asset's purpose or content
+         */
         this._memoizedDescription = new core_1.MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized archive status with change notification
+         * Used for soft deletion and filtering of assets
+         */
         this._memoizedArchived = new core_1.MemoizedBoolean(false, this.notifyOnChange);
+        /**
+         * Memoized file URL for remote asset access
+         * Points to where the actual file can be downloaded from
+         */
         this._memoizedFileURL = new core_1.MemoizedString("", this.notifyOnChange);
+        /**
+         * Memoized filename for display and download purposes
+         * Preserves the original name of the uploaded file
+         */
         this._memoizedFilename = new core_1.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;
@@ -116,6 +256,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) => {
@@ -128,6 +274,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) => {
@@ -137,8 +289,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 core_1.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/cjs/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"]}

package/dist/cjs/Assets/Entities/AssetRepo.js

@@ -4,17 +4,107 @@ exports.AssetRepo = void 0;
 exports.makeAssetRepo = makeAssetRepo;
 const core_1 = require("@vived/core");
 const AssetEntity_1 = require("./AssetEntity");
+/**
+ * AssetRepo implements the Repository pattern for asset lifecycle management in VIVED applications.
+ *
+ * This singleton entity handles:
+ * 1. Asset CRUD operations (Create, Read, Update, Delete)
+ * 2. Factory pattern for asset creation with dependency injection support
+ * 3. DTO to entity mapping for external data integration
+ * 4. Recursive linked asset processing for complex hierarchies
+ * 5. Asset lookup and caching for performance optimization
+ *
+ * Key Concepts:
+ * - Repository pattern provides a clean abstraction over asset storage
+ * - Factory pattern allows for customizable asset creation strategies
+ * - DTO processing supports complex asset hierarchies with linked relationships
+ * - Singleton pattern ensures consistent asset management across the application
+ *
+ * Usage Patterns:
+ * ```typescript
+ * // Get the global asset repository
+ * const assetRepo = AssetRepo.get(appObjects);
+ * if (assetRepo) {
+ *   // Basic CRUD operations
+ *   const asset = assetRepo.getOrCreate("asset123");
+ *   assetRepo.add(asset);
+ *   const allAssets = assetRepo.getAll();
+ *   const exists = assetRepo.has("asset123");
+ *   assetRepo.remove("asset123");
+ *
+ *   // DTO processing for external data
+ *   const assetDTO = {
+ *     id: "asset456",
+ *     name: "Sample Asset",
+ *     // ... other properties
+ *     linkedAssets: [
+ *       { type: "texture", asset: textureDTO },
+ *       { type: "sound", asset: soundDTO }
+ *     ]
+ *   };
+ *   const createdAsset = assetRepo.addFromDTO(assetDTO);
+ * }
+ * ```
+ *
+ * Integration Points:
+ * - Works with AssetEntity for individual asset management
+ * - Integrates with AppAssetsEntity for collection operations
+ * - Used by GetAppAssetsUC and other use cases for bulk operations
+ * - Supports external APIs through DTO processing
+ */
 class AssetRepo extends core_1.AppObjectEntity {
+    /**
+     * Retrieves the singleton AssetRepo from the host application objects
+     * @param hostAppObjects - The application object repository to search
+     * @returns AssetRepo instance or undefined if not found
+     * Uses getSingletonComponent to ensure only one instance exists
+     */
     static get(hostAppObjects) {
         return (0, core_1.getSingletonComponent)(AssetRepo.type, hostAppObjects);
     }
 }
 exports.AssetRepo = AssetRepo;
+/** Static type identifier for component registration */
 AssetRepo.type = "AssetRepository";
+/**
+ * Factory function to create a new AssetRepo instance
+ * @param appObj - The AppObject that will host this AssetRepo
+ * @returns A new AssetRepo implementation instance
+ */
 function makeAssetRepo(appObj) {
     return new AssetRepositoryImp(appObj);
 }
+/**
+ * Private implementation of AssetRepo that handles all concrete repository functionality.
+ *
+ * Key Implementation Details:
+ * - Uses Map for efficient asset lookup and storage
+ * - Implements factory pattern with fallback to default asset creation
+ * - Processes DTOs recursively to handle complex asset hierarchies
+ * - Maintains referential integrity when mapping DTOs to entities
+ * - Automatic singleton registration ensures global accessibility
+ *
+ * DTO Processing Pattern:
+ * The addFromDTO method recursively processes linked assets to ensure that
+ * complex asset hierarchies are properly created and linked. This supports
+ * scenarios where assets depend on other assets (e.g., 3D models with textures).
+ *
+ * Factory Pattern Implementation:
+ * The assetFactory method can be overridden or injected to customize how
+ * assets are created, allowing for different asset types or initialization strategies.
+ */
 class AssetRepositoryImp extends AssetRepo {
+    /**
+     * Creates assets from external DTO data with recursive linked asset processing
+     * This method handles complex asset hierarchies by:
+     * 1. Creating the primary asset from the DTO
+     * 2. Recursively processing all linked assets
+     * 3. Establishing relationships between assets
+     *
+     * @param dto - The asset data transfer object containing metadata and relationships
+     * @returns The primary AssetEntity created from the DTO
+     * Side effects: Creates and adds multiple assets for complex hierarchies
+     */
     addFromDTO(dto) {
         const baseAsset = this.getOrCreate(dto.id);
         this.setAssetFromDTO(dto, baseAsset);
@@ -26,31 +116,74 @@ class AssetRepositoryImp extends AssetRepo {
         });
         return baseAsset;
     }
+    /**
+     * Recursively processes linked asset DTOs to build a flat list of all dependencies
+     * This method traverses the entire asset hierarchy to ensure all linked assets
+     * are processed regardless of nesting depth
+     *
+     * @param linkedAssetList - Array of linked asset references with type and DTO
+     * @param metaList - Accumulator array for collecting all linked DTOs
+     * Side effects: Populates metaList with all linked DTOs found in the hierarchy
+     */
     addLinkedAssetDTOsRecursively(linkedAssetList, metaList) {
         linkedAssetList.forEach((linkedAsset) => {
             metaList.push(linkedAsset.asset);
             this.addLinkedAssetDTOsRecursively(linkedAsset.asset.linkedAssets, metaList);
         });
     }
+    /**
+     * Initializes the AssetRepo with singleton registration
+     * @param appObj - The AppObject that will host this repository
+     * Side effects: Registers this instance as a singleton for global access
+     */
     constructor(appObj) {
         super(appObj, AssetRepo.type);
+        /** Internal storage for asset lookup using Map for O(1) access */
         this.assetLookup = new Map();
+        /**
+         * Checks if an asset exists in the repository
+         * @param id - The asset ID to check for
+         * @returns true if asset exists, false otherwise
+         */
         this.has = (id) => {
             return this.assetLookup.has(id);
         };
+        /**
+         * Factory method for creating new AssetEntity instances
+         * Uses default factory if not injected via dependency injection
+         * This allows for dependency injection of custom asset creation logic
+         * @param id - The unique identifier for the new asset
+         * @returns A new AssetEntity instance using the default factory
+         */
         this.assetFactory = (id) => {
-            this.error("Asset factory has not been injected");
             return (0, AssetEntity_1.makeAssetEntity)(this.appObjects.getOrCreate(id));
         };
+        /**
+         * Adds an asset to the repository if not already present
+         * Prevents duplicate entries and maintains repository integrity
+         * @param asset - The AssetEntity to add
+         * Side effects: Triggers change notifications if asset was added
+         */
         this.add = (asset) => {
             if (this.assetLookup.has(asset.id))
                 return;
             this.assetLookup.set(asset.id, asset);
             this.notifyOnChange();
         };
+        /**
+         * Retrieves an asset from the repository
+         * @param assetID - The unique identifier of the asset
+         * @returns AssetEntity if found, undefined otherwise
+         */
         this.get = (assetID) => {
             return this.assetLookup.get(assetID);
         };
+        /**
+         * Retrieves an existing asset or creates a new one using the factory
+         * This is the primary method for ensuring assets exist in the repository
+         * @param assetID - The unique identifier of the asset
+         * @returns AssetEntity (either existing or newly created)
+         */
         this.getOrCreate = (assetID) => {
             const existing = this.assetLookup.get(assetID);
             if (existing) {
@@ -60,15 +193,35 @@ class AssetRepositoryImp extends AssetRepo {
             this.add(newAsset);
             return newAsset;
         };
+        /**
+         * Retrieves all assets in the repository
+         * Returns the values from the internal Map as an array
+         * @returns Array of all AssetEntity instances
+         */
         this.getAll = () => {
             return Array.from(this.assetLookup.values());
         };
+        /**
+         * Removes an asset from the repository if present
+         * @param assetID - The unique identifier of the asset to remove
+         * Side effects: Triggers change notifications if asset was removed
+         */
         this.remove = (assetID) => {
             if (!this.assetLookup.has(assetID))
                 return;
             this.assetLookup.delete(assetID);
             this.notifyOnChange();
         };
+        /**
+         * Maps DTO properties to an AssetEntity instance
+         * This method handles the conversion from external data format to internal entity state
+         * Also establishes linked asset relationships
+         *
+         * @param data - The DTO containing asset metadata
+         * @param asset - The AssetEntity to populate with DTO data
+         * @returns The populated AssetEntity for chaining
+         * Side effects: Modifies asset properties and establishes linked asset relationships
+         */
         this.setAssetFromDTO = (data, asset) => {
             asset.description = data.description;
             asset.name = data.name;

package/dist/cjs/Assets/Entities/AssetRepo.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetRepo.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AssetEntity, makeAssetEntity } from \"./AssetEntity\";\r\n\r\nexport interface AssetDTO {\r\n  id: string;\r\n  ownerId: string;\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n  filename: string;\r\n  fileURL: string;\r\n  linkedAssets: { type: string; asset: AssetDTO }[];\r\n}\r\n\r\nexport abstract class AssetRepo extends AppObjectEntity {\r\n  static type = \"AssetRepository\";\r\n\r\n  abstract add(asset: AssetEntity): void;\r\n  abstract has(id: string): boolean;\r\n  abstract get(assetID: string): AssetEntity | undefined;\r\n  abstract getOrCreate(assetID: string): AssetEntity;\r\n  abstract getAll(): AssetEntity[];\r\n  abstract remove(assetID: string): void;\r\n  abstract assetFactory(id: string): AssetEntity;\r\n  abstract addFromDTO(dto: AssetDTO): AssetEntity;\r\n\r\n  static get(hostAppObjects: AppObjectRepo): AssetRepo | undefined {\r\n    return getSingletonComponent(AssetRepo.type, hostAppObjects);\r\n  }\r\n}\r\n\r\nexport function makeAssetRepo(appObj: AppObject): AssetRepo {\r\n  return new AssetRepositoryImp(appObj);\r\n}\r\n\r\nclass AssetRepositoryImp extends AssetRepo {\r\n  private assetLookup = new Map<string, AssetEntity>();\r\n\r\n  has = (id: string): boolean => {\r\n    return this.assetLookup.has(id);\r\n  };\r\n\r\n  assetFactory = (id: string): AssetEntity => {\r\n    this.error(\"Asset factory has not been injected\");\r\n    return makeAssetEntity(this.appObjects.getOrCreate(id));\r\n  };\r\n\r\n  add = (asset: AssetEntity): void => {\r\n    if (this.assetLookup.has(asset.id)) return;\r\n    this.assetLookup.set(asset.id, asset);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  get = (assetID: string): AssetEntity | undefined => {\r\n    return this.assetLookup.get(assetID);\r\n  };\r\n\r\n  getOrCreate = (assetID: string): AssetEntity => {\r\n    const existing = this.assetLookup.get(assetID);\r\n    if (existing) {\r\n      return existing;\r\n    }\r\n\r\n    const newAsset = this.assetFactory(assetID);\r\n    this.add(newAsset);\r\n    return newAsset;\r\n  };\r\n\r\n  getAll = (): AssetEntity[] => {\r\n    return Array.from(this.assetLookup.values());\r\n  };\r\n\r\n  remove = (assetID: string) => {\r\n    if (!this.assetLookup.has(assetID)) return;\r\n\r\n    this.assetLookup.delete(assetID);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  addFromDTO(dto: AssetDTO): AssetEntity {\r\n    const baseAsset = this.getOrCreate(dto.id);\r\n    this.setAssetFromDTO(dto, baseAsset);\r\n\r\n    const allLinkedDTOs: AssetDTO[] = [];\r\n    this.addLinkedAssetDTOsRecursively(dto.linkedAssets, allLinkedDTOs);\r\n\r\n    allLinkedDTOs.forEach((linkedDTO) => {\r\n      const asset = this.getOrCreate(linkedDTO.id);\r\n      this.setAssetFromDTO(linkedDTO, asset);\r\n    });\r\n\r\n    return baseAsset;\r\n  }\r\n\r\n  private addLinkedAssetDTOsRecursively(\r\n    linkedAssetList: { type: string; asset: AssetDTO }[],\r\n    metaList: AssetDTO[]\r\n  ) {\r\n    linkedAssetList.forEach((linkedAsset) => {\r\n      metaList.push(linkedAsset.asset);\r\n      this.addLinkedAssetDTOsRecursively(\r\n        linkedAsset.asset.linkedAssets,\r\n        metaList\r\n      );\r\n    });\r\n  }\r\n\r\n  private setAssetFromDTO = (data: AssetDTO, asset: AssetEntity) => {\r\n    asset.description = data.description;\r\n    asset.name = data.name;\r\n    asset.archived = data.archived;\r\n    asset.filename = data.filename;\r\n    asset.owner = data.ownerId;\r\n    asset.fileURL = data.fileURL;\r\n\r\n    data.linkedAssets.forEach((linkedAsset) => {\r\n      asset.addLinkedAsset(linkedAsset.type, linkedAsset.asset.id);\r\n    });\r\n\r\n    return asset;\r\n  };\r\n\r\n  constructor(appObj: AppObject) {\r\n    super(appObj, AssetRepo.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AssetRepo.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetRepo.ts"],"names":[],"mappings":";;;AAmKA,sCAEC;AArKD,sCAKqB;AACrB,+CAA6D;AA8B7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAsB,SAAU,SAAQ,sBAAe;IA+DrD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,cAA6B;QACtC,OAAO,IAAA,4BAAqB,EAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;;AAvEH,8BAwEC;AAvEC,wDAAwD;AACjD,cAAI,GAAG,iBAAiB,CAAC;AAwElC;;;;GAIG;AACH,SAAgB,aAAa,CAAC,MAAiB;IAC7C,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,kBAAmB,SAAQ,SAAS;IAkFxC;;;;;;;;;;OAUG;IACH,UAAU,CAAC,GAAa;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAErC,MAAM,aAAa,GAAe,EAAE,CAAC;QACrC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAEpE,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACK,6BAA6B,CACnC,eAAoD,EACpD,QAAoB;QAEpB,eAAe,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YACtC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,6BAA6B,CAChC,WAAW,CAAC,KAAK,CAAC,YAAY,EAC9B,QAAQ,CACT,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IA2BD;;;;OAIG;IACH,YAAY,MAAiB;QAC3B,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAhKhC,kEAAkE;QAC1D,gBAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;QAErD;;;;WAIG;QACH,QAAG,GAAG,CAAC,EAAU,EAAW,EAAE;YAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;QACF;;;;;;WAMG;QACH,iBAAY,GAAG,CAAC,EAAU,EAAe,EAAE;YACzC,OAAO,IAAA,6BAAe,EAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC;QAEF;;;;;WAKG;QACH,QAAG,GAAG,CAAC,KAAkB,EAAQ,EAAE;YACjC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,OAAO;YAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF;;;;WAIG;QACH,QAAG,GAAG,CAAC,OAAe,EAA2B,EAAE;YACjD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC;QAEF;;;;;WAKG;QACH,gBAAW,GAAG,CAAC,OAAe,EAAe,EAAE;YAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;QAEF;;;;WAIG;QACH,WAAM,GAAG,GAAkB,EAAE;YAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEF;;;;WAIG;QACH,WAAM,GAAG,CAAC,OAAe,EAAE,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,OAAO;YAE3C,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAkDF;;;;;;;;;WASG;QACK,oBAAe,GAAG,CAAC,IAAc,EAAE,KAAkB,EAAE,EAAE;YAC/D,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;YAC3B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAE7B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;gBACxC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QASA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AssetEntity, makeAssetEntity } from \"./AssetEntity\";\r\n\r\n/**\r\n * Data Transfer Object interface for asset operations between external APIs and the asset system.\r\n *\r\n * This interface defines the structure for transferring asset data from external sources\r\n * (such as APIs, databases, or file systems) into the VIVED asset management system.\r\n * It includes all necessary metadata and supports hierarchical asset relationships.\r\n *\r\n * @interface AssetDTO\r\n * @property id - Unique identifier for the asset\r\n * @property ownerId - ID of the user or entity that owns this asset\r\n * @property name - Display name of the asset\r\n * @property description - Detailed description of the asset's purpose or content\r\n * @property archived - Whether the asset is archived (soft deleted)\r\n * @property filename - Original filename of the uploaded file\r\n * @property fileURL - Remote URL where the file can be accessed\r\n * @property linkedAssets - Array of linked asset relationships with type and nested DTO\r\n */\r\nexport interface AssetDTO {\r\n  id: string;\r\n  ownerId: string;\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n  filename: string;\r\n  fileURL: string;\r\n  linkedAssets: { type: string; asset: AssetDTO }[];\r\n}\r\n\r\n/**\r\n * AssetRepo implements the Repository pattern for asset lifecycle management in VIVED applications.\r\n *\r\n * This singleton entity handles:\r\n * 1. Asset CRUD operations (Create, Read, Update, Delete)\r\n * 2. Factory pattern for asset creation with dependency injection support\r\n * 3. DTO to entity mapping for external data integration\r\n * 4. Recursive linked asset processing for complex hierarchies\r\n * 5. Asset lookup and caching for performance optimization\r\n *\r\n * Key Concepts:\r\n * - Repository pattern provides a clean abstraction over asset storage\r\n * - Factory pattern allows for customizable asset creation strategies\r\n * - DTO processing supports complex asset hierarchies with linked relationships\r\n * - Singleton pattern ensures consistent asset management across the application\r\n *\r\n * Usage Patterns:\r\n * ```typescript\r\n * // Get the global asset repository\r\n * const assetRepo = AssetRepo.get(appObjects);\r\n * if (assetRepo) {\r\n *   // Basic CRUD operations\r\n *   const asset = assetRepo.getOrCreate(\"asset123\");\r\n *   assetRepo.add(asset);\r\n *   const allAssets = assetRepo.getAll();\r\n *   const exists = assetRepo.has(\"asset123\");\r\n *   assetRepo.remove(\"asset123\");\r\n *\r\n *   // DTO processing for external data\r\n *   const assetDTO = {\r\n *     id: \"asset456\",\r\n *     name: \"Sample Asset\",\r\n *     // ... other properties\r\n *     linkedAssets: [\r\n *       { type: \"texture\", asset: textureDTO },\r\n *       { type: \"sound\", asset: soundDTO }\r\n *     ]\r\n *   };\r\n *   const createdAsset = assetRepo.addFromDTO(assetDTO);\r\n * }\r\n * ```\r\n *\r\n * Integration Points:\r\n * - Works with AssetEntity for individual asset management\r\n * - Integrates with AppAssetsEntity for collection operations\r\n * - Used by GetAppAssetsUC and other use cases for bulk operations\r\n * - Supports external APIs through DTO processing\r\n */\r\nexport abstract class AssetRepo extends AppObjectEntity {\r\n  /** Static type identifier for component registration */\r\n  static type = \"AssetRepository\";\r\n\r\n  /**\r\n   * Adds an asset to the repository if not already present\r\n   * @param asset - The AssetEntity to add to the repository\r\n   * Side effects: Triggers change notifications for UI updates\r\n   */\r\n  abstract add(asset: AssetEntity): void;\r\n\r\n  /**\r\n   * Checks if an asset exists in the repository\r\n   * @param id - The unique identifier to check for\r\n   * @returns true if the asset exists, false otherwise\r\n   */\r\n  abstract has(id: string): boolean;\r\n\r\n  /**\r\n   * Retrieves an asset from the repository\r\n   * @param assetID - The unique identifier of the asset to retrieve\r\n   * @returns AssetEntity if found, undefined otherwise\r\n   */\r\n  abstract get(assetID: string): AssetEntity | undefined;\r\n\r\n  /**\r\n   * Retrieves an existing asset or creates a new one if not found\r\n   * Uses the asset factory to create new instances when needed\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns AssetEntity (either existing or newly created)\r\n   */\r\n  abstract getOrCreate(assetID: string): AssetEntity;\r\n\r\n  /**\r\n   * Retrieves all assets currently stored in the repository\r\n   * @returns Array of all AssetEntity instances\r\n   */\r\n  abstract getAll(): AssetEntity[];\r\n\r\n  /**\r\n   * Removes an asset from the repository\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   * Factory method for creating new AssetEntity instances\r\n   * Can be overridden or injected to customize asset creation behavior\r\n   * @param id - The unique identifier for the new asset\r\n   * @returns A new AssetEntity instance\r\n   */\r\n  abstract assetFactory(id: string): AssetEntity;\r\n\r\n  /**\r\n   * Creates assets from external DTO data with recursive linked asset processing\r\n   * Handles complex asset hierarchies by processing all linked assets recursively\r\n   * @param dto - The asset data transfer object containing asset metadata and relationships\r\n   * @returns The primary AssetEntity created from the DTO\r\n   * Side effects: Creates and adds multiple assets if linked assets are present\r\n   */\r\n  abstract addFromDTO(dto: AssetDTO): AssetEntity;\r\n\r\n  /**\r\n   * Retrieves the singleton AssetRepo from the host application objects\r\n   * @param hostAppObjects - The application object repository to search\r\n   * @returns AssetRepo instance or undefined if not found\r\n   * Uses getSingletonComponent to ensure only one instance exists\r\n   */\r\n  static get(hostAppObjects: AppObjectRepo): AssetRepo | undefined {\r\n    return getSingletonComponent(AssetRepo.type, hostAppObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new AssetRepo instance\r\n * @param appObj - The AppObject that will host this AssetRepo\r\n * @returns A new AssetRepo implementation instance\r\n */\r\nexport function makeAssetRepo(appObj: AppObject): AssetRepo {\r\n  return new AssetRepositoryImp(appObj);\r\n}\r\n\r\n/**\r\n * Private implementation of AssetRepo that handles all concrete repository functionality.\r\n *\r\n * Key Implementation Details:\r\n * - Uses Map for efficient asset lookup and storage\r\n * - Implements factory pattern with fallback to default asset creation\r\n * - Processes DTOs recursively to handle complex asset hierarchies\r\n * - Maintains referential integrity when mapping DTOs to entities\r\n * - Automatic singleton registration ensures global accessibility\r\n *\r\n * DTO Processing Pattern:\r\n * The addFromDTO method recursively processes linked assets to ensure that\r\n * complex asset hierarchies are properly created and linked. This supports\r\n * scenarios where assets depend on other assets (e.g., 3D models with textures).\r\n *\r\n * Factory Pattern Implementation:\r\n * The assetFactory method can be overridden or injected to customize how\r\n * assets are created, allowing for different asset types or initialization strategies.\r\n */\r\nclass AssetRepositoryImp extends AssetRepo {\r\n  /** Internal storage for asset lookup using Map for O(1) access */\r\n  private assetLookup = new Map<string, AssetEntity>();\r\n\r\n  /**\r\n   * Checks if an asset exists in the repository\r\n   * @param id - The asset ID to check for\r\n   * @returns true if asset exists, false otherwise\r\n   */\r\n  has = (id: string): boolean => {\r\n    return this.assetLookup.has(id);\r\n  };\r\n  /**\r\n   * Factory method for creating new AssetEntity instances\r\n   * Uses default factory if not injected via dependency injection\r\n   * This allows for dependency injection of custom asset creation logic\r\n   * @param id - The unique identifier for the new asset\r\n   * @returns A new AssetEntity instance using the default factory\r\n   */\r\n  assetFactory = (id: string): AssetEntity => {\r\n    return makeAssetEntity(this.appObjects.getOrCreate(id));\r\n  };\r\n\r\n  /**\r\n   * Adds an asset to the repository if not already present\r\n   * Prevents duplicate entries and maintains repository integrity\r\n   * @param asset - The AssetEntity to add\r\n   * Side effects: Triggers change notifications if asset was added\r\n   */\r\n  add = (asset: AssetEntity): void => {\r\n    if (this.assetLookup.has(asset.id)) return;\r\n    this.assetLookup.set(asset.id, asset);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Retrieves an asset from the repository\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns AssetEntity if found, undefined otherwise\r\n   */\r\n  get = (assetID: string): AssetEntity | undefined => {\r\n    return this.assetLookup.get(assetID);\r\n  };\r\n\r\n  /**\r\n   * Retrieves an existing asset or creates a new one using the factory\r\n   * This is the primary method for ensuring assets exist in the repository\r\n   * @param assetID - The unique identifier of the asset\r\n   * @returns AssetEntity (either existing or newly created)\r\n   */\r\n  getOrCreate = (assetID: string): AssetEntity => {\r\n    const existing = this.assetLookup.get(assetID);\r\n    if (existing) {\r\n      return existing;\r\n    }\r\n\r\n    const newAsset = this.assetFactory(assetID);\r\n    this.add(newAsset);\r\n    return newAsset;\r\n  };\r\n\r\n  /**\r\n   * Retrieves all assets in the repository\r\n   * Returns the values from the internal Map as an array\r\n   * @returns Array of all AssetEntity instances\r\n   */\r\n  getAll = (): AssetEntity[] => {\r\n    return Array.from(this.assetLookup.values());\r\n  };\r\n\r\n  /**\r\n   * Removes an asset from the repository if present\r\n   * @param assetID - The unique identifier of the asset to remove\r\n   * Side effects: Triggers change notifications if asset was removed\r\n   */\r\n  remove = (assetID: string) => {\r\n    if (!this.assetLookup.has(assetID)) return;\r\n\r\n    this.assetLookup.delete(assetID);\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Creates assets from external DTO data with recursive linked asset processing\r\n   * This method handles complex asset hierarchies by:\r\n   * 1. Creating the primary asset from the DTO\r\n   * 2. Recursively processing all linked assets\r\n   * 3. Establishing relationships between assets\r\n   *\r\n   * @param dto - The asset data transfer object containing metadata and relationships\r\n   * @returns The primary AssetEntity created from the DTO\r\n   * Side effects: Creates and adds multiple assets for complex hierarchies\r\n   */\r\n  addFromDTO(dto: AssetDTO): AssetEntity {\r\n    const baseAsset = this.getOrCreate(dto.id);\r\n    this.setAssetFromDTO(dto, baseAsset);\r\n\r\n    const allLinkedDTOs: AssetDTO[] = [];\r\n    this.addLinkedAssetDTOsRecursively(dto.linkedAssets, allLinkedDTOs);\r\n\r\n    allLinkedDTOs.forEach((linkedDTO) => {\r\n      const asset = this.getOrCreate(linkedDTO.id);\r\n      this.setAssetFromDTO(linkedDTO, asset);\r\n    });\r\n\r\n    return baseAsset;\r\n  }\r\n\r\n  /**\r\n   * Recursively processes linked asset DTOs to build a flat list of all dependencies\r\n   * This method traverses the entire asset hierarchy to ensure all linked assets\r\n   * are processed regardless of nesting depth\r\n   *\r\n   * @param linkedAssetList - Array of linked asset references with type and DTO\r\n   * @param metaList - Accumulator array for collecting all linked DTOs\r\n   * Side effects: Populates metaList with all linked DTOs found in the hierarchy\r\n   */\r\n  private addLinkedAssetDTOsRecursively(\r\n    linkedAssetList: { type: string; asset: AssetDTO }[],\r\n    metaList: AssetDTO[]\r\n  ) {\r\n    linkedAssetList.forEach((linkedAsset) => {\r\n      metaList.push(linkedAsset.asset);\r\n      this.addLinkedAssetDTOsRecursively(\r\n        linkedAsset.asset.linkedAssets,\r\n        metaList\r\n      );\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Maps DTO properties to an AssetEntity instance\r\n   * This method handles the conversion from external data format to internal entity state\r\n   * Also establishes linked asset relationships\r\n   *\r\n   * @param data - The DTO containing asset metadata\r\n   * @param asset - The AssetEntity to populate with DTO data\r\n   * @returns The populated AssetEntity for chaining\r\n   * Side effects: Modifies asset properties and establishes linked asset relationships\r\n   */\r\n  private setAssetFromDTO = (data: AssetDTO, asset: AssetEntity) => {\r\n    asset.description = data.description;\r\n    asset.name = data.name;\r\n    asset.archived = data.archived;\r\n    asset.filename = data.filename;\r\n    asset.owner = data.ownerId;\r\n    asset.fileURL = data.fileURL;\r\n\r\n    data.linkedAssets.forEach((linkedAsset) => {\r\n      asset.addLinkedAsset(linkedAsset.type, linkedAsset.asset.id);\r\n    });\r\n\r\n    return asset;\r\n  };\r\n\r\n  /**\r\n   * Initializes the AssetRepo with singleton registration\r\n   * @param appObj - The AppObject that will host this repository\r\n   * Side effects: Registers this instance as a singleton for global access\r\n   */\r\n  constructor(appObj: AppObject) {\r\n    super(appObj, AssetRepo.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B","sourcesContent":["export * from './AppAssetsEntity';\r\nexport * from './AssetEntity';\r\nexport * from './AssetRepo';\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Entities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B","sourcesContent":["export * from \"./AppAssetsEntity\";\nexport * from \"./AssetEntity\";\nexport * from \"./AssetRepo\";\n"]}