@vived/host 4.9.1 → 4.11.0

package/dist/types/Assets/Entities/AssetEntity.d.ts

@@ -1,35 +1,171 @@
 import { AppObject, AppObjectEntity } 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 declare abstract class AssetEntity extends AppObjectEntity {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Unique identifier for this asset, derived from the underlying AppObject
+     * @readonly
+     */
     abstract readonly id: string;
+    /**
+     * Display name of the asset
+     * Triggers change notifications when modified for UI updates
+     */
     abstract get name(): string;
     abstract set name(name: string);
+    /**
+     * Detailed description of the asset's purpose or content
+     * Triggers change notifications when modified for UI updates
+     */
     abstract get description(): string;
     abstract set description(description: string);
+    /**
+     * ID of the user or entity that owns this asset
+     * Used for permission and filtering operations
+     */
     abstract get owner(): string;
     abstract set owner(val: string);
+    /**
+     * Whether this asset is archived (hidden from normal views)
+     * Used for soft deletion and filtering capabilities
+     */
     abstract get archived(): boolean;
     abstract set archived(archived: boolean);
+    /**
+     * Original filename of the uploaded file
+     * Preserved for download operations and display purposes
+     */
     abstract get filename(): string;
     abstract set filename(filename: string);
+    /**
+     * Remote URL where the file can be accessed
+     * Used for fetching the actual file content from external storage
+     */
     abstract get fileURL(): string;
     abstract set fileURL(fileURL: string);
+    /**
+     * Sets the local file object and creates a blob URL for immediate access
+     * @param file - The file object to associate with this asset
+     * Side effects: Creates blob URL, triggers change notifications
+     */
     abstract setFile(file: File): void;
+    /**
+     * The local file object if one has been set
+     * @returns File object or undefined if no file has been loaded locally
+     */
     abstract get file(): File | undefined;
+    /**
+     * Local blob URL for immediate file access without network requests
+     * @returns Blob URL string or undefined if no local file is available
+     */
     abstract get blobURL(): string | undefined;
+    /**
+     * Indicates whether the file has been successfully fetched and stored locally
+     * @returns true if file is available locally, false otherwise
+     */
     abstract get fileHasBeenFetched(): boolean;
+    /**
+     * Array of linked assets that have relationships with this asset
+     * Supports hierarchical asset structures (e.g., models with textures)
+     * @returns Array of linked asset references with type and ID
+     */
     abstract get linkedAssets(): {
         type: string;
         id: string;
     }[];
+    /**
+     * Adds a linked asset relationship
+     * @param type - The type/category of the linked asset (e.g., "texture", "sound")
+     * @param id - The unique ID of the linked asset
+     * Side effects: Triggers change notifications if asset is not already linked
+     */
     abstract addLinkedAsset(type: string, id: string): void;
+    /**
+     * Removes a linked asset relationship
+     * @param type - The type/category of the linked asset to remove
+     * @param id - The unique ID of the linked asset to remove
+     * Side effects: Triggers change notifications if asset was previously linked
+     */
     abstract removeLinkedAsset(type: string, id: string): void;
+    /**
+     * Retrieves all linked asset IDs of a specific type
+     * @param type - The type/category to filter by (e.g., "texture", "sound")
+     * @returns Array of asset IDs that match the specified type
+     */
     abstract getLinkedAssetByType(type: string): string[];
+    /**
+     * Indicates whether a file fetch operation is currently in progress
+     * Used for showing loading states in UI components
+     */
     abstract get isFetchingFile(): boolean;
     abstract set isFetchingFile(isFetchingFile: boolean);
+    /**
+     * Any error that occurred during the most recent fetch operation
+     * Used for error handling and user feedback in UI components
+     */
     abstract get fetchError(): Error | undefined;
     abstract set fetchError(fetchError: Error | undefined);
+    /**
+     * 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: AppObject): AssetEntity | undefined;
 }
+/**
+ * Factory function to create a new AssetEntity instance
+ * @param appObject - The AppObject that will host this AssetEntity
+ * @returns A new AssetEntity implementation instance
+ */
 export declare function makeAssetEntity(appObject: AppObject): AssetEntity;
 //# sourceMappingURL=AssetEntity.d.ts.map

package/dist/types/Assets/Entities/AssetEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetEntity.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EAGhB,MAAM,aAAa,CAAC;AAErB,8BAAsB,WAAY,SAAQ,eAAe;IACvD,MAAM,CAAC,IAAI,SAAiB;IAE5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;IAEhC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IACnC,QAAQ,KAAK,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE;IAE9C,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC;IAC7B,QAAQ,KAAK,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE;IAEhC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE;IAEzC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAExC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC;IAC/B,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE;IAEtC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAClC,QAAQ,KAAK,IAAI,IAAI,IAAI,GAAG,SAAS,CAAC;IACtC,QAAQ,KAAK,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC;IAE3C,QAAQ,KAAK,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IACvD,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAErD,QAAQ,KAAK,cAAc,IAAI,OAAO,CAAC;IACvC,QAAQ,KAAK,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE;IAErD,QAAQ,KAAK,UAAU,IAAI,KAAK,GAAG,SAAS,CAAC;IAC7C,QAAQ,KAAK,UAAU,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,EAAE;IAEvD,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;CAU1D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAEjE"}
+{"version":3,"file":"AssetEntity.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EAGhB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,8BAAsB,WAAY,SAAQ,eAAe;IACvD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAiB;IAE5B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;IAEhC;;;OAGG;IACH,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IACnC,QAAQ,KAAK,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE;IAE9C;;;OAGG;IACH,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC;IAC7B,QAAQ,KAAK,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE;IAEhC;;;OAGG;IACH,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE;IAEzC;;;OAGG;IACH,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAExC;;;OAGG;IACH,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC;IAC/B,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAElC;;;OAGG;IACH,QAAQ,KAAK,IAAI,IAAI,IAAI,GAAG,SAAS,CAAC;IAEtC;;;OAGG;IACH,QAAQ,KAAK,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAE3C;;;OAGG;IACH,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,KAAK,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE5D;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAE1D;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAErD;;;OAGG;IACH,QAAQ,KAAK,cAAc,IAAI,OAAO,CAAC;IACvC,QAAQ,KAAK,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE;IAErD;;;OAGG;IACH,QAAQ,KAAK,UAAU,IAAI,KAAK,GAAG,SAAS,CAAC;IAC7C,QAAQ,KAAK,UAAU,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,EAAE;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;CAU1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAEjE"}

package/dist/types/Assets/Entities/AssetRepo.d.ts

@@ -1,5 +1,22 @@
 import { AppObject, AppObjectEntity, AppObjectRepo } from "@vived/core";
 import { AssetEntity } from "./AssetEntity";
+/**
+ * Data Transfer Object interface for asset operations between external APIs and the asset system.
+ *
+ * This interface defines the structure for transferring asset data from external sources
+ * (such as APIs, databases, or file systems) into the VIVED asset management system.
+ * It includes all necessary metadata and supports hierarchical asset relationships.
+ *
+ * @interface AssetDTO
+ * @property id - Unique identifier for the asset
+ * @property ownerId - ID of the user or entity that owns this asset
+ * @property name - Display name of the asset
+ * @property description - Detailed description of the asset's purpose or content
+ * @property archived - Whether the asset is archived (soft deleted)
+ * @property filename - Original filename of the uploaded file
+ * @property fileURL - Remote URL where the file can be accessed
+ * @property linkedAssets - Array of linked asset relationships with type and nested DTO
+ */
 export interface AssetDTO {
     id: string;
     ownerId: string;
@@ -13,17 +30,120 @@ export interface AssetDTO {
         asset: AssetDTO;
     }[];
 }
+/**
+ * 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
+ */
 export declare abstract class AssetRepo extends AppObjectEntity {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Adds an asset to the repository if not already present
+     * @param asset - The AssetEntity to add to the repository
+     * Side effects: Triggers change notifications for UI updates
+     */
     abstract add(asset: AssetEntity): void;
+    /**
+     * Checks if an asset exists in the repository
+     * @param id - The unique identifier to check for
+     * @returns true if the asset exists, false otherwise
+     */
     abstract has(id: string): boolean;
+    /**
+     * Retrieves an asset from the repository
+     * @param assetID - The unique identifier of the asset to retrieve
+     * @returns AssetEntity if found, undefined otherwise
+     */
     abstract get(assetID: string): AssetEntity | undefined;
+    /**
+     * Retrieves an existing asset or creates a new one if not found
+     * Uses the asset factory to create new instances when needed
+     * @param assetID - The unique identifier of the asset
+     * @returns AssetEntity (either existing or newly created)
+     */
     abstract getOrCreate(assetID: string): AssetEntity;
+    /**
+     * Retrieves all assets currently stored in the repository
+     * @returns Array of all AssetEntity instances
+     */
     abstract getAll(): AssetEntity[];
+    /**
+     * Removes an asset from the repository
+     * @param assetID - The unique identifier of the asset to remove
+     * Side effects: Triggers change notifications for UI updates
+     */
     abstract remove(assetID: string): void;
+    /**
+     * Factory method for creating new AssetEntity instances
+     * Can be overridden or injected to customize asset creation behavior
+     * @param id - The unique identifier for the new asset
+     * @returns A new AssetEntity instance
+     */
     abstract assetFactory(id: string): AssetEntity;
+    /**
+     * Creates assets from external DTO data with recursive linked asset processing
+     * Handles complex asset hierarchies by processing all linked assets recursively
+     * @param dto - The asset data transfer object containing asset metadata and relationships
+     * @returns The primary AssetEntity created from the DTO
+     * Side effects: Creates and adds multiple assets if linked assets are present
+     */
     abstract addFromDTO(dto: AssetDTO): AssetEntity;
+    /**
+     * 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: AppObjectRepo): AssetRepo | undefined;
 }
+/**
+ * Factory function to create a new AssetRepo instance
+ * @param appObj - The AppObject that will host this AssetRepo
+ * @returns A new AssetRepo implementation instance
+ */
 export declare function makeAssetRepo(appObj: AppObject): AssetRepo;
 //# sourceMappingURL=AssetRepo.d.ts.map

package/dist/types/Assets/Entities/AssetRepo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetRepo.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,EAAE,CAAC;CACnD;AAED,8BAAsB,SAAU,SAAQ,eAAe;IACrD,MAAM,CAAC,IAAI,SAAqB;IAEhC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IACjC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IACtD,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAClD,QAAQ,CAAC,MAAM,IAAI,WAAW,EAAE;IAChC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAC9C,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW;IAE/C,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS;CAGjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAE1D"}
+{"version":3,"file":"AssetRepo.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,EAAE,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,8BAAsB,SAAU,SAAQ,eAAe;IACrD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAqB;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAEtD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAElD;;;OAGG;IACH,QAAQ,CAAC,MAAM,IAAI,WAAW,EAAE;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEtC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAE9C;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW;IAE/C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS;CAGjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAE1D"}

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

@@ -1,4 +1,4 @@
-export * from './AppAssetsEntity';
-export * from './AssetEntity';
-export * from './AssetRepo';
+export * from "./AppAssetsEntity";
+export * from "./AssetEntity";
+export * from "./AssetRepo";
 //# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,34 @@
+import { AppObject, DomainFactory } from "@vived/core";
+/**
+ * Factory responsible for setting up the Assets domain components.
+ * This factory initializes all entities, use cases, and presentation models
+ * required for the Assets functionality.
+ */
+export declare class AssetsFactory extends DomainFactory {
+    readonly factoryName = "AssetsFactory";
+    private assetRepoAO;
+    private appAssetsAO;
+    private assetRepo;
+    constructor(appObject: AppObject);
+    /**
+     * Sets up all entities required for the Assets system
+     */
+    setupEntities(): void;
+    /**
+     * Creates an asset factory function that properly initializes assets with all required components
+     */
+    private makeAssetFactory;
+    /**
+     * Sets up all use cases for the Assets system
+     */
+    setupUCs(): void;
+    /**
+     * Sets up all presentation managers for the Assets system
+     */
+    setupPMs(): void;
+    /**
+     * Performs any final setup operations after all components are initialized
+     */
+    finalSetup(): void;
+}
+//# sourceMappingURL=AssetsFactory.d.ts.map

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,8 @@
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Sets up the Assets system using the domain factory pattern
+ *
+ * @param appObjects The application's object repository
+ */
+export declare function setupAssets(appObjects: AppObjectRepo): void;
+//# sourceMappingURL=setupAssets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setupAssets.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/setupAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,aAAa,QAGpD"}

package/dist/types/Assets/PMs/AssetPM.d.ts

@@ -1,14 +1,62 @@
+/**
+ * AssetPM.ts
+ *
+ * This presentation manager handles the view model generation and change tracking
+ * for individual asset entities, providing a clean interface between asset data
+ * and UI components.
+ *
+ * Key Concepts:
+ * - Transforms asset entity data into view models for UI consumption
+ * - Tracks entity changes and triggers UI updates when needed
+ * - Provides efficient comparison methods for view model equality
+ * - Manages asset entity lifecycle and observer patterns
+ * - Follows the PM pattern for separation of concerns between domain and presentation
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static getByID() method with asset ID
+ * - Automatically updates UI components when underlying asset data changes
+ * - Used by adapters to connect asset data to React components and other UI frameworks
+ */
 import { AppObject, AppObjectPM, AppObjectRepo } from "@vived/core";
+/**
+ * View model interface representing asset data optimized for UI display.
+ * Contains essential asset information formatted for presentation components.
+ */
 export interface AssetVM {
+    /** Unique identifier of the asset */
     id: string;
+    /** Display name of the asset */
     name: string;
+    /** Description of the asset's purpose or content */
     description: string;
+    /** Whether the asset is archived (hidden from normal views) */
     archived: boolean;
 }
+/**
+ * AssetPM manages presentation logic for individual asset entities.
+ *
+ * This presentation manager bridges the gap between asset domain entities
+ * and UI components by providing optimized view models and change tracking.
+ */
 export declare abstract class AssetPM extends AppObjectPM<AssetVM> {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Retrieves an AssetPM component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns AssetPM instance or undefined if not found
+     */
     static getByID(assetID: string, appObjects: AppObjectRepo): AssetPM | undefined;
 }
+/**
+ * Factory function to create a new AssetPM instance.
+ *
+ * @param appObject - The AppObject that will host this PM (should contain an AssetEntity)
+ * @returns A new AssetPM implementation instance
+ */
 export declare function makeAssetPM(appObject: AppObject): AssetPM;
 export declare const defaultAssetVM: AssetVM;
 //# sourceMappingURL=AssetPM.d.ts.map

package/dist/types/Assets/PMs/AssetPM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetPM.d.ts","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,8BAAsB,OAAQ,SAAQ,WAAW,CAAC,OAAO,CAAC;IACxD,MAAM,CAAC,IAAI,SAAa;IAExB,MAAM,CAAC,OAAO,CACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,OAAO,GAAG,SAAS;CAoBvB;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAEzD;AAyCD,eAAO,MAAM,cAAc,EAAE,OAK5B,CAAC"}
+{"version":3,"file":"AssetPM.d.ts","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetPM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpE;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,8BAAsB,OAAQ,SAAQ,WAAW,CAAC,OAAO,CAAC;IACxD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAa;IAExB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,OAAO,GAAG,SAAS;CAoBvB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAEzD;AA0DD,eAAO,MAAM,cAAc,EAAE,OAK5B,CAAC"}

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

@@ -1,8 +1,55 @@
+/**
+ * ArchiveAssetUC.ts
+ *
+ * This use case handles the archiving and unarchiving of assets, providing
+ * a reversible soft-deletion mechanism that hides assets from normal views
+ * while preserving them in the system.
+ *
+ * Key Concepts:
+ * - Archive operations are reversible soft-deletion mechanisms
+ * - Archived assets remain in the system but are hidden from normal views
+ * - Uses API calls to persist archive state changes
+ * - Provides user feedback through spinner and error dialogs
+ * - Updates both local entity state and collection notifications
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Handles both archiving (hiding) and unarchiving (showing) operations
+ * - Manages async API calls with proper error handling and user feedback
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * ArchiveAssetUC manages the archiving and unarchiving operations for individual assets.
+ *
+ * This use case provides the business logic for toggling asset archive status,
+ * handling API persistence, and managing user feedback during the operation.
+ * Archive operations are reversible and provide a soft-deletion mechanism.
+ */
 export declare abstract class ArchiveAssetUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Sets the archived status of the associated asset.
+     *
+     * @param archived - True to archive (hide) the asset, false to unarchive (show) it
+     * @returns Promise that resolves when the operation completes successfully
+     */
     abstract setArchived(archived: boolean): Promise<void>;
+    /**
+     * Retrieves an ArchiveAssetUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns ArchiveAssetUC instance or undefined if not found
+     */
     static get(assetID: string, appObjects: AppObjectRepo): ArchiveAssetUC | undefined;
 }
+/**
+ * Factory function to create a new ArchiveAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new ArchiveAssetUC implementation instance
+ */
 export declare function makeArchiveAssetUC(appObject: AppObject): ArchiveAssetUC;
 //# sourceMappingURL=ArchiveAssetUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ArchiveAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/ArchiveAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAUpE,8BAAsB,cAAe,SAAQ,WAAW;IACtD,MAAM,CAAC,IAAI,SAAoB;IAE/B,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,cAAc,GAAG,SAAS;CAqB9B;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAEvE"}
+{"version":3,"file":"ArchiveAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/ArchiveAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAUpE;;;;;;GAMG;AACH,8BAAsB,cAAe,SAAQ,WAAW;IACtD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAoB;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,cAAc,GAAG,SAAS;CAqB9B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAEvE"}

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

@@ -1,9 +1,57 @@
+/**
+ * DeleteAssetUC.ts
+ *
+ * This use case handles the permanent deletion of assets from the system,
+ * including user confirmation dialogs and cleanup of all related data.
+ *
+ * Key Concepts:
+ * - Permanent deletion removes assets completely from the system
+ * - Includes mandatory user confirmation to prevent accidental deletions
+ * - Cleans up asset from all collections and repositories
+ * - Uses API calls to persist deletion on the backend
+ * - Provides user feedback through dialogs during the operation
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Provides both confirmed and unconfirmed deletion methods
+ * - Handles async operations with proper error handling and user feedback
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * DeleteAssetUC manages the permanent deletion of individual assets.
+ *
+ * This use case provides both confirmed and unconfirmed deletion methods,
+ * handling complete cleanup of asset data from all system components.
+ */
 export declare abstract class DeleteAssetUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Permanently deletes the associated asset without user confirmation.
+     *
+     * @returns Promise that resolves when the deletion completes successfully
+     */
     abstract delete(): Promise<void>;
+    /**
+     * Initiates asset deletion with user confirmation dialog.
+     * Shows a confirmation dialog before proceeding with the deletion.
+     */
     abstract deleteWithConfirm(): void;
+    /**
+     * Retrieves a DeleteAssetUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns DeleteAssetUC instance or undefined if not found
+     */
     static get(assetID: string, appObjects: AppObjectRepo): DeleteAssetUC | undefined;
 }
