shoplazza-cli 1.0.13 → 1.1.1

package/lib/app/commands/config/actions/link.js

@@ -0,0 +1,189 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const inquirer = require('inquirer');
+
+const { createAppRequest, getAppListRequest, getAppConfigRequest } = require('../../../api/cli');
+const { getPartner, promptCreateOrConnect } = require('../../../services/partner');
+const { withErrorHandling } = require('../../../utils/error');
+const { selectOne } = require('../../../utils/views/select');
+const { getTomlConfigFiles, parseTomlFile, createTomlConfig } = require('../../../utils/toml');
+const { slugify } = require('../../../utils/path');
+const { successMessageRender } = require('../../../utils/views/message');
+const { configStore } = require('../../../store');
+
+// 处理 configFile 相关
+async function handleConfigFile(projectDir) {
+  // 获取所有 TOML 配置文件
+  const tomlConfigFiles = getTomlConfigFiles(projectDir);
+  let configFile;
+  let isOverwrite = false;
+  if (tomlConfigFiles.length > 0) {
+    while (true) {
+      const { rawName } = await inquirer.prompt({
+        type: 'input',
+        name: 'rawName',
+        message: 'Configuration file name:',
+        validate: (input) => (input.trim() === '' ? "Configuration file can't be empty" : true)
+      });
+      configFile = `shoplazza.app.${slugify(rawName)}.toml`;
+      let isRename = false;
+      if (fs.existsSync(path.join(projectDir, configFile))) {
+        isRename = await selectOne(
+          [
+            { name: `Yes, I'll choose a different name`, value: true },
+            { name: `No, overwrite my existing configuration file`, value: false }
+          ],
+          {
+            message: `Configuration file ${configFile} already exists. Do you want to choose a different configuration name?`,
+            autoPickSingle: false
+          }
+        );
+        isOverwrite = !isRename;
+      }
+      if (!isRename) {
+        break;
+      }
+    }
+  } else {
+    configFile = 'shoplazza.app.toml';
+  }
+
+  return { configFile, isOverwrite };
+}
+
+// 格式化 appList
+function formatAppList(appList, projectDir) {
+  const configFiles = getTomlConfigFiles(projectDir);
+  const map = configFiles.reduce((acc, configFile) => {
+    const config = parseTomlFile(configFile);
+    acc[config.client_id] = configFile;
+    return acc;
+  }, {});
+
+  return appList.map((app) => {
+    return {
+      ...app,
+      configFile: map[app.client_id] || ''
+    };
+  });
+}
+
+// 成功提示
+function successTips({ configFile, appName }) {
+  successMessageRender(`${chalk.bold(`${configFile} is now linked to "${appName}" on Shoplazza`)}
+    
+Using ${configFile} as your default config.
+
+Next steps
+  • Make updates to ${configFile} in your local project
+  • To update your config, run ${chalk.hex('#d079f8')('`shoplazza app deploy`')}`);
+}
+
+async function linkAction(options) {
+  const { path: argPath = '.', clientId: argClientId } = options;
+
+  // 项目目录
+  const projectDir = path.resolve(argPath);
+
+  if (!fs.existsSync(projectDir)) {
+    throw new Error(`path not found: ${projectDir}`);
+  }
+
+  // 选取 partner
+  const partner = await getPartner();
+
+  // 获取 app
+  const appListRes = await getAppListRequest(partner.id);
+
+  // 判断 创建 还是 链接
+  const isCreate = argClientId ? false : await promptCreateOrConnect(appListRes);
+
+  if (isCreate) {
+    // 创建
+    const appName = await inquirer
+      .prompt({
+        type: 'input',
+        name: 'app_name',
+        message: 'App name:',
+        validate: (input) => (input.trim() === '' ? "App name can't be empty" : true)
+      })
+      .then((r) => r.app_name);
+
+    // 规范化 appName
+    const normalizedAppName = slugify(appName);
+
+    const { configFile, isOverwrite } = await handleConfigFile(projectDir);
+
+    const { app } = await createAppRequest(partner.id, {
+      app_name: normalizedAppName
+    });
+
+    if (isOverwrite) {
+      fs.rmSync(path.join(projectDir, configFile));
+    }
+
+    await createTomlConfig(path.join(projectDir, configFile), (config) => ({
+      ...config,
+      client_id: app.client_id,
+    }));
+
+    // 缓存 app 相关信息
+    configStore.setProjectConfig(projectDir, {
+      clientId: app.client_id,
+      directory: projectDir,
+      configFile
+    });
+
+    successTips({ configFile, appName: app.name });
+  } else {
+    // 链接 app
+
+    // 处理 appList
+    const formattedAppList = formatAppList(appListRes.apps, projectDir);
+    // 连接已存在的 app
+    const clientId =
+      argClientId ||
+      (await selectOne(formattedAppList, {
+        autoPickSingle: false,
+        message: 'Which existing app is this for?',
+        formatChoice: (a) => ({ name: a.name + (a.configFile ? ` (${a.configFile}) ` : ''), value: a.client_id })
+      }));
+
+    let configFile;
+    let isOverwrite = false;
+    const currentApp = formattedAppList.find((a) => a.client_id === clientId);
+    if (currentApp.configFile) {
+      configFile = currentApp.configFile;
+      isOverwrite = true;
+    } else {
+      const { configFile: newConfigFile, isOverwrite: newIsOverwrite } = await handleConfigFile(projectDir);
+      configFile = newConfigFile;
+      isOverwrite = newIsOverwrite;
+    }
+
+    const { app } = await getAppConfigRequest(partner.id, clientId);
+
+    if (isOverwrite) {
+      fs.rmSync(path.join(projectDir, configFile));
+    }
+
+    await createTomlConfig(path.join(projectDir, configFile), (config) => ({
+      ...config,
+      client_id: app.client_id,
+    }));
+
+    // 缓存 app 相关信息
+    configStore.setProjectConfig(projectDir, {
+      clientId: app.client_id,
+      directory: projectDir,
+      configFile
+    });
+
+    successTips({ configFile, appName: app.name });
+  }
+}
+
+module.exports = {
+  linkAction: withErrorHandling(linkAction)
+};

