jiren 1.0.5 → 1.0.6

package/dist/components/client.d.ts

@@ -0,0 +1,29 @@
+import type { RequestOptions, GetRequestOptions, PostRequestOptions, HttpResponse } from "../types";
+export declare class JirenClient {
+    private ptr;
+    constructor();
+    /**
+     * Free the native client resources.
+     * Must be called when the client is no longer needed.
+     */
+    close(): void;
+    /**
+     * Perform a HTTP request.
+     * @param url - The URL to request
+     * @param options - Request options (method, headers, body)
+     * @returns Response object
+     */
+    request(url: string, options?: RequestOptions): HttpResponse;
+    get(url: string, options?: GetRequestOptions): HttpResponse;
+    post(url: string, body: string | object, options?: PostRequestOptions): HttpResponse;
+    put(url: string, body: string | object, options?: PostRequestOptions): HttpResponse;
+    delete(url: string, options?: GetRequestOptions): HttpResponse;
+    patch(url: string, body: string | object, options?: PostRequestOptions): HttpResponse;
+    head(url: string, options?: GetRequestOptions): HttpResponse;
+    /**
+     * Prefetch URLs to warm up connections (resolve DNS & Handshake).
+     * @param urls - List of URLs to prefetch
+     */
+    prefetch(urls: string[]): void;
+    private parseResponse;
+}

package/dist/components/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * flous - Ultra-fast HTTP/HTTPS client powered by native Zig
+ *
+ * @packageDocumentation
+ */
+export { JirenClient } from "./client";
+export type { JirenHttpConfig, ParsedUrl } from "../types/index";

package/dist/components/native.d.ts

@@ -0,0 +1,101 @@
+import { FFIType } from "bun:ffi";
+export declare const ffiDef: {
+    readonly zclient_new: {
+        readonly args: readonly [];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_free: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.void;
+    };
+    readonly zclient_get: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_post: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring, FFIType.cstring];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_prefetch: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring];
+        readonly returns: FFIType.void;
+    };
+    readonly zclient_response_status: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.uint16_t;
+    };
+    readonly zclient_response_body: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_response_body_len: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.uint64_t;
+    };
+    readonly zclient_response_headers: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_response_headers_len: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.uint64_t;
+    };
+    readonly zclient_response_free: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.void;
+    };
+    readonly zclient_request: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring, FFIType.cstring, FFIType.cstring, FFIType.cstring];
+        readonly returns: FFIType.ptr;
+    };
+};
+export declare const lib: import("bun:ffi").Library<{
+    readonly zclient_new: {
+        readonly args: readonly [];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_free: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.void;
+    };
+    readonly zclient_get: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_post: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring, FFIType.cstring];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_prefetch: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring];
+        readonly returns: FFIType.void;
+    };
+    readonly zclient_response_status: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.uint16_t;
+    };
+    readonly zclient_response_body: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_response_body_len: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.uint64_t;
+    };
+    readonly zclient_response_headers: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.ptr;
+    };
+    readonly zclient_response_headers_len: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.uint64_t;
+    };
+    readonly zclient_response_free: {
+        readonly args: readonly [FFIType.ptr];
+        readonly returns: FFIType.void;
+    };
+    readonly zclient_request: {
+        readonly args: readonly [FFIType.ptr, FFIType.cstring, FFIType.cstring, FFIType.cstring, FFIType.cstring];
+        readonly returns: FFIType.ptr;
+    };
+}>;

