shoplazza-cli 1.0.12 → 1.1.1

package/README.md

@@ -378,37 +378,37 @@ $ shoplazza theme delete [--theme]
 
 ## app
 
-### generate
+### init
 
 ```terminal
-$ shoplazza app generate extension
+$ shoplazza app init
 ```
 
-> Choose Your app type and download template.
+> Initialize a new Shoplazza app project.
 
-### build
+### generate
 
 ```terminal
-$ shoplazza app build
+$ shoplazza app generate extension
 ```
 
-> Minify css / js files and generate manifest.json and zip.
+> create a new extension.
 
-### deploy
+### dev
 
 ```terminal
-$ shoplazza app deploy extension
+$ shoplazza app dev
 ```
 
-> Deploy your zip to oss for publish.
+> choose a store to test your extension app.
 
-### pupblish
+### deploy
 
 ```terminal
-$ shoplazza app publish extension
+$ shoplazza app deploy
 ```
 
-> Choose your extension version and publish to your store.
+> deploy your extension app.
 
 ## Theme Directory
 

package/bin/shoplazza

@@ -5,14 +5,14 @@ require('../lib/check');
 const { program } = require('commander');
 const updateNotifier = require('update-notifier');
 const Sentry = require('@sentry/node');
-const Tracing = require('@sentry/tracing');
 const pkg = require('../package.json');
 const report = require('../lib/report');
 require('../lib/tracing');
 
 const { makeCheckoutCommand } = require('../lib/checkout');
-const { initThemeAppCommand } = require('../lib/app');
+const { initThemeAppCommand } = require('../lib/theme-extension');
 const { makeFunctionCommand } = require('../lib/function');
