curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123",
    "name": "John Doe"
  }'

const response = await fetch('<API_ENDPOINT>/api/v1/platform/auth/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'SecurePass123',
    name: 'John Doe',
  }),
});

const data = await response.json();

{
  "success": true,
  "message": "Registration successful. Please check your email to verify your account.",
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "name": "John Doe",
    "emailVerified": false,
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123"
  }'

const response = await fetch('<API_ENDPOINT>/api/v1/platform/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'SecurePass123',
  }),
});

const { token, refreshToken, user } = await response.json();

// Store tokens securely
localStorage.setItem('token', token);
localStorage.setItem('refreshToken', refreshToken);

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 900,
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "name": "John Doe",
    "emailVerified": true
  }
}

{
  "success": true,
  "requires2FA": true,
  "tempToken": "temp_abc123xyz",
  "message": "Two-factor authentication required"
}

curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/logout" \
  -H "Authorization: Bearer your_jwt_token"

{
  "success": true,
  "message": "Logged out successfully"
}

curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/refresh-token" \
  -H "Content-Type: application/json" \
  -d '{
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }'

async function refreshAccessToken() {
  const refreshToken = localStorage.getItem('refreshToken');

  const response = await fetch(
    '<API_ENDPOINT>/api/v1/platform/auth/refresh-token',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ refreshToken }),
    }
  );

  const data = await response.json();

  if (data.success) {
    localStorage.setItem('token', data.token);
    return data.token;
  }

  // Refresh token expired, redirect to login
  window.location.href = '/login';
}

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 900
}

curl -X GET "<API_ENDPOINT>/api/v1/platform/auth/verify-token" \
  -H "Authorization: Bearer your_jwt_token"

{
  "success": true,
  "valid": true,
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "name": "John Doe"
  },
  "expiresAt": "2024-01-15T11:00:00.000Z"
}

curl -X GET "<API_ENDPOINT>/api/v1/platform/auth/verify-email?token=verification_token_here"

{
  "success": true,
  "message": "Email verified successfully"
}

curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/resend-verification" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com"
  }'

{
  "success": true,
  "message": "Verification email sent"
}

curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/password-reset/request" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com"
  }'

{
  "success": true,
  "message": "If an account with this email exists, a password reset link has been sent."
}

curl -X POST "<API_ENDPOINT>/api/v1/platform/auth/password-reset/confirm" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "reset_token_from_email",
    "password": "NewSecurePass123"
  }'

{
  "success": true,
  "message": "Password reset successfully"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email format"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_CREDENTIALS",
    "message": "Invalid email or password"
  }
}

{
  "success": false,
  "error": {
    "code": "EMAIL_NOT_VERIFIED",
    "message": "Please verify your email before logging in"
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many attempts. Please try again later.",
    "retryAfter": 900
  }
}