@kdcloudjs/cli 0.0.1

package/src/api/index.js

@@ -0,0 +1,99 @@
+const { error } = require('../utils/log')
+const crypto = require('crypto')
+async function getAllDataCenters (url) {
+  if (!url) return []
+  const res = []
+  try {
+    url = url.trim().replace(/\/+$/, '')
+    const resp = await fetch(`${url}/auth/getAllDatacenters.do`)
+    if (resp?.status === 200) {
+      const data = await resp.json()
+      if (Array.isArray(data) && data.length > 0) {
+        for (let i = 0; i < data.length; i++) {
+          const d = data[i]
+          if (d.accountId) {
+            res.push({
+              ...d,
+              title: d.accountName,
+              value: d.accountId
+            })
+          } else {
+            error(`⚠  数据中心返回异常，请检查url: ${url} 是否正确`)
+          }
+        }
+      } else {
+        error(`⚠  数据中心列表为空，请检查url: ${url} 是否正确`)
+      }
+    } else {
+      error(`⚠  请求失败，请检查url: ${url} 是否正确。error message: ${resp?.statusText}`)
+    }
+  } catch (e) {
+    error(`⚠  请求失败，请检查url: ${url} 是否正确。error message: ${e?.message}`)
+  }
+  return res
+}
+
+async function getAccessToken (url, params) {
+  if (!url) return {}
+  let res = {}
+  try {
+    // 构造请求体
+    const body = {
+      client_id: params.client_id,
+      client_secret: params.client_secret,
+      username: params.username,
+      accountId: params.accountId,
+      language: 'zh_CN',
+      nonce: crypto.randomBytes(8).toString('hex'),
+      timestamp: `${Date.now()}`
+    }
+    url = url.trim().replace(/\/+$/, '')
+    const resp = await fetch(`${url}/kapi/oauth2/getToken`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body)
+    })
+    if (resp?.status === 200) {
+      const respData = await resp.json()
+      if (respData?.status) {
+        res = respData?.data || {}
+      } else {
+        error(`⚠  获取access_token失败，请检查url、client_id、client_secret、username是否正确。errormessage: ${respData?.message}`)
+      }
+    } else {
+      error(`⚠  获取access_token失败，请检查url、client_id、client_secret、username是否正确, response status: ${resp?.status}`)
+    }
+  } catch (e) {
+    error(`⚠  获取access_token失败，请检查url、client_id、client_secret、username是否正确。error message: ${e?.message}`)
+  }
+  return res
+}
+
+async function getIsv (url, access_token) {
+  if (!url || !access_token) return {}
+  let res = {}
+  const baseUrl = url.trim().replace(/\/+$/, '')
+  const isvUrl = `${baseUrl}/kapi/v2/mdl/kwcisv`
+  try {
+    const resp = await fetch(isvUrl, {
+      method: 'GET',
+      headers: { 'Content-Type': 'application/json', access_token }
+    })
+
+    if (resp.status === 200) {
+      const respData = await resp.json()
+      if (respData?.status) {
+        res = respData?.data || {}
+      } else {
+        error(`⚠  get isv fail，pls check url and credentials info, errormessage: ${respData?.message}`)
+      }
+    } else {
+      error(`⚠  get isv fail，pls check url and credentials info, response status: ${resp?.status}`)
+    }
+  } catch (err) {
+    error(`⚠ getIsv fail。error message: ${err.message}`)
+  }
+  return res
+}
+
+module.exports = { getAllDataCenters, getAccessToken, getIsv }

package/src/api/uploader/index.js

@@ -0,0 +1,7 @@
+const { updateKwcMeta } = require('./updateKwcMeta')
+const { updatePageMeta } = require('./updatePageMeta')
+
+module.exports = {
+  updateKwcMeta,
+  updatePageMeta
+}

package/src/api/uploader/updateKwcMeta.js

