@rtorcato/js-common 1.2.0

package/dist/colors/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Generates a random hex color string.
+ *
+ * @returns {string} A string representing a random color in hexadecimal format (e.g., `#a1b2c3`).
+ */
+export declare function randomColor(): string;
+/**
+ * Generates a random color with a given alpha value.
+ *
+ * @export
+ * @param {string} color
+ * @return {*}
+ */
+export declare function matchingTextColor(color: string): "#000" | "#fff";
+/**
+ * Converts a hex color string to an RGB object.
+ *
+ * @export
+ * @param {string} hex
+ * @return {*}  {({ r: number; g: number; b: number } | null)}
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Converts RGB values to a hex color string.
+ *
+ * @export
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @return {*}  {string}
+ */
+export declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * Converts a hex color string to an HSL object.
+ *
+ * @export
+ * @param {string} hex
+ * @return {*}  {({ h: number; s: number; l: number } | null)}
+ */
+export declare function isValidHex(hex: string): boolean;
+/**
+ * Darkens a hex color by a given percentage.
+ *
+ * @export
+ * @param {string} hex
+ * @param {number} percent
+ * @return {*}  {string}
+ */
+export declare function darken(hex: string, percent: number): string;
+/**
+ * Lightens a hex color by a given percentage.
+ *
+ * @export
+ * @param {string} hex
+ * @param {number} percent
+ * @return {*}  {string}
+ */
+export declare function lighten(hex: string, percent: number): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/colors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,mBAO9C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQhF;AAED;;;;;;;;GAQG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/colors/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";function u(){return`#${Math.floor(Math.random()*16777215).toString(16).padStart(6,"0")}`}function f(r){let t=Number.parseInt(r.slice(1,3),16),n=Number.parseInt(r.slice(3,5),16),e=Number.parseInt(r.slice(5,7),16);return(t*299+n*587+e*114)/1e3>=128?"#000":"#fff"}function i(r){let t=r.match(/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i);return t?{r:Number.parseInt(t[1]||"",16),g:Number.parseInt(t[2]||"",16),b:Number.parseInt(t[3]||"",16)}:null}function s(r,t,n){return`#${[r,t,n].map(e=>{let o=e.toString(16);return o.length===1?`0${o}`:o}).join("")}`}function b(r){return/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(r)}function g(r,t){let n=i(r);if(!n)return r;let e=Math.max(0,Math.floor(n.r*(1-t))),o=Math.max(0,Math.floor(n.g*(1-t))),a=Math.max(0,Math.floor(n.b*(1-t)));return s(e,o,a)}function m(r,t){let n=i(r);if(!n)return r;let e=Math.min(255,Math.floor(n.r+(255-n.r)*t)),o=Math.min(255,Math.floor(n.g+(255-n.g)*t)),a=Math.min(255,Math.floor(n.b+(255-n.b)*t));return s(e,o,a)}export{g as darken,i as hexToRgb,b as isValidHex,m as lighten,f as matchingTextColor,u as randomColor,s as rgbToHex};

package/dist/console/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Console utility functions for logging and disabling console output in production.
+ * @module console
+ */
+/**
+ * Disables console output in production environment.
+ */
+export declare const disableConsole: () => void;
+/**
+ * Clears the console.
+ *
+ * @export
+ * @return {*}  {void}
+ */
+export declare const clearConsole: () => void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,YAK1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAA"}

