@plolink/sdk 0.0.4

package/dist/modules/billing/index.js

@@ -0,0 +1,411 @@
+import { Poller } from '../../chunk-IHAAKFEJ.js';
+import { PlolinkError } from '../../chunk-MD4O7FWT.js';
+
+// 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 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 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 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 PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new 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 PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new 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 PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new 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 PlolinkError("startDate and endDate are required", "MISSING_PARAMS");
+    }
+    if (pageSize > 100) {
+      throw new 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
+      }
+    });
+  }
+};
+
+export { Billing };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

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

package/dist/modules/chat/index.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+// src/modules/chat/index.ts
+var CHAT_MODULE_INFO = {
+  name: "chat",
+  version: "1.0.0",
+  status: "planned",
+  features: [
+    "conversation-create",
+    "message-send",
+    "history-query",
+    "content-moderation",
+    "conversation-management",
+    "material-association"
+  ]
+};
+
+exports.CHAT_MODULE_INFO = CHAT_MODULE_INFO;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/chat/index.ts"],"names":[],"mappings":";;;AA8DO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA,EAAM,MAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,MAAA,EAAQ,SAAA;AAAA,EACR,QAAA,EAAU;AAAA,IACR,qBAAA;AAAA,IACA,cAAA;AAAA,IACA,eAAA;AAAA,IACA,oBAAA;AAAA,IACA,yBAAA;AAAA,IACA;AAAA;AAEJ","file":"index.cjs","sourcesContent":["/**\n * 对话能力模块\n * \n * @description\n * 提供基于已有信息的对话功能。\n * 使用素材创建对话，聊天历史数据存储在中台。\n * 包含内容审核检查，非流式输出。\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Chat } from '@plolink/sdk/chat';\n * \n * const client = new PlolinkClient({ mode: 'apiKey', apiKey: 'xxx' });\n * const chat = new Chat(client);\n * \n * // 创建对话\n * const conversation = await chat.createConversation({\n *   materialId: 'material-123'\n * });\n * ```\n * \n * @module chat\n */\n\n// 预留：将在后续实现 Chat 类\n\n/**\n * Chat 模块占位符\n * \n * @description\n * 此模块将在后续版本中实现以下功能：\n * - 创建对话会话\n * - 发送消息\n * - 获取对话历史\n * - 内容审核\n * - 对话管理\n * - 素材关联\n * \n * @example\n * ```typescript\n * // 未来使用方式（预览）\n * const chat = new Chat(client);\n * \n * // 创建对话\n * const conversation = await chat.createConversation({\n *   materialId: 'material-123',\n *   context: '这是关于产品的文档...'\n * });\n * \n * // 发送消息\n * const response = await chat.sendMessage({\n *   conversationId: conversation.id,\n *   message: '请介绍一下这个产品'\n * });\n * \n * console.log('AI response:', response.content);\n * \n * // 获取历史记录\n * const history = await chat.getHistory(conversation.id);\n * ```\n */\nexport const CHAT_MODULE_INFO = {\n  name: 'chat',\n  version: '1.0.0',\n  status: 'planned',\n  features: [\n    'conversation-create',\n    'message-send',\n    'history-query',\n    'content-moderation',\n    'conversation-management',\n    'material-association',\n  ],\n} as const;\n\n// 导出类型（预留）\nexport type ChatModuleInfo = typeof CHAT_MODULE_INFO;\n\n"]}

package/dist/modules/chat/index.d.cts

