@vived/host 4.10.0 → 4.11.0

package/dist/cjs/VivedAPI/Mocks/index.js

@@ -1,4 +1,28 @@
 "use strict";
+/**
+ * VivedAPI Mocks Index
+ *
+ * This module exports all mock implementations for the VivedAPI feature.
+ * Mocks provide test doubles and stub implementations for development and testing
+ * scenarios where real API communication is not desired or available.
+ *
+ * Key Concepts:
+ * - Mocks implement the same interfaces as production components
+ * - They provide predictable, controllable behavior for testing
+ * - Mocks can simulate various success and failure scenarios
+ * - They enable development without requiring live API connections
+ * - Mock implementations support isolated unit testing
+ *
+ * Available Mock Components:
+ * - Presentation Manager Mocks: ApiStagePMMock, UserTokenPMMock
+ * - HTTP Request Mocks: MockBasicFetchUC, MockJsonRequestUC, MockBlobRequestUC
+ * - Authentication Mocks: MockSignedAuthToken, MockUserLoginUC
+ * - File Operation Mocks: MockFileUpload, MockFetchAssetFileFromAPIUC, MockPatchAssetFileUC
+ * - Asset Management Mocks: MockPostNewAssetUC, MockDeleteAssetOnAPIUC, MockGetAssetsForOwnerUC
+ * - Asset Metadata Mocks: MockFetchAssetMetaFromAPIUC, MockPatchAssetMetaUC, MockPatchAssetIsArchivedUC
+ * - App Management Mocks: MockGetAppFromAPIUC
+ * - Asset Update Mocks: MockPatchAssetUC
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/cjs/VivedAPI/Mocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,2DAAyC;AACzC,gEAA8C;AAC9C,gEAA8C;AAC9C,mDAAiC;AACjC,wDAAsC;AACtC,4DAA0C;AAC1C,sDAAoC;AACpC,yDAAuC;AACvC,+DAA6C;AAC7C,yDAAuC;AACvC,qDAAmC;AACnC,uDAAqC;AACrC,wDAAsC;AACtC,oDAAkC;AAClC,oDAAkC","sourcesContent":["export * from \"./ApiStagePMMock\";\r\nexport * from \"./MockBasicFetchUC\";\r\nexport * from \"./MockBlobRequestUC\";\r\nexport * from \"./MockDeleteAssetOnAPIUC\";\r\nexport * from \"./MockFetchAssetFileFromAPIUC\";\r\nexport * from \"./MockFetchAssetMetaFromAPIUC\";\r\nexport * from \"./MockFileUpload\";\r\nexport * from \"./MockGetAppFromAPIUC\";\r\nexport * from \"./MockGetAssetsForOwnerUC\";\r\nexport * from \"./MockJsonRequestUC\";\r\nexport * from \"./MockPatchAssetFileUC\";\r\nexport * from \"./MockPatchAssetIsArchivedUC\";\r\nexport * from \"./MockPatchAssetMetaUC\";\r\nexport * from \"./MockPatchAssetUC\";\r\nexport * from \"./MockPostNewAssetUC\";\r\nexport * from \"./MockSignedAuthToken\";\r\nexport * from \"./MockUserLoginUC\";\r\nexport * from \"./UserTokenPMMock\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;AAEH,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,2DAAyC;AACzC,gEAA8C;AAC9C,gEAA8C;AAC9C,mDAAiC;AACjC,wDAAsC;AACtC,4DAA0C;AAC1C,sDAAoC;AACpC,yDAAuC;AACvC,+DAA6C;AAC7C,yDAAuC;AACvC,qDAAmC;AACnC,uDAAqC;AACrC,wDAAsC;AACtC,oDAAkC;AAClC,oDAAkC","sourcesContent":["/**\r\n * VivedAPI Mocks Index\r\n * \r\n * This module exports all mock implementations for the VivedAPI feature.\r\n * Mocks provide test doubles and stub implementations for development and testing\r\n * scenarios where real API communication is not desired or available.\r\n * \r\n * Key Concepts:\r\n * - Mocks implement the same interfaces as production components\r\n * - They provide predictable, controllable behavior for testing\r\n * - Mocks can simulate various success and failure scenarios\r\n * - They enable development without requiring live API connections\r\n * - Mock implementations support isolated unit testing\r\n * \r\n * Available Mock Components:\r\n * - Presentation Manager Mocks: ApiStagePMMock, UserTokenPMMock\r\n * - HTTP Request Mocks: MockBasicFetchUC, MockJsonRequestUC, MockBlobRequestUC\r\n * - Authentication Mocks: MockSignedAuthToken, MockUserLoginUC\r\n * - File Operation Mocks: MockFileUpload, MockFetchAssetFileFromAPIUC, MockPatchAssetFileUC\r\n * - Asset Management Mocks: MockPostNewAssetUC, MockDeleteAssetOnAPIUC, MockGetAssetsForOwnerUC\r\n * - Asset Metadata Mocks: MockFetchAssetMetaFromAPIUC, MockPatchAssetMetaUC, MockPatchAssetIsArchivedUC\r\n * - App Management Mocks: MockGetAppFromAPIUC\r\n * - Asset Update Mocks: MockPatchAssetUC\r\n */\r\n\r\nexport * from \"./ApiStagePMMock\";\r\nexport * from \"./MockBasicFetchUC\";\r\nexport * from \"./MockBlobRequestUC\";\r\nexport * from \"./MockDeleteAssetOnAPIUC\";\r\nexport * from \"./MockFetchAssetFileFromAPIUC\";\r\nexport * from \"./MockFetchAssetMetaFromAPIUC\";\r\nexport * from \"./MockFileUpload\";\r\nexport * from \"./MockGetAppFromAPIUC\";\r\nexport * from \"./MockGetAssetsForOwnerUC\";\r\nexport * from \"./MockJsonRequestUC\";\r\nexport * from \"./MockPatchAssetFileUC\";\r\nexport * from \"./MockPatchAssetIsArchivedUC\";\r\nexport * from \"./MockPatchAssetMetaUC\";\r\nexport * from \"./MockPatchAssetUC\";\r\nexport * from \"./MockPostNewAssetUC\";\r\nexport * from \"./MockSignedAuthToken\";\r\nexport * from \"./MockUserLoginUC\";\r\nexport * from \"./UserTokenPMMock\";\r\n"]}

package/dist/cjs/VivedAPI/PMs/ApiStagePM.js

@@ -1,28 +1,85 @@
 "use strict";
