vps-work 2.4.1 → 2.5.1

package/dist/packages/vps-work/src/commands/org-structure.js

@@ -0,0 +1,347 @@
+import { VertuError } from '../core/errors.js';
+import { imRequest } from '../core/im-client.js';
+import { attachSharedShortcutOptions, parseOptionalInt, } from './shortcut-common.js';
+function baseUrl(opts, cmd) {
+    const merged = cmd.optsWithGlobals();
+    return opts.baseUrl ?? merged.baseUrl;
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+function numberField(row, key, label) {
+    const value = row[key];
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    throw new VertuError(`组织部门数据无效：${label} 缺失或不是数字。`);
+}
+function stringField(row, key, label) {
+    const value = row[key];
+    if (typeof value === 'string') {
+        return value;
+    }
+    throw new VertuError(`组织部门数据无效：${label} 缺失或不是字符串。`);
+}
+function nullableNumberField(row, key) {
+    const value = row[key];
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    throw new VertuError(`组织部门数据无效：${key} 不是数字。`);
+}
+function nullableStringField(row, key) {
+    const value = row[key];
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    throw new VertuError(`组织部门数据无效：${key} 不是字符串。`);
+}
+export function parseOrgDepartments(payload) {
+    const data = asRecord(payload);
+    const rows = Array.isArray(data?.departments) ? data.departments : null;
+    if (!rows) {
+        throw new VertuError('Vertu 服务未返回 departments 数组。');
+    }
+    return rows.map((item) => {
+        const row = asRecord(item);
+        if (!row) {
+            throw new VertuError('组织部门数据无效：部门记录不是对象。');
+        }
+        const activeValue = row.active;
+        return {
+            department_id: numberField(row, 'department_id', 'department_id'),
+            parent_id: nullableNumberField(row, 'parent_id'),
+            name: stringField(row, 'name', 'name'),
+            complete_name: nullableStringField(row, 'complete_name'),
+            active: typeof activeValue === 'boolean' ? activeValue : true,
+            employee_count: numberField(row, 'employee_count', 'employee_count'),
+        };
+    });
+}
+export function parseOrgUsers(payload) {
+    const data = asRecord(payload);
+    const rows = Array.isArray(data?.users) ? data.users : null;
+    if (!rows) {
+        throw new VertuError('Vertu 服务未返回 users 数组。');
+    }
+    return rows.map((item) => {
+        const row = asRecord(item);
+        if (!row) {
+            throw new VertuError('组织人员数据无效：人员记录不是对象。');
+        }
+        const activeValue = row.is_active;
+        return {
+            user_id: numberField(row, 'user_id', 'user_id'),
+            login: stringField(row, 'login', 'login'),
+            employee_id: nullableNumberField(row, 'employee_id'),
+            employee_name: nullableStringField(row, 'employee_name'),
+            barcode: nullableStringField(row, 'barcode'),
+            job_title: nullableStringField(row, 'job_title'),
+            manager_user_id: nullableNumberField(row, 'manager_user_id'),
+            manager_name: nullableStringField(row, 'manager_name'),
+            department_id: nullableNumberField(row, 'department_id'),
+            department_name: nullableStringField(row, 'department_name'),
+            department_path: nullableStringField(row, 'department_path'),
+            employment_status: nullableStringField(row, 'employment_status'),
+            is_active: typeof activeValue === 'boolean' ? activeValue : true,
+        };
+    });
+}
+export function resolveOrgDepartmentPath(departments, input) {
+    const query = input.trim().toLocaleLowerCase();
+    if (!query) {
+        throw new VertuError('--department cannot be empty.');
+    }
+    const pathMatch = departments.find((department) => department.complete_name?.trim().toLocaleLowerCase() === query);
+    if (pathMatch) {
+        return pathMatch.complete_name?.trim() || pathMatch.name.trim();
+    }
+    const nameMatches = departments.filter((department) => department.name.trim().toLocaleLowerCase() === query);
+    if (nameMatches.length === 1) {
+        return nameMatches[0]?.complete_name?.trim() || nameMatches[0]?.name.trim() || input.trim();
+    }
+    if (nameMatches.length > 1) {
+        const paths = nameMatches.map((department) => department.complete_name || department.name).join('、');
+        throw new VertuError(`部门名称不唯一，请使用完整路径：${paths}`);
+    }
+    throw new VertuError(`未找到部门：${input.trim()}`);
+}
+function displayName(department) {
+    const name = department.name.trim();
+    if (name) {
+        return name;
+    }
+    return department.complete_name?.trim() || `部门 ${department.department_id}`;
+}
+function sortByDisplayName(a, b) {
+    return displayName(a).localeCompare(displayName(b), 'zh-CN');
+}
+export function buildOrgDepartmentForest(departments) {
+    const nodes = new Map();
+    for (const department of departments) {
+        nodes.set(department.department_id, {
+            ...department,
+            level: 1,
+            subtree_employee_count: department.employee_count,
+            children: [],
+        });
+    }
+    const roots = [];
+    for (const node of nodes.values()) {
+        const parent = node.parent_id === null ? undefined : nodes.get(node.parent_id);
+        if (parent) {
+            parent.children.push(node);
+        }
+        else {
+            roots.push(node);
+        }
+    }
+    const fill = (node, level) => {
+        node.level = level;
+        node.children.sort(sortByDisplayName);
+        let total = node.employee_count;
+        for (const child of node.children) {
+            total += fill(child, level + 1);
+        }
+        node.subtree_employee_count = total;
+        return total;
+    };
+    roots.sort(sortByDisplayName);
+    for (const root of roots) {
+        fill(root, 1);
+    }
+    return roots;
+}
+function cloneNode(node) {
+    return {
+        ...node,
+        children: node.children.map(cloneNode),
+    };
+}
+function matchesQuery(node, query) {
+    const haystack = [
+        node.department_id,
+        node.parent_id,
+        node.name,
+        node.complete_name,
+        node.employee_count,
+        node.subtree_employee_count,
+    ]
+        .join(' ')
+        .toLowerCase();
+    return haystack.includes(query);
+}
+function filterTree(nodes, query) {
+    if (!query) {
+        return nodes.map(cloneNode);
+    }
+    const filtered = [];
+    for (const node of nodes) {
+        const children = filterTree(node.children, query);
+        if (matchesQuery(node, query)) {
+            filtered.push(cloneNode(node));
+        }
+        else if (children.length > 0) {
+            filtered.push({ ...node, children });
+        }
+    }
+    return filtered;
+}
+function limitDepth(nodes, maxDepth) {
+    return nodes.map((node) => ({
+        ...node,
+        children: maxDepth !== null && node.level >= maxDepth ? [] : limitDepth(node.children, maxDepth),
+    }));
+}
+function flattenTree(nodes) {
+    const rows = [];
+    const walk = (items) => {
+        for (const item of items) {
+            const { children: _children, ...row } = item;
+            rows.push(row);
+            walk(_children);
+        }
+    };
+    walk(nodes);
+    return rows;
+}
+function maxDepthValue(opts) {
+    const raw = opts.maxDepth ?? '2';
+    const parsed = parseOptionalInt(raw, '--max-depth') ?? 2;
+    if (parsed < 0) {
+        throw new VertuError('--max-depth must be >= 0.');
+    }
+    return parsed === 0 ? null : parsed;
+}
+export function buildOrgStructureOutput(departments, opts = {}) {
+    const maxDepth = maxDepthValue(opts);
+    const query = opts.query?.trim().toLowerCase() || '';
+    const forest = limitDepth(filterTree(buildOrgDepartmentForest(departments), query), maxDepth);
+    if (opts.flat) {
+        const rows = flattenTree(forest);
+        return {
+            ok: true,
+            count: rows.length,
+            query: query || null,
+            max_depth: maxDepth,
+            departments: rows,
+        };
+    }
+    const rows = flattenTree(forest);
+    return {
+        ok: true,
+        count: rows.length,
+        query: query || null,
+        max_depth: maxDepth,
+        tree: forest,
+    };
+}
+function printTreePlain(nodes) {
+    const lines = [];
+    const walk = (items) => {
+        for (const node of items) {
+            const indent = '  '.repeat(Math.max(0, node.level - 1));
+            const staff = `${node.employee_count}/${node.subtree_employee_count}`;
+            lines.push(`${indent}- ${displayName(node)} (#${node.department_id}, staff ${staff})`);
+            walk(node.children);
+        }
+    };
+    walk(nodes);
+    console.log(lines.join('\n'));
+}
+function printOrgStructure(opts, out) {
+    if (opts.json !== false) {
+        console.log(JSON.stringify(out, null, 2));
+        return;
+    }
+    if ('tree' in out) {
+        printTreePlain(out.tree);
+    }
+    else {
+        for (const row of out.departments) {
+            console.log(`${'  '.repeat(Math.max(0, row.level - 1))}${row.complete_name || row.name} (#${row.department_id})`);
+        }
+    }
+    printUsersPlain(out.users);
+}
+function printUsersPlain(users) {
+    if (!users) {
+        return;
+    }
+    console.log(`\n员工名单（${users.length} 人）`);
+    const byDepartment = new Map();
+    for (const user of users) {
+        const path = user.department_path || user.department_name || '未分配部门';
+        const rows = byDepartment.get(path) ?? [];
+        rows.push(user);
+        byDepartment.set(path, rows);
+    }
+    for (const [path, rows] of [...byDepartment.entries()].sort(([a], [b]) => a.localeCompare(b, 'zh-CN'))) {
+        const names = rows
+            .map((user) => {
+            const name = user.employee_name || user.login;
+            return user.job_title ? `${name}（${user.job_title}）` : name;
+        })
+            .sort((a, b) => a.localeCompare(b, 'zh-CN'));
+        console.log(`- ${path}（${rows.length}）：${names.join('、')}`);
+    }
+}
+async function fetchOrgUsers(baseUrlValue, departmentPath) {
+    const users = new Map();
+    let page = 1;
+    let hasMore = true;
+    while (hasMore) {
+        const data = await imRequest('GET', '/v1/im/org/users', {
+            baseUrl: baseUrlValue,
+            query: {
+                department_path: departmentPath,
+                include_children: true,
+                page,
+                page_size: 500,
+            },
+        });
+        for (const user of parseOrgUsers(data)) {
+            users.set(user.user_id, user);
+        }
+        const pagination = asRecord(asRecord(data)?.pagination);
+        hasMore = pagination?.has_more === true;
+        page += 1;
+    }
+    return [...users.values()];
+}
+export function attachOrgStructureShortcut(parent, commandName, description) {
+    attachSharedShortcutOptions(parent
+        .command(commandName)
+        .description(description)
+        .option('--query <text>', '部门 ID / 名称 / 完整路径关键字')
+        .option('--department <path>', '限定部门子树；支持完整路径或唯一部门名称')
+        .option('--max-depth <n>', '最大部门层级；默认 2（一级/二级），0 表示不限', '2')
+        .option('--flat', '输出扁平部门列表而不是树', false)
+        .option('--include-users', '同时返回所选部门及下级部门的在职员工名单', false)).action(async (opts, cmd) => {
+        if (opts.query?.trim() && opts.department?.trim()) {
+            throw new VertuError('--query and --department cannot be used together.');
+        }
+        const serviceBaseUrl = baseUrl(opts, cmd);
+        const data = await imRequest('GET', '/v1/im/org/departments', { baseUrl: serviceBaseUrl });
+        const departments = parseOrgDepartments(data);
+        const departmentPath = opts.department
+            ? resolveOrgDepartmentPath(departments, opts.department)
+            : undefined;
+        const out = buildOrgStructureOutput(departments, {
+            ...opts,
+            query: departmentPath ?? opts.query,
+        });
+        if (opts.includeUsers) {
+            const users = await fetchOrgUsers(serviceBaseUrl, departmentPath);
+            out.user_count = users.length;
+            out.users = users;
+        }
+        printOrgStructure(opts, out);
+    });
+}

package/dist/packages/vps-work/src/commands/popup/index.js

@@ -0,0 +1,147 @@
+import { Command } from 'commander';
+import { VertuError } from '../../core/errors.js';
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { readStdinText, readUtf8File } from '../../utils/read-text.js';
+const HEX_COLOR = /^#[0-9a-f]{6}$/i;
+function required(value, flag, max) {
+    const normalized = value?.trim();
+    if (!normalized)
+        throw new VertuError(`${flag} 为必填。`);
+    if (normalized.length > max)
+        throw new VertuError(`${flag} 最多 ${max} 字。`);
+    return normalized;
+}
+function optionalColor(value, flag) {
+    const normalized = value?.trim();
+    if (!normalized)
+        return undefined;
+    if (!HEX_COLOR.test(normalized)) {
+        throw new VertuError(`${flag} 必须是 #RRGGBB。`);
+    }
+    return normalized.toUpperCase();
+}
+function numberInRange(value, flag, fallback, min, max) {
+    const parsed = value === undefined ? fallback : Number(value);
+    if (!Number.isFinite(parsed) || parsed < min || parsed > max) {
+        throw new VertuError(`${flag} 必须在 ${min}–${max} 之间。`);
+    }
+    return parsed;
+}
+function optionalHttpsUrl(value, flag) {
+    const normalized = value?.trim();
+    if (!normalized)
+        return undefined;
+    try {
+        const url = new URL(normalized);
+        if (url.protocol !== 'https:')
+            throw new Error('protocol');
+        return url.toString();
+    }
+    catch {
+        throw new VertuError(`${flag} 必须是 HTTPS URL。`);
+    }
+}
+export function buildPopupPayload(opts, content) {
+    if (opts.userId !== undefined && opts.login !== undefined) {
+        throw new VertuError('--user-id 和 --login 不能同时使用。');
+    }
+    let targetUserId;
+    if (opts.userId !== undefined) {
+        targetUserId = Number(opts.userId);
+        if (!Number.isSafeInteger(targetUserId) || targetUserId <= 0) {
+            throw new VertuError('--user-id 必须是正整数。');
+        }
+    }
+    const targetLogin = opts.login?.trim();
+    if (opts.login !== undefined && !targetLogin) {
+        throw new VertuError('--login 不能为空。');
+    }
+    const gradientStart = optionalColor(opts.gradientStart, '--gradient-start');
+    const gradientEnd = optionalColor(opts.gradientEnd, '--gradient-end');
+    if ((gradientStart === undefined) !== (gradientEnd === undefined)) {
+        throw new VertuError('--gradient-start 和 --gradient-end 必须同时提供。');
+    }
+    const buttonStyle = opts.buttonStyle?.trim().toLowerCase() || 'filled';
+    if (buttonStyle !== 'filled' && buttonStyle !== 'outlined') {
+        throw new VertuError('--button-style 只支持 filled 或 outlined。');
+    }
+    return {
+        ...(targetUserId === undefined ? {} : { target_user_id: targetUserId }),
+        ...(targetLogin ? { target_login: targetLogin } : {}),
+        title: required(opts.title, '--title', 120),
+        content: required(content, '--content', 4000),
+        presentation: {
+            height_factor: numberInRange(opts.height, '--height', 0.62, 0.3, 0.95),
+            background_color: optionalColor(opts.backgroundColor, '--background-color'),
+            gradient_start: gradientStart,
+            gradient_end: gradientEnd,
+            background_image_url: optionalHttpsUrl(opts.backgroundImageUrl, '--background-image-url'),
+            title_color: optionalColor(opts.titleColor, '--title-color'),
+            content_color: optionalColor(opts.contentColor, '--content-color'),
+        },
+        button: {
+            text: opts.buttonText?.trim() || '我知道了',
+            style: buttonStyle,
+            background_color: optionalColor(opts.buttonBackgroundColor, '--button-background-color'),
+            text_color: optionalColor(opts.buttonTextColor, '--button-text-color'),
+            action_url: optionalHttpsUrl(opts.buttonUrl, '--button-url'),
+        },
+        expires_in_minutes: Math.round(numberInRange(opts.expiresInMinutes, '--expires-in-minutes', 1440, 1, 10080)),
+    };
+}
+async function resolveContent(opts) {
+    if (opts.content !== undefined && opts.contentFile !== undefined) {
+        throw new VertuError('--content 和 --content-file 不能同时使用。');
+    }
+    if (opts.contentFile === '-')
+        return readStdinText();
+    if (opts.contentFile)
+        return readUtf8File(opts.contentFile);
+    return opts.content ?? '';
+}
+export function buildPopupCommand() {
+    const popup = new Command('popup').description('Agent 主动向 VPS 手机端投递一次性弹窗。');
+    popup
+        .command('+send')
+        .description('投递声明式安全弹窗；前台约 0–10 秒展示，离线时下次打开展示')
+        .option('--user-id <id>', '目标用户 ID；向他人推送需要管理员权限')
+        .option('--login <login>', '目标用户登录名；向他人推送需要管理员权限')
+        .requiredOption('--title <text>', '弹窗标题，最多 120 字')
+        .option('--content <text>', '弹窗正文，最多 4000 字')
+        .option('--content-file <path>', '从 UTF-8 文件读取正文；- 表示 stdin')
+        .option('--height <ratio>', '屏幕高度比例，0.3–0.95', '0.62')
+        .option('--background-color <#RRGGBB>', '纯色背景')
+        .option('--gradient-start <#RRGGBB>', '顶部渐变色，须与 --gradient-end 同时提供')
+        .option('--gradient-end <#RRGGBB>', '底部渐变色，须与 --gradient-start 同时提供')
+        .option('--background-image-url <https-url>', 'HTTPS 背景图地址')
+        .option('--title-color <#RRGGBB>', '标题颜色')
+        .option('--content-color <#RRGGBB>', '正文颜色')
+        .option('--button-text <text>', '按钮文字', '我知道了')
+        .option('--button-style <style>', 'filled 或 outlined', 'filled')
+        .option('--button-background-color <#RRGGBB>', '按钮背景/描边颜色')
+        .option('--button-text-color <#RRGGBB>', '按钮文字颜色')
+        .option('--button-url <https-url>', '点击按钮后打开的 HTTPS URL')
+        .option('--expires-in-minutes <number>', '未领取弹窗的有效分钟数，1–10080', '1440')
+        .option('--base-url <url>', 'Vertu 服务地址')
+        .option('--dry-run', '只打印请求，不投递')
+        .option('--no-json', '输出紧凑 JSON')
+        .action(async (opts, command) => {
+        const merged = command.optsWithGlobals();
+        const payload = buildPopupPayload(opts, await resolveContent(opts));
+        if (opts.dryRun) {
+            printImResult(opts.json, {
+                dry_run: true,
+                method: 'POST',
+                endpoint: '/v1/agent-popups',
+                body: payload,
+            });
+            return;
+        }
+        const result = await imRequest('POST', '/v1/agent-popups', {
+            baseUrl: opts.baseUrl ?? merged.baseUrl,
+            body: payload,
+        });
+        printImResult(opts.json, result);
+    });
+    return popup;
+}