@plyaz/types 1.27.2 → 1.27.4

package/dist/auth/index.js

@@ -2,6 +2,20 @@ import { z } from 'zod';
 
 // @plyaz package - Built with tsup
 
+// src/errors/enums.ts
+var ERROR_SEVERITY = {
+  /** Low severity - does not impact functionality significantly. */
+  Low: "low",
+  /** Medium severity - minor disruption or warning. */
+  Medium: "medium",
+  /** High severity - major issue requiring attention. */
+  High: "high"};
+var ERROR_CATEGORY = {
+  /** Authentication-related error (e.g., invalid credentials, expired token). */
+  Authentication: "authentication",
+  /** Authorization-related error (e.g., insufficient permissions). */
+  Authorization: "authorization"};
+
 // src/http/constants.ts
 var HTTP_STATUS = {
   /**
@@ -17,8 +31,9 @@ var HTTP_STATUS = {
    */
   LOCKED: 423};
 
-// src/auth/types.ts
-var AUTH_ERROR_CODES = {
+// src/errors/codes.ts
+var ERROR_CODES = {
+  // Authentication
   INVALID_CREDENTIALS: "AUTH_INVALID_CREDENTIALS",
   TOKEN_EXPIRED: "AUTH_TOKEN_EXPIRED",
   TOKEN_INVALID: "AUTH_TOKEN_INVALID",
@@ -90,90 +105,116 @@ var TOKEN_TYPE = /* @__PURE__ */ ((TOKEN_TYPE2) => {
   return TOKEN_TYPE2;
 })(TOKEN_TYPE || {});
 var AUTH_ERROR_DEFINITIONS = {
-  [AUTH_ERROR_CODES.INVALID_CREDENTIALS]: {
+  [ERROR_CODES.INVALID_CREDENTIALS]: {
+    code: ERROR_CODES.INVALID_CREDENTIALS,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Wrong email/password.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.invalid_credentials",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.TOKEN_EXPIRED]: {
+  [ERROR_CODES.TOKEN_EXPIRED]: {
+    code: ERROR_CODES.TOKEN_EXPIRED,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Access/refresh token expired.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.token_expired",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.TOKEN_INVALID]: {
+  [ERROR_CODES.TOKEN_INVALID]: {
+    code: ERROR_CODES.TOKEN_INVALID,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Token signature invalid.",
-    severity: "high",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.token_invalid",
+    severity: ERROR_SEVERITY.High,
     retryable: false
   },
-  [AUTH_ERROR_CODES.TOKEN_REVOKED]: {
+  [ERROR_CODES.TOKEN_REVOKED]: {
+    code: ERROR_CODES.TOKEN_REVOKED,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Token has been revoked.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.token_revoked",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.SESSION_EXPIRED]: {
+  [ERROR_CODES.SESSION_EXPIRED]: {
+    code: ERROR_CODES.SESSION_EXPIRED,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Session no longer valid.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.session_expired",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.MFA_REQUIRED]: {
+  [ERROR_CODES.MFA_REQUIRED]: {
+    code: ERROR_CODES.MFA_REQUIRED,
     status: HTTP_STATUS.FORBIDDEN,
-    // 403 Forbidden is appropriate here
-    message: "MFA verification needed.",
-    severity: "low",
+    category: ERROR_CATEGORY.Authorization,
+    userMessage: "errors.auth.mfa_required",
+    severity: ERROR_SEVERITY.Low,
     retryable: false
   },
-  [AUTH_ERROR_CODES.MFA_INVALID]: {
+  [ERROR_CODES.MFA_INVALID]: {
+    code: ERROR_CODES.MFA_INVALID,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "MFA code incorrect.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.mfa_invalid",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.INSUFFICIENT_PERMISSIONS]: {
+  [ERROR_CODES.INSUFFICIENT_PERMISSIONS]: {
+    code: ERROR_CODES.INSUFFICIENT_PERMISSIONS,
     status: HTTP_STATUS.FORBIDDEN,
-    message: "User lacks required permission.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authorization,
+    userMessage: "errors.auth.insufficient_permissions",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.ROLE_REQUIRED]: {
+  [ERROR_CODES.ROLE_REQUIRED]: {
+    code: ERROR_CODES.ROLE_REQUIRED,
     status: HTTP_STATUS.FORBIDDEN,
-    message: "User lacks required role.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authorization,
+    userMessage: "errors.auth.role_required",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.WALLET_SIGNATURE_INVALID]: {
+  [ERROR_CODES.WALLET_SIGNATURE_INVALID]: {
+    code: ERROR_CODES.WALLET_SIGNATURE_INVALID,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Web3 signature verification failed.",
-    severity: "high",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.wallet_signature_invalid",
+    severity: ERROR_SEVERITY.High,
     retryable: false
   },
-  [AUTH_ERROR_CODES.NONCE_EXPIRED]: {
+  [ERROR_CODES.NONCE_EXPIRED]: {
+    code: ERROR_CODES.NONCE_EXPIRED,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "SIWE nonce has expired.",
-    severity: "medium",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.nonce_expired",
+    severity: ERROR_SEVERITY.Medium,
     retryable: false
   },
-  [AUTH_ERROR_CODES.NONCE_ALREADY_USED]: {
+  [ERROR_CODES.NONCE_ALREADY_USED]: {
+    code: ERROR_CODES.NONCE_ALREADY_USED,
     status: HTTP_STATUS.UNAUTHORIZED,
-    message: "Replay attack detected.",
-    severity: "high",
+    category: ERROR_CATEGORY.Authentication,
+    userMessage: "errors.auth.nonce_already_used",
+    severity: ERROR_SEVERITY.High,
     retryable: false
   },
-  [AUTH_ERROR_CODES.ACCOUNT_LOCKED]: {
+  [ERROR_CODES.ACCOUNT_LOCKED]: {
+    code: ERROR_CODES.ACCOUNT_LOCKED,
     status: HTTP_STATUS.LOCKED,
-    // 423 Locked is perfect for this
-    message: "Too many failed attempts.",
-    severity: "high",
+    category: ERROR_CATEGORY.Authorization,
+    userMessage: "errors.auth.account_locked",
+    severity: ERROR_SEVERITY.High,
     retryable: false
   },
-  [AUTH_ERROR_CODES.ACCOUNT_SUSPENDED]: {
+  [ERROR_CODES.ACCOUNT_SUSPENDED]: {
+    code: ERROR_CODES.ACCOUNT_SUSPENDED,
     status: HTTP_STATUS.FORBIDDEN,
-    message: "Account has been suspended.",
-    severity: "high",
+    category: ERROR_CATEGORY.Authorization,
+    userMessage: "errors.auth.account_suspended",
+    severity: ERROR_SEVERITY.High,
     retryable: false
   }
 };