@otim/utils 0.0.2-development.0

package/dist/helpers/date.d.ts

@@ -0,0 +1,70 @@
+import z from "zod";
+type Locale = "en" | "es";
+type FormatDateFunc<T> = (date: Date) => T;
+export declare const iso8601DateSchema: z.ZodString;
+export declare const TimeUnit: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+export 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;
+export 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;
+export declare const formatToJustDate: (dateString: string) => string;
+export 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) => string;
+declare const getRelativeDateDescription: (targetDate: Date, locale?: Locale) => 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;
+export { formatDateAsUSStandard, formatToShortDate, formatToShortDateWithYear, formatFullDate, formatTime, formatDateTime, formatLongDate, formatLongDateTime, getPluralizedUnit, getRelativeDateDescription, isDateInvalid, isValidDate, validateIso8601Date, isDateEpoc, isDateInRange, isDateInPast, isSameDate, safeFormatDate, parseDateTime, };
+export type { FormatDateFunc };
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/helpers/date.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAIpB,KAAK,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1B,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC;AAE3C,eAAO,MAAM,iBAAiB,aAK3B,CAAC;AAEJ,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,QAAA,MAAM,KAAK;;;;;;;;;;;;;CAaD,CAAC;AAEX,QAAA,MAAM,sBAAsB,GAC1B,MAAM,IAAI,EACV,OAAO,IAAI,CAAC,qBAAqB,WAO/B,CAAC;AAEL,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,WAAuB,CAAC;AAElE,QAAA,MAAM,cAAc,GAAI,MAAM,IAAI,KAAG,MAQpC,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,MAQhC,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,MAAM,IAAI,KAAG,MAqBpC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,cAAc,GAAI,MAAM,IAAI,KAAG,MAQpC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,kBAAkB,GAAI,MAAM,IAAI,KAAG,MAsBxC,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,YAAY,MAAM,GAAG,IAAI,WAanD,CAAC;AAEF,QAAA,MAAM,yBAAyB,GAAI,YAAY,MAAM,GAAG,IAAI,WAc3D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,WAQlD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,MAAM,IAAI,WAM9C,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,MAAM,IAAI,YAEhC,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,WAAW,GAAI,MAAM,IAAI,KAAG,OAEjC,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,MAAM,IAAI,YAE7B,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,KAAK,OAAO,KAAG,OAUrC,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,OAgBrD,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,OAAO,IAAI,EAAE,OAAO,IAAI,YAM3C,CAAC;AAEF,QAAA,MAAM,iBAAiB,GACrB,MAAM,MAAM,OAAO,KAAK,EACxB,OAAO,MAAM,EACb,SAAQ,MAAa,WAYtB,CAAC;AAEF,QAAA,MAAM,0BAA0B,GAC9B,YAAY,IAAI,EAChB,SAAQ,MAAa,WAsBtB,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,cAAc,GAAI,CAAC,GAAG,MAAM,EAChC,MAAM,MAAM,GAAG,IAAI,EACnB,WAAW,cAAc,CAAC,CAAC,CAAC,EAC5B,UAAU,CAAC,KACV,CAeF,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,YAAY,MAAM,qBA2C3D,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,IAO9C,CAAC;AAEF,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,UAAU,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,GACd,CAAC;AACF,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/helpers/datetime.d.mts

@@ -0,0 +1,57 @@
+import type { Nullable, Optional } from "./types";
+import { z } from "zod";
+/**
+ * schema for TimeUnitInputValue
+ */
+export declare const timeUnitInputValueSchema: z.ZodObject<{
+    unit: z.ZodEnum<{
+        none: "none";
+        second: "second";
+        minute: "minute";
+        hour: "hour";
+        day: "day";
+        week: "week";
+        month: "month";
+    }>;
+    value: z.ZodNumber;
+    seconds: z.ZodNumber;
+}, z.core.$strip>;
+export type TimeUnitInputValue = z.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
+ */
+export declare const parseTimeUnitValue: (value: unknown) => Optional<TimeUnitInputValue>;
+/**
+ * serializes TimeUnitInputValue to JSON string for form compatibility.
+ *
+ * @param value – TimeUnitInputValue to serialize
+ * @returns JSON string representation
+ */
+export 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
+ */
+export 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
+ */
+export declare const getSecondsFromTimeUnitValue: (value: unknown) => number;
+export declare const coerceSecondsFromTimeUnitValue: (value: unknown) => number;
+/**
+ * Parses a date and time string into a Date object (strict version).
+ * @param date – date string
+ * @param time – time string
+ * @returns Date object or null if invalid
+ */
+export declare function parseDateTimeStrict(date: string, time: string): Nullable<Date>;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/helpers/datetime.d.ts

@@ -0,0 +1,57 @@
+import type { Nullable, Optional } from "./types";
+import { z } from "zod";
+/**
+ * schema for TimeUnitInputValue
+ */
+export declare const timeUnitInputValueSchema: z.ZodObject<{
+    unit: z.ZodEnum<{
+        none: "none";
+        second: "second";
+        minute: "minute";
+        hour: "hour";
+        day: "day";
+        week: "week";
+        month: "month";
+    }>;
+    value: z.ZodNumber;
+    seconds: z.ZodNumber;
+}, z.core.$strip>;
+export type TimeUnitInputValue = z.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
+ */
+export declare const parseTimeUnitValue: (value: unknown) => Optional<TimeUnitInputValue>;
+/**
+ * serializes TimeUnitInputValue to JSON string for form compatibility.
+ *
+ * @param value – TimeUnitInputValue to serialize
+ * @returns JSON string representation
+ */
+export 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
+ */
+export 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
+ */
+export declare const getSecondsFromTimeUnitValue: (value: unknown) => number;
+export declare const coerceSecondsFromTimeUnitValue: (value: unknown) => number;
+/**
+ * Parses a date and time string into a Date object (strict version).
+ * @param date – date string
+ * @param time – time string
+ * @returns Date object or null if invalid
+ */
+export declare function parseDateTimeStrict(date: string, time: string): Nullable<Date>;
+//# sourceMappingURL=datetime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/helpers/datetime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAInC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAoC1E;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,QAAQ,CAAC,kBAAkB,CAe7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,kBAAkB,KAAG,MAElE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,OAErD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,MAG5D,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,OAAO,OAAO,KAAG,MAgB/D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,IAAI,CAAC,CA4BhB"}

package/dist/helpers/domain.d.mts

@@ -0,0 +1,2 @@
+export declare function getBaseDomain(hostname: string): string;
+//# sourceMappingURL=domain.d.ts.map

package/dist/helpers/domain.d.ts

@@ -0,0 +1,2 @@
+export declare function getBaseDomain(hostname: string): string;
+//# sourceMappingURL=domain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/helpers/domain.ts"],"names":[],"mappings":"AAuBA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6DtD"}

package/dist/helpers/index.d.mts

@@ -0,0 +1,19 @@
+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";
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts

@@ -0,0 +1,19 @@
+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";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}