@vived/host 4.10.0 → 4.11.0

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

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

@@ -1 +1 @@
-{"version":3,"file":"DownloadAssetFileUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/DownloadAssetFileUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AASpE,8BAAsB,mBAAoB,SAAQ,WAAW;IAC3D,MAAM,CAAC,IAAI,SAAyB;IAEpC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAClC,QAAQ,CAAC,eAAe,IAAI,IAAI;IAEhC,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,mBAAmB,GAAG,SAAS;CAuBnC;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAErB"}
+{"version":3,"file":"DownloadAssetFileUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/DownloadAssetFileUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AASpE;;;;;GAKG;AACH,8BAAsB,mBAAoB,SAAQ,WAAW;IAC3D,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAyB;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,eAAe,IAAI,IAAI;IAEhC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,mBAAmB,GAAG,SAAS;CAuBnC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,mBAAmB,CAErB"}

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

@@ -1,8 +1,51 @@
+/**
+ * EditAppAssetUC.ts
+ *
+ * This use case handles initiating the asset editing workflow by transitioning
+ * the application to editing mode for a specific asset.
+ *
+ * Key Concepts:
+ * - Manages application state transitions for asset editing workflows
+ * - Sets the editing context in AppAssetsEntity for UI components
+ * - Transitions sandbox state to enable editing interfaces
+ * - Validates asset existence before initiating editing
+ * - Provides error handling for missing assets or dependencies
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to initiate editing for specific assets
+ * - Coordinates between asset repository, app assets entity, and sandbox state
+ * - Used by controllers to start editing workflows from UI interactions
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * EditAppAssetUC handles initiating asset editing workflows and state transitions.
+ *
+ * This singleton use case manages the transition from normal asset viewing
+ * to editing mode, setting up the necessary context for editing interfaces.
+ */
 export declare abstract class EditAppAssetUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Initiates editing mode for the specified asset.
+     *
+     * @param assetID - The unique identifier of the asset to edit
+     */
     abstract editAsset(assetID: string): void;
+    /**
+     * Retrieves the singleton EditAppAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns EditAppAssetUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): EditAppAssetUC | undefined;
 }
+/**
+ * Factory function to create a new EditAppAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case (must have AssetRepo)
+ * @returns A new EditAppAssetUC implementation instance
+ */
 export declare function makeEditAppAsset(appObject: AppObject): EditAppAssetUC;
 //# sourceMappingURL=EditAppAssetUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EditAppAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/EditAppAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB,8BAAsB,cAAe,SAAQ,WAAW;IACtD,MAAM,CAAC,IAAI,SAAoB;IAE/B,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEzC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS;CAMlE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAErE"}
+{"version":3,"file":"EditAppAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/EditAppAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB;;;;;GAKG;AACH,8BAAsB,cAAe,SAAQ,WAAW;IACtD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAoB;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS;CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAErE"}

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

@@ -1,8 +1,53 @@
+/**
+ * GetAssetBlobURLUC.ts
+ *
+ * This use case provides optimized asset file retrieval with caching support,
+ * returning blob URLs for immediate use in web applications.
+ *
+ * Key Concepts:
+ * - Provides blob URLs for asset files with multi-level caching optimization
+ * - Checks memory cache (existing entities) first for immediate access
+ * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval
+ * - Finally fetches from remote API when cache misses occur
+ * - Manages fetch state indicators for UI feedback
+ * - Automatically stores fetched files in cache for future access
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to retrieve blob URL for display or download
+ * - Handles async operations with comprehensive error handling
+ * - Optimizes performance through multi-level caching strategy
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * GetAssetBlobURLUC handles optimized retrieval of asset files as blob URLs.
+ *
+ * This singleton use case implements a multi-level caching strategy to minimize
+ * network requests and provide fast access to asset files for web applications.
+ */
 export declare abstract class GetAssetBlobURLUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Retrieves a blob URL for the specified asset file.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @returns Promise resolving to a blob URL for immediate use
+     */
     abstract getAssetBlobURL(assetID: string): Promise<string>;
+    /**
+     * Retrieves the singleton GetAssetBlobURLUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetBlobURLUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): GetAssetBlobURLUC | undefined;
 }
+/**
+ * Factory function to create a new GetAssetBlobURLUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new GetAssetBlobURLUC implementation instance
+ */
 export declare function makeGetAssetBlobURLUC(appObject: AppObject): GetAssetBlobURLUC;
 //# sourceMappingURL=GetAssetBlobURLUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GetAssetBlobURLUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB,8BAAsB,iBAAkB,SAAQ,WAAW;IACzD,MAAM,CAAC,IAAI,SAAuB;IAElC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE1D,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS;CAMrE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,iBAAiB,CAE7E"}