package/lib/app/commands/config/actions/use.js

@@ -0,0 +1,40 @@
+const path = require('path');
+
+const { getAppCompleteInfoRequest } = require('../../../api/cli');
+const { configStore } = require('../../../store');
+const { withErrorHandling } = require('../../../utils/error');
+const { getTomlConfigFiles, parseTomlFile } = require('../../../utils/toml');
+const { successMessageRender } = require('../../../utils/views/message');
+const { selectOne } = require('../../../utils/views/select');
+async function useAction(options) {
+  const { path: argPath = '.' } = options;
+  const projectDir = path.resolve(argPath);
+
+  const configFiles = getTomlConfigFiles(projectDir);
+  const selectedConfigFile = await selectOne(configFiles, {
+    message: 'Configuration file:',
+    formatChoice: (name) => ({
+      name,
+      value: name
+    })
+  });
+
+  if (!selectedConfigFile) {
+    throw new Error(`Couldn't find an app toml file at ${projectDir}, is this an app directory?`);
+  }
+
+  const configInfo = await parseTomlFile(selectedConfigFile);
+  const { app } = await getAppCompleteInfoRequest(configInfo.client_id);
+
+  configStore.setProjectConfig(projectDir, {
+    configFile: selectedConfigFile,
+    clientId: app.client_id,
+    directory: projectDir
+  });
+
+  successMessageRender(`Using configuration file ${selectedConfigFile}`);
+}
+
+module.exports = {
+  useAction: withErrorHandling(useAction)
+};

package/lib/app/commands/config/index.js

@@ -0,0 +1,25 @@
+const { Command } = require('commander');
+const { useCommand } = require('./use');
+const { linkCommand } = require('./link');
+const chalk = require('chalk');
+
+const configCommand = new Command('config')
+  .description('Manage app configuration')
+  .addCommand(useCommand)
+  .addCommand(linkCommand);
+
+configCommand.helpInformation = function () {
+  return `Manage app configuration.
+
+${chalk.bold('USAGE')}
+  $ shoplazza app config COMMAND
+
+${chalk.bold('COMMANDS')}
+  app config link  Fetch your app configuration from the Partner Dashboard
+  app config use   Activate an app configuration
+`;
+};
+
+module.exports = {
+  configCommand
+};

