jiren 1.1.1 → 1.2.0

package/components/index.ts

@@ -5,9 +5,19 @@
  */
 
 // Main client
-export { JirenClient, type JirenClientOptions } from "./client";
+export {
+  JirenClient,
+  type JirenClientOptions,
+  type UrlAccessor,
+} from "./client";
 
 // Types
-export type { JirenHttpConfig, ParsedUrl } from "../types/index";
+export type {
+  JirenHttpConfig,
+  ParsedUrl,
+  WarmupUrlConfig,
+  UrlRequestOptions,
+  UrlEndpoint,
+} from "./types";
 
 // Remove broken exports

package/components/native.ts

@@ -29,6 +29,7 @@ export const ffiDef = {
       FFIType.cstring,
       FFIType.cstring,
       FFIType.u8,
+      FFIType.bool,
     ],
     returns: FFIType.ptr,
   },
@@ -56,10 +57,30 @@ export const ffiDef = {
     args: [FFIType.ptr],
     returns: FFIType.u64,
   },
+  zclient_response_parse_header_offsets: {
+    args: [FFIType.ptr],
+    returns: FFIType.ptr,
+  },
+  zclient_header_offsets_free: {
+    args: [FFIType.ptr],
+    returns: FFIType.void,
+  },
+  z_find_header_value: {
+    args: [FFIType.ptr, FFIType.u64, FFIType.cstring],
+    returns: FFIType.ptr,
+  },
+  zclient_header_value_free: {
+    args: [FFIType.ptr],
+    returns: FFIType.void,
+  },
   zclient_response_free: {
     args: [FFIType.ptr],
     returns: FFIType.void,
   },
+  zclient_set_benchmark_mode: {
+    args: [FFIType.ptr, FFIType.bool],
+    returns: FFIType.void,
+  },
 } as const;
 
 export const lib = dlopen(libPath, ffiDef);

package/components/types.ts

@@ -34,16 +34,44 @@ export interface RequestOptions {
   timeout?: number;
   /** Maximum number of redirects to follow */
   maxRedirects?: number;
+  /** Automatically parse response body */
+  responseType?: "json" | "text" | "arraybuffer" | "blob";
+  /** Enable anti-bot protection (using curl-impersonate) */
+  antibot?: boolean;
+}
+
+/** HTTP Response Body Wrapper */
+export interface JirenResponseBody<T = any> {
+  /** Get response as JSON */
+  json: <R = T>() => Promise<R>;
+  /** Get response as text */
+  text: () => Promise<string>;
+  /** Get response as ArrayBuffer */
+  arrayBuffer: () => Promise<ArrayBuffer>;
+  /** Get response as Blob */
+  blob: () => Promise<Blob>;
+  /** Whether the body has been used */
+  bodyUsed: boolean;
 }
 
 /** HTTP Response */
-export interface HttpResponse {
+export interface JirenResponse<T = any> {
   /** HTTP status code */
   status: number;
-  /** Response body as string */
-  body: string;
+  /** Response body object */
+  body: JirenResponseBody<T>;
   /** Response headers */
-  headers?: Record<string, string>;
+  headers: Record<string, string>;
+  /** Whether the request was successful (status 200-299) */
+  ok: boolean;
+  /** The URL of the response */
+  url: string;
+  /** The status message corresponding to the status code */
+  statusText: string;
+  /** Whether the response was redirected */
+  redirected: boolean;
+  /** The type of the response */
+  type: "basic" | "cors" | "default" | "error" | "opaque" | "opaqueredirect";
 }
 
 /** Configuration for JirenHttpClient */
@@ -61,3 +89,100 @@ export interface ParsedUrl {
   port: number;
   path: string;
 }
+
+/** Warmup URL with a key for type-safe access */
+export interface WarmupUrlConfig {
+  /** Unique key to access this URL via client.url[key] */
+  key: string;
+  /** The URL to warmup */
+  url: string;
+  /** Enable response caching for this URL (default: false) */
+  cache?: boolean | CacheConfig;
+}
+
+/** Cache configuration */
+export interface CacheConfig {
+  /** Cache TTL in milliseconds (default: 60000 = 1 minute) */
+  ttl?: number;
+  /** Maximum cache size (default: 100 entries) */
+  maxSize?: number;
+}
+
+/** Options for URL endpoint requests */
+export interface UrlRequestOptions {
+  /** Request headers */
+  headers?: Record<string, string>;
+  /** Path to append to the base URL */
+  path?: string;
+  /** Maximum number of redirects to follow */
+  maxRedirects?: number;
+  /** Automatically parse response body */
+  responseType?: "json" | "text" | "arraybuffer" | "blob";
+  /** Enable anti-bot protection (using curl-impersonate) */
+  antibot?: boolean;
+}
+
+/** Interface for a URL endpoint with HTTP method helpers */
+export interface UrlEndpoint {
+  /** GET request */
+  get<T = any>(options?: UrlRequestOptions): Promise<JirenResponse<T>>;
+  get<T = any>(
+    options?: UrlRequestOptions & { responseType: "json" }
+  ): Promise<T>;
+  get<T = any>(
+    options?: UrlRequestOptions & { responseType: "text" }
+  ): Promise<string>;
+
+  /** POST request */
+  post<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions
+  ): Promise<JirenResponse<T>>;
+  post<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions & { responseType: "json" }
+  ): Promise<T>;
+
+  /** PUT request */
+  put<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions
+  ): Promise<JirenResponse<T>>;
+  put<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions & { responseType: "json" }
+  ): Promise<T>;
+
+  /** PATCH request */
+  patch<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions
+  ): Promise<JirenResponse<T>>;
+  patch<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions & { responseType: "json" }
+  ): Promise<T>;
+
+  /** DELETE request */
+  delete<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions
+  ): Promise<JirenResponse<T>>;
+  delete<T = any>(
+    body?: string | null,
+    options?: UrlRequestOptions & { responseType: "json" }
+  ): Promise<T>;
+
+  /** HEAD request */
+  head(options?: UrlRequestOptions): Promise<JirenResponse<any>>;
+
+  /** OPTIONS request */
+  options(options?: UrlRequestOptions): Promise<JirenResponse<any>>;
+
+  /** Prefetch/refresh cache for this URL */
+  prefetch(options?: UrlRequestOptions): Promise<void>;
+}
+
+/** Type helper to extract keys from warmup config array */
+export type ExtractWarmupKeys<T extends readonly WarmupUrlConfig[]> =
+  T[number]["key"];

package/components/worker.ts

@@ -75,12 +75,17 @@ if (parentPort) {
           bodyBuffer = Buffer.from(bodyStr + "\0");
         }
 
+        const maxRedirects = options.maxRedirects ?? 5;
+        const antibot = options.antibot ?? false;
+
         const respPtr = lib.symbols.zclient_request(
           ptr,
           methodBuffer,
           urlBuffer,
           headersBuffer,
-          bodyBuffer
+          bodyBuffer,
+          maxRedirects,
+          antibot
         );
 
         // Parse Response

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiren",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "author": "",
   "main": "index.ts",
   "module": "index.ts",

package/types/index.ts

@@ -33,6 +33,12 @@ export interface RequestOptions {
   body?: string | object;
   /** Request timeout in milliseconds */
   timeout?: number;
+  /** Maximum number of redirects to follow */
+  maxRedirects?: number;
+  /** Automatically parse response body */
+  responseType?: "json" | "text" | "arraybuffer" | "blob";
+  /** Enable anti-bot protection (using curl-impersonate) */
+  antibot?: boolean;
 }
 
 /** HTTP Response */