@knsdev330/node-utils 1.0.1

package/dist/bnUtils.js

@@ -0,0 +1,67 @@
+/**
+ * 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 const bnNum = (num) => {
+    let numStr = "";
+    for (const char of String(num)) {
+        if (char === '0')
+            numStr += '০';
+        else if (char === '1')
+            numStr += '১';
+        else if (char === '2')
+            numStr += '২';
+        else if (char === '3')
+            numStr += '৩';
+        else if (char === '4')
+            numStr += '৪';
+        else if (char === '5')
+            numStr += '৫';
+        else if (char === '6')
+            numStr += '৬';
+        else if (char === '7')
+            numStr += '৭';
+        else if (char === '8')
+            numStr += '৮';
+        else if (char === '9')
+            numStr += '৯';
+        else
+            numStr += char;
+    }
+    return numStr;
+};
+/**
+ * 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 const monthToBn = (month) => {
+    if (month === 'january' || month === 'jan' || month === 1)
+        return 'জানুয়ারি';
+    if (month === 'february' || month === 'feb' || month === 2)
+        return 'ফেব্রুয়ারি';
+    if (month === 'march' || month === 'mar' || month === 3)
+        return 'মার্চ';
+    if (month === 'april' || month === 'apr' || month === 4)
+        return 'এপ্রিল';
+    if (month === 'may' || month === 5)
+        return 'মে';
+    if (month === 'june' || month === 'jun' || month === 6)
+        return 'জুন';
+    if (month === 'july' || month === 'jul' || month === 7)
+        return 'জুলাই';
+    if (month === 'august' || month === 'aug' || month === 8)
+        return 'আগস্ট';
+    if (month === 'september' || month === 'sep' || month === 9)
+        return 'সেপ্টেম্বর';
+    if (month === 'october' || month === 'oct' || month === 10)
+        return 'অক্টোবর';
+    if (month === 'november' || month === 'nov' || month === 11)
+        return 'নভেম্বর';
+    if (month === 'december' || month === 'dec' || month === 12)
+        return 'ডিসেম্বর';
+    return month;
+};
+//# sourceMappingURL=bnUtils.js.map

package/dist/bnUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bnUtils.js","sourceRoot":"","sources":["../src/bnUtils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAoB,EAAU,EAAE;IACrD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAC3B,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;aAChC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,IAAI,GAAG,CAAC;;YAChC,MAAM,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,KAAiF,EACxE,EAAE;IACX,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAC9E,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IACjF,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACxE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzE,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACvE,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzE,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IACjF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7E,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9E,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,UAAU,CAAC;IAC/E,OAAO,KAAK,CAAC;AACd,CAAC,CAAC"}

package/dist/getEnvv.d.ts

@@ -0,0 +1,21 @@
+import type { TAppEnvs } from './types.js';
+type TypeMap = {
+    string: string;
+    int: number;
+    float: number;
+    boolean: boolean;
+    appEnv: TAppEnvs;
+};
+type EnvSchema = Record<string, keyof TypeMap>;
+type ResolvedEnv<T extends EnvSchema> = {
+    [K in keyof T]: TypeMap[T[K]];
+};
+/**
+ * Resolve and validate environment variables from a schema.
+ * @param schema - Map of env keys to expected primitive types.
+ * @returns Parsed environment object with inferred value types.
+ * @throws {Error} If required keys are missing or values fail validation.
+ */
+export declare const getEnvv: <T extends EnvSchema>(schema: T) => ResolvedEnv<T>;
+export {};
+//# sourceMappingURL=getEnvv.d.ts.map

package/dist/getEnvv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEnvv.d.ts","sourceRoot":"","sources":["../src/getEnvv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,OAAO,GAAG;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC;AAE/C,KAAK,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,SAAS,EAAE,QAAQ,CAAC,KAAG,WAAW,CAAC,CAAC,CAiErE,CAAC"}

package/dist/getEnvv.js

