@vived/host 4.9.1 → 4.11.0

package/dist/esm/VivedAPI/Mocks/MockJsonRequestUC.js

@@ -1,10 +1,44 @@
+/**
+ * MockJsonRequestUC.ts
+ *
+ * This file provides a mock implementation of JsonRequestUC for testing and development.
+ * MockJsonRequestUC replaces real HTTP request functionality with Jest mock functions,
+ * enabling controlled testing scenarios and development without live API dependencies.
+ *
+ * Key concepts:
+ * - Mock extends the real JsonRequestUC class to maintain interface compatibility
+ * - Uses Jest mock functions to provide controllable request behavior
+ * - Enables testing of components that depend on JSON HTTP requests
+ * - Allows simulation of various response scenarios (success, failure, delays)
+ * - Supports isolated unit testing without external API dependencies
+ *
+ * Usage pattern:
+ * 1. Use makeMockJsonRequestUC to create and register the mock
+ * 2. Configure mock behavior using Jest mock function methods
+ * 3. Test components can verify request calls and control responses
+ * 4. Replace with real implementation for integration testing
+ */
 import { JsonRequestUC } from "../UCs/JsonRequestUC";
+/**
+ * Mock implementation of JsonRequestUC for testing and development
+ * Provides Jest mock functions instead of real HTTP request functionality
+ */
 export class MockJsonRequestUC extends JsonRequestUC {
+    /**
+     * Constructs a new MockJsonRequestUC
+     * @param appObject The AppObject this mock UC belongs to
+     */
     constructor(appObject) {
         super(appObject, JsonRequestUC.type);
+        /** Jest mock function for the doRequest method */
         this.doRequest = jest.fn();
     }
 }
+/**
+ * Factory function to create and register a MockJsonRequestUC
+ * @param appObjects The AppObjectRepo to create the mock in
+ * @returns A new MockJsonRequestUC instance
+ */
 export function makeMockJsonRequestUC(appObjects) {
     return new MockJsonRequestUC(appObjects.getOrCreate("MockJsonRequestUC"));
 }

package/dist/esm/VivedAPI/Mocks/MockJsonRequestUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockJsonRequestUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockJsonRequestUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAGlD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAHvC,cAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAItB,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAyB;IAC7D,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { JsonRequestUC } from \"../UCs/JsonRequestUC\";\r\n\r\nexport class MockJsonRequestUC extends JsonRequestUC {\r\n  doRequest = jest.fn();\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, JsonRequestUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockJsonRequestUC(appObjects: AppObjectRepo) {\r\n  return new MockJsonRequestUC(appObjects.getOrCreate(\"MockJsonRequestUC\"));\r\n}\r\n"]}
+{"version":3,"file":"MockJsonRequestUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockJsonRequestUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAIlD;;;OAGG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QARvC,kDAAkD;QAClD,cAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAQtB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAyB;IAC7D,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["/**\r\n * MockJsonRequestUC.ts\r\n * \r\n * This file provides a mock implementation of JsonRequestUC for testing and development.\r\n * MockJsonRequestUC replaces real HTTP request functionality with Jest mock functions,\r\n * enabling controlled testing scenarios and development without live API dependencies.\r\n * \r\n * Key concepts:\r\n * - Mock extends the real JsonRequestUC class to maintain interface compatibility\r\n * - Uses Jest mock functions to provide controllable request behavior\r\n * - Enables testing of components that depend on JSON HTTP requests\r\n * - Allows simulation of various response scenarios (success, failure, delays)\r\n * - Supports isolated unit testing without external API dependencies\r\n * \r\n * Usage pattern:\r\n * 1. Use makeMockJsonRequestUC to create and register the mock\r\n * 2. Configure mock behavior using Jest mock function methods\r\n * 3. Test components can verify request calls and control responses\r\n * 4. Replace with real implementation for integration testing\r\n */\r\n\r\nimport { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { JsonRequestUC } from \"../UCs/JsonRequestUC\";\r\n\r\n/**\r\n * Mock implementation of JsonRequestUC for testing and development\r\n * Provides Jest mock functions instead of real HTTP request functionality\r\n */\r\nexport class MockJsonRequestUC extends JsonRequestUC {\r\n  /** Jest mock function for the doRequest method */\r\n  doRequest = jest.fn();\r\n\r\n  /**\r\n   * Constructs a new MockJsonRequestUC\r\n   * @param appObject The AppObject this mock UC belongs to\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, JsonRequestUC.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create and register a MockJsonRequestUC\r\n * @param appObjects The AppObjectRepo to create the mock in\r\n * @returns A new MockJsonRequestUC instance\r\n */\r\nexport function makeMockJsonRequestUC(appObjects: AppObjectRepo) {\r\n  return new MockJsonRequestUC(appObjects.getOrCreate(\"MockJsonRequestUC\"));\r\n}\r\n"]}

