@sudobility/types 1.9.52 → 1.9.54

package/dist/types/subscription/period.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Subscription Period Types
+ *
+ * Standard subscription periods and utilities for period comparison.
+ */
+/**
+ * Standard subscription periods
+ */
+export type SubscriptionPeriod = 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'lifetime';
+/**
+ * Period ranking for comparison (higher = longer)
+ */
+export declare const PERIOD_RANKS: Record<SubscriptionPeriod, number>;
+/**
+ * All supported periods in order
+ */
+export declare const ALL_PERIODS: SubscriptionPeriod[];
+//# sourceMappingURL=period.d.ts.map

package/dist/types/subscription/period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"period.d.ts","sourceRoot":"","sources":["../../../src/types/subscription/period.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAM3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,kBAAkB,EAM3C,CAAC"}

package/dist/types/subscription/period.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Subscription Period Types
+ *
+ * Standard subscription periods and utilities for period comparison.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_PERIODS = exports.PERIOD_RANKS = void 0;
+/**
+ * Period ranking for comparison (higher = longer)
+ */
+exports.PERIOD_RANKS = {
+    weekly: 1,
+    monthly: 2,
+    quarterly: 3,
+    yearly: 4,
+    lifetime: 5,
+};
+/**
+ * All supported periods in order
+ */
+exports.ALL_PERIODS = [
+    'weekly',
+    'monthly',
+    'quarterly',
+    'yearly',
+    'lifetime',
+];
+//# sourceMappingURL=period.js.map

package/dist/types/subscription/period.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"period.js","sourceRoot":"","sources":["../../../src/types/subscription/period.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAYH;;GAEG;AACU,QAAA,YAAY,GAAuC;IAC9D,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAAyB;IAC/C,QAAQ;IACR,SAAS;IACT,WAAW;IACX,QAAQ;IACR,UAAU;CACX,CAAC"}

package/dist/utils/async-helpers.cjs

@@ -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.d.ts

@@ -1,35 +1,156 @@
 /**
- * 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
  */
 import { Optional } from '../types/common';
+/**
+ * Result type for safe async operations.
+ * Contains either `data` on success or `error` on failure.
+ *
+ * @template T - The success data type
+ * @since 1.0.0
+ */
 type AsyncResult<T> = {
     data?: T;
     error?: Error;
     success: boolean;
 };
 /**
- * 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);
+ * }
+ * ```
  */
 declare const safeAsync: <T>(operation: () => Promise<T>, context?: string) => Promise<AsyncResult<T>>;
 /**
- * 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'
+ * );
+ * ```
  */
 declare const withLoadingState: <T>(operation: () => Promise<T>, setLoading: (loading: boolean) => void, setError: (error: Optional<string>) => void, context?: string) => Promise<Optional<T>>;
 /**
- * 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'
+ * );
+ * ```
  */
 declare const safeParallel: <T extends readonly unknown[]>(operations: readonly [...{ [K in keyof T]: () => Promise<T[K]>; }], context?: string) => Promise<AsyncResult<T>>;
 /**
- * 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'
+ * );
+ * ```
  */
 declare const withTimeout: <T>(operation: () => Promise<T>, timeoutMs: number, context?: string) => Promise<T>;
+/**
+ * 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
+ * );
+ * ```
+ */
 declare const withCache: <T>(key: string, operation: () => Promise<T>, ttlMs?: number) => Promise<T>;
 /**
- * Clear expired cache entries
+ * Clear expired cache entries from the in-memory cache.
+ * @since 1.0.0
  */
 declare const clearExpiredCache: () => void;
+/**
+ * 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');
+ * ```
+ */
 declare const debounceAsync: <T extends unknown[], R>(fn: (...args: T) => Promise<R>, delay: number, key: string) => ((...args: T) => Promise<Optional<R>>);
 export { safeAsync, withLoadingState, safeParallel, withTimeout, withCache, clearExpiredCache, debounceAsync, type AsyncResult, };
 //# sourceMappingURL=async-helpers.d.ts.map

package/dist/utils/async-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/async-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,KAAK,WAAW,CAAC,CAAC,IAAI;IACpB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,SAAS,GAAU,CAAC,EACxB,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,MAAM,KACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CASxB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,gBAAgB,GAAU,CAAC,EAC/B,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,YAAY,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EACtC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,EAC3C,UAAU,MAAM,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAerB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,YAAY,GAAU,CAAC,SAAS,SAAS,OAAO,EAAE,EACtD,YAAY,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAE,CAAC,EACjE,UAAU,MAAM,KACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAaxB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,WAAW,GAAU,CAAC,EAC1B,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,MAAM,EACjB,UAAU,MAAM,KACf,OAAO,CAAC,CAAC,CAcX,CAAC;AAOF,QAAA,MAAM,SAAS,GAAU,CAAC,EACxB,KAAK,MAAM,EACX,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAO,MAAsB,KAC5B,OAAO,CAAC,CAAC,CAWX,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,iBAAiB,QAAO,IAO7B,CAAC;AAOF,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC3C,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,MAAM,EACb,KAAK,MAAM,KACV,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAsBvC,CAAC;AAEF,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,GACjB,CAAC"}
+{"version":3,"file":"async-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/async-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;GAMG;AACH,KAAK,WAAW,CAAC,CAAC,IAAI;IACpB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,QAAA,MAAM,SAAS,GAAU,CAAC,EACxB,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,MAAM,KACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CASxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,gBAAgB,GAAU,CAAC,EAC/B,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,YAAY,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EACtC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,EAC3C,UAAU,MAAM,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAerB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,YAAY,GAAU,CAAC,SAAS,SAAS,OAAO,EAAE,EACtD,YAAY,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAE,CAAC,EACjE,UAAU,MAAM,KACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAaxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,WAAW,GAAU,CAAC,EAC1B,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,MAAM,EACjB,UAAU,MAAM,KACf,OAAO,CAAC,CAAC,CAcX,CAAC;AAOF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,SAAS,GAAU,CAAC,EACxB,KAAK,MAAM,EACX,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAO,MAAsB,KAC5B,OAAO,CAAC,CAAC,CAWX,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,iBAAiB,QAAO,IAO7B,CAAC;AAOF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC3C,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,MAAM,EACb,KAAK,MAAM,KACV,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAsBvC,CAAC;AAEF,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,GACjB,CAAC"}

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"}