create-request 0.0.1-beta.23 → 0.0.1-beta.24

package/dist/library/requestFactories.d.ts

@@ -3,87 +3,89 @@ import { GetRequest, PostRequest, PutRequest, DeleteRequest, PatchRequest, HeadR
  * Create a GET request
  * Used for retrieving resources from the server.
  *
+ * @param url - The URL to send the request to
  * @returns A new GET request instance
  *
  * @example
- * const users = await get()
- *   .withQueryParams({ limit: 10 })
- *   .sendTo('/api/users')
- *   .getJson();
+ * const request = get('/api/users')
+ *   .withQueryParams({ limit: 10 });
+ * const users = await request.getData();
  */
-export declare function get(): GetRequest;
+export declare function get(url: string): GetRequest;
 /**
  * Create a POST request
  * Used for creating new resources or submitting data.
  *
+ * @param url - The URL to send the request to
  * @returns A new POST request instance
  *
  * @example
- * const newUser = await post()
- *   .withJson({ name: 'John', email: 'john@example.com' })
- *   .sendTo('/api/users')
- *   .getJson();
+ * const request = post('/api/users')
+ *   .withJson({ name: 'John', email: 'john@example.com' });
+ * const newUser = await request.getData();
  */
-export declare function post(): PostRequest;
+export declare function post(url: string): PostRequest;
 /**
  * Create a PUT request
  * Used for replacing or updating an existing resource.
  *
+ * @param url - The URL to send the request to
  * @returns A new PUT request instance
  *
  * @example
- * const updatedUser = await put()
- *   .withJson({ name: 'John Updated', email: 'john@example.com' })
- *   .sendTo('/api/users/123')
- *   .getJson();
+ * const request = put('/api/users/123')
+ *   .withJson({ name: 'John Updated', email: 'john@example.com' });
+ * const updatedUser = await request.getData();
  */
-export declare function put(): PutRequest;
+export declare function put(url: string): PutRequest;
 /**
  * Create a DELETE request
  * Used for removing resources from the server.
  *
+ * @param url - The URL to send the request to
  * @returns A new DELETE request instance
  *
  * @example
- * await del()
- *   .sendTo('/api/users/123')
- *   .getJson();
+ * const request = del('/api/users/123');
+ * await request.getData();
  */
-export declare function del(): DeleteRequest;
+export declare function del(url: string): DeleteRequest;
 /**
  * Create a PATCH request
  * Used for applying partial modifications to a resource.
  *
+ * @param url - The URL to send the request to
  * @returns A new PATCH request instance
  *
  * @example
- * const patchedUser = await patch()
- *   .withJson({ status: 'active' })
- *   .sendTo('/api/users/123')
- *   .getJson();
+ * const request = patch('/api/users/123')
+ *   .withJson({ status: 'active' });
+ * const patchedUser = await request.getData();
  */
-export declare function patch(): PatchRequest;
+export declare function patch(url: string): PatchRequest;
 /**
  * Create a HEAD request
  * Similar to GET but returns only headers without a body.
  *
+ * @param url - The URL to send the request to
  * @returns A new HEAD request instance
  *
  * @example
- * const response = await head()
- *   .sendTo('/api/users/123');
+ * const request = head('/api/users/123');
+ * const response = await request.getResponse();
  * console.log(response.headers.get('Last-Modified'));
  */
-export declare function head(): HeadRequest;
+export declare function head(url: string): HeadRequest;
 /**
  * Create an OPTIONS request
  * Used to describe the communication options for a resource.
  *
+ * @param url - The URL to send the request to
  * @returns A new OPTIONS request instance
  *
  * @example
- * const response = await options()
- *   .sendTo('/api/users');
+ * const request = options('/api/users');
+ * const response = await request.getResponse();
  * console.log(response.headers.get('Allow'));
  */
-export declare function options(): OptionsRequest;
+export declare function options(url: string): OptionsRequest;

package/dist/library/requestMethods.d.ts

@@ -6,79 +6,86 @@ import { HttpMethod } from "./enums.js";
  * Used for retrieving data from an API endpoint.
  *
  * @example
- * const request = new GetRequest()
- *   .withQueryParams({ id: '123' })
- *   .sendTo('/api/users');
+ * const request = new GetRequest('/api/users')
+ *   .withQueryParams({ id: '123' });
+ * const data = await request.getData();
  */
 export declare class GetRequest extends BaseRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }
 /**
  * HTTP HEAD request implementation
  * Similar to GET but returns only headers without a response body.
  *
  * @example
- * const request = new HeadRequest()
- *   .sendTo('/api/users/123');
+ * const request = new HeadRequest('/api/users/123');
+ * const response = await request.getResponse();
  */
 export declare class HeadRequest extends BaseRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }
 /**
  * HTTP OPTIONS request implementation
  * Used to describe the communication options for the target resource.
  *
  * @example
- * const request = new OptionsRequest()
- *   .sendTo('/api/users');
+ * const request = new OptionsRequest('/api/users');
+ * const response = await request.getResponse();
  */
 export declare class OptionsRequest extends BaseRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }
 /**
  * HTTP DELETE request implementation
  * Used to delete a resource on the server.
  *
  * @example
- * const request = new DeleteRequest()
- *   .sendTo('/api/users/123');
+ * const request = new DeleteRequest('/api/users/123');
+ * await request.getData();
  */
 export declare class DeleteRequest extends BaseRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }
 /**
  * HTTP POST request implementation
  * Used to create a new resource or submit data for processing.
  *
  * @example
- * const request = new PostRequest()
- *   .withJson({ name: 'John', email: 'john@example.com' })
- *   .sendTo('/api/users');
+ * const request = new PostRequest('/api/users')
+ *   .withJson({ name: 'John', email: 'john@example.com' });
+ * const data = await request.getData();
  */
 export declare class PostRequest extends BodyRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }
 /**
  * HTTP PUT request implementation
  * Used to replace or update an existing resource.
  *
  * @example
- * const request = new PutRequest()
- *   .withJson({ id: '123', name: 'John', email: 'john@example.com' })
- *   .sendTo('/api/users/123');
+ * const request = new PutRequest('/api/users/123')
+ *   .withJson({ id: '123', name: 'John', email: 'john@example.com' });
+ * const data = await request.getData();
  */
 export declare class PutRequest extends BodyRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }
 /**
  * HTTP PATCH request implementation
  * Used to apply partial modifications to a resource.
  *
  * @example
- * const request = new PatchRequest()
- *   .withJson({ email: 'new.email@example.com' })
- *   .sendTo('/api/users/123');
+ * const request = new PatchRequest('/api/users/123')
+ *   .withJson({ email: 'new.email@example.com' });
+ * const data = await request.getData();
  */
 export declare class PatchRequest extends BodyRequest {
     protected method: HttpMethod;
+    constructor(url: string);
 }

