@foxscheduling/shared 0.1.0

package/dist/cjs/utils/bookingPageIcons.d.ts

@@ -0,0 +1,160 @@
+export declare const BOOKING_PAGE_ICONS: {
+    clock: string;
+    "dollar-sign": string;
+    "arrow-right": string;
+    tag: string;
+    scissors: string;
+    sparkles: string;
+    heart: string;
+    star: string;
+    palette: string;
+    camera: string;
+    music: string;
+    briefcase: string;
+    dumbbell: string;
+    car: string;
+    home: string;
+    utensils: string;
+    coffee: string;
+    package: string;
+    "map-pin": string;
+    calendar: string;
+    phone: string;
+    mail: string;
+    video: string;
+    stethoscope: string;
+    "book-open": string;
+    wrench: string;
+    gift: string;
+};
+export declare function getServiceIconSvg(iconId?: keyof typeof BOOKING_PAGE_ICONS | null): string;
+export declare const PRESET_ACCENTS: readonly [{
+    readonly value: "emerald";
+    readonly label: "Emerald";
+    readonly class: "from-emerald-500 to-teal-600";
+    readonly hoverBorder: "hover:border-emerald-500/50";
+    readonly hoverText: "group-hover:text-emerald-500";
+    readonly active: "border-emerald-500 bg-emerald-500/10 text-emerald-500";
+    readonly proseLink: "[&_a]:text-emerald-500 [&_a:hover]:text-emerald-600";
+    readonly link: "text-emerald-500 hover:text-emerald-600";
+}, {
+    readonly value: "violet";
+    readonly label: "Violet";
+    readonly class: "from-violet-500 to-purple-600";
+    readonly hoverBorder: "hover:border-violet-500/50";
+    readonly hoverText: "group-hover:text-violet-500";
+    readonly active: "border-violet-500 bg-violet-500/10 text-violet-500";
+    readonly proseLink: "[&_a]:text-violet-500 [&_a:hover]:text-violet-600";
+    readonly link: "text-violet-500 hover:text-violet-600";
+}, {
+    readonly value: "blue";
+    readonly label: "Blue";
+    readonly class: "from-blue-500 to-indigo-600";
+    readonly hoverBorder: "hover:border-blue-500/50";
+    readonly hoverText: "group-hover:text-blue-500";
+    readonly active: "border-blue-500 bg-blue-500/10 text-blue-500";
+    readonly proseLink: "[&_a]:text-blue-500 [&_a:hover]:text-blue-600";
+    readonly link: "text-blue-500 hover:text-blue-600";
+}, {
+    readonly value: "cyan";
+    readonly label: "Cyan";
+    readonly class: "from-cyan-500 to-teal-600";
+    readonly hoverBorder: "hover:border-cyan-500/50";
+    readonly hoverText: "group-hover:text-cyan-500";
+    readonly active: "border-cyan-500 bg-cyan-500/10 text-cyan-500";
+    readonly proseLink: "[&_a]:text-cyan-500 [&_a:hover]:text-cyan-600";
+    readonly link: "text-cyan-500 hover:text-cyan-600";
+}, {
+    readonly value: "sky";
+    readonly label: "Sky";
+    readonly class: "from-sky-500 to-blue-600";
+    readonly hoverBorder: "hover:border-sky-500/50";
+    readonly hoverText: "group-hover:text-sky-500";
+    readonly active: "border-sky-500 bg-sky-500/10 text-sky-500";
+    readonly proseLink: "[&_a]:text-sky-500 [&_a:hover]:text-sky-600";
+    readonly link: "text-sky-500 hover:text-sky-600";
+}, {
+    readonly value: "indigo";
+    readonly label: "Indigo";
+    readonly class: "from-indigo-500 to-violet-600";
+    readonly hoverBorder: "hover:border-indigo-500/50";
+    readonly hoverText: "group-hover:text-indigo-500";
+    readonly active: "border-indigo-500 bg-indigo-500/10 text-indigo-500";
+    readonly proseLink: "[&_a]:text-indigo-500 [&_a:hover]:text-indigo-600";
+    readonly link: "text-indigo-500 hover:text-indigo-600";
+}, {
+    readonly value: "fuchsia";
+    readonly label: "Fuchsia";
+    readonly class: "from-fuchsia-500 to-pink-600";
+    readonly hoverBorder: "hover:border-fuchsia-500/50";
+    readonly hoverText: "group-hover:text-fuchsia-500";
+    readonly active: "border-fuchsia-500 bg-fuchsia-500/10 text-fuchsia-500";
+    readonly proseLink: "[&_a]:text-fuchsia-500 [&_a:hover]:text-fuchsia-600";
+    readonly link: "text-fuchsia-500 hover:text-fuchsia-600";
+}, {
+    readonly value: "rose";
+    readonly label: "Rose";
+    readonly class: "from-rose-500 to-pink-600";
+    readonly hoverBorder: "hover:border-rose-500/50";
+    readonly hoverText: "group-hover:text-rose-500";
+    readonly active: "border-rose-500 bg-rose-500/10 text-rose-500";
+    readonly proseLink: "[&_a]:text-rose-500 [&_a:hover]:text-rose-600";
+    readonly link: "text-rose-500 hover:text-rose-600";
+}, {
+    readonly value: "amber";
+    readonly label: "Amber";
+    readonly class: "from-amber-500 to-orange-600";
+    readonly hoverBorder: "hover:border-amber-500/50";
+    readonly hoverText: "group-hover:text-amber-500";
+    readonly active: "border-amber-500 bg-amber-500/10 text-amber-500";
+    readonly proseLink: "[&_a]:text-amber-500 [&_a:hover]:text-amber-600";
+    readonly link: "text-amber-500 hover:text-amber-600";
+}, {
+    readonly value: "orange";
+    readonly label: "Orange";
+    readonly class: "from-orange-500 to-amber-600";
+    readonly hoverBorder: "hover:border-orange-500/50";
+    readonly hoverText: "group-hover:text-orange-500";
+    readonly active: "border-orange-500 bg-orange-500/10 text-orange-500";
+    readonly proseLink: "[&_a]:text-orange-500 [&_a:hover]:text-orange-600";
+    readonly link: "text-orange-500 hover:text-orange-600";
+}, {
+    readonly value: "red";
+    readonly label: "Red";
+    readonly class: "from-red-500 to-rose-600";
+    readonly hoverBorder: "hover:border-red-500/50";
+    readonly hoverText: "group-hover:text-red-500";
+    readonly active: "border-red-500 bg-red-500/10 text-red-500";
+    readonly proseLink: "[&_a]:text-red-500 [&_a:hover]:text-red-600";
+    readonly link: "text-red-500 hover:text-red-600";
+}, {
+    readonly value: "lime";
+    readonly label: "Lime";
+    readonly class: "from-lime-500 to-green-600";
+    readonly hoverBorder: "hover:border-lime-500/50";
+    readonly hoverText: "group-hover:text-lime-500";
+    readonly active: "border-lime-500 bg-lime-500/10 text-lime-500";
+    readonly proseLink: "[&_a]:text-lime-500 [&_a:hover]:text-lime-600";
+    readonly link: "text-lime-500 hover:text-lime-600";
+}, {
+    readonly value: "slate";
+    readonly label: "Slate";
+    readonly class: "from-slate-500 to-slate-700";
+    readonly hoverBorder: "hover:border-slate-500/50";
+    readonly hoverText: "group-hover:text-slate-500";
+    readonly active: "border-slate-500 bg-slate-500/10 text-slate-500";
+    readonly proseLink: "[&_a]:text-slate-500 [&_a:hover]:text-slate-600";
+    readonly link: "text-slate-500 hover:text-slate-600";
+}];
+export type AccentValue = (typeof PRESET_ACCENTS)[number]["value"] | "custom";
+export declare const ACCENT_PRESETS: Record<string, {
+    class: string;
+    link: string;
+    border: string;
+    hoverBg: string;
+}>;
+/** Hex gradients for accent swatches - Tailwind v4 may not include from-/to- utilities */
+export declare const ACCENT_GRADIENT_STYLES: Record<string, string>;
+/** Primary hex for each preset - used for grid layout CSS variables */
+export declare const ACCENT_HEX: Record<string, string>;
+//# sourceMappingURL=bookingPageIcons.d.ts.map