@@ -0,0 +1,90 @@
+const fs = require('fs')
+const path = require('path')
+const FormData = require('form-data')
+const axios = require('axios')
+const { getAccessToken } = require('../../api')
+const { isValidUrl } = require('../../utils/validator')
+const { decrypt } = require('../../utils/crypto')
+
+module.exports.updateKwcMeta = async function updateKwcMeta(filePath, env = {}) {
+  // TODO: 调用真实接口
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`❌ 未找到文件: ${filePath}`)
+  }
+
+  const { url: backendUrl, client_id, client_secret, username, accountId, access_token } = env
+
+  // 这里accessToken可能已过期，所以如果有client_id、client_secret、username、accountId这些信息就可以重新获取一下token
+  // todo，现在先写死
+  // 获取token
+   if (!isValidUrl(backendUrl)) {
+      throw new Error('Invalid URL format:', backendUrl)
+   }
+  let token = access_token
+  if (client_id && client_secret && username && accountId) {
+    const getAccessTokenParams = {
+        client_id,
+        client_secret: decrypt(client_secret),
+        username,
+        accountId
+    }
+    const tokenData = await getAccessToken(backendUrl, getAccessTokenParams) || {}
+    token = tokenData.access_token || ''
+    if (!token) {
+        throw new Error('Failed to obtain access_token. Please check your credentials and reauthentication.')
+    } 
+  }
+
+  // 去掉 backendUrl 尾部的 /
+  const baseUrl = backendUrl.trim().replace(/\/+$/, '')
+  const url = `${baseUrl}/kapi/v2/mdl/updateKwc`
+
+  // ============ 第一阶段：文本方式上传 ============
+  try {
+    const xmlContent = fs.readFileSync(filePath, 'utf-8')
+
+    const res = await axios.post(
+      url,
+      {
+        content: xmlContent, // ✅ 将 XML 文件内容作为纯文本传输
+        filename: path.basename(filePath), // 文件名
+        forceSave: 'true'
+      },
+      {
+        headers: {
+          'Content-Type': 'application/json',
+          access_token: token
+        }
+      }
+    )
+
+    if (res.status === 200 && res.data?.status) {
+      return res
+    }
+  } catch (err) {
+    console.warn(`⚠ 文本上传失败，尝试文件上传方式: ${err.message}`)
+  }
+
+  // ============ 第二阶段：FormData 文件流上传 ============
+  try {
+    // 构造 FormData
+    const formData = new FormData()
+    formData.append('file', fs.createReadStream(filePath), {
+      filename: path.basename(filePath)
+    })
+    formData.append('forceSave', 'true')
+
+    const res = await axios.post(url, formData, {
+      headers: {
+        access_token: token, // ✅ 后端要求的 header
+        ...formData.getHeaders() // ✅ 自动补上 multipart 边界
+      }
+    })
+    if (res.status === 200 && res.data?.status) {
+      return res
+    }
+    throw new Error(`File upload failed： ${res?.data?.message || res.status}`)
+  } catch (err) {
+    throw new Error(`元数据上传失败：${err.message}`)
+  }
+}

package/src/api/uploader/updatePageMeta.js