package/dist/console/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";var o=()=>{process.env.NODE_ENV==="production"&&(console.log=()=>{})},e=()=>{process.stdout.write("\x1B[2J\x1B[0f")};export{e as clearConsole,o as disableConsole};

package/dist/crypto/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hashes a string using the specified algorithm.
+ * @param str The string to hash.
+ * @param algorithm The hash algorithm (default: 'sha256').
+ * @returns The hex-encoded hash.
+ */
+export declare function hashString(str: string, algorithm?: string): string;
+/**
+ * Generates a random hex string of the specified length (in bytes).
+ * @param length The number of bytes (not hex chars).
+ * @returns A random hex string.
+ */
+export declare function randomHex(length?: number): string;
+/**
+ * Creates an HMAC hash of a string using a secret and algorithm.
+ * @param str The string to hash.
+ * @param secret The secret key.
+ * @param algorithm The hash algorithm (default: 'sha256').
+ * @returns The hex-encoded HMAC.
+ */
+export declare function hmacHash(str: string, secret: string, algorithm?: string): string;
+/**
+ * Encodes a string to base64.
+ * @param str The string to encode.
+ * @returns The base64-encoded string.
+ */
+export declare function base64Encode(str: string): string;
+/**
+ * Decodes a base64 string.
+ * @param b64 The base64 string to decode.
+ * @returns The decoded string.
+ */
+export declare function base64Decode(b64: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/crypto/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";import{createHash as n,createHmac as i,randomBytes as s}from"node:crypto";function a(t,r="sha256"){return n(r).update(t).digest("hex")}function g(t=16){return s(t).toString("hex")}function u(t,r,e="sha256"){return i(e,r).update(t).digest("hex")}function f(t){return Buffer.from(t,"utf-8").toString("base64")}function c(t){return Buffer.from(t,"base64").toString("utf-8")}export{c as base64Decode,f as base64Encode,a as hashString,u as hmacHash,g as randomHex};

package/dist/currency/currencies.d.ts

@@ -0,0 +1,16 @@
+/**
+ * List of supported currency codes.
+ *
+ * This array contains ISO 4217 currency codes and some special codes
+ * (such as precious metals and testing codes) used in financial applications.
+ *
+ * @remarks
+ * - Some codes represent fiat currencies (e.g., 'USD', 'EUR').
+ * - Some codes represent precious metals (e.g., 'XAU' for gold).
+ * - Some codes are reserved for testing or special purposes (e.g., 'XTS', 'XXX').
+ *
+ * @see {@link https://www.iso.org/iso-4217-currency-codes.html ISO 4217 Currency Codes}
+ */
+export declare const currencies: string[];
+export default currencies;
+//# sourceMappingURL=currencies.d.ts.map

package/dist/currency/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../../src/currency/currencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,UA6CtB,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/currency/currencies.js

@@ -0,0 +1 @@
+import{a,b}from"../chunks/chunk-7MXMG6WN.js";import"../chunks/chunk-ANN5UYCF.js";export{a as currencies,b as default};

package/dist/currency/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Returns the currency symbol for a given ISO 4217 currency code.
+ *
+ * Utilizes the `Intl.NumberFormat` API to format a number as currency and extract the symbol.
+ *
+ * @param currency - The ISO 4217 currency code (e.g., 'USD', 'EUR', 'JPY').
+ * @returns The currency symbol as a string (e.g., '$', '€', '¥'), or `undefined` if the symbol cannot be determined.
+ */
+export declare const getCurrencySymbol: (currency: string) => string | undefined;
+/**
+ * Formats a given price value into a localized currency string.
+ *
+ * @param price - The numeric value or string representation of the price to format.
+ * @param currency - The currency code to use for formatting. Supported values are 'USD', 'EUR', 'GBP', and 'BDT'. Defaults to 'USD'.
+ * @param notation - The formatting notation style. Can be 'compact', 'engineering', 'scientific', or 'standard'. Defaults to 'standard'.
+ * @returns The formatted currency string according to the specified locale, currency, and notation.
+ */
+export declare function formatPrice(price: number | string, currency?: 'USD' | 'EUR' | 'GBP' | 'BDT', notation?: 'compact' | 'engineering' | 'scientific' | 'standard'): string;
+/**
+ * Parses a given price string and returns its numeric value.
+ *
+ * @param value - The price string to parse.
+ * @returns The numeric value of the price, or `null` if the value cannot be parsed.
+ */
+export declare function parsePrice(value: string): number | null;
+/**
+ * Converts a given amount from one currency to another using the provided exchange rate.
+ *
+ * @param amount - The amount of money to convert.
+ * @param rate - The exchange rate to use for the conversion.
+ * @param decimals - The number of decimal places to include in the result. Defaults to 2.
+ * @returns The converted amount as a number.
+ */
+export declare function convertCurrency(amount: number, rate: number, decimals?: number): number;
+/**
+ * Checks if the provided currency code is valid.
+ *
+ * Converts the input code to uppercase and verifies if it exists in the list of supported currencies.
+ *
+ * @param code - The currency code to validate (e.g., 'USD', 'eur').
+ * @returns `true` if the currency code is valid; otherwise, `false`.
+ */
+export declare function isValidCurrencyCode(code: string): boolean;
+/**
+ * Rounds a given number to a specified number of decimal places.
+ *
+ * @param value - The number to be rounded.
+ * @param decimals - The number of decimal places to round to. Defaults to 2.
+ * @returns The rounded number.
+ */
+export declare function roundTo(value: number, decimals?: number): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,SAQ7D,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAa,EAC/C,QAAQ,GAAE,SAAS,GAAG,aAAa,GAAG,YAAY,GAAG,UAAuB,UAO5E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAElF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAG3D"}

package/dist/currency/index.js

@@ -0,0 +1 @@
+import{b as t}from"../chunks/chunk-7MXMG6WN.js";import"../chunks/chunk-ANN5UYCF.js";var o=r=>{let n=new Intl.NumberFormat("en",{currency:r,style:"currency"}).formatToParts(0).find(e=>e.type==="currency");return n?.value==="\xA4"?void 0:n?.value};function c(r,n="USD",e="standard"){return new Intl.NumberFormat("en-US",{style:"currency",currency:n,notation:e}).format(Number(r))}function i(r){let n=r.replace(/[^0-9.-]+/g,""),e=Number.parseFloat(n);return Number.isNaN(e)?null:e}function a(r,n,e=2){return Number.parseFloat((r*n).toFixed(e))}function s(r){return t.includes(r.toUpperCase())}function m(r,n=2){let e=10**n;return Math.round(r*e)/e}export{a as convertCurrency,c as formatPrice,o as getCurrencySymbol,s as isValidCurrencyCode,i as parsePrice,m as roundTo};

package/dist/date/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Returns today's date as a YYYY-MM-DD string.
+ * @returns {string}
+ */
+export declare function today(): string;
+/**
+ * Returns a Date object from a YYYY-MM-DD string.
+ * @param dateStr The date string.
+ * @returns {Date}
+ */
+export declare function parseDate(dateStr: string): Date;
+/**
+ * Formats a Date object as YYYY-MM-DD.
+ * @param date The Date object.
+ * @returns {string}
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Returns the difference in days between two dates (date2 - date1).
+ * @param date1 The first date (string or Date).
+ * @param date2 The second date (string or Date).
+ * @returns {number}
+ */
+export declare function daysBetween(date1: string | Date, date2: string | Date): number;
+/**
+ * Checks if a year is a leap year.
+ * @param year The year (number or Date).
+ * @returns {boolean}
+ */
+export declare function isLeapYear(year: number | Date): boolean;
+/**
+ * Adds days to a date and returns a new Date object.
+ * @param date The date (string or Date).
+ * @param days Number of days to add.
+ * @returns {Date}
+ */
+export declare function addDays(date: string | Date, days: number): Date;
+/**
+ * Returns the day of the week for a date (0=Sunday, 6=Saturday).
+ * @param date The date (string or Date).
+ * @returns {number}
+ */
+export declare function getDayOfWeek(date: string | Date): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAG9B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI9E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGxD"}

package/dist/date/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";function i(){return new Date().toISOString().slice(0,10)}function r(t){return new Date(`${t}T00:00:00`)}function s(t){return t.toISOString().slice(0,10)}function a(t,e){let n=typeof t=="string"?r(t):t,o=typeof e=="string"?r(e):e;return Math.floor((o.getTime()-n.getTime())/(1e3*60*60*24))}function g(t){let e=t instanceof Date?t.getUTCFullYear():t;return e%4===0&&e%100!==0||e%400===0}function u(t,e){let n=typeof t=="string"?r(t):new Date(t);return n.setDate(n.getDate()+e),n}function D(t){return(typeof t=="string"?r(t):t).getDay()}export{u as addDays,a as daysBetween,s as formatDate,D as getDayOfWeek,g as isLeapYear,r as parseDate,i as today};

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/datetime/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";function i(){return new Date().toISOString()}function c(e){let t=new Date(e);return Number.isNaN(t.getTime())?null:t}function T(e){let t=n=>n.toString().padStart(2,"0");return`${e.getFullYear()}-${t(e.getMonth()+1)}-${t(e.getDate())} ${t(e.getHours())}:${t(e.getMinutes())}:${t(e.getSeconds())}`}function l(e=new Date){return e.getTimezoneOffset()}function f(e){return new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()))}function m(){return Math.floor(Date.now()/1e3)}function w(){return Date.now()}function U(e,t){return Math.floor((t.getTime()-e.getTime())/1e3)}function C(e){let t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate())),n=t.getUTCDay(),s=n===0?7:n;t.setUTCDate(t.getUTCDate()+4-s);let o=new Date(Date.UTC(t.getUTCFullYear(),0,1)).getUTCDay(),a=o===0?7:o,D=new Date(Date.UTC(t.getUTCFullYear(),0,1+(4-a))),u=t.getTime()-D.getTime();return 1+Math.round(u/(10080*60*1e3))}function y(e){let t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate()));t.setUTCDate(t.getUTCDate()+4-(t.getUTCDay()||7));let n=t.getUTCFullYear(),r=new Date(Date.UTC(n,0,1)).getUTCDay()||7,o=new Date(Date.UTC(n,0,1-r+1+(r>4?7:0))),a=t.getTime()-o.getTime();return{week:Math.floor(a/(10080*60*1e3))+1,year:n}}export{T as formatDateTimeLocal,C as getIsoWeek,y as getIsoWeekInfo,l as getTimezoneOffset,i as nowIso,c as parseIsoDateTime,U as secondsBetween,f as toUtcDate,w as unixMillis,m as unixTimestamp};

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/emails/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";function e(t){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)}function s(t){return t.trim().toLowerCase()}function a(t){let[o,r]=t.split("@");return!o||!r?t:o.length<=1?`*@${r}`:`${o[0]}${"*".repeat(Math.max(1,o.length-1))}@${r}`}function n(t){let o=t.split("@");return o.length===2?o[1]??"":""}var i=["gmail.com","yahoo.com","outlook.com","hotmail.com","icloud.com","aol.com","zoho.com","mail.com"];function m(t){return i.includes(n(t))}export{n as getEmailDomain,m as isFreeEmailProvider,e as isValidEmail,a as maskEmail,s as normalizeEmail};

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<{
+        test: "test";
+        development: "development";
+        production: "production";
+    }>>;
+    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/env/index.js

@@ -0,0 +1,3 @@
+import"../chunks/chunk-ANN5UYCF.js";import{z as n}from"zod";var c=(r,o)=>{let e=process.env[r.toString()];if(e===void 0&&o!==void 0)return o;if(e===void 0){let t=`Undefined ENV variable - ${r.toString()}`;throw new Error(t)}return e},d=()=>process.env.NODE_ENV==="development",p=()=>process.env.NODE_ENV==="production",E=()=>process.env.NODE_ENV==="test",u=()=>process.env.NODE_ENV||"development";function a(r,o=process.env){try{return r.parse(o)}catch(e){if(e instanceof n.ZodError){let t=`Missing required values in .env:
+`;t+=Object.keys(e.flatten().fieldErrors).join(`
+`);let s=new Error(t);throw s.stack="",s}throw e}}var f=n.object({NODE_ENV:n.enum(["development","test","production"]).default("development"),LOG_LEVEL:n.enum(["debug","info","warn","error"]).default("info"),PORT:n.coerce.number().default(3e3)});export{f as RootApiEnvSchema,a as checkEnv,c as getENV,u as getNodeEnv,d as isDev,p as isProd,E as isTest};

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: any, message: string): asserts condition;
+/**
+ * Wraps a function and catches errors, returning a fallback value if an error occurs.
+ * @param fn The function to wrap.
+ * @param fallback The fallback value to return on error.
+ *
+ * @example
+ * const result = await tryCatch(async () => {
+ *   // some code that might throw
+ *   return await fetchData();
+ * }, []);
+ * // result will be [] if fetchData throws an error*/
+export declare function tryCatch<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,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAIzE;AAED;;;;;;;;;;sDAUsD;AACtD,wBAAsB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnF"}

package/dist/errors/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";function e(n,r){let t=new Error(r);return t.name=n,t}function o(n,r){return n instanceof Error&&n.name===r}function i(n){if(n instanceof Error)return n.message;if(typeof n=="string")return n;try{return JSON.stringify(n)}catch{return String(n)}}function s(n,r){if(!n)throw new Error(r)}async function a(n,r){try{return await n()}catch{return r}}export{s as assert,e as createCustomError,i as getErrorMessage,o as isErrorName,a as tryCatch};

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?: any): 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,GAAG,GAAG,OAAO,CAE7E;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/events/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";function r(e,n,t,o){return e.addEventListener(n,t,o),()=>e.removeEventListener(n,t,o)}function E(e,n,t){return e.dispatchEvent(new CustomEvent(n,{detail:t}))}function i(e,n){return new Promise(t=>{let o=v=>{e.removeEventListener(n,o),t(v)};e.addEventListener(n,o)})}function a(e){e.preventDefault()}function s(e){e.stopPropagation()}export{E as emit,r as on,i as once,a as preventDefault,s as stopPropagation};

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/fetch/index.js

@@ -0,0 +1 @@
+import"../chunks/chunk-ANN5UYCF.js";async function i(n,t={},e=8e3){let o=new AbortController,r=setTimeout(()=>o.abort(),e);try{let s=await fetch(n,{...t,signal:o.signal});return clearTimeout(r),await s.json()}finally{clearTimeout(r)}}async function a(n,t,e={}){return await(await fetch(n,{method:"POST",headers:{"Content-Type":"application/json",...e.headers||{}},body:JSON.stringify(t),...e})).json()}async function c(n,t={}){return await(await fetch(n,{...t,method:"GET"})).json()}async function u(n,t={}){return await(await fetch(n,t)).text()}async function p(n,t){try{return await n}catch(e){if(t!==void 0)return t;throw e}}export{u as fetchText,i as fetchWithTimeout,c as getJson,p as handleApiError,a as postJson};

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