+/**
+ * ApiStagePM.ts
+ *
+ * This file defines the Presentation Manager for API stage configuration.
+ * ApiStagePM bridges the VivedAPIEntity domain logic with UI components,
+ * managing the display and interaction of API environment settings.
+ *
+ * Key concepts:
+ * - PM extends AppObjectPM and manages view model state for API stage
+ * - Observes VivedAPIEntity changes and updates UI accordingly
+ * - Provides value comparison logic for efficient view updates
+ * - Implements singleton pattern for system-wide stage management
+ * - Handles API stage transitions and notifications
+ *
+ * Usage pattern:
+ * 1. Get the singleton PM using ApiStagePM.get(appObjects)
+ * 2. Connect to UI components that display/edit API stage
+ * 3. PM automatically updates views when entity state changes
+ * 4. Use with adapters to bind to specific UI frameworks
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiStagePM = void 0;
 exports.makeApiStagePM = makeApiStagePM;
 const core_1 = require("@vived/core");
 const Entities_1 = require("../Entities");
+/**
+ * ApiStagePM provides presentation logic for API stage configuration.
+ * Abstract class that manages the view model for API environment settings.
+ */
 class ApiStagePM extends core_1.AppObjectPM {
+    /**
+     * Retrieves the singleton ApiStagePM from the app objects repository
+     * @param appObjects The AppObjectRepo to get the singleton from
+     * @returns The ApiStagePM singleton or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(ApiStagePM.type, appObjects);
     }
 }
 exports.ApiStagePM = ApiStagePM;
+/** Unique type identifier for this component */
 ApiStagePM.type = "ApiStagePM";
+/**
+ * Factory function to create a new ApiStagePM instance
+ * @param appObject The AppObject to attach the PM to
+ * @returns A new ApiStagePM instance
+ */
 function makeApiStagePM(appObject) {
     return new ApiStagePMImp(appObject);
 }
+/**
+ * Concrete implementation of ApiStagePM
+ * This private class handles the actual presentation logic for API stage management
+ */
 class ApiStagePMImp extends ApiStagePM {
+    /**
+     * Gets the VivedAPIEntity from the same app objects repository
+     * Uses cached singleton access for efficient repeated access
+     */
     get api() {
         return this.getCachedSingleton(Entities_1.VivedAPIEntity.type);
     }
+    /**
+     * Compares two APIStage values for equality to determine if view updates are needed
+     * @param a First APIStage value to compare
+     * @param b Second APIStage value to compare
+     * @returns True if the values are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         return a === b;
     }
+    /**
+     * Constructs a new ApiStagePMImp and sets up entity observation
+     * @param appObject The AppObject this PM belongs to
+     */
     constructor(appObject) {
         super(appObject, ApiStagePM.type);
+        /**
+         * Handles entity change notifications and updates the view
+         * Called when the VivedAPIEntity's API stage changes
+         */
         this.onEntityChange = () => {
             if (!this.api)
                 return;

package/dist/cjs/VivedAPI/PMs/ApiStagePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiStagePM.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/ApiStagePM.ts"],"names":[],"mappings":";;;AAgBA,wCAEC;AAlBD,sCAKqB;AACrB,0CAAuD;AAEvD,MAAsB,UAAW,SAAQ,kBAAqB;IAG5D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AALH,gCAMC;AALQ,eAAI,GAAG,YAAY,CAAC;AAO7B,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IACpC,IAAY,GAAG;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAiB,yBAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAQD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAPpC,mBAAc,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEtB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { APIStage, VivedAPIEntity } from \"../Entities\";\r\n\r\nexport abstract class ApiStagePM extends AppObjectPM<APIStage> {\r\n  static type = \"ApiStagePM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ApiStagePM>(ApiStagePM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeApiStagePM(appObject: AppObject): ApiStagePM {\r\n  return new ApiStagePMImp(appObject);\r\n}\r\n\r\nclass ApiStagePMImp extends ApiStagePM {\r\n  private get api() {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: APIStage, b: APIStage): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  onEntityChange = () => {\r\n    if (!this.api) return;\r\n\r\n    this.doUpdateView(this.api.apiStage);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ApiStagePM.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.api?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ApiStagePM.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/ApiStagePM.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAiCH,wCAEC;AAjCD,sCAKqB;AACrB,0CAAuD;AAEvD;;;GAGG;AACH,MAAsB,UAAW,SAAQ,kBAAqB;IAI5D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAXH,gCAYC;AAXC,gDAAgD;AACzC,eAAI,GAAG,YAAY,CAAC;AAY7B;;;;GAIG;AACH,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC;;;OAGG;IACH,IAAY,GAAG;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAiB,yBAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAYD;;;OAGG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAfpC;;;WAGG;QACH,mBAAc,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEtB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;QAQA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["/**\r\n * ApiStagePM.ts\r\n * \r\n * This file defines the Presentation Manager for API stage configuration.\r\n * ApiStagePM bridges the VivedAPIEntity domain logic with UI components,\r\n * managing the display and interaction of API environment settings.\r\n * \r\n * Key concepts:\r\n * - PM extends AppObjectPM and manages view model state for API stage\r\n * - Observes VivedAPIEntity changes and updates UI accordingly\r\n * - Provides value comparison logic for efficient view updates\r\n * - Implements singleton pattern for system-wide stage management\r\n * - Handles API stage transitions and notifications\r\n * \r\n * Usage pattern:\r\n * 1. Get the singleton PM using ApiStagePM.get(appObjects)\r\n * 2. Connect to UI components that display/edit API stage\r\n * 3. PM automatically updates views when entity state changes\r\n * 4. Use with adapters to bind to specific UI frameworks\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { APIStage, VivedAPIEntity } from \"../Entities\";\r\n\r\n/**\r\n * ApiStagePM provides presentation logic for API stage configuration.\r\n * Abstract class that manages the view model for API environment settings.\r\n */\r\nexport abstract class ApiStagePM extends AppObjectPM<APIStage> {\r\n  /** Unique type identifier for this component */\r\n  static type = \"ApiStagePM\";\r\n\r\n  /**\r\n   * Retrieves the singleton ApiStagePM from the app objects repository\r\n   * @param appObjects The AppObjectRepo to get the singleton from\r\n   * @returns The ApiStagePM singleton or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<ApiStagePM>(ApiStagePM.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ApiStagePM instance\r\n * @param appObject The AppObject to attach the PM to\r\n * @returns A new ApiStagePM instance\r\n */\r\nexport function makeApiStagePM(appObject: AppObject): ApiStagePM {\r\n  return new ApiStagePMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ApiStagePM\r\n * This private class handles the actual presentation logic for API stage management\r\n */\r\nclass ApiStagePMImp extends ApiStagePM {\r\n  /**\r\n   * Gets the VivedAPIEntity from the same app objects repository\r\n   * Uses cached singleton access for efficient repeated access\r\n   */\r\n  private get api() {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two APIStage values for equality to determine if view updates are needed\r\n   * @param a First APIStage value to compare\r\n   * @param b Second APIStage value to compare\r\n   * @returns True if the values are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: APIStage, b: APIStage): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  /**\r\n   * Handles entity change notifications and updates the view\r\n   * Called when the VivedAPIEntity's API stage changes\r\n   */\r\n  onEntityChange = () => {\r\n    if (!this.api) return;\r\n\r\n    this.doUpdateView(this.api.apiStage);\r\n  };\r\n\r\n  /**\r\n   * Constructs a new ApiStagePMImp and sets up entity observation\r\n   * @param appObject The AppObject this PM belongs to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ApiStagePM.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.api?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}

package/dist/cjs/VivedAPI/PMs/UserTokenPM.js

@@ -1,28 +1,81 @@
 "use strict";
+/**
+ * UserTokenPM.ts
+ *
+ * This file defines the Presentation Manager for user authentication token display.
+ * UserTokenPM bridges the VivedAPIEntity token state with UI components,
+ * managing the display and interaction of user authentication tokens.
+ *
+ * Key concepts:
+ * - PM extends AppObjectPM and manages view model state for user tokens
+ * - Observes VivedAPIEntity token changes and updates UI accordingly
+ * - Provides value comparison logic for efficient view updates
+ * - Implements singleton pattern for system-wide token display management
+ * - Handles token state transitions and notifications
+ *
+ * Usage pattern:
+ * 1. Get the singleton PM using UserTokenPM.get(appObjects)
+ * 2. Connect to UI components that display user authentication tokens
+ * 3. PM automatically updates views when entity token state changes
+ * 4. Use with adapters to bind to specific UI frameworks
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserTokenPM = void 0;
 exports.makeUserTokenPM = makeUserTokenPM;
 const core_1 = require("@vived/core");
 const Entities_1 = require("../Entities");
+/**
+ * UserTokenPM provides presentation logic for user authentication token display.
+ * Abstract class that manages the view model for user token information.
+ */
 class UserTokenPM extends core_1.AppObjectPM {
+    /**
+     * Retrieves the singleton UserTokenPM from the app objects repository
+     * @param appObjects The AppObjectRepo to get the singleton from
+     * @returns The UserTokenPM singleton or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(UserTokenPM.type, appObjects);
     }
 }
 exports.UserTokenPM = UserTokenPM;
+/** Unique type identifier for this component */
 UserTokenPM.type = "UserTokenPM";
+/**
+ * Factory function to create a new UserTokenPM instance
+ * @param appObject The AppObject to attach the PM to
+ * @returns A new UserTokenPM instance
+ */
 function makeUserTokenPM(appObject) {
     return new UserTokenPMImp(appObject);
 }
+/**
+ * Concrete implementation of UserTokenPM
+ * This private class handles the actual presentation logic for user token management
+ */
 class UserTokenPMImp extends UserTokenPM {
+    /**
+     * Gets the VivedAPIEntity from the same app objects repository
+     * Uses cached singleton access for efficient repeated access
+     */
     get sandbox() {
         return this.getCachedSingleton(Entities_1.VivedAPIEntity.type);
     }
+    /**
+     * Compares two token string values for equality to determine if view updates are needed
+     * @param a First token string to compare
+     * @param b Second token string to compare
+     * @returns True if the token values are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         return a === b;
     }
     constructor(appObject) {
         super(appObject, UserTokenPM.type);
+        /**
+         * Handles entity change notifications and updates the view
+         * Called when the VivedAPIEntity's user token changes
+         */
         this.onEntityChange = () => {
             if (!this.sandbox)
                 return;

package/dist/cjs/VivedAPI/PMs/UserTokenPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserTokenPM.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/UserTokenPM.ts"],"names":[],"mappings":";;;AAgBA,0CAEC;AAlBD,sCAKqB;AACrB,0CAA6C;AAE7C,MAAsB,WAAY,SAAQ,kBAAmB;IAG3D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AALH,kCAMC;AALQ,gBAAI,GAAG,aAAa,CAAC;AAO9B,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,cAAe,SAAQ,WAAW;IACtC,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,yBAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,WAAW,CAAC,CAAS,EAAE,CAAS;QAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAQD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAPrC,mBAAc,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAE1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { VivedAPIEntity } from \"../Entities\";\r\n\r\nexport abstract class UserTokenPM extends AppObjectPM<string> {\r\n  static type = \"UserTokenPM\";\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<UserTokenPM>(UserTokenPM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeUserTokenPM(appObject: AppObject): UserTokenPM {\r\n  return new UserTokenPMImp(appObject);\r\n}\r\n\r\nclass UserTokenPMImp extends UserTokenPM {\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  vmsAreEqual(a: string, b: string): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  onEntityChange = () => {\r\n    if (!this.sandbox) return;\r\n\r\n    this.doUpdateView(this.sandbox.userToken);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UserTokenPM.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.sandbox?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"UserTokenPM.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/UserTokenPM.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAiCH,0CAEC;AAjCD,sCAKqB;AACrB,0CAA6C;AAE7C;;;GAGG;AACH,MAAsB,WAAY,SAAQ,kBAAmB;IAI3D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AAXH,kCAYC;AAXC,gDAAgD;AACzC,gBAAI,GAAG,aAAa,CAAC;AAY9B;;;;GAIG;AACH,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,cAAe,SAAQ,WAAW;IACtC;;;OAGG;IACH,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,yBAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,CAAS,EAAE,CAAS;QAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAYD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAXrC;;;WAGG;QACH,mBAAc,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAE1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["/**\r\n * UserTokenPM.ts\r\n * \r\n * This file defines the Presentation Manager for user authentication token display.\r\n * UserTokenPM bridges the VivedAPIEntity token state with UI components,\r\n * managing the display and interaction of user authentication tokens.\r\n * \r\n * Key concepts:\r\n * - PM extends AppObjectPM and manages view model state for user tokens\r\n * - Observes VivedAPIEntity token changes and updates UI accordingly\r\n * - Provides value comparison logic for efficient view updates\r\n * - Implements singleton pattern for system-wide token display management\r\n * - Handles token state transitions and notifications\r\n * \r\n * Usage pattern:\r\n * 1. Get the singleton PM using UserTokenPM.get(appObjects)\r\n * 2. Connect to UI components that display user authentication tokens\r\n * 3. PM automatically updates views when entity token state changes\r\n * 4. Use with adapters to bind to specific UI frameworks\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { VivedAPIEntity } from \"../Entities\";\r\n\r\n/**\r\n * UserTokenPM provides presentation logic for user authentication token display.\r\n * Abstract class that manages the view model for user token information.\r\n */\r\nexport abstract class UserTokenPM extends AppObjectPM<string> {\r\n  /** Unique type identifier for this component */\r\n  static type = \"UserTokenPM\";\r\n\r\n  /**\r\n   * Retrieves the singleton UserTokenPM from the app objects repository\r\n   * @param appObjects The AppObjectRepo to get the singleton from\r\n   * @returns The UserTokenPM singleton or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<UserTokenPM>(UserTokenPM.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new UserTokenPM instance\r\n * @param appObject The AppObject to attach the PM to\r\n * @returns A new UserTokenPM instance\r\n */\r\nexport function makeUserTokenPM(appObject: AppObject): UserTokenPM {\r\n  return new UserTokenPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of UserTokenPM\r\n * This private class handles the actual presentation logic for user token management\r\n */\r\nclass UserTokenPMImp extends UserTokenPM {\r\n  /**\r\n   * Gets the VivedAPIEntity from the same app objects repository\r\n   * Uses cached singleton access for efficient repeated access\r\n   */\r\n  private get sandbox() {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Compares two token string values for equality to determine if view updates are needed\r\n   * @param a First token string to compare\r\n   * @param b Second token string to compare\r\n   * @returns True if the token values are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: string, b: string): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  /**\r\n   * Handles entity change notifications and updates the view\r\n   * Called when the VivedAPIEntity's user token changes\r\n   */\r\n  onEntityChange = () => {\r\n    if (!this.sandbox) return;\r\n\r\n    this.doUpdateView(this.sandbox.userToken);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UserTokenPM.type);\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.sandbox?.addChangeObserver(this.onEntityChange);\r\n    this.onEntityChange();\r\n  }\r\n}\r\n"]}

package/dist/cjs/VivedAPI/PMs/index.js

@@ -1,4 +1,22 @@
 "use strict";
+/**
+ * VivedAPI Presentation Managers Index
+ *
+ * This module exports all presentation manager classes for the VivedAPI feature.
+ * Presentation managers bridge the gap between domain entities and user interface
+ * components, providing view model management and change notification systems.
+ *
+ * Key Concepts:
+ * - PMs extend AppObjectPM and manage view state for specific domain concepts
+ * - They observe entity changes and update connected UI components
+ * - PMs provide value comparison logic for efficient view update optimization
+ * - They handle the conversion between domain models and view models
+ * - PMs implement observer patterns for reactive UI updates
+ *
+ * Available Presentation Managers:
+ * - ApiStagePM: Manages view state for API environment configuration
+ * - UserTokenPM: Manages view state for user authentication token display
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/cjs/VivedAPI/PMs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,gDAA6B","sourcesContent":["export * from \"./ApiStagePM\"\r\nexport * from \"./UserTokenPM\""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,gDAA8B","sourcesContent":["/**\r\n * VivedAPI Presentation Managers Index\r\n * \r\n * This module exports all presentation manager classes for the VivedAPI feature.\r\n * Presentation managers bridge the gap between domain entities and user interface\r\n * components, providing view model management and change notification systems.\r\n * \r\n * Key Concepts:\r\n * - PMs extend AppObjectPM and manage view state for specific domain concepts\r\n * - They observe entity changes and update connected UI components\r\n * - PMs provide value comparison logic for efficient view update optimization\r\n * - They handle the conversion between domain models and view models\r\n * - PMs implement observer patterns for reactive UI updates\r\n * \r\n * Available Presentation Managers:\r\n * - ApiStagePM: Manages view state for API environment configuration\r\n * - UserTokenPM: Manages view state for user authentication token display\r\n */\r\n\r\nexport * from \"./ApiStagePM\";\r\nexport * from \"./UserTokenPM\";\r\n"]}

package/dist/cjs/VivedAPI/UCs/BasicFetchUC.js

@@ -1,12 +1,42 @@
 "use strict";
+/**
+ * BasicFetchUC.ts
+ *
+ * This file defines the core Use Case for making basic HTTP fetch requests.
+ * BasicFetchUC provides a standardized interface for HTTP operations that return
+ * raw Response objects rather than parsed JSON data.
+ *
+ * Key concepts:
+ * - Abstract UC defining the interface for basic HTTP fetch operations
+ * - Supports all standard HTTP methods (GET, POST, PUT, PATCH, DELETE)
+ * - Returns raw Response objects for flexible response handling
+ * - Handles request headers, parameters, and body data
+ * - Implements singleton pattern for system-wide request handling
+ *
+ * Usage pattern:
+ * 1. Get the singleton UC using BasicFetchUC.get(appObjects)
+ * 2. Call doRequest with URL and request options
+ * 3. Handle the returned Promise with raw Response object
+ * 4. Process response data according to content type and needs
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BasicFetchUC = void 0;
 const core_1 = require("@vived/core");
+/**
+ * BasicFetchUC provides functionality for making basic HTTP fetch requests.
+ * Abstract class that defines the interface for HTTP operations returning raw Response objects.
+ */
 class BasicFetchUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton BasicFetchUC from the app objects repository
+     * @param appObjects The AppObjectRepo to get the singleton from
+     * @returns The BasicFetchUC singleton or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(BasicFetchUC.type, appObjects);
     }
 }
 exports.BasicFetchUC = BasicFetchUC;
+/** Unique type identifier for this component */
 BasicFetchUC.type = "BasicFetchUC";
 //# sourceMappingURL=BasicFetchUC.js.map

package/dist/cjs/VivedAPI/UCs/BasicFetchUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"BasicFetchUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/BasicFetchUC.ts"],"names":[],"mappings":";;;AAAA,sCAKqB;AASrB,MAAsB,YAAa,SAAQ,kBAAW;IAKpD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;;AAPH,oCAQC;AAPQ,iBAAI,GAAG,cAAc,CAAC","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\n\r\nexport interface BasicFetchOptions {\r\n  headers?: any;\r\n  method: \"GET\" | \"PATCH\" | \"POST\" | \"PUT\" | \"DELETE\" | undefined;\r\n  params?: any;\r\n  body?: any;\r\n}\r\n\r\nexport abstract class BasicFetchUC extends AppObjectUC {\r\n  static type = \"BasicFetchUC\";\r\n\r\n  abstract doRequest(url: URL, options?: BasicFetchOptions): Promise<Response>;\r\n\r\n  static get(appObjects: AppObjectRepo): BasicFetchUC | undefined {\r\n    return getSingletonComponent(BasicFetchUC.type, appObjects);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BasicFetchUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/BasicFetchUC.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,sCAKqB;AAgBrB;;;GAGG;AACH,MAAsB,YAAa,SAAQ,kBAAW;IAYpD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;;AAnBH,oCAoBC;AAnBC,gDAAgD;AACzC,iBAAI,GAAG,cAAc,CAAC","sourcesContent":["/**\r\n * BasicFetchUC.ts\r\n * \r\n * This file defines the core Use Case for making basic HTTP fetch requests.\r\n * BasicFetchUC provides a standardized interface for HTTP operations that return\r\n * raw Response objects rather than parsed JSON data.\r\n * \r\n * Key concepts:\r\n * - Abstract UC defining the interface for basic HTTP fetch operations\r\n * - Supports all standard HTTP methods (GET, POST, PUT, PATCH, DELETE)\r\n * - Returns raw Response objects for flexible response handling\r\n * - Handles request headers, parameters, and body data\r\n * - Implements singleton pattern for system-wide request handling\r\n * \r\n * Usage pattern:\r\n * 1. Get the singleton UC using BasicFetchUC.get(appObjects)\r\n * 2. Call doRequest with URL and request options\r\n * 3. Handle the returned Promise with raw Response object\r\n * 4. Process response data according to content type and needs\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\n\r\n/**\r\n * Configuration options for basic HTTP fetch requests\r\n */\r\nexport interface BasicFetchOptions {\r\n  /** HTTP headers to include in the request */\r\n  headers?: any;\r\n  /** HTTP method for the request */\r\n  method: \"GET\" | \"PATCH\" | \"POST\" | \"PUT\" | \"DELETE\" | undefined;\r\n  /** URL parameters to include in the request */\r\n  params?: any;\r\n  /** Request body data for POST/PUT/PATCH requests */\r\n  body?: any;\r\n}\r\n\r\n/**\r\n * BasicFetchUC provides functionality for making basic HTTP fetch requests.\r\n * Abstract class that defines the interface for HTTP operations returning raw Response objects.\r\n */\r\nexport abstract class BasicFetchUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static type = \"BasicFetchUC\";\r\n\r\n  /**\r\n   * Performs a basic HTTP fetch request to the specified URL\r\n   * @param url The target URL for the request\r\n   * @param options Optional configuration for the request\r\n   * @returns Promise resolving to the raw Response object\r\n   */\r\n  abstract doRequest(url: URL, options?: BasicFetchOptions): Promise<Response>;\r\n\r\n  /**\r\n   * Retrieves the singleton BasicFetchUC from the app objects repository\r\n   * @param appObjects The AppObjectRepo to get the singleton from\r\n   * @returns The BasicFetchUC singleton or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): BasicFetchUC | undefined {\r\n    return getSingletonComponent(BasicFetchUC.type, appObjects);\r\n  }\r\n}\r\n"]}

package/dist/cjs/VivedAPI/UCs/BlobRequestUC.js

@@ -1,12 +1,42 @@
 "use strict";
+/**
+ * BlobRequestUC.ts
+ *
+ * This file defines the Use Case for making HTTP requests that return binary data as Blobs.
+ * BlobRequestUC provides functionality for downloading files, images, and other binary
+ * content from API endpoints, returning the data as Blob objects for further processing.
+ *
+ * Key concepts:
+ * - Abstract UC defining the interface for binary data HTTP requests
+ * - Supports all standard HTTP methods for blob retrieval
+ * - Returns Blob objects suitable for file downloads or binary processing
+ * - Handles request headers, parameters, and body data
+ * - Implements singleton pattern for system-wide blob request handling
+ *
+ * Usage pattern:
+ * 1. Get the singleton UC using BlobRequestUC.get(appObjects)
+ * 2. Call doRequest with URL and request options
+ * 3. Handle the returned Promise with Blob object
+ * 4. Process blob data for downloads, display, or further operations
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlobRequestUC = void 0;
 const core_1 = require("@vived/core");
+/**
+ * BlobRequestUC provides functionality for making HTTP requests that return binary data.
+ * Abstract class that defines the interface for blob/binary data retrieval operations.
+ */
 class BlobRequestUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves the singleton BlobRequestUC from the app objects repository
+     * @param appObjects The AppObjectRepo to get the singleton from
+     * @returns The BlobRequestUC singleton or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(BlobRequestUC.type, appObjects);
     }
 }
 exports.BlobRequestUC = BlobRequestUC;
