create-request 0.0.1-beta.2 → 0.0.1-beta.4

package/dist/library/BaseRequest.d.ts

@@ -1,11 +1,12 @@
 import { type HttpMethod, type RedirectMode, type RequestMode, type RequestPriority, CredentialsPolicy } from "./enums";
 import { type ResponsePromise } from "./ResponseWrapper";
-import type { RequestOptions, RetryCallback } from "./types";
+import type { RequestOptions, RetryCallback, CookiesRecord, CookieOptions } from "./types";
 export declare abstract class BaseRequest {
     protected abstract method: HttpMethod;
     protected requestOptions: RequestOptions;
     protected abortController?: AbortController;
     protected queryParams: URLSearchParams;
+    protected autoApplyCsrfProtection: boolean;
     constructor();
     withHeaders(headers: Record<string, string>): this;
     withTimeout(timeout: number): this;
@@ -93,10 +94,35 @@ export declare abstract class BaseRequest {
     withBearerToken(token: string): this;
     /**
      * Sets cookies for the request
-     * @param cookies - An object containing cookie name-value pairs
+     * @param cookies Object containing cookie name-value pairs or cookie options
      * @returns The instance for chaining
      */
-    withCookies(cookies: Record<string, string>): this;
+    withCookies(cookies: CookiesRecord): this;
+    /**
+     * Set a single cookie
+     * @param name Cookie name
+     * @param value Cookie value or options object
+     * @returns The instance for chaining
+     */
+    withCookie(name: string, value: string | CookieOptions): this;
+    /**
+     * Sets a CSRF token in the request headers
+     * @param token The CSRF token
+     * @param headerName The name of the header to use (default: X-CSRF-Token)
+     * @returns The instance for chaining
+     */
+    withCsrfToken(token: string, headerName?: string): this;
+    /**
+     * Disables automatic anti-CSRF protection.
+     * By default, X-Requested-With: XMLHttpRequest header is sent with all requests.
+     * @returns The instance for chaining
+     */
+    withoutCsrfProtection(): this;
+    /**
+     * Sets common security headers to help prevent CSRF attacks
+     * @returns The instance for chaining
+     */
+    withAntiCsrfHeaders(): this;
     /**
      * Send the request to the specified URL
      * @param url The URL to send the request to

package/dist/library/BodyRequest.d.ts

@@ -1,8 +1,21 @@
 import { BaseRequest } from "./BaseRequest";
 import type { Body } from "./types";
+/**
+ * Base class for requests that can have a body (POST, PUT, PATCH)
+ */
 export declare abstract class BodyRequest extends BaseRequest {
+    protected body?: Body;
+    private bodyProcessed;
+    private bodyType?;
     /**
-     * Sets the request body with appropriate content type handling
+     * Sets the body of the request
+     * @param body - The request body
      */
     withBody(body: Body): this;
+    private setContentTypeIfNeeded;
+    /**
+     * Send the request to the specified URL
+     * Overrides the base implementation to add body handling
+     */
+    sendTo(url: string): ReturnType<BaseRequest["sendTo"]>;
 }

package/dist/library/ResponseWrapper.d.ts

@@ -24,31 +24,42 @@ export declare class ResponseWrapper {
     /**
      * Parse response as JSON
      */
-    json<T = unknown>(): Promise<T>;
+    getJson<T = unknown>(): Promise<T>;
     /**
      * Get response as text
      */
-    text(): Promise<string>;
+    getText(): Promise<string>;
     /**
      * Get response as Blob
      */
-    blob(): Promise<Blob>;
+    getBlob(): Promise<Blob>;
     /**
      * Get response as ArrayBuffer
      */
-    arrayBuffer(): Promise<ArrayBuffer>;
+    getArrayBuffer(): Promise<ArrayBuffer>;
     /**
-     * Get response as ReadableStream
+     * Get response as ReadableStream for true streaming consumption.
+     * This allows you to process data incrementally as it arrives.
+     *
+     * @example
+     * const stream = await request.sendTo('https://example.com/large-file').getBody();
+     * const reader = stream.getReader();
+     *
+     * while (true) {
+     *   const { done, value } = await reader.read();
+     *   if (done) break;
+     *   // Process chunk of data in 'value'
+     * }
      */
-    body(): ReadableStream<Uint8Array> | null;
+    getBody(): ReadableStream<Uint8Array> | null;
 }
 /**
  * Type for Promise with response data transformation methods
  */
 export interface ResponsePromise<T = ResponseWrapper> extends Promise<T> {
-    json<R = unknown>(): Promise<R>;
-    text(): Promise<string>;
-    blob(): Promise<Blob>;
-    arrayBuffer(): Promise<ArrayBuffer>;
-    body(): Promise<ReadableStream<Uint8Array> | null>;
+    getJson<R = unknown>(): Promise<R>;
+    getText(): Promise<string>;
+    getBlob(): Promise<Blob>;
+    getArrayBuffer(): Promise<ArrayBuffer>;
+    getBody(): Promise<ReadableStream<Uint8Array> | null>;
 }

package/dist/library/enums.d.ts

@@ -3,28 +3,28 @@
  */
 export declare enum HttpMethod {
     GET = "GET",
-    POST = "POST",
     PUT = "PUT",
-    DELETE = "DELETE",
-    PATCH = "PATCH",
+    POST = "POST",
     HEAD = "HEAD",
+    PATCH = "PATCH",
+    DELETE = "DELETE",
     OPTIONS = "OPTIONS"
 }
 /**
  * Enum for request priorities
  */
 export declare enum RequestPriority {
-    HIGH = "high",
     LOW = "low",
+    HIGH = "high",
     AUTO = "auto"
 }
 /**
  * Enum for credentials policies
  */
 export declare enum CredentialsPolicy {
+    OMIT = "omit",
     INCLUDE = "include",
-    SAME_ORIGIN = "same-origin",
-    OMIT = "omit"
+    SAME_ORIGIN = "same-origin"
 }
 /**
  * Enum for request modes
@@ -39,8 +39,8 @@ export declare enum RequestMode {
  * Enum for redirect modes
  */
 export declare enum RedirectMode {
-    FOLLOW = "follow",
     ERROR = "error",
+    FOLLOW = "follow",
     MANUAL = "manual"
 }
 /**
@@ -48,9 +48,25 @@ export declare enum RedirectMode {
  */
 export declare enum CacheMode {
     DEFAULT = "default",
-    NO_STORE = "no-store",
     RELOAD = "reload",
+    NO_STORE = "no-store",
     NO_CACHE = "no-cache",
     FORCE_CACHE = "force-cache",
     ONLY_IF_CACHED = "only-if-cached"
 }
+/**
+ * Enum for cookie SameSite policies
+ */
+export declare enum SameSitePolicy {
+    LAX = "Lax",
+    NONE = "None",
+    STRICT = "Strict"
+}
+/**
+ * Enum for body types
+ */
+export declare enum BodyType {
+    JSON = "json",
+    STRING = "string",
+    BINARY = "binary"
+}

package/dist/library/index.d.ts

@@ -1,8 +1,10 @@
 import { get, put, head, post, patch, del, options } from "./requestFactories";
-export { HttpMethod, RequestPriority, CredentialsPolicy, RequestMode, RedirectMode, CacheMode, } from "./enums";
-export type { RetryCallback, RequestOptions } from "./types";
+import { Config } from "./utils/Config";
+export { HttpMethod, RequestPriority, CredentialsPolicy, RequestMode, RedirectMode, CacheMode, SameSitePolicy, } from "./enums";
+export type { RetryCallback, RequestOptions, CookieOptions, CookiesRecord } from "./types";
 export { RequestError } from "./RequestError";
 export { ResponseWrapper } from "./ResponseWrapper";
+export { CookieUtils } from "./utils/CookieUtils";
 export { GetRequest, PostRequest, PutRequest, DeleteRequest, PatchRequest, HeadRequest, OptionsRequest, } from "./requestMethods";
 declare const create: {
     readonly get: typeof get;
@@ -12,5 +14,6 @@ declare const create: {
     readonly patch: typeof patch;
     readonly head: typeof head;
     readonly options: typeof options;
+    readonly config: Config;
 };
 export default create;