@cranberry-money/shared-constants 8.11.0 → 8.13.0

package/dist/config.d.ts

@@ -0,0 +1,108 @@
+export declare const DEFAULT_STRINGS: {
+    readonly EMPTY: "";
+    readonly UNKNOWN: "Unknown";
+    readonly NOT_APPLICABLE: "N/A";
+    readonly ERROR_MESSAGE: "An error occurred";
+    readonly ZERO: "0";
+    readonly NULL_UUID: "00000000-0000-0000-0000-000000000000";
+};
+export declare const DEFAULT_NUMBERS: {
+    readonly ZERO: 0;
+    readonly PRECISION: 2;
+    readonly PERCENTAGE_PRECISION: 2;
+    readonly QUANTITY_PRECISION: 6;
+};
+export declare const LOCALE_CONFIG: {
+    readonly DEFAULT: "en-AU";
+    readonly FALLBACK: "en-US";
+    readonly SUPPORTED: readonly ["en-AU", "en-US", "en-GB"];
+};
+export type SupportedLocale = (typeof LOCALE_CONFIG.SUPPORTED)[number];
+export declare const CONFIG_ALLOCATION_DEFAULTS: {
+    readonly DEFAULT_PERCENTAGE: 10;
+    readonly PERCENTAGE_PRECISION: 0.01;
+    readonly TARGET_TOTAL: 100;
+};
+export declare const DEFAULT_FORMAT_OPTIONS: {
+    readonly CURRENCY: {
+        readonly style: "currency";
+        readonly minimumFractionDigits: 2;
+        readonly maximumFractionDigits: 2;
+    };
+    readonly CURRENCY_SIGNED: {
+        readonly style: "currency";
+        readonly minimumFractionDigits: 2;
+        readonly maximumFractionDigits: 2;
+        readonly signDisplay: "always";
+    };
+    readonly PERCENTAGE: {
+        readonly style: "percent";
+        readonly minimumFractionDigits: 0;
+        readonly maximumFractionDigits: 2;
+    };
+    readonly DECIMAL: {
+        readonly style: "decimal";
+        readonly minimumFractionDigits: 0;
+        readonly maximumFractionDigits: 8;
+    };
+};
+export declare const PAGINATION_CONFIG: {
+    readonly DEFAULT_PAGE: 1;
+    readonly DEFAULT_PAGE_SIZE: 20;
+    readonly MIN_PAGE_SIZE: 1;
+    readonly MAX_PAGE_SIZE: 100;
+    readonly PAGE_SIZE_OPTIONS: readonly [10, 20, 50, 100];
+    readonly DEFAULT_SORT_ORDER: "desc";
+};
+export type PageSizeOption = (typeof PAGINATION_CONFIG.PAGE_SIZE_OPTIONS)[number];
+export declare const getValidPageSize: (pageSize: number) => number;
+export declare const getValidPageNumber: (page: number) => number;
+export declare const COMMON_THRESHOLDS: {
+    readonly THOUSAND: 1000;
+    readonly MILLION: 1000000;
+    readonly BILLION: 1000000000;
+    readonly DEFAULT_DECIMALS: 2;
+    readonly CURRENCY_DECIMALS: 2;
+    readonly PERCENTAGE_DECIMALS: 2;
+    readonly QUANTITY_DECIMALS: 6;
+    readonly PRICE_DECIMALS: 4;
+    readonly MAX_NAME_LENGTH: 100;
+    readonly MAX_DESCRIPTION_LENGTH: 500;
+    readonly MAX_NOTES_LENGTH: 1000;
+    readonly MIN_PASSWORD_LENGTH: 8;
+    readonly MAX_FILE_SIZE_MB: 10;
+    readonly MAX_FILE_NAME_LENGTH: 255;
+    readonly MIN_PORTFOLIO_VALUE: 1000;
+    readonly MIN_TRADE_AMOUNT: 10;
+    readonly MIN_WITHDRAWAL_AMOUNT: 100;
+    readonly MAX_PORTFOLIOS_PER_USER: 10;
+    readonly MAX_TRADES_PER_DAY: 100;
+    readonly MIN_DISPLAY_AMOUNT: 0.01;
+    readonly MIN_DISPLAY_PERCENTAGE: 0.01;
+    readonly DEFAULT_TIMEOUT_MS: 30000;
+    readonly DEFAULT_RETRY_ATTEMPTS: 3;
+    readonly DEFAULT_RETRY_DELAY_MS: 1000;
+    readonly MAX_RETRY_DELAY_MS: 10000;
+    readonly REQUEST_DEBOUNCE_MS: 300;
+};
+export declare const NUMERIC_RANGES: {
+    readonly AMOUNT: {
+        readonly MIN: 0;
+        readonly MAX: 999999999.99;
+    };
+    readonly PERCENTAGE: {
+        readonly MIN: 0;
+        readonly MAX: 100;
+    };
+    readonly QUANTITY: {
+        readonly MIN: 0;
+        readonly MAX: 999999999.999999;
+    };
+};
+export declare const formatWithThousandSeparator: (value: number) => string;
+export declare const NUMBER_ABBREVIATIONS: {
+    readonly THOUSAND: "K";
+    readonly MILLION: "M";
+    readonly BILLION: "B";
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,0BAA0B;;;;CAI7B,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;CAsBzB,CAAC;AAMX,eAAO,MAAM,iBAAiB;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAQnD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAEjD,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,eAAO,MAAM,2BAA2B,GAAI,OAAO,MAAM,KAAG,MAW3D,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC"}

package/dist/config.js

@@ -0,0 +1,136 @@
+// ============================================
+// Default Values
+// ============================================
+export const DEFAULT_STRINGS = {
+    EMPTY: '',
+    UNKNOWN: 'Unknown',
+    NOT_APPLICABLE: 'N/A',
+    ERROR_MESSAGE: 'An error occurred',
+    ZERO: '0',
+    NULL_UUID: '00000000-0000-0000-0000-000000000000',
+};
+export const DEFAULT_NUMBERS = {
+    ZERO: 0,
+    PRECISION: 2,
+    PERCENTAGE_PRECISION: 2,
+    QUANTITY_PRECISION: 6,
+};
+export const LOCALE_CONFIG = {
+    DEFAULT: 'en-AU',
+    FALLBACK: 'en-US',
+    SUPPORTED: ['en-AU', 'en-US', 'en-GB'],
+};
+export const CONFIG_ALLOCATION_DEFAULTS = {
+    DEFAULT_PERCENTAGE: 10,
+    PERCENTAGE_PRECISION: 0.01,
+    TARGET_TOTAL: 100,
+};
+export const DEFAULT_FORMAT_OPTIONS = {
+    CURRENCY: {
+        style: 'currency',
+        minimumFractionDigits: DEFAULT_NUMBERS.PRECISION,
+        maximumFractionDigits: DEFAULT_NUMBERS.PRECISION,
+    },
+    CURRENCY_SIGNED: {
+        style: 'currency',
+        minimumFractionDigits: DEFAULT_NUMBERS.PRECISION,
+        maximumFractionDigits: DEFAULT_NUMBERS.PRECISION,
+        signDisplay: 'always',
+    },
+    PERCENTAGE: {
+        style: 'percent',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: DEFAULT_NUMBERS.PERCENTAGE_PRECISION,
+    },
+    DECIMAL: {
+        style: 'decimal',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 8,
+    },
+};
+// ============================================
+// Pagination
+// ============================================
+export const PAGINATION_CONFIG = {
+    DEFAULT_PAGE: 1,
+    DEFAULT_PAGE_SIZE: 20,
+    MIN_PAGE_SIZE: 1,
+    MAX_PAGE_SIZE: 100,
+    PAGE_SIZE_OPTIONS: [10, 20, 50, 100],
+    DEFAULT_SORT_ORDER: 'desc',
+};
+export const getValidPageSize = (pageSize) => {
+    if (pageSize < PAGINATION_CONFIG.MIN_PAGE_SIZE) {
+        return PAGINATION_CONFIG.MIN_PAGE_SIZE;
+    }
+    if (pageSize > PAGINATION_CONFIG.MAX_PAGE_SIZE) {
+        return PAGINATION_CONFIG.MAX_PAGE_SIZE;
+    }
+    return pageSize;
+};
+export const getValidPageNumber = (page) => {
+    return Math.max(PAGINATION_CONFIG.DEFAULT_PAGE, page);
+};
+// ============================================
+// Thresholds and Limits
+// ============================================
+export const COMMON_THRESHOLDS = {
+    THOUSAND: 1000,
+    MILLION: 1000000,
+    BILLION: 1000000000,
+    DEFAULT_DECIMALS: 2,
+    CURRENCY_DECIMALS: 2,
+    PERCENTAGE_DECIMALS: 2,
+    QUANTITY_DECIMALS: 6,
+    PRICE_DECIMALS: 4,
+    MAX_NAME_LENGTH: 100,
+    MAX_DESCRIPTION_LENGTH: 500,
+    MAX_NOTES_LENGTH: 1000,
+    MIN_PASSWORD_LENGTH: 8,
+    MAX_FILE_SIZE_MB: 10,
+    MAX_FILE_NAME_LENGTH: 255,
+    MIN_PORTFOLIO_VALUE: 1000,
+    MIN_TRADE_AMOUNT: 10,
+    MIN_WITHDRAWAL_AMOUNT: 100,
+    MAX_PORTFOLIOS_PER_USER: 10,
+    MAX_TRADES_PER_DAY: 100,
+    MIN_DISPLAY_AMOUNT: 0.01,
+    MIN_DISPLAY_PERCENTAGE: 0.01,
+    DEFAULT_TIMEOUT_MS: 30000,
+    DEFAULT_RETRY_ATTEMPTS: 3,
+    DEFAULT_RETRY_DELAY_MS: 1000,
+    MAX_RETRY_DELAY_MS: 10000,
+    REQUEST_DEBOUNCE_MS: 300,
+};
+export const NUMERIC_RANGES = {
+    AMOUNT: {
+        MIN: 0,
+        MAX: 999999999.99,
+    },
+    PERCENTAGE: {
+        MIN: 0,
+        MAX: 100,
+    },
+    QUANTITY: {
+        MIN: 0,
+        MAX: 999999999.999999,
+    },
+};
+export const formatWithThousandSeparator = (value) => {
+    if (value >= COMMON_THRESHOLDS.BILLION) {
+        return `${(value / COMMON_THRESHOLDS.BILLION).toFixed(1)}B`;
+    }
+    if (value >= COMMON_THRESHOLDS.MILLION) {
+        return `${(value / COMMON_THRESHOLDS.MILLION).toFixed(1)}M`;
+    }
+    if (value >= COMMON_THRESHOLDS.THOUSAND) {
+        return `${(value / COMMON_THRESHOLDS.THOUSAND).toFixed(1)}K`;
+    }
+    return value.toString();
+};
+export const NUMBER_ABBREVIATIONS = {
+    THOUSAND: 'K',
+    MILLION: 'M',
+    BILLION: 'B',
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/utilities.d.ts

@@ -0,0 +1,209 @@
+export declare const DECIMAL_PLACES: 2;
+export declare const DEFAULT_NUMERIC_ZERO: 0;
+export declare const DEFAULT_EMPTY_STRING: "";
+export declare const QUANTITY_FORMAT_THRESHOLD_MILLION: 1000000;
+export declare const QUANTITY_FORMAT_THRESHOLD_THOUSAND: 1000;
+export declare const ERROR_TYPE_BUSINESS_LOGIC = "business_logic";
+export declare const ERROR_TYPE_PERMISSION = "permission";
+export declare const ERROR_TYPE_SERVER = "server";
+export declare const LOCALE_AUSTRALIA: "en-AU";
+export declare const NUMBER_FORMAT_OPTIONS_CURRENCY: {
+    readonly style: "currency";
+    readonly minimumFractionDigits: 2;
+    readonly maximumFractionDigits: 2;
+};
+export declare const NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED: {
+    readonly style: "currency";
+    readonly minimumFractionDigits: 2;
+    readonly maximumFractionDigits: 2;
+    readonly signDisplay: "always";
+};
+export declare const QUERY_PARAM_ORDER_BY = "order_by";
+export declare const ORDER_BY_CREATED_AT = "created_at";
+export declare const DEFAULT_UNKNOWN_VALUE: "Unknown";
+export declare const DEFAULT_ERROR_MESSAGE: "An error occurred";
+export declare const DEFAULT_VALUES: {
+    readonly ZERO: "0";
+    readonly EMPTY_STRING: "";
+    readonly UNKNOWN: "UNKNOWN";
+    readonly NOT_APPLICABLE: "N/A";
+    readonly NULL_UUID: "00000000-0000-0000-0000-000000000000";
+};
+export declare const NUMERIC_DEFAULTS: {
+    readonly MIN_AMOUNT: 0;
+    readonly MAX_AMOUNT: 999999999.99;
+    readonly DEFAULT_PRECISION: 2;
+    readonly PERCENTAGE_PRECISION: 2;
+    readonly QUANTITY_PRECISION: 6;
+};
+export declare const THRESHOLDS: {
+    readonly MIN_PORTFOLIO_VALUE: 1000;
+    readonly MIN_TRADE_AMOUNT: 10;
+    readonly MIN_WITHDRAWAL_AMOUNT: 100;
+    readonly MAX_PORTFOLIOS_PER_USER: 10;
+    readonly MAX_TRADES_PER_DAY: 100;
+};
+export declare const DISPLAY_LIMITS: {
+    readonly MAX_NAME_LENGTH: 100;
+    readonly MAX_DESCRIPTION_LENGTH: 500;
+    readonly MAX_NOTES_LENGTH: 1000;
+    readonly MAX_FILE_SIZE_MB: 10;
+    readonly MAX_FILE_NAME_LENGTH: 255;
+    readonly DASHBOARD_RECENT_TRADES: 5;
+    readonly DASHBOARD_TARGET_TRADES: 5;
+    readonly DASHBOARD_TRANSACTIONS: 5;
+    readonly DASHBOARD_WITHDRAWALS: 5;
+    readonly DEFAULT_PAGE_SIZE: 20;
+    readonly PAGE_SIZE_OPTIONS: readonly [10, 20, 50, 100];
+    readonly AUTOCOMPLETE_MAX_RESULTS: 10;
+    readonly RECENT_SEARCHES_MAX: 5;
+};
+export declare const ALLOCATION_DEFAULTS: {
+    readonly DEFAULT_PERCENTAGE: 10;
+    readonly PERCENTAGE_PRECISION: 0.01;
+    readonly TARGET_TOTAL: 100;
+};
+export declare const SORT_DIRECTION: {
+    readonly ASC: "asc";
+    readonly DESC: "desc";
+};
+export type SortDirection = (typeof SORT_DIRECTION)[keyof typeof SORT_DIRECTION];
+export declare const SORT_FIELDS: {
+    readonly CREATED_AT: "created_at";
+    readonly UPDATED_AT: "updated_at";
+    readonly DATE: "date";
+    readonly NAME: "name";
+    readonly TITLE: "title";
+    readonly AMOUNT: "amount";
+    readonly VALUE: "value";
+    readonly PRICE: "price";
+    readonly QUANTITY: "quantity";
+    readonly STATUS: "status";
+    readonly PRIORITY: "priority";
+    readonly SYMBOL: "symbol";
+    readonly TYPE: "type";
+};
+export type SortField = (typeof SORT_FIELDS)[keyof typeof SORT_FIELDS];
+export declare const DEFAULT_SORT_CONFIG: {
+    readonly PORTFOLIOS: {
+        readonly field: "updated_at";
+        readonly direction: "desc";
+    };
+    readonly TRADES: {
+        readonly field: "created_at";
+        readonly direction: "desc";
+    };
+    readonly WITHDRAWALS: {
+        readonly field: "created_at";
+        readonly direction: "desc";
+    };
+    readonly TRANSACTIONS: {
+        readonly field: "date";
+        readonly direction: "desc";
+    };
+};
+export declare const SORT_DIRECTION_ASC: "asc";
+export declare const SORT_DIRECTION_DESC: "desc";
+export declare const MILLISECONDS: {
+    readonly SECOND: 1000;
+    readonly MINUTE: number;
+    readonly HOUR: number;
+    readonly DAY: number;
+    readonly WEEK: number;
+};
+export declare const SECONDS: {
+    readonly MINUTE: 60;
+    readonly HOUR: number;
+    readonly DAY: number;
+    readonly WEEK: number;
+};
+export declare const DATE_FORMATS: {
+    readonly DISPLAY_DATE: "MMM dd, yyyy";
+    readonly DISPLAY_DATE_TIME: "MMM dd, yyyy HH:mm";
+    readonly DISPLAY_DATE_TIME_SECONDS: "MMM dd, yyyy HH:mm:ss";
+    readonly DISPLAY_SHORT: "MM/dd/yy";
+    readonly API_DATE: "yyyy-MM-dd";
+    readonly API_DATETIME: "yyyy-MM-dd'T'HH:mm:ss";
+    readonly API_DATETIME_WITH_TIMEZONE: "yyyy-MM-dd'T'HH:mm:ss'Z'";
+    readonly MONTH_YEAR: "MMM yyyy";
+    readonly YEAR: "yyyy";
+    readonly TIME: "HH:mm";
+    readonly TIME_WITH_SECONDS: "HH:mm:ss";
+};
+export declare const TIME_ZONES: {
+    readonly UTC: "UTC";
+    readonly EST: "America/New_York";
+    readonly PST: "America/Los_Angeles";
+    readonly SYDNEY: "Australia/Sydney";
+    readonly MELBOURNE: "Australia/Melbourne";
+};
+export type TimeZone = (typeof TIME_ZONES)[keyof typeof TIME_ZONES];
+export declare const SESSION_DURATIONS: {
+    readonly DEFAULT: number;
+    readonly EXTENDED: number;
+    readonly REMEMBER_ME: number;
+};
+export declare const MILLISECONDS_PER_DAY: number;
+export declare const DEFAULT_RECENT_TRANSACTIONS_DAYS = 30;
+export declare const DATE_ISO_TIME_SEPARATOR = "T";
+export type TimeRange = '1W' | '1M' | '6M' | '1Y' | '3Y' | '5Y' | '10Y';
+export interface TimeRangeConfig {
+    label: string;
+    value: TimeRange;
+    days: number;
+}
+export declare const TIME_RANGES: TimeRangeConfig[];
+export declare const REGEX_PATTERNS: {
+    readonly EMAIL: RegExp;
+    readonly PHONE: RegExp;
+    readonly USERNAME: RegExp;
+    readonly PASSWORD: RegExp;
+    readonly UUID: RegExp;
+    readonly NUMERIC: RegExp;
+    readonly DECIMAL: RegExp;
+    readonly ALPHA_ONLY: RegExp;
+    readonly ALPHANUMERIC: RegExp;
+    readonly URL: RegExp;
+};
+export declare const VALIDATION_RULES: {
+    readonly MIN_USERNAME_LENGTH: 3;
+    readonly MAX_USERNAME_LENGTH: 30;
+    readonly MIN_PASSWORD_LENGTH: 8;
+    readonly MAX_PASSWORD_LENGTH: 128;
+    readonly MIN_NAME_LENGTH: 2;
+    readonly MAX_NAME_LENGTH: 50;
+    readonly MIN_PORTFOLIO_NAME_LENGTH: 3;
+    readonly MAX_PORTFOLIO_NAME_LENGTH: 100;
+    readonly MIN_PORTFOLIO_DESCRIPTION_LENGTH: 0;
+    readonly MAX_PORTFOLIO_DESCRIPTION_LENGTH: 500;
+    readonly MIN_TRADE_AMOUNT: 0.01;
+    readonly MAX_TRADE_AMOUNT: 1000000;
+    readonly MIN_TRADE_QUANTITY: 0.001;
+    readonly MAX_TRADE_QUANTITY: 1000000;
+    readonly MIN_PRICE: 0.01;
+    readonly MAX_PRICE: 1000000;
+    readonly MIN_WITHDRAWAL_AMOUNT: 100;
+    readonly MAX_WITHDRAWAL_AMOUNT: 1000000;
+    readonly MAX_DESCRIPTION_LENGTH: 500;
+    readonly MAX_NOTES_LENGTH: 1000;
+    readonly MAX_FILE_SIZE_MB: 10;
+    readonly MAX_FILE_NAME_LENGTH: 255;
+    readonly MIN_ADDRESS_LENGTH: 10;
+    readonly MAX_ADDRESS_LENGTH: 200;
+    readonly MIN_POSTAL_CODE_LENGTH: 3;
+    readonly MAX_POSTAL_CODE_LENGTH: 10;
+};
+export declare const VALIDATION_ERRORS: {
+    readonly REQUIRED: "This field is required";
+    readonly INVALID_EMAIL: "Please enter a valid email address";
+    readonly INVALID_PHONE: "Please enter a valid phone number";
+    readonly INVALID_USERNAME: "Username must be 3-30 characters, letters, numbers, underscores, and hyphens only";
+    readonly INVALID_PASSWORD: "Password must be at least 8 characters with uppercase, lowercase, and numbers";
+    readonly MIN_LENGTH: (field: string, min: number) => string;
+    readonly MAX_LENGTH: (field: string, max: number) => string;
+    readonly MIN_VALUE: (field: string, min: number) => string;
+    readonly MAX_VALUE: (field: string, max: number) => string;
+    readonly INVALID_FORMAT: (field: string) => string;
+    readonly PASSWORDS_DONT_MATCH: "Passwords do not match";
+};
+//# sourceMappingURL=utilities.d.ts.map

package/dist/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,cAAc,GAAqC,CAAC;AAEjE,eAAO,MAAM,oBAAoB,GAAuB,CAAC;AACzD,eAAO,MAAM,oBAAoB,IAAwB,CAAC;AAE1D,eAAO,MAAM,iCAAiC,SAA4B,CAAC;AAC3E,eAAO,MAAM,kCAAkC,MAA6B,CAAC;AAE7E,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAC1D,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,eAAO,MAAM,gBAAgB,SAAwB,CAAC;AAEtD,eAAO,MAAM,8BAA8B;;;;CAAkC,CAAC;AAE9E,eAAO,MAAM,qCAAqC;;;;;CAAyC,CAAC;AAE5F,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,eAAO,MAAM,qBAAqB,WAA0B,CAAC;AAC7D,eAAO,MAAM,qBAAqB,qBAAgC,CAAC;AAMnE,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAiBjB,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAMX,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEjF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAkBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAiBtB,CAAC;AAEX,eAAO,MAAM,kBAAkB,OAAqB,CAAC;AACrD,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AAMvD,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;CAcf,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AAExD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,WAAW,EAAE,eAAe,EAQxC,CAAC;AAMF,eAAO,MAAM,cAAc;;;;;;;;;;;CAWjB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCnB,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;iCAMR,MAAM,OAAO,MAAM;iCACnB,MAAM,OAAO,MAAM;gCACpB,MAAM,OAAO,MAAM;gCACnB,MAAM,OAAO,MAAM;qCACd,MAAM;;CAEtB,CAAC"}

package/dist/utilities.js

@@ -0,0 +1,215 @@
+import { COMMON_THRESHOLDS, DEFAULT_STRINGS, DEFAULT_NUMBERS, LOCALE_CONFIG, DEFAULT_FORMAT_OPTIONS, CONFIG_ALLOCATION_DEFAULTS } from './config';
+// ============================================
+// Common Utilities
+// ============================================
+export const DECIMAL_PLACES = COMMON_THRESHOLDS.DEFAULT_DECIMALS;
+export const DEFAULT_NUMERIC_ZERO = DEFAULT_NUMBERS.ZERO;
+export const DEFAULT_EMPTY_STRING = DEFAULT_STRINGS.EMPTY;
+export const QUANTITY_FORMAT_THRESHOLD_MILLION = COMMON_THRESHOLDS.MILLION;
+export const QUANTITY_FORMAT_THRESHOLD_THOUSAND = COMMON_THRESHOLDS.THOUSAND;
+export const ERROR_TYPE_BUSINESS_LOGIC = 'business_logic';
+export const ERROR_TYPE_PERMISSION = 'permission';
+export const ERROR_TYPE_SERVER = 'server';
+export const LOCALE_AUSTRALIA = LOCALE_CONFIG.DEFAULT;
+export const NUMBER_FORMAT_OPTIONS_CURRENCY = DEFAULT_FORMAT_OPTIONS.CURRENCY;
+export const NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED = DEFAULT_FORMAT_OPTIONS.CURRENCY_SIGNED;
+export const QUERY_PARAM_ORDER_BY = 'order_by';
+export const ORDER_BY_CREATED_AT = 'created_at';
+export const DEFAULT_UNKNOWN_VALUE = DEFAULT_STRINGS.UNKNOWN;
+export const DEFAULT_ERROR_MESSAGE = DEFAULT_STRINGS.ERROR_MESSAGE;
+// ============================================
+// Default Values
+// ============================================
+export const DEFAULT_VALUES = {
+    ZERO: DEFAULT_STRINGS.ZERO,
+    EMPTY_STRING: DEFAULT_STRINGS.EMPTY,
+    UNKNOWN: 'UNKNOWN',
+    NOT_APPLICABLE: DEFAULT_STRINGS.NOT_APPLICABLE,
+    NULL_UUID: DEFAULT_STRINGS.NULL_UUID,
+};
+export const NUMERIC_DEFAULTS = {
+    MIN_AMOUNT: DEFAULT_NUMBERS.ZERO,
+    MAX_AMOUNT: 999999999.99,
+    DEFAULT_PRECISION: DEFAULT_NUMBERS.PRECISION,
+    PERCENTAGE_PRECISION: DEFAULT_NUMBERS.PERCENTAGE_PRECISION,
+    QUANTITY_PRECISION: DEFAULT_NUMBERS.QUANTITY_PRECISION,
+};
+export const THRESHOLDS = {
+    MIN_PORTFOLIO_VALUE: COMMON_THRESHOLDS.MIN_PORTFOLIO_VALUE,
+    MIN_TRADE_AMOUNT: COMMON_THRESHOLDS.MIN_TRADE_AMOUNT,
+    MIN_WITHDRAWAL_AMOUNT: COMMON_THRESHOLDS.MIN_WITHDRAWAL_AMOUNT,
+    MAX_PORTFOLIOS_PER_USER: COMMON_THRESHOLDS.MAX_PORTFOLIOS_PER_USER,
+    MAX_TRADES_PER_DAY: COMMON_THRESHOLDS.MAX_TRADES_PER_DAY,
+};
+export const DISPLAY_LIMITS = {
+    MAX_NAME_LENGTH: COMMON_THRESHOLDS.MAX_NAME_LENGTH,
+    MAX_DESCRIPTION_LENGTH: COMMON_THRESHOLDS.MAX_DESCRIPTION_LENGTH,
+    MAX_NOTES_LENGTH: COMMON_THRESHOLDS.MAX_NOTES_LENGTH,
+    MAX_FILE_SIZE_MB: COMMON_THRESHOLDS.MAX_FILE_SIZE_MB,
+    MAX_FILE_NAME_LENGTH: COMMON_THRESHOLDS.MAX_FILE_NAME_LENGTH,
+    DASHBOARD_RECENT_TRADES: 5,
+    DASHBOARD_TARGET_TRADES: 5,
+    DASHBOARD_TRANSACTIONS: 5,
+    DASHBOARD_WITHDRAWALS: 5,
+    DEFAULT_PAGE_SIZE: 20,
+    PAGE_SIZE_OPTIONS: [10, 20, 50, 100],
+    AUTOCOMPLETE_MAX_RESULTS: 10,
+    RECENT_SEARCHES_MAX: 5,
+};
+export const ALLOCATION_DEFAULTS = {
+    DEFAULT_PERCENTAGE: CONFIG_ALLOCATION_DEFAULTS.DEFAULT_PERCENTAGE,
+    PERCENTAGE_PRECISION: CONFIG_ALLOCATION_DEFAULTS.PERCENTAGE_PRECISION,
+    TARGET_TOTAL: CONFIG_ALLOCATION_DEFAULTS.TARGET_TOTAL,
+};
+// ============================================
+// Sorting
+// ============================================
+export const SORT_DIRECTION = {
+    ASC: 'asc',
+    DESC: 'desc',
+};
+export const SORT_FIELDS = {
+    CREATED_AT: 'created_at',
+    UPDATED_AT: 'updated_at',
+    DATE: 'date',
+    NAME: 'name',
+    TITLE: 'title',
+    AMOUNT: 'amount',
+    VALUE: 'value',
+    PRICE: 'price',
+    QUANTITY: 'quantity',
+    STATUS: 'status',
+    PRIORITY: 'priority',
+    SYMBOL: 'symbol',
+    TYPE: 'type',
+};
+export const DEFAULT_SORT_CONFIG = {
+    PORTFOLIOS: {
+        field: SORT_FIELDS.UPDATED_AT,
+        direction: SORT_DIRECTION.DESC,
+    },
+    TRADES: {
+        field: SORT_FIELDS.CREATED_AT,
+        direction: SORT_DIRECTION.DESC,
+    },
+    WITHDRAWALS: {
+        field: SORT_FIELDS.CREATED_AT,
+        direction: SORT_DIRECTION.DESC,
+    },
+    TRANSACTIONS: {
+        field: SORT_FIELDS.DATE,
+        direction: SORT_DIRECTION.DESC,
+    },
+};
+export const SORT_DIRECTION_ASC = SORT_DIRECTION.ASC;
+export const SORT_DIRECTION_DESC = SORT_DIRECTION.DESC;
+// ============================================
+// Time and Date
+// ============================================
+export const MILLISECONDS = {
+    SECOND: 1000,
+    MINUTE: 60 * 1000,
+    HOUR: 60 * 60 * 1000,
+    DAY: 24 * 60 * 60 * 1000,
+    WEEK: 7 * 24 * 60 * 60 * 1000,
+};
+export const SECONDS = {
+    MINUTE: 60,
+    HOUR: 60 * 60,
+    DAY: 24 * 60 * 60,
+    WEEK: 7 * 24 * 60 * 60,
+};
+export const DATE_FORMATS = {
+    DISPLAY_DATE: 'MMM dd, yyyy',
+    DISPLAY_DATE_TIME: 'MMM dd, yyyy HH:mm',
+    DISPLAY_DATE_TIME_SECONDS: 'MMM dd, yyyy HH:mm:ss',
+    DISPLAY_SHORT: 'MM/dd/yy',
+    API_DATE: 'yyyy-MM-dd',
+    API_DATETIME: "yyyy-MM-dd'T'HH:mm:ss",
+    API_DATETIME_WITH_TIMEZONE: "yyyy-MM-dd'T'HH:mm:ss'Z'",
+    MONTH_YEAR: 'MMM yyyy',
+    YEAR: 'yyyy',
+    TIME: 'HH:mm',
+    TIME_WITH_SECONDS: 'HH:mm:ss',
+};
+export const TIME_ZONES = {
+    UTC: 'UTC',
+    EST: 'America/New_York',
+    PST: 'America/Los_Angeles',
+    SYDNEY: 'Australia/Sydney',
+    MELBOURNE: 'Australia/Melbourne',
+};
+export const SESSION_DURATIONS = {
+    DEFAULT: 30 * 60 * 1000,
+    EXTENDED: 24 * 60 * 60 * 1000,
+    REMEMBER_ME: 30 * 24 * 60 * 60 * 1000,
+};
+export const MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;
+export const DEFAULT_RECENT_TRANSACTIONS_DAYS = 30;
+export const DATE_ISO_TIME_SEPARATOR = 'T';
+export const TIME_RANGES = [
+    { label: '1W', value: '1W', days: 7 },
+    { label: '1M', value: '1M', days: 30 },
+    { label: '6M', value: '6M', days: 180 },
+    { label: '1Y', value: '1Y', days: 365 },
+    { label: '3Y', value: '3Y', days: 1095 },
+    { label: '5Y', value: '5Y', days: 1825 },
+    { label: '10Y', value: '10Y', days: 3650 },
+];
+// ============================================
+// Validation
+// ============================================
+export const REGEX_PATTERNS = {
+    EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+    PHONE: /^\+?[\d\s-()]+$/,
+    USERNAME: /^[a-zA-Z0-9_-]{3,30}$/,
+    PASSWORD: /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)[a-zA-Z\d@$!%*?&]{8,}$/,
+    UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+    NUMERIC: /^\d+$/,
+    DECIMAL: /^\d+(\.\d{1,2})?$/,
+    ALPHA_ONLY: /^[a-zA-Z]+$/,
+    ALPHANUMERIC: /^[a-zA-Z0-9]+$/,
+    URL: /^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)$/,
+};
+export const VALIDATION_RULES = {
+    MIN_USERNAME_LENGTH: 3,
+    MAX_USERNAME_LENGTH: 30,
+    MIN_PASSWORD_LENGTH: 8,
+    MAX_PASSWORD_LENGTH: 128,
+    MIN_NAME_LENGTH: 2,
+    MAX_NAME_LENGTH: 50,
+    MIN_PORTFOLIO_NAME_LENGTH: 3,
+    MAX_PORTFOLIO_NAME_LENGTH: 100,
+    MIN_PORTFOLIO_DESCRIPTION_LENGTH: 0,
+    MAX_PORTFOLIO_DESCRIPTION_LENGTH: 500,
+    MIN_TRADE_AMOUNT: 0.01,
+    MAX_TRADE_AMOUNT: 1000000,
+    MIN_TRADE_QUANTITY: 0.001,
+    MAX_TRADE_QUANTITY: 1000000,
+    MIN_PRICE: 0.01,
+    MAX_PRICE: 1000000,
+    MIN_WITHDRAWAL_AMOUNT: 100,
+    MAX_WITHDRAWAL_AMOUNT: 1000000,
+    MAX_DESCRIPTION_LENGTH: 500,
+    MAX_NOTES_LENGTH: 1000,
+    MAX_FILE_SIZE_MB: 10,
+    MAX_FILE_NAME_LENGTH: 255,
+    MIN_ADDRESS_LENGTH: 10,
+    MAX_ADDRESS_LENGTH: 200,
+    MIN_POSTAL_CODE_LENGTH: 3,
+    MAX_POSTAL_CODE_LENGTH: 10,
+};
+export const VALIDATION_ERRORS = {
+    REQUIRED: 'This field is required',
+    INVALID_EMAIL: 'Please enter a valid email address',
+    INVALID_PHONE: 'Please enter a valid phone number',
+    INVALID_USERNAME: 'Username must be 3-30 characters, letters, numbers, underscores, and hyphens only',
+    INVALID_PASSWORD: 'Password must be at least 8 characters with uppercase, lowercase, and numbers',
+    MIN_LENGTH: (field, min) => `${field} must be at least ${min} characters`,
+    MAX_LENGTH: (field, max) => `${field} must be no more than ${max} characters`,
+    MIN_VALUE: (field, min) => `${field} must be at least ${min}`,
+    MAX_VALUE: (field, max) => `${field} must be no more than ${max}`,
+    INVALID_FORMAT: (field) => `${field} has an invalid format`,
+    PASSWORDS_DONT_MATCH: 'Passwords do not match',
+};
+//# sourceMappingURL=utilities.js.map