+/** Unique type identifier for this component */
 BlobRequestUC.type = "BlobRequestUC";
 //# sourceMappingURL=BlobRequestUC.js.map

package/dist/cjs/VivedAPI/UCs/BlobRequestUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"BlobRequestUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/BlobRequestUC.ts"],"names":[],"mappings":";;;AAAA,sCAKqB;AASrB,MAAsB,aAAc,SAAQ,kBAAW;IAKrD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;;AAPH,sCAQC;AAPQ,kBAAI,GAAG,eAAe,CAAC","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\n\r\nexport interface RequestBlobOptions {\r\n  headers?: any;\r\n  method: \"GET\" | \"PATCH\" | \"POST\" | \"PUT\" | \"DELETE\" | undefined;\r\n  params?: any;\r\n  body?: any;\r\n}\r\n\r\nexport abstract class BlobRequestUC extends AppObjectUC {\r\n  static type = \"BlobRequestUC\";\r\n\r\n  abstract doRequest(url: URL, options?: RequestBlobOptions): Promise<Blob>;\r\n\r\n  static get(appObjects: AppObjectRepo): BlobRequestUC | undefined {\r\n    return getSingletonComponent(BlobRequestUC.type, appObjects);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BlobRequestUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/BlobRequestUC.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,sCAKqB;AAgBrB;;;GAGG;AACH,MAAsB,aAAc,SAAQ,kBAAW;IAYrD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;;AAnBH,sCAoBC;AAnBC,gDAAgD;AACzC,kBAAI,GAAG,eAAe,CAAC","sourcesContent":["/**\r\n * BlobRequestUC.ts\r\n * \r\n * This file defines the Use Case for making HTTP requests that return binary data as Blobs.\r\n * BlobRequestUC provides functionality for downloading files, images, and other binary\r\n * content from API endpoints, returning the data as Blob objects for further processing.\r\n * \r\n * Key concepts:\r\n * - Abstract UC defining the interface for binary data HTTP requests\r\n * - Supports all standard HTTP methods for blob retrieval\r\n * - Returns Blob objects suitable for file downloads or binary processing\r\n * - Handles request headers, parameters, and body data\r\n * - Implements singleton pattern for system-wide blob request handling\r\n * \r\n * Usage pattern:\r\n * 1. Get the singleton UC using BlobRequestUC.get(appObjects)\r\n * 2. Call doRequest with URL and request options\r\n * 3. Handle the returned Promise with Blob object\r\n * 4. Process blob data for downloads, display, or further operations\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\n\r\n/**\r\n * Configuration options for binary blob HTTP requests\r\n */\r\nexport interface RequestBlobOptions {\r\n  /** HTTP headers to include in the request */\r\n  headers?: any;\r\n  /** HTTP method for the request */\r\n  method: \"GET\" | \"PATCH\" | \"POST\" | \"PUT\" | \"DELETE\" | undefined;\r\n  /** URL parameters to include in the request */\r\n  params?: any;\r\n  /** Request body data for POST/PUT/PATCH requests */\r\n  body?: any;\r\n}\r\n\r\n/**\r\n * BlobRequestUC provides functionality for making HTTP requests that return binary data.\r\n * Abstract class that defines the interface for blob/binary data retrieval operations.\r\n */\r\nexport abstract class BlobRequestUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static type = \"BlobRequestUC\";\r\n\r\n  /**\r\n   * Performs an HTTP request that returns binary data as a Blob\r\n   * @param url The target URL for the request\r\n   * @param options Optional configuration for the request\r\n   * @returns Promise resolving to the response data as a Blob\r\n   */\r\n  abstract doRequest(url: URL, options?: RequestBlobOptions): Promise<Blob>;\r\n\r\n  /**\r\n   * Retrieves the singleton BlobRequestUC from the app objects repository\r\n   * @param appObjects The AppObjectRepo to get the singleton from\r\n   * @returns The BlobRequestUC singleton or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): BlobRequestUC | undefined {\r\n    return getSingletonComponent(BlobRequestUC.type, appObjects);\r\n  }\r\n}\r\n"]}

