@rtorcato/js-common 2.0.0 → 2.0.1

package/dist/datetime/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Returns the current date and time as an ISO string (YYYY-MM-DDTHH:mm:ss.sssZ).
+ */
+export declare function nowIso(): string;
+/**
+ * Parses an ISO date-time string to a Date object. Returns null if invalid.
+ * @param iso The ISO string.
+ */
+export declare function parseIsoDateTime(iso: string): Date | null;
+/**
+ * Formats a Date as YYYY-MM-DD HH:mm:ss (local time).
+ * @param date The Date object.
+ */
+export declare function formatDateTimeLocal(date: Date): string;
+/**
+ * Returns the timezone offset in minutes for a given date (local - UTC).
+ * @param date The Date object.
+ */
+export declare function getTimezoneOffset(date?: Date): number;
+/**
+ * Returns the UTC equivalent of a local Date.
+ * @param date The local Date object.
+ */
+export declare function toUtcDate(date: Date): Date;
+/**
+ * Returns the number of seconds since the Unix epoch (UTC).
+ */
+export declare function unixTimestamp(): number;
+/**
+ * Returns the number of milliseconds since the Unix epoch.
+ */
+export declare function unixMillis(): number;
+/**
+ * Returns the difference in seconds between two Date objects.
+ * @param a First date.
+ * @param b Second date.
+ */
+export declare function secondsBetween(a: Date, b: Date): number;
+/**
+ * Returns the ISO week number (1–53) of a given date using UTC.
+ * @param date A JavaScript Date object.
+ */
+export declare function getIsoWeek(date: Date): number;
+/**
+ * Returns ISO week number and ISO week year (which may differ from calendar year).
+ * @param date Date object (UTC-safe)
+ */
+export declare function getIsoWeekInfo(date: Date): {
+    week: number;
+    year: number;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datetime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAY1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAoB7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBzE"}

package/dist/emails/banned/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Checks if the domain part of the given email is present in a list of forbidden domains.
+ *
+ * @param email - The email address to check.
+ * @param forbiddenEmails - A newline-separated string of forbidden email domains.
+ * @throws Will throw an error if the email is not formatted properly or if the domain is forbidden.
+ */
+export declare const isEmailinBannedDomains: (email: string, forbiddenEmails: string) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/emails/banned/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/emails/banned/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,EAAE,iBAAiB,MAAM,SAW5E,CAAA"}

package/dist/emails/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Validates if a string is a valid email address (simple regex).
+ * @param email The email address to validate.
+ * @returns True if valid, false otherwise.
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Normalizes an email address by trimming and converting to lowercase.
+ * @param email The email address to normalize.
+ * @returns The normalized email address.
+ */
+export declare function normalizeEmail(email: string): string;
+/**
+ * Masks an email address for privacy (e.g., j***@domain.com).
+ * @param email The email address to mask.
+ * @returns The masked email address.
+ */
+export declare function maskEmail(email: string): string;
+/**
+ * Extracts the domain from an email address.
+ * @param email The email address.
+ * @returns The domain part of the email, or an empty string if invalid.
+ */
+export declare function getEmailDomain(email: string): string;
+export declare function isFreeEmailProvider(email: string): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emails/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAiBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/env/index.d.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+/**
+ * Retrieves the value of an environment variable by its key.
+ *
+ * @param key - The name of the environment variable to retrieve.
+ * @param defaultValue - An optional default value to return if the environment variable is not defined.
+ * @returns The value of the environment variable if it exists, otherwise the default value if provided.
+ * @throws {Error} If the environment variable is undefined and no default value is provided.
+ */
+export declare const getENV: (key: string, defaultValue?: string) => string;
+/**
+ * Determines if the current environment is set to development.
+ *
+ * @returns {boolean} `true` if `process.env.NODE_ENV` is `'development'`, otherwise `false`.
+ */
+export declare const isDev: () => boolean;
+/**
+ * Determines if the current environment is set to production.
+ *
+ * @returns {boolean} `true` if `process.env.NODE_ENV` is `'production'`, otherwise `false`.
+ */
+export declare const isProd: () => boolean;
+/**
+ * Determines if the current environment is set to test.
+ *
+ * @returns {boolean} `true` if `process.env.NODE_ENV` is `'test'`, otherwise `false`.
+ */
+export declare const isTest: () => boolean;
+/**
+ * Returns the current NODE_ENV value, or 'development' if not set.
+ *
+ * @returns {string}
+ */
+export declare const getNodeEnv: () => string;
+/**
+ *
+ * Validates the environment variables against a Zod schema.
+ * Throws an error if any required variables are missing or invalid.
+ * @param {z.ZodObject<T>} EnvSchema - The Zod schema to validate against.
+ * @param {Record<string, string | undefined>} buildEnv - The environment variables to validate, defaults to `process.env`.
+ * @throws {Error} If validation fails, an error with a message listing missing variables is thrown.
+ */
+export declare function checkEnv<T extends z.ZodRawShape>(EnvSchema: z.ZodObject<T>, buildEnv?: Record<string, string | undefined>): z.core.$InferObjectOutput<T, {}>;
+/**
+ * Schema for validating the root environment variables.
+ * It includes NODE_ENV, LOG_LEVEL, and PORT with their respective types and defaults.
+ */
+export declare const RootApiEnvSchema: z.ZodObject<{
+    NODE_ENV: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>;
+    PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type RootApiEnvSchema = z.infer<typeof RootApiEnvSchema>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,WAUxD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAO,OAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAC/C,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACzB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,oCAc1D;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAI3B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/errors/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Creates a new Error with a custom name and message.
+ * @param name The error name.
+ * @param message The error message.
+ * @returns The custom Error object.
+ */
+export declare function createCustomError(name: string, message: string): Error;
+/**
+ * Checks if an error is an instance of a specific error name.
+ * @param error The error to check.
+ * @param name The error name to match.
+ * @returns True if the error matches the name, false otherwise.
+ */
+export declare function isErrorName(error: unknown, name: string): boolean;
+/**
+ * Gets the error message from an unknown error value.
+ * @param error The error value.
+ * @returns The error message, or a stringified version if not an Error.
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Throws an error if the condition is false.
+ * @param condition The condition to check.
+ * @param message The error message to throw if the condition is false.
+ */
+export declare function assert(condition: unknown, message: string): asserts condition;
+/**
+ * Wraps a function and catches errors, returning a fallback value if an error occurs.
+ * Use this only when the fallback is genuinely safe and the error can be ignored.
+ * For typed error handling, prefer `tryCatch` from `@rtorcato/js-common/try`.
+ * @param fn The function to wrap.
+ * @param fallback The fallback value to return on error.
+ *
+ * @example
+ * const result = await tryWithFallback(async () => fetchData(), [])
+ * // result will be [] if fetchData throws
+ */
+export declare function tryWithFallback<T>(fn: () => Promise<T> | T, fallback: T): Promise<T>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAItE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;;GAIG;AAEH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI7E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM1F"}

package/dist/events/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Adds an event listener and returns a function to remove it.
+ * @param target The event target.
+ * @param type The event type.
+ * @param handler The event handler.
+ * @param options Event listener options.
+ * @returns {() => void} Unsubscribe function.
+ */
+export declare function on<K extends keyof HTMLElementEventMap>(target: EventTarget, type: K, handler: (event: HTMLElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): () => void;
+/**
+ * Dispatches a custom event on the target.
+ * @param target The event target.
+ * @param type The event type.
+ * @param detail Optional detail data.
+ * @returns {boolean} True if not canceled.
+ */
+export declare function emit(target: EventTarget, type: string, detail?: unknown): boolean;
+/**
+ * Waits for a single event to occur and resolves a promise.
+ * @param target The event target.
+ * @param type The event type.
+ * @returns {Promise<Event>} Resolves with the event object.
+ */
+export declare function once<K extends keyof HTMLElementEventMap>(target: EventTarget, type: K): Promise<HTMLElementEventMap[K]>;
+/**
+ * Prevents the default action for an event.
+ * @param event The event object.
+ */
+export declare function preventDefault(event: Event): void;
+/**
+ * Stops propagation for an event.
+ * @param event The event object.
+ */
+export declare function stopPropagation(event: Event): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACrD,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAChD,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GACzC,MAAM,IAAI,CAGZ;AAED;;;;;;GAMG;AAEH,wBAAgB,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACvD,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,CAAC,GACL,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAQjC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAElD"}

package/dist/fetch/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Fetches a resource with a timeout.
+ * @param url The URL to fetch.
+ * @param options Fetch options.
+ * @param timeout Timeout in milliseconds (default: 8000).
+ * @returns The parsed JSON response.
+ */
+export declare function fetchWithTimeout(url: string, options?: RequestInit, timeout?: number): Promise<unknown>;
+/**
+ * Sends a POST request with a JSON body.
+ * @param url The URL to post to.
+ * @param body The body to send.
+ * @param options Additional fetch options.
+ * @returns The parsed JSON response.
+ */
+export declare function postJson<T = unknown, R = unknown>(url: string, body: T, options?: RequestInit): Promise<R>;
+/**
+ * Sends a GET request and returns JSON.
+ * @param url The URL to fetch.
+ * @param options Additional fetch options.
+ * @returns The parsed JSON response.
+ */
+export declare function getJson<T = unknown>(url: string, options?: RequestInit): Promise<T>;
+/**
+ * Fetches a resource and returns the response as text.
+ * @param url The URL to fetch.
+ * @param options Fetch options.
+ * @returns The response as text.
+ */
+export declare function fetchText(url: string, options?: RequestInit): Promise<string>;
+/**
+ * Handles fetch errors and returns a fallback value or throws.
+ * @param promise The fetch promise.
+ * @param fallback The fallback value to return on error.
+ * @returns The resolved value or the fallback.
+ */
+export declare function handleApiError<T>(promise: Promise<T>, fallback?: T): Promise<T>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,OAAO,SAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACtD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,WAAgB,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAG7F;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGvF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOrF"}

package/dist/file/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Reads a file as a string (UTF-8).
+ * @param {string} filePath - The path to the file.
+ * @returns {Promise<string>} The file contents as a string.
+ */
+export declare function readFileAsString(filePath: string): Promise<string>;
+/**
+ * Writes a string to a file (UTF-8).
+ * @param {string} filePath - The path to the file.
+ * @param {string} data - The string data to write.
+ * @returns {Promise<void>}
+ */
+export declare function writeFileAsString(filePath: string, data: string): Promise<void>;
+/**
+ * Checks if a file exists.
+ * @param {string} filePath - The path to the file.
+ * @returns {Promise<boolean>} True if the file exists, false otherwise.
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Deletes a file.
+ * @param {string} filePath - The path to the file.
+ * @returns {Promise<void>}
+ */
+export declare function deleteFile(filePath: string): Promise<void>;
+/**
+ * Gets the file extension from a file path.
+ * @param {string} filePath - The path to the file.
+ * @returns {string} The file extension (including the dot), or an empty string if none.
+ */
+export declare function getFileExtension(filePath: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/formatting/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pads a string or number with leading zeros to a given length.
+ * @param value The value to pad.
+ * @param length The desired length.
+ * @returns The padded string.
+ */
+export declare function padZero(value: string | number, length?: number): string;
+/**
+ * Formats a number with thousands separators.
+ * @param num The number to format.
+ * @param locale Optional locale string (default: 'en-US').
+ * @returns The formatted string.
+ */
+export declare function formatNumber(num: number, locale?: string): string;
+/**
+ * Formats a number as a percentage string.
+ * @param value The value to format (e.g. 0.25 for 25%).
+ * @param fractionDigits Number of decimal places (default: 0).
+ * @returns The formatted percentage string.
+ */
+export declare function formatPercent(value: number, fractionDigits?: number): string;
+/**
+ * Formats a Date as YYYY-MM-DD.
+ * @param date The date to format.
+ * @returns The formatted date string.
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Formats a Date as HH:MM:SS.
+ * @param date The date to format.
+ * @returns The formatted time string.
+ */
+export declare function formatTime(date: Date): string;
+/**
+ * Formats a Date as YYYY-MM-DD HH:MM:SS.
+ * @param date The date to format.
+ * @returns The formatted date-time string.
+ */
+export declare function formatDateTime(date: Date): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEjD"}

package/dist/functions/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Returns a function that only calls the original function once.
+ * @param fn The function to wrap.
+ * @returns {Function}
+ */
+export declare function once<T extends (...args: any[]) => any>(fn: T): T;
+/**
+ * Returns a debounced version of a function.
+ * @param fn The function to debounce.
+ * @param wait Milliseconds to wait.
+ * @returns {Function}
+ */
+export declare function debounce<T extends (...args: any[]) => void>(fn: T, wait: number): T;
+/**
+ * Returns a throttled version of a function.
+ * @param fn The function to throttle.
+ * @param wait Milliseconds to wait between calls.
+ * @returns {Function}
+ */
+export declare function throttle<T extends (...args: any[]) => void>(fn: T, wait: number): T;
+/**
+ * Composes functions from right to left.
+ * @param fns Functions to compose.
+ * @returns {Function}
+ */
+export declare function compose<T>(...fns: Array<(arg: T) => T>): (arg: T) => T;
+/**
+ * Pipes functions from left to right.
+ * @param fns Functions to pipe.
+ * @returns {Function}
+ */
+export declare function pipe<T>(...fns: Array<(arg: T) => T>): (arg: T) => T;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAUhE;AAED;;;;;GAKG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMnF;AAED;;;;;GAKG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CASnF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAEnE"}

package/dist/geometry/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Calculates the distance between two points in 2D space.
+ * @param x1 X coordinate of first point.
+ * @param y1 Y coordinate of first point.
+ * @param x2 X coordinate of second point.
+ * @param y2 Y coordinate of second point.
+ * @returns {number} The distance.
+ */
+export declare function distance2D(x1: number, y1: number, x2: number, y2: number): number;
+/**
+ * Calculates the midpoint between two points in 2D space.
+ * @param x1 X coordinate of first point.
+ * @param y1 Y coordinate of first point.
+ * @param x2 X coordinate of second point.
+ * @param y2 Y coordinate of second point.
+ * @returns {[number, number]} The midpoint as [x, y].
+ */
+export declare function midpoint2D(x1: number, y1: number, x2: number, y2: number): [number, number];
+/**
+ * Calculates the angle (in radians) between two points in 2D space.
+ * @param x1 X coordinate of first point.
+ * @param y1 Y coordinate of first point.
+ * @param x2 X coordinate of second point.
+ * @param y2 Y coordinate of second point.
+ * @returns {number} The angle in radians.
+ */
+export declare function angle2D(x1: number, y1: number, x2: number, y2: number): number;
+/**
+ * Checks if a point is inside a rectangle.
+ * @param px X coordinate of the point.
+ * @param py Y coordinate of the point.
+ * @param rx X coordinate of the rectangle's top-left corner.
+ * @param ry Y coordinate of the rectangle's top-left corner.
+ * @param rw Rectangle width.
+ * @param rh Rectangle height.
+ * @returns {boolean} True if inside, false otherwise.
+ */
+export declare function pointInRect(px: number, py: number, rx: number, ry: number, rw: number, rh: number): boolean;
+/**
+ * Checks if two rectangles overlap.
+ * @param ax X of rect A.
+ * @param ay Y of rect A.
+ * @param aw Width of rect A.
+ * @param ah Height of rect A.
+ * @param bx X of rect B.
+ * @param by Y of rect B.
+ * @param bw Width of rect B.
+ * @param bh Height of rect B.
+ * @returns {boolean} True if rectangles overlap.
+ */
+export declare function rectsOverlap(ax: number, ay: number, aw: number, ah: number, bx: number, by: number, bw: number, bh: number): boolean;
+/**
+ * Calculates the area of a polygon given its vertices (Shoelace formula).
+ * @param points Array of [x, y] pairs.
+ * @returns {number} The area (positive value).
+ */
+export declare function polygonArea(points: [number, number][]): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3F;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAY9D"}

package/dist/html/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Escapes special HTML characters in a string to prevent XSS attacks.
+ * @param str The string to escape.
+ * @returns The escaped string.
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Unescapes HTML entities in a string.
+ * @param str The string to unescape.
+ * @returns The unescaped string.
+ */
+export declare function unescapeHtml(str: string): string;
+/**
+ * Strips all HTML tags from a string.
+ * @param str The string to strip tags from.
+ * @returns The plain text string.
+ */
+export declare function stripHtmlTags(str: string): string;
+/**
+ * Converts a plain text string to a simple HTML paragraph (\n to <br>).
+ * @param str The plain text string.
+ * @returns The HTML string with <br> tags.
+ */
+export declare function textToHtml(str: string): string;
+/**
+ * Checks if a string contains any HTML tags.
+ * @param str The string to check.
+ * @returns True if the string contains HTML tags, false otherwise.
+ */
+export declare function containsHtml(str: string): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Detects the user's preferred language from the browser or Node.js environment.
+ * @returns {string} The language code (e.g., 'en', 'fr').
+ */
+export declare function detectLanguage(defaultLang?: string): string;
+/**
+ * Formats a number as a localized string.
+ * @param value The number to format.
+ * @param locale The locale code (e.g., 'en-US').
+ * @param options Intl.NumberFormat options.
+ * @returns {string}
+ */
+export declare function formatNumber(value: number, locale?: string, options?: Intl.NumberFormatOptions): string;
+/**
+ * Formats a date as a localized string.
+ * @param date The date to format.
+ * @param locale The locale code (e.g., 'en-US').
+ * @param options Intl.DateTimeFormat options.
+ * @returns {string}
+ */
+export declare function formatDateI18n(date: Date, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Simple translation function using a dictionary object.
+ * @param key The translation key.
+ * @param dict The dictionary object (e.g., { en: { hello: 'Hello' }, fr: { hello: 'Bonjour' } }).
+ * @param lang The language code (optional, defaults to detected language).
+ * @returns {string}
+ */
+export declare function t(key: string, dict: Record<string, Record<string, string>>, lang?: string): string;
+/**
+ * Pluralizes a word based on a count (basic English only).
+ * @param word The word to pluralize.
+ * @param count The count.
+ * @returns {string}
+ */
+export declare function pluralize(word: string, count: number): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAAa,GAAG,MAAM,CAQjE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAChC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,CAAC,CAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5C,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAA"}

package/dist/interval/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs a function repeatedly at a specified interval (cross-platform).
+ * @param fn The function to run.
+ * @param ms The interval in milliseconds.
+ * @returns The interval ID (NodeJS.Timeout or number).
+ */
+export declare function runInterval(fn: () => void, ms: number): ReturnType<typeof setInterval>;
+/**
+ * Cancels an interval by its ID (cross-platform).
+ * @param id The interval ID (NodeJS.Timeout or number).
+ */
+export declare function clearIntervalById(id: ReturnType<typeof setInterval>): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interval/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAEtF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAE1E"}

package/dist/json/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Safely parses a JSON string, returning a fallback value if parsing fails.
+ * @param {string} str - The JSON string to parse.
+ * @param {any} [fallback=null] - The value to return if parsing fails.
+ * @returns The parsed object or the fallback value.
+ */
+export declare function safeJsonParse<T = any>(str: string, fallback?: T | null): T | null;
+/**
+ * Safely stringifies a value to JSON, returning a fallback value if stringification fails.
+ * @param {any} value - The value to stringify.
+ * @param {string} [fallback=null] - The value to return if stringification fails.
+ * @returns The JSON string or the fallback value.
+ */
+export declare function safeJsonStringify(value: any, fallback?: string | null): string | null;
+/**
+ * Checks if a string is valid JSON.
+ * @param {string} str - The string to check.
+ * @returns {boolean} True if the string is valid JSON, false otherwise.
+ */
+export declare function isValidJson(str: string): boolean;
+/**
+ * Deep clones a value using JSON serialization.
+ * Note: Only works for JSON-safe values (no functions, undefined, etc).
+ * @param {T} value - The value to clone.
+ * @returns {T} The deep-cloned value.
+ */
+export declare function deepCloneJson<T>(value: T): T;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,IAAW,GAAG,CAAC,GAAG,IAAI,CAMvF;AAED;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,GAAG,IAAI,CAM3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE5C"}

package/dist/logger/index.d.ts

@@ -0,0 +1,2 @@
+export { logger } from './logger';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,3 @@
+import pino from 'pino';
+export declare const logger: pino.Logger<never, boolean>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,eAAO,MAAM,MAAM,6BAyBO,CAAA"}