@knsdev330/node-utils 1.0.1

package/dist/Nums.js

@@ -0,0 +1,141 @@
+/**
+ * Clamp a number to an inclusive range.
+ * @param value - Input number.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns `value` constrained to `[min, max]`.
+ */
+export const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+/**
+ * Check whether a number falls within an inclusive range.
+ * @param value - Number to test.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns `true` when `min <= value <= max`; otherwise `false`.
+ */
+export const isBetween = (value, min, max) => value >= min && value <= max;
+/**
+ * Round a number to a fixed number of decimal places.
+ * @param value - Number to round.
+ * @param decimals - Decimal places to keep.
+ * @returns Rounded number.
+ */
+export const roundTo = (value, decimals) => {
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+};
+/**
+ * Round a number down to a fixed number of decimal places.
+ * @param value - Number to floor.
+ * @param decimals - Decimal places to keep.
+ * @returns Floored number.
+ */
+export const floorTo = (value, decimals) => {
+    const factor = 10 ** decimals;
+    return Math.floor(value * factor) / factor;
+};
+/**
+ * Round a number up to a fixed number of decimal places.
+ * @param value - Number to ceil.
+ * @param decimals - Decimal places to keep.
+ * @returns Ceiled number.
+ */
+export const ceilTo = (value, decimals) => {
+    const factor = 10 ** decimals;
+    return Math.ceil(value * factor) / factor;
+};
+/**
+ * Parse a value into an integer safely.
+ * @param value - Value to parse.
+ * @param radix - Numeric base for parsing string inputs.
+ * @returns Parsed integer, or `null` for `null`/`undefined`/`NaN`.
+ */
+export const parseIntSafe = (value, radix = 10) => {
+    if (value === null || value === undefined)
+        return null;
+    const n = typeof value === 'number' ? value : parseInt(String(value), radix);
+    return Number.isNaN(n) ? null : n;
+};
+/**
+ * Parse a value into a floating-point number safely.
+ * @param value - Value to parse.
+ * @returns Parsed number, or `null` for `null`/`undefined`/`NaN`.
+ */
+export const parseFloatSafe = (value) => {
+    if (value === null || value === undefined)
+        return null;
+    const n = typeof value === 'number' ? value : parseFloat(String(value));
+    return Number.isNaN(n) ? null : n;
+};
+/**
+ * Type guard for finite numbers.
+ * @param value - Unknown input.
+ * @returns `true` when `value` is a finite `number`.
+ */
+export const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+/**
+ * Type guard for integer numbers.
+ * @param value - Unknown input.
+ * @returns `true` when `value` is an integer `number`.
+ */
+export const isInteger = (value) => typeof value === 'number' && Number.isInteger(value);
+/**
+ * Format a number using `Intl.NumberFormat`.
+ * @param value - Number to format.
+ * @param locale - BCP47 locale string.
+ * @param options - Number format options.
+ * @returns Formatted number string.
+ */
+export const formatNumber = (value, locale = 'en', options) => new Intl.NumberFormat(locale, {
+    minimumFractionDigits: 0,
+    maximumFractionDigits: 2,
+    ...options,
+}).format(value);
+/**
+ * Format a number with group separators.
+ * @param value - Number to format.
+ * @param locale - BCP47 locale string. (default: 'en')
+ * @param decimals - Optional fixed fraction digits.
+ * @returns Formatted string with commas/grouping.
+ */
+export const formatWithCommas = (value, locale = 'en', decimals) => {
+    const opts = {};
+    if (decimals !== undefined) {
+        opts.minimumFractionDigits = decimals;
+        opts.maximumFractionDigits = decimals;
+    }
+    return new Intl.NumberFormat(locale, opts).format(value);
+};
+/**
+ * Calculate percentage of `part` out of `total`.
+ * @param part - Numerator.
+ * @param total - Denominator.
+ * @param decimals - Decimal places in the result.
+ * @returns Percentage value. Returns `0` if `total` is `0`.
+ */
+export const percentage = (part, total, decimals = 0) => {
+    if (total === 0)
+        return 0;
+    return roundTo((part / total) * 100, decimals);
+};
+/**
+ * Convert unknown input to a finite number with fallback.
+ * @param value - Value to convert.
+ * @param fallback - Value used when conversion is not finite.
+ * @returns Finite number from input, or `fallback`.
+ */
+export const toNumber = (value, fallback) => {
+    const n = typeof value === 'number' ? value : parseFloat(String(value));
+    return Number.isFinite(n) ? n : fallback;
+};
+/**
+ * Convert unknown input to an integer with fallback.
+ * @param value - Value to convert.
+ * @param fallback - Value used when conversion is not an integer.
+ * @returns Integer from input, or `fallback`.
+ */
+export const toInt = (value, fallback) => {
+    const n = typeof value === 'number' ? value : parseInt(String(value), 10);
+    return Number.isInteger(n) ? n : fallback;
+};
+//# sourceMappingURL=Nums.js.map