package/dist/cjs/VivedAPI/UCs/DeleteAssetOnAPIUC.js

@@ -1,4 +1,24 @@
 "use strict";
+/**
+ * DeleteAssetOnAPIUC.ts
+ *
+ * This file defines the Use Case for deleting assets via the VIVED API.
+ * DeleteAssetOnAPIUC handles the workflow of removing asset records from
+ * the backend storage system through authenticated API requests.
+ *
+ * Key concepts:
+ * - Orchestrates asset deletion through API endpoints
+ * - Manages authentication tokens for authorized deletion requests
+ * - Coordinates between JsonRequestUC and SignedAuthTokenUC
+ * - Handles error cases and provides feedback for deletion operations
+ * - Ensures proper cleanup of asset data and metadata
+ *
+ * Usage pattern:
+ * 1. Get a UC instance using DeleteAssetOnAPIUC.get(appObjects) or makeDeleteAssetOnAPIUC
+ * 2. Call doDelete with the asset ID to remove
+ * 3. Handle the returned Promise for deletion completion
+ * 4. UC manages authentication and API communication details
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeleteAssetOnAPIUC = void 0;
 exports.makeDeleteAssetOnAPIUC = makeDeleteAssetOnAPIUC;
@@ -6,16 +26,35 @@ const core_1 = require("@vived/core");
 const VivedAPIEntity_1 = require("../Entities/VivedAPIEntity");
 const JsonRequestUC_1 = require("./JsonRequestUC");
 const SignedAuthTokenUC_1 = require("./SignedAuthTokenUC");
+/**
+ * DeleteAssetOnAPIUC provides functionality for deleting assets via API.
+ * Abstract class that defines the interface for asset deletion operations.
+ */
 class DeleteAssetOnAPIUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves a DeleteAssetOnAPIUC component from an AppObject
