weaver-work-cli 0.1.5 → 0.1.7

package/dist/shortcuts/ebuilder-form/index.js

@@ -0,0 +1,108 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createEbuilderFormContinuationSigner } from './continuation.js';
+import { ebuilderValidationError } from './errors.js';
+import { createEbuilderFormHost } from './host.js';
+import { ebuilderFormManifest } from './manifest.js';
+import { executeEbuilderFormOperation } from './operations.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');
+}
+function stripBom(value) {
+    return value.replace(/^\uFEFF+/u, '');
+}
+function parseJsonInput(raw, label) {
+    try {
+        const parsed = JSON.parse(stripBom(raw));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('input must be an object');
+        }
+        return parsed;
+    }
+    catch {
+        throw ebuilderValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw ebuilderValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson) {
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    }
+    if (opts.input) {
+        let raw;
+        try {
+            raw = stripBom(opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8'));
+        }
+        catch {
+            throw ebuilderValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+        input = parseJsonInput(raw, '--input');
+    }
+    return {
+        ...input,
+        ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== '')),
+    };
+}
+export function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data === undefined ? null : result.data,
+        ...(result.meta ? { meta: result.meta } : {}),
+        warnings: result.warnings ?? [],
+    };
+}
+function failureEnvelope(error) {
+    return {
+        schemaVersion: 1,
+        ok: false,
+        error: toErrorEnvelope(error),
+    };
+}
+async function executeAndPrint(ctx, operation, input) {
+    try {
+        const result = await executeEbuilderFormOperation(operation, input, {
+            ctx,
+            host: createEbuilderFormHost(ctx),
+            continuation: createEbuilderFormContinuationSigner(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 ebuilderFormShortcut = {
+    name: 'ebuilder-form',
+    description: '泛微E10 eBuilder 表单菜单、列表和表单数据 CLI',
+    category: 'shortcut',
+    register({ program, action }) {
+        const ebuilder = program.command('ebuilder-form').description('泛微E10 eBuilder 表单菜单、List/NList、OpenAPI 与自定义接口能力');
+        ebuilder.command('schema')
+            .description('Print ebuilder-form operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(ebuilderFormManifest, { json: true });
+        }));
+        ebuilder.command('run')
+            .description('Run an ebuilder-form operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. ebuilder-form.context.resolve')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+    },
+};

package/dist/shortcuts/ebuilder-form/manifest.js

@@ -0,0 +1,347 @@
+const contextProperties = {
+    context: { type: 'object', description: '已解析的 eBuilder 上下文，可由 ebuilder-form.context.resolve 返回' },
+    menuKeywords: { type: 'array', items: { type: 'string' }, minItems: 1, maxItems: 5 },
+    menu: { type: 'string' },
+    menuId: { type: 'string', pattern: '^\\d+$' },
+    url: { type: 'string', description: 'E10 列表页面 URL；支持 /sp/ebdfpage/list、viewport 和 /ebdapp/view' },
+    appId: { type: 'string', pattern: '^\\d+$' },
+    apiPrefix: { type: 'string', pattern: '^/api/ebuilder\\d*$' },
+    objId: { type: 'string', pattern: '^\\d+$' },
+    listId: { type: 'string', pattern: '^\\d+$' },
+    hostPageId: { type: 'string', pattern: '^\\d+$' },
+    listKind: { type: 'string', enum: ['List', 'NList'] },
+    menuUrl: { type: 'string' },
+    entryUrl: { type: 'string' },
+};
+const preparedWriteProperties = {
+    confirm: { const: true },
+    continuation: { type: 'string', minLength: 1 },
+};
+function schema(properties, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(options.required?.length ? { required: options.required } : {}),
+        ...(options.anyOf ? { anyOf: options.anyOf } : {}),
+        ...(options.oneOf ? { oneOf: options.oneOf } : {}),
+        ...(options.description ? { description: options.description } : {}),
+    };
+}
+export const ebuilderFormOperations = [
+    {
+        name: 'ebuilder-form.menu.search',
+        summary: '按业务关键词查询当前账号有权限访问的 eBuilder 表格/数据列表菜单',
+        risk: 'read',
+        inputSchema: schema({
+            menuKeywords: { type: 'array', items: { type: 'string' }, minItems: 1, maxItems: 5 },
+        }, { required: ['menuKeywords'] }),
+    },
+    {
+        name: 'ebuilder-form.context.resolve',
+        summary: '从菜单关键词、页面 URL、objId 或现有 context 解析 appId、apiPrefix、listId、objId 和页面地址上下文',
+        risk: 'read',
+        inputSchema: schema(contextProperties, {
+            anyOf: [
+                { required: ['context'] },
+                { required: ['url'] },
+                { required: ['menuKeywords'] },
+                { required: ['menu'] },
+                { required: ['objId'] },
+                { required: ['listId', 'appId', 'listKind'] },
+            ],
+        }),
+    },
+    {
+        name: 'ebuilder-form.views.list',
+        summary: '枚举某个表单对象下的 List/NList 视图',
+        risk: 'read',
+        inputSchema: schema(contextProperties, { required: ['objId'] }),
+    },
+    {
+        name: 'ebuilder-form.list.config',
+        summary: '读取传统表格 List 的基础设置、显示列、排序、搜索、统计和固定条件配置',
+        risk: 'read',
+        inputSchema: schema(contextProperties, {
+            anyOf: [{ required: ['context'] }, { required: ['listId', 'appId'] }, { required: ['menuKeywords'] }, { required: ['url'] }],
+        }),
+    },
+    {
+        name: 'ebuilder-form.list.query',
+        summary: '按 List 运行时接口查询分页数据和真实总数，保留明细展开重复行',
+        risk: 'read',
+        inputSchema: schema({
+            ...contextProperties,
+            pageNo: { type: 'integer', minimum: 1, default: 1 },
+            pageSize: { type: 'integer', minimum: 1, maximum: 200 },
+            allPages: { type: 'boolean', default: false },
+            tableuid: { type: 'string' },
+            searchParamData: { type: 'object' },
+            filterCondition: { type: 'object' },
+            orderParams: { type: 'array' },
+            passid: { type: 'string' },
+            cid: { type: 'string' },
+        }),
+    },
+    {
+        name: 'ebuilder-form.nlist.config',
+        summary: '读取数据列表 NList 的页面、组件与 comps[1].config 运行时配置',
+        risk: 'read',
+        inputSchema: schema(contextProperties, {
+            anyOf: [{ required: ['context'] }, { required: ['hostPageId', 'appId'] }, { required: ['menuKeywords'] }, { required: ['url'] }],
+        }),
+    },
+    {
+        name: 'ebuilder-form.nlist.query',
+        summary: '按 NList eblist 运行时接口查询分页数据和真实总数，使用 customConfig LZW 数字串编码',
+        risk: 'read',
+        inputSchema: schema({
+            ...contextProperties,
+            pageNo: { type: 'integer', minimum: 1, default: 1 },
+            pageSize: { type: 'integer', minimum: 1, maximum: 200 },
+            allPages: { type: 'boolean', default: false },
+            compId: { type: 'string' },
+            tableuid: { type: 'string' },
+            filter: {},
+            fieldFilter: {},
+            pageFilter: {},
+            customConfig: { type: 'object' },
+            refPluginPackageId: { type: 'string' },
+        }),
+    },
+    {
+        name: 'ebuilder-form.fields.get',
+        summary: '读取 eBuilder 字段定义，返回主表与明细表字段、config.dataKey、browserParams 和组件类型',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/common/ds/fields' },
+        inputSchema: schema({
+            ...contextProperties,
+            groupId: { type: 'string' },
+            sourceId: { type: 'string' },
+            sourceType: { type: 'string', default: 'FORM' },
+            detailFieldsGroup: { type: ['boolean', 'string'], default: true },
+            enableMerge: { type: ['boolean', 'string'], default: true },
+            customParam: {},
+            params: {},
+        }),
+    },
+    {
+        name: 'ebuilder-form.options.get',
+        summary: '按字段元数据 ID 读取选择类字段选项',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/common/ds/options' },
+        inputSchema: schema({
+            ...contextProperties,
+            fieldName: { type: 'string', pattern: '^\\d+$' },
+            fieldId: { type: 'string', pattern: '^\\d+$' },
+            sourceType: { type: 'string', default: 'FORM' },
+            groupId: { type: 'string' },
+            optionLevel: { type: ['integer', 'string'], default: 1 },
+        }, {
+            anyOf: [{ required: ['fieldName'] }, { required: ['fieldId'] }],
+        }),
+    },
+    {
+        name: 'ebuilder-form.mapping.get',
+        summary: '读取 objId 的 mainTable/detailN 与主表/明细表标识映射',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/dataset/v1/getTableMapping' },
+        inputSchema: schema({
+            ...contextProperties,
+            reverse: { type: 'boolean', default: false },
+        }, { required: ['objId'] }),
+    },
+    {
+        name: 'ebuilder-form.browser.resolve',
+        summary: '调用字段配置或已知模块对应的通用浏览 complete 接口，将名称解析为可选项 ID',
+        risk: 'read',
+        inputSchema: schema({
+            module: { type: 'string', description: '浏览接口模块，例如 hrm、workflow/core、doc、task' },
+            browserType: { type: 'string', description: '浏览类型，例如 resource、department、wfcRequest' },
+            query: { type: 'string', minLength: 1 },
+            multiple: { type: 'boolean', default: false },
+            limit: { type: 'integer', minimum: 1, maximum: 50, default: 20 },
+            extra: { type: 'object' },
+        }, { required: ['module', 'browserType', 'query'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.detail',
+        summary: 'OpenAPI getDataById 获取单条表单数据详情',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/dataset/v2/getDataById' },
+        inputSchema: schema({
+            ...contextProperties,
+            dataId: { type: 'string', pattern: '^\\d+$' },
+            isReturnDetail: { type: ['boolean', 'string'], default: 'y' },
+            fieldNoFindIgnore: { type: ['boolean', 'string'], default: 'false' },
+        }, { required: ['objId', 'dataId'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.query',
+        summary: 'OpenAPI getAllData 表单级分页查询',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/dataset/v2/getAllData' },
+        inputSchema: schema({
+            ...contextProperties,
+            mainTable: { type: 'object' },
+            pageNo: { type: 'integer', minimum: 1, default: 1 },
+            pageSize: { type: 'integer', minimum: 1, maximum: 1000, default: 10 },
+            isReturnDetail: { type: ['boolean', 'string'], default: 'n' },
+            fieldNoFindIgnore: { type: ['boolean', 'string'], default: 'false' },
+        }, { required: ['objId'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.count',
+        summary: 'OpenAPI getAllDataCount 表单级总数查询',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/dataset/v2/getAllDataCount' },
+        inputSchema: schema({
+            ...contextProperties,
+            mainTable: { type: 'object' },
+            fieldNoFindIgnore: { type: ['boolean', 'string'], default: 'false' },
+        }, { required: ['objId'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.add.prepare',
+        summary: '准备 OpenAPI saveFormData 新增请求，签发 continuation，不写入',
+        risk: 'read-before-write',
+        inputSchema: schema({
+            ...contextProperties,
+            datas: { type: 'array', minItems: 1 },
+            operationinfo: { type: 'object' },
+        }, { required: ['objId', 'datas'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.add.apply',
+        summary: '确认后执行 OpenAPI saveFormData 新增请求',
+        risk: 'high-risk-write',
+        inputSchema: schema(preparedWriteProperties, { required: ['confirm', 'continuation'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.update.prepare',
+        summary: '准备 OpenAPI updateFormData 修改请求，签发 continuation，不写入',
+        risk: 'read-before-write',
+        inputSchema: schema({
+            ...contextProperties,
+            datas: { type: 'array', minItems: 1 },
+            operationinfo: { type: 'object' },
+        }, { required: ['objId', 'datas'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.update.apply',
+        summary: '确认后执行 OpenAPI updateFormData 修改请求',
+        risk: 'high-risk-write',
+        inputSchema: schema(preparedWriteProperties, { required: ['confirm', 'continuation'] }),
+    },
+    {
+        name: 'ebuilder-form.openapi.delete.prepare',
+        summary: '准备 OpenAPI deleteData 删除请求，签发 continuation，不写入',
+        risk: 'read-before-write',
+        inputSchema: schema({
+            ...contextProperties,
+            mainTable: { type: 'object', description: '删除条件；按数据 ID 删除时传 {"id":"..."}' },
+            dataId: { type: 'string', pattern: '^\\d+$' },
+            operationinfo: { type: 'object' },
+        }, {
+            required: ['objId'],
+            anyOf: [{ required: ['dataId'] }, { required: ['mainTable'] }],
+        }),
+    },
+    {
+        name: 'ebuilder-form.openapi.delete.apply',
+        summary: '确认后执行 OpenAPI deleteData 删除请求',
+        risk: 'high-risk-write',
+        inputSchema: schema(preparedWriteProperties, { required: ['confirm', 'continuation'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.detail',
+        summary: '已发布自定义接口 getFormDataByPk 根据主键查询详情',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/formdata/v2/getFormDataByPk/{interfacePk}' },
+        inputSchema: schema({
+            ...contextProperties,
+            interfacePk: { type: 'string', minLength: 1 },
+            dataId: { type: 'string', pattern: '^\\d+$' },
+        }, { required: ['interfacePk', 'dataId'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.query',
+        summary: '已发布自定义接口 getFormDataList 分页查询',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/formdata/v2/getFormDataList/{interfacePk}' },
+        inputSchema: schema({
+            ...contextProperties,
+            interfacePk: { type: 'string', minLength: 1 },
+            mainTable: { type: 'object' },
+            pageNo: { type: 'integer', minimum: 1, default: 1 },
+            pageSize: { type: 'integer', minimum: 1, maximum: 1000, default: 10 },
+        }, { required: ['interfacePk'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.count',
+        summary: '已发布自定义接口 getFormDataCount 查询总数',
+        risk: 'read',
+        fixed: { path: '/api/ebuilder/form/formdata/v2/getFormDataCount/{interfacePk}' },
+        inputSchema: schema({
+            ...contextProperties,
+            interfacePk: { type: 'string', minLength: 1 },
+            mainTable: { type: 'object' },
+        }, { required: ['interfacePk'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.add.prepare',
+        summary: '准备已发布自定义接口 saveFormData 新增请求，签发 continuation',
+        risk: 'read-before-write',
+        inputSchema: schema({
+            ...contextProperties,
+            interfacePk: { type: 'string', minLength: 1 },
+            datas: { type: 'array', minItems: 1 },
+            operationinfo: { type: 'object' },
+        }, { required: ['interfacePk', 'datas'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.add.apply',
+        summary: '确认后执行已发布自定义接口 saveFormData 新增请求',
+        risk: 'high-risk-write',
+        inputSchema: schema(preparedWriteProperties, { required: ['confirm', 'continuation'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.update.prepare',
+        summary: '准备已发布自定义接口 updateFormData 修改请求，签发 continuation',
+        risk: 'read-before-write',
+        inputSchema: schema({
+            ...contextProperties,
+            interfacePk: { type: 'string', minLength: 1 },
+            datas: { type: 'array', minItems: 1 },
+            operationinfo: { type: 'object' },
+        }, { required: ['interfacePk', 'datas'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.update.apply',
+        summary: '确认后执行已发布自定义接口 updateFormData 修改请求',
+        risk: 'high-risk-write',
+        inputSchema: schema(preparedWriteProperties, { required: ['confirm', 'continuation'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.delete.prepare',
+        summary: '准备已发布自定义接口 deleteFormData 删除请求，签发 continuation',
+        risk: 'read-before-write',
+        inputSchema: schema({
+            ...contextProperties,
+            interfacePk: { type: 'string', minLength: 1 },
+            dataIds: { type: 'array', items: { type: 'string', pattern: '^\\d+$' }, minItems: 1 },
+            operationinfo: { type: 'object' },
+        }, { required: ['interfacePk', 'dataIds'] }),
+    },
+    {
+        name: 'ebuilder-form.custom.delete.apply',
+        summary: '确认后执行已发布自定义接口 deleteFormData 删除请求',
+        risk: 'high-risk-write',
+        inputSchema: schema(preparedWriteProperties, { required: ['confirm', 'continuation'] }),
+    },
+];
+export const ebuilderFormManifest = {
+    module: 'ebuilder-form',
+    version: 1,
+    operations: ebuilderFormOperations,
+};

package/dist/shortcuts/ebuilder-form/operations/read.js

@@ -0,0 +1,157 @@
+import { ebuilderSuccess } from './types.js';
+import { asObject, assertKnownKeys, optionalString, requiredArray, } from './shared.js';
+const CONTEXT_KEYS = [
+    'context',
+    'menuKeywords',
+    'menu',
+    'menuId',
+    'url',
+    'appId',
+    'apiPrefix',
+    'objId',
+    'listId',
+    'hostPageId',
+    'listKind',
+    'menuUrl',
+    'entryUrl',
+];
+export class EbuilderMenuSearchOperation {
+    name = 'ebuilder-form.menu.search';
+    async execute(input, { host }) {
+        assertKnownKeys(input, ['menuKeywords'], this.name);
+        const keywords = requiredArray(input.menuKeywords, 'menuKeywords').map((item) => String(item));
+        const menus = await host.searchMenus(keywords);
+        return ebuilderSuccess(this.name, { menus, count: menus.length }, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderContextResolveOperation {
+    name = 'ebuilder-form.context.resolve';
+    async execute(input, { host }) {
+        const context = await host.resolveContext(input);
+        return ebuilderSuccess(this.name, {
+            context,
+            listUrl: host.buildListUrl(context),
+        }, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderViewsListOperation {
+    name = 'ebuilder-form.views.list';
+    async execute(input, { host }) {
+        const result = await host.formViews(input);
+        return ebuilderSuccess(this.name, result, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderListConfigOperation {
+    name = 'ebuilder-form.list.config';
+    async execute(input, { host }) {
+        const context = await host.resolveContext({ ...input, listKind: input.listKind || input.context?.listKind || 'List' });
+        const result = await host.listConfig(context, this.name);
+        return ebuilderSuccess(this.name, result, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderListQueryOperation {
+    name = 'ebuilder-form.list.query';
+    async execute(input, { host }) {
+        const result = await host.listQuery(input, this.name);
+        return ebuilderSuccess(this.name, result, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderNlistConfigOperation {
+    name = 'ebuilder-form.nlist.config';
+    async execute(input, { host }) {
+        const context = await host.resolveContext({ ...input, listKind: input.listKind || input.context?.listKind || 'NList' });
+        const result = await host.nlistConfig(context, this.name);
+        return ebuilderSuccess(this.name, result, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderNlistQueryOperation {
+    name = 'ebuilder-form.nlist.query';
+    async execute(input, { host }) {
+        const result = await host.nlistQuery(input, this.name);
+        return ebuilderSuccess(this.name, result, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderFieldsGetOperation {
+    name = 'ebuilder-form.fields.get';
+    async execute(input, { host }) {
+        const result = await host.fields(input, this.name);
+        return ebuilderSuccess(this.name, { result }, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderOptionsGetOperation {
+    name = 'ebuilder-form.options.get';
+    async execute(input, { host }) {
+        const result = await host.options(input, this.name);
+        return ebuilderSuccess(this.name, { result }, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderMappingGetOperation {
+    name = 'ebuilder-form.mapping.get';
+    async execute(input, { host }) {
+        const result = await host.mapping(input, this.name);
+        return ebuilderSuccess(this.name, { result }, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderBrowserResolveOperation {
+    name = 'ebuilder-form.browser.resolve';
+    async execute(input, { host }) {
+        assertKnownKeys(input, ['module', 'browserType', 'query', 'multiple', 'limit', 'extra'], this.name);
+        const result = await host.browserResolve(input, this.name);
+        return ebuilderSuccess(this.name, result, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderOpenapiReadOperation {
+    endpoint;
+    name;
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+        this.name = `ebuilder-form.openapi.${endpoint}`;
+    }
+    async execute(input, { host }) {
+        const allowed = [
+            ...CONTEXT_KEYS,
+            'dataId',
+            'mainTable',
+            'pageNo',
+            'pageSize',
+            'isReturnDetail',
+            'fieldNoFindIgnore',
+        ];
+        assertKnownKeys(input, allowed, this.name);
+        const result = await host.openapiRead(this.endpoint, input, this.name);
+        const data = addLinks(result, host, this.endpoint === 'detail' ? optionalString(input.dataId, 'dataId') : undefined);
+        return ebuilderSuccess(this.name, data, { status: 'COMPLETE' });
+    }
+}
+export class EbuilderCustomReadOperation {
+    endpoint;
+    name;
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+        this.name = `ebuilder-form.custom.${endpoint}`;
+    }
+    async execute(input, { host }) {
+        const allowed = [
+            ...CONTEXT_KEYS,
+            'interfacePk',
+            'dataId',
+            'mainTable',
+            'pageNo',
+            'pageSize',
+        ];
+        assertKnownKeys(input, allowed, this.name);
+        const result = await host.customRead(this.endpoint, input, this.name);
+        const data = addLinks(result, host, this.endpoint === 'detail' ? optionalString(input.dataId, 'dataId') : undefined);
+        return ebuilderSuccess(this.name, data, { status: 'COMPLETE' });
+    }
+}
+function addLinks(result, host, dataId) {
+    const context = asObject(result.context || {}, 'context');
+    const payload = asObject(result.result || {}, 'result');
+    return {
+        context,
+        result: payload,
+        ...(dataId ? { dataUrl: host.buildDataUrl(context, dataId) } : {}),
+        listUrl: host.buildListUrl(context),
+    };
+}

package/dist/shortcuts/ebuilder-form/operations/registry.js

@@ -0,0 +1,56 @@
+import { ebuilderValidationError } from '../errors.js';
+import { ebuilderFormOperations } from '../manifest.js';
+import { EbuilderBrowserResolveOperation, EbuilderContextResolveOperation, EbuilderCustomReadOperation, EbuilderFieldsGetOperation, EbuilderListConfigOperation, EbuilderListQueryOperation, EbuilderMappingGetOperation, EbuilderMenuSearchOperation, EbuilderNlistConfigOperation, EbuilderNlistQueryOperation, EbuilderOpenapiReadOperation, EbuilderOptionsGetOperation, EbuilderViewsListOperation, } from './read.js';
+import { EbuilderCustomApplyOperation, EbuilderCustomPrepareOperation, EbuilderOpenapiApplyOperation, EbuilderOpenapiPrepareOperation, } from './write.js';
+function buildRegistry() {
+    const handlers = [
+        new EbuilderMenuSearchOperation(),
+        new EbuilderContextResolveOperation(),
+        new EbuilderViewsListOperation(),
+        new EbuilderListConfigOperation(),
+        new EbuilderListQueryOperation(),
+        new EbuilderNlistConfigOperation(),
+        new EbuilderNlistQueryOperation(),
+        new EbuilderFieldsGetOperation(),
+        new EbuilderOptionsGetOperation(),
+        new EbuilderMappingGetOperation(),
+        new EbuilderBrowserResolveOperation(),
+        new EbuilderOpenapiReadOperation('detail'),
+        new EbuilderOpenapiReadOperation('query'),
+        new EbuilderOpenapiReadOperation('count'),
+        new EbuilderOpenapiPrepareOperation('add'),
+        new EbuilderOpenapiApplyOperation('add'),
+        new EbuilderOpenapiPrepareOperation('update'),
+        new EbuilderOpenapiApplyOperation('update'),
+        new EbuilderOpenapiPrepareOperation('delete'),
+        new EbuilderOpenapiApplyOperation('delete'),
+        new EbuilderCustomReadOperation('detail'),
+        new EbuilderCustomReadOperation('query'),
+        new EbuilderCustomReadOperation('count'),
+        new EbuilderCustomPrepareOperation('add'),
+        new EbuilderCustomApplyOperation('add'),
+        new EbuilderCustomPrepareOperation('update'),
+        new EbuilderCustomApplyOperation('update'),
+        new EbuilderCustomPrepareOperation('delete'),
+        new EbuilderCustomApplyOperation('delete'),
+    ];
+    const registry = new Map();
+    for (const handler of handlers) {
+        if (registry.has(handler.name))
+            throw new Error(`duplicate ebuilder-form operation handler: ${handler.name}`);
+        registry.set(handler.name, handler);
+    }
+    for (const contract of ebuilderFormOperations) {
+        if (!registry.has(contract.name))
+            throw new Error(`missing ebuilder-form operation handler: ${contract.name}`);
+    }
+    return registry;
+}
+const registry = buildRegistry();
+export function getEbuilderFormOperation(operation) {
+    const handler = registry.get(operation);
+    if (!handler) {
+        throw ebuilderValidationError('operation_unknown', `eBuilder 表单不支持操作：${operation}`);
+    }
+    return handler;
+}