@cranberry-money/shared-utils 5.0.1 → 8.0.1

package/dist/auth.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Authentication and token management utilities
+ */
+import type { DeviceInfo, TokenRefreshResponse, TokenRefreshError, AutoRefreshHandler } from '@cranberry-money/shared-types';
+/**
+ * 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;
+/**
+ * Parse device information from user agent string
+ * @param userAgent - The user agent string
+ * @returns Parsed device info
+ */
+export declare function parseDeviceInfo(userAgent: string): DeviceInfo;
+/**
+ * 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;
+/**
+ * Get error message from token refresh error
+ * @param error - The refresh error
+ * @returns Error message string
+ */
+export declare function getRefreshErrorMessage(error: TokenRefreshError): string;
+/**
+ * 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;AAGH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAkBvC;;;;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;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAwB7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAWvE;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/badge-status.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Badge Status Utilities - Status-specific badge functions
+ *
+ * This module provides pre-configured badge functions for common status types
+ * in the MyPortfolio platform. It builds on top of the core badge system.
+ */
+import type { StatusBadgeStyle, TradeStatus, WithdrawalStatus, LiquidationStatus, TargetTradeStatus } from '@cranberry-money/shared-types';
+import type { BadgeSize } from '@cranberry-money/shared-types';
+/**
+ * Creates a badge for trade status
+ *
+ * @param status - Trade status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getTradeStatusBadge(TRADE_STATUS_SETTLED);
+ * // Returns badge with success variant and "Settled" display text
+ * ```
+ */
+export declare function getTradeStatusBadge(status: TradeStatus, size?: BadgeSize): StatusBadgeStyle;
+/**
+ * Creates a badge for withdrawal status
+ *
+ * @param status - Withdrawal status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getWithdrawalStatusBadge(WITHDRAWAL_STATUS_APPROVED);
+ * // Returns badge with success variant and "Approved" display text
+ * ```
+ */
+export declare function getWithdrawalStatusBadge(status: WithdrawalStatus, size?: BadgeSize): StatusBadgeStyle;
+/**
+ * Creates a badge for liquidation status
+ *
+ * @param status - Liquidation status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getLiquidationStatusBadge(LIQUIDATION_STATUS_SETTLED);
+ * // Returns badge with success variant and "Settled" display text
+ * ```
+ */
+export declare function getLiquidationStatusBadge(status: LiquidationStatus, size?: BadgeSize): StatusBadgeStyle;
+/**
+ * Creates a badge for target trade status
+ *
+ * @param status - Target trade status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getTargetTradeStatusBadge(TARGET_TRADE_STATUS_PENDING);
+ * // Returns badge with warning variant and "Pending" display text
+ * ```
+ */
+export declare function getTargetTradeStatusBadge(status: TargetTradeStatus, size?: BadgeSize): StatusBadgeStyle;
+//# sourceMappingURL=badge-status.d.ts.map

package/dist/badge-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge-status.d.ts","sourceRoot":"","sources":["../src/badge-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAmDvC,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAiF7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,GAAE,SAAgB,GAAG,gBAAgB,CAUjG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,GAAE,SAAgB,GAAG,gBAAgB,CAU3G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,SAAgB,GAAG,gBAAgB,CAU7G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,SAAgB,GAAG,gBAAgB,CAU7G"}

package/dist/badge-status.js

