@rtorcato/js-common 2.0.0 → 2.1.0

package/dist/strings/index.d.ts

@@ -0,0 +1,296 @@
+/**
+ * Converts a string to Title Case (capitalizes the first letter of each word).
+ *
+ * @example
+ * ```typescript
+ * titleCase('hello world') // 'Hello World'
+ * titleCase('javaScript is awesome') // 'Javascript Is Awesome'
+ * titleCase('UPPER CASE TEXT') // 'Upper Case Text'
+ * titleCase('mixed-case_string') // 'Mixed-case_string'
+ * ```
+ *
+ * @param str The string to convert to title case
+ * @returns The title-cased string
+ * @category String Utilities
+ */
+export declare function titleCase(str: string): string;
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @example
+ * ```typescript
+ * capitalize('hello') // 'Hello'
+ * capitalize('WORLD') // 'WORLD'
+ * capitalize('') // ''
+ * capitalize('a') // 'A'
+ * ```
+ *
+ * @param str The string to capitalize
+ * @returns The capitalized string
+ * @category String Utilities
+ */
+export declare function capitalize(str: string): string;
+/**
+ * Converts a string to camelCase.
+ * Removes hyphens, underscores, and spaces while capitalizing following letters.
+ *
+ * @example
+ * ```typescript
+ * camelCase('hello world') // 'helloWorld'
+ * camelCase('hello-world') // 'helloWorld'
+ * camelCase('hello_world') // 'helloWorld'
+ * camelCase('Hello World') // 'helloWorld'
+ * camelCase('API_KEY_NAME') // 'aPIKEYNAME'
+ * ```
+ *
+ * @param str The string to convert to camelCase
+ * @returns The camelCased string
+ * @category String Utilities
+ */
+export declare function camelCase(str: string): string;
+/**
+ * Converts a string to kebab-case.
+ * Converts camelCase and spaces/underscores to hyphen-separated lowercase.
+ *
+ * @example
+ * ```typescript
+ * kebabCase('helloWorld') // 'hello-world'
+ * kebabCase('Hello World') // 'hello-world'
+ * kebabCase('hello_world') // 'hello-world'
+ * kebabCase('APIKeyName') // 'a-p-i-key-name'
+ * kebabCase('camelCaseString') // 'camel-case-string'
+ * ```
+ *
+ * @param str The string to convert to kebab-case
+ * @returns The kebab-cased string
+ * @category String Utilities
+ */
+export declare function kebabCase(str: string): string;
+/**
+ * Converts a string to snake_case.
+ * @param str The string to convert.
+ * @returns The snake_cased string.
+ */
+export declare function snakeCase(str: string): string;
+/**
+ * Truncates a string to a maximum length, adding ellipsis if needed.
+ * @param str The string to truncate.
+ * @param maxLength The maximum length.
+ * @returns The truncated string.
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Pads the start of a string to a given length.
+ * @param str The string to pad.
+ * @param targetLength The target length.
+ * @param padString The string to pad with.
+ * @returns The padded string.
+ */
+export declare function padStart(str: string, targetLength: number, padString?: string): string;
+/**
+ * Pads the end of a string to a given length.
+ * @param str The string to pad.
+ * @param targetLength The target length.
+ * @param padString The string to pad with.
+ * @returns The padded string.
+ */
+export declare function padEnd(str: string, targetLength: number, padString?: string): string;
+/**
+ * get a random string
+ * var rStr= randomString(32,'0123456789abcdefghijklmn');
+ * @param  {number} length
+ * @param  {string} chars
+ */
+export declare const randomString: (length: number, chars: string) => string;
+/**
+ * replace all items in a string using regex
+ * @param  {string} str
+ * @param  {string} search
+ * @param  {string} replacement
+ */
+export declare const replaceString: (str: string, search: string, replacement: string) => string;
+/**
+ * Sanitizes a string by removing script tags and event handlers.
+ * @param str The string to sanitize.
+ * @returns The sanitized string.
+ */
+export declare function sanitizeString(str: string): string;
+/**
+ * Reverses a string.
+ *
+ * @example
+ * ```typescript
+ * reverse('hello') // 'olleh'
+ * reverse('abc123') // '321cba'
+ * ```
+ *
+ * @param str The string to reverse
+ * @returns The reversed string
+ */
+export declare function reverse(str: string): string;
+/**
+ * Converts a string to a URL-friendly slug.
+ * Handles unicode, accents, and special characters.
+ *
+ * @example
+ * ```typescript
+ * slugify('Hello World!') // 'hello-world'
+ * slugify('Café & Résumé') // 'cafe-resume'
+ * slugify('  Multiple   Spaces  ') // 'multiple-spaces'
+ * ```
+ *
+ * @param str The string to slugify
+ * @returns The slugified string
+ */
+export declare function slugify(str: string): string;
+/**
+ * Splits a string into an array of words.
+ *
+ * @example
+ * ```typescript
+ * words('hello world') // ['hello', 'world']
+ * words('camelCaseString') // ['camel', 'Case', 'String']
+ * words('hello-world_test') // ['hello', 'world', 'test']
+ * ```
+ *
+ * @param str The string to split
+ * @returns Array of words
+ */
+export declare function words(str: string): string[];
+/**
+ * Counts the number of words in a string.
+ *
+ * @example
+ * ```typescript
+ * wordCount('hello world') // 2
+ * wordCount('  one  two  three  ') // 3
+ * wordCount('') // 0
+ * ```
+ *
+ * @param str The string to count words in
+ * @returns The word count
+ */
+export declare function wordCount(str: string): number;
+/**
+ * Escapes HTML special characters to prevent XSS.
+ *
+ * @example
+ * ```typescript
+ * escapeHtml('<div>Hello & "World"</div>') // '&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;'
+ * escapeHtml("It's <script>") // "It&#39;s &lt;script&gt;"
+ * ```
+ *
+ * @param str The string to escape
+ * @returns The escaped string
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Unescapes HTML entities back to their original characters.
+ *
+ * @example
+ * ```typescript
+ * unescapeHtml('&lt;div&gt;') // '<div>'
+ * unescapeHtml('&amp;&quot;&#39;') // '&"''
+ * ```
+ *
+ * @param str The string to unescape
+ * @returns The unescaped string
+ */
+export declare function unescapeHtml(str: string): string;
+/**
+ * Removes all HTML tags from a string.
+ *
+ * @example
+ * ```typescript
+ * stripHtml('<p>Hello <b>World</b></p>') // 'Hello World'
+ * stripHtml('<script>alert(1)</script>Text') // 'Text'
+ * ```
+ *
+ * @param str The string to strip HTML from
+ * @returns The string without HTML tags
+ */
+export declare function stripHtml(str: string): string;
+/**
+ * Returns the plural form of a word based on count.
+ *
+ * @example
+ * ```typescript
+ * pluralize('item', 0) // 'items'
+ * pluralize('item', 1) // 'item'
+ * pluralize('item', 5) // 'items'
+ * pluralize('box', 2, 'boxes') // 'boxes'
+ * ```
+ *
+ * @param word The singular word
+ * @param count The count
+ * @param plural Optional custom plural form
+ * @returns The pluralized word
+ */
+export declare function pluralize(word: string, count: number, plural?: string): string;
+/**
+ * Converts a number to its ordinal form.
+ *
+ * @example
+ * ```typescript
+ * ordinalize(1) // '1st'
+ * ordinalize(2) // '2nd'
+ * ordinalize(3) // '3rd'
+ * ordinalize(4) // '4th'
+ * ordinalize(11) // '11th'
+ * ordinalize(21) // '21st'
+ * ```
+ *
+ * @param num The number to ordinalize
+ * @returns The ordinal string
+ */
+export declare function ordinalize(num: number): string;
+/**
+ * Checks if a string is blank (empty or only whitespace).
+ *
+ * @example
+ * ```typescript
+ * isBlank('') // true
+ * isBlank('   ') // true
+ * isBlank('\t\n') // true
+ * isBlank('hello') // false
+ * isBlank(' a ') // false
+ * ```
+ *
+ * @param str The string to check
+ * @returns True if blank, false otherwise
+ */
+export declare function isBlank(str: string): boolean;
+/**
+ * Masks part of a string with a specified character.
+ *
+ * @example
+ * ```typescript
+ * mask('1234567890', 0, 4) // '******7890'
+ * mask('1234567890', 6, 10) // '123456****'
+ * mask('secret', 0, 3, 'X') // 'XXXret'
+ * mask('4111111111111111', 0, 12) // '************1111'
+ * ```
+ *
+ * @param str The string to mask
+ * @param start Start index of masking
+ * @param end End index of masking
+ * @param char The masking character (default: '*')
+ * @returns The masked string
+ */
+export declare function mask(str: string, start: number, end: number, char?: string): string;
+/**
+ * Simple template interpolation using ${key} syntax.
+ *
+ * @example
+ * ```typescript
+ * template('Hello, ${name}!', { name: 'World' }) // 'Hello, World!'
+ * template('${a} + ${b} = ${c}', { a: 1, b: 2, c: 3 }) // '1 + 2 = 3'
+ * template('Missing ${key}', {}) // 'Missing ${key}'
+ * ```
+ *
+ * @param str The template string
+ * @param data The data object with values
+ * @returns The interpolated string
+ */
+export declare function template(str: string, data: Record<string, unknown>): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAEnF;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAEjF;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAM5D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,MAEhF,CAAA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAehD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAOhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAI3E"}

