@knsdev/node-utils 1.0.1 → 2.0.0

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"}

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 "./PassUtils.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,gBAAgB,CAAC;AAC/C,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 "./PassUtils.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,gBAAgB,CAAC;AAC/C,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,9 @@
+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';
+export type TThemes = 'light' | 'dark' | 'system';
+//# 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;AACxE,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,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/dist/zod.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export declare const z_PASSWORD: z.ZodString;
+export declare const z_GENERAL_TOKEN: z.ZodString;
+export declare const z_CODE_6_DIGITS: z.ZodString;
+export declare const z_SLUG: z.ZodString;
+export declare const z_EMAIL: z.ZodEmail;
+export declare const z_FIRST_NAME: z.ZodString;
+export declare const z_LAST_NAME: z.ZodString;
+export declare const z_TURNSTILE_TOKEN: z.ZodString;
+export declare const z_LOGOUT_OTHER_SESSIONS: z.ZodBoolean;
+export declare const z_REMEMBER_ME: z.ZodBoolean;
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,UAAU,aAEgC,CAAC;AAExD,eAAO,MAAM,eAAe,aAE4B,CAAC;AAEzD,eAAO,MAAM,eAAe,aAE0B,CAAC;AAEvD,eAAO,MAAM,MAAM,aAG4B,CAAC;AAEhD,eAAO,MAAM,OAAO,YAE6B,CAAA;AAEjD,eAAO,MAAM,YAAY,aAEkC,CAAC;AAE5D,eAAO,MAAM,WAAW,aAEiC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,aAEuC,CAAA;AAErE,eAAO,MAAM,uBAAuB,cACkC,CAAC;AAEvE,eAAO,MAAM,aAAa,cACkC,CAAC"}

package/dist/zod.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { CLengths } from "./CLengths.js";
+const k = (key) => key;
+export const z_PASSWORD = z.string(k('PASSWORD__INVALID'))
+    .min(CLengths.PASSWORD.min, k('PASSWORD__MIN_LENGTH'))
+    .max(CLengths.PASSWORD.max, k('PASSWORD__MAX_LENGTH'));
+export const z_GENERAL_TOKEN = z.string(k('GENERAL_TOKEN__INVALID'))
+    .length(CLengths.GENERAL_TOKEN, k('GENERAL_TOKEN__LENGTH'))
+    .regex(/^[a-zA-Z0-9-_]+$/, k('GENERAL_TOKEN__INVALID'));
+export const z_CODE_6_DIGITS = z.string(k('CODE_6_DIGITS__INVALID'))
+    .length(CLengths.Code_6_digits, k('CODE_6_DIGITS__LENGTH'))
+    .regex(/^\d{6}$/, k('CODE_6_DIGITS__INVALID_FORMAT'));
+export const z_SLUG = z.string(k('SLUG__INVALID'))
+    .min(CLengths.SLUG.min, k('SLUG__MIN_LENGTH'))
+    .max(CLengths.SLUG.max, k('SLUG__MAX_LENGTH'))
+    .regex(/^[a-zA-Z0-9-_]+$/, k('SLUG__INVALID'));
+export const z_EMAIL = z.email(k('EMAIL__INVALID'))
+    .min(CLengths.EMAIL.min, k('EMAIL__MIN_LENGTH'))
+    .max(CLengths.EMAIL.max, k('EMAIL__MAX_LENGTH'));
+export const z_FIRST_NAME = z.string(k('FIRST_NAME__INVALID'))
+    .min(CLengths.FIRST_NAME.min, k('FIRST_NAME__MIN_LENGTH'))
+    .max(CLengths.FIRST_NAME.max, k('FIRST_NAME__MAX_LENGTH'));
+export const z_LAST_NAME = z.string(k('LAST_NAME__INVALID'))
+    .min(CLengths.LAST_NAME.min, k('LAST_NAME__MIN_LENGTH'))
+    .max(CLengths.LAST_NAME.max, k('LAST_NAME__MAX_LENGTH'));
+export const z_TURNSTILE_TOKEN = z.string(k('TURNSTILE_TOKEN__INVALID'))
+    .min(CLengths.TURNSTILE_TOKEN.min, k('TURNSTILE_TOKEN__MIN_LENGTH'))
+    .max(CLengths.TURNSTILE_TOKEN.max, k('TURNSTILE_TOKEN__MAX_LENGTH'));
+export const z_LOGOUT_OTHER_SESSIONS = z.boolean(k('LOGOUT_OTHER_SESSIONS__INVALID'))
+    .refine((data) => data === true, k('LOGOUT_OTHER_SESSIONS__INVALID'));
+export const z_REMEMBER_ME = z.boolean(k('REMEMBER_ME__INVALID'))
+    .refine((data) => data === true, k('REMEMBER_ME__INVALID'));
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

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