+     * @param appObjects The AppObjectRepo to get the component from
+     * @returns The DeleteAssetOnAPIUC component or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(DeleteAssetOnAPIUC.type, appObjects);
     }
 }
 exports.DeleteAssetOnAPIUC = DeleteAssetOnAPIUC;
+/** Unique type identifier for this component */
 DeleteAssetOnAPIUC.type = "DeleteAssetOnAPIUC";
+/**
+ * Factory function to create a new DeleteAssetOnAPIUC instance
+ * @param appObject The AppObject to attach the UC to
+ * @returns A new DeleteAssetOnAPIUC instance
+ */
 function makeDeleteAssetOnAPIUC(appObject) {
     return new DeleteAssetUCImp(appObject);
 }
+/**
+ * Concrete implementation of DeleteAssetOnAPIUC
+ * This private class handles the actual asset deletion workflow
+ */
 class DeleteAssetUCImp extends DeleteAssetOnAPIUC {
     get jsonRequester() {
         return this.getCachedSingleton(JsonRequestUC_1.JsonRequestUC.type)

package/dist/cjs/VivedAPI/UCs/DeleteAssetOnAPIUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeleteAssetOnAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/DeleteAssetOnAPIUC.ts"],"names":[],"mappings":";;;AAoBA,wDAIC;AAxBD,sCAKqB;AACrB,+DAA4D;AAC5D,mDAAoE;AACpE,2DAAwD;AAExD,MAAsB,kBAAmB,SAAQ,kBAAW;IAK1D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC;;AAPH,gDAQC;AAPQ,uBAAI,GAAG,oBAAoB,CAAC;AASrC,SAAgB,sBAAsB,CACpC,SAAoB;IAEpB,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,gBAAiB,SAAQ,kBAAkB;IAC/C,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAoB,qCAAiB,CAAC,IAAI,CAAC;YACvE,EAAE,YAAY,CAAC;IACnB,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAmCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAlC5C,aAAQ,GAAG,CAAC,OAAe,EAAiB,EAAE;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YAEzC,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,YAAY,EAAE;qBACX,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;oBACd,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;oBAE7D,MAAM,OAAO,GAAuB;wBAClC,MAAM,EAAE,QAAQ;wBAChB,OAAO,EAAE;4BACP,aAAa,EAAE,SAAS,GAAG,KAAK;yBACjC;qBACF,CAAC;oBAEF,OAAO,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzC,CAAC,CAAC;qBACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACX,MAAM,CAAC,CAAC,CAAC,CAAC;oBACV,OAAO;gBACT,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { VivedAPIEntity } from \"../Entities/VivedAPIEntity\";\r\nimport { JsonRequestUC, RequestJSONOptions } from \"./JsonRequestUC\";\r\nimport { SignedAuthTokenUC } from \"./SignedAuthTokenUC\";\r\n\r\nexport abstract class DeleteAssetOnAPIUC extends AppObjectUC {\r\n  static type = \"DeleteAssetOnAPIUC\";\r\n\r\n  abstract doDelete(assetID: string): Promise<void>;\r\n\r\n  static get(appObjects: AppObjectRepo): DeleteAssetOnAPIUC | undefined {\r\n    return getSingletonComponent(DeleteAssetOnAPIUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeDeleteAssetOnAPIUC(\r\n  appObject: AppObject\r\n): DeleteAssetOnAPIUC {\r\n  return new DeleteAssetUCImp(appObject);\r\n}\r\n\r\nclass DeleteAssetUCImp extends DeleteAssetOnAPIUC {\r\n  private get jsonRequester() {\r\n    return this.getCachedSingleton<JsonRequestUC>(JsonRequestUC.type)\r\n      ?.doRequest;\r\n  }\r\n\r\n  private get getAuthToken() {\r\n    return this.getCachedSingleton<SignedAuthTokenUC>(SignedAuthTokenUC.type)\r\n      ?.getAuthToken;\r\n  }\r\n\r\n  private get vivedAPI() {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  doDelete = (assetID: string): Promise<void> => {\r\n    const getAuthToken = this.getAuthToken;\r\n    const vivedAPI = this.vivedAPI;\r\n    const jsonRequester = this.jsonRequester;\r\n\r\n    if (!getAuthToken || !vivedAPI || !jsonRequester) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      getAuthToken()\r\n        .then((token) => {\r\n          const postURL = vivedAPI.getEndpointURL(`assets/${assetID}`);\r\n\r\n          const options: RequestJSONOptions = {\r\n            method: \"DELETE\",\r\n            headers: {\r\n              Authorization: \"Bearer \" + token\r\n            }\r\n          };\r\n\r\n          return jsonRequester(postURL, options);\r\n        })\r\n        .then((_) => {\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          reject(e);\r\n          return;\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, DeleteAssetOnAPIUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"DeleteAssetOnAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/DeleteAssetOnAPIUC.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AA0CH,wDAIC;AA5CD,sCAKqB;AACrB,+DAA4D;AAC5D,mDAAoE;AACpE,2DAAwD;AAExD;;;GAGG;AACH,MAAsB,kBAAmB,SAAQ,kBAAW;IAW1D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC;;AAlBH,gDAmBC;AAlBC,gDAAgD;AACzC,uBAAI,GAAG,oBAAoB,CAAC;AAmBrC;;;;GAIG;AACH,SAAgB,sBAAsB,CACpC,SAAoB;IAEpB,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,gBAAiB,SAAQ,kBAAkB;IAC/C,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAoB,qCAAiB,CAAC,IAAI,CAAC;YACvE,EAAE,YAAY,CAAC;IACnB,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAmCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAlC5C,aAAQ,GAAG,CAAC,OAAe,EAAiB,EAAE;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YAEzC,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,YAAY,EAAE;qBACX,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;oBACd,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;oBAE7D,MAAM,OAAO,GAAuB;wBAClC,MAAM,EAAE,QAAQ;wBAChB,OAAO,EAAE;4BACP,aAAa,EAAE,SAAS,GAAG,KAAK;yBACjC;qBACF,CAAC;oBAEF,OAAO,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzC,CAAC,CAAC;qBACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACX,MAAM,CAAC,CAAC,CAAC,CAAC;oBACV,OAAO;gBACT,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\r\n * DeleteAssetOnAPIUC.ts\r\n * \r\n * This file defines the Use Case for deleting assets via the VIVED API.\r\n * DeleteAssetOnAPIUC handles the workflow of removing asset records from\r\n * the backend storage system through authenticated API requests.\r\n * \r\n * Key concepts:\r\n * - Orchestrates asset deletion through API endpoints\r\n * - Manages authentication tokens for authorized deletion requests\r\n * - Coordinates between JsonRequestUC and SignedAuthTokenUC\r\n * - Handles error cases and provides feedback for deletion operations\r\n * - Ensures proper cleanup of asset data and metadata\r\n * \r\n * Usage pattern:\r\n * 1. Get a UC instance using DeleteAssetOnAPIUC.get(appObjects) or makeDeleteAssetOnAPIUC\r\n * 2. Call doDelete with the asset ID to remove\r\n * 3. Handle the returned Promise for deletion completion\r\n * 4. UC manages authentication and API communication details\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { VivedAPIEntity } from \"../Entities/VivedAPIEntity\";\r\nimport { JsonRequestUC, RequestJSONOptions } from \"./JsonRequestUC\";\r\nimport { SignedAuthTokenUC } from \"./SignedAuthTokenUC\";\r\n\r\n/**\r\n * DeleteAssetOnAPIUC provides functionality for deleting assets via API.\r\n * Abstract class that defines the interface for asset deletion operations.\r\n */\r\nexport abstract class DeleteAssetOnAPIUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static type = \"DeleteAssetOnAPIUC\";\r\n\r\n  /**\r\n   * Deletes an asset from the API by its ID\r\n   * @param assetID The unique identifier of the asset to delete\r\n   * @returns Promise that resolves when deletion is complete\r\n   */\r\n  abstract doDelete(assetID: string): Promise<void>;\r\n\r\n  /**\r\n   * Retrieves a DeleteAssetOnAPIUC component from an AppObject\r\n   * @param appObjects The AppObjectRepo to get the component from\r\n   * @returns The DeleteAssetOnAPIUC component or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): DeleteAssetOnAPIUC | undefined {\r\n    return getSingletonComponent(DeleteAssetOnAPIUC.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new DeleteAssetOnAPIUC instance\r\n * @param appObject The AppObject to attach the UC to\r\n * @returns A new DeleteAssetOnAPIUC instance\r\n */\r\nexport function makeDeleteAssetOnAPIUC(\r\n  appObject: AppObject\r\n): DeleteAssetOnAPIUC {\r\n  return new DeleteAssetUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of DeleteAssetOnAPIUC\r\n * This private class handles the actual asset deletion workflow\r\n */\r\nclass DeleteAssetUCImp extends DeleteAssetOnAPIUC {\r\n  private get jsonRequester() {\r\n    return this.getCachedSingleton<JsonRequestUC>(JsonRequestUC.type)\r\n      ?.doRequest;\r\n  }\r\n\r\n  private get getAuthToken() {\r\n    return this.getCachedSingleton<SignedAuthTokenUC>(SignedAuthTokenUC.type)\r\n      ?.getAuthToken;\r\n  }\r\n\r\n  private get vivedAPI() {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  doDelete = (assetID: string): Promise<void> => {\r\n    const getAuthToken = this.getAuthToken;\r\n    const vivedAPI = this.vivedAPI;\r\n    const jsonRequester = this.jsonRequester;\r\n\r\n    if (!getAuthToken || !vivedAPI || !jsonRequester) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      getAuthToken()\r\n        .then((token) => {\r\n          const postURL = vivedAPI.getEndpointURL(`assets/${assetID}`);\r\n\r\n          const options: RequestJSONOptions = {\r\n            method: \"DELETE\",\r\n            headers: {\r\n              Authorization: \"Bearer \" + token\r\n            }\r\n          };\r\n\r\n          return jsonRequester(postURL, options);\r\n        })\r\n        .then((_) => {\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          reject(e);\r\n          return;\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, DeleteAssetOnAPIUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/cjs/VivedAPI/UCs/FetchAssetFileFromAPIUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"FetchAssetFileFromAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FetchAssetFileFromAPIUC.ts"],"names":[],"mappings":";;;AAmBA,kEAIC;AAvBD,sCAKqB;AAErB,mDAAgD;AAEhD,MAAsB,uBAAwB,SAAQ,kBAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;;AAPH,0DAQC;AAPQ,4BAAI,GAAG,yBAAyB,CAAC;AAS1C,SAAgB,2BAA2B,CACzC,SAAoB;IAEpB,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,uBAAuB;IACvD,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAkCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAjCjD,YAAO,GAAG,CAAC,KAAkB,EAAiB,EAAE;YAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAChC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAEnC,WAAW,CAAC,GAAG,CAAC;qBACb,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACb,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;wBACrB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;wBACxC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { AssetEntity } from \"../../Assets\";\r\nimport { BlobRequestUC } from \"./BlobRequestUC\";\r\n\r\nexport abstract class FetchAssetFileFromAPIUC extends AppObjectUC {\r\n  static type = \"FetchAssetFileFromAPIUC\";\r\n\r\n  abstract doFetch(asset: AssetEntity): Promise<File>;\r\n\r\n  static get(appObjects: AppObjectRepo): FetchAssetFileFromAPIUC | undefined {\r\n    return getSingletonComponent(FetchAssetFileFromAPIUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeFetchAssetFileFromAPIUC(\r\n  appObject: AppObject\r\n): FetchAssetFileFromAPIUC {\r\n  return new FetchAssetFileUCImp(appObject);\r\n}\r\n\r\nclass FetchAssetFileUCImp extends FetchAssetFileFromAPIUC {\r\n  private get requestBlob() {\r\n    return this.getCachedSingleton<BlobRequestUC>(BlobRequestUC.type)\r\n      ?.doRequest;\r\n  }\r\n\r\n  doFetch = (asset: AssetEntity): Promise<File> => {\r\n    const requestBlob = this.requestBlob;\r\n    if (!requestBlob) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    if (!asset.fileURL) {\r\n      return Promise.reject(new Error(`${asset.id} does not have a file URL`));\r\n    }\r\n\r\n    if (!asset.filename) {\r\n      return Promise.reject(new Error(`${asset.id} does not have a filename`));\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      const filename = asset.filename;\r\n      const url = new URL(asset.fileURL);\r\n\r\n      requestBlob(url)\r\n        .then((blob) => {\r\n          if (blob && filename) {\r\n            const file = new File([blob], filename);\r\n            resolve(file);\r\n          }\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, FetchAssetFileFromAPIUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"FetchAssetFileFromAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FetchAssetFileFromAPIUC.ts"],"names":[],"mappings":";;;AAmBA,kEAIC;AAvBD,sCAKqB;AAErB,mDAAgD;AAEhD,MAAsB,uBAAwB,SAAQ,kBAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;;AAPH,0DAQC;AAPQ,4BAAI,GAAG,yBAAyB,CAAC;AAS1C,SAAgB,2BAA2B,CACzC,SAAoB;IAEpB,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,uBAAuB;IACvD,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAkCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAjCjD,YAAO,GAAG,CAAC,KAAkB,EAAiB,EAAE;YAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAChC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAEnC,WAAW,CAAC,GAAG,CAAC;qBACb,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACb,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;wBACrB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;wBACxC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectRepo,\n  AppObjectUC\n} from \"@vived/core\";\nimport { AssetEntity } from \"../../Assets\";\nimport { BlobRequestUC } from \"./BlobRequestUC\";\n\nexport abstract class FetchAssetFileFromAPIUC extends AppObjectUC {\n  static type = \"FetchAssetFileFromAPIUC\";\n\n  abstract doFetch(asset: AssetEntity): Promise<File>;\n\n  static get(appObjects: AppObjectRepo): FetchAssetFileFromAPIUC | undefined {\n    return getSingletonComponent(FetchAssetFileFromAPIUC.type, appObjects);\n  }\n}\n\nexport function makeFetchAssetFileFromAPIUC(\n  appObject: AppObject\n): FetchAssetFileFromAPIUC {\n  return new FetchAssetFileUCImp(appObject);\n}\n\nclass FetchAssetFileUCImp extends FetchAssetFileFromAPIUC {\n  private get requestBlob() {\n    return this.getCachedSingleton<BlobRequestUC>(BlobRequestUC.type)\n      ?.doRequest;\n  }\n\n  doFetch = (asset: AssetEntity): Promise<File> => {\n    const requestBlob = this.requestBlob;\n    if (!requestBlob) {\n      return Promise.reject();\n    }\n\n    if (!asset.fileURL) {\n      return Promise.reject(new Error(`${asset.id} does not have a file URL`));\n    }\n\n    if (!asset.filename) {\n      return Promise.reject(new Error(`${asset.id} does not have a filename`));\n    }\n\n    return new Promise((resolve, reject) => {\n      const filename = asset.filename;\n      const url = new URL(asset.fileURL);\n\n      requestBlob(url)\n        .then((blob) => {\n          if (blob && filename) {\n            const file = new File([blob], filename);\n            resolve(file);\n          }\n        })\n        .catch((e: Error) => {\n          this.warn(e.message);\n          reject(e);\n        });\n    });\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, FetchAssetFileFromAPIUC.type);\n    this.appObjects.registerSingleton(this);\n  }\n}\n"]}

