@be-link/http 1.0.1-beta.0

package/dist/interceptors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 拦截器模块导出
+ *
+ * @module interceptors
+ */
+/** 请求拦截器 */
+export { setRequestInterceptor } from './request';
+/** 响应拦截器 */
+export { setResponseInterceptor } from './response';
+//# sourceMappingURL=index.d.ts.map

package/dist/interceptors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interceptors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/interceptors/request.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 请求拦截器
+ *
+ * 在请求发出前对请求进行处理，包括：
+ * - 时间同步
+ * - 设置默认请求头
+ * - 添加用户 ID
+ * - Token 加密和添加
+ * - 调用自定义拦截器
+ *
+ * @module interceptors/request
+ */
+import type { AxiosInstance } from 'axios';
+import type { RequestOptions } from '../types';
+import { EncryptionService, TimeSyncService } from '../services';
+/**
+ * 设置请求拦截器
+ *
+ * 为 Axios 实例添加请求拦截器，处理请求前的通用逻辑
+ *
+ * 拦截器执行顺序：
+ * 1. 确保时间同步（如果配置了 TimeSyncService）
+ * 2. 设置默认 Content-Type
+ * 3. 添加用户 ID 到请求头
+ * 4. 加密并添加 Token 到请求头
+ * 5. 调用自定义请求拦截器
+ *
+ * @param instance - Axios 实例
+ * @param options - 请求配置选项
+ * @param timeSyncService - 时间同步服务实例（可选）
+ * @param encryptionService - 加密服务实例（可选）
+ *
+ * @example
+ * ```ts
+ * const instance = axios.create({ baseURL: 'https://api.example.com' });
+ *
+ * setRequestInterceptor(
+ *   instance,
+ *   {
+ *     baseURL: 'https://api.example.com',
+ *     getToken: () => localStorage.getItem('token'),
+ *     getUserId: () => localStorage.getItem('userId'),
+ *   },
+ *   timeSyncService,
+ *   encryptionService,
+ * );
+ * ```
+ */
+export declare function setRequestInterceptor(instance: AxiosInstance, options: RequestOptions, timeSyncService?: TimeSyncService, encryptionService?: EncryptionService): void;
+//# sourceMappingURL=request.d.ts.map

package/dist/interceptors/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/interceptors/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,OAAO,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,cAAc,EACvB,eAAe,CAAC,EAAE,eAAe,EACjC,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,IAAI,CAmDN"}

package/dist/interceptors/response.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 响应拦截器
+ *
+ * 在收到响应后对响应进行处理，包括：
+ * - 提取响应数据
+ * - 调用自定义响应拦截器
+ * - 统一错误处理
+ *
+ * @module interceptors/response
+ */
+import type { AxiosInstance } from 'axios';
+import type { RequestOptions } from '../types';
+/**
+ * 设置响应拦截器
+ *
+ * 为 Axios 实例添加响应拦截器，处理响应后的通用逻辑
+ *
+ * 成功响应处理：
+ * 1. 提取响应数据（response.data）
+ * 2. 调用自定义响应拦截器（如果配置）
+ * 3. 返回处理后的数据
+ *
+ * 错误响应处理：
+ * 1. 调用自定义错误处理（如果配置）
+ * 2. 检查业务错误（success === false）
+ * 3. 抛出错误
+ *
+ * @param instance - Axios 实例
+ * @param options - 请求配置选项
+ *
+ * @example
+ * ```ts
+ * const instance = axios.create({ baseURL: 'https://api.example.com' });
+ *
+ * setResponseInterceptor(instance, {
+ *   baseURL: 'https://api.example.com',
+ *   onResponse: (data) => {
+ *     console.log('响应数据:', data);
+ *     return data;
+ *   },
+ *   onError: (error) => {
+ *     if (error.response?.status === 401) {
+ *       // 处理未授权错误
+ *       window.location.href = '/login';
+ *     }
+ *     throw error;
+ *   },
+ * });
+ * ```
+ */
+export declare function setResponseInterceptor(instance: AxiosInstance, options: RequestOptions): void;
+//# sourceMappingURL=response.d.ts.map

package/dist/interceptors/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/interceptors/response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,OAAO,CAAC;AAE1D,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,UAAU,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAyC7F"}

