weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/hrm/operations/org.js

@@ -0,0 +1,110 @@
+import { hrmValidationError } from '../errors.js';
+import { READ, SCHEMA_ID, SCHEMA_PAGE, hrmSuccess, schemaOf, } from './types.js';
+import { browserBaseBody, orgLink, toNumber, toPositiveInt, toStringIdList, } from './shared.js';
+const ORG_TYPES = ['subcompany', 'department'];
+/**
+ * 组织浏览接口（分部 subcompany / 部门 department）统一入口。
+ * 两者 Body 结构一致，仅父级条件键不同：
+ *   - department 支持 parent（上级部门）/ subcompany（上级分部）
+ *   - subcompany 支持 supSubDepartment（上级分部）
+ */
+const orgQuery = {
+    name: 'hrm.org.query',
+    resource: 'org',
+    method: 'org.query',
+    action: 'hrm.org.query',
+    summary: '按名称/编号/上级组织查询分部或部门（type 区分；不传 type 时默认部门，可用 type 切分部分部）',
+    risk: READ,
+    inputSchema: schemaOf({
+        type: { type: 'string', enum: [...ORG_TYPES], description: 'subcompany 分部 / department 部门；不传默认 department' },
+        name: { type: 'string', description: '名称（模糊包含匹配）' },
+        code: { type: 'string', description: '编号（模糊包含匹配）' },
+        parent: { type: 'array', items: SCHEMA_ID, description: '上级部门 id 数组（部门挂在部门下，department）' },
+        subcompany: { type: 'array', items: SCHEMA_ID, description: '上级分部 id 数组（部门挂在分部下，department）' },
+        supSubDepartment: { type: 'array', items: SCHEMA_ID, description: '上级分部 id 数组（分部挂在分部下，subcompany）' },
+        ...SCHEMA_PAGE,
+    }),
+    handler: async (args, { host }) => {
+        const type = args.type === undefined ? 'department' : String(args.type);
+        if (!ORG_TYPES.includes(type)) {
+            throw hrmValidationError('enum_invalid', `type 取值必须是 ${ORG_TYPES.join(' / ')} 之一`);
+        }
+        const name = args.name === undefined ? '' : String(args.name).trim();
+        const code = args.code === undefined ? '' : String(args.code).trim();
+        const parentIds = toStringIdList(args.parent, 'parent');
+        const subcompanyIds = toStringIdList(args.subcompany, 'subcompany');
+        const supSubDepartmentIds = toStringIdList(args.supSubDepartment, 'supSubDepartment');
+        const hasText = name !== '' || code !== '';
+        const hasOrg = Boolean(parentIds?.length || subcompanyIds?.length || supSubDepartmentIds?.length);
+        if (!hasText && !hasOrg) {
+            throw hrmValidationError('empty_condition', '组织查询必须携带至少一个收敛条件：name / code / parent / subcompany / supSubDepartment');
+        }
+        const formDatas = {};
+        if (name)
+            formDatas.name = [{ nameCondition: { id: 'in', content: '包含', disabled: false }, name }];
+        if (code)
+            formDatas.code = [{ codeCondition: { id: 'in', content: '包含', disabled: false }, code }];
+        if (parentIds?.length) {
+            formDatas.parent = [{ parentCondition: { id: 'eq', content: '等于', disabled: false }, parent: parentIds.map((id) => ({ id })) }];
+        }
+        if (subcompanyIds?.length) {
+            formDatas.subcompany = [{ subcompanyCondition: { id: 'eq', content: '等于', disabled: false }, subcompany: subcompanyIds.map((id) => ({ id })) }];
+        }
+        if (supSubDepartmentIds?.length) {
+            formDatas.supSubDepartment = [{ supSubDepartmentCondition: { id: 'eq', content: '等于', disabled: false }, supSubDepartment: supSubDepartmentIds.map((id) => ({ id })) }];
+        }
+        const body = {
+            ...browserBaseBody(),
+            virtualType: 'ALL',
+            cmd: 'list',
+            formDatas,
+            quickSearchDatas: {},
+            type: 'and',
+            stopDepartment: false,
+        };
+        // 组织浏览接口（subcompany/department）后端要求 current/pageSize 非空，
+        // 不传会 500（`current is null`），故与 meta 默认值一致地补齐默认分页。
+        const current = toPositiveInt(args.current, 'current') ?? 1;
+        const pageSize = toNumber(args.pageSize, 'pageSize') ?? 200;
+        body.current = current;
+        body.pageSize = pageSize;
+        const path = type === 'subcompany'
+            ? '/api/hrm/common/browser/data/subcompany'
+            : '/api/hrm/common/browser/data/department';
+        const resp = await host.request({ method: 'POST', path, body });
+        const d = resp?.data ?? {};
+        const rawRows = Array.isArray(d.data) ? d.data : [];
+        const session = await host.getSession();
+        const baseUrl = session.baseUrl.replace(/\/+$/, '');
+        const rows = rawRows.map((r) => ({ ...r, link: orgLink(baseUrl, r.id) }));
+        return hrmSuccess('hrm.org.query', { rows, total: Number(d.total ?? rows.length), type }, { current, pageSize });
+    },
+};
+const orgDetail = {
+    name: 'hrm.org.detail',
+    resource: 'org',
+    method: 'org.detail',
+    action: 'hrm.org.detail',
+    summary: '按组织节点 id 取部门/分部详情表单（类型由服务端按记录自动判断；含全路径 fullPath 与人员统计）',
+    risk: READ,
+    inputSchema: schemaOf({ id: SCHEMA_ID }, { required: ['id'] }),
+    handler: async (args, { host }) => {
+        const id = String(args.id).trim();
+        if (!id)
+            throw hrmValidationError('id_required', 'id 必填');
+        const session = await host.getSession();
+        const baseUrl = session.baseUrl.replace(/\/+$/, '');
+        const resp = await host.request({
+            method: 'GET',
+            path: '/api/bs/hrm/organization/getForm',
+            query: { id, readOnly: true, includeSub: true, quote: true, isMobile: false },
+            headers: { Referer: `${baseUrl}/sp/hrm/orgCard/${id}` },
+        });
+        const data = resp?.data ?? {};
+        return hrmSuccess('hrm.org.detail', { ...data, link: orgLink(baseUrl, id) });
+    },
+};
+export const hrmOrgOperations = [
+    orgQuery,
+    orgDetail,
+];