package/dist/esm/VivedAPI/Mocks/MockPatchAssetFileUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockPatchAssetFileUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetFileUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IAGxD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAH1C,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAItD,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAyB;IAChE,OAAO,IAAI,oBAAoB,CAC7B,UAAU,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAC/C,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { PatchAssetFileUC } from \"../UCs/PatchAssetFileUC\";\r\n\r\nexport class MockPatchAssetFileUC extends PatchAssetFileUC {\r\n  doPatch = jest.fn().mockResolvedValue(\"new.filename\");\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, PatchAssetFileUC.type);\r\n  }\r\n}\r\n\r\nexport function mockMockPatchAssetFileUC(appObjects: AppObjectRepo) {\r\n  return new MockPatchAssetFileUC(\r\n    appObjects.getOrCreate(\"MockPatchAssetFileUC\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"MockPatchAssetFileUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetFileUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IAGxD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAH1C,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAItD,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAyB;IAChE,OAAO,IAAI,oBAAoB,CAC7B,UAAU,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAC/C,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { PatchAssetFileUC } from \"../UCs/PatchAssetFileUC\";\n\nexport class MockPatchAssetFileUC extends PatchAssetFileUC {\n  doPatch = jest.fn().mockResolvedValue(\"new.filename\");\n\n  constructor(appObject: AppObject) {\n    super(appObject, PatchAssetFileUC.type);\n  }\n}\n\nexport function mockMockPatchAssetFileUC(appObjects: AppObjectRepo) {\n  return new MockPatchAssetFileUC(\n    appObjects.getOrCreate(\"MockPatchAssetFileUC\")\n  );\n}\n"]}

package/dist/esm/VivedAPI/Mocks/MockPatchAssetIsArchivedUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockPatchAssetIsArchivedUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetIsArchivedUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IAGpE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAHhD,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIjD,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAyB;IACtE,OAAO,IAAI,0BAA0B,CACnC,UAAU,CAAC,WAAW,CAAC,4BAA4B,CAAC,CACrD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { PatchAssetIsArchivedUC } from \"../UCs/PatchAssetIsArchivedUC\";\r\n\r\nexport class MockPatchAssetIsArchivedUC extends PatchAssetIsArchivedUC {\r\n  doPatch = jest.fn().mockResolvedValue(undefined);\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, PatchAssetIsArchivedUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockPatchAssetIsArchivedUC(appObjects: AppObjectRepo) {\r\n  return new MockPatchAssetIsArchivedUC(\r\n    appObjects.getOrCreate(\"MockPatchAssetIsArchivedUC\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"MockPatchAssetIsArchivedUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetIsArchivedUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IAGpE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAHhD,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIjD,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAyB;IACtE,OAAO,IAAI,0BAA0B,CACnC,UAAU,CAAC,WAAW,CAAC,4BAA4B,CAAC,CACrD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { PatchAssetIsArchivedUC } from \"../UCs/PatchAssetIsArchivedUC\";\n\nexport class MockPatchAssetIsArchivedUC extends PatchAssetIsArchivedUC {\n  doPatch = jest.fn().mockResolvedValue(undefined);\n\n  constructor(appObject: AppObject) {\n    super(appObject, PatchAssetIsArchivedUC.type);\n  }\n}\n\nexport function makeMockPatchAssetIsArchivedUC(appObjects: AppObjectRepo) {\n  return new MockPatchAssetIsArchivedUC(\n    appObjects.getOrCreate(\"MockPatchAssetIsArchivedUC\")\n  );\n}\n"]}

