weaver-work-cli 0.1.40 → 0.1.44

package/dist/shortcuts/invoice/operations/add.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
 import { addPreview, asPositiveString, assertNotDuplicate, detailInfo, getDetail, identityFingerprint, normalizeAddInfo, normalizeScope, objectFingerprint, operateType, preview, reqBase, sessionMatches, workflow, } from './shared.js';
 export class InvoiceAddPrepareOperation {
@@ -24,7 +25,7 @@ export class InvoiceAddPrepareOperation {
                 preview: addPreview(info, scope, session.baseUrl),
                 normalizedInfo: info,
                 continuation: continuationToken,
-                expiresInSeconds: 600,
+                expiresInSeconds: CONTINUATION_TTL_SECONDS,
                 workflow: workflow('invoice.add', 'AWAITING_CONFIRMATION'),
             },
         };

package/dist/shortcuts/invoice/operations/delete.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
 import { detailFingerprint, detailInfo, getDetail, normalizeScope, operateType, preview, reqBase, sessionMatches, workflow, } from './shared.js';
 export class InvoiceDeletePrepareOperation {
@@ -19,7 +20,7 @@ export class InvoiceDeletePrepareOperation {
             fingerprint: detailFingerprint(info),
             preview: item,
         });
-        return { status: 'AWAITING_CONFIRMATION', data: { preview: item, continuation: continuationToken, expiresInSeconds: 600, workflow: workflow('invoice.delete', 'AWAITING_CONFIRMATION') } };
+        return { status: 'AWAITING_CONFIRMATION', data: { preview: item, continuation: continuationToken, expiresInSeconds: CONTINUATION_TTL_SECONDS, workflow: workflow('invoice.delete', 'AWAITING_CONFIRMATION') } };
     }
 }
 export class InvoiceDeleteApplyOperation {

package/dist/shortcuts/invoice/operations/import.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
 import { asPositiveString, detailInfo, getDetail, importOptions, importSource, objectFingerprint, preview, sessionMatches, workflow, } from './shared.js';
 export class InvoiceImportPrepareOperation {
@@ -34,7 +35,7 @@ export class InvoiceImportPrepareOperation {
             data: {
                 preview: filePreview,
                 continuation: continuationToken,
-                expiresInSeconds: 600,
+                expiresInSeconds: CONTINUATION_TTL_SECONDS,
                 workflow: workflow('invoice.import', 'AWAITING_CONFIRMATION'),
             },
         };

package/dist/shortcuts/invoice/operations/issuing-contract-detail.js

@@ -0,0 +1,86 @@
+import { InvoiceCliError, invoiceValidationError } from '../errors.js';
+const REQUEST_DETAIL_PATH = '/api/workflow/core/paService/v1/getWorkflowRequest';
+/** 合同审批流程里放客户的 Ebuilder 字段；新客户购买合同没有「客户名称」，用「最终用户卡片」。 */
+const CUSTOMER_FIELD_TITLES = ['客户名称', '最终用户卡片'];
+const CONTRACT_FILE_FIELD_TITLE = '合同正文及附件';
+function textValue(value) {
+    if (value === undefined || value === null)
+        return null;
+    const text = String(value).trim();
+    return text === '' ? null : text;
+}
+function mainFields(data) {
+    const details = data?.formData?.dataDetails;
+    return Array.isArray(details) ? details.filter((item) => item?.formField && typeof item.formField === 'object') : [];
+}
+function fieldByTitle(fields, title, componentKey) {
+    return fields.find((field) => textValue(field.formField.title) === title && textValue(field.formField.componentKey) === componentKey);
+}
+function customerOf(fields) {
+    for (const title of CUSTOMER_FIELD_TITLES) {
+        const option = fieldByTitle(fields, title, 'Ebuilder')?.dataOptions?.[0];
+        const id = textValue(option?.optionId);
+        const name = textValue(option?.content);
+        if (id && name)
+            return { customer: { id, name }, customerSource: title };
+    }
+    return { customer: null, customerSource: null };
+}
+function contractDocumentsOf(fields) {
+    const options = fieldByTitle(fields, CONTRACT_FILE_FIELD_TITLE, 'FileComponent')?.dataOptions;
+    if (!Array.isArray(options))
+        return [];
+    return options.map((option) => ({
+        docId: textValue(option?.optionObj?.docId),
+        fileId: textValue(option?.optionObj?.fileid) ?? textValue(option?.optionId),
+        name: textValue(option?.content) ?? textValue(option?.optionObj?.name),
+    }));
+}
+export class InvoiceIssuingContractDetailOperation {
+    name = 'invoice.issuing.contract.detail';
+    async execute(input, { host }) {
+        const requestId = textValue(input.requestId);
+        if (!requestId || !/^\d+$/u.test(requestId)) {
+            throw invoiceValidationError('input_invalid', 'requestId 必须是合同审批流程的数字 requestId');
+        }
+        const session = await host.getSession();
+        const result = await host.invoiceRequest({
+            path: REQUEST_DETAIL_PATH,
+            method: 'POST',
+            body: {
+                requestId,
+                isGetRequestBaseInfo: true,
+                isGetRequestLog: false,
+                isGetFormData: true,
+                isReadRequest: false,
+                ...(session.userId ? { userId: session.userId } : {}),
+            },
+            operation: this.name,
+        });
+        const errcode = textValue(result?.message?.errcode);
+        if (errcode !== null && errcode !== '0') {
+            throw new InvoiceCliError('api', 'issuing_contract_detail_failed', textValue(result?.message?.errmsg) ?? `读取合同流程 ${requestId} 失败`, {
+                code: errcode,
+                exitCode: 1,
+            });
+        }
+        const data = result?.data;
+        if (!Array.isArray(data?.formData?.dataDetails)) {
+            throw new InvoiceCliError('api', 'issuing_contract_detail_failed', `合同流程 ${requestId} 的详情缺少表单数据，可能没有查看权限`, { exitCode: 1 });
+        }
+        const fields = mainFields(data);
+        const contractDocuments = contractDocumentsOf(fields);
+        const docIds = contractDocuments.map((document) => document.docId).filter((docId) => Boolean(docId));
+        return {
+            status: 'COMPLETE',
+            data: {
+                requestId,
+                requestName: textValue(data.workflowBaseInfo?.requestName),
+                workflowName: textValue(data.workflowBaseInfo?.workflowName),
+                ...customerOf(fields),
+                contractDocuments,
+                contractDocIds: docIds.length ? docIds.join(',') : null,
+            },
+        };
+    }
+}

package/dist/shortcuts/invoice/operations/issuing-contracts.js

@@ -0,0 +1,210 @@
+import { InvoiceCliError, invoiceValidationError } from '../errors.js';
+import { assertBusinessSuccess } from './shared.js';
+const CONTRACT_DATA_PATH = '/api/ebuilder/form/eblist/getData';
+const PAGE_APP_ID = '846297243998732291';
+const PAGE_ID = '1332949650257698904';
+const COMP_ID = 'd9393fc65f7f49cc870600a78d71bc0e';
+const DETAIL_PAGE_SIZE = 100;
+const MAX_DETAIL_PAGES = 20;
+const MAX_REQUESTS = 50;
+/** 「合同虚拟表」返回行的字段 id。 */
+const FIELD = {
+    contractNo: '1201427014149029927',
+    seller: '1214704660726972419',
+    itemName: '1204384271089598493',
+    amount: '1201418617613795454',
+    customerName: '1201418170947821738',
+    buyerTaxNo: '1201418170947821739',
+    group: '1201417526769836172',
+};
+function contractFilter(requestId) {
+    return [{
+            conditionType: 'and',
+            dataType: 'field',
+            id: 'd65b6602cd2e4c119beda5f5721e6035',
+            conditionComId: `${COMP_ID}_advance_EXCLUDECACHE`,
+            filterFields: [{
+                    compId: COMP_ID,
+                    compType: 'Workflow',
+                    dataset: {
+                        isPhysical: true,
+                        relationDataset: { groupId: 'weaver-ebuilder-form-service', id: '1201416959744065575', type: 'LOGIC' },
+                        ebuilderDataConfig: { dataSetup: {}, type: 'FORM' },
+                        detailTable: false,
+                        groupId: 'weaver-ebuilder-form-service',
+                        usage: 'all',
+                        appId: PAGE_APP_ID,
+                        id: '1332949650257698828',
+                        text: '合同虚拟表',
+                        type: 'LOGIC',
+                        objType: 'vform',
+                    },
+                    fieldName: 'field_1208799170921791564',
+                    id: '1208799170921791564',
+                    objId: '1332949650257698828',
+                    type: 'Workflow',
+                    text: '合同审批流程',
+                }],
+            funcType: 'inC',
+            value: requestId,
+            customSelect: null,
+        }];
+}
+function textValue(value) {
+    if (value === undefined || value === null)
+        return null;
+    const text = String(value).trim();
+    return text === '' ? null : text;
+}
+function firstText(rows, field) {
+    for (const row of rows) {
+        const value = textValue(row[field]);
+        if (value)
+            return value;
+    }
+    return null;
+}
+function sellerName(rows) {
+    for (const row of rows) {
+        const sellers = Array.isArray(row[FIELD.seller]) ? row[FIELD.seller] : [];
+        const names = sellers.map((seller) => textValue(seller?.name)).filter(Boolean);
+        if (names.length)
+            return names.join('、');
+    }
+    return null;
+}
+function amountCents(value, requestId) {
+    const text = textValue(value)?.replace(/,/g, '') ?? null;
+    if (text === null)
+        return 0;
+    if (!/^-?\d+(?:\.\d+)?$/u.test(text)) {
+        throw new InvoiceCliError('api', 'issuing_amount_invalid', `合同流程 ${requestId} 的开票金额不是数字：${text}`, { exitCode: 1 });
+    }
+    return Math.round(Number(text) * 100);
+}
+function formatCents(cents) {
+    return (cents / 100).toFixed(2);
+}
+/** 把同一合同的开票明细汇总成「是否开票、合同号、客户、开票金额」；明细为空表示已开票。 */
+export function summarizeContractRows(requestId, rows) {
+    if (rows.length === 0) {
+        return {
+            invoiced: true,
+            contractNo: null,
+            customerName: null,
+            buyerTaxNo: null,
+            sellerName: null,
+            invoiceAmount: null,
+            invoiceGroups: [],
+        };
+    }
+    const groups = new Map();
+    let totalCents = 0;
+    for (const row of rows) {
+        const group = textValue(row[FIELD.group]);
+        const cents = amountCents(row[FIELD.amount], requestId);
+        totalCents += cents;
+        const key = group ?? '';
+        const entry = groups.get(key) ?? { group, cents: 0, items: [] };
+        entry.cents += cents;
+        entry.items.push({ name: textValue(row[FIELD.itemName]), amount: formatCents(cents) });
+        groups.set(key, entry);
+    }
+    return {
+        invoiced: false,
+        contractNo: firstText(rows, FIELD.contractNo),
+        customerName: firstText(rows, FIELD.customerName),
+        buyerTaxNo: firstText(rows, FIELD.buyerTaxNo),
+        sellerName: sellerName(rows),
+        invoiceAmount: formatCents(totalCents),
+        invoiceGroups: [...groups.values()].map(({ group, cents, items }) => ({ group, amount: formatCents(cents), items })),
+    };
+}
+function requestIdOf(value, location) {
+    const requestId = textValue(value);
+    if (!requestId || !/^\d+$/u.test(requestId)) {
+        throw invoiceValidationError('input_invalid', `${location} 必须是数字 requestId`);
+    }
+    return requestId;
+}
+function inputCards(input) {
+    const { cards, requestIds } = input;
+    if (cards !== undefined && requestIds !== undefined) {
+        throw invoiceValidationError('input_ambiguous', 'cards 与 requestIds 只能提供一个');
+    }
+    let result;
+    if (cards !== undefined) {
+        if (!Array.isArray(cards))
+            throw invoiceValidationError('input_invalid', 'cards 必须是 workflow.search 返回的 data.cards 数组');
+        result = cards.map((card, index) => {
+            if (!card || typeof card !== 'object' || Array.isArray(card)) {
+                throw invoiceValidationError('input_invalid', `cards[${index}] 必须是对象`);
+            }
+            return { ...card, requestId: requestIdOf(card.requestId, `cards[${index}].requestId`) };
+        });
+    }
+    else {
+        const ids = typeof requestIds === 'string' ? requestIds.split(',') : requestIds;
+        if (!Array.isArray(ids))
+            throw invoiceValidationError('input_invalid', '必须提供 cards 或 requestIds');
+        result = ids.map((id, index) => ({ requestId: requestIdOf(id, `requestIds[${index}]`) }));
+    }
+    if (result.length === 0)
+        throw invoiceValidationError('input_invalid', 'cards / requestIds 不能为空');
+    if (result.length > MAX_REQUESTS)
+        throw invoiceValidationError('input_invalid', `一次最多查询 ${MAX_REQUESTS} 个合同流程`);
+    return result;
+}
+export class InvoiceIssuingContractsListOperation {
+    name = 'invoice.issuing.contracts.list';
+    async execute(input, { host }) {
+        const cards = inputCards(input);
+        const summaries = new Map();
+        for (const { requestId } of cards) {
+            if (summaries.has(requestId))
+                continue;
+            const rows = await this.contractRows(host, requestId);
+            summaries.set(requestId, summarizeContractRows(requestId, rows));
+        }
+        const merged = cards.map((card) => ({ ...card, ...summaries.get(card.requestId) }));
+        const pendingCount = merged.filter((card) => card.invoiced === false).length;
+        return {
+            status: 'COMPLETE',
+            data: {
+                cards: merged,
+                count: merged.length,
+                pendingCount,
+                invoicedCount: merged.length - pendingCount,
+            },
+        };
+    }
+    async contractRows(host, requestId) {
+        const rows = [];
+        for (let pageNo = 1; pageNo <= MAX_DETAIL_PAGES; pageNo += 1) {
+            const result = await host.invoiceMultipartRequest({
+                path: CONTRACT_DATA_PATH,
+                method: 'POST',
+                fields: {
+                    filter: contractFilter(requestId),
+                    fieldFilter: {},
+                    pageFilter: { filter: {}, filterIsNull: true, esbFilter: [] },
+                    pageAppId: PAGE_APP_ID,
+                    compId: COMP_ID,
+                    pageId: PAGE_ID,
+                    pageNo: String(pageNo),
+                    pageSize: String(DETAIL_PAGE_SIZE),
+                },
+                operation: this.name,
+            });
+            assertBusinessSuccess(result, 'issuing_contracts_query_failed', `查询合同流程 ${requestId} 的开票数据失败`);
+            const list = result?.data?.list;
+            if (!Array.isArray(list)) {
+                throw new InvoiceCliError('api', 'issuing_contracts_query_failed', `合同流程 ${requestId} 的开票数据返回缺少 data.list`, { exitCode: 1 });
+            }
+            rows.push(...list);
+            if (list.length < DETAIL_PAGE_SIZE)
+                return rows;
+        }
+        throw new InvoiceCliError('api', 'issuing_contracts_too_many_rows', `合同流程 ${requestId} 的开票明细超过 ${DETAIL_PAGE_SIZE * MAX_DETAIL_PAGES} 行`, { exitCode: 1 });
+    }
+}

package/dist/shortcuts/invoice/operations/registry.js

@@ -1,16 +1,17 @@
 import { invoiceValidationError } from '../errors.js';
-import { invoiceOperations } from '../manifest.js';
+import { invoiceOperations, invoiceRetiredOperations } from '../manifest.js';
 import { InvoiceAddApplyOperation, InvoiceAddPrepareOperation } from './add.js';
 import { InvoiceBrowseFieldDataOperation } from './browse-field.js';
 import { InvoiceDeleteApplyOperation, InvoiceDeletePrepareOperation } from './delete.js';
 import { InvoiceDownloadOperation } from './download.js';
 import { InvoiceGetOperation } from './get.js';
 import { InvoiceImportApplyOperation, InvoiceImportPrepareOperation } from './import.js';
-import { InvoiceIssuingQysListOperation } from './issuing-qys.js';
+import { InvoiceIssuingContractDetailOperation } from './issuing-contract-detail.js';
+import { InvoiceIssuingContractsListOperation } from './issuing-contracts.js';
 import { InvoiceListOperation } from './list.js';
 import { InvoiceOcrPreviewOperation } from './ocr-preview.js';
-import { InvoiceReimEmployeeSuperiorsOperation, InvoiceReimFieldSearchOperation, InvoiceReimFileOcrPreviewOperation, InvoiceReimFlowCreateApplyOperation, InvoiceReimFlowCreatePrepareOperation, InvoiceReimFlowUpdateApplyOperation, InvoiceReimFlowUpdatePrepareOperation, InvoiceReimFormStructureOperation, InvoiceReimRequestsListOperation, InvoiceReimRowInfoBatchOperation, InvoiceReimRowInfoOperation, InvoiceReimWorkflowResolveOperation, } from './reim.js';
-import { InvoiceReimCandidatesListOperation, InvoiceReimFlowCreateAutoPrepareOperation, InvoiceReimTemplateBuildOperation, } from './reim-auto.js';
+import { InvoiceReimEmployeeSuperiorsOperation, InvoiceReimFieldSearchOperation, InvoiceReimFileOcrPreviewOperation, InvoiceReimRequestsListOperation, InvoiceReimWorkflowResolveOperation, } from './reim.js';
+import { InvoiceReimCandidatesListOperation } from './reim-auto.js';
 import { InvoiceUpdateApplyOperation, InvoiceUpdatePrepareOperation } from './update.js';
 import { InvoiceUploadOperation } from './upload.js';
 import { InvoiceUploadAndValidateOperation } from './upload-and-validate.js';
@@ -39,18 +40,10 @@ function buildRegistry() {
         new InvoiceReimRequestsListOperation(),
         new InvoiceReimWorkflowResolveOperation(),
         new InvoiceReimCandidatesListOperation(),
-        new InvoiceReimTemplateBuildOperation(),
-        new InvoiceReimFlowCreateAutoPrepareOperation(),
-        new InvoiceReimFormStructureOperation(),
-        new InvoiceReimRowInfoOperation(),
-        new InvoiceReimRowInfoBatchOperation(),
         new InvoiceReimEmployeeSuperiorsOperation(),
         new InvoiceReimFieldSearchOperation(),
-        new InvoiceReimFlowCreatePrepareOperation(),
-        new InvoiceReimFlowCreateApplyOperation(),
-        new InvoiceReimFlowUpdatePrepareOperation(),
-        new InvoiceReimFlowUpdateApplyOperation(),
-        new InvoiceIssuingQysListOperation(),
+        new InvoiceIssuingContractsListOperation(),
+        new InvoiceIssuingContractDetailOperation(),
     ];
     for (const handler of handlers) {
         if (registry.has(handler.name))
@@ -61,13 +54,20 @@ function buildRegistry() {
         if (!registry.has(contract.name))
             throw new Error(`missing invoice operation handler: ${contract.name}`);
     }
+    for (const retired of invoiceRetiredOperations) {
+        if (registry.has(retired.name))
+            throw new Error(`retired invoice operation is still registered: ${retired.name}`);
+    }
     return registry;
 }
 const invoiceOperationRegistry = buildRegistry();
 export function getInvoiceOperation(operation) {
     const handler = invoiceOperationRegistry.get(operation);
-    if (!handler) {
-        throw invoiceValidationError('operation_unknown', `业票通不支持操作：${operation}`);
+    if (handler)
+        return handler;
+    const retired = invoiceRetiredOperations.find((item) => item.name === operation);
+    if (retired) {
+        throw invoiceValidationError('operation_retired', `业票通不支持操作：${operation}（已下线）。${retired.replacement}；详见 weaver-e10-yepiaotong 的 ${retired.reference}`, { operation, replacement: retired.replacement, reference: retired.reference });
     }
-    return handler;
+    throw invoiceValidationError('operation_unknown', `业票通不支持操作：${operation}`);
 }