@plolink/sdk 2.0.1 → 2.0.4

package/dist/modules/invoice-application/index.cjs

@@ -0,0 +1,164 @@
+'use strict';
+
+var chunkY3UJVC2L_cjs = require('../../chunk-Y3UJVC2L.cjs');
+
+// src/modules/invoice-application/index.ts
+var InvoiceApplication = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 获取团队财务选项
+   *
+   * @description
+   * 返回当前用户有申请开票权限的团队列表及其财务信息。
+   * 包含每个团队的可开票金额、消费金额、已开票金额和余额。
+   *
+   * @returns 团队财务选项列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   *
+   * @example
+   * ```typescript
+   * const teams = await invoiceApp.getTeamFinancialOptions();
+   * teams.forEach(team => {
+   *   console.log(`${team.teamName}: 可开票 ${team.invoiceableAmount}`);
+   * });
+   * ```
+   */
+  async getTeamFinancialOptions() {
+    return this.client.axiosInstance.get("/api/v1/payments/teams/financial-options");
+  }
+  /**
+   * 创建开票申请
+   *
+   * @description
+   * 创建跨团队开票申请。支持同时为多个团队申请开票，
+   * 申请单将提交给财务审核。
+   *
+   * @param params - 开票申请参数
+   * @returns 创建结果，包含申请单ID和创建时间
+   * @throws {PlolinkError} 当参数无效或创建失败时抛出
+   *
+   * @example
+   * ```typescript
+   * // 单团队申请
+   * const result = await invoiceApp.create({
+   *   teams: [{ teamId: 'team-1', amount: 1000 }],
+   *   invoiceType: 'VAT_SPECIAL',
+   *   invoiceTitle: 'Test Company Ltd',
+   *   taxNumber: '91110000XXX',
+   *   remark: 'January invoice'
+   * });
+   * console.log(`申请单ID: ${result.id}`);
+   *
+   * // 跨团队申请
+   * const result = await invoiceApp.create({
+   *   teams: [
+   *     { teamId: 'team-1', amount: 500 },
+   *     { teamId: 'team-2', amount: 300 }
+   *   ],
+   *   invoiceType: 'VAT_NORMAL',
+   *   invoiceTitle: 'Test Company Ltd',
+   *   taxNumber: '91110000XXX'
+   * });
+   * ```
+   */
+  async create(params) {
+    const { teams, invoiceType, invoiceTitle, taxNumber, businessModule, businessCode, businessId, remark } = params;
+    if (!teams || teams.length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("teams is required and must not be empty", "INVALID_PARAMS");
+    }
+    for (const team of teams) {
+      if (!team.teamId) {
+        throw new chunkY3UJVC2L_cjs.PlolinkError("teamId is required for each team", "INVALID_PARAMS");
+      }
+      if (!team.amount || team.amount <= 0) {
+        throw new chunkY3UJVC2L_cjs.PlolinkError("amount must be greater than 0 for each team", "INVALID_PARAMS");
+      }
+    }
+    if (!invoiceType) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("invoiceType is required", "INVALID_PARAMS");
+    }
+    if (!invoiceTitle) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("invoiceTitle is required", "INVALID_PARAMS");
+    }
+    if (!taxNumber) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("taxNumber is required", "INVALID_PARAMS");
+    }
+    this.client.logger.info("Creating invoice application", {
+      teamCount: teams.length,
+      totalAmount: teams.reduce((sum, t) => sum + t.amount, 0),
+      invoiceType
+    });
+    return this.client.axiosInstance.post("/api/v1/payments/invoice/applications", {
+      teams,
+      invoiceType,
+      invoiceTitle,
+      taxNumber,
+      businessModule,
+      businessCode,
+      businessId,
+      remark
+    });
+  }
+  /**
+   * 分页查询申请单列表
+   *
+   * @description
+   * 分页查询当前用户提交的发票申请单列表，支持按状态筛选。
+   *
+   * @param params - 查询参数
+   * @returns 分页申请单列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   *
+   * @example
+   * ```typescript
+   * // 查询所有申请单
+   * const result = await invoiceApp.list({ page: 1, pageSize: 20 });
+   * console.log(`共 ${result.total} 条申请单`);
+   *
+   * // 按状态筛选
+   * const pending = await invoiceApp.list({ status: 'PENDING' });
+   * const approved = await invoiceApp.list({ status: 'APPROVED' });
+   * ```
+   */
+  async list(params = {}) {
+    const { page = 1, pageSize = 20, status } = params;
+    return this.client.axiosInstance.get("/api/v1/payments/invoice/applications", {
+      params: { page, pageSize, status }
+    });
+  }
+  /**
+   * 查询申请单详情
+   *
+   * @description
+   * 根据申请单ID查询详细信息，包括各团队的申请金额和审核状态。
+   *
+   * @param id - 申请单ID
+   * @returns 申请单详情
+   * @throws {PlolinkError} 当申请单不存在或请求失败时抛出
+   *
+   * @example
+   * ```typescript
+   * const detail = await invoiceApp.getById('application-id');
+   * console.log(`状态: ${detail.status}`);
+   * console.log(`总金额: ${detail.totalAmount}`);
+   * console.log(`发票号: ${detail.invoiceNumber || '未填写'}`);
+   *
+   * // 查看各团队详情
+   * detail.details.forEach(d => {
+   *   console.log(`${d.teamName}: ${d.amount}`);
+   * });
+   * ```
+   */
+  async getById(id) {
+    if (!id) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/payments/invoice/applications/${id}`);
+  }
+};
+
+exports.InvoiceApplication = InvoiceApplication;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/invoice-application/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/invoice-application/index.ts"],"names":["PlolinkError"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 发票申请模块\n *\n * @description\n * 提供跨团队发票申请相关功能，包括：\n * - 获取有申请开票权限的团队财务选项\n * - 创建跨团队开票申请\n * - 分页查询申请单列表\n * - 查询申请单详情\n *\n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { InvoiceApplication } from '@plolink/sdk/invoice-application';\n *\n * const client = new PlolinkClient({\n *   token: 'sk-your-api-key'\n * });\n *\n * const invoiceApp = new InvoiceApplication(client);\n *\n * // 获取可申请开票的团队列表\n * const teams = await invoiceApp.getTeamFinancialOptions();\n *\n * // 创建开票申请\n * const result = await invoiceApp.create({\n *   teams: [{ teamId: 'team-1', amount: 1000 }],\n *   invoiceType: 'VAT_SPECIAL',\n *   invoiceTitle: 'Company Name',\n *   taxNumber: '91110000XXX'\n * });\n *\n * // 查询申请单列表\n * const list = await invoiceApp.list({ page: 1, pageSize: 20 });\n *\n * // 查询申请单详情\n * const detail = await invoiceApp.getById(result.id);\n * ```\n *\n * @module invoice-application\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { PlolinkError } from '../../core/error';\nimport type {\n  CreateInvoiceApplicationParams,\n  CreateInvoiceApplicationResult,\n  ListInvoiceApplicationsParams,\n  PaginatedInvoiceApplications,\n  InvoiceApplicationDetail,\n  TeamFinancialOption,\n} from '../../types/invoice-application';\n\nexport type {\n  InvoiceApplicationStatus,\n  CreateInvoiceApplicationParams,\n  CreateInvoiceApplicationResult,\n  ListInvoiceApplicationsParams,\n  InvoiceApplicationListItem,\n  PaginatedInvoiceApplications,\n  InvoiceApplicationDetail,\n  TeamFinancialOption,\n} from '../../types/invoice-application';\n\n/**\n * 发票申请模块\n */\nexport class InvoiceApplication {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 获取团队财务选项\n   *\n   * @description\n   * 返回当前用户有申请开票权限的团队列表及其财务信息。\n   * 包含每个团队的可开票金额、消费金额、已开票金额和余额。\n   *\n   * @returns 团队财务选项列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   *\n   * @example\n   * ```typescript\n   * const teams = await invoiceApp.getTeamFinancialOptions();\n   * teams.forEach(team => {\n   *   console.log(`${team.teamName}: 可开票 ${team.invoiceableAmount}`);\n   * });\n   * ```\n   */\n  public async getTeamFinancialOptions(): Promise<TeamFinancialOption[]> {\n    return this.client.axiosInstance.get('/api/v1/payments/teams/financial-options');\n  }\n\n  /**\n   * 创建开票申请\n   *\n   * @description\n   * 创建跨团队开票申请。支持同时为多个团队申请开票，\n   * 申请单将提交给财务审核。\n   *\n   * @param params - 开票申请参数\n   * @returns 创建结果，包含申请单ID和创建时间\n   * @throws {PlolinkError} 当参数无效或创建失败时抛出\n   *\n   * @example\n   * ```typescript\n   * // 单团队申请\n   * const result = await invoiceApp.create({\n   *   teams: [{ teamId: 'team-1', amount: 1000 }],\n   *   invoiceType: 'VAT_SPECIAL',\n   *   invoiceTitle: 'Test Company Ltd',\n   *   taxNumber: '91110000XXX',\n   *   remark: 'January invoice'\n   * });\n   * console.log(`申请单ID: ${result.id}`);\n   *\n   * // 跨团队申请\n   * const result = await invoiceApp.create({\n   *   teams: [\n   *     { teamId: 'team-1', amount: 500 },\n   *     { teamId: 'team-2', amount: 300 }\n   *   ],\n   *   invoiceType: 'VAT_NORMAL',\n   *   invoiceTitle: 'Test Company Ltd',\n   *   taxNumber: '91110000XXX'\n   * });\n   * ```\n   */\n  public async create(\n    params: CreateInvoiceApplicationParams,\n  ): Promise<CreateInvoiceApplicationResult> {\n    const { teams, invoiceType, invoiceTitle, taxNumber, businessModule, businessCode, businessId, remark } = params;\n\n    // 参数验证\n    if (!teams || teams.length === 0) {\n      throw new PlolinkError('teams is required and must not be empty', 'INVALID_PARAMS');\n    }\n\n    for (const team of teams) {\n      if (!team.teamId) {\n        throw new PlolinkError('teamId is required for each team', 'INVALID_PARAMS');\n      }\n      if (!team.amount || team.amount <= 0) {\n        throw new PlolinkError('amount must be greater than 0 for each team', 'INVALID_PARAMS');\n      }\n    }\n\n    if (!invoiceType) {\n      throw new PlolinkError('invoiceType is required', 'INVALID_PARAMS');\n    }\n\n    if (!invoiceTitle) {\n      throw new PlolinkError('invoiceTitle is required', 'INVALID_PARAMS');\n    }\n\n    if (!taxNumber) {\n      throw new PlolinkError('taxNumber is required', 'INVALID_PARAMS');\n    }\n\n    this.client.logger.info('Creating invoice application', {\n      teamCount: teams.length,\n      totalAmount: teams.reduce((sum, t) => sum + t.amount, 0),\n      invoiceType,\n    });\n\n    return this.client.axiosInstance.post('/api/v1/payments/invoice/applications', {\n      teams,\n      invoiceType,\n      invoiceTitle,\n      taxNumber,\n      businessModule,\n      businessCode,\n      businessId,\n      remark,\n    });\n  }\n\n  /**\n   * 分页查询申请单列表\n   *\n   * @description\n   * 分页查询当前用户提交的发票申请单列表，支持按状态筛选。\n   *\n   * @param params - 查询参数\n   * @returns 分页申请单列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   *\n   * @example\n   * ```typescript\n   * // 查询所有申请单\n   * const result = await invoiceApp.list({ page: 1, pageSize: 20 });\n   * console.log(`共 ${result.total} 条申请单`);\n   *\n   * // 按状态筛选\n   * const pending = await invoiceApp.list({ status: 'PENDING' });\n   * const approved = await invoiceApp.list({ status: 'APPROVED' });\n   * ```\n   */\n  public async list(\n    params: ListInvoiceApplicationsParams = {},\n  ): Promise<PaginatedInvoiceApplications> {\n    const { page = 1, pageSize = 20, status } = params;\n\n    return this.client.axiosInstance.get('/api/v1/payments/invoice/applications', {\n      params: { page, pageSize, status },\n    });\n  }\n\n  /**\n   * 查询申请单详情\n   *\n   * @description\n   * 根据申请单ID查询详细信息，包括各团队的申请金额和审核状态。\n   *\n   * @param id - 申请单ID\n   * @returns 申请单详情\n   * @throws {PlolinkError} 当申请单不存在或请求失败时抛出\n   *\n   * @example\n   * ```typescript\n   * const detail = await invoiceApp.getById('application-id');\n   * console.log(`状态: ${detail.status}`);\n   * console.log(`总金额: ${detail.totalAmount}`);\n   * console.log(`发票号: ${detail.invoiceNumber || '未填写'}`);\n   *\n   * // 查看各团队详情\n   * detail.details.forEach(d => {\n   *   console.log(`${d.teamName}: ${d.amount}`);\n   * });\n   * ```\n   */\n  public async getById(id: string): Promise<InvoiceApplicationDetail> {\n    if (!id) {\n      throw new PlolinkError('id is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/payments/invoice/applications/${id}`);\n  }\n}\n"]}

package/dist/modules/invoice-application/index.d.cts

@@ -0,0 +1,311 @@
+import { P as PlolinkClient } from '../../client-CAjIQKPm.cjs';
+import '../../core-77EbLgbp.cjs';
+import 'axios';
+
+/**
+ * 发票申请模块类型
+ */
+/**
+ * 申请单状态
+ */
+type InvoiceApplicationStatus = 'PENDING' | 'APPROVED' | 'REJECTED';
+/**
+ * 创建开票申请参数
+ */
+interface CreateInvoiceApplicationParams {
+    /** 团队列表，每个团队包含团队ID和申请金额 */
+    teams: Array<{
+        /** 团队ID */
+        teamId: string;
+        /** 申请金额 */
+        amount: number;
+    }>;
+    /** 发票类型 */
+    invoiceType: string;
+    /** 发票抬头 */
+    invoiceTitle: string;
+    /** 税号 */
+    taxNumber: string;
+    /** 业务模块（可选） */
+    businessModule?: string;
+    /** 业务编码（可选） */
+    businessCode?: string;
+    /** 业务ID（可选） */
+    businessId?: string;
+    /** 备注（可选） */
+    remark?: string;
+}
+/**
+ * 创建开票申请响应
+ */
+interface CreateInvoiceApplicationResult {
+    /** 申请单ID */
+    id: string;
+    /** 创建时间 */
+    createdAt: Date;
+}
+/**
+ * 申请单列表查询参数
+ */
+interface ListInvoiceApplicationsParams {
+    /** 页码，从1开始，默认1 */
+    page?: number;
+    /** 每页条数，默认20 */
+    pageSize?: number;
+    /** 申请单状态筛选 */
+    status?: InvoiceApplicationStatus;
+}
+/**
+ * 申请单列表项
+ */
+interface InvoiceApplicationListItem {
+    /** 申请单ID */
+    id: string;
+    /** 总金额 */
+    totalAmount: string;
+    /** 发票抬头 */
+    invoiceTitle: string;
+    /** 申请单状态 */
+    status: InvoiceApplicationStatus;
+    /** 创建时间 */
+    createdAt: Date;
+    /** 涉及团队数量 */
+    teamCount: number;
+    /** 业务模块 */
+    businessModule: string;
+    /** 业务编码 */
+    businessCode: string;
+    /** 业务ID */
+    businessId: string;
+}
+/**
+ * 分页申请单列表结果
+ */
+interface PaginatedInvoiceApplications {
+    /** 申请单列表 */
+    list: InvoiceApplicationListItem[];
+    /** 总条数 */
+    total: number;
+    /** 当前页码 */
+    page: number;
+    /** 每页条数 */
+    pageSize: number;
+}
+/**
+ * 申请单详情中的团队信息
+ */
+interface InvoiceApplicationTeamDetail {
+    /** 团队ID */
+    teamId: string;
+    /** 团队名称 */
+    teamName: string;
+    /** 申请金额 */
+    amount: string;
+}
+/**
+ * 申请单详情
+ */
+interface InvoiceApplicationDetail {
+    /** 申请单ID */
+    id: string;
+    /** 申请单状态 */
+    status: InvoiceApplicationStatus;
+    /** 发票类型 */
+    invoiceType: string;
+    /** 发票抬头 */
+    invoiceTitle: string;
+    /** 税号 */
+    taxNumber: string;
+    /** 总金额 */
+    totalAmount: string;
+    /** 业务模块 */
+    businessModule: string;
+    /** 业务编码 */
+    businessCode: string;
+    /** 业务ID */
+    businessId: string;
+    /** 备注 */
+    remark: string;
+    /** 发票号（审核通过后填写） */
+    invoiceNumber: string;
+    /** 发票文件Key（审核通过后填写） */
+    fileKey: string;
+    /** 审核人ID */
+    reviewerId: string;
+    /** 审核时间 */
+    reviewedAt: Date | null;
+    /** 创建时间 */
+    createdAt: Date;
+    /** 团队详情列表 */
+    details: InvoiceApplicationTeamDetail[];
+}
+/**
+ * 团队财务选项
+ */
+interface TeamFinancialOption {
+    /** 团队ID */
+    teamId: string;
+    /** 团队名称 */
+    teamName: string;
+    /** 可开票金额 */
+    invoiceableAmount: string;
+    /** 消费金额 */
+    consumptionAmount: string;
+    /** 已开票金额 */
+    invoicedAmount: string;
+    /** 余额 */
+    balance: string;
+}
+
+/**
+ * 发票申请模块
+ *
+ * @description
+ * 提供跨团队发票申请相关功能，包括：
+ * - 获取有申请开票权限的团队财务选项
+ * - 创建跨团队开票申请
+ * - 分页查询申请单列表
+ * - 查询申请单详情
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { InvoiceApplication } from '@plolink/sdk/invoice-application';
+ *
+ * const client = new PlolinkClient({
+ *   token: 'sk-your-api-key'
+ * });
+ *
+ * const invoiceApp = new InvoiceApplication(client);
+ *
+ * // 获取可申请开票的团队列表
+ * const teams = await invoiceApp.getTeamFinancialOptions();
+ *
+ * // 创建开票申请
+ * const result = await invoiceApp.create({
+ *   teams: [{ teamId: 'team-1', amount: 1000 }],
+ *   invoiceType: 'VAT_SPECIAL',
+ *   invoiceTitle: 'Company Name',
+ *   taxNumber: '91110000XXX'
+ * });
+ *
+ * // 查询申请单列表
+ * const list = await invoiceApp.list({ page: 1, pageSize: 20 });
+ *
+ * // 查询申请单详情
+ * const detail = await invoiceApp.getById(result.id);
+ * ```
+ *
+ * @module invoice-application
+ */
+
+/**
+ * 发票申请模块
+ */
+declare class InvoiceApplication {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 获取团队财务选项
+     *
+     * @description
+     * 返回当前用户有申请开票权限的团队列表及其财务信息。
+     * 包含每个团队的可开票金额、消费金额、已开票金额和余额。
+     *
+     * @returns 团队财务选项列表
+     * @throws {PlolinkError} 当请求失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const teams = await invoiceApp.getTeamFinancialOptions();
+     * teams.forEach(team => {
+     *   console.log(`${team.teamName}: 可开票 ${team.invoiceableAmount}`);
+     * });
+     * ```
+     */
+    getTeamFinancialOptions(): Promise<TeamFinancialOption[]>;
+    /**
+     * 创建开票申请
+     *
+     * @description
+     * 创建跨团队开票申请。支持同时为多个团队申请开票，
+     * 申请单将提交给财务审核。
+     *
+     * @param params - 开票申请参数
+     * @returns 创建结果，包含申请单ID和创建时间
+     * @throws {PlolinkError} 当参数无效或创建失败时抛出
+     *
+     * @example
+     * ```typescript
+     * // 单团队申请
+     * const result = await invoiceApp.create({
+     *   teams: [{ teamId: 'team-1', amount: 1000 }],
+     *   invoiceType: 'VAT_SPECIAL',
+     *   invoiceTitle: 'Test Company Ltd',
+     *   taxNumber: '91110000XXX',
+     *   remark: 'January invoice'
+     * });
+     * console.log(`申请单ID: ${result.id}`);
+     *
+     * // 跨团队申请
+     * const result = await invoiceApp.create({
+     *   teams: [
+     *     { teamId: 'team-1', amount: 500 },
+     *     { teamId: 'team-2', amount: 300 }
+     *   ],
+     *   invoiceType: 'VAT_NORMAL',
+     *   invoiceTitle: 'Test Company Ltd',
+     *   taxNumber: '91110000XXX'
+     * });
+     * ```
+     */
+    create(params: CreateInvoiceApplicationParams): Promise<CreateInvoiceApplicationResult>;
+    /**
+     * 分页查询申请单列表
+     *
+     * @description
+     * 分页查询当前用户提交的发票申请单列表，支持按状态筛选。
+     *
+     * @param params - 查询参数
+     * @returns 分页申请单列表
+     * @throws {PlolinkError} 当请求失败时抛出
+     *
+     * @example
+     * ```typescript
+     * // 查询所有申请单
+     * const result = await invoiceApp.list({ page: 1, pageSize: 20 });
+     * console.log(`共 ${result.total} 条申请单`);
+     *
+     * // 按状态筛选
+     * const pending = await invoiceApp.list({ status: 'PENDING' });
+     * const approved = await invoiceApp.list({ status: 'APPROVED' });
+     * ```
+     */
+    list(params?: ListInvoiceApplicationsParams): Promise<PaginatedInvoiceApplications>;
+    /**
+     * 查询申请单详情
+     *
+     * @description
+     * 根据申请单ID查询详细信息，包括各团队的申请金额和审核状态。
+     *
+     * @param id - 申请单ID
+     * @returns 申请单详情
+     * @throws {PlolinkError} 当申请单不存在或请求失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const detail = await invoiceApp.getById('application-id');
+     * console.log(`状态: ${detail.status}`);
+     * console.log(`总金额: ${detail.totalAmount}`);
+     * console.log(`发票号: ${detail.invoiceNumber || '未填写'}`);
+     *
+     * // 查看各团队详情
+     * detail.details.forEach(d => {
+     *   console.log(`${d.teamName}: ${d.amount}`);
+     * });
+     * ```
+     */
+    getById(id: string): Promise<InvoiceApplicationDetail>;
+}
+
+export { type CreateInvoiceApplicationParams, type CreateInvoiceApplicationResult, InvoiceApplication, type InvoiceApplicationDetail, type InvoiceApplicationListItem, type InvoiceApplicationStatus, type ListInvoiceApplicationsParams, type PaginatedInvoiceApplications, type TeamFinancialOption };