@otim/utils 0.0.4 → 0.0.6

package/dist/helpers/index.d.ts

@@ -1,19 +1,562 @@
-export * from "./address";
-export * from "./blockchain";
-export * from "./date";
-export * from "./datetime";
-export * from "./domain";
-export * from "./intl";
-export * from "./logger";
-export * from "./mask-options";
-export * from "./num-formatter";
-export * from "./polling";
-export * from "./random";
-export * from "./sdk-loader";
-export * from "./signatures";
-export * from "./string";
-export * from "./types";
-export * from "./url";
-export * from "./window";
-export * from "./zod";
+import { Nullable as Nullable$1 } from "@otim/utils/helpers";
+import z, { ZodObject, ZodTypeAny, z as z$1 } from "zod";
+import { EIP2098Signature as EIP2098Signature$1, HexString, VRS } from "@otim/utils/schemas";
+import { Chain } from "viem";
+import { ActivityCCTPBurnData, ActivityData, ActivityERC4626DepositData, ActivityERC4626WithdrawData, ActivitySwapData, ActivityTransferData } from "@otim/utils/api";
+import { MaskitoOptions } from "@maskito/core";
+
+//#region src/helpers/address.d.ts
+/**
+ * Check if two addresses are equal (case-insensitive)
+ * Works with Ethereum addresses and other blockchain addresses
+ */
+declare const areAddressesEqual: (address1?: Nullable$1<string>, address2?: Nullable$1<string>) => boolean;
+//#endregion
+//#region src/helpers/activity.d.ts
+interface BaseActivityDetails {
+  from: string;
+  to: string;
+  amount: string;
+  token: string;
+}
+declare function isTransferActivity(activity: ActivityData): activity is {
+  transfer: ActivityTransferData;
+};
+declare function isSwapActivity(activity: ActivityData): activity is {
+  swap: ActivitySwapData;
+};
+declare function isCctpBurnActivity(activity: ActivityData): activity is {
+  cctpBurn: ActivityCCTPBurnData;
+};
+declare function isErc4626DepositActivity(activity: ActivityData): activity is {
+  erc4626Deposit: ActivityERC4626DepositData;
+};
+declare function isErc4626WithdrawActivity(activity: ActivityData): activity is {
+  erc4626Withdraw: ActivityERC4626WithdrawData;
+};
+declare function extractBaseActivityDetails(activity: ActivityData): BaseActivityDetails;
+/**
+ * Converts a Unix timestamp (seconds) to an ISO date string.
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns ISO date string
+ */
+declare function timestampToISOString(timestamp: number): string;
+//#endregion
+//#region src/helpers/blockchain.d.ts
+declare const truncateAddress: (address: string) => string;
+/**
+ * Ethereum address regex pattern
+ * Matches addresses like 0x1234...abcd (40 hex characters after 0x prefix)
+ */
+declare const ETHEREUM_ADDRESS_REGEX: RegExp;
+/**
+ * Validates if a string is a valid Ethereum address format
+ * @param address - The address string to validate
+ * @returns true if the address matches the Ethereum address format
+ */
+declare const isValidEthereumAddress: (address: string) => boolean;
+/**
+ * Parses a signature string into its v, r, s components.
+ * @param signature - The signature string to parse (must be 0x-prefixed, 132 chars total)
+ * @returns VRS object containing v, r, and s values
+ */
+declare const parseSignatureToVRS: (signature: string) => VRS;
+declare const isValidV: (v: number) => boolean;
+declare const normalizeV: (v: number) => number;
+/**
+ * Creates an EIP-2098 compact signature from VRS components.
+ * @param vrs - The VRS signature components
+ * @returns EIP2098Signature object with yParity, r, and s
+ */
+declare const createEIP2098Signature: (vrs: VRS) => EIP2098Signature$1;
+declare const getChainRpcUrl: (chainId: number, chains: readonly [Chain, ...Chain[]]) => {
+  http: readonly string[];
+  webSocket?: readonly string[] | undefined;
+} | undefined;
+declare const DEFAULT_ADDRESS = "0x0000000000000000000000000000000000000000";
+declare const isNullAddress: (address: HexString) => boolean;
+/**
+ * Parses a hex amount string with decimals into a number.
+ *
+ * @param hexAmount - The hex string (e.g. "0x...")
+ * @param decimals - Token decimals
+ * @returns The parsed number
+ */
+declare function parseHexAmount(hexAmount: string, decimals: number): number;
+//#endregion
+//#region src/helpers/date.d.ts
+type Locale$1 = "en" | "es";
+type FormatDateFunc<T> = (date: Date) => T;
+declare const iso8601DateSchema: z.ZodString;
+declare const TimeUnit: {
+  readonly Day: "day";
+  readonly Month: "month";
+  readonly Year: "year";
+};
+type TimeUnit = (typeof TimeUnit)[keyof typeof TimeUnit];
+declare const units: {
+  readonly day: {
+    readonly one: "day";
+    readonly other: "days";
+  };
+  readonly month: {
+    readonly one: "month";
+    readonly other: "months";
+  };
+  readonly year: {
+    readonly one: "year";
+    readonly other: "years";
+  };
+};
+declare const formatDateAsUSStandard: (date: Date, opts?: Intl.DateTimeFormatOptions) => string;
+declare const formatDateAsISO: (date: Date) => string;
+declare const formatFullDate: (date: Date) => string;
+declare const formatTime: (date: Date) => string;
+declare const formatDateTime: (date: Date) => string;
+/**
+ * Formats a date in long format (e.g., "June 19, 2025")
+ * @param date - Date object to format
+ * @returns Formatted date string
+ */
+declare const formatLongDate: (date: Date) => string;
+/**
+ * Formats a date with time in long format (e.g., "June 19, 2025 at 07:00 AM")
+ * @param date - Date object to format
+ * @returns Formatted date and time string
+ */
+declare const formatLongDateTime: (date: Date) => string;
+declare const formatToShortDate: (dateString: string | Date) => string;
+declare const formatToShortDateWithYear: (dateString: string | Date) => string;
+declare const formatToJustDate: (dateString: string) => string;
+declare const formatDateToYYYYMMDD: (date: Date) => string;
+declare const isDateInvalid: (date: Date) => boolean;
+/**
+ * Validates if a date is valid (opposite of isDateInvalid)
+ * Checks both the Date object validity and the timestamp
+ */
+declare const isValidDate: (date: Date) => boolean;
+declare const isDateEpoc: (date: Date) => boolean;
+declare const isDateInRange: (arg: unknown) => boolean;
+declare const isDateInPast: (input: string | number | Date) => boolean;
+declare const isSameDate: (dateA: Date, dateB: Date) => boolean;
+declare const getPluralizedUnit: (unit: keyof typeof units, count: number, locale?: Locale$1) => string;
+declare const getRelativeDateDescription: (targetDate: Date, locale?: Locale$1) => string;
+/**
+ * Safely formats a date with validation and fallback support
+ * @param date - String or Date to format
+ * @param formatter - Function that formats the Date object
+ * @param fallback - Value to return if date is invalid
+ * @returns Formatted string or fallback value
+ */
+declare const safeFormatDate: <T = string>(date: string | Date, formatter: FormatDateFunc<T>, fallback: T) => T;
+declare const parseDateTime: (dateInput: string, timeInput?: string) => Date | undefined;
+declare const validateIso8601Date: (dueDate: string) => void;
+//#endregion
+//#region src/helpers/types.d.ts
+type Nullable<T> = T | null;
+type Nullish<T> = T | null | undefined;
+type Optional<T> = T | undefined;
+type Any = any;
+type NumberOrString = number | string;
+type OverrideProps<T, TOverridden> = Omit<T, keyof TOverridden> & TOverridden;
+type NonEmptyArray<T> = [T, ...T[]];
+interface DataRecord {
+  [value: string]: Nullish<DataRecord | string | number | boolean>;
+}
+interface Input<T> {
+  input: T;
+}
+type ZodCustom<Values extends object> = ZodObject<{ [P in keyof Values]: z$1.ZodType<Values[P]> }>;
+declare const isError: (value: unknown) => value is Error;
+declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+declare const isObject: (value: unknown) => value is Record<string, unknown>;
+declare const isNumber: (value: unknown) => value is number;
+declare const isString: (value: unknown) => value is string;
+declare const isUndefined: (value: unknown) => value is undefined;
+declare const isBoolean: (value: unknown) => value is boolean;
+declare const isNull: (value: unknown) => value is null;
+declare const isNotNull: (value: unknown) => value is NonNullable<unknown>;
+declare const isEmpty: (value: unknown) => value is "" | null | undefined;
+/**
+ * Safely extracts a string from an unknown value.
+ * @param value - The value to extract from
+ * @param fallback - Optional fallback value if extraction fails
+ * @returns The extracted string or fallback/undefined
+ */
+declare const extractString: (value: unknown, fallback?: string) => Optional<string>;
+/**
+ * Safely extracts a number from an unknown value.
+ * Handles both number and string representations.
+ * @param value - The value to extract from
+ * @returns The extracted number or undefined
+ */
+declare const extractNumber: (value: unknown) => Optional<number>;
+//#endregion
+//#region src/helpers/datetime.d.ts
+declare const timeUnitInputValueSchema: z$1.ZodObject<{
+  unit: z$1.ZodEnum<{
+    none: "none";
+    second: "second";
+    minute: "minute";
+    hour: "hour";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>;
+  value: z$1.ZodNumber;
+  seconds: z$1.ZodNumber;
+}, z$1.core.$strip>;
+type TimeUnitInputValue = z$1.infer<typeof timeUnitInputValueSchema>;
+/**
+ * converts various value formats to TimeUnitInputValue.
+ * handles both direct objects and JSON strings from form system.
+ *
+ * @param value – value from form field (can be object, string, or other)
+ * @returns parsed TimeUnitInputValue or undefined if invalid
+ */
+declare const parseTimeUnitValue: (value: unknown) => Optional<TimeUnitInputValue>;
+/**
+ * serializes TimeUnitInputValue to JSON string for form compatibility.
+ *
+ * @param value – TimeUnitInputValue to serialize
+ * @returns JSON string representation
+ */
+declare const serializeTimeUnitValue: (value: TimeUnitInputValue) => string;
+/**
+ * validates if a value can be converted to a valid TimeUnitInputValue.
+ *
+ * @param value – value to validate
+ * @returns true if value is valid, false otherwise
+ */
+declare const isValidTimeUnitValue: (value: unknown) => boolean;
+/**
+ * gets the total seconds from a TimeUnitInputValue or its serialized form.
+ *
+ * @param value – TimeUnitInputValue or JSON string
+ * @returns number of seconds or 0 if invalid
+ */
+declare const getSecondsFromTimeUnitValue: (value: unknown) => number;
+declare const coerceSecondsFromTimeUnitValue: (value: unknown) => number;
+//#endregion
+//#region src/helpers/domain.d.ts
+declare function getBaseDomain(hostname: string): string;
+//#endregion
+//#region src/helpers/external-account.d.ts
+/**
+ * External account display formatting helpers
+ */
+/**
+ * Formats external account information for display
+ *
+ * @param externalAccount - External account object with optional properties
+ * @returns Formatted display name for the external account
+ */
+declare function formatExternalAccountName(externalAccount: {
+  accountName?: string;
+  bankName?: string;
+  last_4?: string;
+}): string;
+//#endregion
+//#region src/helpers/intl.d.ts
+/**
+ * Floors a number to a specific number of decimal places.
+ * This ensures values are always rounded down, never up.
+ *
+ * @param value - The number to floor
+ * @param decimals - Number of decimal places to keep
+ * @returns The floored number
+ */
+declare const floorToDecimals: (value: number, decimals: number) => number;
+declare const i18n: {
+  defaultLocale: string;
+  locales: ("en" | "es")[];
+};
+declare const localeSchema: z$1.ZodEnum<{
+  en: "en";
+  es: "es";
+}>;
+type Locale = z$1.infer<typeof localeSchema>;
+declare const formattedNumber: (num: number) => string;
+/**
+ * Formats a token or asset amount with appropriate decimal places
+ * based on the magnitude of the value.
+ * Values are floored (rounded down) to avoid showing inflated amounts.
+ *
+ * @param amount - The amount to format
+ * @param decimals - Optional maximum decimal places
+ */
+declare const formatAmount: (amount: number, decimals?: number) => string;
+/**
+ * Formats a number as USD currency with proper locale formatting.
+ * Values are floored (rounded down) to avoid showing inflated amounts.
+ *
+ * @param amount – The amount to format
+ * @param options – Optional Intl.NumberFormatOptions to customize formatting
+ * @returns – Formatted currency string (e.g., "$1,234.56")
+ */
+declare const formatCurrency: (amount: number | string, options?: Intl.NumberFormatOptions) => string;
+/**
+ * Formats a number as USD currency with smart decimal places based on magnitude.
+ * Shows more precision for small values to avoid displaying "$0.00" for meaningful amounts.
+ * Values are floored (rounded down) to avoid showing inflated amounts.
+ *
+ * @param amount – The amount to format
+ * @returns – Formatted currency string with adaptive decimals
+ *
+ * @example
+ * formatSmartCurrency(0)          // "$0"
+ * formatSmartCurrency(0.0000001)  // "<$0.000001"
+ * formatSmartCurrency(0.003456)   // "$0.003456"
+ * formatSmartCurrency(0.5678)     // "$0.5678"
+ * formatSmartCurrency(1234.56)    // "$1,234.56"
+ */
+declare const formatSmartCurrency: (amount: number | string) => string;
+/**
+ * Alias for formatCurrency specifically for USD
+ */
+declare const formatUsd: (amount: number | string, options?: Intl.NumberFormatOptions) => string;
+/**
+ * Formats a USD amount without the currency symbol.
+ * Values are floored (rounded down) to avoid showing inflated amounts.
+ *
+ * @param amount – The amount to format
+ * @param options – Optional Intl.NumberFormatOptions to customize formatting
+ * @returns – Formatted amount string (e.g., "1,234.56")
+ */
+declare const formatUsdAmount: (amount: number | string, options?: Intl.NumberFormatOptions) => string;
+//#endregion
+//#region src/helpers/logger.d.ts
+interface LoggerOptions {
+  context?: string;
+  data?: unknown;
+}
+interface ErrorLogOptions {
+  context?: string;
+  operation?: string;
+  metadata?: Record<string, unknown>;
+}
+declare class Logger {
+  info(message: string, options?: LoggerOptions): void;
+  warn(message: string, options?: LoggerOptions): void;
+  error(message: string, options?: LoggerOptions): void;
+  /**
+   * Log errors with full context and stack trace.
+   * For API errors, consider using `getErrorMessage` from `@otim/utils/api`.
+   */
+  logError(error: unknown, options?: ErrorLogOptions): void;
+  private log;
+  private logData;
+}
+declare const logger: Logger;
+//#endregion
+//#region src/helpers/mask-options.d.ts
+declare const postalCodeMaskOptions: MaskitoOptions;
+declare const dateMaskOptions: Required<MaskitoOptions>;
+declare const timeOptions: Required<MaskitoOptions>;
+declare const timeOptionsWithoutMeridiem: Required<MaskitoOptions>;
+declare const timeMaskOptionsHHMM: Required<MaskitoOptions>;
+declare const formatUUID: (value: string) => string;
+declare const uuidMaskOptions: MaskitoOptions;
+declare const usdCurrencyMaskOptions: MaskitoOptions;
+//#endregion
+//#region src/helpers/num-formatter.d.ts
+declare const numFormatter: (num: number, round?: number) => string | number;
+declare const formatNumberAsUSStandard: (num: number) => string;
+//#endregion
+//#region src/helpers/polling.d.ts
+interface PollingConfig {
+  intervalMs?: number;
+  onComplete?: () => void;
+}
+/**
+ * Manages polling for emergent window completion status.
+ * Generic utility that can be used for any async polling scenario.
+ * Follows Single Responsibility Principle - only handles polling logic.
+ */
+declare class PollingManager {
+  private emergentWindow;
+  private pollIntervalId;
+  private config;
+  constructor(config?: PollingConfig);
+  /**
+   * Starts polling for the given check function
+   *
+   * @param emergentWindow - The emergent window to monitor (optional)
+   * @param checkFn - Function that returns true when polling should stop
+   */
+  start(emergentWindow: Nullable<Window>, checkFn: () => Promise<boolean>): void;
+  stop(): void;
+  /**
+   * Finalizes polling by closing emergent window, stopping interval, and returning focus
+   */
+  finalize(): void;
+  dispose(): void;
+}
+//#endregion
+//#region src/helpers/random.d.ts
+interface Range {
+  min: number;
+  max: number;
+}
+interface GenerateRandom extends Range {
+  value: string;
+}
+declare const randomNumber: (opts: GenerateRandom) => number;
+//#endregion
+//#region src/helpers/sdk-loader.d.ts
+/**
+ * Configuration for loading external SDK scripts
+ */
+interface SdkLoaderConfig {
+  src: string;
+  name: string;
+  timeout?: number;
+}
+/**
+ * Generic SDK loader utility for loading third-party scripts
+ * Follows Single Responsibility Principle - only handles script loading
+ *
+ * @param config - SDK loader configuration
+ * @returns Promise that resolves when SDK is loaded
+ * @throws Error if SDK fails to load or times out
+ */
+declare function loadExternalSdk(config: SdkLoaderConfig): Promise<void>;
+/**
+ * Checks if a script with the given src is already loaded
+ *
+ * @param src - Script source URL to check
+ * @returns true if script is already in the DOM
+ */
+declare function isScriptLoaded(src: string): boolean;
+//#endregion
+//#region src/helpers/signatures.d.ts
+/**
+ * EIP-2098 Signature format (compact)
+ */
+interface EIP2098Signature {
+  yParity: number;
+  r: `0x${string}`;
+  s: `0x${string}`;
+}
+/**
+ * Converts a standard signature to EIP-2098 format
+ */
+declare const formatSignatureToEIP2098: (signature: {
+  v: string;
+  r: string;
+  s: string;
+}) => EIP2098Signature;
+//#endregion
+//#region src/helpers/string.d.ts
+/**
+ * Capitalizes the first letter of a string
+ *
+ * @param str – The string to capitalize
+ * @returns The string with first letter capitalized, or undefined if input is
+ * nullish
+ */
+declare const capitalize: (str?: string) => Optional<string>;
+/**
+ * Converts a string to title case (capitalizes first letter, lowercase rest)
+ *
+ * @param str – The string to convert
+ * @returns The string in title case, or undefined if input is nullish
+ */
+declare const toTitleCase: (str?: string) => Optional<string>;
+//#endregion
+//#region src/helpers/url.d.ts
+type QueryParams = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Builds a query string from a params object, skipping undefined/null values.
+ * Encodes using encodeURIComponent. Returns empty string if no params.
+ */
+declare function buildQueryString(params: QueryParams): string;
+/**
+ * Build a URL by combining a base path with optional query params.
+ */
+declare function buildUrl(path: string, params?: QueryParams): string;
+//#endregion
+//#region src/helpers/window.d.ts
+declare const isClient: () => boolean;
+interface EmergentWindowConfig {
+  width?: number;
+  height?: number;
+  name?: string;
+}
+/**
+ * Opens an emergent window centered on the screen.
+ * Used for authentication flows and external integrations.
+ *
+ * @param url - The URL to open in the emergent window
+ * @param config - Optional configuration for the window
+ * @returns The opened window or null if it failed
+ */
+declare function openCenteredEmergentWindow(url: string, config?: EmergentWindowConfig): Nullable<Window>;
+/**
+ * Closes an emergent window safely
+ *
+ * @param emergentWindow - The emergent window to close
+ */
+declare function closeEmergentWindow(emergentWindow: Nullable<Window>): void;
+declare function focusMainWindow(): void;
+/**
+ * Performs a client-side redirect to the specified path
+ *
+ * @param path - The path to redirect to
+ * @param fallbackPath - Optional fallback path if the main path is empty
+ */
+declare function performRedirect(path: string, fallbackPath?: string): void;
+//#endregion
+//#region src/helpers/zod.d.ts
+type Validator<T> = (data: T, ctx: z$1.RefinementCtx) => void;
+declare const composeValidators: <T>(validators: Validator<T>[]) => (data: T, ctx: z$1.RefinementCtx) => void;
+/**
+ * creates a time unit validator for fields stored as JSON strings.
+ * validates both the JSON format and the minimum seconds requirement.
+ *
+ * @param fieldName – the name of the field for error messages
+ * @param options – configuration options
+ * @param options.minSeconds – minimum seconds required (default: 60)
+ * @param options.allowZero – whether to allow 0 seconds for "None" option (default: false)
+ * @param options.useHumanReadable – whether to use human-readable time in error messages (default: true)
+ */
+declare const createTimeUnitValidator: (fieldName: string, options?: {
+  minSeconds?: number;
+  allowZero?: boolean;
+  useHumanReadable?: boolean;
+}) => z$1.ZodOptional<z$1.ZodString>;
+/**
+ * Parse the input values using the provided schema. If the input values are
+ * invalid, throw a ResolverError.
+ * @param values - The input values to parse.
+ * @param schema - The schema to use to parse the input values.
+ * @param error - The error code to use if the input values are invalid.
+ * @returns The parsed input values.
+ * @throws ResolverError if the input values are invalid.
+ */
+declare const parseSchema: <Values, Schema extends ZodTypeAny = ZodObject<{ [P in keyof Values]: z$1.ZodType<Values[P]> }>>(values: Values, schema: Schema) => z$1.infer<Schema>;
+/**
+ * Creates a permissive decimal string schema that allows empty strings.
+ * Converts undefined/null values to empty strings, preventing "expected string, received undefined" errors.
+ * Useful for form fields where validation happens in a refine step.
+ */
+declare const formDecimalStringSchema: () => z$1.ZodPipe<z$1.ZodTransform<string, unknown>, z$1.ZodString>;
+/**
+ * Creates a hex string schema with preprocessing that defaults to DEFAULT_ADDRESS.
+ * Converts undefined/null/empty values to DEFAULT_ADDRESS before validation.
+ * Useful for form fields that expect hex addresses.
+ */
+declare const formHexStringSchema: () => z$1.ZodPipe<z$1.ZodTransform<{}, unknown>, z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
+/**
+ * Filters out Zod internal errors that shouldn't be shown to users.
+ * Only returns user-friendly validation messages.
+ *
+ * @param errors - Array of error messages from Zod validation, or a single error string
+ * @param fieldValue - The field value being validated
+ * @returns User-friendly error message or undefined
+ */
+declare const getDisplayableZodError: (errors: string[] | string | undefined, fieldValue: unknown) => string | undefined;
+//#endregion
+export { Any, BaseActivityDetails, DEFAULT_ADDRESS, DataRecord, EIP2098Signature, ETHEREUM_ADDRESS_REGEX, EmergentWindowConfig, ErrorLogOptions, type FormatDateFunc, Input, Locale, LoggerOptions, NonEmptyArray, Nullable, Nullish, NumberOrString, Optional, OverrideProps, PollingConfig, PollingManager, QueryParams, SdkLoaderConfig, TimeUnit, TimeUnitInputValue, Validator, ZodCustom, areAddressesEqual, buildQueryString, buildUrl, capitalize, closeEmergentWindow, coerceSecondsFromTimeUnitValue, composeValidators, createEIP2098Signature, createTimeUnitValidator, dateMaskOptions, extractBaseActivityDetails, extractNumber, extractString, floorToDecimals, focusMainWindow, formDecimalStringSchema, formHexStringSchema, formatAmount, formatCurrency, formatDateAsISO, formatDateAsUSStandard, formatDateTime, formatDateToYYYYMMDD, formatExternalAccountName, formatFullDate, formatLongDate, formatLongDateTime, formatNumberAsUSStandard, formatSignatureToEIP2098, formatSmartCurrency, formatTime, formatToJustDate, formatToShortDate, formatToShortDateWithYear, formatUUID, formatUsd, formatUsdAmount, formattedNumber, getBaseDomain, getChainRpcUrl, getDisplayableZodError, getPluralizedUnit, getRelativeDateDescription, getSecondsFromTimeUnitValue, i18n, isBoolean, isCctpBurnActivity, isClient, isDateEpoc, isDateInPast, isDateInRange, isDateInvalid, isEmpty, isErc4626DepositActivity, isErc4626WithdrawActivity, isError, isFunction, isNotNull, isNull, isNullAddress, isNumber, isObject, isSameDate, isScriptLoaded, isString, isSwapActivity, isTransferActivity, isUndefined, isValidDate, isValidEthereumAddress, isValidTimeUnitValue, isValidV, iso8601DateSchema, loadExternalSdk, localeSchema, logger, normalizeV, numFormatter, openCenteredEmergentWindow, parseDateTime, parseHexAmount, parseSchema, parseSignatureToVRS, parseTimeUnitValue, performRedirect, postalCodeMaskOptions, randomNumber, safeFormatDate, serializeTimeUnitValue, timeMaskOptionsHHMM, timeOptions, timeOptionsWithoutMeridiem, timeUnitInputValueSchema, timestampToISOString, toTitleCase, truncateAddress, usdCurrencyMaskOptions, uuidMaskOptions, validateIso8601Date };
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/helpers/address.ts","../../src/helpers/activity.ts","../../src/helpers/blockchain.ts","../../src/helpers/date.ts","../../src/helpers/types.ts","../../src/helpers/datetime.ts","../../src/helpers/domain.ts","../../src/helpers/external-account.ts","../../src/helpers/intl.ts","../../src/helpers/logger.ts","../../src/helpers/mask-options.ts","../../src/helpers/num-formatter.ts","../../src/helpers/polling.ts","../../src/helpers/random.ts","../../src/helpers/sdk-loader.ts","../../src/helpers/signatures.ts","../../src/helpers/string.ts","../../src/helpers/url.ts","../../src/helpers/window.ts","../../src/helpers/zod.ts"],"sourcesContent":[],"mappings":"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"}