@@ -0,0 +1,68 @@
+/**
+ * Resolve and validate environment variables from a schema.
+ * @param schema - Map of env keys to expected primitive types.
+ * @returns Parsed environment object with inferred value types.
+ * @throws {Error} If required keys are missing or values fail validation.
+ */
+export const getEnvv = (schema) => {
+    const result = {};
+    const notFoundKeys = [];
+    const valueErrors = [];
+    for (const key of Object.keys(schema)) {
+        const raw = process.env[key];
+        if (raw === undefined || raw === '') {
+            notFoundKeys.push(key);
+            continue;
+        }
+        const type = schema[key];
+        if (type === 'int') {
+            if (!/^-?\d+$/.test(raw)) {
+                valueErrors.push(`${key} is not a valid integer`);
+                continue;
+            }
+            const parsed = parseInt(raw, 10);
+            result[key] = parsed;
+        }
+        else if (type === 'float') {
+            if (!/^-?\d+(\.\d+)?$/.test(raw)) {
+                valueErrors.push(`${key} is not a valid float`);
+                continue;
+            }
+            const parsed = parseFloat(raw);
+            result[key] = parsed;
+        }
+        else if (type === 'boolean') {
+            const lowerRaw = raw.toLowerCase();
+            const parsed = ['true', '1', 'yes', 'y', 'false', '0', 'no', 'n'].includes(lowerRaw)
+                ? ['true', '1', 'yes', 'y'].includes(lowerRaw)
+                : null;
+            if (parsed === null) {
+                valueErrors.push(`${key} is not a valid boolean`);
+                continue;
+            }
+            result[key] = parsed;
+        }
+        else if (type === 'string') {
+            result[key] = raw;
+        }
+        else if (type === 'appEnv') {
+            if (!['dev', 'test', 'prod'].includes(raw)) {
+                valueErrors.push(`${key} is not a valid app environment`);
+                continue;
+            }
+            result[key] = raw;
+        }
+        else {
+            valueErrors.push(`${key} is not a valid type`);
+        }
+    }
+    if (notFoundKeys.length + valueErrors.length > 0) {
+        throw new Error(`
+			${notFoundKeys.length > 0 ? `Not found keys: ${notFoundKeys.join(', ')}` : ''}
+			================================
+			${valueErrors.length > 0 ? `Value errors: ${valueErrors.join(', ')}` : ''}
+		`);
+    }
+    return result;
+};
+//# sourceMappingURL=getEnvv.js.map

package/dist/getEnvv.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { CookieUtils } from "./Cookies.js";
+export * from "./bnUtils.js";
+export type { EApiCodes } from "./EApiCodes.js";
+export * from "./ErrorClasses.js";
+export { FacebookUtils } from "./FBUtils.js";
+export { getEnvv } from "./getEnvv.js";
+export { GoogleUtils } from "./GoogleUtils.js";
+export { HMACUtils } from "./HMACUtils.js";
+export { HttpCodes, type THttpCodes } from "./HttpCodes.js";
+export { IDUtils } from "./IDUtils.js";
+export { JwtUtils } from "./JwtUtils.js";
+export * from "./Nums.js";
+export { PasswordUtils } from "./PasswordUtils.js";
+export * from "./Rand.js";
+export { tryCatch, tryCatch2 } from "./tryCatch.js";
+export { TurnstileValidator } from "./TurnstileValidator.js";
+export type * from "./types.js";
+export { validateUUID } from "./validators.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export { CookieUtils } from "./Cookies.js";
+export * from "./bnUtils.js";
+export * from "./ErrorClasses.js";
+export { FacebookUtils } from "./FBUtils.js";
+export { getEnvv } from "./getEnvv.js";
+export { GoogleUtils } from "./GoogleUtils.js";
+export { HMACUtils } from "./HMACUtils.js";
+export { HttpCodes } from "./HttpCodes.js";
+export { IDUtils } from "./IDUtils.js";
+export { JwtUtils } from "./JwtUtils.js";
+export * from "./Nums.js";
+export { PasswordUtils } from "./PasswordUtils.js";
+export * from "./Rand.js";
+export { tryCatch, tryCatch2 } from "./tryCatch.js";
+export { TurnstileValidator } from "./TurnstileValidator.js";
+export { validateUUID } from "./validators.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,cAAc,cAAc,CAAC;AAE7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tryCatch.d.ts

@@ -0,0 +1,23 @@
+type Success<T> = [
+    data: T,
+    error: null
+];
+type Failure<E> = [
+    data: null,
+    error: E
+];
+type Result<T, E = Error> = Success<T> | Failure<E>;
+/**
+ * Wrap a promise and return tuple-style `[data, error]`.
+ * @param promise - Promise to execute.
+ * @returns Tuple with successful data and `null` error, or `null` data and captured error.
+ */
+export declare function tryCatch<T, E = Error>(promise: Promise<T>): Promise<Result<T, E>>;
+/**
+ * Wrap a sync function and return tuple-style `[data, error]`.
+ * @param fn - Function to execute.
+ * @returns Tuple with successful data and `null` error, or `null` data and captured error.
+ */
+export declare function tryCatch2<T, E = Error>(fn: () => T): Result<T, E>;
+export {};
+//# sourceMappingURL=tryCatch.d.ts.map

package/dist/tryCatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryCatch.d.ts","sourceRoot":"","sources":["../src/tryCatch.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,CAAC,CAAC,IAAI;IACjB,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,IAAI;CACX,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,IAAI;IACjB,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,CAAC;CACR,CAAA;AAED,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAGpD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAC1C,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAQvB;AAGD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EACrC,EAAE,EAAE,MAAM,CAAC,GACT,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAQd"}

package/dist/tryCatch.js