package/lib/app/commands/config/link.js

@@ -0,0 +1,11 @@
+const { Command } = require('commander');
+const { linkAction } = require('./actions/link');
+
+const linkCommand = new Command('link')
+  .option('--path <path>', 'The path to your app directory')
+  .option('--client-id <client-id>', 'The client id of your app')
+  .action(linkAction);
+
+module.exports = {
+  linkCommand
+};

package/lib/app/commands/config/use.js

@@ -0,0 +1,11 @@
+const { Command } = require('commander');
+const { useAction } = require('./actions/use');
+
+const useCommand = new Command('use')
+  .option('--path <path>', 'The path to your app directory')
+  .description('Activate an app configuration')
+  .action(useAction);
+
+module.exports = {
+  useCommand
+};

package/lib/app/commands/deploy/actions/deploy.js

@@ -0,0 +1,196 @@
+const { withErrorHandling } = require('../../../utils/error');
+const { getAppCompleteInfo } = require('../../../services/config');
+const { parseTomlFile, modifyTomlFile } = require('../../../utils/toml');
+const path = require('path');
+const glob = require('glob');
+const { getAppExtensionsRequest, generateVersionRequest, extensionDeploy } = require('../../../api/cli');
+const fs = require('fs');
+const { extensionDiff } = require('../../../services/extension-diff');
+const { getPartnerAccessToken, getStoreAccessToken } = require('../../../services/auth');
+const { upsertExtension } = require('../../../services/extension-upsert');
+const ora = require('ora');
+const { buildExtension } = require('../../../services/extension-build');
+const { useOss } = require('../../../../oss');
+const { successMessageRender, infoMessageRender } = require('../../../utils/views/message');
+const chalk = require('chalk');
+// 获取 localExtensions
+function getLocalExtensions(projectDir = process.env.APP_PROJECT_DIR) {
+  const extensionsDir = path.join(projectDir, 'extensions');
+  const extensionFiles = glob.sync(path.join(extensionsDir, '**/*.toml'));
+  const result = extensionFiles.map((extensionFile) => {
+    const extensionInfo = parseTomlFile(extensionFile);
+    return {
+      extension_id: extensionInfo.id, // 扩展ID
+      extension_name: extensionInfo.name, // 扩展名称
+      extension_type: extensionInfo.type, // 扩展类型
+      extension_version: '', // 扩展版本
+      extension_version_id: '', // 扩展版本ID
+      resource_url: '', // 资源地址
+      configPath: extensionFile, // 扩展配置文件路径
+      distPath: '' // 打包后的资源路径
+    };
+  });
+  return result;
+}
+
+// 获取 remoteExtensions
+async function getRemoteExtensions(appClientId, partnerId) {
+  const res = await getAppExtensionsRequest({ partner_id: partnerId, app_client_id: appClientId, is_dev: 1 });
+
+  return res.extensions.map((extension) => ({
+    extension_id: extension.extension_id,
+    extension_name: extension.extension_name,
+    extension_type: extension.extension_type,
+    resource_url: extension.resource_url,
+    extension_version: extension.extension_version,
+    extension_version_id: extension.extension_version_id
+  }));
+}
+
+// 生成版本
+async function generateNewVersion(partnerId, appClientId) {
+  const res = await generateVersionRequest({
+    partner_id: partnerId,
+    app_client_id: appClientId,
+    is_dev: true
+  });
+
+  const { extensions, app_version } = res;
+  const extensionVersions = extensions.reduce((acc, { extension_id, extension_version }) => {
+    return {
+      ...acc,
+      [extension_id]: extension_version
+    };
+  }, {});
+
+  return {
+    newAppVersion: app_version,
+    newExtensionVersions: extensionVersions
+  };
+}
+
+// 成功提示
+function successTips(appName, newAppVersion) {
+  successMessageRender(`New version ${appName}(${newAppVersion}) is deployed successfully`);
+}
+
+// app 信息展示
+function appInfoShow({ app, partner }) {
+  infoMessageRender(`${chalk.bold('Your app info:\n')}
+• ${'Partner:'.padEnd(10)} ${partner.business_name}
+• ${'App:'.padEnd(10)} ${app.name}`);
+}
+
+async function deployAction(options) {
+  // 获取 app 信息
+  const { app, partner, user } = await getAppCompleteInfo();
+
+  appInfoShow({ app, partner });
+
+  const localExtensions = getLocalExtensions();
+  const remoteExtensions = await getRemoteExtensions(app.client_id, partner.id);
+
+  const { newAppVersion, newExtensionVersions } = await generateNewVersion(partner.id, app.client_id);
+
+  const appAccessToken = await getPartnerAccessToken(app.client_id, app.secret);
+  const {
+    addExtensions, // 需要创建新的 extension & version
+    updateExtensions, // 需要更新 version
+    deleteExtensions // 需要删除 extension 目前不支持删除，直接传回服务端
+  } = await extensionDiff(localExtensions, remoteExtensions);
+
+  // 更新 extension 版本
+  [...updateExtensions, ...deleteExtensions].forEach((extension) => {
+    extension.extension_version = newExtensionVersions[extension.extension_id];
+  });
+
+  // 清空 app-deploy
+  fs.rmSync(path.join(process.env.APP_PROJECT_DIR, 'app-deploy'), { recursive: true, force: true });
+  fs.mkdirSync(path.join(process.env.APP_PROJECT_DIR, 'app-deploy'));
+
+  const buildExtensionResults = await Promise.all(
+    [...addExtensions, ...updateExtensions].map(async (extension) => {
+      const distPath = await buildExtension(extension);
+      extension.distPath = distPath;
+      return distPath;
+    })
+  );
+
+  // 🎯 获取动态的店铺认证信息
+  const { store_domain, access_token } = await getStoreAccessToken(app.client_id, partner.id);
+
+  // 上传资源到 OSS
+  await Promise.all(
+    [...addExtensions, ...updateExtensions].map(async (extension) => {
+      const { distPath } = extension;
+      // 🎯 使用 useOss 替换原来的上传逻辑
+      const { uploadOss } = useOss(access_token, store_domain, `✗ 未找到店铺信息。请检查app配置。`);
+      const resourceUrl = await uploadOss(distPath);
+      extension.resource_url = resourceUrl;
+    })
+  );
+
+
+  // 创建或更新 extension
+  const upsertExtensionResults = await Promise.all(
+    [...addExtensions, ...updateExtensions, ...deleteExtensions].map(async (extension) => {
+      const spinner = ora(`${extension.extension_name}(${extension.extension_version}) upserting...`).start();
+      try {
+        const res = await upsertExtension(extension, app.client_id, partner.id, appAccessToken);
+        extension.extension_id = res.extension_id;
+        extension.extension_version = res.extension_version;
+        extension.extension_version_id = res.extension_version_id;
+        spinner.succeed(`${extension.extension_name}(${extension.extension_version}) upsert success`);
+        return res;
+      } catch (error) {
+        spinner.fail(`${extension.extension_name}(${extension.extension_version}) upsert failed`);
+        throw error;
+      }
+    })
+  );
+
+
+  // 更新本地配置文件信息
+  await Promise.all(
+    [...addExtensions, ...updateExtensions].map(async (extension) => {
+      try {
+        await modifyTomlFile(extension.configPath, (config) => {
+          config.id = extension.extension_id;
+          config.name = extension.extension_name;
+          config.type = extension.extension_type;
+          return config;
+        });
+      } catch (error) {
+        throw error;
+      }
+    })
+  );
+
+  const completeExtensions = [...addExtensions, ...updateExtensions, ...deleteExtensions].map((extension) => ({
+    extension_id: extension.extension_id,
+    extension_name: extension.extension_name,
+    extension_type: extension.extension_type,
+    extension_version: extension.extension_version,
+    extension_version_id: extension.extension_version_id,
+    resource_url: extension.resource_url,
+  }));
+
+
+  const deployResponse = await extensionDeploy({
+    partner_id: partner.id,
+    app_client_id: app.client_id,
+    data: {
+      app: {
+        version: newAppVersion,
+        extensions: completeExtensions
+      }
+    }
+  });
+
+
+  successTips(app.name, newAppVersion);
+}
+
+module.exports = {
+  deployAction: withErrorHandling(deployAction)
+};

