@cranberry-money/shared-utils 4.10.0 → 4.12.0

package/dist/auth.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Authentication and token management utilities
+ */
+/**
+ * Check if a token has expired based on its expiration timestamp
+ * @param expiresAt - The expiration timestamp
+ * @returns true if token is expired, false otherwise
+ */
+export declare function isTokenExpired(expiresAt: string): boolean;
+/**
+ * Check if a token will expire within a specified number of minutes
+ * @param expiresAt - The expiration timestamp
+ * @param minutesBeforeExpiry - Minutes before expiry to consider as "expiring soon"
+ * @returns true if token is expiring soon, false otherwise
+ */
+export declare function isTokenExpiringSoon(expiresAt: string, minutesBeforeExpiry?: number): boolean;
+/**
+ * Get the remaining time until token expiry in minutes
+ * @param expiresAt - The expiration timestamp
+ * @returns Number of minutes until expiry
+ */
+export declare function getTimeUntilExpiry(expiresAt: string): number;
+/**
+ * Format the time until expiry in a human-readable format
+ * @param expiresAt - The expiration timestamp
+ * @returns Formatted time string
+ */
+export declare function formatTimeUntilExpiry(expiresAt: string): string;
+/**
+ * Device info structure
+ */
+export interface DeviceInfo {
+    browser: string;
+    os: string;
+}
+/**
+ * Parse device information from user agent string
+ * @param userAgent - The user agent string
+ * @returns Parsed device info
+ */
+export declare function parseDeviceInfo(userAgent: string): DeviceInfo;
+/**
+ * Token refresh response structure
+ */
+export interface TokenRefreshResponse {
+    status?: number;
+    data?: {
+        access?: string;
+        refresh?: string;
+    };
+}
+/**
+ * Check if token refresh was successful
+ * @param response - The refresh response
+ * @returns true if refresh was successful, false otherwise
+ */
+export declare function isRefreshSuccess(response: TokenRefreshResponse): boolean;
+/**
+ * Token refresh error structure
+ */
+export interface TokenRefreshError {
+    response?: {
+        data?: {
+            detail?: string;
+            message?: string;
+        };
+    };
+    message?: string;
+}
+/**
+ * Get error message from token refresh error
+ * @param error - The refresh error
+ * @returns Error message string
+ */
+export declare function getRefreshErrorMessage(error: TokenRefreshError): string;
+/**
+ * Auto refresh handler interface
+ */
+export interface AutoRefreshHandler {
+    start: () => void;
+    stop: () => void;
+}
+/**
+ * Create an auto-refresh handler for tokens
+ * @param refreshCallback - Callback function to refresh token
+ * @param checkInterval - Interval in milliseconds to check for refresh
+ * @returns Auto refresh handler with start/stop methods
+ */
+export declare function createAutoRefreshHandler(refreshCallback: () => Promise<void>, checkInterval?: number): AutoRefreshHandler;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,mBAAmB,GAAE,MAA6C,GACjE,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB/D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAwB7D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE;YACL,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACpC,aAAa,GAAE,MAAc,GAC5B,kBAAkB,CAiBpB"}

package/dist/auth.js

