@evomap/evolver-adapter-public 2.0.0-beta.18 → 2.0.0-beta.19

package/dist/hubFetch.d.ts

@@ -9,21 +9,35 @@ export interface HubFetchResponse {
     json: () => Promise<unknown>;
     text: () => Promise<string>;
 }
-export type FetchLike = (url: string, init: {
+export interface HubFetchInit {
     method: string;
     headers: Record<string, string>;
     body?: string;
-}) => Promise<{
-    status: number;
-    headers?: HeadersLike;
-    body: unknown | null;
-    json: () => Promise<unknown>;
-    text: () => Promise<string>;
-}>;
+    signal?: AbortSignal;
+    redirect?: 'manual';
+}
+export type FetchLike = (url: string, init: HubFetchInit) => Promise<HubFetchResponse>;
 export declare const HUB_ERROR_TEXT_MAX_BYTES: number;
 export declare const HUB_JSON_TEXT_MAX_BYTES: number;
 export declare const HUB_UNREACHABLE_BACKOFF_BASE_MS = 60000;
 export declare const HUB_UNREACHABLE_BACKOFF_MAX_MS: number;
+export declare const HUB_GENERAL_TIMEOUT_MS = 15000;
+export declare const HUB_SEARCH_TIMEOUT_MS = 8000;
+export declare const HUB_HEARTBEAT_TIMEOUT_MS = 10000;
+export declare const HUB_EVENT_POLL_TIMEOUT_MS = 60000;
+export declare const HUB_HELLO_TIMEOUT_MS = 15000;
+export interface HubOperationTimeouts {
+    generalMs: number;
+    searchMs: number;
+    heartbeatMs: number;
+    pollMs: number;
+    helloMs: number;
+}
+export type HubOperation = 'general' | 'search' | 'heartbeat' | 'poll' | 'hello';
+export interface HubDeadlineScheduler {
+    set(callback: () => void, delayMs: number): unknown;
+    clear(handle: unknown): void;
+}
 export declare class AuthError extends Error {
     readonly status: number;
     readonly body?: unknown | undefined;
@@ -33,7 +47,8 @@ export declare class AuthError extends Error {
 export declare class HubClientError extends Error {
     readonly status: number;
     readonly body: unknown;
-    constructor(status: number, body: unknown);
+    readonly retryAfterMs?: number | undefined;
+    constructor(status: number, body: unknown, retryAfterMs?: number | undefined);
 }
 export declare class HubUnreachableError extends Error {
     readonly details: {
@@ -42,6 +57,8 @@ export declare class HubUnreachableError extends Error {
         bodySnippet?: string;
         context?: string;
         retryAfterMs?: number;
+        operation?: HubOperation;
+        timeoutMs?: number;
     };
     readonly code = "HUB_UNREACHABLE";
     constructor(message: string, details?: {
@@ -50,6 +67,8 @@ export declare class HubUnreachableError extends Error {
         bodySnippet?: string;
         context?: string;
         retryAfterMs?: number;
+        operation?: HubOperation;
+        timeoutMs?: number;
     });
     get retryAfterMs(): number;
 }
@@ -58,6 +77,11 @@ export interface HubFetchDeps {
     auth: hub.AuthProvider;
     fetchFn: FetchLike;
     senderId: () => string | undefined;
+    now?: () => number;
+    env?: Record<string, string | undefined>;
+    operationTimeouts?: Partial<HubOperationTimeouts>;
+    authTimeoutMs?: number;
+    deadlineScheduler?: HubDeadlineScheduler;
 }
 /**
  * 公版 hub HTTP 客户端(M6-6). 每请求经 AuthProvider 取凭证: POST 通常注入 body; GET 与 strict hello envelope
@@ -68,20 +92,27 @@ export interface HubFetchDeps {
  */
 export declare class HubFetch {
     private readonly deps;
+    private readonly operationTimeouts;
+    private readonly deadlineScheduler;
     constructor(deps: HubFetchDeps);
     call<T>(method: string, path: string, bodyObj?: Record<string, unknown>, query?: Record<string, string | number | undefined>, requestHeaders?: Readonly<Record<string, string>>): Promise<T>;
 }
+export declare function resolveHubOperationTimeouts(env?: Record<string, string | undefined>, overrides?: Partial<HubOperationTimeouts>): HubOperationTimeouts;
 export declare function hubResponseContentType(res: Pick<HubFetchResponse, 'headers'> | undefined): string;
 export declare function isHubApiResponse(res: Pick<HubFetchResponse, 'headers'> | undefined): boolean;
 export declare function hubUnreachableBackoffMs(failureCount: number): number;
 export declare function isHubUnreachableError(err: unknown): boolean;
 export declare function isHubUnreachableResponse(res: Pick<HubFetchResponse, 'headers'> | undefined): boolean;
-export declare function drainHubResponse(res: Pick<HubFetchResponse, 'body'> | undefined): Promise<void>;
+export declare function drainHubResponse(res: Pick<HubFetchResponse, 'body'> | undefined, opts?: {
+    signal?: AbortSignal;
+}): Promise<void>;
 export declare function readHubResponseText(res: Pick<HubFetchResponse, 'body' | 'text'>, opts?: {
     maxBytes?: number;
+    signal?: AbortSignal;
 }): Promise<string>;
 export declare function readHubResponseJson(res: Pick<HubFetchResponse, 'body' | 'text'>, opts?: {
     maxBytes?: number;
+    signal?: AbortSignal;
 }): Promise<unknown>;
 export declare function throwIfHubUnreachableResponse(res: HubFetchResponse, context?: string): Promise<void>;
 /** https-only scheme guard: throws on invalid URL or non-https (unless the escape hatch is set). Called at both request and transport layers (defense in depth). */
@@ -89,6 +120,7 @@ export declare function assertHubUrlSecure(url: string, env?: Record<string, str
 export type HubIpFamilyPolicy = 'ipv4first' | 'ipv4only' | 'auto';
 export declare const HUB_CONNECT_TIMEOUT_MS = 10000;
 export declare const HUB_IPV4FIRST_PRIMARY_CONNECT_TIMEOUT_MS = 2500;
+export declare const HUB_TCP_KEEPALIVE_IDLE_MS = 15000;
 interface HubConnectOptions {
     rejectUnauthorized: true;
     timeout: number;
@@ -107,6 +139,7 @@ export interface HubFetchTransportConfig {
 export declare function resolveHubIpFamily(env?: Record<string, string | undefined>): HubIpFamilyPolicy;
 export declare function _getHubFetchConfigForTest(env?: Record<string, string | undefined>): HubFetchTransportConfig;
 export declare function _shouldFallbackFromIpv4ForTest(err: unknown, hubIpFamily?: HubIpFamilyPolicy): boolean;
+export declare function _configureHubSocketForTest(socket: unknown): void;
 type RawFetch = (url: string, init: Record<string, unknown>) => Promise<HubFetchResponse>;
 export declare function _setFetchImplForTest(fn?: RawFetch): void;
 /** Test seam: reset the one-time insecure-warning latch. */