package/lib/app/commands/deploy/index.js

@@ -0,0 +1,11 @@
+const { Command } = require('commander');
+const deployCommand = new Command('deploy');
+const { deployAction } = require('./actions/deploy');
+
+deployCommand.option('--path <path>', 'The path to your app directory');
+
+deployCommand.action(deployAction);
+
+module.exports = {
+  deployCommand
+};

package/lib/app/commands/dev/actions/dev.js

@@ -0,0 +1,206 @@
+const { withErrorHandling } = require('../../../utils/error');
+const { getAppCompleteInfo } = require('../../../services/config');
+const { parseTomlFile, modifyTomlFile } = require('../../../utils/toml');
+const path = require('path');
+const glob = require('glob');
+const { getAppExtensionsRequest, extensionDev, generateVersionRequest } = require('../../../api/cli');
+const fs = require('fs');
+const { extensionDiff } = require('../../../services/extension-diff');
+const { getPartnerAccessToken, getStoreAccessToken } = require('../../../services/auth');
+const { startDevServer } = require('../../../services/devServer');
+const { upsertExtension } = require('../../../services/extension-upsert');
+const { infoMessageRender } = require('../../../utils/views/message');
+const ora = require('ora');
+const { buildExtension } = require('../../../services/extension-build');
+const chalk = require('chalk');
+const { useOss } = require('../../../../oss');
+// 获取 localExtensions
+function getLocalExtensions(projectDir = process.env.APP_PROJECT_DIR) {
+  const extensionsDir = path.join(projectDir, 'extensions');
+  const extensionFiles = glob.sync(path.join(extensionsDir, '**/*.toml'));
+  const result = extensionFiles.map((extensionFile) => {
+    const extensionInfo = parseTomlFile(extensionFile);
+    return {
+      extension_id: extensionInfo.id, // 扩展ID
+      extension_name: extensionInfo.name, // 扩展名称
+      extension_type: extensionInfo.type, // 扩展类型
+      extension_version: '', // 扩展版本
+      extension_version_id: '', // 扩展版本ID
+      resource_url: '', // 资源地址
+      configPath: extensionFile, // 扩展配置文件路径
+      distPath: '' // 打包后的资源路径
+    };
+  });
+  return result;
+}
+
+// 获取 remoteExtensions
+async function getRemoteExtensions(appClientId, partnerId) {
+  const res = await getAppExtensionsRequest({ partner_id: partnerId, app_client_id: appClientId, is_dev: 1 });
+  return res.extensions.map((extension) => ({
+    extension_id: extension.extension_id,
+    extension_name: extension.extension_name,
+    extension_type: extension.extension_type,
+    resource_url: extension.resource_url
+  }));
+}
+
+// 生成版本
+async function generateNewVersion(partnerId, appClientId) {
+  const res = await generateVersionRequest({
+    partner_id: partnerId,
+    app_client_id: appClientId,
+    is_dev: true
+  });
+
+  const { extensions, app_version } = res;
+  const extensionVersions = extensions.reduce((acc, { extension_id, extension_version }) => {
+    return {
+      ...acc,
+      [extension_id]: extension_version
+    };
+  }, {});
+
+  return {
+    newAppVersion: app_version,
+    newExtensionVersions: extensionVersions
+  };
+}
+
+// app 信息展示
+function appInfoShow({ app, partner }) {
+  infoMessageRender(`${chalk.bold('Your app info:\n')}
+• ${'Partner:'.padEnd(10)} ${partner.business_name}
+• ${'App:'.padEnd(10)} ${app.name}`);
+}
+
+async function devAction(options) {
+  // const { path: argPath = '.' } = options;
+  // 获取 app 信息
+  const { app, partner, user, configContent } = await getAppCompleteInfo();
+
+  appInfoShow({ app, partner });
+
+  const localExtensions = getLocalExtensions();
+  const remoteExtensions = await getRemoteExtensions(app.client_id, partner.id);
+
+  const appAccessToken = await getPartnerAccessToken(app.client_id, app.secret);
+
+  const { newAppVersion, newExtensionVersions } = await generateNewVersion(partner.id, app.client_id);
+
+  // 清空 app-deploy
+  fs.rmSync(path.join(process.env.APP_PROJECT_DIR, 'app-deploy'), { recursive: true, force: true });
+  fs.mkdirSync(path.join(process.env.APP_PROJECT_DIR, 'app-deploy'));
+
+  const {
+    addExtensions, // 需要创建新的 extension & version
+    updateExtensions, // 需要更新 version
+    deleteExtensions // 需要删除 extension 目前不支持删除，直接传回服务端
+  } = await extensionDiff(localExtensions, remoteExtensions);
+
+  [...updateExtensions, ...deleteExtensions].forEach((extension) => {
+    if (extension.extension_id in newExtensionVersions) {
+      extension.extension_version = newExtensionVersions[extension.extension_id];
+    }
+  });
+
+  const buildFunctionResults = await Promise.all(
+    [...addExtensions, ...updateExtensions].map(async (extension) => {
+      const distPath = await buildExtension(extension);
+      extension.distPath = distPath;
+      return distPath;
+    })
+  );
+
+  // 🎯 获取动态的店铺认证信息
+  const { store_domain, access_token } = await getStoreAccessToken(app.client_id, partner.id);
+
+  // 上传资源到 OSS
+  await Promise.all(
+    [...addExtensions, ...updateExtensions].map(async (extension) => {
+      const { distPath } = extension;
+
+      // 🎯 使用 useOss 替换原来的上传逻辑
+      const { uploadOss } = useOss(access_token, store_domain, `✗ 未找到店铺信息。请检查app配置。`);
+
+      const resourceUrl = await uploadOss(distPath);
+      extension.resource_url = resourceUrl;
+    })
+  );
+
+
+  // 创建或更新 extension
+  const upsertExtensionResults = await Promise.all(
+    [...addExtensions, ...updateExtensions, ...deleteExtensions].map(async (extension) => {
+      const spinner = ora(`${extension.extension_name}(${extension.extension_version}) upserting...`).start();
+      try {
+        const res = await upsertExtension(extension, app.client_id, partner.id, appAccessToken);
+        extension.extension_id = res.extension_id;
+        extension.extension_version = res.extension_version;
+        extension.extension_version_id = res.extension_version_id;
+        spinner.succeed(`${extension.extension_name}(${extension.extension_version}) upsert success`);
+        return res;
+      } catch (error) {
+        spinner.fail(`${extension.extension_name}(${extension.extension_version}) upsert failed`);
+        throw error;
+      }
+    })
+  );
+
+
+  // 更新本地配置文件信息
+  await Promise.all(
+    [...addExtensions, ...updateExtensions].map(async (extension) => {
+      try {
+        await modifyTomlFile(extension.configPath, (config) => {
+          config.id = extension.extension_id;
+          config.name = extension.extension_name;
+          config.type = extension.extension_type;
+          return config;
+        });
+      } catch (error) {
+        throw error;
+      }
+    })
+  );
+
+  const completeExtensions = [...addExtensions, ...updateExtensions, ...deleteExtensions].map((extension) => ({
+    extension_id: extension.extension_id,
+    extension_name: extension.extension_name,
+    extension_type: extension.extension_type,
+    extension_version: extension.extension_version,
+    extension_version_id: extension.extension_version_id,
+    resource_url: extension.resource_url
+  }));
+
+
+  const { appUrl, redirectUrl } = await startDevServer({
+    clientId: app.client_id,
+    clientSecret: app.secret,
+    scopes: configContent.scopes
+  });
+
+  // 展示 App URL 和 Redirect URL
+
+  const { install_url } = await extensionDev({
+    partner_id: partner.id,
+    app_client_id: app.client_id,
+    data: {
+      app: {
+        version: newAppVersion,
+        extensions: completeExtensions,
+        dev_app_uri: appUrl,
+        dev_redirect_uri: redirectUrl
+      }
+    }
+  });
+
+  console.log(chalk.bold('Your App URL:'), chalk.underline.green(appUrl));
+  console.log(chalk.bold('Your Redirect URL:'), chalk.underline.green(redirectUrl));
+  console.log(chalk.bold('Your Install URL:'), chalk.underline.green(install_url));
+
+}
+
+module.exports = {
+  devAction: withErrorHandling(devAction)
+};