jiren 1.5.5 → 1.6.5

package/dist/components/client-node-native.d.ts

@@ -0,0 +1,134 @@
+import type { RequestOptions, JirenResponse, TargetUrlConfig, UrlEndpoint, CacheConfig, RetryConfig, Interceptors, MetricsAPI } from "./types.js";
+/** URL configuration with optional cache and antibot */
+export type UrlConfig = string | {
+    url: string;
+    cache?: boolean | CacheConfig;
+    antibot?: boolean;
+};
+/** Options for JirenClient constructor */
+export interface JirenClientOptions<T extends readonly TargetUrlConfig[] | Record<string, UrlConfig> = readonly TargetUrlConfig[] | Record<string, UrlConfig>> {
+    /** Target URLs to pre-connect on client creation */
+    targets?: string[] | T;
+    /** Enable benchmark mode (Force HTTP/2, disable probing) */
+    benchmark?: boolean;
+    /** Global retry configuration */
+    retry?: number | RetryConfig;
+    /** Request/response interceptors */
+    interceptors?: Interceptors;
+    /** Performance mode: disable metrics, skip cache checks for non-cached endpoints (default: true) */
+    performanceMode?: boolean;
+    /** Enable default browser emulation headers (default: true) */
+    defaultHeaders?: boolean;
+}
+export type ExtractTargetKeys<T extends readonly TargetUrlConfig[] | Record<string, UrlConfig>> = T extends readonly TargetUrlConfig[] ? T[number]["key"] : T extends Record<string, UrlConfig> ? keyof T : never;
+export type UrlAccessor<T extends readonly TargetUrlConfig[] | Record<string, UrlConfig>> = {
+    [K in ExtractTargetKeys<T>]: UrlEndpoint;
+};
+/**
+ * Helper to define target URLs with type inference.
+ */
+export declare function defineUrls<const T extends readonly TargetUrlConfig[]>(urls: T): T;
+export declare class JirenClient<T extends readonly TargetUrlConfig[] | Record<string, UrlConfig> = readonly TargetUrlConfig[] | Record<string, UrlConfig>> implements Disposable {
+    private ptr;
+    private urlMap;
+    private cacheConfig;
+    private antibotConfig;
+    private cache;
+    private inflightRequests;
+    private globalRetry?;
+    private requestInterceptors;
+    private responseInterceptors;
+    private errorInterceptors;
+    private targetsPromise;
+    private targetsComplete;
+    private performanceMode;
+    private useDefaultHeaders;
+    private readonly defaultHeadersStr;
+    private readonly defaultHeaders;
+    /** Type-safe URL accessor for warmed-up URLs */
+    readonly url: UrlAccessor<T>;
+    private metricsCollector;
+    /** Public metrics API */
+    readonly metrics: MetricsAPI;
+    constructor(options?: JirenClientOptions<T>);
+    private waitFor;
+    /**
+     * Wait for lazy pre-connection to complete.
+     */
+    waitForTargets(): Promise<void>;
+    /**
+     * @deprecated Use waitForTargets() instead
+     */
+    waitForWarmup(): Promise<void>;
+    /**
+     * Creates a proxy-based URL accessor for type-safe access.
+     */
+    private createUrlAccessor;
+    /**
+     * Free the native client resources.
+     * Note: This is called automatically when the client is garbage collected,
+     * or you can use the `using` keyword for automatic cleanup in a scope.
+     */
+    close(): void;
+    /**
+     * Dispose method for the `using` keyword (ECMAScript Explicit Resource Management)
+     * @example
+     * ```typescript
+     * using client = new JirenClient({ targets: [...] });
+     * // client is automatically closed when the scope ends
+     * ```
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Register interceptors dynamically.
+     */
+    use(interceptors: Interceptors): this;
+    /**
+     * Pre-connect to URLs in parallel.
+     */
+    preconnect(urls: string[]): Promise<void>;
+    /**
+     * @deprecated Use preconnect() instead
+     */
+    warmup(urls: string[]): Promise<void>;
+    /**
+     * @deprecated Use preconnect() instead
+     */
+    prefetch(urls: string[]): void;
+    /**
+     * Pre-warm a single URL (establishes connection, caches DNS, TLS session)
+     * Call this before making requests to eliminate first-request latency.
+     */
+    prewarm(url: string): Promise<void>;
+    /**
+     * Execute multiple requests in a single pipelined batch (100k+ RPS)
+     * All requests must go to the same host.
+     * @param host - The host (e.g., "localhost")
+     * @param port - The port (e.g., 4000)
+     * @param requests - Array of { method, path } objects
+     * @returns Array of response bodies as strings
+     */
+    batch(host: string, port: number, requests: Array<{
+        method: string;
+        path: string;
+    }>): string[];
+    request<T = any>(method: string, url: string, body?: string | null, options?: RequestOptions & {
+        responseType: "json";
+    }): Promise<T>;
+    request<T = any>(method: string, url: string, body?: string | null, options?: RequestOptions & {
+        responseType: "text";
+    }): Promise<string>;
+    request<T = any>(method: string, url: string, body?: string | null, options?: RequestOptions & {
+        responseType: "arraybuffer";
+    }): Promise<ArrayBuffer>;
+    request<T = any>(method: string, url: string, body?: string | null, options?: RequestOptions & {
+        responseType: "blob";
+    }): Promise<Blob>;
+    request<T = any>(method: string, url: string, body?: string | null, options?: RequestOptions): Promise<JirenResponse<T>>;
+    private parseResponse;
+    /**
+     * Helper to prepare body and headers for requests.
+     */
+    private prepareBody;
+}
+//# sourceMappingURL=client-node-native.d.ts.map

package/dist/components/client-node-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-node-native.d.ts","sourceRoot":"","sources":["../../components/client-node-native.ts"],"names":[],"mappings":"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"}