package/dist/cjs/utils/bookingPageIcons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookingPageIcons.d.ts","sourceRoot":"","sources":["../../../src/utils/bookingPageIcons.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B9B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAGzF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmIjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;AAE9E,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAc3G,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAczD,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAc7C,CAAC"}

package/dist/cjs/utils/bookingProviders.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeBookingProviderIds = normalizeBookingProviderIds;
+exports.bookingProviderDisplayFields = bookingProviderDisplayFields;
+/** Effective staff IDs assigned to the booking (deduped, non-empty strings). */
+function normalizeBookingProviderIds(booking) {
+    const raw = booking.providerIds?.filter((id) => typeof id === "string" && id.length > 0) ?? [];
+    if (raw.length)
+        return [...new Set(raw)];
+    const legacy = booking.providerId?.trim();
+    return legacy ? [legacy] : [];
+}
+/**
+ * Parallel display arrays aligned with `orderedProviderIds` (same order as
+ * {@link normalizeBookingProviderIds} when that array is passed through).
+ */
+function bookingProviderDisplayFields(orderedProviderIds, userById) {
+    const providerNames = orderedProviderIds.map((pid) => {
+        const u = userById.get(pid);
+        if (!u)
+            return pid;
+        const name = `${u.cognitoRecord?.firstName ?? ""} ${u.cognitoRecord?.lastName ?? ""}`.trim();
+        return name || u.email || pid;
+    });
+    const providerPictureUrls = orderedProviderIds.map((pid) => userById.get(pid)?.cognitoRecord?.picture?.trim() || undefined);
+    return { providerNames, providerPictureUrls };
+}