package/dist/esm/VivedAPI/Mocks/MockPatchAssetMetaUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockPatchAssetMetaUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetMetaUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IAGxD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAH1C,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIjD,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAyB;IAChE,OAAO,IAAI,oBAAoB,CAC7B,UAAU,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAC/C,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { PatchAssetMetaUC } from \"../UCs\";\r\n\r\nexport class MockPatchAssetMetaUC extends PatchAssetMetaUC {\r\n  doPatch = jest.fn().mockResolvedValue(undefined);\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, PatchAssetMetaUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockPatchAssetMetaUC(appObjects: AppObjectRepo) {\r\n  return new MockPatchAssetMetaUC(\r\n    appObjects.getOrCreate(\"MockPatchAssetMetaUC\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"MockPatchAssetMetaUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetMetaUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IAGxD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAH1C,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIjD,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAyB;IAChE,OAAO,IAAI,oBAAoB,CAC7B,UAAU,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAC/C,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { PatchAssetMetaUC } from \"../UCs\";\n\nexport class MockPatchAssetMetaUC extends PatchAssetMetaUC {\n  doPatch = jest.fn().mockResolvedValue(undefined);\n\n  constructor(appObject: AppObject) {\n    super(appObject, PatchAssetMetaUC.type);\n  }\n}\n\nexport function makeMockPatchAssetMetaUC(appObjects: AppObjectRepo) {\n  return new MockPatchAssetMetaUC(\n    appObjects.getOrCreate(\"MockPatchAssetMetaUC\")\n  );\n}\n"]}

package/dist/esm/VivedAPI/Mocks/MockPatchAssetUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockPatchAssetUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAGhD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAHtC,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIjD,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAyB;IAC5D,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { PatchAssetUC } from \"../UCs/PatchAssetUC\";\r\n\r\nexport class MockPatchAssetUC extends PatchAssetUC {\r\n  doPatch = jest.fn().mockResolvedValue(undefined);\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, PatchAssetUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockPatchAssetUC(appObjects: AppObjectRepo) {\r\n  return new MockPatchAssetUC(appObjects.getOrCreate(\"MockPatchAssetUC\"));\r\n}\r\n"]}
+{"version":3,"file":"MockPatchAssetUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPatchAssetUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAGhD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAHtC,YAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIjD,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAyB;IAC5D,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { PatchAssetUC } from \"../UCs/PatchAssetUC\";\n\nexport class MockPatchAssetUC extends PatchAssetUC {\n  doPatch = jest.fn().mockResolvedValue(undefined);\n\n  constructor(appObject: AppObject) {\n    super(appObject, PatchAssetUC.type);\n  }\n}\n\nexport function makeMockPatchAssetUC(appObjects: AppObjectRepo) {\n  return new MockPatchAssetUC(appObjects.getOrCreate(\"MockPatchAssetUC\"));\n}\n"]}

package/dist/esm/VivedAPI/Mocks/MockPostNewAssetUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockPostNewAssetUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPostNewAssetUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAMpD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QANxC,WAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACnC,EAAE,EAAE,YAAY;YAChB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAC;IAIH,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAyB;IAC9D,OAAO,IAAI,kBAAkB,CAAC,UAAU,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { PostNewAssetUC } from \"../UCs/PostNewAssetUC\";\r\n\r\nexport class MockPostNewAssetUC extends PostNewAssetUC {\r\n  doPost = jest.fn().mockResolvedValue({\r\n    id: \"newAssetID\",\r\n    filename: \"newAssetFile.name\"\r\n  });\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, PostNewAssetUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockPostNewAssetUC(appObjects: AppObjectRepo) {\r\n  return new MockPostNewAssetUC(appObjects.getOrCreate(\"MockPostNewAssetUC\"));\r\n}\r\n"]}
+{"version":3,"file":"MockPostNewAssetUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockPostNewAssetUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAMpD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QANxC,WAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACnC,EAAE,EAAE,YAAY;YAChB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAC;IAIH,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAyB;IAC9D,OAAO,IAAI,kBAAkB,CAAC,UAAU,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { PostNewAssetUC } from \"../UCs/PostNewAssetUC\";\n\nexport class MockPostNewAssetUC extends PostNewAssetUC {\n  doPost = jest.fn().mockResolvedValue({\n    id: \"newAssetID\",\n    filename: \"newAssetFile.name\"\n  });\n\n  constructor(appObject: AppObject) {\n    super(appObject, PostNewAssetUC.type);\n  }\n}\n\nexport function makeMockPostNewAssetUC(appObjects: AppObjectRepo) {\n  return new MockPostNewAssetUC(appObjects.getOrCreate(\"MockPostNewAssetUC\"));\n}\n"]}

