@futdevpro/fsm-dynamo 1.20.8 → 1.20.10

package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.spec.ts

@@ -1,374 +0,0 @@
-import { DyFM_ListCollectorDataHandler } from './list-collector-data-handler.control-model';
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-import { DyFM_ListCollectorDataHandler_Settings } from './data-handler-settings.control-model';
-import { DyFM_Error } from '../../../_models/control-models/error.control-model';
-
-class TestCollector extends DyFM_Metadata {
-  items?: TestItem[];
-}
-
-class TestItem extends DyFM_Metadata {
-  name?: string;
-}
-
-describe('| DyFM_ListCollectorDataHandler', (): void => {
-  let handler: DyFM_ListCollectorDataHandler<TestCollector, TestItem>;
-  let settings: DyFM_ListCollectorDataHandler_Settings<TestCollector, TestItem>;
-
-  beforeEach(() => {
-    settings = {
-      name: 'TestCollectorHandler',
-      listKey: 'items',
-      get: async (loadBy?: string): Promise<TestCollector> => {
-        return {
-          _id: loadBy || 'default',
-          items: [
-            { _id: '1', name: 'item1' } as TestItem,
-            { _id: '2', name: 'item2' } as TestItem,
-          ],
-        } as TestCollector;
-      },
-      setItem: async (item: TestItem, collectorId?: string): Promise<TestItem> => item,
-      deleteItem: async (id: string, collectorId?: string): Promise<void> => {},
-      defaultValue: { _id: 'default', items: [] } as TestCollector,
-    };
-
-    handler = new DyFM_ListCollectorDataHandler<TestCollector, TestItem>(settings);
-  });
-
-  it('| should create an instance with settings', (): void => {
-    expect(handler).toBeTruthy();
-    expect(handler.name).toBe('TestCollectorHandler');
-  });
-
-  it('| should have dataList$ observable', (): void => {
-    expect(handler.dataList$).toBeTruthy();
-  });
-
-  it('| should have activeItem$ observable', (): void => {
-    expect(handler.activeItem$).toBeTruthy();
-  });
-
-  it('| should get empty dataList initially', (): void => {
-    expect(handler.dataList).toEqual([]);
-  });
-
-  it('| should set active item', (): void => {
-    const item = { _id: '1', name: 'item1' } as TestItem;
-    handler.setActiveItem(item);
-
-    handler.activeItem$.subscribe(activeItem => {
-      expect(activeItem).toEqual(item);
-    });
-  });
-
-  it('| should clear data and active item', (): void => {
-    handler.clear();
-
-    expect(handler.dataList).toEqual([]);
-    handler.activeItem$.subscribe(activeItem => {
-      expect(activeItem).toBeNull();
-    });
-  });
-
-  it('| should throw error when adding item without data', async (): Promise<void> => {
-    handler.clear();
-    const newItem = { _id: '3', name: 'item3' } as TestItem;
-
-    await expectAsync(handler.addItem(newItem)).toBeRejectedWith(jasmine.any(DyFM_Error));
-  });
-
-  it('| should throw error when removing item without data', async (): Promise<void> => {
-    // Test case for lines 204-212: removeItem throws error when list not found
-    handler.clear();
-    
-    await expectAsync(handler.removeItem('1')).toBeRejectedWith(jasmine.any(DyFM_Error));
-  });
-
-  it('| should remove item with deleteItem', async (): Promise<void> => {
-    // Test case for lines 213-226: removeItem with deleteItem
-    // Use updateData to bypass the problematic post-process that expects an array
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    const deleteItemSpy = spyOn(handler as any, 'deleteItem').and.returnValue(Promise.resolve());
-    
-    await handler.removeItem('1');
-    
-    expect(deleteItemSpy).toHaveBeenCalledWith('1', undefined);
-    expect(handler.dataList.find(i => i._id === '1')).toBeUndefined();
-  });
-
-  it('| should remove item without deleteItem', async (): Promise<void> => {
-    // Test case for lines 213-226: removeItem without deleteItem
-    settings.deleteItem = undefined;
-    handler = new DyFM_ListCollectorDataHandler<TestCollector, TestItem>(settings);
-    // Use updateData to bypass the problematic post-process that expects an array
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    
-    await handler.removeItem('1');
-    
-    expect(handler.dataList.find(i => i._id === '1')).toBeUndefined();
-  });
-
-  it('| should clear active item when removing active item', async (): Promise<void> => {
-    // Test case for lines 223-225: clear active item when removing
-    // Use updateData to bypass the problematic post-process that expects an array
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    handler.setActiveItem(handler.dataList[0]);
-    
-    await handler.removeItem(handler.dataList[0]._id);
-    
-    handler.activeItem$.subscribe(activeItem => {
-      expect(activeItem).toBeNull();
-    });
-  });
-
-  it('| should throw error when updating item without data', async (): Promise<void> => {
-    // Test case for lines 238-246: updateItem throws error when list not found
-    handler.clear();
-    const item = { _id: '1', name: 'item1' } as TestItem;
-    
-    await expectAsync(handler.updateItem(item)).toBeRejectedWith(jasmine.any(DyFM_Error));
-  });
-
-  it('| should update item with setItem', async (): Promise<void> => {
-    // Test case for lines 247-269: updateItem with setItem
-    // Use updateData to bypass the problematic post-process that expects an array
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    const setItemSpy = spyOn(handler as any, 'setItem').and.returnValue(Promise.resolve(handler.dataList[0]));
-    
-    const updatedItem = { _id: '1', name: 'updated' } as TestItem;
-    await handler.updateItem(updatedItem);
-    
-    expect(setItemSpy).toHaveBeenCalledWith(updatedItem, undefined);
-    expect(handler.dataList.find(i => i._id === '1')?.name).toBe('updated');
-  });
-
-  it('| should update item without setItem', async (): Promise<void> => {
-    // Test case for lines 247-269: updateItem without setItem
-    settings.setItem = undefined;
-    handler = new DyFM_ListCollectorDataHandler<TestCollector, TestItem>(settings);
-    // Use updateData to bypass the problematic post-process that expects an array
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    
-    const updatedItem = { _id: '1', name: 'updated' } as TestItem;
-    await handler.updateItem(updatedItem);
-    
-    expect(handler.dataList.find(i => i._id === '1')?.name).toBe('updated');
-  });
-
-  it('| should throw error when updating non-existent item', async (): Promise<void> => {
-    // Test case for lines 260-268: updateItem throws error when item not found
-    // Use updateData to bypass the problematic post-process that expects an array
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    const nonExistentItem = { _id: '999', name: 'not found' } as TestItem;
-    
-    await expectAsync(handler.updateItem(nonExistentItem)).toBeRejected();
-  });
-
-  it('| should addItem with setItem and dontSendUpdate false', async (): Promise<void> => {
-    // Test case for lines 173-193: addItem with setItem
-    await handler.updateData({
-      _id: 'test',
-      items: [],
-    } as TestCollector);
-    const setItemSpy = spyOn(handler as any, 'setItem').and.returnValue(Promise.resolve({ _id: '3', name: 'item3' }));
-    
-    const newItem = { _id: '3', name: 'item3' } as TestItem;
-    await handler.addItem(newItem, undefined, false);
-    
-    expect(setItemSpy).toHaveBeenCalled();
-    expect(handler.activeItem_BS.value).toEqual(newItem);
-  });
-
-  it('| should addItem with setItem and dontSendUpdate true', async (): Promise<void> => {
-    // Test case for lines 173-193: addItem with dontSendUpdate
-    // When dontSendUpdate is true, setItem should NOT be called (line 185: if (this.setItem && !dontSendUpdate))
-    await handler.updateData({
-      _id: 'test',
-      items: [],
-    } as TestCollector);
-    const setItemSpy = spyOn(handler as any, 'setItem').and.returnValue(Promise.resolve({ _id: '3', name: 'item3' }));
-    
-    const newItem = { _id: '3', name: 'item3' } as TestItem;
-    await handler.addItem(newItem, undefined, true);
-    
-    expect(setItemSpy).not.toHaveBeenCalled();
-    expect(handler.activeItem_BS.value).toEqual(newItem);
-  });
-
-  it('| should addItem without setItem', async (): Promise<void> => {
-    // Test case for lines 173-193: addItem without setItem
-    settings.setItem = undefined;
-    handler = new DyFM_ListCollectorDataHandler<TestCollector, TestItem>(settings);
-    await handler.updateData({
-      _id: 'test',
-      items: [],
-    } as TestCollector);
-    
-    const newItem = { _id: '3', name: 'item3' } as TestItem;
-    await handler.addItem(newItem);
-    
-    expect(handler.dataList.find(i => i._id === '3')).toBeDefined();
-  });
-
-  it('| should addItem with collectorId', async (): Promise<void> => {
-    // Test case for lines 173-193: addItem with collectorId
-    await handler.updateData({
-      _id: 'test',
-      items: [],
-    } as TestCollector);
-    const setItemSpy = spyOn(handler as any, 'setItem').and.returnValue(Promise.resolve({ _id: '3', name: 'item3' }));
-    
-    const newItem = { _id: '3', name: 'item3' } as TestItem;
-    await handler.addItem(newItem, 'collectorId');
-    
-    expect(setItemSpy).toHaveBeenCalledWith(newItem, 'collectorId');
-  });
-
-  it('| should addItem when listKey does not exist', async (): Promise<void> => {
-    // Test case for line 183: addItem when listKey does not exist
-    await handler.updateData({
-      _id: 'test',
-    } as TestCollector);
-    
-    const newItem = { _id: '3', name: 'item3' } as TestItem;
-    await handler.addItem(newItem);
-    
-    expect(handler.dataList.find(i => i._id === '3')).toBeDefined();
-  });
-
-  it('| should removeItem when item not found', async (): Promise<void> => {
-    // Test case for lines 203-226: removeItem when index === -1
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    
-    await handler.removeItem('999');
-    
-    // Should not throw, just do nothing
-    expect(handler.dataList.length).toBe(2);
-  });
-
-  it('| should removeItem with collectorId parameter', async (): Promise<void> => {
-    // Test case for lines 203-226: removeItem with collectorId
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    const deleteItemSpy = spyOn(handler as any, 'deleteItem').and.returnValue(Promise.resolve());
-    
-    await handler.removeItem('1', 'collectorId');
-    
-    expect(deleteItemSpy).toHaveBeenCalledWith('1', 'collectorId');
-  });
-
-  it('| should removeItem with dontSendUpdate', async (): Promise<void> => {
-    // Test case for lines 203-226: removeItem with dontSendUpdate
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    settings.deleteItem = undefined;
-    handler = new DyFM_ListCollectorDataHandler<TestCollector, TestItem>(settings);
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    
-    await handler.removeItem('1', undefined, true);
-    
-    expect(handler.dataList.find(i => i._id === '1')).toBeUndefined();
-  });
-
-  it('| should updateItem with collectorId parameter', async (): Promise<void> => {
-    // Test case for lines 237-269: updateItem with collectorId
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    const setItemSpy = spyOn(handler as any, 'setItem').and.returnValue(Promise.resolve(handler.dataList[0]));
-    
-    const updatedItem = { _id: '1', name: 'updated' } as TestItem;
-    await handler.updateItem(updatedItem, 'collectorId');
-    
-    expect(setItemSpy).toHaveBeenCalledWith(updatedItem, 'collectorId');
-  });
-
-  it('| should updateItem with dontSendUpdate', async (): Promise<void> => {
-    // Test case for lines 237-269: updateItem with dontSendUpdate
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    settings.setItem = undefined;
-    handler = new DyFM_ListCollectorDataHandler<TestCollector, TestItem>(settings);
-    await handler.updateData({
-      _id: 'test',
-      items: [
-        { _id: '1', name: 'item1' } as TestItem,
-        { _id: '2', name: 'item2' } as TestItem,
-      ],
-    } as TestCollector);
-    
-    const updatedItem = { _id: '1', name: 'updated' } as TestItem;
-    await handler.updateItem(updatedItem, undefined, true);
-    
-    expect(handler.dataList.find(i => i._id === '1')?.name).toBe('updated');
-  });
-});
-