@@ -0,0 +1,94 @@
+// const { getAccessToken } = require('../../api')
+// module.exports.updatePageMeta = async function updatePageMeta(files, env) {
+//   // TODO: 调用真实接口
+// //   console.log(files, env, 'updatePageMeta')
+// }
+const fs = require('fs')
+const path = require('path')
+const FormData = require('form-data')
+const axios = require('axios')
+const { getAccessToken } = require('../../api')
+const { isValidUrl } = require('../../utils/validator')
+const { decrypt } = require('../../utils/crypto')
+
+module.exports.updatePageMeta = async function updatePageMeta(filePath, env = {}) {
+  // TODO: 调用真实接口
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`❌ 未找到文件: ${filePath}`)
+  }
+
+  const { url: backendUrl, client_id, client_secret, username, accountId, access_token } = env
+
+  // 这里accessToken可能已过期，所以如果有client_id、client_secret、username、accountId这些信息就可以重新获取一下token
+  // todo，现在先写死
+  // 获取token
+   if (!isValidUrl(backendUrl)) {
+      throw new Error('Invalid URL format:', backendUrl)
+   }
+  let token = access_token
+  if (client_id && client_secret && username && accountId) {
+    const getAccessTokenParams = {
+        client_id,
+        client_secret: decrypt(client_secret),
+        username,
+        accountId
+    }
+    const tokenData = await getAccessToken(backendUrl, getAccessTokenParams) || {}
+    token = tokenData.access_token || ''
+    if (!token) {
+        throw new Error('Failed to obtain access_token. Please check your credentials and reauthentication.')
+    } 
+  }
+
+  // 去掉 backendUrl 尾部的 /
+  const baseUrl = backendUrl.trim().replace(/\/+$/, '')
+  const url = `${baseUrl}/kapi/v2/mdl/updatePageMeta`
+
+  // ============ 第一阶段：文本方式上传 ============
+  try {
+    const xmlContent = fs.readFileSync(filePath, 'utf-8')
+
+    const res = await axios.post(
+      url,
+      {
+        content: xmlContent, // ✅ 将 XML 文件内容作为纯文本传输
+        filename: path.basename(filePath), // 文件名
+        forceSave: 'true'
+      },
+      {
+        headers: {
+          'Content-Type': 'application/json',
+          access_token: token
+        }
+      }
+    )
+    if (res.status === 200 && res.data?.status) {
+      return res
+    }
+  } catch (err) {
+    console.warn(`⚠ 文本上传失败，尝试文件上传方式: ${err.message}`)
+  }
+
+  // ============ 第二阶段：FormData 文件流上传 ============
+  try {
+    // 构造 FormData
+    const formData = new FormData()
+    formData.append('file', fs.createReadStream(filePath), {
+      filename: path.basename(filePath)
+    })
+    formData.append('forceSave', 'true')
+
+    const res = await axios.post(url, formData, {
+      headers: {
+        access_token: token, // ✅ 后端要求的 header
+        ...formData.getHeaders() // ✅ 自动补上 multipart 边界
+      }
+    })
+    if (res.status === 200 && res.data?.status) {
+      return res
+    }
+    throw new Error(`File upload failed： ${res?.data?.message || res.status}`)
+  } catch (err) {
+    throw new Error(`元数据上传失败：${err.message}`)
+  }
+}

package/src/commands/env/auth.js

@@ -0,0 +1,8 @@
+const doAuth = require('../../actions/env/auth')
+
+module.exports = async function auth(type, options) {
+  await doAuth({
+    type,
+    ...options
+  })
+}

package/src/commands/env/create.js

@@ -0,0 +1,2 @@
+module.exports = (name, options) =>
+  require('../../actions/env/create')(name, options)

package/src/commands/env/delete.js

@@ -0,0 +1,2 @@
+module.exports = name =>
+  require('../../actions/env/remove')(name)

package/src/commands/env/index.js

@@ -0,0 +1,72 @@
+module.exports = function registerEnv(program) {
+  const env = program
+    .command('env')
+    .description('Environment management')
+
+  env
+    .command('create <name>')
+    .description('Create a new environment')
+    .option('--url <url>', 'environment url')
+    .action((name, options) =>
+      require('./create')(name, options)
+    )
+
+  env
+    .command('set')
+    .description('Set environment config')
+    .command('target-env <name>')
+    .description('Set default environment')
+    .action(name =>
+      require('./set')(name)
+    )
+
+  env
+    .command('info')
+    .description('Show current environment info')
+    .action(() =>
+      require('./info')()
+    )
+
+  env
+    .command('list')
+    .description('List all environments')
+    .action(() =>
+      require('./list')()
+    )
+
+  env
+    .command('delete <name>')
+    .description('Delete an environment')
+    .action(name =>
+      require('./delete')(name)
+    )
+
+  env
+    .command('remote [envName]')
+    .description('Open remote environment page with local debug server')
+    .requiredOption('-f, --form-id <id>', 'Form ID')
+    .action((envName, options) =>
+      require('./remote')(envName, options)
+    )
+
+  const auth = env
+    .command('auth')
+    .description('Authenticate environment')
+
+  auth
+    .command('web')
+    .description('Authenticate via Web (username/password)')
+    .option('--env <name>', 'target environment name')
+    .action((options) =>
+      require('./auth')('web', options)
+    )
+
+  auth
+    .command('openapi')
+    .description('Authenticate via OpenAPI (client credentials)')
+    .option('--env <name>', 'target environment name')
+    .action((options) =>
+      require('./auth')('openapi', options)
+    )
+  
+}

package/src/commands/env/info.js

@@ -0,0 +1,2 @@
+module.exports = () =>
+  require('../../actions/env/info')()

package/src/commands/env/list.js

@@ -0,0 +1,2 @@
+module.exports = () =>
+  require('../../actions/env/list')()