package/dist/esm/VivedAPI/Mocks/MockSignedAuthToken.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockSignedAuthToken.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockSignedAuthToken.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAG1D,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAH3C,iBAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAIzB,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,UAAyB;IACjE,OAAO,IAAI,qBAAqB,CAC9B,UAAU,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAChD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { SignedAuthTokenUC } from \"../UCs/SignedAuthTokenUC\";\r\n\r\nexport class MockSignedAuthTokenUC extends SignedAuthTokenUC {\r\n  getAuthToken = jest.fn();\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SignedAuthTokenUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockSignedAuthTokenUC(appObjects: AppObjectRepo) {\r\n  return new MockSignedAuthTokenUC(\r\n    appObjects.getOrCreate(\"MockSignedAuthTokenUC\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"MockSignedAuthToken.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockSignedAuthToken.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAG1D,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAH3C,iBAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAIzB,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,UAAyB;IACjE,OAAO,IAAI,qBAAqB,CAC9B,UAAU,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAChD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { SignedAuthTokenUC } from \"../UCs/SignedAuthTokenUC\";\n\nexport class MockSignedAuthTokenUC extends SignedAuthTokenUC {\n  getAuthToken = jest.fn();\n\n  constructor(appObject: AppObject) {\n    super(appObject, SignedAuthTokenUC.type);\n  }\n}\n\nexport function makeMockSignedAuthTokenUC(appObjects: AppObjectRepo) {\n  return new MockSignedAuthTokenUC(\n    appObjects.getOrCreate(\"MockSignedAuthTokenUC\")\n  );\n}\n"]}

package/dist/esm/VivedAPI/Mocks/MockUserLoginUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockUserLoginUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockUserLoginUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,cAAe,SAAQ,UAAU;IAK5C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QALpC,UAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/C,WAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAChD,6BAAwB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIlE,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAyB;IAC3D,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACtE,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { UserAuthUC } from \"../UCs/UserAuthUC\";\r\n\r\nexport class MockUserAuthUC extends UserAuthUC {\r\n  login = jest.fn().mockResolvedValue(undefined);\r\n  logout = jest.fn().mockResolvedValue(undefined);\r\n  refreshAuthenticatedUser = jest.fn().mockResolvedValue(undefined);\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UserAuthUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockUserLoginUC(appObjects: AppObjectRepo) {\r\n  return new MockUserAuthUC(appObjects.getOrCreate(\"MockUserAuthUC\"));\r\n}\r\n"]}
+{"version":3,"file":"MockUserLoginUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/MockUserLoginUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,cAAe,SAAQ,UAAU;IAK5C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QALpC,UAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/C,WAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAChD,6BAAwB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIlE,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAyB;IAC3D,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACtE,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { UserAuthUC } from \"../UCs/UserAuthUC\";\n\nexport class MockUserAuthUC extends UserAuthUC {\n  login = jest.fn().mockResolvedValue(undefined);\n  logout = jest.fn().mockResolvedValue(undefined);\n  refreshAuthenticatedUser = jest.fn().mockResolvedValue(undefined);\n\n  constructor(appObject: AppObject) {\n    super(appObject, UserAuthUC.type);\n  }\n}\n\nexport function makeMockUserLoginUC(appObjects: AppObjectRepo) {\n  return new MockUserAuthUC(appObjects.getOrCreate(\"MockUserAuthUC\"));\n}\n"]}

