Utilities

Pure, standalone functions providing common, reusable logic for the IGNIS framework. All utilities are stateless and easy to use.

Quick Reference

Utility	Package	Purpose	Key Functions
Date	ignis-helpers	Date/time manipulation	dayjs, sleep(), isWeekday(), getDateTz(), hrTime()
Duration	ignis-helpers	Duration units and conversion	DurationUnits, DurationMultipliers.toMilliseconds(), .parseToMilliseconds()
JSX	ignis	HTML/JSX responses	htmlContent(), htmlResponse()
Module	ignis-helpers	Optional peer loading	ModuleUtility
Parse	ignis-helpers	Data type conversion	int(), float(), toBoolean(), toCamel()
Performance	ignis-helpers	Execution timing	executeWithPerformanceMeasure(), getPerformanceCheckpoint()
Promise	ignis-helpers	Promise helpers	executePromiseWithLimit(), isPromiseLike(), getDeepProperty()
Request	ignis-helpers	HTTP utilities	parseMultipartBody(), sanitizeFilename(), createContentDispositionHeader()
Retry	ignis-helpers	Backoff-driven retries	RetryHelper
Schema	ignis	Zod schema helpers	jsonContent(), jsonResponse(), requiredString(), idParamsSchema()
Statuses	ignis	Status code constants	Statuses, CommonStatuses, UserStatuses, RoleStatuses

What's in This Section

Data Processing

• Parse - Functions for parsing and converting data types safely (integers, floats, booleans, camelCase, array-to-map)
• Schema - Helpers for creating Zod schemas for OpenAPI request/response validation
• Statuses - Standardized status code constants for entity lifecycle management

Time & Performance

• Date - Date and time manipulation functions built on dayjs with timezone support
• Duration - A unit vocabulary, written-duration parsing, and conversion between units and milliseconds
• Performance - Utilities for measuring code execution time and performance profiling

Async & HTTP

• JSX - HTML and JSX response utilities for server-side rendering and OpenAPI documentation
• Promise - Helper functions for working with Promises including concurrency limiting and value transformation
• Request - HTTP request utilities for parsing multipart form data and creating secure Content-Disposition headers
• Retry - Backoff-driven retry helpers on RetryHelper - error-triggered (executeWithRetry) and predicate-driven (executeWithRetryUntil)

Runtime

• Module - Utility for validating that required Node.js modules are installed at runtime

Usage Pattern

Utilities are imported from @venizia/ignis (schema, JSX, and status helpers) or @venizia/ignis-helpers (runtime utilities):

import { jsonContent, jsonResponse, htmlResponse, requiredString, Statuses } from '@venizia/ignis';
import { dayjs, sleep, int, float, toBoolean } from '@venizia/ignis-helpers';

// Date
const now = dayjs();
await sleep(1000);

// Parse
const myInt = int('1,000'); // 1000
const myFloat = float('1,234.567', 2); // 1234.57
const myBool = toBoolean('true'); // true

// Schema (for OpenAPI JSON routes)
const responseSchema = jsonResponse({
  description: 'User data',
  schema: z.object({ id: z.string(), name: z.string() }),
});

// JSX (for HTML routes)
const htmlResponseSchema = htmlResponse({
  description: 'Dashboard page',
});

// Statuses
const order = { status: Statuses.COMPLETED };
if (Statuses.isCompleted(order.status)) {
  console.log('Order is complete');
}

Related: Helpers Reference | Core Concepts Guide