package/src/commands/env/remote.js

@@ -0,0 +1,2 @@
+module.exports = (envName, options) =>
+  require('../../actions/env/remote')(envName, options)

package/src/commands/env/set.js

@@ -0,0 +1,2 @@
+module.exports = name =>
+  require('../../actions/env/setDefault')(name)

package/src/commands/project/create.js

@@ -0,0 +1,8 @@
+const createProject = require('../../actions/project/create')
+
+module.exports = async function create(name, options) {
+  await createProject({
+    name,
+    type: options.type
+  })
+}

package/src/commands/project/deploy.js

@@ -0,0 +1,2 @@
+module.exports = (options) =>
+  require('../../actions/project/deploy')(options)

package/src/commands/project/index.js

@@ -0,0 +1,28 @@
+module.exports = function registerProject(program) {
+  const project = program
+    .command('project')
+    .description('Project management')
+
+  project
+    .command('init <name>')
+    .description('Initialize a new project')
+    .option('-s, --source <source>', 'specified repository source', 'outer')
+    .action((name, options) => require('./init')(name, options))
+
+  project
+    .command('create <name>')
+    .description('Create control or page xml')
+    .option('--type <type>', 'project type: kwc | page')
+    .action((name, options) =>
+      require('./create')(name, options)
+    )
+
+  project
+    .command('deploy')
+    .description('Deploy current project')
+    .option('-e --target-env <env>', 'specified target environment')
+    .option('-d --source-dir <dir>', 'specified source directory to deploy')
+    // .option('-f --force', 'force deploy, ignore warnings')
+    // .option('-a --all', 'deploy all metadata')
+    .action((options) => require('./deploy')(options))
+}

package/src/commands/project/init.js

@@ -0,0 +1,5 @@
+const initProject = require('../../actions/project/init')
+
+module.exports = async function init(projectName, options) {
+  await initProject({ projectName, source: options?.source })
+}

package/src/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander')
+const pkg = require('../package.json')
+const checkUpdate = require('./utils/checkUpdate')
+
+const program = new Command()
+
+checkUpdate()
+
+program
+  .name('kd')
+  .description('Kingdee CLI')
+  .version(pkg.version)
+
+program
+  .command('update')
+  .description('update kd to latest version')
+  .action(() => require('./commands/update')())
+
+require('./commands/project')(program)
+require('./commands/env')(program)
+
+program.parse(process.argv)

package/src/utils/checkUpdate.js

@@ -0,0 +1,18 @@
+const pkg = require('../../package.json')
+
+async function checkUpdate() {
+  const { default: updateNotifier } = await import('update-notifier')
+  const notifier = updateNotifier({
+    pkg,
+    updateCheckInterval: 1000 * 60 * 60 * 24 // 1 天
+  })
+
+  if (notifier.update) {
+    notifier.notify({
+      defer: false,
+      isGlobal: true
+    })
+  }
+}
+
+module.exports = checkUpdate

package/src/utils/crypto.js

@@ -0,0 +1,53 @@
+const crypto = require('crypto')
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+
+const KEY_FILE = path.join(os.homedir(), '.kd', 'secret.key')
+const ALGORITHM = 'aes-256-cbc'
+
+/**
+ * 获取加密密钥，如果不存在则自动生成并保存
+ */
+function getKey () {
+  if (!fs.existsSync(KEY_FILE)) {
+    const dir = path.dirname(KEY_FILE)
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+    const key = crypto.randomBytes(32) // 256 bit
+    fs.writeFileSync(KEY_FILE, key.toString('hex'), 'utf-8')
+    return key
+  }
+  return Buffer.from(fs.readFileSync(KEY_FILE, 'utf-8'), 'hex')
+}
+
+/**
+ * 加密文本
+ * @param {string} text - 明文
+ * @returns {string} - base64编码的密文（包含 iv）
+ */
+function encrypt (text) {
+  const key = getKey()
+  const iv = crypto.randomBytes(16) // 128 bit
+  const cipher = crypto.createCipheriv(ALGORITHM, key, iv)
+  let encrypted = cipher.update(text, 'utf8', 'base64')
+  encrypted += cipher.final('base64')
+  return iv.toString('base64') + ':' + encrypted
+}
+
+/**
+ * 解密文本
+ * @param {string} data - base64编码的密文（iv:密文）
+ * @returns {string} - 明文
+ */
+function decrypt (data) {
+  if (!data) return ''
+  const key = getKey()
+  const [ivStr, encrypted] = data.split(':')
+  const iv = Buffer.from(ivStr, 'base64')
+  const decipher = crypto.createDecipheriv(ALGORITHM, key, iv)
+  let decrypted = decipher.update(encrypted, 'base64', 'utf8')
+  decrypted += decipher.final('utf8')
+  return decrypted
+}
+
+module.exports = { encrypt, decrypt }