@@ -0,0 +1,170 @@
+/**
+ * Badge Status Utilities - Status-specific badge functions
+ *
+ * This module provides pre-configured badge functions for common status types
+ * in the MyPortfolio platform. It builds on top of the core badge system.
+ */
+import { TRADE_STATUS_EXECUTED, TRADE_STATUS_SETTLED, TRADE_STATUS_CANCELLED, TRADE_STATUS_FAILED, TRADE_STATUS_LABEL_EXECUTED, TRADE_STATUS_LABEL_SETTLED, TRADE_STATUS_LABEL_CANCELLED, TRADE_STATUS_LABEL_FAILED, TARGET_TRADE_STATUS_PENDING, TARGET_TRADE_STATUS_APPROVED, TARGET_TRADE_STATUS_SUBMITTED, TARGET_TRADE_STATUS_CANCELLED, TARGET_TRADE_STATUS_EXPIRED, TARGET_TRADE_STATUS_LABEL_PENDING, TARGET_TRADE_STATUS_LABEL_APPROVED, TARGET_TRADE_STATUS_LABEL_SUBMITTED, TARGET_TRADE_STATUS_LABEL_CANCELLED, TARGET_TRADE_STATUS_LABEL_EXPIRED, WITHDRAWAL_STATUS_PENDING_REVIEW, WITHDRAWAL_STATUS_APPROVED, WITHDRAWAL_STATUS_REJECTED, WITHDRAWAL_STATUS_PROCESSING, WITHDRAWAL_STATUS_AWAITING_LIQUIDATION, WITHDRAWAL_STATUS_LIQUIDATION_IN_PROGRESS, WITHDRAWAL_STATUS_COMPLETED, WITHDRAWAL_STATUS_CANCELLED, WITHDRAWAL_STATUS_FAILED, WITHDRAWAL_STATUS_LABEL_PENDING_REVIEW, WITHDRAWAL_STATUS_LABEL_APPROVED, WITHDRAWAL_STATUS_LABEL_REJECTED, WITHDRAWAL_STATUS_LABEL_PROCESSING, WITHDRAWAL_STATUS_LABEL_AWAITING_LIQUIDATION, WITHDRAWAL_STATUS_LABEL_LIQUIDATION_IN_PROGRESS, WITHDRAWAL_STATUS_LABEL_COMPLETED, WITHDRAWAL_STATUS_LABEL_CANCELLED, WITHDRAWAL_STATUS_LABEL_FAILED, LIQUIDATION_STATUS_PENDING, LIQUIDATION_STATUS_TRADES_CREATED, LIQUIDATION_STATUS_EXECUTED, LIQUIDATION_STATUS_SETTLED, LIQUIDATION_STATUS_FAILED, LIQUIDATION_STATUS_LABEL_PENDING, LIQUIDATION_STATUS_LABEL_TRADES_CREATED, LIQUIDATION_STATUS_LABEL_EXECUTED, LIQUIDATION_STATUS_LABEL_SETTLED, LIQUIDATION_STATUS_LABEL_FAILED, } from '@cranberry-money/shared-constants';
+import { createBadge } from './badge';
+// Status to variant mappings
+const TRADE_STATUS_MAPPING = {
+    [TRADE_STATUS_EXECUTED]: 'primary',
+    [TRADE_STATUS_SETTLED]: 'success',
+    [TRADE_STATUS_CANCELLED]: 'error',
+    [TRADE_STATUS_FAILED]: 'error',
+    [TARGET_TRADE_STATUS_PENDING]: 'warning',
+    [TARGET_TRADE_STATUS_SUBMITTED]: 'primary',
+    [TARGET_TRADE_STATUS_EXPIRED]: 'neutral',
+};
+const WITHDRAWAL_STATUS_MAPPING = {
+    [WITHDRAWAL_STATUS_PENDING_REVIEW]: 'warning',
+    [WITHDRAWAL_STATUS_APPROVED]: 'success',
+    [WITHDRAWAL_STATUS_REJECTED]: 'error',
+    [WITHDRAWAL_STATUS_PROCESSING]: 'primary',
+    [WITHDRAWAL_STATUS_AWAITING_LIQUIDATION]: 'warning',
+    [WITHDRAWAL_STATUS_LIQUIDATION_IN_PROGRESS]: 'primary',
+    [WITHDRAWAL_STATUS_COMPLETED]: 'success',
+    [WITHDRAWAL_STATUS_CANCELLED]: 'neutral',
+    [WITHDRAWAL_STATUS_FAILED]: 'error',
+};
+const LIQUIDATION_STATUS_MAPPING = {
+    [LIQUIDATION_STATUS_PENDING]: 'warning',
+    [LIQUIDATION_STATUS_TRADES_CREATED]: 'primary',
+    [LIQUIDATION_STATUS_EXECUTED]: 'primary',
+    [LIQUIDATION_STATUS_SETTLED]: 'success',
+    [LIQUIDATION_STATUS_FAILED]: 'error',
+};
+const TARGET_TRADE_STATUS_MAPPING = {
+    [TARGET_TRADE_STATUS_PENDING]: 'warning',
+    [TARGET_TRADE_STATUS_APPROVED]: 'success',
+    [TARGET_TRADE_STATUS_SUBMITTED]: 'primary',
+    [TARGET_TRADE_STATUS_CANCELLED]: 'error',
+    [TARGET_TRADE_STATUS_EXPIRED]: 'neutral',
+};
+// Status to label mappings
+const TRADE_STATUS_LABELS = {
+    [TRADE_STATUS_EXECUTED]: TRADE_STATUS_LABEL_EXECUTED,
+    [TRADE_STATUS_SETTLED]: TRADE_STATUS_LABEL_SETTLED,
+    [TRADE_STATUS_CANCELLED]: TRADE_STATUS_LABEL_CANCELLED,
+    [TRADE_STATUS_FAILED]: TRADE_STATUS_LABEL_FAILED,
+    [TARGET_TRADE_STATUS_PENDING]: TARGET_TRADE_STATUS_LABEL_PENDING,
+    [TARGET_TRADE_STATUS_SUBMITTED]: TARGET_TRADE_STATUS_LABEL_SUBMITTED,
+    [TARGET_TRADE_STATUS_EXPIRED]: TARGET_TRADE_STATUS_LABEL_EXPIRED,
+};
+const WITHDRAWAL_STATUS_LABELS = {
+    [WITHDRAWAL_STATUS_PENDING_REVIEW]: WITHDRAWAL_STATUS_LABEL_PENDING_REVIEW,
+    [WITHDRAWAL_STATUS_APPROVED]: WITHDRAWAL_STATUS_LABEL_APPROVED,
+    [WITHDRAWAL_STATUS_REJECTED]: WITHDRAWAL_STATUS_LABEL_REJECTED,
+    [WITHDRAWAL_STATUS_PROCESSING]: WITHDRAWAL_STATUS_LABEL_PROCESSING,
+    [WITHDRAWAL_STATUS_AWAITING_LIQUIDATION]: WITHDRAWAL_STATUS_LABEL_AWAITING_LIQUIDATION,
+    [WITHDRAWAL_STATUS_LIQUIDATION_IN_PROGRESS]: WITHDRAWAL_STATUS_LABEL_LIQUIDATION_IN_PROGRESS,
+    [WITHDRAWAL_STATUS_COMPLETED]: WITHDRAWAL_STATUS_LABEL_COMPLETED,
+    [WITHDRAWAL_STATUS_CANCELLED]: WITHDRAWAL_STATUS_LABEL_CANCELLED,
+    [WITHDRAWAL_STATUS_FAILED]: WITHDRAWAL_STATUS_LABEL_FAILED,
+};
+const LIQUIDATION_STATUS_LABELS = {
+    [LIQUIDATION_STATUS_PENDING]: LIQUIDATION_STATUS_LABEL_PENDING,
+    [LIQUIDATION_STATUS_TRADES_CREATED]: LIQUIDATION_STATUS_LABEL_TRADES_CREATED,
+    [LIQUIDATION_STATUS_EXECUTED]: LIQUIDATION_STATUS_LABEL_EXECUTED,
+    [LIQUIDATION_STATUS_SETTLED]: LIQUIDATION_STATUS_LABEL_SETTLED,
+    [LIQUIDATION_STATUS_FAILED]: LIQUIDATION_STATUS_LABEL_FAILED,
+};
+const TARGET_TRADE_STATUS_LABELS = {
+    [TARGET_TRADE_STATUS_PENDING]: TARGET_TRADE_STATUS_LABEL_PENDING,
+    [TARGET_TRADE_STATUS_APPROVED]: TARGET_TRADE_STATUS_LABEL_APPROVED,
+    [TARGET_TRADE_STATUS_SUBMITTED]: TARGET_TRADE_STATUS_LABEL_SUBMITTED,
+    [TARGET_TRADE_STATUS_CANCELLED]: TARGET_TRADE_STATUS_LABEL_CANCELLED,
+    [TARGET_TRADE_STATUS_EXPIRED]: TARGET_TRADE_STATUS_LABEL_EXPIRED,
+};
+/**
+ * Creates a badge for trade status
+ *
+ * @param status - Trade status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getTradeStatusBadge(TRADE_STATUS_SETTLED);
+ * // Returns badge with success variant and "Settled" display text
+ * ```
+ */
+export function getTradeStatusBadge(status, size = 'md') {
+    const variant = TRADE_STATUS_MAPPING[status] || 'neutral';
+    const badge = createBadge({ variant, size });
+    const displayText = TRADE_STATUS_LABELS[status] || status.charAt(0) + status.slice(1).toLowerCase();
+    return {
+        ...badge,
+        displayText,
+        ariaLabel: `Trade status: ${displayText}`,
+    };
+}
+/**
+ * Creates a badge for withdrawal status
+ *
+ * @param status - Withdrawal status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getWithdrawalStatusBadge(WITHDRAWAL_STATUS_APPROVED);
+ * // Returns badge with success variant and "Approved" display text
+ * ```
+ */
+export function getWithdrawalStatusBadge(status, size = 'md') {
+    const variant = WITHDRAWAL_STATUS_MAPPING[status] || 'neutral';
+    const badge = createBadge({ variant, size });
+    const displayText = WITHDRAWAL_STATUS_LABELS[status] || status;
+    return {
+        ...badge,
+        displayText,
+        ariaLabel: `Withdrawal status: ${displayText}`,
+    };
+}
+/**
+ * Creates a badge for liquidation status
+ *
+ * @param status - Liquidation status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getLiquidationStatusBadge(LIQUIDATION_STATUS_SETTLED);
+ * // Returns badge with success variant and "Settled" display text
+ * ```
+ */
+export function getLiquidationStatusBadge(status, size = 'md') {
+    const variant = LIQUIDATION_STATUS_MAPPING[status] || 'neutral';
+    const badge = createBadge({ variant, size });
+    const displayText = LIQUIDATION_STATUS_LABELS[status] || status;
+    return {
+        ...badge,
+        displayText,
+        ariaLabel: `Liquidation status: ${displayText}`,
+    };
+}
+/**
+ * Creates a badge for target trade status
+ *
+ * @param status - Target trade status constant
+ * @param size - Badge size (default: 'md')
+ * @returns Badge style with display text and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * const badge = getTargetTradeStatusBadge(TARGET_TRADE_STATUS_PENDING);
+ * // Returns badge with warning variant and "Pending" display text
+ * ```
+ */
+export function getTargetTradeStatusBadge(status, size = 'md') {
+    const variant = TARGET_TRADE_STATUS_MAPPING[status] || 'neutral';
+    const badge = createBadge({ variant, size });
+    const displayText = TARGET_TRADE_STATUS_LABELS[status] || status;
+    return {
+        ...badge,
+        displayText,
+        ariaLabel: `Target trade status: ${displayText}`,
+    };
+}

