@xbongbong/xbbcli 2.0.0

package/workorderproductlist.js

@@ -0,0 +1,159 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
+const WORK_ORDER_PRODUCT_LIST_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/workOrder/productList';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+let lastPagination = null;
+
+function readConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function getRuntimeConfig() {
+  const config = readConfig();
+  return {
+    corpid: String(config.corpid || '').trim(),
+    token: String(config.token || '').trim(),
+    baseUrl: String(config.baseurl || DEFAULT_BASE_URL).trim(),
+    userId: String(config.userId || '').trim(),
+  };
+}
+
+function buildApiUrl(baseUrl, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function buildPayload(kwargs, corpid) {
+  const payload = {
+    dataId: Number(kwargs.dataId || 0),
+    corpid,
+    page: Number(kwargs.page || 1),
+    pageSize: Number(kwargs.pageSize || 20),
+  };
+
+  if (kwargs.userId) {
+    payload.userId = String(kwargs.userId);
+  }
+
+  return payload;
+}
+
+function getValidationError(payload, token) {
+  if (!payload.dataId) {
+    return { code: 'NO_DATAID', msg: '缺少 --dataId' };
+  }
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+
+  return null;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    rank: '',
+    text_1: '',
+    text_3: '',
+    num_1: '',
+    num_3: '',
+    businessProductId: '',
+    text_8: '',
+    code,
+    msg,
+  }];
+}
+
+function makeSuccessRows(list) {
+  return list.map((item, index) => ({
+    rank: index + 1,
+    text_1: item.text_1 || '',
+    text_3: item.text_3 || '',
+    num_1: item.num_1 || '',
+    num_3: item.num_3 || '',
+    businessProductId: item.businessProductId || '',
+    text_8: item.text_8 || '',
+    code: '',
+    msg: '',
+  }));
+}
+
+cli({
+  site: 'xbb',
+  name: 'workorderproductlist',
+  description: '工单配件接口（businessType: 2301）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', type: 'int', help: '工单id（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'page', type: 'int', default: 1, help: '页码' },
+    { name: 'pageSize', type: 'int', default: 20, help: '每页数量' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['rank', 'text_1', 'text_3', 'num_1', 'num_3', 'businessProductId', 'text_8', 'code', 'msg'],
+  footerExtra: () => (lastPagination ? `totalCount ${lastPagination.totalCount} / totalPage ${lastPagination.totalPage}` : undefined),
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = buildPayload(kwargs, corpid);
+    const body = JSON.stringify(payload);
+
+    const validationError = getValidationError(payload, token);
+    if (validationError) {
+      return makeErrorRow(validationError.code, validationError.msg);
+    }
+
+    const sign = crypto.createHash('sha256').update(body + token).digest('hex');
+    const apiUrl = buildApiUrl(baseUrl, WORK_ORDER_PRODUCT_LIST_API_URL);
+    const headers = Object.assign({
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    }, userId ? { userId } : {});
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    }
+    const resp = await fetch(apiUrl, {
+      method: 'POST',
+      headers,
+      body,
+    });
+
+    if (!resp.ok) {
+      const responseText = await resp.text();
+      if (debug) process.stderr.write(`[debug] ResponseBody: ${responseText}\n`);
+      return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    }
+
+    const data = await resp.json();
+    lastPagination = data?.code === 1 && data?.result?.totalCount != null && data?.result?.totalPage != null
+      ? { totalCount: data.result.totalCount, totalPage: data.result.totalPage }
+      : null;
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) {
+      return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    }
+
+    const list = Array.isArray(data.result?.list) ? data.result.list : [];
+    if (!list.length) {
+      return makeErrorRow('NO_DATA', '接口成功，但 list 为空');
+    }
+
+    return makeSuccessRows(list);
+  },
+});

package/worktimerecorddetail.js

