refactor: front end code to unified design

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

src/services/entityService.ts

@@ -2,10 +2,12 @@
  * Entity management service
  */
 
-import { transceivePost } from './transceive';
+import { transceivePost, transceiveStream } from './transceive';
 import type {
-  EntityListRequest,
-  EntityListResponse,
+  EntityListBulkRequest,
+  EntityListBulkResponse,
+  EntityListStreamRequest,
+  EntityListStreamResponse,
   EntityFetchRequest,
   EntityFetchResponse,
   EntityExtantRequest,
@@ -18,6 +20,8 @@ import type {
   EntityDeleteResponse,
   EntityDeltaRequest,
   EntityDeltaResponse,
+  EntityMoveRequest,
+  EntityMoveResponse,
   EntityInterface,
 } from '../types/entity';
 import { useIntegrationStore } from '@KTXC/stores/integrationStore';
@@ -31,7 +35,7 @@ function createEntityObject(data: EntityInterface): EntityObject {
   const integrationStore = useIntegrationStore();
   const factoryItem = integrationStore.getItemById('chrono_entity_factory', data.provider) as any;
   const factory = factoryItem?.factory;
-  
+
   // Use provider factory if available, otherwise base class
   return factory ? factory(data) : new EntityObject().fromJson(data);
 }
@@ -39,16 +43,11 @@ function createEntityObject(data: EntityInterface): EntityObject {
 export const entityService = {
 
   /**
-   * Retrieve list of entities, optionally filtered by source selector
-   * 
-   * @param request - list request parameters
-   * 
-   * @returns Promise with entity object list grouped by provider, service, collection, and entity identifier
+   * Retrieve list of entities, optionally filtered by source collection identifiers
    */
-  async list(request: EntityListRequest = {}): Promise<Record<string, Record<string, Record<string, Record<string, EntityObject>>>>> {
-    const response = await transceivePost<EntityListRequest, EntityListResponse>('entity.list', request);
-    
-    // Convert nested response to EntityObject instances
+  async listBulk(request: EntityListBulkRequest = {}): Promise<Record<string, Record<string, Record<string, Record<string, EntityObject>>>>> {
+    const response = await transceivePost<EntityListBulkRequest, EntityListBulkResponse>('entity.listBulk', request);
+
     const providerList: Record<string, Record<string, Record<string, Record<string, EntityObject>>>> = {};
     Object.entries(response).forEach(([providerId, providerServices]) => {
       const serviceList: Record<string, Record<string, Record<string, EntityObject>>> = {};
@@ -65,35 +64,39 @@ export const entityService = {
       });
       providerList[providerId] = serviceList;
     });
-    
+
     return providerList;
   },
 
   /**
-   * Retrieve a specific entity by provider and identifier
-   * 
-   * @param request - fetch request parameters
-   * 
-   * @returns Promise with entity objects keyed by identifier
+   * Stream entities as NDJSON, invoking onEntity for each entity as it arrives.
+   */
+  async listStream(request: EntityListStreamRequest, onEntity: (entity: EntityObject) => void): Promise<{ total: number }> {
+    return await transceiveStream<EntityListStreamRequest, EntityListStreamResponse>(
+      'entity.listStream',
+      request,
+      (entity) => {
+        onEntity(createEntityObject(entity));
+      }
+    );
+  },
+
+  /**
+   * Retrieve specific entities by their identifiers
    */
   async fetch(request: EntityFetchRequest): Promise<Record<string, EntityObject>> {
     const response = await transceivePost<EntityFetchRequest, EntityFetchResponse>('entity.fetch', request);
-    
-    // Convert response to EntityObject instances
+
     const list: Record<string, EntityObject> = {};
-    Object.entries(response).forEach(([identifier, entityData]) => {
-      list[identifier] = createEntityObject(entityData);
+    Object.entries(response).forEach(([, entity]) => {
+      list[entity.identifier] = createEntityObject(entity);
     });
-    
+
     return list;
   },
 
   /**
-   * Retrieve entity availability status for a given source selector
-   * 
-   * @param request - extant request parameters
-   * 
-   * @returns Promise with entity availability status
+   * Retrieve entity availability status for a given set of entity identifiers
    */
   async extant(request: EntityExtantRequest): Promise<EntityExtantResponse> {
     return await transceivePost<EntityExtantRequest, EntityExtantResponse>('entity.extant', request);
@@ -101,10 +104,6 @@ export const entityService = {
 
   /**
    * Create a new entity
-   * 
-   * @param request - create request parameters
-   * 
-   * @returns Promise with created entity object
    */
   async create(request: EntityCreateRequest): Promise<EntityObject> {
     const response = await transceivePost<EntityCreateRequest, EntityCreateResponse>('entity.create', request);
@@ -113,10 +112,6 @@ export const entityService = {
 
   /**
    * Update an existing entity
-   * 
-   * @param request - update request parameters
-   * 
-   * @returns Promise with updated entity object
    */
   async update(request: EntityUpdateRequest): Promise<EntityObject> {
     const response = await transceivePost<EntityUpdateRequest, EntityUpdateResponse>('entity.update', request);
@@ -124,11 +119,7 @@ export const entityService = {
   },
 
   /**
-   * Delete an entity
-   * 
-   * @param request - delete request parameters
-   * 
-   * @returns Promise with deletion result
+   * Delete entities by their identifiers
    */
   async delete(request: EntityDeleteRequest): Promise<EntityDeleteResponse> {
     return await transceivePost<EntityDeleteRequest, EntityDeleteResponse>('entity.delete', request);
@@ -136,15 +127,18 @@ export const entityService = {
 
   /**
    * Retrieve delta changes for entities
-   * 
-   * @param request - delta request parameters
-   * 
-   * @returns Promise with delta changes (created, modified, deleted)
    */
   async delta(request: EntityDeltaRequest): Promise<EntityDeltaResponse> {
     return await transceivePost<EntityDeltaRequest, EntityDeltaResponse>('entity.delta', request);
   },
 
+  /**
+   * Move entities to a target collection
+   */
+  async move(request: EntityMoveRequest): Promise<EntityMoveResponse> {
+    return await transceivePost<EntityMoveRequest, EntityMoveResponse>('entity.move', request);
+  },
+
 };
 
 export default entityService;