@gt6/sdk 1.0.15 → 1.0.16

package/README.md

@@ -334,6 +334,120 @@ new GT6SDK(config: GT6Config)
 
 - `getArticleStats(): Promise<ArticleStats>`
 
+### TransactionsAPI 类
+
+#### 交易相关方法
+
+- `uploadFile(file: File): Promise<UploadResponse>` - 上传文件
+- `deductFunds(deductData: DeductFundsRequest): Promise<DeductFundsResponse>` - 资金扣款
+- `createRetailOrder(orderData: CreateRetailOrderRequest): Promise<CreateRetailOrderResponse>` - 创建零售订单
+
+#### 资金扣款
+
+```typescript
+// 资金扣款
+const deductResult = await sdk.transactions.deductFunds({
+  userId: 12345,
+  userType: 2,
+  amount: '100.00',
+  description: '购买商品扣款',
+  orderId: 'ORDER123456'
+});
+
+if (deductResult.success) {
+  console.log('扣款成功');
+  console.log('资金日志ID:', deductResult.fundLogId);
+  console.log('新余额:', deductResult.newBalance);
+} else {
+  console.log('扣款失败:', deductResult.message);
+}
+```
+
+#### 创建零售订单
+
+```typescript
+// 创建零售订单
+const orderData = {
+  user_id: 12345,
+  user_type: 2,
+  total_amount: 150.00,
+  pay_way: 1, // 钱包支付
+  product_type: 1,
+  platform_id: 1747558688,
+  d1: 0,
+  d2: 0,
+  d3: 0,
+  products: [
+    {
+      product_id: 1001,
+      quantity: 2,
+      sku: 'PROD001',
+      price: 50.00,
+      region_id: 1,
+      address_id: 101,
+      shipping_fee: 10.00,
+      tax_fee: 5.00
+    }
+  ]
+};
+
+const orderResult = await sdk.transactions.createRetailOrder(orderData);
+
+if (orderResult.success) {
+  console.log('订单创建成功');
+  console.log('订单ID:', orderResult.orderId);
+  console.log('订单状态:', orderResult.order?.status);
+} else {
+  console.log('订单创建失败:', orderResult.message);
+}
+```
+
+#### 完整交易流程
+
+```typescript
+// 完整的购买流程示例
+async function completePurchase(userId: number, amount: number, products: any[]) {
+  // 第一步：扣款
+  const deductResult = await sdk.transactions.deductFunds({
+    userId,
+    userType: 2,
+    amount: amount.toString(),
+    description: '购买商品扣款'
+  });
+
+  if (!deductResult.success) {
+    throw new Error(`扣款失败: ${deductResult.message}`);
+  }
+
+  // 第二步：创建订单
+  const orderData = {
+    user_id: userId,
+    user_type: 2,
+    total_amount: amount,
+    pay_way: 1,
+    product_type: 1,
+    platform_id: 1747558688,
+    d1: 0,
+    d2: 0,
+    d3: 0,
+    products
+  };
+
+  const orderResult = await sdk.transactions.createRetailOrder(orderData);
+
+  if (!orderResult.success) {
+    // 注意：如果订单创建失败，需要考虑退款处理
+    throw new Error(`订单创建失败: ${orderResult.message}`);
+  }
+
+  return {
+    fundLogId: deductResult.fundLogId,
+    orderId: orderResult.orderId,
+    newBalance: deductResult.newBalance
+  };
+}
+```
+
 ## 使用示例
 
 ### 根据分类获取文章

package/dist/gt6-sdk.cjs.js

@@ -1752,6 +1752,146 @@ class UsersAPI {
     }
 }
 