+/**
+ * Factory function to create a new DeleteAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new DeleteAssetUC implementation instance
+ */
 export declare function makeDeleteAssetUC(appObject: AppObject): DeleteAssetUC;
 //# sourceMappingURL=DeleteAssetUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DeleteAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/DeleteAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAYpE,8BAAsB,aAAc,SAAQ,WAAW;IACrD,MAAM,CAAC,IAAI,SAAmB;IAE9B,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAChC,QAAQ,CAAC,iBAAiB,IAAI,IAAI;IAElC,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,aAAa,GAAG,SAAS;CAqB7B;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAErE"}
+{"version":3,"file":"DeleteAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/DeleteAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAYpE;;;;;GAKG;AACH,8BAAsB,aAAc,SAAQ,WAAW;IACrD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAmB;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,IAAI,IAAI;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,aAAa,GAAG,SAAS;CAqB7B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAErE"}

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

@@ -1,9 +1,57 @@
+/**
+ * DownloadAssetFileUC.ts
+ *
+ * This use case handles downloading asset files to the user's local system,
+ * managing both cached and remote file retrieval with browser download triggers.
+ *
+ * Key Concepts:
+ * - Downloads asset files to user's local file system via browser
+ * - Handles both cached (blob URL) and remote file sources
+ * - Uses GetAssetFileUC for remote file retrieval when needed
+ * - Provides user feedback through spinner dialogs during downloads
+ * - Triggers browser download mechanism using temporary anchor elements
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Handles both immediate downloads (cached files) and fetch-then-download (remote files)
+ * - Manages async operations with proper error handling and user feedback
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * DownloadAssetFileUC manages downloading asset files to the user's local system.
+ *
+ * This use case handles the complete download workflow, from file retrieval
+ * (if necessary) to triggering the browser's download mechanism.
+ */
 export declare abstract class DownloadAssetFileUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Downloads the associated asset file to the user's local system.
+     *
+     * @returns Promise that resolves when the download operation completes
+     */
     abstract download(): Promise<void>;
+    /**
+     * Triggers the browser download mechanism for a cached asset file.
+     * This method assumes the asset already has a blob URL available.
+     */
     abstract saveFileLocally(): void;
+    /**
+     * Retrieves a DownloadAssetFileUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns DownloadAssetFileUC instance or undefined if not found
+     */
     static get(assetID: string, appObjects: AppObjectRepo): DownloadAssetFileUC | undefined;
 }
+/**
+ * Factory function to create a new DownloadAssetFileUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new DownloadAssetFileUC implementation instance
+ */
 export declare function makeDownloadAssetFileUC(appObject: AppObject): DownloadAssetFileUC;
 //# sourceMappingURL=DownloadAssetFileUC.d.ts.map