rezo 1.0.125 → 1.0.127

package/README.md

@@ -104,7 +104,9 @@ Rezo selects the optimal adapter for your runtime automatically.
 | **cURL** | Node.js | ● | ● | ● | ● |
 | **Fetch** | Browsers, Deno, Edge | | | | ● |
 | **XHR** | Browsers | | | | |
-| **React Native** | iOS, Android | | | | ● |
+| **React Native** | iOS, Android | Partial | | | Optional |
+
+React Native uses a dedicated adapter. Base RN support covers buffered requests, retries, timeout/abort, hooks, cookies, and adapter-managed redirects. File downloads, provider-backed upload/download progress, readable streaming, NetInfo preflight, and background-task workflows are enabled through optional RN providers.
 
 ## Examples
 
@@ -142,6 +144,24 @@ const stream = await rezo.stream('https://api.example.com/events');
 stream.on('data', (chunk) => process.stdout.write(chunk));
 ```
 
+**React Native provider setup:**
+
+```typescript
+import rezo, {
+  createReactNativeFsAdapter,
+  createNetInfoProvider,
+} from 'rezo/platform/react-native';
+import RNFS from 'react-native-fs';
+import NetInfo from '@react-native-community/netinfo';
+
+const api = rezo.create({
+  reactNative: {
+    fileSystemAdapter: createReactNativeFsAdapter(RNFS, { background: true }),
+    networkInfoProvider: createNetInfoProvider(NetInfo),
+  }
+});
+```
+
 **26 lifecycle hooks:**
 
 ```typescript

package/dist/adapters/curl.cjs

@@ -1548,6 +1548,7 @@ class CurlCommandBuilder {
   buildDownloadOptions(config, originalRequest, tempFiles) {
     const saveTo = originalRequest.saveTo || config.fileName;
     if (saveTo) {
+      this.addArg("--create-dirs");
       this.addArg("-o", saveTo);
     }
   }
@@ -2047,6 +2048,7 @@ class CurlExecutor {
             };
             streamResult.emit("finish", finishEvent);
             streamResult.emit("done", finishEvent);
+            streamResult.emit("complete", finishEvent);
             resolve(streamResult);
             return;
           }
@@ -2073,6 +2075,7 @@ class CurlExecutor {
             };
             downloadResult.emit("finish", finishEvent);
             downloadResult.emit("done", finishEvent);
+            downloadResult.emit("complete", finishEvent);
             resolve(downloadResult);
             return;
           }
@@ -2100,6 +2103,7 @@ class CurlExecutor {
             };
             uploadResult.emit("finish", finishEvent);
             uploadResult.emit("done", finishEvent);
+            uploadResult.emit("complete", finishEvent);
             resolve(uploadResult);
             return;
           }

package/dist/adapters/curl.js

@@ -1548,6 +1548,7 @@ class CurlCommandBuilder {
   buildDownloadOptions(config, originalRequest, tempFiles) {
     const saveTo = originalRequest.saveTo || config.fileName;
     if (saveTo) {
+      this.addArg("--create-dirs");
       this.addArg("-o", saveTo);
     }
   }
@@ -2047,6 +2048,7 @@ class CurlExecutor {
             };
             streamResult.emit("finish", finishEvent);
             streamResult.emit("done", finishEvent);
+            streamResult.emit("complete", finishEvent);
             resolve(streamResult);
             return;
           }
@@ -2073,6 +2075,7 @@ class CurlExecutor {
             };
             downloadResult.emit("finish", finishEvent);
             downloadResult.emit("done", finishEvent);
+            downloadResult.emit("complete", finishEvent);
             resolve(downloadResult);
             return;
           }
@@ -2100,6 +2103,7 @@ class CurlExecutor {
             };
             uploadResult.emit("finish", finishEvent);
             uploadResult.emit("done", finishEvent);
+            uploadResult.emit("complete", finishEvent);
             resolve(uploadResult);
             return;
           }

package/dist/adapters/entries/curl.d.ts