package/dist/services/EncryptionService.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 加密服务
+ *
+ * 提供 Token 加密/解密功能，使用 AES-CBC 模式
+ * 加密后的 Token 包含时间戳，用于防止重放攻击
+ *
+ * @module EncryptionService
+ */
+import type { EncryptionConfig, EncryptionService as IEncryptionService } from '../types';
+import { TimeSyncService } from './TimeSyncService';
+/**
+ * 加密服务
+ *
+ * 负责 Token 的 AES 加密和解密，提供以下功能：
+ * - Token 加密（带时间戳）
+ * - Token 解密
+ * - 与时间同步服务集成
+ *
+ * 加密格式说明：
+ * - 原始数据格式: `${token}|+|${timestamp}`
+ * - 加密算法: AES-128-CBC
+ * - 输出格式: Base64 编码
+ *
+ * @example
+ * ```ts
+ * const encryption = new EncryptionService({
+ *   key: '1234567890123456', // 16 位
+ *   iv: '1234567890123456',  // 16 位
+ * });
+ *
+ * // 加密 Token
+ * const encryptedToken = encryption.encryptToken('my-token');
+ *
+ * // 解密 Token
+ * const { token, timestamp } = encryption.decryptToken(encryptedToken);
+ * ```
+ */
+export declare class EncryptionService implements IEncryptionService {
+    /** 加密配置 */
+    private config;
+    /** 时间同步服务实例（可选） */
+    private timeSyncService?;
+    /**
+     * 创建加密服务实例
+     *
+     * @param config - 加密配置
+     * @param timeSyncService - 时间同步服务实例（可选），用于获取服务器校正后的时间
+     */
+    constructor(config: EncryptionConfig, timeSyncService?: TimeSyncService);
+    /**
+     * 加密 Token
+     *
+     * 将 Token 与时间戳组合后进行 AES 加密
+     * 加密后的数据用于请求头的 Authorization 字段
+     *
+     * 加密流程：
+     * 1. 组合原始数据: `${token}|+|${timestamp}`
+     * 2. 使用 AES-128-CBC 加密
+     * 3. 输出 Base64 编码的密文
+     *
+     * @param token - 原始 Token 字符串
+     * @param timestamp - 可选的时间戳（毫秒），默认使用调整后的当前时间
+     * @returns 加密后的 Token 字符串（Base64 编码）
+     *
+     * @example
+     * ```ts
+     * // 使用默认时间戳
+     * const encrypted = encryption.encryptToken('my-token');
+     *
+     * // 使用指定时间戳
+     * const encrypted = encryption.encryptToken('my-token', Date.now());
+     * ```
+     */
+    encryptToken(token: string, timestamp?: number): string;
+    /**
+     * 解密 Token
+     *
+     * 将加密后的 Token 解密，提取原始 Token 和时间戳
+     *
+     * @param encryptedToken - 加密后的 Token 字符串
+     * @returns 包含原始 Token 和时间戳的对象
+     *
+     * @example
+     * ```ts
+     * const { token, timestamp } = encryption.decryptToken(encryptedToken);
+     * console.log(token);     // 'my-token'
+     * console.log(timestamp); // 1703577600000
+     * ```
+     */
+    decryptToken(encryptedToken: string): {
+        token: string;
+        timestamp: number;
+    };
+    /**
+     * 获取调整后的时间戳
+     *
+     * 优先使用时间同步服务获取校正后的时间
+     * 如果没有时间同步服务，则使用当前客户端时间
+     *
+     * @returns 时间戳（毫秒）
+     */
+    private getAdjustedTime;
+    /**
+     * 更新配置
+     *
+     * 动态更新加密服务的配置
+     *
+     * @param config - 要更新的配置项
+     */
+    updateConfig(config: Partial<EncryptionConfig>): void;
+    /**
+     * 设置时间同步服务
+     *
+     * 用于后期绑定时间同步服务实例
+     *
+     * @param timeSyncService - 时间同步服务实例
+     */
+    setTimeSyncService(timeSyncService: TimeSyncService): void;
+}
+//# sourceMappingURL=EncryptionService.d.ts.map

package/dist/services/EncryptionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptionService.d.ts","sourceRoot":"","sources":["../../src/services/EncryptionService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,WAAW;IACX,OAAO,CAAC,MAAM,CAAmB;IAEjC,mBAAmB;IACnB,OAAO,CAAC,eAAe,CAAC,CAAkB;IAE1C;;;;;OAKG;gBACS,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,eAAe;IAQvE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAmB9D;;;;;;;;;;;;;;OAcG;IACI,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAejF;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;;;OAMG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAI5D;;;;;;OAMG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI;CAGlE"}

