@rtorcato/js-common 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.4.0](https://github.com/rtorcato/js-common/compare/v1.3.1...v1.4.0) (2025-10-24)
+
+
+### Features
+
+* Enable TypeScript type definitions for package consumers ([70eb162](https://github.com/rtorcato/js-common/commit/70eb162bb556164432762f382470ff28a3ec0251))
+
+## [1.3.1](https://github.com/rtorcato/js-common/compare/v1.3.0...v1.3.1) (2025-10-24)
+
+
+### Bug Fixes
+
+* Correct import paths in CLI for proper TypeScript compilation ([24221d5](https://github.com/rtorcato/js-common/commit/24221d5622fa70dabe78166c7266c825686466ab))
+
 # [1.3.0](https://github.com/rtorcato/js-common/compare/v1.2.0...v1.3.0) (2025-10-24)
 
 

package/README.md

@@ -76,6 +76,28 @@ import { today } from '@rtorcato/js-common/date'
 import { sum, average } from '@rtorcato/js-common/numbers'
 ```
 
+### 🎯 **TypeScript Support**
+
+This package is built with TypeScript and includes complete type definitions out of the box:
+
+- ✅ **Full type safety** - All functions have accurate TypeScript types
+- ✅ **Generic support** - Functions like `unique<T>()` preserve your data types  
+- ✅ **JSDoc integration** - Rich documentation in your IDE
+- ✅ **Tree-shakable** - Import only what you need with perfect type inference
+
+```typescript
+// TypeScript automatically infers types
+const numbers = [1, 2, 3, 4, 5]
+const result: number = sum(numbers)  // ✅ Type: number
+
+const users = [{ name: 'John' }, { name: 'Jane' }]
+const uniqueUsers = unique(users)    // ✅ Type: { name: string }[]
+
+// IDE shows full documentation and type hints
+import { today } from '@rtorcato/js-common/date'
+//      ^ JSDoc: Returns today's date as YYYY-MM-DD string
+```
+
 ## Available Modules
 
 ### 📅 **Date & Time**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtorcato/js-common",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "JavaScript and TypeScript common code",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "build-dev": "rimraf ./dist && cross-env NODE_ENV=development node build.mjs && tsc --emitDeclarationOnly --project tsconfig.build.json && npm run build-cli",
     "build-prod": "rimraf ./dist && cross-env NODE_ENV=production node build.mjs && tsc --emitDeclarationOnly --project tsconfig.build.json && npm run build-cli",
     "build-cli": "tsc src/cli/cli.ts --outDir dist/cli --target ES2022 --module ES2022 --moduleResolution bundler --allowImportingTsExtensions false --esModuleInterop --skipLibCheck && mv dist/cli/cli.js dist/cli/temp.mjs && echo '#!/usr/bin/env node' > dist/cli/index.mjs && cat dist/cli/temp.mjs >> dist/cli/index.mjs && rm dist/cli/temp.mjs && chmod +x dist/cli/index.mjs",
-    "prepublishOnly1": "npm run build-prod",
+    "prepublishOnly": "npm run build-prod",
     "==================== Common ====================": "",
     "lint": "pnpm exec biome lint .",
     "format": "pnpm exec biome format .",

package/dist/abortController/index.d.ts

@@ -1,29 +0,0 @@
-/**
- * Creates a new AbortController and returns its controller and signal.
- * @returns {{ controller: AbortController, signal: AbortSignal }}
- */
-export declare function createAbortController(): {
-    controller: AbortController;
-    signal: AbortSignal;
-};
-/**
- * Returns a promise that rejects when the given AbortSignal is aborted.
- * @param signal The AbortSignal to listen to.
- * @returns {Promise<never>}
- */
-export declare function abortPromise(signal: AbortSignal): Promise<never>;
-/**
- * Wraps a promise and rejects it if the signal is aborted.
- * @param promise The promise to wrap.
- * @param signal The AbortSignal.
- * @returns {Promise<T>}
- */
-export declare function withAbort<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
-/**
- * Aborts the given controller after a timeout (ms).
- * @param controller The AbortController.
- * @param ms Timeout in milliseconds.
- * @returns {NodeJS.Timeout | number} The timeout ID.
- */
-export declare function abortAfter(controller: AbortController, ms: number): ReturnType<typeof setTimeout>;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abortController/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,qBAAqB;;;EAGpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAchE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAEjG"}

package/dist/arrays/index.d.ts

@@ -1,44 +0,0 @@
-/**
- * Returns the first element of an array, or undefined if the array is empty.
- * @param arr The array.
- * @returns The first element or undefined.
- */
-export declare function first<T>(arr: T[]): T | undefined;
-/**
- * Returns the last element of an array, or undefined if the array is empty.
- * @param arr The array.
- * @returns The last element or undefined.
- */
-export declare function last<T>(arr: T[]): T | undefined;
-/**
- * Removes duplicate values from an array.
- * @param arr The array.
- * @returns A new array with unique values.
- */
-export declare function unique<T>(arr: T[]): T[];
-/**
- * Flattens an array one level deep.
- * @param arr The array to flatten.
- * @returns A new flattened array.
- */
-export declare function flatten<T>(arr: any[]): T[];
-/**
- * Chunks an array into smaller arrays of a specified size.
- * @param arr The array to chunk.
- * @param size The chunk size.
- * @returns An array of chunks.
- */
-export declare function chunk<T>(arr: T[], size: number): T[][];
-/**
- * Removes all falsy values from an array.
- * @param arr The array.
- * @returns A new array with only truthy values.
- */
-export declare function compact<T>(arr: T[]): T[];
-/**
- * Shuffles an array in place using the Fisher-Yates algorithm.
- * @param arr The array to shuffle.
- * @returns The shuffled array.
- */
-export declare function shuffle<T>(arr: T[]): T[];
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arrays/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC;AAED;;;;GAIG;AAEH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMtD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAExC;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxC"}

package/dist/boolean/index.d.ts

@@ -1,41 +0,0 @@
-/**
- * Converts a value to a boolean.
- * Accepts 'true', '1', 1 as true; 'false', '0', 0 as false.
- * @param value The value to convert.
- * @returns The boolean representation.
- */
-export declare function toBoolean(value: any): boolean;
-/**
- * Checks if a value is a boolean.
- * @param value The value to check.
- * @returns True if the value is a boolean, false otherwise.
- */
-export declare function isBoolean(value: any): value is boolean;
-/**
- * Returns the logical exclusive OR (XOR) of two booleans.
- * @param a First boolean.
- * @param b Second boolean.
- * @returns True if exactly one of a or b is true.
- */
-export declare function xor(a: boolean, b: boolean): boolean;
-/**
- * Logical AND for two booleans.
- * @param a First boolean.
- * @param b Second boolean.
- * @returns True if both a and b are true.
- */
-export declare function and(a: boolean, b: boolean): boolean;
-/**
- * Logical OR for two booleans.
- * @param a First boolean.
- * @param b Second boolean.
- * @returns True if either a or b is true.
- */
-export declare function or(a: boolean, b: boolean): boolean;
-/**
- * Logical NOT for a boolean.
- * @param a The boolean to negate.
- * @returns The negated boolean.
- */
-export declare function not(a: boolean): boolean;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAW7C;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAEvC"}

package/dist/colors/index.d.ts

@@ -1,63 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/console/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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/crypto/index.d.ts

@@ -1,34 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/currency/currencies.d.ts

@@ -1,16 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/date/index.d.ts

@@ -1,44 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/datetime/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * 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

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

@@ -1,9 +0,0 @@
-/**
- * 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

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

@@ -1,26 +0,0 @@
-/**
- * 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

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

@@ -1,63 +0,0 @@
-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

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