package/dist/badge.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Badge System Core - Type definitions and factory function
+ *
+ * This module provides a standardized way to create and style badges.
+ * It ensures consistency in colors, typography, and semantic meaning
+ * while maintaining accessibility standards.
+ *
+ * Note: The actual style classes are designed to work with Tailwind CSS
+ * and assume a specific color system is in place.
+ */
+import type { BadgeVariant, BadgeSize, BadgeConfig, BadgeStyle } from '@cranberry-money/shared-types';
+/**
+ * Creates a badge style configuration with appropriate CSS classes
+ *
+ * @param config - Badge configuration options
+ * @param variantStyles - Optional custom variant styles (defaults to DEFAULT_BADGE_VARIANTS)
+ * @param sizeStyles - Optional custom size styles (defaults to DEFAULT_BADGE_SIZES)
+ * @returns Badge style object with className and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * // Create a success badge
+ * const successBadge = createBadge({ variant: 'success' });
+ * // Returns: { className: 'inline-flex items-center rounded-md font-medium whitespace-nowrap transition-colors bg-success-900/80 text-success-300 text-xs px-2 py-1', ariaLabel: 'success status' }
+ *
+ * // Create a large warning badge with custom class
+ * const warningBadge = createBadge({ variant: 'warning', size: 'lg', className: 'ml-2' });
+ *
+ * // Use custom variant styles
+ * const customVariants = { primary: 'bg-blue-500 text-white', ... };
+ * const customBadge = createBadge({ variant: 'primary' }, customVariants);
+ * ```
+ */
+export declare function createBadge({ variant, size, className }: BadgeConfig, variantStyles?: Record<BadgeVariant, string>, sizeStyles?: Record<BadgeSize, string>): BadgeStyle;
+/**
+ * Export the default style mappings for consumers who want to use them directly
+ * or extend them with their own styles
+ */
+export declare const BADGE_VARIANTS: Record<BadgeVariant, string>;
+export declare const BADGE_SIZES: Record<BadgeSize, string>;
+//# sourceMappingURL=badge.d.ts.map