package/dist/services/TimeSyncService.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 时间同步服务
+ *
+ * 用于同步客户端和服务器时间，解决客户端时间不准确的问题
+ * 主要用于 Token 加密时使用服务器时间，防止重放攻击
+ *
+ * 使用 performance.now() 计算时间流逝，防止用户修改系统时间导致的问题
+ *
+ * @module TimeSyncService
+ */
+import type { TimeSyncConfig, TimeSyncService as ITimeSyncService } from '../types';
+/**
+ * 时间同步服务
+ *
+ * 负责同步客户端和服务器时间，提供以下功能：
+ * - 自动检测是否需要同步
+ * - 获取服务器时间
+ * - 使用 performance.now() 计算时间流逝，防止用户修改系统时间
+ * - 获取调整后的当前时间
+ *
+ * @example
+ * ```ts
+ * const timeSync = new TimeSyncService({
+ *   syncUrl: 'https://api.example.com/api/time',
+ *   syncGapTime: 50000,
+ * });
+ *
+ * // 确保时间同步
+ * await timeSync.ensureSync();
+ *
+ * // 获取调整后的时间
+ * const adjustedTime = timeSync.getAdjustedTime();
+ * ```
+ */
+export declare class TimeSyncService implements ITimeSyncService {
+    /** 服务配置 */
+    private config;
+    /**
+     * 同步时的服务器时间（内存存储）
+     * 用于计算调整后的时间
+     */
+    private syncServerTime;
+    /**
+     * 同步时的 performance.now() 值（内存存储）
+     * 使用 performance.now() 而不是 Date.now()，防止用户修改系统时间
+     */
+    private syncPerformanceTime;
+    /**
+     * 正在进行的同步 Promise（用于防止并发请求时重复同步）
+     * 当有同步请求正在进行时，其他请求会等待这个 Promise 完成
+     */
+    private syncPromise;
+    /**
+     * 创建时间同步服务实例
+     */
+    constructor(config: TimeSyncConfig);
+    /**
+     * 确保时间已同步
+     *
+     * 检查是否需要同步：
+     * 1. 内存中没有同步数据（页面刷新后）
+     * 2. 距离上次同步的时间超过了 syncGapTime 阈值
+     *
+     * 并发控制：
+     * - 如果已有同步请求正在进行，直接等待该请求完成
+     * - 避免多个并发请求同时触发多次时间同步
+     */
+    ensureSync(): Promise<void>;
+    /**
+     * 执行时间同步
+     *
+     * 向服务器发送请求获取服务器时间
+     * 同时记录 performance.now() 用于后续计算时间流逝
+     *
+     * 并发控制：
+     * - 使用 syncPromise 作为锁，确保同一时间只有一个同步请求
+     * - 同步完成后清除锁，允许后续同步请求
+     */
+    sync(): Promise<void>;
+    /**
+     * 实际执行时间同步的内部方法
+     */
+    private doSync;
+    /**
+     * 获取服务器时间
+     *
+     * 返回同步时获取的服务器时间戳
+     */
+    getServerTime(): number | null;
+    /**
+     * 获取时间差
+     *
+     * 返回服务器时间与客户端时间的差值
+     * 注意：此方法仅用于向后兼容，实际计算使用 getAdjustedTime()
+     */
+    getTimeDiff(): number | null;
+    /**
+     * 获取调整后的当前时间
+     *
+     * 使用 performance.now() 计算时间流逝，得到准确的服务器时间
+     * 计算公式：同步时的服务器时间 + (当前 performance.now() - 同步时的 performance.now())
+     *
+     * 优势：即使用户修改系统时间，performance.now() 的流逝是正确的
+     *
+     * @returns 调整后的时间戳（毫秒），未同步时返回当前客户端时间
+     */
+    getAdjustedTime(): number;
+    /**
+     * 清除同步数据
+     */
+    clear(): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<TimeSyncConfig>): void;
+}
+//# sourceMappingURL=TimeSyncService.d.ts.map