package/dist/system/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Checks if the current OS is macOS.
+ * @returns {boolean} True if macOS, false otherwise.
+ */
+export declare function isMacOs(): boolean;
+/**
+ * Checks if the current OS is Windows.
+ * @returns {boolean} True if Windows, false otherwise.
+ */
+export declare function isWindows(): boolean;
+/**
+ * Checks if the current OS is Linux.
+ * @returns {boolean} True if Linux, false otherwise.
+ */
+export declare function isLinux(): boolean;
+/**
+ * Checks if the device is running iOS.
+ * @returns {boolean} True if iOS, false otherwise.
+ */
+export declare function isIOS(): boolean;
+/**
+ * Checks if the device is running Android.
+ * @returns {boolean} True if Android, false otherwise.
+ */
+export declare function isAndroid(): boolean;
+/**
+ * Returns a string representing the detected platform.
+ * @returns {string} The platform name (e.g., 'macos', 'windows', 'linux', 'ios', 'android', or 'unknown').
+ */
+export declare function getPlatform(): string;
+/**
+ * Checks if the device supports touch events.
+ * @returns {boolean} True if touch is supported, false otherwise.
+ */
+export declare function isTouchDevice(): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAQnC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAK/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC"}

package/dist/time/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Returns the current time as HH:MM:SS string.
+ * @returns {string}
+ */
+export declare function nowTime(): string;
+/**
+ * Parses a time string (HH:MM or HH:MM:SS) into a Date object (today's date).
+ * @param timeStr The time string.
+ * @returns {Date}
+ */
+export declare function parseTime(timeStr: string): Date;
+/**
+ * Formats a Date object as HH:MM:SS.
+ * @param date The Date object.
+ * @returns {string}
+ */
+export declare function formatTime(date: Date): string;
+/**
+ * Returns the difference in seconds between two times (as Date or string).
+ * @param t1 First time (Date or string).
+ * @param t2 Second time (Date or string).
+ * @returns {number}
+ */
+export declare function secondsBetween(t1: string | Date, t2: string | Date): number;
+/**
+ * Pads a number to two digits (e.g., 5 -> '05').
+ * @param n The number.
+ * @returns {string}
+ */
+export declare function pad2(n: number): string;
+/**
+ * Returns the current time as HH:MM string.
+ * @returns {string}
+ */
+export declare function nowTimeShort(): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAGhC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}

