secure-crypto-top-sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,72 @@
+import { P as ProtocolKind, C as CipherAlgorithm, D as DigestAlgorithm } from './base-v1-7dHNy.js';
+
+/**
+ * 浏览器端客户端公共类型
+ */
+
+interface BaseClientConfig {
+    baseURL: string;
+    /** 加密密钥 - 64 字符 hex(32 字节) */
+    encryptionKey: string;
+    /** 签名密钥(>= 32 字符) */
+    hmacSecret: string;
+    /** 应用标识(TOP 协议需要) */
+    appKey?: string;
+    /** 客户端默认协议 */
+    protocol?: ProtocolKind;
+    /** 默认加密算法 */
+    cipher?: CipherAlgorithm;
+    /** 默认签名算法 */
+    digest?: DigestAlgorithm;
+    defaultHeaders?: Record<string, string>;
+    requestWindowMs?: number;
+    /** RSA 公钥 PEM(混合加密场景) */
+    rsaPublicKeyPem?: string;
+    fetchImpl?: typeof fetch;
+}
+interface RequestOptions {
+    session?: string;
+    cipher?: CipherAlgorithm;
+    digest?: DigestAlgorithm;
+    protocol?: ProtocolKind;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+
+/**
+ * 浏览器端 / 通用 fetch 客户端
+ *
+ * 支持:
+ *   - 多种协议(protocol: 'custom' | 'top'),通过 envelope.protocol 字段协商
+ *   - 多种加密/签名算法(可按请求级别覆盖)
+ *   - 自动加密请求 + 解密响应 + 验签
+ */
+
+declare class SecureClient {
+    protected readonly baseURL: string;
+    protected readonly encryptionKey: Buffer;
+    protected readonly hmacSecret: string;
+    protected readonly appKey?: string;
+    protected readonly defaultProtocol: ProtocolKind;
+    protected readonly defaultCipher: BaseClientConfig['cipher'];
+    protected readonly defaultDigest: BaseClientConfig['digest'];
+    protected readonly defaultHeaders: Record<string, string>;
+    protected readonly requestWindowMs: number;
+    protected readonly rsaPublicKeyPem?: string;
+    protected readonly fetchImpl: typeof fetch;
+    constructor(config: BaseClientConfig);
+    /**
+     * 发起加密请求并解密响应
+     */
+    request<T = unknown>(method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', path: string, options?: RequestOptions & {
+        body?: unknown;
+    }): Promise<T>;
+    protected decryptResponseOnly(envelope: any, protocolKind: ProtocolKind): Promise<unknown>;
+    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+}
+
+export { type BaseClientConfig, type RequestOptions, SecureClient };