@futdevpro/fsm-dynamo 1.14.11 → 1.14.13

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

@@ -0,0 +1,325 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_DataSearchHandler = void 0;
+const rxjs_1 = require("rxjs");
+const data_list_handler_control_model_1 = require("./data-list-handler.control-model");
+const object_util_1 = require("../../../_collections/utils/object.util");
+/**
+ * A specialized data handler for managing searchable data with pagination and caching.
+ * Extends DyFM_DataListHandler to provide additional functionality for handling search results.
+ *
+ * @template T_Data - The type of data items in the search results
+ * @template T_DataLoadBy - The type of search query (must extend DyFM_SearchQuery)
+ * @template T_Result - The type of search result (must extend DyFM_SearchResult)
+ * @template T_DependencyData - The type of dependency data (defaults to any)
+ *
+ * @example
+ * ```typescript
+ * // Create a search handler for flow runs
+ * const flowRunsHandler = new DyFM_DataSearchHandler<FlowRun_Preview>({
+ *   name: 'myRuns',
+ *   get: async (query?: DyFM_SearchQuery<FlowRun>): Promise<DyFM_SearchResult<FlowRun_Preview>> => {
+ *     return await flowRunService.searchFlowRuns(query);
+ *   },
+ *   defaultQuery: {
+ *     filterBy: { userId: currentUserId },
+ *     pageSize: 20
+ *   },
+ *   queryUpdateDebounceTime: 500
+ * });
+ *
+ * // Update search query
+ * flowRunsHandler.updateQuery({
+ *   page: 0,
+ *   pageSize: 10,
+ *   filterBy: { status: 'completed' }
+ * });
+ *
+ * // Access search results
+ * const runs = flowRunsHandler.dataList;
+ *
+ * // Get total items count
+ * const totalItems = flowRunsHandler.totalItems;
+ * ```
+ */
+class DyFM_DataSearchHandler extends data_list_handler_control_model_1.DyFM_DataListHandler {
+    /**
+     * Subject for handling fresh search queries with debouncing.
+     * Used internally to manage query updates.
+     */
+    _freshQuery_S = new rxjs_1.Subject();
+    /**
+     * Cache of search results for different pages.
+     * Helps optimize performance by storing previously loaded results.
+     */
+    cache = [];
+    /**
+     * Override of the get method to handle search queries.
+     * Must be implemented to fetch search results from the data source.
+     */
+    // this is redundant, because the base class has the get method and it uses Generic type
+    /* override get: (query?: T_DataLoadBy) => Promise<T_Result>; */
+    /**
+     * Maximum number of cached pages to keep in memory.
+     * Default is 5 pages.
+     */
+    cacheSize = 5;
+    /**
+     * Default number of items per page.
+     * Used when no pageSize is specified in the query.
+     */
+    defaultPageSize = 10;
+    /**
+     * Default search query to use when no query is provided.
+     * Can include default filters, sorting, and pagination settings.
+     */
+    get defaultQuery() {
+        return object_util_1.DyFM_Object.clone(this._defaultQuery);
+    }
+    _defaultQuery;
+    /**
+     * Total number of items available in the search results.
+     * Updated after each successful search.
+     */
+    totalItems;
+    /**
+     * Debounce time in milliseconds for query updates.
+     * Helps prevent too frequent API calls when query changes rapidly.
+     */
+    queryUpdateDebounceTime = 500;
+    /**
+     * Whether to perform initial search when handler is created.
+     * If true, will use defaultQuery for initial search.
+     */
+    searchOnInit = true;
+    /**
+     * Creates a new instance of DyFM_DataSearchHandler.
+     *
+     * @param set - Configuration settings for the search handler
+     */
+    constructor(set) {
+        super({
+            ...set,
+            noId: true,
+        });
+        if (set.queryUpdateDebounceTime) {
+            this.queryUpdateDebounceTime = set.queryUpdateDebounceTime;
+        }
+        if (set.defaultQuery) {
+            this._defaultQuery = set.defaultQuery;
+        }
+        // 3
+        // Add post-processing for search results
+        this.getPostProcesses.unshift((searchResult, loadedBy) => {
+            console.warn('WTF DyFM_Search_DataHandler getPostProcess', searchResult, this.lastLoadedBy);
+            this.cache = this.cache.filter((c) => c.loadPageSize !== this.lastLoadedBy?.pageSize);
+            if (this.cache.length >= this.cacheSize) {
+                this.cache.shift();
+            }
+            this.cache.push({
+                page: this.lastLoadedBy?.page,
+                loadPageSize: this.lastLoadedBy?.pageSize,
+                data: searchResult.results,
+            });
+            this.totalItems = searchResult.totalItems;
+            return searchResult.results;
+        });
+        // 2
+        // Set up query update handling with debouncing
+        this._freshQuery_S.pipe((0, rxjs_1.debounceTime)(this.queryUpdateDebounceTime)).subscribe((query) => {
+            console.warn('asd', query, this.lastLoadedBy);
+            if (!query) {
+                if (!this._defaultQuery) {
+                    this.reloadData();
+                    return;
+                }
+                query = this.defaultQuery;
+            }
+            if (!query.page) {
+                query.page = 0;
+            }
+            if (!query.pageSize) {
+                query.pageSize = this.defaultPageSize;
+            }
+            if (this._defaultQuery?.filterBy) {
+                if (!query.filterBy) {
+                    query.filterBy = {};
+                }
+                for (const key in this._defaultQuery.filterBy) {
+                    if (!query.filterBy[key] && query.filterBy[key] !== null) {
+                        query.filterBy[key] = this._defaultQuery.filterBy[key];
+                    }
+                }
+            }
+            if (this._defaultQuery?.sortBy) {
+                if (!query.sortBy) {
+                    query.sortBy = [];
+                }
+                if (!query.sortBy.length) {
+                    query.sortBy = object_util_1.DyFM_Object.clone(this._defaultQuery.sortBy);
+                }
+            }
+            this.reloadData(query);
+        });
+        if (this.searchOnInit) {
+            this._freshQuery_S.next(this.defaultQuery);
+        }
+    }
+    // 1
+    /**
+     * Updates the search query and triggers a new search.
+     * The search will be debounced according to queryUpdateDebounceTime.
+     *
+     * @param query - The new search query to use
+     */
+    updateQuery(query) {
+        this._freshQuery_S.next(query);
+    }
+    /**
+     * Override to prevent adding dependent data handlers.
+     * Search handlers cannot have dependencies.
+     *
+     * @throws Error - Always throws as search handlers cannot have dependencies
+     */
+    addDependentDataHandlers(dependentDataHandlers) {
+        throw new Error('Cannot add dependent data handlers to a search data handler');
+    }
+    /**
+     * Filters the current search query
+     *
+     * @param filterBy - The filter to apply to the current search query
+     */
+    filter(filterBy) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.filterBy = filterBy;
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Adds a filter to the current search query
+     *
+     * @param filterBy - The filter to add to the current search query
+     */
+    addFiler(filterBy) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            Object.assign(query.filterBy, filterBy);
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Removes a filter from the current search query
+     *
+     * @param keys - The keys of the filter to remove from the current search query
+     */
+    removeFilter(keys) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            keys.forEach((key) => {
+                delete query.filterBy[key];
+            });
+            this.reloadData(query);
+        }
+    }
+    clearFilters() {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.filterBy = {};
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Sorts the current search query
+     *
+     * @param sortBy - The sort to apply to the current search query
+     */
+    sort(sortBy) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.sortBy = sortBy;
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Adds a sort to the current search query
+     *
+     * @param sortBy - The sort to add to the current search query
+     */
+    addSort(sortBy) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.sortBy.push(...sortBy);
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Removes a sort from the current search query
+     *
+     * @param keys - The keys of the sort to remove from the current search query
+     */
+    removeSort(keys) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.sortBy = query.sortBy.filter((sort) => !keys.includes(sort.key));
+            this.reloadData(query);
+        }
+    }
+    clearSorts() {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.sortBy = [];
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Sets the page of the current search query
+     *
+     * @param page - The page to set to the current search query
+     */
+    page(page, pageSize) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.page = page;
+            if (pageSize) {
+                query.pageSize = pageSize;
+            }
+            this.reloadData(query);
+        }
+    }
+    /**
+     * Sets the page size of the current search query
+     *
+     * @param pageSize - The page size to set to the current search query
+     */
+    pageSize(pageSize) {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.pageSize = pageSize;
+            this.reloadData(query);
+        }
+    }
+    resetPage() {
+        const query = this.lastLoadedBy ?? this.defaultQuery;
+        if (query) {
+            query.page = 0;
+            query.pageSize = this.defaultPageSize;
+            this.reloadData(query);
+        }
+    }
+    resetQuery() {
+        const query = this.defaultQuery;
+        if (query) {
+            this.reloadData(query);
+        }
+        else {
+            query.filterBy = {};
+            query.sortBy = [];
+            query.page = 0;
+            query.pageSize = this.defaultPageSize;
+            this.reloadData(query);
+        }
+    }
+}
+exports.DyFM_DataSearchHandler = DyFM_DataSearchHandler;
+//# sourceMappingURL=data-search-handler.control-model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-search-handler.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/data-handler/_models/data-search-handler.control-model.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,116 @@
+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_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 declare 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
+     */
+    get data(): T_ListCollectorData;
+    /**
+     * Gets the current data list.
+     * Alias for data getter.
+     * @returns The current array of data items
+     */
+    get dataList(): T_DataItem[];
+    /**
+     * 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);
+    clear(dontClearDependents?: boolean): void;
+    /**
+     * 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
+     */
+    addItem(item: T_DataItem, collectorId?: string, dontSendUpdate?: boolean): Promise<void>;
+    /**
+     * 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
+     */
+    removeItem(id: string, collectorId?: string, dontSendUpdate?: boolean): Promise<void>;
+    /**
+     * 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
+     */
+    updateItem(item: T_DataItem, collectorId?: string, dontSendUpdate?: boolean): Promise<void>;
+    setActiveItem(item: T_DataItem): void;
+}
+//# sourceMappingURL=list-collector-data-handler.control-model.d.ts.map

package/build/_modules/data-handler/_models/list-collector-data-handler.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-collector-data-handler.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/data-handler/_models/list-collector-data-handler.control-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEnD,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAE/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,kDAAkD,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,6BAA6B,CACxC,mBAAmB,SAAS,aAAa,EACzC,UAAU,SAAS,aAAa,EAChC,gBAAgB,SAAS,aAAa,GAAG,GAAG,EAC5C,YAAY,GAAG,MAAM,CACrB,SAAQ,gBAAgB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,CAAC;IAE7E;mFAC+E;IAC/E,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7F;mFAC+E;IAC/E,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEnC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IAEpD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAE7C;;;OAGG;IACH,IAAa,IAAI,IAAI,mBAAmB,CAEvC;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,UAAU,EAAE,CAE3B;IAED;;;;;OAKG;gBAED,GAAG,EAAE,sCAAsC,CAAC,mBAAmB,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,CAAC;IAC5G;sFACkF;IAClF,yBAAyB,CAAC,EAAE,OAAO;IAqD5B,KAAK,CAAC,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI;IAKnD;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9F;;;;;;;OAOG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3F;;;;;;;;OAQG;IACG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjG,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;CAGtC"}