package/dist/cjs/VivedAPI/UCs/FetchAssetMetaFromAPIUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"FetchAssetMetaFromAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FetchAssetMetaFromAPIUC.ts"],"names":[],"mappings":";;;AAoBA,kEAIC;AAxBD,sCAKqB;AAErB,+DAA4D;AAC5D,mDAAoE;AAEpE,MAAsB,uBAAwB,SAAQ,kBAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;;AAPH,0DAQC;AAPQ,4BAAI,GAAG,yBAAyB,CAAC;AAS1C,SAAgB,2BAA2B,CACzC,SAAoB;IAEpB,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,uBAAuB;IACvD,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IA8BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC;QA7BjD,YAAO,GAAG,CAAC,OAAe,EAAqB,EAAE;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAErC,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;gBACjE,MAAM,OAAO,GAAuB;oBAClC,MAAM,EAAE,KAAK;iBACd,CAAC;gBAEF,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC;qBAC9B,IAAI,CAAC,CAAC,IAAU,EAAE,EAAE;oBACnB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC3C,QAAQ,CAAC,EAAE,GAAG,OAAO,CAAC;oBAEtB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAiBD,SAAS,aAAa,CAAC,IAAmB;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE;QAC7D,OAAO;YACL,IAAI,EAAE,eAAe,CAAC,IAAI;YAC1B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC;SAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAa;QACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY;QACZ,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { AssetDTO } from \"../../Assets\";\r\nimport { VivedAPIEntity } from \"../Entities/VivedAPIEntity\";\r\nimport { JsonRequestUC, RequestJSONOptions } from \"./JsonRequestUC\";\r\n\r\nexport abstract class FetchAssetMetaFromAPIUC extends AppObjectUC {\r\n  static type = \"FetchAssetMetaFromAPIUC\";\r\n\r\n  abstract doFetch(assetID: string): Promise<AssetDTO>;\r\n\r\n  static get(appObjects: AppObjectRepo): FetchAssetMetaFromAPIUC | undefined {\r\n    return getSingletonComponent(FetchAssetMetaFromAPIUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeFetchAssetMetaFromAPIUC(\r\n  appObject: AppObject\r\n): FetchAssetMetaFromAPIUC {\r\n  return new FetchAssetMetaUCImp(appObject);\r\n}\r\n\r\nclass FetchAssetMetaUCImp extends FetchAssetMetaFromAPIUC {\r\n  private get requestJSON() {\r\n    return this.getCachedSingleton<JsonRequestUC>(JsonRequestUC.type)\r\n      ?.doRequest;\r\n  }\r\n\r\n  private get vivedAPI(): VivedAPIEntity | undefined {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  doFetch = (assetID: string): Promise<AssetDTO> => {\r\n    const vivedAPI = this.vivedAPI;\r\n    const requestJSON = this.requestJSON;\r\n\r\n    if (!vivedAPI || !requestJSON) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    return new Promise<AssetDTO>((resolve, reject) => {\r\n      const endpointUrl = vivedAPI.getEndpointURL(`assets/${assetID}`);\r\n      const options: RequestJSONOptions = {\r\n        method: \"GET\"\r\n      };\r\n\r\n      requestJSON(endpointUrl, options)\r\n        .then((resp: Resp) => {\r\n          const assetDTO = responseToDTO(resp.asset);\r\n          assetDTO.id = assetID;\r\n\r\n          resolve(assetDTO);\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, FetchAssetMetaFromAPIUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n\r\ninterface Resp {\r\n  asset: BaseAssetResp;\r\n}\r\n\r\ninterface BaseAssetResp {\r\n  id: string;\r\n  ownerId: string;\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n  fileURL: string;\r\n  filename: string;\r\n  linkedAssets: { type: string; asset: BaseAssetResp }[];\r\n}\r\n\r\nfunction responseToDTO(resp: BaseAssetResp): AssetDTO {\r\n  const linkedAssets = resp.linkedAssets.map((linkedAssetResp) => {\r\n    return {\r\n      type: linkedAssetResp.type,\r\n      asset: responseToDTO(linkedAssetResp.asset)\r\n    };\r\n  });\r\n\r\n  const dto: AssetDTO = {\r\n    archived: resp.archived,\r\n    description: resp.description,\r\n    fileURL: resp.fileURL,\r\n    filename: resp.filename,\r\n    id: resp.id,\r\n    name: resp.name,\r\n    linkedAssets,\r\n    ownerId: resp.ownerId\r\n  };\r\n\r\n  return dto;\r\n}\r\n"]}
+{"version":3,"file":"FetchAssetMetaFromAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FetchAssetMetaFromAPIUC.ts"],"names":[],"mappings":";;;AAoBA,kEAIC;AAxBD,sCAKqB;AAErB,+DAA4D;AAC5D,mDAAoE;AAEpE,MAAsB,uBAAwB,SAAQ,kBAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;;AAPH,0DAQC;AAPQ,4BAAI,GAAG,yBAAyB,CAAC;AAS1C,SAAgB,2BAA2B,CACzC,SAAoB;IAEpB,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,mBAAoB,SAAQ,uBAAuB;IACvD,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IA8BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC;QA7BjD,YAAO,GAAG,CAAC,OAAe,EAAqB,EAAE;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAErC,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;gBACjE,MAAM,OAAO,GAAuB;oBAClC,MAAM,EAAE,KAAK;iBACd,CAAC;gBAEF,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC;qBAC9B,IAAI,CAAC,CAAC,IAAU,EAAE,EAAE;oBACnB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC3C,QAAQ,CAAC,EAAE,GAAG,OAAO,CAAC;oBAEtB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAiBD,SAAS,aAAa,CAAC,IAAmB;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE;QAC7D,OAAO;YACL,IAAI,EAAE,eAAe,CAAC,IAAI;YAC1B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC;SAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAa;QACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY;QACZ,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectRepo,\n  AppObjectUC\n} from \"@vived/core\";\nimport { AssetDTO } from \"../../Assets\";\nimport { VivedAPIEntity } from \"../Entities/VivedAPIEntity\";\nimport { JsonRequestUC, RequestJSONOptions } from \"./JsonRequestUC\";\n\nexport abstract class FetchAssetMetaFromAPIUC extends AppObjectUC {\n  static type = \"FetchAssetMetaFromAPIUC\";\n\n  abstract doFetch(assetID: string): Promise<AssetDTO>;\n\n  static get(appObjects: AppObjectRepo): FetchAssetMetaFromAPIUC | undefined {\n    return getSingletonComponent(FetchAssetMetaFromAPIUC.type, appObjects);\n  }\n}\n\nexport function makeFetchAssetMetaFromAPIUC(\n  appObject: AppObject\n): FetchAssetMetaFromAPIUC {\n  return new FetchAssetMetaUCImp(appObject);\n}\n\nclass FetchAssetMetaUCImp extends FetchAssetMetaFromAPIUC {\n  private get requestJSON() {\n    return this.getCachedSingleton<JsonRequestUC>(JsonRequestUC.type)\n      ?.doRequest;\n  }\n\n  private get vivedAPI(): VivedAPIEntity | undefined {\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\n  }\n\n  doFetch = (assetID: string): Promise<AssetDTO> => {\n    const vivedAPI = this.vivedAPI;\n    const requestJSON = this.requestJSON;\n\n    if (!vivedAPI || !requestJSON) {\n      return Promise.reject();\n    }\n\n    return new Promise<AssetDTO>((resolve, reject) => {\n      const endpointUrl = vivedAPI.getEndpointURL(`assets/${assetID}`);\n      const options: RequestJSONOptions = {\n        method: \"GET\"\n      };\n\n      requestJSON(endpointUrl, options)\n        .then((resp: Resp) => {\n          const assetDTO = responseToDTO(resp.asset);\n          assetDTO.id = assetID;\n\n          resolve(assetDTO);\n        })\n        .catch((e: Error) => {\n          this.warn(e.message);\n          reject(e);\n        });\n    });\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, FetchAssetMetaFromAPIUC.type);\n    this.appObjects.registerSingleton(this);\n  }\n}\n\ninterface Resp {\n  asset: BaseAssetResp;\n}\n\ninterface BaseAssetResp {\n  id: string;\n  ownerId: string;\n  name: string;\n  description: string;\n  archived: boolean;\n  fileURL: string;\n  filename: string;\n  linkedAssets: { type: string; asset: BaseAssetResp }[];\n}\n\nfunction responseToDTO(resp: BaseAssetResp): AssetDTO {\n  const linkedAssets = resp.linkedAssets.map((linkedAssetResp) => {\n    return {\n      type: linkedAssetResp.type,\n      asset: responseToDTO(linkedAssetResp.asset)\n    };\n  });\n\n  const dto: AssetDTO = {\n    archived: resp.archived,\n    description: resp.description,\n    fileURL: resp.fileURL,\n    filename: resp.filename,\n    id: resp.id,\n    name: resp.name,\n    linkedAssets,\n    ownerId: resp.ownerId\n  };\n\n  return dto;\n}\n"]}