package/dist/try/attempt.d.ts

@@ -0,0 +1,8 @@
+type AttemptSuccess<T> = readonly [null, T];
+type AttemptFailure<E> = readonly [E, null];
+type AttemptResult<E, T> = AttemptSuccess<T> | AttemptFailure<E>;
+type AttemptResultAsync<E, T> = Promise<AttemptResult<E, T>>;
+export declare function attempt<E = Error, T = Promise<any>>(operation: T): AttemptResultAsync<E, T>;
+export declare function attempt<E = Error, T = any>(operation: () => T): AttemptResult<E, T>;
+export {};
+//# sourceMappingURL=attempt.d.ts.map

package/dist/try/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../src/try/attempt.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AAC3C,KAAK,cAAc,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAC3C,KAAK,aAAa,CAAC,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;AAChE,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAE5D,wBAAgB,OAAO,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5F,wBAAgB,OAAO,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/dist/try/index.d.ts

@@ -0,0 +1,2 @@
+export * from './trycatch.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/try/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

package/dist/try/trycatch.d.ts

@@ -0,0 +1,12 @@
+export type Success<T> = {
+    data: T;
+    error: null;
+};
+export type Failure<E> = {
+    data: null;
+    error: E;
+};
+export type Result<T, E = Error> = Success<T> | Failure<E>;
+export declare function isSuccess<T, E>(result: Result<T, E>): result is Success<T>;
+export declare function tryCatch<T, E = Error>(fn: () => Promise<T>): Promise<Result<T, E>>;
+//# sourceMappingURL=trycatch.d.ts.map

