@plyaz/auth 1.0.0

package/src/common/errors/specific-auth-errors.ts

@@ -0,0 +1,201 @@
+// /**
+//  * @fileoverview Specific authentication error classes for @plyaz/auth
+//  * @module @plyaz/auth/errors/specific-auth-errors
+//  * 
+//  * @description
+//  * Defines specific error classes for different authentication failure scenarios.
+//  * Each error class provides structured error information including error codes,
+//  * HTTP status codes, and localized messages. Used throughout the auth system
+//  * for consistent error handling and user feedback.
+//  * 
+//  * @example
+//  * ```typescript
+//  * import { InvalidCredentialsError, TokenExpiredError } from '@plyaz/auth';
+//  * 
+//  * // Throw specific error
+//  * throw new InvalidCredentialsError('Invalid email or password');
+//  * 
+//  * // Handle specific error
+//  * if (error instanceof TokenExpiredError) {
+//  *   // Refresh token logic
+//  * }
+//  * ```
+//  */
+
+// import { AUTH_ERROR_CODES, ERROR_CODE_TO_HTTP_STATUS } from "@plyaz/types";
+
+
+
+// /**
+//  * Base authentication error class
+//  * Provides common error structure for all auth-related errors
+//  */
+// export abstract class BaseAuthError extends Error {
+//   /** Error code for programmatic handling */
+//   public readonly code: string;
+//   /** HTTP status code for API responses */
+//   public readonly statusCode: number;
+//   /** Additional error context */
+//   public readonly context?: Record<string, styr>;
+
+//   constructor(
+//     message: string,
+//     code: string,
+//     statusCode: number,
+//     context?: Record<string, any>
+//   ) {
+//     super(message);
+//     this.name = this.constructor.name;
+//     this.code = code;
+//     this.statusCode = statusCode;
+//     this.context = context;
+    
+//     // Maintain proper stack trace
+//     if (Error.captureStackTrace) {
+//       Error.captureStackTrace(this, this.constructor);
+//     }
+//   }
+// }
+
+// /**
+//  * Invalid credentials error
+//  * Thrown when email/password combination is incorrect
+//  */
+// export class InvalidCredentialsError extends BaseAuthError {
+//   constructor(message = 'Invalid email or password', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.INVALID_CREDENTIALS,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.INVALID_CREDENTIALS],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Token expired error
+//  * Thrown when access or refresh token has expired
+//  */
+// export class TokenExpiredError extends BaseAuthError {
+//   constructor(message = 'Authentication token has expired', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.TOKEN_EXPIRED,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.TOKEN_EXPIRED],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Token invalid error
+//  * Thrown when token signature is invalid or malformed
+//  */
+// export class TokenInvalidError extends BaseAuthError {
+//   constructor(message = 'Authentication token is invalid', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.TOKEN_INVALID,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.TOKEN_INVALID],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Token revoked error
+//  * Thrown when token has been blacklisted/revoked
+//  */
+// export class TokenRevokedError extends BaseAuthError {
+//   constructor(message = 'Authentication token has been revoked', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.TOKEN_REVOKED,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.TOKEN_REVOKED],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Session expired error
+//  * Thrown when user session is no longer valid
+//  */
+// export class SessionExpiredError extends BaseAuthError {
+//   constructor(message = 'User session has expired', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.SESSION_EXPIRED,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.SESSION_EXPIRED],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Insufficient permissions error
+//  * Thrown when user lacks required permissions for action
+//  */
+// export class InsufficientPermissionsError extends BaseAuthError {
+//   constructor(
+//     resource?: string,
+//     action?: string,
+//     message = 'Insufficient permissions for this action'
+//   ) {
+//     const context = resource && action ? { resource, action } : undefined;
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.INSUFFICIENT_PERMISSIONS,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.INSUFFICIENT_PERMISSIONS],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Role required error
+//  * Thrown when user lacks required role for action
+//  */
+// export class RoleRequiredError extends BaseAuthError {
+//   constructor(requiredRole?: string, message = 'Required role not found') {
+//     const context = requiredRole ? { requiredRole } : undefined;
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.ROLE_REQUIRED,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.ROLE_REQUIRED],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Account locked error
+//  * Thrown when account is locked due to failed attempts
+//  */
+// export class AccountLockedError extends BaseAuthError {
+//   constructor(message = 'Account is locked due to failed attempts', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.ACCOUNT_LOCKED,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.ACCOUNT_LOCKED],
+//       context
+//     );
+//   }
+// }
+
+// /**
+//  * Account suspended error
+//  * Thrown when account has been suspended by admin
+//  */
+// export class AccountSuspendedError extends BaseAuthError {
+//   constructor(message = 'Account has been suspended', context?: Record<string, any>) {
+//     super(
+//       message,
+//       AUTH_ERROR_CODES.ACCOUNT_SUSPENDED,
+//       ERROR_CODE_TO_HTTP_STATUS[AUTH_ERROR_CODES.ACCOUNT_SUSPENDED],
+//       context
+//     );
+//   }
+// }
+
+

package/src/common/index.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Common utilities, types, and constants for @plyaz/auth
+ * @module @plyaz/auth/common
+ */
+
+// // Types
+// export * from "./types";
+
+// // Constants
+// export * from "./constants";
+
+// // Errors
+// export * from "./errors";
+
+// // Regex patterns
+// export * from "./regex";
+
+// Utilities
+export * from "./utils";

package/src/common/regex/index.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Regular expressions for @plyaz/auth
+ * @module @plyaz/auth/regex
+ */
+
+export const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+export const PASSWORD_REGEX = {
+  MIN_LENGTH: /.{8,}/,
+  HAS_UPPERCASE: /[A-Z]/,
+  HAS_LOWERCASE: /[a-z]/,
+  HAS_NUMBER: /\d/,
+  HAS_SPECIAL: /[!@#$%^&*(),.?":{}|<>]/,
+  STRONG: /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[!@#$%^&*(),.?":{}|<>]).{8,}$/
+};
+
+export const PHONE_REGEX = /^\+?[1-9]\d{1,14}$/;
+
+export const USERNAME_REGEX = /^[a-zA-Z0-9_]{3,20}$/;
+
+export const URL_REGEX = /^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)$/;
+
+export const JWT_REGEX = /^[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]*$/;
+
+export const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+export const WALLET_ADDRESS_REGEX = /^0x[a-fA-F0-9]{40}$/;