package/dist/shortcuts/hrm/operations/position.js

@@ -0,0 +1,176 @@
+import { hrmValidationError } from '../errors.js';
+import { READ, SCHEMA_ID, hrmSuccess, schemaOf, } from './types.js';
+import { positionLink, toNumber, } from './shared.js';
+/** 岗位浏览按钮 formDatas 7 字段默认算子声明（录制原样；快捷搜索时保持占位）。 */
+function positionFormDatas() {
+    const d = {};
+    for (const f of ['name', 'full_name', 'code', 'parent', 'department', 'jobsetid', 'grade_id']) {
+        d[f] = [{ [`${f}Opt`]: { id: 'in', content: '包含', disabled: false } }];
+    }
+    return d;
+}
+/** 岗位浏览按钮轻量行。 */
+function formatPosRow(r, baseUrl) {
+    return {
+        id: r.id,
+        name: r.name || r.content || '',
+        code: r.code || '',
+        title: r.title || '',
+        leaf: r.leaf !== false,
+        link: positionLink(baseUrl, r.id),
+    };
+}
+/** 岗位批量列表（queryListByOrgTree）结构化行。 */
+function formatPosListItem(r, baseUrl) {
+    return {
+        id: r.id,
+        name: r.name,
+        fullName: r.fullName || '',
+        code: r.code || '',
+        parent: r.parent || '',
+        parentId: r.parentId || '',
+        department: r.department || '',
+        userCount: r.userCount || '0',
+        partTimeCount: r.partTimeCount || '0',
+        cancelStatus: r.cancelStatus,
+        jobsetid: r.jobsetid || '',
+        link: positionLink(baseUrl, r.id),
+    };
+}
+const positionQuery = {
+    name: 'hrm.position.query',
+    resource: 'position',
+    method: 'position.query',
+    action: 'hrm.position.query',
+    summary: '按名称/编号查岗位（快捷搜索名称编号合一；显式 name/code 走高级条件）',
+    risk: READ,
+    inputSchema: schemaOf({
+        keyword: { type: 'string', description: '快捷搜索关键词，名称与编号合一匹配' },
+        name: { type: 'string', description: '岗位名称（包含匹配）' },
+        code: { type: 'string', description: '岗位编号（精确匹配）' },
+    }),
+    handler: async (args, { host }) => {
+        const name = args.name === undefined ? '' : String(args.name).trim();
+        const code = args.code === undefined ? '' : String(args.code).trim();
+        const keyword = args.keyword === undefined ? '' : String(args.keyword).trim();
+        if (!name && !code && !keyword) {
+            throw hrmValidationError('empty_condition', '岗位查询必须携带至少一个收敛条件：keyword 或 name / code');
+        }
+        const formDatas = positionFormDatas();
+        const quickSearchDatas = {};
+        if (name) {
+            formDatas.name = [{ nameOpt: { id: 'in', content: '包含', disabled: false } }, { nameInput: name }];
+        }
+        else if (code) {
+            formDatas.code = [{ codeOpt: { id: 'eq', content: '等于', disabled: false } }, { codeInput: code }];
+        }
+        else {
+            quickSearchDatas.name = keyword;
+        }
+        const resp = await host.request({
+            method: 'POST',
+            path: '/api/app/hrm/common/browser/data/position',
+            body: { cmd: 'list', current: 1, pageSize: 200, formDatas, quickSearchDatas, type: 'and' },
+        });
+        const d = resp?.data ?? {};
+        const rawRows = Array.isArray(d.data) ? d.data : [];
+        const session = await host.getSession();
+        const baseUrl = session.baseUrl.replace(/\/+$/, '');
+        const rows = rawRows.map((r) => formatPosRow(r, baseUrl));
+        return hrmSuccess('hrm.position.query', { rows, total: Number(d.total ?? rows.length) });
+    },
+};
+const positionDetail = {
+    name: 'hrm.position.detail',
+    resource: 'position',
+    method: 'position.detail',
+    action: 'hrm.position.detail',
+    summary: '按岗位 id 取岗位详情表单（只读 type=info，含职务/职级名称）',
+    risk: READ,
+    inputSchema: schemaOf({ id: SCHEMA_ID }, { required: ['id'] }),
+    handler: async (args, { host }) => {
+        const id = String(args.id).trim();
+        if (!id)
+            throw hrmValidationError('id_required', 'id 必填');
+        const session = await host.getSession();
+        const baseUrl = session.baseUrl.replace(/\/+$/, '');
+        const resp = await host.request({
+            method: 'GET',
+            path: '/api/bs/hrm/post/getEditOrAddPostForm',
+            query: { id, type: 'info' },
+            headers: { Referer: `${baseUrl}/sp/hrm/positionCard/${id}` },
+        });
+        const data = resp?.data ?? {};
+        return hrmSuccess('hrm.position.detail', { ...data, link: positionLink(baseUrl, id) });
+    },
+};
+const positionList = {
+    name: 'hrm.position.list',
+    resource: 'position',
+    method: 'position.list',
+    action: 'hrm.position.list',
+    summary: '按组织/名称/编号批量查询岗位（岗位地址簿，一次性 + 自动翻页；无过滤需显式 all=true）',
+    risk: READ,
+    inputSchema: schemaOf({
+        org: SCHEMA_ID,
+        name: { type: 'string', description: '岗位名称过滤（与 code 二选一）' },
+        code: { type: 'string', description: '岗位编号过滤（与 name 二选一）' },
+        all: { type: 'boolean', description: '显式确认全量拉取（无 org/name/code 过滤时必填 true）' },
+        pageSize: SCHEMA_ID,
+    }),
+    handler: async (args, { host }) => {
+        const hasFilter = args.org !== undefined || args.name !== undefined || args.code !== undefined;
+        if (!hasFilter && args.all !== true) {
+            throw hrmValidationError('full_pull_blocked', '禁止无条件全量拉取岗位（当前环境岗位可达数千条）。请提供 org（组织 id）或 name / code 过滤；确需全量请显式传 all=true');
+        }
+        const body = {
+            moduleType: 'positionAddressBook',
+            leftOrgId: args.org !== undefined ? String(args.org) : '',
+            tableType: 'none',
+            isContainBlock: '0',
+            includeSub: true,
+            saCondition: {
+                name: [{ name_condition: 'in' }],
+                fullName: [{ fullName_condition: 'in' }],
+                code: [{ code_condition: 'in' }],
+                department: [{ department_condition: 'in' }],
+            },
+            saMatchType: 'and',
+        };
+        if (args.name !== undefined || args.code !== undefined) {
+            body.keyword = String(args.name ?? args.code);
+            body.keywordMatchFieldList = args.name !== undefined ? ['name'] : ['code'];
+        }
+        else {
+            body.keyword = '';
+            body.keywordMatchFieldList = [];
+        }
+        const pageSize = toNumber(args.pageSize, 'pageSize') ?? 100;
+        // 翻页收集：循环 current 直到累计行数 >= total 或空行；加安全预算防死循环。
+        const collected = [];
+        let total = 0;
+        const maxPages = 500;
+        for (let current = 1; current <= maxPages; current++) {
+            const resp = await host.request({
+                method: 'POST',
+                path: '/api/bs/hrm/position/queryListByOrgTree',
+                body: { ...body, current, pageSize },
+            });
+            const d = resp?.data ?? {};
+            const rows = Array.isArray(d.data) ? d.data : [];
+            collected.push(...rows);
+            total = Number(d.total ?? total);
+            if (!rows.length || collected.length >= total)
+                break;
+        }
+        const session = await host.getSession();
+        const baseUrl = session.baseUrl.replace(/\/+$/, '');
+        const list = collected.map((r) => formatPosListItem(r, baseUrl));
+        return hrmSuccess('hrm.position.list', { rows: list, total: total || list.length }, { pageSize });
+    },
+};
+export const hrmPositionOperations = [
+    positionQuery,
+    positionDetail,
+    positionList,
+];

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

