weaver-work-cli 0.1.0

package/dist/shortcuts/invoice/host.js

@@ -0,0 +1,337 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { requireE10Session } from '../../internal/e10/context.js';
+import { getActiveProfile } from '../../internal/e10/auth/session.js';
+import { InvoiceCliError, invoiceAuthError, invoiceNetworkError, invoiceValidationError, } from './errors.js';
+const MAX_DOWNLOAD_BYTES = 50 * 1024 * 1024;
+const TOKEN_SERVICE = 'cn.weaver.weaver-work-cli.invoice-token';
+function assertPath(requestPath) {
+    if (typeof requestPath !== 'string' || !requestPath.startsWith('/') || requestPath.startsWith('//')) {
+        throw invoiceValidationError('path_invalid', '请求路径必须是相对绝对路径');
+    }
+    if (/^https?:/i.test(requestPath) || /[\r\n]/.test(requestPath) || requestPath.includes('/../')) {
+        throw invoiceValidationError('path_invalid', '请求路径不允许跨域或路径逃逸');
+    }
+    if (!requestPath.startsWith('/api/')) {
+        throw invoiceValidationError('path_not_allowed', '业票通只能调用 /api/ 路径');
+    }
+}
+function withQuery(baseUrl, requestPath, query = {}) {
+    const url = new URL(`${baseUrl}${requestPath}`);
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(key, String(item));
+        }
+        else {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url;
+}
+async function fetchWithTimeout(url, options, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { ...options, signal: controller.signal });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw invoiceNetworkError('timeout', `请求超时（${timeoutMs}ms）`, { retryable: false });
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw invoiceNetworkError('transport', `请求失败：${message}`, { retryable: true });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function responseRoot(value) {
+    return value?.res_base || value?.data?.res_base || value;
+}
+function responseMessage(value) {
+    const root = responseRoot(value);
+    return typeof root?.message === 'string'
+        ? root.message
+        : typeof root?.msg === 'string'
+            ? root.msg
+            : '泛微接口返回业务失败';
+}
+function responseCode(value) {
+    const root = responseRoot(value);
+    return root?.ret ?? root?.code;
+}
+function tokenAccount(session) {
+    return createHash('sha256')
+        .update(`${session.profile}\n${session.baseUrl}\n${session.userId}`)
+        .digest('hex');
+}
+function createInvoiceTokenStore(session) {
+    const account = tokenAccount(session);
+    let entryPromise = null;
+    async function entry() {
+        if (!entryPromise) {
+            entryPromise = import('@napi-rs/keyring').then(({ Entry }) => new Entry(TOKEN_SERVICE, account));
+        }
+        return entryPromise;
+    }
+    return {
+        async load() {
+            try {
+                const value = await (await entry()).getPassword();
+                return typeof value === 'string' && value.trim() ? value : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async save(token) {
+            if (!token.trim())
+                return false;
+            try {
+                await (await entry()).setPassword(token);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async clear() {
+            try {
+                await (await entry()).deletePassword();
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+function inferProfile(ctx) {
+    const options = ctx.getGlobalOptions();
+    return options.profile || getActiveProfile();
+}
+function requestHeaders(session, invoiceToken) {
+    const headers = {
+        Accept: 'application/json, text/plain, */*',
+        Cookie: session.cookieHeader(),
+        eteamsid: session.eteamsId,
+        'User-Agent': session.uaHeader(),
+        Origin: session.getBaseUrl(),
+    };
+    if (invoiceToken)
+        headers.token = invoiceToken;
+    return headers;
+}
+export function createInvoiceHost(ctx) {
+    let e10Session = null;
+    let sessionContext = null;
+    let invoiceToken = null;
+    let tokenStore = null;
+    async function ensureSession() {
+        if (!e10Session) {
+            e10Session = await requireE10Session(ctx);
+            sessionContext = {
+                baseUrl: e10Session.getBaseUrl(),
+                profile: inferProfile(ctx),
+                userId: e10Session.userId,
+            };
+        }
+        return e10Session;
+    }
+    async function getSession() {
+        await ensureSession();
+        return sessionContext;
+    }
+    async function ensureInvoiceToken(timeoutMs = 30_000) {
+        await ensureSession();
+        const context = await getSession();
+        tokenStore ||= createInvoiceTokenStore(context);
+        if (invoiceToken)
+            return invoiceToken;
+        invoiceToken = await tokenStore.load();
+        if (invoiceToken)
+            return invoiceToken;
+        const tokenResponse = await invoiceRequest({
+            method: 'GET',
+            path: '/api/inc/proxy/getToken',
+            query: { appType: 1 },
+            needsInvoiceToken: false,
+            timeoutMs,
+        });
+        const token = tokenResponse?.data?.token;
+        if (typeof token !== 'string' || !token.trim()) {
+            throw invoiceAuthError('invoice_token_missing', '未取得业票通业务 Token');
+        }
+        const saved = await tokenStore.save(token);
+        if (!saved) {
+            throw invoiceAuthError('invoice_token_cache_failed', '发票 Token 安全缓存写入失败，已停止业务请求');
+        }
+        invoiceToken = token;
+        return token;
+    }
+    async function ensureContext(needsInvoiceToken, timeoutMs, path) {
+        await ensureSession();
+        const tokenEndpoint = path === '/api/inc/proxy/getToken' || path === '/api/app/inc/proxy/getToken';
+        if (tokenEndpoint)
+            return undefined;
+        if (!needsInvoiceToken) {
+            // 兼容调用方参数，但业务路径仍强制补齐发票 Token。
+        }
+        return ensureInvoiceToken(timeoutMs);
+    }
+    async function invoiceRequest(request) {
+        const { method = 'POST', path, query, body, needsInvoiceToken = true, timeoutMs = 30_000, } = request;
+        assertPath(path);
+        const token = await ensureContext(needsInvoiceToken, timeoutMs, path);
+        const session = await ensureSession();
+        const url = withQuery(session.getBaseUrl(), path, query);
+        const headers = requestHeaders(session, token);
+        const init = { method, headers, redirect: 'manual' };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json;charset=UTF-8';
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetchWithTimeout(url, init, timeoutMs);
+        const text = await response.text();
+        if (response.status === 401 || response.status === 302) {
+            throw invoiceAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> 完成登录', { httpStatus: response.status });
+        }
+        let value = {};
+        try {
+            value = text ? JSON.parse(text) : {};
+        }
+        catch {
+            if (response.status < 200 || response.status >= 300) {
+                throw new InvoiceCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                    code: response.status,
+                    details: { status: response.status },
+                    exitCode: 1,
+                });
+            }
+            throw invoiceNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, { retryable: false });
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new InvoiceCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                code: response.status,
+                details: { status: response.status, message: responseMessage(value) },
+                exitCode: 1,
+            });
+        }
+        const code = responseCode(value);
+        if (code !== undefined && code !== 0 && code !== 200) {
+            throw new InvoiceCliError('api', 'business_error', responseMessage(value), {
+                code: String(code),
+                details: { ret: code },
+                exitCode: 1,
+            });
+        }
+        return value;
+    }
+    return {
+        invoiceRequest,
+        async invoiceMultipartRequest(request) {
+            const { method = 'POST', path, query, fields = {}, file, needsInvoiceToken = true, timeoutMs = 30_000, } = request;
+            if (!file && !fields.url) {
+                throw invoiceValidationError('input_invalid', 'multipart 请求需要文件或 URL');
+            }
+            assertPath(path);
+            const token = await ensureContext(needsInvoiceToken, timeoutMs, path);
+            const session = await ensureSession();
+            const form = new FormData();
+            for (const [key, value] of Object.entries(fields)) {
+                if (value === undefined || value === null)
+                    continue;
+                form.append(key, typeof value === 'string' ? value : JSON.stringify(value));
+            }
+            if (file) {
+                const content = await readFile(file.path);
+                form.append('file', new Blob([content], { type: file.mimeType || 'application/octet-stream' }), file.name);
+            }
+            const response = await fetchWithTimeout(withQuery(session.getBaseUrl(), path, query), {
+                method,
+                headers: requestHeaders(session, token),
+                body: form,
+                redirect: 'manual',
+            }, timeoutMs);
+            const text = await response.text();
+            if (response.status === 401 || response.status === 302) {
+                throw invoiceAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> 完成登录', { httpStatus: response.status });
+            }
+            let value = {};
+            try {
+                value = text ? JSON.parse(text) : {};
+            }
+            catch {
+                throw invoiceNetworkError('protocol', `接口返回不是合法 JSON（HTTP ${response.status}）`, { retryable: false });
+            }
+            if (response.status < 200 || response.status >= 300) {
+                throw new InvoiceCliError('api', 'http_error', `泛微接口 HTTP ${response.status}`, {
+                    code: response.status,
+                    details: { status: response.status, message: responseMessage(value) },
+                    exitCode: 1,
+                });
+            }
+            const code = responseCode(value);
+            if (code !== undefined && code !== 0 && code !== 200) {
+                throw new InvoiceCliError('api', 'business_error', responseMessage(value), {
+                    code: String(code),
+                    details: { ret: code },
+                    exitCode: 1,
+                });
+            }
+            return value;
+        },
+        async invoiceDownload({ id, fid, needLog = false, timeoutMs = 30_000 }) {
+            const token = await ensureContext(true, timeoutMs, '/api/inc/file/download');
+            const session = await ensureSession();
+            const url = withQuery(session.getBaseUrl(), '/api/inc/file/download', { id, fid, needLog });
+            const response = await fetchWithTimeout(url, {
+                method: 'GET',
+                headers: {
+                    ...requestHeaders(session, token),
+                    Accept: 'application/octet-stream, application/pdf, */*',
+                },
+                redirect: 'manual',
+            }, timeoutMs);
+            if (response.status === 401 || response.status === 302) {
+                throw invoiceAuthError('session_expired', 'E10 登录态已失效，请先向用户确认 E10 登录域名，再运行 weaver-work-cli auth login --base-url <域名> 完成登录', { httpStatus: response.status });
+            }
+            const contentType = response.headers.get('content-type') || 'application/octet-stream';
+            const declaredLength = Number(response.headers.get('content-length'));
+            if (Number.isFinite(declaredLength) && declaredLength > MAX_DOWNLOAD_BYTES) {
+                throw invoiceNetworkError('response_too_large', `下载文件超过 ${MAX_DOWNLOAD_BYTES} 字节限制`, { retryable: false });
+            }
+            const content = Buffer.from(await response.arrayBuffer());
+            const looksLikeJson = /^[\s\r\n]*[\[{]/u.test(content.subarray(0, 64).toString('utf8'));
+            if (response.status < 200 || response.status >= 300 || contentType.includes('json') || looksLikeJson) {
+                let value = {};
+                try {
+                    value = JSON.parse(content.toString('utf8'));
+                }
+                catch {
+                    value = {};
+                }
+                throw new InvoiceCliError('api', 'download_failed', responseMessage(value) || `下载失败（HTTP ${response.status}）`, {
+                    code: response.status,
+                    details: { status: response.status, ret: responseCode(value) },
+                    exitCode: 1,
+                });
+            }
+            if (!content.length) {
+                throw invoiceNetworkError('protocol', '下载接口返回空文件', { retryable: false });
+            }
+            if (content.length > MAX_DOWNLOAD_BYTES) {
+                throw invoiceNetworkError('response_too_large', `下载文件超过 ${MAX_DOWNLOAD_BYTES} 字节限制`, { retryable: false });
+            }
+            return { content, contentType };
+        },
+        getSession,
+        invalidateToken() {
+            invoiceToken = null;
+            void tokenStore?.clear();
+        },
+    };
+}

package/dist/shortcuts/invoice/index.js

@@ -0,0 +1,301 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createInvoiceContinuationSigner } from './continuation.js';
+import { createInvoiceHost } from './host.js';
+import { invoiceManifest } from './manifest.js';
+import { executeInvoiceOperation } from './operations.js';
+import { invoiceValidationError } from './errors.js';
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input) {
+        let raw;
+        try {
+            raw = opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8');
+        }
+        catch {
+            throw invoiceValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                throw new Error('input must be an object');
+            }
+            input = parsed;
+        }
+        catch {
+            throw invoiceValidationError('input_invalid', '--input 不是合法 JSON 对象');
+        }
+    }
+    return {
+        ...input,
+        ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== '')),
+    };
+}
+function intOption(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data,
+        meta: { status: result.status },
+        warnings: [],
+    };
+}
+function failureEnvelope(error) {
+    const structured = error;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        ...(structured?.partialData === undefined ? {} : { data: structured.partialData }),
+        error: toErrorEnvelope(error),
+    };
+}
+async function executeAndPrint(ctx, operation, input) {
+    try {
+        const result = await executeInvoiceOperation(operation, input, {
+            host: createInvoiceHost(ctx),
+            continuation: createInvoiceContinuationSigner(ctx),
+        });
+        ctx.output.write(successEnvelope(operation, result), { json: true });
+    }
+    catch (error) {
+        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+export const invoiceShortcut = {
+    name: 'invoice',
+    description: 'E10 业票通发票管理 CLI',
+    category: 'shortcut',
+    register({ program, action }) {
+        const invoice = program.command('invoice').description('E10 业票通发票管理');
+        invoice.command('schema')
+            .description('Print invoice operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(invoiceManifest, { json: true });
+        }));
+        invoice.command('run')
+            .description('Run an invoice operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. invoice.list')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        invoice.command('list')
+            .description('List personal invoice folder entries')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--content <keyword>', 'keyword search')
+            .option('--page-size <size>', 'page size')
+            .option('--start-pos <offset>', 'start position')
+            .option('--sreim <status>', 'reimbursement status: 0 all, 1 in reimbursement, 2 reimbursed, 3 unreimbursed, 4 non-reimbursable')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.list', await inputFrom(options, {
+                content: opts.content,
+                page_size: intOption(opts.pageSize),
+                start_pos: intOption(opts.startPos),
+                sreim: intOption(opts.sreim),
+            }));
+        }));
+        const enterprise = invoice.command('enterprise').description('Enterprise invoice folder commands');
+        enterprise.command('list')
+            .description('List enterprise invoice folder entries')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--content <keyword>', 'keyword search')
+            .option('--page-size <size>', 'page size')
+            .option('--start-pos <offset>', 'start position')
+            .option('--sreim <status>', 'reimbursement status: 0 all, 1 in reimbursement, 2 reimbursed, 3 unreimbursed, 4 non-reimbursable')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.enterprise.list', await inputFrom(options, {
+                content: opts.content,
+                page_size: intOption(opts.pageSize),
+                start_pos: intOption(opts.startPos),
+                sreim: intOption(opts.sreim),
+            }));
+        }));
+        invoice.command('get')
+            .description('Get invoice detail by fid or number')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--fid <fid>', 'invoice fid')
+            .option('--number <number>', 'invoice number')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.get', await inputFrom(options, {
+                fid: opts.fid,
+                number: opts.number,
+            }));
+        }));
+        invoice.command('upload')
+            .description('Upload an invoice file for OCR')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--file <path>', 'local invoice file')
+            .option('--url <url>', 'server-accessible file URL')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.upload', await inputFrom(options, {
+                file: opts.file,
+                url: opts.url,
+            }));
+        }));
+        const ocr = invoice.command('ocr').description('Invoice OCR commands');
+        ocr.command('preview')
+            .description('Preview OCR result without saving an invoice')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--file <path>', 'local invoice file')
+            .option('--url <url>', 'server-accessible file URL')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.ocr.preview', await inputFrom(options, {
+                file: opts.file,
+                url: opts.url,
+            }));
+        }));
+        const validate = invoice.command('validate').description('Invoice validation commands');
+        validate.command('preview')
+            .description('Validate an existing invoice without saving validation result')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--fid <fid>', 'invoice fid')
+            .option('--scope <scope>', 'personal or enterprise')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.validate.preview', await inputFrom(options, {
+                fid: opts.fid,
+                scope: opts.scope,
+            }));
+        }));
+        const importCommand = invoice.command('import').description('Invoice file import commands');
+        importCommand.command('prepare')
+            .description('Prepare a confirmed invoice file import')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--file <path>', 'local invoice file')
+            .option('--validate', 'request validation before import')
+            .option('--no-validate', 'skip validation before import')
+            .option('--sync-to-oa', 'sync imported invoice to OA where supported')
+            .option('--no-sync-to-oa', 'do not sync imported invoice to OA where supported')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.import.prepare', await inputFrom(options, {
+                file: opts.file,
+                validate: typeof opts.validate === 'boolean' ? opts.validate : undefined,
+                syncToOa: typeof opts.syncToOa === 'boolean' ? opts.syncToOa : undefined,
+            }));
+        }));
+        importCommand.command('apply')
+            .description('Apply a prepared invoice file import')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--file <path>', 'local invoice file')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.import.apply', await inputFrom(options, {
+                file: opts.file,
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const add = invoice.command('add').description('Manual invoice add commands');
+        add.command('prepare')
+            .description('Prepare a confirmed manual invoice add')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--scope <scope>', 'personal or enterprise')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.add.prepare', await inputFrom(options, { scope: opts.scope }));
+        }));
+        add.command('apply')
+            .description('Apply a prepared manual invoice add')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.add.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        const update = invoice.command('update').description('Invoice update commands');
+        update.command('prepare')
+            .description('Prepare an invoice update')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--fid <fid>', 'invoice fid')
+            .option('--scope <scope>', 'personal or enterprise')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.update.prepare', await inputFrom(options, {
+                fid: opts.fid,
+                scope: opts.scope,
+            }));
+        }));
+        update.command('apply')
+            .description('Apply a prepared invoice update')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.update.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+        invoice.command('download')
+            .description('Download an invoice attachment after verifying ownership')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--fid <fid>', 'invoice fid')
+            .option('--file-id <id>', 'invoice file id')
+            .option('--output <path>', 'output file path')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.download', await inputFrom(options, {
+                fid: opts.fid,
+                fileId: opts.fileId,
+                output: opts.output,
+            }));
+        }));
+        const del = invoice.command('delete').description('Invoice delete commands');
+        del.command('prepare')
+            .description('Prepare an invoice soft delete')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--fid <fid>', 'invoice fid')
+            .option('--scope <scope>', 'personal or enterprise')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.delete.prepare', await inputFrom(options, {
+                fid: opts.fid,
+                scope: opts.scope,
+            }));
+        }));
+        del.command('apply')
+            .description('Apply a prepared invoice soft delete')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--continuation <token>', 'continuation token from prepare')
+            .option('--yes', 'confirm the write operation')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'invoice.delete.apply', await inputFrom(options, {
+                continuation: opts.continuation,
+                confirm: opts.yes === true ? true : undefined,
+            }));
+        }));
+    },
+};