@@ -742,6 +742,12 @@ export interface BaseEventEmitter {
  * Emits 'data' events for response body chunks
  */
 export interface RezoStreamResponse extends BaseEventEmitter {
+	/** Pipe stream data to a writable destination (file stream, stdout, etc.) */
+	pipe<T extends NodeJS.WritableStream>(destination: T, options?: {
+		end?: boolean;
+	}): T;
+	/** Pipe stream data to a file path (creates directories automatically) */
+	pipeTo(filePath: string): this;
 	on(event: "data", listener: (chunk: Uint8Array | string) => void): this;
 	on(event: "error", listener: (err: RezoError) => void): this;
 	on(event: "finish", listener: (info: StreamFinishEvent) => void): this;
@@ -2731,6 +2737,171 @@ declare class RezoStealth {
 	 */
 	static fromUserAgent(userAgent: string): RezoStealth;
 }
+export interface RezoReactNativeFileDownloadHeadersEvent {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+}
+export interface RezoReactNativeFileDownloadProgressEvent {
+	loaded: number;
+	total?: number;
+	speed?: number;
+	averageSpeed?: number;
+	estimatedTime?: number;
+}
+export interface RezoReactNativeFileDownloadRequest {
+	url: string;
+	destination: string;
+	method: string;
+	headers: Record<string, string>;
+	body?: unknown;
+	timeout?: number | null;
+	signal?: AbortSignal | null;
+	onHeaders?: (event: RezoReactNativeFileDownloadHeadersEvent) => void | Promise<void>;
+	onProgress?: (event: RezoReactNativeFileDownloadProgressEvent) => void | Promise<void>;
+}
+export interface RezoReactNativeFileDownloadResult {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+	filePath: string;
+	fileSize?: number;
+}
+export interface RezoReactNativeFileUploadSource {
+	uri: string;
+	name?: string;
+	type?: string;
+	fieldName?: string;
+	size?: number;
+}
+export interface RezoReactNativeFileUploadProgressEvent {
+	loaded: number;
+	total?: number;
+	speed?: number;
+	averageSpeed?: number;
+	estimatedTime?: number;
+}
+export interface RezoReactNativeFileUploadRequest {
+	url: string;
+	method: string;
+	headers: Record<string, string>;
+	file: RezoReactNativeFileUploadSource;
+	fields?: Record<string, string>;
+	binaryStreamOnly?: boolean;
+	timeout?: number | null;
+	signal?: AbortSignal | null;
+	onHeaders?: (event: RezoReactNativeFileDownloadHeadersEvent) => void | Promise<void>;
+	onProgress?: (event: RezoReactNativeFileUploadProgressEvent) => void | Promise<void>;
+}
+export interface RezoReactNativeFileUploadResult {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+	body?: unknown;
+	uploadSize?: number;
+	fileName?: string;
+}
+export interface RezoReactNativeStreamHeadersEvent {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+}
+export interface RezoReactNativeStreamProgressEvent {
+	loaded: number;
+	total?: number;
+	speed?: number;
+	averageSpeed?: number;
+	estimatedTime?: number;
+}
+export interface RezoReactNativeStreamRequest {
+	url: string;
+	method: string;
+	headers: Record<string, string>;
+	body?: unknown;
+	timeout?: number | null;
+	signal?: AbortSignal | null;
+	onHeaders?: (event: RezoReactNativeStreamHeadersEvent) => void | Promise<void>;
+	onChunk?: (chunk: Uint8Array | string) => void | Promise<void>;
+	onProgress?: (event: RezoReactNativeStreamProgressEvent) => void | Promise<void>;
+}
+export interface RezoReactNativeStreamResult {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+}
+export interface RezoReactNativeUploadConfig extends RezoReactNativeFileUploadSource {
+	enabled?: boolean;
+	fields?: Record<string, string>;
+	binaryStreamOnly?: boolean;
+}
+export interface RezoReactNativeFileSystemAdapterCapabilities {
+	fileDownload?: boolean;
+	downloadProgress?: boolean;
+	uploadFromFile?: boolean;
+	uploadProgress?: boolean;
+	backgroundTasks?: boolean;
+}
+export interface RezoReactNativeFileSystemAdapter {
+	name: string;
+	capabilities?: RezoReactNativeFileSystemAdapterCapabilities;
+	downloadFile?: (request: RezoReactNativeFileDownloadRequest) => Promise<RezoReactNativeFileDownloadResult>;
+	uploadFile?: (request: RezoReactNativeFileUploadRequest) => Promise<RezoReactNativeFileUploadResult>;
+}
+export interface RezoReactNativeStreamTransport {
+	name: string;
+	stream(request: RezoReactNativeStreamRequest): Promise<RezoReactNativeStreamResult>;
+}
+export interface RezoReactNativeNetworkState {
+	type?: string;
+	isConnected: boolean | null;
+	isInternetReachable: boolean | null;
+	isExpensive?: boolean;
+	details?: Record<string, any>;
+}
+export interface RezoReactNativeNetworkInfoProvider {
+	fetch(): Promise<RezoReactNativeNetworkState>;
+	subscribe?(listener: (state: RezoReactNativeNetworkState) => void): (() => void) | Promise<() => void>;
+}
+export interface RezoReactNativeBackgroundTaskDefinition {
+	name: string;
+	minimumInterval?: number;
+	metadata?: Record<string, any>;
+}
+export interface RezoReactNativeBackgroundTaskConfig {
+	enabled?: boolean;
+	name: string;
+	minimumInterval?: number;
+	metadata?: Record<string, any>;
+	keepRegistered?: boolean;
+}
+export interface RezoReactNativeBackgroundTaskProvider {
+	registerTask(task: RezoReactNativeBackgroundTaskDefinition): Promise<void>;
+	unregisterTask(name: string): Promise<void>;
+	isTaskRegistered?(name: string): Promise<boolean>;
+}
+export interface RezoReactNativeOptions {
+	fileSystemAdapter?: RezoReactNativeFileSystemAdapter;
+	streamTransport?: RezoReactNativeStreamTransport;
+	networkInfoProvider?: RezoReactNativeNetworkInfoProvider;
+	backgroundTaskProvider?: RezoReactNativeBackgroundTaskProvider;
+	backgroundTask?: RezoReactNativeBackgroundTaskConfig | null;
+	upload?: RezoReactNativeUploadConfig | null;
+}
 export type queueOptions = QueueConfig;
 export interface CacheConfig {
 	/** Response cache configuration */
@@ -2741,6 +2912,8 @@ export interface CacheConfig {
 export type CacheOption = boolean | CacheConfig;
 export interface RezoDefaultOptions {
 	baseURL?: string;
+	/** Optional React Native integrations such as file-system or network-state providers */
+	reactNative?: RezoReactNativeOptions;
 	/** Hooks for request/response lifecycle */
 	hooks?: Partial<RezoHooks>;
 	/**
@@ -3153,7 +3326,7 @@ export interface RezoConfig {
 	/** @description Final resolved URL after redirects and processing */
 	finalUrl: string;
 	/** @description HTTP adapter used for the request */
-	adapterUsed: "http" | "https" | "http2" | "fetch" | "xhr" | "curl";
+	adapterUsed: "http" | "https" | "http2" | "fetch" | "xhr" | "curl" | "react-native";
 	/** @description Metadata about the adapter used */
 	adapterMetadata?: {
 		/** @description Adapter version */
@@ -3567,6 +3740,8 @@ export type ContentType = "application/json" | "application/x-www-form-urlencode
 export interface RezoRequestConfig<D = any> {
 	/** The target URL for the request */
 	url: string | URL;
+	/** Optional React Native integrations for this request */
+	reactNative?: RezoReactNativeOptions;
 	/**
 	 * The absolute request url
 	 */
@@ -4234,7 +4409,7 @@ export type ToRedirectOptions = {
  * @public - Use with all methods
  * @internal - Do not use internally within the library
  */
-export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method" | "form" | "json" | "formData" | "multipart" | "fullUrl" | "responseType">;
+export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method" | "form" | "json" | "formData" | "multipart" | "fullUrl" | "responseType" | "fileName" | "saveTo" | "baseURL">;
 /**
  * Method-aware request types for better TypeScript inference
  * These types remove data/body fields from methods that don't typically use them
@@ -4243,7 +4418,7 @@ export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method"
  * RezoHttpGetRequest - Request options for GET requests (no request body)
  * @public - Use with GET method
  */
-export type RezoHttpGetRequest = Omit<RezoHttpRequest, "data" | "body">;
+export type RezoHttpGetRequest = Omit<RezoHttpRequest, "data" | "body" | "fileName" | "saveTo">;
 /**
  * RezoHttpPostRequest - Request options for POST requests (includes request body)
  * @public - Use with POST method
@@ -5848,7 +6023,7 @@ export interface RezoInstance extends Rezo, RezoCallable {
  *
  * IMPORTANT: Update these values when bumping package version.
  */
-export declare const VERSION = "1.0.125";
+export declare const VERSION = "1.0.127";
 /**
  * cURL Options Configuration
  *

package/dist/adapters/entries/fetch.d.ts

@@ -742,6 +742,12 @@ export interface BaseEventEmitter {
  * Emits 'data' events for response body chunks
  */
 export interface RezoStreamResponse extends BaseEventEmitter {
+	/** Pipe stream data to a writable destination (file stream, stdout, etc.) */
+	pipe<T extends NodeJS.WritableStream>(destination: T, options?: {
+		end?: boolean;
+	}): T;
+	/** Pipe stream data to a file path (creates directories automatically) */
+	pipeTo(filePath: string): this;
 	on(event: "data", listener: (chunk: Uint8Array | string) => void): this;
 	on(event: "error", listener: (err: RezoError) => void): this;
 	on(event: "finish", listener: (info: StreamFinishEvent) => void): this;
@@ -2731,6 +2737,171 @@ declare class RezoStealth {
 	 */
 	static fromUserAgent(userAgent: string): RezoStealth;
 }
+export interface RezoReactNativeFileDownloadHeadersEvent {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+}
+export interface RezoReactNativeFileDownloadProgressEvent {
+	loaded: number;
+	total?: number;
+	speed?: number;
+	averageSpeed?: number;
+	estimatedTime?: number;
+}
+export interface RezoReactNativeFileDownloadRequest {
+	url: string;
+	destination: string;
+	method: string;
+	headers: Record<string, string>;
+	body?: unknown;
+	timeout?: number | null;
+	signal?: AbortSignal | null;
+	onHeaders?: (event: RezoReactNativeFileDownloadHeadersEvent) => void | Promise<void>;
+	onProgress?: (event: RezoReactNativeFileDownloadProgressEvent) => void | Promise<void>;
+}
+export interface RezoReactNativeFileDownloadResult {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+	filePath: string;
+	fileSize?: number;
+}
+export interface RezoReactNativeFileUploadSource {
+	uri: string;
+	name?: string;
+	type?: string;
+	fieldName?: string;
+	size?: number;
+}
+export interface RezoReactNativeFileUploadProgressEvent {
+	loaded: number;
+	total?: number;
+	speed?: number;
+	averageSpeed?: number;
+	estimatedTime?: number;
+}
+export interface RezoReactNativeFileUploadRequest {
+	url: string;
+	method: string;
+	headers: Record<string, string>;
+	file: RezoReactNativeFileUploadSource;
+	fields?: Record<string, string>;
+	binaryStreamOnly?: boolean;
+	timeout?: number | null;
+	signal?: AbortSignal | null;
+	onHeaders?: (event: RezoReactNativeFileDownloadHeadersEvent) => void | Promise<void>;
+	onProgress?: (event: RezoReactNativeFileUploadProgressEvent) => void | Promise<void>;
+}
+export interface RezoReactNativeFileUploadResult {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+	body?: unknown;
+	uploadSize?: number;
+	fileName?: string;
+}
+export interface RezoReactNativeStreamHeadersEvent {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+}
+export interface RezoReactNativeStreamProgressEvent {
+	loaded: number;
+	total?: number;
+	speed?: number;
+	averageSpeed?: number;
+	estimatedTime?: number;
+}
+export interface RezoReactNativeStreamRequest {
+	url: string;
+	method: string;
+	headers: Record<string, string>;
+	body?: unknown;
+	timeout?: number | null;
+	signal?: AbortSignal | null;
+	onHeaders?: (event: RezoReactNativeStreamHeadersEvent) => void | Promise<void>;
+	onChunk?: (chunk: Uint8Array | string) => void | Promise<void>;
+	onProgress?: (event: RezoReactNativeStreamProgressEvent) => void | Promise<void>;
+}
+export interface RezoReactNativeStreamResult {
+	status: number;
+	statusText?: string;
+	headers?: Record<string, string>;
+	finalUrl?: string;
+	contentType?: string;
+	contentLength?: number;
+}
+export interface RezoReactNativeUploadConfig extends RezoReactNativeFileUploadSource {
+	enabled?: boolean;
+	fields?: Record<string, string>;
+	binaryStreamOnly?: boolean;
+}
+export interface RezoReactNativeFileSystemAdapterCapabilities {
+	fileDownload?: boolean;
+	downloadProgress?: boolean;
+	uploadFromFile?: boolean;
+	uploadProgress?: boolean;
+	backgroundTasks?: boolean;
+}
+export interface RezoReactNativeFileSystemAdapter {
+	name: string;
+	capabilities?: RezoReactNativeFileSystemAdapterCapabilities;
+	downloadFile?: (request: RezoReactNativeFileDownloadRequest) => Promise<RezoReactNativeFileDownloadResult>;
+	uploadFile?: (request: RezoReactNativeFileUploadRequest) => Promise<RezoReactNativeFileUploadResult>;
+}
+export interface RezoReactNativeStreamTransport {
+	name: string;
+	stream(request: RezoReactNativeStreamRequest): Promise<RezoReactNativeStreamResult>;
+}
+export interface RezoReactNativeNetworkState {
+	type?: string;
+	isConnected: boolean | null;
+	isInternetReachable: boolean | null;
+	isExpensive?: boolean;
+	details?: Record<string, any>;
+}
+export interface RezoReactNativeNetworkInfoProvider {
+	fetch(): Promise<RezoReactNativeNetworkState>;
+	subscribe?(listener: (state: RezoReactNativeNetworkState) => void): (() => void) | Promise<() => void>;
+}
+export interface RezoReactNativeBackgroundTaskDefinition {
+	name: string;
+	minimumInterval?: number;
+	metadata?: Record<string, any>;
+}
+export interface RezoReactNativeBackgroundTaskConfig {
+	enabled?: boolean;
+	name: string;
+	minimumInterval?: number;
+	metadata?: Record<string, any>;
+	keepRegistered?: boolean;
+}
+export interface RezoReactNativeBackgroundTaskProvider {
+	registerTask(task: RezoReactNativeBackgroundTaskDefinition): Promise<void>;
+	unregisterTask(name: string): Promise<void>;
+	isTaskRegistered?(name: string): Promise<boolean>;
+}
+export interface RezoReactNativeOptions {
+	fileSystemAdapter?: RezoReactNativeFileSystemAdapter;
+	streamTransport?: RezoReactNativeStreamTransport;
+	networkInfoProvider?: RezoReactNativeNetworkInfoProvider;
+	backgroundTaskProvider?: RezoReactNativeBackgroundTaskProvider;
+	backgroundTask?: RezoReactNativeBackgroundTaskConfig | null;
+	upload?: RezoReactNativeUploadConfig | null;
+}
 export type queueOptions = QueueConfig;
 export interface CacheConfig {
 	/** Response cache configuration */
@@ -2741,6 +2912,8 @@ export interface CacheConfig {
 export type CacheOption = boolean | CacheConfig;
 export interface RezoDefaultOptions {
 	baseURL?: string;
+	/** Optional React Native integrations such as file-system or network-state providers */
+	reactNative?: RezoReactNativeOptions;
 	/** Hooks for request/response lifecycle */
 	hooks?: Partial<RezoHooks>;
 	/**
@@ -3153,7 +3326,7 @@ export interface RezoConfig {
 	/** @description Final resolved URL after redirects and processing */
 	finalUrl: string;
 	/** @description HTTP adapter used for the request */
-	adapterUsed: "http" | "https" | "http2" | "fetch" | "xhr" | "curl";
+	adapterUsed: "http" | "https" | "http2" | "fetch" | "xhr" | "curl" | "react-native";
 	/** @description Metadata about the adapter used */
 	adapterMetadata?: {
 		/** @description Adapter version */
@@ -3567,6 +3740,8 @@ export type ContentType = "application/json" | "application/x-www-form-urlencode
 export interface RezoRequestConfig<D = any> {
 	/** The target URL for the request */
 	url: string | URL;
+	/** Optional React Native integrations for this request */
+	reactNative?: RezoReactNativeOptions;
 	/**
 	 * The absolute request url
 	 */
@@ -4234,7 +4409,7 @@ export type ToRedirectOptions = {
  * @public - Use with all methods
  * @internal - Do not use internally within the library
  */
-export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method" | "form" | "json" | "formData" | "multipart" | "fullUrl" | "responseType">;
+export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method" | "form" | "json" | "formData" | "multipart" | "fullUrl" | "responseType" | "fileName" | "saveTo" | "baseURL">;
 /**
  * Method-aware request types for better TypeScript inference
  * These types remove data/body fields from methods that don't typically use them
@@ -4243,7 +4418,7 @@ export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method"
  * RezoHttpGetRequest - Request options for GET requests (no request body)
  * @public - Use with GET method
  */
-export type RezoHttpGetRequest = Omit<RezoHttpRequest, "data" | "body">;
+export type RezoHttpGetRequest = Omit<RezoHttpRequest, "data" | "body" | "fileName" | "saveTo">;
 /**
  * RezoHttpPostRequest - Request options for POST requests (includes request body)
  * @public - Use with POST method
@@ -5848,7 +6023,7 @@ export interface RezoInstance extends Rezo, RezoCallable {
  *
  * IMPORTANT: Update these values when bumping package version.
  */
-export declare const VERSION = "1.0.125";
+export declare const VERSION = "1.0.127";
 export declare const isRezoError: typeof RezoError.isRezoError;
 export declare const Cancel: typeof RezoError;
 export declare const CancelToken: {