package/dist/esm/VivedAPI/Mocks/UserTokenPMMock.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserTokenPMMock.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/UserTokenPMMock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAE9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAFrC,gBAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAGxB,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAyB;IAC3D,OAAO,IAAI,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { UserTokenPM } from \"../PMs/UserTokenPM\";\r\n\r\nexport class UserTokenPMMock extends UserTokenPM {\r\n  vmsAreEqual = jest.fn();\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UserTokenPM.type);\r\n  }\r\n}\r\n\r\nexport function makeUserTokenPMMock(appObjects: AppObjectRepo) {\r\n  return new UserTokenPMMock(appObjects.getOrCreate(\"UserTokenPMMock\"));\r\n}\r\n"]}
+{"version":3,"file":"UserTokenPMMock.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/UserTokenPMMock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAE9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAFrC,gBAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAGxB,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAyB;IAC3D,OAAO,IAAI,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { UserTokenPM } from \"../PMs/UserTokenPM\";\n\nexport class UserTokenPMMock extends UserTokenPM {\n  vmsAreEqual = jest.fn();\n  constructor(appObject: AppObject) {\n    super(appObject, UserTokenPM.type);\n  }\n}\n\nexport function makeUserTokenPMMock(appObjects: AppObjectRepo) {\n  return new UserTokenPMMock(appObjects.getOrCreate(\"UserTokenPMMock\"));\n}\n"]}

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

@@ -1,3 +1,27 @@
+/**
+ * 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
+ */
 export * from "./ApiStagePMMock";
 export * from "./MockBasicFetchUC";
 export * from "./MockBlobRequestUC";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/VivedAPI/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC","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,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC","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/esm/VivedAPI/PMs/ApiStagePM.js

@@ -1,23 +1,80 @@
+/**
+ * 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
+ */
 import { getSingletonComponent, AppObjectPM } from "@vived/core";
 import { VivedAPIEntity } from "../Entities";
+/**
+ * ApiStagePM provides presentation logic for API stage configuration.
+ * Abstract class that manages the view model for API environment settings.
+ */
 export class ApiStagePM extends 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 getSingletonComponent(ApiStagePM.type, appObjects);
     }
 }
+/** 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
+ */
 export 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(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/esm/VivedAPI/PMs/ApiStagePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiStagePM.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/ApiStagePM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAY,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,OAAgB,UAAW,SAAQ,WAAqB;IAG5D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAJM,eAAI,GAAG,YAAY,CAAC;AAO7B,MAAM,UAAU,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,cAAc,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;AAEH,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAY,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,MAAM,OAAgB,UAAW,SAAQ,WAAqB;IAI5D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAVD,gDAAgD;AACzC,eAAI,GAAG,YAAY,CAAC;AAY7B;;;;GAIG;AACH,MAAM,UAAU,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,cAAc,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/esm/VivedAPI/PMs/UserTokenPM.js

@@ -1,23 +1,76 @@
+/**
+ * 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
+ */
 import { getSingletonComponent, AppObjectPM } from "@vived/core";
 import { VivedAPIEntity } from "../Entities";
+/**
+ * UserTokenPM provides presentation logic for user authentication token display.
+ * Abstract class that manages the view model for user token information.
+ */
 export class UserTokenPM extends 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 getSingletonComponent(UserTokenPM.type, appObjects);
     }
 }
+/** 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
+ */
 export 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(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/esm/VivedAPI/PMs/UserTokenPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserTokenPM.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/UserTokenPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAgB,WAAY,SAAQ,WAAmB;IAG3D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AAJM,gBAAI,GAAG,aAAa,CAAC;AAO9B,MAAM,UAAU,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,cAAc,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;AAEH,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,MAAM,OAAgB,WAAY,SAAQ,WAAmB;IAI3D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAc,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;;AAVD,gDAAgD;AACzC,gBAAI,GAAG,aAAa,CAAC;AAY9B;;;;GAIG;AACH,MAAM,UAAU,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,cAAc,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/esm/VivedAPI/PMs/index.js

@@ -1,3 +1,21 @@
+/**
+ * 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
+ */
 export * from "./ApiStagePM";
 export * from "./UserTokenPM";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/VivedAPI/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA","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,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC","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/esm/VivedAPI/UCs/BasicFetchUC.js

@@ -1,8 +1,38 @@
+/**
+ * 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
+ */
 import { getSingletonComponent, AppObjectUC } from "@vived/core";
+/**
+ * BasicFetchUC provides functionality for making basic HTTP fetch requests.
+ * Abstract class that defines the interface for HTTP operations returning raw Response objects.
+ */
 export class BasicFetchUC extends 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 getSingletonComponent(BasicFetchUC.type, appObjects);
     }
 }
