@plyaz/types 1.27.3 → 1.27.4

package/dist/auth/enums.d.ts

@@ -110,86 +110,114 @@ export declare enum TOKEN_TYPE {
 }
 export declare const AUTH_ERROR_DEFINITIONS: {
     readonly AUTH_INVALID_CREDENTIALS: {
+        readonly code: "AUTH_INVALID_CREDENTIALS";
         readonly status: 401;
-        readonly message: "Wrong email/password.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.invalid_credentials";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_TOKEN_EXPIRED: {
+        readonly code: "AUTH_TOKEN_EXPIRED";
         readonly status: 401;
-        readonly message: "Access/refresh token expired.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.token_expired";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_TOKEN_INVALID: {
+        readonly code: "AUTH_TOKEN_INVALID";
         readonly status: 401;
-        readonly message: "Token signature invalid.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.token_invalid";
         readonly severity: "high";
         readonly retryable: false;
     };
     readonly AUTH_TOKEN_REVOKED: {
+        readonly code: "AUTH_TOKEN_REVOKED";
         readonly status: 401;
-        readonly message: "Token has been revoked.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.token_revoked";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_SESSION_EXPIRED: {
+        readonly code: "AUTH_SESSION_EXPIRED";
         readonly status: 401;
-        readonly message: "Session no longer valid.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.session_expired";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_MFA_REQUIRED: {
+        readonly code: "AUTH_MFA_REQUIRED";
         readonly status: 403;
-        readonly message: "MFA verification needed.";
+        readonly category: "authorization";
+        readonly userMessage: "errors.auth.mfa_required";
         readonly severity: "low";
         readonly retryable: false;
     };
     readonly AUTH_MFA_INVALID: {
+        readonly code: "AUTH_MFA_INVALID";
         readonly status: 401;
-        readonly message: "MFA code incorrect.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.mfa_invalid";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_INSUFFICIENT_PERMISSIONS: {
+        readonly code: "AUTH_INSUFFICIENT_PERMISSIONS";
         readonly status: 403;
-        readonly message: "User lacks required permission.";
+        readonly category: "authorization";
+        readonly userMessage: "errors.auth.insufficient_permissions";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_ROLE_REQUIRED: {
+        readonly code: "AUTH_ROLE_REQUIRED";
         readonly status: 403;
-        readonly message: "User lacks required role.";
+        readonly category: "authorization";
+        readonly userMessage: "errors.auth.role_required";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_WALLET_SIGNATURE_INVALID: {
+        readonly code: "AUTH_WALLET_SIGNATURE_INVALID";
         readonly status: 401;
-        readonly message: "Web3 signature verification failed.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.wallet_signature_invalid";
         readonly severity: "high";
         readonly retryable: false;
     };
     readonly AUTH_NONCE_EXPIRED: {
+        readonly code: "AUTH_NONCE_EXPIRED";
         readonly status: 401;
-        readonly message: "SIWE nonce has expired.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.nonce_expired";
         readonly severity: "medium";
         readonly retryable: false;
     };
     readonly AUTH_NONCE_ALREADY_USED: {
+        readonly code: "AUTH_NONCE_ALREADY_USED";
         readonly status: 401;
-        readonly message: "Replay attack detected.";
+        readonly category: "authentication";
+        readonly userMessage: "errors.auth.nonce_already_used";
         readonly severity: "high";
         readonly retryable: false;
     };
     readonly AUTH_ACCOUNT_LOCKED: {
+        readonly code: "AUTH_ACCOUNT_LOCKED";
         readonly status: 423;
-        readonly message: "Too many failed attempts.";
+        readonly category: "authorization";
+        readonly userMessage: "errors.auth.account_locked";
         readonly severity: "high";
         readonly retryable: false;
     };
     readonly AUTH_ACCOUNT_SUSPENDED: {
+        readonly code: "AUTH_ACCOUNT_SUSPENDED";
         readonly status: 403;
-        readonly message: "Account has been suspended.";
+        readonly category: "authorization";
+        readonly userMessage: "errors.auth.account_suspended";
         readonly severity: "high";
         readonly retryable: false;
     };

package/dist/auth/index.cjs

@@ -4,6 +4,20 @@ var zod = require('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 = {
   /**
@@ -19,8 +33,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",
@@ -92,90 +107,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
   }
 };