package/src/utils/download.js

@@ -0,0 +1,21 @@
+const download = require('download-git-repo')
+const ora = require('ora')
+const { error, success } = require('./log.js')
+
+module.exports = function downloadTemplate(repo, dest, template) {
+  const spinner = ora('downloading ...').start()
+
+  return new Promise((resolve, reject) => {
+    download(repo, dest, { clone: true }, err => {
+      if (err) {
+        spinner.fail()
+        error(`Template ${template} download failed: ${err.message || err}`)
+        reject(err)
+      } else {
+        spinner.stop()
+        success('\n✅ project created successfully！\n')
+        resolve()
+      }
+    })
+  })
+}

package/src/utils/index.js

@@ -0,0 +1,9 @@
+exports.capitalize = function (name) {
+  return name[0].toUpperCase() + name.slice(1)
+}
+
+exports.toPascalCase = function (name) {
+  return name
+    .replace(/(-\w)/g, (match) => match[1].toUpperCase()) // kebab-case to camelCase
+    .replace(/^[a-z]/, (match) => match.toUpperCase())    // first char to Upper
+}

package/src/utils/log.js

@@ -0,0 +1,20 @@
+const chalk = require('chalk')
+
+const warn = (msg) => console.log(chalk.yellow(msg))
+const error = (msg) => console.log(chalk.red(msg))
+
+const success = (msg) => console.log(chalk.green(msg))
+
+const mark = (msg) => console.log(chalk.magenta(msg))
+
+const info = (msg) => console.log(chalk.gray(msg))
+const tip  = (msg) => console.log(chalk.cyan(msg))
+
+module.exports = {
+  warn,
+  error,
+  success,
+  mark,
+  info,
+  tip
+}

package/src/utils/printTable.js

@@ -0,0 +1,28 @@
+function pad(str, len) {
+  str = String(str)
+  return str + ' '.repeat(Math.max(len - str.length, 0))
+}
+
+module.exports = function printTable(headers, rows) {
+  const colWidths = headers.map((h, i) =>
+    Math.max(
+      h.length,
+      ...rows.map(r => String(r[i] ?? '').length)
+    )
+  )
+
+  const line = headers
+    .map((h, i) => pad(h, colWidths[i]))
+    .join('  ')
+
+  console.log(line)
+  console.log(
+    colWidths.map(w => '-'.repeat(w)).join('  ')
+  )
+
+  rows.forEach(row => {
+    console.log(
+      row.map((cell, i) => pad(cell ?? '', colWidths[i])).join('  ')
+    )
+  })
+}

package/src/utils/projectConfig.js

@@ -0,0 +1,32 @@
+const fs = require('fs')
+const path = require('path')
+
+function getConfig(root) {
+  const configPath = path.join(root, '.kd', 'config.json')
+
+  if (!fs.existsSync(configPath)) {
+    throw new Error('未找到 .kd/config.json')
+  }
+
+  return JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+}
+
+function getConfigValue(root, key) {
+  const config = getConfig(root)
+
+  if (!config[key]) {
+    throw new Error(`config.json 中缺少 ${key}`)
+  }
+
+  return config[key]
+}
+
+exports.getConfig = getConfig
+
+exports.getModuleId = function (root) {
+  return getConfigValue(root, 'moduleId')
+}
+
+exports.getFramework = function (root) {
+  return getConfigValue(root, 'framework')
+}

package/src/utils/prompts.js

@@ -0,0 +1,14 @@
+const prompts = require('prompts')
+
+function safePrompts (questions) {
+  return prompts(questions, {
+    onCancel: () => {
+      console.log('\n❌ action already canceled, exiting...')
+      process.exit(0)
+    }
+  })
+}
+
+module.exports = {
+  safePrompts
+}