package/dist/Nums.js.map

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

package/dist/PasswordUtils.d.ts

@@ -0,0 +1,58 @@
+declare class passwordUtils {
+    /**
+     * Hash a password with bcrypt and return result as success/error object.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Success object with hash, or failure object with error.
+     */
+    readonly hashPassword: (password: string, saltRounds?: number) => Promise<{
+        success: true;
+        hashedPassword: string;
+    } | {
+        success: false;
+        error: Error;
+    }>;
+    /**
+     * Hash a password with bcrypt and throw on failure.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Hashed password string.
+     * @throws {InternalServerError} If hashing fails.
+     */
+    readonly hashPasswordOrThrow: (password: string, saltRounds?: number) => Promise<string>;
+    /**
+     * Compare plain-text password with bcrypt hash.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true`/`false` comparison result, or `false` if comparison throws.
+     */
+    readonly comparePassword: (password: string, hashedPassword: string) => Promise<boolean | null>;
+    /**
+     * Compare plain-text password with bcrypt hash and throw on failure.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true` when password matches hash, otherwise `false`.
+     * @throws {InternalServerError} If comparison fails unexpectedly.
+     */
+    readonly comparePasswordOrThrow: (password: string, hashedPassword: string) => Promise<boolean>;
+    /**
+     * Validate password length boundaries.
+     * @param password - Plain-text password.
+     * @param minLength - Inclusive minimum length.
+     * @param maxLength - Inclusive maximum length.
+     * @returns `true` when password length is within bounds.
+     */
+    readonly validateStrength: (password: string, minLength: number, maxLength: number) => boolean;
+    /**
+     * Check whether a string appears to be a bcrypt hash.
+     * @param value - Input string.
+     * @returns `true` when input matches bcrypt hash pattern.
+     */
+    readonly isBcryptHash: (value: string) => boolean;
+}
+/**
+ * Singleton instance of password utilities.
+ */
+export declare const PasswordUtils: passwordUtils;
+export {};
+//# sourceMappingURL=PasswordUtils.d.ts.map

package/dist/PasswordUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordUtils.d.ts","sourceRoot":"","sources":["../src/PasswordUtils.ts"],"names":[],"mappings":"AAKA,cAAM,aAAa;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,GACpB,UAAU,MAAM,EAChB,mBAAgC,KAC9B,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAOtF;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,GAC3B,UAAU,MAAM,EAChB,mBAAgC,KAC9B,OAAO,CAAC,MAAM,CAAC,CAOhB;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,GACvB,UAAU,MAAM,EAChB,gBAAgB,MAAM,KACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAOxB;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,GAC9B,UAAU,MAAM,EAChB,gBAAgB,MAAM,KACpB,OAAO,CAAC,OAAO,CAAC,CAOjB;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAC/B;IAE9D;;;;OAIG;IACH,QAAQ,CAAC,YAAY,GAAI,OAAO,MAAM,KAAG,OAAO,CACI;CACpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/PasswordUtils.js

