hazo_collab_forms 3.0.18 → 3.1.0

package/dist/utils/fb_data_helpers.js

@@ -0,0 +1,269 @@
+/**
+ * Read helpers for the hierarchical FB form data model.
+ *
+ * These functions walk the data[] tree and extract flat views
+ * that existing components and views can consume.
+ */
+/**
+ * Walk all processed_data nodes in the tree, calling the visitor for each.
+ * Handles both root entries and nested clarification blocks recursively.
+ */
+function walk_processed_data(data, visitor) {
+    const walk_client_inputs = (inputs, entry_index, form_instance) => {
+        const input_list = Array.isArray(inputs) ? inputs : [inputs];
+        for (const input of input_list) {
+            if (input.processed_data) {
+                for (const pd of input.processed_data) {
+                    visitor(pd, entry_index, form_instance);
+                    // Recurse into activities that have nested clarifications
+                    if (pd.activities) {
+                        for (const act of pd.activities) {
+                            if (act.clarification?.client_data) {
+                                for (const cdi of act.clarification.client_data) {
+                                    walk_client_inputs(cdi.client_input, entry_index, act.clarification.question?.form_instance);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    };
+    for (let i = 0; i < data.length; i++) {
+        const entry = data[i];
+        const form_instance = entry.question?.form_instance ?? entry.clarification?.question?.form_instance;
+        // Walk root-level client_data
+        if (entry.client_data) {
+            for (const cdi of entry.client_data) {
+                walk_client_inputs(cdi.client_input, i, form_instance);
+            }
+        }
+        // Walk clarification-level client_data
+        if (entry.clarification?.client_data) {
+            for (const cdi of entry.clarification.client_data) {
+                walk_client_inputs(cdi.client_input, i, form_instance);
+            }
+        }
+    }
+}
+/**
+ * Walk all activities in the tree, calling the visitor for each.
+ */
+function walk_activities(data, visitor) {
+    walk_processed_data(data, (pd, entry_index, form_instance) => {
+        if (pd.activities) {
+            for (const act of pd.activities) {
+                visitor(act, pd, entry_index, form_instance);
+            }
+        }
+    });
+}
+// ========================================
+// Filtering by instance
+// ========================================
+/** Get all data entries for a specific form instance */
+export function get_entries_for_instance(data, form_instance) {
+    return data.filter((entry) => {
+        const inst = entry.question?.form_instance ?? entry.clarification?.question?.form_instance;
+        return inst === form_instance;
+    });
+}
+// ========================================
+// Validation access
+// ========================================
+/** Get all validations across the entire data tree */
+export function get_all_validations(data) {
+    const results = [];
+    walk_activities(data, (act, pd, entry_index) => {
+        if (act.validations) {
+            for (const val of act.validations) {
+                results.push({ validation: val, activity: act, processed_data: pd, entry_index });
+            }
+        }
+    });
+    return results;
+}
+/** Get all failed validations */
+export function get_failed_validations(data) {
+    return get_all_validations(data).filter((v) => v.validation.validation_status === 'failed');
+}
+// ========================================
+// RFI / Clarification access
+// ========================================
+/** Get all activities of type 'client_question' (RFIs) */
+export function get_all_rfis(data) {
+    const results = [];
+    walk_activities(data, (act, pd, entry_index) => {
+        if (act.activity_info.activity_type === 'client_question' && act.clarification) {
+            results.push({ clarification: act.clarification, activity: act, processed_data: pd, entry_index });
+        }
+    });
+    return results;
+}
+/** Get RFIs that have been issued but not yet responded to */
+export function get_pending_rfis(data) {
+    return get_all_rfis(data).filter((r) => {
+        const status = r.clarification.rfi?.rfi_status ?? '';
+        return status.includes('issued') && !status.includes('responded');
+    });
+}
+/** Get RFIs where the client has responded */
+export function get_responded_rfis(data) {
+    return get_all_rfis(data).filter((r) => {
+        const status = r.clarification.rfi?.rfi_status ?? '';
+        return status.includes('responded');
+    });
+}
+// ========================================
+// Review & send-back access
+// ========================================
+/** Get all activities with type 'review_client_input' */
+export function get_review_items(data) {
+    const results = [];
+    walk_activities(data, (act, pd, entry_index, form_instance) => {
+        if (act.activity_info.activity_type === 'review_client_input') {
+            results.push({ activity: act, processed_data: pd, entry_index, form_instance });
+        }
+    });
+    return results;
+}
+/** Get all activities with type 'send_back_to_client' */
+export function get_send_back_items(data) {
+    const results = [];
+    walk_activities(data, (act, pd, entry_index, form_instance) => {
+        if (act.activity_info.activity_type === 'send_back_to_client') {
+            results.push({ activity: act, processed_data: pd, entry_index, form_instance });
+        }
+    });
+    return results;
+}
+// ========================================
+// Lookup by ID
+// ========================================
+/** Find an activity by its activity_no anywhere in the tree */
+export function find_by_activity_no(data, act_no) {
+    let result = null;
+    walk_activities(data, (act, pd, entry_index, form_instance) => {
+        if (act.activity_info.activity_no === act_no && !result) {
+            result = { activity: act, processed_data: pd, entry_index, form_instance };
+        }
+    });
+    return result;
+}
+/** Find a processed_data node by its processed_data_id */
+export function find_by_pd_id(data, pd_id) {
+    let result = null;
+    walk_processed_data(data, (pd, entry_index) => {
+        if (pd.processed_data_id === pd_id && !result) {
+            result = { pd, entry_index };
+        }
+    });
+    return result;
+}
+/** Find a validation by its validation_id */
+export function find_by_validation_id(data, val_id) {
+    const all = get_all_validations(data);
+    return all.find((v) => v.validation.validation_id === val_id) ?? null;
+}
+/** Find a client data item by its input_elt_id */
+export function find_by_ie_id(data, ie_id) {
+    const find_in_client_data = (items) => {
+        if (!items)
+            return null;
+        for (const item of items) {
+            if (item.input_elt_id === ie_id)
+                return item;
+        }
+        return null;
+    };
+    for (const entry of data) {
+        const found = find_in_client_data(entry.client_data) ??
+            find_in_client_data(entry.clarification?.client_data);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** Extract a classification summary from all processed_data nodes */
+export function get_classification_summary(data) {
+    const results = [];
+    walk_processed_data(data, (pd) => {
+        if (pd.tags || pd.processed_data_category || pd.processed_data_nature) {
+            results.push({
+                processed_data_id: pd.processed_data_id,
+                tags: pd.tags ?? [],
+                category: pd.processed_data_category ?? [],
+                nature: pd.processed_data_nature ?? [],
+                source_text: pd.processed_data_text,
+                source_file: pd.processed_data_files ? {
+                    file_id: pd.processed_data_files.file_id,
+                    file_name: pd.processed_data_files.file_name,
+                } : undefined,
+            });
+        }
+    });
+    return results;
+}
+/** Extract per-file validation summaries from data[] */
+export function get_file_validation_summary(data) {
+    const file_map = new Map();
+    walk_processed_data(data, (pd) => {
+        if (pd.processed_data_type !== 'file' || !pd.processed_data_files)
+            return;
+        const file_id = pd.processed_data_files.file_id;
+        const existing = file_map.get(file_id) ?? {
+            file_id,
+            file_name: pd.processed_data_files.file_name,
+            validations: [],
+            has_failures: false,
+            all_passed: true,
+        };
+        if (pd.activities) {
+            for (const act of pd.activities) {
+                if (act.validations) {
+                    for (const val of act.validations) {
+                        existing.validations.push(val);
+                        if (val.validation_status === 'failed') {
+                            existing.has_failures = true;
+                            existing.all_passed = false;
+                        }
+                    }
+                }
+            }
+        }
+        file_map.set(file_id, existing);
+    });
+    return file_map;
+}
+/** Get all activities filtered by type */
+export function get_activities_by_type(data, type) {
+    const results = [];
+    walk_activities(data, (act, pd, entry_index, form_instance) => {
+        if (act.activity_info.activity_type === type) {
+            results.push({ activity: act, processed_data: pd, entry_index, form_instance });
+        }
+    });
+    return results;
+}
+/** Count data entries by form_instance */
+export function count_entries_by_instance(data) {
+    const counts = new Map();
+    for (const entry of data) {
+        const inst = entry.question?.form_instance ?? entry.clarification?.question?.form_instance;
+        if (inst != null) {
+            counts.set(inst, (counts.get(inst) ?? 0) + 1);
+        }
+    }
+    return counts;
+}
+/** Get the highest form_instance number in the data */
+export function get_max_form_instance(data) {
+    let max = 0;
+    for (const entry of data) {
+        const inst = entry.question?.form_instance ?? entry.clarification?.question?.form_instance;
+        if (inst != null && inst > max)
+            max = inst;
+    }
+    return max;
+}
+//# sourceMappingURL=fb_data_helpers.js.map

package/dist/utils/fb_data_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fb_data_helpers.js","sourceRoot":"","sources":["../../src/utils/fb_data_helpers.ts"],"names":[],"mappings":"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"}

package/dist/utils/fb_data_mutations.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Immutable mutation helpers for the hierarchical FB form data model.
+ *
+ * All functions return new arrays (never mutate in place) to work
+ * correctly with React state updates.
+ */
+import type { FbDataEntry, FbClientDataItem, FbProcessedData, FbActivity, FbValidation, FbQuestion, FbRfiDraft } from '../types/fb_form_data.js';
+/** Append a new data entry to the data array */
+export declare function add_data_entry(data: FbDataEntry[], entry: FbDataEntry): FbDataEntry[];
+/** Remove a data entry by index */
+export declare function remove_data_entry(data: FbDataEntry[], entry_index: number): FbDataEntry[];
+/** Update a data entry at a specific index */
+export declare function update_data_entry(data: FbDataEntry[], entry_index: number, updater: (entry: FbDataEntry) => FbDataEntry): FbDataEntry[];
+/** Add a client_data item to a root-level data entry */
+export declare function add_client_data(data: FbDataEntry[], entry_index: number, item: FbClientDataItem): FbDataEntry[];
+/** Add a client_data item to a clarification block within an entry */
+export declare function add_clarification_client_data(data: FbDataEntry[], entry_index: number, item: FbClientDataItem): FbDataEntry[];
+/**
+ * Add processed_data items to a specific client input identified by input_elt_id.
+ * Searches both root client_data and clarification client_data.
+ */
+export declare function add_processed_data(data: FbDataEntry[], ie_id: string, pd_items: FbProcessedData[]): FbDataEntry[];
+/**
+ * Append an activity to a specific processed_data node identified by pd_id.
+ * Recursively searches the entire tree.
+ */
+export declare function append_activity(data: FbDataEntry[], pd_id: string, activity: FbActivity): FbDataEntry[];
+/** Update a validation's status by validation_id */
+export declare function update_validation(data: FbDataEntry[], val_id: string, updates: Partial<Pick<FbValidation, 'validation_status' | 'validation_details'>>): FbDataEntry[];
+/** Set the review decision on an activity identified by activity_no */
+export declare function set_review_decision(data: FbDataEntry[], act_no: string, decision: 'accept' | 'send_back'): FbDataEntry[];
+/** Add client response data to an RFI clarification within an activity */
+export declare function add_rfi_response(data: FbDataEntry[], act_no: string, client_data_item: FbClientDataItem): FbDataEntry[];
+/**
+ * Create a new top-level clarification entry for a send-back.
+ * This represents a new clarification question in the next form instance.
+ */
+export declare function create_send_back_entry(data: FbDataEntry[], source_act_no: string, form_instance: number, rfi_draft: FbRfiDraft): FbDataEntry[];
+/**
+ * Create a new root question entry for a form instance.
+ */
+export declare function create_question_entry(data: FbDataEntry[], question: FbQuestion): FbDataEntry[];
+//# sourceMappingURL=fb_data_mutations.d.ts.map

package/dist/utils/fb_data_mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fb_data_mutations.d.ts","sourceRoot":"","sources":["../../src/utils/fb_data_mutations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAEhB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAMlC,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,CAErF;AAED,mCAAmC;AACnC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAEzF;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GAC3C,WAAW,EAAE,CAEf;AAMD,wDAAwD;AACxD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACrB,WAAW,EAAE,CAKf;AAED,sEAAsE;AACtE,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,WAAW,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACrB,WAAW,EAAE,CAWf;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,eAAe,EAAE,GAC1B,WAAW,EAAE,CAqBf;AAmCD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,UAAU,GACnB,WAAW,EAAE,CAQf;AAkFD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,mBAAmB,GAAG,oBAAoB,CAAC,CAAC,GAC/E,WAAW,EAAE,CASf;AAMD,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAC/B,WAAW,EAAE,CAKf;AAMD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,GACjC,WAAW,EAAE,CAef;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,UAAU,GACpB,WAAW,EAAE,CAsBf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EAAE,EACnB,QAAQ,EAAE,UAAU,GACnB,WAAW,EAAE,CAEf"}