@@ -0,0 +1,68 @@
+/**
+ * 对话能力模块
+ *
+ * @description
+ * 提供基于已有信息的对话功能。
+ * 使用素材创建对话，聊天历史数据存储在中台。
+ * 包含内容审核检查，非流式输出。
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { Chat } from '@plolink/sdk/chat';
+ *
+ * const client = new PlolinkClient({ mode: 'apiKey', apiKey: 'xxx' });
+ * const chat = new Chat(client);
+ *
+ * // 创建对话
+ * const conversation = await chat.createConversation({
+ *   materialId: 'material-123'
+ * });
+ * ```
+ *
+ * @module chat
+ */
+/**
+ * Chat 模块占位符
+ *
+ * @description
+ * 此模块将在后续版本中实现以下功能：
+ * - 创建对话会话
+ * - 发送消息
+ * - 获取对话历史
+ * - 内容审核
+ * - 对话管理
+ * - 素材关联
+ *
+ * @example
+ * ```typescript
+ * // 未来使用方式（预览）
+ * const chat = new Chat(client);
+ *
+ * // 创建对话
+ * const conversation = await chat.createConversation({
+ *   materialId: 'material-123',
+ *   context: '这是关于产品的文档...'
+ * });
+ *
+ * // 发送消息
+ * const response = await chat.sendMessage({
+ *   conversationId: conversation.id,
+ *   message: '请介绍一下这个产品'
+ * });
+ *
+ * console.log('AI response:', response.content);
+ *
+ * // 获取历史记录
+ * const history = await chat.getHistory(conversation.id);
+ * ```
+ */
+declare const CHAT_MODULE_INFO: {
+    readonly name: "chat";
+    readonly version: "1.0.0";
+    readonly status: "planned";
+    readonly features: readonly ["conversation-create", "message-send", "history-query", "content-moderation", "conversation-management", "material-association"];
+};
+type ChatModuleInfo = typeof CHAT_MODULE_INFO;
+
+export { CHAT_MODULE_INFO, type ChatModuleInfo };

package/dist/modules/chat/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 对话能力模块
+ *
+ * @description
+ * 提供基于已有信息的对话功能。
+ * 使用素材创建对话，聊天历史数据存储在中台。
+ * 包含内容审核检查，非流式输出。
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { Chat } from '@plolink/sdk/chat';
+ *
+ * const client = new PlolinkClient({ mode: 'apiKey', apiKey: 'xxx' });
+ * const chat = new Chat(client);
+ *
+ * // 创建对话
+ * const conversation = await chat.createConversation({
+ *   materialId: 'material-123'
+ * });
+ * ```
+ *
+ * @module chat
+ */
+/**
+ * Chat 模块占位符
+ *
+ * @description
+ * 此模块将在后续版本中实现以下功能：
+ * - 创建对话会话
+ * - 发送消息
+ * - 获取对话历史
+ * - 内容审核
+ * - 对话管理
+ * - 素材关联
+ *
+ * @example
+ * ```typescript
+ * // 未来使用方式（预览）
+ * const chat = new Chat(client);
+ *
+ * // 创建对话
+ * const conversation = await chat.createConversation({
+ *   materialId: 'material-123',
+ *   context: '这是关于产品的文档...'
+ * });
+ *
+ * // 发送消息
+ * const response = await chat.sendMessage({
+ *   conversationId: conversation.id,
+ *   message: '请介绍一下这个产品'
+ * });
+ *
+ * console.log('AI response:', response.content);
+ *
+ * // 获取历史记录
+ * const history = await chat.getHistory(conversation.id);
+ * ```
+ */
+declare const CHAT_MODULE_INFO: {
+    readonly name: "chat";
+    readonly version: "1.0.0";
+    readonly status: "planned";
+    readonly features: readonly ["conversation-create", "message-send", "history-query", "content-moderation", "conversation-management", "material-association"];
+};
+type ChatModuleInfo = typeof CHAT_MODULE_INFO;
+
+export { CHAT_MODULE_INFO, type ChatModuleInfo };

package/dist/modules/chat/index.js

@@ -0,0 +1,18 @@
+// src/modules/chat/index.ts
+var CHAT_MODULE_INFO = {
+  name: "chat",
+  version: "1.0.0",
+  status: "planned",
+  features: [
+    "conversation-create",
+    "message-send",
+    "history-query",
+    "content-moderation",
+    "conversation-management",
+    "material-association"
+  ]
+};
+
+export { CHAT_MODULE_INFO };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/modules/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/chat/index.ts"],"names":[],"mappings":";AA8DO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA,EAAM,MAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,MAAA,EAAQ,SAAA;AAAA,EACR,QAAA,EAAU;AAAA,IACR,qBAAA;AAAA,IACA,cAAA;AAAA,IACA,eAAA;AAAA,IACA,oBAAA;AAAA,IACA,yBAAA;AAAA,IACA;AAAA;AAEJ","file":"index.js","sourcesContent":["/**\n * 对话能力模块\n * \n * @description\n * 提供基于已有信息的对话功能。\n * 使用素材创建对话，聊天历史数据存储在中台。\n * 包含内容审核检查，非流式输出。\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Chat } from '@plolink/sdk/chat';\n * \n * const client = new PlolinkClient({ mode: 'apiKey', apiKey: 'xxx' });\n * const chat = new Chat(client);\n * \n * // 创建对话\n * const conversation = await chat.createConversation({\n *   materialId: 'material-123'\n * });\n * ```\n * \n * @module chat\n */\n\n// 预留：将在后续实现 Chat 类\n\n/**\n * Chat 模块占位符\n * \n * @description\n * 此模块将在后续版本中实现以下功能：\n * - 创建对话会话\n * - 发送消息\n * - 获取对话历史\n * - 内容审核\n * - 对话管理\n * - 素材关联\n * \n * @example\n * ```typescript\n * // 未来使用方式（预览）\n * const chat = new Chat(client);\n * \n * // 创建对话\n * const conversation = await chat.createConversation({\n *   materialId: 'material-123',\n *   context: '这是关于产品的文档...'\n * });\n * \n * // 发送消息\n * const response = await chat.sendMessage({\n *   conversationId: conversation.id,\n *   message: '请介绍一下这个产品'\n * });\n * \n * console.log('AI response:', response.content);\n * \n * // 获取历史记录\n * const history = await chat.getHistory(conversation.id);\n * ```\n */\nexport const CHAT_MODULE_INFO = {\n  name: 'chat',\n  version: '1.0.0',\n  status: 'planned',\n  features: [\n    'conversation-create',\n    'message-send',\n    'history-query',\n    'content-moderation',\n    'conversation-management',\n    'material-association',\n  ],\n} as const;\n\n// 导出类型（预留）\nexport type ChatModuleInfo = typeof CHAT_MODULE_INFO;\n\n"]}