package/dist/cjs/utils/bookingProviders.d.ts

@@ -0,0 +1,25 @@
+import type { Booking } from "../types/db.booking.js";
+/** Booking row may still carry legacy `providerId` (singular) from older records. */
+export type BookingWithLegacyProviders = Pick<Booking, "providerIds"> & {
+    providerId?: string;
+};
+/** Effective staff IDs assigned to the booking (deduped, non-empty strings). */
+export declare function normalizeBookingProviderIds(booking: BookingWithLegacyProviders): string[];
+/** Minimal user shape for building booking provider labels in list APIs. */
+export type UserProfileForProviderDisplay = {
+    email?: string;
+    cognitoRecord?: {
+        firstName?: string;
+        lastName?: string;
+        picture?: string;
+    };
+};
+/**
+ * Parallel display arrays aligned with `orderedProviderIds` (same order as
+ * {@link normalizeBookingProviderIds} when that array is passed through).
+ */
+export declare function bookingProviderDisplayFields(orderedProviderIds: string[], userById: Map<string, UserProfileForProviderDisplay | undefined>): {
+    providerNames: string[];
+    providerPictureUrls: (string | undefined)[];
+};
+//# sourceMappingURL=bookingProviders.d.ts.map

package/dist/cjs/utils/bookingProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookingProviders.d.ts","sourceRoot":"","sources":["../../../src/utils/bookingProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,qFAAqF;AACrF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,0BAA0B,GAClC,MAAM,EAAE,CAQV;AAED,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,kBAAkB,EAAE,MAAM,EAAE,EAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,6BAA6B,GAAG,SAAS,CAAC,GAC/D;IACD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;CAC7C,CAYA"}

