katanakit-js 2.2.1 → 2.12.9

package/dist/core/services/dates.service.js

@@ -1,64 +1,211 @@
 import { Temporal } from "@js-temporal/polyfill";
 /**
- * Facade + Adapter + Singleton over the Temporal polyfill.
+ * Internal helper that adapts flexible inputs into a `PlainDate`.
+ *
+ * @param date - An ISO date string or a `Temporal.PlainDate`.
+ * @returns A `Temporal.PlainDate`.
  */
-export class DatesService {
-    static instance;
-    constructor() { }
-    static getInstance() {
-        if (!DatesService.instance) {
-            DatesService.instance = new DatesService();
+function toPlainDate(date) {
+    return typeof date === "string" ? Temporal.PlainDate.from(date) : date;
+}
+/**
+ * Returns a human-readable diff between two dates as years, months, and days.
+ *
+ * @param start - Start date (ISO string or `PlainDate`).
+ * @param end - End date (ISO string or `PlainDate`).
+ * @returns A formatted string, e.g. `"2 years, 3 months and 15 days"`.
+ *
+ * @example
+ * ```ts
+ * useDiff("2020-01-01", "2022-04-16");
+ * // "2 years, 3 months and 15 days"
+ * ```
+ */
+export function useDiff(start, end) {
+    const startDate = toPlainDate(start);
+    const endDate = toPlainDate(end);
+    const duration = startDate.until(endDate, { largestUnit: "year" });
+    return `${duration.years} years, ${duration.months} months and ${duration.days} days`;
+}
+/**
+ * Formats a date input into a localised string using `Intl.DateTimeFormat`.
+ *
+ * Accepts epoch milliseconds, ISO strings, native `Date` objects,
+ * `Temporal.Instant`, or any `Temporal` date/time type.
+ *
+ * @param dateInput - The value to format.
+ * @param locale - BCP 47 locale tag (defaults to `"en"`).
+ * @param options - `Intl.DateTimeFormatOptions` (defaults to `{}`).
+ * @returns The formatted date string.
+ * @throws {Error} If the input cannot be parsed as a date.
+ *
+ * @example
+ * ```ts
+ * useFormat("2024-06-15");                        // "6/15/2024" (en-US)
+ * useFormat(Date.now(), "es", { dateStyle: "full" }); // "sábado, 15 de junio de 2024"
+ * ```
+ */
+export function useFormat(dateInput, locale = "en", options = {}) {
+    let date;
+    try {
+        if (typeof dateInput === "number") {
+            date = Temporal.Instant.fromEpochMilliseconds(dateInput).toZonedDateTimeISO(Temporal.Now.timeZoneId());
         }
-        return DatesService.instance;
-    }
-    // Private helper that adapts flexible inputs into a PlainDate.
-    TO_PLAIN_DATE = (date) => typeof date === "string" ? Temporal.PlainDate.from(date) : date;
-    useDiff = (start, end) => {
-        const startDate = this.TO_PLAIN_DATE(start);
-        const endDate = this.TO_PLAIN_DATE(end);
-        const duration = startDate.until(endDate, { largestUnit: "year" });
-        return `${duration.years} years, ${duration.months} months and ${duration.days} days`;
-    };
-    useFormat = (dateInput, locale = "en", options = {}) => {
-        let date;
-        try {
-            if (typeof dateInput === "number") {
-                date = Temporal.Instant.fromEpochMilliseconds(dateInput).toZonedDateTimeISO(Temporal.Now.timeZoneId());
-            }
-            else if (typeof dateInput === "string") {
-                try {
-                    date = Temporal.PlainDate.from(dateInput);
-                }
-                catch {
-                    date = Temporal.PlainDateTime.from(dateInput);
-                }
-            }
-            else if (dateInput instanceof Date) {
-                date = Temporal.Instant.fromEpochMilliseconds(dateInput.getTime()).toZonedDateTimeISO(Temporal.Now.timeZoneId());
+        else if (typeof dateInput === "string") {
+            try {
+                date = Temporal.PlainDate.from(dateInput);
             }
-            else if (dateInput instanceof Temporal.Instant) {
-                date = dateInput.toZonedDateTimeISO(Temporal.Now.timeZoneId());
+            catch {
+                date = Temporal.PlainDateTime.from(dateInput);
             }
-            else {
-                date = dateInput;
-            }
-            return date.toLocaleString(locale, options);
         }
-        catch (error) {
-            console.error("Invalid date input:", error);
-            throw new Error(`Invalid date input: ${dateInput}`);
+        else if (dateInput instanceof Date) {
+            date = Temporal.Instant.fromEpochMilliseconds(dateInput.getTime()).toZonedDateTimeISO(Temporal.Now.timeZoneId());
+        }
+        else if (dateInput instanceof Temporal.Instant) {
+            date = dateInput.toZonedDateTimeISO(Temporal.Now.timeZoneId());
         }
-    };
-    useNow = () => Temporal.Now.plainDateISO().toString();
-    useNowDateTime = () => Temporal.Now.plainDateTimeISO().toString();
-    useAddDays = (date, days) => this.TO_PLAIN_DATE(date).add({ days }).toString();
-    useSubtractDays = (date, days) => this.TO_PLAIN_DATE(date).subtract({ days }).toString();
-    useIsEqual = (date1, date2) => Temporal.PlainDate.compare(this.TO_PLAIN_DATE(date1), this.TO_PLAIN_DATE(date2)) === 0;
-    useIsBefore = (date1, date2) => Temporal.PlainDate.compare(this.TO_PLAIN_DATE(date1), this.TO_PLAIN_DATE(date2)) < 0;
-    useIsAfter = (date1, date2) => Temporal.PlainDate.compare(this.TO_PLAIN_DATE(date1), this.TO_PLAIN_DATE(date2)) > 0;
-    useFirstDayOfMonth = (date = Temporal.Now.plainDateISO()) => this.TO_PLAIN_DATE(date).with({ day: 1 }).toString();
-    useLastDayOfMonth = (date = Temporal.Now.plainDateISO()) => this.TO_PLAIN_DATE(date).add({ months: 1 }).with({ day: 1 }).subtract({ days: 1 }).toString();
+        else {
+            date = dateInput;
+        }
+        return date.toLocaleString(locale, options);
+    }
+    catch (error) {
+        console.error("Invalid date input:", error);
+        throw new Error(`Invalid date input: ${dateInput}`);
+    }
+}
+/**
+ * Returns today's date as an ISO date string.
+ *
+ * @returns The current date in `YYYY-MM-DD` format.
+ *
+ * @example
+ * ```ts
+ * useNow(); // "2024-06-15"
+ * ```
+ */
+export function useNow() {
+    return Temporal.Now.plainDateISO().toString();
+}
+/**
+ * Returns the current date and time as an ISO string (no timezone offset).
+ *
+ * @returns The current date-time in `YYYY-MM-DDTHH:MM:SS` format.
+ *
+ * @example
+ * ```ts
+ * useNowDateTime(); // "2024-06-15T14:30:00"
+ * ```
+ */
+export function useNowDateTime() {
+    return Temporal.Now.plainDateTimeISO().toString();
+}
+/**
+ * Adds a number of days to a date.
+ *
+ * @param date - Base date (ISO string or `PlainDate`).
+ * @param days - Number of days to add (can be negative).
+ * @returns The resulting date as an ISO string.
+ *
+ * @example
+ * ```ts
+ * useAddDays("2024-01-01", 10); // "2024-01-11"
+ * ```
+ */
+export function useAddDays(date, days) {
+    return toPlainDate(date).add({ days }).toString();
+}
+/**
+ * Subtracts a number of days from a date.
+ *
+ * @param date - Base date (ISO string or `PlainDate`).
+ * @param days - Number of days to subtract.
+ * @returns The resulting date as an ISO string.
+ *
+ * @example
+ * ```ts
+ * useSubtractDays("2024-01-11", 10); // "2024-01-01"
+ * ```
+ */
+export function useSubtractDays(date, days) {
+    return toPlainDate(date).subtract({ days }).toString();
+}
+/**
+ * Checks whether two dates are equal.
+ *
+ * @param date1 - First date (ISO string or `PlainDate`).
+ * @param date2 - Second date (ISO string or `PlainDate`).
+ * @returns `true` if the dates represent the same day.
+ *
+ * @example
+ * ```ts
+ * useIsEqual("2024-06-15", "2024-06-15"); // true
+ * useIsEqual("2024-06-15", "2024-06-16"); // false
+ * ```
+ */
+export function useIsEqual(date1, date2) {
+    return Temporal.PlainDate.compare(toPlainDate(date1), toPlainDate(date2)) === 0;
+}
+/**
+ * Checks whether `date1` is before `date2`.
+ *
+ * @param date1 - First date (ISO string or `PlainDate`).
+ * @param date2 - Second date (ISO string or `PlainDate`).
+ * @returns `true` if `date1` is strictly before `date2`.
+ *
+ * @example
+ * ```ts
+ * useIsBefore("2024-01-01", "2024-06-15"); // true
+ * useIsBefore("2024-06-15", "2024-06-15"); // false
+ * ```
+ */
+export function useIsBefore(date1, date2) {
+    return Temporal.PlainDate.compare(toPlainDate(date1), toPlainDate(date2)) < 0;
+}
+/**
+ * Checks whether `date1` is after `date2`.
+ *
+ * @param date1 - First date (ISO string or `PlainDate`).
+ * @param date2 - Second date (ISO string or `PlainDate`).
+ * @returns `true` if `date1` is strictly after `date2`.
+ *
+ * @example
+ * ```ts
+ * useIsAfter("2024-06-15", "2024-01-01"); // true
+ * useIsAfter("2024-06-15", "2024-06-15"); // false
+ * ```
+ */
+export function useIsAfter(date1, date2) {
+    return Temporal.PlainDate.compare(toPlainDate(date1), toPlainDate(date2)) > 0;
+}
+/**
+ * Returns the first day of the month for a given date.
+ *
+ * @param date - Base date (defaults to today).
+ * @returns The first day of the month as an ISO string.
+ *
+ * @example
+ * ```ts
+ * useFirstDayOfMonth("2024-06-15"); // "2024-06-01"
+ * ```
+ */
+export function useFirstDayOfMonth(date = Temporal.Now.plainDateISO()) {
+    return toPlainDate(date).with({ day: 1 }).toString();
+}
+/**
+ * Returns the last day of the month for a given date.
+ *
+ * @param date - Base date (defaults to today).
+ * @returns The last day of the month as an ISO string.
+ *
+ * @example
+ * ```ts
+ * useLastDayOfMonth("2024-02-10"); // "2024-02-29" (leap year)
+ * useLastDayOfMonth("2024-06-15"); // "2024-06-30"
+ * ```
+ */
+export function useLastDayOfMonth(date = Temporal.Now.plainDateISO()) {
+    return toPlainDate(date).add({ months: 1 }).with({ day: 1 }).subtract({ days: 1 }).toString();
 }
-// Singleton instance and destructured exports.
-export const { useDiff, useFormat, useNow, useNowDateTime, useAddDays, useSubtractDays, useIsEqual, useIsBefore, useIsAfter, useFirstDayOfMonth, useLastDayOfMonth, } = DatesService.getInstance();
 //# sourceMappingURL=dates.service.js.map

package/dist/core/services/dates.service.js.map

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

package/dist/core/services/error.service.d.ts

@@ -1,25 +1,37 @@
-import type { IErrorFactory, ISerializedError } from "../../types/index.js";
+import type { ISerializedError } from "../../types/index.js";
 /**
- * Decoupled application error. Carries an HTTP-style status code.
+ * Serialize an error into a plain object.
+ * Uses sensible defaults based on the status code when message is omitted.
+ *
+ * @param message - Error message (falls back to status code default)
+ * @param code - HTTP status code (default: 400)
+ * @returns Serialized error with message and code
+ *
+ * @example
+ * ```ts
+ * const err = useErrorSerialize("User not found", 404);
+ * // { message: "User not found", code: 404 }
+ *
+ * const err2 = useErrorSerialize("", 500);
+ * // { message: "Internal Server Error", code: 500 }
+ * ```
  */
-export declare class AppError extends Error {
-    readonly code: number;
-    constructor(message?: string, code?: number);
-    useToJson: () => ISerializedError;
-}
+export declare function useErrorSerialize(message?: string, code?: number): ISerializedError;
 /**
- * Error factory implemented as a singleton (Factory Method pattern).
+ * Create a custom error object. Use with `useLogger` for consistent error logging.
+ *
+ * @param msg - Error message
+ * @param code - HTTP status code
+ * @returns Serialized error with message and code
+ *
+ * @example
+ * ```ts
+ * import { useErrorCustom, useLogger } from "katanakit-js";
+ *
+ * const error = useErrorCustom("User not found", 404);
+ * useLogger("error", error.message, error);
+ * // { message: "User not found", code: 404 }
+ * ```
  */
-export declare class ErrorFactoryService implements IErrorFactory {
-    private static instance;
-    private constructor();
-    static getInstance(): ErrorFactoryService;
-    useBadRequest: (message?: string) => AppError;
-    useUnauthorized: (message?: string) => AppError;
-    useForbidden: (message?: string) => AppError;
-    useNotFound: (message?: string) => AppError;
-    useInternal: (message?: string) => AppError;
-    useCustom: (message: string, code: number) => AppError;
-}
-export declare const useBadRequest: (message?: string) => AppError, useUnauthorized: (message?: string) => AppError, useForbidden: (message?: string) => AppError, useNotFound: (message?: string) => AppError, useInternal: (message?: string) => AppError, useCustom: (message: string, code: number) => AppError;
+export declare function useErrorCustom(msg: string, code: number): ISerializedError;
 //# sourceMappingURL=error.service.d.ts.map

package/dist/core/services/error.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/error.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;IAF7B,YACC,OAAO,SAAkB,EACT,IAAI,GAAE,MAAY,EAKlC;IAEM,SAAS,QAAO,gBAAgB,CAIpC;CACH;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAE7C,OAAO,eAAiB;IAExB,OAAc,WAAW,IAAI,mBAAmB,CAK/C;IAEM,aAAa,wBAA8B,QAAQ,CAA+B;IAElF,eAAe,wBAA+B,QAAQ,CAA+B;IAErF,YAAY,wBAA4B,QAAQ,CAA+B;IAE/E,WAAW,wBAA4B,QAAQ,CAA+B;IAE9E,WAAW,wBAAwC,QAAQ,CAA+B;IAE1F,SAAS,YAAa,MAAM,QAAQ,MAAM,KAAG,QAAQ,CAAgC;CAC5F;AAGD,eAAO,MACN,aAAa,wBAfqC,QAAQ,EAgB1D,eAAe,wBAdsC,QAAQ,EAe7D,YAAY,wBAbmC,QAAQ,EAcvD,WAAW,wBAZmC,QAAQ,EAatD,WAAW,wBAX+C,QAAQ,EAYlE,SAAS,YAVoB,MAAM,QAAQ,MAAM,KAAG,QAWK,CAAC"}
+{"version":3,"file":"error.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/error.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAW7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAK,EAAE,IAAI,SAAM,GAAG,gBAAgB,CAK5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAE1E"}

package/dist/core/services/error.service.js

@@ -1,39 +1,51 @@
+/** Default error messages by HTTP status code. */
+const ERROR_DEFAULTS = {
+    400: "Bad Request",
+    401: "Unauthorized",
+    403: "Forbidden",
+    404: "Not Found",
+    500: "Internal Server Error",
+};
 /**
- * Decoupled application error. Carries an HTTP-style status code.
+ * Serialize an error into a plain object.
+ * Uses sensible defaults based on the status code when message is omitted.
+ *
+ * @param message - Error message (falls back to status code default)
+ * @param code - HTTP status code (default: 400)
+ * @returns Serialized error with message and code
+ *
+ * @example
+ * ```ts
+ * const err = useErrorSerialize("User not found", 404);
+ * // { message: "User not found", code: 404 }
+ *
+ * const err2 = useErrorSerialize("", 500);
+ * // { message: "Internal Server Error", code: 500 }
+ * ```
  */
-export class AppError extends Error {
-    code;
-    constructor(message = "Unknown error", code = 400) {
-        super(message);
-        this.code = code;
-        this.name = "AppError";
-        Object.setPrototypeOf(this, AppError.prototype);
-    }
-    useToJson = () => ({
-        name: this.name,
-        message: this.message,
-        code: this.code,
-    });
+export function useErrorSerialize(message = "", code = 400) {
+    return {
+        message: message || ERROR_DEFAULTS[code] || "Error",
+        code,
+    };
 }
 /**
- * Error factory implemented as a singleton (Factory Method pattern).
+ * Create a custom error object. Use with `useLogger` for consistent error logging.
+ *
+ * @param msg - Error message
+ * @param code - HTTP status code
+ * @returns Serialized error with message and code
+ *
+ * @example
+ * ```ts
+ * import { useErrorCustom, useLogger } from "katanakit-js";
+ *
+ * const error = useErrorCustom("User not found", 404);
+ * useLogger("error", error.message, error);
+ * // { message: "User not found", code: 404 }
+ * ```
  */
-export class ErrorFactoryService {
-    static instance;
-    constructor() { }
-    static getInstance() {
-        if (!ErrorFactoryService.instance) {
-            ErrorFactoryService.instance = new ErrorFactoryService();
-        }
-        return ErrorFactoryService.instance;
-    }
-    useBadRequest = (message = "Bad Request") => new AppError(message, 400);
-    useUnauthorized = (message = "Unauthorized") => new AppError(message, 401);
-    useForbidden = (message = "Forbidden") => new AppError(message, 403);
-    useNotFound = (message = "Not Found") => new AppError(message, 404);
-    useInternal = (message = "Internal Server Error") => new AppError(message, 500);
-    useCustom = (message, code) => new AppError(message, code);
+export function useErrorCustom(msg, code) {
+    return useErrorSerialize(msg, code);
 }
-// Singleton instance and destructured exports.
-export const { useBadRequest, useUnauthorized, useForbidden, useNotFound, useInternal, useCustom, } = ErrorFactoryService.getInstance();
 //# sourceMappingURL=error.service.js.map

package/dist/core/services/error.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.service.js","sourceRoot":"","sources":["../../../src/core/services/error.service.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGjB,IAAI;IAFrB,YACC,OAAO,GAAG,eAAe,EACT,IAAI,GAAW,GAAG;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAFC,IAAI;QAGpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAEM,SAAS,GAAG,GAAqB,EAAE,CAAC,CAAC;QAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KACf,CAAC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACvB,MAAM,CAAC,QAAQ,CAAsB;IAE7C,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACxB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YACnC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC;IACrC,CAAC;IAEM,aAAa,GAAG,CAAC,OAAO,GAAG,aAAa,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAElF,eAAe,GAAG,CAAC,OAAO,GAAG,cAAc,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAErF,YAAY,GAAG,CAAC,OAAO,GAAG,WAAW,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE/E,WAAW,GAAG,CAAC,OAAO,GAAG,WAAW,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE9E,WAAW,GAAG,CAAC,OAAO,GAAG,uBAAuB,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE1F,SAAS,GAAG,CAAC,OAAe,EAAE,IAAY,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;CAC5F;AAED,+CAA+C;AAC/C,MAAM,CAAC,MAAM,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,GACT,GAAwB,mBAAmB,CAAC,WAAW,EAAE,CAAC"}
+{"version":3,"file":"error.service.js","sourceRoot":"","sources":["../../../src/core/services/error.service.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,MAAM,cAAc,GAA2B;IAC9C,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,uBAAuB;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAG,EAAE,EAAE,IAAI,GAAG,GAAG;IACzD,OAAO;QACN,OAAO,EAAE,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,OAAO;QACnD,IAAI;KACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY;IACvD,OAAO,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC"}