package/dist/cjs/VivedAPI/UCs/FileUploadUC.js

@@ -1,4 +1,24 @@
 "use strict";
+/**
+ * FileUploadUC.ts
+ *
+ * This file defines the Use Case for uploading files to the VIVED API.
+ * FileUploadUC handles the process of uploading file data to storage endpoints,
+ * managing multipart form data and upload progress.
+ *
+ * Key concepts:
+ * - Abstract UC defining the interface for file upload operations
+ * - Handles file upload workflows with progress tracking
+ * - Coordinates with BasicFetchUC for HTTP transport
+ * - Manages multipart form data encoding and transmission
+ * - Provides error handling for upload failures
+ *
+ * Usage pattern:
+ * 1. Get a UC instance using FileUploadUC.get(appObjects) or makeFileUploadUC
+ * 2. Call doUpload with File object to upload
+ * 3. Handle the returned Promise for upload completion
+ * 4. UC manages the HTTP upload mechanics and error handling
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileUploadUC = void 0;
 exports.makeFileUploadUC = makeFileUploadUC;
@@ -6,16 +26,35 @@ const core_1 = require("@vived/core");
 const VivedAPIEntity_1 = require("../Entities/VivedAPIEntity");
 const BasicFetchUC_1 = require("./BasicFetchUC");
 const JsonRequestUC_1 = require("./JsonRequestUC");
+/**
+ * FileUploadUC provides functionality for uploading files to APIs.
+ * Abstract class that defines the interface for file upload operations.
+ */
 class FileUploadUC extends core_1.AppObjectUC {
+    /**
+     * Retrieves a FileUploadUC component from an AppObject
+     * @param appObjects The AppObjectRepo to get the component from
+     * @returns The FileUploadUC component or undefined if not found
+     */
     static get(appObjects) {
         return (0, core_1.getSingletonComponent)(FileUploadUC.type, appObjects);
     }
 }
 exports.FileUploadUC = FileUploadUC;
+/** Unique type identifier for this component */
 FileUploadUC.type = "FileUploadUC";
+/**
+ * Factory function to create a new FileUploadUC instance
+ * @param appObject The AppObject to attach the UC to
+ * @returns A new FileUploadUC instance
+ */
 function makeFileUploadUC(appObject) {
     return new FileUploadUCImp(appObject);
 }