package/dist/cjs/utils/currencies.cjs

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currencies = void 0;
+/**
+ * Currencies supported by Stripe for payments.
+ * @see https://stripe.com/docs/currencies
+ */
+exports.currencies = [
+    "AED",
+    "AFN",
+    "ALL",
+    "AMD",
+    "ANG",
+    "AOA",
+    "ARS",
+    "AUD",
+    "AWG",
+    "AZN",
+    "BAM",
+    "BBD",
+    "BDT",
+    "BGN",
+    "BIF",
+    "BMD",
+    "BND",
+    "BOB",
+    "BRL",
+    "BSD",
+    "BWP",
+    "BZD",
+    "CAD",
+    "CDF",
+    "CHF",
+    "CLP",
+    "CNY",
+    "COP",
+    "CRC",
+    "CVE",
+    "CZK",
+    "DJF",
+    "DKK",
+    "DOP",
+    "DZD",
+    "EEK",
+    "EGP",
+    "ETB",
+    "EUR",
+    "FJD",
+    "FKP",
+    "GBP",
+    "GEL",
+    "GIP",
+    "GMD",
+    "GNF",
+    "GTQ",
+    "GYD",
+    "HKD",
+    "HNL",
+    "HRK",
+    "HTG",
+    "HUF",
+    "IDR",
+    "ILS",
+    "INR",
+    "ISK",
+    "JMD",
+    "JPY",
+    "KES",
+    "KGS",
+    "KHR",
+    "KMF",
+    "KRW",
+    "KYD",
+    "KZT",
+    "LAK",
+    "LBP",
+    "LKR",
+    "LRD",
+    "LSL",
+    "LTL",
+    "LVL",
+    "MAD",
+    "MDL",
+    "MGA",
+    "MKD",
+    "MNT",
+    "MOP",
+    "MRO",
+    "MUR",
+    "MVR",
+    "MWK",
+    "MXN",
+    "MYR",
+    "MZN",
+    "NAD",
+    "NGN",
+    "NIO",
+    "NOK",
+    "NPR",
+    "NZD",
+    "PAB",
+    "PEN",
+    "PGK",
+    "PHP",
+    "PKR",
+    "PLN",
+    "PYG",
+    "QAR",
+    "RON",
+    "RSD",
+    "RUB",
+    "RWF",
+    "SAR",
+    "SBD",
+    "SCR",
+    "SEK",
+    "SGD",
+    "SHP",
+    "SLL",
+    "SOS",
+    "SRD",
+    "STD",
+    "SVC",
+    "SZL",
+    "THB",
+    "TJS",
+    "TOP",
+    "TRY",
+    "TTD",
+    "TWD",
+    "TZS",
+    "UAH",
+    "UGX",
+    "USD",
+    "UYU",
+    "UZS",
+    "VEF",
+    "VND",
+    "VUV",
+    "WST",
+    "XAF",
+    "XCD",
+    "XOF",
+    "XPF",
+    "YER",
+    "ZAR",
+    "ZMW",
+];

