@futdevpro/fsm-dynamo 1.20.92 → 1.20.93

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

@@ -0,0 +1,386 @@
+import { BehaviorSubject } from 'rxjs';
+import { DyFM_Log } from '../../..';
+/**
+ * DynamoDataHandler is used to create application wide data handling
+ * used to create subscribeAble data handler
+ *
+ * this implements data reload function that uses predefined apiService,
+ * using previous or given id,
+ * prevents multiple load calls and triggers data change subscriptions when done
+ *
+ * load post processes can be implemented to ensure special conditions
+ *
+ * @example
+ * personalInformationDH = new DynamoDataHandler<PersonalInformation>({
+ *   apiService: this.accountApiService,
+ *   getDataFunctionName: 'getPersonalInformation',
+ * });
+ */
+export class DyFM_DataHandler_ControlModel {
+    name;
+    /**
+     * BehaviorSubject that holds the current data value.
+     * This is the source of truth for data in DyFM.
+     */
+    data_BS;
+    /**
+     * Observable that emits the current data value.
+     * Derived from the BehaviorSubject.
+     */
+    data$;
+    /**
+     * BehaviorSubject that indicates whether the data has been loaded.
+     * True when data is loaded, false otherwise.
+     */
+    loaded_BS;
+    /**
+     * Observable that indicates whether the data has been loaded.
+     */
+    loaded$;
+    /**
+     * BehaviorSubject that tracks the current loading operation.
+     * Contains information about the ongoing data load operation or false if no load is in progress.
+     */
+    loadInProgress_BS;
+    /**
+     * Observable that tracks the current loading operation.
+     */
+    loadInProgress$;
+    /**
+     * last loaded by will work properly only if you use the Dynamo form of "_id" for loading
+     */
+    lastLoadedBy; // for lists
+    defaultLoadBy; // for lists
+    /** this will handle the data loading from the api */
+    get;
+    /** this will handle the data setting to the data handler */
+    set;
+    /** this will handle the data patching to the data handler */
+    /* patch: (data: T) => Promise<T>; */
+    // TODO
+    /* directApiSetup: any; */
+    /**
+     * post processes will be called as pipes after data is loaded by get function,
+     * but before data is set to data handler by data_$.set (after get, before Signal triggers)
+     */
+    getPostProcesses = [];
+    /** @deprecated Use isIdOmitted; noId remains the serialized compatibility key. */
+    noId;
+    waitsOnLoad = [];
+    dependentDataHandlers = [];
+    /** @deprecated Use isDebugLogEnabled; debugLog remains the serialized compatibility key. */
+    debugLog;
+    /**
+     * DynamoDataHandler
+     * @param apiService any service can be used as apiService
+     * as long as the function, you pass in getDataFunctionName exists,
+     * uses (or not uses an ID as input) and returns the data as Promise<Type>
+     * @param getDataFunctionName the function name on the apiService,
+     * that will be used as get api call
+     *
+     * @param successfulReloadCallBack you can create direct callback for successful reloads
+     * by passing it here
+     *
+     * @param getPostPreprocessLoad post processes can be implemented to ensure special conditions on data
+     *
+     * @param defaultValue you can set default value that will be used before any load
+     * @param noId this flag needs to be true, when using api function without id
+     *
+     * @example
+     * personalInformationDH = new DynamoDataHandler<PersonalInformation>({
+     *   apiService: this.accountApiService,
+     *   getDataFunctionName: 'getPersonalInformation',
+     * });
+     */
+    constructor(set, 
+    /** is in construct?
+     * so the dependent data handlers are not added here, but in the extended class */
+    skipDependencyConnections) {
+        // TODO: + TRYTOGETTYPE(this.data);
+        if (!set.name) {
+            set.name = 'Unnamed DataHandler ' + (+new Date());
+            DyFM_Log.warn(`DYNAMO DH.constructor (${this.name}) WARN: ` +
+                `\n  Name is not set!`, '\n\n', new Error());
+        }
+        this.name = set.name;
+        this.debugLog = set?.debugLog;
+        // Initialize BehaviorSubjects
+        this.data_BS = new BehaviorSubject(set.defaultValue);
+        this.data$ = this.data_BS.asObservable();
+        this.loaded_BS = new BehaviorSubject(false);
+        this.loaded$ = this.loaded_BS.asObservable();
+        this.loadInProgress_BS = new BehaviorSubject(false);
+        this.loadInProgress$ = this.loadInProgress_BS.asObservable();
+        if (set.get) {
+            this.get = set.get;
+        }
+        if (set.set) {
+            this.set = set.set;
+        }
+        this.noId = !!set.noId;
+        if (set.defaultLoadBy) {
+            this.defaultLoadBy = set.defaultLoadBy;
+        }
+        if (!skipDependencyConnections) {
+            if (set.dependencyDataHandler) {
+                this.addDependencyDataHandler(set.dependencyDataHandler);
+            }
+            if (set.dependentDataHandlers) {
+                this.addDependentDataHandlers(set.dependentDataHandlers, true);
+            }
+        }
+        if (set.getPostProcess) {
+            this.getPostProcesses.push(set.getPostProcess);
+        }
+    }
+    addDependencyDataHandler(dependencyDataHandler) {
+        try {
+            if (!dependencyDataHandler) {
+                throw new Error(`DYNAMO DH.addDependencyDataHandler (${this.name}) ERROR: ` +
+                    `\n  Dependent DataHandler is null or undefined! (${this.name})`);
+            }
+            if (!(dependencyDataHandler instanceof DyFM_DataHandler_ControlModel)) {
+                throw new Error(`DYNAMO DH.addDependencyDataHandler (${this.name}) ERROR: ` +
+                    `\n  Dependent DataHandler is not instance of DyFM_DataHandler_ControlModel! (${this.name})`);
+            }
+            dependencyDataHandler.addDependentDataHandlers([this]);
+        }
+        catch (error) {
+            console.error(`DYNAMO DH.addDependencyDataHandler (${this.name}) ERROR: ` +
+                `\n  Failed to add dependency data handler! ("${this.name}": "${this.constructor.name}")`, '\n\n', error, '\n\n', new Error());
+        }
+    }
+    addDependentDataHandlers(dependentDataHandlers, isInConstruct) {
+        dependentDataHandlers.forEach((dependent_DH) => {
+            if (!dependent_DH) {
+                throw new Error(`DYNAMO DH.addDependentDataHandlers (${this.name}) ERROR: ` +
+                    `\n  Dependent DataHandler is null or undefined! (${this.name})`);
+            }
+            if (!(dependent_DH instanceof DyFM_DataHandler_ControlModel)) {
+                throw new Error(`DYNAMO DH.addDependentDataHandlers (${this.name}) ERROR: ` +
+                    `\n  Dependent DataHandler is not instance of DyFM_DataHandler_ControlModel! (${this.name})`);
+            }
+            if (dependent_DH.name === this.name) {
+                throw new Error(`DYNAMO DH.addDependentDataHandlers (${this.name}) ERROR: ` +
+                    `\n  Dependent DataHandler has the same name as the current DataHandler! (${this.name})`);
+            }
+            if (!dependent_DH.data_BS) {
+                throw new Error(`DYNAMO DH.addDependentDataHandlers (${this.name}) ERROR: ` +
+                    `\n  Dependent DataHandler has not been set up yet! ` +
+                    `(this: "${this.name}", dependent: "${dependent_DH.name}")` +
+                    `\n    Try the opposite direction of dependency!\n\n`);
+            }
+            if (!dependentDataHandlers.includes(dependent_DH)) {
+                dependentDataHandlers.push(dependent_DH);
+            }
+            if (this.debugLog) {
+                this.getPostProcesses.push(async (newData) => {
+                    console.log(`DYNAMO DH.addDependentDataHandlers (${this.name}) DEBUG:` +
+                        `\nDataHandler triggering dependent dataHandler (${dependent_DH.name}) to reload... ` +
+                        `\n(using id: ${newData && newData._id ? newData._id : ''})`);
+                    return newData;
+                });
+            }
+            this.getPostProcesses.push(async (newData) => {
+                if (newData && newData._id && newData._id !== dependent_DH.lastLoadedBy) {
+                    dependent_DH.reloadData(newData._id);
+                }
+                else if (!newData) {
+                    dependent_DH.clear();
+                }
+                return newData;
+            });
+            if (!isInConstruct && this.data) {
+                dependent_DH.reloadData(this.data._id);
+            }
+        });
+    }
+    /**
+     * reloads data on DynamoDataHandler using predefined apiservice,
+     * using previous or given id,
+     * prevents multiple load calls and triggers data change subscriptions when done
+     * @param loadBy previous or given id (or can be disabled trough setup by: { noId: true })
+     * @returns the data as Promise<T>, finishes when the call ends (throws error on fail)
+     */
+    async reloadData(loadBy, opts) {
+        try {
+            const loadInProgress = this.loadInProgress_BS.value;
+            const useLoadBy = loadBy ??
+                this.data?._id ??
+                this.lastLoadedBy ??
+                this.defaultLoadBy;
+            if (!useLoadBy && !this.noId) {
+                // BFR-MASTERPROMPTER-024: a getData not-loaded-yet útján (silentMissingId) a console.error
+                // kimarad — a boot-race ID-hiány nem caller-hiba; a throw változatlanul megy.
+                if (!opts?.silentMissingId) {
+                    console.error(`DynamoERROR (DH.reloadData): Missing ID! (${this.name})`, this.data, '\n\n', new Error());
+                }
+                throw new Error(`DynamoERROR (DH.reloadData): Missing ID! (${this.name})`);
+            }
+            if (loadInProgress && loadInProgress.loadBy === useLoadBy) {
+                if (this.debugLog) {
+                    console.log(`DYNAMO DH.reloadData (${this.name}) DEBUG:` +
+                        `\n  DataHandler reloadData... (using id: ${useLoadBy})` +
+                        `\n  DataHandler is already loading data... (awaiting it)`);
+                }
+                // BFR-MASTERPROMPTER-074: a second call for the SAME key awaits the load in flight. Returning `this.data`
+                // here handed the caller the not-yet-loaded (undefined / stale) value - measured: MP "Create Flow" during the
+                // first `loadMyFlows()` got `undefined` and crashed on `myFlows.find`. Same contract as `getData()`.
+                return await loadInProgress.progress;
+            }
+            if (this.debugLog) {
+                console.log(`DYNAMO DH.reloadData (${this.name}) DEBUG:` +
+                    `\n  DataHandler reloadData... (using id: ${useLoadBy})`);
+            }
+            const loadProgress = this.doReloadDataBy(useLoadBy);
+            this.loadInProgress_BS.next({
+                loadBy: useLoadBy,
+                progress: loadProgress
+            });
+            // clears the in-flight marker on BOTH outcomes; `.finally()` returned a derived promise that rejected unhandled on
+            // every failed load (an "Uncaught (in promise)" beside the real error) — the caller already receives the error
+            const clearInProgress = () => {
+                this.loadInProgress_BS.next(false);
+            };
+            loadProgress.then(clearInProgress, clearInProgress);
+            return await loadProgress;
+        }
+        catch (error) {
+            this.loadInProgress_BS.next(false);
+            this.loaded_BS.next(false);
+            if (!error?.error?.handled) {
+                console.error(`DYNAMO DH.reloadData (${this.name}) ERROR: ` +
+                    `\n  reloadData was UNSUCCESSFUL`, '\n\n', error, '\n\n', new Error());
+                if (error?.error?.flag?.includes('DYNAMO')) {
+                    error.error.handled = true;
+                }
+            }
+            throw error;
+        }
+    }
+    async getData() {
+        if (!this.data) {
+            const loadProgress = this.loadInProgress_BS.value;
+            if (loadProgress) {
+                return await loadProgress.progress;
+            }
+            else {
+                // BFR-MASTERPROMPTER-024: not-loaded-yet út → silent missing-ID (a throw marad).
+                return await this.reloadData(undefined, { silentMissingId: true });
+            }
+        }
+        else {
+            return this.data;
+        }
+    }
+    async doReloadDataBy(loadedBy) {
+        try {
+            this.lastLoadedBy = loadedBy;
+            return await this.processLoadResult(await this.get(loadedBy), loadedBy);
+        }
+        catch (error) {
+            this.resolveWaitsOnLoad();
+            throw error;
+        }
+    }
+    /**
+     * A DataHandler adatának közvetlen frissítése egy már ismert value-val, szerver-round-trip NÉLKÜL
+     * (pl. login-response → user_DH.updateData). Alapból CSAK a saját data_BS-t frissíti.
+     *
+     * @param reloadDependents opt-in (BFR-MASTERPROMPTER-013): ha true, a `reloadData` post-process
+     *   dependent-reload-láncát is meghajtja — a függő DataHandler-ek (pl. token-balance) újratöltődnek
+     *   az új adat `_id`-jével. A `reloadData` (hard-nav boot) útján ez a lánc automatikus, de az
+     *   `updateData` (round-trip-mentes) útján eddig NEM futott → a friss SPA-login után a dependent-DH
+     *   adatok üresek maradtak hard-reload-ig. DEFAULT false (backward-safe): az `updateData` fő szándéka
+     *   ÉPP a szerver-hívás elkerülése, ezért a vak dependent-reload nem kívánt HTTP-flood-ot okozhatna.
+     */
+    async updateData(data, dontSendUpdate, reloadDependents) {
+        if (this.set && !dontSendUpdate) {
+            this.data_BS.next(await this.set(data));
+        }
+        else {
+            this.data_BS.next(data);
+        }
+        if (reloadDependents) {
+            // ugyanaz a reload-vagy-clear logika, mint a reloadData post-process-e (dependent-lánc)
+            this.dependentDataHandlers?.forEach((dependent_DH) => {
+                if (data && data._id && data._id !== dependent_DH.lastLoadedBy) {
+                    dependent_DH.reloadData(data._id);
+                }
+                else if (!data) {
+                    dependent_DH.clear();
+                }
+            });
+        }
+    }
+    clear(dontClearDependents) {
+        this.data_BS.next(undefined);
+        this.lastLoadedBy = undefined;
+        if (!dontClearDependents) {
+            this.dependentDataHandlers.forEach((ddh) => {
+                ddh.clear();
+            });
+        }
+    }
+    async processLoadResult(result, loadedBy) {
+        if (this.debugLog) {
+            console.log(`DYNAMO DH.processLoadResult (${this.name}) DEBUG:` +
+                `\n  DataHandler processLoadResult... (using id: ${loadedBy})` +
+                `\n  Result:`, result);
+        }
+        for (const postProcess of this.getPostProcesses) {
+            if (this.debugLog) {
+                console.log(`DYNAMO DH.processLoadResult (${this.name}) DEBUG:` +
+                    `\n  Post process:`, postProcess);
+            }
+            result = await postProcess(result, loadedBy);
+            if (!result) {
+                DyFM_Log.warn(`DYNAMO DH.processLoadResult (${this.name}) WARN: ` +
+                    `\nPost process returned null or undefined!`, '\n\n', new Error());
+            }
+        }
+        this.data_BS.next(result);
+        this.loaded_BS.next(true);
+        this.resolveWaitsOnLoad();
+        return result;
+    }
+    resolveWaitsOnLoad() {
+        this.waitsOnLoad.forEach(({ promise, resolve }) => {
+            resolve();
+        });
+        this.waitsOnLoad = [];
+    }
+    /**
+     * waits for the first load to finish
+     * @returns a promise that resolves when the first load finishes after this "subscription"
+     */
+    waitForLoad() {
+        let resolve;
+        const promise = new Promise((r) => { resolve = r; });
+        this.waitsOnLoad.push({ promise, resolve });
+        return promise;
+    }
+}
+Object.defineProperty(DyFM_DataHandler_ControlModel, 'name', { value: 'DyFM_DataHandler' });
+/** @deprecated Use DyFM_DataHandler_ControlModel. Same constructor; no API removal. */
+export { DyFM_DataHandler_ControlModel as DyFM_DataHandler };
+Object.defineProperty(DyFM_DataHandler_ControlModel.prototype, 'isIdOmitted', {
+    configurable: true,
+    enumerable: false,
+    get: function () {
+        return this.noId;
+    },
+    set: function (isValue) {
+        this.noId = isValue;
+    },
+});
+Object.defineProperty(DyFM_DataHandler_ControlModel.prototype, 'isDebugLogEnabled', {
+    configurable: true,
+    enumerable: false,
+    get: function () {
+        return this.debugLog;
+    },
+    set: function (isValue) {
+        this.debugLog = isValue;
+    },
+});

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