+/**
+ * 交易管理API模块
+ * 提供资金扣款、订单创建等功能
+ */
+class TransactionsAPI {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 资金扣款
+     * @param deductData 扣款数据
+     * @returns 扣款响应
+     */
+    async deductFunds(deductData) {
+        try {
+            // 获取用户token
+            const token = this.getToken();
+            if (!token) {
+                return {
+                    success: false,
+                    message: '用户未登录'
+                };
+            }
+            const response = await this.client.request('/web/user/fund/deduct', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(deductData)
+            });
+            return response;
+        }
+        catch (error) {
+            // 如果是HTTP错误，尝试解析响应体
+            if (error.statusCode && error.message) {
+                // 对于401错误，返回认证失败信息
+                if (error.statusCode === 401) {
+                    return {
+                        success: false,
+                        message: '认证失败，请重新登录'
+                    };
+                }
+                // 对于400错误，可能是余额不足等业务错误
+                if (error.statusCode === 400) {
+                    return {
+                        success: false,
+                        message: error.message || '扣款失败，请检查余额'
+                    };
+                }
+                // 对于其他HTTP错误，返回状态码信息
+                return {
+                    success: false,
+                    message: error.message || `HTTP ${error.statusCode} 错误`
+                };
+            }
+            // 对于网络错误或其他错误
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : '资金扣款失败'
+            };
+        }
+    }
+    /**
+     * 创建零售订单
+     * @param orderData 订单数据
+     * @returns 创建订单响应
+     */
+    async createRetailOrder(orderData) {
+        try {
+            // 获取用户token
+            const token = this.getToken();
+            if (!token) {
+                return {
+                    success: false,
+                    message: '用户未登录'
+                };
+            }
+            const response = await this.client.request('/web/orders', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(orderData)
+            });
+            return response;
+        }
+        catch (error) {
+            // 如果是HTTP错误，尝试解析响应体
+            if (error.statusCode && error.message) {
+                // 对于401错误，返回认证失败信息
+                if (error.statusCode === 401) {
+                    return {
+                        success: false,
+                        message: '认证失败，请重新登录'
+                    };
+                }
+                // 对于400错误，可能是订单数据有误
+                if (error.statusCode === 400) {
+                    return {
+                        success: false,
+                        message: error.message || '订单数据有误，请检查输入'
+                    };
+                }
+                // 对于其他HTTP错误，返回状态码信息
+                return {
+                    success: false,
+                    message: error.message || `HTTP ${error.statusCode} 错误`
+                };
+            }
+            // 对于网络错误或其他错误
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : '创建订单失败'
+            };
+        }
+    }
+    /**
+     * 获取用户token（从本地存储）
+     * @returns token或null
+     */
+    getToken() {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const userDataStr = localStorage.getItem('userData');
+            if (userDataStr) {
+                try {
+                    const userData = JSON.parse(userDataStr);
+                    return userData.token || null;
+                }
+                catch (error) {
+                    console.warn('解析用户数据失败:', error);
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+}
+
 /**
  * GT6 SDK 主类
  * 提供文章、产品、设置、表单和用户管理相关的所有功能
@@ -1764,6 +1904,7 @@ class GT6SDK {
         this.settings = new SettingsAPI(client);
         this.forms = new FormsAPI(client);
         this.users = new UsersAPI(client);
+        this.transactions = new TransactionsAPI(client);
     }
     /**
      * 获取客户端实例（用于高级用法）
@@ -2125,6 +2266,18 @@ class GT6SDK {
     async uploadFile(file) {
         return this.users.uploadFile(file);
     }
+    /**
+     * 便捷方法：资金扣款
+     */
+    async deductFunds(deductData) {
+        return this.transactions.deductFunds(deductData);
+    }
+    /**
+     * 便捷方法：创建零售订单
+     */
+    async createRetailOrder(orderData) {
+        return this.transactions.createRetailOrder(orderData);
+    }
 }
 
 exports.ArticlesAPI = ArticlesAPI;
@@ -2134,6 +2287,7 @@ exports.GT6Error = GT6Error;
 exports.GT6SDK = GT6SDK;
 exports.ProductsAPI = ProductsAPI;
 exports.SettingsAPI = SettingsAPI;
+exports.TransactionsAPI = TransactionsAPI;
 exports.UsersAPI = UsersAPI;
 exports.default = GT6SDK;
 //# sourceMappingURL=gt6-sdk.cjs.js.map