Ultan is a utility library that bridges traditional JavaScript development with modern AI, healthcare (FHIR/HL7), and cloud-native architectures. Built for Fortune 500 environments, it provides enterprise-grade functions for string manipulation, array operations, object handling, healthcare data processing, AI prompt management, PHI masking, and reactive state management. Whether you're building HIPAA-compliant healthcare applications, AI-powered workflows, or mission-critical enterprise systems, Ultan delivers production-ready utilities that eliminate boilerplate and accelerate development cycles.
- Installation
- Quick Start
- Healthcare (FHIR/HL7)
- AI Integration
- String Manipulation
- Object Utilities
- Array Utilities
- Function Utilities
- HTTP/Network
- Miscellaneous
- Regular Expressions
- Constants
- License
npm install ultanconst {
stringFormat,
isValidFhir,
getFhirName,
getAcuityScore,
fillPrompt,
parseAiJson,
maskPHI,
debounce,
generateUUID
} = require('ultan');
const patient = {
resourceType: 'Patient',
id: '12345',
name: [{ use: 'official', given: ['John'], family: 'Doe' }]
};
console.log(isValidFhir(patient));
console.log(getFhirName(patient));Validates if an object is a valid FHIR resource by checking for resourceType and id properties.
isValidFhir({ resourceType: 'Patient', id: '123' });Extracts the official name from a FHIR Patient resource, falling back to the first name available.
const name = getFhirName(patientResource);Calculates clinical acuity score based on vital signs (heart rate, respiratory rate, temperature, systolic blood pressure).
const score = getAcuityScore({ hr: 120, rr: 26, temp: 98.6, sbp: 85 });Masks Protected Health Information including SSN, phone numbers, and email addresses.
const masked = maskPHI('Contact: john@email.com or 555-123-4567');Detects stagnant sessions or zombie connections based on heartbeat timestamp.
const stale = isZombie('2024-01-01T10:00:00Z', 300000);Replaces {{variable}} placeholders in prompt templates with actual values.
const prompt = fillPrompt('Analyze {{dataType}} for patient {{id}}', {
dataType: 'vitals',
id: '12345'
});Parses JSON from AI responses, handling markdown code fences and malformed output.
const data = parseAiJson('```json\n{"key": "value"}\n```');Creates a reactive signal with pub/sub pattern for state management.
const counter = createSignal(0);
counter.subscribe(val => console.log('New value:', val));
counter.set(5);
const current = counter.get();Replaces {0}, {1}, etc. placeholders with arguments.
stringFormat('Hello, {0}! Welcome to {1}.', 'Alice', 'Ultan');Converts string to title case.
toTitleCase('hello world');Escapes HTML special characters.
sanitizeString('<script>alert("xss")</script>');Base64 encoding and decoding with UTF-8 support.
const encoded = toBase64('Hello World');
const decoded = fromBase64(encoded);Counts substring occurrences.
countOccurrences('hello world hello', 'hello');Checks if object, array, or string is empty.
isEmpty({});
isEmpty([]);
isEmpty('');
isEmpty(null);Creates deep copy using structuredClone or JSON fallback.
const clone = deepClone({ nested: { data: [1, 2, 3] } });Sets nested property using dot notation.
const obj = {};
setNestedProperty(obj, 'user.profile.name', 'John');Retrieves nested property using dot notation.
const name = getNestedProperty(obj, 'user.profile.name');Converts between objects and key-value pair arrays.
objectToArray({ a: 1, b: 2 });
arrayToObject([['a', 1], ['b', 2]]);Merges arrays removing duplicates.
mergeArrays([1, 2, 3], [3, 4, 5]);Calculates sum or average of numeric array.
sumArray([1, 2, 3, 4]);
averageArray([10, 20, 30]);Returns elements in array1 not in array2.
arrayDifference([1, 2, 3], [2, 3, 4]);Filters out falsy values.
removeFalsyValues([0, 1, false, 2, '', 3, null, undefined]);Groups array of objects by property.
groupBy([{ type: 'A', val: 1 }, { type: 'B', val: 2 }], 'type');Delays function execution until after delay milliseconds.
const debouncedSearch = debounce(searchFunction, 500);Ensures function executes at most once per limit milliseconds.
const throttledScroll = throttle(handleScroll, 100);Simplified fetch wrapper that throws on non-OK responses and parses JSON.
const data = await reqFlow('https://api.example.com/data', {
method: 'POST',
body: JSON.stringify({ key: 'value' })
});Console logs greeting with optional destructured parameters.
greet({ name: 'Alice', age: 30 });
greet();Returns lowercase type string.
getType([]);
getType({});
getType(null);Returns random float in range.
getRandomInRange(1, 10);Rounds to specified decimal places.
round(3.14159, 2);Generates RFC4122 compliant UUID v4.
const id = generateUUID();Formats date as MM/DD/YYYY.
formatDate(new Date());Pre-compiled regex patterns accessible via regexes object:
regexes.email- Email validationregexes.phone- International phone numbersregexes.url- HTTP/HTTPS URLs
const { regexes } = require('ultan');
regexes.email.test('user@example.com');Frozen object with weekday names.
const { DaysOfWeek } = require('ultan');
console.log(DaysOfWeek.MONDAY);Common HTTP status codes.
const { HttpStatus } = require('ultan');
if (response.status === HttpStatus.NOT_FOUND) { }MIT
