Upload preference receipt helpers

[michaelfarrell76]

Related Issues

• ref https://linear.app/transcend/issue/PIK-166/fix-prferences-cli-to-handle-mutliple-identifiers
• picked from [WIP] Adds a cli command to classify usntructured data #459

This pull request introduces a new set of utilities for handling and aggregating receipt files in the consent upload-preferences workflow. The main changes add functions to summarize receipt data, read failing updates, resolve receipt file paths, and apply these summaries to overall totals. Comprehensive unit tests are included for these new utilities. Additionally, there is a minor update to the way Node.js core modules are imported for consistency.

Receipt utilities and aggregation:

• Added applyReceiptSummary function, which merges receipt summary data into an aggregation object and collects failing updates. This function supports both upload and check modes and handles dry runs.
• Added summarizeReceipt utility to parse receipt JSON files and return dashboard counters, supporting both upload and check modes.
• Added readFailingUpdatesFromReceipt to extract rows of failing updates from a receipt file, including error details and source file context.
• Added resolveReceiptPath to locate the correct receipt JSON file for a given input, handling suffixes and selecting the most recent file.
• Updated receipts/index.ts to export all new utilities for easier use elsewhere in the codebase.

Testing:

• Added thorough unit tests for applyReceiptSummary and readFailingUpdatesFromReceipt, covering merging logic, error handling, and edge cases. [1] [2]

[linear]

PIK-166 Fix prferences CLI to handle mutliple identifiers