@@ -0,0 +1,135 @@
+/**
+ * Authentication and token management utilities
+ */
+import { DEFAULT_TOKEN_REFRESH_BUFFER_MINUTES, MILLISECONDS_PER_MINUTE, MINUTES_PER_HOUR, HOURS_PER_DAY, TIME_LABEL_EXPIRED, TIME_LABEL_MINUTE, TIME_LABEL_MINUTES, TIME_LABEL_HOUR, TIME_LABEL_HOURS, TIME_LABEL_DAY, TIME_LABEL_DAYS, DEFAULT_UNKNOWN_VALUE, DEFAULT_ERROR_MESSAGE, } from '@cranberry-money/shared-constants';
+/**
+ * Check if a token has expired based on its expiration timestamp
+ * @param expiresAt - The expiration timestamp
+ * @returns true if token is expired, false otherwise
+ */
+export function isTokenExpired(expiresAt) {
+    const expirationTime = new Date(expiresAt).getTime();
+    const currentTime = Date.now();
+    return currentTime >= expirationTime;
+}
+/**
+ * Check if a token will expire within a specified number of minutes
+ * @param expiresAt - The expiration timestamp
+ * @param minutesBeforeExpiry - Minutes before expiry to consider as "expiring soon"
+ * @returns true if token is expiring soon, false otherwise
+ */
+export function isTokenExpiringSoon(expiresAt, minutesBeforeExpiry = DEFAULT_TOKEN_REFRESH_BUFFER_MINUTES) {
+    const expirationTime = new Date(expiresAt).getTime();
+    const currentTime = Date.now();
+    const bufferTime = minutesBeforeExpiry * MILLISECONDS_PER_MINUTE;
+    return currentTime + bufferTime >= expirationTime;
+}
+/**
+ * Get the remaining time until token expiry in minutes
+ * @param expiresAt - The expiration timestamp
+ * @returns Number of minutes until expiry
+ */
+export function getTimeUntilExpiry(expiresAt) {
+    const expirationTime = new Date(expiresAt).getTime();
+    const currentTime = Date.now();
+    const remainingTime = expirationTime - currentTime;
+    if (remainingTime <= 0) {
+        return 0;
+    }
+    return Math.floor(remainingTime / MILLISECONDS_PER_MINUTE);
+}
+/**
+ * Format the time until expiry in a human-readable format
+ * @param expiresAt - The expiration timestamp
+ * @returns Formatted time string
+ */
+export function formatTimeUntilExpiry(expiresAt) {
+    const minutesRemaining = getTimeUntilExpiry(expiresAt);
+    if (minutesRemaining <= 0) {
+        return TIME_LABEL_EXPIRED;
+    }
+    if (minutesRemaining < MINUTES_PER_HOUR) {
+        return minutesRemaining === 1 ? `1 ${TIME_LABEL_MINUTE}` : `${minutesRemaining} ${TIME_LABEL_MINUTES}`;
+    }
+    const hoursRemaining = Math.floor(minutesRemaining / MINUTES_PER_HOUR);
+    if (hoursRemaining < HOURS_PER_DAY) {
+        return hoursRemaining === 1 ? `1 ${TIME_LABEL_HOUR}` : `${hoursRemaining} ${TIME_LABEL_HOURS}`;
+    }
+    const daysRemaining = Math.floor(hoursRemaining / HOURS_PER_DAY);
+    return daysRemaining === 1 ? `1 ${TIME_LABEL_DAY}` : `${daysRemaining} ${TIME_LABEL_DAYS}`;
+}
+/**
+ * Parse device information from user agent string
+ * @param userAgent - The user agent string
+ * @returns Parsed device info
+ */
+export function parseDeviceInfo(userAgent) {
+    const browser = userAgent.includes('Chrome')
+        ? 'Chrome'
+        : userAgent.includes('Firefox')
+            ? 'Firefox'
+            : userAgent.includes('Safari')
+                ? 'Safari'
+                : userAgent.includes('Edge')
+                    ? 'Edge'
+                    : DEFAULT_UNKNOWN_VALUE;
+    const os = userAgent.includes('Windows')
+        ? 'Windows'
+        : userAgent.includes('Mac')
+            ? 'macOS'
+            : userAgent.includes('Linux')
+                ? 'Linux'
+                : userAgent.includes('Android')
+                    ? 'Android'
+                    : userAgent.includes('iOS')
+                        ? 'iOS'
+                        : DEFAULT_UNKNOWN_VALUE;
+    return { browser, os };
+}
+/**
+ * Check if token refresh was successful
+ * @param response - The refresh response
+ * @returns true if refresh was successful, false otherwise
+ */
+export function isRefreshSuccess(response) {
+    return !!(response?.status === 200 && response?.data?.access && response?.data?.refresh);
+}
+/**
+ * Get error message from token refresh error
+ * @param error - The refresh error
+ * @returns Error message string
+ */
+export function getRefreshErrorMessage(error) {
+    if (error.response?.data?.detail) {
+        return error.response.data.detail;
+    }
+    if (error.response?.data?.message) {
+        return error.response.data.message;
+    }
+    if (error.message) {
+        return error.message;
+    }
+    return DEFAULT_ERROR_MESSAGE;
+}
+/**
+ * Create an auto-refresh handler for tokens
+ * @param refreshCallback - Callback function to refresh token
+ * @param checkInterval - Interval in milliseconds to check for refresh
+ * @returns Auto refresh handler with start/stop methods
+ */
+export function createAutoRefreshHandler(refreshCallback, checkInterval = 60000 // 1 minute
+) {
+    let intervalId = null;
+    const start = () => {
+        if (intervalId)
+            return;
+        intervalId = setInterval(refreshCallback, checkInterval);
+    };
+    const stop = () => {
+        if (intervalId) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+    return { start, stop };
+}

package/dist/collections.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Generic collection and array utilities
+ * Pure functions for common array operations with type safety
+ */
+/**
+ * Sort array of objects by a string field
+ * @param items - Array of objects to sort
+ * @param fieldName - Name of the field to sort by
+ * @returns New sorted array
+ */
+export declare function sortByStringField<T>(items: T[], fieldName: keyof T): T[];
+/**
+ * Filter array by text search in a specific field (case-insensitive)
+ * @param items - Array of objects to filter
+ * @param fieldName - Name of the field to search in
+ * @param searchTerm - Search term
+ * @returns Filtered array
+ */
+export declare function filterByTextSearch<T>(items: T[], fieldName: keyof T, searchTerm: string): T[];
+/**
+ * Filter array by boolean field
+ * @param items - Array of objects to filter
+ * @param fieldName - Name of the boolean field
+ * @param value - Boolean value to filter by
+ * @returns Filtered array
+ */
+export declare function filterByBooleanField<T>(items: T[], fieldName: keyof T, value: boolean): T[];
+/**
+ * Find item by exact field match
+ * @param items - Array of objects to search
+ * @param fieldName - Name of the field to match
+ * @param value - Value to match
+ * @returns Found item or undefined
+ */
+export declare function findByField<T>(items: T[], fieldName: keyof T, value: unknown): T | undefined;
+/**
+ * Find item by case-insensitive string field match
+ * @param items - Array of objects to search
+ * @param fieldName - Name of the string field to match
+ * @param value - String value to match (case-insensitive)
+ * @returns Found item or undefined
+ */
+export declare function findByStringField<T>(items: T[], fieldName: keyof T, value: string): T | undefined;
+/**
+ * Extract values from a specific field and sort them
+ * @param items - Array of objects
+ * @param fieldName - Name of the field to extract
+ * @returns Sorted array of extracted values
+ */
+export declare function extractAndSortField<T, K extends keyof T>(items: T[], fieldName: K): T[K][];
+/**
+ * Group array items by the first character of a string field
+ * @param items - Array of objects to group
+ * @param fieldName - Name of the string field to group by
+ * @returns Object with first letters as keys and arrays of items as values
+ */
+export declare function groupByFirstLetter<T>(items: T[], fieldName: keyof T): Record<string, T[]>;
+/**
+ * Group array items by a field value
+ * @param items - Array of objects to group
+ * @param fieldName - Name of the field to group by
+ * @returns Object with field values as keys and arrays of items as values
+ */
+export declare function groupByField<T, K extends keyof T>(items: T[], fieldName: K): Record<string, T[]>;
+/**
+ * Check if any item in array has a specific boolean field value
+ * @param items - Array of objects to check
+ * @param fieldName - Name of the boolean field
+ * @param value - Boolean value to check for
+ * @returns true if any item matches, false otherwise
+ */
+export declare function hasItemWithFieldValue<T>(items: T[], fieldName: keyof T, value: unknown): boolean;
+/**
+ * Count items that match a field value
+ * @param items - Array of objects to count
+ * @param fieldName - Name of the field to check
+ * @param value - Value to count
+ * @returns Number of matching items
+ */
+export declare function countByFieldValue<T>(items: T[], fieldName: keyof T, value: unknown): number;
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE,CAM7F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAE5F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAMjG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAazF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAYhG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAE3F"}

package/dist/collections.js

@@ -0,0 +1,127 @@
+/**
+ * Generic collection and array utilities
+ * Pure functions for common array operations with type safety
+ */
+/**
+ * Sort array of objects by a string field
+ * @param items - Array of objects to sort
+ * @param fieldName - Name of the field to sort by
+ * @returns New sorted array
+ */
+export function sortByStringField(items, fieldName) {
+    return [...items].sort((a, b) => {
+        const aValue = String(a[fieldName]);
+        const bValue = String(b[fieldName]);
+        return aValue.localeCompare(bValue);
+    });
+}
+/**
+ * Filter array by text search in a specific field (case-insensitive)
+ * @param items - Array of objects to filter
+ * @param fieldName - Name of the field to search in
+ * @param searchTerm - Search term
+ * @returns Filtered array
+ */
+export function filterByTextSearch(items, fieldName, searchTerm) {
+    const lowercaseSearch = searchTerm.toLowerCase();
+    return items.filter(item => {
+        const fieldValue = String(item[fieldName]).toLowerCase();
+        return fieldValue.includes(lowercaseSearch);
+    });
+}
+/**
+ * Filter array by boolean field
+ * @param items - Array of objects to filter
+ * @param fieldName - Name of the boolean field
+ * @param value - Boolean value to filter by
+ * @returns Filtered array
+ */
+export function filterByBooleanField(items, fieldName, value) {
+    return items.filter(item => Boolean(item[fieldName]) === value);
+}
+/**
+ * Find item by exact field match
+ * @param items - Array of objects to search
+ * @param fieldName - Name of the field to match
+ * @param value - Value to match
+ * @returns Found item or undefined
+ */
+export function findByField(items, fieldName, value) {
+    return items.find(item => item[fieldName] === value);
+}
+/**
+ * Find item by case-insensitive string field match
+ * @param items - Array of objects to search
+ * @param fieldName - Name of the string field to match
+ * @param value - String value to match (case-insensitive)
+ * @returns Found item or undefined
+ */
+export function findByStringField(items, fieldName, value) {
+    const lowercaseValue = value.toLowerCase();
+    return items.find(item => {
+        const fieldValue = String(item[fieldName]).toLowerCase();
+        return fieldValue === lowercaseValue;
+    });
+}
+/**
+ * Extract values from a specific field and sort them
+ * @param items - Array of objects
+ * @param fieldName - Name of the field to extract
+ * @returns Sorted array of extracted values
+ */
+export function extractAndSortField(items, fieldName) {
+    return items.map(item => item[fieldName]).sort();
+}
+/**
+ * Group array items by the first character of a string field
+ * @param items - Array of objects to group
+ * @param fieldName - Name of the string field to group by
+ * @returns Object with first letters as keys and arrays of items as values
+ */
+export function groupByFirstLetter(items, fieldName) {
+    return items.reduce((groups, item) => {
+        const fieldValue = String(item[fieldName]);
+        const firstLetter = fieldValue.charAt(0).toUpperCase();
+        if (!groups[firstLetter]) {
+            groups[firstLetter] = [];
+        }
+        groups[firstLetter].push(item);
+        return groups;
+    }, {});
+}
+/**
+ * Group array items by a field value
+ * @param items - Array of objects to group
+ * @param fieldName - Name of the field to group by
+ * @returns Object with field values as keys and arrays of items as values
+ */
+export function groupByField(items, fieldName) {
+    return items.reduce((groups, item) => {
+        const fieldValue = String(item[fieldName]);
+        if (!groups[fieldValue]) {
+            groups[fieldValue] = [];
+        }
+        groups[fieldValue].push(item);
+        return groups;
+    }, {});
+}
+/**
+ * Check if any item in array has a specific boolean field value
+ * @param items - Array of objects to check
+ * @param fieldName - Name of the boolean field
+ * @param value - Boolean value to check for
+ * @returns true if any item matches, false otherwise
+ */
+export function hasItemWithFieldValue(items, fieldName, value) {
+    return items.some(item => item[fieldName] === value);
+}
+/**
+ * Count items that match a field value
+ * @param items - Array of objects to count
+ * @param fieldName - Name of the field to check
+ * @param value - Value to count
+ * @returns Number of matching items
+ */
+export function countByFieldValue(items, fieldName, value) {
+    return items.filter(item => item[fieldName] === value).length;
+}

package/dist/downloads.d.ts

@@ -0,0 +1,46 @@
+/**
+ * File download utilities
+ * Browser-based file download functionality
+ */
+/**
+ * Download a blob as a file
+ * Creates a temporary download link and triggers the download
+ * @param blob - The blob to download
+ * @param filename - The filename for the downloaded file
+ */
+export declare function downloadBlob(blob: Blob, filename: string): void;
+/**
+ * Download text content as a file
+ * @param content - Text content to download
+ * @param filename - The filename for the downloaded file
+ * @param mimeType - MIME type for the file (default: text/plain)
+ */
+export declare function downloadTextFile(content: string, filename: string, mimeType?: string): void;
+/**
+ * Download JSON data as a file
+ * @param data - JavaScript object to serialize and download
+ * @param filename - The filename for the downloaded file (should end with .json)
+ */
+export declare function downloadJsonFile(data: unknown, filename: string): void;
+/**
+ * Generate a timestamped filename
+ * @param baseName - Base name for the file (without extension)
+ * @param extension - File extension (with or without leading dot)
+ * @param includeTime - Whether to include time in timestamp (default: false)
+ * @returns Timestamped filename
+ */
+export declare function generateTimestampedFilename(baseName: string, extension: string, includeTime?: boolean): string;
+/**
+ * Download data URL as a file
+ * @param dataUrl - Data URL (data:mime/type;base64,data)
+ * @param filename - The filename for the downloaded file
+ */
+export declare function downloadDataUrl(dataUrl: string, filename: string): void;
+/**
+ * Download CSV data as a file
+ * @param data - Array of objects to convert to CSV
+ * @param filename - The filename for the downloaded file (should end with .csv)
+ * @param headers - Optional custom headers (uses object keys if not provided)
+ */
+export declare function downloadCsvFile<T extends Record<string, unknown>>(data: T[], filename: string, headers?: string[]): void;
+//# sourceMappingURL=downloads.d.ts.map

package/dist/downloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../src/downloads.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS/D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAqB,GAAG,IAAI,CAGzG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,MAAM,CASrH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,CAAC,EAAE,EACT,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,IAAI,CAqBN"}

package/dist/downloads.js

@@ -0,0 +1,91 @@
+/**
+ * File download utilities
+ * Browser-based file download functionality
+ */
+/**
+ * Download a blob as a file
+ * Creates a temporary download link and triggers the download
+ * @param blob - The blob to download
+ * @param filename - The filename for the downloaded file
+ */
+export function downloadBlob(blob, filename) {
+    const url = window.URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.href = url;
+    link.setAttribute('download', filename);
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    window.URL.revokeObjectURL(url);
+}
+/**
+ * Download text content as a file
+ * @param content - Text content to download
+ * @param filename - The filename for the downloaded file
+ * @param mimeType - MIME type for the file (default: text/plain)
+ */
+export function downloadTextFile(content, filename, mimeType = 'text/plain') {
+    const blob = new Blob([content], { type: mimeType });
+    downloadBlob(blob, filename);
+}
+/**
+ * Download JSON data as a file
+ * @param data - JavaScript object to serialize and download
+ * @param filename - The filename for the downloaded file (should end with .json)
+ */
+export function downloadJsonFile(data, filename) {
+    const jsonString = JSON.stringify(data, null, 2);
+    downloadTextFile(jsonString, filename, 'application/json');
+}
+/**
+ * Generate a timestamped filename
+ * @param baseName - Base name for the file (without extension)
+ * @param extension - File extension (with or without leading dot)
+ * @param includeTime - Whether to include time in timestamp (default: false)
+ * @returns Timestamped filename
+ */
+export function generateTimestampedFilename(baseName, extension, includeTime = false) {
+    const now = new Date();
+    const dateString = now.toISOString().split('T')[0]; // YYYY-MM-DD
+    const timeString = now.toTimeString().split(' ')[0]?.replace(/:/g, '-') || '00-00-00'; // HH-MM-SS
+    const cleanExtension = extension.startsWith('.') ? extension : `.${extension}`;
+    const timestamp = includeTime ? `${dateString}-${timeString}` : dateString;
+    return `${baseName}-${timestamp}${cleanExtension}`;
+}
+/**
+ * Download data URL as a file
+ * @param dataUrl - Data URL (data:mime/type;base64,data)
+ * @param filename - The filename for the downloaded file
+ */
+export function downloadDataUrl(dataUrl, filename) {
+    const link = document.createElement('a');
+    link.href = dataUrl;
+    link.setAttribute('download', filename);
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+}
+/**
+ * Download CSV data as a file
+ * @param data - Array of objects to convert to CSV
+ * @param filename - The filename for the downloaded file (should end with .csv)
+ * @param headers - Optional custom headers (uses object keys if not provided)
+ */
+export function downloadCsvFile(data, filename, headers) {
+    if (data.length === 0) {
+        throw new Error('Cannot create CSV from empty data array');
+    }
+    const csvHeaders = headers || Object.keys(data[0] || {});
+    const csvRows = data.map(row => csvHeaders
+        .map(header => {
+        const value = row[header];
+        // Escape commas and quotes in CSV values
+        const stringValue = String(value ?? '');
+        return stringValue.includes(',') || stringValue.includes('"')
+            ? `"${stringValue.replace(/"/g, '""')}"`
+            : stringValue;
+    })
+        .join(','));
+    const csvContent = [csvHeaders.join(','), ...csvRows].join('\n');
+    downloadTextFile(csvContent, filename, 'text/csv');
+}

package/dist/index.d.ts

@@ -17,4 +17,10 @@ export { formatWithdrawalAmount, formatLiquidationValue, formatSharesQuantity, c
 export type { PasswordValidation, EmailConfirmationValidation, ExtendedPasswordValidation } from './validation';
 export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, } from './validation';
 export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';
+export type { DeviceInfo, TokenRefreshResponse, TokenRefreshError, AutoRefreshHandler } from './auth';
+export { isTokenExpired, isTokenExpiringSoon, getTimeUntilExpiry, formatTimeUntilExpiry, parseDeviceInfo, isRefreshSuccess, getRefreshErrorMessage, createAutoRefreshHandler, } from './auth';
+export type { InstrumentTypeInfo, InstrumentBasicInfo, PriceChangeResult, PriceSnapshot, FormattedPriceChange, TradeableInstrument, MarketDataInfo, } from './instruments';
+export { formatInstrumentPrice, getCurrencySymbol, getInstrumentType, formatInstrumentName, calculatePriceChange, formatPriceChange, isInstrumentTradeable, formatMarketCap, formatVolume, hasMarketData, } from './instruments';
+export { sortByStringField, filterByTextSearch, filterByBooleanField, findByField, findByStringField, extractAndSortField, groupByFirstLetter, groupByField, hasItemWithFieldValue, countByFieldValue, } from './collections';
+export { downloadBlob, downloadTextFile, downloadJsonFile, generateTimestampedFilename, downloadDataUrl, downloadCsvFile, } from './downloads';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGjF,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,EACrC,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGnE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhH,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAChH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -18,3 +18,9 @@ export { formatWithdrawalAmount, formatLiquidationValue, formatSharesQuantity, c
 export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, } from './validation';
 // Filter utilities
 export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';
+export { isTokenExpired, isTokenExpiringSoon, getTimeUntilExpiry, formatTimeUntilExpiry, parseDeviceInfo, isRefreshSuccess, getRefreshErrorMessage, createAutoRefreshHandler, } from './auth';
+export { formatInstrumentPrice, getCurrencySymbol, getInstrumentType, formatInstrumentName, calculatePriceChange, formatPriceChange, isInstrumentTradeable, formatMarketCap, formatVolume, hasMarketData, } from './instruments';
+// Collection utilities
+export { sortByStringField, filterByTextSearch, filterByBooleanField, findByField, findByStringField, extractAndSortField, groupByFirstLetter, groupByField, hasItemWithFieldValue, countByFieldValue, } from './collections';
+// Download utilities
+export { downloadBlob, downloadTextFile, downloadJsonFile, generateTimestampedFilename, downloadDataUrl, downloadCsvFile, } from './downloads';

package/dist/instruments.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Instrument and market data formatting utilities
+ */
+/**
+ * Format instrument price with currency symbol
+ * @param price - The price as string
+ * @param currency - The currency code
+ * @returns Formatted price with currency symbol
+ */
+export declare function formatInstrumentPrice(price: string, currency?: string | null): string;
+/**
+ * Get currency symbol for display
+ * @param currency - The currency code
+ * @returns Currency symbol
+ */
+export declare function getCurrencySymbol(currency?: string | null): string;
+/**
+ * Instrument interface for type determination
+ */
+export interface InstrumentTypeInfo {
+    isEtf?: boolean;
+    isFund?: boolean;
+}
+/**
+ * Determine instrument type based on flags
+ * @param instrument - The instrument with type flags
+ * @returns Instrument type string
+ */
+export declare function getInstrumentType(instrument: InstrumentTypeInfo): string;
+/**
+ * Basic instrument info for formatting
+ */
+export interface InstrumentBasicInfo {
+    symbol: string;
+    name: string;
+}
+/**
+ * Format instrument display name with symbol
+ * @param instrument - The instrument with symbol and name
+ * @returns Formatted display name
+ */
+export declare function formatInstrumentName(instrument: InstrumentBasicInfo): string;
+/**
+ * Price change calculation result
+ */
+export interface PriceChangeResult {
+    change: number;
+    changePercent: number;
+    isPositive: boolean;
+}
+/**
+ * Snapshot data for price change calculation
+ */
+export interface PriceSnapshot {
+    change: string;
+    changePercent: string;
+}
+/**
+ * Calculate price change from snapshot
+ * @param snapshot - The price snapshot
+ * @returns Price change calculation result
+ */
+export declare function calculatePriceChange(snapshot: PriceSnapshot): PriceChangeResult;
+/**
+ * Formatted price change result
+ */
+export interface FormattedPriceChange {
+    changeText: string;
+    changePercentText: string;
+    colorClass: string;
+}
+/**
+ * Format price change with appropriate color class
+ * @param snapshot - The price snapshot
+ * @returns Formatted price change with color class
+ */
+export declare function formatPriceChange(snapshot: PriceSnapshot): FormattedPriceChange;
+/**
+ * Tradeable instrument info
+ */
+export interface TradeableInstrument {
+    isActive: boolean;
+    isActivelyTrading: boolean;
+}
+/**
+ * Check if instrument is actively tradeable
+ * @param instrument - The instrument with trading flags
+ * @returns true if tradeable, false otherwise
+ */
+export declare function isInstrumentTradeable(instrument: TradeableInstrument): boolean;
+/**
+ * Format market cap value
+ * @param marketCap - The market cap value as string or null
+ * @returns Formatted market cap string
+ */
+export declare function formatMarketCap(marketCap: string | null | undefined): string;
+/**
+ * Format trading volume
+ * @param volume - The volume number
+ * @returns Formatted volume string
+ */
+export declare function formatVolume(volume: number): string;
+/**
+ * Market data availability info
+ */
+export interface MarketDataInfo {
+    openPrice?: string | null;
+    dayHigh?: string | null;
+    dayLow?: string | null;
+    volume?: number | null;
+}
+/**
+ * Check if market data is available
+ * @param marketData - The market data to check
+ * @returns true if market data is available, false otherwise
+ */
+export declare function hasMarketData(marketData: MarketDataInfo): boolean;
+//# sourceMappingURL=instruments.d.ts.map

package/dist/instruments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.d.ts","sourceRoot":"","sources":["../src/instruments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAalE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAIxE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,iBAAiB,CAS/E;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,oBAAoB,CAY/E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAEjE"}

package/dist/instruments.js

@@ -0,0 +1,135 @@
+/**
+ * Instrument and market data formatting utilities
+ */
+import { INSTRUMENT_TYPE_ETF, INSTRUMENT_TYPE_FUND, INSTRUMENT_TYPE_STOCK, CURRENCY_USD, CURRENCY_AUD, } from '@cranberry-money/shared-constants';
+/**
+ * Format instrument price with currency symbol
+ * @param price - The price as string
+ * @param currency - The currency code
+ * @returns Formatted price with currency symbol
+ */
+export function formatInstrumentPrice(price, currency) {
+    const numericPrice = parseFloat(price);
+    if (isNaN(numericPrice))
+        return price;
+    const currencySymbol = getCurrencySymbol(currency);
+    return `${currencySymbol}${numericPrice.toFixed(2)}`;
+}
+/**
+ * Get currency symbol for display
+ * @param currency - The currency code
+ * @returns Currency symbol
+ */
+export function getCurrencySymbol(currency) {
+    switch (currency) {
+        case CURRENCY_USD:
+            return '$';
+        case CURRENCY_AUD:
+            return 'A$';
+        case 'EUR':
+            return '€';
+        case 'GBP':
+            return '£';
+        default:
+            return '$'; // Default to USD symbol
+    }
+}
+/**
+ * Determine instrument type based on flags
+ * @param instrument - The instrument with type flags
+ * @returns Instrument type string
+ */
+export function getInstrumentType(instrument) {
+    if (instrument.isEtf)
+        return INSTRUMENT_TYPE_ETF;
+    if (instrument.isFund)
+        return INSTRUMENT_TYPE_FUND;
+    return INSTRUMENT_TYPE_STOCK;
+}
+/**
+ * Format instrument display name with symbol
+ * @param instrument - The instrument with symbol and name
+ * @returns Formatted display name
+ */
+export function formatInstrumentName(instrument) {
+    return `${instrument.symbol} - ${instrument.name}`;
+}
+/**
+ * Calculate price change from snapshot
+ * @param snapshot - The price snapshot
+ * @returns Price change calculation result
+ */
+export function calculatePriceChange(snapshot) {
+    const change = parseFloat(snapshot.change);
+    const changePercent = parseFloat(snapshot.changePercent);
+    return {
+        change,
+        changePercent,
+        isPositive: change >= 0,
+    };
+}
+/**
+ * Format price change with appropriate color class
+ * @param snapshot - The price snapshot
+ * @returns Formatted price change with color class
+ */
+export function formatPriceChange(snapshot) {
+    const { change, changePercent, isPositive } = calculatePriceChange(snapshot);
+    const changeText = `${isPositive ? '+' : ''}${change.toFixed(2)}`;
+    const changePercentText = `${isPositive ? '+' : ''}${changePercent.toFixed(2)}%`;
+    const colorClass = isPositive ? 'text-positive' : 'text-negative';
+    return {
+        changeText,
+        changePercentText,
+        colorClass,
+    };
+}
+/**
+ * Check if instrument is actively tradeable
+ * @param instrument - The instrument with trading flags
+ * @returns true if tradeable, false otherwise
+ */
+export function isInstrumentTradeable(instrument) {
+    return instrument.isActive && instrument.isActivelyTrading;
+}
+/**
+ * Format market cap value
+ * @param marketCap - The market cap value as string or null
+ * @returns Formatted market cap string
+ */
+export function formatMarketCap(marketCap) {
+    if (!marketCap)
+        return 'N/A';
+    const marketCapValue = parseFloat(marketCap);
+    if (isNaN(marketCapValue))
+        return 'N/A';
+    if (marketCapValue >= 1e12)
+        return `$${(marketCapValue / 1e12).toFixed(1)}T`;
+    if (marketCapValue >= 1e9)
+        return `$${(marketCapValue / 1e9).toFixed(1)}B`;
+    if (marketCapValue >= 1e6)
+        return `$${(marketCapValue / 1e6).toFixed(1)}M`;
+    return `$${marketCapValue.toFixed(0)}`;
+}
+/**
+ * Format trading volume
+ * @param volume - The volume number
+ * @returns Formatted volume string
+ */
+export function formatVolume(volume) {
+    if (volume >= 1e9)
+        return `${(volume / 1e9).toFixed(1)}B`;
+    if (volume >= 1e6)
+        return `${(volume / 1e6).toFixed(1)}M`;
+    if (volume >= 1e3)
+        return `${(volume / 1e3).toFixed(1)}K`;
+    return volume.toString();
+}
+/**
+ * Check if market data is available
+ * @param marketData - The market data to check
+ * @returns true if market data is available, false otherwise
+ */
+export function hasMarketData(marketData) {
+    return Boolean(marketData.openPrice || marketData.dayHigh || marketData.dayLow || marketData.volume);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cranberry-money/shared-utils",
-  "version": "4.10.0",
+  "version": "4.12.0",
   "description": "Shared utility functions for MyPortfolio platform",
   "type": "module",
   "main": "dist/index.js",