@i.un/api-client 1.1.1 → 1.1.3

package/dist/client.js

@@ -0,0 +1,205 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  createApiClient: () => createApiClient,
+  isApiError: () => isApiError
+});
+module.exports = __toCommonJS(client_exports);
+var import_ofetch = require("ofetch");
+var isApiError = (error) => {
+  return error instanceof Error && "code" in error;
+};
+var defaultUnwrapResponse = (result, returnFullResponse = false) => {
+  if (result && typeof result === "object" && "code" in result) {
+    const body = result;
+    if (body.code === 0) {
+      return returnFullResponse ? body : body.data;
+    }
+  }
+  return result;
+};
+var defaultCreateErrorFromResult = (res) => {
+  const error = new Error(res.message || "Request failed");
+  error.code = res.code;
+  error.data = res.data;
+  return error;
+};
+var extractAccessToken = (data) => {
+  if (typeof data === "string" && data) {
+    return data;
+  }
+  if (!data || typeof data !== "object") {
+    throw new Error(
+      "Invalid refresh token response: data is not an object or string"
+    );
+  }
+  const anyData = data;
+  const accessToken = anyData.access_token ?? anyData.accessToken ?? anyData.token;
+  if (typeof accessToken === "string" && accessToken) {
+    return accessToken;
+  }
+  throw new Error(
+    "Invalid refresh token response: no access_token or token field found"
+  );
+};
+var refreshingPromises = /* @__PURE__ */ new WeakMap();
+function createApiClient(options) {
+  const {
+    baseURL,
+    tokenStorage,
+    refreshToken = false,
+    retry = 1,
+    retryDelay = 1e3,
+    isAuthError = (code) => code === 401,
+    unwrapResponse = defaultUnwrapResponse,
+    createErrorFromResult = defaultCreateErrorFromResult
+  } = options;
+  const refreshTokenFn = !refreshToken ? null : typeof refreshToken === "string" ? async () => {
+    const res = await (0, import_ofetch.ofetch)(refreshToken, {
+      baseURL,
+      method: "POST",
+      retry,
+      retryDelay
+    });
+    if (res.code !== 0) {
+      throw createErrorFromResult(res);
+    }
+    return extractAccessToken(res.data);
+  } : refreshToken;
+  const rawRequest = import_ofetch.ofetch.create({
+    baseURL,
+    retry,
+    retryDelay,
+    async onRequest(context) {
+      const { options: reqOptions } = context;
+      const token = await tokenStorage.getAccessToken();
+      const headers = new Headers(
+        reqOptions.headers
+      );
+      if (token) {
+        headers.set("Authorization", `Bearer ${token}`);
+      }
+      reqOptions.headers = headers;
+      if (options.onRequest) {
+        await options.onRequest(context);
+      }
+    },
+    async onResponse(context) {
+      const { response } = context;
+      if (response.status === 204) {
+        response._data = null;
+        return;
+      }
+      if (options.onResponse) {
+        await options.onResponse(context);
+      }
+    },
+    async onResponseError(context) {
+      const { response } = context;
+      const message = response?._data?.message || `HTTP ${response?.status || "Network Error"}`;
+      const error = new Error(message);
+      error.status = response?.status;
+      error.data = response?._data;
+      throw error;
+    }
+  });
+  async function request(url, options2 = {}) {
+    const { returnFullResponse, _retry, ...fetchOptions } = options2;
+    const res = await rawRequest(url, fetchOptions);
+    if (res.code === 0) {
+      return unwrapResponse(res, !!returnFullResponse);
+    }
+    if (isAuthError(res.code) && !_retry && refreshTokenFn) {
+      try {
+        let refreshingPromise = refreshingPromises.get(tokenStorage);
+        if (!refreshingPromise) {
+          refreshingPromise = refreshTokenFn().finally(() => {
+            refreshingPromises.delete(tokenStorage);
+          });
+          refreshingPromises.set(tokenStorage, refreshingPromise);
+        }
+        const newToken = await refreshingPromise;
+        if (newToken) {
+          await tokenStorage.setAccessToken(newToken);
+        }
+        return await request(url, {
+          ...options2 || {},
+          _retry: true
+        });
+      } catch (e) {
+        await tokenStorage.setAccessToken("");
+        throw createErrorFromResult(res);
+      }
+    }
+    throw createErrorFromResult(res);
+  }
+  async function get(url, params = {}, options2) {
+    return request(url, {
+      ...options2,
+      method: "GET",
+      query: params
+    });
+  }
+  async function post(url, body = {}, options2) {
+    return request(url, {
+      ...options2,
+      method: "POST",
+      body
+    });
+  }
+  async function put(url, body = {}, options2) {
+    return request(url, {
+      ...options2,
+      method: "PUT",
+      body
+    });
+  }
+  async function patch(url, body = {}, options2) {
+    return request(url, {
+      ...options2,
+      method: "PATCH",
+      body
+    });
+  }
+  async function del(url, params = {}, options2) {
+    return request(url, {
+      ...options2,
+      method: "DELETE",
+      query: params
+    });
+  }
+  return {
+    rawRequest,
+    request,
+    get,
+    post,
+    put,
+    patch,
+    del
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createApiClient,
+  isApiError
+});
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import {\n  ofetch,\n  type FetchOptions,\n  type FetchContext,\n  type $Fetch,\n} from \"ofetch\";\n\nexport interface ApiResult<T> {\n  code: number;\n  data: T;\n  message: string;\n}\n\nexport interface ApiError extends Error {\n  code: number; // 业务错误码\n  data?: unknown; // 后端返回的 data 字段（如果有）\n  status?: number; // HTTP 状态码（网络错误时）\n}\n\n// 类型守卫：判断是否是 API 业务错误\nexport const isApiError = (error: unknown): error is ApiError => {\n  return error instanceof Error && \"code\" in error;\n};\n\nexport interface TokenStorage {\n  getAccessToken: () => Promise<string> | string;\n  setAccessToken: (token: string) => Promise<void> | void;\n}\n\nexport interface CreateApiClientOptions {\n  baseURL: string;\n  tokenStorage: TokenStorage;\n  refreshToken?: (() => Promise<string>) | string | false;\n  retry?: number; // 重试次数，默认 1\n  retryDelay?: number; // 重试间隔，默认 1s\n  isAuthError?: (code: number) => boolean;\n  unwrapResponse?<T>(result: unknown, returnFullResponse: boolean): T;\n  createErrorFromResult?(res: unknown): Error;\n  /**\n   * 自定义请求钩子\n   * 在请求发送前执行，可用于编码请求体等\n   */\n  onRequest?: (context: FetchContext) => void | Promise<void>;\n  /**\n   * 自定义响应钩子\n   * 在响应返回后执行，可用于解码响应体等\n   */\n  onResponse?: (context: FetchContext) => void | Promise<void>;\n}\n\ntype RequestOptions = Omit<FetchOptions<\"json\">, \"responseType\"> & {\n  returnFullResponse?: boolean;\n  responseType?: \"json\" | \"arrayBuffer\" | \"text\" | \"blob\";\n};\n\n// 解包后端统一响应格式（默认实现）\nconst defaultUnwrapResponse = <T>(\n  result: unknown,\n  returnFullResponse = false,\n): T => {\n  if (result && typeof result === \"object\" && \"code\" in result) {\n    const body = result as Record<string, unknown>;\n    if (body.code === 0) {\n      return returnFullResponse ? (body as T) : (body.data as T);\n    }\n  }\n  return result as T;\n};\n\nconst defaultCreateErrorFromResult = (res: ApiResult<unknown>): ApiError => {\n  const error = new Error(res.message || \"Request failed\") as ApiError;\n  error.code = res.code;\n  error.data = res.data;\n  return error;\n};\n\nconst extractAccessToken = (data: unknown): string => {\n  if (typeof data === \"string\" && data) {\n    return data;\n  }\n\n  if (!data || typeof data !== \"object\") {\n    throw new Error(\n      \"Invalid refresh token response: data is not an object or string\",\n    );\n  }\n\n  const anyData = data as Record<string, unknown>;\n\n  const accessToken =\n    anyData.access_token ?? anyData.accessToken ?? anyData.token;\n\n  if (typeof accessToken === \"string\" && accessToken) {\n    return accessToken;\n  }\n\n  throw new Error(\n    \"Invalid refresh token response: no access_token or token field found\",\n  );\n};\n\n// 全局共享的刷新状态，以 tokenStorage 为 Key\n// 这样即使有多个 ApiClient 实例，只要它们共用同一个 tokenStorage，刷新逻辑就是单例的\nconst refreshingPromises = new WeakMap<TokenStorage, Promise<string>>();\n\nexport function createApiClient(options: CreateApiClientOptions) {\n  const {\n    baseURL,\n    tokenStorage,\n    refreshToken = false,\n    retry = 1,\n    retryDelay = 1000,\n    isAuthError = (code: number) => code === 401,\n    unwrapResponse = defaultUnwrapResponse,\n    createErrorFromResult = defaultCreateErrorFromResult,\n  } = options;\n\n  const refreshTokenFn: (() => Promise<string>) | null = !refreshToken\n    ? null\n    : typeof refreshToken === \"string\"\n      ? async () => {\n          const res = await ofetch<ApiResult<unknown>>(refreshToken, {\n            baseURL,\n            method: \"POST\",\n            retry,\n            retryDelay,\n          });\n\n          if (res.code !== 0) {\n            throw createErrorFromResult(res as ApiResult<unknown>);\n          }\n\n          return extractAccessToken(res.data);\n        }\n      : refreshToken;\n\n  const rawRequest = ofetch.create({\n    baseURL,\n    retry,\n    retryDelay,\n\n    async onRequest(context: FetchContext) {\n      const { options: reqOptions } = context;\n      const token = await tokenStorage.getAccessToken();\n\n      const headers = new Headers(\n        reqOptions.headers as HeadersInit | undefined,\n      );\n\n      if (token) {\n        headers.set(\"Authorization\", `Bearer ${token}`);\n      }\n\n      reqOptions.headers = headers;\n\n      // 执行用户自定义钩子\n      if (options.onRequest) {\n        await options.onRequest(context);\n      }\n    },\n    async onResponse(context) {\n      const { response } = context;\n      // 不在这里处理 code，统一交给 fetchApi 层处理\n      if (response.status === 204) {\n        response._data = null;\n        return;\n      }\n\n      // 执行用户自定义钩子\n      if (options.onResponse) {\n        await options.onResponse(context);\n      }\n    },\n\n    async onResponseError(context: FetchContext) {\n      // 后端统一返回 HTTP 200，此处只处理网络层错误（如超时、断网）\n      const { response } = context;\n      const message =\n        (response?._data as Record<string, unknown>)?.message ||\n        `HTTP ${response?.status || \"Network Error\"}`;\n\n      const error = new Error(message as string) as ApiError;\n      error.status = response?.status;\n      error.data = response?._data;\n      throw error;\n    },\n  }) as $Fetch;\n\n  async function request<T = unknown>(\n    url: string,\n    options: RequestOptions & { _retry?: boolean } = {},\n  ): Promise<T> {\n    // 提取自定义选项，避免传递给 $fetch\n    const { returnFullResponse, _retry, ...fetchOptions } = options;\n\n    // const res = await rawRequest<ApiResult<T>>(url, fetchOptions);\n    const res = (await rawRequest(url, fetchOptions as FetchOptions)) as ApiResult<T>;\n\n    if (res.code === 0) {\n      return unwrapResponse<T>(res, !!returnFullResponse);\n      //   if (returnFullResponse) {\n      //     return res as unknown as T;\n      //   }\n\n      //   return res.data;\n    }\n\n    if (isAuthError(res.code) && !_retry && refreshTokenFn) {\n      try {\n        let refreshingPromise = refreshingPromises.get(tokenStorage);\n\n        if (!refreshingPromise) {\n          refreshingPromise = refreshTokenFn().finally(() => {\n            refreshingPromises.delete(tokenStorage);\n          });\n          refreshingPromises.set(tokenStorage, refreshingPromise);\n        }\n\n        const newToken = await refreshingPromise;\n\n        if (newToken) {\n          await tokenStorage.setAccessToken(newToken);\n        }\n\n        return await request<T>(url, {\n          ...(options || {}),\n          _retry: true,\n        } as any);\n      } catch (e) {\n        await tokenStorage.setAccessToken(\"\");\n        throw createErrorFromResult(res as ApiResult<unknown>);\n      }\n    }\n\n    throw createErrorFromResult(res as ApiResult<unknown>);\n  }\n\n  async function get<T = unknown>(\n    url: string,\n    params: FetchOptions[\"query\"] = {},\n    options?: RequestOptions,\n  ) {\n    return request<T>(url, {\n      ...options,\n      method: \"GET\",\n      query: params,\n    } as any);\n  }\n\n  async function post<T = unknown>(\n    url: string,\n    body: FetchOptions[\"body\"] = {},\n    options?: RequestOptions,\n  ) {\n    return request<T>(url, {\n      ...options,\n      method: \"POST\",\n      body,\n    } as any);\n  }\n\n  async function put<T = unknown>(\n    url: string,\n    body: FetchOptions[\"body\"] = {},\n    options?: RequestOptions,\n  ) {\n    return request<T>(url, {\n      ...options,\n      method: \"PUT\",\n      body,\n    } as any);\n  }\n\n  async function patch<T = unknown>(\n    url: string,\n    body: FetchOptions[\"body\"] = {},\n    options?: RequestOptions,\n  ) {\n    return request<T>(url, {\n      ...options,\n      method: \"PATCH\",\n      body,\n    } as any);\n  }\n\n  async function del<T = unknown>(\n    url: string,\n    params: FetchOptions[\"query\"] = {},\n    options?: RequestOptions,\n  ) {\n    return request<T>(url, {\n      ...options,\n      method: \"DELETE\",\n      query: params,\n    } as any);\n  }\n\n  return {\n    rawRequest,\n    request,\n    get,\n    post,\n    put,\n    patch,\n    del,\n  };\n}\n"],"mappings":"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","names":["options"]}