package/dist/library/types.d.ts

@@ -1,10 +1,49 @@
-import { HttpMethod, RequestPriority, CredentialsPolicy, RequestMode, RedirectMode, CacheMode, SameSitePolicy } from "./enums";
+import { HttpMethod, RequestPriority, CredentialsPolicy, RequestMode, RedirectMode, SameSitePolicy } from "./enums";
 import type { RequestError } from "./RequestError.js";
+import type { ResponseWrapper } from "./ResponseWrapper.js";
 export type Body = null | Blob | string | object | FormData | ArrayBuffer | URLSearchParams | ReadableStream;
 export type RetryCallback = (options: {
     attempt: number;
     error: RequestError;
 }) => void | Promise<void>;
+/**
+ * Configuration object passed to request interceptors
+ * Contains all the information needed to make the request
+ */
+export interface RequestConfig {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: Body;
+    signal?: AbortSignal;
+    credentials?: RequestCredentials;
+    mode?: RequestMode | string;
+    redirect?: RedirectMode | string;
+    referrer?: string;
+    referrerPolicy?: ReferrerPolicy;
+    keepalive?: boolean;
+    priority?: RequestPriority | string;
+}
+/**
+ * Request interceptor that can modify the request configuration or return an early response
+ * If it returns a Response, the request will be short-circuited and that response will be used
+ * @param config - The request configuration
+ * @returns Modified config, a Response to short-circuit, or a Promise of either
+ */
+export type RequestInterceptor = (config: RequestConfig) => RequestConfig | Response | Promise<RequestConfig | Response>;
+/**
+ * Response interceptor that can transform the response
+ * @param response - The response wrapper
+ * @returns Modified response wrapper or a Promise of it
+ */
+export type ResponseInterceptor = (response: ResponseWrapper) => ResponseWrapper | Promise<ResponseWrapper>;
+/**
+ * Error interceptor that can handle or transform errors
+ * Can return a ResponseWrapper to recover from the error
+ * @param error - The error that occurred
+ * @returns Modified error, a ResponseWrapper to recover, or a Promise of either
+ */
+export type ErrorInterceptor = (error: RequestError) => RequestError | ResponseWrapper | Promise<RequestError | ResponseWrapper>;
 export interface CookieOptions {
     value: string;
     secure?: boolean;
@@ -16,12 +55,12 @@ export interface CookieOptions {
     maxAge?: number;
 }
 export type CookiesRecord = Record<string, string | CookieOptions>;
-export { CacheMode, HttpMethod, RequestMode, RedirectMode, SameSitePolicy, RequestPriority, CredentialsPolicy };
-export interface RequestOptions extends Omit<RequestInit, "signal" | "body" | "method" | "credentials" | "mode" | "redirect" | "cache" | "priority"> {
+export { HttpMethod, RequestMode, RedirectMode, SameSitePolicy, RequestPriority, CredentialsPolicy };
+export interface RequestOptions extends Omit<RequestInit, "signal" | "body" | "method" | "credentials" | "mode" | "redirect" | "priority"> {
     timeout?: number;
     retries?: number;
     onRetry?: RetryCallback;
-    body?: any;
+    body?: Body;
     credentials?: CredentialsPolicy | RequestCredentials;
     mode?: RequestMode;
     redirect?: RedirectMode | RequestRedirect;

package/dist/library/utils/Config.d.ts

@@ -1,3 +1,4 @@
+import type { RequestInterceptor, ResponseInterceptor, ErrorInterceptor } from "../types.js";
 /**
  * Global configuration for create-request
  */
@@ -9,6 +10,10 @@ export declare class Config {
     private csrfToken;
     private enableAutoXsrf;
     private enableAntiCsrf;
+    private requestInterceptors;
+    private responseInterceptors;
+    private errorInterceptors;
+    private nextInterceptorId;
     private constructor();
     /**
      * Get the singleton instance of the Config class
@@ -113,6 +118,97 @@ export declare class Config {
      * @returns True if anti-CSRF protection is enabled
      */
     isAntiCsrfEnabled(): boolean;
+    /**
+     * Add a global request interceptor
+     * Request interceptors can modify the request configuration or return an early response
+     *
+     * @param interceptor - The request interceptor function
+     * @returns The interceptor ID for later removal
+     *
+     * @example
+     * const id = Config.getInstance().addRequestInterceptor((config) => {
+     *   config.headers['X-Custom'] = 'value';
+     *   return config;
+     * });
+     */
+    addRequestInterceptor(interceptor: RequestInterceptor): number;
+    /**
+     * Add a global response interceptor
+     * Response interceptors can transform the response
+     *
+     * @param interceptor - The response interceptor function
+     * @returns The interceptor ID for later removal
+     *
+     * @example
+     * const id = Config.getInstance().addResponseInterceptor((response) => {
+     *   console.log('Response received:', response.status);
+     *   return response;
+     * });
+     */
+    addResponseInterceptor(interceptor: ResponseInterceptor): number;
+    /**
+     * Add a global error interceptor
+     * Error interceptors can handle or transform errors
+     *
+     * @param interceptor - The error interceptor function
+     * @returns The interceptor ID for later removal
+     *
+     * @example
+     * const id = Config.getInstance().addErrorInterceptor((error) => {
+     *   console.error('Request failed:', error);
+     *   throw error;
+     * });
+     */
+    addErrorInterceptor(interceptor: ErrorInterceptor): number;
+    /**
+     * Remove a request interceptor by its ID
+     *
+     * @param id - The interceptor ID returned from addRequestInterceptor
+     *
+     * @example
+     * Config.getInstance().removeRequestInterceptor(id);
+     */
+    removeRequestInterceptor(id: number): void;
+    /**
+     * Remove a response interceptor by its ID
+     *
+     * @param id - The interceptor ID returned from addResponseInterceptor
+     *
+     * @example
+     * Config.getInstance().removeResponseInterceptor(id);
+     */
+    removeResponseInterceptor(id: number): void;
+    /**
+     * Remove an error interceptor by its ID
+     *
+     * @param id - The interceptor ID returned from addErrorInterceptor
+     *
+     * @example
+     * Config.getInstance().removeErrorInterceptor(id);
+     */
+    removeErrorInterceptor(id: number): void;
+    /**
+     * Clear all interceptors (request, response, and error)
+     *
+     * @example
+     * Config.getInstance().clearInterceptors();
+     */
+    clearInterceptors(): void;
+    /**
+     * Get all global request interceptors (in registration order)
+     * @internal
+     */
+    getRequestInterceptors(): RequestInterceptor[];
+    /**
+     * Get all global response interceptors (in registration order)
+     * @internal
+     */
+    getResponseInterceptors(): ResponseInterceptor[];
+    /**
+     * Get all global error interceptors (in registration order)
+     * @internal
+     */
+    getErrorInterceptors(): ErrorInterceptor[];
     /**
      * Reset all configuration options to their default values
      *

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "create-request",
-  "version": "0.0.1-beta.23",
+  "version": "0.0.1-beta.24",
   "description": "A modern, chainable wrapper for fetch with automatic retries, timeouts, comprehensive error handling, and first-class TypeScript support",
-  "main": "dist/library/index.js",
+  "main": "dist/library/index.cjs",
   "module": "dist/library/index.esm.js",
   "types": "dist/library/index.d.ts",
   "sideEffects": false,
@@ -17,8 +17,8 @@
         "production": "./dist/library/index.esm.min.js"
       },
       "require": {
-        "default": "./dist/library/index.js",
-        "production": "./dist/library/index.min.js"
+        "default": "./dist/library/index.cjs",
+        "production": "./dist/library/index.min.cjs"
       },
       "types": "./dist/library/index.d.ts"
     }
@@ -26,20 +26,16 @@
   "scripts": {
     "dev": "cross-env BUILD_ENV=development rollup -c rollup.config.js -w",
     "build": "cross-env BUILD_ENV=production rollup -c rollup.config.js",
-    "build:min": "cross-env BUILD_ENV=production MINIFY=true rollup -c rollup.config.js",
-    "build:all": "npm run build && npm run build:min",
     "analyze": "cross-env ANALYZE=true BUILD_ENV=production rollup -c rollup.config.js",
-    "analyze:min": "cross-env ANALYZE=true MINIFY=true BUILD_ENV=production rollup -c rollup.config.js",
     "lint": "eslint 'src/**/*.{js,ts,json}' 'test/**/*.{js,ts,json}'",
     "lint:fix": "eslint \"**/*.ts\" --ignore-path .eslintignore --fix",
     "format": "prettier --write \"**/*.{ts,js,json}\"",
-    "check": "concurrently \"npm run lint\" \"npm run test\" \"npx size-limit\"",
+    "check": "concurrently \"npm run lint\" \"npm run test\" \"npm run check:size\"",
     "check:size": "npx size-limit",
-    "pretest": "tsc -p tsconfig.test.json",
-    "test": "node --test",
-    "test:coverage": "npm run test -- --experimental-test-coverage",
+    "test": "node --import tsx --test test/**/*.test.ts",
+    "test:coverage": "node --import tsx --experimental-test-coverage --test test/**/*.test.ts",
     "preversion": "npm run check",
-    "prepublishOnly": "npm run build:all",
+    "prepublishOnly": "npm run build",
     "publish:beta": "npm version prerelease --preid=beta && git push origin --tags && npm publish --tag latest",
     "disabled:publish:patch": "npm version patch && git push origin --tags && npm publish",
     "disabled:publish:minor": "npm version minor && git push origin --tags && npm publish",
@@ -55,6 +51,9 @@
   ],
   "author": "Daniel Amenou <amenou.daniel@gmail.com>",
   "license": "MIT",
+  "engines": {
+    "node": ">=18.3.0"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/DanielAmenou/create-request.git"
@@ -67,7 +66,7 @@
       "name": "ESM Standard"
     },
     {
-      "path": "dist/library/index.js",
+      "path": "dist/library/index.cjs",
       "limit": "6 KB",
       "gzip": true,
       "name": "CJS Standard"
@@ -79,7 +78,7 @@
       "name": "ESM Minified"
     },
     {
-      "path": "dist/library/index.min.js",
+      "path": "dist/library/index.min.cjs",
       "limit": "6 KB",
       "gzip": true,
       "name": "CJS Minified"
@@ -100,14 +99,15 @@
     "eslint-config-prettier": "^9.1.0",
     "eslint-import-resolver-typescript": "^3.6.1",
     "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-prettier": "^5.0.1",
     "eslint-plugin-jsonc": "^2.11.0",
+    "eslint-plugin-prettier": "^5.0.1",
     "prettier": "^3.1.1",
     "rollup": "^2.75.5",
     "rollup-plugin-cleaner": "^1.0.0",
     "rollup-plugin-visualizer": "^5.9.2",
     "size-limit": "^8.2.6",
     "tslib": "^2.4.0",
+    "tsx": "^4.20.6",
     "typescript": "^4.7.3",
     "undici": "^5.28.5"
   }