package/dist/try/trycatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trycatch.d.ts","sourceRoot":"","sources":["../../src/try/trycatch.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAA;AAEjD,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAEjD,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE1D,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAE1E;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAOxF"}

package/dist/types/common/index.d.ts

@@ -0,0 +1,9 @@
+/** Prettify a type for better intellisense */
+export type Prettify<T> = { [K in keyof T]: T[K] } & {}
+
+// export type Prettify<T> = {
+// 	[K in keyof T]: T[K]
+// }
+
+/** Merge two types, with B overriding A */
+export type Merge<A, B> = Omit<A, keyof B> & B

package/dist/types/env.d.ts

@@ -0,0 +1,5 @@
+declare namespace NodeJS {
+	interface ProcessEnv {
+		NODE_ENV?: 'development' | 'production' | 'test'
+	}
+}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './common'
+// export * from './api'
+export * from './env'

package/dist/url/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Checks if a string is a valid URL.
+ * @param str The string to check.
+ * @returns True if valid URL, false otherwise.
+ */
+export declare function isValidUrl(str: string): boolean;
+/**
+ * Gets the query parameters from a URL as an object.
+ * @param url The URL string.
+ * @returns An object of query parameters.
+ */
+export declare function getQueryParams(url: string): Record<string, string>;
+/**
+ * Adds or updates a query parameter in a URL.
+ * @param url The URL string.
+ * @param key The query parameter key.
+ * @param value The query parameter value.
+ * @returns The updated URL string.
+ */
+export declare function setQueryParam(url: string, key: string, value: string): string;
+/**
+ * Removes a query parameter from a URL.
+ * @param url The URL string.
+ * @param key The query parameter key to remove.
+ * @returns The updated URL string.
+ */
+export declare function removeQueryParam(url: string, key: string): string;
+/**
+ * Joins multiple URL segments into a single URL, ensuring proper slashes.
+ * @param parts The URL segments.
+ * @returns The joined URL string.
+ */
+export declare function joinUrl(...parts: string[]): string;
+/**
+ * Gets the hostname from a URL string.
+ * @param url The URL string.
+ * @returns The hostname, or an empty string if invalid.
+ */
+export declare function getHostname(url: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/uuid/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Generates a UUID v4 string.
+ * @returns {string} A new UUID v4 string.
+ */
+export declare const getUUID: () => string;
+/**
+ * Generates a UUID v7 string (time-ordered).
+ * UUID v7 embeds a Unix timestamp, making them sortable and ideal for database primary keys.
+ * @returns {string} A new UUID v7 string.
+ *
+ * @example
+ * ```typescript
+ * getUUIDv7() // '018e5e2c-7c0a-7000-8000-0e02b2c3d479'
+ * ```
+ */
+export declare const getUUIDv7: () => string;
+/**
+ * Generates a short UUID string using short-uuid.
+ * @returns {string} A new short UUID string.
+ */
+export declare const getShortUUID: () => string;
+/**
+ * Converts a standard UUID to a short UUID.
+ * @param uuid The standard UUID string.
+ * @returns {string} The short UUID string.
+ *
+ * @example
+ * ```typescript
+ * toShortUUID('f47ac10b-58cc-4372-a567-0e02b2c3d479') // 'mhvXdrZT4jP5T8vBxuvm75'
+ * ```
+ */
+export declare const toShortUUID: (uuid: string) => string;
+/**
+ * Converts a short UUID back to a standard UUID.
+ * @param short The short UUID string.
+ * @returns {string} The standard UUID string.
+ *
+ * @example
+ * ```typescript
+ * fromShortUUID('mhvXdrZT4jP5T8vBxuvm75') // 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
+ * ```
+ */
+export declare const fromShortUUID: (short: string) => string;
+/**
+ * Checks if a string is a valid UUID (any version).
+ * @param id The string to validate.
+ * @returns {boolean} True if valid UUID, false otherwise.
+ */
+export declare const isUUID: (id: string) => boolean;
+/**
+ * Checks if a string is a valid UUID v4.
+ * @param id The string to validate.
+ * @returns {boolean} True if valid UUID v4, false otherwise.
+ */
+export declare const isUUIDv4: (id: string) => boolean;
+/**
+ * Checks if a UUID is the nil UUID (all zeros).
+ * @param id The UUID string to check.
+ * @returns {boolean} True if nil UUID, false otherwise.
+ *
+ * @example
+ * ```typescript
+ * isNilUUID('00000000-0000-0000-0000-000000000000') // true
+ * isNilUUID('f47ac10b-58cc-4372-a567-0e02b2c3d479') // false
+ * ```
+ */
+export declare const isNilUUID: (id: string) => boolean;
+/**
+ * Gets the version number of a UUID.
+ * @param id The UUID string.
+ * @returns {number} The UUID version (1, 4, 7, etc.), or 0 for nil UUID.
+ * @throws {Error} If the UUID is invalid.
+ *
+ * @example
+ * ```typescript
+ * getUUIDVersion('f47ac10b-58cc-4372-a567-0e02b2c3d479') // 4
+ * getUUIDVersion('018e5e2c-7c0a-7000-8000-0e02b2c3d479') // 7
+ * getUUIDVersion('00000000-0000-0000-0000-000000000000') // 0
+ * ```
+ */
+export declare const getUUIDVersion: (id: string) => number;
+/**
+ * Returns the nil UUID (all zeros).
+ * @returns {string} The nil UUID string.
+ */
+export declare const getNilUUID: () => string;
+/**
+ * Converts a UUID string to a byte array (Uint8Array).
+ * @param id The UUID string.
+ * @returns {Uint8Array} The byte array representation of the UUID.
+ */
+export declare const uuidToBytes: (id: string) => Uint8Array;
+/**
+ * Converts a byte array (Uint8Array) to a UUID string.
+ * @param bytes The byte array.
+ * @returns {string} The UUID string.
+ */
+export declare const bytesToUUID: (bytes: Uint8Array) => string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uuid/index.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAO,MAE1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,QAAO,MAE5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,MAE/B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAE1C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAE7C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,KAAG,OAA2B,CAAA;AAE/D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,OAAoD,CAAA;AAE1F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,OAA0B,CAAA;AAEjE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAK3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,MAAkB,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,UAA2B,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,MAA8B,CAAA"}

package/dist/validation/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Checks if a value is defined (not null or undefined).
+ * @param value The value to check.
+ * @returns {boolean}
+ */
+export declare function isDefined<T>(value: T | null | undefined): value is T;
+/**
+ * Check if a value is a string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a string, `false` otherwise.
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Checks if a value is a number (and not NaN).
+ * @param value The value to check.
+ * @returns {boolean}
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Checks if a value is a boolean.
+ * @param value The value to check.
+ * @returns {boolean}
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Checks if a value is an array.
+ * @param value The value to check.
+ * @returns {boolean}
+ */
+export declare function isArray(value: unknown): value is unknown[];
+/**
+ * Checks if a value is an object (but not null or array).
+ * @param value The value to check.
+ * @returns {boolean}
+ */
+export declare function isObject(value: unknown): value is object;
+/**
+ * Checks if a string is a valid email address (simple regex).
+ * @param str The string to check.
+ * @returns {boolean}
+ */
+export declare function isEmail(str: string): boolean;
+/**
+ * Checks if a string is a valid URL.
+ * @param str The string to check.
+ * @returns {boolean}
+ */
+export declare function isUrl(str: string): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEpE;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;GAIG;AAEH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO1C"}