@@ -0,0 +1,29 @@
+/**
+ * Wrap a promise and return tuple-style `[data, error]`.
+ * @param promise - Promise to execute.
+ * @returns Tuple with successful data and `null` error, or `null` data and captured error.
+ */
+export async function tryCatch(promise) {
+    try {
+        const data = await promise;
+        return [data, null];
+    }
+    catch (error) {
+        return [null, error];
+    }
+}
+/**
+ * Wrap a sync function and return tuple-style `[data, error]`.
+ * @param fn - Function to execute.
+ * @returns Tuple with successful data and `null` error, or `null` data and captured error.
+ */
+export function tryCatch2(fn) {
+    try {
+        const data = fn();
+        return [data, null];
+    }
+    catch (error) {
+        return [null, error];
+    }
+}
+//# sourceMappingURL=tryCatch.js.map

package/dist/tryCatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tryCatch.js","sourceRoot":"","sources":["../src/tryCatch.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,OAAmB;IAEnB,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC3B,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,EAAE,KAAU,CAAC,CAAC;IAC3B,CAAC;AACF,CAAC;AAGD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACxB,EAAW;IAEX,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,EAAE,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,EAAE,KAAU,CAAC,CAAC;IAC3B,CAAC;AACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,8 @@
+export type TMonths = `january` | `february` | `march` | `april` | `may` | `june` | `july` | `august` | `september` | `october` | `november` | `december`;
+export type TMonthsShorts = `jan` | `feb` | `mar` | `apr` | `may` | `jun` | `jul` | `aug` | `sep` | `oct` | `nov` | `dec`;
+export type TAppEnvs = 'dev' | 'test' | 'prod';
+export type TUserRoles = 'user' | 'admin' | 'super_admin' | 'bot' | 'moderator' | 'guest' | 'developer';
+export type TUserStatuses = 'active' | 'inactive' | 'pending' | 'blocked' | 'deleted';
+export type TUserGenders = 'male' | 'female' | 'other' | 'prefer_not_to_say';
+export type TVisibility = 'public' | 'private' | 'protected' | 'hidden';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAC1J,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC1H,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AACxG,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AACtF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAC7E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validators.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validate whether an unknown value is a UUID string.
+ * @param uuid - Value to validate.
+ * @returns `true` when `uuid` is a UUID string.
+ */
+export declare const validateUUID: (uuid: unknown) => uuid is string;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI,MAGpD,CAAC"}

package/dist/validators.js

@@ -0,0 +1,11 @@
+/**
+ * Validate whether an unknown value is a UUID string.
+ * @param uuid - Value to validate.
+ * @returns `true` when `uuid` is a UUID string.
+ */
+export const validateUUID = (uuid) => {
+    if (typeof uuid !== 'string')
+        return false;
+    return /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(uuid);
+};
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAa,EAAkB,EAAE;IAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,+EAA+E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,80 @@
+{
+	"name": "@knsdev330/node-utils",
+	"version": "1.0.1",
+	"description": "Node.js utilities: auth helpers, cookies, JWT, passwords, env parsing, IDs, validation, and more.",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./*": {
+			"types": "./dist/*.d.ts",
+			"import": "./dist/*.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "tsc",
+		"prepublishOnly": "pnpm run build",
+		"test": "echo \"Error: no test specified\" && exit 1"
+	},
+	"keywords": [
+		"nodejs",
+		"utilities",
+		"jwt",
+		"bcrypt",
+		"password",
+		"cookies",
+		"express",
+		"oauth",
+		"turnstile",
+		"typescript"
+	],
+	"author": "Khandaker Sajjat",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/KnsDev330/node-utils"
+	},
+	"bugs": {
+		"url": "https://github.com/KnsDev330/node-utils/issues"
+	},
+	"homepage": "https://github.com/KnsDev330/node-utils#readme",
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	},
+	"packageManager": "pnpm@10.30.3",
+	"peerDependencies": {
+		"express": "^4.18.0 || ^5.0.0"
+	},
+	"devDependencies": {
+		"@eslint/js": "^10.0.1",
+		"@types/bcrypt": "^6.0.0",
+		"@types/express": "^5.0.6",
+		"@types/jsonwebtoken": "^9.0.10",
+		"@types/node": "^25.5.0",
+		"eslint": "^10.1.0",
+		"eslint-config-prettier": "^10.1.8",
+		"eslint-plugin-only-warn": "^1.2.1",
+		"express": "^5.2.1",
+		"fs-extra": "^11.3.4",
+		"prettier": "^3.8.1",
+		"tsc-watch": "^7.2.0",
+		"tsx": "^4.21.0",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.57.2",
+		"semantic-release": "^25.0.3"
+	},
+	"dependencies": {
+		"bcrypt": "^6.0.0",
+		"jose": "^6.2.2",
+		"jsonwebtoken": "^9.0.3"
+	}
+}