weaver-work-cli 0.1.40 → 0.1.44

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

@@ -1,5 +1,5 @@
-import { InvoiceCliError, invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
-import { asNonEmptyString, asObject, assertBusinessSuccess, normalizeIdList, objectFingerprint, reqBase, sessionMatches, workflow, } from './shared.js';
+import { InvoiceCliError, invoiceValidationError } from '../errors.js';
+import { asNonEmptyString, assertBusinessSuccess, normalizeIdList, workflow, } from './shared.js';
 function integerInput(value, name, options = {}) {
     const min = options.min ?? 1;
     const max = options.max ?? 200;
@@ -35,14 +35,28 @@ export function addCalendarDays(isoDate, offsetDays) {
     const [year, month, day] = isoDate.split('-').map(Number);
     return formatUtcDate(new Date(Date.UTC(year, (month ?? 1) - 1, (day ?? 1) + offsetDays)));
 }
+/** 按日历月加减；目标月没有这一天时取该月最后一天。 */
+export function addCalendarMonths(isoDate, offsetMonths) {
+    const [year, month, day] = isoDate.split('-').map(Number);
+    const target = new Date(Date.UTC(year, (month ?? 1) - 1 + offsetMonths, 1));
+    const lastDay = new Date(Date.UTC(target.getUTCFullYear(), target.getUTCMonth() + 1, 0)).getUTCDate();
+    target.setUTCDate(Math.min(day ?? 1, lastDay));
+    return formatUtcDate(target);
+}
 /** 东八区日历日。 */
 export function shanghaiCalendarDate(offsetDays = 0, now = new Date()) {
     const today = new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai' }).format(now);
     return offsetDays === 0 ? today : addCalendarDays(today, offsetDays);
 }
-/** 不传结束日用东八区当天；无论是否传入，发给接口前都再加 1 天。 */
-function requestCreateDateEnd(value) {
-    return addCalendarDays(optionalDate(value, 'cusCreateDateEnd') ?? shanghaiCalendarDate(0), 1);
+const REQUEST_DEFAULT_LOOKBACK_DAYS = 7;
+const REQUEST_PHONE_LOOKBACK_DAYS = 90;
+const REQUEST_SCENES = new Set(['phone']);
+function requestScene(value) {
+    const scene = optionalString(value, 'scene');
+    if (scene !== undefined && !REQUEST_SCENES.has(scene)) {
+        throw invoiceValidationError('input_invalid', 'scene 只支持 "phone"（话费报销）');
+    }
+    return scene;
 }
 function responseData(value) {
     return value && typeof value === 'object' && 'data' in value ? value.data : value;
@@ -85,7 +99,7 @@ function projectRequestListResult(value) {
     return { ...record, data: record.data.map(projectRequestListItem) };
 }
 const UNSAFE_JSON_INTEGER_ID = /("id"\s*:\s*)(-?\d{16,})(?=\s*[,}\]])/g;
-export function quoteEmployeeIdsInJsonText(text) {
+function quoteEmployeeIdsInJsonText(text) {
     return text.replace(UNSAFE_JSON_INTEGER_ID, '$1"$2"');
 }
 function employeeIdString(value) {
@@ -126,68 +140,6 @@ function stringifyEmployeeSuperiorsIds(value) {
 function employeeSuperiorsEnvelope(value) {
     return resultEnvelope(stringifyEmployeeSuperiorsIds(value), 'invoice.reim.employee-superiors');
 }
-const flowCreateFields = ['work_flow_id', 'mainFormId', 'request_name', 'main_fields', 'detail_rows', 'need_user_confirm', 'unable_to_fill'];
-const flowUpdateFields = ['requestId', 'mainFormId', 'main_fields', 'detail_rows', 'deleteDetailRows', 'need_user_confirm', 'unable_to_fill'];
-const flowMetaFields = new Set(['continuation', 'confirm']);
-function flowPayloadFromInput(input, allowedFields) {
-    const source = asObject(input, 'input');
-    if (source.payload !== undefined) {
-        return { value: structuredClone(asObject(source.payload, 'payload')), prefix: 'payload.' };
-    }
-    const allowed = new Set(allowedFields);
-    const value = {};
-    for (const [key, item] of Object.entries(source)) {
-        if (flowMetaFields.has(key))
-            continue;
-        if (!allowed.has(key))
-            throw invoiceValidationError('input_invalid', `${key} 不是支持的报销单字段`);
-        value[key] = item;
-    }
-    return { value: structuredClone(value), prefix: '' };
-}
-function ensureFlowCreatePayload(input) {
-    const { value, prefix } = flowPayloadFromInput(input, flowCreateFields);
-    asNonEmptyString(value.work_flow_id, `${prefix}work_flow_id`);
-    asNonEmptyString(value.mainFormId, `${prefix}mainFormId`);
-    asNonEmptyString(value.request_name, `${prefix}request_name`);
-    if (!Array.isArray(value.main_fields))
-        throw invoiceValidationError('input_invalid', `${prefix}main_fields 必须是数组`);
-    if (!Array.isArray(value.detail_rows) || value.detail_rows.length === 0) {
-        throw invoiceValidationError('input_invalid', `${prefix}detail_rows 必须是非空数组`);
-    }
-    return value;
-}
-function ensureFlowUpdatePayload(input) {
-    const { value, prefix } = flowPayloadFromInput(input, flowUpdateFields);
-    asNonEmptyString(value.requestId, `${prefix}requestId`);
-    asNonEmptyString(value.mainFormId, `${prefix}mainFormId`);
-    const hasMain = Array.isArray(value.main_fields) && value.main_fields.length > 0;
-    const hasDetails = Array.isArray(value.detail_rows) && value.detail_rows.length > 0;
-    const hasDeletes = Array.isArray(value.deleteDetailRows) && value.deleteDetailRows.length > 0;
-    if (!hasMain && !hasDetails && !hasDeletes) {
-        const target = prefix ? `${prefix}必须` : 'input 必须';
-        throw invoiceValidationError('input_invalid', `${target}包含 main_fields、detail_rows 或 deleteDetailRows 至少一类变更`);
-    }
-    return value;
-}
-function flowPreview(payload) {
-    return {
-        requestName: payload.request_name || '',
-        workflowId: payload.work_flow_id || '',
-        mainFormId: payload.mainFormId || '',
-        mainFieldCount: Array.isArray(payload.main_fields) ? payload.main_fields.length : 0,
-        detailRowCount: Array.isArray(payload.detail_rows) ? payload.detail_rows.length : 0,
-    };
-}
-function updatePreview(payload) {
-    return {
-        requestId: String(payload.requestId),
-        mainFormId: payload.mainFormId,
-        mainFieldCount: Array.isArray(payload.main_fields) ? payload.main_fields.length : 0,
-        detailRowCount: Array.isArray(payload.detail_rows) ? payload.detail_rows.length : 0,
-        deleteDetailRowCount: Array.isArray(payload.deleteDetailRows) ? payload.deleteDetailRows.length : 0,
-    };
-}
 export class InvoiceReimFileOcrPreviewOperation {
     name = 'invoice.reim.file-ocr.preview';
     async execute(input, { host }) {
@@ -220,21 +172,41 @@ export class InvoiceReimFileOcrPreviewOperation {
 }
 export class InvoiceReimRequestsListOperation {
     name = 'invoice.reim.requests.list';
+    /**
+     * 发起日期窗口：结束日取传入值或东八区当天，发给接口前再加 1 天。
+     * 没传开始日时：话费（scene=phone）取结束日前 90 天；其他取结束日前 7 天，
+     * 第 1 页查不到再放宽到结束日前 1 个月。
+     */
     async execute(input, { host }) {
-        const body = {
-            pageNo: integerInput(input.pageNo, 'pageNo', { min: 1, max: 10000 }),
-            pageSize: integerInput(input.pageSize, 'pageSize', { min: 1, max: 200, defaultValue: 100 }),
+        const pageNo = integerInput(input.pageNo, 'pageNo', { min: 1, max: 10000 });
+        const pageSize = integerInput(input.pageSize, 'pageSize', { min: 1, max: 200, defaultValue: 100 });
+        const requestname = optionalString(input.requestname, 'requestname');
+        const explicitStart = optionalDate(input.cusCreateDateStart, 'cusCreateDateStart');
+        const scene = requestScene(input.scene);
+        const endDate = optionalDate(input.cusCreateDateEnd, 'cusCreateDateEnd') ?? shanghaiCalendarDate(0);
+        const query = async (start) => {
+            const body = { pageNo, pageSize };
+            if (requestname !== undefined)
+                body.requestname = requestname;
+            body.cusCreateDateStart = start;
+            body.cusCreateDateEnd = addCalendarDays(endDate, 1);
+            const result = await host.invoiceRequest({ path: '/api/inc/book/getRequestListByTabId', method: 'POST', body, operation: this.name });
+            assertBusinessSuccess(result, `${this.name}_failed`, '接口返回业务失败');
+            return result;
         };
-        for (const [key, value] of Object.entries({
-            requestname: optionalString(input.requestname, 'requestname'),
-            cusCreateDateStart: optionalDate(input.cusCreateDateStart, 'cusCreateDateStart'),
-            cusCreateDateEnd: requestCreateDateEnd(input.cusCreateDateEnd),
-        })) {
-            if (value !== undefined)
-                body[key] = value;
+        let start = explicitStart
+            ?? addCalendarDays(endDate, -(scene === 'phone' ? REQUEST_PHONE_LOOKBACK_DAYS : REQUEST_DEFAULT_LOOKBACK_DAYS));
+        let widened = false;
+        let result = await query(start);
+        if (explicitStart === undefined && scene === undefined && pageNo === 1
+            && Array.isArray(result?.data) && result.data.length === 0) {
+            start = addCalendarMonths(endDate, -1);
+            widened = true;
+            result = await query(start);
         }
-        const result = await host.invoiceRequest({ path: '/api/inc/book/getRequestListByTabId', method: 'POST', body, operation: this.name });
-        return resultEnvelope(projectRequestListResult(result), 'invoice.reim.requests.list');
+        const envelope = resultEnvelope(projectRequestListResult(result), this.name);
+        envelope.data.query = { cusCreateDateStart: start, cusCreateDateEnd: endDate, widened };
+        return envelope;
     }
 }
 export class InvoiceReimWorkflowResolveOperation {
@@ -257,87 +229,6 @@ export class InvoiceReimWorkflowResolveOperation {
         return resultEnvelope(result, 'invoice.reim.workflow.resolve');
     }
 }
-export class InvoiceReimFormStructureOperation {
-    name = 'invoice.reim.form.structure';
-    async execute(input, { host }) {
-        const result = await host.invoiceRequest({
-            path: '/api/inc/book/getFormStructure',
-            method: 'GET',
-            query: {
-                workflowId: asNonEmptyString(input.workflowId, 'workflowId'),
-                nodeId: optionalString(input.nodeId, 'nodeId') || '1',
-            },
-            operation: this.name,
-        });
-        return resultEnvelope(result, 'invoice.reim.form.structure');
-    }
-}
-export class InvoiceReimRowInfoOperation {
-    name = 'invoice.reim.row-info';
-    async execute(input, { host }) {
-        const session = await host.getSession();
-        const result = await host.invoiceFormRequest({
-            path: '/api/secondev/fna/expense/dataInfo/getRowInfo',
-            method: 'POST',
-            query: { sf_request_type: 'fetch' },
-            fields: {
-                cdzt: optionalString(input.cdzt, 'cdzt') || session.userId,
-                requestid: input.requestid === undefined ? '' : String(input.requestid),
-                invoiceId: asNonEmptyString(input.invoiceId, 'invoiceId'),
-            },
-            operation: this.name,
-        });
-        return resultEnvelope(result, 'invoice.reim.row-info');
-    }
-}
-export class InvoiceReimRowInfoBatchOperation {
-    name = 'invoice.reim.row-info-batch';
-    async execute(input, { host }) {
-        const invoiceIds = normalizeIdList(input.invoiceIds, 'invoiceIds');
-        const session = await host.getSession();
-        const cdzt = optionalString(input.cdzt, 'cdzt') || session.userId;
-        const requestid = input.requestid === undefined ? '' : String(input.requestid);
-        const results = [];
-        const CONCURRENCY = 4;
-        let cursor = 0;
-        const workers = Array.from({ length: Math.min(CONCURRENCY, invoiceIds.length) }, async () => {
-            while (cursor < invoiceIds.length) {
-                const index = cursor;
-                cursor += 1;
-                const invoiceId = invoiceIds[index];
-                try {
-                    const result = await host.invoiceFormRequest({
-                        path: '/api/secondev/fna/expense/dataInfo/getRowInfo',
-                        method: 'POST',
-                        query: { sf_request_type: 'fetch' },
-                        fields: { cdzt, requestid, invoiceId },
-                        operation: this.name,
-                    });
-                    assertBusinessSuccess(result, 'reim_row_info_failed', `获取发票 ${invoiceId} 行预填失败`);
-                    const data = result && typeof result === 'object' && 'data' in result ? result.data : result;
-                    results[index] = { invoiceId, status: 'success', data: data };
-                }
-                catch (error) {
-                    const message = error instanceof Error ? error.message : '未知错误';
-                    results[index] = { invoiceId, status: 'fail', error: message };
-                }
-            }
-        });
-        await Promise.all(workers);
-        const succeeded = results.filter(r => r.status === 'success');
-        const failed = results.filter(r => r.status === 'fail');
-        return {
-            status: failed.length === results.length ? 'PARTIAL' : 'COMPLETE',
-            data: {
-                results,
-                succeeded: succeeded.length,
-                failed: failed.length,
-                total: results.length,
-                workflow: workflow('invoice.reim.row-info-batch', failed.length ? 'PARTIAL' : 'COMPLETE'),
-            },
-        };
-    }
-}
 export class InvoiceReimEmployeeSuperiorsOperation {
     name = 'invoice.reim.employee-superiors';
     async execute(_input, { host }) {
@@ -398,183 +289,3 @@ export class InvoiceReimFieldSearchOperation {
         };
     }
 }
-export class InvoiceReimFlowCreatePrepareOperation {
-    name = 'invoice.reim.flow.create.prepare';
-    async execute(input, { host, continuation }) {
-        const payload = ensureFlowCreatePayload(input);
-        // 挂单预检：提取 detail_rows 中的 invoiceId，查询是否已被其他报销单关联
-        const invoiceIds = payload.detail_rows
-            .map((row) => row?.invoiceId)
-            .filter((id) => typeof id === 'string' && id.trim() !== '');
-        const assignedWarnings = [];
-        if (invoiceIds.length > 0) {
-            try {
-                const detailResult = await host.invoiceRequest({
-                    path: '/api/inc/get',
-                    method: 'POST',
-                    body: { ids: invoiceIds, mask: 0, userFlag: '1', isDelFlag: '1', req_base: reqBase() },
-                    operation: 'invoice.reim.flow.create.prepare',
-                });
-                const infos = Array.isArray(detailResult?.infos) ? detailResult.infos : [];
-                for (const entry of infos) {
-                    if (entry?.ret?.ret !== 0 || !entry.info)
-                        continue;
-                    const info = entry.info;
-                    const fid = String(info.fid ?? info.id ?? '');
-                    const number = String(info.number ?? fid);
-                    const listReim = info?.oreim?.list_reim;
-                    if (Array.isArray(listReim) && listReim.length > 0) {
-                        const names = listReim
-                            .map((r) => typeof r?.name === 'string' ? r.name : '')
-                            .filter((n) => n.trim())
-                            .join('、');
-                        assignedWarnings.push(`发票 ${number} 已挂在报销单：${names || '(未知)'}，继续创建可能导致重复报销`);
-                    }
-                }
-            }
-            catch {
-                // 预检失败不阻断主流程
-            }
-        }
-        const session = await host.getSession();
-        const continuationToken = await continuation.issue({
-            operation: 'invoice.reim.flow.create.apply',
-            workflow: workflow('invoice.reim.flow.create', 'AWAITING_CONFIRMATION'),
-            baseUrl: session.baseUrl,
-            profile: session.profile,
-            userId: session.userId,
-            fingerprint: objectFingerprint(payload),
-            preview: flowPreview(payload),
-        });
-        return {
-            status: 'AWAITING_CONFIRMATION',
-            data: {
-                preview: flowPreview(payload),
-                continuation: continuationToken,
-                expiresInSeconds: 600,
-                warnings: assignedWarnings.length > 0 ? assignedWarnings : undefined,
-                workflow: workflow('invoice.reim.flow.create', 'AWAITING_CONFIRMATION'),
-            },
-        };
-    }
-}
-export class InvoiceReimFlowCreateApplyOperation {
-    name = 'invoice.reim.flow.create.apply';
-    async execute(input, { host, continuation }) {
-        if (input.confirm !== true)
-            throw invoiceConfirmationError('invoice.reim.flow.create.apply', { hint: '重新调用时传入 confirm=true' });
-        const lease = await continuation.verify(input.continuation, 'invoice.reim.flow.create.apply');
-        const payload = ensureFlowCreatePayload(input);
-        if (typeof lease.fingerprint !== 'string')
-            throw invoiceValidationError('continuation_invalid', '报销单创建 continuation 缺少报销单指纹');
-        if (objectFingerprint(payload) !== lease.fingerprint)
-            throw invoiceValidationError('target_changed', '报销单载荷与确认时不一致，请重新准备');
-        const session = await host.getSession();
-        if (!sessionMatches(lease, session))
-            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备报销单创建');
-        let result;
-        try {
-            result = await host.invoiceRequest({ path: '/api/inc/book/createFlowNew', method: 'POST', body: payload, operation: this.name, timeoutMs: 90_000 });
-        }
-        catch (error) {
-            if (isInvoiceNetworkError(error)) {
-                throw invoicePartialError('报销单创建请求发送后连接中断，结果不确定，禁止自动重试', {
-                    preview: lease.preview,
-                    workflow: workflow('invoice.reim.flow.create', 'EXECUTING'),
-                }, { stage: 'reim-flow-create' });
-            }
-            throw error;
-        }
-        assertBusinessSuccess(result, 'reim_flow_create_failed', '报销单创建失败');
-        const requestId = result?.data?.requestId || result?.requestId;
-        if (!requestId) {
-            throw invoicePartialError('报销单创建接口返回成功但缺少 requestId，结果不确定', {
-                preview: lease.preview,
-                result,
-                workflow: workflow('invoice.reim.flow.create', 'VERIFYING'),
-            }, { stage: 'reim-flow-create-response' });
-        }
-        const sessionContext = await host.getSession();
-        return {
-            status: 'COMPLETE',
-            data: {
-                requestId: String(requestId),
-                requestName: payload.request_name,
-                viewUrl: `${sessionContext.baseUrl}/sp/workflow/flowpage/view/${requestId}`,
-                result,
-                workflow: workflow('invoice.reim.flow.create', 'COMPLETE'),
-            },
-        };
-    }
-}
-export class InvoiceReimFlowUpdatePrepareOperation {
-    name = 'invoice.reim.flow.update.prepare';
-    async execute(input, { host, continuation }) {
-        const payload = ensureFlowUpdatePayload(input);
-        const session = await host.getSession();
-        const continuationToken = await continuation.issue({
-            operation: 'invoice.reim.flow.update.apply',
-            workflow: workflow('invoice.reim.flow.update', 'AWAITING_CONFIRMATION'),
-            baseUrl: session.baseUrl,
-            profile: session.profile,
-            userId: session.userId,
-            fingerprint: objectFingerprint(payload),
-            preview: updatePreview(payload),
-        });
-        return {
-            status: 'AWAITING_CONFIRMATION',
-            data: {
-                preview: updatePreview(payload),
-                continuation: continuationToken,
-                expiresInSeconds: 600,
-                workflow: workflow('invoice.reim.flow.update', 'AWAITING_CONFIRMATION'),
-            },
-        };
-    }
-}
-export class InvoiceReimFlowUpdateApplyOperation {
-    name = 'invoice.reim.flow.update.apply';
-    async execute(input, { host, continuation }) {
-        if (input.confirm !== true)
-            throw invoiceConfirmationError('invoice.reim.flow.update.apply', { hint: '重新调用时传入 confirm=true' });
-        const lease = await continuation.verify(input.continuation, 'invoice.reim.flow.update.apply');
-        const payload = ensureFlowUpdatePayload(input);
-        if (typeof lease.fingerprint !== 'string')
-            throw invoiceValidationError('continuation_invalid', '报销单更新 continuation 缺少报销单指纹');
-        if (objectFingerprint(payload) !== lease.fingerprint)
-            throw invoiceValidationError('target_changed', '报销单更新载荷与确认时不一致，请重新准备');
-        const session = await host.getSession();
-        if (!sessionMatches(lease, session))
-            throw invoiceValidationError('context_mismatch', '确认上下文已变化，请重新准备报销单更新');
-        let result;
-        try {
-            result = await host.invoiceRequest({ path: '/api/inc/book/updateFlow', method: 'POST', body: payload, operation: this.name, timeoutMs: 90_000 });
-        }
-        catch (error) {
-            if (isInvoiceNetworkError(error)) {
-                throw invoicePartialError('报销单更新请求发送后连接中断，结果不确定，禁止自动重试', {
-                    preview: lease.preview,
-                    workflow: workflow('invoice.reim.flow.update', 'EXECUTING'),
-                }, { stage: 'reim-flow-update' });
-            }
-            throw error;
-        }
-        assertBusinessSuccess(result, 'reim_flow_update_failed', '报销单更新失败');
-        const data = result?.data || {};
-        if (data.deleteDetailSuccess === false || data.updateFormSuccess === false) {
-            throw invoicePartialError('报销单更新返回部分失败，可能已有部分变更生效', {
-                preview: lease.preview,
-                result,
-                workflow: workflow('invoice.reim.flow.update', 'VERIFYING'),
-            }, { stage: 'reim-flow-update-response' });
-        }
-        return {
-            status: 'COMPLETE',
-            data: {
-                requestId: String(payload.requestId),
-                result,
-                workflow: workflow('invoice.reim.flow.update', 'COMPLETE'),
-            },
-        };
-    }
-}

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

@@ -3,6 +3,7 @@ import { existsSync } from 'node:fs';
 import { readFile, stat, writeFile } from 'node:fs/promises';
 import { dirname, extname, basename, resolve } from 'node:path';
 import { InvoiceCliError, invoiceValidationError, } from '../errors.js';
+import { FULL_EXT_MASK, invoiceExtInfo, invoiceRecordOf } from '../invoice-record.js';
 const LIST_FIELDS = new Set([
     'page_size',
     'start_pos',
@@ -752,8 +753,22 @@ export async function previewOcr(upload, host) {
     }
     return { results, invoices };
 }
+/** 全额红冲发票（`comm_info.pro.status === 8`）不可报销，查询发票时一律不返回。 */
+export function isRedReversedInvoice(record) {
+    const raw = record?.comm_info?.pro?.status;
+    return (typeof raw === 'number' ? raw : Number(raw ?? 0)) === 8;
+}
 export async function listInvoices(input, host, flag) {
-    const body = { flag, page_size: 10, start_pos: 0, req_type: 1, sreim: '3', bill_type: 0, req_base: reqBase() };
+    const body = {
+        flag,
+        page_size: 10,
+        start_pos: 0,
+        req_type: 1,
+        sreim: '3',
+        bill_type: 0,
+        mext: FULL_EXT_MASK,
+        req_base: reqBase(),
+    };
     for (const [key, value] of Object.entries(input)) {
         if (key === 'flag')
             continue;
@@ -763,10 +778,12 @@ export async function listInvoices(input, host, flag) {
     }
     const session = await host.getSession();
     const result = await host.invoiceRequest({ path: '/api/inc/sync', method: 'POST', body });
-    const items = (result.infos || []).map((item) => {
-        const fid = item?.fid ?? item?.id;
+    const items = (result.infos || []).filter((item) => !isRedReversedInvoice(invoiceRecordOf(item))).map((item) => {
+        const record = invoiceRecordOf(item);
+        const fid = record.fid ?? record.id;
         if (fid)
-            item.detailUrl = invoiceDetailUrl(session.baseUrl, String(fid));
+            record.detailUrl = invoiceDetailUrl(session.baseUrl, String(fid));
+        record.extInfo = invoiceExtInfo(record);
         return item;
     });
     return {

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

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_SECONDS } from '../../../core/continuation-ttl.js';
 import { invoiceConfirmationError, invoicePartialError, invoiceValidationError, isInvoiceNetworkError } from '../errors.js';
 import { applyChanges, assertEditable, changePreview, detailInfo, getDetail, normalizeChanges, normalizeScope, objectFingerprint, operateType, preview, reqBase, sessionMatches, stripForbiddenKeys, verifyChangedFields, workflow, } from './shared.js';
 export class InvoiceUpdatePrepareOperation {
@@ -26,7 +27,7 @@ export class InvoiceUpdatePrepareOperation {
         });
         return {
             status: 'AWAITING_CONFIRMATION',
-            data: { invoice: preview(info, session.baseUrl), changes: diffs, continuation: continuationToken, expiresInSeconds: 600, workflow: workflow('invoice.update', 'AWAITING_CONFIRMATION') },
+            data: { invoice: preview(info, session.baseUrl), changes: diffs, continuation: continuationToken, expiresInSeconds: CONTINUATION_TTL_SECONDS, workflow: workflow('invoice.update', 'AWAITING_CONFIRMATION') },
         };
     }
 }

package/dist/shortcuts/invoice/projection.js

@@ -1,19 +1,5 @@
 import { invoiceValidationError } from './errors.js';
-/**
- * invoice 域的输出投影：把面向程序的完整 envelope 裁成面向阅读的视图。
- *
- * 背景：`invoice.list` 单条发票有 40+ 字段（`custom_field_*`、`rb`、`oa` 等对调用方无用），
- * 10 条即 35KB。调用方要拿到"号码/金额/购销方"就得自己写解析脚本。
- * 本模块提供三个出口，让 CLI 直接给出可读结果：
- *
- * - `--view summary`：语义化平表（仅 list 类 operation，字段口径与 `invoice.reim.candidates.list` 一致）
- * - `--view detail`：单张发票的语义详情（仅 `invoice.get`），summary 字段 + 附件/费用说明/查验标记
- * - `--fields a,b.c`：通用点路径投影，点路径必须存在于原结构（最小惊讶）
- *
- * 另有 `--format markdown`（见 markdown.ts）：把上面的语义视图渲染成 markdown 文本，
- * 属于"渲染档"而非数据档，与 `--json` 互斥。
- */
-import { assertMarkdownSupported, markdownViewFor, normalizeFormat, } from './markdown.js';
+import { EXT_INFO_FIELDS, invoiceExtInfo, invoiceRecordOf, parseInvoiceExt } from './invoice-record.js';
 /** `--view summary` 支持的 operation：data 结构里含发票列表 items 的读取类操作。 */
 export const SUMMARY_OPERATIONS = new Set(['invoice.list', 'invoice.enterprise.list']);
 /** `--view detail` 支持的 operation：data 结构里含 `infos[]`（每条带 info 包装）的详情类操作。 */
@@ -22,6 +8,7 @@ export const OUTPUT_VIEWS = ['full', 'summary', 'detail'];
 /**
  * summary 视图保留的语义字段。命名与 `invoice.reim.candidates.list` 的 items 对齐
  * （`buyer` = 购买方，`payer` = 销售方），避免同一业务概念在不同 operation 里换名。
+ * `EXT_INFO_FIELDS` 来自票面 `ext`（费用说明、城市、备注、起止地等）。
  */
 export const SUMMARY_ITEM_FIELDS = [
     'fid',
@@ -36,6 +23,7 @@ export const SUMMARY_ITEM_FIELDS = [
     'buyerTaxNo',
     'payer',
     'payerTaxNo',
+    ...EXT_INFO_FIELDS,
     'valid',
     'status',
     'reimState',
@@ -58,7 +46,8 @@ function numberOrUndefined(value) {
  * 把一条原始发票对象裁成语义摘要。空值（`''` / `null` / 空数组）直接省键，
  * 票面本身就有的 `'0'`（如税额）保留，避免制造"字段不存在"的歧义。
  */
-export function summarizeInvoiceItem(item) {
+export function summarizeInvoiceItem(raw) {
+    const item = invoiceRecordOf(raw);
     const comm = asRecord(item.comm_info);
     const pro = asRecord(comm.pro);
     const price = asRecord(comm.price);
@@ -79,6 +68,7 @@ export function summarizeInvoiceItem(item) {
         buyerTaxNo: text(buyer.tcode),
         payer: text(payer.company),
         payerTaxNo: text(payer.tcode),
+        ...invoiceExtInfo(item),
         valid: numberOrUndefined(pro.valid),
         status: numberOrUndefined(pro.status),
         reimState: numberOrUndefined(pro.sreim),
@@ -108,25 +98,11 @@ export function summarizeListData(data) {
 }
 /**
  * detail 视图比 summary 多出来的语义字段：
- * 附件清单、票面费用说明、开票人、查验标记（`is_valid`，与票面 `valid` 不是一个口径）。
+ * 附件清单、开票人、查验标记（`is_valid`，与票面 `valid` 不是一个口径）。费用说明已在 summary 里。
  */
-export const DETAIL_EXTRA_FIELDS = ['expenseNote', 'issuer', 'checkState', 'attachments'];
+export const DETAIL_EXTRA_FIELDS = ['issuer', 'checkState', 'attachments'];
 /** `--view detail` 下 items 的字段集：summary 语义字段 + detail 附加字段。 */
 export const DETAIL_ITEM_FIELDS = [...SUMMARY_ITEM_FIELDS, ...DETAIL_EXTRA_FIELDS];
-/** `info.ext` 是**字符串化的 JSON**（票面扩展字段），解析失败按空对象处理，不让脏数据打断输出。 */
-function parseExt(value) {
-    if (value && typeof value === 'object')
-        return asRecord(value);
-    const raw = text(value);
-    if (!raw)
-        return {};
-    try {
-        return asRecord(JSON.parse(raw));
-    }
-    catch {
-        return {};
-    }
-}
 function attachmentOf(entry) {
     const record = asRecord(entry);
     return {
@@ -148,10 +124,7 @@ export function summarizeInvoiceDetailItem(wrapper) {
             detailUrl: info.detailUrl ?? wrapper.detailUrl,
         }),
     };
-    const ext = parseExt(info.ext);
-    const expenseNote = text(ext.expenseDesc);
-    if (expenseNote)
-        detail.expenseNote = expenseNote;
+    const ext = parseInvoiceExt(info.ext);
     const issuer = text(ext.issuer);
     if (issuer)
         detail.issuer = issuer;
@@ -233,29 +206,6 @@ export function normalizeView(value) {
     }
     return view;
 }
-/**
- * 把投影参数解析成"最终生效的视图"。`--format markdown` 是渲染档，
- * 自带字段口径，因此由 operation 决定视图（list 类 → summary，详情类 → detail）；
- * 此时若显式传了别的视图属于口径冲突，直接报错而不是悄悄忽略。
- */
-export function resolveView(operation, projection) {
-    const { view, fields, format } = projection;
-    if (format !== 'markdown')
-        return view ?? 'full';
-    assertMarkdownSupported(operation, format);
-    const expected = markdownViewFor(operation);
-    if (fields?.length) {
-        throw invoiceValidationError('input_conflict', '--format markdown 自带字段口径，不接受 --fields；要自定义字段请用 --fields 输出 JSON');
-    }
-    if (view && view !== expected) {
-        throw invoiceValidationError('input_conflict', `--format markdown 固定使用 ${expected} 视图，与 --view ${view} 冲突`);
-    }
-    return expected;
-}
-/** 供 CLI 侧解析 `--format`。 */
-export function formatFrom(value) {
-    return normalizeFormat(value);
-}
 /**
  * 在发起业务请求**之前**校验投影参数是否可用。
  * 参数写错就该立刻反馈，而不是先打一次网络请求再报 view_unsupported ——
@@ -272,8 +222,6 @@ export function assertProjectionSupported(operation, projection) {
     if (view === 'detail' && !DETAIL_OPERATIONS.has(operation)) {
         throw invoiceValidationError('view_unsupported', `${operation} 不支持 --view detail（仅 ${[...DETAIL_OPERATIONS].join('、')}）`);
     }
-    // 渲染档的可用性与冲突同样要在请求前判掉（resolveView 内含格式白名单校验）。
-    resolveView(operation, projection);
 }
 /**
  * 应用投影。返回新的 data 与要写进 envelope `meta` 的说明，
@@ -282,7 +230,7 @@ export function assertProjectionSupported(operation, projection) {
 export function applyInvoiceProjection(operation, data, projection) {
     assertProjectionSupported(operation, projection);
     const { fields } = projection;
-    const view = resolveView(operation, projection);
+    const view = projection.view ?? 'full';
     const activeMeta = (base) => ({
         projection: { view, ...base },
     });

package/dist/shortcuts/jiuchuanhui/continuation.js

@@ -1,3 +1,4 @@
+import { CONTINUATION_TTL_MS } from '../../core/continuation-ttl.js';
 import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -35,7 +36,7 @@ function signature(payload, key) {
 }
 export function createJiuchuanhuiContinuationSigner(ctx) {
     return {
-        async issue(payload, ttlMs = 10 * 60_000) {
+        async issue(payload, ttlMs = CONTINUATION_TTL_MS) {
             const issuedAt = Date.now();
             const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
             const sig = signature(body, await loadKey(ctx));