reqforge 0.5.0 → 0.7.0

package/README.md

@@ -11,22 +11,41 @@ npm install reqforge
 ## Quick Start
 
 ```javascript
-const { config, utils, request, Logger } = require('reqforge');
+const { config, request, auth, errors } = require('reqforge');
 
-// Get the base URL for API requests
-const baseURL = config.getBaseURL();
-console.log(baseURL); // https://api.example.com/v1
-
-// Make a GET request
+// Make a request with error handling
 request.get('/users')
   .then(res => res.json())
-  .then(data => console.log(data));
-
-// Use custom logger
-const logger = new Logger('[MyApp]');
-logger.info('Application started');
+  .then(data => console.log(data))
+  .catch(err => {
+    if (err instanceof errors.NetworkError) {
+      console.error('Network issue:', err.message);
+    }
+  });
 ```
 
+## Error Handling
+
+The `errors` module provides:
+
+- `ReqForgeError` - Base error class
+- `NetworkError` - Network request failures
+- `TimeoutError` - Request timeout errors
+- `AuthError` - Authentication failures
+- `ValidationError` - Validation errors
+- `ErrorCodes` - Error code constants
+- `createErrorFromResponse(response)` - Create error from response
+
+## Authentication
+
+The `auth` module provides:
+
+- `login(username, password)` - Login and store token
+- `logout()` - Logout and clear token
+- `getToken()` - Get current auth token
+- `setToken(token)` - Set auth token manually
+- `isAuthenticated()` - Check if authenticated
+
 ## Request Methods
 
 The `request` module provides:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reqforge",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "A lightweight, flexible HTTP client library with request interception, automatic retry, and logging capabilities, designed for modern web applications.",
   "main": "src/index.js",
   "scripts": {

package/src/auth.js

@@ -0,0 +1,66 @@
+/**
+ * Authentication module for ReqForge
+ * @module auth
+ */
+
+const { sendRequest } = require('./request');
+
+let authToken = null;
+
+/**
+ * Login with username and password
+ * @param {string} username - Username
+ * @param {string} password - Password
+ * @returns {Promise<Object>} Login response with token
+ */
+function login(username, password) {
+  return sendRequest('/login', { username, password }, { method: 'POST' })
+    .then(response => response.json())
+    .then(data => {
+      authToken = data.token;
+      return data;
+    });
+}
+
+/**
+ * Logout and clear auth token
+ * @returns {Promise<void>}
+ */
+function logout() {
+  return sendRequest('/logout', {}, { method: 'POST' })
+    .then(() => {
+      authToken = null;
+    });
+}
+
+/**
+ * Get current auth token
+ * @returns {string|null} Current auth token
+ */
+function getToken() {
+  return authToken;
+}
+
+/**
+ * Set auth token
+ * @param {string} token - Auth token to set
+ */
+function setToken(token) {
+  authToken = token;
+}
+
+/**
+ * Check if user is authenticated
+ * @returns {boolean} True if authenticated
+ */
+function isAuthenticated() {
+  return authToken !== null;
+}
+
+module.exports = {
+  login,
+  logout,
+  getToken,
+  setToken,
+  isAuthenticated
+};

package/src/errors.js

@@ -0,0 +1,97 @@
+/**
+ * Error handling module for ReqForge
+ * @module errors
+ */
+
+/**
+ * Base error class for ReqForge
+ */
+class ReqForgeError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = 'ReqForgeError';
+    this.code = code;
+  }
+}
+
+/**
+ * Network error
+ */
+class NetworkError extends ReqForgeError {
+  constructor(message = 'Network request failed') {
+    super(message, 'NETWORK_ERROR');
+    this.name = 'NetworkError';
+  }
+}
+
+/**
+ * Timeout error
+ */
+class TimeoutError extends ReqForgeError {
+  constructor(message = 'Request timeout') {
+    super(message, 'TIMEOUT_ERROR');
+    this.name = 'TimeoutError';
+  }
+}
+
+/**
+ * Authentication error
+ */
+class AuthError extends ReqForgeError {
+  constructor(message = 'Authentication failed') {
+    super(message, 'AUTH_ERROR');
+    this.name = 'AuthError';
+  }
+}
+
+/**
+ * Validation error
+ */
+class ValidationError extends ReqForgeError {
+  constructor(message = 'Validation failed') {
+    super(message, 'VALIDATION_ERROR');
+    this.name = 'ValidationError';
+  }
+}
+
+/**
+ * Error codes
+ */
+const ErrorCodes = {
+  NETWORK_ERROR: 'NETWORK_ERROR',
+  TIMEOUT_ERROR: 'TIMEOUT_ERROR',
+  AUTH_ERROR: 'AUTH_ERROR',
+  VALIDATION_ERROR: 'VALIDATION_ERROR',
+  UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+};
+
+/**
+ * Create error from response
+ * @param {Response} response - Fetch response
+ * @returns {ReqForgeError} Appropriate error instance
+ */
+function createErrorFromResponse(response) {
+  if (response.status === 401) {
+    return new AuthError('Unauthorized');
+  }
+  if (response.status === 403) {
+    return new AuthError('Forbidden');
+  }
+  if (response.status === 404) {
+    return new NetworkError('Resource not found');
+  }
+  if (response.status >= 500) {
+    return new NetworkError('Server error');
+  }
+  return new ReqForgeError('Request failed', 'REQUEST_ERROR');
+}
+
+module.exports = {
+  ReqForgeError,
+  NetworkError,
+  TimeoutError,
+  AuthError,
+  ValidationError,
+  ErrorCodes,
+  createErrorFromResponse
+};

package/src/index.js

@@ -7,10 +7,14 @@ const config = require('./config');
 const utils = require('./utils');
 const request = require('./request');
 const Logger = require('./logger');
+const auth = require('./auth');
+const errors = require('./errors');
 
 module.exports = {
   config,
   utils,
   request,
-  Logger
+  Logger,
+  auth,
+  errors
 };