package/dist/cjs/utils/currencies.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Currencies supported by Stripe for payments.
+ * @see https://stripe.com/docs/currencies
+ */
+export declare const currencies: readonly ["AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BWP", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EEK", "EGP", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "ISK", "JMD", "JPY", "KES", "KGS", "KHR", "KMF", "KRW", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "MAD", "MDL", "MGA", "MKD", "MNT", "MOP", "MRO", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SEK", "SGD", "SHP", "SLL", "SOS", "SRD", "STD", "SVC", "SZL", "THB", "TJS", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VEF", "VND", "VUV", "WST", "XAF", "XCD", "XOF", "XPF", "YER", "ZAR", "ZMW"];
+//# sourceMappingURL=currencies.d.ts.map

package/dist/cjs/utils/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../../../src/utils/currencies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU,w9BA4Ib,CAAC"}

package/dist/cjs/utils/dateTime.cjs

@@ -0,0 +1,192 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentWeekDatesSundayToSaturday = exports.validateDate = exports.validYearMonth = exports.dayOfWeek = exports.howManyDaysInMonth = exports.to24h = exports.to12h = exports.isValidDateTime = exports.addToDate = exports.getDayjsFunc = exports.getDayjsFuncUTC = exports.getDayjs = exports.getHoursInArray = exports.getDaysInArray = exports.timeExpired = exports.dateIsBetween = exports.getLastXMonths = exports.getLastXDays = exports.convertLocaleToUTC = exports.convertTimeToLocale = exports.formatDate = exports.currentFullDate = exports.getUTCTimestamp = exports.yesterday = exports.today = exports.lastMonth = exports.beginningOfLastMonth = exports.endOfThisMonth = exports.beginningOfThisMonth = exports.endOfNextWeek = exports.beginningOfNextWeek = exports.endOfLastWeek = exports.beginningOfLastWeek = exports.endOfThisWeek = exports.beginningOfThisWeek = exports.thisMonth = exports.thisYear = exports.defaultDateFormat = exports.dateFormat = void 0;
+const dayjs_1 = __importDefault(require("dayjs"));
+const utc_js_1 = __importDefault(require("dayjs/plugin/utc.js"));
+const timezone_js_1 = __importDefault(require("dayjs/plugin/timezone.js"));
+const customParseFormat_js_1 = __importDefault(require("dayjs/plugin/customParseFormat.js"));
+const advancedFormat_js_1 = __importDefault(require("dayjs/plugin/advancedFormat.js"));
+const isBetween_js_1 = __importDefault(require("dayjs/plugin/isBetween.js"));
+const isSameOrAfter_js_1 = __importDefault(require("dayjs/plugin/isSameOrAfter.js"));
+const isSameOrBefore_js_1 = __importDefault(require("dayjs/plugin/isSameOrBefore.js"));
+dayjs_1.default.extend(utc_js_1.default);
+dayjs_1.default.extend(timezone_js_1.default);
+dayjs_1.default.extend(customParseFormat_js_1.default);
+dayjs_1.default.extend(advancedFormat_js_1.default);
+dayjs_1.default.extend(isBetween_js_1.default);
+dayjs_1.default.extend(isSameOrAfter_js_1.default);
+dayjs_1.default.extend(isSameOrBefore_js_1.default);
+exports.dateFormat = "YYYY-MM-DD";
+exports.defaultDateFormat = "YYYY-MM-DD HH:mm:ss";
+const thisYear = () => (0, dayjs_1.default)().utc().format("YYYY");
+exports.thisYear = thisYear;
+const thisMonth = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).format("YYYY-MM");
+exports.thisMonth = thisMonth;
+const beginningOfThisWeek = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).startOf("week").format("YYYY-MM-DD");
+exports.beginningOfThisWeek = beginningOfThisWeek;
+const endOfThisWeek = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).endOf("week").format("YYYY-MM-DD");
+exports.endOfThisWeek = endOfThisWeek;
+const beginningOfLastWeek = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).subtract(1, "week").startOf("week").format("YYYY-MM-DD");
+exports.beginningOfLastWeek = beginningOfLastWeek;
+const endOfLastWeek = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).subtract(1, "week").endOf("week").format("YYYY-MM-DD");
+exports.endOfLastWeek = endOfLastWeek;
+const beginningOfNextWeek = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).add(1, "week").startOf("week").format("YYYY-MM-DD");
+exports.beginningOfNextWeek = beginningOfNextWeek;
+const endOfNextWeek = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).add(1, "week").endOf("week").format("YYYY-MM-DD");
+exports.endOfNextWeek = endOfNextWeek;
+const beginningOfThisMonth = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).startOf("month").format("YYYY-MM-DD");
+exports.beginningOfThisMonth = beginningOfThisMonth;
+const endOfThisMonth = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).endOf("month").format("YYYY-MM-DD");
+exports.endOfThisMonth = endOfThisMonth;
+const beginningOfLastMonth = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).subtract(1, "month").startOf("month").format("YYYY-MM-DD");
+exports.beginningOfLastMonth = beginningOfLastMonth;
+const lastMonth = () => (0, dayjs_1.default)().subtract(1, "month").endOf("month").utc().format("YYYY-MM");
+exports.lastMonth = lastMonth;
+const today = (timezone = "UTC") => (0, dayjs_1.default)().tz(timezone).format(exports.dateFormat);
+exports.today = today;
+const yesterday = () => (0, dayjs_1.default)().subtract(1, "day").utc().format(exports.dateFormat);
+exports.yesterday = yesterday;
+const getUTCTimestamp = () => (0, dayjs_1.default)().utc().valueOf();
+exports.getUTCTimestamp = getUTCTimestamp;
+/**
+ * @returns current date time in utc
+ */
+const currentFullDate = () => (0, dayjs_1.default)().utc().format(exports.defaultDateFormat);
+exports.currentFullDate = currentFullDate;
+const formatDate = (date, format = "Do MMM., YYYY") => (0, dayjs_1.default)(date).format(format);
+exports.formatDate = formatDate;
+/**
+ * converts UTC datetime to user's locale
+ */
+const convertTimeToLocale = (date, timezoneName, format = exports.defaultDateFormat) => {
+    const d = dayjs_1.default.utc(date);
+    return d.tz(timezoneName).format(format);
+};
+exports.convertTimeToLocale = convertTimeToLocale;
+const convertLocaleToUTC = (date, timezoneName, format = exports.defaultDateFormat) => {
+    return dayjs_1.default.tz(date, format, timezoneName).utc().format(format);
+};
+exports.convertLocaleToUTC = convertLocaleToUTC;
+const getLastXDays = (numDays, startFrom) => {
+    const formattedDates = [];
+    for (let i = 0; i < numDays; i++) {
+        formattedDates.push((0, dayjs_1.default)(startFrom).subtract(i, "day").format("YYYY-MM-DD"));
+    }
+    return formattedDates.reverse();
+};
+exports.getLastXDays = getLastXDays;
+const getLastXMonths = (months, startFrom) => {
+    const formattedDates = [];
+    for (let i = 0; i < months; i++) {
+        formattedDates.push((0, dayjs_1.default)(startFrom).subtract(i, "month").format("YYYY-MM"));
+    }
+    return formattedDates.reverse();
+};
+exports.getLastXMonths = getLastXMonths;
+const dateIsBetween = (from, to, granularity = "day", now) => {
+    const check = now ?? (0, dayjs_1.default)().utc();
+    const exp = dayjs_1.default.utc(to);
+    const start = dayjs_1.default.utc(from);
+    return check.isBetween(start, exp, granularity, "[]");
+};
+exports.dateIsBetween = dateIsBetween;
+const timeExpired = (date, now, inclusive = false) => {
+    const check = now ?? (0, dayjs_1.default)().utc();
+    const exp = dayjs_1.default.utc(date);
+    return inclusive ? check.isSameOrAfter(exp) : check.isAfter(exp);
+};
+exports.timeExpired = timeExpired;
+const getDaysInArray = (startDate, endDate, format = exports.dateFormat) => {
+    const end = dayjs_1.default.utc((0, dayjs_1.default)(endDate).format(format));
+    const start = dayjs_1.default.utc((0, dayjs_1.default)(startDate).format(format));
+    const days = [];
+    let current = start;
+    while (current.isSameOrBefore(end)) {
+        days.push(current.format(format));
+        current = current.add(1, "day");
+    }
+    return days;
+};
+exports.getDaysInArray = getDaysInArray;
+const getHoursInArray = (startDate, endDate) => {
+    const end = dayjs_1.default.utc(endDate);
+    const start = dayjs_1.default.utc(startDate);
+    const days = [];
+    let current = start;
+    while (current.isSameOrBefore(end)) {
+        days.push(current.format("YYYY-MM-DD HH:00:00"));
+        current = current.add(1, "hour");
+    }
+    return days;
+};
+exports.getHoursInArray = getHoursInArray;
+exports.getDayjs = dayjs_1.default;
+const getDayjsFuncUTC = (inp) => dayjs_1.default.utc(inp);
+exports.getDayjsFuncUTC = getDayjsFuncUTC;
+const getDayjsFunc = (inp) => (0, dayjs_1.default)(inp);
+exports.getDayjsFunc = getDayjsFunc;
+const addToDate = (creationDate, total, unit = "minute", format = exports.defaultDateFormat) => (0, dayjs_1.default)(creationDate).add(total, unit).format(format);
+exports.addToDate = addToDate;
+const isValidDateTime = (value) => (0, dayjs_1.default)(value).isValid();
+exports.isValidDateTime = isValidDateTime;
+/** Convert 24h "HH:mm" to 12h { hour: 1-12, period: "AM"|"PM" } */
+const to12h = (time24) => {
+    const [h] = time24.split(":").map(Number);
+    const hour24 = h ?? 0;
+    if (hour24 === 0)
+        return { hour: 12, period: "AM" };
+    if (hour24 === 12)
+        return { hour: 12, period: "PM" };
+    if (hour24 < 12)
+        return { hour: hour24, period: "AM" };
+    return { hour: hour24 - 12, period: "PM" };
+};
+exports.to12h = to12h;
+/** Convert 12h to 24h "HH:mm" */
+const to24h = (hour, period) => {
+    let h = hour;
+    if (period === "AM") {
+        h = hour === 12 ? 0 : hour;
+    }
+    else {
+        h = hour === 12 ? 12 : hour + 12;
+    }
+    return `${String(h).padStart(2, "0")}:00`;
+};
+exports.to24h = to24h;
+const howManyDaysInMonth = (year, month) => {
+    return (0, dayjs_1.default)().month(month - 1).year(year).daysInMonth();
+};
+exports.howManyDaysInMonth = howManyDaysInMonth;
+const dayOfWeek = (date) => {
+    return (0, dayjs_1.default)(date).day();
+};
+exports.dayOfWeek = dayOfWeek;
+const validYearMonth = (yearMonth) => {
+    if (!yearMonth || !yearMonth.match(/^\d{4}-\d{2}$/))
+        return false;
+    const [year, month] = yearMonth.split("-").map(Number);
+    return year >= 1000 && year <= 9999 && month >= 1 && month <= 12;
+};
+exports.validYearMonth = validYearMonth;
+const validateDate = (date) => {
+    return (0, dayjs_1.default)(date).isValid();
+};
+exports.validateDate = validateDate;
+/**
+ * Returns an array of 7 dates (Sunday → Saturday for the current week)
+ * formatted as YYYY-MM-DD using the tenant's timezone (fallback to UTC).
+ */
+const getCurrentWeekDatesSundayToSaturday = (timezone = "UTC") => {
+    // Start from "now" in the tenant's timezone, then take the week starting Sunday in that tz.
+    const startOfWeek = (0, dayjs_1.default)().tz(timezone).startOf("week"); // Sunday-start week
+    const days = [];
+    for (let i = 0; i < 7; i++) {
+        days.push(startOfWeek.add(i, "day").tz(timezone).format(exports.dateFormat));
+    }
+    return days;
+};
+exports.getCurrentWeekDatesSundayToSaturday = getCurrentWeekDatesSundayToSaturday;

