@sudobility/types 1.9.53 → 1.9.55

package/dist/utils/async-helpers.js

@@ -1,14 +1,32 @@
 "use strict";
 /**
- * Common async operation patterns and helpers
- * Reduces boilerplate code for common async operations
+ * Common async operation patterns and helpers.
+ * Reduces boilerplate code for common async operations.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.debounceAsync = exports.clearExpiredCache = exports.withCache = exports.withTimeout = exports.safeParallel = exports.withLoadingState = exports.safeAsync = void 0;
 const logger_1 = require("./logging/logger");
 /**
- * Safely execute an async operation with error handling
- * Returns a result object instead of throwing
+ * Safely execute an async operation with error handling.
+ * Returns a result object instead of throwing.
+ *
+ * @template T - The success data type
+ * @param operation - Async function to execute
+ * @param context - Optional context string for logging
+ * @returns A promise resolving to an {@link AsyncResult}
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = await safeAsync(() => fetchUser(id), 'fetchUser');
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.error?.message);
+ * }
+ * ```
  */
 const safeAsync = async (operation, context) => {
     try {
@@ -23,7 +41,26 @@ const safeAsync = async (operation, context) => {
 };
 exports.safeAsync = safeAsync;
 /**
- * Execute async operation with loading state tracking
+ * Execute async operation with loading state tracking.
+ * Manages `setLoading` and `setError` callbacks automatically.
+ *
+ * @template T - The success data type
+ * @param operation - Async function to execute
+ * @param setLoading - Callback to update loading state
+ * @param setError - Callback to update error state
+ * @param context - Optional context string for logging
+ * @returns The operation result, or undefined on error
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const data = await withLoadingState(
+ *   () => api.getUsers(),
+ *   setIsLoading,
+ *   setErrorMsg,
+ *   'getUsers'
+ * );
+ * ```
  */
 const withLoadingState = async (operation, setLoading, setError, context) => {
     setLoading(true);
@@ -44,7 +81,22 @@ const withLoadingState = async (operation, setLoading, setError, context) => {
 };
 exports.withLoadingState = withLoadingState;
 /**
- * Execute multiple async operations in parallel with error handling
+ * Execute multiple async operations in parallel with error handling.
+ * All operations run concurrently via `Promise.all`.
+ *
+ * @template T - Tuple of result types
+ * @param operations - Array of async functions to execute in parallel
+ * @param context - Optional context string for logging
+ * @returns A promise resolving to an {@link AsyncResult} of the tuple
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = await safeParallel(
+ *   [() => fetchUser(1), () => fetchPosts(1)] as const,
+ *   'loadProfile'
+ * );
+ * ```
  */
 const safeParallel = async (operations, context) => {
     try {
@@ -59,7 +111,25 @@ const safeParallel = async (operations, context) => {
 };
 exports.safeParallel = safeParallel;
 /**
- * Execute async operation with timeout
+ * Execute async operation with a timeout.
+ * Rejects if the operation does not complete within `timeoutMs`.
+ *
+ * @template T - The success data type
+ * @param operation - Async function to execute
+ * @param timeoutMs - Maximum time in milliseconds
+ * @param context - Optional context string for logging
+ * @returns The operation result
+ * @throws Error if the operation times out
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const data = await withTimeout(
+ *   () => fetch('/api/data').then((r) => r.json()),
+ *   5000,
+ *   'fetchData'
+ * );
+ * ```
  */
 const withTimeout = async (operation, timeoutMs, context) => {
     const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Operation timed out after ${timeoutMs}ms`)), timeoutMs));
@@ -73,9 +143,30 @@ const withTimeout = async (operation, timeoutMs, context) => {
 };
 exports.withTimeout = withTimeout;
 /**
- * Cache async operation results with TTL
+ * In-memory cache for {@link withCache}.
  */
 const cache = new Map();
+/**
+ * Cache async operation results with TTL (time-to-live).
+ * Returns cached data if still valid; otherwise executes the operation
+ * and stores the result.
+ *
+ * @template T - The cached data type
+ * @param key - Unique cache key
+ * @param operation - Async function whose result is cached
+ * @param ttlMs - Cache TTL in milliseconds (default: 5 minutes)
+ * @returns The cached or freshly fetched data
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const user = await withCache(
+ *   `user-${id}`,
+ *   () => api.getUser(id),
+ *   60_000 // 1 minute
+ * );
+ * ```
+ */
 const withCache = async (key, operation, ttlMs = 5 * 60 * 1000 // 5 minutes default
 ) => {
     const cached = cache.get(key);
@@ -89,7 +180,8 @@ const withCache = async (key, operation, ttlMs = 5 * 60 * 1000 // 5 minutes defa
 };
 exports.withCache = withCache;
 /**
- * Clear expired cache entries
+ * Clear expired cache entries from the in-memory cache.
+ * @since 1.0.0
  */
 const clearExpiredCache = () => {
     const now = Date.now();
@@ -101,9 +193,31 @@ const clearExpiredCache = () => {
 };
 exports.clearExpiredCache = clearExpiredCache;
 /**
- * Debounce async operations
+ * Active debounce timers keyed by operation key.
  */
 const debounceMap = new Map();
+/**
+ * Debounce async function calls by key.
+ * Only the last call within the delay window will execute.
+ *
+ * @template T - Argument types
+ * @template R - Return type
+ * @param fn - The async function to debounce
+ * @param delay - Debounce delay in milliseconds
+ * @param key - Unique key identifying this debounced operation
+ * @returns A debounced version of `fn`
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = debounceAsync(
+ *   (query: string) => api.search(query),
+ *   300,
+ *   'search'
+ * );
+ * await debouncedSearch('hello');
+ * ```
+ */
 const debounceAsync = (fn, delay, key) => {
     return (...args) => {
         return new Promise(resolve => {

package/dist/utils/async-helpers.js.map

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

package/dist/utils/formatting/currency.cjs

@@ -1,13 +1,16 @@
 "use strict";
 /**
- * Currency formatting utilities for USDC and other tokens
+ * Currency formatting utilities for USDC and other tokens.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLAIM_PERIOD_DAYS = exports.USDC_DECIMALS = void 0;
 exports.formatUSDC = formatUSDC;
 exports.parseUSDC = parseUSDC;
-// USDC configuration constants
+/** Number of decimal places for USDC token amounts. */
 exports.USDC_DECIMALS = 6;
+/** Revenue claim expiration period in days. */
 exports.CLAIM_PERIOD_DAYS = 60;
 /**
  * Format USDC amount from smallest unit to human-readable string

package/dist/utils/formatting/currency.d.ts

@@ -1,7 +1,11 @@
 /**
- * Currency formatting utilities for USDC and other tokens
+ * Currency formatting utilities for USDC and other tokens.
+ *
+ * @since 1.0.0
  */
+/** Number of decimal places for USDC token amounts. */
 export declare const USDC_DECIMALS = 6;
+/** Revenue claim expiration period in days. */
 export declare const CLAIM_PERIOD_DAYS = 60;
 /**
  * Format USDC amount from smallest unit to human-readable string

package/dist/utils/formatting/currency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/utils/formatting/currency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/utils/formatting/currency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uDAAuD;AACvD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/utils/formatting/currency.js

@@ -1,13 +1,16 @@
 "use strict";
 /**
- * Currency formatting utilities for USDC and other tokens
+ * Currency formatting utilities for USDC and other tokens.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLAIM_PERIOD_DAYS = exports.USDC_DECIMALS = void 0;
 exports.formatUSDC = formatUSDC;
 exports.parseUSDC = parseUSDC;
-// USDC configuration constants
+/** Number of decimal places for USDC token amounts. */
 exports.USDC_DECIMALS = 6;
+/** Revenue claim expiration period in days. */
 exports.CLAIM_PERIOD_DAYS = 60;
 /**
  * Format USDC amount from smallest unit to human-readable string

package/dist/utils/formatting/currency.js.map

@@ -1 +1 @@
-{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../../src/utils/formatting/currency.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAeH,gCAEC;AAWD,8BAEC;AA5BD,+BAA+B;AAClB,QAAA,aAAa,GAAG,CAAC,CAAC;AAClB,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,MAAc;IACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,qBAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,MAAc;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,qBAAa,CAAC,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../../src/utils/formatting/currency.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAiBH,gCAEC;AAWD,8BAEC;AA9BD,uDAAuD;AAC1C,QAAA,aAAa,GAAG,CAAC,CAAC;AAE/B,+CAA+C;AAClC,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,MAAc;IACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,qBAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,MAAc;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,qBAAa,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/utils/formatting/date.cjs

@@ -1,6 +1,8 @@
 "use strict";
 /**
- * Date formatting utilities
+ * Date formatting utilities.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatEmailDate = formatEmailDate;
@@ -11,7 +13,19 @@ exports.isDateInRange = isDateInRange;
 exports.addDays = addDays;
 exports.addHours = addHours;
 /**
- * Format a date for display in email list
+ * Format a date for display in email list.
+ * Returns time for today, "Yesterday", day name for the past week,
+ * or a short date for older messages.
+ *
+ * @param date - Date object or ISO date string
+ * @returns Formatted date string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatEmailDate(new Date()); // "3:45 PM"
+ * formatEmailDate('2024-01-15'); // "Jan 15"
+ * ```
  */
 function formatEmailDate(date) {
     const dateObj = typeof date === 'string' ? new Date(date) : date;
@@ -54,13 +68,32 @@ function formatEmailDate(date) {
     });
 }
 /**
- * Format a timestamp to ISO string
+ * Format a Unix timestamp (ms) to an ISO 8601 string.
+ *
+ * @param timestamp - Unix timestamp in milliseconds
+ * @returns ISO 8601 date string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatTimestamp(1700000000000); // "2023-11-14T22:13:20.000Z"
+ * ```
  */
 function formatTimestamp(timestamp) {
     return new Date(timestamp).toISOString();
 }
 /**
- * Format a date to a relative time string (e.g., "2 hours ago")
+ * Format a date to a relative time string (e.g., "2 hours ago").
+ *
+ * @param date - Date object, ISO string, or Unix timestamp (ms)
+ * @returns Human-readable relative time string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatRelativeTime(Date.now() - 3600000); // "1 hour ago"
+ * formatRelativeTime('2024-01-01'); // "1 year ago"
+ * ```
  */
 function formatRelativeTime(date) {
     const dateObj = typeof date === 'string' || typeof date === 'number'
@@ -99,7 +132,17 @@ function formatRelativeTime(date) {
     return diffYears === 1 ? '1 year ago' : `${diffYears} years ago`;
 }
 /**
- * Parse a date string safely
+ * Parse a date string safely, returning null on invalid input.
+ *
+ * @param dateString - Date string to parse
+ * @returns Parsed Date or null if invalid
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * parseDate('2024-01-15'); // Date object
+ * parseDate('not-a-date'); // null
+ * ```
  */
 function parseDate(dateString) {
     try {
@@ -114,13 +157,24 @@ function parseDate(dateString) {
     }
 }
 /**
- * Check if a date is within a range
+ * Check if a date falls within an inclusive range.
+ *
+ * @param date - Date to check
+ * @param startDate - Range start (inclusive)
+ * @param endDate - Range end (inclusive)
+ * @returns True if date is within the range
+ * @since 1.0.0
  */
 function isDateInRange(date, startDate, endDate) {
     return date >= startDate && date <= endDate;
 }
 /**
- * Add days to a date
+ * Add (or subtract) days from a date. Returns a new Date instance.
+ *
+ * @param date - Starting date
+ * @param days - Number of days to add (negative to subtract)
+ * @returns New Date with days added
+ * @since 1.0.0
  */
 function addDays(date, days) {
     const result = new Date(date);
@@ -128,7 +182,12 @@ function addDays(date, days) {
     return result;
 }
 /**
- * Add hours to a date
+ * Add (or subtract) hours from a date. Returns a new Date instance.
+ *
+ * @param date - Starting date
+ * @param hours - Number of hours to add (negative to subtract)
+ * @returns New Date with hours added
+ * @since 1.0.0
  */
 function addHours(date, hours) {
     const result = new Date(date);

package/dist/utils/formatting/date.d.ts

@@ -1,33 +1,92 @@
 /**
- * Date formatting utilities
+ * Date formatting utilities.
+ *
+ * @since 1.0.0
  */
 import { Optional } from '../../types/common';
 /**
- * Format a date for display in email list
+ * Format a date for display in email list.
+ * Returns time for today, "Yesterday", day name for the past week,
+ * or a short date for older messages.
+ *
+ * @param date - Date object or ISO date string
+ * @returns Formatted date string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatEmailDate(new Date()); // "3:45 PM"
+ * formatEmailDate('2024-01-15'); // "Jan 15"
+ * ```
  */
 export declare function formatEmailDate(date: Date | string): string;
 /**
- * Format a timestamp to ISO string
+ * Format a Unix timestamp (ms) to an ISO 8601 string.
+ *
+ * @param timestamp - Unix timestamp in milliseconds
+ * @returns ISO 8601 date string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatTimestamp(1700000000000); // "2023-11-14T22:13:20.000Z"
+ * ```
  */
 export declare function formatTimestamp(timestamp: number): string;
 /**
- * Format a date to a relative time string (e.g., "2 hours ago")
+ * Format a date to a relative time string (e.g., "2 hours ago").
+ *
+ * @param date - Date object, ISO string, or Unix timestamp (ms)
+ * @returns Human-readable relative time string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatRelativeTime(Date.now() - 3600000); // "1 hour ago"
+ * formatRelativeTime('2024-01-01'); // "1 year ago"
+ * ```
  */
 export declare function formatRelativeTime(date: Date | string | number): string;
 /**
- * Parse a date string safely
+ * Parse a date string safely, returning null on invalid input.
+ *
+ * @param dateString - Date string to parse
+ * @returns Parsed Date or null if invalid
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * parseDate('2024-01-15'); // Date object
+ * parseDate('not-a-date'); // null
+ * ```
  */
 export declare function parseDate(dateString: string): Optional<Date>;
 /**
- * Check if a date is within a range
+ * Check if a date falls within an inclusive range.
+ *
+ * @param date - Date to check
+ * @param startDate - Range start (inclusive)
+ * @param endDate - Range end (inclusive)
+ * @returns True if date is within the range
+ * @since 1.0.0
  */
 export declare function isDateInRange(date: Date, startDate: Date, endDate: Date): boolean;
 /**
- * Add days to a date
+ * Add (or subtract) days from a date. Returns a new Date instance.
+ *
+ * @param date - Starting date
+ * @param days - Number of days to add (negative to subtract)
+ * @returns New Date with days added
+ * @since 1.0.0
  */
 export declare function addDays(date: Date, days: number): Date;
 /**
- * Add hours to a date
+ * Add (or subtract) hours from a date. Returns a new Date instance.
+ *
+ * @param date - Starting date
+ * @param hours - Number of hours to add (negative to subtract)
+ * @returns New Date with hours added
+ * @since 1.0.0
  */
 export declare function addHours(date: Date, hours: number): Date;
 //# sourceMappingURL=date.d.ts.map

package/dist/utils/formatting/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/utils/formatting/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CA8C3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CA6CvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAU5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/utils/formatting/date.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CA8C3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CA6CvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAU5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD"}

package/dist/utils/formatting/date.js

@@ -1,6 +1,8 @@
 "use strict";
 /**
- * Date formatting utilities
+ * Date formatting utilities.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatEmailDate = formatEmailDate;
@@ -11,7 +13,19 @@ exports.isDateInRange = isDateInRange;
 exports.addDays = addDays;
 exports.addHours = addHours;
 /**
- * Format a date for display in email list
+ * Format a date for display in email list.
+ * Returns time for today, "Yesterday", day name for the past week,
+ * or a short date for older messages.
+ *
+ * @param date - Date object or ISO date string
+ * @returns Formatted date string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatEmailDate(new Date()); // "3:45 PM"
+ * formatEmailDate('2024-01-15'); // "Jan 15"
+ * ```
  */
 function formatEmailDate(date) {
     const dateObj = typeof date === 'string' ? new Date(date) : date;
@@ -54,13 +68,32 @@ function formatEmailDate(date) {
     });
 }
 /**
- * Format a timestamp to ISO string
+ * Format a Unix timestamp (ms) to an ISO 8601 string.
+ *
+ * @param timestamp - Unix timestamp in milliseconds
+ * @returns ISO 8601 date string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatTimestamp(1700000000000); // "2023-11-14T22:13:20.000Z"
+ * ```
  */
 function formatTimestamp(timestamp) {
     return new Date(timestamp).toISOString();
 }
 /**
- * Format a date to a relative time string (e.g., "2 hours ago")
+ * Format a date to a relative time string (e.g., "2 hours ago").
+ *
+ * @param date - Date object, ISO string, or Unix timestamp (ms)
+ * @returns Human-readable relative time string
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * formatRelativeTime(Date.now() - 3600000); // "1 hour ago"
+ * formatRelativeTime('2024-01-01'); // "1 year ago"
+ * ```
  */
 function formatRelativeTime(date) {
     const dateObj = typeof date === 'string' || typeof date === 'number'
@@ -99,7 +132,17 @@ function formatRelativeTime(date) {
     return diffYears === 1 ? '1 year ago' : `${diffYears} years ago`;
 }
 /**
- * Parse a date string safely
+ * Parse a date string safely, returning null on invalid input.
+ *
+ * @param dateString - Date string to parse
+ * @returns Parsed Date or null if invalid
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * parseDate('2024-01-15'); // Date object
+ * parseDate('not-a-date'); // null
+ * ```
  */
 function parseDate(dateString) {
     try {
@@ -114,13 +157,24 @@ function parseDate(dateString) {
     }
 }
 /**
- * Check if a date is within a range
+ * Check if a date falls within an inclusive range.
+ *
+ * @param date - Date to check
+ * @param startDate - Range start (inclusive)
+ * @param endDate - Range end (inclusive)
+ * @returns True if date is within the range
+ * @since 1.0.0
  */
 function isDateInRange(date, startDate, endDate) {
     return date >= startDate && date <= endDate;
 }
 /**
- * Add days to a date
+ * Add (or subtract) days from a date. Returns a new Date instance.
+ *
+ * @param date - Starting date
+ * @param days - Number of days to add (negative to subtract)
+ * @returns New Date with days added
+ * @since 1.0.0
  */
 function addDays(date, days) {
     const result = new Date(date);
@@ -128,7 +182,12 @@ function addDays(date, days) {
     return result;
 }
 /**
- * Add hours to a date
+ * Add (or subtract) hours from a date. Returns a new Date instance.
+ *
+ * @param date - Starting date
+ * @param hours - Number of hours to add (negative to subtract)
+ * @returns New Date with hours added
+ * @since 1.0.0
  */
 function addHours(date, hours) {
     const result = new Date(date);

package/dist/utils/formatting/date.js.map

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