package/dist/components/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * pow - Ultra-fast HTTP/HTTPS client powered by native Zigr than any other HTTP/HTTPS client
+ */
+/** Options for batch HTTP requests */
+export interface BatchOptions {
+    /** Number of requests to send (default: 1000) */
+    count?: number;
+    /** Number of concurrent threads (default: 100) */
+    threads?: number;
+}
+/** Result of a batch request operation */
+export interface BatchResult {
+    /** Number of successful requests */
+    success: number;
+    /** Total requests attempted */
+    total: number;
+    /** Duration in seconds */
+    duration: number;
+    /** Requests per second */
+    requestsPerSecond: number;
+}
+/** Options for single HTTP requests */
+export interface RequestOptions {
+    /** HTTP method (default: GET) */
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD";
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (for POST, PUT, PATCH) */
+    body?: string | object;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/** HTTP Response */
+export interface HttpResponse {
+    /** HTTP status code */
+    status: number;
+    /** Response body as string */
+    body: string;
+    /** Response headers */
+    headers?: Record<string, string>;
+}
+/** Configuration for JirenHttpClient */
+export interface JirenHttpConfig {
+    /** Default number of threads for batch operations */
+    defaultThreads?: number;
+    /** Base URL prefix for all requests */
+    baseUrl?: string;
+}
+/** Parsed URL components */
+export interface ParsedUrl {
+    protocol: "http" | "https";
+    host: string;
+    port: number;
+    path: string;
+}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * jiren - Ultra-fast HTTP/HTTPS client powered by native Zig
+ *
+ * Faster than any other HTTP/HTTPS client | 1.5M+ requests/sec
+ *
+ * @example
+ * ```typescript
+ * import { JirenClient } from 'jiren';
+ *
+ * const client = new JirenClient();
+ *
+ * // High-performance batch requests
+ * const result = client.batch('http://localhost:3000/', {
+ *   count: 10000,
+ *   threads: 100
+ * });
+ *
+ * console.log(`Success: ${result.success}/${result.total}`);
+ * console.log(`Speed: ${result.requestsPerSecond.toFixed(0)} req/sec`);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { JirenClient } from "./components";
+export * from "./types";

package/dist/test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * jiren - Ultra-fast HTTP/HTTPS Client Types
+ * 56% faster than llhttp
+ */
+/** Options for batch HTTP requests */
+export interface BatchOptions {
+    /** Number of requests to send (default: 1000) */
+    count?: number;
+    /** Number of concurrent threads (default: 100) */
+    threads?: number;
+}
+/** Result of a batch request operation */
+export interface BatchResult {
+    /** Number of successful requests */
+    success: number;
+    /** Total requests attempted */
+    total: number;
+    /** Duration in seconds */
+    duration: number;
+    /** Requests per second */
+    requestsPerSecond: number;
+}
+/** Options for single HTTP requests */
+/** Options for single HTTP requests */
+export interface RequestOptions {
+    /** HTTP method (default: GET) */
+    method?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (for POST, PUT, PATCH) */
+    body?: string | object;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Maximum number of redirects to follow (default: 0) */
+    maxRedirects?: number;
+}
+/** Options for requests without a body (GET, DELETE, HEAD) */
+export type GetRequestOptions = Omit<RequestOptions, "method" | "body">;
+/** Options for requests with a body (POST, PUT, PATCH) where body is a separate argument */
+export type PostRequestOptions = Omit<RequestOptions, "method" | "body">;
+/** HTTP Response */
+export interface HttpResponse {
+    /** HTTP status code */
+    status: number;
+    /** Response body as string */
+    body: string;
+    /** Response headers */
+    headers?: Record<string, string>;
+    /** True if status is 2xx */
+    ok: boolean;
+    /** Helper to get body as string (Promise for Fetch compatibility) */
+    text: () => Promise<string>;
+    /** Helper to parse JSON body */
+    json: <T = any>() => T;
+}
+/** Configuration for JirenHttpClient */
+export interface JirenHttpConfig {
+    /** Default number of threads for batch operations */
+    defaultThreads?: number;
+    /** Base URL prefix for all requests */
+    baseUrl?: string;
+}
+/** Parsed URL components */
+export interface ParsedUrl {
+    protocol: "http" | "https";
+    host: string;
+    port: number;
+    path: string;
+}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "jiren",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "author": "",
   "main": "index.ts",
   "module": "index.ts",
-  "types": "index.ts",
+  "types": "dist/index.d.ts",
   "dependencies": {
     "@types/bun": "^1.3.4"
   },
-  "devDependencies": {},
+  "devDependencies": {
+    "typescript": "^5"
+  },
   "peerDependencies": {
     "typescript": "^5"
   },
@@ -16,6 +18,7 @@
   "files": [
     "index.ts",
     "types",
+    "dist",
     "lib",
     "components"
   ],
@@ -33,6 +36,7 @@
   ],
   "license": "MIT",
   "scripts": {
+    "build": "tsc",
     "build:zig": "cd .. && zig build --release=fast",
     "test": "bun run examples/basic.ts"
   },