package/dist/cjs/utils/dateTime.d.ts

@@ -0,0 +1,57 @@
+import dayjs from "dayjs";
+export declare const dateFormat = "YYYY-MM-DD";
+export declare const defaultDateFormat = "YYYY-MM-DD HH:mm:ss";
+export declare const thisYear: () => string;
+export declare const thisMonth: (timezone?: string) => string;
+export declare const beginningOfThisWeek: (timezone?: string) => string;
+export declare const endOfThisWeek: (timezone?: string) => string;
+export declare const beginningOfLastWeek: (timezone?: string) => string;
+export declare const endOfLastWeek: (timezone?: string) => string;
+export declare const beginningOfNextWeek: (timezone?: string) => string;
+export declare const endOfNextWeek: (timezone?: string) => string;
+export declare const beginningOfThisMonth: (timezone?: string) => string;
+export declare const endOfThisMonth: (timezone?: string) => string;
+export declare const beginningOfLastMonth: (timezone?: string) => string;
+export declare const lastMonth: () => string;
+export declare const today: (timezone?: string) => string;
+export declare const yesterday: () => string;
+export declare const getUTCTimestamp: () => number;
+/**
+ * @returns current date time in utc
+ */
+export declare const currentFullDate: () => string;
+export declare const formatDate: (date: string, format?: string) => string;
+/**
+ * converts UTC datetime to user's locale
+ */
+export declare const convertTimeToLocale: (date: string, timezoneName: string, format?: string) => string;
+export declare const convertLocaleToUTC: (date: string, timezoneName: string, format?: string) => string;
+export declare const getLastXDays: (numDays: number, startFrom?: string) => string[];
+export declare const getLastXMonths: (months: number, startFrom?: string) => string[];
+export type DayjsUnit = "year" | "month" | "week" | "day" | "hour" | "minute";
+export declare const dateIsBetween: (from: string, to: string, granularity?: DayjsUnit, now?: dayjs.Dayjs) => boolean;
+export declare const timeExpired: (date: string, now?: dayjs.Dayjs, inclusive?: boolean) => boolean;
+export declare const getDaysInArray: (startDate: string, endDate: string, format?: string) => string[];
+export declare const getHoursInArray: (startDate: string, endDate: string) => string[];
+export declare const getDayjs: typeof dayjs;
+export declare const getDayjsFuncUTC: (inp?: string | Date | dayjs.Dayjs) => dayjs.Dayjs;
+export declare const getDayjsFunc: (inp?: string | Date | dayjs.Dayjs) => dayjs.Dayjs;
+export declare const addToDate: (creationDate: string, total: number, unit?: dayjs.ManipulateType, format?: string) => string;
+export declare const isValidDateTime: (value: string) => boolean;
+/** Convert 24h "HH:mm" to 12h { hour: 1-12, period: "AM"|"PM" } */
+export declare const to12h: (time24: string) => {
+    hour: number;
+    period: "AM" | "PM";
+};
+/** Convert 12h to 24h "HH:mm" */
+export declare const to24h: (hour: number, period: "AM" | "PM") => string;
+export declare const howManyDaysInMonth: (year: number, month: number) => number;
+export declare const dayOfWeek: (date: string) => number;
+export declare const validYearMonth: (yearMonth: string) => boolean;
+export declare const validateDate: (date: string) => boolean;
+/**
+ * Returns an array of 7 dates (Sunday → Saturday for the current week)
+ * formatted as YYYY-MM-DD using the tenant's timezone (fallback to UTC).
+ */
+export declare const getCurrentWeekDatesSundayToSaturday: (timezone?: string) => string[];
+//# sourceMappingURL=dateTime.d.ts.map