+{"version":3,"file":"GetAssetBlobURLUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetBlobURLUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB;;;;;GAKG;AACH,8BAAsB,iBAAkB,SAAQ,WAAW;IACzD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAuB;IAElC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE1D;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS;CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,iBAAiB,CAE7E"}

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

@@ -1,8 +1,53 @@
+/**
+ * GetAssetFileUC.ts
+ *
+ * This use case handles retrieval of asset files with advanced caching strategies,
+ * returning File objects for use in web applications and file operations.
+ *
+ * Key Concepts:
+ * - Retrieves asset files as File objects with multi-level caching optimization
+ * - Checks memory cache (existing entities) first for immediate access
+ * - Falls back to persistent cache (IndexedDB/localStorage) for faster retrieval
+ * - Finally fetches from remote API when cache misses occur
+ * - Manages fetch state indicators and error handling for user feedback
+ * - Automatically stores fetched files in cache for future access
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to retrieve File object for processing or display
+ * - Handles async operations with comprehensive error handling
+ * - Optimizes performance through intelligent caching strategies
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * GetAssetFileUC handles optimized retrieval of asset files as File objects.
+ *
+ * This singleton use case implements a multi-level caching strategy to minimize
+ * network requests and provide fast access to asset files for web applications.
+ */
 export declare abstract class GetAssetFileUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Retrieves a File object for the specified asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @returns Promise resolving to a File object for the asset
+     */
     abstract getAssetFile(assetID: string): Promise<File>;
+    /**
+     * Retrieves the singleton GetAssetFileUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetFileUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): GetAssetFileUC | undefined;
 }
+/**
+ * Factory function to create a new GetAssetFileUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new GetAssetFileUC implementation instance
+ */
 export declare function makeGetAssetFileUC(appObject: AppObject): GetAssetFileUC;
 //# sourceMappingURL=GetAssetFileUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GetAssetFileUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetFileUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAMrB,8BAAsB,cAAe,SAAQ,WAAW;IACtD,MAAM,CAAC,IAAI,SAAoB;IAE/B,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAErD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS;CAMlE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAEvE"}
+{"version":3,"file":"GetAssetFileUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetFileUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAMrB;;;;;GAKG;AACH,8BAAsB,cAAe,SAAQ,WAAW;IACtD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAoB;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS;CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAEvE"}

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

@@ -1,9 +1,54 @@
+/**
+ * GetAssetUC.ts
+ *
+ * This use case handles retrieval of asset metadata, managing both local
+ * repository cache and remote API fetching to ensure asset entities exist
+ * and are properly configured.
+ *
+ * Key Concepts:
+ * - Retrieves asset entities with metadata from local cache or remote API
+ * - Maintains asset repository consistency for entity management
+ * - Uses lazy loading to fetch assets only when needed
+ * - Transforms API DTOs to local asset entities automatically
+ * - Provides singleton access for system-wide asset retrieval
+ *
+ * Usage Patterns:
+ * - Singleton use case accessed through static get() method
+ * - Called with asset ID to ensure asset entity exists and is loaded
+ * - Returns existing entities immediately or fetches from API as needed
+ * - Used by other UCs that need asset entities for operations
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
 import { AssetEntity } from "../Entities/AssetEntity";
+/**
+ * GetAssetUC handles retrieval and caching of asset entities with metadata.
+ *
+ * This singleton use case ensures asset entities exist in the local repository,
+ * fetching from the API when necessary and maintaining consistent entity state.
+ */
 export declare abstract class GetAssetUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Retrieves an asset entity, fetching from API if not already cached.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @returns Promise resolving to the asset entity with loaded metadata
+     */
     abstract getAsset(assetID: string): Promise<AssetEntity>;
+    /**
+     * Retrieves the singleton GetAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns GetAssetUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): GetAssetUC | undefined;
 }
+/**
+ * Factory function to create a new GetAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case (must have AssetRepo)
+ * @returns A new GetAssetUC implementation instance
+ */
 export declare function makeGetAssetUC(appObject: AppObject): GetAssetUC;
 //# sourceMappingURL=GetAssetUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GetAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,8BAAsB,UAAW,SAAQ,WAAW;IAClD,MAAM,CAAC,IAAI,SAAgB;IAE3B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAExD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;CAG9D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}