package/dist/client.mjs

@@ -0,0 +1,9 @@
+import {
+  createApiClient,
+  isApiError
+} from "./chunk-XARZ5KSG.mjs";
+export {
+  createApiClient,
+  isApiError
+};
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.mts

@@ -1,221 +1,5 @@
-import { FetchContext, $Fetch, FetchOptions } from 'ofetch';
-import protobuf from 'protobufjs/light';
-
-interface ApiResult<T> {
-    code: number;
-    data: T;
-    message: string;
-}
-interface ApiError extends Error {
-    code: number;
-    data?: unknown;
-    status?: number;
-}
-declare const isApiError: (error: unknown) => error is ApiError;
-interface TokenStorage {
-    getAccessToken: () => Promise<string> | string;
-    setAccessToken: (token: string) => Promise<void> | void;
-}
-interface CreateApiClientOptions {
-    baseURL: string;
-    tokenStorage: TokenStorage;
-    refreshToken?: (() => Promise<string>) | string | false;
-    retry?: number;
-    retryDelay?: number;
-    isAuthError?: (code: number) => boolean;
-    unwrapResponse?<T>(result: unknown, returnFullResponse: boolean): T;
-    createErrorFromResult?(res: unknown): Error;
-    /**
-     * 自定义请求钩子
-     * 在请求发送前执行，可用于编码请求体等
-     */
-    onRequest?: (context: FetchContext) => void | Promise<void>;
-    /**
-     * 自定义响应钩子
-     * 在响应返回后执行，可用于解码响应体等
-     */
-    onResponse?: (context: FetchContext) => void | Promise<void>;
-}
-type RequestOptions = Omit<FetchOptions<"json">, "responseType"> & {
-    returnFullResponse?: boolean;
-    responseType?: "json" | "arrayBuffer" | "text" | "blob";
-};
-declare function createApiClient(options: CreateApiClientOptions): {
-    rawRequest: $Fetch;
-    request: <T = unknown>(url: string, options?: RequestOptions & {
-        _retry?: boolean;
-    }) => Promise<T>;
-    get: <T = unknown>(url: string, params?: FetchOptions["query"], options?: RequestOptions) => Promise<T>;
-    post: <T = unknown>(url: string, body?: FetchOptions["body"], options?: RequestOptions) => Promise<T>;
-    put: <T = unknown>(url: string, body?: FetchOptions["body"], options?: RequestOptions) => Promise<T>;
-    patch: <T = unknown>(url: string, body?: FetchOptions["body"], options?: RequestOptions) => Promise<T>;
-    del: <T = unknown>(url: string, params?: FetchOptions["query"], options?: RequestOptions) => Promise<T>;
-};
-
-/**
- * Request Chain Runner
- * 负责解析和执行通用的 HTTP 请求链 (Chain Execution)
- * 适用于任何需要链式 HTTP 请求编排的场景
- */
-/** Supported HTTP Methods */
-type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-/** HTTP 请求参数 */
-interface HttpRequestSpec {
-    method: HttpMethod;
-    url: string;
-    headers?: Record<string, string>;
-    body?: any;
-}
-/**
- * 网络适配器接口
- * 定义实际发送请求的能力
- */
-/**
- * 网络适配器接口
- * 定义实际发送请求的能力
- */
-interface NetworkAdapter {
-    get<T>(url: string, params?: any, headers?: Record<string, string>): Promise<T>;
-    post<T>(url: string, body?: any, headers?: Record<string, string>): Promise<T>;
-    put?<T>(url: string, body?: any, headers?: Record<string, string>): Promise<T>;
-    delete?<T>(url: string, params?: any, headers?: Record<string, string>): Promise<T>;
-    patch?<T>(url: string, body?: any, headers?: Record<string, string>): Promise<T>;
-}
-/**
- * 网络处理器接口 (Strategy Pattern)
- * 组合了"匹配规则"和"执行能力"
- */
-interface NetworkHandler {
-    /** 处理器名称 (用于调试) */
-    name?: string;
-    /** 判断该 URL 是否由此适配器处理 */
-    shouldHandle(url: string, method: HttpMethod): boolean;
-    /** 具体的网络适配器 */
-    adapter: NetworkAdapter;
-}
-/**
- * 请求链规则 (Chain Step)
- */
-interface ChainRequestRule {
-    /**
-     * 结果存储的键名 (Context Key)
-     * Fetch 结果存储: context[key] = response
-     */
-    key?: string;
-    /**
-     * HTTP 请求详情
-     */
-    request: HttpRequestSpec;
-    /**
-     * 数据提取选择器
-     * 用于从响应中提取特定数据, e.g., "elements.0"
-     */
-    selector?: string;
-    /** 是否允许请求失败 (默认 false) */
-    optional?: boolean;
-    /**
-     * 是否包含上下文
-     * 如果为 true，请求 Body 将自动合并当前 Context 和 Payload
-     */
-    includeContext?: boolean;
-    /**
-     * 上下文筛选列表 (优先级高于 includeContext)
-     * 指定需要合并到 Body 中的 Context Key 列表
-     * e.g., ["rawProfile", "rawCompany"]
-     */
-    pickContext?: string[];
-    /** 额外 Payload (仅当 includeContext 为 true 或 pickContext 存在时合并) */
-    payload?: Record<string, any>;
-}
-/**
- * 请求链执行器 (Request Chain Engine)
- * 支持链式请求、上下文累积、智能路由、变量替换
- *
- * @param requests 链式执行规则列表
- * @param handlers 网络适配器处理器列表 (按顺序匹配)
- */
-declare function executeRequestChain<T>(requests: ChainRequestRule[], handlers?: NetworkHandler[], getChainRequests?: (context: Record<string, any>) => ChainRequestRule[] | null | undefined, initContext?: Record<string, any>): Promise<T>;
-
-/**
- * Protobuf 安全通信模块
- *
- * 提供基于 Protobuf 的二进制序列化、XOR 混淆加密以及与 API Client 的无缝集成。
- */
-
-/**
- * 基础编解码配置
- * 控制如何将数据转换为二进制，以及是否混淆
- */
-interface ProtobufCodecOptions {
-    /** 是否启用二进制 XOR 混淆 (默认 true) */
-    obfuscate?: boolean;
-    /**
-     * 混淆密钥
-     * 可以是静态字符串/字节数组，也可以是动态获取密钥的同步或异步函数
-     */
-    obfuscationKey?: string | Uint8Array | (() => string | Uint8Array | Promise<string | Uint8Array>);
-    /** 预编译的 Protobuf 类型对象 (推荐，性能最高) */
-    protoType?: protobuf.Type;
-    /** 数据转换钩子：处理业务模型与 Proto 结构不一致的情况 */
-    transform?: {
-        beforeEncode?: (data: any) => any;
-        afterDecode?: (payload: any) => any;
-    };
-}
-/**
- * 完全自定义编解码接口
- * 用于外部项目完全接管序列化过程，同时复用基础库的混淆外壳
- */
-interface ProtobufCustomCodec {
-    /** 外部定义的编码逻辑 (返回原始二进制) */
-    encode?: (data: any) => Uint8Array | Promise<Uint8Array>;
-    /** 外部定义的解码逻辑 (返回原始对象) */
-    decode?: <T>(buffer: Uint8Array) => T | Promise<T>;
-}
-/**
- * 集成配置项
- * 用于 createProtobufHooks 或 API Client 全局配置
- */
-interface ProtobufHooksOptions extends ProtobufCodecOptions, ProtobufCustomCodec {
-}
-/**
- * API Client 内部使用的标准化配置
- */
-interface ProtobufConfig {
-    encode: (data: any) => Uint8Array | Promise<Uint8Array>;
-    decode: <T>(buffer: Uint8Array) => T | Promise<T>;
-    options?: ProtobufCodecOptions;
-}
-/** 简单的二进制异或混淆转换 */
-declare function xorTransform(data: Uint8Array, key: string | Uint8Array): Uint8Array;
-/** 获取混淆密钥（支持异步/函数） */
-declare function getObfuscationKey(keyOption?: ProtobufCodecOptions["obfuscationKey"]): Promise<string | Uint8Array>;
-/**
- * 编码安全载荷
- *
- * 流程：业务数据 -> (自定义编码 / Proto 序列化) -> 二进制混淆
- */
-declare function encodeSecure<T>(data: T, options?: ProtobufHooksOptions): Promise<Uint8Array>;
-/**
- * 解码安全载荷
- *
- * 流程：二进制流 -> 二进制反混淆 -> (自定义解码 / Proto 反序列化) -> 业务数据
- */
-declare function decodeSecure<T>(buffer: Uint8Array | ArrayBuffer, options?: ProtobufHooksOptions): Promise<T>;
-/** 创建安全响应 (Worker/Server 端使用) */
-declare function secureResponse<T>(data: T, options?: ProtobufCodecOptions & {
-    corsHeaders?: Record<string, string>;
-}): Promise<Response>;
-/** 解析安全请求体 (Worker/Server 端使用) */
-declare function parseSecureRequest<T>(request: Request, customDecode?: ProtobufCustomCodec["decode"]): Promise<T>;
-/** 检查是否为 Protobuf 响应头 */
-declare function isProtobufContentType(contentType: string | null): boolean;
-/** 标准化配置对象 */
-declare function normalizeProtobufConfig(config: boolean | ProtobufConfig | undefined, options?: ProtobufHooksOptions): ProtobufConfig | null;
-/** 创建 Protobuf 编解码钩子 (用于与 createApiClient 配合使用) */
-declare function createProtobufHooks(options?: ProtobufHooksOptions): {
-    onRequest(context: FetchContext): Promise<void>;
-    onResponse(context: FetchContext): Promise<void>;
-};
-
-export { type ApiError, type ApiResult, type ChainRequestRule, type CreateApiClientOptions, type HttpRequestSpec, type NetworkAdapter, type NetworkHandler, type ProtobufCodecOptions, type ProtobufConfig, type ProtobufCustomCodec, type ProtobufHooksOptions, type TokenStorage, createApiClient, createProtobufHooks, decodeSecure, encodeSecure, executeRequestChain, getObfuscationKey, isApiError, isProtobufContentType, normalizeProtobufConfig, parseSecureRequest, secureResponse, xorTransform };
+export { ApiError, ApiResult, CreateApiClientOptions, TokenStorage, createApiClient, isApiError } from './client.mjs';
+export { ChainRequestRule, HttpRequestSpec, NetworkAdapter, NetworkHandler, executeRequestChain } from './chain.mjs';
+export { PROTOBUF_CONTENT_TYPE, ProtobufCodecOptions, ProtobufCustomCodec, ProtobufHooksOptions, ProtobufTypeLike, createProtobufHooks, decodeSecure, encodeSecure, isProtobufContentType, parseSecureRequest, secureResponse, setProtobufRequestHeaders, xorTransform } from './protobuf.mjs';
+import 'ofetch';
+import 'protobufjs/light';