@@ -0,0 +1,11 @@
+import { DyFM_DataHandler_Settings } from './data-handler-settings.control-model';
+/** Settings for a list data handler. */
+export class DyFM_DataListHandlerSettings_ControlModel extends DyFM_DataHandler_Settings {
+    static {
+        Object.defineProperty(this, 'name', { value: 'DyFM_DataListHandler_Settings' });
+    }
+    setItem;
+    deleteItem;
+}
+/** @deprecated Use DyFM_DataListHandlerSettings_ControlModel. Same constructor; no API removal. */
+export { DyFM_DataListHandlerSettings_ControlModel as DyFM_DataListHandler_Settings };

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

@@ -0,0 +1,222 @@
+import { BehaviorSubject } from 'rxjs';
+import { DyFM_DataHandler } from './data-handler.control-model';
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+import { DyFM_Log } from '../../../_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_ControlModel<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);
+ * });
+ * ```
+ */
+export class DyFM_DataListHandler_ControlModel extends 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_ControlModel.
+     *
+     * @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 BehaviorSubject([]);
+        this.dataList$ = this.dataList_BS.asObservable();
+        // Initialize activeItem BehaviorSubject and Observable
+        this.activeItem_BS = new 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) {
+            DyFM_Log.error(`Error reloading DyFM_DataListHandler_ControlModel (${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 DyFM_Error({
+                error: new Error(`Item not found! (${this.name})`),
+                errorCode: 'DyFM-DLH-UI1',
+                additionalContent: {
+                    item: item,
+                },
+            });
+        }
+    }
+    setActiveItem(item) {
+        this.activeItem_BS.next(item);
+    }
+}
+Object.defineProperty(DyFM_DataListHandler_ControlModel, 'name', { value: 'DyFM_DataListHandler' });
+/** @deprecated Use DyFM_DataListHandler_ControlModel. Same constructor; no API removal. */
+export { DyFM_DataListHandler_ControlModel as DyFM_DataListHandler };

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

@@ -0,0 +1,25 @@
+import { DyFM_DataHandler_Settings } from './data-handler-settings.control-model';
+/** Settings for a search-backed data handler. */
+export class DyFM_DataSearchHandlerSettings_ControlModel extends DyFM_DataHandler_Settings {
+    static {
+        Object.defineProperty(this, 'name', { value: 'DyFM_DataSearchHandler_Settings' });
+    }
+    defaultQuery;
+    defaultPageSize;
+    cacheSize;
+    queryUpdateDebounceTime;
+    /** @deprecated Use isSearchOnInitEnabled; searchOnInit remains the serialized compatibility key. */
+    searchOnInit;
+}
+Object.defineProperty(DyFM_DataSearchHandlerSettings_ControlModel.prototype, 'isSearchOnInitEnabled', {
+    configurable: true,
+    enumerable: false,
+    get: function () {
+        return this.searchOnInit;
+    },
+    set: function (isValue) {
+        this.searchOnInit = isValue;
+    },
+});
+/** @deprecated Use DyFM_DataSearchHandlerSettings_ControlModel. Same constructor; no API removal. */
+export { DyFM_DataSearchHandlerSettings_ControlModel as DyFM_DataSearchHandler_Settings };