@@ -0,0 +1,33 @@
+import { hrmValidationError } from '../errors.js';
+import { hrmEmployeeOperations } from './employee.js';
+import { hrmOrgOperations } from './org.js';
+import { hrmPositionOperations } from './position.js';
+function buildRegistry() {
+    const registry = new Map();
+    const definitions = [
+        ...hrmEmployeeOperations,
+        ...hrmOrgOperations,
+        ...hrmPositionOperations,
+    ];
+    for (const definition of definitions) {
+        if (registry.has(definition.name)) {
+            throw new Error(`duplicate hrm operation: ${definition.name}`);
+        }
+        registry.set(definition.name, definition);
+    }
+    return registry;
+}
+const hrmOperationRegistry = buildRegistry();
+export function hrmOperationDefinitions() {
+    return [...hrmOperationRegistry.values()];
+}
+export function getHrmOperation(operation) {
+    const definition = hrmOperationRegistry.get(operation);
+    if (!definition) {
+        throw hrmValidationError('operation_unknown', `组织管理不支持操作：${operation}`);
+    }
+    return definition;
+}
+export function hasHrmOperation(operation) {
+    return hrmOperationRegistry.has(operation);
+}

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

@@ -0,0 +1,143 @@
+import { hrmValidationError } from '../errors.js';
+/** 原型污染防护：禁止出现在输入对象中的键。 */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+export function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw hrmValidationError('input_not_object', '输入必须是 JSON 对象');
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    for (const key of Object.keys(input)) {
+        if (FORBIDDEN_KEYS.has(key)) {
+            throw hrmValidationError('forbidden_key', `输入包含非法字段：${key}`);
+        }
+    }
+}
+export function toNumber(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric)) {
+        throw hrmValidationError('number_invalid', `${field} 必须是数字`);
+    }
+    return numeric;
+}
+export function toPositiveInt(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric)) {
+        throw hrmValidationError('number_invalid', `${field} 必须是数字`);
+    }
+    const truncated = Math.trunc(numeric);
+    if (truncated !== numeric || truncated <= 0) {
+        throw hrmValidationError('number_invalid', `${field} 必须是正整数`);
+    }
+    return truncated;
+}
+/** ID 归一化为字符串数组。长整型 id 一律按字符串传递，避免精度丢失。 */
+export function toStringIdList(value, field) {
+    if (value === undefined || value === null)
+        return undefined;
+    const list = Array.isArray(value) ? value : [value];
+    if (list.length === 0)
+        return undefined;
+    return list.map((item, index) => {
+        if (item === undefined || item === null || item === '') {
+            throw hrmValidationError('id_list_invalid', `${field}[${index}] 不能为空`);
+        }
+        const text = String(item);
+        if (!/^\d+$/.test(text)) {
+            throw hrmValidationError('id_list_invalid', `${field}[${index}] 必须是数字 ID`);
+        }
+        return text;
+    });
+}
+export function pickDefined(value, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (value[key] !== undefined)
+            result[key] = value[key];
+    }
+    return result;
+}
+/** 移除值为 undefined 的键，避免把空值写进请求体。 */
+export function compact(body) {
+    for (const key of Object.keys(body)) {
+        if (body[key] === undefined)
+            delete body[key];
+    }
+    return body;
+}
+/** 校验枚举取值。 */
+export function assertEnum(value, allowed, field) {
+    const text = typeof value === 'string' ? value : String(value);
+    if (!allowed.includes(text)) {
+        throw hrmValidationError('enum_invalid', `${field} 取值必须是 ${allowed.join(' / ')} 之一`);
+    }
+    return text;
+}
+/** 通用「浏览按钮」请求体固定字段（HRM browser/data 接口录制原样）。 */
+export function browserBaseBody() {
+    return {
+        browserMultiple: true,
+        authWecahtBook: false,
+        wxDepNeedConvertCount: 0,
+        wxEmpNeedConvertCount: 0,
+        wxTotalNeedConvertCount: 0,
+    };
+}
+/** 详情页卡片链接（SPA 页面路由，非 API；baseUrl 取自会话，禁止写死域名）。 */
+export function personLink(baseUrl, id) {
+    return `${baseUrl}/sp/hrm/profileInfo/${String(id)}`;
+}
+export function orgLink(baseUrl, id) {
+    return `${baseUrl}/sp/hrm/orgCard/${String(id)}`;
+}
+export function positionLink(baseUrl, id) {
+    return `${baseUrl}/sp/hrm/positionCard/${String(id)}`;
+}
+/**
+ * 员工浏览接口字段自动推断（与 hrm-cli.mjs 一致）：
+ *   @ → 邮箱；11 位纯数字 → 手机；纯数字或字母开头含数字 → 工号；其余 → 姓名。
+ */
+export function inferEmployeeField(target) {
+    if (/@/.test(target))
+        return { key: 'email', value: target };
+    if (/^\d{11}$/.test(target))
+        return { key: 'mobile', value: target };
+    if (/^\d+$/.test(target) || /^[A-Za-z][A-Za-z0-9]*\d[A-Za-z0-9]*$/.test(target)) {
+        return { key: 'job_num', value: target };
+    }
+    return { key: 'username', value: target };
+}
+/**
+ * 按部门名称精确定位部门节点 id（部门浏览接口 name 条件 eq）。
+ * 未找到抛 dept_not_found，重名抛 dept_ambiguous（要求改用 id）。
+ */
+export async function resolveDepartmentIdByName(host, name) {
+    const resp = await host.request({
+        method: 'POST',
+        path: '/api/hrm/common/browser/data/department',
+        body: {
+            ...browserBaseBody(),
+            virtualType: 'ALL',
+            cmd: 'list',
+            current: 1,
+            pageSize: 200,
+            formDatas: { name: [{ nameCondition: { id: 'eq', content: '等于', disabled: false }, name }] },
+            quickSearchDatas: {},
+            type: 'and',
+            stopDepartment: false,
+        },
+    });
+    const rows = resp?.data?.data ?? [];
+    if (rows.length === 0) {
+        throw hrmValidationError('dept_not_found', `未找到部门：${name}（请确认部门名称）`);
+    }
+    if (rows.length > 1) {
+        throw hrmValidationError('dept_ambiguous', `部门重名（${rows.length} 个候选）：${rows.map((x) => x.name).join('、')}，请改用部门 id`);
+    }
+    return rows[0];
+}

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