@@ -0,0 +1,157 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
+const WORK_TIME_RECORD_DETAIL_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/workTimeRecord/detail';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+
+function readConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function getRuntimeConfig() {
+  const config = readConfig();
+  return {
+    corpid: String(config.corpid || '').trim(),
+    token: String(config.token || '').trim(),
+    baseUrl: String(config.baseurl || DEFAULT_BASE_URL).trim(),
+    userId: String(config.userId || '').trim(),
+  };
+}
+
+function buildApiUrl(baseUrl, apiUrl) {
+  const apiPath = new URL(apiUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function buildPayload(kwargs, corpid) {
+  const payload = {
+    dataId: Number(kwargs.dataId || 0),
+    corpid,
+  };
+
+  const userId = String(kwargs.userId || '');
+  if (userId) {
+    payload.userId = userId;
+  }
+
+  const queryFlag = String(kwargs.queryFlag ?? '');
+  if (queryFlag !== '') {
+    payload.queryFlag = Number(queryFlag);
+  }
+
+  return payload;
+}
+
+function getValidationError(payload, token) {
+  if (!payload.dataId) {
+    return { code: 'NO_DATAID', msg: '缺少 --dataId' };
+  }
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+
+  return null;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    dataId: '',
+    formId: '',
+    serialNo: '',
+    creatorId: '',
+    ownerId: '',
+    coUserId: '',
+    addTime: '',
+    updateTime: '',
+    data: '',
+    code,
+    msg,
+  }];
+}
+
+function makeSuccessRow(data) {
+  const result = data.result || {};
+  return [{
+    dataId: result.dataId || '',
+    formId: result.formId || '',
+    serialNo: result.data?.serialNo || '',
+    creatorId: result.data?.creatorId ? JSON.stringify(result.data.creatorId) : '',
+    ownerId: Array.isArray(result.data?.ownerId) ? JSON.stringify(result.data.ownerId) : (result.data?.ownerId || ''),
+    coUserId: Array.isArray(result.data?.coUserId) ? JSON.stringify(result.data.coUserId) : (result.data?.coUserId || ''),
+    addTime: result.addTime || '',
+    updateTime: result.updateTime || '',
+    data: JSON.stringify(result.data || {}),
+    code: data.code ?? '',
+    msg: data.msg || '',
+  }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'worktimerecorddetail',
+  description: '工时记录详情接口（businessType: 2301）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', type: 'int', help: '数据id（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'queryFlag', type: 'str', default: '', help: '是否查询审批数据：0非审批，1审批中，2全部' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['dataId', 'formId', 'serialNo', 'creatorId', 'ownerId', 'coUserId', 'addTime', 'updateTime', 'data', 'code', 'msg'],
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = buildPayload(kwargs, corpid);
+    const requestBody = JSON.stringify(payload);
+
+    const validationError = getValidationError(payload, token);
+    if (validationError) {
+      return makeErrorRow(validationError.code, validationError.msg);
+    }
+
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const apiUrl = buildApiUrl(baseUrl, WORK_TIME_RECORD_DETAIL_API_URL);
+    const headers = Object.assign({
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    }, userId ? { userId } : {});
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${requestBody}\n`);
+    }
+    const resp = await fetch(apiUrl, {
+      method: 'POST',
+      headers,
+      body: requestBody,
+    });
+
+    if (!resp.ok) {
+      const responseText = await resp.text();
+      if (debug) process.stderr.write(`[debug] ResponseBody: ${responseText}\n`);
+      return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    }
+
+    const data = await resp.json();
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) {
+      return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    }
+
+    return makeSuccessRow(data);
+  },
+});

package/worktimerecordlist.js

@@ -0,0 +1,199 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
+const WORK_TIME_RECORD_LIST_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/workTimeRecord/list';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+let lastPagination = null;
+
+function readConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function getRuntimeConfig() {
+  const config = readConfig();
+  return {
+    corpid: String(config.corpid || '').trim(),
+    token: String(config.token || '').trim(),
+    baseUrl: String(config.baseurl || DEFAULT_BASE_URL).trim(),
+    userId: String(config.userId || '').trim(),
+  };
+}
+
+function buildApiUrl(baseUrl, apiUrl) {
+  const apiPath = new URL(apiUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function buildConditions(kwargs) {
+  const conditions = kwargs.conditions;
+  if (typeof conditions === 'string' && conditions.trim()) {
+    return JSON.parse(conditions);
+  }
+
+  if (!(kwargs.attr && kwargs.value)) {
+    return [];
+  }
+
+  return [{
+    attr: String(kwargs.attr),
+    value: [String(kwargs.value)],
+    symbol: String(kwargs.symbol || 'equal'),
+  }];
+}
+
+function buildPayload(kwargs, corpid) {
+  const payload = {
+    corpid,
+    page: Number(kwargs.page || 1),
+    pageSize: Number(kwargs.pageSize || 20),
+  };
+
+  const userId = String(kwargs.userId || '');
+  if (userId) {
+    payload.userId = userId;
+  }
+
+  const viewApproval = String(kwargs.viewApproval ?? '');
+  if (viewApproval !== '') {
+    payload.viewApproval = Number(viewApproval);
+  }
+
+  const conditions = buildConditions(kwargs);
+  if (conditions.length) {
+    payload.conditions = conditions;
+  }
+
+  return payload;
+}
+
+function getValidationError(payload, token) {
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+
+  return null;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    rank: '',
+    dataId: '',
+    formId: '',
+    serialNo: '',
+    creatorId: '',
+    ownerId: '',
+    coUserId: '',
+    addTime: '',
+    updateTime: '',
+    data: '',
+    code,
+    msg,
+  }];
+}
+
+function makeSuccessRows(list, kwargs) {
+  return list.map((item, index) => ({
+    rank: index + 1,
+    dataId: item.dataId || '',
+    formId: item.formId || '',
+    serialNo: item.data?.serialNo || '',
+    creatorId: item.data?.creatorId || '',
+    ownerId: Array.isArray(item.data?.ownerId) ? JSON.stringify(item.data.ownerId) : (item.data?.ownerId || ''),
+    coUserId: Array.isArray(item.data?.coUserId) ? JSON.stringify(item.data.coUserId) : (item.data?.coUserId || ''),
+    addTime: item.addTime || '',
+    updateTime: item.updateTime || '',
+    data: JSON.stringify(item.data || {}),
+    code: '',
+    msg: '',
+  }));
+}
+
+cli({
+  site: 'xbb',
+  name: 'worktimerecordlist',
+  description: '工时记录列表接口（businessType: 2301）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'viewApproval', type: 'str', default: '', help: '是否查询审批中数据，1是，0否' },
+    { name: 'conditions', type: 'str', default: '', help: '条件集合 JSON 字符串' },
+    { name: 'attr', type: 'str', default: '', help: '筛选字段 attr，例如 text_1' },
+    { name: 'value', type: 'str', default: '', help: '筛选值，和 --attr 配合使用' },
+    { name: 'symbol', type: 'str', default: 'equal', help: '筛选操作符，默认 equal' },
+    { name: 'page', type: 'int', default: 1, help: '页码' },
+    { name: 'pageSize', type: 'int', default: 20, help: '每页数量（最大100）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['rank', 'dataId', 'formId', 'serialNo', 'creatorId', 'ownerId', 'coUserId', 'addTime', 'updateTime', 'data', 'code', 'msg'],
+  footerExtra: () => (lastPagination ? `totalCount ${lastPagination.totalCount} / totalPage ${lastPagination.totalPage}` : undefined),
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    let payload;
+    try {
+      payload = buildPayload(kwargs, corpid);
+    } catch (error) {
+      return makeErrorRow('INVALID_CONDITIONS', 'conditions 不是合法 JSON');
+    }
+
+    const requestBody = JSON.stringify(payload);
+
+    const validationError = getValidationError(payload, token);
+    if (validationError) {
+      return makeErrorRow(validationError.code, validationError.msg);
+    }
+
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const apiUrl = buildApiUrl(baseUrl, WORK_TIME_RECORD_LIST_API_URL);
+    const headers = Object.assign({
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    }, userId ? { userId } : {});
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${requestBody}\n`);
+    }
+    const resp = await fetch(apiUrl, {
+      method: 'POST',
+      headers,
+      body: requestBody,
+    });
+
+    if (!resp.ok) {
+      const responseText = await resp.text();
+      if (debug) process.stderr.write(`[debug] ResponseBody: ${responseText}\n`);
+      return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    }
+
+    const data = await resp.json();
+    lastPagination = data?.code === 1 && data?.result?.totalCount != null && data?.result?.totalPage != null
+      ? { totalCount: data.result.totalCount, totalPage: data.result.totalPage }
+      : null;
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) {
+      return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    }
+
+    const list = Array.isArray(data.result?.list) ? data.result.list : [];
+    if (!list.length) {
+      return makeErrorRow('NO_DATA', '接口成功，但 list 为空');
+    }
+
+    return makeSuccessRows(list, kwargs);
+  },
+});

package/xbb-registry.js

@@ -0,0 +1,21 @@
+const registry = new Map();
+
+export const Strategy = Object.freeze({ PUBLIC: 'public', PRIVATE: 'private' });
+
+export function fullName(site, name) {
+  return `${site}/${name}`;
+}
+
+export function cli(definition) {
+  const key = fullName(definition.site, definition.name);
+  registry.set(key, definition);
+  return definition;
+}
+
+export function registerCommand(definition) {
+  return cli(definition);
+}
+
+export function getRegistry() {
+  return registry;
+}