@be-link/request 1.45.1-beta.8 → 1.45.1-beta.9

package/dist/BeLinkRequest.d.ts

@@ -0,0 +1,207 @@
+/**
+ * BeLinkRequest 请求客户端
+ *
+ * 单例模式的 HTTP 请求客户端
+ * 支持时间同步和 Token 加密
+ *
+ * @module BeLinkRequest
+ *
+ * @example
+ * ```ts
+ * import { beLinkRequest } from '@be-link/request';
+ *
+ * // 初始化
+ * beLinkRequest.init({
+ *   baseURL: 'https://api.example.com',
+ *   timeSync: { syncUrl: 'https://api.example.com/api/time' },
+ *   encryption: { key: '...', iv: '...' },
+ *   getToken: () => localStorage.getItem('token'),
+ * });
+ *
+ * // 发起请求
+ * const data = await beLinkRequest.get('/api/users');
+ * ```
+ */
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import type { RequestOptions } from './types';
+import { TimeSyncService } from './services/TimeSyncService';
+import { EncryptionService } from './services/EncryptionService';
+/**
+ * BeLinkRequest 单例类
+ *
+ * 提供统一的 HTTP 请求接口，支持：
+ * - 时间同步
+ * - Token 加密
+ * - 请求/响应拦截
+ */
+declare class BeLinkRequest {
+    /** Axios 实例 */
+    private instance;
+    /** 时间同步服务 */
+    private timeSyncService;
+    /** 加密服务 */
+    private encryptionService;
+    /** 是否已初始化 */
+    private initialized;
+    /**
+     * 初始化请求客户端
+     *
+     * 必须在使用其他方法之前调用此方法进行初始化
+     *
+     * @param options - 请求配置选项
+     *
+     * @example
+     * ```ts
+     * beLinkRequest.init({
+     *   baseURL: 'https://api.example.com',
+     *   timeout: 30000,
+     *   timeSync: {
+     *     syncUrl: 'https://api.example.com/api/time',
+     *   },
+     *   encryption: {
+     *     key: 'your-aes-key-16ch',
+     *     iv: 'your-aes-iv-16ch',
+     *   },
+     *   getToken: () => localStorage.getItem('token'),
+     *   getUserId: () => localStorage.getItem('userId'),
+     * });
+     * ```
+     */
+    init(options: RequestOptions): void;
+    /**
+     * 检查是否已初始化
+     */
+    private checkInitialized;
+    /**
+     * GET 请求
+     *
+     * @param url - 请求 URL
+     * @param config - 可选的 Axios 请求配置
+     * @returns Promise 响应数据
+     *
+     * @example
+     * ```ts
+     * const users = await beLinkRequest.get('/api/users');
+     * const user = await beLinkRequest.get('/api/users/1', { params: { include: 'profile' } });
+     * ```
+     */
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * POST 请求
+     *
+     * @param url - 请求 URL
+     * @param data - 请求体数据
+     * @param config - 可选的 Axios 请求配置
+     * @returns Promise 响应数据
+     *
+     * @example
+     * ```ts
+     * const result = await beLinkRequest.post('/api/users', { name: '张三', age: 25 });
+     * ```
+     */
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * PUT 请求
+     *
+     * @param url - 请求 URL
+     * @param data - 请求体数据
+     * @param config - 可选的 Axios 请求配置
+     * @returns Promise 响应数据
+     *
+     * @example
+     * ```ts
+     * const result = await beLinkRequest.put('/api/users/1', { name: '李四' });
+     * ```
+     */
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * PATCH 请求
+     *
+     * @param url - 请求 URL
+     * @param data - 请求体数据
+     * @param config - 可选的 Axios 请求配置
+     * @returns Promise 响应数据
+     *
+     * @example
+     * ```ts
+     * const result = await beLinkRequest.patch('/api/users/1', { age: 26 });
+     * ```
+     */
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * DELETE 请求
+     *
+     * @param url - 请求 URL
+     * @param config - 可选的 Axios 请求配置
+     * @returns Promise 响应数据
+     *
+     * @example
+     * ```ts
+     * await beLinkRequest.delete('/api/users/1');
+     * ```
+     */
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * 通用请求方法
+     *
+     * @param config - Axios 请求配置
+     * @returns Promise 响应数据
+     *
+     * @example
+     * ```ts
+     * const result = await beLinkRequest.request({
+     *   method: 'post',
+     *   url: '/api/users',
+     *   data: { name: '张三' },
+     *   headers: { 'X-Custom': 'value' },
+     * });
+     * ```
+     */
+    request<T = any>(config: AxiosRequestConfig): Promise<T>;
+    /**
+     * 获取时间同步服务实例
+     *
+     * @returns 时间同步服务实例，未初始化时返回 null
+     */
+    getTimeSyncService(): TimeSyncService | null;
+    /**
+     * 获取加密服务实例
+     *
+     * @returns 加密服务实例，未初始化时返回 null
+     */
+    getEncryptionService(): EncryptionService | null;
+    /**
+     * 获取 Axios 实例
+     *
+     * @returns Axios 实例，未初始化时返回 null
+     */
+    getAxiosInstance(): AxiosInstance | null;
+    /**
+     * 重置客户端
+     *
+     * 清除所有配置和实例，需要重新调用 init() 初始化
+     */
+    reset(): void;
+}
+/**
+ * BeLinkRequest 单例实例
+ *
+ * @example
+ * ```ts
+ * import { beLinkRequest } from '@be-link/request';
+ *
+ * // 初始化
+ * beLinkRequest.init({
+ *   baseURL: 'https://api.example.com',
+ * });
+ *
+ * // 使用
+ * const data = await beLinkRequest.get('/api/users');
+ * ```
+ */
+export declare const beLinkRequest: BeLinkRequest;
+/**
+ * 导出类，用于创建多个实例（如需要）
+ */
+export { BeLinkRequest };
+//# sourceMappingURL=BeLinkRequest.d.ts.map

package/dist/BeLinkRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeLinkRequest.d.ts","sourceRoot":"","sources":["../src/BeLinkRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAIjE;;;;;;;GAOG;AACH,cAAM,aAAa;IACjB,eAAe;IACf,OAAO,CAAC,QAAQ,CAA8B;IAE9C,aAAa;IACb,OAAO,CAAC,eAAe,CAAgC;IAEvD,WAAW;IACX,OAAO,CAAC,iBAAiB,CAAkC;IAE3D,aAAa;IACb,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAmC1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;;;;;OAYG;IACU,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/E;;;;;;;;;;;;OAYG;IACU,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK5F;;;;;;;;;;;;OAYG;IACU,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK3F;;;;;;;;;;;;OAYG;IACU,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK7F;;;;;;;;;;;OAWG;IACU,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlF;;;;;;;;;;;;;;;OAeG;IACU,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKrE;;;;OAIG;IACI,kBAAkB,IAAI,eAAe,GAAG,IAAI;IAInD;;;;OAIG;IACI,oBAAoB,IAAI,iBAAiB,GAAG,IAAI;IAIvD;;;;OAIG;IACI,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAI/C;;;;OAIG;IACI,KAAK,IAAI,IAAI;CAMrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC"}