@@ -0,0 +1,23 @@
+export const READ = 'read';
+export function hrmSuccess(action, data, meta) {
+    const payload = { ok: true, action, data };
+    if (meta && Object.keys(meta).length > 0)
+        payload.meta = meta;
+    return payload;
+}
+/** 构造「对象类型 + 严格禁止额外字段」的 JSON Schema。 */
+export function schemaOf(properties, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(options.required?.length ? { required: options.required } : {}),
+        ...(options.description ? { description: options.description } : {}),
+    };
+}
+export const SCHEMA_ID = { oneOf: [{ type: 'integer' }, { type: 'string', pattern: '^\\d+$' }] };
+export const SCHEMA_ID_LIST = { type: 'array', items: SCHEMA_ID };
+export const SCHEMA_PAGE = {
+    current: SCHEMA_ID,
+    pageSize: SCHEMA_ID,
+};

package/dist/shortcuts/hrm/operations.js

@@ -0,0 +1,19 @@
+import { getHrmOperation } from './operations/registry.js';
+import { assertNoForbiddenKeys, asObject } from './operations/shared.js';
+export async function executeHrmOperation(operation, rawInput, context) {
+    const definition = getHrmOperation(operation);
+    const input = asObject(rawInput);
+    assertNoForbiddenKeys(input);
+    const host = {
+        request(request) {
+            return context.host.request({
+                ...request,
+                operation: request.operation || operation,
+            });
+        },
+        getSession() {
+            return context.host.getSession();
+        },
+    };
+    return definition.handler(input, { ...context, host });
+}

package/dist/shortcuts/index.js

@@ -1,4 +1,24 @@
+import { archiveShortcut } from './archive/index.js';
+import { calendarShortcut } from './calendar/index.js';
+import { ehrShortcut } from './ehr/index.js';
+import { esbShortcut } from './esb/index.js';
+import { fnaShortcut } from './fna/index.js';
+import { hrmShortcut } from './hrm/index.js';
 import { invoiceShortcut } from './invoice/index.js';
+import { mailShortcut } from './mail/index.js';
+import { planShortcut } from './plan/index.js';
+import { jiuchuanhuiShortcut } from './jiuchuanhui/index.js';
+import { assetShortcut } from './asset/index.js';
 export const builtinShortcuts = [
     invoiceShortcut,
+    ehrShortcut,
+    archiveShortcut,
+    calendarShortcut,
+    fnaShortcut,
+    hrmShortcut,
+    mailShortcut,
+    planShortcut,
+    esbShortcut,
+    jiuchuanhuiShortcut,
+    assetShortcut,
 ];