weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/jiuchuanhui/operations/datajson.js

@@ -0,0 +1,214 @@
+import { jiuchuanhuiConfirmationError, jiuchuanhuiPartialError, jiuchuanhuiValidationError, isJiuchuanhuiNetworkError, } from '../errors.js';
+import { asObject, asPositiveString, byIdBody, datasBody, listBody, listRecords, pagingFrom, resultDataIds, sessionMatches, stripForbiddenKeys, workflow, } from './shared.js';
+/**
+ * datajson 创建/更新写操作（saveFormData / updateFormData）。
+ * prepare -> apply 确认链；apply 校验 confirm + continuation + 会话一致后提交。
+ */
+export class DatajsonWritePrepareOperation {
+    name;
+    applyOperation;
+    constructor(name, applyOperation) {
+        this.name = name;
+        this.applyOperation = applyOperation;
+    }
+    async execute(input, { host, continuation }) {
+        const form = asObject(input.form, 'form');
+        const session = await host.getSession();
+        const preview = {
+            datas: form.datas !== undefined ? form.datas : [stripForbiddenKeys(form)],
+            operator: session.userId,
+        };
+        const continuationToken = await continuation.issue({
+            operation: this.applyOperation,
+            workflow: workflow(this.applyOperation, 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            form,
+            preview,
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow(this.applyOperation, 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+export class DatajsonWriteApplyOperation {
+    name;
+    path;
+    constructor(name, path) {
+        this.name = name;
+        this.path = path;
+    }
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw jiuchuanhuiConfirmationError(this.name, { hint: '重新调用时传入 confirm=true' });
+        if (typeof input.continuation !== 'string' || !input.continuation) {
+            throw jiuchuanhuiValidationError('continuation_required', 'apply 必须携带 prepare 返回的 continuation');
+        }
+        const lease = await continuation.verify(input.continuation, this.name);
+        if (!lease.form || typeof lease.form !== 'object') {
+            throw jiuchuanhuiValidationError('continuation_invalid', `${this.name} continuation 缺少表单数据`);
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw jiuchuanhuiValidationError('context_mismatch', '确认上下文已变化，请重新准备操作');
+        let result;
+        try {
+            result = await host.request({
+                path: this.path,
+                body: datasBody(lease.form, session.userId),
+                operation: this.name,
+            });
+        }
+        catch (error) {
+            if (isJiuchuanhuiNetworkError(error)) {
+                throw jiuchuanhuiPartialError('写请求发送后连接中断，结果不确定，禁止自动重试', {
+                    preview: lease.preview,
+                    workflow: workflow(this.name, 'EXECUTING'),
+                }, { stage: 'datajson-apply' });
+            }
+            throw error;
+        }
+        const dataIds = resultDataIds(result);
+        if (!dataIds.length) {
+            throw jiuchuanhuiPartialError('保存接口返回成功但没有 dataIds，结果不确定', {
+                preview: lease.preview,
+                result,
+                workflow: workflow(this.name, 'EXECUTING'),
+            }, { stage: 'datajson-response' });
+        }
+        return {
+            status: 'COMPLETE',
+            data: {
+                dataIds,
+                applied: lease.preview,
+                result,
+                workflow: workflow(this.name, 'COMPLETE'),
+            },
+        };
+    }
+}
+/** datajson 详情查询（getFormDataByPk）。 */
+export class DatajsonDetailOperation {
+    name;
+    path;
+    constructor(name, path) {
+        this.name = name;
+        this.path = path;
+    }
+    async execute(input, { host }) {
+        const id = asPositiveString(String(input.id ?? input.dataId), 'id');
+        const session = await host.getSession();
+        const result = await host.request({
+            path: this.path,
+            body: byIdBody(id, session.userId),
+            operation: this.name,
+        });
+        return {
+            status: 'COMPLETE',
+            data: {
+                id,
+                ...(result && typeof result === 'object' ? { raw: result } : {}),
+                mainTable: extractMainTable(result),
+                detail: result,
+            },
+        };
+    }
+}
+/**
+ * datajson 列表搜索。搜索条件走 query（透传），body 固定 datajson.mainTable/pageInfo/header。
+ * 需要总数时，与列表接口并行调用 countPath。
+ */
+export class DatajsonSearchOperation {
+    name;
+    path;
+    countPath;
+    constructor(name, path, countPath) {
+        this.name = name;
+        this.path = path;
+        this.countPath = countPath;
+    }
+    async execute(input, { host }) {
+        const { pageNo, pageSize } = pagingFrom(input);
+        const session = await host.getSession();
+        const query = buildSearchQuery(input, pageNo, pageSize);
+        const main = listBody(session.userId, pageNo, pageSize, {});
+        const listPromise = host.request({ path: this.path, query, body: main, operation: this.name });
+        const countPromise = input.count === true && this.countPath
+            ? host.request({ path: this.countPath, query: withoutPaging(query), body: listBody(session.userId, 1, 1, {}), operation: `${this.name}.count` })
+            : undefined;
+        const [listResult, countResult] = countPromise
+            ? await Promise.all([listPromise, countPromise])
+            : [await listPromise, undefined];
+        const records = listRecords(listResult);
+        const total = extractCount(countResult);
+        return {
+            status: 'COMPLETE',
+            data: {
+                items: records,
+                total,
+                pageNo,
+                pageSize,
+                hasMore: total === undefined ? records.length >= pageSize : pageNo * pageSize < total,
+                query,
+            },
+        };
+    }
+}
+function buildSearchQuery(input, pageNo, pageSize) {
+    const query = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (key === 'pageNo' || key === 'pageSize' || key === 'count' || value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            query[key] = value.join(',');
+        }
+        else if (typeof value === 'boolean') {
+            query[key] = value ? 'true' : 'false';
+        }
+        else {
+            query[key] = String(value);
+        }
+    }
+    // 事项范围参数：mine / all / customerSea，调用方传入，默认不加（业务 Skill 负责补默认值）
+    query.pageNo = pageNo;
+    query.pageSize = pageSize;
+    return query;
+}
+function withoutPaging(query) {
+    const next = { ...query };
+    delete next.pageNo;
+    delete next.pageSize;
+    return next;
+}
+function extractCount(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const root = value;
+    const datas = root.datajson?.datas;
+    const raw = Array.isArray(datas) ? datas[0] : datas;
+    const num = Number(raw ?? root.total ?? root.count);
+    return Number.isFinite(num) ? num : undefined;
+}
+function extractMainTable(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const root = value;
+    const mt = root.datajson?.mainTable;
+    if (mt && typeof mt === 'object' && !Array.isArray(mt))
+        return mt;
+    const datas = root.datajson?.datas;
+    if (Array.isArray(datas) && datas[0] && typeof datas[0] === 'object') {
+        const first = datas[0];
+        if (first.mainTable && typeof first.mainTable === 'object')
+            return first.mainTable;
+        return first;
+    }
+    return undefined;
+}

package/dist/shortcuts/jiuchuanhui/operations/esb.js

@@ -0,0 +1,157 @@
+import { jiuchuanhuiConfirmationError, jiuchuanhuiPartialError, jiuchuanhuiValidationError, isJiuchuanhuiNetworkError, } from '../errors.js';
+import { asObject, asNonEmptyString, esbBody, esbOutcome, sessionMatches, workflow } from './shared.js';
+/**
+ * ESB 写操作模板。所有 ESB 动作流写操作（新建/修改/转移/释放/领取/状态变更/赢单/输单/无效/暂停/重启/完成计划）
+ * 采用 prepare -> apply 两段式确认链：
+ * - prepare 只校验入参、签发 continuation，不触发动作流；
+ * - apply 必须 confirm:true + 有效 continuation，且校验会话上下文一致后才触发动作流。
+ */
+export class EsbWritePrepareOperation {
+    name;
+    applyOperation;
+    uniqueIndent;
+    mainTableKeys;
+    constructor(name, applyOperation, uniqueIndent, mainTableKeys) {
+        this.name = name;
+        this.applyOperation = applyOperation;
+        this.uniqueIndent = uniqueIndent;
+        this.mainTableKeys = mainTableKeys;
+    }
+    async execute(input, { host, continuation }) {
+        const mainTable = normalizeMainTable(input.mainTable, this.mainTableKeys);
+        const preview = summaryOf(mainTable);
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: this.applyOperation,
+            workflow: workflow(this.applyOperation, 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            uniqueIndent: this.uniqueIndent,
+            mainTable,
+            preview,
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                preview,
+                continuation: continuationToken,
+                expiresInSeconds: 600,
+                workflow: workflow(this.applyOperation, 'AWAITING_CONFIRMATION'),
+            },
+        };
+    }
+}
+export class EsbWriteApplyOperation {
+    name;
+    uniqueIndent;
+    constructor(name, uniqueIndent) {
+        this.name = name;
+        this.uniqueIndent = uniqueIndent;
+    }
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true)
+            throw jiuchuanhuiConfirmationError(this.name, { hint: '重新调用时传入 confirm=true' });
+        if (typeof input.continuation !== 'string' || !input.continuation) {
+            throw jiuchuanhuiValidationError('continuation_required', 'apply 必须携带 prepare 返回的 continuation');
+        }
+        const lease = await continuation.verify(input.continuation, this.name);
+        if (!lease.uniqueIndent || !lease.mainTable || typeof lease.mainTable !== 'object') {
+            throw jiuchuanhuiValidationError('continuation_invalid', `${this.name} continuation 缺少动作流标识或业务参数`);
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session))
+            throw jiuchuanhuiValidationError('context_mismatch', '确认上下文已变化，请重新准备操作');
+        if (lease.uniqueIndent !== this.uniqueIndent) {
+            throw jiuchuanhuiValidationError('continuation_mismatch', 'continuation 与当前操作的动作流标识不一致');
+        }
+        let result;
+        try {
+            result = await host.request({
+                path: '/api/esb/server/event/triggerActionFlow',
+                body: esbBody(lease.mainTable, this.uniqueIndent, session.userId),
+                operation: this.name,
+            });
+        }
+        catch (error) {
+            if (isJiuchuanhuiNetworkError(error)) {
+                throw jiuchuanhuiPartialError('写请求发送后连接中断，结果不确定，禁止自动重试', {
+                    preview: lease.preview,
+                    workflow: workflow(this.name, 'EXECUTING'),
+                }, { stage: 'esb-apply' });
+            }
+            throw error;
+        }
+        const { resultCode, resultMsg } = esbOutcome(result);
+        if (resultCode !== 200) {
+            throw jiuchuanhuiPartialError(`动作流返回非成功结果（resultCode=${resultCode}），结果不确定`, {
+                preview: lease.preview,
+                result,
+                workflow: workflow(this.name, 'EXECUTING'),
+            }, { stage: 'esb-response', resultCode, resultMsg });
+        }
+        return {
+            status: 'COMPLETE',
+            data: {
+                applied: lease.preview,
+                result: { resultCode, resultMsg },
+                workflow: workflow(this.name, 'COMPLETE'),
+            },
+        };
+    }
+}
+/**
+ * ESB 只读动作流（查询/搜索类，如按名称查 ID、查人员 ID、查联系记录等）。
+ * 不触发写入确认链。
+ */
+export class EsbReadOperation {
+    name;
+    uniqueIndent;
+    mainTableKeys;
+    constructor(name, uniqueIndent, mainTableKeys) {
+        this.name = name;
+        this.uniqueIndent = uniqueIndent;
+        this.mainTableKeys = mainTableKeys;
+    }
+    async execute(input, { host }) {
+        const mainTable = normalizeMainTable(input.mainTable ?? input, this.mainTableKeys);
+        const session = await host.getSession();
+        const result = await host.request({
+            path: '/api/esb/server/event/triggerActionFlow',
+            body: esbBody(mainTable, this.uniqueIndent, session.userId),
+            operation: this.name,
+        });
+        const { resultCode, resultMsg } = esbOutcome(result);
+        if (resultCode !== 200) {
+            throw jiuchuanhuiValidationError('esb_read_failed', `动作流查询失败（resultCode=${resultCode}）：${resultMsg}`);
+        }
+        const customData = result?.actionData?.responseData?.customData;
+        return {
+            status: 'COMPLETE',
+            data: {
+                resultCode,
+                resultMsg,
+                ...(customData && typeof customData === 'object' ? { customData } : {}),
+                mainTable: customData?.mainTable,
+                raw: result,
+            },
+        };
+    }
+}
+function normalizeMainTable(raw, allowedKeys) {
+    const mainTable = asObject(raw, 'mainTable');
+    if (!allowedKeys.length)
+        return { ...mainTable };
+    for (const key of Object.keys(mainTable)) {
+        if (!allowedKeys.includes(key)) {
+            throw jiuchuanhuiValidationError('field_unsupported', `${key} 不是该操作支持的字段`);
+        }
+    }
+    if (!allowedKeys.some((key) => mainTable[key] !== undefined && mainTable[key] !== null && mainTable[key] !== '')) {
+        throw jiuchuanhuiValidationError('field_required', `至少需要提供以下字段之一：${allowedKeys.join('、')}`);
+    }
+    return { ...mainTable };
+}
+function summaryOf(mainTable) {
+    return Object.fromEntries(Object.entries(mainTable).map(([key, value]) => [key, asNonEmptyString(value, key)]));
+}

package/dist/shortcuts/jiuchuanhui/operations/generic.js

@@ -0,0 +1,146 @@
+import { jiuchuanhuiValidationError } from '../errors.js';
+import { asNonEmptyString, asObject } from './shared.js';
+/** GET 接口（bodyMode=get）：query 透传，可带 save 保存文件流。 */
+export class GetQueryOperation {
+    name;
+    path;
+    requiredKeys;
+    constructor(name, path, requiredKeys = []) {
+        this.name = name;
+        this.path = path;
+        this.requiredKeys = requiredKeys;
+    }
+    async execute(input, { host }) {
+        const query = {};
+        for (const key of this.requiredKeys) {
+            const value = input[key];
+            if (value === undefined || value === null || value === '') {
+                throw jiuchuanhuiValidationError('field_required', `缺少必填参数：${key}`);
+            }
+            query[key] = String(value);
+        }
+        for (const [key, value] of Object.entries(input)) {
+            if (value === undefined || value === null || key === 'save')
+                continue;
+            query[key] = Array.isArray(value) ? value.join(',') : value;
+        }
+        const result = await host.request({
+            method: 'GET',
+            path: this.path,
+            query,
+            operation: this.name,
+        });
+        return {
+            status: 'COMPLETE',
+            data: {
+                ...(result && typeof result === 'object' ? { raw: result } : { raw: result }),
+                query,
+            },
+        };
+    }
+}
+/** POST raw body 接口（bodyMode=raw）：params 原样透传。 */
+export class RawPostOperation {
+    name;
+    path;
+    requiredKeys;
+    constructor(name, path, requiredKeys = []) {
+        this.name = name;
+        this.path = path;
+        this.requiredKeys = requiredKeys;
+    }
+    async execute(input, { host }) {
+        const body = asObject(input.params, 'params');
+        for (const key of this.requiredKeys) {
+            if (body[key] === undefined || body[key] === null || body[key] === '') {
+                throw jiuchuanhuiValidationError('field_required', `缺少必填参数：${key}`);
+            }
+        }
+        const query = {};
+        if (input.pathParams && typeof input.pathParams === 'object') {
+            for (const [key, value] of Object.entries(input.pathParams)) {
+                query[key] = String(value);
+            }
+        }
+        const result = await host.request({
+            path: this.path,
+            query,
+            body,
+            operation: this.name,
+        });
+        return {
+            status: 'COMPLETE',
+            data: {
+                ...(result && typeof result === 'object' ? { raw: result } : { raw: result }),
+            },
+        };
+    }
+}
+/** 占位符路径 raw POST（browser-option-search：path 含 {customBrowserType}）。 */
+export class PathParamsPostOperation {
+    name;
+    pathTemplate;
+    constructor(name, pathTemplate) {
+        this.name = name;
+        this.pathTemplate = pathTemplate;
+    }
+    async execute(input, { host }) {
+        const pathParams = asObject(input.pathParams ?? input.pathParamsRaw, 'pathParams');
+        const names = [...this.pathTemplate.matchAll(/\{(\w+)\}/g)].map((m) => m[1]);
+        let path = this.pathTemplate;
+        for (const name of names) {
+            const value = pathParams[name];
+            if (value === undefined || value === null || value === '') {
+                throw jiuchuanhuiValidationError('path_param_missing', `路径占位符 {${name}} 缺失，请通过 pathParams 传入`);
+            }
+            path = path.replace(`{${name}}`, encodeURIComponent(String(value)));
+        }
+        const body = input.params && typeof input.params === 'object' ? input.params : {};
+        const result = await host.request({
+            path,
+            body,
+            operation: this.name,
+        });
+        return {
+            status: 'COMPLETE',
+            data: {
+                ...(result && typeof result === 'object' ? { raw: result } : { raw: result }),
+            },
+        };
+    }
+}
+/** GET 文件预览/下载（get-file-preview）：fileId 等 query，save 输出到本地。 */
+export class FilePreviewOperation {
+    name;
+    constructor(name) {
+        this.name = name;
+    }
+    async execute(input, { host }) {
+        const fileId = asNonEmptyString(input.fileId, 'fileId');
+        const query = {
+            fileId,
+            module: input.module ?? 'ebuilderform',
+            authModule: input.authModule ?? 'ebuilderform',
+            source: input.source ?? 'form',
+        };
+        if (input.fieldId !== undefined)
+            query.fieldId = input.fieldId;
+        if (input.appId !== undefined)
+            query.appId = input.appId;
+        if (input.customParam !== undefined)
+            query.customParam = typeof input.customParam === 'string' ? input.customParam : JSON.stringify(input.customParam);
+        const result = await host.request({
+            method: 'GET',
+            path: '/api/file/preview',
+            query,
+            operation: this.name,
+        });
+        return {
+            status: 'COMPLETE',
+            data: {
+                ...(result && typeof result === 'object' ? { raw: result } : { raw: result }),
+                fileId,
+            },
+        };
+    }
+}

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

@@ -0,0 +1,133 @@
+import { jiuchuanhuiValidationError } from '../errors.js';
+import { jiuchuanhuiOperations } from '../manifest.js';
+import { CacheInitOperation } from '../cache.js';
+import { DatajsonDetailOperation, DatajsonSearchOperation, DatajsonWriteApplyOperation, DatajsonWritePrepareOperation, } from './datajson.js';
+import { EsbReadOperation, EsbWriteApplyOperation, EsbWritePrepareOperation, } from './esb.js';
+import { FilePreviewOperation, GetQueryOperation, PathParamsPostOperation, } from './generic.js';
+/**
+ * 九氚汇 operation -> handler 注册表。
+ *
+ * ESB 写操作 fixed.uniqueIndent 从 manifest 读取：registry 与 manifest 一一对应，
+ * 测试据此断言"每个 operation 有 handler / 每个 handler 在 schema 中暴露"。
+ */
+function buildRegistry() {
+    const registry = new Map();
+    const handlers = [
+        // ===== 发现与缓存 =====
+        new CacheInitOperation(),
+        new GetQueryOperation('jiuchuanhui.app.discovery', '/api/bs/ebuilder/app/tags/getAppIds', ['tag']),
+        new GetQueryOperation('jiuchuanhui.form.discovery', '/api/ebuilder/form/obj/getObjsByTag', ['tag', 'appId']),
+        new GetQueryOperation('jiuchuanhui.field.options', '/api/ebuilder/common/ds/options', ['fieldName', 'sourceType']),
+        new GetQueryOperation('jiuchuanhui.rest.cfg.detail', '/api/bs/ebuilder/form/formdata/getRestCfgById', ['apid', 'id']),
+        new EsbReadOperation('jiuchuanhui.config.id.by.pk', '4F6E1A9702864666803CCA6B77B86227', ['interface_pk']),
+        new FilePreviewOperation('jiuchuanhui.file.preview'),
+        // ===== 客户 =====
+        new DatajsonWritePrepareOperation('jiuchuanhui.customer.create.prepare', 'jiuchuanhui.customer.create.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.customer.create.apply', '/api/ebuilder/form/formdata/v2/saveFormData/customer_create_api'),
+        new DatajsonDetailOperation('jiuchuanhui.customer.get', '/api/ebuilder/form/formdata/v2/getFormDataByPk/customer_get_api'),
+        new DatajsonSearchOperation('jiuchuanhui.customer.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_search_api', '/api/ebuilder/form/formdata/v2/getFormDataCount/ebcustomer_search_count_api'),
+        new DatajsonSearchOperation('jiuchuanhui.customer.type.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_type_search_api'),
+        new DatajsonSearchOperation('jiuchuanhui.customer.status.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_status_search_api'),
+        new DatajsonSearchOperation('jiuchuanhui.customer.industry.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_industry_search_api'),
+        new DatajsonSearchOperation('jiuchuanhui.customer.open-sea.search', '/api/ebuilder/form/formdata/v2/getFormDataList/customer_open_sea_search_api'),
+        new DatajsonWritePrepareOperation('jiuchuanhui.customer.update.prepare', 'jiuchuanhui.customer.update.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.customer.update.apply', '/api/ebuilder/form/formdata/v2/updateFormData/customer_update_api'),
+        // ===== 客户 ESB 写操作 =====
+        new EsbWritePrepareOperation('jiuchuanhui.customer.transfer.prepare', 'jiuchuanhui.customer.transfer.apply', '1E44ED7DA9EB46329818E682C2914928', ['customerId', 'toUserId', 'remark']),
+        new EsbWriteApplyOperation('jiuchuanhui.customer.transfer.apply', '1E44ED7DA9EB46329818E682C2914928'),
+        new EsbWritePrepareOperation('jiuchuanhui.customer.open-sea.release.prepare', 'jiuchuanhui.customer.open-sea.release.apply', '0E29AD0E708D4964B071D293288B92D7', ['customerId', 'openSeaId', 'remark']),
+        new EsbWriteApplyOperation('jiuchuanhui.customer.open-sea.release.apply', '0E29AD0E708D4964B071D293288B92D7'),
+        new EsbWritePrepareOperation('jiuchuanhui.customer.open-sea.claim.prepare', 'jiuchuanhui.customer.open-sea.claim.apply', 'D587CDC892FE41118DD073475C01A2CE', ['customer_id']),
+        new EsbWriteApplyOperation('jiuchuanhui.customer.open-sea.claim.apply', 'D587CDC892FE41118DD073475C01A2CE'),
+        new EsbReadOperation('jiuchuanhui.customer.duplicate.check', 'D5D0A1C30E7B404B842987C0AD3B749D', ['name', 'simpleName']),
+        new EsbWritePrepareOperation('jiuchuanhui.customer.contact-record.create.prepare', 'jiuchuanhui.customer.contact-record.create.apply', 'C7A226EEE1324FF3B6E5BD18AF923DE7', ['customerId', 'comment_content', 'type', 'rating', 'contact_information', 'contacts', 'next_time', 'next_content', 'next_contact_information', 'next_contacts', 'sync_salechance', 'rel_remind']),
+        new EsbWriteApplyOperation('jiuchuanhui.customer.contact-record.create.apply', 'C7A226EEE1324FF3B6E5BD18AF923DE7'),
+        new EsbWritePrepareOperation('jiuchuanhui.customer.contact-record.batch.prepare', 'jiuchuanhui.customer.contact-record.batch.apply', 'D0F315619FE34C669AE738ED68329FAB', ['entityList', 'content']),
+        new EsbWriteApplyOperation('jiuchuanhui.customer.contact-record.batch.apply', 'D0F315619FE34C669AE738ED68329FAB'),
+        // ===== 联系人 =====
+        new DatajsonWritePrepareOperation('jiuchuanhui.contact.create.prepare', 'jiuchuanhui.contact.create.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.contact.create.apply', '/api/ebuilder/form/formdata/v2/saveFormData/contact_create_api'),
+        new DatajsonDetailOperation('jiuchuanhui.contact.get', '/api/ebuilder/form/formdata/v2/getFormDataByPk/contact_get_api'),
+        new DatajsonWritePrepareOperation('jiuchuanhui.contact.update.prepare', 'jiuchuanhui.contact.update.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.contact.update.apply', '/api/ebuilder/form/formdata/v2/updateFormData/contact_update_api'),
+        new DatajsonSearchOperation('jiuchuanhui.contact.by-entity.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebcontact_search_by_entity_api'),
+        // ===== 商机 =====
+        new DatajsonWritePrepareOperation('jiuchuanhui.sale.create.prepare', 'jiuchuanhui.sale.create.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.sale.create.apply', '/api/ebuilder/form/formdata/v2/saveFormData/sale_create_api'),
+        new DatajsonDetailOperation('jiuchuanhui.sale.get', '/api/ebuilder/form/formdata/v2/getFormDataByPk/sale_get_api'),
+        new DatajsonSearchOperation('jiuchuanhui.sale.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebsale_search_api', '/api/ebuilder/form/formdata/v2/getFormDataCount/ebsale_search_count_api'),
+        new DatajsonWritePrepareOperation('jiuchuanhui.sale.update.prepare', 'jiuchuanhui.sale.update.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.sale.update.apply', '/api/ebuilder/form/formdata/v2/updateFormData/sale_update_api'),
+        new DatajsonSearchOperation('jiuchuanhui.sale.stage.search', '/api/ebuilder/form/formdata/v2/getFormDataList/sale_stage_search_api'),
+        new DatajsonSearchOperation('jiuchuanhui.sale.process.search', '/api/ebuilder/form/formdata/v2/getFormDataList/sale_process_sear_api'),
+        new DatajsonSearchOperation('jiuchuanhui.sale.lose-reason.search', '/api/ebuilder/form/formdata/v2/getFormDataList/sale_lose_reason'),
+        new DatajsonSearchOperation('jiuchuanhui.rival.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebrival_search_api'),
+        // ===== 商机 ESB 写操作 =====
+        new EsbWritePrepareOperation('jiuchuanhui.sale.win.prepare', 'jiuchuanhui.sale.win.apply', '3B23E782E5084F18A904E895BBD61A96', ['saleId']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.win.apply', '3B23E782E5084F18A904E895BBD61A96'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.lose.prepare', 'jiuchuanhui.sale.lose.apply', 'DE35D926F82F49FDBA26B48B0CA1CB53', ['saleid', 'money', 'reasonids', 'rivals', 'desc']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.lose.apply', 'DE35D926F82F49FDBA26B48B0CA1CB53'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.invalid.prepare', 'jiuchuanhui.sale.invalid.apply', '4D88AB8677D84BAC90B63137E7FA1FF9', ['saleId']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.invalid.apply', '4D88AB8677D84BAC90B63137E7FA1FF9'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.pause.prepare', 'jiuchuanhui.sale.pause.apply', '859C73403DCC4F01B02329571BDBD9F3', ['saleId', 'pauseReason', 'restartDate']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.pause.apply', '859C73403DCC4F01B02329571BDBD9F3'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.restart.prepare', 'jiuchuanhui.sale.restart.apply', 'F3004CDCA8A548B5A0DACD3CDE62387A', ['saleChanceId']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.restart.apply', 'F3004CDCA8A548B5A0DACD3CDE62387A'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.manager-change.prepare', 'jiuchuanhui.sale.manager-change.apply', '595F9C6F1C4248929B83086F71363BA7', ['saleChanceId', 'managerId']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.manager-change.apply', '595F9C6F1C4248929B83086F71363BA7'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.link-contacts.prepare', 'jiuchuanhui.sale.link-contacts.apply', '1114A713A62F4CA9899CC24ED5902D93', ['salechanceId', 'contactIds']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.link-contacts.apply', '1114A713A62F4CA9899CC24ED5902D93'),
+        new EsbWritePrepareOperation('jiuchuanhui.sale.contact-record.create.prepare', 'jiuchuanhui.sale.contact-record.create.apply', '7BB3A1918186445F9E770862EFA7EDA9', ['saleId', 'comment_content', 'type', 'rating', 'contact_information', 'contacts', 'next_time', 'next_content', 'next_contact_information', 'next_contacts', 'rel_remind']),
+        new EsbWriteApplyOperation('jiuchuanhui.sale.contact-record.create.apply', '7BB3A1918186445F9E770862EFA7EDA9'),
+        // ===== 线索 =====
+        new DatajsonWritePrepareOperation('jiuchuanhui.clue.create.prepare', 'jiuchuanhui.clue.create.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.clue.create.apply', '/api/ebuilder/form/formdata/v2/saveFormData/ebclue_ai_create_api'),
+        new DatajsonDetailOperation('jiuchuanhui.clue.get', '/api/ebuilder/form/formdata/v2/getFormDataByPk/ebcluepool_ai_get_api'),
+        new DatajsonSearchOperation('jiuchuanhui.clue.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebclue_ai_search_api', '/api/ebuilder/form/formdata/v2/getFormDataCount/ebclue_ai_search_count_api'),
+        new DatajsonSearchOperation('jiuchuanhui.clue.pool.search', '/api/ebuilder/form/formdata/v2/getFormDataList/ebcluepool_ai_search_api'),
+        new DatajsonWritePrepareOperation('jiuchuanhui.clue.update.prepare', 'jiuchuanhui.clue.update.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.clue.update.apply', '/api/ebuilder/form/formdata/v2/updateFormData/ebclue_ai_update_api'),
+        // ===== 线索 ESB 写操作 =====
+        new EsbWritePrepareOperation('jiuchuanhui.clue.status-change.prepare', 'jiuchuanhui.clue.status-change.apply', '257CC8DE42234F9191439B229839B8A7', ['clueid', 'type', 'newmanager', 'desc']),
+        new EsbWriteApplyOperation('jiuchuanhui.clue.status-change.apply', '257CC8DE42234F9191439B229839B8A7'),
+        new EsbWritePrepareOperation('jiuchuanhui.clue.to-customer.prepare', 'jiuchuanhui.clue.to-customer.apply', '00914C6415EB455DB7FCCC32DBE6E0C3', ['clueId', 'customerId']),
+        new EsbWriteApplyOperation('jiuchuanhui.clue.to-customer.apply', '00914C6415EB455DB7FCCC32DBE6E0C3'),
+        new EsbWritePrepareOperation('jiuchuanhui.clue.contact-record.create.prepare', 'jiuchuanhui.clue.contact-record.create.apply', 'B3DD120601344320A2B50A042B450681', ['clueId', 'content', 'clueStatus_MappingId']),
+        new EsbWriteApplyOperation('jiuchuanhui.clue.contact-record.create.apply', 'B3DD120601344320A2B50A042B450681'),
+        // ===== 联系计划 =====
+        new DatajsonWritePrepareOperation('jiuchuanhui.contact-plan.create.prepare', 'jiuchuanhui.contact-plan.create.apply'),
+        new DatajsonWriteApplyOperation('jiuchuanhui.contact-plan.create.apply', '/api/ebuilder/form/formdata/v2/saveFormData/ebcontact_plan_create_api'),
+        new EsbWritePrepareOperation('jiuchuanhui.contact-plan.complete.prepare', 'jiuchuanhui.contact-plan.complete.apply', '2595D3556CFC414F85B1A4A8D806EFE5', ['planId']),
+        new EsbWriteApplyOperation('jiuchuanhui.contact-plan.complete.apply', '2595D3556CFC414F85B1A4A8D806EFE5'),
+        // ===== 联系记录 =====
+        new EsbReadOperation('jiuchuanhui.entity.contact-records.list', '364A9713D10C4997AF6EDCAA5296968E', ['moduleType', 'entityId']),
+        new EsbReadOperation('jiuchuanhui.contact-records.by-person-time.list', 'D01DD00978524525AD8728BE1BF9FE79', ['employeeId', 'startData', 'endData']),
+        // ===== 通用辅助 =====
+        new EsbReadOperation('jiuchuanhui.entity.id.by-name', '7EC1639D5AC24B4DBCEE8D2CB85D4025', ['moduleType', 'name']),
+        new EsbReadOperation('jiuchuanhui.user.id.by-name', '911C17207E2C4BD29379B5A4001B246E', ['employeeName']),
+        new EsbReadOperation('jiuchuanhui.user.current-profile', 'B8F7597190FF419FB9127D6C8272C4FE', []),
+        new EsbReadOperation('jiuchuanhui.entity.permission.judge', '6D369F0A84764051A5D7B5AA1245F49A', ['moduleType', 'entityId', 'opType']),
+        new EsbReadOperation('jiuchuanhui.company.business-profile.query', 'BAB4DBE204214BB395BA161620A4A1CD', ['companyName']),
+        new EsbReadOperation('jiuchuanhui.field.info.by-ids', '10351A4DC8D4454A9F1957FBE647CD9F', ['fieldids']),
+        new PathParamsPostOperation('jiuchuanhui.browser-option.search', '/api/bcw/common/browser/complete/{customBrowserType}'),
+        new GetQueryOperation('jiuchuanhui.get-rest-cfg-detail', '/api/bs/ebuilder/form/formdata/getRestCfgById', ['apid', 'id']),
+    ];
+    for (const handler of handlers) {
+        if (registry.has(handler.name))
+            throw new Error(`duplicate jiuchuanhui operation handler: ${handler.name}`);
+        registry.set(handler.name, handler);
+    }
+    for (const contract of jiuchuanhuiOperations) {
+        if (!registry.has(contract.name))
+            throw new Error(`missing jiuchuanhui operation handler: ${contract.name}`);
+    }
+    return registry;
+}
+const jiuchuanhuiOperationRegistry = buildRegistry();
+export function getJiuchuanhuiOperation(operation) {
+    const handler = jiuchuanhuiOperationRegistry.get(operation);
+    if (!handler) {
+        throw jiuchuanhuiValidationError('operation_unknown', `九氚汇不支持操作：${operation}`);
+    }
+    return handler;
+}