@futdevpro/fsm-dynamo 1.16.39 → 1.16.40

package/build/_modules/data-handler/_models/data-list-handler.control-model.js

@@ -1,224 +1,224 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_DataListHandler = void 0;
-const rxjs_1 = require("rxjs");
-const data_handler_control_model_1 = require("./data-handler.control-model");
-const error_control_model_1 = require("../../../_models/control-models/error.control-model");
-const log_util_1 = require("../../../_collections/utils/log.util");
-/**
- * A specialized data handler for managing arrays of data items.
- * Extends DyFM_DataHandler to provide additional functionality for handling lists of data.
- *
- * @template T_DataList - The type of the data list (must be an array of T_DataItem)
- * @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)
- * @template T_DataItem - The type of individual items in the list (must extend DyFM_Metadata)
- *
- * @example
- * ```typescript
- * // Create a data list handler for user messages
- * const messagesHandler = new DyFM_DataListHandler<UserMessage[]>({
- *   get: async (userId: string): Promise<UserMessage[]> => {
- *     return await userApiService.getUserMessages(userId, 0, 100);
- *   }
- * });
- *
- * // Access the data list
- * const messages = messagesHandler.dataList;
- *
- * // Add a new message
- * messagesHandler.addItem(newMessage);
- *
- * // Update an existing message
- * messagesHandler.updateItem(updatedMessage);
- *
- * // Subscribe to changes
- * messagesHandler.dataList$.subscribe(messages => {
- *   console.log('Messages updated:', messages);
- * });
- * ```
- */
-class DyFM_DataListHandler extends data_handler_control_model_1.DyFM_DataHandler {
-    setItem;
-    deleteItem;
-    /**
-     * BehaviorSubject that holds the current data list.
-     * Computed from the base data_BS BehaviorSubject, ensuring it always returns an array.
-     */
-    dataList_BS;
-    /**
-     * Observable that holds the current data list.
-     * Computed from the base data$ Observable, ensuring it always returns an array.
-     */
-    dataList$;
-    /**
-     * BehaviorSubject that holds the currently active item.
-     */
-    activeItem_BS;
-    /**
-     * Observable that holds the currently active item.
-     */
-    activeItem$;
-    /**
-     * Gets the current data list.
-     * @returns The current array of data items
-     */
-    get data() {
-        return this.dataList_BS.value;
-    }
-    /**
-     * Gets the current data list.
-     * Alias for data getter.
-     * @returns The current array of data items
-     */
-    get dataList() {
-        return this.dataList_BS.value;
-    }
-    /**
-     * Creates a new instance of DyFM_DataListHandler.
-     *
-     * @param set - Configuration settings for the data handler
-     * @param skipDependencyConnections - Optional flag to skip dependency connections during construction
-     */
-    constructor(set, 
-    /** is in construct?
-     * so the dependent data handlers are not added here, but in the extended class */
-    skipDependencyConnections) {
-        super(set, skipDependencyConnections);
-        // Initialize dataList BehaviorSubject and Observable
-        this.dataList_BS = new rxjs_1.BehaviorSubject([]);
-        this.dataList$ = this.dataList_BS.asObservable();
-        // Initialize activeItem BehaviorSubject and Observable
-        this.activeItem_BS = new rxjs_1.BehaviorSubject(null);
-        this.activeItem$ = this.activeItem_BS.asObservable();
-        // Subscribe to data changes to update dataList
-        this.data$.subscribe(data => {
-            const dataList = Array.isArray(data) ? data : [];
-            this.dataList_BS.next(dataList);
-        });
-        if (set.setItem) {
-            this.setItem = set.setItem;
-        }
-        if (set.deleteItem) {
-            this.deleteItem = set.deleteItem;
-        }
-        this.getPostProcesses.push((data) => {
-            // check if data is an array
-            if (!Array.isArray(data)) {
-                console.error(`DYNAMO DataListHandler (${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);
-            }
-        }
-    }
-    async reloadData(loadBy) {
-        try {
-            const setActiveItem = !this.activeItem_BS.value || this.activeItem_BS.value?._id !== loadBy;
-            const dataList = await super.reloadData(loadBy);
-            if (setActiveItem && dataList.length > 0) {
-                this.setActiveItem(dataList[0]);
-            }
-            return dataList;
-        }
-        catch (error) {
-            log_util_1.DyFM_Log.error(`Error reloading DyFM_DataListHandler (${this.name}):`, error);
-            throw error;
-        }
-    }
-    clear(dontClearDependents) {
-        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 updateBy - Optional parameter for update tracking
-     * @param dontSendUpdate - Optional flag to prevent sending update notification
-     */
-    async addItem(item, updateBy, dontSendUpdate) {
-        const currentData = this.data;
-        currentData.push(item);
-        if (this.setItem && !dontSendUpdate) {
-            await this.setItem(item, updateBy);
-            // dont send update because we already sent it to the setItem function
-            await this.updateData(this.dataList_BS.value, true);
-        }
-        else {
-            await this.updateData(this.dataList_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 updateBy - Optional parameter for update tracking
-     * @param dontSendUpdate - Optional flag to prevent sending update notification
-     */
-    async removeItem(id, updateBy, dontSendUpdate) {
-        const currentData = this.data;
-        const index = currentData.findIndex(i => i._id === id);
-        if (index !== -1) {
-            currentData.splice(index, 1);
-            if (this.deleteItem) {
-                await this.deleteItem(id, updateBy);
-                await this.updateData(this.dataList_BS.value, true);
-            }
-            else {
-                await this.updateData(this.dataList_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 updateBy - Optional parameter for update tracking
-     * @param dontSendUpdate - Optional flag to prevent sending update notification
-     * @throws Error if the item is not found in the list
-     */
-    async updateItem(item, updateBy, dontSendUpdate) {
-        const currentData = this.data;
-        const index = currentData.findIndex(i => i._id === item._id);
-        if (index !== -1) {
-            currentData[index] = item;
-            if (this.setItem) {
-                await this.setItem(item, updateBy);
-                await this.updateData(this.dataList_BS.value, true);
-            }
-            else {
-                await this.updateData(this.dataList_BS.value, dontSendUpdate);
-            }
-        }
-        else {
-            throw new error_control_model_1.DyFM_Error({
-                error: new Error(`Item not found! (${this.name})`),
-                errorCode: 'DyFM-DLH-UI1',
-                additionalContent: {
-                    item: item,
-                },
-            });
-        }
-    }
-    setActiveItem(item) {
-        this.activeItem_BS.next(item);
-    }
-}
-exports.DyFM_DataListHandler = DyFM_DataListHandler;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_DataListHandler = void 0;
+const rxjs_1 = require("rxjs");
+const data_handler_control_model_1 = require("./data-handler.control-model");
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+const log_util_1 = require("../../../_collections/utils/log.util");
+/**
+ * A specialized data handler for managing arrays of data items.
+ * Extends DyFM_DataHandler to provide additional functionality for handling lists of data.
+ *
+ * @template T_DataList - The type of the data list (must be an array of T_DataItem)
+ * @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)
+ * @template T_DataItem - The type of individual items in the list (must extend DyFM_Metadata)
+ *
+ * @example
+ * ```typescript
+ * // Create a data list handler for user messages
+ * const messagesHandler = new DyFM_DataListHandler<UserMessage[]>({
+ *   get: async (userId: string): Promise<UserMessage[]> => {
+ *     return await userApiService.getUserMessages(userId, 0, 100);
+ *   }
+ * });
+ *
+ * // Access the data list
+ * const messages = messagesHandler.dataList;
+ *
+ * // Add a new message
+ * messagesHandler.addItem(newMessage);
+ *
+ * // Update an existing message
+ * messagesHandler.updateItem(updatedMessage);
+ *
+ * // Subscribe to changes
+ * messagesHandler.dataList$.subscribe(messages => {
+ *   console.log('Messages updated:', messages);
+ * });
+ * ```
+ */
+class DyFM_DataListHandler extends data_handler_control_model_1.DyFM_DataHandler {
+    setItem;
+    deleteItem;
+    /**
+     * BehaviorSubject that holds the current data list.
+     * Computed from the base data_BS BehaviorSubject, ensuring it always returns an array.
+     */
+    dataList_BS;
+    /**
+     * Observable that holds the current data list.
+     * Computed from the base data$ Observable, ensuring it always returns an array.
+     */
+    dataList$;
+    /**
+     * BehaviorSubject that holds the currently active item.
+     */
+    activeItem_BS;
+    /**
+     * Observable that holds the currently active item.
+     */
+    activeItem$;
+    /**
+     * Gets the current data list.
+     * @returns The current array of data items
+     */
+    get data() {
+        return this.dataList_BS.value;
+    }
+    /**
+     * Gets the current data list.
+     * Alias for data getter.
+     * @returns The current array of data items
+     */
+    get dataList() {
+        return this.dataList_BS.value;
+    }
+    /**
+     * Creates a new instance of DyFM_DataListHandler.
+     *
+     * @param set - Configuration settings for the data handler
+     * @param skipDependencyConnections - Optional flag to skip dependency connections during construction
+     */
+    constructor(set, 
+    /** is in construct?
+     * so the dependent data handlers are not added here, but in the extended class */
+    skipDependencyConnections) {
+        super(set, skipDependencyConnections);
+        // Initialize dataList BehaviorSubject and Observable
+        this.dataList_BS = new rxjs_1.BehaviorSubject([]);
+        this.dataList$ = this.dataList_BS.asObservable();
+        // Initialize activeItem BehaviorSubject and Observable
+        this.activeItem_BS = new rxjs_1.BehaviorSubject(null);
+        this.activeItem$ = this.activeItem_BS.asObservable();
+        // Subscribe to data changes to update dataList
+        this.data$.subscribe(data => {
+            const dataList = Array.isArray(data) ? data : [];
+            this.dataList_BS.next(dataList);
+        });
+        if (set.setItem) {
+            this.setItem = set.setItem;
+        }
+        if (set.deleteItem) {
+            this.deleteItem = set.deleteItem;
+        }
+        this.getPostProcesses.push((data) => {
+            // check if data is an array
+            if (!Array.isArray(data)) {
+                console.error(`DYNAMO DataListHandler (${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);
+            }
+        }
+    }
+    async reloadData(loadBy) {
+        try {
+            const setActiveItem = !this.activeItem_BS.value || this.activeItem_BS.value?._id !== loadBy;
+            const dataList = await super.reloadData(loadBy);
+            if (setActiveItem && dataList.length > 0) {
+                this.setActiveItem(dataList[0]);
+            }
+            return dataList;
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`Error reloading DyFM_DataListHandler (${this.name}):`, error);
+            throw error;
+        }
+    }
+    clear(dontClearDependents) {
+        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 updateBy - Optional parameter for update tracking
+     * @param dontSendUpdate - Optional flag to prevent sending update notification
+     */
+    async addItem(item, updateBy, dontSendUpdate) {
+        const currentData = this.data;
+        currentData.push(item);
+        if (this.setItem && !dontSendUpdate) {
+            await this.setItem(item, updateBy);
+            // dont send update because we already sent it to the setItem function
+            await this.updateData(this.dataList_BS.value, true);
+        }
+        else {
+            await this.updateData(this.dataList_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 updateBy - Optional parameter for update tracking
+     * @param dontSendUpdate - Optional flag to prevent sending update notification
+     */
+    async removeItem(id, updateBy, dontSendUpdate) {
+        const currentData = this.data;
+        const index = currentData.findIndex(i => i._id === id);
+        if (index !== -1) {
+            currentData.splice(index, 1);
+            if (this.deleteItem) {
+                await this.deleteItem(id, updateBy);
+                await this.updateData(this.dataList_BS.value, true);
+            }
+            else {
+                await this.updateData(this.dataList_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 updateBy - Optional parameter for update tracking
+     * @param dontSendUpdate - Optional flag to prevent sending update notification
+     * @throws Error if the item is not found in the list
+     */
+    async updateItem(item, updateBy, dontSendUpdate) {
+        const currentData = this.data;
+        const index = currentData.findIndex(i => i._id === item._id);
+        if (index !== -1) {
+            currentData[index] = item;
+            if (this.setItem) {
+                await this.setItem(item, updateBy);
+                await this.updateData(this.dataList_BS.value, true);
+            }
+            else {
+                await this.updateData(this.dataList_BS.value, dontSendUpdate);
+            }
+        }
+        else {
+            throw new error_control_model_1.DyFM_Error({
+                error: new Error(`Item not found! (${this.name})`),
+                errorCode: 'DyFM-DLH-UI1',
+                additionalContent: {
+                    item: item,
+                },
+            });
+        }
+    }
+    setActiveItem(item) {
+        this.activeItem_BS.next(item);
+    }
+}
+exports.DyFM_DataListHandler = DyFM_DataListHandler;
 //# sourceMappingURL=data-list-handler.control-model.js.map