weaver-work-cli 0.1.0

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

@@ -0,0 +1,640 @@
+import { createHash } from 'node:crypto';
+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';
+const LIST_FIELDS = new Set([
+    'page_size',
+    'start_pos',
+    'req_type',
+    'mask',
+    'mext',
+    'content',
+    'types',
+    'date_begin',
+    'date_end',
+    'create_tm_begin',
+    'create_tm_end',
+    'payer_company',
+    'buyer_company',
+    'payer_taxno',
+    'buyer_taxno',
+    'code',
+    'number',
+    'total_begin',
+    'total_end',
+    'attribute',
+    'sreim',
+    'valids',
+    'sources',
+    'is_lian',
+    'is_modify',
+    'tag_ids',
+    'tag_condition_type',
+    'sorts',
+    'bill_type',
+]);
+const FILE_EXTENSIONS = new Set(['pdf', 'ofd', 'xml', 'png', 'jpg', 'jpeg']);
+const MIME_TYPES = {
+    pdf: 'application/pdf',
+    ofd: 'application/ofd',
+    xml: 'application/xml',
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+};
+const MAX_UPLOAD_BYTES = 25 * 1024 * 1024;
+const MAIN_INVOICE_TYPES = new Set([1, 2, 3, 4, 5, 10, 22, 28]);
+const CODE_REQUIRED_TYPES = new Set([1, 2, 3, 4, 5, 6, 7, 28, 49, 50]);
+const CHECK_CODE_REQUIRED_TYPES = new Set([2, 3, 4, 5]);
+const AMOUNT_REQUIRED_TYPES = new Set([1, 6, 28, 49]);
+const TOTAL_REQUIRED_TYPES = new Set([7, 32, 33, 47, 48, 52, 53, 54, 56]);
+const MONEY_PATTERN = /^\d+(?:\.\d{1,2})?$/u;
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/u;
+const FORBIDDEN_INPUT_KEYS = new Set([
+    'access_token',
+    'app_key',
+    'app_secret',
+    'cookie',
+    'eteamsid',
+    'token',
+    'sedit',
+    'dubboFlag',
+    'dubboToken',
+    'skipFlag',
+    'secondSectionType',
+]);
+const FORBIDDEN_NORMALIZED_KEYS = new Set([...FORBIDDEN_INPUT_KEYS].map((key) => key.toLowerCase()));
+const UPDATE_FIELDS = new Map([
+    ['code', 'string'],
+    ['number', 'string'],
+    ['comm_info.pro.date', 'date'],
+    ['comm_info.price.amount', 'money'],
+    ['comm_info.price.total', 'money'],
+    ['comm_info.price.dtax', 'money'],
+    ['comm_info.buyer.company', 'string'],
+    ['comm_info.buyer.tcode', 'string'],
+    ['comm_info.payer.company', 'string'],
+    ['comm_info.payer.tcode', 'string'],
+    ['fylx', 'string'],
+    ['currency', 'string'],
+    ['currencyName', 'string'],
+]);
+export function asObject(value, name = '业务输入') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw invoiceValidationError('input_invalid', `${name}必须是 JSON 对象`);
+    }
+    return value;
+}
+export function asPositiveString(value, name) {
+    if (typeof value !== 'string' || !/^\d+$/u.test(value) || value === '0') {
+        throw invoiceValidationError('input_invalid', `${name} 必须是正整数文本`);
+    }
+    return value;
+}
+export function reqBase({ numericTrace = false } = {}) {
+    const trace = Date.now();
+    return { trace: numericTrace ? trace : String(trace), dev: 1 };
+}
+function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+export function objectFingerprint(value) {
+    return createHash('sha256').update(canonicalJson(value)).digest('hex');
+}
+export function assertNoForbiddenKeys(value, location = 'input') {
+    if (!value || typeof value !== 'object')
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => assertNoForbiddenKeys(item, `${location}[${index}]`));
+        return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_INPUT_KEYS.has(key) || FORBIDDEN_NORMALIZED_KEYS.has(key.toLowerCase())) {
+            throw invoiceValidationError('field_forbidden', `禁止业务输入字段：${location}.${key}`);
+        }
+        assertNoForbiddenKeys(child, `${location}.${key}`);
+    }
+}
+export function stripForbiddenKeys(value) {
+    if (Array.isArray(value))
+        return value.map(stripForbiddenKeys);
+    if (!value || typeof value !== 'object')
+        return value;
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_INPUT_KEYS.has(key) || FORBIDDEN_NORMALIZED_KEYS.has(key.toLowerCase()))
+            continue;
+        result[key] = stripForbiddenKeys(child);
+    }
+    return result;
+}
+export function normalizeScope(scope) {
+    if (scope !== 'personal' && scope !== 'enterprise') {
+        throw invoiceValidationError('scope_invalid', 'scope 必须是 personal 或 enterprise');
+    }
+    return scope;
+}
+export function operateType(scope) {
+    return normalizeScope(scope) === 'enterprise' ? 2 : 0;
+}
+export function sessionMatches(lease, session) {
+    return lease.baseUrl === session.baseUrl && lease.profile === session.profile && lease.userId === session.userId;
+}
+function ensureMoney(value, name, { required = false } = {}) {
+    if (value === undefined || value === null || value === '') {
+        if (required)
+            throw invoiceValidationError('invoice_field_required', `${name} 必填`);
+        return;
+    }
+    if (typeof value !== 'string' || !MONEY_PATTERN.test(value)) {
+        throw invoiceValidationError('invoice_field_invalid', `${name} 必须是最多两位小数的非负金额文本`);
+    }
+}
+function ensureDate(value, name, { required = false } = {}) {
+    if (value === undefined || value === null || value === '') {
+        if (required)
+            throw invoiceValidationError('invoice_field_required', `${name} 必填`);
+        return;
+    }
+    if (typeof value !== 'string' || !DATE_PATTERN.test(value) || Number.isNaN(Date.parse(`${value}T00:00:00Z`))) {
+        throw invoiceValidationError('invoice_field_invalid', `${name} 必须是有效的 YYYY-MM-DD`);
+    }
+    const today = new Date().toISOString().slice(0, 10);
+    if (value > today)
+        throw invoiceValidationError('invoice_field_invalid', `${name} 不能晚于今天`);
+}
+export function identityFingerprint(info) {
+    return objectFingerprint({
+        code: info.code || '',
+        number: info.number,
+        type: info.comm_info?.pro?.type,
+        date: info.comm_info?.pro?.date || '',
+        amount: info.comm_info?.price?.amount || '',
+        total: info.comm_info?.price?.total || '',
+        buyerTaxNo: info.comm_info?.buyer?.tcode || '',
+        payerTaxNo: info.comm_info?.payer?.tcode || '',
+    });
+}
+export function detailFingerprint(info) {
+    const p = info.comm_info?.pro || {};
+    const price = info.comm_info?.price || {};
+    return createHash('sha256').update(JSON.stringify({
+        fid: info.fid || info.id,
+        code: info.code,
+        number: info.number,
+        date: p.date,
+        total: price.total,
+        status: p.status,
+        valid: p.valid,
+        sreim: p.sreim,
+        del: info.modify_info?.del,
+    })).digest('hex');
+}
+export function detailInfo(value) {
+    const item = Array.isArray(value?.infos)
+        ? value.infos.find((candidate) => candidate?.ret?.ret === 0 && candidate.info)
+        : undefined;
+    if (!item) {
+        throw new InvoiceCliError('api', 'invoice_not_found', '未找到有权查看的发票', {
+            details: { result: value },
+            exitCode: 1,
+        });
+    }
+    return item.info;
+}
+export async function getDetail(input, host) {
+    const body = {};
+    if (input.fid !== undefined)
+        body.ids = [asPositiveString(input.fid, 'fid')];
+    if (body.ids === undefined && input.number !== undefined) {
+        if (typeof input.number !== 'string' || !input.number.trim()) {
+            throw invoiceValidationError('input_invalid', 'number 不能为空');
+        }
+        body.number = input.number.trim();
+    }
+    if (!body.ids && !body.number)
+        throw invoiceValidationError('input_invalid', '必须提供 fid 或 number');
+    return host.invoiceRequest({
+        path: '/api/inc/get',
+        method: 'POST',
+        body: { ...body, userFlag: '1', isDelFlag: '1', req_base: reqBase() },
+    });
+}
+export function preview(info) {
+    const p = info.comm_info?.pro || {};
+    const price = info.comm_info?.price || {};
+    const rawFid = info.fid ?? info.id;
+    return {
+        fid: rawFid === undefined || rawFid === null ? '' : String(rawFid),
+        code: info.code || '',
+        number: info.number || '',
+        date: p.date || '',
+        total: price.total || '',
+        buyer: info.comm_info?.buyer?.company || '',
+        payer: info.comm_info?.payer?.company || '',
+        valid: p.valid,
+        reimbursement: p.sreim,
+        status: p.status,
+    };
+}
+export function validationPreview(info, scope, targetFid) {
+    const p = info?.comm_info?.pro || {};
+    const item = preview(info);
+    return {
+        ...item,
+        fid: targetFid,
+        targetFid,
+        resultFid: item.fid,
+        scope,
+        validation: p.valid,
+        invoiceStatus: p.status,
+        saved: false,
+    };
+}
+export function workflow(name, state) {
+    return { workflow: name, version: 1, state };
+}
+function uploadSource(input) {
+    const { file, url } = input;
+    if (file !== undefined && url !== undefined)
+        throw invoiceValidationError('input_ambiguous', 'file 与 url 只能提供一个');
+    if (file === undefined && url === undefined)
+        throw invoiceValidationError('file_required', '必须提供本地 file 路径或可访问的 url');
+    if (file !== undefined) {
+        if (typeof file !== 'string' || !file.trim())
+            throw invoiceValidationError('file_invalid', 'file 必须是本地文件路径');
+        return { kind: 'file', path: resolve(file) };
+    }
+    if (typeof url !== 'string' || !url.trim())
+        throw invoiceValidationError('url_invalid', 'url 必须是非空 URL');
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw invoiceValidationError('url_invalid', 'url 不是合法 URL');
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol) || parsed.username || parsed.password) {
+        throw invoiceValidationError('url_invalid', 'url 只允许 http/https 且不能包含账号密码');
+    }
+    return { kind: 'url', url: parsed.href };
+}
+async function normalizeFileSource(source) {
+    if (source.kind === 'url')
+        return { fields: { url: source.url } };
+    let metadata;
+    try {
+        metadata = await stat(source.path);
+    }
+    catch {
+        throw invoiceValidationError('file_not_found', `文件不存在或不可读取：${source.path}`);
+    }
+    if (!metadata.isFile())
+        throw invoiceValidationError('file_invalid', 'file 必须指向普通文件');
+    if (metadata.size <= 0)
+        throw invoiceValidationError('file_empty', '不能上传空文件');
+    if (metadata.size > MAX_UPLOAD_BYTES)
+        throw invoiceValidationError('file_too_large', `文件不能超过 ${MAX_UPLOAD_BYTES} 字节`);
+    const extension = extname(source.path).slice(1).toLowerCase();
+    if (!FILE_EXTENSIONS.has(extension)) {
+        throw invoiceValidationError('file_type_unsupported', `不支持的发票文件类型：${extension || '(无扩展名)'}`);
+    }
+    return {
+        fields: {},
+        file: { path: source.path, name: basename(source.path), mimeType: MIME_TYPES[extension] },
+    };
+}
+export async function importFile(input) {
+    if (input.url !== undefined)
+        throw invoiceValidationError('import_url_unsupported', '确定性导入当前只接受本地 file，不接受远程 URL');
+    const source = uploadSource({ file: input.file });
+    const prepared = await normalizeFileSource(source);
+    if (!prepared.file)
+        throw invoiceValidationError('file_required', '必须提供本地 file 路径');
+    const content = await readFile(prepared.file.path);
+    return {
+        file: prepared.file,
+        size: content.length,
+        sha256: createHash('sha256').update(content).digest('hex'),
+    };
+}
+export function importOptions(input) {
+    if (typeof input.validate !== 'boolean' || typeof input.syncToOa !== 'boolean') {
+        throw invoiceValidationError('import_option_required', 'validate 和 syncToOa 必须显式提供布尔值');
+    }
+    if (input.validate && !input.syncToOa) {
+        throw invoiceValidationError('import_option_conflict', 'validate=true 分支由服务端固定同步 OA，不能设置 syncToOa=false');
+    }
+    return { validate: input.validate, syncToOa: input.validate ? true : input.syncToOa };
+}
+function normalizeUploadResponse(value, source) {
+    if (value?.fail === true) {
+        throw new InvoiceCliError('api', 'upload_failed', value?.res_base?.message || '发票文件上传或切割失败', {
+            details: { source: source.kind },
+            exitCode: 1,
+        });
+    }
+    const rawIds = Array.isArray(value?.ids) ? value.ids : (value?.id === undefined ? [] : [value.id]);
+    const ids = rawIds
+        .filter((id) => id !== undefined && id !== null && String(id).trim())
+        .map((id) => String(id));
+    if (!ids.length) {
+        throw new InvoiceCliError('api', 'upload_empty', '上传成功但服务端没有返回文件 ID', {
+            details: { source: source.kind },
+            exitCode: 1,
+        });
+    }
+    const id = value?.id === undefined || value.id === null ? ids[0] : String(value.id);
+    const fileType = typeof value?.fileType === 'string' ? value.fileType.toLowerCase() : '';
+    if (!FILE_EXTENSIONS.has(fileType)) {
+        throw new InvoiceCliError('api', 'upload_type_missing', '上传成功但服务端没有返回受支持的文件类型', { exitCode: 1 });
+    }
+    return {
+        id,
+        ids,
+        fileType,
+        fileName: typeof value.fileName === 'string' ? value.fileName : undefined,
+        totalPages: Number.isInteger(value.totalPages) ? value.totalPages : ids.length,
+        hasFanWei: value.hasFanWei === true,
+        ocrMap: typeof value.ocrMap === 'string' ? value.ocrMap : undefined,
+        fail: false,
+    };
+}
+export async function uploadInvoiceFile(input, host) {
+    const source = uploadSource(input);
+    const prepared = await normalizeFileSource(source);
+    const result = await host.invoiceMultipartRequest({
+        path: '/api/inc/file/uploadFileSpilit',
+        fields: { ...prepared.fields, ocr: '1' },
+        file: prepared.file,
+    });
+    return normalizeUploadResponse(result, source);
+}
+export function uploadFromInput(input) {
+    if (input.upload === undefined)
+        return null;
+    if (!input.upload || typeof input.upload !== 'object' || Array.isArray(input.upload)) {
+        throw invoiceValidationError('upload_invalid', 'upload 必须是 upload 操作返回的 JSON 对象');
+    }
+    const upload = input.upload;
+    const rawIds = Array.isArray(upload.ids) ? upload.ids : (upload.id === undefined ? [] : [upload.id]);
+    const ids = rawIds
+        .filter((id) => id !== undefined && id !== null && String(id).trim())
+        .map((id) => String(id));
+    const fileType = typeof upload.fileType === 'string' ? upload.fileType.toLowerCase() : '';
+    if (!ids.length || !FILE_EXTENSIONS.has(fileType)) {
+        throw invoiceValidationError('upload_invalid', 'upload 缺少有效的 id/ids 或 fileType');
+    }
+    return {
+        id: upload.id === undefined ? ids[0] : String(upload.id),
+        ids,
+        fileType,
+        fileName: typeof upload.fileName === 'string' ? upload.fileName : undefined,
+        totalPages: Number.isInteger(upload.totalPages) ? upload.totalPages : ids.length,
+        hasFanWei: upload.hasFanWei === true,
+        ocrMap: typeof upload.ocrMap === 'string' ? upload.ocrMap : undefined,
+        fail: false,
+    };
+}
+function ocrInfo(result) {
+    const infos = Array.isArray(result?.infos) ? result.infos : [];
+    const failed = infos.filter((item) => item?.ret?.ret !== 0);
+    if (failed.length) {
+        throw new InvoiceCliError('api', 'ocr_item_failed', '部分文件页 OCR 失败', {
+            details: { failed: failed.map((item) => item?.ret?.message || 'OCR 失败') },
+            exitCode: 1,
+        });
+    }
+    if (!infos.length)
+        throw new InvoiceCliError('api', 'ocr_empty', 'OCR 未返回任何发票结果', { exitCode: 1 });
+    return infos;
+}
+export async function previewOcr(upload, host) {
+    const results = [];
+    const invoices = [];
+    let latestMainFid = '';
+    const knownMainFids = [];
+    for (const imageIndex of upload.ids) {
+        const body = {
+            image_index: imageIndex,
+            fileTypeStr: upload.fileType,
+            flag: 13,
+            is_save: 1,
+            is_sync: 1,
+            operate_type: 0,
+            req_base: reqBase(),
+        };
+        if (upload.ocrMap !== undefined)
+            body.ocrMap = upload.ocrMap;
+        if (upload.ids.length > 1) {
+            body.origin = {
+                id: upload.id,
+                name: upload.fileName || '',
+                type: upload.fileType,
+                fid: latestMainFid,
+                fids: JSON.stringify(knownMainFids),
+            };
+        }
+        const result = await host.invoiceRequest({ path: '/api/inc/ocr', method: 'POST', body });
+        const infos = ocrInfo(result);
+        results.push(result);
+        invoices.push(...infos);
+        for (const item of infos) {
+            const info = item?.info;
+            const type = Number(info?.comm_info?.pro?.type);
+            const fid = info?.fid ?? info?.id;
+            if (MAIN_INVOICE_TYPES.has(type) && fid !== undefined && String(fid).trim()) {
+                latestMainFid = String(fid);
+                knownMainFids.push({ fid: latestMainFid, type });
+            }
+        }
+    }
+    return { results, invoices };
+}
+export async function listInvoices(input, host, flag) {
+    const body = { flag, page_size: 10, start_pos: 0, req_type: 1, sreim: 3, req_base: reqBase() };
+    for (const [key, value] of Object.entries(input)) {
+        if (key === 'flag')
+            continue;
+        if (!LIST_FIELDS.has(key))
+            throw invoiceValidationError('input_field_unsupported', `列表查询不支持字段：${key}`);
+        body[key] = value;
+    }
+    const result = await host.invoiceRequest({ path: '/api/inc/sync', method: 'POST', body });
+    return {
+        status: 'COMPLETE',
+        data: {
+            items: result.infos || [],
+            total: result.total ?? 0,
+            totalAmount: result.totalTn ?? '0',
+            totalAmountExcludingTax: result.totalAm ?? '0',
+            hasMore: result.end_flag === 1,
+            scope: flag === 6 ? 'enterprise' : 'personal',
+        },
+    };
+}
+export function normalizeAddInfo(rawInfo) {
+    const info = structuredClone(asObject(rawInfo, 'info'));
+    assertNoForbiddenKeys(info, 'info');
+    if (typeof info.number !== 'string' || !info.number.trim())
+        throw invoiceValidationError('invoice_field_required', 'info.number 必填');
+    info.number = info.number.trim();
+    const pro = info.comm_info?.pro;
+    if (!pro || typeof pro !== 'object' || !Number.isSafeInteger(pro.type) || pro.type <= 0) {
+        throw invoiceValidationError('invoice_field_required', 'info.comm_info.pro.type 必须是正整数');
+    }
+    if (CODE_REQUIRED_TYPES.has(pro.type) && (typeof info.code !== 'string' || !info.code.trim())) {
+        throw invoiceValidationError('invoice_field_required', `票种 ${pro.type} 必须提供 info.code`);
+    }
+    if (CHECK_CODE_REQUIRED_TYPES.has(pro.type) && (typeof pro.chcode !== 'string' || !pro.chcode.trim())) {
+        throw invoiceValidationError('invoice_field_required', `票种 ${pro.type} 必须提供 info.comm_info.pro.chcode`);
+    }
+    if (pro.type === 50 && (typeof pro.electronicNumber !== 'string' || !pro.electronicNumber.trim())) {
+        throw invoiceValidationError('invoice_field_required', '票种 50 必须提供 electronicNumber');
+    }
+    ensureDate(pro.date, 'info.comm_info.pro.date');
+    const price = info.comm_info?.price || {};
+    ensureMoney(price.amount, 'info.comm_info.price.amount', { required: AMOUNT_REQUIRED_TYPES.has(pro.type) });
+    ensureMoney(price.total, 'info.comm_info.price.total', { required: TOTAL_REQUIRED_TYPES.has(pro.type) });
+    ensureMoney(price.dtax, 'info.comm_info.price.dtax');
+    if (info.ext !== undefined) {
+        if (typeof info.ext !== 'string')
+            throw invoiceValidationError('invoice_field_invalid', 'info.ext 必须是 JSON 字符串');
+        try {
+            JSON.parse(info.ext);
+        }
+        catch {
+            throw invoiceValidationError('invoice_field_invalid', 'info.ext 不是合法 JSON 字符串');
+        }
+    }
+    if (!info.modify_info || typeof info.modify_info !== 'object' || Array.isArray(info.modify_info))
+        info.modify_info = {};
+    if (info.modify_info.source === undefined)
+        info.modify_info.source = 7;
+    if (info.currency === undefined)
+        info.currency = 'CNY';
+    if (info.currencyName === undefined)
+        info.currencyName = '人民币';
+    return info;
+}
+export async function assertNotDuplicate(info, host) {
+    try {
+        const result = await getDetail({ number: info.number }, host);
+        const duplicate = result?.infos?.find((item) => item?.ret?.ret === 0 && item.info);
+        if (duplicate) {
+            throw invoiceValidationError('invoice_duplicate', '当前上下文已存在相同号码的发票', { existing: preview(duplicate.info) });
+        }
+    }
+    catch (error) {
+        if (error instanceof InvoiceCliError
+            && (error.code === '300241' || error.subtype === 'invoice_not_found')) {
+            return;
+        }
+        throw error;
+    }
+}
+export function addPreview(info, scope) {
+    return { ...preview(info), type: info.comm_info?.pro?.type, scope };
+}
+function getPath(value, fieldPath) {
+    return fieldPath.split('.').reduce((current, key) => current?.[key], value);
+}
+function setPath(value, fieldPath, next) {
+    const parts = fieldPath.split('.');
+    let current = value;
+    for (const key of parts.slice(0, -1)) {
+        if (!current[key] || typeof current[key] !== 'object' || Array.isArray(current[key]))
+            current[key] = {};
+        current = current[key];
+    }
+    current[parts[parts.length - 1]] = next;
+}
+export function normalizeChanges(rawChanges) {
+    const changes = asObject(rawChanges, 'changes');
+    const entries = Object.entries(changes);
+    if (!entries.length)
+        throw invoiceValidationError('changes_empty', 'changes 至少包含一个允许修改的字段');
+    if (entries.length > 20)
+        throw invoiceValidationError('changes_too_many', '单次最多修改 20 个字段');
+    for (const [field, value] of entries) {
+        const kind = UPDATE_FIELDS.get(field);
+        if (!kind)
+            throw invoiceValidationError('update_field_unsupported', `不支持修改字段：${field}`);
+        if (kind === 'money')
+            ensureMoney(value, field, { required: true });
+        else if (kind === 'date')
+            ensureDate(value, field, { required: true });
+        else if (typeof value !== 'string' || value.length > 500 || /[\r\n]/u.test(value)) {
+            throw invoiceValidationError('invoice_field_invalid', `${field} 必须是 500 字符以内的单行文本`);
+        }
+        if (field === 'number' && typeof value === 'string' && !value.trim()) {
+            throw invoiceValidationError('invoice_field_invalid', 'number 不能为空');
+        }
+    }
+    return structuredClone(changes);
+}
+export function applyChanges(info, changes) {
+    const updated = structuredClone(info);
+    for (const [field, value] of Object.entries(changes))
+        setPath(updated, field, value);
+    return updated;
+}
+export function changePreview(info, changes) {
+    return Object.entries(changes).map(([field, to]) => ({ field, from: getPath(info, field), to }));
+}
+export function assertEditable(info) {
+    const p = info.comm_info?.pro || {};
+    if ((p.sreim ?? 0) !== 0 || (p.status ?? 0) !== 0 || (info.modify_info?.del ?? 0) !== 0) {
+        throw invoiceValidationError('invoice_not_editable', '发票当前状态不允许编辑', { status: preview(info) });
+    }
+}
+export function verifyChangedFields(info, changes) {
+    return Object.entries(changes).every(([field, value]) => Object.is(getPath(info, field), value));
+}
+export function associatedFileIds(info) {
+    const values = new Set();
+    for (const item of info.flist || []) {
+        if (item?.id !== undefined && item.id !== null)
+            values.add(String(item.id));
+    }
+    for (const field of ['furl', 'pdf', 'xml']) {
+        const value = info.modify_info?.[field];
+        if (value !== undefined && value !== null && String(value).trim())
+            values.add(String(value));
+    }
+    return values;
+}
+export async function resolveDownloadOutput(output) {
+    if (typeof output !== 'string' || !output.trim())
+        throw invoiceValidationError('output_required', 'output 必须是明确的本地文件路径');
+    const resolved = resolve(output);
+    let parent;
+    try {
+        parent = await stat(dirname(resolved));
+    }
+    catch {
+        throw invoiceValidationError('output_parent_missing', `输出目录不存在：${dirname(resolved)}`);
+    }
+    if (!parent.isDirectory())
+        throw invoiceValidationError('output_parent_invalid', '输出文件的父路径不是目录');
+    if (existsSync(resolved))
+        throw invoiceValidationError('output_exists', `输出文件已存在，拒绝覆盖：${resolved}`);
+    return resolved;
+}
+export async function writeDownload(resolved, content) {
+    try {
+        await writeFile(resolved, content, { flag: 'wx', mode: 0o600 });
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === 'EEXIST') {
+            throw invoiceValidationError('output_exists', `输出文件已存在，拒绝覆盖：${resolved}`);
+        }
+        throw error;
+    }
+}

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

@@ -0,0 +1 @@
+export {};