+{"version":3,"file":"GetAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/GetAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;;;;GAKG;AACH,8BAAsB,UAAW,SAAQ,WAAW;IAClD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAgB;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAExD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}

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

@@ -1,13 +1,49 @@
+/**
+ * NewAppAssetUC.ts
+ *
+ * This use case handles creation of new assets within application contexts,
+ * managing the complete workflow from file upload to UI state transitions.
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * Data transfer object for new application asset creation requests.
+ */
 export interface NewAppAssetDTO {
+    /** The file object to be uploaded and stored as the asset */
     file: File;
+    /** Display name for the asset */
     name: string;
+    /** Detailed description of the asset's purpose or content */
     description: string;
 }
+/**
+ * NewAppAssetUC handles creation of new assets within application contexts.
+ *
+ * This singleton use case manages asset creation with UI feedback and state transitions.
+ */
 export declare abstract class NewAppAssetUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Creates a new asset with the provided data.
+     *
+     * @param data - Complete asset information including file and metadata
+     * @returns Promise that resolves when the asset is successfully created
+     */
     abstract create(data: NewAppAssetDTO): Promise<void>;
+    /**
+     * Retrieves the singleton NewAppAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns NewAppAssetUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): NewAppAssetUC | undefined;
 }
+/**
+ * Factory function to create a new NewAppAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new NewAppAssetUC implementation instance
+ */
 export declare function makeNewAppAssetUC(appObject: AppObject): NewAppAssetUC;
 //# sourceMappingURL=NewAppAssetUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NewAppAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAppAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAUrB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8BAAsB,aAAc,SAAQ,WAAW;IACrD,MAAM,CAAC,IAAI,SAAmB;IAE9B,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS;CAGjE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAErE"}
+{"version":3,"file":"NewAppAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAppAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAUrB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,IAAI,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,8BAAsB,aAAc,SAAQ,WAAW;IACrD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAmB;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS;CAGjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAErE"}

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

@@ -1,14 +1,66 @@
+/**
+ * NewAssetUC.ts
+ *
+ * This use case handles the creation of new assets, managing the complete workflow
+ * from file upload through API persistence to local entity creation and storage.
+ *
+ * Key Concepts:
+ * - Singleton use case that handles asset creation operations
+ * - Coordinates file upload with metadata persistence via API
+ * - Creates and configures new asset entities in the local repository
+ * - Transforms between DTO formats for API and internal use
+ * - Provides unique asset IDs for tracking and reference
+ *
+ * Usage Patterns:
+ * - Accessed as a singleton through static get() method
+ * - Called with complete asset data including file and metadata
+ * - Returns asset ID for immediate reference by calling code
+ * - Handles async operations with proper error propagation
+ */
 import { AppObject, AppObjectRepo, AppObjectUC } from "@vived/core";
+/**
+ * Data transfer object for new asset creation requests.
+ * Contains all necessary information to create a new asset in the system.
+ */
 export interface NewAssetDto {
+    /** The file object to be uploaded and stored as the asset */
     file: File;
+    /** Display name for the asset */
     name: string;
+    /** Detailed description of the asset's purpose or content */
     description: string;
+    /** ID of the user or entity that owns this asset */
     owner: string;
 }
+/**
+ * NewAssetUC handles the creation of new assets in the VIVED system.
+ *
+ * This singleton use case manages the complete asset creation workflow,
+ * from initial file upload through API persistence to local entity creation.
+ */
 export declare abstract class NewAssetUC extends AppObjectUC {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Creates a new asset with the provided data.
+     *
+     * @param data - Complete asset information including file and metadata
+     * @returns Promise resolving to the unique ID of the newly created asset
+     */
     abstract create(data: NewAssetDto): Promise<string>;
+    /**
+     * Retrieves the singleton NewAssetUC instance.
+     *
+     * @param appObjects - Repository for accessing the singleton component
+     * @returns NewAssetUC instance or undefined if not found
+     */
     static get(appObjects: AppObjectRepo): NewAssetUC | undefined;
 }
+/**
+ * Factory function to create a new NewAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this singleton use case
+ * @returns A new NewAssetUC implementation instance
+ */
 export declare function makeNewAssetUC(appObject: AppObject): NewAssetUC;
 //# sourceMappingURL=NewAssetUC.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NewAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAssetUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EAEZ,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8BAAsB,UAAW,SAAQ,WAAW;IAClD,MAAM,CAAC,IAAI,SAAgB;IAE3B,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAEnD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;CAG9D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}
+{"version":3,"file":"NewAssetUC.d.ts","sourceRoot":"","sources":["../../../../src/Assets/UCs/NewAssetUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EAEZ,MAAM,aAAa,CAAC;AAIrB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,IAAI,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,8BAAsB,UAAW,SAAQ,WAAW;IAClD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAgB;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAEnD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAE/D"}