package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.ts

@@ -1,274 +0,0 @@
-import { BehaviorSubject, Observable } from 'rxjs';
-
-import { DyFM_ListCollectorDataHandler_Settings } from './data-handler-settings.control-model';
-
-import { DyFM_DataHandler } from './data-handler.control-model';
-import { DyFM_Error } from '../../../_models/control-models/error.control-model';
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-
-/**
- * A specialized data handler for managing list collections within a parent data object.
- * Extends DyFM_DataHandler to provide functionality for handling lists within a collector object.
- * 
- * @template T_ListCollectorData - The type of the parent collector data object
- * @template T_DataItem - The type of individual items in the list (must extend DyFM_Metadata)
- * @template T_DependencyData - The type of dependency data (defaults to any)
- * @template T_DataLoadBy - The type used to identify how data should be loaded (defaults to string)
- * 
- * @example
- * ```typescript
- * // Create a list collector handler for user's projects
- * const userProjectsHandler = new DyFM_ListCollectorDataHandler<User, Project>({
- *   listKey: 'projects',
- *   get: async (userId: string): Promise<User> => {
- *     return await userService.getUserWithProjects(userId);
- *   }
- * });
- * 
- * // Access the data list
- * const projects = userProjectsHandler.dataList;
- * 
- * // Add a new project
- * userProjectsHandler.addItem(newProject);
- * 
- * // Update an existing project
- * userProjectsHandler.updateItem(updatedProject);
- * 
- * // Subscribe to changes
- * userProjectsHandler.dataList$.subscribe(projects => {
- *   console.log('Projects updated:', projects);
- * });
- * ```
- */
-export class DyFM_ListCollectorDataHandler<
-  T_ListCollectorData extends DyFM_Metadata,
-  T_DataItem extends DyFM_Metadata,
-  T_DependencyData extends DyFM_Metadata = any,
-  T_DataLoadBy = string,
-> extends DyFM_DataHandler<T_ListCollectorData, T_DependencyData, T_DataLoadBy> {
-
-  /** this is only for data list handlers, 
-   * while creating arrow function for this, dont forget to use async n await! */
-  protected readonly setItem?: (item: T_DataItem, collectorId?: string) => Promise<T_DataItem>;
-  /** this is only for data list handlers, 
-   * while creating arrow function for this, dont forget to use async n await! */
-  protected readonly deleteItem?: (id: string, collectorId?: string) => Promise<void>;
-
-  protected readonly listKey: string;
-
-  /**
-   * BehaviorSubject that holds the current data list.
-   * Computed from the base data_BS BehaviorSubject, ensuring it always returns an array.
-   */
-  protected readonly dataList_BS: BehaviorSubject<T_DataItem[]>;
-
-  /**
-   * Observable that holds the current data list.
-   * Computed from the base data$ Observable, ensuring it always returns an array.
-   */
-  readonly dataList$: Observable<T_DataItem[]>;
-
-  /**
-   * BehaviorSubject that holds the currently active item.
-   */
-  readonly activeItem_BS: BehaviorSubject<T_DataItem>;
-
-  /**
-   * Observable that holds the currently active item.
-   */
-  readonly activeItem$: Observable<T_DataItem>;
-
-  /**
-   * Gets the current data value.
-   * @returns The current data value
-   */
-  override get data(): T_ListCollectorData {
-    return this.data_BS.value;
-  }
-
-  /**
-   * Gets the current data list.
-   * Alias for data getter.
-   * @returns The current array of data items
-   */
-  get dataList(): T_DataItem[] {
-    return this.dataList_BS.value;
-  }
-
-  /**
-   * Creates a new instance of DyFM_ListCollectorDataHandler.
-   * 
-   * @param set - Configuration settings for the data handler
-   * @param skipDependencyConnections - Optional flag to skip dependency connections during construction
-   */
-  constructor(
-    set: DyFM_ListCollectorDataHandler_Settings<T_ListCollectorData, T_DataItem, T_DependencyData, T_DataLoadBy>,
-    /** is in construct? 
-     * so the dependent data handlers are not added here, but in the extended class */
-    skipDependencyConnections?: boolean,
-  ) {
-    super(set, skipDependencyConnections);
-
-    this.listKey = set.listKey;
-    
-    // Initialize dataList BehaviorSubject and Observable
-    this.dataList_BS = new BehaviorSubject<T_DataItem[]>([]);
-    this.dataList$ = this.dataList_BS.asObservable();
-    
-    // Initialize activeItem BehaviorSubject and Observable
-    this.activeItem_BS = new BehaviorSubject<T_DataItem>(null);
-    this.activeItem$ = this.activeItem_BS.asObservable();
-
-    // Subscribe to data changes to update dataList
-    this.data$.subscribe(data => {
-      const dataList = Array.isArray(data?.[this.listKey]) ? data[this.listKey] : [];
-      this.dataList_BS.next(dataList);
-    });
-    
-    if (set.setItem) {
-      this.setItem = set.setItem;
-    }
-
-    if (set.deleteItem) {
-      this.deleteItem = set.deleteItem;
-    }
-
-    this.getPostProcesses.push((data: T_DataItem[]) => {
-      // check if data is an array
-      if (!Array.isArray(data) ) {
-        console.error(
-          `DYNAMO DynamoDataHandler (${this.name}) ERROR: ` +
-          `\nData is not an array!:` +
-          '\n\n', data
-        );
-        throw new Error(`Data is not an array! (${this.name})`);
-      }
-
-      return data;
-    });
-
-    if (!skipDependencyConnections) {
-      if (set.dependencyDataHandler) {
-        this.addDependencyDataHandler(set.dependencyDataHandler);
-      }
-  
-      if (set.dependentDataHandlers) {
-        this.addDependentDataHandlers(set.dependentDataHandlers, true);
-      }
-    }
-  }
-
-  override clear(dontClearDependents?: boolean): void {
-    super.clear(dontClearDependents);
-    this.activeItem_BS.next(null);
-  }
-
-  /**
-   * Adds a new item to the data list.
-   * 
-   * @param item - The item to add to the list
-   * @param collectorId - Optional collector ID for tracking
-   * @param dontSendUpdate - Optional flag to prevent sending update notification
-   */
-  async addItem(item: T_DataItem, collectorId?: string, dontSendUpdate?: boolean): Promise<void> {
-    if (!this.data) {
-      throw new DyFM_Error({
-        error: new Error(`Data not found! (${this.name})`),
-        errorCode: 'DyFM-LCDH-AI1',
-        additionalContent: {
-          listKey: this.listKey,
-        },
-      });
-    }
-    this.data[this.listKey] ??= [];
-    this.data[this.listKey].push(item);
-    if (this.setItem && !dontSendUpdate) {
-      await this.setItem(item, collectorId);
-      // dont send update because we already sent it to the setItem function
-      await this.updateData(this.data_BS.value, true);
-    } else {
-      await this.updateData(this.data_BS.value, dontSendUpdate);
-    }
-    this.activeItem_BS.next(item);
-  }
-
-  /**
-   * Removes an item from the data list.
-   * The item is identified by its _id property.
-   * 
-   * @param id - The id of the item to remove from the list
-   * @param collectorId - Optional collector ID for tracking
-   * @param dontSendUpdate - Optional flag to prevent sending update notification
-   */
-  async removeItem(id: string, collectorId?: string, dontSendUpdate?: boolean): Promise<void> {
-    if (!this.data?.[this.listKey]?.length) {
-      throw new DyFM_Error({
-        error: new Error(`List not found! (${this.name})`),
-        errorCode: 'DyFM-LCDH-RI1',
-        additionalContent: {
-          listKey: this.listKey,
-        },
-      });
-    }
-    const index = this.data[this.listKey].findIndex(i => i._id === id);
-    if (index !== -1) {
-      this.data[this.listKey].splice(index, 1);
-      if (this.deleteItem) {
-        await this.deleteItem(id, collectorId);
-        await this.updateData(this.data_BS.value, true);
-      } else {
-        await this.updateData(this.data_BS.value, dontSendUpdate);
-      }
-    }
-    if (this.activeItem_BS.value?._id === id) {
-      this.activeItem_BS.next(null);
-    }
-  }
-
-  /**
-   * Updates an existing item in the data list.
-   * The item is identified by its _id property.
-   * 
-   * @param item - The updated item
-   * @param collectorId - Optional collector ID for tracking
-   * @param dontSendUpdate - Optional flag to prevent sending update notification
-   * @throws Error if the item is not found in the list
-   */
-  async updateItem(item: T_DataItem, collectorId?: string, dontSendUpdate?: boolean): Promise<void> {
-    if (!this.data?.[this.listKey]?.length) {
-      throw new DyFM_Error({
-        error: new Error(`List not found! (${this.name})`),
-        errorCode: 'DyFM-LCDH-UI0',
-        additionalContent: {
-          listKey: this.listKey,
-        },
-      });
-    }
-    // check if item is in the list
-    const index = this.data[this.listKey].findIndex(i => i._id === item._id);
-    if (index !== -1) {
-      // update the item
-      this.data[this.listKey][index] = item;
-      if (this.setItem) {
-        // send update to API
-        await this.setItem(item, collectorId);
-        await this.updateData(this.data_BS.value, true);
-      } else {
-        // send update to API
-        await this.updateData(this.data_BS.value, dontSendUpdate);
-      }
-    } else {
-      throw new DyFM_Error({
-        error: new Error(`Item not found! (${this.name})`),
-        errorCode: 'DyFM-LCDH-UI1',
-        additionalContent: {
-          item: item,
-        },
-      });
-    }
-  }
-
-  setActiveItem(item: T_DataItem): void {
-    this.activeItem_BS.next(item);
-  }
-}

package/src/_modules/data-handler/index.ts

@@ -1,6 +0,0 @@
-// MODELS
-export * from './_models/data-handler.control-model';
-export * from './_models/data-handler-settings.control-model';
-export * from './_models/data-list-handler.control-model';
-export * from './_models/data-search-handler.control-model';
-export * from './_models/list-collector-data-handler.control-model';