package/dist/zodTypes.d.ts

@@ -0,0 +1,2 @@
+export type TZodCodes = `PASSWORD__REQUIRED` | `PASSWORD__INVALID` | `PASSWORD__MIN_LENGTH` | `PASSWORD__MAX_LENGTH` | `GENERAL_TOKEN__REQUIRED` | `GENERAL_TOKEN__INVALID` | `GENERAL_TOKEN__LENGTH` | `CODE_6_DIGITS__REQUIRED` | `CODE_6_DIGITS__INVALID` | `CODE_6_DIGITS__LENGTH` | `CODE_6_DIGITS__INVALID_FORMAT` | `EMAIL__REQUIRED` | `EMAIL__INVALID` | `EMAIL__MIN_LENGTH` | `EMAIL__MAX_LENGTH` | `FIRST_NAME__REQUIRED` | `FIRST_NAME__INVALID` | `FIRST_NAME__MIN_LENGTH` | `FIRST_NAME__MAX_LENGTH` | `LAST_NAME__REQUIRED` | `LAST_NAME__INVALID` | `LAST_NAME__MIN_LENGTH` | `LAST_NAME__MAX_LENGTH` | `TURNSTILE_TOKEN__REQUIRED` | `TURNSTILE_TOKEN__INVALID` | `TURNSTILE_TOKEN__MIN_LENGTH` | `TURNSTILE_TOKEN__MAX_LENGTH` | `CONFIRM_PASSWORD__REQUIRED` | `CONFIRM_PASSWORD__DONT_MATCH` | `LOGOUT_OTHER_SESSIONS__REQUIRED` | `LOGOUT_OTHER_SESSIONS__INVALID` | `REMEMBER_ME__REQUIRED` | `REMEMBER_ME__INVALID` | `SLUG__REQUIRED` | `SLUG__INVALID` | `SLUG__MIN_LENGTH` | `SLUG__MAX_LENGTH` | `USERNAME__REQUIRED` | `USERNAME__INVALID` | `USERNAME__MIN_LENGTH` | `USERNAME__MAX_LENGTH` | `DESIGNATION__REQUIRED` | `DESIGNATION__INVALID` | `DESIGNATION_MAX_LENGTH` | `BIO__REQUIRED` | `BIO__INVALID` | `BIO_MAX_LENGTH` | `PROFILE_VISIBILITY__REQUIRED` | `PROFILE_VISIBILITY__INVALID`;
+//# sourceMappingURL=zodTypes.d.ts.map

package/dist/zodTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodTypes.d.ts","sourceRoot":"","sources":["../src/zodTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GAEtB,yBAAyB,GACzB,wBAAwB,GACxB,uBAAuB,GAEvB,yBAAyB,GACzB,wBAAwB,GACxB,uBAAuB,GACvB,+BAA+B,GAE/B,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GAEnB,sBAAsB,GACtB,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GAExB,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,uBAAuB,GAEvB,2BAA2B,GAC3B,0BAA0B,GAC1B,6BAA6B,GAC7B,6BAA6B,GAE7B,4BAA4B,GAC5B,8BAA8B,GAE9B,iCAAiC,GACjC,gCAAgC,GAEhC,uBAAuB,GACvB,sBAAsB,GACtB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAElB,oBAAoB,GACpB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GAEtB,uBAAuB,GACvB,sBAAsB,GACtB,wBAAwB,GAExB,eAAe,GACf,cAAc,GACd,gBAAgB,GAEhB,8BAA8B,GAC9B,6BAA6B,CAAC"}

package/dist/zodTypes.js

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

package/dist/zodTypes.js.map

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