+/**
+ * Concrete implementation of FileUploadUC
+ * This private class handles the actual file upload mechanics
+ */
 class FileUploadUCImp extends FileUploadUC {
     get vivedAPI() {
         return this.getCachedSingleton(VivedAPIEntity_1.VivedAPIEntity.type);

package/dist/cjs/VivedAPI/UCs/FileUploadUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileUploadUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FileUploadUC.ts"],"names":[],"mappings":";;;AAoBA,4CAEC;AAtBD,sCAKqB;AACrB,+DAA4D;AAC5D,iDAAiE;AACjE,mDAAgD;AAEhD,MAAsB,YAAa,SAAQ,kBAAW;IAKpD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;;AAPH,oCAQC;AAPQ,iBAAI,GAAG,cAAc,CAAC;AAS/B,SAAgB,gBAAgB,CAAC,SAAoB;IACnD,OAAO,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,eAAgB,SAAQ,YAAY;IACxC,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,UAAU;QACpB,OAAO,IAAI,CAAC,kBAAkB,CAAe,2BAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC7E,CAAC;IAmCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAlCtC,aAAQ,GAAG,CAAC,IAAU,EAAiB,EAAE;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YAEnC,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,CAC1C,6BAA6B,IAAI,CAAC,IAAI,EAAE,CACzC,CAAC;gBAEF,WAAW,CAAC,YAAY,CAAC;qBACtB,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;oBAClB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAmB,CAAC,CAAC;oBACzC,MAAM,OAAO,GAAsB;wBACjC,MAAM,EAAE,KAAK;wBACb,IAAI,EAAE,IAAI;qBACX,CAAC;oBAEF,OAAO,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAClC,CAAC,CAAC;qBACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { VivedAPIEntity } from \"../Entities/VivedAPIEntity\";\r\nimport { BasicFetchOptions, BasicFetchUC } from \"./BasicFetchUC\";\r\nimport { JsonRequestUC } from \"./JsonRequestUC\";\r\n\r\nexport abstract class FileUploadUC extends AppObjectUC {\r\n  static type = \"FileUploadUC\";\r\n\r\n  abstract doUpload(file: File): Promise<void>;\r\n\r\n  static get(appObjects: AppObjectRepo): FileUploadUC | undefined {\r\n    return getSingletonComponent(FileUploadUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeFileUploadUC(appObject: AppObject): FileUploadUC {\r\n  return new FileUploadUCImp(appObject);\r\n}\r\n\r\nclass FileUploadUCImp extends FileUploadUC {\r\n  private get vivedAPI(): VivedAPIEntity | undefined {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  private get requestJSON() {\r\n    return this.getCachedSingleton<JsonRequestUC>(JsonRequestUC.type)\r\n      ?.doRequest;\r\n  }\r\n\r\n  private get basicFetch() {\r\n    return this.getCachedSingleton<BasicFetchUC>(BasicFetchUC.type)?.doRequest;\r\n  }\r\n\r\n  doUpload = (file: File): Promise<void> => {\r\n    const vivedAPI = this.vivedAPI;\r\n    const requestJSON = this.requestJSON;\r\n    const basicFetch = this.basicFetch;\r\n\r\n    if (!vivedAPI || !requestJSON || !basicFetch) {\r\n      return Promise.reject();\r\n    }\r\n    return new Promise<void>((resolve, reject) => {\r\n      const getUploadURL = vivedAPI.getEndpointURL(\r\n        `upload/large/DataVariants/${file.name}`\r\n      );\r\n\r\n      requestJSON(getUploadURL)\r\n        .then((uploadURL) => {\r\n          const url = new URL(uploadURL as string);\r\n          const options: BasicFetchOptions = {\r\n            method: \"PUT\",\r\n            body: file\r\n          };\r\n\r\n          return basicFetch(url, options);\r\n        })\r\n        .then((_) => {\r\n          resolve();\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, FileUploadUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"FileUploadUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FileUploadUC.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AA0CH,4CAEC;AA1CD,sCAKqB;AACrB,+DAA4D;AAC5D,iDAAiE;AACjE,mDAAgD;AAEhD;;;GAGG;AACH,MAAsB,YAAa,SAAQ,kBAAW;IAWpD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;;AAlBH,oCAmBC;AAlBC,gDAAgD;AACzC,iBAAI,GAAG,cAAc,CAAC;AAmB/B;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,SAAoB;IACnD,OAAO,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,eAAgB,SAAQ,YAAY;IACxC,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,+BAAc,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,IAAY,WAAW;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAgB,6BAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,UAAU;QACpB,OAAO,IAAI,CAAC,kBAAkB,CAAe,2BAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC7E,CAAC;IAmCD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAlCtC,aAAQ,GAAG,CAAC,IAAU,EAAiB,EAAE;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YAEnC,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,CAC1C,6BAA6B,IAAI,CAAC,IAAI,EAAE,CACzC,CAAC;gBAEF,WAAW,CAAC,YAAY,CAAC;qBACtB,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;oBAClB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAmB,CAAC,CAAC;oBACzC,MAAM,OAAO,GAAsB;wBACjC,MAAM,EAAE,KAAK;wBACb,IAAI,EAAE,IAAI;qBACX,CAAC;oBAEF,OAAO,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAClC,CAAC,CAAC;qBACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;oBAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\r\n * FileUploadUC.ts\r\n * \r\n * This file defines the Use Case for uploading files to the VIVED API.\r\n * FileUploadUC handles the process of uploading file data to storage endpoints,\r\n * managing multipart form data and upload progress.\r\n * \r\n * Key concepts:\r\n * - Abstract UC defining the interface for file upload operations\r\n * - Handles file upload workflows with progress tracking\r\n * - Coordinates with BasicFetchUC for HTTP transport\r\n * - Manages multipart form data encoding and transmission\r\n * - Provides error handling for upload failures\r\n * \r\n * Usage pattern:\r\n * 1. Get a UC instance using FileUploadUC.get(appObjects) or makeFileUploadUC\r\n * 2. Call doUpload with File object to upload\r\n * 3. Handle the returned Promise for upload completion\r\n * 4. UC manages the HTTP upload mechanics and error handling\r\n */\r\n\r\nimport {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { VivedAPIEntity } from \"../Entities/VivedAPIEntity\";\r\nimport { BasicFetchOptions, BasicFetchUC } from \"./BasicFetchUC\";\r\nimport { JsonRequestUC } from \"./JsonRequestUC\";\r\n\r\n/**\r\n * FileUploadUC provides functionality for uploading files to APIs.\r\n * Abstract class that defines the interface for file upload operations.\r\n */\r\nexport abstract class FileUploadUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static type = \"FileUploadUC\";\r\n\r\n  /**\r\n   * Uploads a file to the configured API endpoint\r\n   * @param file The File object to upload\r\n   * @returns Promise that resolves when upload is complete\r\n   */\r\n  abstract doUpload(file: File): Promise<void>;\r\n\r\n  /**\r\n   * Retrieves a FileUploadUC component from an AppObject\r\n   * @param appObjects The AppObjectRepo to get the component from\r\n   * @returns The FileUploadUC component or undefined if not found\r\n   */\r\n  static get(appObjects: AppObjectRepo): FileUploadUC | undefined {\r\n    return getSingletonComponent(FileUploadUC.type, appObjects);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new FileUploadUC instance\r\n * @param appObject The AppObject to attach the UC to\r\n * @returns A new FileUploadUC instance\r\n */\r\nexport function makeFileUploadUC(appObject: AppObject): FileUploadUC {\r\n  return new FileUploadUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of FileUploadUC\r\n * This private class handles the actual file upload mechanics\r\n */\r\nclass FileUploadUCImp extends FileUploadUC {\r\n  private get vivedAPI(): VivedAPIEntity | undefined {\r\n    return this.getCachedSingleton<VivedAPIEntity>(VivedAPIEntity.type);\r\n  }\r\n\r\n  private get requestJSON() {\r\n    return this.getCachedSingleton<JsonRequestUC>(JsonRequestUC.type)\r\n      ?.doRequest;\r\n  }\r\n\r\n  private get basicFetch() {\r\n    return this.getCachedSingleton<BasicFetchUC>(BasicFetchUC.type)?.doRequest;\r\n  }\r\n\r\n  doUpload = (file: File): Promise<void> => {\r\n    const vivedAPI = this.vivedAPI;\r\n    const requestJSON = this.requestJSON;\r\n    const basicFetch = this.basicFetch;\r\n\r\n    if (!vivedAPI || !requestJSON || !basicFetch) {\r\n      return Promise.reject();\r\n    }\r\n    return new Promise<void>((resolve, reject) => {\r\n      const getUploadURL = vivedAPI.getEndpointURL(\r\n        `upload/large/DataVariants/${file.name}`\r\n      );\r\n\r\n      requestJSON(getUploadURL)\r\n        .then((uploadURL) => {\r\n          const url = new URL(uploadURL as string);\r\n          const options: BasicFetchOptions = {\r\n            method: \"PUT\",\r\n            body: file\r\n          };\r\n\r\n          return basicFetch(url, options);\r\n        })\r\n        .then((_) => {\r\n          resolve();\r\n        })\r\n        .catch((e: Error) => {\r\n          this.warn(e.message);\r\n          reject(e);\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, FileUploadUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}