+const { makeAppCommand } = require('../lib/app');
 
 Sentry.init({
   dsn: 'https://89964605acaf4db8839f2d5237396d6c@sentry.shoplazza.com/730',
@@ -31,7 +31,7 @@ updateNotifier({ pkg }).notify({
   isGlobal: true
 });
 program.usage('[command] [options]');
-program.option('--debug <ent>', 'debug mode')
+program.option('--debug <ent>', 'debug mode');
 
 program.command('version').description('Welcome to the Shoplazza CLI').action(require('../lib/commands/version'));
 program.description('Welcome to the Shoplazza CLI').option('-v --version').action(require('../lib/commands/version'));
@@ -121,6 +121,8 @@ makeCheckoutCommand(program);
 initThemeAppCommand(program);
 // function cli
 makeFunctionCommand(program);
+// app cli
+makeAppCommand(program);
 
 program.parse(process.argv);
 !program.args.length && program.help();

package/lib/app/api/cli.js

@@ -0,0 +1,225 @@
+const { getStoreAccessToken } = require('../services/auth');
+const { cliClient } = require('../utils/request/cli');
+
+// 获取 app 列表
+function getAppListRequest(partner_id) {
+  return cliClient.get(`api/cli/partners/${partner_id}/apps`);
+}
+
+// 获取 partner 列表
+function getPartnerListRequest() {
+  return cliClient.get('api/cli/partners');
+}
+
+// 创建 app
+function createAppRequest(partner_id, params) {
+  const { app_name, app_type } = params;
+  return cliClient.post(`api/cli/partners/${partner_id}/apps`, {
+    app_name,
+    app_type
+  });
+}
+
+/**
+ * @description 获取模板 git 地址
+ * @param {string} template_type 模板类型 可选值：'app' | 'ext_func' | 'ext_thm' | 'ext_co'
+ * @returns {Promise<{data: { template_type: string, https: string }}>}
+ */
+function getTemplateGitRequest(template_type) {
+  return cliClient.get(`api/cli/template`, {
+    params: {
+      template_type
+    }
+  });
+}
+
+// 获取 app 配置
+function getAppConfigRequest(partner_id, app_client_id) {
+  return cliClient.get(`api/cli/partners/${partner_id}/apps/${app_client_id}`);
+}
+
+// app 完整信息 包括但不限配置信息
+function getAppCompleteInfoRequest(app_client_id) {
+  return cliClient.get(`api/cli/info`, {
+    params: {
+      app_client_id
+    }
+  });
+}
+
+/**
+ * 获取 OSS 上传凭证
+ * @param {Object} params
+ * @param {string} params.partnerId 开发者 id
+ * @param {string} params.appClientId app client id
+ * @param {number} params.fileSize 文件大小（字节）
+ * @param {string} params.md5 文件 md5（base64 编码）
+ * @returns {Promise<object>} OSS post_policy
+ */
+async function getPostPolicy({ partnerId, appClientId, fileSize, md5 }) {
+  return cliClient.get(`api/cli/partners/${partnerId}/apps/${appClientId}/post_policy`, {
+    params: { file_size: fileSize, md5 }
+  });
+}
+
+/**
+ * 扩展信息
+ * @typedef {Object} Extension
+ * @property {string} extension_id - 扩展 ID（必传）
+ * @property {string} extension_name - 扩展名称（必传）
+ * @property {string} extension_type - 扩展类型（必传）
+ * @property {string} extension_version - 扩展版本（必传）
+ * @property {string} resource_url - 扩展资源地址（必传）
+ */
+
+/**
+ * 应用信息
+ * @typedef {Object} AppInfo
+ * @property {Extension[]} extensions - 扩展列表
+ * @property {string} [dev_app_uri] - 内网穿透调试地址
+ * @property {string} [dev_redirect_uri] - 内网穿透回调地址
+ */
+
+/**
+ * 请求数据
+ * @typedef {Object} ExtensionDevData
+ * @property {AppInfo} app - 应用信息
+ */
+
+/**
+ * dev 启动
+ * @param {Object} params - 请求参数
+ * @param {string} params.partner_id - 合作伙伴 ID
+ * @param {string} params.app_client_id - 应用客户端 ID
+ * @param {ExtensionDevData} params.data - 请求体数据
+ * @returns {Promise<Object>} 后端返回的响应
+ */
+async function extensionDev({ partner_id, app_client_id, data }) {
+  const { access_token, store_id } = await getStoreAccessToken(app_client_id, partner_id);
+
+  return cliClient.post(
+    `api/cli/partners/${partner_id}/apps/${app_client_id}/dev`,
+    {
+      ...data,
+      store_id
+    },
+    {
+      headers: {
+        'access-token': access_token,
+        'Content-Type': 'application/json'
+      }
+    }
+  );
+}
+
+/**
+ * 请求数据
+ * @typedef {Object} ExtensionDeployData
+ * @property {Object} app - 应用信息
+ * @property {string} app.version - 版本号
+ * @property {Extension[]} app.extensions - 扩展信息
+ */
+
+/**
+ * deploy 部署
+ * @param {Object} params - 请求参数
+ * @param {string} params.partner_id - 合作伙伴 ID
+ * @param {string} params.app_client_id - 应用客户端 ID
+ * @param {ExtensionDeployData} params.data - 请求体数据
+ * @returns {Promise<Object>} 后端返回的响应
+ */
+async function extensionDeploy({ partner_id, app_client_id, data }) {
+  const { access_token, store_id } = await getStoreAccessToken(app_client_id, partner_id);
+  return cliClient.post(
+    `api/cli/partners/${partner_id}/apps/${app_client_id}/deploy`,
+    {
+      ...data,
+      store_id
+    },
+    {
+      headers: {
+        'access-token': access_token
+      }
+    }
+  );
+}
+
+/**
+ * 获取 app 某个版本的 extensions
+ * @param {string} partner_id
+ * @param {string} app_client_id
+ * @param {string} [app_version_id]
+ * @returns {Promise<Object>}
+ */
+async function getAppExtensionsRequest({ partner_id, app_client_id, app_version_id = 0, is_dev }) {
+  const appInstallCache = await getStoreAccessToken(app_client_id, partner_id);
+  return cliClient.get(`api/cli/partners/${partner_id}/apps/${app_client_id}/extension_versions`, {
+    params: {
+      app_version_id,
+      is_dev
+    },
+    headers: {
+      'access-token': appInstallCache.access_token
+    }
+  });
+}
+
+/**
+ * 生成版本
+ * @param {Object} params
+ * @param {string} params.partner_id
+ * @param {string} params.app_client_id
+ * @param {boolean} params.is_dev
+ * @returns {Promise<Object>}
+ */
+async function generateVersionRequest({ partner_id, app_client_id, is_dev }) {
+  const { access_token, store_id } = await getStoreAccessToken(app_client_id, partner_id);
+  return cliClient.get(`api/cli/partners/${partner_id}/apps/${app_client_id}/version/generate`, {
+    params: {
+      is_dev,
+      store_id
+    },
+    headers: {
+      'access-token': access_token
+    }
+  });
+}
+
+/**
+ * 获取 app 版本列表
+ * @param {Object} params
+ * @param {string} params.partner_id
+ * @param {string} params.app_client_id
+ * @param {number} params.offset
+ * @param {number} params.limit
+ * @returns {Promise<{versions: {id: number, version: string}[], has_more: boolean}>}
+ */
+
+async function getAppVersionsRequest({ partner_id, app_client_id, offset = 0, limit = 10 }) {
+  const { access_token, store_id } = await getStoreAccessToken(app_client_id, partner_id);
+
+  return cliClient.get(`api/cli/partners/${partner_id}/apps/${app_client_id}/versions`, {
+    params: {
+      offset,
+      limit
+    },
+    headers: {
+      'access-token': access_token
+    }
+  });
+}
+
+module.exports = {
+  createAppRequest,
+  getAppListRequest,
+  getPartnerListRequest,
+  getTemplateGitRequest,
+  getAppConfigRequest,
+  getAppCompleteInfoRequest,
+  getAppExtensionsRequest,
+  getPostPolicy,
+  extensionDev,
+  extensionDeploy,
+  generateVersionRequest,
+  getAppVersionsRequest
+};

package/lib/app/api/openapi.js

@@ -0,0 +1,121 @@
+const { getOpenapiClient } = require('../utils/request/openapi');
+
+/**
+ * 创建或更新主题插件
+ * @param {Object} data
+ * @param {string} [data.extension_id]
+ * @param {string} [data.title]
+ * @param {string} [data.icon]
+ * @param {string} [data.resource_url]
+ * @returns {Promise<{extension_id: string}>}
+ */
+async function upsertThemeExtensionRequest(app_client_id, partner_id, data) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.put('openapi/2020-07/theme-extensions', data);
+}
+
+/**
+ * 创建主题插件版本
+ * @param {string} app_client_id
+ * @param {string} partner_id
+ * @param {Object} data
+ * @param {string} data.extension_id
+ * @param {string} data.version
+ * @param {string} data.resource_url
+ * @returns {Promise<{extension_id: string}>}
+ */
+async function createThemeExtensionVersionRequest(app_client_id, partner_id, data) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.post('openapi/2020-07/theme-extensions/version-tasks', data);
+}
+
+/**
+ * 获取主题插件版本任务
+ * @param {string} app_client_id
+ * @param {string} partner_id
+ * @param {string} task_id
+ * @returns {Promise<{
+ *  task_id: string,
+ *  state: number,
+ *  message: string,
+ *  task_type: string
+ * }>}
+ */
+async function getThemeExtensionVersionTaskRequest(app_client_id, partner_id, task_id) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.get(`openapi/2020-07/theme-extensions/version-tasks/${task_id}`);
+}
+
+/**
+ * 创建 checkout 插件
+ * @param {string} app_client_id
+ * @param {string} partner_id
+ * @param {Object} data
+ * @param {string} data.name
+ * @param {string} data.version
+ * @param {string} data.resource_url
+ * @returns
+ */
+async function createCheckoutExtensionRequest(app_client_id, partner_id, data) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.post('openapi/checkout_extensions/create', {
+    extension: data
+  });
+}
+
+/**
+ * commit checkout 插件
+ * @param {string} app_client_id
+ * @param {string} partner_id
+ * @param {Object} data
+ * @param {string} data.name
+ * @param {string} data.version
+ * @param {string} data.extension_id
+ * @param {string} data.resource_url
+ */
+async function commitCheckoutExtensionRequest(app_client_id, partner_id, data) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.post(`openapi/checkout_extensions/commit`, {
+    extension: data
+  });
+}
+
+/**
+ * 部署 checkout 插件
+ * @param {string} app_client_id
+ * @param {string} partner_id
+* @param {Object} data
+ * @param {string} data.extension_id
+ * @param {string} data.extension_version_id
+ */
+async function deployCheckoutExtensionRequest(app_client_id, partner_id, { extension_id, extension_version_id }) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.post(`openapi/checkout_extensions/deploy`, {
+    extension: {
+      extension_id,
+      id: extension_version_id
+    }
+  });
+}
+
+async function deployThemeExtensionRequest(app_client_id, partner_id, { extension_id, extension_version_id }) {
+  const client = await getOpenapiClient(app_client_id, partner_id);
+  return client.post(`openapi/2020-07/theme-extensions/publications`, {
+    extension: {
+      extension_id,
+      version_id: extension_version_id,
+      type: 'enable'
+    }
+  });
+}
+
+
+module.exports = {
+  upsertThemeExtensionRequest,
+  createCheckoutExtensionRequest,
+  createThemeExtensionVersionRequest,
+  getThemeExtensionVersionTaskRequest,
+  commitCheckoutExtensionRequest,
+  deployCheckoutExtensionRequest,
+  deployThemeExtensionRequest,
+};

