IntelliWakeTSFoundation Reference

This library provides foundational TypeScript utilities for data manipulation, formatting, and validation.

Core Modules

• DateManager: Comprehensive date/time parsing and formatting.
• SortSearch: Type-safe multi-property sorting.
• Importer: Tabular data analysis and validation (CSV/Excel workflows).
• Formatters: Currency, numeric, and string masking.

Documentation

• Full Wiki: https://github.com/SolidBasisVentures/IntelliWakeTSFoundation/wiki
• Importer Workflow: See ImporterUsage.md for validation priorities.

Implementation Patterns

• Always validate imports in this order: Structural (Missing Columns) -> Integrity (Errors) -> Quality (Warnings).
• Use DateManager for all date manipulations to ensure cross-timezone consistency.

IntelliwakeTSFoundation, short for the IntelliWake TypeScript Foundation Library provides multiple helper functions that are not present in vanilla JavaScript.

Documentation on how to use these features can be found on our WIKI

This library is meant to be used both on the client side and the server side.

Date and Date/Time Utilities

The basic premise of the date/time functions is that you can provide any format you like as an input (Javascript Date object, date string (MM/DD/YYYY, YYYY-MM-DD), date/time string, time string, ISO date time string (in a variety of flavors)) and it can parse, manipulate, compare and format them.

Format Utilities

Sometimes you just need to do some simple manipulation to format things nicely for users, but coming up with the right mechanism use isn't always straight forward. These utilities provide some great ways to get strings and numbers formatted for common needs.

Array Utilities

Javascript has an array.sort() function. But, it's implementation is inconsistent (comparison by subtraction for numbers, trying to get strings to sort case-insensitive, comparing dates and/or times, binaries, etc.). And then, if you want to sort by multiple conditions, the syntax is complicated to the point where it may not be obvious what the intent of the original developer was.

The idea behind this implementation is to handle sorts in a consistent way and vastly simplify the process of stacked sorting.

Generic Functions

There are a few additional functions that provide other features, like checking additional values for a truthy condition, coalescing 0's and blank strings, and providing a promise based sleep function.