reqforge 0.1.0 → 0.3.0

package/.claude/settings.local.json

@@ -7,7 +7,8 @@
       "Bash(git add *)",
       "Bash(git commit *)",
       "Bash(git push *)",
-      "Bash(npm publish *)"
+      "Bash(npm publish *)",
+      "Bash(npm view *)"
     ]
   }
 }

package/README.md

@@ -8,6 +8,40 @@ A lightweight, flexible HTTP client library with request interception, automatic
 npm install reqforge
 ```
 
+## Quick Start
+
+```javascript
+const { config, utils } = require('reqforge');
+
+// Get the base URL for API requests
+const baseURL = config.getBaseURL();
+console.log(baseURL); // https://api.example.com/v1
+
+// Build URL with query parameters
+const url = utils.buildURL('https://api.example.com/v1/users', { page: 1, limit: 10 });
+console.log(url); // https://api.example.com/v1/users?page=1&limit=10
+```
+
+## Configuration
+
+The `config` module provides:
+
+- `getBaseURL()` - Get the base URL for API requests
+- `API_VERSION` - Current API version
+- `defaultConfig` - Default configuration object
+- `mergeConfig(customConfig)` - Merge custom configuration with defaults
+
+## Utilities
+
+The `utils` module provides:
+
+- `buildURL(baseURL, params)` - Build URL with query parameters
+- `serializeQuery(obj)` - Serialize object to query string
+- `parseQuery(queryString)` - Parse query string to object
+- `deepMerge(target, source)` - Deep merge objects
+- `isPlainObject(value)` - Check if value is a plain object
+- `delay(ms)` - Delay execution
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reqforge",
-  "version": "0.1.0",
+  "version": "0.3.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/config.js

@@ -0,0 +1,48 @@
+/**
+ * Configuration module for ReqForge
+ * @module config
+ */
+
+const API_VERSION = 'v1';
+
+/**
+ * Get the base URL for API requests
+ * @returns {string} The base URL with API version
+ */
+function getBaseURL() {
+  return `https://api.example.com/${API_VERSION}`;
+}
+
+/**
+ * Default configuration for requests
+ */
+const defaultConfig = {
+  baseURL: getBaseURL(),
+  timeout: 5000,
+  headers: {
+    'Content-Type': 'application/json'
+  }
+};
+
+/**
+ * Merge custom configuration with defaults
+ * @param {Object} customConfig - Custom configuration to merge
+ * @returns {Object} Merged configuration
+ */
+function mergeConfig(customConfig = {}) {
+  return {
+    ...defaultConfig,
+    ...customConfig,
+    headers: {
+      ...defaultConfig.headers,
+      ...(customConfig.headers || {})
+    }
+  };
+}
+
+module.exports = {
+  getBaseURL,
+  API_VERSION,
+  defaultConfig,
+  mergeConfig
+};

package/src/index.js

@@ -3,4 +3,10 @@
  * @module reqforge
  */
 
-module.exports = {};
+const config = require('./config');
+const utils = require('./utils');
+
+module.exports = {
+  config,
+  utils
+};

package/src/utils.js

@@ -0,0 +1,91 @@
+/**
+ * Utility functions for ReqForge
+ * @module utils
+ */
+
+/**
+ * Build URL with query parameters
+ * @param {string} baseURL - The base URL
+ * @param {Object} params - Query parameters
+ * @returns {string} URL with query string
+ */
+function buildURL(baseURL, params = {}) {
+  const url = new URL(baseURL);
+  Object.keys(params).forEach(key => {
+    if (params[key] !== undefined && params[key] !== null) {
+      url.searchParams.append(key, params[key]);
+    }
+  });
+  return url.toString();
+}
+
+/**
+ * Serialize object to query string
+ * @param {Object} obj - Object to serialize
+ * @returns {string} Query string
+ */
+function serializeQuery(obj) {
+  return Object.keys(obj)
+    .filter(key => obj[key] !== undefined && obj[key] !== null)
+    .map(key => `${encodeURIComponent(key)}=${encodeURIComponent(obj[key])}`)
+    .join('&');
+}
+
+/**
+ * Parse query string to object
+ * @param {string} queryString - Query string to parse
+ * @returns {Object} Parsed query object
+ */
+function parseQuery(queryString) {
+  const params = {};
+  const searchParams = new URLSearchParams(queryString);
+  searchParams.forEach((value, key) => {
+    params[key] = value;
+  });
+  return params;
+}
+
+/**
+ * Deep merge objects
+ * @param {Object} target - Target object
+ * @param {Object} source - Source object
+ * @returns {Object} Merged object
+ */
+function deepMerge(target, source) {
+  const result = { ...target };
+  Object.keys(source).forEach(key => {
+    if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+      result[key] = deepMerge(result[key] || {}, source[key]);
+    } else {
+      result[key] = source[key];
+    }
+  });
+  return result;
+}
+
+/**
+ * Check if value is a plain object
+ * @param {*} value - Value to check
+ * @returns {boolean} True if plain object
+ */
+function isPlainObject(value) {
+  return Object.prototype.toString.call(value) === '[object Object]';
+}
+
+/**
+ * Delay execution
+ * @param {number} ms - Milliseconds to delay
+ * @returns {Promise} Promise that resolves after delay
+ */
+function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+module.exports = {
+  buildURL,
+  serializeQuery,
+  parseQuery,
+  deepMerge,
+  isPlainObject,
+  delay
+};