package/dist/services/TimeSyncService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSyncService.d.ts","sourceRoot":"","sources":["../../src/services/TimeSyncService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAoCpF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,WAAW;IACX,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;OAGG;IACH,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA8B;IAEjD;;OAEG;gBACS,MAAM,EAAE,cAAc;IAQlC;;;;;;;;;;OAUG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxC;;;;;;;;;OASG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBlC;;OAEG;YACW,MAAM;IAwCpB;;;;OAIG;IACI,aAAa,IAAI,MAAM,GAAG,IAAI;IAIrC;;;;;OAKG;IACI,WAAW,IAAI,MAAM,GAAG,IAAI;IAOnC;;;;;;;;;OASG;IACI,eAAe,IAAI,MAAM;IAUhC;;OAEG;IACI,KAAK,IAAI,IAAI;IAYpB;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;CAG3D"}

package/dist/services/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 服务模块导出
+ *
+ * @module services
+ */
+/** 时间同步服务 */
+export { TimeSyncService } from './TimeSyncService';
+/** 加密服务 */
+export { EncryptionService } from './EncryptionService';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * @be-link/http 类型定义
+ *
+ * 本文件定义了请求库的所有 TypeScript 类型接口
+ */
+import type { AxiosInstance, AxiosRequestConfig } from 'axios';
+/**
+ * 时间同步配置
+ *
+ * 用于配置客户端与服务器时间同步的相关参数
+ * 时间同步主要用于 Token 加密时使用服务器时间，防止客户端时间不准导致的问题
+ *
+ * @example
+ * ```ts
+ * const timeSyncConfig: TimeSyncConfig = {
+ *   enabled: true,
+ *   syncUrl: 'https://api.example.com/api/time',
+ *   syncGapTime: 50000,
+ *   storagePrefix: 'myapp',
+ * };
+ * ```
+ */
+export interface TimeSyncConfig {
+    /**
+     * 是否启用时间同步
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 时间同步接口 URL
+     * 该接口应返回 { data: number } 格式，data 为服务器时间戳（毫秒）
+     */
+    syncUrl: string;
+    /**
+     * 同步间隔阈值（毫秒）
+     * 当距离上次同步时间超过此阈值时，会触发重新同步
+     * @default 50000 (50 秒)
+     */
+    syncGapTime?: number;
+    /**
+     * localStorage 存储 key 前缀
+     * 用于区分不同应用的时间同步数据
+     * 实际存储 key 为: `${storagePrefix}_belink_server_time`
+     */
+    storagePrefix?: string;
+}
+/**
+ * 加密配置
+ *
+ * 用于配置 Token AES 加密的相关参数
+ * 加密格式: AES(token + "|+|" + timestamp)
+ *
+ * @example
+ * ```ts
+ * const encryptionConfig: EncryptionConfig = {
+ *   enabled: true,
+ *   key: '1234567890123456', // 16 位
+ *   iv: '1234567890123456',  // 16 位
+ * };
+ * ```
+ */
+export interface EncryptionConfig {
+    /**
+     * 是否启用加密
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * AES 密钥
+     * 必须为 16 位字符串（128 位）
+     */
+    key: string;
+    /**
+     * AES 初始化向量（IV）
+     * 必须为 16 位字符串（128 位）
+     */
+    iv: string;
+}
+/**
+ * 请求配置选项
+ *
+ * createRequest 工厂函数的配置参数
+ * 所有参数都由应用方传递，提供最大的灵活性
+ *
+ * @example
+ * ```ts
+ * const options: RequestOptions = {
+ *   baseURL: 'https://api.example.com',
+ *   timeout: 30000,
+ *   timeSync: { syncUrl: 'https://api.example.com/api/time' },
+ *   encryption: { key: '...', iv: '...' },
+ *   getToken: () => localStorage.getItem('token'),
+ *   getUserId: () => localStorage.getItem('userId'),
+ * };
+ * ```
+ */
+export interface RequestOptions {
+    /**
+     * API 基础 URL
+     * 所有请求的 URL 都会基于此 URL 拼接
+     */
+    baseURL: string;
+    /**
+     * 请求超时时间（毫秒）
+     * @default 30000 (30 秒)
+     */
+    timeout?: number;
+    /**
+     * 默认请求头
+     * 会与每个请求的 headers 合并
+     */
+    headers?: Record<string, string>;
+    /**
+     * 时间同步配置
+     * 配置后会在请求前自动同步服务器时间
+     */
+    timeSync?: TimeSyncConfig;
+    /**
+     * Token 加密配置
+     * 配置后会自动对 Token 进行 AES 加密
+     */
+    encryption?: EncryptionConfig;
+    /**
+     * 获取 Token 的函数
+     * 每次请求时调用，返回当前的认证 Token
+     */
+    getToken?: () => string | null | undefined;
+    /**
+     * Token 请求头名称
+     * @default 'X-BeLink-Token'
+     */
+    tokenHeaderName?: string;
+    /**
+     * 获取用户 ID 的函数
+     * 每次请求时调用，返回当前用户 ID
+     */
+    getUserId?: () => string | null | undefined;
+    /**
+     * 用户 ID 请求头名称
+     * @default 'X-BeLink-UserId'
+     */
+    userIdHeaderName?: string;
+    /**
+     * 自定义请求拦截器
+     * 在请求发出前调用，可以修改请求配置
+     * @param config - Axios 请求配置
+     * @returns 修改后的请求配置
+     */
+    onRequest?: (config: AxiosRequestConfig) => AxiosRequestConfig | Promise<AxiosRequestConfig>;
+    /**
+     * 自定义响应拦截器
+     * 在收到响应后调用，可以处理响应数据
+     * @param response - 响应数据
+     * @returns 处理后的响应数据
+     */
+    onResponse?: <T = any>(response: T) => T | Promise<T>;
+    /**
+     * 自定义错误处理函数
+     * 在请求出错时调用，可以统一处理错误
+     * @param error - 错误对象
+     * @returns 处理后的结果或抛出错误
+     */
+    onError?: (error: any) => any;
+}
+/**
+ * API 响应结构
+ *
+ * 标准的 API 响应格式
+ *
+ * @template T - 响应数据类型
+ */
+export interface ApiResponse<T = any> {
+    /**
+     * 请求是否成功
+     */
+    success: boolean;
+    /**
+     * 响应数据
+     */
+    data: T;
+    /**
+     * 错误或提示消息
+     */
+    message?: string;
+    /**
+     * 错误类型标识
+     */
+    errorType?: string;
+    /**
+     * 请求 ID，用于追踪和调试
+     */
+    requestId?: string;
+}
+/**
+ * 请求实例类型
+ *
+ * 继承自 AxiosInstance，附加了时间同步和加密服务实例
+ */
+export interface RequestInstance extends AxiosInstance {
+    /**
+     * 时间同步服务实例
+     * 仅在配置了 timeSync 时存在
+     */
+    timeSync?: TimeSyncService;
+    /**
+     * 加密服务实例
+     * 仅在配置了 encryption 时存在
+     */
+    encryption?: EncryptionService;
+}
+/**
+ * 时间同步服务接口
+ *
+ * 定义时间同步服务需要实现的方法
+ */
+export interface TimeSyncService {
+    /**
+     * 确保时间已同步
+     * 如果距离上次同步时间超过阈值，会自动触发同步
+     */
+    ensureSync: () => Promise<void>;
+    /**
+     * 强制执行时间同步
+     * 无论是否超过阈值都会向服务器请求时间
+     */
+    sync: () => Promise<void>;
+    /**
+     * 获取上次同步的服务器时间
+     * @returns 服务器时间戳（毫秒），如果未同步则返回 null
+     */
+    getServerTime: () => number | null;
+    /**
+     * 获取时间差（服务器时间 - 客户端时间）
+     * @returns 时间差（毫秒），如果未同步则返回 null
+     */
+    getTimeDiff: () => number | null;
+    /**
+     * 清除本地存储的时间同步数据
+     */
+    clear: () => void;
+}
+/**
+ * 加密服务接口
+ *
+ * 定义加密服务需要实现的方法
+ */
+export interface EncryptionService {
+    /**
+     * 加密 Token
+     * 加密格式: AES(token + "|+|" + timestamp)
+     *
+     * @param token - 原始 Token
+     * @param timestamp - 可选的时间戳，默认使用调整后的当前时间
+     * @returns 加密后的 Token 字符串（Base64 编码）
+     */
+    encryptToken: (token: string, timestamp?: number) => string;
+    /**
+     * 解密 Token
+     *
+     * @param encryptedToken - 加密后的 Token
+     * @returns 包含原始 Token 和时间戳的对象
+     */
+    decryptToken: (encryptedToken: string) => {
+        token: string;
+        timestamp: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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