package/dist/cjs/utils/dateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateTime.d.ts","sourceRoot":"","sources":["../../../src/utils/dateTime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAiB1B,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AACvD,eAAO,MAAM,QAAQ,cAAqC,CAAC;AAC3D,eAAO,MAAM,SAAS,GAAI,iBAAgB,WAA2C,CAAC;AACtF,eAAO,MAAM,mBAAmB,GAAI,iBAAgB,WAA8D,CAAC;AACnH,eAAO,MAAM,aAAa,GAAI,iBAAgB,WAA4D,CAAC;AAC3G,eAAO,MAAM,mBAAmB,GAAI,iBAAgB,WAAkF,CAAC;AACvI,eAAO,MAAM,aAAa,GAAI,iBAAgB,WAAgF,CAAC;AAC/H,eAAO,MAAM,mBAAmB,GAAI,iBAAgB,WAA6E,CAAC;AAClI,eAAO,MAAM,aAAa,GAAI,iBAAgB,WAA2E,CAAC;AAC1H,eAAO,MAAM,oBAAoB,GAAI,iBAAgB,WAA+D,CAAC;AACrH,eAAO,MAAM,cAAc,GAAI,iBAAgB,WAA6D,CAAC;AAC7G,eAAO,MAAM,oBAAoB,GAAI,iBAAgB,WAAoF,CAAC;AAC1I,eAAO,MAAM,SAAS,cACiD,CAAC;AACxE,eAAO,MAAM,KAAK,GAAI,iBAAgB,WAA4C,CAAC;AACnF,eAAO,MAAM,SAAS,cACiC,CAAC;AACxD,eAAO,MAAM,eAAe,cAAgC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,eAAe,cACe,CAAC;AAC5C,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,eAAwB,WACnC,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC5B,MAAM,MAAM,EACZ,cAAc,MAAM,EACpB,eAA0B,KAC3B,MAGF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC3B,MAAM,MAAM,EACZ,cAAc,MAAM,EACpB,eAA0B,KAC3B,MAEF,CAAC;AAEF,eAAO,MAAM,YAAY,GACrB,SAAS,MAAM,EACf,YAAY,MAAM,KACnB,MAAM,EAQR,CAAC;AAEF,eAAO,MAAM,cAAc,GACvB,QAAQ,MAAM,EACd,YAAY,MAAM,KACnB,MAAM,EAQR,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9E,eAAO,MAAM,aAAa,GACtB,MAAM,MAAM,EACZ,IAAI,MAAM,EACV,cAAa,SAAiB,EAC9B,MAAM,KAAK,CAAC,KAAK,KAClB,OAKF,CAAC;AAEF,eAAO,MAAM,WAAW,GACpB,MAAM,MAAM,EACZ,MAAM,KAAK,CAAC,KAAK,EACjB,mBAAiB,KAClB,OAIF,CAAC;AAEF,eAAO,MAAM,cAAc,GACvB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,eAAmB,aAWtB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,EAAE,SAAS,MAAM,aAUjE,CAAC;AAEF,eAAO,MAAM,QAAQ,cAAQ,CAAC;AAC9B,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK,gBAC/C,CAAC;AACnB,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK,gBAAe,CAAC;AAC9E,eAAO,MAAM,SAAS,GAClB,cAAc,MAAM,EACpB,OAAO,MAAM,EACb,OAAM,KAAK,CAAC,cAAyB,EACrC,eAA0B,KAC3B,MAA6D,CAAC;AACjE,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,YAA2B,CAAC;AAEzE,mEAAmE;AACnE,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAA;CAOzE,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,QAAQ,IAAI,GAAG,IAAI,KAAG,MAQzD,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MAEhE,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAExC,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,OAIlD,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAE3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mCAAmC,GAAI,iBAAgB,KAAG,MAAM,EAQ5E,CAAA"}