jiren 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -43
- package/components/client.ts +200 -0
- package/components/index.ts +11 -11
- package/components/native.ts +11 -10
- package/components/types.ts +2 -0
- package/components/worker.ts +137 -0
- package/index.ts +29 -0
- package/lib/libhttpclient.dylib +0 -0
- package/package.json +9 -14
- package/types/index.ts +1 -12
- package/components/client-bun.ts +0 -188
- package/components/client-node.ts +0 -105
- package/components/runtime.ts +0 -11
- package/dist/index.js +0 -271
package/README.md
CHANGED
|
@@ -1,19 +1,17 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Jiren
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Ultra-fast HTTP/HTTPS client.
|
|
3
|
+
Ultra-fast HTTP/HTTPS client powered by native Zig (FFI).
|
|
6
4
|
Designed to be significantly faster than `fetch` and other Node/Bun HTTP clients.
|
|
7
5
|
|
|
8
6
|
## Features
|
|
9
7
|
|
|
10
|
-
- **
|
|
11
|
-
- **
|
|
12
|
-
- **
|
|
13
|
-
- **Type-Safe API**: Strict options (`GetRequestOptions`, `PostRequestOptions`) for better DX.
|
|
14
|
-
- **Helper Methods**: Built-in `.json<T>()` parser and header accessors.
|
|
8
|
+
- **Native Performance**: Written in Zig for memory safety and speed.
|
|
9
|
+
- **Zero-Copy (Planned)**: Minimal overhead FFI.
|
|
10
|
+
- **HTTP/1.1 & HTTP/3 (QUIC)**: Support for modern protocols.
|
|
15
11
|
- **Connection Pooling**: Reuse connections for maximum throughput.
|
|
16
12
|
- **0-RTT Session Resumption**: Extremely fast subsequent requests.
|
|
13
|
+
- **Smart Warmup**: Pre-warm connections to reduce latency.
|
|
14
|
+
- **JSON & Text Helpers**: Easy response parsing.
|
|
17
15
|
|
|
18
16
|
## Installation
|
|
19
17
|
|
|
@@ -23,65 +21,57 @@ bun add jiren
|
|
|
23
21
|
|
|
24
22
|
## Usage
|
|
25
23
|
|
|
26
|
-
### Basic
|
|
24
|
+
### Basic GET
|
|
27
25
|
|
|
28
26
|
```typescript
|
|
29
27
|
import { JirenClient } from "jiren";
|
|
30
28
|
|
|
31
29
|
const client = new JirenClient();
|
|
30
|
+
const res = await client.get("https://example.com");
|
|
32
31
|
|
|
33
|
-
|
|
34
|
-
const
|
|
35
|
-
console.log(
|
|
36
|
-
|
|
37
|
-
// JSON Parsing Helper
|
|
38
|
-
const data = res.json<{ message: string }>();
|
|
32
|
+
console.log(res.status);
|
|
33
|
+
const text = await res.text();
|
|
34
|
+
console.log(text);
|
|
39
35
|
```
|
|
40
36
|
|
|
41
|
-
###
|
|
42
|
-
|
|
43
|
-
Jiren enforces type safety. You cannot pass a body to a GET request!
|
|
37
|
+
### JSON Response
|
|
44
38
|
|
|
45
39
|
```typescript
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
JSON.stringify({ name: "Jiren" }),
|
|
55
|
-
{
|
|
56
|
-
headers: { "Content-Type": "application/json" },
|
|
57
|
-
}
|
|
58
|
-
);
|
|
59
|
-
|
|
60
|
-
// Follow Redirects (e.g., http -> https)
|
|
61
|
-
client.get("http://google.com", {
|
|
62
|
-
maxRedirects: 5, // Automatically follows up to 5 hops
|
|
63
|
-
});
|
|
40
|
+
interface User {
|
|
41
|
+
id: number;
|
|
42
|
+
name: string;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
const res = await client.get<User>("https://api.example.com/user/1");
|
|
46
|
+
const user = await res.json();
|
|
47
|
+
console.log(user.name);
|
|
64
48
|
```
|
|
65
49
|
|
|
66
|
-
### Prefetching
|
|
50
|
+
### Warmup / Prefetching
|
|
67
51
|
|
|
68
52
|
Warm up DNS and TLS handshakes to ensure subsequent requests are instant.
|
|
53
|
+
You can do this in the constructor or via the `warmup` method.
|
|
69
54
|
|
|
70
55
|
```typescript
|
|
71
|
-
//
|
|
72
|
-
client
|
|
56
|
+
// Option 1: In constructor
|
|
57
|
+
const client = new JirenClient({
|
|
58
|
+
warmup: ["https://google.com", "https://cloudflare.com"],
|
|
59
|
+
});
|
|
60
|
+
|
|
61
|
+
// Option 2: Explicit method call
|
|
62
|
+
client.warmup(["https://example.org"]);
|
|
73
63
|
|
|
74
64
|
// ... later, requests are instant
|
|
75
|
-
const res = client.get("https://google.com");
|
|
65
|
+
const res = await client.get("https://google.com");
|
|
76
66
|
```
|
|
77
67
|
|
|
78
68
|
## Benchmarks
|
|
79
69
|
|
|
80
|
-
**
|
|
70
|
+
**Jiren** delivers native performance by bypassing the JavaScript engine overhead for network I/O.
|
|
81
71
|
|
|
82
72
|
| Client | Requests/sec | Relative Speed |
|
|
83
73
|
| ----------------- | ------------- | -------------- |
|
|
84
|
-
| **
|
|
74
|
+
| **Jiren** | **1,550,000** | **1.0x** |
|
|
85
75
|
| Bun `fetch` | 45,000 | 34x Slower |
|
|
86
76
|
| Node `http` | 32,000 | 48x Slower |
|
|
87
77
|
| Python `requests` | 6,500 | 238x Slower |
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
import { CString, toArrayBuffer, type Pointer } from "bun:ffi";
|
|
2
|
+
import { lib } from "./native";
|
|
3
|
+
import type { RequestOptions } from "./types";
|
|
4
|
+
|
|
5
|
+
export interface JirenClientOptions {
|
|
6
|
+
/** URLs to warmup on client creation (pre-connect + handshake) */
|
|
7
|
+
warmup?: string[];
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
export class JirenClient {
|
|
11
|
+
private ptr: Pointer | null;
|
|
12
|
+
|
|
13
|
+
constructor(options?: JirenClientOptions) {
|
|
14
|
+
this.ptr = lib.symbols.zclient_new();
|
|
15
|
+
if (!this.ptr) throw new Error("Failed to create native client instance");
|
|
16
|
+
|
|
17
|
+
// Warmup connections immediately if URLs provided
|
|
18
|
+
if (options?.warmup && options.warmup.length > 0) {
|
|
19
|
+
this.warmup(options.warmup);
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Free the native client resources.
|
|
25
|
+
* Must be called when the client is no longer needed.
|
|
26
|
+
*/
|
|
27
|
+
public close(): void {
|
|
28
|
+
if (this.ptr) {
|
|
29
|
+
lib.symbols.zclient_free(this.ptr);
|
|
30
|
+
this.ptr = null;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Warm up connections to URLs (DNS resolve + QUIC handshake).
|
|
36
|
+
* Call this early (e.g., at app startup) so subsequent requests are fast.
|
|
37
|
+
* @param urls - List of URLs to warm up
|
|
38
|
+
*/
|
|
39
|
+
public warmup(urls: string[]): void {
|
|
40
|
+
if (!this.ptr) throw new Error("Client is closed");
|
|
41
|
+
|
|
42
|
+
for (const url of urls) {
|
|
43
|
+
const urlBuffer = Buffer.from(url + "\0");
|
|
44
|
+
lib.symbols.zclient_prefetch(this.ptr, urlBuffer);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* @deprecated Use warmup() instead
|
|
50
|
+
*/
|
|
51
|
+
public prefetch(urls: string[]): void {
|
|
52
|
+
this.warmup(urls);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Perform a generic HTTP request.
|
|
57
|
+
* @param method - HTTP method (GET, POST, PUT, DELETE, etc.)
|
|
58
|
+
* @param url - The URL to request
|
|
59
|
+
* @param body - The body content string (optional)
|
|
60
|
+
* @param options - Request options (headers, maxRedirects, etc.) or just headers map
|
|
61
|
+
* @returns Promise resolving to Response object
|
|
62
|
+
*/
|
|
63
|
+
public async request<T = any>(
|
|
64
|
+
method: string,
|
|
65
|
+
url: string,
|
|
66
|
+
body?: string | null,
|
|
67
|
+
options?: RequestOptions | Record<string, string> | null
|
|
68
|
+
) {
|
|
69
|
+
if (!this.ptr) throw new Error("Client is closed");
|
|
70
|
+
|
|
71
|
+
// Normalize options
|
|
72
|
+
let headers: Record<string, string> = {};
|
|
73
|
+
let maxRedirects = 5; // Default
|
|
74
|
+
|
|
75
|
+
if (options) {
|
|
76
|
+
if ("maxRedirects" in options || "headers" in options) {
|
|
77
|
+
// It is RequestOptions
|
|
78
|
+
const opts = options as RequestOptions;
|
|
79
|
+
if (opts.headers) headers = opts.headers;
|
|
80
|
+
if (opts.maxRedirects !== undefined) maxRedirects = opts.maxRedirects;
|
|
81
|
+
// Merge top-level unknown keys as headers if lenient? No, strict to types.
|
|
82
|
+
} else {
|
|
83
|
+
// Assume it's just headers Record<string, string> for backward compatibility
|
|
84
|
+
headers = options as Record<string, string>;
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
const methodBuffer = Buffer.from(method + "\0");
|
|
89
|
+
const urlBuffer = Buffer.from(url + "\0");
|
|
90
|
+
|
|
91
|
+
let bodyBuffer: Buffer | null = null;
|
|
92
|
+
if (body) {
|
|
93
|
+
bodyBuffer = Buffer.from(body + "\0");
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
let headersBuffer: Buffer | null = null;
|
|
97
|
+
const defaultHeaders: Record<string, string> = {
|
|
98
|
+
"user-agent":
|
|
99
|
+
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
|
|
100
|
+
accept:
|
|
101
|
+
"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
|
|
102
|
+
"accept-encoding": "gzip, deflate, br",
|
|
103
|
+
"accept-language": "en-US,en;q=0.9",
|
|
104
|
+
};
|
|
105
|
+
|
|
106
|
+
const finalHeaders = { ...defaultHeaders, ...headers };
|
|
107
|
+
|
|
108
|
+
const headerStr = Object.entries(finalHeaders)
|
|
109
|
+
.map(([k, v]) => `${k.toLowerCase()}: ${v}`)
|
|
110
|
+
.join("\r\n");
|
|
111
|
+
|
|
112
|
+
if (headerStr.length > 0) {
|
|
113
|
+
headersBuffer = Buffer.from(headerStr + "\0");
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
const respPtr = lib.symbols.zclient_request(
|
|
117
|
+
this.ptr,
|
|
118
|
+
methodBuffer,
|
|
119
|
+
urlBuffer,
|
|
120
|
+
headersBuffer,
|
|
121
|
+
bodyBuffer,
|
|
122
|
+
maxRedirects
|
|
123
|
+
);
|
|
124
|
+
|
|
125
|
+
return this.parseResponse<T>(respPtr);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
public async get<T = any>(
|
|
129
|
+
url: string,
|
|
130
|
+
options?: RequestOptions | Record<string, string>
|
|
131
|
+
) {
|
|
132
|
+
return this.request<T>("GET", url, null, options);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
public async post<T = any>(
|
|
136
|
+
url: string,
|
|
137
|
+
body: string,
|
|
138
|
+
options?: RequestOptions | Record<string, string>
|
|
139
|
+
) {
|
|
140
|
+
return this.request<T>("POST", url, body, options);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
public async put<T = any>(
|
|
144
|
+
url: string,
|
|
145
|
+
body: string,
|
|
146
|
+
options?: RequestOptions | Record<string, string>
|
|
147
|
+
) {
|
|
148
|
+
return this.request<T>("PUT", url, body, options);
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
public async patch<T = any>(
|
|
152
|
+
url: string,
|
|
153
|
+
body: string,
|
|
154
|
+
options?: RequestOptions | Record<string, string>
|
|
155
|
+
) {
|
|
156
|
+
return this.request<T>("PATCH", url, body, options);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
public async delete<T = any>(
|
|
160
|
+
url: string,
|
|
161
|
+
body?: string,
|
|
162
|
+
options?: RequestOptions | Record<string, string>
|
|
163
|
+
) {
|
|
164
|
+
return this.request<T>("DELETE", url, body || null, options);
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
public async head(url: string, headers?: Record<string, string>) {
|
|
168
|
+
return this.request("HEAD", url, null, headers);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
public async options(url: string, headers?: Record<string, string>) {
|
|
172
|
+
return this.request("OPTIONS", url, null, headers);
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
private parseResponse<T = any>(respPtr: Pointer | null) {
|
|
176
|
+
if (!respPtr)
|
|
177
|
+
throw new Error("Native request failed (returned null pointer)");
|
|
178
|
+
|
|
179
|
+
try {
|
|
180
|
+
const status = lib.symbols.zclient_response_status(respPtr);
|
|
181
|
+
const len = Number(lib.symbols.zclient_response_body_len(respPtr));
|
|
182
|
+
const bodyPtr = lib.symbols.zclient_response_body(respPtr);
|
|
183
|
+
|
|
184
|
+
let bodyString = "";
|
|
185
|
+
if (len > 0 && bodyPtr) {
|
|
186
|
+
const buffer = toArrayBuffer(bodyPtr, 0, len);
|
|
187
|
+
bodyString = new TextDecoder().decode(buffer);
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
return {
|
|
191
|
+
status,
|
|
192
|
+
body: bodyString,
|
|
193
|
+
text: async () => bodyString,
|
|
194
|
+
json: async (): Promise<T> => JSON.parse(bodyString),
|
|
195
|
+
};
|
|
196
|
+
} finally {
|
|
197
|
+
lib.symbols.zclient_response_free(respPtr);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
}
|
package/components/index.ts
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Jiren - Ultra-fast HTTP/3 client powered by native Zig + QUIC
|
|
3
|
+
*
|
|
4
|
+
* @packageDocumentation
|
|
5
|
+
*/
|
|
2
6
|
|
|
3
|
-
//
|
|
4
|
-
export
|
|
5
|
-
? (await import("./client-bun.js")).JirenClient
|
|
6
|
-
: (await import("./client-node.js")).NodeJirenClient;
|
|
7
|
+
// Main client
|
|
8
|
+
export { JirenClient, type JirenClientOptions } from "./client";
|
|
7
9
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
PostRequestOptions,
|
|
13
|
-
} from "../types/index.js";
|
|
10
|
+
// Types
|
|
11
|
+
export type { JirenHttpConfig, ParsedUrl } from "../types/index";
|
|
12
|
+
|
|
13
|
+
// Remove broken exports
|
package/components/native.ts
CHANGED
|
@@ -21,6 +21,17 @@ export const ffiDef = {
|
|
|
21
21
|
args: [FFIType.ptr, FFIType.cstring, FFIType.cstring],
|
|
22
22
|
returns: FFIType.ptr,
|
|
23
23
|
},
|
|
24
|
+
zclient_request: {
|
|
25
|
+
args: [
|
|
26
|
+
FFIType.ptr,
|
|
27
|
+
FFIType.cstring,
|
|
28
|
+
FFIType.cstring,
|
|
29
|
+
FFIType.cstring,
|
|
30
|
+
FFIType.cstring,
|
|
31
|
+
FFIType.u8,
|
|
32
|
+
],
|
|
33
|
+
returns: FFIType.ptr,
|
|
34
|
+
},
|
|
24
35
|
zclient_prefetch: {
|
|
25
36
|
args: [FFIType.ptr, FFIType.cstring],
|
|
26
37
|
returns: FFIType.void,
|
|
@@ -49,16 +60,6 @@ export const ffiDef = {
|
|
|
49
60
|
args: [FFIType.ptr],
|
|
50
61
|
returns: FFIType.void,
|
|
51
62
|
},
|
|
52
|
-
zclient_request: {
|
|
53
|
-
args: [
|
|
54
|
-
FFIType.ptr, // client
|
|
55
|
-
FFIType.cstring, // method
|
|
56
|
-
FFIType.cstring, // url
|
|
57
|
-
FFIType.cstring, // headers (nullable)
|
|
58
|
-
FFIType.cstring, // body (nullable)
|
|
59
|
-
],
|
|
60
|
-
returns: FFIType.ptr,
|
|
61
|
-
},
|
|
62
63
|
} as const;
|
|
63
64
|
|
|
64
65
|
export const lib = dlopen(libPath, ffiDef);
|
package/components/types.ts
CHANGED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import { parentPort } from "worker_threads";
|
|
2
|
+
import { CString, type Pointer } from "bun:ffi";
|
|
3
|
+
import { lib } from "./native";
|
|
4
|
+
import type { RequestOptions } from "../types";
|
|
5
|
+
|
|
6
|
+
// Each worker has its own isolated native client
|
|
7
|
+
let ptr: Pointer | null = lib.symbols.zclient_new();
|
|
8
|
+
|
|
9
|
+
if (!ptr) {
|
|
10
|
+
throw new Error("Failed to create native client instance in worker");
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
// Handle cleanup
|
|
14
|
+
process.on("exit", () => {
|
|
15
|
+
if (ptr) {
|
|
16
|
+
lib.symbols.zclient_free(ptr);
|
|
17
|
+
ptr = null;
|
|
18
|
+
}
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
if (parentPort) {
|
|
22
|
+
parentPort.on(
|
|
23
|
+
"message",
|
|
24
|
+
(msg: {
|
|
25
|
+
id: number;
|
|
26
|
+
url: string;
|
|
27
|
+
options: RequestOptions;
|
|
28
|
+
type?: string;
|
|
29
|
+
}) => {
|
|
30
|
+
if (msg.type === "close") {
|
|
31
|
+
if (ptr) {
|
|
32
|
+
lib.symbols.zclient_free(ptr);
|
|
33
|
+
ptr = null;
|
|
34
|
+
}
|
|
35
|
+
process.exit(0);
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
if (msg.type === "prefetch") {
|
|
40
|
+
if (!ptr) return;
|
|
41
|
+
const urls = msg.url as unknown as string[]; // hack: url field used for string[]
|
|
42
|
+
for (const url of urls) {
|
|
43
|
+
const urlBuffer = Buffer.from(url + "\0");
|
|
44
|
+
lib.symbols.zclient_prefetch(ptr, urlBuffer);
|
|
45
|
+
}
|
|
46
|
+
parentPort?.postMessage({ type: "prefetch_done" });
|
|
47
|
+
return;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const { id, url, options } = msg;
|
|
51
|
+
|
|
52
|
+
try {
|
|
53
|
+
if (!ptr) throw new Error("Worker client is closed");
|
|
54
|
+
|
|
55
|
+
const method = options.method || "GET";
|
|
56
|
+
const methodBuffer = Buffer.from(method + "\0");
|
|
57
|
+
const urlBuffer = Buffer.from(url + "\0");
|
|
58
|
+
|
|
59
|
+
let headersBuffer: Buffer | null = null;
|
|
60
|
+
if (options.headers) {
|
|
61
|
+
const headerStr = Object.entries(options.headers)
|
|
62
|
+
.map(([k, v]) => `${k.toLowerCase()}: ${v}`)
|
|
63
|
+
.join("\r\n");
|
|
64
|
+
if (headerStr.length > 0) {
|
|
65
|
+
headersBuffer = Buffer.from(headerStr + "\0");
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
let bodyBuffer: Buffer | null = null;
|
|
70
|
+
if (options.body) {
|
|
71
|
+
const bodyStr =
|
|
72
|
+
typeof options.body === "string"
|
|
73
|
+
? options.body
|
|
74
|
+
: JSON.stringify(options.body);
|
|
75
|
+
bodyBuffer = Buffer.from(bodyStr + "\0");
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const respPtr = lib.symbols.zclient_request(
|
|
79
|
+
ptr,
|
|
80
|
+
methodBuffer,
|
|
81
|
+
urlBuffer,
|
|
82
|
+
headersBuffer,
|
|
83
|
+
bodyBuffer
|
|
84
|
+
);
|
|
85
|
+
|
|
86
|
+
// Parse Response
|
|
87
|
+
if (!respPtr) throw new Error("Native request failed");
|
|
88
|
+
|
|
89
|
+
const status = lib.symbols.zclient_response_status(respPtr);
|
|
90
|
+
const bodyLen = Number(lib.symbols.zclient_response_body_len(respPtr));
|
|
91
|
+
const bodyPtr = lib.symbols.zclient_response_body(respPtr);
|
|
92
|
+
const headersLen = Number(
|
|
93
|
+
lib.symbols.zclient_response_headers_len(respPtr)
|
|
94
|
+
);
|
|
95
|
+
const headersPtr = lib.symbols.zclient_response_headers(respPtr);
|
|
96
|
+
|
|
97
|
+
let bodyString = "";
|
|
98
|
+
if (bodyLen > 0 && bodyPtr) {
|
|
99
|
+
bodyString = new CString(bodyPtr).toString();
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
const headers: Record<string, string> = {};
|
|
103
|
+
if (headersLen > 0 && headersPtr) {
|
|
104
|
+
const headersStr = new CString(headersPtr).toString();
|
|
105
|
+
const lines = headersStr.split("\r\n");
|
|
106
|
+
for (const line of lines) {
|
|
107
|
+
if (!line) continue;
|
|
108
|
+
const colonIdx = line.indexOf(":");
|
|
109
|
+
if (colonIdx !== -1) {
|
|
110
|
+
const key = line.substring(0, colonIdx).trim().toLowerCase();
|
|
111
|
+
const val = line.substring(colonIdx + 1).trim();
|
|
112
|
+
headers[key] = val;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
lib.symbols.zclient_response_free(respPtr);
|
|
118
|
+
|
|
119
|
+
parentPort?.postMessage({
|
|
120
|
+
id,
|
|
121
|
+
success: true,
|
|
122
|
+
response: {
|
|
123
|
+
status,
|
|
124
|
+
body: bodyString,
|
|
125
|
+
headers,
|
|
126
|
+
},
|
|
127
|
+
});
|
|
128
|
+
} catch (err: any) {
|
|
129
|
+
parentPort?.postMessage({
|
|
130
|
+
id,
|
|
131
|
+
success: false,
|
|
132
|
+
error: err.message,
|
|
133
|
+
});
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
);
|
|
137
|
+
}
|
package/index.ts
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* jiren - Ultra-fast HTTP/HTTPS client powered by native Zig
|
|
3
|
+
*
|
|
4
|
+
* Faster than any other HTTP/HTTPS client | 1.5M+ requests/sec
|
|
5
|
+
*
|
|
6
|
+
* @example
|
|
7
|
+
* ```typescript
|
|
8
|
+
* import { JirenClient } from 'jiren';
|
|
9
|
+
*
|
|
10
|
+
* const client = new JirenClient();
|
|
11
|
+
*
|
|
12
|
+
* // High-performance batch requests
|
|
13
|
+
* const result = client.batch('http://localhost:3000/', {
|
|
14
|
+
* count: 10000,
|
|
15
|
+
* threads: 100
|
|
16
|
+
* });
|
|
17
|
+
*
|
|
18
|
+
* console.log(`Success: ${result.success}/${result.total}`);
|
|
19
|
+
* console.log(`Speed: ${result.requestsPerSecond.toFixed(0)} req/sec`);
|
|
20
|
+
* ```
|
|
21
|
+
*
|
|
22
|
+
* @packageDocumentation
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
// Main client
|
|
26
|
+
export { JirenClient } from "./components";
|
|
27
|
+
|
|
28
|
+
// Types
|
|
29
|
+
export * from "./types";
|
package/lib/libhttpclient.dylib
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,24 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "jiren",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.1",
|
|
4
4
|
"author": "",
|
|
5
|
-
"main": "
|
|
6
|
-
"module": "
|
|
7
|
-
"types": "
|
|
5
|
+
"main": "index.ts",
|
|
6
|
+
"module": "index.ts",
|
|
7
|
+
"types": "index.ts",
|
|
8
8
|
"devDependencies": {
|
|
9
|
-
"@types/bun": "^1.3.4"
|
|
10
|
-
"@types/node": "^20",
|
|
11
|
-
"bun-types": "^1.3.4"
|
|
9
|
+
"@types/bun": "^1.3.4"
|
|
12
10
|
},
|
|
13
11
|
"peerDependencies": {
|
|
14
12
|
"typescript": "^5"
|
|
15
13
|
},
|
|
16
|
-
"description": "Jiren is a high-performance HTTP/HTTPS client
|
|
14
|
+
"description": "Jiren is a high-performance HTTP/HTTPS client, Faster than any other HTTP/HTTPS client.",
|
|
17
15
|
"files": [
|
|
18
|
-
"
|
|
16
|
+
"index.ts",
|
|
17
|
+
"types",
|
|
19
18
|
"lib",
|
|
20
|
-
"components"
|
|
21
|
-
"types"
|
|
19
|
+
"components"
|
|
22
20
|
],
|
|
23
21
|
"keywords": [
|
|
24
22
|
"http",
|
|
@@ -30,14 +28,11 @@
|
|
|
30
28
|
"benchmark",
|
|
31
29
|
"performance",
|
|
32
30
|
"bun",
|
|
33
|
-
"node",
|
|
34
31
|
"parser"
|
|
35
32
|
],
|
|
36
33
|
"license": "MIT",
|
|
37
34
|
"scripts": {
|
|
38
35
|
"build:zig": "cd .. && zig build --release=fast",
|
|
39
|
-
"build": "bun build ./index.ts --outdir dist --target bun",
|
|
40
|
-
"prepare": "bun run build",
|
|
41
36
|
"test": "bun run examples/basic.ts"
|
|
42
37
|
},
|
|
43
38
|
"engines": {
|
package/types/index.ts
CHANGED
|
@@ -23,27 +23,18 @@ export interface BatchResult {
|
|
|
23
23
|
requestsPerSecond: number;
|
|
24
24
|
}
|
|
25
25
|
|
|
26
|
-
/** Options for single HTTP requests */
|
|
27
26
|
/** Options for single HTTP requests */
|
|
28
27
|
export interface RequestOptions {
|
|
29
28
|
/** HTTP method (default: GET) */
|
|
30
|
-
method?:
|
|
29
|
+
method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD";
|
|
31
30
|
/** Request headers */
|
|
32
31
|
headers?: Record<string, string>;
|
|
33
32
|
/** Request body (for POST, PUT, PATCH) */
|
|
34
33
|
body?: string | object;
|
|
35
34
|
/** Request timeout in milliseconds */
|
|
36
35
|
timeout?: number;
|
|
37
|
-
/** Maximum number of redirects to follow (default: 0) */
|
|
38
|
-
maxRedirects?: number;
|
|
39
36
|
}
|
|
40
37
|
|
|
41
|
-
/** Options for requests without a body (GET, DELETE, HEAD) */
|
|
42
|
-
export type GetRequestOptions = Omit<RequestOptions, "method" | "body">;
|
|
43
|
-
|
|
44
|
-
/** Options for requests with a body (POST, PUT, PATCH) where body is a separate argument */
|
|
45
|
-
export type PostRequestOptions = Omit<RequestOptions, "method" | "body">;
|
|
46
|
-
|
|
47
38
|
/** HTTP Response */
|
|
48
39
|
export interface HttpResponse {
|
|
49
40
|
/** HTTP status code */
|
|
@@ -52,8 +43,6 @@ export interface HttpResponse {
|
|
|
52
43
|
body: string;
|
|
53
44
|
/** Response headers */
|
|
54
45
|
headers?: Record<string, string>;
|
|
55
|
-
/** Helper to parse JSON body */
|
|
56
|
-
json: <T = any>() => T;
|
|
57
46
|
}
|
|
58
47
|
|
|
59
48
|
/** Configuration for JirenHttpClient */
|
package/components/client-bun.ts
DELETED
|
@@ -1,188 +0,0 @@
|
|
|
1
|
-
import { CString, type Pointer } from "bun:ffi";
|
|
2
|
-
import { lib } from "./native";
|
|
3
|
-
import type {
|
|
4
|
-
RequestOptions,
|
|
5
|
-
GetRequestOptions,
|
|
6
|
-
PostRequestOptions,
|
|
7
|
-
HttpResponse,
|
|
8
|
-
} from "../types";
|
|
9
|
-
|
|
10
|
-
export class JirenClient {
|
|
11
|
-
private ptr: Pointer | null;
|
|
12
|
-
|
|
13
|
-
constructor() {
|
|
14
|
-
this.ptr = lib.symbols.zclient_new();
|
|
15
|
-
if (!this.ptr) throw new Error("Failed to create native client instance");
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
/**
|
|
19
|
-
* Free the native client resources.
|
|
20
|
-
* Must be called when the client is no longer needed.
|
|
21
|
-
*/
|
|
22
|
-
public close(): void {
|
|
23
|
-
if (this.ptr) {
|
|
24
|
-
lib.symbols.zclient_free(this.ptr);
|
|
25
|
-
this.ptr = null;
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* Perform a HTTP request.
|
|
31
|
-
* @param url - The URL to request
|
|
32
|
-
* @param options - Request options (method, headers, body)
|
|
33
|
-
* @returns Response object
|
|
34
|
-
*/
|
|
35
|
-
public request(url: string, options: RequestOptions = {}): HttpResponse {
|
|
36
|
-
if (!this.ptr) throw new Error("Client is closed");
|
|
37
|
-
|
|
38
|
-
const method = options.method || "GET";
|
|
39
|
-
const methodBuffer = Buffer.from(method + "\0");
|
|
40
|
-
const urlBuffer = Buffer.from(url + "\0");
|
|
41
|
-
|
|
42
|
-
let headersBuffer: Buffer | null = null;
|
|
43
|
-
if (options.headers) {
|
|
44
|
-
const headerStr = Object.entries(options.headers)
|
|
45
|
-
.map(([k, v]) => `${k.toLowerCase()}: ${v}`)
|
|
46
|
-
.join("\r\n");
|
|
47
|
-
if (headerStr.length > 0) {
|
|
48
|
-
headersBuffer = Buffer.from(headerStr + "\0");
|
|
49
|
-
}
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
let bodyBuffer: Buffer | null = null;
|
|
53
|
-
if (options.body) {
|
|
54
|
-
const bodyStr =
|
|
55
|
-
typeof options.body === "string"
|
|
56
|
-
? options.body
|
|
57
|
-
: JSON.stringify(options.body);
|
|
58
|
-
bodyBuffer = Buffer.from(bodyStr + "\0");
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
const respPtr = lib.symbols.zclient_request(
|
|
62
|
-
this.ptr,
|
|
63
|
-
methodBuffer,
|
|
64
|
-
urlBuffer,
|
|
65
|
-
headersBuffer,
|
|
66
|
-
bodyBuffer
|
|
67
|
-
);
|
|
68
|
-
|
|
69
|
-
const response = this.parseResponse(respPtr);
|
|
70
|
-
|
|
71
|
-
// Handle Redirects
|
|
72
|
-
if (
|
|
73
|
-
options.maxRedirects &&
|
|
74
|
-
options.maxRedirects > 0 &&
|
|
75
|
-
response.status >= 300 &&
|
|
76
|
-
response.status < 400 &&
|
|
77
|
-
response.headers &&
|
|
78
|
-
response.headers["location"]
|
|
79
|
-
) {
|
|
80
|
-
const location = response.headers["location"];
|
|
81
|
-
const newUrl = new URL(location, url).toString(); // Resolve relative URLs
|
|
82
|
-
const newOptions = { ...options, maxRedirects: options.maxRedirects - 1 };
|
|
83
|
-
|
|
84
|
-
return this.request(newUrl, newOptions);
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
return response;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
public get(url: string, options: GetRequestOptions = {}) {
|
|
91
|
-
return this.request(url, { ...options, method: "GET" });
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
public post(
|
|
95
|
-
url: string,
|
|
96
|
-
body: string | object,
|
|
97
|
-
options: PostRequestOptions = {}
|
|
98
|
-
) {
|
|
99
|
-
return this.request(url, { ...options, method: "POST", body });
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
public put(
|
|
103
|
-
url: string,
|
|
104
|
-
body: string | object,
|
|
105
|
-
options: PostRequestOptions = {}
|
|
106
|
-
) {
|
|
107
|
-
return this.request(url, { ...options, method: "PUT", body });
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
public delete(url: string, options: GetRequestOptions = {}) {
|
|
111
|
-
return this.request(url, { ...options, method: "DELETE" });
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
public patch(
|
|
115
|
-
url: string,
|
|
116
|
-
body: string | object,
|
|
117
|
-
options: PostRequestOptions = {}
|
|
118
|
-
) {
|
|
119
|
-
return this.request(url, { ...options, method: "PATCH", body });
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
public head(url: string, options: GetRequestOptions = {}) {
|
|
123
|
-
return this.request(url, { ...options, method: "HEAD" });
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
/**
|
|
127
|
-
* Prefetch URLs to warm up connections (resolve DNS & Handshake).
|
|
128
|
-
* @param urls - List of URLs to prefetch
|
|
129
|
-
*/
|
|
130
|
-
public prefetch(urls: string[]) {
|
|
131
|
-
if (!this.ptr) throw new Error("Client is closed");
|
|
132
|
-
|
|
133
|
-
for (const url of urls) {
|
|
134
|
-
const urlBuffer = Buffer.from(url + "\0");
|
|
135
|
-
lib.symbols.zclient_prefetch(this.ptr, urlBuffer);
|
|
136
|
-
}
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
private parseResponse(respPtr: Pointer | null) {
|
|
140
|
-
if (!respPtr)
|
|
141
|
-
throw new Error("Native request failed (returned null pointer)");
|
|
142
|
-
|
|
143
|
-
try {
|
|
144
|
-
const status = lib.symbols.zclient_response_status(respPtr);
|
|
145
|
-
const bodyLen = Number(lib.symbols.zclient_response_body_len(respPtr));
|
|
146
|
-
const bodyPtr = lib.symbols.zclient_response_body(respPtr);
|
|
147
|
-
const headersLen = Number(
|
|
148
|
-
lib.symbols.zclient_response_headers_len(respPtr)
|
|
149
|
-
);
|
|
150
|
-
const headersPtr = lib.symbols.zclient_response_headers(respPtr);
|
|
151
|
-
|
|
152
|
-
let bodyString = "";
|
|
153
|
-
if (bodyLen > 0 && bodyPtr) {
|
|
154
|
-
// CString uses the full length if not null-terminated or we can just read the ptr
|
|
155
|
-
// Since we know the length, we can be more precise, but CString assumes null-terminated
|
|
156
|
-
// for now we trust it is null terminated from Zig
|
|
157
|
-
bodyString = new CString(bodyPtr).toString();
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
const headers: Record<string, string> = {};
|
|
161
|
-
if (headersLen > 0 && headersPtr) {
|
|
162
|
-
const headersStr = new CString(headersPtr).toString();
|
|
163
|
-
const lines = headersStr.split("\r\n");
|
|
164
|
-
for (const line of lines) {
|
|
165
|
-
if (!line) continue;
|
|
166
|
-
const colonIdx = line.indexOf(":");
|
|
167
|
-
if (colonIdx !== -1) {
|
|
168
|
-
const key = line.substring(0, colonIdx).trim().toLowerCase();
|
|
169
|
-
const val = line.substring(colonIdx + 1).trim();
|
|
170
|
-
headers[key] = val;
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
return {
|
|
176
|
-
status,
|
|
177
|
-
body: bodyString,
|
|
178
|
-
headers,
|
|
179
|
-
json: <T = any>() => {
|
|
180
|
-
if (!bodyString) return null as T;
|
|
181
|
-
return JSON.parse(bodyString) as T;
|
|
182
|
-
},
|
|
183
|
-
};
|
|
184
|
-
} finally {
|
|
185
|
-
lib.symbols.zclient_response_free(respPtr);
|
|
186
|
-
}
|
|
187
|
-
}
|
|
188
|
-
}
|
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
RequestOptions,
|
|
3
|
-
GetRequestOptions,
|
|
4
|
-
PostRequestOptions,
|
|
5
|
-
HttpResponse,
|
|
6
|
-
} from "../types/index.js";
|
|
7
|
-
|
|
8
|
-
/**
|
|
9
|
-
* Node.js fallback client using native fetch
|
|
10
|
-
*/
|
|
11
|
-
export class NodeJirenClient {
|
|
12
|
-
constructor() {
|
|
13
|
-
// No initialization needed for Node.js fetch
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
public close(): void {
|
|
17
|
-
// No cleanup needed
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
public async request(
|
|
21
|
-
url: string,
|
|
22
|
-
options: RequestOptions = {}
|
|
23
|
-
): Promise<HttpResponse> {
|
|
24
|
-
const method = options.method || "GET";
|
|
25
|
-
const headers = options.headers || {};
|
|
26
|
-
|
|
27
|
-
const fetchOptions: RequestInit = {
|
|
28
|
-
method,
|
|
29
|
-
headers,
|
|
30
|
-
redirect:
|
|
31
|
-
options.maxRedirects && options.maxRedirects > 0 ? "follow" : "manual",
|
|
32
|
-
};
|
|
33
|
-
|
|
34
|
-
if (options.body) {
|
|
35
|
-
fetchOptions.body =
|
|
36
|
-
typeof options.body === "string"
|
|
37
|
-
? options.body
|
|
38
|
-
: JSON.stringify(options.body);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
try {
|
|
42
|
-
const response = await fetch(url, fetchOptions);
|
|
43
|
-
const body = await response.text();
|
|
44
|
-
|
|
45
|
-
// Convert Headers to plain object
|
|
46
|
-
const responseHeaders: Record<string, string> = {};
|
|
47
|
-
response.headers.forEach((value, key) => {
|
|
48
|
-
responseHeaders[key.toLowerCase()] = value;
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
return {
|
|
52
|
-
status: response.status,
|
|
53
|
-
body,
|
|
54
|
-
headers: responseHeaders,
|
|
55
|
-
json: <T = any>() => {
|
|
56
|
-
if (!body) return null as T;
|
|
57
|
-
return JSON.parse(body) as T;
|
|
58
|
-
},
|
|
59
|
-
};
|
|
60
|
-
} catch (error) {
|
|
61
|
-
throw new Error(`HTTP request failed: ${error}`);
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
public async get(url: string, options: GetRequestOptions = {}) {
|
|
66
|
-
return this.request(url, { ...options, method: "GET" });
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
public async post(
|
|
70
|
-
url: string,
|
|
71
|
-
body: string | object,
|
|
72
|
-
options: PostRequestOptions = {}
|
|
73
|
-
) {
|
|
74
|
-
return this.request(url, { ...options, method: "POST", body });
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
public async put(
|
|
78
|
-
url: string,
|
|
79
|
-
body: string | object,
|
|
80
|
-
options: PostRequestOptions = {}
|
|
81
|
-
) {
|
|
82
|
-
return this.request(url, { ...options, method: "PUT", body });
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
public async delete(url: string, options: GetRequestOptions = {}) {
|
|
86
|
-
return this.request(url, { ...options, method: "DELETE" });
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
public async patch(
|
|
90
|
-
url: string,
|
|
91
|
-
body: string | object,
|
|
92
|
-
options: PostRequestOptions = {}
|
|
93
|
-
) {
|
|
94
|
-
return this.request(url, { ...options, method: "PATCH", body });
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
public async head(url: string, options: GetRequestOptions = {}) {
|
|
98
|
-
return this.request(url, { ...options, method: "HEAD" });
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
public prefetch(urls: string[]) {
|
|
102
|
-
// No-op in Node.js
|
|
103
|
-
// Could implement DNS prefetch here if needed
|
|
104
|
-
}
|
|
105
|
-
}
|
package/components/runtime.ts
DELETED
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
// Runtime detection
|
|
2
|
-
export const isBun = typeof Bun !== "undefined";
|
|
3
|
-
export const isNode = !isBun && typeof process !== "undefined";
|
|
4
|
-
|
|
5
|
-
// Re-export types
|
|
6
|
-
export type {
|
|
7
|
-
HttpResponse,
|
|
8
|
-
RequestOptions,
|
|
9
|
-
GetRequestOptions,
|
|
10
|
-
PostRequestOptions,
|
|
11
|
-
} from "../types/index.js";
|
package/dist/index.js
DELETED
|
@@ -1,271 +0,0 @@
|
|
|
1
|
-
// @bun
|
|
2
|
-
var __defProp = Object.defineProperty;
|
|
3
|
-
var __export = (target, all) => {
|
|
4
|
-
for (var name in all)
|
|
5
|
-
__defProp(target, name, {
|
|
6
|
-
get: all[name],
|
|
7
|
-
enumerable: true,
|
|
8
|
-
configurable: true,
|
|
9
|
-
set: (newValue) => all[name] = () => newValue
|
|
10
|
-
});
|
|
11
|
-
};
|
|
12
|
-
var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
|
|
13
|
-
|
|
14
|
-
// components/native.ts
|
|
15
|
-
import { dlopen, FFIType, suffix } from "bun:ffi";
|
|
16
|
-
import { join } from "path";
|
|
17
|
-
var libPath, ffiDef, lib;
|
|
18
|
-
var init_native = __esm(() => {
|
|
19
|
-
libPath = join(import.meta.dir, `../lib/libhttpclient.${suffix}`);
|
|
20
|
-
ffiDef = {
|
|
21
|
-
zclient_new: {
|
|
22
|
-
args: [],
|
|
23
|
-
returns: FFIType.ptr
|
|
24
|
-
},
|
|
25
|
-
zclient_free: {
|
|
26
|
-
args: [FFIType.ptr],
|
|
27
|
-
returns: FFIType.void
|
|
28
|
-
},
|
|
29
|
-
zclient_get: {
|
|
30
|
-
args: [FFIType.ptr, FFIType.cstring],
|
|
31
|
-
returns: FFIType.ptr
|
|
32
|
-
},
|
|
33
|
-
zclient_post: {
|
|
34
|
-
args: [FFIType.ptr, FFIType.cstring, FFIType.cstring],
|
|
35
|
-
returns: FFIType.ptr
|
|
36
|
-
},
|
|
37
|
-
zclient_prefetch: {
|
|
38
|
-
args: [FFIType.ptr, FFIType.cstring],
|
|
39
|
-
returns: FFIType.void
|
|
40
|
-
},
|
|
41
|
-
zclient_response_status: {
|
|
42
|
-
args: [FFIType.ptr],
|
|
43
|
-
returns: FFIType.u16
|
|
44
|
-
},
|
|
45
|
-
zclient_response_body: {
|
|
46
|
-
args: [FFIType.ptr],
|
|
47
|
-
returns: FFIType.ptr
|
|
48
|
-
},
|
|
49
|
-
zclient_response_body_len: {
|
|
50
|
-
args: [FFIType.ptr],
|
|
51
|
-
returns: FFIType.u64
|
|
52
|
-
},
|
|
53
|
-
zclient_response_headers: {
|
|
54
|
-
args: [FFIType.ptr],
|
|
55
|
-
returns: FFIType.ptr
|
|
56
|
-
},
|
|
57
|
-
zclient_response_headers_len: {
|
|
58
|
-
args: [FFIType.ptr],
|
|
59
|
-
returns: FFIType.u64
|
|
60
|
-
},
|
|
61
|
-
zclient_response_free: {
|
|
62
|
-
args: [FFIType.ptr],
|
|
63
|
-
returns: FFIType.void
|
|
64
|
-
},
|
|
65
|
-
zclient_request: {
|
|
66
|
-
args: [
|
|
67
|
-
FFIType.ptr,
|
|
68
|
-
FFIType.cstring,
|
|
69
|
-
FFIType.cstring,
|
|
70
|
-
FFIType.cstring,
|
|
71
|
-
FFIType.cstring
|
|
72
|
-
],
|
|
73
|
-
returns: FFIType.ptr
|
|
74
|
-
}
|
|
75
|
-
};
|
|
76
|
-
lib = dlopen(libPath, ffiDef);
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
// components/client-bun.ts
|
|
80
|
-
var exports_client_bun = {};
|
|
81
|
-
__export(exports_client_bun, {
|
|
82
|
-
JirenClient: () => JirenClient
|
|
83
|
-
});
|
|
84
|
-
import { CString } from "bun:ffi";
|
|
85
|
-
|
|
86
|
-
class JirenClient {
|
|
87
|
-
ptr;
|
|
88
|
-
constructor() {
|
|
89
|
-
this.ptr = lib.symbols.zclient_new();
|
|
90
|
-
if (!this.ptr)
|
|
91
|
-
throw new Error("Failed to create native client instance");
|
|
92
|
-
}
|
|
93
|
-
close() {
|
|
94
|
-
if (this.ptr) {
|
|
95
|
-
lib.symbols.zclient_free(this.ptr);
|
|
96
|
-
this.ptr = null;
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
request(url, options = {}) {
|
|
100
|
-
if (!this.ptr)
|
|
101
|
-
throw new Error("Client is closed");
|
|
102
|
-
const method = options.method || "GET";
|
|
103
|
-
const methodBuffer = Buffer.from(method + "\x00");
|
|
104
|
-
const urlBuffer = Buffer.from(url + "\x00");
|
|
105
|
-
let headersBuffer = null;
|
|
106
|
-
if (options.headers) {
|
|
107
|
-
const headerStr = Object.entries(options.headers).map(([k, v]) => `${k.toLowerCase()}: ${v}`).join(`\r
|
|
108
|
-
`);
|
|
109
|
-
if (headerStr.length > 0) {
|
|
110
|
-
headersBuffer = Buffer.from(headerStr + "\x00");
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
let bodyBuffer = null;
|
|
114
|
-
if (options.body) {
|
|
115
|
-
const bodyStr = typeof options.body === "string" ? options.body : JSON.stringify(options.body);
|
|
116
|
-
bodyBuffer = Buffer.from(bodyStr + "\x00");
|
|
117
|
-
}
|
|
118
|
-
const respPtr = lib.symbols.zclient_request(this.ptr, methodBuffer, urlBuffer, headersBuffer, bodyBuffer);
|
|
119
|
-
const response = this.parseResponse(respPtr);
|
|
120
|
-
if (options.maxRedirects && options.maxRedirects > 0 && response.status >= 300 && response.status < 400 && response.headers && response.headers["location"]) {
|
|
121
|
-
const location = response.headers["location"];
|
|
122
|
-
const newUrl = new URL(location, url).toString();
|
|
123
|
-
const newOptions = { ...options, maxRedirects: options.maxRedirects - 1 };
|
|
124
|
-
return this.request(newUrl, newOptions);
|
|
125
|
-
}
|
|
126
|
-
return response;
|
|
127
|
-
}
|
|
128
|
-
get(url, options = {}) {
|
|
129
|
-
return this.request(url, { ...options, method: "GET" });
|
|
130
|
-
}
|
|
131
|
-
post(url, body, options = {}) {
|
|
132
|
-
return this.request(url, { ...options, method: "POST", body });
|
|
133
|
-
}
|
|
134
|
-
put(url, body, options = {}) {
|
|
135
|
-
return this.request(url, { ...options, method: "PUT", body });
|
|
136
|
-
}
|
|
137
|
-
delete(url, options = {}) {
|
|
138
|
-
return this.request(url, { ...options, method: "DELETE" });
|
|
139
|
-
}
|
|
140
|
-
patch(url, body, options = {}) {
|
|
141
|
-
return this.request(url, { ...options, method: "PATCH", body });
|
|
142
|
-
}
|
|
143
|
-
head(url, options = {}) {
|
|
144
|
-
return this.request(url, { ...options, method: "HEAD" });
|
|
145
|
-
}
|
|
146
|
-
prefetch(urls) {
|
|
147
|
-
if (!this.ptr)
|
|
148
|
-
throw new Error("Client is closed");
|
|
149
|
-
for (const url of urls) {
|
|
150
|
-
const urlBuffer = Buffer.from(url + "\x00");
|
|
151
|
-
lib.symbols.zclient_prefetch(this.ptr, urlBuffer);
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
parseResponse(respPtr) {
|
|
155
|
-
if (!respPtr)
|
|
156
|
-
throw new Error("Native request failed (returned null pointer)");
|
|
157
|
-
try {
|
|
158
|
-
const status = lib.symbols.zclient_response_status(respPtr);
|
|
159
|
-
const bodyLen = Number(lib.symbols.zclient_response_body_len(respPtr));
|
|
160
|
-
const bodyPtr = lib.symbols.zclient_response_body(respPtr);
|
|
161
|
-
const headersLen = Number(lib.symbols.zclient_response_headers_len(respPtr));
|
|
162
|
-
const headersPtr = lib.symbols.zclient_response_headers(respPtr);
|
|
163
|
-
let bodyString = "";
|
|
164
|
-
if (bodyLen > 0 && bodyPtr) {
|
|
165
|
-
bodyString = new CString(bodyPtr).toString();
|
|
166
|
-
}
|
|
167
|
-
const headers = {};
|
|
168
|
-
if (headersLen > 0 && headersPtr) {
|
|
169
|
-
const headersStr = new CString(headersPtr).toString();
|
|
170
|
-
const lines = headersStr.split(`\r
|
|
171
|
-
`);
|
|
172
|
-
for (const line of lines) {
|
|
173
|
-
if (!line)
|
|
174
|
-
continue;
|
|
175
|
-
const colonIdx = line.indexOf(":");
|
|
176
|
-
if (colonIdx !== -1) {
|
|
177
|
-
const key = line.substring(0, colonIdx).trim().toLowerCase();
|
|
178
|
-
const val = line.substring(colonIdx + 1).trim();
|
|
179
|
-
headers[key] = val;
|
|
180
|
-
}
|
|
181
|
-
}
|
|
182
|
-
}
|
|
183
|
-
return {
|
|
184
|
-
status,
|
|
185
|
-
body: bodyString,
|
|
186
|
-
headers,
|
|
187
|
-
json: () => {
|
|
188
|
-
if (!bodyString)
|
|
189
|
-
return null;
|
|
190
|
-
return JSON.parse(bodyString);
|
|
191
|
-
}
|
|
192
|
-
};
|
|
193
|
-
} finally {
|
|
194
|
-
lib.symbols.zclient_response_free(respPtr);
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
var init_client_bun = __esm(() => {
|
|
199
|
-
init_native();
|
|
200
|
-
});
|
|
201
|
-
|
|
202
|
-
// components/client-node.ts
|
|
203
|
-
var exports_client_node = {};
|
|
204
|
-
__export(exports_client_node, {
|
|
205
|
-
NodeJirenClient: () => NodeJirenClient
|
|
206
|
-
});
|
|
207
|
-
|
|
208
|
-
class NodeJirenClient {
|
|
209
|
-
constructor() {}
|
|
210
|
-
close() {}
|
|
211
|
-
async request(url, options = {}) {
|
|
212
|
-
const method = options.method || "GET";
|
|
213
|
-
const headers = options.headers || {};
|
|
214
|
-
const fetchOptions = {
|
|
215
|
-
method,
|
|
216
|
-
headers,
|
|
217
|
-
redirect: options.maxRedirects && options.maxRedirects > 0 ? "follow" : "manual"
|
|
218
|
-
};
|
|
219
|
-
if (options.body) {
|
|
220
|
-
fetchOptions.body = typeof options.body === "string" ? options.body : JSON.stringify(options.body);
|
|
221
|
-
}
|
|
222
|
-
try {
|
|
223
|
-
const response = await fetch(url, fetchOptions);
|
|
224
|
-
const body = await response.text();
|
|
225
|
-
const responseHeaders = {};
|
|
226
|
-
response.headers.forEach((value, key) => {
|
|
227
|
-
responseHeaders[key.toLowerCase()] = value;
|
|
228
|
-
});
|
|
229
|
-
return {
|
|
230
|
-
status: response.status,
|
|
231
|
-
body,
|
|
232
|
-
headers: responseHeaders,
|
|
233
|
-
json: () => {
|
|
234
|
-
if (!body)
|
|
235
|
-
return null;
|
|
236
|
-
return JSON.parse(body);
|
|
237
|
-
}
|
|
238
|
-
};
|
|
239
|
-
} catch (error) {
|
|
240
|
-
throw new Error(`HTTP request failed: ${error}`);
|
|
241
|
-
}
|
|
242
|
-
}
|
|
243
|
-
async get(url, options = {}) {
|
|
244
|
-
return this.request(url, { ...options, method: "GET" });
|
|
245
|
-
}
|
|
246
|
-
async post(url, body, options = {}) {
|
|
247
|
-
return this.request(url, { ...options, method: "POST", body });
|
|
248
|
-
}
|
|
249
|
-
async put(url, body, options = {}) {
|
|
250
|
-
return this.request(url, { ...options, method: "PUT", body });
|
|
251
|
-
}
|
|
252
|
-
async delete(url, options = {}) {
|
|
253
|
-
return this.request(url, { ...options, method: "DELETE" });
|
|
254
|
-
}
|
|
255
|
-
async patch(url, body, options = {}) {
|
|
256
|
-
return this.request(url, { ...options, method: "PATCH", body });
|
|
257
|
-
}
|
|
258
|
-
async head(url, options = {}) {
|
|
259
|
-
return this.request(url, { ...options, method: "HEAD" });
|
|
260
|
-
}
|
|
261
|
-
prefetch(urls) {}
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
// components/runtime.ts
|
|
265
|
-
var isBun = typeof Bun !== "undefined";
|
|
266
|
-
|
|
267
|
-
// components/index.ts
|
|
268
|
-
var JirenClient2 = isBun ? (await Promise.resolve().then(() => (init_client_bun(), exports_client_bun))).JirenClient : (await Promise.resolve().then(() => exports_client_node)).NodeJirenClient;
|
|
269
|
-
export {
|
|
270
|
-
JirenClient2 as JirenClient
|
|
271
|
-
};
|