@plolink/sdk 0.0.4

package/dist/modules/billing/index.cjs

@@ -0,0 +1,413 @@
+'use strict';
+
+var chunkJR4HYYQI_cjs = require('../../chunk-JR4HYYQI.cjs');
+var chunkY3UJVC2L_cjs = require('../../chunk-Y3UJVC2L.cjs');
+
+// src/modules/billing/index.ts
+var Billing = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 获取团队余额信息
+   * 
+   * @returns 余额信息,包括可用余额和可开票金额
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const balance = await billing.getBalance();
+   * console.log(`余额: ${balance.balance}, 可开票: ${balance.invoiceableAmount}`);
+   * ```
+   */
+  async getBalance() {
+    return this.client.axiosInstance.get("/api/v1/payments/balance");
+  }
+  /**
+   * 创建微信充值订单
+   * 
+   * @param params - 充值参数
+   * @returns 充值订单信息,包含二维码URL和订单号
+   * @throws {PlolinkError} 当金额无效或创建失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 基础充值(仅返回二维码URL)
+   * const result = await billing.createRecharge({
+   *   amount: 100,
+   *   description: '充值100元'
+   * });
+   * console.log(`请使用微信扫描: ${result.qrCodeUrl}`);
+   * 
+   * // 充值并获取二维码图片
+   * const result = await billing.createRecharge({
+   *   amount: 100,
+   *   needQrCodeImage: true
+   * });
+   * console.log(`二维码图片地址: ${result.qrCodeImageUrl}`);
+   * ```
+   */
+  async createRecharge(params) {
+    const { amount, description, needQrCodeImage } = params;
+    if (amount <= 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("Amount must be greater than 0", "INVALID_AMOUNT");
+    }
+    return this.client.axiosInstance.post("/api/v1/payments/recharge/wechat", {
+      amount,
+      description,
+      needQrCodeImage
+    });
+  }
+  /**
+   * 查询订单状态
+   * 
+   * @param orderNo - 订单号
+   * @returns 订单状态信息
+   * @throws {PlolinkError} 当订单不存在时抛出
+   * 
+   * @example
+   * ```typescript
+   * const status = await billing.getOrderStatus('ORDER_123');
+   * console.log(`订单状态: ${status.status}`);
+   * ```
+   */
+  async getOrderStatus(orderNo) {
+    const records = await this.getRechargeRecords();
+    const record = records.find((r) => r.orderId === orderNo);
+    if (!record) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(`Order not found: ${orderNo}`, "ORDER_NOT_FOUND");
+    }
+    return {
+      orderNo,
+      status: record.status,
+      amount: record.amount,
+      createdAt: record.createdAt
+    };
+  }
+  /**
+   * 轮询订单状态
+   * 
+   * @description
+   * 创建一个轮询器持续监听订单状态变化,直到订单达到终态(success/failed/closed)。
+   * 使用指数退避策略,初始间隔1秒,最大间隔30秒。
+   * 
+   * @param orderNo - 订单号
+   * @param onStatusChange - 状态变化回调函数
+   * @returns Poller实例,可用于手动停止轮询
+   * 
+   * @example
+   * ```typescript
+   * const poller = billing.watchOrderStatus('ORDER_123', (status) => {
+   *   console.log(`状态更新: ${status.status}`);
+   *   
+   *   if (status.status === 'success') {
+   *     console.log('支付成功!');
+   *   } else if (status.status === 'failed') {
+   *     console.error('支付失败!');
+   *   }
+   * });
+   * 
+   * // 开始轮询
+   * poller.start();
+   * 
+   * // 需要时可以手动停止
+   * // poller.stop();
+   * ```
+   */
+  watchOrderStatus(orderNo, onStatusChange) {
+    const poller = new chunkJR4HYYQI_cjs.Poller({
+      task: () => this.getOrderStatus(orderNo),
+      onResult: onStatusChange,
+      shouldStop: (status) => {
+        return ["success", "failed", "closed"].includes(status.status);
+      },
+      initialInterval: 1e3,
+      maxInterval: 3e4,
+      backoffFactor: 1.5,
+      onError: (error) => {
+        this.client.logger.error("Order polling error", { error, orderNo });
+      }
+    });
+    void poller.start();
+    return poller;
+  }
+  /**
+   * 获取消耗统计
+   * 
+   * @returns 消耗统计信息(今日/7天/30天)
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const stats = await billing.getConsumptionStats();
+   * console.log(`今日消耗: ${stats.today}`);
+   * console.log(`7天消耗: ${stats.last7Days}`);
+   * console.log(`30天消耗: ${stats.last30Days}`);
+   * ```
+   */
+  async getConsumptionStats() {
+    return this.client.axiosInstance.get("/api/v1/payments/consumption/stats");
+  }
+  /**
+   * 获取消费记录(分页)
+   * 
+   * @param params - 分页参数
+   * @returns 消费记录列表和总数
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await billing.getConsumptionRecords({
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * console.log(`共 ${result.total} 条记录`);
+   * result.list.forEach(record => {
+   *   console.log(`消费: ${record.amount}, 用途: ${record.purpose}`);
+   * });
+   * ```
+   */
+  async getConsumptionRecords(params = {}) {
+    const { page = 1, pageSize = 20 } = params;
+    return this.client.axiosInstance.get("/api/v1/payments/consumption/records", {
+      params: { page, pageSize }
+    });
+  }
+  /**
+   * 获取充值记录
+   * 
+   * @returns 充值记录列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const records = await billing.getRechargeRecords();
+   * records.forEach(record => {
+   *   console.log(`${record.createdAt}: ${record.amount}, 状态: ${record.status}`);
+   * });
+   * ```
+   */
+  async getRechargeRecords() {
+    return this.client.axiosInstance.get("/api/v1/payments/recharge/records");
+  }
+  /**
+   * 获取开票记录
+   * 
+   * @returns 开票记录列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const records = await billing.getInvoiceRecords();
+   * records.forEach(record => {
+   *   console.log(`发票: ${record.invoiceNumber}, 金额: ${record.amount}`);
+   * });
+   * ```
+   */
+  async getInvoiceRecords() {
+    return this.client.axiosInstance.get("/api/v1/payments/invoice/records");
+  }
+  /**
+   * 获取退费记录
+   * 
+   * @returns 退费记录列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const records = await billing.getRefundRecords();
+   * records.forEach(record => {
+   *   console.log(`退费: ${record.amount}, 备注: ${record.remark}`);
+   * });
+   * ```
+   */
+  async getRefundRecords() {
+    return this.client.axiosInstance.get("/api/v1/payments/refund/records");
+  }
+  /**
+   * 获取对公账户信息
+   * 
+   * @returns 对公账户信息
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const account = await billing.getCompanyAccount();
+   * console.log(`账户名: ${account.accountName}`);
+   * console.log(`账号: ${account.accountNumber}`);
+   * console.log(`开户行: ${account.bankName}`);
+   * ```
+   */
+  async getCompanyAccount() {
+    return this.client.axiosInstance.get("/api/v1/payments/company-account");
+  }
+  // ============ 跨团队查询接口 ============
+  /**
+   * 获取跨团队开票记录
+   * 
+   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的开票记录
+   * 
+   * @param params - 查询参数
+   * @returns 分页结果（包含团队名称）
+   * @throws {PlolinkError} 当参数无效或请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await billing.getInvoiceRecordsCrossTeam({
+   *   startDate: '2025-01-01T00:00:00.000Z',
+   *   endDate: '2025-01-31T23:59:59.999Z',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * 
+   * console.log(`共查询到 ${result.total} 条记录`);
+   * result.list.forEach(record => {
+   *   console.log(`团队: ${record.teamName}, 发票号: ${record.invoiceNumber}, 金额: ${record.amount}`);
+   * });
+   * ```
+   */
+  async getInvoiceRecordsCrossTeam(params) {
+    const { startDate, endDate, page = 1, pageSize = 20 } = params;
+    if (!startDate || !endDate) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("pageSize must not exceed 100", "INVALID_PAGE_SIZE");
+    }
+    return this.client.axiosInstance.get("/api/v1/payments/invoice/records:cross-team", {
+      params: {
+        startDate,
+        endDate,
+        page,
+        pageSize
+      }
+    });
+  }
+  /**
+   * 获取跨团队充值记录
+   * 
+   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的充值记录
+   * 
+   * @param params - 查询参数
+   * @returns 分页结果（包含团队名称）
+   * @throws {PlolinkError} 当参数无效或请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await billing.getRechargeRecordsCrossTeam({
+   *   startDate: '2025-01-01T00:00:00.000Z',
+   *   endDate: '2025-01-31T23:59:59.999Z',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * 
+   * console.log(`共查询到 ${result.total} 条记录`);
+   * result.list.forEach(record => {
+   *   console.log(`团队: ${record.teamName}, 金额: ${record.amount}, 状态: ${record.status}`);
+   * });
+   * ```
+   */
+  async getRechargeRecordsCrossTeam(params) {
+    const { startDate, endDate, page = 1, pageSize = 20 } = params;
+    if (!startDate || !endDate) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("pageSize must not exceed 100", "INVALID_PAGE_SIZE");
+    }
+    return this.client.axiosInstance.get("/api/v1/payments/recharge/records:cross-team", {
+      params: {
+        startDate,
+        endDate,
+        page,
+        pageSize
+      }
+    });
+  }
+  /**
+   * 获取跨团队消费记录
+   * 
+   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的消费记录
+   * 
+   * @param params - 查询参数
+   * @returns 分页结果（包含团队名称）
+   * @throws {PlolinkError} 当参数无效或请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await billing.getConsumptionRecordsCrossTeam({
+   *   startDate: '2025-01-01T00:00:00.000Z',
+   *   endDate: '2025-01-31T23:59:59.999Z',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * 
+   * console.log(`共查询到 ${result.total} 条记录`);
+   * result.list.forEach(record => {
+   *   console.log(`团队: ${record.teamName}, 金额: ${record.amount}, 用途: ${record.purpose}`);
+   * });
+   * ```
+   */
+  async getConsumptionRecordsCrossTeam(params) {
+    const { startDate, endDate, page = 1, pageSize = 20 } = params;
+    if (!startDate || !endDate) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("pageSize must not exceed 100", "INVALID_PAGE_SIZE");
+    }
+    return this.client.axiosInstance.get("/api/v1/payments/consumption/records:cross-team", {
+      params: {
+        startDate,
+        endDate,
+        page,
+        pageSize
+      }
+    });
+  }
+  /**
+   * 获取跨团队退费记录
+   * 
+   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的退费记录
+   * 
+   * @param params - 查询参数
+   * @returns 分页结果（包含团队名称）
+   * @throws {PlolinkError} 当参数无效或请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await billing.getRefundRecordsCrossTeam({
+   *   startDate: '2025-01-01T00:00:00.000Z',
+   *   endDate: '2025-01-31T23:59:59.999Z',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * 
+   * console.log(`共查询到 ${result.total} 条记录`);
+   * result.list.forEach(record => {
+   *   console.log(`团队: ${record.teamName}, 金额: ${record.amount}, 备注: ${record.remark}`);
+   * });
+   * ```
+   */
+  async getRefundRecordsCrossTeam(params) {
+    const { startDate, endDate, page = 1, pageSize = 20 } = params;
+    if (!startDate || !endDate) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("pageSize must not exceed 100", "INVALID_PAGE_SIZE");
+    }
+    return this.client.axiosInstance.get("/api/v1/payments/refund/records:cross-team", {
+      params: {
+        startDate,
+        endDate,
+        page,
+        pageSize
+      }
+    });
+  }
+};
+
+exports.Billing = Billing;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/billing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/billing/index.ts"],"names":["PlolinkError","Poller"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 充值消费模块\n * \n * @description\n * 提供完整的充值消费相关功能,包括:\n * - 余额查询\n * - 微信扫码充值(支持可选生成二维码图片)\n * - 订单状态查询和轮询\n * - 消费/充值/开票/退费记录查询\n * - 消耗统计\n * - 对公账户信息\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Billing } from '@plolink/sdk/billing';\n * \n * const client = new PlolinkClient({\n *   mode: 'apiKey',\n *   apiKey: 'your-api-key'\n * });\n * \n * const billing = new Billing(client);\n * \n * // 查询余额\n * const balance = await billing.getBalance();\n * console.log(`当前余额: ${balance.balance}`);\n * \n * // 发起充值(含二维码图片)\n * const result = await billing.createRecharge({\n *   amount: 100,\n *   needQrCodeImage: true\n * });\n * console.log(`请扫码支付: ${result.qrCodeImageUrl}`);\n * \n * // 轮询订单状态\n * const poller = billing.watchOrderStatus(result.orderNo, (status) => {\n *   console.log(`订单状态: ${status.status}`);\n *   if (status.status === 'success') {\n *     console.log('支付成功!');\n *   }\n * });\n * ```\n * \n * @module billing\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { Poller } from '../../common/poller';\nimport { PlolinkError } from '../../core/error';\nimport type {\n  BalanceInfo,\n  CreateRechargeParams,\n  WechatRechargeResult,\n  OrderStatusResult,\n  ConsumptionStats,\n  PaginationParams,\n  PaginatedResult,\n  ConsumptionRecord,\n  RechargeRecord,\n  InvoiceRecord,\n  RefundRecord,\n  CompanyAccount,\n  CrossTeamQueryParams,\n  CrossTeamPaginatedResult,\n  InvoiceRecordCrossTeam,\n  RechargeRecordCrossTeam,\n  ConsumptionRecordCrossTeam,\n  RefundRecordCrossTeam,\n} from '../../types/billing';\n\nexport type {\n  BalanceInfo,\n  CreateRechargeParams,\n  WechatRechargeResult,\n  OrderStatus,\n  OrderStatusResult,\n  ConsumptionStats,\n  PaginationParams,\n  PaginatedResult,\n  ConsumptionRecord,\n  RechargeRecord,\n  InvoiceRecord,\n  RefundRecord,\n  CompanyAccount,\n  CrossTeamQueryParams,\n  CrossTeamPaginatedResult,\n  InvoiceRecordCrossTeam,\n  RechargeRecordCrossTeam,\n  ConsumptionRecordCrossTeam,\n  RefundRecordCrossTeam,\n} from '../../types/billing';\n\n/**\n * 充值消费模块\n */\nexport class Billing {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 获取团队余额信息\n   * \n   * @returns 余额信息,包括可用余额和可开票金额\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const balance = await billing.getBalance();\n   * console.log(`余额: ${balance.balance}, 可开票: ${balance.invoiceableAmount}`);\n   * ```\n   */\n  public async getBalance(): Promise<BalanceInfo> {\n    return this.client.axiosInstance.get('/api/v1/payments/balance');\n  }\n\n  /**\n   * 创建微信充值订单\n   * \n   * @param params - 充值参数\n   * @returns 充值订单信息,包含二维码URL和订单号\n   * @throws {PlolinkError} 当金额无效或创建失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 基础充值(仅返回二维码URL)\n   * const result = await billing.createRecharge({\n   *   amount: 100,\n   *   description: '充值100元'\n   * });\n   * console.log(`请使用微信扫描: ${result.qrCodeUrl}`);\n   * \n   * // 充值并获取二维码图片\n   * const result = await billing.createRecharge({\n   *   amount: 100,\n   *   needQrCodeImage: true\n   * });\n   * console.log(`二维码图片地址: ${result.qrCodeImageUrl}`);\n   * ```\n   */\n  public async createRecharge(params: CreateRechargeParams): Promise<WechatRechargeResult> {\n    const { amount, description, needQrCodeImage } = params;\n    \n    if (amount <= 0) {\n      throw new PlolinkError('Amount must be greater than 0', 'INVALID_AMOUNT');\n    }\n\n    return this.client.axiosInstance.post('/api/v1/payments/recharge/wechat', {\n      amount,\n      description,\n      needQrCodeImage,\n    });\n  }\n\n  /**\n   * 查询订单状态\n   * \n   * @param orderNo - 订单号\n   * @returns 订单状态信息\n   * @throws {PlolinkError} 当订单不存在时抛出\n   * \n   * @example\n   * ```typescript\n   * const status = await billing.getOrderStatus('ORDER_123');\n   * console.log(`订单状态: ${status.status}`);\n   * ```\n   */\n  public async getOrderStatus(orderNo: string): Promise<OrderStatusResult> {\n    // 通过充值记录接口查询订单状态\n    const records = await this.getRechargeRecords();\n    const record = records.find((r) => r.orderId === orderNo);\n    \n    if (!record) {\n      throw new PlolinkError(`Order not found: ${orderNo}`, 'ORDER_NOT_FOUND');\n    }\n\n    return {\n      orderNo,\n      status: record.status,\n      amount: record.amount,\n      createdAt: record.createdAt,\n    };\n  }\n\n  /**\n   * 轮询订单状态\n   * \n   * @description\n   * 创建一个轮询器持续监听订单状态变化,直到订单达到终态(success/failed/closed)。\n   * 使用指数退避策略,初始间隔1秒,最大间隔30秒。\n   * \n   * @param orderNo - 订单号\n   * @param onStatusChange - 状态变化回调函数\n   * @returns Poller实例,可用于手动停止轮询\n   * \n   * @example\n   * ```typescript\n   * const poller = billing.watchOrderStatus('ORDER_123', (status) => {\n   *   console.log(`状态更新: ${status.status}`);\n   *   \n   *   if (status.status === 'success') {\n   *     console.log('支付成功!');\n   *   } else if (status.status === 'failed') {\n   *     console.error('支付失败!');\n   *   }\n   * });\n   * \n   * // 开始轮询\n   * poller.start();\n   * \n   * // 需要时可以手动停止\n   * // poller.stop();\n   * ```\n   */\n  public watchOrderStatus(\n    orderNo: string,\n    onStatusChange: (status: OrderStatusResult) => void\n  ): Poller<OrderStatusResult> {\n    const poller = new Poller<OrderStatusResult>({\n      task: () => this.getOrderStatus(orderNo),\n      onResult: onStatusChange,\n      shouldStop: (status) => {\n        return ['success', 'failed', 'closed'].includes(status.status);\n      },\n      initialInterval: 1000,\n      maxInterval: 30000,\n      backoffFactor: 1.5,\n      onError: (error) => {\n        this.client.logger.error('Order polling error', { error, orderNo });\n      },\n    });\n\n    // 自动启动\n    void poller.start();\n\n    return poller;\n  }\n\n  /**\n   * 获取消耗统计\n   * \n   * @returns 消耗统计信息(今日/7天/30天)\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const stats = await billing.getConsumptionStats();\n   * console.log(`今日消耗: ${stats.today}`);\n   * console.log(`7天消耗: ${stats.last7Days}`);\n   * console.log(`30天消耗: ${stats.last30Days}`);\n   * ```\n   */\n  public async getConsumptionStats(): Promise<ConsumptionStats> {\n    return this.client.axiosInstance.get('/api/v1/payments/consumption/stats');\n  }\n\n  /**\n   * 获取消费记录(分页)\n   * \n   * @param params - 分页参数\n   * @returns 消费记录列表和总数\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await billing.getConsumptionRecords({\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * console.log(`共 ${result.total} 条记录`);\n   * result.list.forEach(record => {\n   *   console.log(`消费: ${record.amount}, 用途: ${record.purpose}`);\n   * });\n   * ```\n   */\n  public async getConsumptionRecords(\n    params: PaginationParams = {}\n  ): Promise<PaginatedResult<ConsumptionRecord>> {\n    const { page = 1, pageSize = 20 } = params;\n    return this.client.axiosInstance.get('/api/v1/payments/consumption/records', {\n      params: { page, pageSize },\n    });\n  }\n\n  /**\n   * 获取充值记录\n   * \n   * @returns 充值记录列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const records = await billing.getRechargeRecords();\n   * records.forEach(record => {\n   *   console.log(`${record.createdAt}: ${record.amount}, 状态: ${record.status}`);\n   * });\n   * ```\n   */\n  public async getRechargeRecords(): Promise<RechargeRecord[]> {\n    return this.client.axiosInstance.get('/api/v1/payments/recharge/records');\n  }\n\n  /**\n   * 获取开票记录\n   * \n   * @returns 开票记录列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const records = await billing.getInvoiceRecords();\n   * records.forEach(record => {\n   *   console.log(`发票: ${record.invoiceNumber}, 金额: ${record.amount}`);\n   * });\n   * ```\n   */\n  public async getInvoiceRecords(): Promise<InvoiceRecord[]> {\n    return this.client.axiosInstance.get('/api/v1/payments/invoice/records');\n  }\n\n  /**\n   * 获取退费记录\n   * \n   * @returns 退费记录列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const records = await billing.getRefundRecords();\n   * records.forEach(record => {\n   *   console.log(`退费: ${record.amount}, 备注: ${record.remark}`);\n   * });\n   * ```\n   */\n  public async getRefundRecords(): Promise<RefundRecord[]> {\n    return this.client.axiosInstance.get('/api/v1/payments/refund/records');\n  }\n\n  /**\n   * 获取对公账户信息\n   * \n   * @returns 对公账户信息\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const account = await billing.getCompanyAccount();\n   * console.log(`账户名: ${account.accountName}`);\n   * console.log(`账号: ${account.accountNumber}`);\n   * console.log(`开户行: ${account.bankName}`);\n   * ```\n   */\n  public async getCompanyAccount(): Promise<CompanyAccount> {\n    return this.client.axiosInstance.get('/api/v1/payments/company-account');\n  }\n\n  // ============ 跨团队查询接口 ============\n\n  /**\n   * 获取跨团队开票记录\n   * \n   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的开票记录\n   * \n   * @param params - 查询参数\n   * @returns 分页结果（包含团队名称）\n   * @throws {PlolinkError} 当参数无效或请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await billing.getInvoiceRecordsCrossTeam({\n   *   startDate: '2025-01-01T00:00:00.000Z',\n   *   endDate: '2025-01-31T23:59:59.999Z',\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * \n   * console.log(`共查询到 ${result.total} 条记录`);\n   * result.list.forEach(record => {\n   *   console.log(`团队: ${record.teamName}, 发票号: ${record.invoiceNumber}, 金额: ${record.amount}`);\n   * });\n   * ```\n   */\n  public async getInvoiceRecordsCrossTeam(\n    params: CrossTeamQueryParams\n  ): Promise<CrossTeamPaginatedResult<InvoiceRecordCrossTeam>> {\n    const { startDate, endDate, page = 1, pageSize = 20 } = params;\n\n    if (!startDate || !endDate) {\n      throw new PlolinkError('startDate and endDate are required', 'MISSING_PARAMS');\n    }\n\n    if (pageSize > 100) {\n      throw new PlolinkError('pageSize must not exceed 100', 'INVALID_PAGE_SIZE');\n    }\n\n    return this.client.axiosInstance.get('/api/v1/payments/invoice/records:cross-team', {\n      params: {\n        startDate,\n        endDate,\n        page,\n        pageSize,\n      },\n    });\n  }\n\n  /**\n   * 获取跨团队充值记录\n   * \n   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的充值记录\n   * \n   * @param params - 查询参数\n   * @returns 分页结果（包含团队名称）\n   * @throws {PlolinkError} 当参数无效或请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await billing.getRechargeRecordsCrossTeam({\n   *   startDate: '2025-01-01T00:00:00.000Z',\n   *   endDate: '2025-01-31T23:59:59.999Z',\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * \n   * console.log(`共查询到 ${result.total} 条记录`);\n   * result.list.forEach(record => {\n   *   console.log(`团队: ${record.teamName}, 金额: ${record.amount}, 状态: ${record.status}`);\n   * });\n   * ```\n   */\n  public async getRechargeRecordsCrossTeam(\n    params: CrossTeamQueryParams\n  ): Promise<CrossTeamPaginatedResult<RechargeRecordCrossTeam>> {\n    const { startDate, endDate, page = 1, pageSize = 20 } = params;\n\n    if (!startDate || !endDate) {\n      throw new PlolinkError('startDate and endDate are required', 'MISSING_PARAMS');\n    }\n\n    if (pageSize > 100) {\n      throw new PlolinkError('pageSize must not exceed 100', 'INVALID_PAGE_SIZE');\n    }\n\n    return this.client.axiosInstance.get('/api/v1/payments/recharge/records:cross-team', {\n      params: {\n        startDate,\n        endDate,\n        page,\n        pageSize,\n      },\n    });\n  }\n\n  /**\n   * 获取跨团队消费记录\n   * \n   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的消费记录\n   * \n   * @param params - 查询参数\n   * @returns 分页结果（包含团队名称）\n   * @throws {PlolinkError} 当参数无效或请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await billing.getConsumptionRecordsCrossTeam({\n   *   startDate: '2025-01-01T00:00:00.000Z',\n   *   endDate: '2025-01-31T23:59:59.999Z',\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * \n   * console.log(`共查询到 ${result.total} 条记录`);\n   * result.list.forEach(record => {\n   *   console.log(`团队: ${record.teamName}, 金额: ${record.amount}, 用途: ${record.purpose}`);\n   * });\n   * ```\n   */\n  public async getConsumptionRecordsCrossTeam(\n    params: CrossTeamQueryParams\n  ): Promise<CrossTeamPaginatedResult<ConsumptionRecordCrossTeam>> {\n    const { startDate, endDate, page = 1, pageSize = 20 } = params;\n\n    if (!startDate || !endDate) {\n      throw new PlolinkError('startDate and endDate are required', 'MISSING_PARAMS');\n    }\n\n    if (pageSize > 100) {\n      throw new PlolinkError('pageSize must not exceed 100', 'INVALID_PAGE_SIZE');\n    }\n\n    return this.client.axiosInstance.get('/api/v1/payments/consumption/records:cross-team', {\n      params: {\n        startDate,\n        endDate,\n        page,\n        pageSize,\n      },\n    });\n  }\n\n  /**\n   * 获取跨团队退费记录\n   * \n   * 用于财务人员在多个团队中拥有财务权限时查询所有可管理团队的退费记录\n   * \n   * @param params - 查询参数\n   * @returns 分页结果（包含团队名称）\n   * @throws {PlolinkError} 当参数无效或请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const result = await billing.getRefundRecordsCrossTeam({\n   *   startDate: '2025-01-01T00:00:00.000Z',\n   *   endDate: '2025-01-31T23:59:59.999Z',\n   *   page: 1,\n   *   pageSize: 20\n   * });\n   * \n   * console.log(`共查询到 ${result.total} 条记录`);\n   * result.list.forEach(record => {\n   *   console.log(`团队: ${record.teamName}, 金额: ${record.amount}, 备注: ${record.remark}`);\n   * });\n   * ```\n   */\n  public async getRefundRecordsCrossTeam(\n    params: CrossTeamQueryParams\n  ): Promise<CrossTeamPaginatedResult<RefundRecordCrossTeam>> {\n    const { startDate, endDate, page = 1, pageSize = 20 } = params;\n\n    if (!startDate || !endDate) {\n      throw new PlolinkError('startDate and endDate are required', 'MISSING_PARAMS');\n    }\n\n    if (pageSize > 100) {\n      throw new PlolinkError('pageSize must not exceed 100', 'INVALID_PAGE_SIZE');\n    }\n\n    return this.client.axiosInstance.get('/api/v1/payments/refund/records:cross-team', {\n      params: {\n        startDate,\n        endDate,\n        page,\n        pageSize,\n      },\n    });\n  }\n}\n"]}