package/lib/app/api/partnerOpenapi.js

@@ -0,0 +1,104 @@
+const { partnerOpenapiClient } = require('../utils/request/partnerOpenapi');
+const FormData = require('form-data');
+const fs = require('fs');
+/**
+ * 连接App
+ * @param {Object} data
+ * @param {string} data.extension_id
+ * @param {string} data.type
+ * @returns {Promise<Object>}
+ */
+function connectionAppRequest({ app_client_id, extension_id, access_token }) {
+  
+  return partnerOpenapiClient.post(
+    'openapi/2025-06/theme-extensions/connection',
+    {
+      extension_id,
+      type: 'link'
+    },
+    {
+      headers: {
+        'app-client-id': app_client_id,
+        'access-token': access_token
+      }
+    }
+  );
+}
+
+/**
+ * 创建函数
+ * @param {string} app_client_id
+ * @param {Object} data
+ * @param {string} data.name
+ * @param {string} data.namespace
+ * @param {string} data.source_code
+ * @param {string} data.file
+ * @returns {Promise<{function_id: string, version_id: string, version: string}>}
+ */
+async function createFunctionRequest(app_client_id, access_token, data) {
+  const formData = new FormData();
+  Object.entries(data).forEach(([key, value]) => {
+    if (key === 'file') {
+      // 如果是文件路径，用流替换
+      formData.append(key, fs.createReadStream(value));
+    } else if (key === 'source_code') {
+      // source_code 是文件路径，读取内容作为字符串传递
+      const sourceCode = fs.readFileSync(value, 'utf8');
+      formData.append(key, sourceCode);
+    } else {
+      formData.append(key, value);
+    }
+  });
+  return partnerOpenapiClient.post(`openapi/2025-06/functions/create`, formData, {
+    headers: {
+      ...formData.getHeaders(), // 让 axios 自动带上正确的 multipart/form-data boundary
+      'app-client-id': app_client_id,
+      'access-token': access_token,
+    },
+    maxContentLength: Infinity,
+    maxBodyLength: Infinity
+  });
+}
+
+/**
+ * 提交函数
+ * @param {string} app_client_id
+ * @param {Object} data
+ * @param {string} data.function_id
+ * @param {string} data.source_code
+ * @param {string} data.file
+ * @param {string} data.version
+ * @param {string} data.name
+ * @param {string} data.namespace
+ * @returns {Promise<{function_id: string, version_id: string, version: string}>}
+ */
+async function commitFunctionRequest(app_client_id, access_token, data) {
+  const formData = new FormData();
+  Object.entries(data).forEach(([key, value]) => {
+    if (key === 'file') {
+      // 如果是文件路径，用流替换
+      formData.append(key, fs.createReadStream(value));
+    } else if (key === 'source_code') {
+      // source_code 是文件路径，读取内容作为字符串传递
+      const sourceCode = fs.readFileSync(value, 'utf8');
+      formData.append(key, sourceCode);
+    } else {
+      formData.append(key, value);
+    }
+  });
+  return partnerOpenapiClient.post(`openapi/2025-06/functions/commit`, formData, {
+    headers: {
+      ...formData.getHeaders(), // 让 axios 自动带上正确的 multipart/form-data boundary
+      'app-client-id': app_client_id,
+      'access-token': access_token,
+    },
+    maxContentLength: Infinity,
+    maxBodyLength: Infinity
+  });
+}
+
+module.exports = {
+  connectionAppRequest,
+  createFunctionRequest,
+  commitFunctionRequest
+};

package/lib/app/bin/index.js

@@ -0,0 +1,20 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { getArchPlatform } = require('../utils/platform');
+
+function getLibPath(name) {
+  const archPlatform = getArchPlatform();
+  const supportedTargets = ['arm-linux', 'arm-macos', 'x86_64-macos', 'x86_64-windows', 'x86_64-linux'];
+  if (!supportedTargets.includes(archPlatform)) {
+    throw Error(`Unsupported platform/architecture combination ${processPlatform}/${processArch}`);
+  }
+  const libDir = fs.readdirSync(__dirname).find((n) => name === n);
+  const targetPath = fs.readdirSync(path.resolve(__dirname, libDir)).find((libName) => libName.includes(archPlatform));
+  const libPath = path.resolve(__dirname, name, targetPath);
+  fs.chmodSync(libPath, 0o755);
+  return libPath;
+}
+
+module.exports = {
+  getLibPath
+};