package/dist/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../src/badge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AA+BtG;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,EAAE,OAAO,EAAE,IAAW,EAAE,SAAc,EAAE,EAAE,WAAW,EACrD,aAAa,GAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAA0B,EACpE,UAAU,GAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAuB,GAC1D,UAAU,CAQZ;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,8BAAyB,CAAC;AACrD,eAAO,MAAM,WAAW,2BAAsB,CAAC"}

package/dist/badge.js

@@ -0,0 +1,72 @@
+/**
+ * Badge System Core - Type definitions and factory function
+ *
+ * This module provides a standardized way to create and style badges.
+ * It ensures consistency in colors, typography, and semantic meaning
+ * while maintaining accessibility standards.
+ *
+ * Note: The actual style classes are designed to work with Tailwind CSS
+ * and assume a specific color system is in place.
+ */
+/**
+ * Default variant styles using Tailwind CSS classes
+ * These assume a specific color system with surface and semantic colors
+ */
+const DEFAULT_BADGE_VARIANTS = {
+    default: 'bg-surface-secondary text-content-body',
+    primary: 'bg-surface-tertiary text-content-secondary',
+    secondary: 'bg-surface-secondary text-content-body',
+    success: 'bg-success-900/80 text-success-300',
+    warning: 'bg-warning-900/80 text-warning-300',
+    error: 'bg-error-900/80 text-error-300',
+    info: 'bg-surface-tertiary text-content-body',
+    neutral: 'bg-surface-secondary text-content-muted',
+};
+/**
+ * Default size styles for badges
+ */
+const DEFAULT_BADGE_SIZES = {
+    sm: 'text-xs px-1.5 py-0.5',
+    md: 'text-xs px-2 py-1',
+    lg: 'text-sm px-3 py-1.5',
+};
+/**
+ * Base badge styles that apply to all badges
+ */
+const BASE_BADGE_STYLES = 'inline-flex items-center rounded-md font-medium whitespace-nowrap transition-colors';
+/**
+ * Creates a badge style configuration with appropriate CSS classes
+ *
+ * @param config - Badge configuration options
+ * @param variantStyles - Optional custom variant styles (defaults to DEFAULT_BADGE_VARIANTS)
+ * @param sizeStyles - Optional custom size styles (defaults to DEFAULT_BADGE_SIZES)
+ * @returns Badge style object with className and accessibility attributes
+ *
+ * @example
+ * ```typescript
+ * // Create a success badge
+ * const successBadge = createBadge({ variant: 'success' });
+ * // Returns: { className: 'inline-flex items-center rounded-md font-medium whitespace-nowrap transition-colors bg-success-900/80 text-success-300 text-xs px-2 py-1', ariaLabel: 'success status' }
+ *
+ * // Create a large warning badge with custom class
+ * const warningBadge = createBadge({ variant: 'warning', size: 'lg', className: 'ml-2' });
+ *
+ * // Use custom variant styles
+ * const customVariants = { primary: 'bg-blue-500 text-white', ... };
+ * const customBadge = createBadge({ variant: 'primary' }, customVariants);
+ * ```
+ */
+export function createBadge({ variant, size = 'md', className = '' }, variantStyles = DEFAULT_BADGE_VARIANTS, sizeStyles = DEFAULT_BADGE_SIZES) {
+    const variantClasses = variantStyles[variant] || variantStyles.neutral;
+    const sizeClasses = sizeStyles[size];
+    return {
+        className: `${BASE_BADGE_STYLES} ${variantClasses} ${sizeClasses} ${className}`.trim(),
+        ariaLabel: `${variant} status`,
+    };
+}
+/**
+ * Export the default style mappings for consumers who want to use them directly
+ * or extend them with their own styles
+ */
+export const BADGE_VARIANTS = DEFAULT_BADGE_VARIANTS;
+export const BADGE_SIZES = DEFAULT_BADGE_SIZES;

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