@@ -0,0 +1,82 @@
+import bcrypt from "bcrypt";
+import { InternalServerError } from "./ErrorClasses.js";
+const DEFAULT_SALT_ROUNDS = 10;
+class passwordUtils {
+    /**
+     * Hash a password with bcrypt and return result as success/error object.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Success object with hash, or failure object with error.
+     */
+    hashPassword = async (password, saltRounds = DEFAULT_SALT_ROUNDS) => {
+        try {
+            return { success: true, hashedPassword: await bcrypt.hash(password, saltRounds) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    };
+    /**
+     * Hash a password with bcrypt and throw on failure.
+     * @param password - Plain-text password.
+     * @param saltRounds - BCrypt salt rounds.
+     * @returns Hashed password string.
+     * @throws {InternalServerError} If hashing fails.
+     */
+    hashPasswordOrThrow = async (password, saltRounds = DEFAULT_SALT_ROUNDS) => {
+        try {
+            return await bcrypt.hash(password, saltRounds);
+        }
+        catch {
+            throw new InternalServerError();
+        }
+    };
+    /**
+     * Compare plain-text password with bcrypt hash.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true`/`false` comparison result, or `false` if comparison throws.
+     */
+    comparePassword = async (password, hashedPassword) => {
+        try {
+            return await bcrypt.compare(password, hashedPassword);
+        }
+        catch {
+            return false;
+        }
+    };
+    /**
+     * Compare plain-text password with bcrypt hash and throw on failure.
+     * @param password - Plain-text password.
+     * @param hashedPassword - BCrypt hash.
+     * @returns `true` when password matches hash, otherwise `false`.
+     * @throws {InternalServerError} If comparison fails unexpectedly.
+     */
+    comparePasswordOrThrow = async (password, hashedPassword) => {
+        try {
+            return await bcrypt.compare(password, hashedPassword);
+        }
+        catch {
+            throw new InternalServerError();
+        }
+    };
+    /**
+     * Validate password length boundaries.
+     * @param password - Plain-text password.
+     * @param minLength - Inclusive minimum length.
+     * @param maxLength - Inclusive maximum length.
+     * @returns `true` when password length is within bounds.
+     */
+    validateStrength = (password, minLength, maxLength) => password.length >= minLength && password.length <= maxLength;
+    /**
+     * Check whether a string appears to be a bcrypt hash.
+     * @param value - Input string.
+     * @returns `true` when input matches bcrypt hash pattern.
+     */
+    isBcryptHash = (value) => /^\$2[aby]\$\d{2}\$[./A-Za-z0-9]{53}$/.test(value);
+}
+/**
+ * Singleton instance of password utilities.
+ */
+export const PasswordUtils = new passwordUtils();
+//# sourceMappingURL=PasswordUtils.js.map

package/dist/PasswordUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordUtils.js","sourceRoot":"","sources":["../src/PasswordUtils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,aAAa;IAClB;;;;;OAKG;IACM,YAAY,GAAG,KAAK,EAC5B,QAAgB,EAChB,UAAU,GAAG,mBAAmB,EACwD,EAAE;QAC1F,IAAI,CAAC;YACJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACnF,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QAClD,CAAC;IACF,CAAC,CAAC;IAEF;;;;;;OAMG;IACM,mBAAmB,GAAG,KAAK,EACnC,QAAgB,EAChB,UAAU,GAAG,mBAAmB,EACd,EAAE;QACpB,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,CAAC;YACN,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACjC,CAAC;IACF,CAAC,CAAC;IAEF;;;;;OAKG;IACM,eAAe,GAAG,KAAK,EAC/B,QAAgB,EAChB,cAAsB,EACI,EAAE;QAC5B,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC;YACN,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC,CAAC;IAEF;;;;;;OAMG;IACM,sBAAsB,GAAG,KAAK,EACtC,QAAgB,EAChB,cAAsB,EACH,EAAE;QACrB,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC;YACN,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACjC,CAAC;IACF,CAAC,CAAC;IAEF;;;;;;OAMG;IACM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAE,SAAiB,EAAW,EAAE,CAC/F,QAAQ,CAAC,MAAM,IAAI,SAAS,IAAI,QAAQ,CAAC,MAAM,IAAI,SAAS,CAAC;IAE9D;;;;OAIG;IACM,YAAY,GAAG,CAAC,KAAa,EAAW,EAAE,CAClD,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/Rand.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pseudo-random integer between `min` and `max` (inclusive) using `Math.random()`.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A pseudo-random integer `n` such that `min <= n <= max`.
+ */
+export declare const srandInt: (min: number, max: number) => number;
+/**
+ * Crypto-random integer between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound. Must be a safe integer.
+ * @param max - Inclusive upper bound. Must be a safe integer.
+ * @returns A crypto-random integer `n` such that `min <= n <= max`.
+ * @throws {TypeError} If `min` or `max` are not safe integers.
+ * @throws {RangeError} If `max < min`.
+ */
+export declare const randInt: (min: number, max: number) => number;
+/**
+ * Pseudo-random float between `min` and `max`.
+ * Note: uses `Math.random()`, so the result is effectively in `[min, max)` (with `max` excluded).
+ * @param min - Inclusive lower bound.
+ * @param max - Upper bound (effectively exclusive).
+ * @returns A pseudo-random number `x` such that `min <= x < max`.
+ */
+export declare const srandFloat: (min: number, max: number) => number;
+/**
+ * Crypto-random float between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A crypto-random number `x` such that `min <= x <= max` (subject to normal floating-point rounding).
+ */
+export declare const randFloat: (min: number, max: number) => number;
+/**
+ * Generates a crypto-random RFC4122 v4 UUID.
+ * @returns A UUID string (e.g. `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`).
+ */
+export declare const randUuid: () => string;
+/**
+ * Crypto-random Base58 string.
+ * Uses `randInt(0, max)` with an inclusive `max` contract.
+ * @param length - Number of characters to generate.
+ * @returns A Base58 string of length `length` (or `""` if `length <= 0`).
+ */
+export declare const randStr: (length: number) => string;
+//# sourceMappingURL=Rand.d.ts.map

package/dist/Rand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rand.d.ts","sourceRoot":"","sources":["../src/Rand.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WACC,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAW/C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAAsC,CAAC;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAUjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAO,MAAsB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,WAOrC,CAAA"}

package/dist/Rand.js

@@ -0,0 +1,72 @@
+import { randomUUID, randomInt as cryptoRandomInt } from "crypto";
+const BASE58_CHARS = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Pseudo-random integer between `min` and `max` (inclusive) using `Math.random()`.
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A pseudo-random integer `n` such that `min <= n <= max`.
+ */
+export const srandInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+/**
+ * Crypto-random integer between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound. Must be a safe integer.
+ * @param max - Inclusive upper bound. Must be a safe integer.
+ * @returns A crypto-random integer `n` such that `min <= n <= max`.
+ * @throws {TypeError} If `min` or `max` are not safe integers.
+ * @throws {RangeError} If `max < min`.
+ */
+export const randInt = (min, max) => {
+    // Node's `crypto.randomInt` uses an exclusive upper bound.
+    // We keep the previous inclusive `max` contract.
+    if (!Number.isSafeInteger(min) || !Number.isSafeInteger(max)) {
+        throw new TypeError("randInt(min, max) requires safe integers");
+    }
+    if (max < min) {
+        throw new RangeError("randInt(min, max): max must be >= min");
+    }
+    return cryptoRandomInt(min, max + 1);
+};
+/**
+ * Pseudo-random float between `min` and `max`.
+ * Note: uses `Math.random()`, so the result is effectively in `[min, max)` (with `max` excluded).
+ * @param min - Inclusive lower bound.
+ * @param max - Upper bound (effectively exclusive).
+ * @returns A pseudo-random number `x` such that `min <= x < max`.
+ */
+export const srandFloat = (min, max) => Math.random() * (max - min) + min;
+/**
+ * Crypto-random float between `min` and `max` (inclusive).
+ * @param min - Inclusive lower bound.
+ * @param max - Inclusive upper bound.
+ * @returns A crypto-random number `x` such that `min <= x <= max` (subject to normal floating-point rounding).
+ */
+export const randFloat = (min, max) => {
+    const range = max - min;
+    if (range === 0)
+        return min;
+    // Uniform value in [0, 1] using 48 random bits (inclusive upper endpoint).
+    // `crypto.randomInt(min, max)` treats `max` as exclusive.
+    const maxInclusiveInt = 2 ** 48 - 2;
+    const uInt = cryptoRandomInt(0, maxInclusiveInt + 1); // -> [0, maxInclusiveInt]
+    const u = uInt / maxInclusiveInt; // -> [0, 1]
+    return min + u * range;
+};
+/**
+ * Generates a crypto-random RFC4122 v4 UUID.
+ * @returns A UUID string (e.g. `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`).
+ */
+export const randUuid = () => randomUUID();
+/**
+ * Crypto-random Base58 string.
+ * Uses `randInt(0, max)` with an inclusive `max` contract.
+ * @param length - Number of characters to generate.
+ * @returns A Base58 string of length `length` (or `""` if `length <= 0`).
+ */
+export const randStr = (length) => {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += BASE58_CHARS[randInt(0, BASE58_CHARS.length - 1)];
+    }
+    return result;
+};
+//# sourceMappingURL=Rand.js.map

package/dist/Rand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rand.js","sourceRoot":"","sources":["../src/Rand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,QAAQ,CAAC;AAElE,MAAM,YAAY,GAAG,4DAA4D,CAAC;AAElF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CACpD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE;IACnD,2DAA2D;IAC3D,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE;IACrD,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5B,2EAA2E;IAC3E,0DAA0D;IAC1D,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B;IAChF,MAAM,CAAC,GAAG,IAAI,GAAG,eAAe,CAAC,CAAC,YAAY;IAC9C,OAAO,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;AACxB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,UAAU,EAAE,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,EAAE;IACzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC,CAAA"}

package/dist/TurnstileValidator.d.ts

@@ -0,0 +1,57 @@
+import type { TAppEnvs } from "./types.js";
+type customErrCodes = "invalid-token-format" | "token-too-long" | "action-mismatch" | "hostname-mismatch" | "validation-timeout" | "internal-error";
+type TurnstileValidationError = {
+    'success': false;
+    'error-codes': (customErrCodes | 'missing-input-secret' | 'invalid-input-secret' | 'missing-input-response' | 'invalid-input-response' | 'bad-request' | 'timeout-or-duplicate' | 'internal-error')[];
+};
+type TurnstileValidationSuccess = {
+    'success': true;
+    'challenge_ts': string;
+    'hostname': string;
+    'error-codes': [];
+    'action': string;
+    'cdata': unknown;
+    'metadata': {
+        'ephemeral_id': string;
+    };
+};
+type TurnstileValidationResult = [null, TurnstileValidationError] | [TurnstileValidationSuccess, null];
+declare class turnstileValidator {
+    /**
+     * Validate a Cloudflare Turnstile token.
+     * @param secretKey - Turnstile secret key.
+     * @param token - Token submitted by the client.
+     * @param remoteip - Optional client IP.
+     * @param options - Optional expected action/hostname and idempotency key.
+     * @param timeout - Request timeout in milliseconds.
+     * @param _appEnv - Reserved for callers (e.g. future logging policy); unused.
+     * @returns Tuple of `[successResult, null]` or `[null, errorResult]`.
+     */
+    readonly validate: (secretKey: string, token: string, remoteip: string | null | undefined, options: {
+        expectedAction?: string;
+        expectedHostname?: string;
+        idempotencyKey?: string;
+    } | undefined, timeout: number | undefined, _appEnv: TAppEnvs) => Promise<TurnstileValidationResult>;
+    /**
+     * Validate Turnstile token and throw on failure.
+     * @param secretKey - Turnstile secret key.
+     * @param token - Token submitted by the client.
+     * @param remoteip - Optional client IP.
+     * @param options - Optional expected action/hostname and idempotency key.
+     * @param timeout - Request timeout in milliseconds.
+     * @param APP_ENV - Reserved; forwarded to `validate` for API stability.
+     * @returns Successful Turnstile verification payload.
+     * @throws {BadRequest} When token validation fails.
+     */
+    readonly validateOrThrow: (secretKey: string, token: string, remoteip: string | null | undefined, options: {
+        expectedAction?: string;
+        expectedHostname?: string;
+        idempotencyKey?: string;
+    } | undefined, timeout: number | undefined, APP_ENV: TAppEnvs) => Promise<TurnstileValidationSuccess>;
+}
+/**
+ * Singleton instance of Turnstile validation utilities.
+ */
+export declare const TurnstileValidator: turnstileValidator;
+export {};
+//# sourceMappingURL=TurnstileValidator.d.ts.map

package/dist/TurnstileValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnstileValidator.d.ts","sourceRoot":"","sources":["../src/TurnstileValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,KAAK,cAAc,GAAG,sBAAsB,GAC3C,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,CAAC;AAElB,KAAK,wBAAwB,GAAG;IAC/B,SAAS,EAAE,KAAK,CAAC;IACjB,aAAa,EAAE,CACd,cAAc,GACd,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,wBAAwB,GACxB,aAAa,GACb,sBAAsB,GACtB,gBAAgB,CAChB,EAAE,CAAC;CACJ,CAAC;AAEF,KAAK,0BAA0B,GAAG;IACjC,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE;QACX,cAAc,EAAE,MAAM,CAAC;KACvB,CAAC;CACF,CAAA;AAED,KAAK,yBAAyB,GAAG,CAAC,IAAI,EAAE,wBAAwB,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;AAGvG,cAAM,kBAAkB;IACvB;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,GAChB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,SAAS;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,YAAK,EAC7F,2BAAe,EACf,SAAS,QAAQ,KACf,OAAO,CAAC,yBAAyB,CAAC,CAmFpC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,eAAe,GACvB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,SAAS;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,YAAK,EAC7F,2BAAe,EACf,SAAS,QAAQ,KACf,OAAO,CAAC,0BAA0B,CAAC,CAMrC;CACD;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/TurnstileValidator.js

@@ -0,0 +1,99 @@
+import { BadRequest } from "./ErrorClasses.js";
+class turnstileValidator {
+    /**
+     * Validate a Cloudflare Turnstile token.
+     * @param secretKey - Turnstile secret key.
+     * @param token - Token submitted by the client.
+     * @param remoteip - Optional client IP.
+     * @param options - Optional expected action/hostname and idempotency key.
+     * @param timeout - Request timeout in milliseconds.
+     * @param _appEnv - Reserved for callers (e.g. future logging policy); unused.
+     * @returns Tuple of `[successResult, null]` or `[null, errorResult]`.
+     */
+    validate = async (secretKey, token, remoteip, options = {}, timeout = 10000, _appEnv) => {
+        // Input validation
+        if (!token || typeof token !== "string") {
+            return [null, { success: false, 'error-codes': ["invalid-token-format"] }];
+        }
+        if (token.length > 2048) {
+            return [null, { success: false, 'error-codes': ["token-too-long"] }];
+        }
+        // Prepare request
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const formData = new FormData();
+            formData.append("secret", secretKey);
+            formData.append("response", token);
+            if (remoteip) {
+                formData.append("remoteip", remoteip);
+            }
+            if (options.idempotencyKey) {
+                formData.append("idempotency_key", options.idempotencyKey);
+            }
+            const response = await fetch("https://challenges.cloudflare.com/turnstile/v0/siteverify", {
+                method: "POST",
+                body: formData,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                return [null, { success: false, 'error-codes': ["internal-error"] }];
+            }
+            let result;
+            try {
+                result = await response.json();
+            }
+            catch {
+                return [null, { success: false, 'error-codes': ["internal-error"] }];
+            }
+            if (typeof result !== "object" || result === null || !("success" in result)) {
+                return [null, { success: false, 'error-codes': ["internal-error"] }];
+            }
+            // Additional validation
+            if (result.success) {
+                if (options.expectedAction &&
+                    result.action !== options.expectedAction) {
+                    return [null, { success: false, 'error-codes': ["action-mismatch"] }];
+                }
+                if (options.expectedHostname &&
+                    result.hostname !== options.expectedHostname) {
+                    return [null, { success: false, 'error-codes': ["hostname-mismatch"] }];
+                }
+                return [result, null];
+            }
+            return [null, result];
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                return [null, { success: false, 'error-codes': ["validation-timeout"] }];
+            }
+            return [null, { success: false, 'error-codes': ["internal-error"] }];
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    };
+    /**
+     * Validate Turnstile token and throw on failure.
+     * @param secretKey - Turnstile secret key.
+     * @param token - Token submitted by the client.
+     * @param remoteip - Optional client IP.
+     * @param options - Optional expected action/hostname and idempotency key.
+     * @param timeout - Request timeout in milliseconds.
+     * @param APP_ENV - Reserved; forwarded to `validate` for API stability.
+     * @returns Successful Turnstile verification payload.
+     * @throws {BadRequest} When token validation fails.
+     */
+    validateOrThrow = async (secretKey, token, remoteip, options = {}, timeout = 10000, APP_ENV) => {
+        const [result, error] = await this.validate(secretKey, token, remoteip, options, timeout, APP_ENV);
+        if (error) {
+            throw new BadRequest('CAPTCHA__VALIDATION_FAILED');
+        }
+        return result;
+    };
+}
+/**
+ * Singleton instance of Turnstile validation utilities.
+ */
+export const TurnstileValidator = new turnstileValidator();
+//# sourceMappingURL=TurnstileValidator.js.map

package/dist/TurnstileValidator.js.map

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

package/dist/bnUtils.d.ts

@@ -0,0 +1,15 @@
+import type { TMonths, TMonthsShorts } from "./types.js";
+/**
+ * Convert ASCII digits in the input to Bengali digits.
+ * Non-digit characters are preserved as-is.
+ * @param num - A number or string to convert.
+ * @returns A string where `0-9` are replaced by their Bengali equivalents.
+ */
+export declare const bnNum: (num: number | string) => string;
+/**
+ * Convert a lowercase English month (full/short) or month number to the Bengali month name.
+ * @param month - Month as a number (`1-12`), lowercase full English month name, or lowercase short English month name.
+ * @returns The Bengali month name string for known inputs; otherwise returns the original `month` value.
+ */
+export declare const monthToBn: (month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | TMonths | TMonthsShorts) => string;
+//# sourceMappingURL=bnUtils.d.ts.map

package/dist/bnUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bnUtils.d.ts","sourceRoot":"","sources":["../src/bnUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,GAAG,MAAM,KAAG,MAiB5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACrB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,GAAG,aAAa,KAC/E,MAcF,CAAC"}