+/** Unique type identifier for this component */
 BasicFetchUC.type = "BasicFetchUC";
 //# sourceMappingURL=BasicFetchUC.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BasicFetchUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/BasicFetchUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AASrB,MAAM,OAAgB,YAAa,SAAQ,WAAW;IAKpD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;;AANM,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,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AAgBrB;;;GAGG;AACH,MAAM,OAAgB,YAAa,SAAQ,WAAW;IAYpD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;;AAlBD,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/esm/VivedAPI/UCs/BlobRequestUC.js

@@ -1,8 +1,38 @@
+/**
+ * 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
+ */
 import { getSingletonComponent, AppObjectUC } from "@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.
+ */
 export class BlobRequestUC extends 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 getSingletonComponent(BlobRequestUC.type, appObjects);
     }
 }
+/** Unique type identifier for this component */
 BlobRequestUC.type = "BlobRequestUC";
 //# sourceMappingURL=BlobRequestUC.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BlobRequestUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/BlobRequestUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AASrB,MAAM,OAAgB,aAAc,SAAQ,WAAW;IAKrD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;;AANM,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,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AAgBrB;;;GAGG;AACH,MAAM,OAAgB,aAAc,SAAQ,WAAW;IAYrD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;;AAlBD,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/esm/VivedAPI/UCs/DeleteAssetOnAPIUC.js

@@ -1,16 +1,55 @@
+/**
+ * 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
+ */
 import { getSingletonComponent, AppObjectUC } from "@vived/core";
 import { VivedAPIEntity } from "../Entities/VivedAPIEntity";
 import { JsonRequestUC } from "./JsonRequestUC";
 import { SignedAuthTokenUC } from "./SignedAuthTokenUC";
+/**
+ * DeleteAssetOnAPIUC provides functionality for deleting assets via API.
+ * Abstract class that defines the interface for asset deletion operations.
+ */
 export class DeleteAssetOnAPIUC extends 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 getSingletonComponent(DeleteAssetOnAPIUC.type, appObjects);
     }
 }
+/** 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
+ */
 export 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.type)

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

@@ -1 +1 @@
-{"version":3,"file":"DeleteAssetOnAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/DeleteAssetOnAPIUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,OAAgB,kBAAmB,SAAQ,WAAW;IAK1D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC;;AANM,uBAAI,GAAG,oBAAoB,CAAC;AASrC,MAAM,UAAU,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,aAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAoB,iBAAiB,CAAC,IAAI,CAAC;YACvE,EAAE,YAAY,CAAC;IACnB,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,cAAc,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;AAEH,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,WAAW;IAW1D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC;;AAjBD,gDAAgD;AACzC,uBAAI,GAAG,oBAAoB,CAAC;AAmBrC;;;;GAIG;AACH,MAAM,UAAU,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,aAAa,CAAC,IAAI,CAAC;YAC/D,EAAE,SAAS,CAAC;IAChB,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAoB,iBAAiB,CAAC,IAAI,CAAC;YACvE,EAAE,YAAY,CAAC;IACnB,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAiB,cAAc,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/esm/VivedAPI/UCs/FetchAssetFileFromAPIUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"FetchAssetFileFromAPIUC.js","sourceRoot":"","sources":["../../../../src/VivedAPI/UCs/FetchAssetFileFromAPIUC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,OAAgB,uBAAwB,SAAQ,WAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;;AANM,4BAAI,GAAG,yBAAyB,CAAC;AAS1C,MAAM,UAAU,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,aAAa,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":"AAAA,OAAO,EACL,qBAAqB,EAGrB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,OAAgB,uBAAwB,SAAQ,WAAW;IAK/D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;;AANM,4BAAI,GAAG,yBAAyB,CAAC;AAS1C,MAAM,UAAU,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,aAAa,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"]}