package/dist/modules/psych/index.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+// src/modules/psych/index.ts
+var PSYCH_MODULE_INFO = {
+  name: "psych",
+  version: "1.0.0",
+  status: "planned",
+  features: [
+    "question-sampling",
+    "assessment-create",
+    "answer-submit",
+    "result-generate",
+    "duplicate-prevention",
+    "history-query"
+  ]
+};
+
+exports.PSYCH_MODULE_INFO = PSYCH_MODULE_INFO;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/psych/index.ts"],"names":[],"mappings":";;;AA+DO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,IAAA,EAAM,OAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,MAAA,EAAQ,SAAA;AAAA,EACR,QAAA,EAAU;AAAA,IACR,mBAAA;AAAA,IACA,mBAAA;AAAA,IACA,eAAA;AAAA,IACA,iBAAA;AAAA,IACA,sBAAA;AAAA,IACA;AAAA;AAEJ","file":"index.cjs","sourcesContent":["/**\n * 心理测评模块\n * \n * @description\n * 提供心理题库抽题、评测创建、答题提交、结果生成等功能。\n * 随机逻辑在后端处理，前端获取的题目已经打乱。\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Psychology } from '@plolink/sdk/psych';\n * \n * const client = new PlolinkClient({ mode: 'apiKey', apiKey: 'xxx' });\n * const psych = new Psychology(client);\n * \n * // 抽题并创建评测\n * const assessment = await psych.createAssessment({\n *   type: 'big-five',\n *   count: 50\n * });\n * ```\n * \n * @module psych\n */\n\n// 预留：将在后续实现 Psychology 类\n\n/**\n * Psychology 模块占位符\n * \n * @description\n * 此模块将在后续版本中实现以下功能：\n * - 题库抽题（后端随机）\n * - 创建心理评测记录\n * - 提交答题结果\n * - 生成评测报告\n * - 防止重复提交\n * - 获取历史评测记录\n * \n * @example\n * ```typescript\n * // 未来使用方式（预览）\n * const psych = new Psychology(client);\n * \n * // 创建评测（自动抽题）\n * const assessment = await psych.createAssessment({\n *   type: 'big-five',\n *   count: 50\n * });\n * \n * // 提交答案\n * const result = await psych.submitAnswers({\n *   assessmentId: assessment.id,\n *   answers: [\n *     { questionId: 1, answer: 'A' },\n *     { questionId: 2, answer: 'B' }\n *   ]\n * });\n * \n * // 获取评测结果\n * console.log('Assessment result:', result);\n * ```\n */\nexport const PSYCH_MODULE_INFO = {\n  name: 'psych',\n  version: '1.0.0',\n  status: 'planned',\n  features: [\n    'question-sampling',\n    'assessment-create',\n    'answer-submit',\n    'result-generate',\n    'duplicate-prevention',\n    'history-query',\n  ],\n} as const;\n\n// 导出类型（预留）\nexport type PsychModuleInfo = typeof PSYCH_MODULE_INFO;\n\n"]}