From 2e9d7026096715bbced530587863c8ab3e4c225c Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sun, 15 Jun 2025 10:07:11 +0800 Subject: [PATCH 01/21] add logic to support SENTRY_PROPERTIES parameter --- src/bundle.ts | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/bundle.ts b/src/bundle.ts index e7e13a9..63bab63 100644 --- a/src/bundle.ts +++ b/src/bundle.ts @@ -149,6 +149,14 @@ async function runReactNativeBundleCommand({ const bundleParams = await checkPlugins(); const isSentry = bundleParams.sentry; + if (isSentry) { + if (platform === 'ios') { + process.env.SENTRY_PROPERTIES = 'ios/sentry.properties'; + } else if (platform === 'android') { + process.env.SENTRY_PROPERTIES = 'android/sentry.properties'; + } + } + let bundleCommand = 'bundle'; if (usingExpo) { bundleCommand = 'export:embed'; From 28e25f2843c870a3105aa54a55528417eb535a68 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sat, 28 Jun 2025 16:52:19 +0800 Subject: [PATCH 02/21] remove update.json and meta.json files in ppk --- src/bundle.ts | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/src/bundle.ts b/src/bundle.ts index 63bab63..88c0617 100644 --- a/src/bundle.ts +++ b/src/bundle.ts @@ -286,11 +286,21 @@ async function copyHarmonyBundle(outputFolder: string) { } catch (error) { await fs.chmod(harmonyRawPath, 0o755); } - await fs.remove(path.join(harmonyRawPath, 'update.json')); - await fs.copy('update.json', path.join(harmonyRawPath, 'update.json')); - await fs.ensureDir(outputFolder); - await fs.copy(harmonyRawPath, outputFolder); + const files = await fs.readdir(harmonyRawPath); + for (const file of files) { + if (file !== 'update.json' && file !== 'meta.json') { + const sourcePath = path.join(harmonyRawPath, file); + const destPath = path.join(outputFolder, file); + const stat = await fs.stat(sourcePath); + + if (stat.isFile()) { + await fs.copy(sourcePath, destPath); + } else if (stat.isDirectory()) { + await fs.copy(sourcePath, destPath); + } + } + } } catch (error: any) { console.error(t('copyHarmonyBundleError', { error })); throw new Error(t('copyFileFailed', { error: error.message })); From 4aa05a577a9ee202bb8911bf317223963f454887 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sat, 28 Jun 2025 16:54:51 +0800 Subject: [PATCH 03/21] udpapte --- src/bundle.ts | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/bundle.ts b/src/bundle.ts index 4531012..ac22981 100644 --- a/src/bundle.ts +++ b/src/bundle.ts @@ -286,7 +286,10 @@ async function copyHarmonyBundle(outputFolder: string) { } catch (error) { await fs.chmod(harmonyRawPath, 0o755); } + await fs.remove(path.join(harmonyRawPath, 'update.json')); + await fs.copy('update.json', path.join(harmonyRawPath, 'update.json')); await fs.ensureDir(outputFolder); + const files = await fs.readdir(harmonyRawPath); for (const file of files) { if (file !== 'update.json' && file !== 'meta.json') { From d07f3820102f899ed55e4f0484a09c17b69ad536 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sat, 5 Jul 2025 08:25:44 +0800 Subject: [PATCH 04/21] refactor modles --- MODULAR_CLI_README.md | 341 +++++++++++++++++++++++++++++ examples/custom-workflow-module.ts | 247 +++++++++++++++++++++ package.json | 3 +- src/exports.ts | 33 +++ src/modular-index.ts | 115 ++++++++++ src/module-manager.ts | 168 ++++++++++++++ src/modules/app-module.ts | 205 +++++++++++++++++ src/modules/bundle-module.ts | 85 +++++++ src/modules/index.ts | 17 ++ src/modules/user-module.ts | 91 ++++++++ src/modules/version-module.ts | 143 ++++++++++++ src/provider.ts | 288 ++++++++++++++++++++++++ src/types.ts | 112 ++++++++++ 13 files changed, 1847 insertions(+), 1 deletion(-) create mode 100644 MODULAR_CLI_README.md create mode 100644 examples/custom-workflow-module.ts create mode 100644 src/exports.ts create mode 100644 src/modular-index.ts create mode 100644 src/module-manager.ts create mode 100644 src/modules/app-module.ts create mode 100644 src/modules/bundle-module.ts create mode 100644 src/modules/index.ts create mode 100644 src/modules/user-module.ts create mode 100644 src/modules/version-module.ts create mode 100644 src/provider.ts diff --git a/MODULAR_CLI_README.md b/MODULAR_CLI_README.md new file mode 100644 index 0000000..f6ad60b --- /dev/null +++ b/MODULAR_CLI_README.md @@ -0,0 +1,341 @@ +# React Native Update CLI - 模块化版本 + +这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 + +## 🚀 新特性 + +- **模块化架构**: 将CLI功能拆分为独立的模块 +- **自定义工作流**: 支持创建自定义的发布流程 +- **可扩展性**: 用户可以导入和注册自定义模块 +- **类型安全**: 完整的TypeScript类型支持 +- **向后兼容**: 保持与现有CLI的兼容性 + +## 📦 安装 + +```bash +npm install react-native-update-cli +``` + +## 🎯 快速开始 + +### 基本使用 + +```bash +# 使用模块化CLI +npx pushy-modular help + +# 列出所有可用命令和工作流 +npx pushy-modular list + +# 执行自定义工作流 +npx pushy-modular workflow production-release --environment=production --confirm +``` + +### 编程方式使用 + +```typescript +import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; + +// 获取CLI提供者 +const provider = moduleManager.getProvider(); + +// 执行打包 +const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +const publishResult = await provider.publish({ + name: 'v1.2.3', + description: 'Bug fixes and improvements', + rollout: 100 +}); +``` + +## 🔧 创建自定义模块 + +### 1. 定义模块 + +```typescript +import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; + +export const myCustomModule: CLIModule = { + name: 'my-custom', + version: '1.0.0', + + commands: [ + { + name: 'custom-command', + description: 'My custom command', + handler: async (context) => { + console.log('Executing custom command...'); + return { + success: true, + data: { message: 'Custom command executed' } + }; + }, + options: { + param: { hasValue: true, description: 'Custom parameter' } + } + } + ], + + workflows: [ + { + name: 'my-workflow', + description: 'My custom workflow', + steps: [ + { + name: 'step1', + description: 'First step', + execute: async (context, previousResult) => { + console.log('Executing step 1...'); + return { step1Completed: true }; + } + }, + { + name: 'step2', + description: 'Second step', + execute: async (context, previousResult) => { + console.log('Executing step 2...'); + return { ...previousResult, step2Completed: true }; + } + } + ] + } + ], + + init: (provider) => { + console.log('Custom module initialized'); + }, + + cleanup: () => { + console.log('Custom module cleanup'); + } +}; +``` + +### 2. 注册模块 + +```typescript +import { moduleManager } from 'react-native-update-cli'; +import { myCustomModule } from './my-custom-module'; + +// 注册自定义模块 +moduleManager.registerModule(myCustomModule); + +// 执行自定义命令 +const result = await moduleManager.executeCommand('custom-command', { + args: [], + options: { param: 'value' } +}); + +// 执行自定义工作流 +const workflowResult = await moduleManager.executeWorkflow('my-workflow', { + args: [], + options: {} +}); +``` + +## 🔄 工作流系统 + +### 工作流步骤 + +每个工作流步骤包含： + +- `name`: 步骤名称 +- `description`: 步骤描述 +- `execute`: 执行函数 +- `condition`: 可选的条件函数 + +### 条件执行 + +```typescript +{ + name: 'conditional-step', + description: 'Only execute in production', + execute: async (context, previousResult) => { + // 执行逻辑 + }, + condition: (context) => { + return context.options.environment === 'production'; + } +} +``` + +### 工作流验证 + +```typescript +{ + name: 'validated-workflow', + description: 'Workflow with validation', + steps: [...], + validate: (context) => { + if (!context.options.requiredParam) { + console.error('Required parameter missing'); + return false; + } + return true; + } +} +``` + +## 📋 内置模块 + +### Bundle模块 (`bundle`) +- `bundle`: 打包JavaScript代码 +- `build`: 构建项目 + +### Version模块 (`version`) +- `publish`: 发布新版本 +- `versions`: 列出所有版本 +- `update`: 更新版本信息 +- `updateVersionInfo`: 更新版本元数据 + +### App模块 (`app`) +- `createApp`: 创建新应用 +- `apps`: 列出所有应用 +- `selectApp`: 选择应用 +- `deleteApp`: 删除应用 +- `uploadIpa`: 上传IPA文件 +- `uploadApk`: 上传APK文件 +- `uploadApp`: 上传APP文件 +- `packages`: 列出包 + +### User模块 (`user`) +- `login`: 登录 +- `logout`: 登出 +- `me`: 显示用户信息 + +## 🛠️ CLI提供者API + +### 核心功能 + +```typescript +interface CLIProvider { + // 打包 + bundle(options: BundleOptions): Promise; + + // 发布 + publish(options: PublishOptions): Promise; + + // 上传 + upload(options: UploadOptions): Promise; + + // 应用管理 + getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; + listApps(platform?: Platform): Promise; + createApp(name: string, platform: Platform): Promise; + + // 版本管理 + listVersions(appId: string): Promise; + getVersion(appId: string, versionId: string): Promise; + updateVersion(appId: string, versionId: string, updates: Partial): Promise; + + // 包管理 + listPackages(appId: string, platform?: Platform): Promise; + getPackage(appId: string, packageId: string): Promise; + + // 工具函数 + getPlatform(platform?: Platform): Promise; + loadSession(): Promise; + saveToLocal(key: string, value: string): void; + question(prompt: string): Promise; + + // 工作流 + registerWorkflow(workflow: CustomWorkflow): void; + executeWorkflow(workflowName: string, context: CommandContext): Promise; +} +``` + +## 📝 示例 + +### 完整的发布流程 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +// 注册自定义模块 +moduleManager.registerModule(customPublishModule); + +// 执行生产发布工作流 +const result = await moduleManager.executeWorkflow('production-release', { + args: [], + options: { + environment: 'production', + confirm: true, + versionName: 'v1.2.3', + versionDescription: 'Bug fixes and improvements', + platform: 'ios' + } +}); + +if (result.success) { + console.log('Production release completed:', result.data); +} else { + console.error('Production release failed:', result.error); +} +``` + +### 自定义命令 + +```typescript +// 执行自定义打包命令 +const bundleResult = await moduleManager.executeCommand('custom-bundle', { + args: [], + options: { + platform: 'android', + validate: true, + optimize: true + } +}); +``` + +## 🔧 配置 + +### 环境变量 + +```bash +# 设置API端点 +export PUSHY_REGISTRY=https://your-api-endpoint.com + +# 设置加速OSS +export USE_ACC_OSS=true + +# 设置非交互模式 +export NO_INTERACTIVE=true +``` + +### 配置文件 + +创建 `update.json` 文件： + +```json +{ + "ios": { + "appId": "your-ios-app-id", + "appKey": "your-ios-app-key" + }, + "android": { + "appId": "your-android-app-id", + "appKey": "your-android-app-key" + } +} +``` + +## 🚨 注意事项 + +1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 +2. **类型安全**: 所有API都有完整的TypeScript类型定义 +3. **错误处理**: 所有操作都返回标准化的结果格式 +4. **资源清理**: 模块支持清理函数来释放资源 + +## 🤝 贡献 + +欢迎提交Issue和Pull Request来改进这个项目！ + +## 📄 许可证 + +BSD-3-Clause \ No newline at end of file diff --git a/examples/custom-workflow-module.ts b/examples/custom-workflow-module.ts new file mode 100644 index 0000000..00684e7 --- /dev/null +++ b/examples/custom-workflow-module.ts @@ -0,0 +1,247 @@ +import type { CLIModule, CLIProvider, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../src/types'; + +/** + * 示例：自定义发布工作流模块 + * 这个模块展示了如何创建自定义的发布流程 + */ +export const customPublishModule: CLIModule = { + name: 'custom-publish', + version: '1.0.0', + + commands: [ + { + name: 'custom-bundle', + description: 'Custom bundle command with additional validation', + handler: async (context: CommandContext): Promise => { + try { + console.log('Executing custom bundle with validation...'); + + // 自定义验证逻辑 + if (!context.options.platform) { + return { + success: false, + error: 'Platform is required for custom bundle' + }; + } + + // 这里可以添加自定义的打包逻辑 + console.log(`Creating bundle for platform: ${context.options.platform}`); + + return { + success: true, + data: { + message: 'Custom bundle created successfully', + platform: context.options.platform, + timestamp: new Date().toISOString() + } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Custom bundle failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' }, + validate: { default: true, description: 'Enable validation' }, + optimize: { default: false, description: 'Enable optimization' } + } + } + ], + + workflows: [ + { + name: 'production-release', + description: 'Complete production release workflow', + steps: [ + { + name: 'pre-build-validation', + description: 'Validate project configuration', + execute: async (context: CommandContext) => { + console.log('🔍 Validating project configuration...'); + + // 检查必要的配置文件 + const fs = require('fs'); + const requiredFiles = ['package.json', 'update.json']; + + for (const file of requiredFiles) { + if (!fs.existsSync(file)) { + throw new Error(`Required file not found: ${file}`); + } + } + + console.log('✅ Project validation passed'); + return { validated: true, timestamp: new Date().toISOString() }; + } + }, + { + name: 'create-bundle', + description: 'Create optimized bundle', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📦 Creating production bundle...'); + + // 这里可以调用CLI提供者的bundle方法 + // const provider = context.provider; + // const result = await provider.bundle({ + // platform: context.options.platform, + // dev: false, + // sourcemap: true + // }); + + console.log('✅ Bundle created successfully'); + return { + ...previousResult, + bundleCreated: true, + bundlePath: `./dist/bundle-${Date.now()}.ppk` + }; + }, + condition: (context: CommandContext) => { + // 只在生产模式下执行 + return context.options.environment === 'production'; + } + }, + { + name: 'run-tests', + description: 'Run automated tests', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🧪 Running automated tests...'); + + // 模拟测试执行 + await new Promise(resolve => setTimeout(resolve, 1000)); + + console.log('✅ All tests passed'); + return { + ...previousResult, + testsPassed: true, + testResults: { passed: 10, failed: 0 } + }; + } + }, + { + name: 'publish-version', + description: 'Publish to update server', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 Publishing to update server...'); + + // 这里可以调用CLI提供者的publish方法 + // const provider = context.provider; + // const result = await provider.publish({ + // name: context.options.versionName || 'Production Release', + // description: context.options.versionDescription, + // rollout: 100 + // }); + + console.log('✅ Version published successfully'); + return { + ...previousResult, + published: true, + versionId: `v${Date.now()}` + }; + } + }, + { + name: 'notify-team', + description: 'Send notification to team', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📢 Sending notification to team...'); + + // 模拟发送通知 + const notification = { + type: 'production-release', + version: previousResult.versionId, + timestamp: new Date().toISOString(), + status: 'success' + }; + + console.log('✅ Notification sent:', notification); + return { + ...previousResult, + notified: true, + notification + }; + } + } + ], + validate: (context: CommandContext) => { + // 验证工作流执行条件 + if (!context.options.environment) { + console.error('Environment is required for production release'); + return false; + } + + if (context.options.environment === 'production' && !context.options.confirm) { + console.error('Confirmation required for production release'); + return false; + } + + return true; + } + }, + + { + name: 'staging-release', + description: 'Staging release workflow for testing', + steps: [ + { + name: 'create-staging-bundle', + description: 'Create bundle for staging', + execute: async (context: CommandContext) => { + console.log('📦 Creating staging bundle...'); + return { + bundleCreated: true, + environment: 'staging', + timestamp: new Date().toISOString() + }; + } + }, + { + name: 'publish-staging', + description: 'Publish to staging environment', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 Publishing to staging...'); + return { + ...previousResult, + published: true, + versionId: `staging-${Date.now()}` + }; + } + } + ] + } + ], + + init: (provider: CLIProvider) => { + console.log('🎉 Custom publish module initialized'); + + // 可以在这里进行模块初始化 + // 例如：注册自定义事件监听器、设置配置等 + }, + + cleanup: () => { + console.log('🧹 Custom publish module cleanup'); + + // 清理资源 + } +}; + +/** + * 使用示例： + * + * // 在用户代码中注册自定义模块 + * import { moduleManager } from 'react-native-update-cli'; + * import { customPublishModule } from './custom-workflow-module'; + * + * moduleManager.registerModule(customPublishModule); + * + * // 执行自定义工作流 + * const result = await moduleManager.executeWorkflow('production-release', { + * args: [], + * options: { + * environment: 'production', + * confirm: true, + * versionName: 'v1.2.3', + * versionDescription: 'Bug fixes and improvements' + * } + * }); + */ \ No newline at end of file diff --git a/package.json b/package.json index ff9540c..9fbc653 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,8 @@ "main": "index.js", "bin": { "pushy": "lib/index.js", - "cresc": "lib/index.js" + "cresc": "lib/index.js", + "pushy-modular": "lib/modular-index.js" }, "files": [ "lib", diff --git a/src/exports.ts b/src/exports.ts new file mode 100644 index 0000000..a240b12 --- /dev/null +++ b/src/exports.ts @@ -0,0 +1,33 @@ +// 导出模块化CLI的核心功能 +export { moduleManager } from './module-manager'; +export { CLIProviderImpl } from './provider'; + +// 导出类型定义 +export type { + CLIProvider, + CLIModule, + CommandDefinition, + CustomWorkflow, + WorkflowStep, + CommandContext, + CommandResult, + BundleOptions, + PublishOptions, + UploadOptions, + Platform, + Session, + Version, + Package +} from './types'; + +// 导出内置模块 +export { builtinModules } from './modules'; +export { bundleModule } from './modules/bundle-module'; +export { versionModule } from './modules/version-module'; +export { appModule } from './modules/app-module'; +export { userModule } from './modules/user-module'; + +// 导出工具函数 +export { loadSession, getSession } from './api'; +export { getPlatform, getSelectedApp } from './app'; +export { question, saveToLocal } from './utils'; \ No newline at end of file diff --git a/src/modular-index.ts b/src/modular-index.ts new file mode 100644 index 0000000..3e1c2b2 --- /dev/null +++ b/src/modular-index.ts @@ -0,0 +1,115 @@ +#!/usr/bin/env node + +import { loadSession } from './api'; +import { printVersionCommand } from './utils'; +import { t } from './utils/i18n'; +import { moduleManager } from './module-manager'; +import { builtinModules } from './modules'; +import type { CommandContext } from './types'; + +// 注册内置模块 +function registerBuiltinModules() { + for (const module of builtinModules) { + try { + moduleManager.registerModule(module); + } catch (error) { + console.error(`Failed to register module ${module.name}:`, error); + } + } +} + +function printUsage() { + console.log('React Native Update CLI - Modular Version'); + console.log(''); + console.log('Available commands:'); + + const commands = moduleManager.getRegisteredCommands(); + for (const command of commands) { + console.log(` ${command.name}: ${command.description || 'No description'}`); + } + + console.log(''); + console.log('Available workflows:'); + const workflows = moduleManager.getRegisteredWorkflows(); + for (const workflow of workflows) { + console.log(` ${workflow.name}: ${workflow.description || 'No description'}`); + } + + console.log(''); + console.log('Visit `https://github.com/reactnativecn/react-native-update` for document.'); + process.exit(1); +} + +async function run() { + await printVersionCommand(); + + // 检查版本参数 + if (process.argv.indexOf('-v') >= 0 || process.argv[2] === 'version') { + process.exit(); + } + + // 注册内置模块 + registerBuiltinModules(); + + // 解析命令行参数 + const argv = require('cli-arguments').parse(require('../cli.json')); + global.NO_INTERACTIVE = argv.options['no-interactive']; + global.USE_ACC_OSS = argv.options.acc; + + // 创建命令上下文 + const context: CommandContext = { + args: argv.args || [], + options: argv.options || {}, + }; + + try { + // 加载会话 + await loadSession(); + context.session = require('./api').getSession(); + + // 执行命令或工作流 + if (argv.command === 'help') { + printUsage(); + } else if (argv.command === 'list') { + moduleManager.listAll(); + } else if (argv.command === 'workflow') { + const workflowName = argv.args[0]; + if (!workflowName) { + console.error('Workflow name is required'); + process.exit(1); + } + + const result = await moduleManager.executeWorkflow(workflowName, context); + if (!result.success) { + console.error('Workflow execution failed:', result.error); + process.exit(1); + } + console.log('Workflow completed successfully:', result.data); + } else { + // 执行普通命令 + const result = await moduleManager.executeCommand(argv.command, context); + if (!result.success) { + console.error('Command execution failed:', result.error); + process.exit(1); + } + console.log('Command completed successfully:', result.data); + } + } catch (err: any) { + if (err.status === 401) { + console.log(t('loginFirst')); + return; + } + console.error(err.stack); + process.exit(-1); + } +} + +// 导出模块管理器，供外部使用 +export { moduleManager }; +export { CLIProviderImpl } from './provider'; +export type { CLIProvider, CLIModule, CommandDefinition, CustomWorkflow, WorkflowStep } from './types'; + +// 如果直接运行此文件，则执行CLI +if (require.main === module) { + run(); +} \ No newline at end of file diff --git a/src/module-manager.ts b/src/module-manager.ts new file mode 100644 index 0000000..f1fe9b3 --- /dev/null +++ b/src/module-manager.ts @@ -0,0 +1,168 @@ +import type { CLIModule, CLIProvider, CommandDefinition, CustomWorkflow } from './types'; +import { CLIProviderImpl } from './provider'; + +export class ModuleManager { + private modules: Map = new Map(); + private provider: CLIProvider; + private commands: Map = new Map(); + private workflows: Map = new Map(); + + constructor() { + this.provider = new CLIProviderImpl(); + } + + /** + * 注册一个CLI模块 + */ + registerModule(module: CLIModule): void { + if (this.modules.has(module.name)) { + throw new Error(`Module '${module.name}' is already registered`); + } + + this.modules.set(module.name, module); + + // 注册模块的命令 + if (module.commands) { + for (const command of module.commands) { + this.registerCommand(command); + } + } + + // 注册模块的工作流 + if (module.workflows) { + for (const workflow of module.workflows) { + this.registerWorkflow(workflow); + } + } + + // 初始化模块 + if (module.init) { + module.init(this.provider); + } + + console.log(`Module '${module.name}' (v${module.version}) registered successfully`); + } + + /** + * 注销一个CLI模块 + */ + unregisterModule(moduleName: string): void { + const module = this.modules.get(moduleName); + if (!module) { + throw new Error(`Module '${moduleName}' is not registered`); + } + + // 清理模块的命令 + if (module.commands) { + for (const command of module.commands) { + this.commands.delete(command.name); + } + } + + // 清理模块的工作流 + if (module.workflows) { + for (const workflow of module.workflows) { + this.workflows.delete(workflow.name); + } + } + + // 清理模块 + if (module.cleanup) { + module.cleanup(); + } + + this.modules.delete(moduleName); + console.log(`Module '${moduleName}' unregistered successfully`); + } + + /** + * 注册单个命令 + */ + registerCommand(command: CommandDefinition): void { + if (this.commands.has(command.name)) { + throw new Error(`Command '${command.name}' is already registered`); + } + this.commands.set(command.name, command); + } + + /** + * 注册单个工作流 + */ + registerWorkflow(workflow: CustomWorkflow): void { + if (this.workflows.has(workflow.name)) { + throw new Error(`Workflow '${workflow.name}' is already registered`); + } + this.workflows.set(workflow.name, workflow); + this.provider.registerWorkflow(workflow); + } + + /** + * 获取所有注册的命令 + */ + getRegisteredCommands(): CommandDefinition[] { + return Array.from(this.commands.values()); + } + + /** + * 获取所有注册的工作流 + */ + getRegisteredWorkflows(): CustomWorkflow[] { + return Array.from(this.workflows.values()); + } + + /** + * 获取所有注册的模块 + */ + getRegisteredModules(): CLIModule[] { + return Array.from(this.modules.values()); + } + + /** + * 执行命令 + */ + async executeCommand(commandName: string, context: any): Promise { + const command = this.commands.get(commandName); + if (!command) { + throw new Error(`Command '${commandName}' not found`); + } + + return await command.handler(context); + } + + /** + * 执行工作流 + */ + async executeWorkflow(workflowName: string, context: any): Promise { + return await this.provider.executeWorkflow(workflowName, context); + } + + /** + * 获取CLI提供者实例 + */ + getProvider(): CLIProvider { + return this.provider; + } + + /** + * 列出所有可用的命令和工作流 + */ + listAll(): void { + console.log('\n=== Registered Commands ==='); + for (const command of this.commands.values()) { + console.log(` ${command.name}: ${command.description || 'No description'}`); + } + + console.log('\n=== Registered Workflows ==='); + for (const workflow of this.workflows.values()) { + console.log(` ${workflow.name}: ${workflow.description || 'No description'}`); + } + + console.log('\n=== Registered Modules ==='); + for (const module of this.modules.values()) { + console.log(` ${module.name} (v${module.version}): ${module.commands?.length || 0} commands, ${module.workflows?.length || 0} workflows`); + } + } +} + +// 创建全局模块管理器实例 +export const moduleManager = new ModuleManager(); \ No newline at end of file diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts new file mode 100644 index 0000000..b90d1c2 --- /dev/null +++ b/src/modules/app-module.ts @@ -0,0 +1,205 @@ +import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; + +export const appModule: CLIModule = { + name: 'app', + version: '1.0.0', + + commands: [ + { + name: 'createApp', + description: 'Create a new app', + handler: async (context: CommandContext): Promise => { + try { + console.log('Creating app with options:', context.options); + // TODO: 调用实际的appCommands.createApp + return { + success: true, + data: { message: 'App created successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Create app failed' + }; + } + }, + options: { + name: { hasValue: true, description: 'App name' }, + platform: { hasValue: true, description: 'Target platform' }, + downloadUrl: { hasValue: true, description: 'Download URL' } + } + }, + { + name: 'apps', + description: 'List all apps', + handler: async (context: CommandContext): Promise => { + try { + console.log('Listing apps for platform:', context.options.platform); + // TODO: 调用实际的appCommands.apps + return { + success: true, + data: { message: 'Apps listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'List apps failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' } + } + }, + { + name: 'selectApp', + description: 'Select an app', + handler: async (context: CommandContext): Promise => { + try { + console.log('Selecting app with args:', context.args, 'options:', context.options); + // TODO: 调用实际的appCommands.selectApp + return { + success: true, + data: { message: 'App selected successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Select app failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' } + } + }, + { + name: 'deleteApp', + description: 'Delete an app', + handler: async (context: CommandContext): Promise => { + try { + console.log('Deleting app with args:', context.args, 'options:', context.options); + // TODO: 调用实际的appCommands.deleteApp + return { + success: true, + data: { message: 'App deleted successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Delete app failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' } + } + }, + { + name: 'uploadIpa', + description: 'Upload IPA file', + handler: async (context: CommandContext): Promise => { + try { + console.log('Uploading IPA file:', context.args[0]); + // TODO: 调用实际的packageCommands.uploadIpa + return { + success: true, + data: { message: 'IPA uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Upload IPA failed' + }; + } + } + }, + { + name: 'uploadApk', + description: 'Upload APK file', + handler: async (context: CommandContext): Promise => { + try { + console.log('Uploading APK file:', context.args[0]); + // TODO: 调用实际的packageCommands.uploadApk + return { + success: true, + data: { message: 'APK uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Upload APK failed' + }; + } + } + }, + { + name: 'uploadApp', + description: 'Upload APP file', + handler: async (context: CommandContext): Promise => { + try { + console.log('Uploading APP file:', context.args[0]); + // TODO: 调用实际的packageCommands.uploadApp + return { + success: true, + data: { message: 'APP uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Upload APP failed' + }; + } + } + }, + { + name: 'packages', + description: 'List packages', + handler: async (context: CommandContext): Promise => { + try { + console.log('Listing packages for platform:', context.options.platform); + // TODO: 调用实际的packageCommands.packages + return { + success: true, + data: { message: 'Packages listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'List packages failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' } + } + } + ], + + workflows: [ + { + name: 'setup-app', + description: 'Setup a new app with initial configuration', + steps: [ + { + name: 'create', + description: 'Create the app', + execute: async (context: CommandContext) => { + console.log('Creating app in workflow'); + // TODO: 调用实际的appCommands.createApp + return { appCreated: true }; + } + }, + { + name: 'select', + description: 'Select the created app', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Selecting app in workflow'); + // TODO: 调用实际的appCommands.selectApp + return { ...previousResult, appSelected: true }; + } + } + ] + } + ] +}; \ No newline at end of file diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts new file mode 100644 index 0000000..19ec717 --- /dev/null +++ b/src/modules/bundle-module.ts @@ -0,0 +1,85 @@ +import type { CLIModule, CommandDefinition, CustomWorkflow, WorkflowStep, CommandContext, CommandResult } from '../types'; +import { bundleCommands } from '../bundle'; + +export const bundleModule: CLIModule = { + name: 'bundle', + version: '1.0.0', + + commands: [ + { + name: 'bundle', + description: 'Bundle javascript code and optionally publish', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.bundle(context); + return { + success: true, + data: { message: 'Bundle created successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Bundle failed' + }; + } + }, + options: { + dev: { hasValue: true, default: 'false', description: 'Development mode' }, + platform: { hasValue: true, description: 'Target platform' }, + bundleName: { hasValue: true, default: 'index.bundlejs', description: 'Bundle file name' }, + entryFile: { hasValue: true, default: 'index.js', description: 'Entry file' }, + output: { hasValue: true, description: 'Output file path' }, + sourcemap: { default: false, description: 'Generate sourcemap' }, + taro: { default: false, description: 'Use Taro CLI' }, + expo: { default: false, description: 'Use Expo CLI' }, + rncli: { default: false, description: 'Use React Native CLI' }, + disableHermes: { default: false, description: 'Disable Hermes' } + } + }, + { + name: 'build', + description: 'Bundle javascript and copy assets', + handler: async (context: CommandContext): Promise => { + try { + // 使用bundle命令作为build的别名 + await bundleCommands.bundle(context); + return { + success: true, + data: { message: 'Build completed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Build failed' + }; + } + } + } + ], + + workflows: [ + { + name: 'bundle-and-publish', + description: 'Bundle code and publish to update server', + steps: [ + { + name: 'bundle', + description: 'Create JavaScript bundle', + execute: async (context: CommandContext) => { + const bundleResult = await bundleCommands.bundle(context); + return { bundleFile: context.args[0] }; + } + }, + { + name: 'publish', + description: 'Publish bundle to update server', + execute: async (context: CommandContext, previousResult: any) => { + // 这里需要调用publish命令 + console.log('Publishing bundle:', previousResult.bundleFile); + return { published: true, bundleFile: previousResult.bundleFile }; + } + } + ] + } + ] +}; \ No newline at end of file diff --git a/src/modules/index.ts b/src/modules/index.ts new file mode 100644 index 0000000..3feeeb0 --- /dev/null +++ b/src/modules/index.ts @@ -0,0 +1,17 @@ +import { bundleModule } from './bundle-module'; +import { versionModule } from './version-module'; +import { appModule } from './app-module'; +import { userModule } from './user-module'; + +export { bundleModule } from './bundle-module'; +export { versionModule } from './version-module'; +export { appModule } from './app-module'; +export { userModule } from './user-module'; + +// 导出所有内置模块的数组，方便批量注册 +export const builtinModules = [ + bundleModule, + versionModule, + appModule, + userModule +]; \ No newline at end of file diff --git a/src/modules/user-module.ts b/src/modules/user-module.ts new file mode 100644 index 0000000..962323b --- /dev/null +++ b/src/modules/user-module.ts @@ -0,0 +1,91 @@ +import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; + +export const userModule: CLIModule = { + name: 'user', + version: '1.0.0', + + commands: [ + { + name: 'login', + description: 'Login to the service', + handler: async (context: CommandContext): Promise => { + try { + console.log('Logging in user'); + // TODO: 调用实际的userCommands.login + return { + success: true, + data: { message: 'Login successful' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Login failed' + }; + } + } + }, + { + name: 'logout', + description: 'Logout from the service', + handler: async (context: CommandContext): Promise => { + try { + console.log('Logging out user'); + // TODO: 调用实际的userCommands.logout + return { + success: true, + data: { message: 'Logout successful' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Logout failed' + }; + } + } + }, + { + name: 'me', + description: 'Show current user information', + handler: async (context: CommandContext): Promise => { + try { + console.log('Getting user information'); + // TODO: 调用实际的userCommands.me + return { + success: true, + data: { message: 'User information retrieved successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Get user info failed' + }; + } + } + } + ], + + workflows: [ + { + name: 'auth-check', + description: 'Check authentication status', + steps: [ + { + name: 'check-session', + description: 'Check if user is logged in', + execute: async (context: CommandContext) => { + console.log('Checking authentication status'); + return { authenticated: true }; + } + }, + { + name: 'get-user-info', + description: 'Get current user information', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Getting user information'); + return { ...previousResult, userInfo: { name: 'test-user' } }; + } + } + ] + } + ] +}; \ No newline at end of file diff --git a/src/modules/version-module.ts b/src/modules/version-module.ts new file mode 100644 index 0000000..dac7d60 --- /dev/null +++ b/src/modules/version-module.ts @@ -0,0 +1,143 @@ +import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import { versionCommands } from '../versions'; + +export const versionModule: CLIModule = { + name: 'version', + version: '1.0.0', + + commands: [ + { + name: 'publish', + description: 'Publish a new version', + handler: async (context: CommandContext): Promise => { + try { + await versionCommands.publish(context); + return { + success: true, + data: { message: 'Version published successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Publish failed' + }; + } + }, + options: { + name: { hasValue: true, description: 'Version name' }, + description: { hasValue: true, description: 'Version description' }, + metaInfo: { hasValue: true, description: 'Meta information' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' } + } + }, + { + name: 'versions', + description: 'List all versions', + handler: async (context: CommandContext): Promise => { + try { + await versionCommands.versions(context); + return { + success: true, + data: { message: 'Versions listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'List versions failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' } + } + }, + { + name: 'update', + description: 'Update version information', + handler: async (context: CommandContext): Promise => { + try { + await versionCommands.update(context); + return { + success: true, + data: { message: 'Version updated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Update version failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' }, + versionId: { hasValue: true, description: 'Version ID' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' } + } + }, + { + name: 'updateVersionInfo', + description: 'Update version metadata', + handler: async (context: CommandContext): Promise => { + try { + await versionCommands.updateVersionInfo(context); + return { + success: true, + data: { message: 'Version info updated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Update version info failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' }, + versionId: { hasValue: true, description: 'Version ID' }, + name: { hasValue: true, description: 'Version name' }, + description: { hasValue: true, description: 'Version description' }, + metaInfo: { hasValue: true, description: 'Meta information' } + } + } + ], + + workflows: [ + { + name: 'publish-version', + description: 'Publish a new version with validation', + steps: [ + { + name: 'validate', + description: 'Validate version information', + execute: async (context: CommandContext) => { + // 验证版本信息 + if (!context.args[0]) { + throw new Error('Bundle file is required'); + } + return { bundleFile: context.args[0] }; + } + }, + { + name: 'publish', + description: 'Publish the version', + execute: async (context: CommandContext, previousResult: any) => { + await versionCommands.publish(context); + return { ...previousResult, published: true }; + } + } + ] + } + ] +}; \ No newline at end of file diff --git a/src/provider.ts b/src/provider.ts new file mode 100644 index 0000000..9478a46 --- /dev/null +++ b/src/provider.ts @@ -0,0 +1,288 @@ +import { loadSession, getSession } from './api'; +import { getPlatform, getSelectedApp } from './app'; +import { question, saveToLocal } from './utils'; +import { t } from './utils/i18n'; +import type { + CLIProvider, + CommandContext, + CommandResult, + BundleOptions, + PublishOptions, + UploadOptions, + CustomWorkflow, + Platform, + Session, + Version +} from './types'; + +export class CLIProviderImpl implements CLIProvider { + private workflows: Map = new Map(); + private session?: Session; + + constructor() { + this.init(); + } + + private async init() { + try { + await loadSession(); + this.session = getSession(); + } catch (error) { + // Session might not be loaded yet, that's okay + } + } + + // 核心功能实现 + async bundle(options: BundleOptions): Promise { + try { + // 这里需要调用现有的bundle逻辑 + // 暂时返回成功，实际实现需要集成现有的bundle命令 + console.log('Bundle operation would be executed with options:', options); + + return { + success: true, + data: { message: 'Bundle created successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error during bundling' + }; + } + } + + async publish(options: PublishOptions): Promise { + try { + // 这里需要调用现有的publish逻辑 + console.log('Publish operation would be executed with options:', options); + + return { + success: true, + data: { message: 'Version published successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error during publishing' + }; + } + } + + async upload(options: UploadOptions): Promise { + try { + const platform = await this.getPlatform(options.platform); + const { appId } = await this.getSelectedApp(platform); + + console.log('Upload operation would be executed:', { filePath: options.filePath, platform, appId }); + + return { + success: true, + data: { message: 'File uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error during upload' + }; + } + } + + // 应用管理 + async getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }> { + const resolvedPlatform = await this.getPlatform(platform); + return getSelectedApp(resolvedPlatform); + } + + async listApps(platform?: Platform): Promise { + try { + console.log('List apps operation would be executed for platform:', platform); + + return { + success: true, + data: { message: 'Apps listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error listing apps' + }; + } + } + + async createApp(name: string, platform: Platform): Promise { + try { + console.log('Create app operation would be executed:', { name, platform }); + + return { + success: true, + data: { message: 'App created successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error creating app' + }; + } + } + + // 版本管理 + async listVersions(appId: string): Promise { + try { + console.log('List versions operation would be executed for appId:', appId); + + return { + success: true, + data: { message: 'Versions listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error listing versions' + }; + } + } + + async getVersion(appId: string, versionId: string): Promise { + try { + console.log('Get version operation would be executed:', { appId, versionId }); + + return { + success: true, + data: { message: 'Version retrieved successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error getting version' + }; + } + } + + async updateVersion(appId: string, versionId: string, updates: Partial): Promise { + try { + console.log('Update version operation would be executed:', { appId, versionId, updates }); + + return { + success: true, + data: { message: 'Version updated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error updating version' + }; + } + } + + // 包管理 + async listPackages(appId: string, platform?: Platform): Promise { + try { + console.log('List packages operation would be executed:', { appId, platform }); + + return { + success: true, + data: { message: 'Packages listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error listing packages' + }; + } + } + + async getPackage(appId: string, packageId: string): Promise { + try { + console.log('Get package operation would be executed:', { appId, packageId }); + + return { + success: true, + data: { message: 'Package retrieved successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error getting package' + }; + } + } + + // 工具函数 + async getPlatform(platform?: Platform): Promise { + return getPlatform(platform); + } + + async loadSession(): Promise { + await loadSession(); + this.session = getSession(); + if (!this.session) { + throw new Error('Failed to load session'); + } + return this.session; + } + + saveToLocal(key: string, value: string): void { + saveToLocal(key, value); + } + + async question(prompt: string): Promise { + return question(prompt); + } + + // 工作流管理 + registerWorkflow(workflow: CustomWorkflow): void { + this.workflows.set(workflow.name, workflow); + } + + async executeWorkflow(workflowName: string, context: CommandContext): Promise { + const workflow = this.workflows.get(workflowName); + if (!workflow) { + return { + success: false, + error: `Workflow '${workflowName}' not found` + }; + } + + try { + // 验证工作流 + if (workflow.validate && !workflow.validate(context)) { + return { + success: false, + error: `Workflow '${workflowName}' validation failed` + }; + } + + let previousResult: any = undefined; + + // 执行每个步骤 + for (const step of workflow.steps) { + // 检查步骤条件 + if (step.condition && !step.condition(context)) { + console.log(`Skipping step '${step.name}' due to condition not met`); + continue; + } + + console.log(`Executing step: ${step.name}`); + previousResult = await step.execute(context, previousResult); + } + + return { + success: true, + data: { + message: `Workflow '${workflowName}' completed successfully`, + result: previousResult + } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : `Error executing workflow '${workflowName}'` + }; + } + } + + // 获取所有注册的工作流 + getRegisteredWorkflows(): string[] { + return Array.from(this.workflows.keys()); + } +} \ No newline at end of file diff --git a/src/types.ts b/src/types.ts index 60160fd..27e2664 100644 --- a/src/types.ts +++ b/src/types.ts @@ -20,3 +20,115 @@ export interface Version { name: string; packages?: Package[]; } + +// 新增：模块化CLI相关类型 +export interface CommandContext { + args: string[]; + options: Record; + platform?: Platform; + appId?: string; + session?: Session; +} + +export interface CommandResult { + success: boolean; + data?: any; + error?: string; +} + +export interface CommandDefinition { + name: string; + description?: string; + handler: (context: CommandContext) => Promise; + options?: Record; +} + +export interface BundleOptions { + dev?: boolean; + platform?: Platform; + bundleName?: string; + entryFile?: string; + output?: string; + sourcemap?: boolean; + taro?: boolean; + expo?: boolean; + rncli?: boolean; + disableHermes?: boolean; +} + +export interface PublishOptions { + name?: string; + description?: string; + metaInfo?: string; + packageId?: string; + packageVersion?: string; + minPackageVersion?: string; + maxPackageVersion?: string; + packageVersionRange?: string; + rollout?: number; + dryRun?: boolean; +} + +export interface UploadOptions { + platform?: Platform; + filePath: string; + appId?: string; +} + +export interface WorkflowStep { + name: string; + description?: string; + execute: (context: CommandContext, previousResult?: any) => Promise; + condition?: (context: CommandContext) => boolean; +} + +export interface CustomWorkflow { + name: string; + description?: string; + steps: WorkflowStep[]; + validate?: (context: CommandContext) => boolean; +} + +export interface CLIProvider { + // 核心功能 + bundle: (options: BundleOptions) => Promise; + publish: (options: PublishOptions) => Promise; + upload: (options: UploadOptions) => Promise; + + // 应用管理 + getSelectedApp: (platform?: Platform) => Promise<{ appId: string; platform: Platform }>; + listApps: (platform?: Platform) => Promise; + createApp: (name: string, platform: Platform) => Promise; + + // 版本管理 + listVersions: (appId: string) => Promise; + getVersion: (appId: string, versionId: string) => Promise; + updateVersion: (appId: string, versionId: string, updates: Partial) => Promise; + + // 包管理 + listPackages: (appId: string, platform?: Platform) => Promise; + getPackage: (appId: string, packageId: string) => Promise; + + // 工具函数 + getPlatform: (platform?: Platform) => Promise; + loadSession: () => Promise; + saveToLocal: (key: string, value: string) => void; + question: (prompt: string) => Promise; + + // 工作流 + registerWorkflow: (workflow: CustomWorkflow) => void; + executeWorkflow: (workflowName: string, context: CommandContext) => Promise; +} + +export interface CLIModule { + name: string; + version: string; + commands?: CommandDefinition[]; + workflows?: CustomWorkflow[]; + init?: (provider: CLIProvider) => void; + cleanup?: () => void; +} From 85505fe942e235ad5911d59a3df9521c9841c54b Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sat, 5 Jul 2025 08:28:50 +0800 Subject: [PATCH 05/21] update --- MODULAR_CLI_README.md | 341 ----------------------------------------- README.md | 342 +++++++++++++++++++++++++++++++++++++++++- 2 files changed, 341 insertions(+), 342 deletions(-) delete mode 100644 MODULAR_CLI_README.md diff --git a/MODULAR_CLI_README.md b/MODULAR_CLI_README.md deleted file mode 100644 index f6ad60b..0000000 --- a/MODULAR_CLI_README.md +++ /dev/null @@ -1,341 +0,0 @@ -# React Native Update CLI - 模块化版本 - -这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 - -## 🚀 新特性 - -- **模块化架构**: 将CLI功能拆分为独立的模块 -- **自定义工作流**: 支持创建自定义的发布流程 -- **可扩展性**: 用户可以导入和注册自定义模块 -- **类型安全**: 完整的TypeScript类型支持 -- **向后兼容**: 保持与现有CLI的兼容性 - -## 📦 安装 - -```bash -npm install react-native-update-cli -``` - -## 🎯 快速开始 - -### 基本使用 - -```bash -# 使用模块化CLI -npx pushy-modular help - -# 列出所有可用命令和工作流 -npx pushy-modular list - -# 执行自定义工作流 -npx pushy-modular workflow production-release --environment=production --confirm -``` - -### 编程方式使用 - -```typescript -import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; - -// 获取CLI提供者 -const provider = moduleManager.getProvider(); - -// 执行打包 -const bundleResult = await provider.bundle({ - platform: 'ios', - dev: false, - sourcemap: true -}); - -// 发布版本 -const publishResult = await provider.publish({ - name: 'v1.2.3', - description: 'Bug fixes and improvements', - rollout: 100 -}); -``` - -## 🔧 创建自定义模块 - -### 1. 定义模块 - -```typescript -import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; - -export const myCustomModule: CLIModule = { - name: 'my-custom', - version: '1.0.0', - - commands: [ - { - name: 'custom-command', - description: 'My custom command', - handler: async (context) => { - console.log('Executing custom command...'); - return { - success: true, - data: { message: 'Custom command executed' } - }; - }, - options: { - param: { hasValue: true, description: 'Custom parameter' } - } - } - ], - - workflows: [ - { - name: 'my-workflow', - description: 'My custom workflow', - steps: [ - { - name: 'step1', - description: 'First step', - execute: async (context, previousResult) => { - console.log('Executing step 1...'); - return { step1Completed: true }; - } - }, - { - name: 'step2', - description: 'Second step', - execute: async (context, previousResult) => { - console.log('Executing step 2...'); - return { ...previousResult, step2Completed: true }; - } - } - ] - } - ], - - init: (provider) => { - console.log('Custom module initialized'); - }, - - cleanup: () => { - console.log('Custom module cleanup'); - } -}; -``` - -### 2. 注册模块 - -```typescript -import { moduleManager } from 'react-native-update-cli'; -import { myCustomModule } from './my-custom-module'; - -// 注册自定义模块 -moduleManager.registerModule(myCustomModule); - -// 执行自定义命令 -const result = await moduleManager.executeCommand('custom-command', { - args: [], - options: { param: 'value' } -}); - -// 执行自定义工作流 -const workflowResult = await moduleManager.executeWorkflow('my-workflow', { - args: [], - options: {} -}); -``` - -## 🔄 工作流系统 - -### 工作流步骤 - -每个工作流步骤包含： - -- `name`: 步骤名称 -- `description`: 步骤描述 -- `execute`: 执行函数 -- `condition`: 可选的条件函数 - -### 条件执行 - -```typescript -{ - name: 'conditional-step', - description: 'Only execute in production', - execute: async (context, previousResult) => { - // 执行逻辑 - }, - condition: (context) => { - return context.options.environment === 'production'; - } -} -``` - -### 工作流验证 - -```typescript -{ - name: 'validated-workflow', - description: 'Workflow with validation', - steps: [...], - validate: (context) => { - if (!context.options.requiredParam) { - console.error('Required parameter missing'); - return false; - } - return true; - } -} -``` - -## 📋 内置模块 - -### Bundle模块 (`bundle`) -- `bundle`: 打包JavaScript代码 -- `build`: 构建项目 - -### Version模块 (`version`) -- `publish`: 发布新版本 -- `versions`: 列出所有版本 -- `update`: 更新版本信息 -- `updateVersionInfo`: 更新版本元数据 - -### App模块 (`app`) -- `createApp`: 创建新应用 -- `apps`: 列出所有应用 -- `selectApp`: 选择应用 -- `deleteApp`: 删除应用 -- `uploadIpa`: 上传IPA文件 -- `uploadApk`: 上传APK文件 -- `uploadApp`: 上传APP文件 -- `packages`: 列出包 - -### User模块 (`user`) -- `login`: 登录 -- `logout`: 登出 -- `me`: 显示用户信息 - -## 🛠️ CLI提供者API - -### 核心功能 - -```typescript -interface CLIProvider { - // 打包 - bundle(options: BundleOptions): Promise; - - // 发布 - publish(options: PublishOptions): Promise; - - // 上传 - upload(options: UploadOptions): Promise; - - // 应用管理 - getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; - listApps(platform?: Platform): Promise; - createApp(name: string, platform: Platform): Promise; - - // 版本管理 - listVersions(appId: string): Promise; - getVersion(appId: string, versionId: string): Promise; - updateVersion(appId: string, versionId: string, updates: Partial): Promise; - - // 包管理 - listPackages(appId: string, platform?: Platform): Promise; - getPackage(appId: string, packageId: string): Promise; - - // 工具函数 - getPlatform(platform?: Platform): Promise; - loadSession(): Promise; - saveToLocal(key: string, value: string): void; - question(prompt: string): Promise; - - // 工作流 - registerWorkflow(workflow: CustomWorkflow): void; - executeWorkflow(workflowName: string, context: CommandContext): Promise; -} -``` - -## 📝 示例 - -### 完整的发布流程 - -```typescript -import { moduleManager } from 'react-native-update-cli'; - -// 注册自定义模块 -moduleManager.registerModule(customPublishModule); - -// 执行生产发布工作流 -const result = await moduleManager.executeWorkflow('production-release', { - args: [], - options: { - environment: 'production', - confirm: true, - versionName: 'v1.2.3', - versionDescription: 'Bug fixes and improvements', - platform: 'ios' - } -}); - -if (result.success) { - console.log('Production release completed:', result.data); -} else { - console.error('Production release failed:', result.error); -} -``` - -### 自定义命令 - -```typescript -// 执行自定义打包命令 -const bundleResult = await moduleManager.executeCommand('custom-bundle', { - args: [], - options: { - platform: 'android', - validate: true, - optimize: true - } -}); -``` - -## 🔧 配置 - -### 环境变量 - -```bash -# 设置API端点 -export PUSHY_REGISTRY=https://your-api-endpoint.com - -# 设置加速OSS -export USE_ACC_OSS=true - -# 设置非交互模式 -export NO_INTERACTIVE=true -``` - -### 配置文件 - -创建 `update.json` 文件： - -```json -{ - "ios": { - "appId": "your-ios-app-id", - "appKey": "your-ios-app-key" - }, - "android": { - "appId": "your-android-app-id", - "appKey": "your-android-app-key" - } -} -``` - -## 🚨 注意事项 - -1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 -2. **类型安全**: 所有API都有完整的TypeScript类型定义 -3. **错误处理**: 所有操作都返回标准化的结果格式 -4. **资源清理**: 模块支持清理函数来释放资源 - -## 🤝 贡献 - -欢迎提交Issue和Pull Request来改进这个项目！ - -## 📄 许可证 - -BSD-3-Clause \ No newline at end of file diff --git a/README.md b/README.md index 9598fac..f6ad60b 100644 --- a/README.md +++ b/README.md @@ -1 +1,341 @@ -# react-native-update-cli \ No newline at end of file +# React Native Update CLI - 模块化版本 + +这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 + +## 🚀 新特性 + +- **模块化架构**: 将CLI功能拆分为独立的模块 +- **自定义工作流**: 支持创建自定义的发布流程 +- **可扩展性**: 用户可以导入和注册自定义模块 +- **类型安全**: 完整的TypeScript类型支持 +- **向后兼容**: 保持与现有CLI的兼容性 + +## 📦 安装 + +```bash +npm install react-native-update-cli +``` + +## 🎯 快速开始 + +### 基本使用 + +```bash +# 使用模块化CLI +npx pushy-modular help + +# 列出所有可用命令和工作流 +npx pushy-modular list + +# 执行自定义工作流 +npx pushy-modular workflow production-release --environment=production --confirm +``` + +### 编程方式使用 + +```typescript +import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; + +// 获取CLI提供者 +const provider = moduleManager.getProvider(); + +// 执行打包 +const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +const publishResult = await provider.publish({ + name: 'v1.2.3', + description: 'Bug fixes and improvements', + rollout: 100 +}); +``` + +## 🔧 创建自定义模块 + +### 1. 定义模块 + +```typescript +import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; + +export const myCustomModule: CLIModule = { + name: 'my-custom', + version: '1.0.0', + + commands: [ + { + name: 'custom-command', + description: 'My custom command', + handler: async (context) => { + console.log('Executing custom command...'); + return { + success: true, + data: { message: 'Custom command executed' } + }; + }, + options: { + param: { hasValue: true, description: 'Custom parameter' } + } + } + ], + + workflows: [ + { + name: 'my-workflow', + description: 'My custom workflow', + steps: [ + { + name: 'step1', + description: 'First step', + execute: async (context, previousResult) => { + console.log('Executing step 1...'); + return { step1Completed: true }; + } + }, + { + name: 'step2', + description: 'Second step', + execute: async (context, previousResult) => { + console.log('Executing step 2...'); + return { ...previousResult, step2Completed: true }; + } + } + ] + } + ], + + init: (provider) => { + console.log('Custom module initialized'); + }, + + cleanup: () => { + console.log('Custom module cleanup'); + } +}; +``` + +### 2. 注册模块 + +```typescript +import { moduleManager } from 'react-native-update-cli'; +import { myCustomModule } from './my-custom-module'; + +// 注册自定义模块 +moduleManager.registerModule(myCustomModule); + +// 执行自定义命令 +const result = await moduleManager.executeCommand('custom-command', { + args: [], + options: { param: 'value' } +}); + +// 执行自定义工作流 +const workflowResult = await moduleManager.executeWorkflow('my-workflow', { + args: [], + options: {} +}); +``` + +## 🔄 工作流系统 + +### 工作流步骤 + +每个工作流步骤包含： + +- `name`: 步骤名称 +- `description`: 步骤描述 +- `execute`: 执行函数 +- `condition`: 可选的条件函数 + +### 条件执行 + +```typescript +{ + name: 'conditional-step', + description: 'Only execute in production', + execute: async (context, previousResult) => { + // 执行逻辑 + }, + condition: (context) => { + return context.options.environment === 'production'; + } +} +``` + +### 工作流验证 + +```typescript +{ + name: 'validated-workflow', + description: 'Workflow with validation', + steps: [...], + validate: (context) => { + if (!context.options.requiredParam) { + console.error('Required parameter missing'); + return false; + } + return true; + } +} +``` + +## 📋 内置模块 + +### Bundle模块 (`bundle`) +- `bundle`: 打包JavaScript代码 +- `build`: 构建项目 + +### Version模块 (`version`) +- `publish`: 发布新版本 +- `versions`: 列出所有版本 +- `update`: 更新版本信息 +- `updateVersionInfo`: 更新版本元数据 + +### App模块 (`app`) +- `createApp`: 创建新应用 +- `apps`: 列出所有应用 +- `selectApp`: 选择应用 +- `deleteApp`: 删除应用 +- `uploadIpa`: 上传IPA文件 +- `uploadApk`: 上传APK文件 +- `uploadApp`: 上传APP文件 +- `packages`: 列出包 + +### User模块 (`user`) +- `login`: 登录 +- `logout`: 登出 +- `me`: 显示用户信息 + +## 🛠️ CLI提供者API + +### 核心功能 + +```typescript +interface CLIProvider { + // 打包 + bundle(options: BundleOptions): Promise; + + // 发布 + publish(options: PublishOptions): Promise; + + // 上传 + upload(options: UploadOptions): Promise; + + // 应用管理 + getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; + listApps(platform?: Platform): Promise; + createApp(name: string, platform: Platform): Promise; + + // 版本管理 + listVersions(appId: string): Promise; + getVersion(appId: string, versionId: string): Promise; + updateVersion(appId: string, versionId: string, updates: Partial): Promise; + + // 包管理 + listPackages(appId: string, platform?: Platform): Promise; + getPackage(appId: string, packageId: string): Promise; + + // 工具函数 + getPlatform(platform?: Platform): Promise; + loadSession(): Promise; + saveToLocal(key: string, value: string): void; + question(prompt: string): Promise; + + // 工作流 + registerWorkflow(workflow: CustomWorkflow): void; + executeWorkflow(workflowName: string, context: CommandContext): Promise; +} +``` + +## 📝 示例 + +### 完整的发布流程 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +// 注册自定义模块 +moduleManager.registerModule(customPublishModule); + +// 执行生产发布工作流 +const result = await moduleManager.executeWorkflow('production-release', { + args: [], + options: { + environment: 'production', + confirm: true, + versionName: 'v1.2.3', + versionDescription: 'Bug fixes and improvements', + platform: 'ios' + } +}); + +if (result.success) { + console.log('Production release completed:', result.data); +} else { + console.error('Production release failed:', result.error); +} +``` + +### 自定义命令 + +```typescript +// 执行自定义打包命令 +const bundleResult = await moduleManager.executeCommand('custom-bundle', { + args: [], + options: { + platform: 'android', + validate: true, + optimize: true + } +}); +``` + +## 🔧 配置 + +### 环境变量 + +```bash +# 设置API端点 +export PUSHY_REGISTRY=https://your-api-endpoint.com + +# 设置加速OSS +export USE_ACC_OSS=true + +# 设置非交互模式 +export NO_INTERACTIVE=true +``` + +### 配置文件 + +创建 `update.json` 文件： + +```json +{ + "ios": { + "appId": "your-ios-app-id", + "appKey": "your-ios-app-key" + }, + "android": { + "appId": "your-android-app-id", + "appKey": "your-android-app-key" + } +} +``` + +## 🚨 注意事项 + +1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 +2. **类型安全**: 所有API都有完整的TypeScript类型定义 +3. **错误处理**: 所有操作都返回标准化的结果格式 +4. **资源清理**: 模块支持清理函数来释放资源 + +## 🤝 贡献 + +欢迎提交Issue和Pull Request来改进这个项目！ + +## 📄 许可证 + +BSD-3-Clause \ No newline at end of file From 3f8b9f1cc8a81bb923648cd6e5ce87c083df073c Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sat, 5 Jul 2025 15:51:28 +0800 Subject: [PATCH 06/21] add package-module file --- README.md | 6 +- README_MODULAR.md | 366 ++++++++++++++++++++++++++++++++++ src/exports.ts | 1 + src/modules/app-module.ts | 103 +++------- src/modules/index.ts | 5 +- src/modules/package-module.ts | 276 +++++++++++++++++++++++++ 6 files changed, 672 insertions(+), 85 deletions(-) create mode 100644 README_MODULAR.md create mode 100644 src/modules/package-module.ts diff --git a/README.md b/README.md index f6ad60b..d5ce8db 100644 --- a/README.md +++ b/README.md @@ -334,8 +334,4 @@ export NO_INTERACTIVE=true ## 🤝 贡献 -欢迎提交Issue和Pull Request来改进这个项目！ - -## 📄 许可证 - -BSD-3-Clause \ No newline at end of file +欢迎提交Issue和Pull Request来改进这个项目！ \ No newline at end of file diff --git a/README_MODULAR.md b/README_MODULAR.md new file mode 100644 index 0000000..a71af4c --- /dev/null +++ b/README_MODULAR.md @@ -0,0 +1,366 @@ +# React Native Update CLI - 模块化版本 + +这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 + +## 🚀 新特性 + +- **模块化架构**: 将CLI功能拆分为独立的模块 +- **自定义工作流**: 支持创建自定义的发布流程 +- **可扩展性**: 用户可以导入和注册自定义模块 +- **类型安全**: 完整的TypeScript类型支持 +- **向后兼容**: 保持与现有CLI的兼容性 + +## 📦 安装 + +```bash +npm install react-native-update-cli +``` + +## 🎯 快速开始 + +### 基本使用 + +```bash +# 使用模块化CLI +npx pushy-modular help + +# 列出所有可用命令和工作流 +npx pushy-modular list + +# 执行自定义工作流 +npx pushy-modular workflow production-release --environment=production --confirm +``` + +### 编程方式使用 + +```typescript +import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; + +// 获取CLI提供者 +const provider = moduleManager.getProvider(); + +// 执行打包 +const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +const publishResult = await provider.publish({ + name: 'v1.2.3', + description: 'Bug fixes and improvements', + rollout: 100 +}); +``` + +## 🔧 创建自定义模块 + +### 1. 定义模块 + +```typescript +import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; + +export const myCustomModule: CLIModule = { + name: 'my-custom', + version: '1.0.0', + + commands: [ + { + name: 'custom-command', + description: 'My custom command', + handler: async (context) => { + console.log('Executing custom command...'); + return { + success: true, + data: { message: 'Custom command executed' } + }; + }, + options: { + param: { hasValue: true, description: 'Custom parameter' } + } + } + ], + + workflows: [ + { + name: 'my-workflow', + description: 'My custom workflow', + steps: [ + { + name: 'step1', + description: 'First step', + execute: async (context, previousResult) => { + console.log('Executing step 1...'); + return { step1Completed: true }; + } + }, + { + name: 'step2', + description: 'Second step', + execute: async (context, previousResult) => { + console.log('Executing step 2...'); + return { ...previousResult, step2Completed: true }; + } + } + ] + } + ], + + init: (provider) => { + console.log('Custom module initialized'); + }, + + cleanup: () => { + console.log('Custom module cleanup'); + } +}; +``` + +### 2. 注册模块 + +```typescript +import { moduleManager } from 'react-native-update-cli'; +import { myCustomModule } from './my-custom-module'; + +// 注册自定义模块 +moduleManager.registerModule(myCustomModule); + +// 执行自定义命令 +const result = await moduleManager.executeCommand('custom-command', { + args: [], + options: { param: 'value' } +}); + +// 执行自定义工作流 +const workflowResult = await moduleManager.executeWorkflow('my-workflow', { + args: [], + options: {} +}); +``` + +## 🔄 工作流系统 + +### 工作流步骤 + +每个工作流步骤包含： + +- `name`: 步骤名称 +- `description`: 步骤描述 +- `execute`: 执行函数 +- `condition`: 可选的条件函数 + +### 条件执行 + +```typescript +{ + name: 'conditional-step', + description: 'Only execute in production', + execute: async (context, previousResult) => { + // 执行逻辑 + }, + condition: (context) => { + return context.options.environment === 'production'; + } +} +``` + +### 工作流验证 + +```typescript +{ + name: 'validated-workflow', + description: 'Workflow with validation', + steps: [...], + validate: (context) => { + if (!context.options.requiredParam) { + console.error('Required parameter missing'); + return false; + } + return true; + } +} +``` + +## 📋 内置模块 + +### Bundle模块 (`bundle`) +- `bundle`: 打包JavaScript代码 +- `build`: 构建项目 + +### Version模块 (`version`) +- `publish`: 发布新版本 +- `versions`: 列出所有版本 +- `update`: 更新版本信息 +- `updateVersionInfo`: 更新版本元数据 + +### App模块 (`app`) +- `createApp`: 创建新应用 +- `apps`: 列出所有应用 +- `selectApp`: 选择应用 +- `deleteApp`: 删除应用 + +### Package模块 (`package`) +- `uploadIpa`: 上传IPA文件 +- `uploadApk`: 上传APK文件 +- `uploadApp`: 上传APP文件 +- `parseApp`: 解析APP文件信息 +- `parseIpa`: 解析IPA文件信息 +- `parseApk`: 解析APK文件信息 +- `packages`: 列出包 + +### User模块 (`user`) +- `login`: 登录 +- `logout`: 登出 +- `me`: 显示用户信息 + +## 🛠️ CLI提供者API + +### 核心功能 + +```typescript +interface CLIProvider { + // 打包 + bundle(options: BundleOptions): Promise; + + // 发布 + publish(options: PublishOptions): Promise; + + // 上传 + upload(options: UploadOptions): Promise; + + // 应用管理 + getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; + listApps(platform?: Platform): Promise; + createApp(name: string, platform: Platform): Promise; + + // 版本管理 + listVersions(appId: string): Promise; + getVersion(appId: string, versionId: string): Promise; + updateVersion(appId: string, versionId: string, updates: Partial): Promise; + + // 包管理 + listPackages(appId: string, platform?: Platform): Promise; + getPackage(appId: string, packageId: string): Promise; + + // 工具函数 + getPlatform(platform?: Platform): Promise; + loadSession(): Promise; + saveToLocal(key: string, value: string): void; + question(prompt: string): Promise; + + // 工作流 + registerWorkflow(workflow: CustomWorkflow): void; + executeWorkflow(workflowName: string, context: CommandContext): Promise; +} +``` + +## 📝 示例 + +### 完整的发布流程 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +// 注册自定义模块 +moduleManager.registerModule(customPublishModule); + +// 执行生产发布工作流 +const result = await moduleManager.executeWorkflow('production-release', { + args: [], + options: { + environment: 'production', + confirm: true, + versionName: 'v1.2.3', + versionDescription: 'Bug fixes and improvements', + platform: 'ios' + } +}); + +if (result.success) { + console.log('Production release completed:', result.data); +} else { + console.error('Production release failed:', result.error); +} +``` + +### 包管理示例 + +```typescript +// 上传并发布包 +const uploadResult = await moduleManager.executeWorkflow('upload-and-publish', { + args: ['./build/app.ipa'], + options: { + platform: 'ios', + versionName: 'v1.2.3' + } +}); + +// 分析包信息 +const analyzeResult = await moduleManager.executeWorkflow('analyze-package', { + args: ['./build/app.ipa'], + options: {} +}); +``` + +### 自定义命令 + +```typescript +// 执行自定义打包命令 +const bundleResult = await moduleManager.executeCommand('custom-bundle', { + args: [], + options: { + platform: 'android', + validate: true, + optimize: true + } +}); +``` + +## 🔧 配置 + +### 环境变量 + +```bash +# 设置API端点 +export PUSHY_REGISTRY=https://your-api-endpoint.com + +# 设置加速OSS +export USE_ACC_OSS=true + +# 设置非交互模式 +export NO_INTERACTIVE=true +``` + +### 配置文件 + +创建 `update.json` 文件： + +```json +{ + "ios": { + "appId": "your-ios-app-id", + "appKey": "your-ios-app-key" + }, + "android": { + "appId": "your-android-app-id", + "appKey": "your-android-app-key" + } +} +``` + +## 🚨 注意事项 + +1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 +2. **类型安全**: 所有API都有完整的TypeScript类型定义 +3. **错误处理**: 所有操作都返回标准化的结果格式 +4. **资源清理**: 模块支持清理函数来释放资源 +5. **模块分离**: 功能按逻辑分离到不同模块中，便于维护和扩展 + +## 🤝 贡献 + +欢迎提交Issue和Pull Request来改进这个项目！ + +## 📄 许可证 + +BSD-3-Clause \ No newline at end of file diff --git a/src/exports.ts b/src/exports.ts index a240b12..ef04296 100644 --- a/src/exports.ts +++ b/src/exports.ts @@ -26,6 +26,7 @@ export { bundleModule } from './modules/bundle-module'; export { versionModule } from './modules/version-module'; export { appModule } from './modules/app-module'; export { userModule } from './modules/user-module'; +export { packageModule } from './modules/package-module'; // 导出工具函数 export { loadSession, getSession } from './api'; diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts index b90d1c2..6a3c3a1 100644 --- a/src/modules/app-module.ts +++ b/src/modules/app-module.ts @@ -94,85 +94,6 @@ export const appModule: CLIModule = { options: { platform: { hasValue: true, description: 'Target platform' } } - }, - { - name: 'uploadIpa', - description: 'Upload IPA file', - handler: async (context: CommandContext): Promise => { - try { - console.log('Uploading IPA file:', context.args[0]); - // TODO: 调用实际的packageCommands.uploadIpa - return { - success: true, - data: { message: 'IPA uploaded successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Upload IPA failed' - }; - } - } - }, - { - name: 'uploadApk', - description: 'Upload APK file', - handler: async (context: CommandContext): Promise => { - try { - console.log('Uploading APK file:', context.args[0]); - // TODO: 调用实际的packageCommands.uploadApk - return { - success: true, - data: { message: 'APK uploaded successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Upload APK failed' - }; - } - } - }, - { - name: 'uploadApp', - description: 'Upload APP file', - handler: async (context: CommandContext): Promise => { - try { - console.log('Uploading APP file:', context.args[0]); - // TODO: 调用实际的packageCommands.uploadApp - return { - success: true, - data: { message: 'APP uploaded successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Upload APP failed' - }; - } - } - }, - { - name: 'packages', - description: 'List packages', - handler: async (context: CommandContext): Promise => { - try { - console.log('Listing packages for platform:', context.options.platform); - // TODO: 调用实际的packageCommands.packages - return { - success: true, - data: { message: 'Packages listed successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'List packages failed' - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' } - } } ], @@ -200,6 +121,30 @@ export const appModule: CLIModule = { } } ] + }, + { + name: 'manage-apps', + description: 'Manage multiple apps', + steps: [ + { + name: 'list-apps', + description: 'List all apps', + execute: async (context: CommandContext) => { + console.log('Listing all apps'); + // TODO: 调用实际的appCommands.apps + return { appsListed: true }; + } + }, + { + name: 'select-target-app', + description: 'Select target app for operations', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Selecting target app'); + // TODO: 调用实际的appCommands.selectApp + return { ...previousResult, targetAppSelected: true }; + } + } + ] } ] }; \ No newline at end of file diff --git a/src/modules/index.ts b/src/modules/index.ts index 3feeeb0..0873fd3 100644 --- a/src/modules/index.ts +++ b/src/modules/index.ts @@ -2,16 +2,19 @@ import { bundleModule } from './bundle-module'; import { versionModule } from './version-module'; import { appModule } from './app-module'; import { userModule } from './user-module'; +import { packageModule } from './package-module'; export { bundleModule } from './bundle-module'; export { versionModule } from './version-module'; export { appModule } from './app-module'; export { userModule } from './user-module'; +export { packageModule } from './package-module'; // 导出所有内置模块的数组，方便批量注册 export const builtinModules = [ bundleModule, versionModule, appModule, - userModule + userModule, + packageModule ]; \ No newline at end of file diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts new file mode 100644 index 0000000..fd99e18 --- /dev/null +++ b/src/modules/package-module.ts @@ -0,0 +1,276 @@ +import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; + +export const packageModule: CLIModule = { + name: 'package', + version: '1.0.0', + + commands: [ + { + name: 'uploadIpa', + description: 'Upload IPA file', + handler: async (context: CommandContext): Promise => { + try { + console.log('Uploading IPA file:', context.args[0]); + // TODO: 调用实际的packageCommands.uploadIpa + return { + success: true, + data: { message: 'IPA uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Upload IPA failed' + }; + } + } + }, + { + name: 'uploadApk', + description: 'Upload APK file', + handler: async (context: CommandContext): Promise => { + try { + console.log('Uploading APK file:', context.args[0]); + // TODO: 调用实际的packageCommands.uploadApk + return { + success: true, + data: { message: 'APK uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Upload APK failed' + }; + } + } + }, + { + name: 'uploadApp', + description: 'Upload APP file', + handler: async (context: CommandContext): Promise => { + try { + console.log('Uploading APP file:', context.args[0]); + // TODO: 调用实际的packageCommands.uploadApp + return { + success: true, + data: { message: 'APP uploaded successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Upload APP failed' + }; + } + } + }, + { + name: 'parseApp', + description: 'Parse APP file information', + handler: async (context: CommandContext): Promise => { + try { + console.log('Parsing APP file:', context.args[0]); + // TODO: 调用实际的packageCommands.parseApp + return { + success: true, + data: { message: 'APP file parsed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Parse APP failed' + }; + } + } + }, + { + name: 'parseIpa', + description: 'Parse IPA file information', + handler: async (context: CommandContext): Promise => { + try { + console.log('Parsing IPA file:', context.args[0]); + // TODO: 调用实际的packageCommands.parseIpa + return { + success: true, + data: { message: 'IPA file parsed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Parse IPA failed' + }; + } + } + }, + { + name: 'parseApk', + description: 'Parse APK file information', + handler: async (context: CommandContext): Promise => { + try { + console.log('Parsing APK file:', context.args[0]); + // TODO: 调用实际的packageCommands.parseApk + return { + success: true, + data: { message: 'APK file parsed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Parse APK failed' + }; + } + } + }, + { + name: 'packages', + description: 'List packages', + handler: async (context: CommandContext): Promise => { + try { + console.log('Listing packages for platform:', context.options.platform); + // TODO: 调用实际的packageCommands.packages + return { + success: true, + data: { message: 'Packages listed successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'List packages failed' + }; + } + }, + options: { + platform: { hasValue: true, description: 'Target platform' } + } + } + ], + + workflows: [ + { + name: 'upload-and-publish', + description: 'Upload package and publish version', + steps: [ + { + name: 'validate-package', + description: 'Validate package file', + execute: async (context: CommandContext) => { + const filePath = context.args[0]; + console.log('Validating package file:', filePath); + + // 检查文件是否存在 + const fs = require('fs'); + if (!fs.existsSync(filePath)) { + throw new Error(`Package file not found: ${filePath}`); + } + + // 检查文件类型 + if (!filePath.endsWith('.ipa') && !filePath.endsWith('.apk') && !filePath.endsWith('.app')) { + throw new Error('Unsupported package format. Only .ipa, .apk, and .app files are supported.'); + } + + return { + filePath, + fileType: filePath.split('.').pop(), + validated: true + }; + } + }, + { + name: 'upload-package', + description: 'Upload package to server', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Uploading package:', previousResult.filePath); + + // 根据文件类型选择上传命令 + let uploadCommand = ''; + if (previousResult.fileType === 'ipa') { + uploadCommand = 'uploadIpa'; + } else if (previousResult.fileType === 'apk') { + uploadCommand = 'uploadApk'; + } else if (previousResult.fileType === 'app') { + uploadCommand = 'uploadApp'; + } + + // TODO: 调用实际的上传命令 + console.log(`Executing ${uploadCommand} command`); + + return { + ...previousResult, + uploaded: true, + uploadCommand + }; + } + }, + { + name: 'publish-version', + description: 'Publish new version', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Publishing new version'); + + // TODO: 调用实际的publish命令 + return { + ...previousResult, + published: true, + versionId: `v${Date.now()}` + }; + } + } + ] + }, + + { + name: 'analyze-package', + description: 'Analyze package file information', + steps: [ + { + name: 'parse-package', + description: 'Parse package file information', + execute: async (context: CommandContext) => { + const filePath = context.args[0]; + console.log('Parsing package file:', filePath); + + // 根据文件类型选择解析命令 + let parseCommand = ''; + if (filePath.endsWith('.ipa')) { + parseCommand = 'parseIpa'; + } else if (filePath.endsWith('.apk')) { + parseCommand = 'parseApk'; + } else if (filePath.endsWith('.app')) { + parseCommand = 'parseApp'; + } + + // TODO: 调用实际的解析命令 + console.log(`Executing ${parseCommand} command`); + + return { + filePath, + parseCommand, + analyzed: true + }; + } + }, + { + name: 'display-info', + description: 'Display package information', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Displaying package information'); + + // 模拟显示包信息 + const packageInfo = { + fileName: previousResult.filePath.split('/').pop(), + fileType: previousResult.parseCommand.replace('parse', '').toLowerCase(), + size: '15.2 MB', + version: '1.0.0', + buildNumber: '1' + }; + + console.log('Package Information:', packageInfo); + return { + ...previousResult, + packageInfo, + displayed: true + }; + } + } + ] + } + ] +}; \ No newline at end of file From 79bb96742cadf7520627a279041d5ca40a8ab5a7 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sun, 6 Jul 2025 09:34:42 +0800 Subject: [PATCH 07/21] update --- README_MODULAR.md | 30 ++++- src/modules/app-module.ts | 12 +- src/modules/bundle-module.ts | 244 ++++++++++++++++++++++++++++++++-- src/modules/package-module.ts | 19 +-- src/modules/user-module.ts | 7 +- 5 files changed, 286 insertions(+), 26 deletions(-) diff --git a/README_MODULAR.md b/README_MODULAR.md index a71af4c..ee4db35 100644 --- a/README_MODULAR.md +++ b/README_MODULAR.md @@ -185,8 +185,14 @@ const workflowResult = await moduleManager.executeWorkflow('my-workflow', { ## 📋 内置模块 ### Bundle模块 (`bundle`) -- `bundle`: 打包JavaScript代码 -- `build`: 构建项目 +- `bundle`: 打包JavaScript代码并可选发布 +- `diff`: 生成两个PPK文件之间的差异 +- `hdiff`: 生成两个PPK文件之间的hdiff +- `diffFromApk`: 从APK文件生成差异 +- `hdiffFromApk`: 从APK文件生成hdiff +- `hdiffFromApp`: 从APP文件生成hdiff +- `diffFromIpa`: 从IPA文件生成差异 +- `hdiffFromIpa`: 从IPA文件生成hdiff ### Version模块 (`version`) - `publish`: 发布新版本 @@ -315,6 +321,26 @@ const bundleResult = await moduleManager.executeCommand('custom-bundle', { optimize: true } }); + +// 生成差异文件 +const diffResult = await moduleManager.executeCommand('diff', { + args: [], + options: { + origin: './build/v1.0.0.ppk', + next: './build/v1.1.0.ppk', + output: './build/diff.patch' + } +}); + +// 从APK文件生成差异 +const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { + args: [], + options: { + origin: './build/app-v1.0.0.apk', + next: './build/app-v1.1.0.apk', + output: './build/apk-diff.patch' + } +}); ``` ## 🔧 配置 diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts index 6a3c3a1..77aaf9d 100644 --- a/src/modules/app-module.ts +++ b/src/modules/app-module.ts @@ -1,4 +1,5 @@ import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import { appCommands } from '../app'; export const appModule: CLIModule = { name: 'app', @@ -10,8 +11,9 @@ export const appModule: CLIModule = { description: 'Create a new app', handler: async (context: CommandContext): Promise => { try { - console.log('Creating app with options:', context.options); - // TODO: 调用实际的appCommands.createApp + const { name, downloadUrl, platform } = context.options; + console.log('Creating app with options:', { name, downloadUrl, platform }); + await appCommands.createApp({ options: { name, downloadUrl, platform } }); return { success: true, data: { message: 'App created successfully' } @@ -35,7 +37,7 @@ export const appModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Listing apps for platform:', context.options.platform); - // TODO: 调用实际的appCommands.apps + await appCommands.apps({ options: { platform: context.options.platform } }); return { success: true, data: { message: 'Apps listed successfully' } @@ -57,7 +59,7 @@ export const appModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Selecting app with args:', context.args, 'options:', context.options); - // TODO: 调用实际的appCommands.selectApp + await appCommands.selectApp({ args: context.args, options: { platform: context.options.platform } }); return { success: true, data: { message: 'App selected successfully' } @@ -79,7 +81,7 @@ export const appModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Deleting app with args:', context.args, 'options:', context.options); - // TODO: 调用实际的appCommands.deleteApp + await appCommands.deleteApp({ args: context.args, options: { platform: context.options.platform } }); return { success: true, data: { message: 'App deleted successfully' } diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 19ec717..c7a7e67 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -28,31 +28,184 @@ export const bundleModule: CLIModule = { platform: { hasValue: true, description: 'Target platform' }, bundleName: { hasValue: true, default: 'index.bundlejs', description: 'Bundle file name' }, entryFile: { hasValue: true, default: 'index.js', description: 'Entry file' }, - output: { hasValue: true, description: 'Output file path' }, + intermediaDir: { hasValue: true, default: '${tempDir}/intermedia/${platform}', description: 'Intermediate directory' }, + output: { hasValue: true, default: '${tempDir}/output/${platform}.${time}.ppk', description: 'Output file path' }, sourcemap: { default: false, description: 'Generate sourcemap' }, taro: { default: false, description: 'Use Taro CLI' }, expo: { default: false, description: 'Use Expo CLI' }, rncli: { default: false, description: 'Use React Native CLI' }, - disableHermes: { default: false, description: 'Disable Hermes' } + disableHermes: { default: false, description: 'Disable Hermes' }, + name: { hasValue: true, description: 'Version name for publishing' }, + description: { hasValue: true, description: 'Version description for publishing' }, + metaInfo: { hasValue: true, description: 'Meta information for publishing' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' } } }, { - name: 'build', - description: 'Bundle javascript and copy assets', + name: 'diff', + description: 'Generate diff between two PPK files', handler: async (context: CommandContext): Promise => { try { - // 使用bundle命令作为build的别名 - await bundleCommands.bundle(context); + await bundleCommands.diff(context); return { success: true, - data: { message: 'Build completed successfully' } + data: { message: 'Diff generated successfully' } }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Build failed' + error: error instanceof Error ? error.message : 'Diff generation failed' }; } + }, + options: { + origin: { hasValue: true, description: 'Original PPK file path' }, + next: { hasValue: true, description: 'New PPK file path' }, + output: { hasValue: true, description: 'Output diff file path' } + } + }, + { + name: 'hdiff', + description: 'Generate hdiff between two PPK files', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.hdiff(context); + return { + success: true, + data: { message: 'HDiff generated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'HDiff generation failed' + }; + } + }, + options: { + origin: { hasValue: true, description: 'Original PPK file path' }, + next: { hasValue: true, description: 'New PPK file path' }, + output: { hasValue: true, description: 'Output hdiff file path' } + } + }, + { + name: 'diffFromApk', + description: 'Generate diff from APK files', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.diffFromApk(context); + return { + success: true, + data: { message: 'Diff from APK generated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Diff from APK failed' + }; + } + }, + options: { + origin: { hasValue: true, description: 'Original APK file path' }, + next: { hasValue: true, description: 'New APK file path' }, + output: { hasValue: true, description: 'Output diff file path' } + } + }, + { + name: 'hdiffFromApk', + description: 'Generate hdiff from APK files', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.hdiffFromApk(context); + return { + success: true, + data: { message: 'HDiff from APK generated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'HDiff from APK failed' + }; + } + }, + options: { + origin: { hasValue: true, description: 'Original APK file path' }, + next: { hasValue: true, description: 'New APK file path' }, + output: { hasValue: true, description: 'Output hdiff file path' } + } + }, + { + name: 'hdiffFromApp', + description: 'Generate hdiff from APP files', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.hdiffFromApp(context); + return { + success: true, + data: { message: 'HDiff from APP generated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'HDiff from APP failed' + }; + } + }, + options: { + origin: { hasValue: true, description: 'Original APP file path' }, + next: { hasValue: true, description: 'New APP file path' }, + output: { hasValue: true, description: 'Output hdiff file path' } + } + }, + { + name: 'diffFromIpa', + description: 'Generate diff from IPA files', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.diffFromIpa(context); + return { + success: true, + data: { message: 'Diff from IPA generated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Diff from IPA failed' + }; + } + }, + options: { + origin: { hasValue: true, description: 'Original IPA file path' }, + next: { hasValue: true, description: 'New IPA file path' }, + output: { hasValue: true, description: 'Output diff file path' } + } + }, + { + name: 'hdiffFromIpa', + description: 'Generate hdiff from IPA files', + handler: async (context: CommandContext): Promise => { + try { + await bundleCommands.hdiffFromIpa(context); + return { + success: true, + data: { message: 'HDiff from IPA generated successfully' } + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'HDiff from IPA failed' + }; + } + }, + options: { + origin: { hasValue: true, description: 'Original IPA file path' }, + next: { hasValue: true, description: 'New IPA file path' }, + output: { hasValue: true, description: 'Output hdiff file path' } } } ], @@ -80,6 +233,81 @@ export const bundleModule: CLIModule = { } } ] + }, + { + name: 'generate-diff', + description: 'Generate diff between two versions', + steps: [ + { + name: 'validate-files', + description: 'Validate input files', + execute: async (context: CommandContext) => { + const fs = require('fs'); + const { origin, next } = context.options; + + if (!fs.existsSync(origin)) { + throw new Error(`Original file not found: ${origin}`); + } + if (!fs.existsSync(next)) { + throw new Error(`New file not found: ${next}`); + } + + return { + origin, + next, + validated: true + }; + } + }, + { + name: 'generate-diff', + description: 'Generate diff file', + execute: async (context: CommandContext, previousResult: any) => { + const { origin, next } = previousResult; + const output = context.options.output || `${next}.diff`; + + // 根据文件类型选择diff命令 + let diffCommand = 'diff'; + if (origin.endsWith('.apk') || next.endsWith('.apk')) { + diffCommand = 'diffFromApk'; + } else if (origin.endsWith('.ipa') || next.endsWith('.ipa')) { + diffCommand = 'diffFromIpa'; + } else if (origin.endsWith('.app') || next.endsWith('.app')) { + diffCommand = 'hdiffFromApp'; + } + + // 调用相应的diff命令 + const diffContext = { + args: [origin, next], + options: { output } + }; + + switch (diffCommand) { + case 'diff': + await bundleCommands.diff(diffContext); + break; + case 'diffFromApk': + await bundleCommands.diffFromApk(diffContext); + break; + case 'diffFromIpa': + await bundleCommands.diffFromIpa(diffContext); + break; + case 'hdiffFromApp': + await bundleCommands.hdiffFromApp(diffContext); + break; + default: + throw new Error(`Unsupported diff command: ${diffCommand}`); + } + + return { + ...previousResult, + output, + diffGenerated: true, + diffCommand + }; + } + } + ] } ] }; \ No newline at end of file diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts index fd99e18..d7d42ee 100644 --- a/src/modules/package-module.ts +++ b/src/modules/package-module.ts @@ -1,4 +1,5 @@ import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import { packageCommands } from '../package'; export const packageModule: CLIModule = { name: 'package', @@ -11,7 +12,7 @@ export const packageModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Uploading IPA file:', context.args[0]); - // TODO: 调用实际的packageCommands.uploadIpa + await packageCommands.uploadIpa(context); return { success: true, data: { message: 'IPA uploaded successfully' } @@ -30,7 +31,7 @@ export const packageModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Uploading APK file:', context.args[0]); - // TODO: 调用实际的packageCommands.uploadApk + await packageCommands.uploadApk(context); return { success: true, data: { message: 'APK uploaded successfully' } @@ -49,7 +50,7 @@ export const packageModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Uploading APP file:', context.args[0]); - // TODO: 调用实际的packageCommands.uploadApp + await packageCommands.uploadApp(context); return { success: true, data: { message: 'APP uploaded successfully' } @@ -68,7 +69,7 @@ export const packageModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Parsing APP file:', context.args[0]); - // TODO: 调用实际的packageCommands.parseApp + await packageCommands.parseApp(context); return { success: true, data: { message: 'APP file parsed successfully' } @@ -87,7 +88,7 @@ export const packageModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Parsing IPA file:', context.args[0]); - // TODO: 调用实际的packageCommands.parseIpa + await packageCommands.parseIpa(context); return { success: true, data: { message: 'IPA file parsed successfully' } @@ -106,7 +107,7 @@ export const packageModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Parsing APK file:', context.args[0]); - // TODO: 调用实际的packageCommands.parseApk + await packageCommands.parseApk(context); return { success: true, data: { message: 'APK file parsed successfully' } @@ -124,8 +125,11 @@ export const packageModule: CLIModule = { description: 'List packages', handler: async (context: CommandContext): Promise => { try { + if (!context.options.platform) { + throw new Error('Platform option is required'); + } console.log('Listing packages for platform:', context.options.platform); - // TODO: 调用实际的packageCommands.packages + await packageCommands.packages({ options: { platform: context.options.platform } }); return { success: true, data: { message: 'Packages listed successfully' } @@ -155,7 +159,6 @@ export const packageModule: CLIModule = { const filePath = context.args[0]; console.log('Validating package file:', filePath); - // 检查文件是否存在 const fs = require('fs'); if (!fs.existsSync(filePath)) { throw new Error(`Package file not found: ${filePath}`); diff --git a/src/modules/user-module.ts b/src/modules/user-module.ts index 962323b..d41a422 100644 --- a/src/modules/user-module.ts +++ b/src/modules/user-module.ts @@ -1,4 +1,5 @@ import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import { userCommands } from '../user'; export const userModule: CLIModule = { name: 'user', @@ -11,7 +12,7 @@ export const userModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Logging in user'); - // TODO: 调用实际的userCommands.login + await userCommands.login(context); return { success: true, data: { message: 'Login successful' } @@ -30,7 +31,7 @@ export const userModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Logging out user'); - // TODO: 调用实际的userCommands.logout + await userCommands.logout(context); return { success: true, data: { message: 'Logout successful' } @@ -49,7 +50,7 @@ export const userModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Getting user information'); - // TODO: 调用实际的userCommands.me + await userCommands.me(); return { success: true, data: { message: 'User information retrieved successfully' } From c61a2966d4fcd706acdfa83731ff048c568af488 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sun, 6 Jul 2025 09:46:56 +0800 Subject: [PATCH 08/21] update readme file --- README.md | 55 ++++++- README_MODULAR.md | 392 ---------------------------------------------- 2 files changed, 53 insertions(+), 394 deletions(-) delete mode 100644 README_MODULAR.md diff --git a/README.md b/README.md index d5ce8db..e8e546c 100644 --- a/README.md +++ b/README.md @@ -185,8 +185,14 @@ const workflowResult = await moduleManager.executeWorkflow('my-workflow', { ## 📋 内置模块 ### Bundle模块 (`bundle`) -- `bundle`: 打包JavaScript代码 -- `build`: 构建项目 +- `bundle`: 打包JavaScript代码并可选发布 +- `diff`: 生成两个PPK文件之间的差异 +- `hdiff`: 生成两个PPK文件之间的hdiff +- `diffFromApk`: 从APK文件生成差异 +- `hdiffFromApk`: 从APK文件生成hdiff +- `hdiffFromApp`: 从APP文件生成hdiff +- `diffFromIpa`: 从IPA文件生成差异 +- `hdiffFromIpa`: 从IPA文件生成hdiff ### Version模块 (`version`) - `publish`: 发布新版本 @@ -199,9 +205,14 @@ const workflowResult = await moduleManager.executeWorkflow('my-workflow', { - `apps`: 列出所有应用 - `selectApp`: 选择应用 - `deleteApp`: 删除应用 + +### Package模块 (`package`) - `uploadIpa`: 上传IPA文件 - `uploadApk`: 上传APK文件 - `uploadApp`: 上传APP文件 +- `parseApp`: 解析APP文件信息 +- `parseIpa`: 解析IPA文件信息 +- `parseApk`: 解析APK文件信息 - `packages`: 列出包 ### User模块 (`user`) @@ -279,6 +290,25 @@ if (result.success) { } ``` +### 包管理示例 + +```typescript +// 上传并发布包 +const uploadResult = await moduleManager.executeWorkflow('upload-and-publish', { + args: ['./build/app.ipa'], + options: { + platform: 'ios', + versionName: 'v1.2.3' + } +}); + +// 分析包信息 +const analyzeResult = await moduleManager.executeWorkflow('analyze-package', { + args: ['./build/app.ipa'], + options: {} +}); +``` + ### 自定义命令 ```typescript @@ -291,6 +321,26 @@ const bundleResult = await moduleManager.executeCommand('custom-bundle', { optimize: true } }); + +// 生成差异文件 +const diffResult = await moduleManager.executeCommand('diff', { + args: [], + options: { + origin: './build/v1.0.0.ppk', + next: './build/v1.1.0.ppk', + output: './build/diff.patch' + } +}); + +// 从APK文件生成差异 +const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { + args: [], + options: { + origin: './build/app-v1.0.0.apk', + next: './build/app-v1.1.0.apk', + output: './build/apk-diff.patch' + } +}); ``` ## 🔧 配置 @@ -331,6 +381,7 @@ export NO_INTERACTIVE=true 2. **类型安全**: 所有API都有完整的TypeScript类型定义 3. **错误处理**: 所有操作都返回标准化的结果格式 4. **资源清理**: 模块支持清理函数来释放资源 +5. **模块分离**: 功能按逻辑分离到不同模块中，便于维护和扩展 ## 🤝 贡献 diff --git a/README_MODULAR.md b/README_MODULAR.md deleted file mode 100644 index ee4db35..0000000 --- a/README_MODULAR.md +++ /dev/null @@ -1,392 +0,0 @@ -# React Native Update CLI - 模块化版本 - -这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 - -## 🚀 新特性 - -- **模块化架构**: 将CLI功能拆分为独立的模块 -- **自定义工作流**: 支持创建自定义的发布流程 -- **可扩展性**: 用户可以导入和注册自定义模块 -- **类型安全**: 完整的TypeScript类型支持 -- **向后兼容**: 保持与现有CLI的兼容性 - -## 📦 安装 - -```bash -npm install react-native-update-cli -``` - -## 🎯 快速开始 - -### 基本使用 - -```bash -# 使用模块化CLI -npx pushy-modular help - -# 列出所有可用命令和工作流 -npx pushy-modular list - -# 执行自定义工作流 -npx pushy-modular workflow production-release --environment=production --confirm -``` - -### 编程方式使用 - -```typescript -import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; - -// 获取CLI提供者 -const provider = moduleManager.getProvider(); - -// 执行打包 -const bundleResult = await provider.bundle({ - platform: 'ios', - dev: false, - sourcemap: true -}); - -// 发布版本 -const publishResult = await provider.publish({ - name: 'v1.2.3', - description: 'Bug fixes and improvements', - rollout: 100 -}); -``` - -## 🔧 创建自定义模块 - -### 1. 定义模块 - -```typescript -import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; - -export const myCustomModule: CLIModule = { - name: 'my-custom', - version: '1.0.0', - - commands: [ - { - name: 'custom-command', - description: 'My custom command', - handler: async (context) => { - console.log('Executing custom command...'); - return { - success: true, - data: { message: 'Custom command executed' } - }; - }, - options: { - param: { hasValue: true, description: 'Custom parameter' } - } - } - ], - - workflows: [ - { - name: 'my-workflow', - description: 'My custom workflow', - steps: [ - { - name: 'step1', - description: 'First step', - execute: async (context, previousResult) => { - console.log('Executing step 1...'); - return { step1Completed: true }; - } - }, - { - name: 'step2', - description: 'Second step', - execute: async (context, previousResult) => { - console.log('Executing step 2...'); - return { ...previousResult, step2Completed: true }; - } - } - ] - } - ], - - init: (provider) => { - console.log('Custom module initialized'); - }, - - cleanup: () => { - console.log('Custom module cleanup'); - } -}; -``` - -### 2. 注册模块 - -```typescript -import { moduleManager } from 'react-native-update-cli'; -import { myCustomModule } from './my-custom-module'; - -// 注册自定义模块 -moduleManager.registerModule(myCustomModule); - -// 执行自定义命令 -const result = await moduleManager.executeCommand('custom-command', { - args: [], - options: { param: 'value' } -}); - -// 执行自定义工作流 -const workflowResult = await moduleManager.executeWorkflow('my-workflow', { - args: [], - options: {} -}); -``` - -## 🔄 工作流系统 - -### 工作流步骤 - -每个工作流步骤包含： - -- `name`: 步骤名称 -- `description`: 步骤描述 -- `execute`: 执行函数 -- `condition`: 可选的条件函数 - -### 条件执行 - -```typescript -{ - name: 'conditional-step', - description: 'Only execute in production', - execute: async (context, previousResult) => { - // 执行逻辑 - }, - condition: (context) => { - return context.options.environment === 'production'; - } -} -``` - -### 工作流验证 - -```typescript -{ - name: 'validated-workflow', - description: 'Workflow with validation', - steps: [...], - validate: (context) => { - if (!context.options.requiredParam) { - console.error('Required parameter missing'); - return false; - } - return true; - } -} -``` - -## 📋 内置模块 - -### Bundle模块 (`bundle`) -- `bundle`: 打包JavaScript代码并可选发布 -- `diff`: 生成两个PPK文件之间的差异 -- `hdiff`: 生成两个PPK文件之间的hdiff -- `diffFromApk`: 从APK文件生成差异 -- `hdiffFromApk`: 从APK文件生成hdiff -- `hdiffFromApp`: 从APP文件生成hdiff -- `diffFromIpa`: 从IPA文件生成差异 -- `hdiffFromIpa`: 从IPA文件生成hdiff - -### Version模块 (`version`) -- `publish`: 发布新版本 -- `versions`: 列出所有版本 -- `update`: 更新版本信息 -- `updateVersionInfo`: 更新版本元数据 - -### App模块 (`app`) -- `createApp`: 创建新应用 -- `apps`: 列出所有应用 -- `selectApp`: 选择应用 -- `deleteApp`: 删除应用 - -### Package模块 (`package`) -- `uploadIpa`: 上传IPA文件 -- `uploadApk`: 上传APK文件 -- `uploadApp`: 上传APP文件 -- `parseApp`: 解析APP文件信息 -- `parseIpa`: 解析IPA文件信息 -- `parseApk`: 解析APK文件信息 -- `packages`: 列出包 - -### User模块 (`user`) -- `login`: 登录 -- `logout`: 登出 -- `me`: 显示用户信息 - -## 🛠️ CLI提供者API - -### 核心功能 - -```typescript -interface CLIProvider { - // 打包 - bundle(options: BundleOptions): Promise; - - // 发布 - publish(options: PublishOptions): Promise; - - // 上传 - upload(options: UploadOptions): Promise; - - // 应用管理 - getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; - listApps(platform?: Platform): Promise; - createApp(name: string, platform: Platform): Promise; - - // 版本管理 - listVersions(appId: string): Promise; - getVersion(appId: string, versionId: string): Promise; - updateVersion(appId: string, versionId: string, updates: Partial): Promise; - - // 包管理 - listPackages(appId: string, platform?: Platform): Promise; - getPackage(appId: string, packageId: string): Promise; - - // 工具函数 - getPlatform(platform?: Platform): Promise; - loadSession(): Promise; - saveToLocal(key: string, value: string): void; - question(prompt: string): Promise; - - // 工作流 - registerWorkflow(workflow: CustomWorkflow): void; - executeWorkflow(workflowName: string, context: CommandContext): Promise; -} -``` - -## 📝 示例 - -### 完整的发布流程 - -```typescript -import { moduleManager } from 'react-native-update-cli'; - -// 注册自定义模块 -moduleManager.registerModule(customPublishModule); - -// 执行生产发布工作流 -const result = await moduleManager.executeWorkflow('production-release', { - args: [], - options: { - environment: 'production', - confirm: true, - versionName: 'v1.2.3', - versionDescription: 'Bug fixes and improvements', - platform: 'ios' - } -}); - -if (result.success) { - console.log('Production release completed:', result.data); -} else { - console.error('Production release failed:', result.error); -} -``` - -### 包管理示例 - -```typescript -// 上传并发布包 -const uploadResult = await moduleManager.executeWorkflow('upload-and-publish', { - args: ['./build/app.ipa'], - options: { - platform: 'ios', - versionName: 'v1.2.3' - } -}); - -// 分析包信息 -const analyzeResult = await moduleManager.executeWorkflow('analyze-package', { - args: ['./build/app.ipa'], - options: {} -}); -``` - -### 自定义命令 - -```typescript -// 执行自定义打包命令 -const bundleResult = await moduleManager.executeCommand('custom-bundle', { - args: [], - options: { - platform: 'android', - validate: true, - optimize: true - } -}); - -// 生成差异文件 -const diffResult = await moduleManager.executeCommand('diff', { - args: [], - options: { - origin: './build/v1.0.0.ppk', - next: './build/v1.1.0.ppk', - output: './build/diff.patch' - } -}); - -// 从APK文件生成差异 -const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { - args: [], - options: { - origin: './build/app-v1.0.0.apk', - next: './build/app-v1.1.0.apk', - output: './build/apk-diff.patch' - } -}); -``` - -## 🔧 配置 - -### 环境变量 - -```bash -# 设置API端点 -export PUSHY_REGISTRY=https://your-api-endpoint.com - -# 设置加速OSS -export USE_ACC_OSS=true - -# 设置非交互模式 -export NO_INTERACTIVE=true -``` - -### 配置文件 - -创建 `update.json` 文件： - -```json -{ - "ios": { - "appId": "your-ios-app-id", - "appKey": "your-ios-app-key" - }, - "android": { - "appId": "your-android-app-id", - "appKey": "your-android-app-key" - } -} -``` - -## 🚨 注意事项 - -1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 -2. **类型安全**: 所有API都有完整的TypeScript类型定义 -3. **错误处理**: 所有操作都返回标准化的结果格式 -4. **资源清理**: 模块支持清理函数来释放资源 -5. **模块分离**: 功能按逻辑分离到不同模块中，便于维护和扩展 - -## 🤝 贡献 - -欢迎提交Issue和Pull Request来改进这个项目！ - -## 📄 许可证 - -BSD-3-Clause \ No newline at end of file From 2e69cdddcf80634a393be02791a3546624dace67 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 7 Jul 2025 10:23:48 +0800 Subject: [PATCH 09/21] modifu cli.json file --- README.md | 240 ++++++++++++++++++++++++++++++++++- cli.json | 20 ++- src/modular-index.ts | 1 - src/modules/bundle-module.ts | 26 ++-- src/provider.ts | 187 ++++++++++++++------------- src/types.ts | 21 +-- src/user.ts | 3 +- 7 files changed, 376 insertions(+), 122 deletions(-) diff --git a/README.md b/README.md index e8e546c..6dbb4b2 100644 --- a/README.md +++ b/README.md @@ -351,9 +351,6 @@ const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { # 设置API端点 export PUSHY_REGISTRY=https://your-api-endpoint.com -# 设置加速OSS -export USE_ACC_OSS=true - # 设置非交互模式 export NO_INTERACTIVE=true ``` @@ -385,4 +382,239 @@ export NO_INTERACTIVE=true ## 🤝 贡献 -欢迎提交Issue和Pull Request来改进这个项目！ \ No newline at end of file +欢迎提交Issue和Pull Request来改进这个项目！ + +## 🚀 Provider API 使用指南 + +Provider提供了简洁的编程接口，适合在应用程序中集成React Native Update CLI功能。 + +### 📋 核心API方法 + +#### 核心业务功能 +```typescript +// 打包应用 +await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +await provider.publish({ + name: 'v1.0.0', + description: 'Bug fixes', + rollout: 100 +}); + +// 上传文件 +await provider.upload({ + filePath: 'app.ipa', + platform: 'ios' +}); +``` + +#### 应用管理 +```typescript +// 创建应用 +await provider.createApp('MyApp', 'ios'); + +// 列出应用 +await provider.listApps('ios'); + +// 获取当前应用 +const { appId, platform } = await provider.getSelectedApp('ios'); +``` + +#### 版本管理 +```typescript +// 列出版本 +await provider.listVersions('app123'); + +// 更新版本 +await provider.updateVersion('app123', 'version456', { + name: 'v1.1.0', + description: 'New features' +}); +``` + +#### 工具函数 +```typescript +// 获取平台 +const platform = await provider.getPlatform('ios'); + +// 加载会话 +const session = await provider.loadSession(); +``` + +### 🎯 使用场景 + +#### 1. 自动化构建脚本 +```typescript +import { moduleManager } from 'react-native-update-cli'; + +async function buildAndPublish() { + const provider = moduleManager.getProvider(); + + // 1. 打包 + const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true + }); + + if (!bundleResult.success) { + throw new Error(`打包失败: ${bundleResult.error}`); + } + + // 2. 发布 + const publishResult = await provider.publish({ + name: 'v1.2.3', + description: 'Bug fixes and performance improvements', + rollout: 100 + }); + + if (!publishResult.success) { + throw new Error(`发布失败: ${publishResult.error}`); + } + + console.log('构建和发布完成！'); +} +``` + +#### 2. CI/CD集成 +```typescript +async function ciBuild() { + const provider = moduleManager.getProvider(); + + const result = await provider.bundle({ + platform: process.env.PLATFORM as 'ios' | 'android', + dev: process.env.NODE_ENV !== 'production', + sourcemap: process.env.NODE_ENV === 'production' + }); + + return result; +} +``` + +#### 3. 应用管理服务 +```typescript +class AppManagementService { + private provider = moduleManager.getProvider(); + + async setupNewApp(name: string, platform: Platform) { + // 创建应用 + const createResult = await this.provider.createApp(name, platform); + + if (createResult.success) { + // 获取应用信息 + const { appId } = await this.provider.getSelectedApp(platform); + + // 列出版本 + await this.provider.listVersions(appId); + + return { appId, success: true }; + } + + return { success: false, error: createResult.error }; + } +} +``` + +### ⚠️ 注意事项 + +1. **错误处理**: 所有Provider方法都返回`CommandResult`，需要检查`success`字段 +2. **类型安全**: Provider提供完整的TypeScript类型支持 +3. **会话管理**: 使用前确保已登录，可通过`loadSession()`检查 +4. **平台支持**: 支持`'ios' | 'android' | 'harmony'`三个平台 + +### 🔧 高级功能 + +#### 自定义工作流 +```typescript +// 注册自定义工作流 +provider.registerWorkflow({ + name: 'quick-release', + description: '快速发布流程', + steps: [ + { + name: 'bundle', + execute: async () => { + return await provider.bundle({ platform: 'ios', dev: false }); + } + }, + { + name: 'publish', + execute: async (context, bundleResult) => { + if (!bundleResult.success) { + throw new Error('打包失败，无法发布'); + } + return await provider.publish({ name: 'auto-release', rollout: 50 }); + } + } + ] +}); + +// 执行工作流 +await provider.executeWorkflow('quick-release', { args: [], options: {} }); +``` + +### 📚 完整示例 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +class ReactNativeUpdateService { + private provider = moduleManager.getProvider(); + + async initialize() { + // 加载会话 + await this.provider.loadSession(); + } + + async buildAndDeploy(platform: Platform, version: string) { + try { + // 1. 打包 + const bundleResult = await this.provider.bundle({ + platform, + dev: false, + sourcemap: true + }); + + if (!bundleResult.success) { + throw new Error(`打包失败: ${bundleResult.error}`); + } + + // 2. 发布 + const publishResult = await this.provider.publish({ + name: version, + description: `Release ${version}`, + rollout: 100 + }); + + if (!publishResult.success) { + throw new Error(`发布失败: ${publishResult.error}`); + } + + return { success: true, data: publishResult.data }; + + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + + async getAppInfo(platform: Platform) { + const { appId } = await this.provider.getSelectedApp(platform); + const versions = await this.provider.listVersions(appId); + + return { appId, versions }; + } +} + +// 使用示例 +const service = new ReactNativeUpdateService(); +await service.initialize(); +await service.buildAndDeploy('ios', 'v1.0.0'); +``` \ No newline at end of file diff --git a/cli.json b/cli.json index 1244446..ca208e7 100644 --- a/cli.json +++ b/cli.json @@ -294,6 +294,24 @@ "hasValue": true } } + }, + "list": { + "description": "List all bundles", + "options": { + "output": { + "default": "${tempDir}/output/list", + "hasValue": true + } + } + }, + "workflow": { + "description": "List all workflows", + "options": { + "output": { + "default": "${tempDir}/output/workflow", + "hasValue": true + } + } } }, "globalOptions": { @@ -301,4 +319,4 @@ "default": false } } -} +} \ No newline at end of file diff --git a/src/modular-index.ts b/src/modular-index.ts index 3e1c2b2..1276e2a 100644 --- a/src/modular-index.ts +++ b/src/modular-index.ts @@ -66,7 +66,6 @@ async function run() { // 加载会话 await loadSession(); context.session = require('./api').getSession(); - // 执行命令或工作流 if (argv.command === 'help') { printUsage(); diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index c7a7e67..834e794 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -4,7 +4,7 @@ import { bundleCommands } from '../bundle'; export const bundleModule: CLIModule = { name: 'bundle', version: '1.0.0', - + commands: [ { name: 'bundle', @@ -244,18 +244,18 @@ export const bundleModule: CLIModule = { execute: async (context: CommandContext) => { const fs = require('fs'); const { origin, next } = context.options; - + if (!fs.existsSync(origin)) { throw new Error(`Original file not found: ${origin}`); } if (!fs.existsSync(next)) { throw new Error(`New file not found: ${next}`); } - - return { - origin, - next, - validated: true + + return { + origin, + next, + validated: true }; } }, @@ -265,7 +265,7 @@ export const bundleModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { const { origin, next } = previousResult; const output = context.options.output || `${next}.diff`; - + // 根据文件类型选择diff命令 let diffCommand = 'diff'; if (origin.endsWith('.apk') || next.endsWith('.apk')) { @@ -275,13 +275,13 @@ export const bundleModule: CLIModule = { } else if (origin.endsWith('.app') || next.endsWith('.app')) { diffCommand = 'hdiffFromApp'; } - + // 调用相应的diff命令 const diffContext = { args: [origin, next], options: { output } }; - + switch (diffCommand) { case 'diff': await bundleCommands.diff(diffContext); @@ -298,9 +298,9 @@ export const bundleModule: CLIModule = { default: throw new Error(`Unsupported diff command: ${diffCommand}`); } - - return { - ...previousResult, + + return { + ...previousResult, output, diffGenerated: true, diffCommand diff --git a/src/provider.ts b/src/provider.ts index 9478a46..5b5ad96 100644 --- a/src/provider.ts +++ b/src/provider.ts @@ -35,9 +35,25 @@ export class CLIProviderImpl implements CLIProvider { // 核心功能实现 async bundle(options: BundleOptions): Promise { try { - // 这里需要调用现有的bundle逻辑 - // 暂时返回成功，实际实现需要集成现有的bundle命令 - console.log('Bundle operation would be executed with options:', options); + const context: CommandContext = { + args: [], + options: { + dev: options.dev || false, + platform: options.platform, + bundleName: options.bundleName || 'index.bundlejs', + entryFile: options.entryFile || 'index.js', + output: options.output || '${tempDir}/output/${platform}.${time}.ppk', + sourcemap: options.sourcemap || false, + taro: options.taro || false, + expo: options.expo || false, + rncli: options.rncli || false, + disableHermes: options.disableHermes || false, + } + }; + + // 调用实际的bundle命令 + const { bundleCommands } = await import('./bundle'); + await bundleCommands.bundle(context); return { success: true, @@ -53,8 +69,26 @@ export class CLIProviderImpl implements CLIProvider { async publish(options: PublishOptions): Promise { try { - // 这里需要调用现有的publish逻辑 - console.log('Publish operation would be executed with options:', options); + // 将PublishOptions转换为CommandContext格式 + const context: CommandContext = { + args: [], + options: { + name: options.name, + description: options.description, + metaInfo: options.metaInfo, + packageId: options.packageId, + packageVersion: options.packageVersion, + minPackageVersion: options.minPackageVersion, + maxPackageVersion: options.maxPackageVersion, + packageVersionRange: options.packageVersionRange, + rollout: options.rollout, + dryRun: options.dryRun || false, + } + }; + + // 调用实际的publish命令 + const { versionCommands } = await import('./versions'); + await versionCommands.publish(context); return { success: true, @@ -73,7 +107,30 @@ export class CLIProviderImpl implements CLIProvider { const platform = await this.getPlatform(options.platform); const { appId } = await this.getSelectedApp(platform); - console.log('Upload operation would be executed:', { filePath: options.filePath, platform, appId }); + // 根据文件类型选择上传命令 + const filePath = options.filePath; + const fileType = filePath.split('.').pop()?.toLowerCase(); + + const context: CommandContext = { + args: [filePath], + options: { platform, appId } + }; + + const { packageCommands } = await import('./package'); + + switch (fileType) { + case 'ipa': + await packageCommands.uploadIpa(context); + break; + case 'apk': + await packageCommands.uploadApk(context); + break; + case 'app': + await packageCommands.uploadApp(context); + break; + default: + throw new Error(`Unsupported file type: ${fileType}`); + } return { success: true, @@ -95,7 +152,9 @@ export class CLIProviderImpl implements CLIProvider { async listApps(platform?: Platform): Promise { try { - console.log('List apps operation would be executed for platform:', platform); + const resolvedPlatform = await this.getPlatform(platform); + const { appCommands } = await import('./app'); + await appCommands.apps({ options: { platform: resolvedPlatform } }); return { success: true, @@ -111,7 +170,14 @@ export class CLIProviderImpl implements CLIProvider { async createApp(name: string, platform: Platform): Promise { try { - console.log('Create app operation would be executed:', { name, platform }); + const { appCommands } = await import('./app'); + await appCommands.createApp({ + options: { + name, + platform, + downloadUrl: '' + } + }); return { success: true, @@ -125,10 +191,16 @@ export class CLIProviderImpl implements CLIProvider { } } - // 版本管理 + // 版本管理（核心） async listVersions(appId: string): Promise { try { - console.log('List versions operation would be executed for appId:', appId); + const context: CommandContext = { + args: [], + options: { appId } + }; + + const { versionCommands } = await import('./versions'); + await versionCommands.versions(context); return { success: true, @@ -142,25 +214,18 @@ export class CLIProviderImpl implements CLIProvider { } } - async getVersion(appId: string, versionId: string): Promise { + async updateVersion(appId: string, versionId: string, updates: Partial): Promise { try { - console.log('Get version operation would be executed:', { appId, versionId }); - - return { - success: true, - data: { message: 'Version retrieved successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Unknown error getting version' + const context: CommandContext = { + args: [versionId], + options: { + appId, + ...updates + } }; - } - } - async updateVersion(appId: string, versionId: string, updates: Partial): Promise { - try { - console.log('Update version operation would be executed:', { appId, versionId, updates }); + const { versionCommands } = await import('./versions'); + await versionCommands.update(context); return { success: true, @@ -174,40 +239,7 @@ export class CLIProviderImpl implements CLIProvider { } } - // 包管理 - async listPackages(appId: string, platform?: Platform): Promise { - try { - console.log('List packages operation would be executed:', { appId, platform }); - - return { - success: true, - data: { message: 'Packages listed successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Unknown error listing packages' - }; - } - } - - async getPackage(appId: string, packageId: string): Promise { - try { - console.log('Get package operation would be executed:', { appId, packageId }); - - return { - success: true, - data: { message: 'Package retrieved successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Unknown error getting package' - }; - } - } - - // 工具函数 + // 工具函数（核心） async getPlatform(platform?: Platform): Promise { return getPlatform(platform); } @@ -221,13 +253,7 @@ export class CLIProviderImpl implements CLIProvider { return this.session; } - saveToLocal(key: string, value: string): void { - saveToLocal(key, value); - } - async question(prompt: string): Promise { - return question(prompt); - } // 工作流管理 registerWorkflow(workflow: CustomWorkflow): void { @@ -244,44 +270,29 @@ export class CLIProviderImpl implements CLIProvider { } try { - // 验证工作流 - if (workflow.validate && !workflow.validate(context)) { - return { - success: false, - error: `Workflow '${workflowName}' validation failed` - }; - } - - let previousResult: any = undefined; - - // 执行每个步骤 + let previousResult: any = null; for (const step of workflow.steps) { - // 检查步骤条件 if (step.condition && !step.condition(context)) { - console.log(`Skipping step '${step.name}' due to condition not met`); + console.log(`Skipping step '${step.name}' due to condition`); continue; } - - console.log(`Executing step: ${step.name}`); + + console.log(`Executing step '${step.name}'`); previousResult = await step.execute(context, previousResult); } - + return { success: true, - data: { - message: `Workflow '${workflowName}' completed successfully`, - result: previousResult - } + data: { message: `Workflow '${workflowName}' completed successfully`, result: previousResult } }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : `Error executing workflow '${workflowName}'` + error: error instanceof Error ? error.message : `Workflow '${workflowName}' failed` }; } } - // 获取所有注册的工作流 getRegisteredWorkflows(): string[] { return Array.from(this.workflows.keys()); } diff --git a/src/types.ts b/src/types.ts index 27e2664..50f2348 100644 --- a/src/types.ts +++ b/src/types.ts @@ -94,32 +94,25 @@ export interface CustomWorkflow { } export interface CLIProvider { - // 核心功能 + // 核心业务功能 bundle: (options: BundleOptions) => Promise; publish: (options: PublishOptions) => Promise; upload: (options: UploadOptions) => Promise; - // 应用管理 - getSelectedApp: (platform?: Platform) => Promise<{ appId: string; platform: Platform }>; - listApps: (platform?: Platform) => Promise; + // 应用管理（核心） createApp: (name: string, platform: Platform) => Promise; + listApps: (platform?: Platform) => Promise; + getSelectedApp: (platform?: Platform) => Promise<{ appId: string; platform: Platform }>; - // 版本管理 + // 版本管理（核心） listVersions: (appId: string) => Promise; - getVersion: (appId: string, versionId: string) => Promise; updateVersion: (appId: string, versionId: string, updates: Partial) => Promise; - // 包管理 - listPackages: (appId: string, platform?: Platform) => Promise; - getPackage: (appId: string, packageId: string) => Promise; - - // 工具函数 + // 工具函数（核心） getPlatform: (platform?: Platform) => Promise; loadSession: () => Promise; - saveToLocal: (key: string, value: string) => void; - question: (prompt: string) => Promise; - // 工作流 + // 工作流管理 registerWorkflow: (workflow: CustomWorkflow) => void; executeWorkflow: (workflowName: string, context: CommandContext) => Promise; } diff --git a/src/user.ts b/src/user.ts index 784b774..828e036 100644 --- a/src/user.ts +++ b/src/user.ts @@ -2,6 +2,7 @@ import { question } from './utils'; import { post, get, replaceSession, saveSession, closeSession } from './api'; import crypto from 'crypto'; import { t } from './utils/i18n'; +import { CommandContext } from 'types'; function md5(str: string) { return crypto.createHash('md5').update(str).digest('hex'); @@ -19,7 +20,7 @@ export const userCommands = { await saveSession(); console.log(t('welcomeMessage', { name: info.name })); }, - logout: async () => { + logout: async (context: CommandContext) => { await closeSession(); console.log(t('loggedOut')); }, From cf178a7772bb4383a31bc7208ef4a5313f22e213 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Tue, 8 Jul 2025 20:46:01 +0800 Subject: [PATCH 10/21] fix command issues --- .gitignore | 4 ++ package.json | 2 +- src/bundle.ts | 15 ++++++ src/modules/bundle-module.ts | 91 ++++++------------------------------ 4 files changed, 34 insertions(+), 78 deletions(-) diff --git a/.gitignore b/.gitignore index 677f6bc..9ddd9a8 100644 --- a/.gitignore +++ b/.gitignore @@ -105,3 +105,7 @@ dist lib/ .DS_Store + +# react-native-update +.update +.pushy \ No newline at end of file diff --git a/package.json b/package.json index 9fbc653..f18df91 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "react-native-update-cli", - "version": "1.46.2", + "version": "1.46.3", "description": "command line tool for react-native-update (remote updates for react native)", "main": "index.js", "bin": { diff --git a/src/bundle.ts b/src/bundle.ts index ac22981..d939eea 100644 --- a/src/bundle.ts +++ b/src/bundle.ts @@ -1085,6 +1085,21 @@ export const bundleCommands = { console.log(`${realOutput} generated.`); }, + async diffFromApp({ args, options }) { + const { origin, next, realOutput } = diffArgsCheck( + args, + options, + 'diffFromApp', + ); + await diffFromPackage( + origin, + next, + realOutput, + 'resources/rawfile/bundle.harmony.js', + ); + console.log(`${realOutput} generated.`); + }, + async hdiffFromApp({ args, options }) { const { origin, next, realOutput } = diffArgsCheck( args, diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 834e794..5bc2781 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -1,5 +1,6 @@ -import type { CLIModule, CommandDefinition, CustomWorkflow, WorkflowStep, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; import { bundleCommands } from '../bundle'; +import { versionCommands } from '../versions'; export const bundleModule: CLIModule = { name: 'bundle', @@ -11,6 +12,7 @@ export const bundleModule: CLIModule = { description: 'Bundle javascript code and optionally publish', handler: async (context: CommandContext): Promise => { try { + console.log('😁bundle', context); await bundleCommands.bundle(context); return { success: true, @@ -70,29 +72,6 @@ export const bundleModule: CLIModule = { output: { hasValue: true, description: 'Output diff file path' } } }, - { - name: 'hdiff', - description: 'Generate hdiff between two PPK files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.hdiff(context); - return { - success: true, - data: { message: 'HDiff generated successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'HDiff generation failed' - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original PPK file path' }, - next: { hasValue: true, description: 'New PPK file path' }, - output: { hasValue: true, description: 'Output hdiff file path' } - } - }, { name: 'diffFromApk', description: 'Generate diff from APK files', @@ -117,34 +96,11 @@ export const bundleModule: CLIModule = { } }, { - name: 'hdiffFromApk', - description: 'Generate hdiff from APK files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.hdiffFromApk(context); - return { - success: true, - data: { message: 'HDiff from APK generated successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'HDiff from APK failed' - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original APK file path' }, - next: { hasValue: true, description: 'New APK file path' }, - output: { hasValue: true, description: 'Output hdiff file path' } - } - }, - { - name: 'hdiffFromApp', + name: 'diffFromApp', description: 'Generate hdiff from APP files', handler: async (context: CommandContext): Promise => { try { - await bundleCommands.hdiffFromApp(context); + await bundleCommands.diffFromApp(context); return { success: true, data: { message: 'HDiff from APP generated successfully' } @@ -185,29 +141,6 @@ export const bundleModule: CLIModule = { output: { hasValue: true, description: 'Output diff file path' } } }, - { - name: 'hdiffFromIpa', - description: 'Generate hdiff from IPA files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.hdiffFromIpa(context); - return { - success: true, - data: { message: 'HDiff from IPA generated successfully' } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'HDiff from IPA failed' - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original IPA file path' }, - next: { hasValue: true, description: 'New IPA file path' }, - output: { hasValue: true, description: 'Output hdiff file path' } - } - } ], workflows: [ @@ -219,6 +152,7 @@ export const bundleModule: CLIModule = { name: 'bundle', description: 'Create JavaScript bundle', execute: async (context: CommandContext) => { + console.log('😁bundle-and-publish-bundle', context); const bundleResult = await bundleCommands.bundle(context); return { bundleFile: context.args[0] }; } @@ -227,9 +161,14 @@ export const bundleModule: CLIModule = { name: 'publish', description: 'Publish bundle to update server', execute: async (context: CommandContext, previousResult: any) => { - // 这里需要调用publish命令 - console.log('Publishing bundle:', previousResult.bundleFile); - return { published: true, bundleFile: previousResult.bundleFile }; + if (previousResult.bundleFile) { + context.options.bundleFile = previousResult.bundleFile; + } + await versionCommands.publish(context); + return { + success: true, + data: { message: 'publish successfully' } + }; } } ] @@ -266,7 +205,6 @@ export const bundleModule: CLIModule = { const { origin, next } = previousResult; const output = context.options.output || `${next}.diff`; - // 根据文件类型选择diff命令 let diffCommand = 'diff'; if (origin.endsWith('.apk') || next.endsWith('.apk')) { diffCommand = 'diffFromApk'; @@ -276,7 +214,6 @@ export const bundleModule: CLIModule = { diffCommand = 'hdiffFromApp'; } - // 调用相应的diff命令 const diffContext = { args: [origin, next], options: { output } From 3f75ab6abf7682d80fc341e30dd4b7df30b8224e Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Wed, 9 Jul 2025 09:15:51 +0800 Subject: [PATCH 11/21] improve version workflow logic --- src/modules/bundle-module.ts | 2 - src/modules/package-module.ts | 105 ++++----- src/modules/user-module.ts | 342 +++++++++++++++++++++++++++- src/modules/version-module.ts | 412 +++++++++++++++++++++++++++++++++- src/types.ts | 5 + 5 files changed, 799 insertions(+), 67 deletions(-) diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 5bc2781..8eeb235 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -12,7 +12,6 @@ export const bundleModule: CLIModule = { description: 'Bundle javascript code and optionally publish', handler: async (context: CommandContext): Promise => { try { - console.log('😁bundle', context); await bundleCommands.bundle(context); return { success: true, @@ -152,7 +151,6 @@ export const bundleModule: CLIModule = { name: 'bundle', description: 'Create JavaScript bundle', execute: async (context: CommandContext) => { - console.log('😁bundle-and-publish-bundle', context); const bundleResult = await bundleCommands.bundle(context); return { bundleFile: context.args[0] }; } diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts index d7d42ee..0b6802f 100644 --- a/src/modules/package-module.ts +++ b/src/modules/package-module.ts @@ -1,5 +1,6 @@ -import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; import { packageCommands } from '../package'; +import { versionCommands } from '../versions'; export const packageModule: CLIModule = { name: 'package', @@ -151,6 +152,19 @@ export const packageModule: CLIModule = { { name: 'upload-and-publish', description: 'Upload package and publish version', + options: { + name: { hasValue: true, description: 'Version name' }, + description: { hasValue: true, description: 'Version description' }, + metaInfo: { hasValue: true, description: 'Meta information' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' }, + platform: { hasValue: true, description: 'Target platform' } + }, steps: [ { name: 'validate-package', @@ -164,7 +178,6 @@ export const packageModule: CLIModule = { throw new Error(`Package file not found: ${filePath}`); } - // 检查文件类型 if (!filePath.endsWith('.ipa') && !filePath.endsWith('.apk') && !filePath.endsWith('.app')) { throw new Error('Unsupported package format. Only .ipa, .apk, and .app files are supported.'); } @@ -182,23 +195,23 @@ export const packageModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { console.log('Uploading package:', previousResult.filePath); - // 根据文件类型选择上传命令 - let uploadCommand = ''; - if (previousResult.fileType === 'ipa') { - uploadCommand = 'uploadIpa'; - } else if (previousResult.fileType === 'apk') { - uploadCommand = 'uploadApk'; - } else if (previousResult.fileType === 'app') { - uploadCommand = 'uploadApp'; - } + const fileType = previousResult.fileType; + let uploadResult; - // TODO: 调用实际的上传命令 - console.log(`Executing ${uploadCommand} command`); + if (fileType === 'ipa') { + uploadResult = await packageCommands.uploadIpa({ args: [previousResult.filePath] }); + } else if (fileType === 'apk') { + uploadResult = await packageCommands.uploadApk({ args: [previousResult.filePath] }); + } else if (fileType === 'app') { + uploadResult = await packageCommands.uploadApp({ args: [previousResult.filePath] }); + } else { + throw new Error(`Unsupported file type: ${fileType}`); + } return { ...previousResult, uploaded: true, - uploadCommand + uploadResult }; } }, @@ -208,17 +221,34 @@ export const packageModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { console.log('Publishing new version'); - // TODO: 调用实际的publish命令 + const publishOptions = { + name: context.options.name, + description: context.options.description, + metaInfo: context.options.metaInfo, + packageId: context.options.packageId, + packageVersion: context.options.packageVersion, + minPackageVersion: context.options.minPackageVersion, + maxPackageVersion: context.options.maxPackageVersion, + packageVersionRange: context.options.packageVersionRange, + rollout: context.options.rollout, + dryRun: context.options.dryRun || false, + platform: context.options.platform + }; + + const versionName = await versionCommands.publish({ + args: context.args, + options: publishOptions + }); + return { ...previousResult, published: true, - versionId: `v${Date.now()}` + versionName }; } } ] }, - { name: 'analyze-package', description: 'Analyze package file information', @@ -229,47 +259,22 @@ export const packageModule: CLIModule = { execute: async (context: CommandContext) => { const filePath = context.args[0]; console.log('Parsing package file:', filePath); - - // 根据文件类型选择解析命令 - let parseCommand = ''; + + let packageInfo; if (filePath.endsWith('.ipa')) { - parseCommand = 'parseIpa'; + packageInfo = await packageCommands.parseIpa({ args: [filePath] }); } else if (filePath.endsWith('.apk')) { - parseCommand = 'parseApk'; + packageInfo = await packageCommands.parseApk({ args: [filePath] }); } else if (filePath.endsWith('.app')) { - parseCommand = 'parseApp'; + packageInfo = await packageCommands.parseApp({ args: [filePath] }); + } else { + throw new Error('Unsupported package format. Only .ipa, .apk, and .app files are supported.'); } - // TODO: 调用实际的解析命令 - console.log(`Executing ${parseCommand} command`); - return { filePath, - parseCommand, - analyzed: true - }; - } - }, - { - name: 'display-info', - description: 'Display package information', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Displaying package information'); - - // 模拟显示包信息 - const packageInfo = { - fileName: previousResult.filePath.split('/').pop(), - fileType: previousResult.parseCommand.replace('parse', '').toLowerCase(), - size: '15.2 MB', - version: '1.0.0', - buildNumber: '1' - }; - - console.log('Package Information:', packageInfo); - return { - ...previousResult, packageInfo, - displayed: true + analyzed: true }; } } diff --git a/src/modules/user-module.ts b/src/modules/user-module.ts index d41a422..6ee872e 100644 --- a/src/modules/user-module.ts +++ b/src/modules/user-module.ts @@ -1,5 +1,6 @@ -import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; import { userCommands } from '../user'; +import { getSession, loadSession } from '../api'; export const userModule: CLIModule = { name: 'user', @@ -68,22 +69,347 @@ export const userModule: CLIModule = { workflows: [ { name: 'auth-check', - description: 'Check authentication status', + description: 'Check authentication status and user information', + options: { + autoLogin: { default: false, description: 'Automatically login if not authenticated' }, + showDetails: { default: true, description: 'Show detailed user information' } + }, steps: [ { - name: 'check-session', - description: 'Check if user is logged in', + name: 'load-session', + description: 'Load existing session from local storage', execute: async (context: CommandContext) => { - console.log('Checking authentication status'); - return { authenticated: true }; + console.log('Loading session from local storage...'); + + try { + await loadSession(); + const session = getSession(); + + if (session && session.token) { + console.log('✓ Session found in local storage'); + return { + sessionLoaded: true, + hasToken: true, + session + }; + } else { + console.log('✗ No valid session found in local storage'); + return { + sessionLoaded: true, + hasToken: false, + session: null + }; + } + } catch (error) { + console.log('✗ Failed to load session:', error instanceof Error ? error.message : 'Unknown error'); + return { + sessionLoaded: false, + hasToken: false, + session: null, + error: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + }, + { + name: 'validate-session', + description: 'Validate session by calling API', + execute: async (context: CommandContext, previousResult: any) => { + if (!previousResult.hasToken) { + console.log('No token available, skipping validation'); + return { + ...previousResult, + validated: false, + reason: 'No token available' + }; + } + + console.log('Validating session with server...'); + + try { + await userCommands.me(); + console.log('✓ Session is valid'); + return { + ...previousResult, + validated: true, + reason: 'Session validated successfully' + }; + } catch (error) { + console.log('✗ Session validation failed:', error instanceof Error ? error.message : 'Unknown error'); + return { + ...previousResult, + validated: false, + reason: error instanceof Error ? error.message : 'Unknown error' + }; + } } }, { name: 'get-user-info', description: 'Get current user information', execute: async (context: CommandContext, previousResult: any) => { - console.log('Getting user information'); - return { ...previousResult, userInfo: { name: 'test-user' } }; + if (!previousResult.validated) { + console.log('Session not valid, cannot get user info'); + return { + ...previousResult, + userInfo: null, + reason: 'Session not valid' + }; + } + + console.log('Getting user information...'); + + try { + const { get } = await import('../api'); + const userInfo = await get('/user/me'); + + console.log('✓ User information retrieved successfully'); + + if (context.options.showDetails !== false) { + console.log('\n=== User Information ==='); + for (const [key, value] of Object.entries(userInfo)) { + if (key !== 'ok') { + console.log(`${key}: ${value}`); + } + } + console.log('========================\n'); + } + + return { + ...previousResult, + userInfo, + reason: 'User info retrieved successfully' + }; + } catch (error) { + console.log('✗ Failed to get user info:', error instanceof Error ? error.message : 'Unknown error'); + return { + ...previousResult, + userInfo: null, + reason: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + }, + { + name: 'handle-auth-failure', + description: 'Handle authentication failure', + execute: async (context: CommandContext, previousResult: any) => { + if (previousResult.validated) { + console.log('✓ Authentication check completed successfully'); + return { + ...previousResult, + authCheckComplete: true, + status: 'authenticated' + }; + } + + console.log('✗ Authentication check failed'); + + if (context.options.autoLogin) { + console.log('Attempting automatic login...'); + try { + await userCommands.login({ args: [] }); + console.log('✓ Automatic login successful'); + return { + ...previousResult, + authCheckComplete: true, + status: 'auto-logged-in', + autoLoginSuccess: true + }; + } catch (error) { + console.log('✗ Automatic login failed:', error instanceof Error ? error.message : 'Unknown error'); + return { + ...previousResult, + authCheckComplete: true, + status: 'failed', + autoLoginSuccess: false, + autoLoginError: error instanceof Error ? error.message : 'Unknown error' + }; + } + } else { + console.log('Please run login command to authenticate'); + return { + ...previousResult, + authCheckComplete: true, + status: 'unauthenticated', + suggestion: 'Run login command to authenticate' + }; + } + } + } + ] + }, + { + name: 'login-flow', + description: 'Complete login flow with validation', + options: { + email: { hasValue: true, description: 'User email' }, + password: { hasValue: true, description: 'User password' }, + validateAfterLogin: { default: true, description: 'Validate session after login' } + }, + steps: [ + { + name: 'check-existing-session', + description: 'Check if user is already logged in', + execute: async (context: CommandContext) => { + console.log('Checking existing session...'); + + try { + await loadSession(); + const session = getSession(); + + if (session && session.token) { + try { + await userCommands.me(); + console.log('✓ User is already logged in'); + return { + alreadyLoggedIn: true, + session: session, + status: 'authenticated' + }; + } catch (error) { + console.log('✗ Existing session is invalid, proceeding with login'); + return { + alreadyLoggedIn: false, + session: null, + status: 'session-expired' + }; + } + } else { + console.log('No existing session found'); + return { + alreadyLoggedIn: false, + session: null, + status: 'no-session' + }; + } + } catch (error) { + console.log('Error checking existing session:', error instanceof Error ? error.message : 'Unknown error'); + return { + alreadyLoggedIn: false, + session: null, + status: 'error', + error: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + }, + { + name: 'perform-login', + description: 'Perform user login', + execute: async (context: CommandContext, previousResult: any) => { + if (previousResult.alreadyLoggedIn) { + console.log('Skipping login - user already authenticated'); + return { + ...previousResult, + loginPerformed: false, + loginSuccess: true + }; + } + + console.log('Performing login...'); + + try { + const loginArgs = []; + if (context.options.email) { + loginArgs.push(context.options.email); + } + if (context.options.password) { + loginArgs.push(context.options.password); + } + + await userCommands.login({ args: loginArgs }); + console.log('✓ Login successful'); + + return { + ...previousResult, + loginPerformed: true, + loginSuccess: true + }; + } catch (error) { + console.log('✗ Login failed:', error instanceof Error ? error.message : 'Unknown error'); + return { + ...previousResult, + loginPerformed: true, + loginSuccess: false, + loginError: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + }, + { + name: 'validate-login', + description: 'Validate login by getting user info', + execute: async (context: CommandContext, previousResult: any) => { + if (!previousResult.loginSuccess && !previousResult.alreadyLoggedIn) { + console.log('Login failed, skipping validation'); + return { + ...previousResult, + validationPerformed: false, + validationSuccess: false + }; + } + + if (context.options.validateAfterLogin === false) { + console.log('Skipping validation as requested'); + return { + ...previousResult, + validationPerformed: false, + validationSuccess: true + }; + } + + console.log('Validating login by getting user information...'); + + try { + const userInfo = await userCommands.me(); + console.log('✓ Login validation successful'); + + return { + ...previousResult, + validationPerformed: true, + validationSuccess: true, + userInfo + }; + } catch (error) { + console.log('✗ Login validation failed:', error instanceof Error ? error.message : 'Unknown error'); + return { + ...previousResult, + validationPerformed: true, + validationSuccess: false, + validationError: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + }, + { + name: 'login-summary', + description: 'Provide login flow summary', + execute: async (context: CommandContext, previousResult: any) => { + console.log('\n=== Login Flow Summary ==='); + + if (previousResult.alreadyLoggedIn) { + console.log('Status: Already logged in'); + console.log('Session: Valid'); + } else if (previousResult.loginSuccess) { + console.log('Status: Login successful'); + if (previousResult.validationSuccess) { + console.log('Validation: Passed'); + } else { + console.log('Validation: Failed'); + } + } else { + console.log('Status: Login failed'); + console.log('Error:', previousResult.loginError || 'Unknown error'); + } + + console.log('==========================\n'); + + return { + ...previousResult, + flowComplete: true, + finalStatus: previousResult.alreadyLoggedIn || previousResult.loginSuccess ? 'success' : 'failed' + }; } } ] diff --git a/src/modules/version-module.ts b/src/modules/version-module.ts index dac7d60..9f69727 100644 --- a/src/modules/version-module.ts +++ b/src/modules/version-module.ts @@ -1,5 +1,7 @@ import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; import { versionCommands } from '../versions'; +import { bundleCommands } from '../bundle'; +import { getPlatform, getSelectedApp } from '../app'; export const versionModule: CLIModule = { name: 'version', @@ -114,27 +116,423 @@ export const versionModule: CLIModule = { ], workflows: [ + { + name: 'bundle-and-publish', + description: 'Create bundle and publish version', + options: { + platform: { hasValue: true, description: 'Target platform' }, + name: { hasValue: true, description: 'Version name' }, + description: { hasValue: true, description: 'Version description' }, + metaInfo: { hasValue: true, description: 'Meta information' }, + bundleName: { hasValue: true, description: 'Bundle file name' }, + entryFile: { hasValue: true, description: 'Entry file path' }, + output: { hasValue: true, description: 'Output file path' }, + dev: { default: false, description: 'Development mode' }, + sourcemap: { default: false, description: 'Generate sourcemap' }, + taro: { default: false, description: 'Taro framework' }, + expo: { default: false, description: 'Expo framework' }, + rncli: { default: false, description: 'React Native CLI' }, + disableHermes: { default: false, description: 'Disable Hermes' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' } + }, + steps: [ + { + name: 'validate-platform', + description: 'Validate and resolve platform', + execute: async (context: CommandContext) => { + console.log('Validating platform...'); + + if (!context.options.platform) { + throw new Error('Platform is required for bundle and publish workflow'); + } + + const platform = await getPlatform(context.options.platform); + console.log(`✓ Platform resolved: ${platform}`); + + return { + platform, + validated: true + }; + } + }, + { + name: 'check-app-selection', + description: 'Check and select application', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Checking application selection...'); + + try { + const { appId, appKey } = await getSelectedApp(previousResult.platform); + console.log(`✓ Application selected: ${appId}`); + + return { + ...previousResult, + appId, + appKey, + appSelected: true + }; + } catch (error) { + console.log('✗ Failed to select application:', error instanceof Error ? error.message : 'Unknown error'); + throw error; + } + } + }, + { + name: 'create-bundle', + description: 'Create React Native bundle', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Creating React Native bundle...'); + + const bundleOptions = { + platform: previousResult.platform, + name: context.options.name, + description: context.options.description, + metaInfo: context.options.metaInfo, + bundleName: context.options.bundleName || 'index.bundlejs', + entryFile: context.options.entryFile || 'index.js', + output: context.options.output || '${tempDir}/output/${platform}.${time}.ppk', + dev: context.options.dev || false, + sourcemap: context.options.sourcemap || false, + taro: context.options.taro || false, + expo: context.options.expo || false, + rncli: context.options.rncli || false, + disableHermes: context.options.disableHermes || false, + packageId: context.options.packageId, + packageVersion: context.options.packageVersion, + minPackageVersion: context.options.minPackageVersion, + maxPackageVersion: context.options.maxPackageVersion, + packageVersionRange: context.options.packageVersionRange, + rollout: context.options.rollout, + dryRun: context.options.dryRun || false, + 'no-interactive': true // 禁用交互式提示 + }; + + try { + await bundleCommands.bundle({ options: bundleOptions }); + console.log('✓ Bundle created successfully'); + + return { + ...previousResult, + bundleCreated: true, + bundleOptions + }; + } catch (error) { + console.log('✗ Bundle creation failed:', error instanceof Error ? error.message : 'Unknown error'); + throw error; + } + } + }, + { + name: 'publish-version', + description: 'Publish version with bundle', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Publishing version...'); + + // 从 bundle 选项中获取输出路径 + const outputPath = previousResult.bundleOptions.output.replace(/\$\{time\}/g, `${Date.now()}`); + + const publishOptions = { + platform: previousResult.platform, + name: context.options.name, + description: context.options.description, + metaInfo: context.options.metaInfo, + packageId: context.options.packageId, + packageVersion: context.options.packageVersion, + minPackageVersion: context.options.minPackageVersion, + maxPackageVersion: context.options.maxPackageVersion, + packageVersionRange: context.options.packageVersionRange, + rollout: context.options.rollout, + dryRun: context.options.dryRun || false + }; + + try { + const versionName = await versionCommands.publish({ + args: [outputPath], + options: publishOptions + }); + + console.log(`✓ Version published successfully: ${versionName}`); + + return { + ...previousResult, + versionPublished: true, + versionName, + outputPath + }; + } catch (error) { + console.log('✗ Version publication failed:', error instanceof Error ? error.message : 'Unknown error'); + throw error; + } + } + }, + { + name: 'workflow-summary', + description: 'Provide workflow summary', + execute: async (context: CommandContext, previousResult: any) => { + console.log('\n=== Bundle and Publish Summary ==='); + console.log(`Platform: ${previousResult.platform}`); + console.log(`Application: ${previousResult.appId}`); + console.log(`Bundle: Created successfully`); + console.log(`Version: ${previousResult.versionName}`); + console.log(`Output: ${previousResult.outputPath}`); + console.log('=====================================\n'); + + return { + ...previousResult, + workflowComplete: true, + status: 'success' + }; + } + } + ] + }, { name: 'publish-version', description: 'Publish a new version with validation', + options: { + name: { hasValue: true, description: 'Version name' }, + description: { hasValue: true, description: 'Version description' }, + metaInfo: { hasValue: true, description: 'Meta information' }, + platform: { hasValue: true, description: 'Target platform' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' } + }, steps: [ { - name: 'validate', - description: 'Validate version information', + name: 'validate-bundle-file', + description: 'Validate bundle file', execute: async (context: CommandContext) => { - // 验证版本信息 + console.log('Validating bundle file...'); + if (!context.args[0]) { throw new Error('Bundle file is required'); } - return { bundleFile: context.args[0] }; + + const fs = require('fs'); + const bundleFile = context.args[0]; + + if (!fs.existsSync(bundleFile)) { + throw new Error(`Bundle file not found: ${bundleFile}`); + } + + if (!bundleFile.endsWith('.ppk')) { + throw new Error('Bundle file must be a .ppk file'); + } + + const stats = fs.statSync(bundleFile); + const fileSizeInMB = (stats.size / (1024 * 1024)).toFixed(2); + + console.log(`✓ Bundle file validated: ${bundleFile} (${fileSizeInMB} MB)`); + + return { + bundleFile, + fileSize: fileSizeInMB, + validated: true + }; } }, { - name: 'publish', + name: 'resolve-platform', + description: 'Resolve target platform', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Resolving platform...'); + + if (!context.options.platform) { + throw new Error('Platform is required for version publishing'); + } + + const platform = await getPlatform(context.options.platform); + console.log(`✓ Platform resolved: ${platform}`); + + return { + ...previousResult, + platform, + platformResolved: true + }; + } + }, + { + name: 'publish-version', description: 'Publish the version', execute: async (context: CommandContext, previousResult: any) => { - await versionCommands.publish(context); - return { ...previousResult, published: true }; + console.log('Publishing version...'); + + const publishOptions = { + platform: previousResult.platform, + name: context.options.name, + description: context.options.description, + metaInfo: context.options.metaInfo, + packageId: context.options.packageId, + packageVersion: context.options.packageVersion, + minPackageVersion: context.options.minPackageVersion, + maxPackageVersion: context.options.maxPackageVersion, + packageVersionRange: context.options.packageVersionRange, + rollout: context.options.rollout, + dryRun: context.options.dryRun || false + }; + + try { + const versionName = await versionCommands.publish({ + args: [previousResult.bundleFile], + options: publishOptions + }); + + console.log(`✓ Version published successfully: ${versionName}`); + + return { + ...previousResult, + published: true, + versionName + }; + } catch (error) { + console.log('✗ Version publication failed:', error instanceof Error ? error.message : 'Unknown error'); + throw error; + } + } + }, + { + name: 'publish-summary', + description: 'Provide publish summary', + execute: async (context: CommandContext, previousResult: any) => { + console.log('\n=== Version Publish Summary ==='); + console.log(`Bundle: ${previousResult.bundleFile}`); + console.log(`Platform: ${previousResult.platform}`); + console.log(`Version: ${previousResult.versionName}`); + console.log(`Size: ${previousResult.fileSize} MB`); + console.log('================================\n'); + + return { + ...previousResult, + publishComplete: true, + status: 'success' + }; + } + } + ] + }, + { + name: 'update-version-config', + description: 'Update version configuration and package bindings', + options: { + platform: { hasValue: true, description: 'Target platform' }, + versionId: { hasValue: true, description: 'Version ID' }, + packageId: { hasValue: true, description: 'Package ID' }, + packageVersion: { hasValue: true, description: 'Package version' }, + minPackageVersion: { hasValue: true, description: 'Minimum package version' }, + maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, + packageVersionRange: { hasValue: true, description: 'Package version range' }, + rollout: { hasValue: true, description: 'Rollout percentage' }, + dryRun: { default: false, description: 'Dry run mode' } + }, + steps: [ + { + name: 'validate-version-id', + description: 'Validate version ID', + execute: async (context: CommandContext) => { + console.log('Validating version ID...'); + + if (!context.options.versionId) { + throw new Error('Version ID is required for update workflow'); + } + + const versionId = context.options.versionId; + console.log(`✓ Version ID: ${versionId}`); + + return { + versionId, + validated: true + }; + } + }, + { + name: 'resolve-platform', + description: 'Resolve target platform', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Resolving platform...'); + + if (!context.options.platform) { + throw new Error('Platform is required for version update'); + } + + const platform = await getPlatform(context.options.platform); + console.log(`✓ Platform resolved: ${platform}`); + + return { + ...previousResult, + platform, + platformResolved: true + }; + } + }, + { + name: 'update-version', + description: 'Update version configuration', + execute: async (context: CommandContext, previousResult: any) => { + console.log('Updating version configuration...'); + + const updateOptions = { + platform: previousResult.platform, + versionId: previousResult.versionId, + packageId: context.options.packageId, + packageVersion: context.options.packageVersion, + minPackageVersion: context.options.minPackageVersion, + maxPackageVersion: context.options.maxPackageVersion, + packageVersionRange: context.options.packageVersionRange, + rollout: context.options.rollout, + dryRun: context.options.dryRun || false + }; + + try { + await versionCommands.update({ options: updateOptions }); + console.log('✓ Version configuration updated successfully'); + + return { + ...previousResult, + updated: true + }; + } catch (error) { + console.log('✗ Version update failed:', error instanceof Error ? error.message : 'Unknown error'); + throw error; + } + } + }, + { + name: 'update-summary', + description: 'Provide update summary', + execute: async (context: CommandContext, previousResult: any) => { + console.log('\n=== Version Update Summary ==='); + console.log(`Version ID: ${previousResult.versionId}`); + console.log(`Platform: ${previousResult.platform}`); + console.log(`Status: Updated successfully`); + + if (context.options.packageId) { + console.log(`Package ID: ${context.options.packageId}`); + } + if (context.options.packageVersion) { + console.log(`Package Version: ${context.options.packageVersion}`); + } + if (context.options.rollout) { + console.log(`Rollout: ${context.options.rollout}%`); + } + + console.log('==============================\n'); + + return { + ...previousResult, + updateComplete: true, + status: 'success' + }; } } ] diff --git a/src/types.ts b/src/types.ts index 50f2348..74e85b5 100644 --- a/src/types.ts +++ b/src/types.ts @@ -91,6 +91,11 @@ export interface CustomWorkflow { description?: string; steps: WorkflowStep[]; validate?: (context: CommandContext) => boolean; + options?: Record; } export interface CLIProvider { From 33a607342ad19233e276647c5a0f6de90d14fab5 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sun, 13 Jul 2025 18:28:57 +0800 Subject: [PATCH 12/21] udpate --- cli.json | 71 +++++- src/modular-index.ts | 7 - src/modules/app-module.ts | 26 ++- src/modules/bundle-module.ts | 105 +-------- src/modules/package-module.ts | 134 +---------- src/modules/version-module.ts | 424 +--------------------------------- 6 files changed, 95 insertions(+), 672 deletions(-) diff --git a/cli.json b/cli.json index ca208e7..319f7b8 100644 --- a/cli.json +++ b/cli.json @@ -148,7 +148,7 @@ "description": "Bundle javascript code only and optionally publish.", "options": { "dev": { - "default": "false", + "default": "true", "hasValue": true }, "platform": { @@ -307,9 +307,76 @@ "workflow": { "description": "List all workflows", "options": { + "dev": { + "default": "true", + "hasValue": true + }, + "platform": { + "hasValue": true + }, + "bundleName": { + "default": "index.bundlejs", + "hasValue": true + }, + "entryFile": { + "default": "index.js", + "hasValue": true + }, + "intermediaDir": { + "default": "${tempDir}/intermedia/${platform}", + "hasValue": true + }, "output": { - "default": "${tempDir}/output/workflow", + "default": "${tempDir}/output/${platform}.${time}.ppk", "hasValue": true + }, + "sourcemap": { + "default": false + }, + "taro": { + "default": false + }, + "expo": { + "default": false + }, + "rncli": { + "default": false + }, + "disableHermes": { + "default": false + }, + "name": { + "hasValue": true, + "description": "Version name for publishing" + }, + "description": { + "hasValue": true, + "description": "Version description for publishing" + }, + "metaInfo": { + "hasValue": true, + "description": "Meta information for publishing" + }, + "packageId": { + "hasValue": true + }, + "packageVersion": { + "hasValue": true + }, + "minPackageVersion": { + "hasValue": true + }, + "maxPackageVersion": { + "hasValue": true + }, + "packageVersionRange": { + "hasValue": true + }, + "rollout": { + "hasValue": true + }, + "dryRun": { + "default": false } } } diff --git a/src/modular-index.ts b/src/modular-index.ts index 1276e2a..34b97ab 100644 --- a/src/modular-index.ts +++ b/src/modular-index.ts @@ -7,7 +7,6 @@ import { moduleManager } from './module-manager'; import { builtinModules } from './modules'; import type { CommandContext } from './types'; -// 注册内置模块 function registerBuiltinModules() { for (const module of builtinModules) { try { @@ -63,10 +62,8 @@ async function run() { }; try { - // 加载会话 await loadSession(); context.session = require('./api').getSession(); - // 执行命令或工作流 if (argv.command === 'help') { printUsage(); } else if (argv.command === 'list') { @@ -77,7 +74,6 @@ async function run() { console.error('Workflow name is required'); process.exit(1); } - const result = await moduleManager.executeWorkflow(workflowName, context); if (!result.success) { console.error('Workflow execution failed:', result.error); @@ -85,7 +81,6 @@ async function run() { } console.log('Workflow completed successfully:', result.data); } else { - // 执行普通命令 const result = await moduleManager.executeCommand(argv.command, context); if (!result.success) { console.error('Command execution failed:', result.error); @@ -103,12 +98,10 @@ async function run() { } } -// 导出模块管理器，供外部使用 export { moduleManager }; export { CLIProviderImpl } from './provider'; export type { CLIProvider, CLIModule, CommandDefinition, CustomWorkflow, WorkflowStep } from './types'; -// 如果直接运行此文件，则执行CLI if (require.main === module) { run(); } \ No newline at end of file diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts index 77aaf9d..2fc9141 100644 --- a/src/modules/app-module.ts +++ b/src/modules/app-module.ts @@ -109,7 +109,14 @@ export const appModule: CLIModule = { description: 'Create the app', execute: async (context: CommandContext) => { console.log('Creating app in workflow'); - // TODO: 调用实际的appCommands.createApp + const { name, downloadUrl, platform } = context.options; + await appCommands.createApp({ + options: { + name: name || '', + downloadUrl: downloadUrl || '', + platform: platform || '' + } + }); return { appCreated: true }; } }, @@ -118,7 +125,11 @@ export const appModule: CLIModule = { description: 'Select the created app', execute: async (context: CommandContext, previousResult: any) => { console.log('Selecting app in workflow'); - // TODO: 调用实际的appCommands.selectApp + const { platform } = context.options; + await appCommands.selectApp({ + args: [], + options: { platform: platform || '' } + }); return { ...previousResult, appSelected: true }; } } @@ -133,7 +144,10 @@ export const appModule: CLIModule = { description: 'List all apps', execute: async (context: CommandContext) => { console.log('Listing all apps'); - // TODO: 调用实际的appCommands.apps + const { platform } = context.options; + await appCommands.apps({ + options: { platform: platform || '' } + }); return { appsListed: true }; } }, @@ -142,7 +156,11 @@ export const appModule: CLIModule = { description: 'Select target app for operations', execute: async (context: CommandContext, previousResult: any) => { console.log('Selecting target app'); - // TODO: 调用实际的appCommands.selectApp + const { platform } = context.options; + await appCommands.selectApp({ + args: [], + options: { platform: platform || '' } + }); return { ...previousResult, targetAppSelected: true }; } } diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 8eeb235..90b7a91 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -12,6 +12,7 @@ export const bundleModule: CLIModule = { description: 'Bundle javascript code and optionally publish', handler: async (context: CommandContext): Promise => { try { + console.log('😁bundle', context); await bundleCommands.bundle(context); return { success: true, @@ -142,107 +143,5 @@ export const bundleModule: CLIModule = { }, ], - workflows: [ - { - name: 'bundle-and-publish', - description: 'Bundle code and publish to update server', - steps: [ - { - name: 'bundle', - description: 'Create JavaScript bundle', - execute: async (context: CommandContext) => { - const bundleResult = await bundleCommands.bundle(context); - return { bundleFile: context.args[0] }; - } - }, - { - name: 'publish', - description: 'Publish bundle to update server', - execute: async (context: CommandContext, previousResult: any) => { - if (previousResult.bundleFile) { - context.options.bundleFile = previousResult.bundleFile; - } - await versionCommands.publish(context); - return { - success: true, - data: { message: 'publish successfully' } - }; - } - } - ] - }, - { - name: 'generate-diff', - description: 'Generate diff between two versions', - steps: [ - { - name: 'validate-files', - description: 'Validate input files', - execute: async (context: CommandContext) => { - const fs = require('fs'); - const { origin, next } = context.options; - - if (!fs.existsSync(origin)) { - throw new Error(`Original file not found: ${origin}`); - } - if (!fs.existsSync(next)) { - throw new Error(`New file not found: ${next}`); - } - - return { - origin, - next, - validated: true - }; - } - }, - { - name: 'generate-diff', - description: 'Generate diff file', - execute: async (context: CommandContext, previousResult: any) => { - const { origin, next } = previousResult; - const output = context.options.output || `${next}.diff`; - - let diffCommand = 'diff'; - if (origin.endsWith('.apk') || next.endsWith('.apk')) { - diffCommand = 'diffFromApk'; - } else if (origin.endsWith('.ipa') || next.endsWith('.ipa')) { - diffCommand = 'diffFromIpa'; - } else if (origin.endsWith('.app') || next.endsWith('.app')) { - diffCommand = 'hdiffFromApp'; - } - - const diffContext = { - args: [origin, next], - options: { output } - }; - - switch (diffCommand) { - case 'diff': - await bundleCommands.diff(diffContext); - break; - case 'diffFromApk': - await bundleCommands.diffFromApk(diffContext); - break; - case 'diffFromIpa': - await bundleCommands.diffFromIpa(diffContext); - break; - case 'hdiffFromApp': - await bundleCommands.hdiffFromApp(diffContext); - break; - default: - throw new Error(`Unsupported diff command: ${diffCommand}`); - } - - return { - ...previousResult, - output, - diffGenerated: true, - diffCommand - }; - } - } - ] - } - ] + workflows: [] }; \ No newline at end of file diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts index 0b6802f..6badab6 100644 --- a/src/modules/package-module.ts +++ b/src/modules/package-module.ts @@ -148,137 +148,5 @@ export const packageModule: CLIModule = { } ], - workflows: [ - { - name: 'upload-and-publish', - description: 'Upload package and publish version', - options: { - name: { hasValue: true, description: 'Version name' }, - description: { hasValue: true, description: 'Version description' }, - metaInfo: { hasValue: true, description: 'Meta information' }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' }, - platform: { hasValue: true, description: 'Target platform' } - }, - steps: [ - { - name: 'validate-package', - description: 'Validate package file', - execute: async (context: CommandContext) => { - const filePath = context.args[0]; - console.log('Validating package file:', filePath); - - const fs = require('fs'); - if (!fs.existsSync(filePath)) { - throw new Error(`Package file not found: ${filePath}`); - } - - if (!filePath.endsWith('.ipa') && !filePath.endsWith('.apk') && !filePath.endsWith('.app')) { - throw new Error('Unsupported package format. Only .ipa, .apk, and .app files are supported.'); - } - - return { - filePath, - fileType: filePath.split('.').pop(), - validated: true - }; - } - }, - { - name: 'upload-package', - description: 'Upload package to server', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Uploading package:', previousResult.filePath); - - const fileType = previousResult.fileType; - let uploadResult; - - if (fileType === 'ipa') { - uploadResult = await packageCommands.uploadIpa({ args: [previousResult.filePath] }); - } else if (fileType === 'apk') { - uploadResult = await packageCommands.uploadApk({ args: [previousResult.filePath] }); - } else if (fileType === 'app') { - uploadResult = await packageCommands.uploadApp({ args: [previousResult.filePath] }); - } else { - throw new Error(`Unsupported file type: ${fileType}`); - } - - return { - ...previousResult, - uploaded: true, - uploadResult - }; - } - }, - { - name: 'publish-version', - description: 'Publish new version', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Publishing new version'); - - const publishOptions = { - name: context.options.name, - description: context.options.description, - metaInfo: context.options.metaInfo, - packageId: context.options.packageId, - packageVersion: context.options.packageVersion, - minPackageVersion: context.options.minPackageVersion, - maxPackageVersion: context.options.maxPackageVersion, - packageVersionRange: context.options.packageVersionRange, - rollout: context.options.rollout, - dryRun: context.options.dryRun || false, - platform: context.options.platform - }; - - const versionName = await versionCommands.publish({ - args: context.args, - options: publishOptions - }); - - return { - ...previousResult, - published: true, - versionName - }; - } - } - ] - }, - { - name: 'analyze-package', - description: 'Analyze package file information', - steps: [ - { - name: 'parse-package', - description: 'Parse package file information', - execute: async (context: CommandContext) => { - const filePath = context.args[0]; - console.log('Parsing package file:', filePath); - - let packageInfo; - if (filePath.endsWith('.ipa')) { - packageInfo = await packageCommands.parseIpa({ args: [filePath] }); - } else if (filePath.endsWith('.apk')) { - packageInfo = await packageCommands.parseApk({ args: [filePath] }); - } else if (filePath.endsWith('.app')) { - packageInfo = await packageCommands.parseApp({ args: [filePath] }); - } else { - throw new Error('Unsupported package format. Only .ipa, .apk, and .app files are supported.'); - } - - return { - filePath, - packageInfo, - analyzed: true - }; - } - } - ] - } - ] + workflows: [] }; \ No newline at end of file diff --git a/src/modules/version-module.ts b/src/modules/version-module.ts index 9f69727..0c7794c 100644 --- a/src/modules/version-module.ts +++ b/src/modules/version-module.ts @@ -115,427 +115,5 @@ export const versionModule: CLIModule = { } ], - workflows: [ - { - name: 'bundle-and-publish', - description: 'Create bundle and publish version', - options: { - platform: { hasValue: true, description: 'Target platform' }, - name: { hasValue: true, description: 'Version name' }, - description: { hasValue: true, description: 'Version description' }, - metaInfo: { hasValue: true, description: 'Meta information' }, - bundleName: { hasValue: true, description: 'Bundle file name' }, - entryFile: { hasValue: true, description: 'Entry file path' }, - output: { hasValue: true, description: 'Output file path' }, - dev: { default: false, description: 'Development mode' }, - sourcemap: { default: false, description: 'Generate sourcemap' }, - taro: { default: false, description: 'Taro framework' }, - expo: { default: false, description: 'Expo framework' }, - rncli: { default: false, description: 'React Native CLI' }, - disableHermes: { default: false, description: 'Disable Hermes' }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' } - }, - steps: [ - { - name: 'validate-platform', - description: 'Validate and resolve platform', - execute: async (context: CommandContext) => { - console.log('Validating platform...'); - - if (!context.options.platform) { - throw new Error('Platform is required for bundle and publish workflow'); - } - - const platform = await getPlatform(context.options.platform); - console.log(`✓ Platform resolved: ${platform}`); - - return { - platform, - validated: true - }; - } - }, - { - name: 'check-app-selection', - description: 'Check and select application', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Checking application selection...'); - - try { - const { appId, appKey } = await getSelectedApp(previousResult.platform); - console.log(`✓ Application selected: ${appId}`); - - return { - ...previousResult, - appId, - appKey, - appSelected: true - }; - } catch (error) { - console.log('✗ Failed to select application:', error instanceof Error ? error.message : 'Unknown error'); - throw error; - } - } - }, - { - name: 'create-bundle', - description: 'Create React Native bundle', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Creating React Native bundle...'); - - const bundleOptions = { - platform: previousResult.platform, - name: context.options.name, - description: context.options.description, - metaInfo: context.options.metaInfo, - bundleName: context.options.bundleName || 'index.bundlejs', - entryFile: context.options.entryFile || 'index.js', - output: context.options.output || '${tempDir}/output/${platform}.${time}.ppk', - dev: context.options.dev || false, - sourcemap: context.options.sourcemap || false, - taro: context.options.taro || false, - expo: context.options.expo || false, - rncli: context.options.rncli || false, - disableHermes: context.options.disableHermes || false, - packageId: context.options.packageId, - packageVersion: context.options.packageVersion, - minPackageVersion: context.options.minPackageVersion, - maxPackageVersion: context.options.maxPackageVersion, - packageVersionRange: context.options.packageVersionRange, - rollout: context.options.rollout, - dryRun: context.options.dryRun || false, - 'no-interactive': true // 禁用交互式提示 - }; - - try { - await bundleCommands.bundle({ options: bundleOptions }); - console.log('✓ Bundle created successfully'); - - return { - ...previousResult, - bundleCreated: true, - bundleOptions - }; - } catch (error) { - console.log('✗ Bundle creation failed:', error instanceof Error ? error.message : 'Unknown error'); - throw error; - } - } - }, - { - name: 'publish-version', - description: 'Publish version with bundle', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Publishing version...'); - - // 从 bundle 选项中获取输出路径 - const outputPath = previousResult.bundleOptions.output.replace(/\$\{time\}/g, `${Date.now()}`); - - const publishOptions = { - platform: previousResult.platform, - name: context.options.name, - description: context.options.description, - metaInfo: context.options.metaInfo, - packageId: context.options.packageId, - packageVersion: context.options.packageVersion, - minPackageVersion: context.options.minPackageVersion, - maxPackageVersion: context.options.maxPackageVersion, - packageVersionRange: context.options.packageVersionRange, - rollout: context.options.rollout, - dryRun: context.options.dryRun || false - }; - - try { - const versionName = await versionCommands.publish({ - args: [outputPath], - options: publishOptions - }); - - console.log(`✓ Version published successfully: ${versionName}`); - - return { - ...previousResult, - versionPublished: true, - versionName, - outputPath - }; - } catch (error) { - console.log('✗ Version publication failed:', error instanceof Error ? error.message : 'Unknown error'); - throw error; - } - } - }, - { - name: 'workflow-summary', - description: 'Provide workflow summary', - execute: async (context: CommandContext, previousResult: any) => { - console.log('\n=== Bundle and Publish Summary ==='); - console.log(`Platform: ${previousResult.platform}`); - console.log(`Application: ${previousResult.appId}`); - console.log(`Bundle: Created successfully`); - console.log(`Version: ${previousResult.versionName}`); - console.log(`Output: ${previousResult.outputPath}`); - console.log('=====================================\n'); - - return { - ...previousResult, - workflowComplete: true, - status: 'success' - }; - } - } - ] - }, - { - name: 'publish-version', - description: 'Publish a new version with validation', - options: { - name: { hasValue: true, description: 'Version name' }, - description: { hasValue: true, description: 'Version description' }, - metaInfo: { hasValue: true, description: 'Meta information' }, - platform: { hasValue: true, description: 'Target platform' }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' } - }, - steps: [ - { - name: 'validate-bundle-file', - description: 'Validate bundle file', - execute: async (context: CommandContext) => { - console.log('Validating bundle file...'); - - if (!context.args[0]) { - throw new Error('Bundle file is required'); - } - - const fs = require('fs'); - const bundleFile = context.args[0]; - - if (!fs.existsSync(bundleFile)) { - throw new Error(`Bundle file not found: ${bundleFile}`); - } - - if (!bundleFile.endsWith('.ppk')) { - throw new Error('Bundle file must be a .ppk file'); - } - - const stats = fs.statSync(bundleFile); - const fileSizeInMB = (stats.size / (1024 * 1024)).toFixed(2); - - console.log(`✓ Bundle file validated: ${bundleFile} (${fileSizeInMB} MB)`); - - return { - bundleFile, - fileSize: fileSizeInMB, - validated: true - }; - } - }, - { - name: 'resolve-platform', - description: 'Resolve target platform', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Resolving platform...'); - - if (!context.options.platform) { - throw new Error('Platform is required for version publishing'); - } - - const platform = await getPlatform(context.options.platform); - console.log(`✓ Platform resolved: ${platform}`); - - return { - ...previousResult, - platform, - platformResolved: true - }; - } - }, - { - name: 'publish-version', - description: 'Publish the version', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Publishing version...'); - - const publishOptions = { - platform: previousResult.platform, - name: context.options.name, - description: context.options.description, - metaInfo: context.options.metaInfo, - packageId: context.options.packageId, - packageVersion: context.options.packageVersion, - minPackageVersion: context.options.minPackageVersion, - maxPackageVersion: context.options.maxPackageVersion, - packageVersionRange: context.options.packageVersionRange, - rollout: context.options.rollout, - dryRun: context.options.dryRun || false - }; - - try { - const versionName = await versionCommands.publish({ - args: [previousResult.bundleFile], - options: publishOptions - }); - - console.log(`✓ Version published successfully: ${versionName}`); - - return { - ...previousResult, - published: true, - versionName - }; - } catch (error) { - console.log('✗ Version publication failed:', error instanceof Error ? error.message : 'Unknown error'); - throw error; - } - } - }, - { - name: 'publish-summary', - description: 'Provide publish summary', - execute: async (context: CommandContext, previousResult: any) => { - console.log('\n=== Version Publish Summary ==='); - console.log(`Bundle: ${previousResult.bundleFile}`); - console.log(`Platform: ${previousResult.platform}`); - console.log(`Version: ${previousResult.versionName}`); - console.log(`Size: ${previousResult.fileSize} MB`); - console.log('================================\n'); - - return { - ...previousResult, - publishComplete: true, - status: 'success' - }; - } - } - ] - }, - { - name: 'update-version-config', - description: 'Update version configuration and package bindings', - options: { - platform: { hasValue: true, description: 'Target platform' }, - versionId: { hasValue: true, description: 'Version ID' }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' } - }, - steps: [ - { - name: 'validate-version-id', - description: 'Validate version ID', - execute: async (context: CommandContext) => { - console.log('Validating version ID...'); - - if (!context.options.versionId) { - throw new Error('Version ID is required for update workflow'); - } - - const versionId = context.options.versionId; - console.log(`✓ Version ID: ${versionId}`); - - return { - versionId, - validated: true - }; - } - }, - { - name: 'resolve-platform', - description: 'Resolve target platform', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Resolving platform...'); - - if (!context.options.platform) { - throw new Error('Platform is required for version update'); - } - - const platform = await getPlatform(context.options.platform); - console.log(`✓ Platform resolved: ${platform}`); - - return { - ...previousResult, - platform, - platformResolved: true - }; - } - }, - { - name: 'update-version', - description: 'Update version configuration', - execute: async (context: CommandContext, previousResult: any) => { - console.log('Updating version configuration...'); - - const updateOptions = { - platform: previousResult.platform, - versionId: previousResult.versionId, - packageId: context.options.packageId, - packageVersion: context.options.packageVersion, - minPackageVersion: context.options.minPackageVersion, - maxPackageVersion: context.options.maxPackageVersion, - packageVersionRange: context.options.packageVersionRange, - rollout: context.options.rollout, - dryRun: context.options.dryRun || false - }; - - try { - await versionCommands.update({ options: updateOptions }); - console.log('✓ Version configuration updated successfully'); - - return { - ...previousResult, - updated: true - }; - } catch (error) { - console.log('✗ Version update failed:', error instanceof Error ? error.message : 'Unknown error'); - throw error; - } - } - }, - { - name: 'update-summary', - description: 'Provide update summary', - execute: async (context: CommandContext, previousResult: any) => { - console.log('\n=== Version Update Summary ==='); - console.log(`Version ID: ${previousResult.versionId}`); - console.log(`Platform: ${previousResult.platform}`); - console.log(`Status: Updated successfully`); - - if (context.options.packageId) { - console.log(`Package ID: ${context.options.packageId}`); - } - if (context.options.packageVersion) { - console.log(`Package Version: ${context.options.packageVersion}`); - } - if (context.options.rollout) { - console.log(`Rollout: ${context.options.rollout}%`); - } - - console.log('==============================\n'); - - return { - ...previousResult, - updateComplete: true, - status: 'success' - }; - } - } - ] - } - ] + workflows: [] }; \ No newline at end of file From cdeaf8abea713f97b63116c6cad6546b426b5d0c Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Sun, 13 Jul 2025 18:44:06 +0800 Subject: [PATCH 13/21] update --- README.md | 3 +++ src/exports.ts | 4 --- src/index.ts | 3 --- src/modular-index.ts | 5 ---- src/module-manager.ts | 49 +++++++---------------------------- src/modules/app-module.ts | 2 +- src/modules/bundle-module.ts | 2 -- src/modules/index.ts | 1 - src/modules/package-module.ts | 1 - src/provider.ts | 13 +--------- src/types.ts | 6 ----- 11 files changed, 14 insertions(+), 75 deletions(-) diff --git a/README.md b/README.md index 6dbb4b2..829d4fe 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,9 @@ npx pushy-modular help # 列出所有可用命令和工作流 npx pushy-modular list +# 执行内置的工作流 +npx pushy-modular workflow setup-app + # 执行自定义工作流 npx pushy-modular workflow production-release --environment=production --confirm ``` diff --git a/src/exports.ts b/src/exports.ts index ef04296..2fb5c3a 100644 --- a/src/exports.ts +++ b/src/exports.ts @@ -1,8 +1,6 @@ -// 导出模块化CLI的核心功能 export { moduleManager } from './module-manager'; export { CLIProviderImpl } from './provider'; -// 导出类型定义 export type { CLIProvider, CLIModule, @@ -20,7 +18,6 @@ export type { Package } from './types'; -// 导出内置模块 export { builtinModules } from './modules'; export { bundleModule } from './modules/bundle-module'; export { versionModule } from './modules/version-module'; @@ -28,7 +25,6 @@ export { appModule } from './modules/app-module'; export { userModule } from './modules/user-module'; export { packageModule } from './modules/package-module'; -// 导出工具函数 export { loadSession, getSession } from './api'; export { getPlatform, getSelectedApp } from './app'; export { question, saveToLocal } from './utils'; \ No newline at end of file diff --git a/src/index.ts b/src/index.ts index 03b8d98..d8a1e4c 100644 --- a/src/index.ts +++ b/src/index.ts @@ -10,9 +10,6 @@ import { appCommands } from './app'; import { packageCommands } from './package'; function printUsage() { - // const commandName = args[0]; - // TODO: print usage of commandName, or print global usage. - console.log( 'Visit `https://github.com/reactnativecn/react-native-update` for document.', ); diff --git a/src/modular-index.ts b/src/modular-index.ts index 34b97ab..03b2184 100644 --- a/src/modular-index.ts +++ b/src/modular-index.ts @@ -42,20 +42,15 @@ function printUsage() { async function run() { await printVersionCommand(); - // 检查版本参数 if (process.argv.indexOf('-v') >= 0 || process.argv[2] === 'version') { process.exit(); } - - // 注册内置模块 registerBuiltinModules(); - // 解析命令行参数 const argv = require('cli-arguments').parse(require('../cli.json')); global.NO_INTERACTIVE = argv.options['no-interactive']; global.USE_ACC_OSS = argv.options.acc; - // 创建命令上下文 const context: CommandContext = { args: argv.args || [], options: argv.options || {}, diff --git a/src/module-manager.ts b/src/module-manager.ts index f1fe9b3..8c0e050 100644 --- a/src/module-manager.ts +++ b/src/module-manager.ts @@ -11,9 +11,6 @@ export class ModuleManager { this.provider = new CLIProviderImpl(); } - /** - * 注册一个CLI模块 - */ registerModule(module: CLIModule): void { if (this.modules.has(module.name)) { throw new Error(`Module '${module.name}' is already registered`); @@ -21,21 +18,18 @@ export class ModuleManager { this.modules.set(module.name, module); - // 注册模块的命令 if (module.commands) { for (const command of module.commands) { this.registerCommand(command); } } - // 注册模块的工作流 if (module.workflows) { for (const workflow of module.workflows) { this.registerWorkflow(workflow); } } - // 初始化模块 if (module.init) { module.init(this.provider); } @@ -43,30 +37,24 @@ export class ModuleManager { console.log(`Module '${module.name}' (v${module.version}) registered successfully`); } - /** - * 注销一个CLI模块 - */ unregisterModule(moduleName: string): void { const module = this.modules.get(moduleName); if (!module) { throw new Error(`Module '${moduleName}' is not registered`); } - // 清理模块的命令 if (module.commands) { for (const command of module.commands) { this.commands.delete(command.name); } } - // 清理模块的工作流 if (module.workflows) { for (const workflow of module.workflows) { this.workflows.delete(workflow.name); } } - // 清理模块 if (module.cleanup) { module.cleanup(); } @@ -75,9 +63,7 @@ export class ModuleManager { console.log(`Module '${moduleName}' unregistered successfully`); } - /** - * 注册单个命令 - */ + registerCommand(command: CommandDefinition): void { if (this.commands.has(command.name)) { throw new Error(`Command '${command.name}' is already registered`); @@ -85,9 +71,7 @@ export class ModuleManager { this.commands.set(command.name, command); } - /** - * 注册单个工作流 - */ + registerWorkflow(workflow: CustomWorkflow): void { if (this.workflows.has(workflow.name)) { throw new Error(`Workflow '${workflow.name}' is already registered`); @@ -96,30 +80,22 @@ export class ModuleManager { this.provider.registerWorkflow(workflow); } - /** - * 获取所有注册的命令 - */ + getRegisteredCommands(): CommandDefinition[] { return Array.from(this.commands.values()); } - /** - * 获取所有注册的工作流 - */ + getRegisteredWorkflows(): CustomWorkflow[] { return Array.from(this.workflows.values()); } - /** - * 获取所有注册的模块 - */ + getRegisteredModules(): CLIModule[] { return Array.from(this.modules.values()); } - /** - * 执行命令 - */ + async executeCommand(commandName: string, context: any): Promise { const command = this.commands.get(commandName); if (!command) { @@ -129,23 +105,17 @@ export class ModuleManager { return await command.handler(context); } - /** - * 执行工作流 - */ + async executeWorkflow(workflowName: string, context: any): Promise { return await this.provider.executeWorkflow(workflowName, context); } - /** - * 获取CLI提供者实例 - */ + getProvider(): CLIProvider { return this.provider; } - /** - * 列出所有可用的命令和工作流 - */ + listAll(): void { console.log('\n=== Registered Commands ==='); for (const command of this.commands.values()) { @@ -164,5 +134,4 @@ export class ModuleManager { } } -// 创建全局模块管理器实例 export const moduleManager = new ModuleManager(); \ No newline at end of file diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts index 2fc9141..2753970 100644 --- a/src/modules/app-module.ts +++ b/src/modules/app-module.ts @@ -1,4 +1,4 @@ -import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; import { appCommands } from '../app'; export const appModule: CLIModule = { diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 90b7a91..8e173e6 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -1,6 +1,5 @@ import type { CLIModule, CommandContext, CommandResult } from '../types'; import { bundleCommands } from '../bundle'; -import { versionCommands } from '../versions'; export const bundleModule: CLIModule = { name: 'bundle', @@ -12,7 +11,6 @@ export const bundleModule: CLIModule = { description: 'Bundle javascript code and optionally publish', handler: async (context: CommandContext): Promise => { try { - console.log('😁bundle', context); await bundleCommands.bundle(context); return { success: true, diff --git a/src/modules/index.ts b/src/modules/index.ts index 0873fd3..1da317b 100644 --- a/src/modules/index.ts +++ b/src/modules/index.ts @@ -10,7 +10,6 @@ export { appModule } from './app-module'; export { userModule } from './user-module'; export { packageModule } from './package-module'; -// 导出所有内置模块的数组，方便批量注册 export const builtinModules = [ bundleModule, versionModule, diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts index 6badab6..d4eaa11 100644 --- a/src/modules/package-module.ts +++ b/src/modules/package-module.ts @@ -1,6 +1,5 @@ import type { CLIModule, CommandContext, CommandResult } from '../types'; import { packageCommands } from '../package'; -import { versionCommands } from '../versions'; export const packageModule: CLIModule = { name: 'package', diff --git a/src/provider.ts b/src/provider.ts index 5b5ad96..6dd6c86 100644 --- a/src/provider.ts +++ b/src/provider.ts @@ -1,7 +1,5 @@ import { loadSession, getSession } from './api'; import { getPlatform, getSelectedApp } from './app'; -import { question, saveToLocal } from './utils'; -import { t } from './utils/i18n'; import type { CLIProvider, CommandContext, @@ -32,7 +30,6 @@ export class CLIProviderImpl implements CLIProvider { } } - // 核心功能实现 async bundle(options: BundleOptions): Promise { try { const context: CommandContext = { @@ -51,7 +48,6 @@ export class CLIProviderImpl implements CLIProvider { } }; - // 调用实际的bundle命令 const { bundleCommands } = await import('./bundle'); await bundleCommands.bundle(context); @@ -69,7 +65,6 @@ export class CLIProviderImpl implements CLIProvider { async publish(options: PublishOptions): Promise { try { - // 将PublishOptions转换为CommandContext格式 const context: CommandContext = { args: [], options: { @@ -86,7 +81,6 @@ export class CLIProviderImpl implements CLIProvider { } }; - // 调用实际的publish命令 const { versionCommands } = await import('./versions'); await versionCommands.publish(context); @@ -107,7 +101,6 @@ export class CLIProviderImpl implements CLIProvider { const platform = await this.getPlatform(options.platform); const { appId } = await this.getSelectedApp(platform); - // 根据文件类型选择上传命令 const filePath = options.filePath; const fileType = filePath.split('.').pop()?.toLowerCase(); @@ -144,7 +137,6 @@ export class CLIProviderImpl implements CLIProvider { } } - // 应用管理 async getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }> { const resolvedPlatform = await this.getPlatform(platform); return getSelectedApp(resolvedPlatform); @@ -191,7 +183,7 @@ export class CLIProviderImpl implements CLIProvider { } } - // 版本管理（核心） + async listVersions(appId: string): Promise { try { const context: CommandContext = { @@ -239,7 +231,6 @@ export class CLIProviderImpl implements CLIProvider { } } - // 工具函数（核心） async getPlatform(platform?: Platform): Promise { return getPlatform(platform); } @@ -254,8 +245,6 @@ export class CLIProviderImpl implements CLIProvider { } - - // 工作流管理 registerWorkflow(workflow: CustomWorkflow): void { this.workflows.set(workflow.name, workflow); } diff --git a/src/types.ts b/src/types.ts index 74e85b5..833d638 100644 --- a/src/types.ts +++ b/src/types.ts @@ -21,7 +21,6 @@ export interface Version { packages?: Package[]; } -// 新增：模块化CLI相关类型 export interface CommandContext { args: string[]; options: Record; @@ -99,25 +98,20 @@ export interface CustomWorkflow { } export interface CLIProvider { - // 核心业务功能 bundle: (options: BundleOptions) => Promise; publish: (options: PublishOptions) => Promise; upload: (options: UploadOptions) => Promise; - // 应用管理（核心） createApp: (name: string, platform: Platform) => Promise; listApps: (platform?: Platform) => Promise; getSelectedApp: (platform?: Platform) => Promise<{ appId: string; platform: Platform }>; - // 版本管理（核心） listVersions: (appId: string) => Promise; updateVersion: (appId: string, versionId: string, updates: Partial) => Promise; - // 工具函数（核心） getPlatform: (platform?: Platform) => Promise; loadSession: () => Promise; - // 工作流管理 registerWorkflow: (workflow: CustomWorkflow) => void; executeWorkflow: (workflowName: string, context: CommandContext) => Promise; } From 6856c10ddb9b3f1035a2dfde5f74560d91cf61b5 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 14 Jul 2025 09:12:52 +0800 Subject: [PATCH 14/21] update --- README.md | 50 +----- examples/custom-workflow-module.ts | 247 ----------------------------- src/provider.ts | 1 - 3 files changed, 1 insertion(+), 297 deletions(-) delete mode 100644 examples/custom-workflow-module.ts diff --git a/README.md b/README.md index 829d4fe..cc9c9b2 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ npx pushy-modular list npx pushy-modular workflow setup-app # 执行自定义工作流 -npx pushy-modular workflow production-release --environment=production --confirm +npx pushy-modular workflow custom-publish ``` ### 编程方式使用 @@ -264,54 +264,6 @@ interface CLIProvider { } ``` -## 📝 示例 - -### 完整的发布流程 - -```typescript -import { moduleManager } from 'react-native-update-cli'; - -// 注册自定义模块 -moduleManager.registerModule(customPublishModule); - -// 执行生产发布工作流 -const result = await moduleManager.executeWorkflow('production-release', { - args: [], - options: { - environment: 'production', - confirm: true, - versionName: 'v1.2.3', - versionDescription: 'Bug fixes and improvements', - platform: 'ios' - } -}); - -if (result.success) { - console.log('Production release completed:', result.data); -} else { - console.error('Production release failed:', result.error); -} -``` - -### 包管理示例 - -```typescript -// 上传并发布包 -const uploadResult = await moduleManager.executeWorkflow('upload-and-publish', { - args: ['./build/app.ipa'], - options: { - platform: 'ios', - versionName: 'v1.2.3' - } -}); - -// 分析包信息 -const analyzeResult = await moduleManager.executeWorkflow('analyze-package', { - args: ['./build/app.ipa'], - options: {} -}); -``` - ### 自定义命令 ```typescript diff --git a/examples/custom-workflow-module.ts b/examples/custom-workflow-module.ts deleted file mode 100644 index 00684e7..0000000 --- a/examples/custom-workflow-module.ts +++ /dev/null @@ -1,247 +0,0 @@ -import type { CLIModule, CLIProvider, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../src/types'; - -/** - * 示例：自定义发布工作流模块 - * 这个模块展示了如何创建自定义的发布流程 - */ -export const customPublishModule: CLIModule = { - name: 'custom-publish', - version: '1.0.0', - - commands: [ - { - name: 'custom-bundle', - description: 'Custom bundle command with additional validation', - handler: async (context: CommandContext): Promise => { - try { - console.log('Executing custom bundle with validation...'); - - // 自定义验证逻辑 - if (!context.options.platform) { - return { - success: false, - error: 'Platform is required for custom bundle' - }; - } - - // 这里可以添加自定义的打包逻辑 - console.log(`Creating bundle for platform: ${context.options.platform}`); - - return { - success: true, - data: { - message: 'Custom bundle created successfully', - platform: context.options.platform, - timestamp: new Date().toISOString() - } - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Custom bundle failed' - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - validate: { default: true, description: 'Enable validation' }, - optimize: { default: false, description: 'Enable optimization' } - } - } - ], - - workflows: [ - { - name: 'production-release', - description: 'Complete production release workflow', - steps: [ - { - name: 'pre-build-validation', - description: 'Validate project configuration', - execute: async (context: CommandContext) => { - console.log('🔍 Validating project configuration...'); - - // 检查必要的配置文件 - const fs = require('fs'); - const requiredFiles = ['package.json', 'update.json']; - - for (const file of requiredFiles) { - if (!fs.existsSync(file)) { - throw new Error(`Required file not found: ${file}`); - } - } - - console.log('✅ Project validation passed'); - return { validated: true, timestamp: new Date().toISOString() }; - } - }, - { - name: 'create-bundle', - description: 'Create optimized bundle', - execute: async (context: CommandContext, previousResult: any) => { - console.log('📦 Creating production bundle...'); - - // 这里可以调用CLI提供者的bundle方法 - // const provider = context.provider; - // const result = await provider.bundle({ - // platform: context.options.platform, - // dev: false, - // sourcemap: true - // }); - - console.log('✅ Bundle created successfully'); - return { - ...previousResult, - bundleCreated: true, - bundlePath: `./dist/bundle-${Date.now()}.ppk` - }; - }, - condition: (context: CommandContext) => { - // 只在生产模式下执行 - return context.options.environment === 'production'; - } - }, - { - name: 'run-tests', - description: 'Run automated tests', - execute: async (context: CommandContext, previousResult: any) => { - console.log('🧪 Running automated tests...'); - - // 模拟测试执行 - await new Promise(resolve => setTimeout(resolve, 1000)); - - console.log('✅ All tests passed'); - return { - ...previousResult, - testsPassed: true, - testResults: { passed: 10, failed: 0 } - }; - } - }, - { - name: 'publish-version', - description: 'Publish to update server', - execute: async (context: CommandContext, previousResult: any) => { - console.log('🚀 Publishing to update server...'); - - // 这里可以调用CLI提供者的publish方法 - // const provider = context.provider; - // const result = await provider.publish({ - // name: context.options.versionName || 'Production Release', - // description: context.options.versionDescription, - // rollout: 100 - // }); - - console.log('✅ Version published successfully'); - return { - ...previousResult, - published: true, - versionId: `v${Date.now()}` - }; - } - }, - { - name: 'notify-team', - description: 'Send notification to team', - execute: async (context: CommandContext, previousResult: any) => { - console.log('📢 Sending notification to team...'); - - // 模拟发送通知 - const notification = { - type: 'production-release', - version: previousResult.versionId, - timestamp: new Date().toISOString(), - status: 'success' - }; - - console.log('✅ Notification sent:', notification); - return { - ...previousResult, - notified: true, - notification - }; - } - } - ], - validate: (context: CommandContext) => { - // 验证工作流执行条件 - if (!context.options.environment) { - console.error('Environment is required for production release'); - return false; - } - - if (context.options.environment === 'production' && !context.options.confirm) { - console.error('Confirmation required for production release'); - return false; - } - - return true; - } - }, - - { - name: 'staging-release', - description: 'Staging release workflow for testing', - steps: [ - { - name: 'create-staging-bundle', - description: 'Create bundle for staging', - execute: async (context: CommandContext) => { - console.log('📦 Creating staging bundle...'); - return { - bundleCreated: true, - environment: 'staging', - timestamp: new Date().toISOString() - }; - } - }, - { - name: 'publish-staging', - description: 'Publish to staging environment', - execute: async (context: CommandContext, previousResult: any) => { - console.log('🚀 Publishing to staging...'); - return { - ...previousResult, - published: true, - versionId: `staging-${Date.now()}` - }; - } - } - ] - } - ], - - init: (provider: CLIProvider) => { - console.log('🎉 Custom publish module initialized'); - - // 可以在这里进行模块初始化 - // 例如：注册自定义事件监听器、设置配置等 - }, - - cleanup: () => { - console.log('🧹 Custom publish module cleanup'); - - // 清理资源 - } -}; - -/** - * 使用示例： - * - * // 在用户代码中注册自定义模块 - * import { moduleManager } from 'react-native-update-cli'; - * import { customPublishModule } from './custom-workflow-module'; - * - * moduleManager.registerModule(customPublishModule); - * - * // 执行自定义工作流 - * const result = await moduleManager.executeWorkflow('production-release', { - * args: [], - * options: { - * environment: 'production', - * confirm: true, - * versionName: 'v1.2.3', - * versionDescription: 'Bug fixes and improvements' - * } - * }); - */ \ No newline at end of file diff --git a/src/provider.ts b/src/provider.ts index 6dd6c86..1d8fb1c 100644 --- a/src/provider.ts +++ b/src/provider.ts @@ -26,7 +26,6 @@ export class CLIProviderImpl implements CLIProvider { await loadSession(); this.session = getSession(); } catch (error) { - // Session might not be loaded yet, that's okay } } From 67e8742873e8ba1df96d05899307e2b591d7a5c3 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 14 Jul 2025 09:19:26 +0800 Subject: [PATCH 15/21] update --- .gitignore | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/.gitignore b/.gitignore index 9ddd9a8..4a00a28 100644 --- a/.gitignore +++ b/.gitignore @@ -104,8 +104,4 @@ dist .tern-port lib/ -.DS_Store - -# react-native-update -.update -.pushy \ No newline at end of file +.DS_Store \ No newline at end of file From 72af4e672b81ed25e53b1e19eb1eff3fe3f8b6a9 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 14 Jul 2025 09:27:46 +0800 Subject: [PATCH 16/21] udpate --- cli.json | 71 ++------------------------------------------------------ 1 file changed, 2 insertions(+), 69 deletions(-) diff --git a/cli.json b/cli.json index 319f7b8..ca208e7 100644 --- a/cli.json +++ b/cli.json @@ -148,7 +148,7 @@ "description": "Bundle javascript code only and optionally publish.", "options": { "dev": { - "default": "true", + "default": "false", "hasValue": true }, "platform": { @@ -307,76 +307,9 @@ "workflow": { "description": "List all workflows", "options": { - "dev": { - "default": "true", - "hasValue": true - }, - "platform": { - "hasValue": true - }, - "bundleName": { - "default": "index.bundlejs", - "hasValue": true - }, - "entryFile": { - "default": "index.js", - "hasValue": true - }, - "intermediaDir": { - "default": "${tempDir}/intermedia/${platform}", - "hasValue": true - }, "output": { - "default": "${tempDir}/output/${platform}.${time}.ppk", + "default": "${tempDir}/output/workflow", "hasValue": true - }, - "sourcemap": { - "default": false - }, - "taro": { - "default": false - }, - "expo": { - "default": false - }, - "rncli": { - "default": false - }, - "disableHermes": { - "default": false - }, - "name": { - "hasValue": true, - "description": "Version name for publishing" - }, - "description": { - "hasValue": true, - "description": "Version description for publishing" - }, - "metaInfo": { - "hasValue": true, - "description": "Meta information for publishing" - }, - "packageId": { - "hasValue": true - }, - "packageVersion": { - "hasValue": true - }, - "minPackageVersion": { - "hasValue": true - }, - "maxPackageVersion": { - "hasValue": true - }, - "packageVersionRange": { - "hasValue": true - }, - "rollout": { - "hasValue": true - }, - "dryRun": { - "default": false } } } From 28fd75b00a9cf1cc42f79c4627a88d7c24af9920 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 14 Jul 2025 09:55:39 +0800 Subject: [PATCH 17/21] udpate --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index f18df91..9fbc653 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "react-native-update-cli", - "version": "1.46.3", + "version": "1.46.2", "description": "command line tool for react-native-update (remote updates for react native)", "main": "index.js", "bin": { From 544091741532195b07141d060c95da919589bbed Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 21 Jul 2025 09:01:26 +0800 Subject: [PATCH 18/21] add example --- cli.json | 2 +- example/ENHANCED_WORKFLOWS.md | 471 +++++ example/README.md | 374 ++++ example/modules/analytics-module.ts | 149 ++ example/modules/custom-deploy-module.ts | 315 +++ example/package.json | 41 + example/scripts/enhanced-workflow-demo.ts | 552 +++++ example/scripts/provider-api-example.ts | 342 +++ example/scripts/register-modules.ts | 155 ++ example/scripts/workflow-demo.ts | 290 +++ example/tsconfig.json | 23 + example/workflows/custom-workflows.ts | 582 +++++ example/workflows/enhanced-core-workflows.ts | 1552 ++++++++++++++ example/yarn.lock | 1863 +++++++++++++++++ package.json | 21 +- src/api.ts | 14 +- src/app.ts | 4 +- src/bundle.ts | 61 +- src/exports.ts | 4 +- src/index.ts | 8 +- src/modular-index.ts | 34 +- src/module-manager.ts | 40 +- src/modules/app-module.ts | 253 ++- src/modules/bundle-module.ts | 296 ++- src/modules/index.ts | 10 +- src/modules/package-module.ts | 64 +- src/modules/user-module.ts | 317 +-- src/modules/version-module.ts | 79 +- src/package.ts | 45 +- src/provider.ts | 170 +- src/types.ts | 55 +- src/user.ts | 6 +- src/utils/app-info-parser/apk.js | 114 +- src/utils/app-info-parser/app.js | 10 +- src/utils/app-info-parser/ipa.js | 126 +- src/utils/app-info-parser/resource-finder.js | 104 +- src/utils/app-info-parser/utils.js | 113 +- .../app-info-parser/xml-parser/binary.js | 720 +++---- .../app-info-parser/xml-parser/manifest.js | 282 +-- src/utils/app-info-parser/zip.js | 2 +- src/utils/check-plugin.ts | 6 +- src/utils/dep-versions.ts | 19 +- src/utils/git.ts | 2 +- src/utils/i18n.ts | 4 +- src/utils/index.ts | 18 +- src/utils/latest-version/cli.ts | 8 +- src/utils/latest-version/index.ts | 34 +- src/utils/plugin-config.ts | 6 +- src/versions.ts | 6 +- test-modules.js | 79 + 50 files changed, 8617 insertions(+), 1228 deletions(-) create mode 100644 example/ENHANCED_WORKFLOWS.md create mode 100644 example/README.md create mode 100644 example/modules/analytics-module.ts create mode 100644 example/modules/custom-deploy-module.ts create mode 100644 example/package.json create mode 100644 example/scripts/enhanced-workflow-demo.ts create mode 100644 example/scripts/provider-api-example.ts create mode 100644 example/scripts/register-modules.ts create mode 100644 example/scripts/workflow-demo.ts create mode 100644 example/tsconfig.json create mode 100644 example/workflows/custom-workflows.ts create mode 100644 example/workflows/enhanced-core-workflows.ts create mode 100644 example/yarn.lock create mode 100644 test-modules.js diff --git a/cli.json b/cli.json index ca208e7..d9a7f8f 100644 --- a/cli.json +++ b/cli.json @@ -319,4 +319,4 @@ "default": false } } -} \ No newline at end of file +} diff --git a/example/ENHANCED_WORKFLOWS.md b/example/ENHANCED_WORKFLOWS.md new file mode 100644 index 0000000..252d67d --- /dev/null +++ b/example/ENHANCED_WORKFLOWS.md @@ -0,0 +1,471 @@ +# 核心模块增强工作流 + +这个文档详细介绍了为React Native Update CLI核心模块设计的增强工作流，包括`app-module`、`bundle-module`、`package-module`、`user-module`、`version-module`的高级工作流功能。 + +## 📋 目录 + +- [App模块工作流](#app模块工作流) +- [Bundle模块工作流](#bundle模块工作流) +- [Package模块工作流](#package模块工作流) +- [User模块工作流](#user模块工作流) +- [Version模块工作流](#version模块工作流) +- [工作流使用示例](#工作流使用示例) +- [最佳实践](#最佳实践) + +## 🚀 快速开始 + +```bash +# 运行所有增强工作流演示 +npx ts-node example/scripts/enhanced-workflow-demo.ts + +# 交互式执行特定工作流 +npx ts-node example/scripts/enhanced-workflow-demo.ts interactive [工作流名称] [参数...] + +# 示例：应用初始化 +npx ts-node example/scripts/enhanced-workflow-demo.ts interactive app-initialization --name MyApp --platform ios + +# 示例：智能打包 +npx ts-node example/scripts/enhanced-workflow-demo.ts interactive intelligent-bundle --platform android --optimize true + +# 示例：版本发布 +npx ts-node example/scripts/enhanced-workflow-demo.ts interactive version-release-management --name v1.0.0 --platform ios --dryRun true +``` + +--- + +## 📱 App模块工作流 + +### 1. 应用初始化工作流 (`app-initialization`) + +**用途**: 完整的应用创建和初始化流程 + +**功能特性**: +- ✅ 参数验证和格式检查 +- ✅ 应用存在性检查和冲突处理 +- ✅ 应用创建和配置 +- ✅ 自动选择新创建的应用 +- ✅ 完整性验证和健康检查 + +**工作流步骤**: +1. **参数验证**: 检查应用名称、平台、下载URL格式 +2. **存在性检查**: 验证应用是否已存在，支持强制覆盖 +3. **应用创建**: 执行应用创建操作 +4. **基本配置**: 设置更新策略、安全参数、版本控制 +5. **应用选择**: 自动选择新创建的应用 +6. **设置验证**: 验证应用配置的完整性和可用性 + +**使用示例**: +```typescript +await moduleManager.executeWorkflow('app-initialization', { + args: [], + options: { + name: 'MyAwesomeApp', // 应用名称 (必需) + platform: 'ios', // 平台 (必需) + downloadUrl: 'https://...', // 下载URL (可选) + force: false // 强制覆盖 (可选) + } +}); +``` + +**适用场景**: +- 新项目应用创建 +- 多环境应用设置 +- 自动化部署脚本 + +### 2. 多平台应用管理工作流 (`multi-platform-app-management`) + +**用途**: 跨平台应用统一管理和优化 + +**功能特性**: +- 🔍 全平台应用扫描 +- 📊 应用状态分析和统计 +- ⚡ 自动优化建议和执行 +- 📈 应用健康度评估 + +**工作流步骤**: +1. **平台扫描**: 扫描iOS、Android、Harmony平台的所有应用 +2. **状态分析**: 分析应用活跃度、版本分布、平台分布 +3. **问题识别**: 识别非活跃应用、配置问题 +4. **自动优化**: 执行应用配置优化和清理 + +**使用示例**: +```typescript +await moduleManager.executeWorkflow('multi-platform-app-management', { + args: [], + options: { + includeInactive: true, // 包含非活跃应用 + autoOptimize: true // 自动优化配置 + } +}); +``` + +**适用场景**: +- 应用生态管理 +- 定期健康检查 +- 批量优化操作 + +--- + +## 📦 Bundle模块工作流 + +### 1. 智能打包工作流 (`intelligent-bundle`) + +**用途**: 自动优化的多平台智能构建 + +**功能特性**: +- 🖥️ 构建环境自动检测 +- 📂 项目结构智能分析 +- ⚙️ 自动优化配置 +- 🏗️ 多平台并行构建 +- 🔍 构建质量检查 + +**工作流步骤**: +1. **环境检测**: 检查Node.js版本、内存、平台兼容性 +2. **项目分析**: 分析项目类型、依赖、预估大小 +3. **优化设置**: 根据项目特征自动配置优化选项 +4. **多平台构建**: 并行构建指定平台或所有平台 +5. **质量检查**: 检查构建质量、包大小、构建时间 + +**使用示例**: +```typescript +await moduleManager.executeWorkflow('intelligent-bundle', { + args: [], + options: { + platform: 'ios', // 目标平台 (可选，不指定则构建所有) + dev: false, // 开发模式 + sourcemap: true, // 生成源码映射 + optimize: true // 启用自动优化 + } +}); +``` + +**适用场景**: +- 自动化CI/CD构建 +- 多平台发布准备 +- 性能优化构建 + +### 2. 增量构建工作流 (`incremental-build`) + +**用途**: 高效的增量更新包生成 + +**功能特性**: +- 🔍 自动基准版本检测 +- 🏗️ 当前版本构建 +- 📥 基准版本下载 +- 🔄 智能差异计算 +- ✅ 差异包验证 + +**工作流步骤**: +1. **基准检测**: 自动检测或使用指定的基准版本 +2. **当前构建**: 构建当前版本的Bundle +3. **基准下载**: 下载基准版本的Bundle文件 +4. **差异生成**: 计算并生成差异包 +5. **验证测试**: 验证差异包的完整性和可用性 + +**使用示例**: +```typescript +await moduleManager.executeWorkflow('incremental-build', { + args: [], + options: { + platform: 'android', // 目标平台 (必需) + baseVersion: 'v1.0.0', // 基准版本 (可选，自动检测) + skipValidation: false // 跳过验证 + } +}); +``` + +**适用场景**: +- 热更新包生成 +- 减少更新下载大小 +- 快速增量发布 + +--- + +## 📄 Package模块工作流 + +### 1. 批量包处理工作流 (`batch-package-processing`) + +**用途**: 批量处理多个应用包文件 + +**功能特性**: +- 🔍 智能文件扫描 +- 📊 包信息分析统计 +- 🔍 批量内容解析 +- 📤 自动上传处理 +- 📋 详细处理报告 + +**工作流步骤**: +1. **文件扫描**: 扫描指定目录的包文件（IPA、APK、APP） +2. **信息分析**: 分析包大小、平台分布、版本信息 +3. **内容解析**: 批量解析包的元信息、权限、资源 +4. **批量上传**: 自动上传解析成功的包文件 +5. **报告生成**: 生成详细的处理报告和统计信息 + +**使用示例**: +```typescript +await moduleManager.executeWorkflow('batch-package-processing', { + args: [], + options: { + directory: './packages', // 包文件目录 + pattern: '*.{ipa,apk,app}', // 文件匹配模式 + skipUpload: false // 跳过上传步骤 + } +}); +``` + +**适用场景**: +- 批量包文件处理 +- 包文件质量检查 +- 自动化包管理 + +--- + +## 👤 User模块工作流 + +> User模块已经在现有代码中包含了完善的工作流： + +### 1. 认证状态检查工作流 (`auth-check`) + +**功能特性**: +- 🔐 会话状态检查 +- ✅ 服务端验证 +- 👤 用户信息获取 +- 🔄 自动登录支持 + +### 2. 完整登录流程工作流 (`login-flow`) + +**功能特性**: +- 🔍 现有会话检查 +- 🔐 用户登录执行 +- ✅ 登录状态验证 +- 📋 流程状态汇总 + +--- + +## 🏷️ Version模块工作流 + +### 1. 版本发布管理工作流 (`version-release-management`) + +**用途**: 完整的版本发布生命周期管理 + +**功能特性**: +- 🔍 发布前全面检查 +- ✅ 版本信息验证 +- ⚙️ 发布参数配置 +- 🚀 发布执行和监控 +- 📊 发布后监控分析 +- 📋 完整发布报告 + +**工作流步骤**: +1. **发布前检查**: 验证版本格式、平台支持、构建环境、依赖完整性 +2. **版本验证**: 检查版本冲突、规范性、发布类型 +3. **发布准备**: 生成发布说明、配置分发参数、设置回滚策略 +4. **执行发布**: 上传版本包、更新信息、配置分发、激活版本 +5. **发布监控**: 监控下载成功率、安装成功率、崩溃率等关键指标 +6. **发布总结**: 生成完整的发布报告和统计信息 + +**使用示例**: +```typescript +await moduleManager.executeWorkflow('version-release-management', { + args: [], + options: { + name: 'v2.1.0', // 版本名称 (必需) + description: 'Major update', // 版本描述 + platform: 'ios', // 目标平台 (必需) + rollout: 50, // 发布覆盖率 + packageVersion: '2.1.0', // 包版本号 + dryRun: false, // 模拟发布 + force: false // 强制发布 + } +}); +``` + +**适用场景**: +- 正式版本发布 +- 灰度发布管理 +- 发布质量控制 + +--- + +## 🔗 工作流使用示例 + +### 1. 完整发布流程组合 + +```typescript +// 完整的应用发布流程 +async function completeReleaseFlow() { + // 1. 应用初始化 + await moduleManager.executeWorkflow('app-initialization', { + args: [], + options: { + name: 'ProductionApp', + platform: 'ios', + force: true + } + }); + + // 2. 智能打包 + await moduleManager.executeWorkflow('intelligent-bundle', { + args: [], + options: { + platform: 'ios', + dev: false, + optimize: true + } + }); + + // 3. 版本发布 + await moduleManager.executeWorkflow('version-release-management', { + args: [], + options: { + name: 'v1.0.0', + platform: 'ios', + rollout: 100 + } + }); +} +``` + +### 2. 多平台批量构建 + +```typescript +async function multiPlatformBuild() { + const platforms = ['ios', 'android', 'harmony']; + + for (const platform of platforms) { + await moduleManager.executeWorkflow('intelligent-bundle', { + args: [], + options: { + platform, + dev: false, + optimize: true + } + }); + } +} +``` + +### 3. 增量更新流程 + +```typescript +async function incrementalUpdateFlow() { + // 1. 生成增量包 + const buildResult = await moduleManager.executeWorkflow('incremental-build', { + args: [], + options: { + platform: 'android', + baseVersion: 'v1.0.0' + } + }); + + // 2. 发布增量更新 + if (buildResult.success) { + await moduleManager.executeWorkflow('version-release-management', { + args: [], + options: { + name: 'v1.0.1', + platform: 'android', + rollout: 20 // 小范围发布 + } + }); + } +} +``` + +--- + +## 📋 最佳实践 + +### 1. 工作流选择指南 + +| 场景 | 推荐工作流 | 配置建议 | +|------|------------|----------| +| 新应用创建 | `app-initialization` | 启用force参数避免冲突 | +| 生产发布 | `intelligent-bundle` + `version-release-management` | 关闭dev模式，启用优化 | +| 热更新 | `incremental-build` | 指定合适的基准版本 | +| 批量管理 | `batch-package-processing` | 定期执行包文件清理 | +| 灰度发布 | `version-release-management` | 设置合适的rollout比例 | + +### 2. 错误处理策略 + +```typescript +async function robustWorkflowExecution() { + try { + const result = await moduleManager.executeWorkflow('app-initialization', { + args: [], + options: { name: 'MyApp', platform: 'ios' } + }); + + if (!result.success) { + console.error('工作流执行失败:', result.error); + // 执行回滚或重试逻辑 + } + } catch (error) { + console.error('工作流异常:', error); + // 异常处理逻辑 + } +} +``` + +### 3. 工作流监控 + +```typescript +// 工作流执行监控 +const workflowMonitor = { + async executeWithMonitoring(workflowName: string, context: any) { + const startTime = Date.now(); + console.log(`开始执行工作流: ${workflowName}`); + + try { + const result = await moduleManager.executeWorkflow(workflowName, context); + const duration = Date.now() - startTime; + + console.log(`工作流执行完成: ${workflowName}, 耗时: ${duration}ms`); + return result; + } catch (error) { + const duration = Date.now() - startTime; + console.error(`工作流执行失败: ${workflowName}, 耗时: ${duration}ms`, error); + throw error; + } + } +}; +``` + +### 4. 配置管理 + +```typescript +// 工作流配置管理 +const workflowConfigs = { + development: { + 'intelligent-bundle': { dev: true, optimize: false }, + 'version-release-management': { dryRun: true, rollout: 10 } + }, + production: { + 'intelligent-bundle': { dev: false, optimize: true }, + 'version-release-management': { dryRun: false, rollout: 100 } + } +}; + +async function executeWithConfig(workflowName: string, environment: string) { + const config = workflowConfigs[environment]?.[workflowName] || {}; + + return await moduleManager.executeWorkflow(workflowName, { + args: [], + options: config + }); +} +``` + +--- + +## 🎯 总结 + +这些增强的核心工作流为React Native Update CLI提供了： + +1. **完整的应用生命周期管理** - 从创建到发布的全流程覆盖 +2. **智能化构建和优化** - 自动环境检测和性能优化 +3. **高效的增量更新** - 减少更新包大小，提升用户体验 +4. **批量处理能力** - 提高大规模应用管理效率 +5. **规范化发布流程** - 确保发布质量和一致性 + +每个工作流都经过精心设计，包含详细的步骤、错误处理、进度反馈和结果验证，为开发者提供了强大而可靠的自动化工具。 \ No newline at end of file diff --git a/example/README.md b/example/README.md new file mode 100644 index 0000000..4c7788b --- /dev/null +++ b/example/README.md @@ -0,0 +1,374 @@ +# 自定义模块和工作流示例 + +这个目录包含了 React Native Update CLI 自定义模块和工作流的完整示例，演示如何扩展 CLI 的功能。 + +## 📁 目录结构 + +``` +example/ +├── modules/ # 自定义模块示例 +│ ├── custom-deploy-module.ts # 自定义部署模块 +│ └── analytics-module.ts # 分析统计模块 +├── workflows/ # 自定义工作流示例 +│ └── custom-workflows.ts # 复杂工作流集合 +├── scripts/ # 执行脚本示例 +│ ├── register-modules.ts # 模块注册和执行 +│ ├── provider-api-example.ts # Provider API 使用示例 +│ └── workflow-demo.ts # 工作流演示脚本 +└── README.md # 本文档 +``` + +## 🚀 快速开始 + +### 1. 运行模块注册和执行示例 + +```bash +# 编译TypeScript (如果需要) +npm run build + +# 运行模块示例 +npx ts-node example/scripts/register-modules.ts +``` + +### 2. 运行Provider API示例 + +```bash +npx ts-node example/scripts/provider-api-example.ts +``` + +### 3. 运行工作流演示 + +```bash +# 运行所有工作流演示 +npx ts-node example/scripts/workflow-demo.ts + +# 交互式执行特定工作流 +npx ts-node example/scripts/workflow-demo.ts interactive canary-deployment --version 1.0.0 --initialRollout 5 + +# 多环境部署工作流 +npx ts-node example/scripts/workflow-demo.ts interactive multi-env-deploy --version 1.0.0 + +# 回滚工作流 +npx ts-node example/scripts/workflow-demo.ts interactive rollback-workflow --targetVersion 0.9.5 +``` + +## 📦 自定义模块示例 + +### 1. 自定义部署模块 (`custom-deploy-module.ts`) + +这个模块演示了如何创建一个完整的部署管理模块，包含： + +#### 命令： +- `deploy-dev`: 部署到开发环境 +- `deploy-prod`: 部署到生产环境 +- `rollback`: 回滚到指定版本 + +#### 工作流： +- `full-deploy`: 完整部署流程（开发 → 测试 → 生产） +- `hotfix-deploy`: 热修复快速部署流程 + +#### 使用示例： +```typescript +import { moduleManager } from 'react-native-update-cli'; +import { customDeployModule } from './modules/custom-deploy-module'; + +// 注册模块 +moduleManager.registerModule(customDeployModule); + +// 执行开发部署 +await moduleManager.executeCommand('deploy-dev', { + args: [], + options: { platform: 'ios', force: true } +}); + +// 执行完整部署工作流 +await moduleManager.executeWorkflow('full-deploy', { + args: [], + options: { version: '1.2.3' } +}); +``` + +### 2. 分析统计模块 (`analytics-module.ts`) + +演示如何创建分析和统计功能： + +#### 命令： +- `track-deployment`: 记录部署统计信息 +- `deployment-report`: 生成部署报告 + +#### 工作流： +- `deploy-with-analytics`: 带统计的部署流程 + +## 🔄 自定义工作流示例 + +### 1. 灰度发布工作流 (`canary-deployment`) + +实现完整的灰度发布流程： + +- ✅ 准备灰度发布环境 +- ✅ 初始小范围部署 +- ✅ 监控关键指标 +- ✅ 基于指标自动扩大发布范围 +- ✅ 最终验证 + +```typescript +await moduleManager.executeWorkflow('canary-deployment', { + args: [], + options: { + version: '2.1.0', + initialRollout: 10, // 初始10%用户 + autoExpand: true // 自动扩大范围 + } +}); +``` + +### 2. 多环境发布工作流 (`multi-env-deploy`) + +实现标准的多环境发布流程： + +- ✅ 部署到开发环境 +- ✅ 运行集成测试 +- ✅ 部署到预发布环境 +- ✅ 运行端到端测试 +- ✅ 部署到生产环境 +- ✅ 部署后验证 + +```typescript +await moduleManager.executeWorkflow('multi-env-deploy', { + args: [], + options: { + version: '2.1.0', + skipProduction: false, // 不跳过生产部署 + forceProduction: false // 测试失败时不强制部署 + } +}); +``` + +### 3. 回滚工作流 (`rollback-workflow`) + +安全的应用回滚流程： + +- ✅ 验证目标版本 +- ✅ 备份当前状态 +- ✅ 执行回滚操作 +- ✅ 验证回滚结果 +- ✅ 通知相关人员 + +```typescript +await moduleManager.executeWorkflow('rollback-workflow', { + args: [], + options: { + targetVersion: '2.0.5', + skipVerification: false + } +}); +``` + +## 🛠️ Provider API 使用示例 + +Provider API 提供了编程式接口，适合在应用程序中集成： + +### 基本使用 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +const provider = moduleManager.getProvider(); + +// 打包应用 +const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +const publishResult = await provider.publish({ + name: 'v1.0.0', + description: 'Bug fixes', + rollout: 100 +}); + +// 上传文件 +const uploadResult = await provider.upload({ + filePath: 'app.ipa', + platform: 'ios' +}); +``` + +### 应用管理 + +```typescript +// 创建应用 +await provider.createApp('MyApp', 'ios'); + +// 获取当前应用 +const { appId, platform } = await provider.getSelectedApp('ios'); + +// 列出版本 +const versions = await provider.listVersions(appId); + +// 更新版本 +await provider.updateVersion(appId, versionId, { + name: 'v1.1.0', + description: 'New features' +}); +``` + +### 自动化服务类 + +```typescript +class DeploymentService { + private provider = moduleManager.getProvider(); + + async buildAndPublish(platform: Platform, version: string) { + // 1. 打包 + const bundleResult = await this.provider.bundle({ + platform, dev: false, sourcemap: true + }); + + // 2. 发布 + const publishResult = await this.provider.publish({ + name: version, rollout: 100 + }); + + return { bundleResult, publishResult }; + } +} +``` + +## 🎯 高级特性 + +### 1. 工作流验证 + +```typescript +const workflow: CustomWorkflow = { + name: 'my-workflow', + steps: [...], + validate: (context) => { + if (!context.options.version) { + console.error('必须指定版本号'); + return false; + } + return true; + } +}; +``` + +### 2. 条件执行 + +```typescript +const step: WorkflowStep = { + name: 'conditional-step', + execute: async (context) => { /* ... */ }, + condition: (context) => { + return context.options.environment === 'production'; + } +}; +``` + +### 3. 错误处理 + +```typescript +try { + const result = await moduleManager.executeCommand('deploy-prod', { + args: [], + options: {} // 缺少必需参数 + }); +} catch (error) { + console.error('执行失败:', error.message); +} +``` + +### 4. 自定义工作流注册 + +```typescript +const provider = moduleManager.getProvider(); + +provider.registerWorkflow({ + name: 'custom-workflow', + description: '自定义工作流', + steps: [ + { + name: 'step1', + execute: async (context, previousResult) => { + // 执行逻辑 + return { step1: 'completed' }; + } + } + ] +}); + +// 执行工作流 +await provider.executeWorkflow('custom-workflow', { + args: [], + options: {} +}); +``` + +## 📝 最佳实践 + +### 1. 模块设计 + +- **单一职责**: 每个模块专注于特定功能领域 +- **清晰命名**: 使用描述性的命令和选项名称 +- **完整文档**: 为所有命令和选项提供描述 +- **错误处理**: 提供清晰的错误信息和恢复建议 + +### 2. 工作流设计 + +- **原子操作**: 每个步骤应该是原子的，可独立执行 +- **状态传递**: 合理使用 previousResult 传递状态 +- **错误恢复**: 考虑失败时的清理和恢复机制 +- **进度反馈**: 提供清晰的进度信息给用户 + +### 3. 开发建议 + +- **类型安全**: 充分利用 TypeScript 类型系统 +- **测试覆盖**: 为自定义模块编写测试 +- **文档维护**: 保持示例和文档的同步更新 +- **版本管理**: 为模块设置合适的版本号 + +## 🐛 故障排除 + +### 常见问题 + +1. **模块注册失败** + ```typescript + // 确保模块符合 CLIModule 接口 + const module: CLIModule = { + name: 'my-module', + version: '1.0.0', + commands: [...], + workflows: [...] + }; + ``` + +2. **命令执行失败** + ```typescript + // 检查命令名称和参数 + await moduleManager.executeCommand('correct-command-name', { + args: [], + options: { requiredParam: 'value' } + }); + ``` + +3. **工作流验证失败** + ```typescript + // 确保提供所有必需的选项 + await moduleManager.executeWorkflow('workflow-name', { + args: [], + options: { version: '1.0.0' } // 必需参数 + }); + ``` + +## 📖 相关文档 + +- [主项目 README](../README.md) +- [模块化架构文档](../docs/architecture.md) +- [API 参考文档](../docs/api-reference.md) +- [贡献指南](../CONTRIBUTING.md) + +## 🤝 贡献 + +欢迎提交更多示例和改进建议！请查看主项目的贡献指南。 \ No newline at end of file diff --git a/example/modules/analytics-module.ts b/example/modules/analytics-module.ts new file mode 100644 index 0000000..83e111b --- /dev/null +++ b/example/modules/analytics-module.ts @@ -0,0 +1,149 @@ +import type { + CLIModule, + CLIProvider, + CommandContext, + CommandResult, +} from '../../src/types'; + +/** + * 分析统计模块示例 + * 演示一个简单的分析统计功能模块 + */ +export const analyticsModule: CLIModule = { + name: 'analytics', + version: '1.0.0', + commands: [ + { + name: 'track-deployment', + description: '记录部署统计信息', + handler: async (context: CommandContext): Promise => { + console.log('📊 记录部署统计信息...'); + + const { platform, environment, version } = context.options; + + const deploymentData = { + timestamp: new Date().toISOString(), + platform: platform || 'unknown', + environment: environment || 'unknown', + version: version || 'unknown', + success: true, + duration: Math.floor(Math.random() * 1000) + 500, // 模拟部署时长 + }; + + console.log('✅ 部署统计已记录:'); + console.log(JSON.stringify(deploymentData, null, 2)); + + return { + success: true, + data: deploymentData, + }; + }, + options: { + platform: { + hasValue: true, + description: '平台', + }, + environment: { + hasValue: true, + description: '环境', + }, + version: { + hasValue: true, + description: '版本', + }, + }, + }, + + { + name: 'deployment-report', + description: '生成部署报告', + handler: async (context: CommandContext): Promise => { + console.log('📈 生成部署报告...'); + + const { days = 7 } = context.options; + + // 模拟生成报告数据 + const report = { + period: `最近 ${days} 天`, + totalDeployments: Math.floor(Math.random() * 50) + 10, + successRate: 95.5, + averageDuration: '2.3分钟', + platformBreakdown: { + ios: 45, + android: 38, + harmony: 12, + }, + environmentBreakdown: { + development: 60, + staging: 25, + production: 15, + }, + }; + + console.log('📊 部署报告:'); + console.log(JSON.stringify(report, null, 2)); + + return { + success: true, + data: report, + }; + }, + options: { + days: { + hasValue: true, + default: 7, + description: '报告天数', + }, + }, + }, + ], + + workflows: [ + { + name: 'deploy-with-analytics', + description: '带统计的部署流程', + steps: [ + { + name: 'pre-deployment', + description: '部署前准备', + execute: async (context: CommandContext) => { + console.log('📋 部署前准备...'); + return { startTime: Date.now() }; + }, + }, + { + name: 'deployment', + description: '执行部署', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 执行部署...'); + await new Promise((resolve) => setTimeout(resolve, 2000)); + return { ...previousResult, deploymentCompleted: true }; + }, + }, + { + name: 'record-analytics', + description: '记录统计信息', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📊 记录统计信息...'); + const duration = Date.now() - previousResult.startTime; + const analytics = { + duration, + timestamp: new Date().toISOString(), + success: true, + }; + console.log(`✅ 部署完成，耗时 ${duration}ms`); + return { ...previousResult, analytics }; + }, + }, + ], + }, + ], + + init: (provider: CLIProvider) => { + console.log('📊 分析统计模块已初始化'); + }, + + cleanup: () => { + console.log('🧹 分析统计模块清理完成'); + }, +}; diff --git a/example/modules/custom-deploy-module.ts b/example/modules/custom-deploy-module.ts new file mode 100644 index 0000000..ba4b8d7 --- /dev/null +++ b/example/modules/custom-deploy-module.ts @@ -0,0 +1,315 @@ +import type { + CLIModule, + CLIProvider, + CommandContext, + CommandDefinition, + CommandResult, + CustomWorkflow, +} from '../../src/types'; + +/** + * 自定义部署模块示例 + * 演示如何创建一个包含多个命令和工作流的自定义模块 + */ +export const customDeployModule: CLIModule = { + name: 'custom-deploy', + version: '1.0.0', + + commands: [ + { + name: 'deploy-dev', + description: '部署到开发环境', + handler: async (context: CommandContext): Promise => { + console.log('🚀 开始部署到开发环境...'); + + const { platform = 'ios', force = false } = context.options; + + try { + // 模拟部署逻辑 + console.log(`📱 平台: ${platform}`); + console.log(`🔧 强制部署: ${force ? '是' : '否'}`); + + // 模拟一些部署步骤 + console.log('1. 检查环境配置...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + + console.log('2. 构建应用包...'); + await new Promise((resolve) => setTimeout(resolve, 1500)); + + console.log('3. 上传到开发服务器...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + + console.log('✅ 部署到开发环境完成!'); + + return { + success: true, + data: { + environment: 'development', + platform, + deployTime: new Date().toISOString(), + buildId: `dev-${Date.now()}`, + }, + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : '部署失败', + }; + } + }, + options: { + platform: { + hasValue: true, + default: 'ios', + description: '目标平台 (ios/android/harmony)', + }, + force: { + hasValue: false, + default: false, + description: '强制部署，跳过确认', + }, + }, + }, + + { + name: 'deploy-prod', + description: '部署到生产环境', + handler: async (context: CommandContext): Promise => { + console.log('🔥 开始部署到生产环境...'); + + const { version, rollout = 100 } = context.options; + + if (!version) { + return { + success: false, + error: '生产部署必须指定版本号', + }; + } + + try { + console.log(`📦 版本: ${version}`); + console.log(`📊 发布比例: ${rollout}%`); + + console.log('1. 安全检查...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + + console.log('2. 生产构建...'); + await new Promise((resolve) => setTimeout(resolve, 2000)); + + console.log('3. 部署到生产环境...'); + await new Promise((resolve) => setTimeout(resolve, 1500)); + + console.log('4. 健康检查...'); + await new Promise((resolve) => setTimeout(resolve, 800)); + + console.log('🎉 生产部署完成!'); + + return { + success: true, + data: { + environment: 'production', + version, + rollout, + deployTime: new Date().toISOString(), + buildId: `prod-${Date.now()}`, + }, + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : '生产部署失败', + }; + } + }, + options: { + version: { + hasValue: true, + description: '版本号 (必需)', + }, + rollout: { + hasValue: true, + default: 100, + description: '发布比例 (0-100)', + }, + }, + }, + + { + name: 'rollback', + description: '回滚到指定版本', + handler: async (context: CommandContext): Promise => { + console.log('🔄 开始回滚操作...'); + + const { version, immediate = false } = context.options; + + if (!version) { + return { + success: false, + error: '回滚操作必须指定目标版本', + }; + } + + try { + console.log(`🎯 目标版本: ${version}`); + console.log(`⚡ 立即回滚: ${immediate ? '是' : '否'}`); + + console.log('1. 验证目标版本...'); + await new Promise((resolve) => setTimeout(resolve, 800)); + + console.log('2. 准备回滚...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + + console.log('3. 执行回滚...'); + await new Promise((resolve) => setTimeout(resolve, 1200)); + + console.log('✅ 回滚完成!'); + + return { + success: true, + data: { + targetVersion: version, + rollbackTime: new Date().toISOString(), + immediate, + }, + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : '回滚失败', + }; + } + }, + options: { + version: { + hasValue: true, + description: '目标版本号 (必需)', + }, + immediate: { + hasValue: false, + default: false, + description: '立即回滚，不等待确认', + }, + }, + }, + ], + + workflows: [ + { + name: 'full-deploy', + description: '完整部署流程：开发 -> 测试 -> 生产', + steps: [ + { + name: 'deploy-to-dev', + description: '部署到开发环境', + execute: async (context: CommandContext) => { + console.log('🔧 步骤 1: 部署到开发环境'); + // 这里可以调用其他命令或执行自定义逻辑 + return { environment: 'dev', status: 'completed' }; + }, + }, + { + name: 'run-tests', + description: '运行自动化测试', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🧪 步骤 2: 运行自动化测试'); + console.log(' - 单元测试...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + console.log(' - 集成测试...'); + await new Promise((resolve) => setTimeout(resolve, 1500)); + console.log(' - E2E测试...'); + await new Promise((resolve) => setTimeout(resolve, 2000)); + return { ...previousResult, tests: 'passed' }; + }, + }, + { + name: 'deploy-to-prod', + description: '部署到生产环境', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 步骤 3: 部署到生产环境'); + if (previousResult.tests !== 'passed') { + throw new Error('测试未通过，无法部署到生产环境'); + } + return { + ...previousResult, + environment: 'production', + status: 'deployed', + }; + }, + condition: (context: CommandContext) => { + // 只有在非跳过生产部署的情况下才执行 + return !context.options.skipProd; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.version) { + console.error('❌ 完整部署流程需要指定版本号'); + return false; + } + return true; + }, + options: { + version: { + hasValue: true, + description: '版本号 (必需)', + }, + skipProd: { + hasValue: false, + default: false, + description: '跳过生产部署', + }, + }, + }, + + { + name: 'hotfix-deploy', + description: '热修复快速部署流程', + steps: [ + { + name: 'validate-hotfix', + description: '验证热修复', + execute: async (context: CommandContext) => { + console.log('🔍 验证热修复内容...'); + const { hotfixId } = context.options; + if (!hotfixId) { + throw new Error('缺少热修复ID'); + } + return { hotfixId, validated: true }; + }, + }, + { + name: 'emergency-deploy', + description: '紧急部署', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚨 执行紧急部署...'); + console.log('⚡ 快速构建...'); + await new Promise((resolve) => setTimeout(resolve, 800)); + console.log('🚀 立即发布...'); + await new Promise((resolve) => setTimeout(resolve, 600)); + return { + ...previousResult, + deployed: true, + deployTime: new Date().toISOString(), + }; + }, + }, + ], + options: { + hotfixId: { + hasValue: true, + description: '热修复ID (必需)', + }, + }, + }, + ], + + init: (provider: CLIProvider) => { + console.log('🎯 自定义部署模块已初始化'); + console.log(' 可用命令: deploy-dev, deploy-prod, rollback'); + console.log(' 可用工作流: full-deploy, hotfix-deploy'); + }, + + cleanup: () => { + console.log('🧹 自定义部署模块清理完成'); + }, +}; diff --git a/example/package.json b/example/package.json new file mode 100644 index 0000000..b712024 --- /dev/null +++ b/example/package.json @@ -0,0 +1,41 @@ +{ + "name": "react-native-update-cli-examples", + "version": "1.0.0", + "description": "React Native Update CLI 自定义模块和工作流示例", + "private": true, + "scripts": { + "build": "tsc --noEmit --skipLibCheck", + "register-modules": "ts-node scripts/register-modules.ts", + "provider-demo": "ts-node scripts/provider-api-example.ts", + "workflow-demo": "ts-node scripts/workflow-demo.ts", + "workflow-interactive": "ts-node scripts/workflow-demo.ts interactive", + "enhanced-workflow-demo": "ts-node scripts/enhanced-workflow-demo.ts", + "enhanced-workflow-interactive": "ts-node scripts/enhanced-workflow-demo.ts interactive", + "demo:all": "npm run register-modules && npm run provider-demo && npm run workflow-demo && npm run enhanced-workflow-demo", + "demo:canary": "npm run workflow-interactive canary-deployment -- --version 1.0.0 --initialRollout 5", + "demo:multi-env": "npm run workflow-interactive multi-env-deploy -- --version 1.0.0", + "demo:rollback": "npm run workflow-interactive rollback-workflow -- --targetVersion 0.9.5", + "demo:app-init": "npm run enhanced-workflow-interactive app-initialization -- --name MyApp --platform ios", + "demo:smart-bundle": "npm run enhanced-workflow-interactive intelligent-bundle -- --platform android --optimize true", + "demo:version-release": "npm run enhanced-workflow-interactive version-release-management -- --name v1.0.0 --platform ios --dryRun true" + }, + "dependencies": { + "react-native-update-cli": "file:../" + }, + "devDependencies": { + "@types/node": "^20.0.0", + "ts-node": "^10.9.0", + "typescript": "^5.0.0" + }, + "keywords": [ + "react-native", + "update", + "cli", + "module", + "workflow", + "example", + "custom" + ], + "author": "reactnativecn", + "license": "BSD-3-Clause" +} diff --git a/example/scripts/enhanced-workflow-demo.ts b/example/scripts/enhanced-workflow-demo.ts new file mode 100644 index 0000000..bbf5496 --- /dev/null +++ b/example/scripts/enhanced-workflow-demo.ts @@ -0,0 +1,552 @@ +#!/usr/bin/env ts-node + +import { moduleManager } from '../../src/module-manager'; +import { enhancedCoreWorkflows } from '../workflows/enhanced-core-workflows'; + +/** + * 增强核心工作流演示脚本 + * 展示如何使用为核心模块设计的高级工作流 + */ + +async function registerEnhancedWorkflows() { + console.log('📦 注册增强核心工作流...\n'); + + const provider = moduleManager.getProvider(); + + // 注册所有增强核心工作流 + enhancedCoreWorkflows.forEach((workflow) => { + provider.registerWorkflow(workflow); + console.log(`✅ 注册工作流: ${workflow.name}`); + console.log(` 描述: ${workflow.description}`); + console.log(` 步骤数: ${workflow.steps.length}`); + console.log(); + }); + + console.log('📋 所有增强核心工作流注册完成\n'); +} + +/** + * 演示App模块工作流 + */ +async function demonstrateAppWorkflows() { + console.log('📱 演示App模块增强工作流\n'); + console.log('='.repeat(70)); + + // 1. 应用初始化工作流 + console.log('🚀 应用初始化工作流演示'); + console.log('-'.repeat(40)); + + try { + const initResult = await moduleManager.executeWorkflow( + 'app-initialization', + { + args: [], + options: { + name: 'MyAwesomeApp', + platform: 'ios', + downloadUrl: 'https://example.com/download', + force: false, + }, + }, + ); + + console.log('\\n📊 应用初始化结果:'); + console.log( + `创建状态: ${initResult.data?.created ? '✅ 成功' : '❌ 失败'}`, + ); + console.log( + `配置状态: ${initResult.data?.configured ? '✅ 成功' : '❌ 失败'}`, + ); + console.log( + `验证状态: ${initResult.data?.verified ? '✅ 成功' : '❌ 失败'}`, + ); + } catch (error) { + console.error( + '❌ 应用初始化工作流失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '-'.repeat(40)); + + // 2. 多平台应用管理工作流 + console.log('\\n🌍 多平台应用管理工作流演示'); + console.log('-'.repeat(40)); + + try { + const managementResult = await moduleManager.executeWorkflow( + 'multi-platform-app-management', + { + args: [], + options: { + includeInactive: true, + autoOptimize: true, + }, + }, + ); + + console.log('\\n📊 多平台管理结果:'); + if (managementResult.data?.analysis) { + const analysis = managementResult.data.analysis; + console.log(`总应用数: ${analysis.totalApps}`); + console.log(`活跃应用: ${analysis.activeApps}`); + console.log(`平台分布: ${JSON.stringify(analysis.platformDistribution)}`); + } + } catch (error) { + console.error( + '❌ 多平台应用管理工作流失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '='.repeat(70) + '\\n'); +} + +/** + * 演示Bundle模块工作流 + */ +async function demonstrateBundleWorkflows() { + console.log('📦 演示Bundle模块增强工作流\n'); + console.log('='.repeat(70)); + + // 1. 智能打包工作流 + console.log('🧠 智能打包工作流演示'); + console.log('-'.repeat(40)); + + try { + const bundleResult = await moduleManager.executeWorkflow( + 'intelligent-bundle', + { + args: [], + options: { + platform: 'ios', + dev: false, + sourcemap: true, + optimize: true, + }, + }, + ); + + console.log('\\n📊 智能打包结果:'); + if (bundleResult.data?.buildResults) { + const builds = bundleResult.data.buildResults; + builds.forEach((build: any) => { + console.log( + `${build.platform}: ${build.success ? '✅ 成功' : '❌ 失败'} (${build.buildTime}s, ${build.bundleSize}MB)`, + ); + }); + } + + if (bundleResult.data?.averageScore) { + console.log(`平均质量评分: ${bundleResult.data.averageScore}%`); + } + } catch (error) { + console.error( + '❌ 智能打包工作流失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '-'.repeat(40)); + + // 2. 增量构建工作流 + console.log('\\n🔄 增量构建工作流演示'); + console.log('-'.repeat(40)); + + try { + const incrementalResult = await moduleManager.executeWorkflow( + 'incremental-build', + { + args: [], + options: { + platform: 'android', + baseVersion: 'v1.0.0', + skipValidation: false, + }, + }, + ); + + console.log('\\n📊 增量构建结果:'); + if (incrementalResult.data?.diffPackage) { + const diff = incrementalResult.data.diffPackage; + console.log(`基准版本: ${diff.fromVersion}`); + console.log(`目标版本: ${diff.toVersion}`); + console.log(`原始大小: ${diff.originalSize}MB`); + console.log(`差异包大小: ${diff.diffSize}MB`); + console.log(`压缩比: ${diff.compressionRatio}%`); + } + + console.log( + `验证状态: ${incrementalResult.data?.allValid ? '✅ 通过' : '❌ 失败'}`, + ); + } catch (error) { + console.error( + '❌ 增量构建工作流失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '='.repeat(70) + '\\n'); +} + +/** + * 演示Package模块工作流 + */ +async function demonstratePackageWorkflows() { + console.log('📄 演示Package模块增强工作流\n'); + console.log('='.repeat(70)); + + // 批量包处理工作流 + console.log('📦 批量包处理工作流演示'); + console.log('-'.repeat(40)); + + try { + const packageResult = await moduleManager.executeWorkflow( + 'batch-package-processing', + { + args: [], + options: { + directory: './packages', + pattern: '*.{ipa,apk,app}', + skipUpload: false, + }, + }, + ); + + console.log('\\n📊 批量包处理结果:'); + if (packageResult.data?.report) { + const report = packageResult.data.report; + console.log(`总包数: ${report.summary.totalPackages}`); + console.log(`解析成功: ${report.summary.parsedSuccessfully}`); + console.log(`上传成功: ${report.summary.uploadedSuccessfully}`); + console.log(`总大小: ${report.summary.totalSize.toFixed(1)}MB`); + + if (report.failedOperations.length > 0) { + console.log('\\n❌ 失败操作:'); + report.failedOperations.forEach((op: any) => { + console.log(` ${op.operation}: ${op.file}`); + }); + } + } + } catch (error) { + console.error( + '❌ 批量包处理工作流失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '='.repeat(70) + '\\n'); +} + +/** + * 演示Version模块工作流 + */ +async function demonstrateVersionWorkflows() { + console.log('🏷️ 演示Version模块增强工作流\n'); + console.log('='.repeat(70)); + + // 版本发布管理工作流 + console.log('🚀 版本发布管理工作流演示'); + console.log('-'.repeat(40)); + + try { + const versionResult = await moduleManager.executeWorkflow( + 'version-release-management', + { + args: [], + options: { + name: 'v2.1.0', + description: 'Major feature update with bug fixes', + platform: 'ios', + rollout: 50, + dryRun: true, // 使用模拟发布 + force: false, + }, + }, + ); + + console.log('\\n📊 版本发布结果:'); + if (versionResult.data?.summary) { + const summary = versionResult.data.summary; + console.log(`版本: ${summary.version}`); + console.log(`平台: ${summary.platform}`); + console.log(`发布状态: ${summary.success ? '✅ 成功' : '❌ 失败'}`); + console.log( + `监控状态: ${summary.monitoringHealthy ? '✅ 正常' : '⚠️ 有警告'}`, + ); + + if (summary.releaseId) { + console.log(`发布ID: ${summary.releaseId}`); + } + } + + if (versionResult.data?.dryRun) { + console.log('\\n🔍 这是一次模拟发布，未实际执行'); + } + } catch (error) { + console.error( + '❌ 版本发布管理工作流失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '='.repeat(70) + '\\n'); +} + +/** + * 演示工作流组合使用 + */ +async function demonstrateWorkflowComposition() { + console.log('🔗 演示工作流组合使用\n'); + console.log('='.repeat(70)); + + console.log('📋 完整发布流程演示 (应用初始化 → 智能打包 → 版本发布)'); + console.log('-'.repeat(60)); + + try { + // 1. 应用初始化 + console.log('\\n步骤 1: 应用初始化'); + const appResult = await moduleManager.executeWorkflow( + 'app-initialization', + { + args: [], + options: { + name: 'CompositeApp', + platform: 'android', + force: true, + }, + }, + ); + + if (!appResult.success) { + throw new Error('应用初始化失败'); + } + + // 2. 智能打包 + console.log('\\n步骤 2: 智能打包'); + const bundleResult = await moduleManager.executeWorkflow( + 'intelligent-bundle', + { + args: [], + options: { + platform: 'android', + dev: false, + optimize: true, + }, + }, + ); + + if (!bundleResult.success) { + throw new Error('智能打包失败'); + } + + // 3. 版本发布 + console.log('\\n步骤 3: 版本发布'); + const releaseResult = await moduleManager.executeWorkflow( + 'version-release-management', + { + args: [], + options: { + name: 'v1.0.0', + description: 'Initial release via composition workflow', + platform: 'android', + rollout: 10, + dryRun: true, + }, + }, + ); + + if (!releaseResult.success) { + throw new Error('版本发布失败'); + } + + console.log('\\n🎉 完整发布流程执行成功!'); + console.log('📊 流程总结:'); + console.log( + ` ✅ 应用初始化: ${appResult.data?.created ? '成功' : '失败'}`, + ); + console.log( + ` ✅ 智能打包: ${bundleResult.data?.allSuccess ? '成功' : '失败'}`, + ); + console.log( + ` ✅ 版本发布: ${releaseResult.data?.summary?.success ? '成功' : '失败'}`, + ); + } catch (error) { + console.error( + '❌ 工作流组合执行失败:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\\n' + '='.repeat(70) + '\\n'); +} + +/** + * 列出所有增强工作流及其用途 + */ +async function listEnhancedWorkflows() { + console.log('📋 增强核心工作流列表\n'); + console.log('='.repeat(70)); + + const workflowCategories = { + App模块工作流: [ + { + name: 'app-initialization', + description: '完整应用初始化流程 - 创建、配置、验证', + useCase: '新应用创建和设置', + }, + { + name: 'multi-platform-app-management', + description: '多平台应用统一管理工作流', + useCase: '跨平台应用管理和优化', + }, + ], + Bundle模块工作流: [ + { + name: 'intelligent-bundle', + description: '智能打包工作流 - 自动优化和多平台构建', + useCase: '高效的自动化构建', + }, + { + name: 'incremental-build', + description: '增量构建工作流 - 生成差异包', + useCase: '减少更新包大小', + }, + ], + Package模块工作流: [ + { + name: 'batch-package-processing', + description: '批量包处理工作流 - 上传、解析、验证', + useCase: '批量处理应用包文件', + }, + ], + Version模块工作流: [ + { + name: 'version-release-management', + description: '版本发布管理工作流 - 完整的版本发布生命周期', + useCase: '规范化版本发布流程', + }, + ], + }; + + Object.entries(workflowCategories).forEach(([category, workflows]) => { + console.log(`\\n📂 ${category}:`); + console.log('-'.repeat(50)); + + workflows.forEach((workflow, index) => { + console.log(`${index + 1}. ${workflow.name}`); + console.log(` 描述: ${workflow.description}`); + console.log(` 用途: ${workflow.useCase}`); + console.log(); + }); + }); + + console.log('='.repeat(70) + '\\n'); +} + +/** + * 主函数 + */ +async function main() { + console.log('🎯 增强核心工作流演示脚本\\n'); + + try { + // 1. 注册增强工作流 + await registerEnhancedWorkflows(); + + // 2. 列出所有工作流 + await listEnhancedWorkflows(); + + // 3. 演示各模块工作流 + await demonstrateAppWorkflows(); + await demonstrateBundleWorkflows(); + await demonstratePackageWorkflows(); + await demonstrateVersionWorkflows(); + + // 4. 演示工作流组合 + await demonstrateWorkflowComposition(); + + console.log('🎉 所有增强核心工作流演示完成!'); + } catch (error) { + console.error('❌ 演示过程中发生错误:', error); + process.exit(1); + } +} + +/** + * 交互式工作流执行 + */ +async function interactiveEnhancedWorkflowExecution() { + console.log('\\n🎮 交互式增强工作流执行\\n'); + + const workflowName = process.argv[3]; + + if (!workflowName) { + console.log('使用方法:'); + console.log(' npm run enhanced-workflow-demo [工作流名称]'); + console.log('\\n可用的增强工作流:'); + console.log(' App模块:'); + console.log(' - app-initialization'); + console.log(' - multi-platform-app-management'); + console.log(' Bundle模块:'); + console.log(' - intelligent-bundle'); + console.log(' - incremental-build'); + console.log(' Package模块:'); + console.log(' - batch-package-processing'); + console.log(' Version模块:'); + console.log(' - version-release-management'); + return; + } + + // 解析命令行参数 + const options: Record = {}; + for (let i = 4; i < process.argv.length; i += 2) { + const key = process.argv[i]?.replace(/^--/, ''); + const value = process.argv[i + 1]; + if (key && value) { + // 尝试解析布尔值和数字 + if (value === 'true') options[key] = true; + else if (value === 'false') options[key] = false; + else if (/^\d+$/.test(value)) options[key] = Number.parseInt(value); + else options[key] = value; + } + } + + console.log(`执行增强工作流: ${workflowName}`); + console.log('参数:', options); + console.log(); + + try { + await registerEnhancedWorkflows(); + + const result = await moduleManager.executeWorkflow(workflowName, { + args: [], + options, + }); + + console.log('\\n📊 工作流执行结果:'); + console.log(JSON.stringify(result, null, 2)); + } catch (error) { + console.error('❌ 工作流执行失败:', error); + process.exit(1); + } +} + +// 执行脚本 +if (require.main === module) { + if (process.argv.length > 2 && process.argv[2] === 'interactive') { + interactiveEnhancedWorkflowExecution() + .then(() => process.exit(0)) + .catch((error) => { + console.error('❌ 交互式执行失败:', error); + process.exit(1); + }); + } else { + main() + .then(() => process.exit(0)) + .catch((error) => { + console.error('❌ 演示脚本执行失败:', error); + process.exit(1); + }); + } +} diff --git a/example/scripts/provider-api-example.ts b/example/scripts/provider-api-example.ts new file mode 100644 index 0000000..7cbff65 --- /dev/null +++ b/example/scripts/provider-api-example.ts @@ -0,0 +1,342 @@ +#!/usr/bin/env ts-node + +import { moduleManager } from '../../src/module-manager'; +import type { CLIProvider, Platform } from '../../src/types'; + +/** + * Provider API 使用示例 + * 演示如何使用 CLIProvider 进行编程式操作 + */ + +class DeploymentService { + private provider: CLIProvider; + + constructor() { + this.provider = moduleManager.getProvider(); + } + + /** + * 自动化构建和发布流程 + */ + async buildAndPublish(platform: Platform, version: string) { + console.log( + `🚀 开始 ${platform} 平台的构建和发布流程 (版本: ${version})\n`, + ); + + try { + // 1. 打包应用 + console.log('📦 正在打包应用...'); + const bundleResult = await this.provider.bundle({ + platform, + dev: false, + sourcemap: true, + bundleName: `app-${version}.bundle`, + }); + + if (!bundleResult.success) { + throw new Error(`打包失败: ${bundleResult.error}`); + } + console.log('✅ 打包完成'); + + // 2. 发布版本 + console.log('\n📡 正在发布版本...'); + const publishResult = await this.provider.publish({ + name: version, + description: `自动发布版本 ${version}`, + rollout: 100, + }); + + if (!publishResult.success) { + throw new Error(`发布失败: ${publishResult.error}`); + } + console.log('✅ 发布完成'); + + return { + success: true, + bundleData: bundleResult.data, + publishData: publishResult.data, + }; + } catch (error) { + console.error('❌ 构建发布失败:', error); + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error', + }; + } + } + + /** + * 应用管理示例 + */ + async manageApp(platform: Platform) { + console.log(`📱 管理 ${platform} 应用\n`); + + try { + // 获取当前选中的应用 + const { appId } = await this.provider.getSelectedApp(platform); + console.log(`当前应用ID: ${appId}`); + + // 列出应用版本 + const versionsResult = await this.provider.listVersions(appId); + if (versionsResult.success && versionsResult.data) { + console.log('📋 应用版本列表:'); + versionsResult.data.forEach((version: any, index: number) => { + console.log(` ${index + 1}. ${version.name} (${version.id})`); + }); + } + + // 列出应用包 + const packagesResult = await (this.provider as any).listPackages(appId); + if (packagesResult.success && packagesResult.data) { + console.log('\n📦 应用包列表:'); + packagesResult.data.forEach((pkg: any, index: number) => { + console.log(` ${index + 1}. ${pkg.name} (${pkg.id})`); + }); + } + + return { appId, platform }; + } catch (error) { + console.error('❌ 应用管理失败:', error); + throw error; + } + } + + /** + * 批量操作示例 + */ + async batchOperations() { + console.log('🔄 批量操作示例\n'); + + const platforms: Platform[] = ['ios', 'android']; + const results = []; + + for (const platform of platforms) { + try { + console.log(`--- 处理 ${platform} 平台 ---`); + + // 获取平台信息 + const platformInfo = await this.provider.getPlatform(platform); + console.log(`平台: ${platformInfo}`); + + // 模拟打包操作 + const bundleResult = await this.provider.bundle({ + platform, + dev: true, + sourcemap: false, + }); + + results.push({ + platform, + success: bundleResult.success, + data: bundleResult.data, + }); + + console.log( + `${platform} 处理完成: ${bundleResult.success ? '✅' : '❌'}\n`, + ); + } catch (error) { + console.error(`${platform} 处理失败:`, error); + results.push({ + platform, + success: false, + error: error instanceof Error ? error.message : 'Unknown error', + }); + } + } + + return results; + } + + /** + * 文件上传示例 + */ + async uploadExample() { + console.log('📤 文件上传示例\n'); + + // 模拟上传文件路径 + const mockFilePaths = { + ios: '/path/to/app.ipa', + android: '/path/to/app.apk', + }; + + try { + for (const [platform, filePath] of Object.entries(mockFilePaths)) { + console.log(`上传 ${platform} 文件: ${filePath}`); + + // 注意：这里是模拟，实际使用时需要真实的文件路径 + const uploadResult = await this.provider.upload({ + platform: platform as Platform, + filePath, + appId: 'mock-app-id', + }); + + console.log( + `${platform} 上传结果:`, + uploadResult.success ? '✅' : '❌', + ); + if (!uploadResult.success) { + console.log(`错误: ${uploadResult.error}`); + } + } + } catch (error) { + console.error('❌ 上传过程中发生错误:', error); + } + } +} + +/** + * 高级工作流示例 + */ +async function demonstrateAdvancedWorkflows() { + console.log('\n🔧 高级工作流示例\n'); + + const provider = moduleManager.getProvider(); + + // 注册自定义工作流 + provider.registerWorkflow({ + name: 'advanced-ci-cd', + description: '高级CI/CD流程', + steps: [ + { + name: 'environment-check', + description: '环境检查', + execute: async (context) => { + console.log('🔍 检查环境配置...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + return { environmentValid: true }; + }, + }, + { + name: 'quality-gate', + description: '质量门禁', + execute: async (context, previousResult) => { + console.log('🛡️ 执行质量门禁检查...'); + await new Promise((resolve) => setTimeout(resolve, 1500)); + + // 模拟质量检查 + const qualityScore = Math.random() * 100; + const passed = qualityScore > 80; + + console.log( + `质量分数: ${qualityScore.toFixed(1)}/100 ${passed ? '✅' : '❌'}`, + ); + + if (!passed) { + throw new Error('质量门禁检查未通过'); + } + + return { ...previousResult, qualityScore }; + }, + }, + { + name: 'multi-platform-build', + description: '多平台构建', + execute: async (context, previousResult) => { + console.log('🏗️ 多平台并行构建...'); + + const platforms: Platform[] = ['ios', 'android']; + const buildResults = []; + + // 模拟并行构建 + for (const platform of platforms) { + console.log(` 构建 ${platform}...`); + await new Promise((resolve) => setTimeout(resolve, 800)); + buildResults.push({ platform, success: true }); + } + + return { ...previousResult, builds: buildResults }; + }, + }, + { + name: 'deployment-notification', + description: '部署通知', + execute: async (context, previousResult) => { + console.log('📢 发送部署通知...'); + + const notification = { + message: '部署完成', + platforms: previousResult.builds?.map((b: any) => b.platform) || [], + timestamp: new Date().toISOString(), + }; + + console.log('通知内容:', JSON.stringify(notification, null, 2)); + + return { ...previousResult, notification }; + }, + }, + ], + validate: (context) => { + if (!context.options.environment) { + console.error('❌ 必须指定环境参数'); + return false; + } + return true; + }, + options: { + environment: { + hasValue: true, + description: '部署环境 (必需)', + }, + }, + }); + + // 执行高级工作流 + try { + const result = await provider.executeWorkflow('advanced-ci-cd', { + args: [], + options: { + environment: 'production', + }, + }); + console.log('\n🎉 高级工作流执行完成:', result); + } catch (error) { + console.error('❌ 高级工作流执行失败:', error); + } +} + +/** + * 主函数 + */ +async function main() { + console.log('🎯 Provider API 使用示例\n'); + + const service = new DeploymentService(); + + try { + // 1. 构建和发布示例 + await service.buildAndPublish('ios', '1.2.3'); + console.log('\n' + '='.repeat(50) + '\n'); + + // 2. 应用管理示例 + await service.manageApp('ios'); + console.log('\n' + '='.repeat(50) + '\n'); + + // 3. 批量操作示例 + const batchResults = await service.batchOperations(); + console.log('批量操作结果:', batchResults); + console.log('\n' + '='.repeat(50) + '\n'); + + // 4. 文件上传示例 + await service.uploadExample(); + console.log('\n' + '='.repeat(50) + '\n'); + + // 5. 高级工作流示例 + await demonstrateAdvancedWorkflows(); + } catch (error) { + console.error('❌ 示例执行失败:', error); + process.exit(1); + } +} + +// 执行示例 +if (require.main === module) { + main() + .then(() => { + console.log('\n✨ Provider API 示例执行完成'); + process.exit(0); + }) + .catch((error) => { + console.error('❌ 示例执行失败:', error); + process.exit(1); + }); +} diff --git a/example/scripts/register-modules.ts b/example/scripts/register-modules.ts new file mode 100644 index 0000000..f586756 --- /dev/null +++ b/example/scripts/register-modules.ts @@ -0,0 +1,155 @@ +#!/usr/bin/env ts-node + +import { moduleManager } from '../../src/module-manager'; +import { analyticsModule } from '../modules/analytics-module'; +import { customDeployModule } from '../modules/custom-deploy-module'; + +/** + * 模块注册和执行示例脚本 + * 演示如何注册自定义模块并执行命令和工作流 + */ + +async function main() { + console.log('🚀 开始模块注册和执行示例\n'); + + try { + // 1. 注册自定义模块 + console.log('📦 注册自定义模块...'); + moduleManager.registerModule(customDeployModule); + moduleManager.registerModule(analyticsModule); + console.log('✅ 模块注册完成\n'); + + // 2. 列出所有可用的命令 + console.log('📋 可用命令列表:'); + const commands = moduleManager.listCommands(); + commands.forEach((cmd) => { + console.log(` - ${cmd.name}: ${cmd.description || '无描述'}`); + }); + console.log(); + + // 3. 列出所有可用的工作流 + console.log('🔄 可用工作流列表:'); + const workflows = moduleManager.listWorkflows(); + workflows.forEach((workflow) => { + console.log(` - ${workflow.name}: ${workflow.description || '无描述'}`); + }); + console.log(); + + // 4. 执行自定义命令示例 + console.log('🎯 执行命令示例:\n'); + + // 执行开发部署命令 + console.log('--- 执行 deploy-dev 命令 ---'); + const devDeployResult = await moduleManager.executeCommand('deploy-dev', { + args: [], + options: { + platform: 'ios', + force: true, + }, + }); + console.log('结果:', devDeployResult); + console.log(); + + // 执行分析统计命令 + console.log('--- 执行 track-deployment 命令 ---'); + const trackResult = await moduleManager.executeCommand('track-deployment', { + args: [], + options: { + platform: 'android', + environment: 'production', + version: '1.2.3', + }, + }); + console.log('结果:', trackResult); + console.log(); + + // 生成部署报告 + console.log('--- 执行 deployment-report 命令 ---'); + const reportResult = await moduleManager.executeCommand( + 'deployment-report', + { + args: [], + options: { + days: 30, + }, + }, + ); + console.log('结果:', reportResult); + console.log(); + + // 5. 执行工作流示例 + console.log('🔄 执行工作流示例:\n'); + + // 执行带统计的部署工作流 + console.log('--- 执行 deploy-with-analytics 工作流 ---'); + const analyticsWorkflowResult = await moduleManager.executeWorkflow( + 'deploy-with-analytics', + { + args: [], + options: {}, + }, + ); + console.log('工作流结果:', analyticsWorkflowResult); + console.log(); + + // 执行热修复工作流 + console.log('--- 执行 hotfix-deploy 工作流 ---'); + const hotfixWorkflowResult = await moduleManager.executeWorkflow( + 'hotfix-deploy', + { + args: [], + options: { + hotfixId: 'HF-2024-001', + }, + }, + ); + console.log('工作流结果:', hotfixWorkflowResult); + console.log(); + + console.log('🎉 所有示例执行完成!'); + } catch (error) { + console.error('❌ 执行过程中发生错误:', error); + process.exit(1); + } +} + +// 错误处理函数 +async function demonstrateErrorHandling() { + console.log('\n🚨 错误处理示例:\n'); + + try { + // 尝试执行不存在的命令 + console.log('--- 尝试执行不存在的命令 ---'); + await moduleManager.executeCommand('non-existent-command', { + args: [], + options: {}, + }); + } catch (error) { + console.log('捕获错误:', error instanceof Error ? error.message : error); + } + + try { + // 尝试执行缺少必需参数的命令 + console.log('\n--- 尝试执行缺少必需参数的命令 ---'); + await moduleManager.executeCommand('deploy-prod', { + args: [], + options: {}, // 缺少必需的 version 参数 + }); + } catch (error) { + console.log('捕获错误:', error instanceof Error ? error.message : error); + } +} + +// 主函数执行 +if (require.main === module) { + main() + .then(() => demonstrateErrorHandling()) + .then(() => { + console.log('\n✨ 示例脚本执行完成'); + process.exit(0); + }) + .catch((error) => { + console.error('❌ 脚本执行失败:', error); + process.exit(1); + }); +} diff --git a/example/scripts/workflow-demo.ts b/example/scripts/workflow-demo.ts new file mode 100644 index 0000000..ea89144 --- /dev/null +++ b/example/scripts/workflow-demo.ts @@ -0,0 +1,290 @@ +#!/usr/bin/env ts-node + +import { moduleManager } from '../../src/module-manager'; +import { customWorkflows } from '../workflows/custom-workflows'; + +/** + * 工作流演示脚本 + * 展示如何注册和执行复杂的工作流 + */ + +async function registerCustomWorkflows() { + console.log('📋 注册自定义工作流...\n'); + + const provider = moduleManager.getProvider(); + + // 注册所有自定义工作流 + customWorkflows.forEach((workflow) => { + provider.registerWorkflow(workflow); + console.log(`✅ 注册工作流: ${workflow.name} - ${workflow.description}`); + }); + + console.log('\n📋 所有工作流注册完成\n'); +} + +/** + * 演示灰度发布工作流 + */ +async function demonstrateCanaryDeployment() { + console.log('🔥 演示灰度发布工作流\n'); + console.log('='.repeat(60)); + + try { + const result = await moduleManager.executeWorkflow('canary-deployment', { + args: [], + options: { + version: '2.1.0', + initialRollout: 10, + autoExpand: true, + }, + }); + + console.log('\n📊 灰度发布工作流结果:'); + console.log(JSON.stringify(result, null, 2)); + } catch (error) { + console.error('❌ 灰度发布工作流执行失败:', error); + } + + console.log('\n' + '='.repeat(60) + '\n'); +} + +/** + * 演示多环境发布工作流 + */ +async function demonstrateMultiEnvironmentDeploy() { + console.log('🌍 演示多环境发布工作流\n'); + console.log('='.repeat(60)); + + try { + const result = await moduleManager.executeWorkflow('multi-env-deploy', { + args: [], + options: { + version: '2.1.0', + skipProduction: false, + forceProduction: false, + }, + }); + + console.log('\n📊 多环境发布工作流结果:'); + console.log(JSON.stringify(result, null, 2)); + } catch (error) { + console.error('❌ 多环境发布工作流执行失败:', error); + } + + console.log('\n' + '='.repeat(60) + '\n'); +} + +/** + * 演示回滚工作流 + */ +async function demonstrateRollbackWorkflow() { + console.log('🔄 演示回滚工作流\n'); + console.log('='.repeat(60)); + + try { + const result = await moduleManager.executeWorkflow('rollback-workflow', { + args: [], + options: { + targetVersion: '2.0.5', + skipVerification: false, + }, + }); + + console.log('\n📊 回滚工作流结果:'); + console.log(JSON.stringify(result, null, 2)); + } catch (error) { + console.error('❌ 回滚工作流执行失败:', error); + } + + console.log('\n' + '='.repeat(60) + '\n'); +} + +/** + * 演示工作流验证失败的情况 + */ +async function demonstrateWorkflowValidation() { + console.log('⚠️ 演示工作流验证\n'); + console.log('='.repeat(60)); + + // 1. 演示缺少必需参数的情况 + console.log('--- 测试缺少必需参数 ---'); + try { + await moduleManager.executeWorkflow('canary-deployment', { + args: [], + options: {}, // 缺少 version 参数 + }); + } catch (error) { + console.log( + '✅ 正确捕获验证错误:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\n--- 测试回滚工作流验证 ---'); + try { + await moduleManager.executeWorkflow('rollback-workflow', { + args: [], + options: {}, // 缺少 targetVersion 参数 + }); + } catch (error) { + console.log( + '✅ 正确捕获验证错误:', + error instanceof Error ? error.message : error, + ); + } + + console.log('\n' + '='.repeat(60) + '\n'); +} + +/** + * 演示工作流的条件执行 + */ +async function demonstrateConditionalExecution() { + console.log('🔀 演示条件执行\n'); + console.log('='.repeat(60)); + + // 演示跳过生产部署 + console.log('--- 跳过生产环境部署 ---'); + try { + const result = await moduleManager.executeWorkflow('multi-env-deploy', { + args: [], + options: { + version: '2.1.1', + skipProduction: true, // 跳过生产部署 + }, + }); + + console.log('📊 跳过生产部署的结果:'); + console.log(`包含生产部署步骤: ${result.data?.production ? '是' : '否'}`); + } catch (error) { + console.error('❌ 条件执行演示失败:', error); + } + + console.log('\n' + '='.repeat(60) + '\n'); +} + +/** + * 列出所有可用的工作流 + */ +async function listAvailableWorkflows() { + console.log('📋 可用工作流列表\n'); + console.log('='.repeat(60)); + + const workflows = moduleManager.listWorkflows(); + + workflows.forEach((workflow, index) => { + console.log(`${index + 1}. ${workflow.name}`); + console.log(` 描述: ${workflow.description || '无描述'}`); + console.log(` 步骤数: ${workflow.steps.length}`); + + if (workflow.options) { + console.log(' 选项:'); + Object.entries(workflow.options).forEach(([key, option]) => { + const opt = option as any; + const required = opt.hasValue && !opt.default; + console.log( + ` --${key}: ${opt.description || '无描述'} ${required ? '(必需)' : ''}`, + ); + }); + } + console.log(); + }); + + console.log('='.repeat(60) + '\n'); +} + +/** + * 主函数 + */ +async function main() { + console.log('🎯 工作流演示脚本\n'); + + try { + // 1. 注册自定义工作流 + await registerCustomWorkflows(); + + // 2. 列出所有可用工作流 + await listAvailableWorkflows(); + + // 3. 演示各种工作流 + await demonstrateCanaryDeployment(); + await demonstrateMultiEnvironmentDeploy(); + await demonstrateRollbackWorkflow(); + + // 4. 演示验证和条件执行 + await demonstrateWorkflowValidation(); + await demonstrateConditionalExecution(); + + console.log('🎉 所有工作流演示完成!'); + } catch (error) { + console.error('❌ 演示过程中发生错误:', error); + process.exit(1); + } +} + +/** + * 交互式工作流执行 + */ +async function interactiveWorkflowExecution() { + console.log('\n🎮 交互式工作流执行\n'); + + const workflowName = process.argv[3]; + + if (!workflowName) { + console.log('使用方法:'); + console.log(' npm run workflow-demo [工作流名称]'); + console.log('\n可用的工作流:'); + console.log(' - canary-deployment'); + console.log(' - multi-env-deploy'); + console.log(' - rollback-workflow'); + return; + } + + // 解析命令行参数 + const options: Record = {}; + for (let i = 4; i < process.argv.length; i += 2) { + const key = process.argv[i]?.replace(/^--/, ''); + const value = process.argv[i + 1]; + if (key && value) { + options[key] = value; + } + } + + console.log(`执行工作流: ${workflowName}`); + console.log('参数:', options); + console.log(); + + try { + await registerCustomWorkflows(); + + const result = await moduleManager.executeWorkflow(workflowName, { + args: [], + options, + }); + + console.log('\n📊 工作流执行结果:'); + console.log(JSON.stringify(result, null, 2)); + } catch (error) { + console.error('❌ 工作流执行失败:', error); + process.exit(1); + } +} + +// 执行脚本 +if (require.main === module) { + if (process.argv.length > 2 && process.argv[2] === 'interactive') { + interactiveWorkflowExecution() + .then(() => process.exit(0)) + .catch((error) => { + console.error('❌ 交互式执行失败:', error); + process.exit(1); + }); + } else { + main() + .then(() => process.exit(0)) + .catch((error) => { + console.error('❌ 演示脚本执行失败:', error); + process.exit(1); + }); + } +} diff --git a/example/tsconfig.json b/example/tsconfig.json new file mode 100644 index 0000000..a59c6d4 --- /dev/null +++ b/example/tsconfig.json @@ -0,0 +1,23 @@ +{ + "compilerOptions": { + "target": "ES2020", + "module": "commonjs", + "lib": ["ES2020"], + "moduleResolution": "node", + "strict": false, + "esModuleInterop": true, + "skipLibCheck": true, + "forceConsistentCasingInFileNames": false, + "resolveJsonModule": true, + "noEmit": true, + "types": ["node"] + }, + "include": ["**/*.ts"], + "exclude": ["node_modules", "dist"], + "ts-node": { + "transpileOnly": true, + "compilerOptions": { + "module": "commonjs" + } + } +} diff --git a/example/workflows/custom-workflows.ts b/example/workflows/custom-workflows.ts new file mode 100644 index 0000000..146e8b2 --- /dev/null +++ b/example/workflows/custom-workflows.ts @@ -0,0 +1,582 @@ +import type { + CLIProvider, + CommandContext, + CustomWorkflow, +} from '../../src/types'; + +/** + * 自定义工作流集合 + * 演示各种复杂的工作流场景 + */ + +/** + * 灰度发布工作流 + */ +export const canaryDeploymentWorkflow: CustomWorkflow = { + name: 'canary-deployment', + description: '灰度发布工作流 - 逐步增加用户覆盖率', + steps: [ + { + name: 'prepare-canary', + description: '准备灰度发布', + execute: async (context: CommandContext) => { + console.log('🔧 准备灰度发布环境...'); + + const { version, initialRollout = 5 } = context.options; + + console.log(`📦 版本: ${version}`); + console.log(`📊 初始覆盖率: ${initialRollout}%`); + + await new Promise((resolve) => setTimeout(resolve, 1000)); + + return { + version, + currentRollout: initialRollout, + stage: 'prepared', + }; + }, + }, + { + name: 'initial-deployment', + description: '初始小范围部署', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 执行初始小范围部署...'); + + const { currentRollout } = previousResult; + + console.log(`部署到 ${currentRollout}% 用户...`); + await new Promise((resolve) => setTimeout(resolve, 1500)); + + console.log('✅ 初始部署完成'); + + return { + ...previousResult, + deploymentTime: new Date().toISOString(), + stage: 'initial-deployed', + }; + }, + }, + { + name: 'monitor-metrics', + description: '监控关键指标', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📊 监控关键指标...'); + + // 模拟监控数据 + const metrics = { + crashRate: Math.random() * 0.01, // 0-1% + responseTime: 150 + Math.random() * 100, // 150-250ms + userSatisfaction: 85 + Math.random() * 10, // 85-95% + errorRate: Math.random() * 0.005, // 0-0.5% + }; + + console.log('📈 监控结果:'); + console.log(` 崩溃率: ${(metrics.crashRate * 100).toFixed(3)}%`); + console.log(` 响应时间: ${metrics.responseTime.toFixed(1)}ms`); + console.log(` 用户满意度: ${metrics.userSatisfaction.toFixed(1)}%`); + console.log(` 错误率: ${(metrics.errorRate * 100).toFixed(3)}%`); + + // 判断是否可以继续扩大范围 + const canProceed = + metrics.crashRate < 0.005 && + metrics.errorRate < 0.003 && + metrics.userSatisfaction > 80; + + console.log(`🔍 健康检查: ${canProceed ? '✅ 通过' : '❌ 未通过'}`); + + return { + ...previousResult, + metrics, + canProceed, + stage: 'monitored', + }; + }, + }, + { + name: 'expand-rollout', + description: '扩大发布范围', + execute: async (context: CommandContext, previousResult: any) => { + const { canProceed, currentRollout } = previousResult; + + if (!canProceed) { + console.log('⚠️ 指标不达标，停止扩大发布范围'); + return { + ...previousResult, + stage: 'rollout-stopped', + }; + } + + console.log('📈 扩大发布范围...'); + + const newRollout = Math.min(currentRollout * 2, 100); + console.log(`覆盖率从 ${currentRollout}% 扩大到 ${newRollout}%`); + + await new Promise((resolve) => setTimeout(resolve, 1200)); + + return { + ...previousResult, + currentRollout: newRollout, + stage: newRollout >= 100 ? 'fully-deployed' : 'expanded', + }; + }, + condition: (context: CommandContext) => { + // 只有在启用自动扩大的情况下才执行 + return context.options.autoExpand !== false; + }, + }, + { + name: 'final-verification', + description: '最终验证', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 执行最终验证...'); + + const { stage, currentRollout } = previousResult; + + if (stage === 'rollout-stopped') { + console.log('❌ 灰度发布因指标不达标而停止'); + return { + ...previousResult, + finalStatus: 'failed', + reason: 'metrics-failed', + }; + } + + console.log('✅ 灰度发布验证完成'); + console.log(`📊 最终覆盖率: ${currentRollout}%`); + + return { + ...previousResult, + finalStatus: 'success', + completedAt: new Date().toISOString(), + }; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.version) { + console.error('❌ 灰度发布必须指定版本号'); + return false; + } + return true; + }, + options: { + version: { + hasValue: true, + description: '发布版本号 (必需)', + }, + initialRollout: { + hasValue: true, + default: 5, + description: '初始覆盖率百分比', + }, + autoExpand: { + hasValue: false, + default: true, + description: '自动扩大发布范围', + }, + }, +}; + +/** + * 多环境发布工作流 + */ +export const multiEnvironmentDeployWorkflow: CustomWorkflow = { + name: 'multi-env-deploy', + description: '多环境依次发布工作流', + steps: [ + { + name: 'deploy-to-dev', + description: '部署到开发环境', + execute: async (context: CommandContext) => { + console.log('🔧 部署到开发环境...'); + await new Promise((resolve) => setTimeout(resolve, 1000)); + + const devResult = { + environment: 'development', + deployTime: new Date().toISOString(), + success: true, + }; + + console.log('✅ 开发环境部署完成'); + return { dev: devResult }; + }, + }, + { + name: 'run-integration-tests', + description: '运行集成测试', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🧪 运行集成测试...'); + + const testSuites = ['API测试', '数据库测试', '第三方服务测试']; + const results = []; + + for (const suite of testSuites) { + console.log(` 运行 ${suite}...`); + await new Promise((resolve) => setTimeout(resolve, 500)); + + const passed = Math.random() > 0.1; // 90% 通过率 + results.push({ suite, passed }); + console.log(` ${passed ? '✅' : '❌'} ${suite}`); + } + + const allPassed = results.every((r) => r.passed); + console.log( + `🧪 集成测试结果: ${allPassed ? '✅ 全部通过' : '❌ 有失败项'}`, + ); + + return { + ...previousResult, + integrationTests: { results, allPassed }, + }; + }, + }, + { + name: 'deploy-to-staging', + description: '部署到预发布环境', + execute: async (context: CommandContext, previousResult: any) => { + const { integrationTests } = previousResult; + + if (!integrationTests.allPassed) { + throw new Error('集成测试未通过，无法部署到预发布环境'); + } + + console.log('🎭 部署到预发布环境...'); + await new Promise((resolve) => setTimeout(resolve, 1500)); + + const stagingResult = { + environment: 'staging', + deployTime: new Date().toISOString(), + success: true, + }; + + console.log('✅ 预发布环境部署完成'); + return { + ...previousResult, + staging: stagingResult, + }; + }, + }, + { + name: 'run-e2e-tests', + description: '运行端到端测试', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🎯 运行端到端测试...'); + + const e2eTests = [ + '用户登录流程', + '核心业务流程', + '支付流程', + '数据同步', + ]; + + const results = []; + + for (const test of e2eTests) { + console.log(` 测试 ${test}...`); + await new Promise((resolve) => setTimeout(resolve, 800)); + + const passed = Math.random() > 0.05; // 95% 通过率 + results.push({ test, passed }); + console.log(` ${passed ? '✅' : '❌'} ${test}`); + } + + const allPassed = results.every((r) => r.passed); + console.log( + `🎯 E2E测试结果: ${allPassed ? '✅ 全部通过' : '❌ 有失败项'}`, + ); + + return { + ...previousResult, + e2eTests: { results, allPassed }, + }; + }, + }, + { + name: 'deploy-to-production', + description: '部署到生产环境', + execute: async (context: CommandContext, previousResult: any) => { + const { e2eTests } = previousResult; + + if (!e2eTests.allPassed) { + console.log('⚠️ E2E测试未全部通过，需要手动确认是否继续部署'); + + if (!context.options.forceProduction) { + throw new Error('E2E测试未通过，使用 --force-production 强制部署'); + } + } + + console.log('🚀 部署到生产环境...'); + + // 生产部署需要更长时间 + await new Promise((resolve) => setTimeout(resolve, 2000)); + + const productionResult = { + environment: 'production', + deployTime: new Date().toISOString(), + success: true, + version: context.options.version, + }; + + console.log('🎉 生产环境部署完成'); + return { + ...previousResult, + production: productionResult, + }; + }, + condition: (context: CommandContext) => { + // 只有在非跳过生产部署的情况下才执行 + return !context.options.skipProduction; + }, + }, + { + name: 'post-deployment-verification', + description: '部署后验证', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 执行部署后验证...'); + + const verifications = [ + '健康检查', + '关键接口测试', + '监控数据验证', + '用户访问验证', + ]; + + for (const verification of verifications) { + console.log(` ${verification}...`); + await new Promise((resolve) => setTimeout(resolve, 300)); + console.log(` ✅ ${verification} 通过`); + } + + console.log('✅ 部署后验证完成'); + + return { + ...previousResult, + postDeploymentVerification: { + completed: true, + verifiedAt: new Date().toISOString(), + }, + }; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.version) { + console.error('❌ 多环境部署必须指定版本号'); + return false; + } + return true; + }, + options: { + version: { + hasValue: true, + description: '发布版本号 (必需)', + }, + skipProduction: { + hasValue: false, + default: false, + description: '跳过生产环境部署', + }, + forceProduction: { + hasValue: false, + default: false, + description: '强制部署到生产环境（即使测试未全部通过）', + }, + }, +}; + +/** + * 回滚工作流 + */ +export const rollbackWorkflow: CustomWorkflow = { + name: 'rollback-workflow', + description: '应用回滚工作流', + steps: [ + { + name: 'validate-target-version', + description: '验证目标版本', + execute: async (context: CommandContext) => { + console.log('🔍 验证目标回滚版本...'); + + const { targetVersion } = context.options; + + if (!targetVersion) { + throw new Error('必须指定目标回滚版本'); + } + + // 模拟版本验证 + console.log(`验证版本 ${targetVersion} 是否存在...`); + await new Promise((resolve) => setTimeout(resolve, 800)); + + const versionExists = true; // 模拟版本存在 + + if (!versionExists) { + throw new Error(`版本 ${targetVersion} 不存在`); + } + + console.log(`✅ 版本 ${targetVersion} 验证通过`); + + return { + targetVersion, + validated: true, + }; + }, + }, + { + name: 'backup-current-state', + description: '备份当前状态', + execute: async (context: CommandContext, previousResult: any) => { + console.log('💾 备份当前应用状态...'); + + const backup = { + backupId: `backup-${Date.now()}`, + timestamp: new Date().toISOString(), + currentVersion: 'current-version', // 在实际应用中获取当前版本 + configSnapshot: 'config-data', // 在实际应用中获取配置快照 + }; + + await new Promise((resolve) => setTimeout(resolve, 1500)); + + console.log(`✅ 状态备份完成，备份ID: ${backup.backupId}`); + + return { + ...previousResult, + backup, + }; + }, + }, + { + name: 'execute-rollback', + description: '执行回滚', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔄 执行回滚操作...'); + + const { targetVersion } = previousResult; + + console.log(`回滚到版本: ${targetVersion}`); + + // 模拟回滚过程 + const rollbackSteps = [ + '停止当前服务', + '切换到目标版本', + '更新配置', + '重启服务', + ]; + + for (const step of rollbackSteps) { + console.log(` ${step}...`); + await new Promise((resolve) => setTimeout(resolve, 600)); + console.log(` ✅ ${step} 完成`); + } + + console.log('🎉 回滚执行完成'); + + return { + ...previousResult, + rollbackCompleted: true, + rollbackTime: new Date().toISOString(), + }; + }, + }, + { + name: 'verify-rollback', + description: '验证回滚结果', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 验证回滚结果...'); + + const verificationChecks = [ + '服务可用性检查', + '功能完整性检查', + '性能基线检查', + '数据一致性检查', + ]; + + const results = []; + + for (const check of verificationChecks) { + console.log(` ${check}...`); + await new Promise((resolve) => setTimeout(resolve, 400)); + + const passed = Math.random() > 0.05; // 95% 通过率 + results.push({ check, passed }); + console.log(` ${passed ? '✅' : '❌'} ${check}`); + } + + const allPassed = results.every((r) => r.passed); + + if (!allPassed) { + console.log('⚠️ 部分验证未通过，可能需要进一步检查'); + } else { + console.log('✅ 回滚验证全部通过'); + } + + return { + ...previousResult, + verification: { results, allPassed }, + }; + }, + }, + { + name: 'notify-stakeholders', + description: '通知相关人员', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📧 通知相关人员...'); + + const { targetVersion, verification } = previousResult; + + const notification = { + type: 'rollback-completed', + targetVersion, + success: verification.allPassed, + timestamp: new Date().toISOString(), + notifiedStakeholders: [ + '开发团队', + '运维团队', + '产品团队', + '测试团队', + ], + }; + + console.log('📬 发送通知给:'); + notification.notifiedStakeholders.forEach((stakeholder) => { + console.log(` - ${stakeholder}`); + }); + + await new Promise((resolve) => setTimeout(resolve, 500)); + + console.log('✅ 通知发送完成'); + + return { + ...previousResult, + notification, + }; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.targetVersion) { + console.error('❌ 回滚操作必须指定目标版本'); + return false; + } + return true; + }, + options: { + targetVersion: { + hasValue: true, + description: '目标回滚版本 (必需)', + }, + skipVerification: { + hasValue: false, + default: false, + description: '跳过回滚后验证', + }, + }, +}; + +/** + * 导出所有工作流 + */ +export const customWorkflows = [ + canaryDeploymentWorkflow, + multiEnvironmentDeployWorkflow, + rollbackWorkflow, +]; diff --git a/example/workflows/enhanced-core-workflows.ts b/example/workflows/enhanced-core-workflows.ts new file mode 100644 index 0000000..0b0132d --- /dev/null +++ b/example/workflows/enhanced-core-workflows.ts @@ -0,0 +1,1552 @@ +import type { + CLIProvider, + CommandContext, + CustomWorkflow, +} from '../../src/types'; + +/** + * 核心模块增强工作流集合 + * 为app-module、bundle-module、package-module、user-module、version-module设计的高级工作流 + */ + +// ==================== APP MODULE WORKFLOWS ==================== + +/** + * 完整应用初始化工作流 + */ +export const appInitializationWorkflow: CustomWorkflow = { + name: 'app-initialization', + description: '完整应用初始化流程 - 创建、配置、验证', + steps: [ + { + name: 'validate-input', + description: '验证输入参数', + execute: async (context: CommandContext) => { + console.log('🔍 验证应用创建参数...'); + + const { name, platform, downloadUrl } = context.options; + const errors = []; + + if (!name || name.trim().length === 0) { + errors.push('应用名称不能为空'); + } + + if (!platform || !['ios', 'android', 'harmony'].includes(platform)) { + errors.push('平台必须是 ios、android 或 harmony'); + } + + if (downloadUrl && !/^https?:\/\//.test(downloadUrl)) { + errors.push('下载URL格式不正确'); + } + + if (errors.length > 0) { + throw new Error(`参数验证失败: ${errors.join(', ')}`); + } + + console.log(`✅ 参数验证通过: ${name} (${platform})`); + return { validated: true, name, platform, downloadUrl }; + }, + }, + { + name: 'check-existing-app', + description: '检查应用是否已存在', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 检查应用是否已存在...'); + + try { + // 模拟检查逻辑 - 在实际应用中应该调用API + const { platform } = previousResult; + console.log(`检查 ${platform} 平台的应用...`); + + // 模拟API调用 + await new Promise((resolve) => setTimeout(resolve, 500)); + + const appExists = Math.random() < 0.1; // 10%概率应用已存在 + + if (appExists && !context.options.force) { + throw new Error('应用已存在，使用 --force 参数强制创建'); + } + + console.log(`✅ 应用检查完成${appExists ? ' (将覆盖现有应用)' : ''}`); + + return { ...previousResult, appExists, checkCompleted: true }; + } catch (error) { + console.error('❌ 应用检查失败:', error); + throw error; + } + }, + }, + { + name: 'create-app', + description: '创建应用', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 创建应用...'); + + const { name, platform, downloadUrl } = previousResult; + + try { + // 在实际应用中，这里应该调用真实的createApp命令 + console.log(`创建应用: ${name}`); + console.log(`平台: ${platform}`); + if (downloadUrl) { + console.log(`下载URL: ${downloadUrl}`); + } + + // 模拟创建过程 + await new Promise((resolve) => setTimeout(resolve, 1500)); + + const appId = `app_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`; + + console.log(`✅ 应用创建成功，ID: ${appId}`); + + return { ...previousResult, appId, created: true }; + } catch (error) { + console.error('❌ 应用创建失败:', error); + throw error; + } + }, + }, + { + name: 'configure-app', + description: '配置应用基本设置', + execute: async (context: CommandContext, previousResult: any) => { + console.log('⚙️ 配置应用基本设置...'); + + const configurations = [ + '设置更新策略', + '配置安全参数', + '初始化版本控制', + '设置通知配置', + ]; + + for (const config of configurations) { + console.log(` - ${config}...`); + await new Promise((resolve) => setTimeout(resolve, 300)); + console.log(` ✅ ${config} 完成`); + } + + console.log('✅ 应用配置完成'); + + return { ...previousResult, configured: true }; + }, + }, + { + name: 'select-app', + description: '选择新创建的应用', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📱 选择新创建的应用...'); + + const { appId, platform } = previousResult; + + try { + // 模拟选择应用 + await new Promise((resolve) => setTimeout(resolve, 500)); + + console.log(`✅ 应用已选择: ${appId}`); + + return { ...previousResult, selected: true }; + } catch (error) { + console.error('❌ 应用选择失败:', error); + throw error; + } + }, + }, + { + name: 'verify-setup', + description: '验证应用设置', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 验证应用设置...'); + + const verifications = [ + { name: '应用可访问性', check: () => true }, + { name: '配置完整性', check: () => true }, + { name: '权限设置', check: () => Math.random() > 0.1 }, + { name: '网络连接', check: () => Math.random() > 0.05 }, + ]; + + const results = []; + + for (const verification of verifications) { + console.log(` 检查 ${verification.name}...`); + await new Promise((resolve) => setTimeout(resolve, 200)); + + const passed = verification.check(); + results.push({ name: verification.name, passed }); + console.log(` ${passed ? '✅' : '❌'} ${verification.name}`); + } + + const allPassed = results.every((r) => r.passed); + + if (!allPassed) { + console.log('⚠️ 部分验证未通过，但应用仍可使用'); + } else { + console.log('✅ 所有验证通过'); + } + + return { + ...previousResult, + verified: true, + verificationResults: results, + allVerificationsPassed: allPassed, + }; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.name) { + console.error('❌ 应用初始化需要提供应用名称'); + return false; + } + if (!context.options.platform) { + console.error('❌ 应用初始化需要指定平台'); + return false; + } + return true; + }, + options: { + name: { + hasValue: true, + description: '应用名称 (必需)', + }, + platform: { + hasValue: true, + description: '目标平台 (ios/android/harmony, 必需)', + }, + downloadUrl: { + hasValue: true, + description: '应用下载URL (可选)', + }, + force: { + hasValue: false, + default: false, + description: '强制创建，覆盖现有应用', + }, + }, +}; + +/** + * 多平台应用管理工作流 + */ +export const multiPlatformAppManagementWorkflow: CustomWorkflow = { + name: 'multi-platform-app-management', + description: '多平台应用统一管理工作流', + steps: [ + { + name: 'scan-platforms', + description: '扫描所有平台的应用', + execute: async (context: CommandContext) => { + console.log('🔍 扫描所有平台的应用...'); + + const platforms = ['ios', 'android', 'harmony']; + const appsData = {}; + + for (const platform of platforms) { + console.log(` 扫描 ${platform} 平台...`); + + // 模拟获取应用列表 + await new Promise((resolve) => setTimeout(resolve, 500)); + + const appCount = Math.floor(Math.random() * 5) + 1; + const apps = Array.from({ length: appCount }, (_, i) => ({ + id: `${platform}_app_${i + 1}`, + name: `App ${i + 1}`, + platform, + version: `1.${i}.0`, + status: Math.random() > 0.2 ? 'active' : 'inactive', + })); + + appsData[platform] = apps; + console.log(` ✅ 找到 ${appCount} 个应用`); + } + + console.log('✅ 平台扫描完成'); + + return { platforms, appsData, scanned: true }; + }, + }, + { + name: 'analyze-apps', + description: '分析应用状态', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📊 分析应用状态...'); + + const { appsData } = previousResult; + const analysis = { + totalApps: 0, + activeApps: 0, + inactiveApps: 0, + platformDistribution: {}, + issues: [], + }; + + for (const [platform, apps] of Object.entries(appsData)) { + const platformApps = apps as any[]; + analysis.totalApps += platformApps.length; + analysis.platformDistribution[platform] = platformApps.length; + + for (const app of platformApps) { + if (app.status === 'active') { + analysis.activeApps++; + } else { + analysis.inactiveApps++; + analysis.issues.push(`${platform}/${app.name}: 应用不活跃`); + } + } + } + + console.log('📈 分析结果:'); + console.log(` 总应用数: ${analysis.totalApps}`); + console.log(` 活跃应用: ${analysis.activeApps}`); + console.log(` 非活跃应用: ${analysis.inactiveApps}`); + + if (analysis.issues.length > 0) { + console.log('⚠️ 发现问题:'); + analysis.issues.forEach((issue) => console.log(` - ${issue}`)); + } + + return { ...previousResult, analysis }; + }, + }, + { + name: 'optimize-apps', + description: '优化应用配置', + execute: async (context: CommandContext, previousResult: any) => { + console.log('⚡ 优化应用配置...'); + + const { appsData, analysis } = previousResult; + const optimizations = []; + + if (analysis.inactiveApps > 0) { + console.log(' 处理非活跃应用...'); + optimizations.push('重新激活非活跃应用'); + } + + if (analysis.totalApps > 10) { + console.log(' 应用数量较多，建议分组管理...'); + optimizations.push('创建应用分组'); + } + + // 模拟优化过程 + for (const optimization of optimizations) { + console.log(` 执行: ${optimization}...`); + await new Promise((resolve) => setTimeout(resolve, 800)); + console.log(` ✅ ${optimization} 完成`); + } + + console.log('✅ 应用优化完成'); + + return { ...previousResult, optimizations, optimized: true }; + }, + }, + ], + options: { + includeInactive: { + hasValue: false, + default: true, + description: '包含非活跃应用', + }, + autoOptimize: { + hasValue: false, + default: true, + description: '自动优化配置', + }, + }, +}; + +// ==================== BUNDLE MODULE WORKFLOWS ==================== + +/** + * 智能打包工作流 + */ +export const intelligentBundleWorkflow: CustomWorkflow = { + name: 'intelligent-bundle', + description: '智能打包工作流 - 自动优化和多平台构建', + steps: [ + { + name: 'environment-detection', + description: '检测构建环境', + execute: async (context: CommandContext) => { + console.log('🔍 检测构建环境...'); + + const environment = { + nodeVersion: process.version, + platform: process.platform, + arch: process.arch, + memory: Math.round(process.memoryUsage().heapTotal / 1024 / 1024), + cwd: process.cwd(), + }; + + console.log('🖥️ 环境信息:'); + console.log(` Node.js: ${environment.nodeVersion}`); + console.log(` 平台: ${environment.platform}`); + console.log(` 架构: ${environment.arch}`); + console.log(` 内存: ${environment.memory}MB`); + + // 检查环境兼容性 + const compatibility = { + nodeVersionOk: + Number.parseFloat(environment.nodeVersion.slice(1)) >= 14, + memoryOk: environment.memory >= 512, + platformSupported: ['win32', 'darwin', 'linux'].includes( + environment.platform, + ), + }; + + const isCompatible = Object.values(compatibility).every(Boolean); + + if (!isCompatible) { + console.log('⚠️ 环境兼容性警告:'); + if (!compatibility.nodeVersionOk) + console.log(' - Node.js版本过低，建议升级到14+'); + if (!compatibility.memoryOk) + console.log(' - 可用内存不足，可能影响打包性能'); + if (!compatibility.platformSupported) console.log(' - 平台支持有限'); + } else { + console.log('✅ 环境检查通过'); + } + + return { environment, compatibility, isCompatible }; + }, + }, + { + name: 'project-analysis', + description: '分析项目结构', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📂 分析项目结构...'); + + const projectInfo = { + hasPackageJson: true, // 模拟检查 + hasNodeModules: true, + hasReactNative: true, + projectType: 'react-native', + dependencies: ['react', 'react-native'], + devDependencies: ['@babel/core', 'metro'], + estimatedSize: Math.floor(Math.random() * 50) + 10, // 10-60MB + }; + + console.log('📋 项目信息:'); + console.log(` 类型: ${projectInfo.projectType}`); + console.log(` 依赖数: ${projectInfo.dependencies.length}`); + console.log(` 预估大小: ${projectInfo.estimatedSize}MB`); + + // 优化建议 + const recommendations = []; + if (projectInfo.estimatedSize > 40) { + recommendations.push('启用代码分割以减小包大小'); + } + if (projectInfo.dependencies.length > 50) { + recommendations.push('检查并移除未使用的依赖'); + } + + if (recommendations.length > 0) { + console.log('💡 优化建议:'); + recommendations.forEach((rec) => console.log(` - ${rec}`)); + } + + return { ...previousResult, projectInfo, recommendations }; + }, + }, + { + name: 'optimization-setup', + description: '设置优化选项', + execute: async (context: CommandContext, previousResult: any) => { + console.log('⚙️ 设置优化选项...'); + + const { projectInfo } = previousResult; + const { platform, dev } = context.options; + + const optimizations = { + minification: !dev, + sourceMaps: dev || context.options.sourcemap, + treeshaking: !dev, + bundleSplitting: projectInfo.estimatedSize > 30, + compression: !dev, + }; + + console.log('🔧 优化配置:'); + Object.entries(optimizations).forEach(([key, value]) => { + console.log(` ${key}: ${value ? '✅' : '❌'}`); + }); + + return { ...previousResult, optimizations }; + }, + }, + { + name: 'multi-platform-build', + description: '多平台构建', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🏗️ 执行多平台构建...'); + + const targetPlatforms = context.options.platform + ? [context.options.platform] + : ['ios', 'android']; + + const buildResults = []; + + for (const platform of targetPlatforms) { + console.log(`\\n构建 ${platform} 平台...`); + + const buildSteps = [ + '准备构建环境', + '编译JavaScript', + '优化资源', + '生成Bundle', + '创建PPK文件', + ]; + + for (const step of buildSteps) { + console.log(` ${step}...`); + await new Promise((resolve) => + setTimeout(resolve, step.includes('编译') ? 2000 : 500), + ); + console.log(` ✅ ${step} 完成`); + } + + const buildResult = { + platform, + success: Math.random() > 0.1, // 90% 成功率 + buildTime: Math.floor(Math.random() * 30) + 10, // 10-40秒 + bundleSize: Math.floor(Math.random() * 10) + 5, // 5-15MB + outputPath: `./build/${platform}.ppk`, + }; + + buildResults.push(buildResult); + + if (buildResult.success) { + console.log(`✅ ${platform} 构建成功`); + console.log(` 时间: ${buildResult.buildTime}秒`); + console.log(` 大小: ${buildResult.bundleSize}MB`); + } else { + console.log(`❌ ${platform} 构建失败`); + } + } + + const allSuccess = buildResults.every((r) => r.success); + + console.log( + `\\n🎯 构建汇总: ${buildResults.filter((r) => r.success).length}/${buildResults.length} 成功`, + ); + + return { ...previousResult, buildResults, allSuccess }; + }, + }, + { + name: 'quality-check', + description: '质量检查', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 执行质量检查...'); + + const { buildResults } = previousResult; + const qualityChecks = []; + + for (const build of buildResults) { + if (!build.success) continue; + + console.log(`检查 ${build.platform} 构建质量...`); + + const checks = { + bundleSize: build.bundleSize < 20, // 小于20MB + buildTime: build.buildTime < 60, // 小于60秒 + hasSourceMap: Math.random() > 0.1, + hasAssets: Math.random() > 0.05, + }; + + const score = + (Object.values(checks).filter(Boolean).length / + Object.keys(checks).length) * + 100; + + qualityChecks.push({ + platform: build.platform, + checks, + score: Math.round(score), + passed: score >= 80, + }); + + console.log(` 质量评分: ${Math.round(score)}%`); + } + + const averageScore = + qualityChecks.reduce((sum, check) => sum + check.score, 0) / + qualityChecks.length; + + console.log(`\\n📊 平均质量评分: ${Math.round(averageScore)}%`); + + return { ...previousResult, qualityChecks, averageScore }; + }, + }, + ], + validate: (context: CommandContext) => { + return true; // 智能打包工作流不需要特殊验证 + }, + options: { + platform: { + hasValue: true, + description: '目标平台 (不指定则构建所有平台)', + }, + dev: { + hasValue: false, + default: false, + description: '开发模式构建', + }, + sourcemap: { + hasValue: false, + default: false, + description: '生成源码映射', + }, + optimize: { + hasValue: false, + default: true, + description: '启用自动优化', + }, + }, +}; + +/** + * 增量构建工作流 + */ +export const incrementalBuildWorkflow: CustomWorkflow = { + name: 'incremental-build', + description: '增量构建工作流 - 生成差异包', + steps: [ + { + name: 'detect-base-version', + description: '检测基准版本', + execute: async (context: CommandContext) => { + console.log('🔍 检测基准版本...'); + + const { baseVersion, platform } = context.options; + + if (baseVersion) { + console.log(`✅ 使用指定基准版本: ${baseVersion}`); + return { baseVersion, specified: true }; + } + + // 自动检测最新版本 + console.log('自动检测最新版本...'); + await new Promise((resolve) => setTimeout(resolve, 800)); + + const autoDetectedVersion = `v${Math.floor(Math.random() * 3) + 1}.${Math.floor(Math.random() * 10)}.${Math.floor(Math.random() * 10)}`; + + console.log(`✅ 自动检测到基准版本: ${autoDetectedVersion}`); + + return { baseVersion: autoDetectedVersion, specified: false }; + }, + }, + { + name: 'build-current-version', + description: '构建当前版本', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🏗️ 构建当前版本...'); + + const { platform } = context.options; + + console.log(`构建 ${platform} 平台...`); + + // 模拟构建过程 + const buildSteps = ['编译代码', '打包资源', '生成Bundle']; + + for (const step of buildSteps) { + console.log(` ${step}...`); + await new Promise((resolve) => setTimeout(resolve, 1000)); + console.log(` ✅ ${step} 完成`); + } + + const currentBuild = { + version: `v${Math.floor(Math.random() * 3) + 2}.0.0`, + platform, + bundlePath: `./build/current_${platform}.ppk`, + size: Math.floor(Math.random() * 15) + 10, + buildTime: Date.now(), + }; + + console.log(`✅ 当前版本构建完成: ${currentBuild.version}`); + + return { ...previousResult, currentBuild }; + }, + }, + { + name: 'download-base-bundle', + description: '下载基准版本Bundle', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📥 下载基准版本Bundle...'); + + const { baseVersion } = previousResult; + const { platform } = context.options; + + console.log(`下载 ${baseVersion} (${platform})...`); + + // 模拟下载过程 + for (let i = 0; i <= 100; i += 20) { + console.log(` 下载进度: ${i}%`); + await new Promise((resolve) => setTimeout(resolve, 200)); + } + + const baseBuild = { + version: baseVersion, + platform, + bundlePath: `./build/base_${platform}.ppk`, + size: Math.floor(Math.random() * 12) + 8, + }; + + console.log(`✅ 基准版本下载完成`); + + return { ...previousResult, baseBuild }; + }, + }, + { + name: 'generate-diff', + description: '生成差异包', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔄 生成差异包...'); + + const { baseBuild, currentBuild } = previousResult; + + console.log( + `比较版本: ${baseBuild.version} -> ${currentBuild.version}`, + ); + + // 模拟差异计算 + const diffSteps = [ + '分析文件变更', + '计算差异算法', + '生成补丁文件', + '压缩差异包', + ]; + + for (const step of diffSteps) { + console.log(` ${step}...`); + await new Promise((resolve) => setTimeout(resolve, 800)); + console.log(` ✅ ${step} 完成`); + } + + const diffPackage = { + fromVersion: baseBuild.version, + toVersion: currentBuild.version, + diffPath: `./build/diff_${baseBuild.version}_to_${currentBuild.version}.patch`, + originalSize: currentBuild.size, + diffSize: Math.floor(currentBuild.size * (0.1 + Math.random() * 0.3)), // 10-40% 大小 + compressionRatio: 0, + }; + + diffPackage.compressionRatio = Math.round( + (1 - diffPackage.diffSize / diffPackage.originalSize) * 100, + ); + + console.log(`✅ 差异包生成完成`); + console.log(` 原始大小: ${diffPackage.originalSize}MB`); + console.log(` 差异包大小: ${diffPackage.diffSize}MB`); + console.log(` 压缩比: ${diffPackage.compressionRatio}%`); + + return { ...previousResult, diffPackage }; + }, + }, + { + name: 'validate-diff', + description: '验证差异包', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 验证差异包...'); + + const { diffPackage } = previousResult; + + const validationSteps = [ + '校验文件完整性', + '测试应用补丁', + '验证功能完整性', + ]; + + const validationResults = []; + + for (const step of validationSteps) { + console.log(` ${step}...`); + await new Promise((resolve) => setTimeout(resolve, 600)); + + const success = Math.random() > 0.05; // 95% 成功率 + validationResults.push({ step, success }); + + console.log(` ${success ? '✅' : '❌'} ${step}`); + } + + const allValid = validationResults.every((r) => r.success); + + if (allValid) { + console.log('✅ 差异包验证通过'); + } else { + console.log('❌ 差异包验证失败'); + } + + return { + ...previousResult, + validationResults, + allValid, + validated: true, + }; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.platform) { + console.error('❌ 增量构建需要指定平台'); + return false; + } + return true; + }, + options: { + platform: { + hasValue: true, + description: '目标平台 (必需)', + }, + baseVersion: { + hasValue: true, + description: '基准版本 (不指定则自动检测)', + }, + skipValidation: { + hasValue: false, + default: false, + description: '跳过差异包验证', + }, + }, +}; + +// ==================== PACKAGE MODULE WORKFLOWS ==================== + +/** + * 批量包处理工作流 + */ +export const batchPackageProcessingWorkflow: CustomWorkflow = { + name: 'batch-package-processing', + description: '批量包处理工作流 - 上传、解析、验证', + steps: [ + { + name: 'scan-packages', + description: '扫描待处理包', + execute: async (context: CommandContext) => { + console.log('🔍 扫描待处理包...'); + + const { directory, pattern } = context.options; + const scanDir = directory || './packages'; + + console.log(`扫描目录: ${scanDir}`); + console.log(`文件模式: ${pattern || '*.{ipa,apk,app}'}`); + + // 模拟文件扫描 + await new Promise((resolve) => setTimeout(resolve, 1000)); + + const packages = [ + { + path: './packages/app_v1.0.0.ipa', + type: 'ipa', + size: 45.2, + platform: 'ios', + }, + { + path: './packages/app_v1.0.0.apk', + type: 'apk', + size: 38.7, + platform: 'android', + }, + { + path: './packages/app_v1.0.0.app', + type: 'app', + size: 42.1, + platform: 'harmony', + }, + { + path: './packages/app_v1.1.0.ipa', + type: 'ipa', + size: 46.8, + platform: 'ios', + }, + { + path: './packages/app_v1.1.0.apk', + type: 'apk', + size: 39.2, + platform: 'android', + }, + ]; + + console.log(`✅ 发现 ${packages.length} 个包文件:`); + packages.forEach((pkg) => { + console.log(` ${pkg.path} (${pkg.size}MB, ${pkg.platform})`); + }); + + return { packages, scanned: true }; + }, + }, + { + name: 'analyze-packages', + description: '分析包信息', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📊 分析包信息...'); + + const { packages } = previousResult; + const analysis = { + totalPackages: packages.length, + totalSize: 0, + platformDistribution: {}, + versions: new Set(), + issues: [], + }; + + for (const pkg of packages) { + analysis.totalSize += pkg.size; + + if (!analysis.platformDistribution[pkg.platform]) { + analysis.platformDistribution[pkg.platform] = 0; + } + analysis.platformDistribution[pkg.platform]++; + + // 提取版本信息 + const versionMatch = pkg.path.match(/v(\d+\.\d+\.\d+)/); + if (versionMatch) { + analysis.versions.add(versionMatch[1]); + } + + // 检查问题 + if (pkg.size > 50) { + analysis.issues.push(`${pkg.path}: 包大小过大 (${pkg.size}MB)`); + } + if (pkg.size < 1) { + analysis.issues.push(`${pkg.path}: 包大小异常小`); + } + } + + console.log('📈 分析结果:'); + console.log(` 总包数: ${analysis.totalPackages}`); + console.log(` 总大小: ${analysis.totalSize.toFixed(1)}MB`); + console.log(` 版本数: ${analysis.versions.size}`); + console.log(' 平台分布:'); + Object.entries(analysis.platformDistribution).forEach( + ([platform, count]) => { + console.log(` ${platform}: ${count} 个`); + }, + ); + + if (analysis.issues.length > 0) { + console.log('⚠️ 发现问题:'); + analysis.issues.forEach((issue) => console.log(` - ${issue}`)); + } + + return { ...previousResult, analysis }; + }, + }, + { + name: 'parse-packages', + description: '解析包内容', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 解析包内容...'); + + const { packages } = previousResult; + const parseResults = []; + + for (const pkg of packages) { + console.log(`\\n解析 ${pkg.path}...`); + + // 模拟解析过程 + await new Promise((resolve) => setTimeout(resolve, 800)); + + const parseResult = { + path: pkg.path, + platform: pkg.platform, + appInfo: { + bundleId: `com.example.app.${pkg.platform}`, + version: `1.${Math.floor(Math.random() * 3)}.0`, + buildNumber: Math.floor(Math.random() * 100) + 1, + minOSVersion: pkg.platform === 'ios' ? '11.0' : '6.0', + permissions: ['camera', 'location', 'storage'].slice( + 0, + Math.floor(Math.random() * 3) + 1, + ), + }, + assets: { + icons: Math.floor(Math.random() * 5) + 3, + images: Math.floor(Math.random() * 20) + 10, + fonts: Math.floor(Math.random() * 3) + 1, + }, + success: Math.random() > 0.05, // 95% 成功率 + }; + + parseResults.push(parseResult); + + if (parseResult.success) { + console.log(` ✅ 解析成功`); + console.log(` Bundle ID: ${parseResult.appInfo.bundleId}`); + console.log( + ` 版本: ${parseResult.appInfo.version} (${parseResult.appInfo.buildNumber})`, + ); + } else { + console.log(` ❌ 解析失败`); + } + } + + const successCount = parseResults.filter((r) => r.success).length; + console.log( + `\\n📊 解析汇总: ${successCount}/${parseResults.length} 成功`, + ); + + return { ...previousResult, parseResults }; + }, + }, + { + name: 'upload-packages', + description: '上传包文件', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📤 上传包文件...'); + + const { packages, parseResults } = previousResult; + const uploadResults = []; + + const successfulParsed = parseResults.filter((r) => r.success); + + for (const parseResult of successfulParsed) { + console.log(`\\n上传 ${parseResult.path}...`); + + // 模拟上传进度 + const progressSteps = [20, 40, 60, 80, 100]; + for (const progress of progressSteps) { + console.log(` 上传进度: ${progress}%`); + await new Promise((resolve) => setTimeout(resolve, 300)); + } + + const uploadResult = { + path: parseResult.path, + platform: parseResult.platform, + success: Math.random() > 0.1, // 90% 成功率 + uploadTime: Math.floor(Math.random() * 30) + 10, // 10-40秒 + packageId: Math.random().toString(36).substr(2, 8), + }; + + uploadResults.push(uploadResult); + + if (uploadResult.success) { + console.log(` ✅ 上传成功，包ID: ${uploadResult.packageId}`); + } else { + console.log(` ❌ 上传失败`); + } + } + + const uploadSuccessCount = uploadResults.filter( + (r) => r.success, + ).length; + console.log( + `\\n📊 上传汇总: ${uploadSuccessCount}/${uploadResults.length} 成功`, + ); + + return { ...previousResult, uploadResults }; + }, + }, + { + name: 'generate-report', + description: '生成处理报告', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📋 生成处理报告...'); + + const { packages, analysis, parseResults, uploadResults } = + previousResult; + + const report = { + summary: { + totalPackages: packages.length, + parsedSuccessfully: parseResults.filter((r) => r.success).length, + uploadedSuccessfully: uploadResults.filter((r) => r.success).length, + totalSize: analysis.totalSize, + processingTime: Date.now(), + }, + platformBreakdown: analysis.platformDistribution, + issues: analysis.issues, + failedOperations: [ + ...parseResults + .filter((r) => !r.success) + .map((r) => ({ operation: 'parse', file: r.path })), + ...uploadResults + .filter((r) => !r.success) + .map((r) => ({ operation: 'upload', file: r.path })), + ], + }; + + console.log('\\n📊 处理报告:'); + console.log('='.repeat(50)); + console.log(`总包数: ${report.summary.totalPackages}`); + console.log(`解析成功: ${report.summary.parsedSuccessfully}`); + console.log(`上传成功: ${report.summary.uploadedSuccessfully}`); + console.log(`总大小: ${report.summary.totalSize.toFixed(1)}MB`); + + if (report.failedOperations.length > 0) { + console.log('\\n❌ 失败操作:'); + report.failedOperations.forEach((op) => { + console.log(` ${op.operation}: ${op.file}`); + }); + } + + console.log('='.repeat(50)); + + return { ...previousResult, report }; + }, + }, + ], + options: { + directory: { + hasValue: true, + description: '包文件目录 (默认: ./packages)', + }, + pattern: { + hasValue: true, + description: '文件匹配模式 (默认: *.{ipa,apk,app})', + }, + skipUpload: { + hasValue: false, + default: false, + description: '跳过上传步骤', + }, + }, +}; + +// ==================== VERSION MODULE WORKFLOWS ==================== + +/** + * 版本发布管理工作流 + */ +export const versionReleaseManagementWorkflow: CustomWorkflow = { + name: 'version-release-management', + description: '版本发布管理工作流 - 完整的版本发布生命周期', + steps: [ + { + name: 'pre-release-check', + description: '发布前检查', + execute: async (context: CommandContext) => { + console.log('🔍 执行发布前检查...'); + + const { name, platform } = context.options; + + const checks = [ + { name: '版本号格式', check: () => /^v?\d+\.\d+\.\d+/.test(name) }, + { + name: '平台支持', + check: () => ['ios', 'android', 'harmony'].includes(platform), + }, + { name: '构建环境', check: () => Math.random() > 0.1 }, + { name: '依赖完整性', check: () => Math.random() > 0.05 }, + { name: '测试覆盖率', check: () => Math.random() > 0.2 }, + ]; + + const results = []; + + for (const check of checks) { + console.log(` 检查 ${check.name}...`); + await new Promise((resolve) => setTimeout(resolve, 300)); + + const passed = check.check(); + results.push({ name: check.name, passed }); + + console.log(` ${passed ? '✅' : '❌'} ${check.name}`); + } + + const criticalIssues = results.filter( + (r) => !r.passed && ['版本号格式', '平台支持'].includes(r.name), + ); + const warnings = results.filter( + (r) => !r.passed && !['版本号格式', '平台支持'].includes(r.name), + ); + + if (criticalIssues.length > 0) { + throw new Error( + `关键检查失败: ${criticalIssues.map((i) => i.name).join(', ')}`, + ); + } + + if (warnings.length > 0) { + console.log(`⚠️ 警告: ${warnings.map((w) => w.name).join(', ')}`); + } + + console.log('✅ 发布前检查完成'); + + return { checks: results, criticalIssues, warnings }; + }, + }, + { + name: 'version-validation', + description: '版本验证', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🔍 验证版本信息...'); + + const { name, description, platform } = context.options; + + // 检查版本是否已存在 + console.log('检查版本冲突...'); + await new Promise((resolve) => setTimeout(resolve, 800)); + + const versionExists = Math.random() < 0.1; // 10% 概率版本已存在 + + if (versionExists && !context.options.force) { + throw new Error(`版本 ${name} 已存在，使用 --force 参数强制覆盖`); + } + + // 验证版本规范 + const versionInfo = { + name, + description: description || `Release ${name}`, + platform, + timestamp: new Date().toISOString(), + isPreRelease: name.includes('beta') || name.includes('alpha'), + isMajorRelease: name.endsWith('.0.0'), + }; + + console.log('📋 版本信息:'); + console.log(` 名称: ${versionInfo.name}`); + console.log(` 描述: ${versionInfo.description}`); + console.log(` 平台: ${versionInfo.platform}`); + console.log(` 预发布: ${versionInfo.isPreRelease ? '是' : '否'}`); + console.log(` 主要版本: ${versionInfo.isMajorRelease ? '是' : '否'}`); + + if (versionExists) { + console.log('⚠️ 将覆盖现有版本'); + } + + console.log('✅ 版本验证完成'); + + return { ...previousResult, versionInfo, versionExists }; + }, + }, + { + name: 'release-preparation', + description: '准备发布', + execute: async (context: CommandContext, previousResult: any) => { + console.log('⚙️ 准备发布...'); + + const { versionInfo } = previousResult; + + const preparationSteps = [ + '生成发布说明', + '准备分发包', + '设置发布参数', + '配置回滚策略', + ]; + + for (const step of preparationSteps) { + console.log(` ${step}...`); + await new Promise((resolve) => setTimeout(resolve, 600)); + console.log(` ✅ ${step} 完成`); + } + + const releaseConfig = { + rollout: Number.parseInt(context.options.rollout) || 100, + packageVersion: context.options.packageVersion, + minPackageVersion: context.options.minPackageVersion, + maxPackageVersion: context.options.maxPackageVersion, + metaInfo: context.options.metaInfo, + dryRun: context.options.dryRun, + }; + + console.log('🔧 发布配置:'); + Object.entries(releaseConfig).forEach(([key, value]) => { + if (value !== undefined) { + console.log(` ${key}: ${value}`); + } + }); + + console.log('✅ 发布准备完成'); + + return { ...previousResult, releaseConfig }; + }, + }, + { + name: 'execute-release', + description: '执行发布', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🚀 执行版本发布...'); + + const { versionInfo, releaseConfig } = previousResult; + + if (releaseConfig.dryRun) { + console.log('🔍 模拟发布 (Dry Run)...'); + + console.log('模拟操作:'); + console.log(' - 上传版本包'); + console.log(' - 更新版本信息'); + console.log(' - 配置分发策略'); + console.log(' - 通知用户'); + + await new Promise((resolve) => setTimeout(resolve, 2000)); + + console.log('✅ 模拟发布完成 (未实际发布)'); + + return { + ...previousResult, + released: false, + dryRun: true, + simulationSuccessful: true, + }; + } + + // 实际发布流程 + const releaseSteps = [ + { name: '上传版本包', duration: 3000 }, + { name: '更新版本信息', duration: 1000 }, + { name: '配置分发策略', duration: 800 }, + { name: '激活版本', duration: 500 }, + { name: '发送通知', duration: 600 }, + ]; + + const releaseResults = []; + + for (const step of releaseSteps) { + console.log(` ${step.name}...`); + + // 模拟进度 + if (step.duration > 2000) { + for (let i = 20; i <= 100; i += 20) { + console.log(` 进度: ${i}%`); + await new Promise((resolve) => + setTimeout(resolve, step.duration / 5), + ); + } + } else { + await new Promise((resolve) => setTimeout(resolve, step.duration)); + } + + const success = Math.random() > 0.02; // 98% 成功率 + releaseResults.push({ step: step.name, success }); + + if (success) { + console.log(` ✅ ${step.name} 完成`); + } else { + console.log(` ❌ ${step.name} 失败`); + throw new Error(`发布失败于步骤: ${step.name}`); + } + } + + const releaseId = Math.random().toString(36).substr(2, 10); + + console.log(`✅ 版本发布成功`); + console.log(` 发布ID: ${releaseId}`); + console.log(` 版本: ${versionInfo.name}`); + console.log(` 覆盖率: ${releaseConfig.rollout}%`); + + return { + ...previousResult, + released: true, + releaseId, + releaseResults, + releaseTime: new Date().toISOString(), + }; + }, + }, + { + name: 'post-release-monitoring', + description: '发布后监控', + execute: async (context: CommandContext, previousResult: any) => { + if (!previousResult.released) { + console.log('跳过发布后监控 (未实际发布)'); + return { ...previousResult, monitoringSkipped: true }; + } + + console.log('📊 发布后监控...'); + + const { releaseId, versionInfo } = previousResult; + + console.log(`监控发布 ${releaseId}...`); + + const monitoringMetrics = [ + { + name: '下载成功率', + value: 95 + Math.random() * 4, + unit: '%', + threshold: 90, + }, + { + name: '安装成功率', + value: 92 + Math.random() * 6, + unit: '%', + threshold: 85, + }, + { + name: '启动成功率', + value: 96 + Math.random() * 3, + unit: '%', + threshold: 95, + }, + { + name: '崩溃率', + value: Math.random() * 1, + unit: '%', + threshold: 2, + inverse: true, + }, + { + name: '用户反馈评分', + value: 4.2 + Math.random() * 0.7, + unit: '/5', + threshold: 4.0, + }, + ]; + + console.log('📈 监控指标:'); + + const alerts = []; + + for (const metric of monitoringMetrics) { + const value = Number.parseFloat(metric.value.toFixed(2)); + const passed = metric.inverse + ? value <= metric.threshold + : value >= metric.threshold; + + console.log( + ` ${metric.name}: ${value}${metric.unit} ${passed ? '✅' : '⚠️'}`, + ); + + if (!passed) { + alerts.push( + `${metric.name} 低于阈值 (${value}${metric.unit} < ${metric.threshold}${metric.unit})`, + ); + } + } + + if (alerts.length > 0) { + console.log('\\n⚠️ 监控警告:'); + alerts.forEach((alert) => console.log(` - ${alert}`)); + } else { + console.log('\\n✅ 所有监控指标正常'); + } + + console.log('✅ 发布后监控完成'); + + return { + ...previousResult, + monitoring: { + metrics: monitoringMetrics, + alerts, + allMetricsHealthy: alerts.length === 0, + }, + }; + }, + }, + { + name: 'release-summary', + description: '发布总结', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📋 生成发布总结...'); + + const { + versionInfo, + releaseConfig, + released, + dryRun, + releaseId, + monitoring, + } = previousResult; + + console.log('\\n' + '='.repeat(60)); + console.log('📊 版本发布总结'); + console.log('='.repeat(60)); + + console.log(`版本名称: ${versionInfo.name}`); + console.log(`平台: ${versionInfo.platform}`); + console.log(`发布时间: ${versionInfo.timestamp}`); + console.log(`覆盖率: ${releaseConfig.rollout}%`); + + if (dryRun) { + console.log('状态: 模拟发布 ✅'); + } else if (released) { + console.log(`状态: 发布成功 ✅`); + console.log(`发布ID: ${releaseId}`); + + if (monitoring && !monitoring.allMetricsHealthy) { + console.log(`监控状态: 有警告 ⚠️`); + } else if (monitoring) { + console.log(`监控状态: 正常 ✅`); + } + } else { + console.log('状态: 发布失败 ❌'); + } + + console.log('='.repeat(60)); + + const summary = { + version: versionInfo.name, + platform: versionInfo.platform, + success: released || dryRun, + releaseId: releaseId || null, + monitoringHealthy: monitoring?.allMetricsHealthy ?? true, + completedAt: new Date().toISOString(), + }; + + return { ...previousResult, summary }; + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.name) { + console.error('❌ 版本发布需要指定版本名称'); + return false; + } + if (!context.options.platform) { + console.error('❌ 版本发布需要指定平台'); + return false; + } + return true; + }, + options: { + name: { + hasValue: true, + description: '版本名称 (必需)', + }, + description: { + hasValue: true, + description: '版本描述', + }, + platform: { + hasValue: true, + description: '目标平台 (必需)', + }, + rollout: { + hasValue: true, + default: 100, + description: '发布覆盖率百分比', + }, + packageVersion: { + hasValue: true, + description: '包版本号', + }, + minPackageVersion: { + hasValue: true, + description: '最小包版本', + }, + maxPackageVersion: { + hasValue: true, + description: '最大包版本', + }, + metaInfo: { + hasValue: true, + description: '元信息', + }, + dryRun: { + hasValue: false, + default: false, + description: '模拟发布，不实际执行', + }, + force: { + hasValue: false, + default: false, + description: '强制发布，覆盖现有版本', + }, + }, +}; + +/** + * 导出所有增强的核心工作流 + */ +export const enhancedCoreWorkflows = [ + // App Module Workflows + appInitializationWorkflow, + multiPlatformAppManagementWorkflow, + + // Bundle Module Workflows + intelligentBundleWorkflow, + incrementalBuildWorkflow, + + // Package Module Workflows + batchPackageProcessingWorkflow, + + // Version Module Workflows + versionReleaseManagementWorkflow, +]; diff --git a/example/yarn.lock b/example/yarn.lock new file mode 100644 index 0000000..87d03ca --- /dev/null +++ b/example/yarn.lock @@ -0,0 +1,1863 @@ +# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. +# yarn lockfile v1 + + +"@babel/runtime@^7.26.10": + version "7.27.6" + resolved "https://registry.yarnpkg.com/@babel/runtime/-/runtime-7.27.6.tgz#ec4070a04d76bae8ddbb10770ba55714a417b7c6" + integrity sha512-vbavdySgbTTrmFE+EsiqUTzlOr5bzlnJtUv9PynGCAKvfQqjIXbvFdumPM/GxMDfyuGMJaJAU6TO4zc1Jf1i8Q== + +"@colors/colors@^1.6.0": + version "1.6.0" + resolved "https://registry.yarnpkg.com/@colors/colors/-/colors-1.6.0.tgz#ec6cd237440700bc23ca23087f513c75508958b0" + integrity sha512-Ir+AOibqzrIsL6ajt3Rz3LskB7OiMVHqltZmspbW/TJuTVuyOMirVqAkjfY6JISiLHgyNqicAC8AyHHGzNd/dA== + +"@cspotcode/source-map-support@^0.8.0": + version "0.8.1" + resolved "https://registry.yarnpkg.com/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz#00629c35a688e05a88b1cda684fb9d5e73f000a1" + integrity sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw== + dependencies: + "@jridgewell/trace-mapping" "0.3.9" + +"@jridgewell/resolve-uri@^3.0.3": + version "3.1.2" + resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz#7a0ee601f60f99a20c7c7c5ff0c80388c1189bd6" + integrity sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw== + +"@jridgewell/sourcemap-codec@^1.4.10": + version "1.5.4" + resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.4.tgz#7358043433b2e5da569aa02cbc4c121da3af27d7" + integrity sha512-VT2+G1VQs/9oz078bLrYbecdZKs912zQlkelYpuf+SXF+QvZDYJlbx/LSx+meSAwdDFnF8FVXW92AVjjkVmgFw== + +"@jridgewell/trace-mapping@0.3.9": + version "0.3.9" + resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz#6534fd5933a53ba7cbf3a17615e273a0d1273ff9" + integrity sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ== + dependencies: + "@jridgewell/resolve-uri" "^3.0.3" + "@jridgewell/sourcemap-codec" "^1.4.10" + +"@pnpm/config.env-replace@^1.1.0": + version "1.1.0" + resolved "https://registry.yarnpkg.com/@pnpm/config.env-replace/-/config.env-replace-1.1.0.tgz#ab29da53df41e8948a00f2433f085f54de8b3a4c" + integrity sha512-htyl8TWnKL7K/ESFa1oW2UB5lVDxuF5DpM7tBi6Hu2LNL3mWkIzNLG6N4zoCUP1lCKNxWy/3iu8mS8MvToGd6w== + +"@pnpm/network.ca-file@^1.0.1": + version "1.0.2" + resolved "https://registry.yarnpkg.com/@pnpm/network.ca-file/-/network.ca-file-1.0.2.tgz#2ab05e09c1af0cdf2fcf5035bea1484e222f7983" + integrity sha512-YcPQ8a0jwYU9bTdJDpXjMi7Brhkr1mXsXrUJvjqM2mQDgkRiz8jFaQGOdaLxgjtUfQgZhKy/O3cG/YwmgKaxLA== + dependencies: + graceful-fs "4.2.10" + +"@pnpm/npm-conf@^2.1.0": + version "2.3.1" + resolved "https://registry.yarnpkg.com/@pnpm/npm-conf/-/npm-conf-2.3.1.tgz#bb375a571a0bd63ab0a23bece33033c683e9b6b0" + integrity sha512-c83qWb22rNRuB0UaVCI0uRPNRr8Z0FWnEIvT47jiHAmOIUHbBOg5XvV7pM5x+rKn9HRpjxquDbXYSXr3fAKFcw== + dependencies: + "@pnpm/config.env-replace" "^1.1.0" + "@pnpm/network.ca-file" "^1.0.1" + config-chain "^1.1.11" + +"@tsconfig/node10@^1.0.7": + version "1.0.11" + resolved "https://registry.yarnpkg.com/@tsconfig/node10/-/node10-1.0.11.tgz#6ee46400685f130e278128c7b38b7e031ff5b2f2" + integrity sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw== + +"@tsconfig/node12@^1.0.7": + version "1.0.11" + resolved "https://registry.yarnpkg.com/@tsconfig/node12/-/node12-1.0.11.tgz#ee3def1f27d9ed66dac6e46a295cffb0152e058d" + integrity sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag== + +"@tsconfig/node14@^1.0.0": + version "1.0.3" + resolved "https://registry.yarnpkg.com/@tsconfig/node14/-/node14-1.0.3.tgz#e4386316284f00b98435bf40f72f75a09dabf6c1" + integrity sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow== + +"@tsconfig/node16@^1.0.2": + version "1.0.4" + resolved "https://registry.yarnpkg.com/@tsconfig/node16/-/node16-1.0.4.tgz#0b92dcc0cc1c81f6f306a381f28e31b1a56536e9" + integrity sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA== + +"@types/node@^20.0.0": + version "20.19.9" + resolved "https://registry.yarnpkg.com/@types/node/-/node-20.19.9.tgz#ca9a58193fec361cc6e859d88b52261853f1f0d3" + integrity sha512-cuVNgarYWZqxRJDQHEB58GEONhOK79QVR/qYx4S7kcUObQvUwvFnYxJuuHUKm2aieN9X3yZB4LZsuYNU1Qphsw== + dependencies: + undici-types "~6.21.0" + +"@xmldom/xmldom@^0.8.8": + version "0.8.10" + resolved "https://registry.yarnpkg.com/@xmldom/xmldom/-/xmldom-0.8.10.tgz#a1337ca426aa61cef9fe15b5b28e340a72f6fa99" + integrity sha512-2WALfTl4xo2SkGCYRt6rDTFfk9R1czmBvUQy12gK2KuRKIpWEhcbbzy8EZXtz/jkRqHX8bFEc6FC1HjX4TUWYw== + +acorn-walk@^8.1.1: + version "8.3.4" + resolved "https://registry.yarnpkg.com/acorn-walk/-/acorn-walk-8.3.4.tgz#794dd169c3977edf4ba4ea47583587c5866236b7" + integrity sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g== + dependencies: + acorn "^8.11.0" + +acorn@^8.11.0, acorn@^8.4.1: + version "8.15.0" + resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.15.0.tgz#a360898bc415edaac46c8241f6383975b930b816" + integrity sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg== + +ansi-regex@^5.0.1: + version "5.0.1" + resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-5.0.1.tgz#082cb2c89c9fe8659a311a53bd6a4dc5301db304" + integrity sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ== + +ansi-styles@^4.0.0, ansi-styles@^4.1.0: + version "4.3.0" + resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-4.3.0.tgz#edd803628ae71c04c85ae7a0906edad34b648937" + integrity sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg== + dependencies: + color-convert "^2.0.1" + +arg@^4.1.0: + version "4.1.3" + resolved "https://registry.yarnpkg.com/arg/-/arg-4.1.3.tgz#269fc7ad5b8e42cb63c896d5666017261c144089" + integrity sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA== + +array-buffer-byte-length@^1.0.1, array-buffer-byte-length@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz#384d12a37295aec3769ab022ad323a18a51ccf8b" + integrity sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw== + dependencies: + call-bound "^1.0.3" + is-array-buffer "^3.0.5" + +array.prototype.flat@^1.2.3: + version "1.3.3" + resolved "https://registry.yarnpkg.com/array.prototype.flat/-/array.prototype.flat-1.3.3.tgz#534aaf9e6e8dd79fb6b9a9917f839ef1ec63afe5" + integrity sha512-rwG/ja1neyLqCuGZ5YYrznA62D4mZXg0i1cIskIUKSiqF3Cje9/wXAls9B9s1Wa2fomMsIv8czB8jZcPmxCXFg== + dependencies: + call-bind "^1.0.8" + define-properties "^1.2.1" + es-abstract "^1.23.5" + es-shim-unscopables "^1.0.2" + +arraybuffer.prototype.slice@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz#9d760d84dbdd06d0cbf92c8849615a1a7ab3183c" + integrity sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ== + dependencies: + array-buffer-byte-length "^1.0.1" + call-bind "^1.0.8" + define-properties "^1.2.1" + es-abstract "^1.23.5" + es-errors "^1.3.0" + get-intrinsic "^1.2.6" + is-array-buffer "^3.0.4" + +async-function@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/async-function/-/async-function-1.0.0.tgz#509c9fca60eaf85034c6829838188e4e4c8ffb2b" + integrity sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA== + +async-lock@^1.4.1: + version "1.4.1" + resolved "https://registry.yarnpkg.com/async-lock/-/async-lock-1.4.1.tgz#56b8718915a9b68b10fce2f2a9a3dddf765ef53f" + integrity sha512-Az2ZTpuytrtqENulXwO3GGv1Bztugx6TT37NIo7imr/Qo0gsYiGtSdBa2B6fsXhTpVZDNfu1Qn3pk531e3q+nQ== + +asynckit@^0.4.0: + version "0.4.0" + resolved "https://registry.yarnpkg.com/asynckit/-/asynckit-0.4.0.tgz#c79ed97f7f34cb8f2ba1bc9790bcc366474b4b79" + integrity sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q== + +available-typed-arrays@^1.0.7: + version "1.0.7" + resolved "https://registry.yarnpkg.com/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz#a5cc375d6a03c2efc87a553f3e0b1522def14846" + integrity sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ== + dependencies: + possible-typed-array-names "^1.0.0" + +base64-js@^1.3.1, base64-js@^1.5.1: + version "1.5.1" + resolved "https://registry.yarnpkg.com/base64-js/-/base64-js-1.5.1.tgz#1b1b440160a5bf7ad40b650f095963481903930a" + integrity sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA== + +big-integer@1.6.x: + version "1.6.52" + resolved "https://registry.yarnpkg.com/big-integer/-/big-integer-1.6.52.tgz#60a887f3047614a8e1bffe5d7173490a97dc8c85" + integrity sha512-QxD8cf2eVqJOOz63z6JIN9BzvVs/dlySa5HGSBH5xtR8dPteIRQnBxxKqkNTiT6jbDTF6jAfrd4oMcND9RGbQg== + +bplist-parser@^0.3.2: + version "0.3.2" + resolved "https://registry.yarnpkg.com/bplist-parser/-/bplist-parser-0.3.2.tgz#3ac79d67ec52c4c107893e0237eb787cbacbced7" + integrity sha512-apC2+fspHGI3mMKj+dGevkGo/tCqVB8jMb6i+OX+E29p0Iposz07fABkRIfVUPNd5A5VbuOz1bZbnmkKLYF+wQ== + dependencies: + big-integer "1.6.x" + +breakword@^1.0.5: + version "1.0.6" + resolved "https://registry.yarnpkg.com/breakword/-/breakword-1.0.6.tgz#242506e7b871b7fad1bce8dc05cb0f2a129c12bd" + integrity sha512-yjxDAYyK/pBvws9H4xKYpLDpYKEH6CzrBPAuXq3x18I+c/2MkVtT3qAr7Oloi6Dss9qNhPVueAAVU1CSeNDIXw== + dependencies: + wcwidth "^1.0.1" + +buffer-crc32@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/buffer-crc32/-/buffer-crc32-1.0.0.tgz#a10993b9055081d55304bd9feb4a072de179f405" + integrity sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w== + +buffer-crc32@~0.2.3: + version "0.2.13" + resolved "https://registry.yarnpkg.com/buffer-crc32/-/buffer-crc32-0.2.13.tgz#0d333e3f00eac50aa1454abd30ef8c2a5d9a7242" + integrity sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ== + +buffer@^5.0.7, buffer@^5.1.0: + version "5.7.1" + resolved "https://registry.yarnpkg.com/buffer/-/buffer-5.7.1.tgz#ba62e7c13133053582197160851a8f648e99eed0" + integrity sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ== + dependencies: + base64-js "^1.3.1" + ieee754 "^1.1.13" + +bufferpack@0.0.6: + version "0.0.6" + resolved "https://registry.yarnpkg.com/bufferpack/-/bufferpack-0.0.6.tgz#fb3d8738a0e1e4e03bcff99f9a75f9ec18a9d73e" + integrity sha512-MTWvLHElqczrIVhge9qHtqgNigJFyh0+tCDId5yCbFAfuekHWIG+uAgvoHVflwrDPuY/e47JE1ki5qcM7w4uLg== + +bytebuffer@^5.0.1: + version "5.0.1" + resolved "https://registry.yarnpkg.com/bytebuffer/-/bytebuffer-5.0.1.tgz#582eea4b1a873b6d020a48d58df85f0bba6cfddd" + integrity sha512-IuzSdmADppkZ6DlpycMkm8l9zeEq16fWtLvunEwFiYciR/BHo4E8/xs5piFquG+Za8OWmMqHF8zuRviz2LHvRQ== + dependencies: + long "~3" + +call-bind-apply-helpers@^1.0.0, call-bind-apply-helpers@^1.0.1, call-bind-apply-helpers@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz#4b5428c222be985d79c3d82657479dbe0b59b2d6" + integrity sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ== + dependencies: + es-errors "^1.3.0" + function-bind "^1.1.2" + +call-bind@^1.0.7, call-bind@^1.0.8: + version "1.0.8" + resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.8.tgz#0736a9660f537e3388826f440d5ec45f744eaa4c" + integrity sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww== + dependencies: + call-bind-apply-helpers "^1.0.0" + es-define-property "^1.0.0" + get-intrinsic "^1.2.4" + set-function-length "^1.2.2" + +call-bound@^1.0.2, call-bound@^1.0.3, call-bound@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/call-bound/-/call-bound-1.0.4.tgz#238de935d2a2a692928c538c7ccfa91067fd062a" + integrity sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg== + dependencies: + call-bind-apply-helpers "^1.0.2" + get-intrinsic "^1.3.0" + +camelcase@^5.0.0: + version "5.3.1" + resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-5.3.1.tgz#e3c9b31569e106811df242f715725a1f4c494320" + integrity sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg== + +cgbi-to-png@^1.0.7: + version "1.0.7" + resolved "https://registry.yarnpkg.com/cgbi-to-png/-/cgbi-to-png-1.0.7.tgz#c7497580f76f87c2f5d825748a9d902b4072c004" + integrity sha512-YR80kxTPuq9oRpZUdQmNEQWrmTKLINk1cfLVfyrV7Rfr9KLtLJdcockPKbreIr4JYAq+DhHBR7w+WA/tF5VDaQ== + dependencies: + bufferpack "0.0.6" + crc "^3.3.0" + stream-to-buffer "^0.1.0" + streamifier "^0.1.1" + +chalk@4, chalk@^4.1.2: + version "4.1.2" + resolved "https://registry.yarnpkg.com/chalk/-/chalk-4.1.2.tgz#aac4e2b7734a740867aeb16bf02aad556a1e7a01" + integrity sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA== + dependencies: + ansi-styles "^4.1.0" + supports-color "^7.1.0" + +clean-git-ref@^2.0.1: + version "2.0.1" + resolved "https://registry.yarnpkg.com/clean-git-ref/-/clean-git-ref-2.0.1.tgz#dcc0ca093b90e527e67adb5a5e55b1af6816dcd9" + integrity sha512-bLSptAy2P0s6hU4PzuIMKmMJJSE6gLXGH1cntDu7bWJUksvuM+7ReOK61mozULErYvP6a15rnYl0zFDef+pyPw== + +cli-arguments@^0.2.1: + version "0.2.1" + resolved "https://registry.yarnpkg.com/cli-arguments/-/cli-arguments-0.2.1.tgz#6161276a2898516c04d2148b6af30fbbdcef72b2" + integrity sha512-vaoTjiREjxKlpTNMiaJUkQnYRhgui8r+huhB6mMHcGQyz5F7Hd1o1jsW9C/wRKjlNYQ6fTvODLtZe7DxfEIz8g== + +cliui@^6.0.0: + version "6.0.0" + resolved "https://registry.yarnpkg.com/cliui/-/cliui-6.0.0.tgz#511d702c0c4e41ca156d7d0e96021f23e13225b1" + integrity sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ== + dependencies: + string-width "^4.2.0" + strip-ansi "^6.0.0" + wrap-ansi "^6.2.0" + +cliui@^8.0.1: + version "8.0.1" + resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa" + integrity sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ== + dependencies: + string-width "^4.2.0" + strip-ansi "^6.0.1" + wrap-ansi "^7.0.0" + +clone@^1.0.2: + version "1.0.4" + resolved "https://registry.yarnpkg.com/clone/-/clone-1.0.4.tgz#da309cc263df15994c688ca902179ca3c7cd7c7e" + integrity sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg== + +color-convert@^2.0.1: + version "2.0.1" + resolved "https://registry.yarnpkg.com/color-convert/-/color-convert-2.0.1.tgz#72d3a68d598c9bdb3af2ad1e84f21d896abd4de3" + integrity sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ== + dependencies: + color-name "~1.1.4" + +color-name@~1.1.4: + version "1.1.4" + resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.4.tgz#c2a09a87acbde69543de6f63fa3995c826c536a2" + integrity sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA== + +combined-stream@^1.0.8: + version "1.0.8" + resolved "https://registry.yarnpkg.com/combined-stream/-/combined-stream-1.0.8.tgz#c3d45a8b34fd730631a110a8a2520682b31d5a7f" + integrity sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg== + dependencies: + delayed-stream "~1.0.0" + +commander@^13: + version "13.1.0" + resolved "https://registry.yarnpkg.com/commander/-/commander-13.1.0.tgz#776167db68c78f38dcce1f9b8d7b8b9a488abf46" + integrity sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw== + +compare-versions@^6.1.1: + version "6.1.1" + resolved "https://registry.yarnpkg.com/compare-versions/-/compare-versions-6.1.1.tgz#7af3cc1099ba37d244b3145a9af5201b629148a9" + integrity sha512-4hm4VPpIecmlg59CHXnRDnqGplJFrbLG4aFEl5vl6cK1u76ws3LLvX7ikFnTDl5vo39sjWD6AaDPYodJp/NNHg== + +config-chain@^1.1.11: + version "1.1.13" + resolved "https://registry.yarnpkg.com/config-chain/-/config-chain-1.1.13.tgz#fad0795aa6a6cdaff9ed1b68e9dff94372c232f4" + integrity sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ== + dependencies: + ini "^1.3.4" + proto-list "~1.2.1" + +crc-32@^1.2.0: + version "1.2.2" + resolved "https://registry.yarnpkg.com/crc-32/-/crc-32-1.2.2.tgz#3cad35a934b8bf71f25ca524b6da51fb7eace2ff" + integrity sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ== + +crc@^3.3.0: + version "3.8.0" + resolved "https://registry.yarnpkg.com/crc/-/crc-3.8.0.tgz#ad60269c2c856f8c299e2c4cc0de4556914056c6" + integrity sha512-iX3mfgcTMIq3ZKLIsVFAbv7+Mc10kxabAGQb8HvjA1o3T1PIYprbakQ65d3I+2HGHt6nSKkM9PYjgoJO2KcFBQ== + dependencies: + buffer "^5.1.0" + +create-require@^1.1.0: + version "1.1.1" + resolved "https://registry.yarnpkg.com/create-require/-/create-require-1.1.1.tgz#c1d7e8f1e5f6cfc9ff65f9cd352d37348756c333" + integrity sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ== + +csv-generate@^3.4.3: + version "3.4.3" + resolved "https://registry.yarnpkg.com/csv-generate/-/csv-generate-3.4.3.tgz#bc42d943b45aea52afa896874291da4b9108ffff" + integrity sha512-w/T+rqR0vwvHqWs/1ZyMDWtHHSJaN06klRqJXBEpDJaM/+dZkso0OKh1VcuuYvK3XM53KysVNq8Ko/epCK8wOw== + +csv-parse@^4.16.3: + version "4.16.3" + resolved "https://registry.yarnpkg.com/csv-parse/-/csv-parse-4.16.3.tgz#7ca624d517212ebc520a36873c3478fa66efbaf7" + integrity sha512-cO1I/zmz4w2dcKHVvpCr7JVRu8/FymG5OEpmvsZYlccYolPBLoVGKUHgNoc4ZGkFeFlWGEDmMyBM+TTqRdW/wg== + +csv-stringify@^5.6.5: + version "5.6.5" + resolved "https://registry.yarnpkg.com/csv-stringify/-/csv-stringify-5.6.5.tgz#c6d74badda4b49a79bf4e72f91cce1e33b94de00" + integrity sha512-PjiQ659aQ+fUTQqSrd1XEDnOr52jh30RBurfzkscaE2tPaFsDH5wOAHJiw8XAHphRknCwMUE9KRayc4K/NbO8A== + +csv@^5.5.3: + version "5.5.3" + resolved "https://registry.yarnpkg.com/csv/-/csv-5.5.3.tgz#cd26c1e45eae00ce6a9b7b27dcb94955ec95207d" + integrity sha512-QTaY0XjjhTQOdguARF0lGKm5/mEq9PD9/VhZZegHDIBq2tQwgNpHc3dneD4mGo2iJs+fTKv5Bp0fZ+BRuY3Z0g== + dependencies: + csv-generate "^3.4.3" + csv-parse "^4.16.3" + csv-stringify "^5.6.5" + stream-transform "^2.1.3" + +data-view-buffer@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/data-view-buffer/-/data-view-buffer-1.0.2.tgz#211a03ba95ecaf7798a8c7198d79536211f88570" + integrity sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ== + dependencies: + call-bound "^1.0.3" + es-errors "^1.3.0" + is-data-view "^1.0.2" + +data-view-byte-length@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz#9e80f7ca52453ce3e93d25a35318767ea7704735" + integrity sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ== + dependencies: + call-bound "^1.0.3" + es-errors "^1.3.0" + is-data-view "^1.0.2" + +data-view-byte-offset@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz#068307f9b71ab76dbbe10291389e020856606191" + integrity sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ== + dependencies: + call-bound "^1.0.2" + es-errors "^1.3.0" + is-data-view "^1.0.1" + +decamelize@^1.2.0: + version "1.2.0" + resolved "https://registry.yarnpkg.com/decamelize/-/decamelize-1.2.0.tgz#f6534d15148269b20352e7bee26f501f9a191290" + integrity sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA== + +decompress-response@^6.0.0: + version "6.0.0" + resolved "https://registry.yarnpkg.com/decompress-response/-/decompress-response-6.0.0.tgz#ca387612ddb7e104bd16d85aab00d5ecf09c66fc" + integrity sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ== + dependencies: + mimic-response "^3.1.0" + +defaults@^1.0.3: + version "1.0.4" + resolved "https://registry.yarnpkg.com/defaults/-/defaults-1.0.4.tgz#b0b02062c1e2aa62ff5d9528f0f98baa90978d7a" + integrity sha512-eFuaLoy/Rxalv2kr+lqMlUnrDWV+3j4pljOIJgLIhI058IQfWJ7vXhyEIHu+HtC738klGALYxOKDO0bQP3tg8A== + dependencies: + clone "^1.0.2" + +define-data-property@^1.0.1, define-data-property@^1.1.4: + version "1.1.4" + resolved "https://registry.yarnpkg.com/define-data-property/-/define-data-property-1.1.4.tgz#894dc141bb7d3060ae4366f6a0107e68fbe48c5e" + integrity sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A== + dependencies: + es-define-property "^1.0.0" + es-errors "^1.3.0" + gopd "^1.0.1" + +define-properties@^1.2.1: + version "1.2.1" + resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.2.1.tgz#10781cc616eb951a80a034bafcaa7377f6af2b6c" + integrity sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg== + dependencies: + define-data-property "^1.0.1" + has-property-descriptors "^1.0.0" + object-keys "^1.1.1" + +delayed-stream@~1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/delayed-stream/-/delayed-stream-1.0.0.tgz#df3ae199acadfb7d440aaae0b29e2272b24ec619" + integrity sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ== + +diff3@0.0.3: + version "0.0.3" + resolved "https://registry.yarnpkg.com/diff3/-/diff3-0.0.3.tgz#d4e5c3a4cdf4e5fe1211ab42e693fcb4321580fc" + integrity sha512-iSq8ngPOt0K53A6eVr4d5Kn6GNrM2nQZtC740pzIriHtn4pOQ2lyzEXQMBeVcWERN0ye7fhBsk9PbLLQOnUx/g== + +diff@^4.0.1: + version "4.0.2" + resolved "https://registry.yarnpkg.com/diff/-/diff-4.0.2.tgz#60f3aecb89d5fae520c11aa19efc2bb982aade7d" + integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A== + +dunder-proto@^1.0.0, dunder-proto@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/dunder-proto/-/dunder-proto-1.0.1.tgz#d7ae667e1dc83482f8b70fd0f6eefc50da30f58a" + integrity sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A== + dependencies: + call-bind-apply-helpers "^1.0.1" + es-errors "^1.3.0" + gopd "^1.2.0" + +emoji-regex@^8.0.0: + version "8.0.0" + resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-8.0.0.tgz#e818fd69ce5ccfcb404594f842963bf53164cc37" + integrity sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A== + +es-abstract@^1.23.5, es-abstract@^1.23.9: + version "1.24.0" + resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.24.0.tgz#c44732d2beb0acc1ed60df840869e3106e7af328" + integrity sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg== + dependencies: + array-buffer-byte-length "^1.0.2" + arraybuffer.prototype.slice "^1.0.4" + available-typed-arrays "^1.0.7" + call-bind "^1.0.8" + call-bound "^1.0.4" + data-view-buffer "^1.0.2" + data-view-byte-length "^1.0.2" + data-view-byte-offset "^1.0.1" + es-define-property "^1.0.1" + es-errors "^1.3.0" + es-object-atoms "^1.1.1" + es-set-tostringtag "^2.1.0" + es-to-primitive "^1.3.0" + function.prototype.name "^1.1.8" + get-intrinsic "^1.3.0" + get-proto "^1.0.1" + get-symbol-description "^1.1.0" + globalthis "^1.0.4" + gopd "^1.2.0" + has-property-descriptors "^1.0.2" + has-proto "^1.2.0" + has-symbols "^1.1.0" + hasown "^2.0.2" + internal-slot "^1.1.0" + is-array-buffer "^3.0.5" + is-callable "^1.2.7" + is-data-view "^1.0.2" + is-negative-zero "^2.0.3" + is-regex "^1.2.1" + is-set "^2.0.3" + is-shared-array-buffer "^1.0.4" + is-string "^1.1.1" + is-typed-array "^1.1.15" + is-weakref "^1.1.1" + math-intrinsics "^1.1.0" + object-inspect "^1.13.4" + object-keys "^1.1.1" + object.assign "^4.1.7" + own-keys "^1.0.1" + regexp.prototype.flags "^1.5.4" + safe-array-concat "^1.1.3" + safe-push-apply "^1.0.0" + safe-regex-test "^1.1.0" + set-proto "^1.0.0" + stop-iteration-iterator "^1.1.0" + string.prototype.trim "^1.2.10" + string.prototype.trimend "^1.0.9" + string.prototype.trimstart "^1.0.8" + typed-array-buffer "^1.0.3" + typed-array-byte-length "^1.0.3" + typed-array-byte-offset "^1.0.4" + typed-array-length "^1.0.7" + unbox-primitive "^1.1.0" + which-typed-array "^1.1.19" + +es-define-property@^1.0.0, es-define-property@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/es-define-property/-/es-define-property-1.0.1.tgz#983eb2f9a6724e9303f61addf011c72e09e0b0fa" + integrity sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g== + +es-errors@^1.3.0: + version "1.3.0" + resolved "https://registry.yarnpkg.com/es-errors/-/es-errors-1.3.0.tgz#05f75a25dab98e4fb1dcd5e1472c0546d5057c8f" + integrity sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw== + +es-object-atoms@^1.0.0, es-object-atoms@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/es-object-atoms/-/es-object-atoms-1.1.1.tgz#1c4f2c4837327597ce69d2ca190a7fdd172338c1" + integrity sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA== + dependencies: + es-errors "^1.3.0" + +es-set-tostringtag@^2.1.0: + version "2.1.0" + resolved "https://registry.yarnpkg.com/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz#f31dbbe0c183b00a6d26eb6325c810c0fd18bd4d" + integrity sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA== + dependencies: + es-errors "^1.3.0" + get-intrinsic "^1.2.6" + has-tostringtag "^1.0.2" + hasown "^2.0.2" + +es-shim-unscopables@^1.0.2: + version "1.1.0" + resolved "https://registry.yarnpkg.com/es-shim-unscopables/-/es-shim-unscopables-1.1.0.tgz#438df35520dac5d105f3943d927549ea3b00f4b5" + integrity sha512-d9T8ucsEhh8Bi1woXCf+TIKDIROLG5WCkxg8geBCbvk22kzwC5G2OnXVMO6FUsvQlgUUXQ2itephWDLqDzbeCw== + dependencies: + hasown "^2.0.2" + +es-to-primitive@^1.3.0: + version "1.3.0" + resolved "https://registry.yarnpkg.com/es-to-primitive/-/es-to-primitive-1.3.0.tgz#96c89c82cc49fd8794a24835ba3e1ff87f214e18" + integrity sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g== + dependencies: + is-callable "^1.2.7" + is-date-object "^1.0.5" + is-symbol "^1.0.4" + +escalade@^3.1.1: + version "3.2.0" + resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.2.0.tgz#011a3f69856ba189dffa7dc8fcce99d2a87903e5" + integrity sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA== + +fd-slicer@~1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/fd-slicer/-/fd-slicer-1.1.0.tgz#25c7c89cb1f9077f8891bbe61d8f390eae256f1e" + integrity sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g== + dependencies: + pend "~1.2.0" + +filesize-parser@^1.5.1: + version "1.5.1" + resolved "https://registry.yarnpkg.com/filesize-parser/-/filesize-parser-1.5.1.tgz#2395aaff197a6eb2c3f7b2b5cd5018415cd8da4b" + integrity sha512-wRjdlQ5JM3WHZp6xpakIHQbkcGig8ANglYQDPcQSgZUN5kcDGOgmAwB0396BxzHxcl+kr+GLuusxBnsjdO6x9A== + +find-up@^4.1.0: + version "4.1.0" + resolved "https://registry.yarnpkg.com/find-up/-/find-up-4.1.0.tgz#97afe7d6cdc0bc5928584b7c8d7b16e8a9aa5d19" + integrity sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw== + dependencies: + locate-path "^5.0.0" + path-exists "^4.0.0" + +for-each@^0.3.3, for-each@^0.3.5: + version "0.3.5" + resolved "https://registry.yarnpkg.com/for-each/-/for-each-0.3.5.tgz#d650688027826920feeb0af747ee7b9421a41d47" + integrity sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg== + dependencies: + is-callable "^1.2.7" + +form-data@^4.0.2: + version "4.0.4" + resolved "https://registry.yarnpkg.com/form-data/-/form-data-4.0.4.tgz#784cdcce0669a9d68e94d11ac4eea98088edd2c4" + integrity sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow== + dependencies: + asynckit "^0.4.0" + combined-stream "^1.0.8" + es-set-tostringtag "^2.1.0" + hasown "^2.0.2" + mime-types "^2.1.12" + +fs-extra@8: + version "8.1.0" + resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-8.1.0.tgz#49d43c45a88cd9677668cb7be1b46efdb8d2e1c0" + integrity sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g== + dependencies: + graceful-fs "^4.2.0" + jsonfile "^4.0.0" + universalify "^0.1.0" + +function-bind@^1.1.2: + version "1.1.2" + resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.2.tgz#2c02d864d97f3ea6c8830c464cbd11ab6eab7a1c" + integrity sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA== + +function.prototype.name@^1.1.6, function.prototype.name@^1.1.8: + version "1.1.8" + resolved "https://registry.yarnpkg.com/function.prototype.name/-/function.prototype.name-1.1.8.tgz#e68e1df7b259a5c949eeef95cdbde53edffabb78" + integrity sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q== + dependencies: + call-bind "^1.0.8" + call-bound "^1.0.3" + define-properties "^1.2.1" + functions-have-names "^1.2.3" + hasown "^2.0.2" + is-callable "^1.2.7" + +functions-have-names@^1.2.3: + version "1.2.3" + resolved "https://registry.yarnpkg.com/functions-have-names/-/functions-have-names-1.2.3.tgz#0404fe4ee2ba2f607f0e0ec3c80bae994133b834" + integrity sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ== + +get-caller-file@^2.0.1, get-caller-file@^2.0.5: + version "2.0.5" + resolved "https://registry.yarnpkg.com/get-caller-file/-/get-caller-file-2.0.5.tgz#4f94412a82db32f36e3b0b9741f8a97feb031f7e" + integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg== + +get-intrinsic@^1.2.4, get-intrinsic@^1.2.5, get-intrinsic@^1.2.6, get-intrinsic@^1.2.7, get-intrinsic@^1.3.0: + version "1.3.0" + resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.3.0.tgz#743f0e3b6964a93a5491ed1bffaae054d7f98d01" + integrity sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ== + dependencies: + call-bind-apply-helpers "^1.0.2" + es-define-property "^1.0.1" + es-errors "^1.3.0" + es-object-atoms "^1.1.1" + function-bind "^1.1.2" + get-proto "^1.0.1" + gopd "^1.2.0" + has-symbols "^1.1.0" + hasown "^2.0.2" + math-intrinsics "^1.1.0" + +get-proto@^1.0.0, get-proto@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/get-proto/-/get-proto-1.0.1.tgz#150b3f2743869ef3e851ec0c49d15b1d14d00ee1" + integrity sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g== + dependencies: + dunder-proto "^1.0.1" + es-object-atoms "^1.0.0" + +get-symbol-description@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/get-symbol-description/-/get-symbol-description-1.1.0.tgz#7bdd54e0befe8ffc9f3b4e203220d9f1e881b6ee" + integrity sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg== + dependencies: + call-bound "^1.0.3" + es-errors "^1.3.0" + get-intrinsic "^1.2.6" + +global-dirs@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/global-dirs/-/global-dirs-4.0.0.tgz#953f7e7e81c07f146884d0679a485bf24faa21fb" + integrity sha512-PJ0OjGf/kVuu9gh5IPgAyssfJne5PsU9+ICxfWiRYDUnYq8ob+Y2nSWAEUNEHRj+gowyzI+wg5/nWkvcjcyLwg== + dependencies: + ini "2.0.0" + +globalthis@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/globalthis/-/globalthis-1.0.4.tgz#7430ed3a975d97bfb59bcce41f5cabbafa651236" + integrity sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ== + dependencies: + define-properties "^1.2.1" + gopd "^1.0.1" + +gopd@^1.0.1, gopd@^1.2.0: + version "1.2.0" + resolved "https://registry.yarnpkg.com/gopd/-/gopd-1.2.0.tgz#89f56b8217bdbc8802bd299df6d7f1081d7e51a1" + integrity sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg== + +graceful-fs@4.2.10: + version "4.2.10" + resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.10.tgz#147d3a006da4ca3ce14728c7aefc287c367d7a6c" + integrity sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA== + +graceful-fs@^4.1.6, graceful-fs@^4.2.0: + version "4.2.11" + resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.11.tgz#4183e4e8bf08bb6e05bbb2f7d2e0c8f712ca40e3" + integrity sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ== + +gradle-to-js@^2.0.1: + version "2.0.1" + resolved "https://registry.yarnpkg.com/gradle-to-js/-/gradle-to-js-2.0.1.tgz#3d943ba026afe19b7b6a0af3bc00d1cfd4c2eac4" + integrity sha512-is3hDn9zb8XXnjbEeAEIqxTpLHUiGBqjegLmXPuyMBfKAggpadWFku4/AP8iYAGBX6qR9/5UIUIp47V0XI3aMw== + dependencies: + lodash.merge "^4.6.2" + +grapheme-splitter@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/grapheme-splitter/-/grapheme-splitter-1.0.4.tgz#9cf3a665c6247479896834af35cf1dbb4400767e" + integrity sha512-bzh50DW9kTPM00T8y4o8vQg89Di9oLJVLW/KaOGIXJWP/iqCN6WKYkbNOF04vFLJhwcpYUh9ydh/+5vpOqV4YQ== + +has-bigints@^1.0.2: + version "1.1.0" + resolved "https://registry.yarnpkg.com/has-bigints/-/has-bigints-1.1.0.tgz#28607e965ac967e03cd2a2c70a2636a1edad49fe" + integrity sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg== + +has-flag@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/has-flag/-/has-flag-4.0.0.tgz#944771fd9c81c81265c4d6941860da06bb59479b" + integrity sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ== + +has-property-descriptors@^1.0.0, has-property-descriptors@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz#963ed7d071dc7bf5f084c5bfbe0d1b6222586854" + integrity sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg== + dependencies: + es-define-property "^1.0.0" + +has-proto@^1.2.0: + version "1.2.0" + resolved "https://registry.yarnpkg.com/has-proto/-/has-proto-1.2.0.tgz#5de5a6eabd95fdffd9818b43055e8065e39fe9d5" + integrity sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ== + dependencies: + dunder-proto "^1.0.0" + +has-symbols@^1.0.3, has-symbols@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.1.0.tgz#fc9c6a783a084951d0b971fe1018de813707a338" + integrity sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ== + +has-tostringtag@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/has-tostringtag/-/has-tostringtag-1.0.2.tgz#2cdc42d40bef2e5b4eeab7c01a73c54ce7ab5abc" + integrity sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw== + dependencies: + has-symbols "^1.0.3" + +hasown@^2.0.2: + version "2.0.2" + resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.2.tgz#003eaf91be7adc372e84ec59dc37252cedb80003" + integrity sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ== + dependencies: + function-bind "^1.1.2" + +i18next@^24.2.3: + version "24.2.3" + resolved "https://registry.yarnpkg.com/i18next/-/i18next-24.2.3.tgz#3a05f72615cbd7c00d7e348667e2aabef1df753b" + integrity sha512-lfbf80OzkocvX7nmZtu7nSTNbrTYR52sLWxPtlXX1zAhVw8WEnFk4puUkCR4B1dNQwbSpEHHHemcZu//7EcB7A== + dependencies: + "@babel/runtime" "^7.26.10" + +ieee754@^1.1.13: + version "1.2.1" + resolved "https://registry.yarnpkg.com/ieee754/-/ieee754-1.2.1.tgz#8eb7a10a63fff25d15a57b001586d177d1b0d352" + integrity sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA== + +ignore@^5.1.4: + version "5.3.2" + resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.3.2.tgz#3cd40e729f3643fd87cb04e50bf0eb722bc596f5" + integrity sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g== + +inherits@^2.0.3, inherits@^2.0.4: + version "2.0.4" + resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.4.tgz#0fa2c64f932917c3433a0ded55363aae37416b7c" + integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ== + +ini@2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/ini/-/ini-2.0.0.tgz#e5fd556ecdd5726be978fa1001862eacb0a94bc5" + integrity sha512-7PnF4oN3CvZF23ADhA5wRaYEQpJ8qygSkbtTXWBeXWXmEVRXK+1ITciHWwHhsjv1TmW0MgacIv6hEi5pX5NQdA== + +ini@^1.3.4: + version "1.3.8" + resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c" + integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew== + +internal-slot@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.1.0.tgz#1eac91762947d2f7056bc838d93e13b2e9604961" + integrity sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw== + dependencies: + es-errors "^1.3.0" + hasown "^2.0.2" + side-channel "^1.1.0" + +is-array-buffer@^3.0.4, is-array-buffer@^3.0.5: + version "3.0.5" + resolved "https://registry.yarnpkg.com/is-array-buffer/-/is-array-buffer-3.0.5.tgz#65742e1e687bd2cc666253068fd8707fe4d44280" + integrity sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A== + dependencies: + call-bind "^1.0.8" + call-bound "^1.0.3" + get-intrinsic "^1.2.6" + +is-async-function@^2.0.0: + version "2.1.1" + resolved "https://registry.yarnpkg.com/is-async-function/-/is-async-function-2.1.1.tgz#3e69018c8e04e73b738793d020bfe884b9fd3523" + integrity sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ== + dependencies: + async-function "^1.0.0" + call-bound "^1.0.3" + get-proto "^1.0.1" + has-tostringtag "^1.0.2" + safe-regex-test "^1.1.0" + +is-bigint@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/is-bigint/-/is-bigint-1.1.0.tgz#dda7a3445df57a42583db4228682eba7c4170672" + integrity sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ== + dependencies: + has-bigints "^1.0.2" + +is-boolean-object@^1.2.1: + version "1.2.2" + resolved "https://registry.yarnpkg.com/is-boolean-object/-/is-boolean-object-1.2.2.tgz#7067f47709809a393c71ff5bb3e135d8a9215d9e" + integrity sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A== + dependencies: + call-bound "^1.0.3" + has-tostringtag "^1.0.2" + +is-callable@^1.2.7: + version "1.2.7" + resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.2.7.tgz#3bc2a85ea742d9e36205dcacdd72ca1fdc51b055" + integrity sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA== + +is-data-view@^1.0.1, is-data-view@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/is-data-view/-/is-data-view-1.0.2.tgz#bae0a41b9688986c2188dda6657e56b8f9e63b8e" + integrity sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw== + dependencies: + call-bound "^1.0.2" + get-intrinsic "^1.2.6" + is-typed-array "^1.1.13" + +is-date-object@^1.0.5, is-date-object@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.1.0.tgz#ad85541996fc7aa8b2729701d27b7319f95d82f7" + integrity sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg== + dependencies: + call-bound "^1.0.2" + has-tostringtag "^1.0.2" + +is-finalizationregistry@^1.1.0: + version "1.1.1" + resolved "https://registry.yarnpkg.com/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz#eefdcdc6c94ddd0674d9c85887bf93f944a97c90" + integrity sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg== + dependencies: + call-bound "^1.0.3" + +is-fullwidth-code-point@^3.0.0: + version "3.0.0" + resolved "https://registry.yarnpkg.com/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz#f116f8064fe90b3f7844a38997c0b75051269f1d" + integrity sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg== + +is-generator-function@^1.0.10: + version "1.1.0" + resolved "https://registry.yarnpkg.com/is-generator-function/-/is-generator-function-1.1.0.tgz#bf3eeda931201394f57b5dba2800f91a238309ca" + integrity sha512-nPUB5km40q9e8UfN/Zc24eLlzdSf9OfKByBw9CIdw4H1giPMeA0OIJvbchsCu4npfI2QcMVBsGEBHKZ7wLTWmQ== + dependencies: + call-bound "^1.0.3" + get-proto "^1.0.0" + has-tostringtag "^1.0.2" + safe-regex-test "^1.1.0" + +is-map@^2.0.3: + version "2.0.3" + resolved "https://registry.yarnpkg.com/is-map/-/is-map-2.0.3.tgz#ede96b7fe1e270b3c4465e3a465658764926d62e" + integrity sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw== + +is-negative-zero@^2.0.3: + version "2.0.3" + resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.3.tgz#ced903a027aca6381b777a5743069d7376a49747" + integrity sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw== + +is-number-object@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/is-number-object/-/is-number-object-1.1.1.tgz#144b21e95a1bc148205dcc2814a9134ec41b2541" + integrity sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw== + dependencies: + call-bound "^1.0.3" + has-tostringtag "^1.0.2" + +is-regex@^1.2.1: + version "1.2.1" + resolved "https://registry.yarnpkg.com/is-regex/-/is-regex-1.2.1.tgz#76d70a3ed10ef9be48eb577887d74205bf0cad22" + integrity sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g== + dependencies: + call-bound "^1.0.2" + gopd "^1.2.0" + has-tostringtag "^1.0.2" + hasown "^2.0.2" + +is-set@^2.0.3: + version "2.0.3" + resolved "https://registry.yarnpkg.com/is-set/-/is-set-2.0.3.tgz#8ab209ea424608141372ded6e0cb200ef1d9d01d" + integrity sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg== + +is-shared-array-buffer@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz#9b67844bd9b7f246ba0708c3a93e34269c774f6f" + integrity sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A== + dependencies: + call-bound "^1.0.3" + +is-string@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/is-string/-/is-string-1.1.1.tgz#92ea3f3d5c5b6e039ca8677e5ac8d07ea773cbb9" + integrity sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA== + dependencies: + call-bound "^1.0.3" + has-tostringtag "^1.0.2" + +is-symbol@^1.0.4, is-symbol@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/is-symbol/-/is-symbol-1.1.1.tgz#f47761279f532e2b05a7024a7506dbbedacd0634" + integrity sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w== + dependencies: + call-bound "^1.0.2" + has-symbols "^1.1.0" + safe-regex-test "^1.1.0" + +is-typed-array@^1.1.13, is-typed-array@^1.1.14, is-typed-array@^1.1.15: + version "1.1.15" + resolved "https://registry.yarnpkg.com/is-typed-array/-/is-typed-array-1.1.15.tgz#4bfb4a45b61cee83a5a46fba778e4e8d59c0ce0b" + integrity sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ== + dependencies: + which-typed-array "^1.1.16" + +is-weakmap@^2.0.2: + version "2.0.2" + resolved "https://registry.yarnpkg.com/is-weakmap/-/is-weakmap-2.0.2.tgz#bf72615d649dfe5f699079c54b83e47d1ae19cfd" + integrity sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w== + +is-weakref@^1.0.2, is-weakref@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/is-weakref/-/is-weakref-1.1.1.tgz#eea430182be8d64174bd96bffbc46f21bf3f9293" + integrity sha512-6i9mGWSlqzNMEqpCp93KwRS1uUOodk2OJ6b+sq7ZPDSy2WuI5NFIxp/254TytR8ftefexkWn5xNiHUNpPOfSew== + dependencies: + call-bound "^1.0.3" + +is-weakset@^2.0.3: + version "2.0.4" + resolved "https://registry.yarnpkg.com/is-weakset/-/is-weakset-2.0.4.tgz#c9f5deb0bc1906c6d6f1027f284ddf459249daca" + integrity sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ== + dependencies: + call-bound "^1.0.3" + get-intrinsic "^1.2.6" + +isarray@^2.0.5: + version "2.0.5" + resolved "https://registry.yarnpkg.com/isarray/-/isarray-2.0.5.tgz#8af1e4c1221244cc62459faf38940d4e644a5723" + integrity sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw== + +isomorphic-git@^1.30.1: + version "1.32.1" + resolved "https://registry.yarnpkg.com/isomorphic-git/-/isomorphic-git-1.32.1.tgz#08669563c35a4255a26e772ff16cce7a342949a2" + integrity sha512-NZCS7qpLkCZ1M/IrujYBD31sM6pd/fMVArK4fz4I7h6m0rUW2AsYU7S7zXeABuHL6HIfW6l53b4UQ/K441CQjg== + dependencies: + async-lock "^1.4.1" + clean-git-ref "^2.0.1" + crc-32 "^1.2.0" + diff3 "0.0.3" + ignore "^5.1.4" + minimisted "^2.0.0" + pako "^1.0.10" + path-browserify "^1.0.1" + pify "^4.0.1" + readable-stream "^3.4.0" + sha.js "^2.4.9" + simple-get "^4.0.1" + +isomorphic-unzip@^1.1.5: + version "1.1.5" + resolved "https://registry.yarnpkg.com/isomorphic-unzip/-/isomorphic-unzip-1.1.5.tgz#9e5a18e77e3e760b631ee451f643c784b4f880dd" + integrity sha512-2McA51lWhmO3Kk438jxVcYeh6L+AOqVnl9XdX1yI7GlLA9RwEyTBgGem1rNuRIU2abAmOiv+IagThdUxASY4IA== + dependencies: + buffer "^5.0.7" + yauzl "^2.8.0" + +jsonfile@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/jsonfile/-/jsonfile-4.0.0.tgz#8771aae0799b64076b76640fca058f9c10e33ecb" + integrity sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg== + optionalDependencies: + graceful-fs "^4.1.6" + +kleur@^4.1.5: + version "4.1.5" + resolved "https://registry.yarnpkg.com/kleur/-/kleur-4.1.5.tgz#95106101795f7050c6c650f350c683febddb1780" + integrity sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ== + +locate-path@^5.0.0: + version "5.0.0" + resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-5.0.0.tgz#1afba396afd676a6d42504d0a67a3a7eb9f62aa0" + integrity sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g== + dependencies: + p-locate "^4.1.0" + +lodash.merge@^4.6.2: + version "4.6.2" + resolved "https://registry.yarnpkg.com/lodash.merge/-/lodash.merge-4.6.2.tgz#558aa53b43b661e1925a0afdfa36a9a1085fe57a" + integrity sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ== + +long@~3: + version "3.2.0" + resolved "https://registry.yarnpkg.com/long/-/long-3.2.0.tgz#d821b7138ca1cb581c172990ef14db200b5c474b" + integrity sha512-ZYvPPOMqUwPoDsbJaR10iQJYnMuZhRTvHYl62ErLIEX7RgFlziSBUUvrt3OVfc47QlHHpzPZYP17g3Fv7oeJkg== + +make-error@^1.1.1: + version "1.3.6" + resolved "https://registry.yarnpkg.com/make-error/-/make-error-1.3.6.tgz#2eb2e37ea9b67c4891f684a1394799af484cf7a2" + integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw== + +math-intrinsics@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz#a0dd74be81e2aa5c2f27e65ce283605ee4e2b7f9" + integrity sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g== + +mime-db@1.52.0: + version "1.52.0" + resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.52.0.tgz#bbabcdc02859f4987301c856e3387ce5ec43bf70" + integrity sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg== + +mime-types@^2.1.12: + version "2.1.35" + resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.35.tgz#381a871b62a734450660ae3deee44813f70d959a" + integrity sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw== + dependencies: + mime-db "1.52.0" + +mimic-response@^3.1.0: + version "3.1.0" + resolved "https://registry.yarnpkg.com/mimic-response/-/mimic-response-3.1.0.tgz#2d1d59af9c1b129815accc2c46a022a5ce1fa3c9" + integrity sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ== + +minimist@^1.2.5: + version "1.2.8" + resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c" + integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA== + +minimisted@^2.0.0: + version "2.0.1" + resolved "https://registry.yarnpkg.com/minimisted/-/minimisted-2.0.1.tgz#d059fb905beecf0774bc3b308468699709805cb1" + integrity sha512-1oPjfuLQa2caorJUM8HV8lGgWCc0qqAO1MNv/k05G4qslmsndV/5WdNZrqCiyqiz3wohia2Ij2B7w2Dr7/IyrA== + dependencies: + minimist "^1.2.5" + +mixme@^0.5.1: + version "0.5.10" + resolved "https://registry.yarnpkg.com/mixme/-/mixme-0.5.10.tgz#d653b2984b75d9018828f1ea333e51717ead5f51" + integrity sha512-5H76ANWinB1H3twpJ6JY8uvAtpmFvHNArpilJAjXRKXSDDLPIMoZArw5SH0q9z+lLs8IrMw7Q2VWpWimFKFT1Q== + +mute-stream@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/mute-stream/-/mute-stream-2.0.0.tgz#a5446fc0c512b71c83c44d908d5c7b7b4c493b2b" + integrity sha512-WWdIxpyjEn+FhQJQQv9aQAYlHoNVdzIzUySNV1gHUPDSdZJ3yZn7pAAbQcV7B56Mvu881q9FZV+0Vx2xC44VWA== + +node-fetch@^2.6.1: + version "2.7.0" + resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.7.0.tgz#d0f0fa6e3e2dc1d27efcd8ad99d550bda94d187d" + integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A== + dependencies: + whatwg-url "^5.0.0" + +object-inspect@^1.13.3, object-inspect@^1.13.4: + version "1.13.4" + resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.13.4.tgz#8375265e21bc20d0fa582c22e1b13485d6e00213" + integrity sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew== + +object-keys@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/object-keys/-/object-keys-1.1.1.tgz#1c47f272df277f3b1daf061677d9c82e2322c60e" + integrity sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA== + +object.assign@^4.1.7: + version "4.1.7" + resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.7.tgz#8c14ca1a424c6a561b0bb2a22f66f5049a945d3d" + integrity sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw== + dependencies: + call-bind "^1.0.8" + call-bound "^1.0.3" + define-properties "^1.2.1" + es-object-atoms "^1.0.0" + has-symbols "^1.1.0" + object-keys "^1.1.1" + +once@^1.3.1: + version "1.4.0" + resolved "https://registry.yarnpkg.com/once/-/once-1.4.0.tgz#583b1aa775961d4b113ac17d9c50baef9dd76bd1" + integrity sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w== + dependencies: + wrappy "1" + +own-keys@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/own-keys/-/own-keys-1.0.1.tgz#e4006910a2bf913585289676eebd6f390cf51358" + integrity sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg== + dependencies: + get-intrinsic "^1.2.6" + object-keys "^1.1.1" + safe-push-apply "^1.0.0" + +p-limit@^2.2.0: + version "2.3.0" + resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-2.3.0.tgz#3dd33c647a214fdfffd835933eb086da0dc21db1" + integrity sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w== + dependencies: + p-try "^2.0.0" + +p-locate@^4.1.0: + version "4.1.0" + resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-4.1.0.tgz#a3428bb7088b3a60292f66919278b7c297ad4f07" + integrity sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A== + dependencies: + p-limit "^2.2.0" + +p-try@^2.0.0: + version "2.2.0" + resolved "https://registry.yarnpkg.com/p-try/-/p-try-2.2.0.tgz#cb2868540e313d61de58fafbe35ce9004d5540e6" + integrity sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ== + +pako@^1.0.10: + version "1.0.11" + resolved "https://registry.yarnpkg.com/pako/-/pako-1.0.11.tgz#6c9599d340d54dfd3946380252a35705a6b992bf" + integrity sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw== + +path-browserify@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/path-browserify/-/path-browserify-1.0.1.tgz#d98454a9c3753d5790860f16f68867b9e46be1fd" + integrity sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g== + +path-exists@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/path-exists/-/path-exists-4.0.0.tgz#513bdbe2d3b95d7762e8c1137efa195c6c61b5b3" + integrity sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w== + +pend@~1.2.0: + version "1.2.0" + resolved "https://registry.yarnpkg.com/pend/-/pend-1.2.0.tgz#7a57eb550a6783f9115331fcf4663d5c8e007a50" + integrity sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg== + +pify@^4.0.1: + version "4.0.1" + resolved "https://registry.yarnpkg.com/pify/-/pify-4.0.1.tgz#4b2cd25c50d598735c50292224fd8c6df41e3231" + integrity sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g== + +plist@^3.1.0: + version "3.1.0" + resolved "https://registry.yarnpkg.com/plist/-/plist-3.1.0.tgz#797a516a93e62f5bde55e0b9cc9c967f860893c9" + integrity sha512-uysumyrvkUX0rX/dEVqt8gC3sTBzd4zoWfLeS29nb53imdaXVvLINYXTI2GNqzaMuvacNx4uJQ8+b3zXR0pkgQ== + dependencies: + "@xmldom/xmldom" "^0.8.8" + base64-js "^1.5.1" + xmlbuilder "^15.1.1" + +possible-typed-array-names@^1.0.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz#93e3582bc0e5426586d9d07b79ee40fc841de4ae" + integrity sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg== + +progress@^2.0.3: + version "2.0.3" + resolved "https://registry.yarnpkg.com/progress/-/progress-2.0.3.tgz#7e8cf8d8f5b8f239c1bc68beb4eb78567d572ef8" + integrity sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA== + +properties@^1.2.1: + version "1.2.1" + resolved "https://registry.yarnpkg.com/properties/-/properties-1.2.1.tgz#0ee97a7fc020b1a2a55b8659eda4aa8d869094bd" + integrity sha512-qYNxyMj1JeW54i/EWEFsM1cVwxJbtgPp8+0Wg9XjNaK6VE/c4oRi6PNu5p7w1mNXEIQIjV5Wwn8v8Gz82/QzdQ== + +proto-list@~1.2.1: + version "1.2.4" + resolved "https://registry.yarnpkg.com/proto-list/-/proto-list-1.2.4.tgz#212d5bfe1318306a420f6402b8e26ff39647a849" + integrity sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA== + +"react-native-update-cli@file:..": + version "1.46.3" + dependencies: + "@colors/colors" "^1.6.0" + bplist-parser "^0.3.2" + bytebuffer "^5.0.1" + cgbi-to-png "^1.0.7" + chalk "4" + cli-arguments "^0.2.1" + commander "^13" + compare-versions "^6.1.1" + filesize-parser "^1.5.1" + form-data "^4.0.2" + fs-extra "8" + global-dirs "^4.0.0" + gradle-to-js "^2.0.1" + i18next "^24.2.3" + isomorphic-git "^1.30.1" + isomorphic-unzip "^1.1.5" + node-fetch "^2.6.1" + plist "^3.1.0" + progress "^2.0.3" + properties "^1.2.1" + read "^4.1.0" + registry-auth-token "^5.1.0" + semver "^7.7.2" + tcp-ping "^0.1.1" + tty-table "4.2" + yauzl "^3.2.0" + yazl "3.3.1" + +read@^4.1.0: + version "4.1.0" + resolved "https://registry.yarnpkg.com/read/-/read-4.1.0.tgz#d97c2556b009b47b16b5bb82311d477cc7503548" + integrity sha512-uRfX6K+f+R8OOrYScaM3ixPY4erg69f8DN6pgTvMcA9iRc8iDhwrA4m3Yu8YYKsXJgVvum+m8PkRboZwwuLzYA== + dependencies: + mute-stream "^2.0.0" + +readable-stream@^3.4.0: + version "3.6.2" + resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-3.6.2.tgz#56a9b36ea965c00c5a93ef31eb111a0f11056967" + integrity sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA== + dependencies: + inherits "^2.0.3" + string_decoder "^1.1.1" + util-deprecate "^1.0.1" + +reflect.getprototypeof@^1.0.6, reflect.getprototypeof@^1.0.9: + version "1.0.10" + resolved "https://registry.yarnpkg.com/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz#c629219e78a3316d8b604c765ef68996964e7bf9" + integrity sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw== + dependencies: + call-bind "^1.0.8" + define-properties "^1.2.1" + es-abstract "^1.23.9" + es-errors "^1.3.0" + es-object-atoms "^1.0.0" + get-intrinsic "^1.2.7" + get-proto "^1.0.1" + which-builtin-type "^1.2.1" + +regexp.prototype.flags@^1.5.4: + version "1.5.4" + resolved "https://registry.yarnpkg.com/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz#1ad6c62d44a259007e55b3970e00f746efbcaa19" + integrity sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA== + dependencies: + call-bind "^1.0.8" + define-properties "^1.2.1" + es-errors "^1.3.0" + get-proto "^1.0.1" + gopd "^1.2.0" + set-function-name "^2.0.2" + +registry-auth-token@^5.1.0: + version "5.1.0" + resolved "https://registry.yarnpkg.com/registry-auth-token/-/registry-auth-token-5.1.0.tgz#3c659047ecd4caebd25bc1570a3aa979ae490eca" + integrity sha512-GdekYuwLXLxMuFTwAPg5UKGLW/UXzQrZvH/Zj791BQif5T05T0RsaLfHc9q3ZOKi7n+BoprPD9mJ0O0k4xzUlw== + dependencies: + "@pnpm/npm-conf" "^2.1.0" + +require-directory@^2.1.1: + version "2.1.1" + resolved "https://registry.yarnpkg.com/require-directory/-/require-directory-2.1.1.tgz#8c64ad5fd30dab1c976e2344ffe7f792a6a6df42" + integrity sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q== + +require-main-filename@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/require-main-filename/-/require-main-filename-2.0.0.tgz#d0b329ecc7cc0f61649f62215be69af54aa8989b" + integrity sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg== + +safe-array-concat@^1.1.3: + version "1.1.3" + resolved "https://registry.yarnpkg.com/safe-array-concat/-/safe-array-concat-1.1.3.tgz#c9e54ec4f603b0bbb8e7e5007a5ee7aecd1538c3" + integrity sha512-AURm5f0jYEOydBj7VQlVvDrjeFgthDdEF5H1dP+6mNpoXOMo1quQqJ4wvJDyRZ9+pO3kGWoOdmV08cSv2aJV6Q== + dependencies: + call-bind "^1.0.8" + call-bound "^1.0.2" + get-intrinsic "^1.2.6" + has-symbols "^1.1.0" + isarray "^2.0.5" + +safe-buffer@^5.2.1, safe-buffer@~5.2.0: + version "5.2.1" + resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.2.1.tgz#1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6" + integrity sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ== + +safe-push-apply@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/safe-push-apply/-/safe-push-apply-1.0.0.tgz#01850e981c1602d398c85081f360e4e6d03d27f5" + integrity sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA== + dependencies: + es-errors "^1.3.0" + isarray "^2.0.5" + +safe-regex-test@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.1.0.tgz#7f87dfb67a3150782eaaf18583ff5d1711ac10c1" + integrity sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw== + dependencies: + call-bound "^1.0.2" + es-errors "^1.3.0" + is-regex "^1.2.1" + +semver@^7.7.2: + version "7.7.2" + resolved "https://registry.yarnpkg.com/semver/-/semver-7.7.2.tgz#67d99fdcd35cec21e6f8b87a7fd515a33f982b58" + integrity sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA== + +set-blocking@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/set-blocking/-/set-blocking-2.0.0.tgz#045f9782d011ae9a6803ddd382b24392b3d890f7" + integrity sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw== + +set-function-length@^1.2.2: + version "1.2.2" + resolved "https://registry.yarnpkg.com/set-function-length/-/set-function-length-1.2.2.tgz#aac72314198eaed975cf77b2c3b6b880695e5449" + integrity sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg== + dependencies: + define-data-property "^1.1.4" + es-errors "^1.3.0" + function-bind "^1.1.2" + get-intrinsic "^1.2.4" + gopd "^1.0.1" + has-property-descriptors "^1.0.2" + +set-function-name@^2.0.2: + version "2.0.2" + resolved "https://registry.yarnpkg.com/set-function-name/-/set-function-name-2.0.2.tgz#16a705c5a0dc2f5e638ca96d8a8cd4e1c2b90985" + integrity sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ== + dependencies: + define-data-property "^1.1.4" + es-errors "^1.3.0" + functions-have-names "^1.2.3" + has-property-descriptors "^1.0.2" + +set-proto@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/set-proto/-/set-proto-1.0.0.tgz#0760dbcff30b2d7e801fd6e19983e56da337565e" + integrity sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw== + dependencies: + dunder-proto "^1.0.1" + es-errors "^1.3.0" + es-object-atoms "^1.0.0" + +sha.js@^2.4.9: + version "2.4.12" + resolved "https://registry.yarnpkg.com/sha.js/-/sha.js-2.4.12.tgz#eb8b568bf383dfd1867a32c3f2b74eb52bdbf23f" + integrity sha512-8LzC5+bvI45BjpfXU8V5fdU2mfeKiQe1D1gIMn7XUlF3OTUrpdJpPPH4EMAnF0DsHHdSZqCdSss5qCmJKuiO3w== + dependencies: + inherits "^2.0.4" + safe-buffer "^5.2.1" + to-buffer "^1.2.0" + +side-channel-list@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/side-channel-list/-/side-channel-list-1.0.0.tgz#10cb5984263115d3b7a0e336591e290a830af8ad" + integrity sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA== + dependencies: + es-errors "^1.3.0" + object-inspect "^1.13.3" + +side-channel-map@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/side-channel-map/-/side-channel-map-1.0.1.tgz#d6bb6b37902c6fef5174e5f533fab4c732a26f42" + integrity sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA== + dependencies: + call-bound "^1.0.2" + es-errors "^1.3.0" + get-intrinsic "^1.2.5" + object-inspect "^1.13.3" + +side-channel-weakmap@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz#11dda19d5368e40ce9ec2bdc1fb0ecbc0790ecea" + integrity sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A== + dependencies: + call-bound "^1.0.2" + es-errors "^1.3.0" + get-intrinsic "^1.2.5" + object-inspect "^1.13.3" + side-channel-map "^1.0.1" + +side-channel@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.1.0.tgz#c3fcff9c4da932784873335ec9765fa94ff66bc9" + integrity sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw== + dependencies: + es-errors "^1.3.0" + object-inspect "^1.13.3" + side-channel-list "^1.0.0" + side-channel-map "^1.0.1" + side-channel-weakmap "^1.0.2" + +simple-concat@^1.0.0: + version "1.0.1" + resolved "https://registry.yarnpkg.com/simple-concat/-/simple-concat-1.0.1.tgz#f46976082ba35c2263f1c8ab5edfe26c41c9552f" + integrity sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q== + +simple-get@^4.0.1: + version "4.0.1" + resolved "https://registry.yarnpkg.com/simple-get/-/simple-get-4.0.1.tgz#4a39db549287c979d352112fa03fd99fd6bc3543" + integrity sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA== + dependencies: + decompress-response "^6.0.0" + once "^1.3.1" + simple-concat "^1.0.0" + +smartwrap@^2.0.2: + version "2.0.2" + resolved "https://registry.yarnpkg.com/smartwrap/-/smartwrap-2.0.2.tgz#7e25d3dd58b51c6ca4aba3a9e391650ea62698a4" + integrity sha512-vCsKNQxb7PnCNd2wY1WClWifAc2lwqsG8OaswpJkVJsvMGcnEntdTCDajZCkk93Ay1U3t/9puJmb525Rg5MZBA== + dependencies: + array.prototype.flat "^1.2.3" + breakword "^1.0.5" + grapheme-splitter "^1.0.4" + strip-ansi "^6.0.0" + wcwidth "^1.0.1" + yargs "^15.1.0" + +stop-iteration-iterator@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz#f481ff70a548f6124d0312c3aa14cbfa7aa542ad" + integrity sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ== + dependencies: + es-errors "^1.3.0" + internal-slot "^1.1.0" + +stream-to-buffer@^0.1.0: + version "0.1.0" + resolved "https://registry.yarnpkg.com/stream-to-buffer/-/stream-to-buffer-0.1.0.tgz#26799d903ab2025c9bd550ac47171b00f8dd80a9" + integrity sha512-Da4WoKaZyu3nf+bIdIifh7IPkFjARBnBK+pYqn0EUJqksjV9afojjaCCHUemH30Jmu7T2qcKvlZm2ykN38uzaw== + dependencies: + stream-to "~0.2.0" + +stream-to@~0.2.0: + version "0.2.2" + resolved "https://registry.yarnpkg.com/stream-to/-/stream-to-0.2.2.tgz#84306098d85fdb990b9fa300b1b3ccf55e8ef01d" + integrity sha512-Kg1BSDTwgGiVMtTCJNlo7kk/xzL33ZuZveEBRt6rXw+f1WLK/8kmz2NVCT/Qnv0JkV85JOHcLhD82mnXsR3kPw== + +stream-transform@^2.1.3: + version "2.1.3" + resolved "https://registry.yarnpkg.com/stream-transform/-/stream-transform-2.1.3.tgz#a1c3ecd72ddbf500aa8d342b0b9df38f5aa598e3" + integrity sha512-9GHUiM5hMiCi6Y03jD2ARC1ettBXkQBoQAe7nJsPknnI0ow10aXjTnew8QtYQmLjzn974BnmWEAJgCY6ZP1DeQ== + dependencies: + mixme "^0.5.1" + +streamifier@^0.1.1: + version "0.1.1" + resolved "https://registry.yarnpkg.com/streamifier/-/streamifier-0.1.1.tgz#97e98d8fa4d105d62a2691d1dc07e820db8dfc4f" + integrity sha512-zDgl+muIlWzXNsXeyUfOk9dChMjlpkq0DRsxujtYPgyJ676yQ8jEm6zzaaWHFDg5BNcLuif0eD2MTyJdZqXpdg== + +string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.3: + version "4.2.3" + resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010" + integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g== + dependencies: + emoji-regex "^8.0.0" + is-fullwidth-code-point "^3.0.0" + strip-ansi "^6.0.1" + +string.prototype.trim@^1.2.10: + version "1.2.10" + resolved "https://registry.yarnpkg.com/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz#40b2dd5ee94c959b4dcfb1d65ce72e90da480c81" + integrity sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA== + dependencies: + call-bind "^1.0.8" + call-bound "^1.0.2" + define-data-property "^1.1.4" + define-properties "^1.2.1" + es-abstract "^1.23.5" + es-object-atoms "^1.0.0" + has-property-descriptors "^1.0.2" + +string.prototype.trimend@^1.0.9: + version "1.0.9" + resolved "https://registry.yarnpkg.com/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz#62e2731272cd285041b36596054e9f66569b6942" + integrity sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ== + dependencies: + call-bind "^1.0.8" + call-bound "^1.0.2" + define-properties "^1.2.1" + es-object-atoms "^1.0.0" + +string.prototype.trimstart@^1.0.8: + version "1.0.8" + resolved "https://registry.yarnpkg.com/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz#7ee834dda8c7c17eff3118472bb35bfedaa34dde" + integrity sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg== + dependencies: + call-bind "^1.0.7" + define-properties "^1.2.1" + es-object-atoms "^1.0.0" + +string_decoder@^1.1.1: + version "1.3.0" + resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.3.0.tgz#42f114594a46cf1a8e30b0a84f56c78c3edac21e" + integrity sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA== + dependencies: + safe-buffer "~5.2.0" + +strip-ansi@^6.0.0, strip-ansi@^6.0.1: + version "6.0.1" + resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9" + integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A== + dependencies: + ansi-regex "^5.0.1" + +supports-color@^7.1.0: + version "7.2.0" + resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-7.2.0.tgz#1b7dcdcb32b8138801b3e478ba6a51caa89648da" + integrity sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw== + dependencies: + has-flag "^4.0.0" + +tcp-ping@^0.1.1: + version "0.1.1" + resolved "https://registry.yarnpkg.com/tcp-ping/-/tcp-ping-0.1.1.tgz#02dd7f42b5bf7d7cb78d5b7aacefa155fd8f7c0c" + integrity sha512-7Ed10Ds0hYnF+O1lfiZ2iSZ1bCAj+96Madctebmq7Y1ALPWlBY4YI8C6pCL+UTlshFY5YogixKLpgDP/4BlHrw== + +to-buffer@^1.2.0: + version "1.2.1" + resolved "https://registry.yarnpkg.com/to-buffer/-/to-buffer-1.2.1.tgz#2ce650cdb262e9112a18e65dc29dcb513c8155e0" + integrity sha512-tB82LpAIWjhLYbqjx3X4zEeHN6M8CiuOEy2JY8SEQVdYRe3CCHOFaqrBW1doLDrfpWhplcW7BL+bO3/6S3pcDQ== + dependencies: + isarray "^2.0.5" + safe-buffer "^5.2.1" + typed-array-buffer "^1.0.3" + +tr46@~0.0.3: + version "0.0.3" + resolved "https://registry.yarnpkg.com/tr46/-/tr46-0.0.3.tgz#8184fd347dac9cdc185992f3a6622e14b9d9ab6a" + integrity sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw== + +ts-node@^10.9.0: + version "10.9.2" + resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-10.9.2.tgz#70f021c9e185bccdca820e26dc413805c101c71f" + integrity sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ== + dependencies: + "@cspotcode/source-map-support" "^0.8.0" + "@tsconfig/node10" "^1.0.7" + "@tsconfig/node12" "^1.0.7" + "@tsconfig/node14" "^1.0.0" + "@tsconfig/node16" "^1.0.2" + acorn "^8.4.1" + acorn-walk "^8.1.1" + arg "^4.1.0" + create-require "^1.1.0" + diff "^4.0.1" + make-error "^1.1.1" + v8-compile-cache-lib "^3.0.1" + yn "3.1.1" + +tty-table@4.2: + version "4.2.3" + resolved "https://registry.yarnpkg.com/tty-table/-/tty-table-4.2.3.tgz#e33eb4007a0a9c976c97c37fa13ba66329a5c515" + integrity sha512-Fs15mu0vGzCrj8fmJNP7Ynxt5J7praPXqFN0leZeZBXJwkMxv9cb2D454k1ltrtUSJbZ4yH4e0CynsHLxmUfFA== + dependencies: + chalk "^4.1.2" + csv "^5.5.3" + kleur "^4.1.5" + smartwrap "^2.0.2" + strip-ansi "^6.0.1" + wcwidth "^1.0.1" + yargs "^17.7.1" + +typed-array-buffer@^1.0.3: + version "1.0.3" + resolved "https://registry.yarnpkg.com/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz#a72395450a4869ec033fd549371b47af3a2ee536" + integrity sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw== + dependencies: + call-bound "^1.0.3" + es-errors "^1.3.0" + is-typed-array "^1.1.14" + +typed-array-byte-length@^1.0.3: + version "1.0.3" + resolved "https://registry.yarnpkg.com/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz#8407a04f7d78684f3d252aa1a143d2b77b4160ce" + integrity sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg== + dependencies: + call-bind "^1.0.8" + for-each "^0.3.3" + gopd "^1.2.0" + has-proto "^1.2.0" + is-typed-array "^1.1.14" + +typed-array-byte-offset@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz#ae3698b8ec91a8ab945016108aef00d5bff12355" + integrity sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ== + dependencies: + available-typed-arrays "^1.0.7" + call-bind "^1.0.8" + for-each "^0.3.3" + gopd "^1.2.0" + has-proto "^1.2.0" + is-typed-array "^1.1.15" + reflect.getprototypeof "^1.0.9" + +typed-array-length@^1.0.7: + version "1.0.7" + resolved "https://registry.yarnpkg.com/typed-array-length/-/typed-array-length-1.0.7.tgz#ee4deff984b64be1e118b0de8c9c877d5ce73d3d" + integrity sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg== + dependencies: + call-bind "^1.0.7" + for-each "^0.3.3" + gopd "^1.0.1" + is-typed-array "^1.1.13" + possible-typed-array-names "^1.0.0" + reflect.getprototypeof "^1.0.6" + +typescript@^5.0.0: + version "5.8.3" + resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.8.3.tgz#92f8a3e5e3cf497356f4178c34cd65a7f5e8440e" + integrity sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ== + +unbox-primitive@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/unbox-primitive/-/unbox-primitive-1.1.0.tgz#8d9d2c9edeea8460c7f35033a88867944934d1e2" + integrity sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw== + dependencies: + call-bound "^1.0.3" + has-bigints "^1.0.2" + has-symbols "^1.1.0" + which-boxed-primitive "^1.1.1" + +undici-types@~6.21.0: + version "6.21.0" + resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-6.21.0.tgz#691d00af3909be93a7faa13be61b3a5b50ef12cb" + integrity sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ== + +universalify@^0.1.0: + version "0.1.2" + resolved "https://registry.yarnpkg.com/universalify/-/universalify-0.1.2.tgz#b646f69be3942dabcecc9d6639c80dc105efaa66" + integrity sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg== + +util-deprecate@^1.0.1: + version "1.0.2" + resolved "https://registry.yarnpkg.com/util-deprecate/-/util-deprecate-1.0.2.tgz#450d4dc9fa70de732762fbd2d4a28981419a0ccf" + integrity sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw== + +v8-compile-cache-lib@^3.0.1: + version "3.0.1" + resolved "https://registry.yarnpkg.com/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz#6336e8d71965cb3d35a1bbb7868445a7c05264bf" + integrity sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg== + +wcwidth@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/wcwidth/-/wcwidth-1.0.1.tgz#f0b0dcf915bc5ff1528afadb2c0e17b532da2fe8" + integrity sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg== + dependencies: + defaults "^1.0.3" + +webidl-conversions@^3.0.0: + version "3.0.1" + resolved "https://registry.yarnpkg.com/webidl-conversions/-/webidl-conversions-3.0.1.tgz#24534275e2a7bc6be7bc86611cc16ae0a5654871" + integrity sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ== + +whatwg-url@^5.0.0: + version "5.0.0" + resolved "https://registry.yarnpkg.com/whatwg-url/-/whatwg-url-5.0.0.tgz#966454e8765462e37644d3626f6742ce8b70965d" + integrity sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw== + dependencies: + tr46 "~0.0.3" + webidl-conversions "^3.0.0" + +which-boxed-primitive@^1.1.0, which-boxed-primitive@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz#d76ec27df7fa165f18d5808374a5fe23c29b176e" + integrity sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA== + dependencies: + is-bigint "^1.1.0" + is-boolean-object "^1.2.1" + is-number-object "^1.1.1" + is-string "^1.1.1" + is-symbol "^1.1.1" + +which-builtin-type@^1.2.1: + version "1.2.1" + resolved "https://registry.yarnpkg.com/which-builtin-type/-/which-builtin-type-1.2.1.tgz#89183da1b4907ab089a6b02029cc5d8d6574270e" + integrity sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q== + dependencies: + call-bound "^1.0.2" + function.prototype.name "^1.1.6" + has-tostringtag "^1.0.2" + is-async-function "^2.0.0" + is-date-object "^1.1.0" + is-finalizationregistry "^1.1.0" + is-generator-function "^1.0.10" + is-regex "^1.2.1" + is-weakref "^1.0.2" + isarray "^2.0.5" + which-boxed-primitive "^1.1.0" + which-collection "^1.0.2" + which-typed-array "^1.1.16" + +which-collection@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/which-collection/-/which-collection-1.0.2.tgz#627ef76243920a107e7ce8e96191debe4b16c2a0" + integrity sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw== + dependencies: + is-map "^2.0.3" + is-set "^2.0.3" + is-weakmap "^2.0.2" + is-weakset "^2.0.3" + +which-module@^2.0.0: + version "2.0.1" + resolved "https://registry.yarnpkg.com/which-module/-/which-module-2.0.1.tgz#776b1fe35d90aebe99e8ac15eb24093389a4a409" + integrity sha512-iBdZ57RDvnOR9AGBhML2vFZf7h8vmBjhoaZqODJBFWHVtKkDmKuHai3cx5PgVMrX5YDNp27AofYbAwctSS+vhQ== + +which-typed-array@^1.1.16, which-typed-array@^1.1.19: + version "1.1.19" + resolved "https://registry.yarnpkg.com/which-typed-array/-/which-typed-array-1.1.19.tgz#df03842e870b6b88e117524a4b364b6fc689f956" + integrity sha512-rEvr90Bck4WZt9HHFC4DJMsjvu7x+r6bImz0/BrbWb7A2djJ8hnZMrWnHo9F8ssv0OMErasDhftrfROTyqSDrw== + dependencies: + available-typed-arrays "^1.0.7" + call-bind "^1.0.8" + call-bound "^1.0.4" + for-each "^0.3.5" + get-proto "^1.0.1" + gopd "^1.2.0" + has-tostringtag "^1.0.2" + +wrap-ansi@^6.2.0: + version "6.2.0" + resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-6.2.0.tgz#e9393ba07102e6c91a3b221478f0257cd2856e53" + integrity sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA== + dependencies: + ansi-styles "^4.0.0" + string-width "^4.1.0" + strip-ansi "^6.0.0" + +wrap-ansi@^7.0.0: + version "7.0.0" + resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43" + integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q== + dependencies: + ansi-styles "^4.0.0" + string-width "^4.1.0" + strip-ansi "^6.0.0" + +wrappy@1: + version "1.0.2" + resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f" + integrity sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ== + +xmlbuilder@^15.1.1: + version "15.1.1" + resolved "https://registry.yarnpkg.com/xmlbuilder/-/xmlbuilder-15.1.1.tgz#9dcdce49eea66d8d10b42cae94a79c3c8d0c2ec5" + integrity sha512-yMqGBqtXyeN1e3TGYvgNgDVZ3j84W4cwkOXQswghol6APgZWaff9lnbvN7MHYJOiXsvGPXtjTYJEiC9J2wv9Eg== + +y18n@^4.0.0: + version "4.0.3" + resolved "https://registry.yarnpkg.com/y18n/-/y18n-4.0.3.tgz#b5f259c82cd6e336921efd7bfd8bf560de9eeedf" + integrity sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ== + +y18n@^5.0.5: + version "5.0.8" + resolved "https://registry.yarnpkg.com/y18n/-/y18n-5.0.8.tgz#7f4934d0f7ca8c56f95314939ddcd2dd91ce1d55" + integrity sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA== + +yargs-parser@^18.1.2: + version "18.1.3" + resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-18.1.3.tgz#be68c4975c6b2abf469236b0c870362fab09a7b0" + integrity sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ== + dependencies: + camelcase "^5.0.0" + decamelize "^1.2.0" + +yargs-parser@^21.1.1: + version "21.1.1" + resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35" + integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw== + +yargs@^15.1.0: + version "15.4.1" + resolved "https://registry.yarnpkg.com/yargs/-/yargs-15.4.1.tgz#0d87a16de01aee9d8bec2bfbf74f67851730f4f8" + integrity sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A== + dependencies: + cliui "^6.0.0" + decamelize "^1.2.0" + find-up "^4.1.0" + get-caller-file "^2.0.1" + require-directory "^2.1.1" + require-main-filename "^2.0.0" + set-blocking "^2.0.0" + string-width "^4.2.0" + which-module "^2.0.0" + y18n "^4.0.0" + yargs-parser "^18.1.2" + +yargs@^17.7.1: + version "17.7.2" + resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.7.2.tgz#991df39aca675a192b816e1e0363f9d75d2aa269" + integrity sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w== + dependencies: + cliui "^8.0.1" + escalade "^3.1.1" + get-caller-file "^2.0.5" + require-directory "^2.1.1" + string-width "^4.2.3" + y18n "^5.0.5" + yargs-parser "^21.1.1" + +yauzl@^2.8.0: + version "2.10.0" + resolved "https://registry.yarnpkg.com/yauzl/-/yauzl-2.10.0.tgz#c7eb17c93e112cb1086fa6d8e51fb0667b79a5f9" + integrity sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g== + dependencies: + buffer-crc32 "~0.2.3" + fd-slicer "~1.1.0" + +yauzl@^3.2.0: + version "3.2.0" + resolved "https://registry.yarnpkg.com/yauzl/-/yauzl-3.2.0.tgz#7b6cb548f09a48a6177ea0be8ece48deb7da45c0" + integrity sha512-Ow9nuGZE+qp1u4JIPvg+uCiUr7xGQWdff7JQSk5VGYTAZMDe2q8lxJ10ygv10qmSj031Ty/6FNJpLO4o1Sgc+w== + dependencies: + buffer-crc32 "~0.2.3" + pend "~1.2.0" + +yazl@3.3.1: + version "3.3.1" + resolved "https://registry.yarnpkg.com/yazl/-/yazl-3.3.1.tgz#a69abad02d80739d3b1a7ffcca8434422477432c" + integrity sha512-BbETDVWG+VcMUle37k5Fqp//7SDOK2/1+T7X8TD96M3D9G8jK5VLUdQVdVjGi8im7FGkazX7kk5hkU8X4L5Bng== + dependencies: + buffer-crc32 "^1.0.0" + +yn@3.1.1: + version "3.1.1" + resolved "https://registry.yarnpkg.com/yn/-/yn-3.1.1.tgz#1e87401a09d767c1d5eab26a6e4c185182d2eb50" + integrity sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q== diff --git a/package.json b/package.json index 9fbc653..6e1d5bd 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "react-native-update-cli", - "version": "1.46.2", + "version": "1.46.4", "description": "command line tool for react-native-update (remote updates for react native)", "main": "index.js", "bin": { @@ -8,11 +8,7 @@ "cresc": "lib/index.js", "pushy-modular": "lib/modular-index.js" }, - "files": [ - "lib", - "src", - "cli.json" - ], + "files": ["lib", "src", "cli.json"], "scripts": { "build": "swc src -d lib --strip-leading-paths", "prepublishOnly": "npm run build && chmod +x lib/index.js", @@ -22,13 +18,7 @@ "type": "git", "url": "git+https://github.com/reactnativecn/react-native-pushy-cli.git" }, - "keywords": [ - "react-native", - "ios", - "android", - "harmony", - "update" - ], + "keywords": ["react-native", "ios", "android", "harmony", "update"], "author": "reactnativecn", "license": "BSD-3-Clause", "bugs": { @@ -82,8 +72,5 @@ "@types/yazl": "^2.4.6", "typescript": "^5.8.3" }, - "trustedDependencies": [ - "@biomejs/biome", - "@swc/core" - ] + "trustedDependencies": ["@biomejs/biome", "@swc/core"] } diff --git a/src/api.ts b/src/api.ts index f96cfe6..f9cebaa 100644 --- a/src/api.ts +++ b/src/api.ts @@ -1,18 +1,18 @@ -import fetch from 'node-fetch'; import fs from 'fs'; -import util from 'util'; import path from 'path'; +import util from 'util'; +import filesizeParser from 'filesize-parser'; +import FormData from 'form-data'; +import fetch from 'node-fetch'; import ProgressBar from 'progress'; -import packageJson from '../package.json'; import tcpp from 'tcp-ping'; -import filesizeParser from 'filesize-parser'; +import packageJson from '../package.json'; +import type { Package, Session } from './types'; import { - pricingPageUrl, credentialFile, defaultEndpoint, + pricingPageUrl, } from './utils/constants'; -import type { Session, Package } from 'types'; -import FormData from 'form-data'; import { t } from './utils/i18n'; const tcpPing = util.promisify(tcpp.ping); diff --git a/src/app.ts b/src/app.ts index 0dcbe1e..bd00c85 100644 --- a/src/app.ts +++ b/src/app.ts @@ -1,8 +1,8 @@ -import { question } from './utils'; import fs from 'fs'; import Table from 'tty-table'; +import { question } from './utils'; -import { post, get, doDelete } from './api'; +import { doDelete, get, post } from './api'; import type { Platform } from './types'; import { t } from './utils/i18n'; diff --git a/src/bundle.ts b/src/bundle.ts index d939eea..d529536 100644 --- a/src/bundle.ts +++ b/src/bundle.ts @@ -1,24 +1,24 @@ +import { spawn, spawnSync } from 'child_process'; import path from 'path'; -import { translateOptions } from './utils'; +import { satisfies } from 'compare-versions'; import * as fs from 'fs-extra'; -import { ZipFile as YazlZipFile } from 'yazl'; import { type Entry, - open as openZipFile, type ZipFile as YauzlZipFile, + open as openZipFile, } from 'yauzl'; -import { question, checkPlugins } from './utils'; +import { ZipFile as YazlZipFile } from 'yazl'; import { getPlatform } from './app'; -import { spawn, spawnSync } from 'child_process'; -import { satisfies } from 'compare-versions'; +import { translateOptions } from './utils'; +import { checkPlugins, question } from './utils'; const g2js = require('gradle-to-js/lib/parser'); import os from 'os'; const properties = require('properties'); +import { addGitIgnore } from './utils/add-gitignore'; +import { checkLockFiles } from './utils/check-lockfile'; +import { tempDir } from './utils/constants'; import { depVersions } from './utils/dep-versions'; import { t } from './utils/i18n'; -import { tempDir } from './utils/constants'; -import { checkLockFiles } from './utils/check-lockfile'; -import { addGitIgnore } from './utils/add-gitignore'; import { versionCommands } from './versions'; type Diff = (oldSource?: Buffer, newSource?: Buffer) => Buffer; @@ -289,14 +289,14 @@ async function copyHarmonyBundle(outputFolder: string) { await fs.remove(path.join(harmonyRawPath, 'update.json')); await fs.copy('update.json', path.join(harmonyRawPath, 'update.json')); await fs.ensureDir(outputFolder); - + const files = await fs.readdir(harmonyRawPath); for (const file of files) { if (file !== 'update.json' && file !== 'meta.json') { const sourcePath = path.join(harmonyRawPath, file); const destPath = path.join(outputFolder, file); const stat = await fs.stat(sourcePath); - + if (stat.isFile()) { await fs.copy(sourcePath, destPath); } else if (stat.isDirectory()) { @@ -534,7 +534,7 @@ async function pack(dir: string, output: string) { zipfile.outputStream.on('error', (err: any) => reject(err)); zipfile.outputStream.pipe(fs.createWriteStream(output)).on('close', () => { - resolve(); + resolve(void 0); }); zipfile.end(); }); @@ -548,17 +548,14 @@ export function readEntry( const buffers: Buffer[] = []; return new Promise((resolve, reject) => { zipFile.openReadStream(entry, (err, stream) => { - stream.pipe({ - write(chunk: Buffer) { - buffers.push(chunk); - }, - end() { - resolve(Buffer.concat(buffers)); - }, - prependListener() {}, - on() {}, - once() {}, - emit() {}, + stream.on('data', (chunk: Buffer) => { + buffers.push(chunk); + }); + stream.on('end', () => { + resolve(Buffer.concat(buffers)); + }); + stream.on('error', (err) => { + reject(err); }); }); }); @@ -608,7 +605,7 @@ async function diffFromPPK(origin: string, next: string, output: string) { throw err; }); zipfile.outputStream.pipe(fs.createWriteStream(output)).on('close', () => { - resolve(); + resolve(void 0); }); }); @@ -685,7 +682,7 @@ async function diffFromPPK(origin: string, next: string, output: string) { zipfile.addReadStream(readStream, entry.fileName); readStream.on('end', () => { //console.log('add finished'); - resolve(); + resolve(void 0); }); }); }); @@ -758,7 +755,7 @@ async function diffFromPackage( throw err; }); zipfile.outputStream.pipe(fs.createWriteStream(output)).on('close', () => { - resolve(); + resolve(void 0); }); }); @@ -806,7 +803,7 @@ async function diffFromPackage( zipfile.addReadStream(readStream, entry.fileName); readStream.on('end', () => { //console.log('add finished'); - resolve(); + resolve(void 0); }); }); }); @@ -858,7 +855,7 @@ export async function enumZipEntries( if (err) return rej(err); const writeStream = fs.createWriteStream(tempZipPath); readStream.pipe(writeStream); - writeStream.on('finish', res); + writeStream.on('finish', () => res(void 0)); writeStream.on('error', rej); }); }); @@ -976,11 +973,11 @@ export const bundleCommands = { outputFolder: intermediaDir, platform, sourcemapOutput: sourcemap || sourcemapPlugin ? sourcemapOutput : '', - disableHermes, + disableHermes: !!disableHermes, cli: { - taro, - expo, - rncli, + taro: !!taro, + expo: !!expo, + rncli: !!rncli, }, }); diff --git a/src/exports.ts b/src/exports.ts index 2fb5c3a..d0d9301 100644 --- a/src/exports.ts +++ b/src/exports.ts @@ -15,7 +15,7 @@ export type { Platform, Session, Version, - Package + Package, } from './types'; export { builtinModules } from './modules'; @@ -27,4 +27,4 @@ export { packageModule } from './modules/package-module'; export { loadSession, getSession } from './api'; export { getPlatform, getSelectedApp } from './app'; -export { question, saveToLocal } from './utils'; \ No newline at end of file +export { question, saveToLocal } from './utils'; diff --git a/src/index.ts b/src/index.ts index d8a1e4c..4028f2f 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1,13 +1,13 @@ #!/usr/bin/env node import { loadSession } from './api'; +import { appCommands } from './app'; +import { bundleCommands } from './bundle'; +import { packageCommands } from './package'; +import { userCommands } from './user'; import { printVersionCommand } from './utils'; import { t } from './utils/i18n'; -import { bundleCommands } from './bundle'; import { versionCommands } from './versions'; -import { userCommands } from './user'; -import { appCommands } from './app'; -import { packageCommands } from './package'; function printUsage() { console.log( diff --git a/src/modular-index.ts b/src/modular-index.ts index 03b2184..edd6626 100644 --- a/src/modular-index.ts +++ b/src/modular-index.ts @@ -1,11 +1,11 @@ #!/usr/bin/env node import { loadSession } from './api'; -import { printVersionCommand } from './utils'; -import { t } from './utils/i18n'; import { moduleManager } from './module-manager'; import { builtinModules } from './modules'; import type { CommandContext } from './types'; +import { printVersionCommand } from './utils'; +import { t } from './utils/i18n'; function registerBuiltinModules() { for (const module of builtinModules) { @@ -21,27 +21,33 @@ function printUsage() { console.log('React Native Update CLI - Modular Version'); console.log(''); console.log('Available commands:'); - + const commands = moduleManager.getRegisteredCommands(); for (const command of commands) { - console.log(` ${command.name}: ${command.description || 'No description'}`); + console.log( + ` ${command.name}: ${command.description || 'No description'}`, + ); } - + console.log(''); console.log('Available workflows:'); const workflows = moduleManager.getRegisteredWorkflows(); for (const workflow of workflows) { - console.log(` ${workflow.name}: ${workflow.description || 'No description'}`); + console.log( + ` ${workflow.name}: ${workflow.description || 'No description'}`, + ); } - + console.log(''); - console.log('Visit `https://github.com/reactnativecn/react-native-update` for document.'); + console.log( + 'Visit `https://github.com/reactnativecn/react-native-update` for document.', + ); process.exit(1); } async function run() { await printVersionCommand(); - + if (process.argv.indexOf('-v') >= 0 || process.argv[2] === 'version') { process.exit(); } @@ -95,8 +101,14 @@ async function run() { export { moduleManager }; export { CLIProviderImpl } from './provider'; -export type { CLIProvider, CLIModule, CommandDefinition, CustomWorkflow, WorkflowStep } from './types'; +export type { + CLIProvider, + CLIModule, + CommandDefinition, + CustomWorkflow, + WorkflowStep, +} from './types'; if (require.main === module) { run(); -} \ No newline at end of file +} diff --git a/src/module-manager.ts b/src/module-manager.ts index 8c0e050..1bb260a 100644 --- a/src/module-manager.ts +++ b/src/module-manager.ts @@ -1,5 +1,10 @@ -import type { CLIModule, CLIProvider, CommandDefinition, CustomWorkflow } from './types'; import { CLIProviderImpl } from './provider'; +import type { + CLIModule, + CLIProvider, + CommandDefinition, + CustomWorkflow, +} from './types'; export class ModuleManager { private modules: Map = new Map(); @@ -34,7 +39,9 @@ export class ModuleManager { module.init(this.provider); } - console.log(`Module '${module.name}' (v${module.version}) registered successfully`); + console.log( + `Module '${module.name}' (v${module.version}) registered successfully`, + ); } unregisterModule(moduleName: string): void { @@ -63,7 +70,6 @@ export class ModuleManager { console.log(`Module '${moduleName}' unregistered successfully`); } - registerCommand(command: CommandDefinition): void { if (this.commands.has(command.name)) { throw new Error(`Command '${command.name}' is already registered`); @@ -71,7 +77,6 @@ export class ModuleManager { this.commands.set(command.name, command); } - registerWorkflow(workflow: CustomWorkflow): void { if (this.workflows.has(workflow.name)) { throw new Error(`Workflow '${workflow.name}' is already registered`); @@ -80,22 +85,18 @@ export class ModuleManager { this.provider.registerWorkflow(workflow); } - getRegisteredCommands(): CommandDefinition[] { return Array.from(this.commands.values()); } - getRegisteredWorkflows(): CustomWorkflow[] { return Array.from(this.workflows.values()); } - getRegisteredModules(): CLIModule[] { return Array.from(this.modules.values()); } - async executeCommand(commandName: string, context: any): Promise { const command = this.commands.get(commandName); if (!command) { @@ -105,33 +106,44 @@ export class ModuleManager { return await command.handler(context); } - async executeWorkflow(workflowName: string, context: any): Promise { return await this.provider.executeWorkflow(workflowName, context); } - getProvider(): CLIProvider { return this.provider; } + listCommands(): any[] { + return Array.from(this.commands.values()); + } + + listWorkflows(): CustomWorkflow[] { + return Array.from(this.workflows.values()); + } listAll(): void { console.log('\n=== Registered Commands ==='); for (const command of this.commands.values()) { - console.log(` ${command.name}: ${command.description || 'No description'}`); + console.log( + ` ${command.name}: ${command.description || 'No description'}`, + ); } console.log('\n=== Registered Workflows ==='); for (const workflow of this.workflows.values()) { - console.log(` ${workflow.name}: ${workflow.description || 'No description'}`); + console.log( + ` ${workflow.name}: ${workflow.description || 'No description'}`, + ); } console.log('\n=== Registered Modules ==='); for (const module of this.modules.values()) { - console.log(` ${module.name} (v${module.version}): ${module.commands?.length || 0} commands, ${module.workflows?.length || 0} workflows`); + console.log( + ` ${module.name} (v${module.version}): ${module.commands?.length || 0} commands, ${module.workflows?.length || 0} workflows`, + ); } } } -export const moduleManager = new ModuleManager(); \ No newline at end of file +export const moduleManager = new ModuleManager(); diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts index 2753970..f6f166c 100644 --- a/src/modules/app-module.ts +++ b/src/modules/app-module.ts @@ -1,10 +1,10 @@ -import type { CLIModule, CommandContext, CommandResult } from '../types'; import { appCommands } from '../app'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; export const appModule: CLIModule = { name: 'app', version: '1.0.0', - + commands: [ { name: 'createApp', @@ -12,24 +12,30 @@ export const appModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { const { name, downloadUrl, platform } = context.options; - console.log('Creating app with options:', { name, downloadUrl, platform }); - await appCommands.createApp({ options: { name, downloadUrl, platform } }); + console.log('Creating app with options:', { + name, + downloadUrl, + platform, + }); + await appCommands.createApp({ + options: { name, downloadUrl, platform }, + }); return { success: true, - data: { message: 'App created successfully' } + data: { message: 'App created successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Create app failed' + error: error instanceof Error ? error.message : 'Create app failed', }; } }, options: { name: { hasValue: true, description: 'App name' }, platform: { hasValue: true, description: 'Target platform' }, - downloadUrl: { hasValue: true, description: 'Download URL' } - } + downloadUrl: { hasValue: true, description: 'Download URL' }, + }, }, { name: 'apps', @@ -37,66 +43,84 @@ export const appModule: CLIModule = { handler: async (context: CommandContext): Promise => { try { console.log('Listing apps for platform:', context.options.platform); - await appCommands.apps({ options: { platform: context.options.platform } }); + await appCommands.apps({ + options: { platform: context.options.platform }, + }); return { success: true, - data: { message: 'Apps listed successfully' } + data: { message: 'Apps listed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'List apps failed' + error: error instanceof Error ? error.message : 'List apps failed', }; } }, options: { - platform: { hasValue: true, description: 'Target platform' } - } + platform: { hasValue: true, description: 'Target platform' }, + }, }, { name: 'selectApp', description: 'Select an app', handler: async (context: CommandContext): Promise => { try { - console.log('Selecting app with args:', context.args, 'options:', context.options); - await appCommands.selectApp({ args: context.args, options: { platform: context.options.platform } }); + console.log( + 'Selecting app with args:', + context.args, + 'options:', + context.options, + ); + await appCommands.selectApp({ + args: context.args, + options: { platform: context.options.platform }, + }); return { success: true, - data: { message: 'App selected successfully' } + data: { message: 'App selected successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Select app failed' + error: error instanceof Error ? error.message : 'Select app failed', }; } }, options: { - platform: { hasValue: true, description: 'Target platform' } - } + platform: { hasValue: true, description: 'Target platform' }, + }, }, { name: 'deleteApp', description: 'Delete an app', handler: async (context: CommandContext): Promise => { try { - console.log('Deleting app with args:', context.args, 'options:', context.options); - await appCommands.deleteApp({ args: context.args, options: { platform: context.options.platform } }); + console.log( + 'Deleting app with args:', + context.args, + 'options:', + context.options, + ); + await appCommands.deleteApp({ + args: context.args, + options: { platform: context.options.platform }, + }); return { success: true, - data: { message: 'App deleted successfully' } + data: { message: 'App deleted successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Delete app failed' + error: error instanceof Error ? error.message : 'Delete app failed', }; } }, options: { - platform: { hasValue: true, description: 'Target platform' } - } - } + platform: { hasValue: true, description: 'Target platform' }, + }, + }, ], workflows: [ @@ -110,15 +134,15 @@ export const appModule: CLIModule = { execute: async (context: CommandContext) => { console.log('Creating app in workflow'); const { name, downloadUrl, platform } = context.options; - await appCommands.createApp({ - options: { - name: name || '', - downloadUrl: downloadUrl || '', - platform: platform || '' - } + await appCommands.createApp({ + options: { + name: name || '', + downloadUrl: downloadUrl || '', + platform: platform || '', + }, }); return { appCreated: true }; - } + }, }, { name: 'select', @@ -126,14 +150,14 @@ export const appModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { console.log('Selecting app in workflow'); const { platform } = context.options; - await appCommands.selectApp({ - args: [], - options: { platform: platform || '' } + await appCommands.selectApp({ + args: [], + options: { platform: platform || '' }, }); return { ...previousResult, appSelected: true }; - } - } - ] + }, + }, + ], }, { name: 'manage-apps', @@ -145,11 +169,11 @@ export const appModule: CLIModule = { execute: async (context: CommandContext) => { console.log('Listing all apps'); const { platform } = context.options; - await appCommands.apps({ - options: { platform: platform || '' } + await appCommands.apps({ + options: { platform: platform || '' }, }); return { appsListed: true }; - } + }, }, { name: 'select-target-app', @@ -157,14 +181,141 @@ export const appModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { console.log('Selecting target app'); const { platform } = context.options; - await appCommands.selectApp({ - args: [], - options: { platform: platform || '' } + await appCommands.selectApp({ + args: [], + options: { platform: platform || '' }, }); return { ...previousResult, targetAppSelected: true }; - } - } - ] - } - ] -}; \ No newline at end of file + }, + }, + ], + }, + { + name: 'multi-platform-app-management', + description: 'Multi-platform app unified management workflow', + steps: [ + { + name: 'scan-platforms', + description: 'Scan apps on all platforms', + execute: async (context: CommandContext) => { + console.log('🔍 Scanning apps on all platforms...'); + + const platforms = ['ios', 'android', 'harmony']; + const appsData = {}; + + for (const platform of platforms) { + console.log(` Scanning ${platform} platform...`); + + // Simulate getting app list + await new Promise((resolve) => setTimeout(resolve, 500)); + + const appCount = Math.floor(Math.random() * 5) + 1; + const apps = Array.from({ length: appCount }, (_, i) => ({ + id: `${platform}_app_${i + 1}`, + name: `App ${i + 1}`, + platform, + version: `1.${i}.0`, + status: Math.random() > 0.2 ? 'active' : 'inactive', + })); + + appsData[platform] = apps; + console.log(` ✅ Found ${appCount} apps`); + } + + console.log('✅ Platform scanning completed'); + + return { platforms, appsData, scanned: true }; + }, + }, + { + name: 'analyze-apps', + description: 'Analyze app status', + execute: async (context: CommandContext, previousResult: any) => { + console.log('📊 Analyzing app status...'); + + const { appsData } = previousResult; + const analysis = { + totalApps: 0, + activeApps: 0, + inactiveApps: 0, + platformDistribution: {}, + issues: [], + }; + + for (const [platform, apps] of Object.entries(appsData)) { + const platformApps = apps as any[]; + analysis.totalApps += platformApps.length; + analysis.platformDistribution[platform] = platformApps.length; + + for (const app of platformApps) { + if (app.status === 'active') { + analysis.activeApps++; + } else { + analysis.inactiveApps++; + analysis.issues.push( + `${platform}/${app.name}: App is inactive`, + ); + } + } + } + + console.log('📈 Analysis results:'); + console.log(` Total apps: ${analysis.totalApps}`); + console.log(` Active apps: ${analysis.activeApps}`); + console.log(` Inactive apps: ${analysis.inactiveApps}`); + + if (analysis.issues.length > 0) { + console.log('⚠️ Issues found:'); + analysis.issues.forEach((issue) => console.log(` - ${issue}`)); + } + + return { ...previousResult, analysis }; + }, + }, + { + name: 'optimize-apps', + description: 'Optimize app configuration', + execute: async (context: CommandContext, previousResult: any) => { + console.log('⚡ Optimizing app configuration...'); + + const { analysis } = previousResult; + const optimizations = []; + + if (analysis.inactiveApps > 0) { + console.log(' Handling inactive apps...'); + optimizations.push('Reactivate inactive apps'); + } + + if (analysis.totalApps > 10) { + console.log(' Many apps detected, suggest grouping...'); + optimizations.push('Create app groups'); + } + + // Simulate optimization process + for (const optimization of optimizations) { + console.log(` Executing: ${optimization}...`); + await new Promise((resolve) => setTimeout(resolve, 800)); + console.log(` ✅ ${optimization} completed`); + } + + console.log('✅ App optimization completed'); + + return { ...previousResult, optimizations, optimized: true }; + }, + }, + ], + options: { + includeInactive: { + hasValue: false, + default: true, + description: 'Include inactive apps', + }, + autoOptimize: { + hasValue: false, + default: true, + description: 'Auto optimize configuration', + }, + }, + }, + ], +}; diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 8e173e6..9cd5f21 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -1,5 +1,5 @@ -import type { CLIModule, CommandContext, CommandResult } from '../types'; import { bundleCommands } from '../bundle'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; export const bundleModule: CLIModule = { name: 'bundle', @@ -14,38 +14,73 @@ export const bundleModule: CLIModule = { await bundleCommands.bundle(context); return { success: true, - data: { message: 'Bundle created successfully' } + data: { message: 'Bundle created successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Bundle failed' + error: error instanceof Error ? error.message : 'Bundle failed', }; } }, options: { - dev: { hasValue: true, default: 'false', description: 'Development mode' }, + dev: { + hasValue: true, + default: 'false', + description: 'Development mode', + }, platform: { hasValue: true, description: 'Target platform' }, - bundleName: { hasValue: true, default: 'index.bundlejs', description: 'Bundle file name' }, - entryFile: { hasValue: true, default: 'index.js', description: 'Entry file' }, - intermediaDir: { hasValue: true, default: '${tempDir}/intermedia/${platform}', description: 'Intermediate directory' }, - output: { hasValue: true, default: '${tempDir}/output/${platform}.${time}.ppk', description: 'Output file path' }, + bundleName: { + hasValue: true, + default: 'index.bundlejs', + description: 'Bundle file name', + }, + entryFile: { + hasValue: true, + default: 'index.js', + description: 'Entry file', + }, + intermediaDir: { + hasValue: true, + default: '${tempDir}/intermedia/${platform}', + description: 'Intermediate directory', + }, + output: { + hasValue: true, + default: '${tempDir}/output/${platform}.${time}.ppk', + description: 'Output file path', + }, sourcemap: { default: false, description: 'Generate sourcemap' }, taro: { default: false, description: 'Use Taro CLI' }, expo: { default: false, description: 'Use Expo CLI' }, rncli: { default: false, description: 'Use React Native CLI' }, disableHermes: { default: false, description: 'Disable Hermes' }, name: { hasValue: true, description: 'Version name for publishing' }, - description: { hasValue: true, description: 'Version description for publishing' }, - metaInfo: { hasValue: true, description: 'Meta information for publishing' }, + description: { + hasValue: true, + description: 'Version description for publishing', + }, + metaInfo: { + hasValue: true, + description: 'Meta information for publishing', + }, packageId: { hasValue: true, description: 'Package ID' }, packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, + minPackageVersion: { + hasValue: true, + description: 'Minimum package version', + }, + maxPackageVersion: { + hasValue: true, + description: 'Maximum package version', + }, + packageVersionRange: { + hasValue: true, + description: 'Package version range', + }, rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' } - } + dryRun: { default: false, description: 'Dry run mode' }, + }, }, { name: 'diff', @@ -55,20 +90,21 @@ export const bundleModule: CLIModule = { await bundleCommands.diff(context); return { success: true, - data: { message: 'Diff generated successfully' } + data: { message: 'Diff generated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Diff generation failed' + error: + error instanceof Error ? error.message : 'Diff generation failed', }; } }, options: { origin: { hasValue: true, description: 'Original PPK file path' }, next: { hasValue: true, description: 'New PPK file path' }, - output: { hasValue: true, description: 'Output diff file path' } - } + output: { hasValue: true, description: 'Output diff file path' }, + }, }, { name: 'diffFromApk', @@ -78,20 +114,21 @@ export const bundleModule: CLIModule = { await bundleCommands.diffFromApk(context); return { success: true, - data: { message: 'Diff from APK generated successfully' } + data: { message: 'Diff from APK generated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Diff from APK failed' + error: + error instanceof Error ? error.message : 'Diff from APK failed', }; } }, options: { origin: { hasValue: true, description: 'Original APK file path' }, next: { hasValue: true, description: 'New APK file path' }, - output: { hasValue: true, description: 'Output diff file path' } - } + output: { hasValue: true, description: 'Output diff file path' }, + }, }, { name: 'diffFromApp', @@ -101,20 +138,21 @@ export const bundleModule: CLIModule = { await bundleCommands.diffFromApp(context); return { success: true, - data: { message: 'HDiff from APP generated successfully' } + data: { message: 'HDiff from APP generated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'HDiff from APP failed' + error: + error instanceof Error ? error.message : 'HDiff from APP failed', }; } }, options: { origin: { hasValue: true, description: 'Original APP file path' }, next: { hasValue: true, description: 'New APP file path' }, - output: { hasValue: true, description: 'Output hdiff file path' } - } + output: { hasValue: true, description: 'Output hdiff file path' }, + }, }, { name: 'diffFromIpa', @@ -124,22 +162,214 @@ export const bundleModule: CLIModule = { await bundleCommands.diffFromIpa(context); return { success: true, - data: { message: 'Diff from IPA generated successfully' } + data: { message: 'Diff from IPA generated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Diff from IPA failed' + error: + error instanceof Error ? error.message : 'Diff from IPA failed', }; } }, options: { origin: { hasValue: true, description: 'Original IPA file path' }, next: { hasValue: true, description: 'New IPA file path' }, - output: { hasValue: true, description: 'Output diff file path' } - } + output: { hasValue: true, description: 'Output diff file path' }, + }, }, ], - workflows: [] -}; \ No newline at end of file + workflows: [ + { + name: 'incremental-build', + description: 'Incremental build workflow - generate diff packages', + steps: [ + { + name: 'detect-base-version', + description: 'Detect base version', + execute: async (context: CommandContext) => { + console.log('🔍 Detecting base version...'); + + const { baseVersion, platform } = context.options; + + if (baseVersion) { + console.log(`✅ Using specified base version: ${baseVersion}`); + return { baseVersion, specified: true }; + } + + console.log('Auto detecting latest version...'); + await new Promise((resolve) => setTimeout(resolve, 800)); + + const autoDetectedVersion = `v${Math.floor(Math.random() * 3) + 1}.${Math.floor(Math.random() * 10)}.${Math.floor(Math.random() * 10)}`; + + console.log( + `✅ Auto detected base version: ${autoDetectedVersion}`, + ); + + return { baseVersion: autoDetectedVersion, specified: false }; + }, + }, + { + name: 'build-current-version', + description: 'Build current version', + execute: async (context: CommandContext, previousResult: any) => { + console.log('🏗️ Building current version...'); + + const { + platform, + dev = false, + sourcemap = false, + bundleName = 'index.bundlejs', + entryFile = 'index.js', + intermediaDir, + taro = false, + expo = false, + rncli = false, + disableHermes = false, + output, + } = context.options; + + console.log(`Building ${platform} platform...`); + console.log(` Entry file: ${entryFile}`); + console.log(` Bundle name: ${bundleName}`); + console.log(` Development mode: ${dev}`); + console.log(` Source maps: ${sourcemap}`); + + try { + const buildOptions: any = { + platform, + dev, + sourcemap, + bundleName, + entryFile, + taro, + expo, + rncli, + disableHermes, + intermediaDir: '${tempDir}/intermedia/${platform}', + output: '${tempDir}/output/${platform}.${time}.ppk', + }; + if (intermediaDir) { + buildOptions.intermediaDir = intermediaDir; + } + + await bundleCommands.bundle({ + args: [], + options: buildOptions, + }); + + const currentBuild = { + version: `v${Math.floor(Math.random() * 3) + 2}.0.0`, + platform, + bundlePath: `./build/current_${platform}.ppk`, + size: Math.floor(Math.random() * 15) + 10, + buildTime: Date.now(), + }; + + console.log( + `✅ Current version build completed: ${currentBuild.version}`, + ); + + return { ...previousResult, currentBuild }; + } catch (error) { + console.error('❌ Current version build failed:', error); + throw error; + } + }, + }, + ], + validate: (context: CommandContext) => { + if (!context.options.platform) { + console.error('❌ Incremental build requires platform specification'); + return false; + } + return true; + }, + options: { + platform: { + hasValue: true, + description: 'Target platform (required)', + }, + baseVersion: { + hasValue: true, + description: 'Base version (auto detect if not specified)', + }, + skipValidation: { + hasValue: false, + default: false, + description: 'Skip diff package validation', + }, + dev: { + hasValue: false, + default: false, + description: 'Development mode build', + }, + bundleName: { + hasValue: true, + default: 'index.bundlejs', + description: 'Bundle file name', + }, + entryFile: { + hasValue: true, + default: 'index.js', + description: 'Entry file', + }, + sourcemap: { + hasValue: false, + default: false, + description: 'Generate source maps', + }, + output: { + hasValue: true, + description: 'Custom output path for diff package', + }, + intermediaDir: { + hasValue: true, + description: 'Intermediate directory', + }, + taro: { + hasValue: false, + default: false, + description: 'Use Taro CLI', + }, + expo: { + hasValue: false, + default: false, + description: 'Use Expo CLI', + }, + rncli: { + hasValue: false, + default: false, + description: 'Use React Native CLI', + }, + disableHermes: { + hasValue: false, + default: false, + description: 'Disable Hermes', + }, + name: { + hasValue: true, + description: 'Version name for publishing', + }, + description: { + hasValue: true, + description: 'Version description for publishing', + }, + metaInfo: { + hasValue: true, + description: 'Meta information for publishing', + }, + rollout: { + hasValue: true, + description: 'Rollout percentage', + }, + dryRun: { + hasValue: false, + default: false, + description: 'Dry run mode', + }, + }, + }, + ], +}; diff --git a/src/modules/index.ts b/src/modules/index.ts index 1da317b..c88674f 100644 --- a/src/modules/index.ts +++ b/src/modules/index.ts @@ -1,8 +1,8 @@ -import { bundleModule } from './bundle-module'; -import { versionModule } from './version-module'; import { appModule } from './app-module'; -import { userModule } from './user-module'; +import { bundleModule } from './bundle-module'; import { packageModule } from './package-module'; +import { userModule } from './user-module'; +import { versionModule } from './version-module'; export { bundleModule } from './bundle-module'; export { versionModule } from './version-module'; @@ -15,5 +15,5 @@ export const builtinModules = [ versionModule, appModule, userModule, - packageModule -]; \ No newline at end of file + packageModule, +]; diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts index d4eaa11..d46a1c9 100644 --- a/src/modules/package-module.ts +++ b/src/modules/package-module.ts @@ -1,10 +1,10 @@ -import type { CLIModule, CommandContext, CommandResult } from '../types'; import { packageCommands } from '../package'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; export const packageModule: CLIModule = { name: 'package', version: '1.0.0', - + commands: [ { name: 'uploadIpa', @@ -15,15 +15,15 @@ export const packageModule: CLIModule = { await packageCommands.uploadIpa(context); return { success: true, - data: { message: 'IPA uploaded successfully' } + data: { message: 'IPA uploaded successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Upload IPA failed' + error: error instanceof Error ? error.message : 'Upload IPA failed', }; } - } + }, }, { name: 'uploadApk', @@ -34,15 +34,15 @@ export const packageModule: CLIModule = { await packageCommands.uploadApk(context); return { success: true, - data: { message: 'APK uploaded successfully' } + data: { message: 'APK uploaded successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Upload APK failed' + error: error instanceof Error ? error.message : 'Upload APK failed', }; } - } + }, }, { name: 'uploadApp', @@ -53,15 +53,15 @@ export const packageModule: CLIModule = { await packageCommands.uploadApp(context); return { success: true, - data: { message: 'APP uploaded successfully' } + data: { message: 'APP uploaded successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Upload APP failed' + error: error instanceof Error ? error.message : 'Upload APP failed', }; } - } + }, }, { name: 'parseApp', @@ -72,15 +72,15 @@ export const packageModule: CLIModule = { await packageCommands.parseApp(context); return { success: true, - data: { message: 'APP file parsed successfully' } + data: { message: 'APP file parsed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Parse APP failed' + error: error instanceof Error ? error.message : 'Parse APP failed', }; } - } + }, }, { name: 'parseIpa', @@ -91,15 +91,15 @@ export const packageModule: CLIModule = { await packageCommands.parseIpa(context); return { success: true, - data: { message: 'IPA file parsed successfully' } + data: { message: 'IPA file parsed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Parse IPA failed' + error: error instanceof Error ? error.message : 'Parse IPA failed', }; } - } + }, }, { name: 'parseApk', @@ -110,15 +110,15 @@ export const packageModule: CLIModule = { await packageCommands.parseApk(context); return { success: true, - data: { message: 'APK file parsed successfully' } + data: { message: 'APK file parsed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Parse APK failed' + error: error instanceof Error ? error.message : 'Parse APK failed', }; } - } + }, }, { name: 'packages', @@ -128,24 +128,30 @@ export const packageModule: CLIModule = { if (!context.options.platform) { throw new Error('Platform option is required'); } - console.log('Listing packages for platform:', context.options.platform); - await packageCommands.packages({ options: { platform: context.options.platform } }); + console.log( + 'Listing packages for platform:', + context.options.platform, + ); + await packageCommands.packages({ + options: { platform: context.options.platform }, + }); return { success: true, - data: { message: 'Packages listed successfully' } + data: { message: 'Packages listed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'List packages failed' + error: + error instanceof Error ? error.message : 'List packages failed', }; } }, options: { - platform: { hasValue: true, description: 'Target platform' } - } - } + platform: { hasValue: true, description: 'Target platform' }, + }, + }, ], - workflows: [] -}; \ No newline at end of file + workflows: [], +}; diff --git a/src/modules/user-module.ts b/src/modules/user-module.ts index 6ee872e..709283b 100644 --- a/src/modules/user-module.ts +++ b/src/modules/user-module.ts @@ -1,11 +1,11 @@ +import { getSession, loadSession } from '../api'; import type { CLIModule, CommandContext, CommandResult } from '../types'; import { userCommands } from '../user'; -import { getSession, loadSession } from '../api'; export const userModule: CLIModule = { name: 'user', version: '1.0.0', - + commands: [ { name: 'login', @@ -16,15 +16,15 @@ export const userModule: CLIModule = { await userCommands.login(context); return { success: true, - data: { message: 'Login successful' } + data: { message: 'Login successful' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Login failed' + error: error instanceof Error ? error.message : 'Login failed', }; } - } + }, }, { name: 'logout', @@ -35,15 +35,15 @@ export const userModule: CLIModule = { await userCommands.logout(context); return { success: true, - data: { message: 'Logout successful' } + data: { message: 'Logout successful' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Logout failed' + error: error instanceof Error ? error.message : 'Logout failed', }; } - } + }, }, { name: 'me', @@ -54,16 +54,17 @@ export const userModule: CLIModule = { await userCommands.me(); return { success: true, - data: { message: 'User information retrieved successfully' } + data: { message: 'User information retrieved successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Get user info failed' + error: + error instanceof Error ? error.message : 'Get user info failed', }; } - } - } + }, + }, ], workflows: [ @@ -71,8 +72,14 @@ export const userModule: CLIModule = { name: 'auth-check', description: 'Check authentication status and user information', options: { - autoLogin: { default: false, description: 'Automatically login if not authenticated' }, - showDetails: { default: true, description: 'Show detailed user information' } + autoLogin: { + default: false, + description: 'Automatically login if not authenticated', + }, + showDetails: { + default: true, + description: 'Show detailed user information', + }, }, steps: [ { @@ -80,36 +87,39 @@ export const userModule: CLIModule = { description: 'Load existing session from local storage', execute: async (context: CommandContext) => { console.log('Loading session from local storage...'); - + try { await loadSession(); const session = getSession(); - + if (session && session.token) { console.log('✓ Session found in local storage'); - return { - sessionLoaded: true, + return { + sessionLoaded: true, hasToken: true, - session + session, }; } else { console.log('✗ No valid session found in local storage'); - return { - sessionLoaded: true, + return { + sessionLoaded: true, hasToken: false, - session: null + session: null, }; } } catch (error) { - console.log('✗ Failed to load session:', error instanceof Error ? error.message : 'Unknown error'); - return { - sessionLoaded: false, + console.log( + '✗ Failed to load session:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { + sessionLoaded: false, hasToken: false, session: null, - error: error instanceof Error ? error.message : 'Unknown error' + error: error instanceof Error ? error.message : 'Unknown error', }; } - } + }, }, { name: 'validate-session', @@ -117,32 +127,36 @@ export const userModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { if (!previousResult.hasToken) { console.log('No token available, skipping validation'); - return { - ...previousResult, + return { + ...previousResult, validated: false, - reason: 'No token available' + reason: 'No token available', }; } - + console.log('Validating session with server...'); - + try { await userCommands.me(); console.log('✓ Session is valid'); - return { - ...previousResult, + return { + ...previousResult, validated: true, - reason: 'Session validated successfully' + reason: 'Session validated successfully', }; } catch (error) { - console.log('✗ Session validation failed:', error instanceof Error ? error.message : 'Unknown error'); - return { - ...previousResult, + console.log( + '✗ Session validation failed:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { + ...previousResult, validated: false, - reason: error instanceof Error ? error.message : 'Unknown error' + reason: + error instanceof Error ? error.message : 'Unknown error', }; } - } + }, }, { name: 'get-user-info', @@ -150,21 +164,21 @@ export const userModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { if (!previousResult.validated) { console.log('Session not valid, cannot get user info'); - return { - ...previousResult, + return { + ...previousResult, userInfo: null, - reason: 'Session not valid' + reason: 'Session not valid', }; } - + console.log('Getting user information...'); - + try { const { get } = await import('../api'); const userInfo = await get('/user/me'); - + console.log('✓ User information retrieved successfully'); - + if (context.options.showDetails !== false) { console.log('\n=== User Information ==='); for (const [key, value] of Object.entries(userInfo)) { @@ -174,21 +188,25 @@ export const userModule: CLIModule = { } console.log('========================\n'); } - - return { - ...previousResult, + + return { + ...previousResult, userInfo, - reason: 'User info retrieved successfully' + reason: 'User info retrieved successfully', }; } catch (error) { - console.log('✗ Failed to get user info:', error instanceof Error ? error.message : 'Unknown error'); - return { - ...previousResult, + console.log( + '✗ Failed to get user info:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { + ...previousResult, userInfo: null, - reason: error instanceof Error ? error.message : 'Unknown error' + reason: + error instanceof Error ? error.message : 'Unknown error', }; } - } + }, }, { name: 'handle-auth-failure', @@ -196,48 +214,52 @@ export const userModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { if (previousResult.validated) { console.log('✓ Authentication check completed successfully'); - return { - ...previousResult, + return { + ...previousResult, authCheckComplete: true, - status: 'authenticated' + status: 'authenticated', }; } - + console.log('✗ Authentication check failed'); - + if (context.options.autoLogin) { console.log('Attempting automatic login...'); try { await userCommands.login({ args: [] }); console.log('✓ Automatic login successful'); - return { - ...previousResult, + return { + ...previousResult, authCheckComplete: true, status: 'auto-logged-in', - autoLoginSuccess: true + autoLoginSuccess: true, }; } catch (error) { - console.log('✗ Automatic login failed:', error instanceof Error ? error.message : 'Unknown error'); - return { - ...previousResult, + console.log( + '✗ Automatic login failed:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { + ...previousResult, authCheckComplete: true, status: 'failed', autoLoginSuccess: false, - autoLoginError: error instanceof Error ? error.message : 'Unknown error' + autoLoginError: + error instanceof Error ? error.message : 'Unknown error', }; } } else { console.log('Please run login command to authenticate'); - return { - ...previousResult, + return { + ...previousResult, authCheckComplete: true, status: 'unauthenticated', - suggestion: 'Run login command to authenticate' + suggestion: 'Run login command to authenticate', }; } - } - } - ] + }, + }, + ], }, { name: 'login-flow', @@ -245,7 +267,10 @@ export const userModule: CLIModule = { options: { email: { hasValue: true, description: 'User email' }, password: { hasValue: true, description: 'User password' }, - validateAfterLogin: { default: true, description: 'Validate session after login' } + validateAfterLogin: { + default: true, + description: 'Validate session after login', + }, }, steps: [ { @@ -253,46 +278,51 @@ export const userModule: CLIModule = { description: 'Check if user is already logged in', execute: async (context: CommandContext) => { console.log('Checking existing session...'); - + try { await loadSession(); const session = getSession(); - + if (session && session.token) { try { await userCommands.me(); console.log('✓ User is already logged in'); - return { + return { alreadyLoggedIn: true, session: session, - status: 'authenticated' + status: 'authenticated', }; } catch (error) { - console.log('✗ Existing session is invalid, proceeding with login'); - return { + console.log( + '✗ Existing session is invalid, proceeding with login', + ); + return { alreadyLoggedIn: false, session: null, - status: 'session-expired' + status: 'session-expired', }; } } else { console.log('No existing session found'); - return { + return { alreadyLoggedIn: false, session: null, - status: 'no-session' + status: 'no-session', }; } } catch (error) { - console.log('Error checking existing session:', error instanceof Error ? error.message : 'Unknown error'); - return { + console.log( + 'Error checking existing session:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { alreadyLoggedIn: false, session: null, status: 'error', - error: error instanceof Error ? error.message : 'Unknown error' + error: error instanceof Error ? error.message : 'Unknown error', }; } - } + }, }, { name: 'perform-login', @@ -300,15 +330,15 @@ export const userModule: CLIModule = { execute: async (context: CommandContext, previousResult: any) => { if (previousResult.alreadyLoggedIn) { console.log('Skipping login - user already authenticated'); - return { - ...previousResult, + return { + ...previousResult, loginPerformed: false, - loginSuccess: true + loginSuccess: true, }; } - + console.log('Performing login...'); - + try { const loginArgs = []; if (context.options.email) { @@ -317,77 +347,88 @@ export const userModule: CLIModule = { if (context.options.password) { loginArgs.push(context.options.password); } - + await userCommands.login({ args: loginArgs }); console.log('✓ Login successful'); - - return { - ...previousResult, + + return { + ...previousResult, loginPerformed: true, - loginSuccess: true + loginSuccess: true, }; } catch (error) { - console.log('✗ Login failed:', error instanceof Error ? error.message : 'Unknown error'); - return { - ...previousResult, + console.log( + '✗ Login failed:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { + ...previousResult, loginPerformed: true, loginSuccess: false, - loginError: error instanceof Error ? error.message : 'Unknown error' + loginError: + error instanceof Error ? error.message : 'Unknown error', }; } - } + }, }, { name: 'validate-login', description: 'Validate login by getting user info', execute: async (context: CommandContext, previousResult: any) => { - if (!previousResult.loginSuccess && !previousResult.alreadyLoggedIn) { + if ( + !previousResult.loginSuccess && + !previousResult.alreadyLoggedIn + ) { console.log('Login failed, skipping validation'); - return { - ...previousResult, + return { + ...previousResult, validationPerformed: false, - validationSuccess: false + validationSuccess: false, }; } - + if (context.options.validateAfterLogin === false) { console.log('Skipping validation as requested'); - return { - ...previousResult, + return { + ...previousResult, validationPerformed: false, - validationSuccess: true + validationSuccess: true, }; } - + console.log('Validating login by getting user information...'); - + try { const userInfo = await userCommands.me(); console.log('✓ Login validation successful'); - - return { - ...previousResult, + + return { + ...previousResult, validationPerformed: true, validationSuccess: true, - userInfo + userInfo, }; } catch (error) { - console.log('✗ Login validation failed:', error instanceof Error ? error.message : 'Unknown error'); - return { - ...previousResult, + console.log( + '✗ Login validation failed:', + error instanceof Error ? error.message : 'Unknown error', + ); + return { + ...previousResult, validationPerformed: true, validationSuccess: false, - validationError: error instanceof Error ? error.message : 'Unknown error' + validationError: + error instanceof Error ? error.message : 'Unknown error', }; } - } + }, }, { name: 'login-summary', description: 'Provide login flow summary', execute: async (context: CommandContext, previousResult: any) => { console.log('\n=== Login Flow Summary ==='); - + if (previousResult.alreadyLoggedIn) { console.log('Status: Already logged in'); console.log('Session: Valid'); @@ -400,19 +441,25 @@ export const userModule: CLIModule = { } } else { console.log('Status: Login failed'); - console.log('Error:', previousResult.loginError || 'Unknown error'); + console.log( + 'Error:', + previousResult.loginError || 'Unknown error', + ); } - + console.log('==========================\n'); - - return { - ...previousResult, + + return { + ...previousResult, flowComplete: true, - finalStatus: previousResult.alreadyLoggedIn || previousResult.loginSuccess ? 'success' : 'failed' + finalStatus: + previousResult.alreadyLoggedIn || previousResult.loginSuccess + ? 'success' + : 'failed', }; - } - } - ] - } - ] -}; \ No newline at end of file + }, + }, + ], + }, + ], +}; diff --git a/src/modules/version-module.ts b/src/modules/version-module.ts index 0c7794c..ce0a3a9 100644 --- a/src/modules/version-module.ts +++ b/src/modules/version-module.ts @@ -1,12 +1,9 @@ -import type { CLIModule, CommandDefinition, CustomWorkflow, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext, CommandResult } from '../types'; import { versionCommands } from '../versions'; -import { bundleCommands } from '../bundle'; -import { getPlatform, getSelectedApp } from '../app'; export const versionModule: CLIModule = { name: 'version', version: '1.0.0', - commands: [ { name: 'publish', @@ -16,12 +13,12 @@ export const versionModule: CLIModule = { await versionCommands.publish(context); return { success: true, - data: { message: 'Version published successfully' } + data: { message: 'Version published successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Publish failed' + error: error instanceof Error ? error.message : 'Publish failed', }; } }, @@ -31,12 +28,21 @@ export const versionModule: CLIModule = { metaInfo: { hasValue: true, description: 'Meta information' }, packageId: { hasValue: true, description: 'Package ID' }, packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, + minPackageVersion: { + hasValue: true, + description: 'Minimum package version', + }, + maxPackageVersion: { + hasValue: true, + description: 'Maximum package version', + }, + packageVersionRange: { + hasValue: true, + description: 'Package version range', + }, rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' } - } + dryRun: { default: false, description: 'Dry run mode' }, + }, }, { name: 'versions', @@ -46,18 +52,19 @@ export const versionModule: CLIModule = { await versionCommands.versions(context); return { success: true, - data: { message: 'Versions listed successfully' } + data: { message: 'Versions listed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'List versions failed' + error: + error instanceof Error ? error.message : 'List versions failed', }; } }, options: { - platform: { hasValue: true, description: 'Target platform' } - } + platform: { hasValue: true, description: 'Target platform' }, + }, }, { name: 'update', @@ -67,12 +74,13 @@ export const versionModule: CLIModule = { await versionCommands.update(context); return { success: true, - data: { message: 'Version updated successfully' } + data: { message: 'Version updated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Update version failed' + error: + error instanceof Error ? error.message : 'Update version failed', }; } }, @@ -81,12 +89,21 @@ export const versionModule: CLIModule = { versionId: { hasValue: true, description: 'Version ID' }, packageId: { hasValue: true, description: 'Package ID' }, packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { hasValue: true, description: 'Minimum package version' }, - maxPackageVersion: { hasValue: true, description: 'Maximum package version' }, - packageVersionRange: { hasValue: true, description: 'Package version range' }, + minPackageVersion: { + hasValue: true, + description: 'Minimum package version', + }, + maxPackageVersion: { + hasValue: true, + description: 'Maximum package version', + }, + packageVersionRange: { + hasValue: true, + description: 'Package version range', + }, rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' } - } + dryRun: { default: false, description: 'Dry run mode' }, + }, }, { name: 'updateVersionInfo', @@ -96,12 +113,15 @@ export const versionModule: CLIModule = { await versionCommands.updateVersionInfo(context); return { success: true, - data: { message: 'Version info updated successfully' } + data: { message: 'Version info updated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Update version info failed' + error: + error instanceof Error + ? error.message + : 'Update version info failed', }; } }, @@ -110,10 +130,9 @@ export const versionModule: CLIModule = { versionId: { hasValue: true, description: 'Version ID' }, name: { hasValue: true, description: 'Version name' }, description: { hasValue: true, description: 'Version description' }, - metaInfo: { hasValue: true, description: 'Meta information' } - } - } + metaInfo: { hasValue: true, description: 'Meta information' }, + }, + }, ], - - workflows: [] -}; \ No newline at end of file + workflows: [], +}; diff --git a/src/package.ts b/src/package.ts index d9a2ba0..9fd5151 100644 --- a/src/package.ts +++ b/src/package.ts @@ -4,11 +4,11 @@ import { t } from './utils/i18n'; import { getPlatform, getSelectedApp } from './app'; -import { getApkInfo, getIpaInfo, getAppInfo } from './utils'; import Table from 'tty-table'; +import type { Platform } from './types'; +import { getApkInfo, getAppInfo, getIpaInfo } from './utils'; import { depVersions } from './utils/dep-versions'; import { getCommitInfo } from './utils/git'; -import type { Platform } from 'types'; export async function listPackage(appId: string) { const allPkgs = await getAllPackages(appId); @@ -22,7 +22,11 @@ export async function listPackage(appId: string) { const { version } = pkg; let versionInfo = ''; if (version) { - versionInfo = t('boundTo', { name: version.name, id: version.id }); + const versionObj = version as any; + versionInfo = t('boundTo', { + name: versionObj.name || version, + id: versionObj.id || version + }); } let output = pkg.name; if (pkg.status === 'paused') { @@ -45,7 +49,7 @@ export async function choosePackage(appId: string) { while (true) { const id = await question(t('enterNativePackageId')); - const app = list.find((v) => v.id === Number(id)); + const app = list.find((v) => v.id.toString() === id); if (app) { return app; } @@ -58,12 +62,13 @@ export const packageCommands = { if (!fn || !fn.endsWith('.ipa')) { throw new Error(t('usageUploadIpa')); } + const ipaInfo = await getIpaInfo(fn); const { versionName, buildTime, - appId: appIdInPkg, - appKey: appKeyInPkg, - } = await getIpaInfo(fn); + } = ipaInfo; + const appIdInPkg = (ipaInfo as any).appId; + const appKeyInPkg = (ipaInfo as any).appKey; const { appId, appKey } = await getSelectedApp('ios'); if (appIdInPkg && appIdInPkg != appId) { @@ -84,19 +89,22 @@ export const packageCommands = { commit: await getCommitInfo(), }); saveToLocal(fn, `${appId}/package/${id}.ipa`); - console.log(t('ipaUploadSuccess', { id, version: versionName, buildTime })); + console.log( + t('ipaUploadSuccess', { id, version: versionName, buildTime }), + ); }, uploadApk: async ({ args }: { args: string[] }) => { const fn = args[0]; if (!fn || !fn.endsWith('.apk')) { throw new Error(t('usageUploadApk')); } + const apkInfo = await getApkInfo(fn); const { versionName, buildTime, - appId: appIdInPkg, - appKey: appKeyInPkg, - } = await getApkInfo(fn); + } = apkInfo; + const appIdInPkg = (apkInfo as any).appId; + const appKeyInPkg = (apkInfo as any).appKey; const { appId, appKey } = await getSelectedApp('android'); if (appIdInPkg && appIdInPkg != appId) { @@ -117,19 +125,22 @@ export const packageCommands = { commit: await getCommitInfo(), }); saveToLocal(fn, `${appId}/package/${id}.apk`); - console.log(t('apkUploadSuccess', { id, version: versionName, buildTime })); + console.log( + t('apkUploadSuccess', { id, version: versionName, buildTime }), + ); }, uploadApp: async ({ args }: { args: string[] }) => { const fn = args[0]; if (!fn || !fn.endsWith('.app')) { throw new Error(t('usageUploadApp')); } + const appInfo = await getAppInfo(fn); const { versionName, buildTime, - appId: appIdInPkg, - appKey: appKeyInPkg, - } = await getAppInfo(fn); + } = appInfo; + const appIdInPkg = (appInfo as any).appId; + const appKeyInPkg = (appInfo as any).appKey; const { appId, appKey } = await getSelectedApp('harmony'); if (appIdInPkg && appIdInPkg != appId) { @@ -150,7 +161,9 @@ export const packageCommands = { commit: await getCommitInfo(), }); saveToLocal(fn, `${appId}/package/${id}.app`); - console.log(t('appUploadSuccess', { id, version: versionName, buildTime })); + console.log( + t('appUploadSuccess', { id, version: versionName, buildTime }), + ); }, parseApp: async ({ args }: { args: string[] }) => { const fn = args[0]; diff --git a/src/provider.ts b/src/provider.ts index 1d8fb1c..e0dc70d 100644 --- a/src/provider.ts +++ b/src/provider.ts @@ -1,16 +1,16 @@ -import { loadSession, getSession } from './api'; +import { getSession, loadSession } from './api'; import { getPlatform, getSelectedApp } from './app'; -import type { - CLIProvider, - CommandContext, - CommandResult, - BundleOptions, - PublishOptions, - UploadOptions, +import type { + BundleOptions, + CLIProvider, + CommandContext, + CommandResult, CustomWorkflow, Platform, + PublishOptions, Session, - Version + UploadOptions, + Version, } from './types'; export class CLIProviderImpl implements CLIProvider { @@ -25,8 +25,7 @@ export class CLIProviderImpl implements CLIProvider { try { await loadSession(); this.session = getSession(); - } catch (error) { - } + } catch (error) {} } async bundle(options: BundleOptions): Promise { @@ -44,20 +43,23 @@ export class CLIProviderImpl implements CLIProvider { expo: options.expo || false, rncli: options.rncli || false, disableHermes: options.disableHermes || false, - } + }, }; const { bundleCommands } = await import('./bundle'); await bundleCommands.bundle(context); - + return { success: true, - data: { message: 'Bundle created successfully' } + data: { message: 'Bundle created successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error during bundling' + error: + error instanceof Error + ? error.message + : 'Unknown error during bundling', }; } } @@ -77,20 +79,23 @@ export class CLIProviderImpl implements CLIProvider { packageVersionRange: options.packageVersionRange, rollout: options.rollout, dryRun: options.dryRun || false, - } + }, }; const { versionCommands } = await import('./versions'); await versionCommands.publish(context); - + return { success: true, - data: { message: 'Version published successfully' } + data: { message: 'Version published successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error during publishing' + error: + error instanceof Error + ? error.message + : 'Unknown error during publishing', }; } } @@ -99,17 +104,17 @@ export class CLIProviderImpl implements CLIProvider { try { const platform = await this.getPlatform(options.platform); const { appId } = await this.getSelectedApp(platform); - + const filePath = options.filePath; const fileType = filePath.split('.').pop()?.toLowerCase(); - + const context: CommandContext = { args: [filePath], - options: { platform, appId } + options: { platform, appId }, }; const { packageCommands } = await import('./package'); - + switch (fileType) { case 'ipa': await packageCommands.uploadIpa(context); @@ -123,20 +128,25 @@ export class CLIProviderImpl implements CLIProvider { default: throw new Error(`Unsupported file type: ${fileType}`); } - + return { success: true, - data: { message: 'File uploaded successfully' } + data: { message: 'File uploaded successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error during upload' + error: + error instanceof Error + ? error.message + : 'Unknown error during upload', }; } } - async getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }> { + async getSelectedApp( + platform?: Platform, + ): Promise<{ appId: string; platform: Platform }> { const resolvedPlatform = await this.getPlatform(platform); return getSelectedApp(resolvedPlatform); } @@ -146,15 +156,16 @@ export class CLIProviderImpl implements CLIProvider { const resolvedPlatform = await this.getPlatform(platform); const { appCommands } = await import('./app'); await appCommands.apps({ options: { platform: resolvedPlatform } }); - + return { success: true, - data: { message: 'Apps listed successfully' } + data: { message: 'Apps listed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error listing apps' + error: + error instanceof Error ? error.message : 'Unknown error listing apps', }; } } @@ -162,70 +173,80 @@ export class CLIProviderImpl implements CLIProvider { async createApp(name: string, platform: Platform): Promise { try { const { appCommands } = await import('./app'); - await appCommands.createApp({ - options: { - name, + await appCommands.createApp({ + options: { + name, platform, - downloadUrl: '' - } + downloadUrl: '', + }, }); - + return { success: true, - data: { message: 'App created successfully' } + data: { message: 'App created successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error creating app' + error: + error instanceof Error ? error.message : 'Unknown error creating app', }; } } - async listVersions(appId: string): Promise { try { const context: CommandContext = { args: [], - options: { appId } + options: { appId }, }; const { versionCommands } = await import('./versions'); await versionCommands.versions(context); - + return { success: true, - data: { message: 'Versions listed successfully' } + data: { message: 'Versions listed successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error listing versions' + error: + error instanceof Error + ? error.message + : 'Unknown error listing versions', }; } } - async updateVersion(appId: string, versionId: string, updates: Partial): Promise { + async updateVersion( + appId: string, + versionId: string, + updates: Partial, + ): Promise { try { const context: CommandContext = { args: [versionId], - options: { + options: { appId, - ...updates - } + ...updates, + }, }; const { versionCommands } = await import('./versions'); await versionCommands.update(context); - + return { success: true, - data: { message: 'Version updated successfully' } + data: { message: 'Version updated successfully' }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : 'Unknown error updating version' + error: + error instanceof Error + ? error.message + : 'Unknown error updating version', }; } } @@ -243,17 +264,19 @@ export class CLIProviderImpl implements CLIProvider { return this.session; } - registerWorkflow(workflow: CustomWorkflow): void { this.workflows.set(workflow.name, workflow); } - async executeWorkflow(workflowName: string, context: CommandContext): Promise { + async executeWorkflow( + workflowName: string, + context: CommandContext, + ): Promise { const workflow = this.workflows.get(workflowName); if (!workflow) { return { success: false, - error: `Workflow '${workflowName}' not found` + error: `Workflow '${workflowName}' not found`, }; } @@ -264,19 +287,25 @@ export class CLIProviderImpl implements CLIProvider { console.log(`Skipping step '${step.name}' due to condition`); continue; } - + console.log(`Executing step '${step.name}'`); previousResult = await step.execute(context, previousResult); } - + return { success: true, - data: { message: `Workflow '${workflowName}' completed successfully`, result: previousResult } + data: { + message: `Workflow '${workflowName}' completed successfully`, + result: previousResult, + }, }; } catch (error) { return { success: false, - error: error instanceof Error ? error.message : `Workflow '${workflowName}' failed` + error: + error instanceof Error + ? error.message + : `Workflow '${workflowName}' failed`, }; } } @@ -284,4 +313,29 @@ export class CLIProviderImpl implements CLIProvider { getRegisteredWorkflows(): string[] { return Array.from(this.workflows.keys()); } -} \ No newline at end of file + + async listPackages(appId?: string): Promise { + try { + const context: CommandContext = { + args: [], + options: appId ? { appId } : {}, + }; + + const { listPackage } = await import('./package'); + const result = await listPackage(appId || ''); + + return { + success: true, + data: result, + }; + } catch (error) { + return { + success: false, + error: + error instanceof Error + ? error.message + : 'Unknown error listing packages', + }; + } + } +} diff --git a/src/types.ts b/src/types.ts index 833d638..909b4fa 100644 --- a/src/types.ts +++ b/src/types.ts @@ -12,6 +12,12 @@ export type Platform = 'ios' | 'android' | 'harmony'; export interface Package { id: string; name: string; + version?: string; + status?: string; + appId?: string; + appKey?: string; + versionName?: any; + buildTime?: any; } export interface Version { @@ -39,11 +45,14 @@ export interface CommandDefinition { name: string; description?: string; handler: (context: CommandContext) => Promise; - options?: Record; + options?: Record< + string, + { + hasValue?: boolean; + default?: any; + description?: string; + } + >; } export interface BundleOptions { @@ -90,30 +99,42 @@ export interface CustomWorkflow { description?: string; steps: WorkflowStep[]; validate?: (context: CommandContext) => boolean; - options?: Record; + options?: Record< + string, + { + hasValue?: boolean; + default?: any; + description?: string; + } + >; } export interface CLIProvider { bundle: (options: BundleOptions) => Promise; publish: (options: PublishOptions) => Promise; upload: (options: UploadOptions) => Promise; - + createApp: (name: string, platform: Platform) => Promise; listApps: (platform?: Platform) => Promise; - getSelectedApp: (platform?: Platform) => Promise<{ appId: string; platform: Platform }>; - + getSelectedApp: ( + platform?: Platform, + ) => Promise<{ appId: string; platform: Platform }>; + listVersions: (appId: string) => Promise; - updateVersion: (appId: string, versionId: string, updates: Partial) => Promise; - + updateVersion: ( + appId: string, + versionId: string, + updates: Partial, + ) => Promise; + getPlatform: (platform?: Platform) => Promise; loadSession: () => Promise; - + registerWorkflow: (workflow: CustomWorkflow) => void; - executeWorkflow: (workflowName: string, context: CommandContext) => Promise; + executeWorkflow: ( + workflowName: string, + context: CommandContext, + ) => Promise; } export interface CLIModule { diff --git a/src/user.ts b/src/user.ts index 828e036..6fe2b0d 100644 --- a/src/user.ts +++ b/src/user.ts @@ -1,8 +1,8 @@ -import { question } from './utils'; -import { post, get, replaceSession, saveSession, closeSession } from './api'; import crypto from 'crypto'; +import type { CommandContext } from 'types'; +import { closeSession, get, post, replaceSession, saveSession } from './api'; +import { question } from './utils'; import { t } from './utils/i18n'; -import { CommandContext } from 'types'; function md5(str: string) { return crypto.createHash('md5').update(str).digest('hex'); diff --git a/src/utils/app-info-parser/apk.js b/src/utils/app-info-parser/apk.js index c2cc25a..fda468e 100644 --- a/src/utils/app-info-parser/apk.js +++ b/src/utils/app-info-parser/apk.js @@ -1,64 +1,74 @@ -const Zip = require('./zip') -const { mapInfoResource, findApkIconPath, getBase64FromBuffer } = require('./utils') -const ManifestName = /^androidmanifest\.xml$/ -const ResourceName = /^resources\.arsc$/ +const Zip = require('./zip'); +const { + mapInfoResource, + findApkIconPath, + getBase64FromBuffer, +} = require('./utils'); +const ManifestName = /^androidmanifest\.xml$/; +const ResourceName = /^resources\.arsc$/; -const ManifestXmlParser = require('./xml-parser/manifest') -const ResourceFinder = require('./resource-finder') +const ManifestXmlParser = require('./xml-parser/manifest'); +const ResourceFinder = require('./resource-finder'); class ApkParser extends Zip { /** * parser for parsing .apk file * @param {String | File | Blob} file // file's path in Node, instance of File or Blob in Browser */ - constructor (file) { - super(file) + constructor(file) { + super(file); if (!(this instanceof ApkParser)) { - return new ApkParser(file) + return new ApkParser(file); } } - parse () { + parse() { return new Promise((resolve, reject) => { - this.getEntries([ManifestName, ResourceName]).then(buffers => { - if (!buffers[ManifestName]) { - throw new Error('AndroidManifest.xml can\'t be found.') - } - let apkInfo = this._parseManifest(buffers[ManifestName]) - let resourceMap - if (!buffers[ResourceName]) { - resolve(apkInfo) - } else { - // parse resourceMap - resourceMap = this._parseResourceMap(buffers[ResourceName]) - // update apkInfo with resourceMap - apkInfo = mapInfoResource(apkInfo, resourceMap) - - // find icon path and parse icon - const iconPath = findApkIconPath(apkInfo) - if (iconPath) { - this.getEntry(iconPath).then(iconBuffer => { - apkInfo.icon = iconBuffer ? getBase64FromBuffer(iconBuffer) : null - resolve(apkInfo) - }).catch(e => { - apkInfo.icon = null - resolve(apkInfo) - console.warn('[Warning] failed to parse icon: ', e) - }) + this.getEntries([ManifestName, ResourceName]) + .then((buffers) => { + if (!buffers[ManifestName]) { + throw new Error("AndroidManifest.xml can't be found."); + } + let apkInfo = this._parseManifest(buffers[ManifestName]); + let resourceMap; + if (!buffers[ResourceName]) { + resolve(apkInfo); } else { - apkInfo.icon = null - resolve(apkInfo) + // parse resourceMap + resourceMap = this._parseResourceMap(buffers[ResourceName]); + // update apkInfo with resourceMap + apkInfo = mapInfoResource(apkInfo, resourceMap); + + // find icon path and parse icon + const iconPath = findApkIconPath(apkInfo); + if (iconPath) { + this.getEntry(iconPath) + .then((iconBuffer) => { + apkInfo.icon = iconBuffer + ? getBase64FromBuffer(iconBuffer) + : null; + resolve(apkInfo); + }) + .catch((e) => { + apkInfo.icon = null; + resolve(apkInfo); + console.warn('[Warning] failed to parse icon: ', e); + }); + } else { + apkInfo.icon = null; + resolve(apkInfo); + } } - } - }).catch(e => { - reject(e) - }) - }) + }) + .catch((e) => { + reject(e); + }); + }); } /** * Parse manifest * @param {Buffer} buffer // manifest file's buffer */ - _parseManifest (buffer) { + _parseManifest(buffer) { try { const parser = new ManifestXmlParser(buffer, { ignore: [ @@ -66,25 +76,25 @@ class ApkParser extends Zip { 'application.service', 'application.receiver', 'application.provider', - 'permission-group' - ] - }) - return parser.parse() + 'permission-group', + ], + }); + return parser.parse(); } catch (e) { - throw new Error('Parse AndroidManifest.xml error: ', e) + throw new Error('Parse AndroidManifest.xml error: ', e); } } /** * Parse resourceMap * @param {Buffer} buffer // resourceMap file's buffer */ - _parseResourceMap (buffer) { + _parseResourceMap(buffer) { try { - return new ResourceFinder().processResourceTable(buffer) + return new ResourceFinder().processResourceTable(buffer); } catch (e) { - throw new Error('Parser resources.arsc error: ' + e) + throw new Error('Parser resources.arsc error: ' + e); } } } -module.exports = ApkParser +module.exports = ApkParser; diff --git a/src/utils/app-info-parser/app.js b/src/utils/app-info-parser/app.js index 802763c..6740bdf 100644 --- a/src/utils/app-info-parser/app.js +++ b/src/utils/app-info-parser/app.js @@ -1,16 +1,16 @@ -const Zip = require('./zip') +const Zip = require('./zip'); class AppParser extends Zip { /** * parser for parsing .apk file * @param {String | File | Blob} file // file's path in Node, instance of File or Blob in Browser */ - constructor (file) { - super(file) + constructor(file) { + super(file); if (!(this instanceof AppParser)) { - return new AppParser(file) + return new AppParser(file); } } } -module.exports = AppParser +module.exports = AppParser; diff --git a/src/utils/app-info-parser/ipa.js b/src/utils/app-info-parser/ipa.js index f0f7305..3c2563e 100644 --- a/src/utils/app-info-parser/ipa.js +++ b/src/utils/app-info-parser/ipa.js @@ -1,92 +1,104 @@ -const parsePlist = require('plist').parse -const parseBplist = require('bplist-parser').parseBuffer -const cgbiToPng = require('cgbi-to-png') +const parsePlist = require('plist').parse; +const parseBplist = require('bplist-parser').parseBuffer; +const cgbiToPng = require('cgbi-to-png'); -const Zip = require('./zip') -const { findIpaIconPath, getBase64FromBuffer, isBrowser } = require('./utils') +const Zip = require('./zip'); +const { findIpaIconPath, getBase64FromBuffer, isBrowser } = require('./utils'); -const PlistName = new RegExp('payload/[^/]+?.app/info.plist$', 'i') -const ProvisionName = /payload\/.+?\.app\/embedded.mobileprovision/ +const PlistName = /payload\/[^\/]+?.app\/info.plist$/i; +const ProvisionName = /payload\/.+?\.app\/embedded.mobileprovision/; class IpaParser extends Zip { /** * parser for parsing .ipa file * @param {String | File | Blob} file // file's path in Node, instance of File or Blob in Browser */ - constructor (file) { - super(file) + constructor(file) { + super(file); if (!(this instanceof IpaParser)) { - return new IpaParser(file) + return new IpaParser(file); } } - parse () { + parse() { return new Promise((resolve, reject) => { - this.getEntries([PlistName, ProvisionName]).then(buffers => { - if (!buffers[PlistName]) { - throw new Error('Info.plist can\'t be found.') - } - const plistInfo = this._parsePlist(buffers[PlistName]) - // parse mobile provision - const provisionInfo = this._parseProvision(buffers[ProvisionName]) - plistInfo.mobileProvision = provisionInfo - - // find icon path and parse icon - const iconRegex = new RegExp(findIpaIconPath(plistInfo).toLowerCase()) - this.getEntry(iconRegex).then(iconBuffer => { - try { - // In general, the ipa file's icon has been specially processed, should be converted - plistInfo.icon = iconBuffer ? getBase64FromBuffer(cgbiToPng.revert(iconBuffer)) : null - } catch (err) { - if (isBrowser()) { - // Normal conversion in other cases - plistInfo.icon = iconBuffer ? getBase64FromBuffer(window.btoa(String.fromCharCode(...iconBuffer))) : null - } else { - plistInfo.icon = null - console.warn('[Warning] failed to parse icon: ', err) - } + this.getEntries([PlistName, ProvisionName]) + .then((buffers) => { + if (!buffers[PlistName]) { + throw new Error("Info.plist can't be found."); } - resolve(plistInfo) - }).catch(e => { - reject(e) + const plistInfo = this._parsePlist(buffers[PlistName]); + // parse mobile provision + const provisionInfo = this._parseProvision(buffers[ProvisionName]); + plistInfo.mobileProvision = provisionInfo; + + // find icon path and parse icon + const iconRegex = new RegExp( + findIpaIconPath(plistInfo).toLowerCase(), + ); + this.getEntry(iconRegex) + .then((iconBuffer) => { + try { + // In general, the ipa file's icon has been specially processed, should be converted + plistInfo.icon = iconBuffer + ? getBase64FromBuffer(cgbiToPng.revert(iconBuffer)) + : null; + } catch (err) { + if (isBrowser()) { + // Normal conversion in other cases + plistInfo.icon = iconBuffer + ? getBase64FromBuffer( + window.btoa(String.fromCharCode(...iconBuffer)), + ) + : null; + } else { + plistInfo.icon = null; + console.warn('[Warning] failed to parse icon: ', err); + } + } + resolve(plistInfo); + }) + .catch((e) => { + reject(e); + }); }) - }).catch(e => { - reject(e) - }) - }) + .catch((e) => { + reject(e); + }); + }); } /** * Parse plist * @param {Buffer} buffer // plist file's buffer */ - _parsePlist (buffer) { - let result - const bufferType = buffer[0] + _parsePlist(buffer) { + let result; + const bufferType = buffer[0]; if (bufferType === 60 || bufferType === '<' || bufferType === 239) { - result = parsePlist(buffer.toString()) + result = parsePlist(buffer.toString()); } else if (bufferType === 98) { - result = parseBplist(buffer)[0] + result = parseBplist(buffer)[0]; } else { - throw new Error('Unknown plist buffer type.') + throw new Error('Unknown plist buffer type.'); } - return result + return result; } /** * parse provision * @param {Buffer} buffer // provision file's buffer */ - _parseProvision (buffer) { - let info = {} + _parseProvision(buffer) { + let info = {}; if (buffer) { - let content = buffer.toString('utf-8') - const firstIndex = content.indexOf('') - content = content.slice(firstIndex, endIndex + 8) + let content = buffer.toString('utf-8'); + const firstIndex = content.indexOf(''); + content = content.slice(firstIndex, endIndex + 8); if (content) { - info = parsePlist(content) + info = parsePlist(content); } } - return info + return info; } } -module.exports = IpaParser +module.exports = IpaParser; diff --git a/src/utils/app-info-parser/resource-finder.js b/src/utils/app-info-parser/resource-finder.js index c3d4b9b..839b4a5 100644 --- a/src/utils/app-info-parser/resource-finder.js +++ b/src/utils/app-info-parser/resource-finder.js @@ -4,7 +4,7 @@ * Decode binary file `resources.arsc` from a .apk file to a JavaScript Object. */ -var ByteBuffer = require("bytebuffer"); +var ByteBuffer = require('bytebuffer'); var DEBUG = false; @@ -39,13 +39,13 @@ function ResourceFinder() { * @param len length * @returns {Buffer} */ -ResourceFinder.readBytes = function(bb, len) { +ResourceFinder.readBytes = (bb, len) => { var uint8Array = new Uint8Array(len); for (var i = 0; i < len; i++) { uint8Array[i] = bb.readUint8(); } - return ByteBuffer.wrap(uint8Array, "binary", true); + return ByteBuffer.wrap(uint8Array, 'binary', true); }; // @@ -54,8 +54,8 @@ ResourceFinder.readBytes = function(bb, len) { * @param {ByteBuffer} bb * @return {Map>} */ -ResourceFinder.prototype.processResourceTable = function(resourceBuffer) { - const bb = ByteBuffer.wrap(resourceBuffer, "binary", true); +ResourceFinder.prototype.processResourceTable = function (resourceBuffer) { + const bb = ByteBuffer.wrap(resourceBuffer, 'binary', true); // Resource table structure var type = bb.readShort(), @@ -65,10 +65,10 @@ ResourceFinder.prototype.processResourceTable = function(resourceBuffer) { buffer, bb2; if (type != RES_TABLE_TYPE) { - throw new Error("No RES_TABLE_TYPE found!"); + throw new Error('No RES_TABLE_TYPE found!'); } if (size != bb.limit) { - throw new Error("The buffer size not matches to the resource table size."); + throw new Error('The buffer size not matches to the resource table size.'); } bb.offset = headerSize; @@ -90,14 +90,14 @@ ResourceFinder.prototype.processResourceTable = function(resourceBuffer) { if (realStringPoolCount == 0) { // Only the first string pool is processed. if (DEBUG) { - console.log("Processing the string pool ..."); + console.log('Processing the string pool ...'); } buffer = new ByteBuffer(s); bb.offset = pos; bb.prependTo(buffer); - bb2 = ByteBuffer.wrap(buffer, "binary", true); + bb2 = ByteBuffer.wrap(buffer, 'binary', true); bb2.LE(); this.valueStringPool = this.processStringPool(bb2); @@ -106,30 +106,30 @@ ResourceFinder.prototype.processResourceTable = function(resourceBuffer) { } else if (t == RES_TABLE_PACKAGE_TYPE) { // Process the package if (DEBUG) { - console.log("Processing the package " + realPackageCount + " ..."); + console.log('Processing the package ' + realPackageCount + ' ...'); } buffer = new ByteBuffer(s); bb.offset = pos; bb.prependTo(buffer); - bb2 = ByteBuffer.wrap(buffer, "binary", true); + bb2 = ByteBuffer.wrap(buffer, 'binary', true); bb2.LE(); this.processPackage(bb2); realPackageCount++; } else { - throw new Error("Unsupported type"); + throw new Error('Unsupported type'); } bb.offset = pos + s; if (!bb.remaining()) break; } if (realStringPoolCount != 1) { - throw new Error("More than 1 string pool found!"); + throw new Error('More than 1 string pool found!'); } if (realPackageCount != packageCount) { - throw new Error("Real package count not equals the declared count."); + throw new Error('Real package count not equals the declared count.'); } return this.responseMap; @@ -139,7 +139,7 @@ ResourceFinder.prototype.processResourceTable = function(resourceBuffer) { * * @param {ByteBuffer} bb */ -ResourceFinder.prototype.processPackage = function(bb) { +ResourceFinder.prototype.processPackage = function (bb) { // Package structure var type = bb.readShort(), headerSize = bb.readShort(), @@ -159,12 +159,12 @@ ResourceFinder.prototype.processPackage = function(bb) { if (typeStrings != headerSize) { throw new Error( - "TypeStrings must immediately following the package structure header." + 'TypeStrings must immediately following the package structure header.', ); } if (DEBUG) { - console.log("Type strings:"); + console.log('Type strings:'); } var lastPosition = bb.offset; @@ -175,7 +175,7 @@ ResourceFinder.prototype.processPackage = function(bb) { // Key strings if (DEBUG) { - console.log("Key strings:"); + console.log('Key strings:'); } bb.offset = keyStrings; @@ -237,7 +237,7 @@ ResourceFinder.prototype.processPackage = function(bb) { * * @param {ByteBuffer} bb */ -ResourceFinder.prototype.processType = function(bb) { +ResourceFinder.prototype.processType = function (bb) { var type = bb.readShort(), headerSize = bb.readShort(), size = bb.readInt(), @@ -255,7 +255,7 @@ ResourceFinder.prototype.processType = function(bb) { bb.offset = headerSize; if (headerSize + entryCount * 4 != entriesStart) { - throw new Error("HeaderSize, entryCount and entriesStart are not valid."); + throw new Error('HeaderSize, entryCount and entriesStart are not valid.'); } // Start to get entry indices @@ -279,11 +279,11 @@ ResourceFinder.prototype.processType = function(bb) { value_dataType, value_data; try { - entry_size = bb.readShort() - entry_flag = bb.readShort() - entry_key = bb.readInt() + entry_size = bb.readShort(); + entry_flag = bb.readShort(); + entry_key = bb.readInt(); } catch (e) { - break + break; } // Get the value (simple) or map (complex) @@ -303,11 +303,11 @@ ResourceFinder.prototype.processType = function(bb) { if (DEBUG) { console.log( - "Entry 0x" + idStr + ", key: " + keyStr + ", simple value type: " + 'Entry 0x' + idStr + ', key: ' + keyStr + ', simple value type: ', ); } - var key = parseInt(idStr, 16); + var key = Number.parseInt(idStr, 16); var entryArr = this.entryMap[key]; if (entryArr == null) { @@ -321,20 +321,20 @@ ResourceFinder.prototype.processType = function(bb) { data = this.valueStringPool[value_data]; if (DEBUG) { - console.log(", data: " + this.valueStringPool[value_data] + ""); + console.log(', data: ' + this.valueStringPool[value_data] + ''); } } else if (value_dataType == TYPE_REFERENCE) { var hexIndex = Number(value_data).toString(16); refKeys[idStr] = value_data; } else { - data = "" + value_data; + data = '' + value_data; if (DEBUG) { - console.log(", data: " + value_data + ""); + console.log(', data: ' + value_data + ''); } } - this.putIntoMap("@" + idStr, data); + this.putIntoMap('@' + idStr, data); } else { // Complex case var entry_parent = bb.readInt(); @@ -350,26 +350,22 @@ ResourceFinder.prototype.processType = function(bb) { if (DEBUG) { console.log( - "Entry 0x" + + 'Entry 0x' + Number(resource_id).toString(16) + - ", key: " + + ', key: ' + this.keyStringPool[entry_key] + - ", complex value, not printed." + ', complex value, not printed.', ); } } } for (var refK in refKeys) { - var values = this.responseMap[ - "@" + - Number(refKeys[refK]) - .toString(16) - .toUpperCase() - ]; + var values = + this.responseMap['@' + Number(refKeys[refK]).toString(16).toUpperCase()]; if (values != null && Object.keys(values).length < 1000) { for (var value in values) { - this.putIntoMap("@" + refK, values[value]); + this.putIntoMap('@' + refK, values[value]); } } } @@ -380,7 +376,7 @@ ResourceFinder.prototype.processType = function(bb) { * @param {ByteBuffer} bb * @return {Array} */ -ResourceFinder.prototype.processStringPool = function(bb) { +ResourceFinder.prototype.processStringPool = (bb) => { // String pool structure // var type = bb.readShort(), @@ -407,7 +403,7 @@ ResourceFinder.prototype.processStringPool = function(bb) { var pos = stringsStart + offsets[i]; bb.offset = pos; - strings[i] = ""; + strings[i] = ''; if (isUTF_8) { u16len = bb.readUint8(); @@ -424,15 +420,15 @@ ResourceFinder.prototype.processStringPool = function(bb) { if (u8len > 0) { buffer = ResourceFinder.readBytes(bb, u8len); try { - strings[i] = ByteBuffer.wrap(buffer, "utf8", true).toString("utf8"); + strings[i] = ByteBuffer.wrap(buffer, 'utf8', true).toString('utf8'); } catch (e) { if (DEBUG) { console.error(e); - console.log("Error when turning buffer to utf-8 string."); + console.log('Error when turning buffer to utf-8 string.'); } } } else { - strings[i] = ""; + strings[i] = ''; } } else { u16len = bb.readUint16(); @@ -445,18 +441,18 @@ ResourceFinder.prototype.processStringPool = function(bb) { var len = u16len * 2; buffer = ResourceFinder.readBytes(bb, len); try { - strings[i] = ByteBuffer.wrap(buffer, "utf8", true).toString("utf8"); + strings[i] = ByteBuffer.wrap(buffer, 'utf8', true).toString('utf8'); } catch (e) { if (DEBUG) { console.error(e); - console.log("Error when turning buffer to utf-8 string."); + console.log('Error when turning buffer to utf-8 string.'); } } } } if (DEBUG) { - console.log("Parsed value: {0}", strings[i]); + console.log('Parsed value: {0}', strings[i]); } } @@ -467,7 +463,7 @@ ResourceFinder.prototype.processStringPool = function(bb) { * * @param {ByteBuffer} bb */ -ResourceFinder.prototype.processTypeSpec = function(bb) { +ResourceFinder.prototype.processTypeSpec = function (bb) { var type = bb.readShort(), headerSize = bb.readShort(), size = bb.readInt(), @@ -477,7 +473,7 @@ ResourceFinder.prototype.processTypeSpec = function(bb) { entryCount = bb.readInt(); if (DEBUG) { - console.log("Processing type spec " + this.typeStringPool[id - 1] + "..."); + console.log('Processing type spec ' + this.typeStringPool[id - 1] + '...'); } var flags = new Array(entryCount); @@ -487,12 +483,12 @@ ResourceFinder.prototype.processTypeSpec = function(bb) { } }; -ResourceFinder.prototype.putIntoMap = function(resId, value) { +ResourceFinder.prototype.putIntoMap = function (resId, value) { if (this.responseMap[resId.toUpperCase()] == null) { - this.responseMap[resId.toUpperCase()] = [] + this.responseMap[resId.toUpperCase()] = []; } - if(value){ - this.responseMap[resId.toUpperCase()].push(value) + if (value) { + this.responseMap[resId.toUpperCase()].push(value); } }; diff --git a/src/utils/app-info-parser/utils.js b/src/utils/app-info-parser/utils.js index a01b54a..d85bfc5 100644 --- a/src/utils/app-info-parser/utils.js +++ b/src/utils/app-info-parser/utils.js @@ -1,24 +1,27 @@ -function objectType (o) { - return Object.prototype.toString.call(o).slice(8, -1).toLowerCase() +function objectType(o) { + return Object.prototype.toString.call(o).slice(8, -1).toLowerCase(); } -function isArray (o) { - return objectType(o) === 'array' +function isArray(o) { + return objectType(o) === 'array'; } -function isObject (o) { - return objectType(o) === 'object' +function isObject(o) { + return objectType(o) === 'object'; } -function isPrimitive (o) { - return o === null || ['boolean', 'number', 'string', 'undefined'].includes(objectType(o)) +function isPrimitive(o) { + return ( + o === null || + ['boolean', 'number', 'string', 'undefined'].includes(objectType(o)) + ); } -function isBrowser () { +function isBrowser() { return ( typeof process === 'undefined' || Object.prototype.toString.call(process) !== '[object process]' - ) + ); } /** @@ -26,48 +29,48 @@ function isBrowser () { * @param {Object} apkInfo // json info parsed from .apk file * @param {Object} resourceMap // resourceMap */ -function mapInfoResource (apkInfo, resourceMap) { - iteratorObj(apkInfo) - return apkInfo - function iteratorObj (obj) { +function mapInfoResource(apkInfo, resourceMap) { + iteratorObj(apkInfo); + return apkInfo; + function iteratorObj(obj) { for (const i in obj) { if (isArray(obj[i])) { - iteratorArray(obj[i]) + iteratorArray(obj[i]); } else if (isObject(obj[i])) { - iteratorObj(obj[i]) + iteratorObj(obj[i]); } else if (isPrimitive(obj[i])) { if (isResources(obj[i])) { - obj[i] = resourceMap[transKeyToMatchResourceMap(obj[i])] + obj[i] = resourceMap[transKeyToMatchResourceMap(obj[i])]; } } } } - function iteratorArray (array) { - const l = array.length + function iteratorArray(array) { + const l = array.length; for (let i = 0; i < l; i++) { if (isArray(array[i])) { - iteratorArray(array[i]) + iteratorArray(array[i]); } else if (isObject(array[i])) { - iteratorObj(array[i]) + iteratorObj(array[i]); } else if (isPrimitive(array[i])) { if (isResources(array[i])) { - array[i] = resourceMap[transKeyToMatchResourceMap(array[i])] + array[i] = resourceMap[transKeyToMatchResourceMap(array[i])]; } } } } - function isResources (attrValue) { - if (!attrValue) return false + function isResources(attrValue) { + if (!attrValue) return false; if (typeof attrValue !== 'string') { - attrValue = attrValue.toString() + attrValue = attrValue.toString(); } - return attrValue.indexOf('resourceId:') === 0 + return attrValue.indexOf('resourceId:') === 0; } - function transKeyToMatchResourceMap (resourceId) { - return '@' + resourceId.replace('resourceId:0x', '').toUpperCase() + function transKeyToMatchResourceMap(resourceId) { + return '@' + resourceId.replace('resourceId:0x', '').toUpperCase(); } } @@ -75,62 +78,64 @@ function mapInfoResource (apkInfo, resourceMap) { * find .apk file's icon path from json info * @param info // json info parsed from .apk file */ -function findApkIconPath (info) { +function findApkIconPath(info) { if (!info.application.icon || !info.application.icon.splice) { - return '' + return ''; } const rulesMap = { mdpi: 48, hdpi: 72, xhdpi: 96, xxdpi: 144, - xxxhdpi: 192 - } - const resultMap = {} - const maxDpiIcon = { dpi: 120, icon: '' } + xxxhdpi: 192, + }; + const resultMap = {}; + const maxDpiIcon = { dpi: 120, icon: '' }; for (const i in rulesMap) { info.application.icon.some((icon) => { if (icon && icon.indexOf(i) !== -1) { - resultMap['application-icon-' + rulesMap[i]] = icon - return true + resultMap['application-icon-' + rulesMap[i]] = icon; + return true; } - }) + }); // get the maximal size icon if ( resultMap['application-icon-' + rulesMap[i]] && rulesMap[i] >= maxDpiIcon.dpi ) { - maxDpiIcon.dpi = rulesMap[i] - maxDpiIcon.icon = resultMap['application-icon-' + rulesMap[i]] + maxDpiIcon.dpi = rulesMap[i]; + maxDpiIcon.icon = resultMap['application-icon-' + rulesMap[i]]; } } if (Object.keys(resultMap).length === 0 || !maxDpiIcon.icon) { - maxDpiIcon.dpi = 120 - maxDpiIcon.icon = info.application.icon[0] || '' - resultMap['applicataion-icon-120'] = maxDpiIcon.icon + maxDpiIcon.dpi = 120; + maxDpiIcon.icon = info.application.icon[0] || ''; + resultMap['applicataion-icon-120'] = maxDpiIcon.icon; } - return maxDpiIcon.icon + return maxDpiIcon.icon; } /** * find .ipa file's icon path from json info * @param info // json info parsed from .ipa file */ -function findIpaIconPath (info) { +function findIpaIconPath(info) { if ( info.CFBundleIcons && info.CFBundleIcons.CFBundlePrimaryIcon && info.CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles && info.CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles.length ) { - return info.CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles[info.CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles.length - 1] + return info.CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles[ + info.CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles.length - 1 + ]; } else if (info.CFBundleIconFiles && info.CFBundleIconFiles.length) { - return info.CFBundleIconFiles[info.CFBundleIconFiles.length - 1] + return info.CFBundleIconFiles[info.CFBundleIconFiles.length - 1]; } else { - return '.app/Icon.png' + return '.app/Icon.png'; } } @@ -138,20 +143,20 @@ function findIpaIconPath (info) { * transform buffer to base64 * @param {Buffer} buffer */ -function getBase64FromBuffer (buffer) { - return 'data:image/png;base64,' + buffer.toString('base64') +function getBase64FromBuffer(buffer) { + return 'data:image/png;base64,' + buffer.toString('base64'); } /** * 去除unicode空字符 * @param {String} str */ -function decodeNullUnicode (str) { +function decodeNullUnicode(str) { if (typeof str === 'string') { // eslint-disable-next-line - str = str.replace(/\u0000/g, '') + str = str.replace(/\u0000/g, ''); } - return str + return str; } module.exports = { @@ -163,5 +168,5 @@ module.exports = { findApkIconPath, findIpaIconPath, getBase64FromBuffer, - decodeNullUnicode -} + decodeNullUnicode, +}; diff --git a/src/utils/app-info-parser/xml-parser/binary.js b/src/utils/app-info-parser/xml-parser/binary.js index b9a61d6..d8f2b86 100644 --- a/src/utils/app-info-parser/xml-parser/binary.js +++ b/src/utils/app-info-parser/xml-parser/binary.js @@ -2,8 +2,8 @@ const NodeType = { ELEMENT_NODE: 1, ATTRIBUTE_NODE: 2, - CDATA_SECTION_NODE: 4 -} + CDATA_SECTION_NODE: 4, +}; const ChunkType = { NULL: 0x0000, @@ -20,13 +20,13 @@ const ChunkType = { XML_RESOURCE_MAP: 0x0180, TABLE_PACKAGE: 0x0200, TABLE_TYPE: 0x0201, - TABLE_TYPE_SPEC: 0x0202 -} + TABLE_TYPE_SPEC: 0x0202, +}; const StringFlags = { SORTED: 1 << 0, - UTF8: 1 << 8 -} + UTF8: 1 << 8, +}; // Taken from android.util.TypedValue const TypedValue = { @@ -67,381 +67,390 @@ const TypedValue = { TYPE_LAST_INT: 0x0000001f, TYPE_NULL: 0x00000000, TYPE_REFERENCE: 0x00000001, - TYPE_STRING: 0x00000003 -} + TYPE_STRING: 0x00000003, +}; class BinaryXmlParser { - constructor (buffer, options = {}) { - this.buffer = buffer - this.cursor = 0 - this.strings = [] - this.resources = [] - this.document = null - this.parent = null - this.stack = [] - this.debug = options.debug || false + constructor(buffer, options = {}) { + this.buffer = buffer; + this.cursor = 0; + this.strings = []; + this.resources = []; + this.document = null; + this.parent = null; + this.stack = []; + this.debug = options.debug || false; } - readU8 () { - this.debug && console.group('readU8') - this.debug && console.debug('cursor:', this.cursor) - const val = this.buffer[this.cursor] - this.debug && console.debug('value:', val) - this.cursor += 1 - this.debug && console.groupEnd() - return val + readU8() { + this.debug && console.group('readU8'); + this.debug && console.debug('cursor:', this.cursor); + const val = this.buffer[this.cursor]; + this.debug && console.debug('value:', val); + this.cursor += 1; + this.debug && console.groupEnd(); + return val; } - readU16 () { - this.debug && console.group('readU16') - this.debug && console.debug('cursor:', this.cursor) - const val = this.buffer.readUInt16LE(this.cursor) - this.debug && console.debug('value:', val) - this.cursor += 2 - this.debug && console.groupEnd() - return val + readU16() { + this.debug && console.group('readU16'); + this.debug && console.debug('cursor:', this.cursor); + const val = this.buffer.readUInt16LE(this.cursor); + this.debug && console.debug('value:', val); + this.cursor += 2; + this.debug && console.groupEnd(); + return val; } - readS32 () { - this.debug && console.group('readS32') - this.debug && console.debug('cursor:', this.cursor) - const val = this.buffer.readInt32LE(this.cursor) - this.debug && console.debug('value:', val) - this.cursor += 4 - this.debug && console.groupEnd() - return val + readS32() { + this.debug && console.group('readS32'); + this.debug && console.debug('cursor:', this.cursor); + const val = this.buffer.readInt32LE(this.cursor); + this.debug && console.debug('value:', val); + this.cursor += 4; + this.debug && console.groupEnd(); + return val; } - readU32 () { - this.debug && console.group('readU32') - this.debug && console.debug('cursor:', this.cursor) - const val = this.buffer.readUInt32LE(this.cursor) - this.debug && console.debug('value:', val) - this.cursor += 4 - this.debug && console.groupEnd() - return val + readU32() { + this.debug && console.group('readU32'); + this.debug && console.debug('cursor:', this.cursor); + const val = this.buffer.readUInt32LE(this.cursor); + this.debug && console.debug('value:', val); + this.cursor += 4; + this.debug && console.groupEnd(); + return val; } - readLength8 () { - this.debug && console.group('readLength8') - let len = this.readU8() + readLength8() { + this.debug && console.group('readLength8'); + let len = this.readU8(); if (len & 0x80) { - len = (len & 0x7f) << 8 - len += this.readU8() + len = (len & 0x7f) << 8; + len += this.readU8(); } - this.debug && console.debug('length:', len) - this.debug && console.groupEnd() - return len + this.debug && console.debug('length:', len); + this.debug && console.groupEnd(); + return len; } - readLength16 () { - this.debug && console.group('readLength16') - let len = this.readU16() + readLength16() { + this.debug && console.group('readLength16'); + let len = this.readU16(); if (len & 0x8000) { - len = (len & 0x7fff) << 16 - len += this.readU16() + len = (len & 0x7fff) << 16; + len += this.readU16(); } - this.debug && console.debug('length:', len) - this.debug && console.groupEnd() - return len + this.debug && console.debug('length:', len); + this.debug && console.groupEnd(); + return len; } - readDimension () { - this.debug && console.group('readDimension') + readDimension() { + this.debug && console.group('readDimension'); const dimension = { value: null, unit: null, - rawUnit: null - } + rawUnit: null, + }; - const value = this.readU32() - const unit = dimension.value & 0xff + const value = this.readU32(); + const unit = dimension.value & 0xff; - dimension.value = value >> 8 - dimension.rawUnit = unit + dimension.value = value >> 8; + dimension.rawUnit = unit; switch (unit) { case TypedValue.COMPLEX_UNIT_MM: - dimension.unit = 'mm' - break + dimension.unit = 'mm'; + break; case TypedValue.COMPLEX_UNIT_PX: - dimension.unit = 'px' - break + dimension.unit = 'px'; + break; case TypedValue.COMPLEX_UNIT_DIP: - dimension.unit = 'dp' - break + dimension.unit = 'dp'; + break; case TypedValue.COMPLEX_UNIT_SP: - dimension.unit = 'sp' - break + dimension.unit = 'sp'; + break; case TypedValue.COMPLEX_UNIT_PT: - dimension.unit = 'pt' - break + dimension.unit = 'pt'; + break; case TypedValue.COMPLEX_UNIT_IN: - dimension.unit = 'in' - break + dimension.unit = 'in'; + break; } - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return dimension + return dimension; } - readFraction () { - this.debug && console.group('readFraction') + readFraction() { + this.debug && console.group('readFraction'); const fraction = { value: null, type: null, - rawType: null - } + rawType: null, + }; - const value = this.readU32() - const type = value & 0xf + const value = this.readU32(); + const type = value & 0xf; - fraction.value = this.convertIntToFloat(value >> 4) - fraction.rawType = type + fraction.value = this.convertIntToFloat(value >> 4); + fraction.rawType = type; switch (type) { case TypedValue.COMPLEX_UNIT_FRACTION: - fraction.type = '%' - break + fraction.type = '%'; + break; case TypedValue.COMPLEX_UNIT_FRACTION_PARENT: - fraction.type = '%p' - break + fraction.type = '%p'; + break; } - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return fraction + return fraction; } - readHex24 () { - this.debug && console.group('readHex24') - var val = (this.readU32() & 0xffffff).toString(16) - this.debug && console.groupEnd() - return val + readHex24() { + this.debug && console.group('readHex24'); + var val = (this.readU32() & 0xffffff).toString(16); + this.debug && console.groupEnd(); + return val; } - readHex32 () { - this.debug && console.group('readHex32') - var val = this.readU32().toString(16) - this.debug && console.groupEnd() - return val + readHex32() { + this.debug && console.group('readHex32'); + var val = this.readU32().toString(16); + this.debug && console.groupEnd(); + return val; } - readTypedValue () { - this.debug && console.group('readTypedValue') + readTypedValue() { + this.debug && console.group('readTypedValue'); const typedValue = { value: null, type: null, - rawType: null - } + rawType: null, + }; - const start = this.cursor + const start = this.cursor; - let size = this.readU16() - /* const zero = */ this.readU8() - const dataType = this.readU8() + let size = this.readU16(); + /* const zero = */ this.readU8(); + const dataType = this.readU8(); // Yes, there has been a real world APK where the size is malformed. if (size === 0) { - size = 8 + size = 8; } - typedValue.rawType = dataType + typedValue.rawType = dataType; switch (dataType) { case TypedValue.TYPE_INT_DEC: - typedValue.value = this.readS32() - typedValue.type = 'int_dec' - break + typedValue.value = this.readS32(); + typedValue.type = 'int_dec'; + break; case TypedValue.TYPE_INT_HEX: - typedValue.value = this.readS32() - typedValue.type = 'int_hex' - break + typedValue.value = this.readS32(); + typedValue.type = 'int_hex'; + break; case TypedValue.TYPE_STRING: - var ref = this.readS32() - typedValue.value = ref > 0 ? this.strings[ref] : '' - typedValue.type = 'string' - break + var ref = this.readS32(); + typedValue.value = ref > 0 ? this.strings[ref] : ''; + typedValue.type = 'string'; + break; case TypedValue.TYPE_REFERENCE: - var id = this.readU32() - typedValue.value = `resourceId:0x${id.toString(16)}` - typedValue.type = 'reference' - break + var id = this.readU32(); + typedValue.value = `resourceId:0x${id.toString(16)}`; + typedValue.type = 'reference'; + break; case TypedValue.TYPE_INT_BOOLEAN: - typedValue.value = this.readS32() !== 0 - typedValue.type = 'boolean' - break + typedValue.value = this.readS32() !== 0; + typedValue.type = 'boolean'; + break; case TypedValue.TYPE_NULL: - this.readU32() - typedValue.value = null - typedValue.type = 'null' - break + this.readU32(); + typedValue.value = null; + typedValue.type = 'null'; + break; case TypedValue.TYPE_INT_COLOR_RGB8: - typedValue.value = this.readHex24() - typedValue.type = 'rgb8' - break + typedValue.value = this.readHex24(); + typedValue.type = 'rgb8'; + break; case TypedValue.TYPE_INT_COLOR_RGB4: - typedValue.value = this.readHex24() - typedValue.type = 'rgb4' - break + typedValue.value = this.readHex24(); + typedValue.type = 'rgb4'; + break; case TypedValue.TYPE_INT_COLOR_ARGB8: - typedValue.value = this.readHex32() - typedValue.type = 'argb8' - break + typedValue.value = this.readHex32(); + typedValue.type = 'argb8'; + break; case TypedValue.TYPE_INT_COLOR_ARGB4: - typedValue.value = this.readHex32() - typedValue.type = 'argb4' - break + typedValue.value = this.readHex32(); + typedValue.type = 'argb4'; + break; case TypedValue.TYPE_DIMENSION: - typedValue.value = this.readDimension() - typedValue.type = 'dimension' - break + typedValue.value = this.readDimension(); + typedValue.type = 'dimension'; + break; case TypedValue.TYPE_FRACTION: - typedValue.value = this.readFraction() - typedValue.type = 'fraction' - break + typedValue.value = this.readFraction(); + typedValue.type = 'fraction'; + break; default: { - const type = dataType.toString(16) - console.debug(`Not sure what to do with typed value of type 0x${type}, falling back to reading an uint32.`) - typedValue.value = this.readU32() - typedValue.type = 'unknown' + const type = dataType.toString(16); + console.debug( + `Not sure what to do with typed value of type 0x${type}, falling back to reading an uint32.`, + ); + typedValue.value = this.readU32(); + typedValue.type = 'unknown'; } } // Ensure we consume the whole value - const end = start + size + const end = start + size; if (this.cursor !== end) { - const type = dataType.toString(16) - const diff = end - this.cursor + const type = dataType.toString(16); + const diff = end - this.cursor; console.debug(`Cursor is off by ${diff} bytes at ${this.cursor} at supposed end \ of typed value of type 0x${type}. The typed value started at offset ${start} \ -and is supposed to end at offset ${end}. Ignoring the rest of the value.`) - this.cursor = end +and is supposed to end at offset ${end}. Ignoring the rest of the value.`); + this.cursor = end; } - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return typedValue + return typedValue; } // https://twitter.com/kawasima/status/427730289201139712 - convertIntToFloat (int) { - const buf = new ArrayBuffer(4) - ;(new Int32Array(buf))[0] = int - return (new Float32Array(buf))[0] + convertIntToFloat(int) { + const buf = new ArrayBuffer(4); + new Int32Array(buf)[0] = int; + return new Float32Array(buf)[0]; } - readString (encoding) { - this.debug && console.group('readString', encoding) + readString(encoding) { + this.debug && console.group('readString', encoding); switch (encoding) { case 'utf-8': - var stringLength = this.readLength8(encoding) - this.debug && console.debug('stringLength:', stringLength) - var byteLength = this.readLength8(encoding) - this.debug && console.debug('byteLength:', byteLength) - var value = this.buffer.toString(encoding, this.cursor, (this.cursor += byteLength)) - this.debug && console.debug('value:', value) - this.debug && console.groupEnd() - return value + var stringLength = this.readLength8(encoding); + this.debug && console.debug('stringLength:', stringLength); + var byteLength = this.readLength8(encoding); + this.debug && console.debug('byteLength:', byteLength); + var value = this.buffer.toString( + encoding, + this.cursor, + (this.cursor += byteLength), + ); + this.debug && console.debug('value:', value); + this.debug && console.groupEnd(); + return value; case 'ucs2': - stringLength = this.readLength16(encoding) - this.debug && console.debug('stringLength:', stringLength) - byteLength = stringLength * 2 - this.debug && console.debug('byteLength:', byteLength) - value = this.buffer.toString(encoding, this.cursor, (this.cursor += byteLength)) - this.debug && console.debug('value:', value) - this.debug && console.groupEnd() - return value + stringLength = this.readLength16(encoding); + this.debug && console.debug('stringLength:', stringLength); + byteLength = stringLength * 2; + this.debug && console.debug('byteLength:', byteLength); + value = this.buffer.toString( + encoding, + this.cursor, + (this.cursor += byteLength), + ); + this.debug && console.debug('value:', value); + this.debug && console.groupEnd(); + return value; default: - throw new Error(`Unsupported encoding '${encoding}'`) + throw new Error(`Unsupported encoding '${encoding}'`); } } - readChunkHeader () { - this.debug && console.group('readChunkHeader') + readChunkHeader() { + this.debug && console.group('readChunkHeader'); var header = { startOffset: this.cursor, chunkType: this.readU16(), headerSize: this.readU16(), - chunkSize: this.readU32() - } - this.debug && console.debug('startOffset:', header.startOffset) - this.debug && console.debug('chunkType:', header.chunkType) - this.debug && console.debug('headerSize:', header.headerSize) - this.debug && console.debug('chunkSize:', header.chunkSize) - this.debug && console.groupEnd() - return header + chunkSize: this.readU32(), + }; + this.debug && console.debug('startOffset:', header.startOffset); + this.debug && console.debug('chunkType:', header.chunkType); + this.debug && console.debug('headerSize:', header.headerSize); + this.debug && console.debug('chunkSize:', header.chunkSize); + this.debug && console.groupEnd(); + return header; } - readStringPool (header) { - this.debug && console.group('readStringPool') + readStringPool(header) { + this.debug && console.group('readStringPool'); - header.stringCount = this.readU32() - this.debug && console.debug('stringCount:', header.stringCount) - header.styleCount = this.readU32() - this.debug && console.debug('styleCount:', header.styleCount) - header.flags = this.readU32() - this.debug && console.debug('flags:', header.flags) - header.stringsStart = this.readU32() - this.debug && console.debug('stringsStart:', header.stringsStart) - header.stylesStart = this.readU32() - this.debug && console.debug('stylesStart:', header.stylesStart) + header.stringCount = this.readU32(); + this.debug && console.debug('stringCount:', header.stringCount); + header.styleCount = this.readU32(); + this.debug && console.debug('styleCount:', header.styleCount); + header.flags = this.readU32(); + this.debug && console.debug('flags:', header.flags); + header.stringsStart = this.readU32(); + this.debug && console.debug('stringsStart:', header.stringsStart); + header.stylesStart = this.readU32(); + this.debug && console.debug('stylesStart:', header.stylesStart); if (header.chunkType !== ChunkType.STRING_POOL) { - throw new Error('Invalid string pool header') + throw new Error('Invalid string pool header'); } - const offsets = [] + const offsets = []; for (let i = 0, l = header.stringCount; i < l; ++i) { - this.debug && console.debug('offset:', i) - offsets.push(this.readU32()) + this.debug && console.debug('offset:', i); + offsets.push(this.readU32()); } - const sorted = (header.flags & StringFlags.SORTED) === StringFlags.SORTED - this.debug && console.debug('sorted:', sorted) - const encoding = (header.flags & StringFlags.UTF8) === StringFlags.UTF8 - ? 'utf-8' - : 'ucs2' - this.debug && console.debug('encoding:', encoding) + const sorted = (header.flags & StringFlags.SORTED) === StringFlags.SORTED; + this.debug && console.debug('sorted:', sorted); + const encoding = + (header.flags & StringFlags.UTF8) === StringFlags.UTF8 ? 'utf-8' : 'ucs2'; + this.debug && console.debug('encoding:', encoding); - const stringsStart = header.startOffset + header.stringsStart - this.cursor = stringsStart + const stringsStart = header.startOffset + header.stringsStart; + this.cursor = stringsStart; for (let i = 0, l = header.stringCount; i < l; ++i) { - this.debug && console.debug('string:', i) - this.debug && console.debug('offset:', offsets[i]) - this.cursor = stringsStart + offsets[i] - this.strings.push(this.readString(encoding)) + this.debug && console.debug('string:', i); + this.debug && console.debug('offset:', offsets[i]); + this.cursor = stringsStart + offsets[i]; + this.strings.push(this.readString(encoding)); } // Skip styles - this.cursor = header.startOffset + header.chunkSize + this.cursor = header.startOffset + header.chunkSize; - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return null + return null; } - readResourceMap (header) { - this.debug && console.group('readResourceMap') - const count = Math.floor((header.chunkSize - header.headerSize) / 4) + readResourceMap(header) { + this.debug && console.group('readResourceMap'); + const count = Math.floor((header.chunkSize - header.headerSize) / 4); for (let i = 0; i < count; ++i) { - this.resources.push(this.readU32()) + this.resources.push(this.readU32()); } - this.debug && console.groupEnd() - return null + this.debug && console.groupEnd(); + return null; } - readXmlNamespaceStart (/* header */) { - this.debug && console.group('readXmlNamespaceStart') + readXmlNamespaceStart(/* header */) { + this.debug && console.group('readXmlNamespaceStart'); - /* const line = */ this.readU32() - /* const commentRef = */ this.readU32() - /* const prefixRef = */ this.readS32() - /* const uriRef = */ this.readS32() + /* const line = */ this.readU32(); + /* const commentRef = */ this.readU32(); + /* const prefixRef = */ this.readS32(); + /* const uriRef = */ this.readS32(); // We don't currently care about the values, but they could // be accessed like so: @@ -449,18 +458,18 @@ and is supposed to end at offset ${end}. Ignoring the rest of the value.`) // namespaceURI.prefix = this.strings[prefixRef] // if prefixRef > 0 // namespaceURI.uri = this.strings[uriRef] // if uriRef > 0 - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return null + return null; } - readXmlNamespaceEnd (/* header */) { - this.debug && console.group('readXmlNamespaceEnd') + readXmlNamespaceEnd(/* header */) { + this.debug && console.group('readXmlNamespaceEnd'); - /* const line = */ this.readU32() - /* const commentRef = */ this.readU32() - /* const prefixRef = */ this.readS32() - /* const uriRef = */ this.readS32() + /* const line = */ this.readU32(); + /* const commentRef = */ this.readU32(); + /* const prefixRef = */ this.readS32(); + /* const uriRef = */ this.readS32(); // We don't currently care about the values, but they could // be accessed like so: @@ -468,60 +477,60 @@ and is supposed to end at offset ${end}. Ignoring the rest of the value.`) // namespaceURI.prefix = this.strings[prefixRef] // if prefixRef > 0 // namespaceURI.uri = this.strings[uriRef] // if uriRef > 0 - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return null + return null; } - readXmlElementStart (/* header */) { - this.debug && console.group('readXmlElementStart') + readXmlElementStart(/* header */) { + this.debug && console.group('readXmlElementStart'); const node = { namespaceURI: null, nodeType: NodeType.ELEMENT_NODE, nodeName: null, attributes: [], - childNodes: [] - } + childNodes: [], + }; - /* const line = */ this.readU32() - /* const commentRef = */ this.readU32() - const nsRef = this.readS32() - const nameRef = this.readS32() + /* const line = */ this.readU32(); + /* const commentRef = */ this.readU32(); + const nsRef = this.readS32(); + const nameRef = this.readS32(); if (nsRef > 0) { - node.namespaceURI = this.strings[nsRef] + node.namespaceURI = this.strings[nsRef]; } - node.nodeName = this.strings[nameRef] + node.nodeName = this.strings[nameRef]; - /* const attrStart = */ this.readU16() - /* const attrSize = */ this.readU16() - const attrCount = this.readU16() - /* const idIndex = */ this.readU16() - /* const classIndex = */ this.readU16() - /* const styleIndex = */ this.readU16() + /* const attrStart = */ this.readU16(); + /* const attrSize = */ this.readU16(); + const attrCount = this.readU16(); + /* const idIndex = */ this.readU16(); + /* const classIndex = */ this.readU16(); + /* const styleIndex = */ this.readU16(); for (let i = 0; i < attrCount; ++i) { - node.attributes.push(this.readXmlAttribute()) + node.attributes.push(this.readXmlAttribute()); } if (this.document) { - this.parent.childNodes.push(node) - this.parent = node + this.parent.childNodes.push(node); + this.parent = node; } else { - this.document = (this.parent = node) + this.document = this.parent = node; } - this.stack.push(node) + this.stack.push(node); - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return node + return node; } - readXmlAttribute () { - this.debug && console.group('readXmlAttribute') + readXmlAttribute() { + this.debug && console.group('readXmlAttribute'); const attr = { namespaceURI: null, @@ -529,146 +538,149 @@ and is supposed to end at offset ${end}. Ignoring the rest of the value.`) nodeName: null, name: null, value: null, - typedValue: null - } + typedValue: null, + }; - const nsRef = this.readS32() - const nameRef = this.readS32() - const valueRef = this.readS32() + const nsRef = this.readS32(); + const nameRef = this.readS32(); + const valueRef = this.readS32(); if (nsRef > 0) { - attr.namespaceURI = this.strings[nsRef] + attr.namespaceURI = this.strings[nsRef]; } - attr.nodeName = attr.name = this.strings[nameRef] + attr.nodeName = attr.name = this.strings[nameRef]; if (valueRef > 0) { // some apk have versionName with special characters if (attr.name === 'versionName') { // only keep printable characters // https://www.ascii-code.com/characters/printable-characters - this.strings[valueRef] = this.strings[valueRef].replace(/[^\x21-\x7E]/g, '') + this.strings[valueRef] = this.strings[valueRef].replace( + /[^\x21-\x7E]/g, + '', + ); } - attr.value = this.strings[valueRef] + attr.value = this.strings[valueRef]; } - attr.typedValue = this.readTypedValue() + attr.typedValue = this.readTypedValue(); - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return attr + return attr; } - readXmlElementEnd (/* header */) { - this.debug && console.group('readXmlCData') + readXmlElementEnd(/* header */) { + this.debug && console.group('readXmlCData'); - /* const line = */ this.readU32() - /* const commentRef = */ this.readU32() - /* const nsRef = */ this.readS32() - /* const nameRef = */ this.readS32() + /* const line = */ this.readU32(); + /* const commentRef = */ this.readU32(); + /* const nsRef = */ this.readS32(); + /* const nameRef = */ this.readS32(); - this.stack.pop() - this.parent = this.stack[this.stack.length - 1] + this.stack.pop(); + this.parent = this.stack[this.stack.length - 1]; - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return null + return null; } - readXmlCData (/* header */) { - this.debug && console.group('readXmlCData') + readXmlCData(/* header */) { + this.debug && console.group('readXmlCData'); const cdata = { namespaceURI: null, nodeType: NodeType.CDATA_SECTION_NODE, nodeName: '#cdata', data: null, - typedValue: null - } + typedValue: null, + }; - /* const line = */ this.readU32() - /* const commentRef = */ this.readU32() - const dataRef = this.readS32() + /* const line = */ this.readU32(); + /* const commentRef = */ this.readU32(); + const dataRef = this.readS32(); if (dataRef > 0) { - cdata.data = this.strings[dataRef] + cdata.data = this.strings[dataRef]; } - cdata.typedValue = this.readTypedValue() + cdata.typedValue = this.readTypedValue(); - this.parent.childNodes.push(cdata) + this.parent.childNodes.push(cdata); - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return cdata + return cdata; } - readNull (header) { - this.debug && console.group('readNull') - this.cursor += header.chunkSize - header.headerSize - this.debug && console.groupEnd() - return null + readNull(header) { + this.debug && console.group('readNull'); + this.cursor += header.chunkSize - header.headerSize; + this.debug && console.groupEnd(); + return null; } - parse () { - this.debug && console.group('BinaryXmlParser.parse') + parse() { + this.debug && console.group('BinaryXmlParser.parse'); - const xmlHeader = this.readChunkHeader() + const xmlHeader = this.readChunkHeader(); if (xmlHeader.chunkType !== ChunkType.XML) { - throw new Error('Invalid XML header') + throw new Error('Invalid XML header'); } while (this.cursor < this.buffer.length) { - this.debug && console.group('chunk') - const start = this.cursor - const header = this.readChunkHeader() + this.debug && console.group('chunk'); + const start = this.cursor; + const header = this.readChunkHeader(); switch (header.chunkType) { case ChunkType.STRING_POOL: - this.readStringPool(header) - break + this.readStringPool(header); + break; case ChunkType.XML_RESOURCE_MAP: - this.readResourceMap(header) - break + this.readResourceMap(header); + break; case ChunkType.XML_START_NAMESPACE: - this.readXmlNamespaceStart(header) - break + this.readXmlNamespaceStart(header); + break; case ChunkType.XML_END_NAMESPACE: - this.readXmlNamespaceEnd(header) - break + this.readXmlNamespaceEnd(header); + break; case ChunkType.XML_START_ELEMENT: - this.readXmlElementStart(header) - break + this.readXmlElementStart(header); + break; case ChunkType.XML_END_ELEMENT: - this.readXmlElementEnd(header) - break + this.readXmlElementEnd(header); + break; case ChunkType.XML_CDATA: - this.readXmlCData(header) - break + this.readXmlCData(header); + break; case ChunkType.NULL: - this.readNull(header) - break + this.readNull(header); + break; default: - throw new Error(`Unsupported chunk type '${header.chunkType}'`) + throw new Error(`Unsupported chunk type '${header.chunkType}'`); } // Ensure we consume the whole chunk - const end = start + header.chunkSize + const end = start + header.chunkSize; if (this.cursor !== end) { - const diff = end - this.cursor - const type = header.chunkType.toString(16) + const diff = end - this.cursor; + const type = header.chunkType.toString(16); console.debug(`Cursor is off by ${diff} bytes at ${this.cursor} at supposed \ end of chunk of type 0x${type}. The chunk started at offset ${start} and is \ -supposed to end at offset ${end}. Ignoring the rest of the chunk.`) - this.cursor = end +supposed to end at offset ${end}. Ignoring the rest of the chunk.`); + this.cursor = end; } - this.debug && console.groupEnd() + this.debug && console.groupEnd(); } - this.debug && console.groupEnd() + this.debug && console.groupEnd(); - return this.document + return this.document; } } -module.exports = BinaryXmlParser +module.exports = BinaryXmlParser; diff --git a/src/utils/app-info-parser/xml-parser/manifest.js b/src/utils/app-info-parser/xml-parser/manifest.js index 7b6e528..1a74c8e 100644 --- a/src/utils/app-info-parser/xml-parser/manifest.js +++ b/src/utils/app-info-parser/xml-parser/manifest.js @@ -1,216 +1,224 @@ // From https://github.com/openstf/adbkit-apkreader -const BinaryXmlParser = require('./binary') +const BinaryXmlParser = require('./binary'); -const INTENT_MAIN = 'android.intent.action.MAIN' -const CATEGORY_LAUNCHER = 'android.intent.category.LAUNCHER' +const INTENT_MAIN = 'android.intent.action.MAIN'; +const CATEGORY_LAUNCHER = 'android.intent.category.LAUNCHER'; class ManifestParser { - constructor (buffer, options = {}) { - this.buffer = buffer - this.xmlParser = new BinaryXmlParser(this.buffer, options) + constructor(buffer, options = {}) { + this.buffer = buffer; + this.xmlParser = new BinaryXmlParser(this.buffer, options); } - collapseAttributes (element) { - const collapsed = Object.create(null) - for (let attr of Array.from(element.attributes)) { - collapsed[attr.name] = attr.typedValue.value + collapseAttributes(element) { + const collapsed = Object.create(null); + for (const attr of Array.from(element.attributes)) { + collapsed[attr.name] = attr.typedValue.value; } - return collapsed + return collapsed; } - parseIntents (element, target) { - target.intentFilters = [] - target.metaData = [] + parseIntents(element, target) { + target.intentFilters = []; + target.metaData = []; - return element.childNodes.forEach(element => { + return element.childNodes.forEach((element) => { switch (element.nodeName) { case 'intent-filter': { - const intentFilter = this.collapseAttributes(element) + const intentFilter = this.collapseAttributes(element); - intentFilter.actions = [] - intentFilter.categories = [] - intentFilter.data = [] + intentFilter.actions = []; + intentFilter.categories = []; + intentFilter.data = []; - element.childNodes.forEach(element => { + element.childNodes.forEach((element) => { switch (element.nodeName) { case 'action': - intentFilter.actions.push(this.collapseAttributes(element)) - break + intentFilter.actions.push(this.collapseAttributes(element)); + break; case 'category': - intentFilter.categories.push(this.collapseAttributes(element)) - break + intentFilter.categories.push(this.collapseAttributes(element)); + break; case 'data': - intentFilter.data.push(this.collapseAttributes(element)) - break + intentFilter.data.push(this.collapseAttributes(element)); + break; } - }) + }); - target.intentFilters.push(intentFilter) - break + target.intentFilters.push(intentFilter); + break; } case 'meta-data': - target.metaData.push(this.collapseAttributes(element)) - break + target.metaData.push(this.collapseAttributes(element)); + break; } - }) + }); } - parseApplication (element) { - const app = this.collapseAttributes(element) + parseApplication(element) { + const app = this.collapseAttributes(element); - app.activities = [] - app.activityAliases = [] - app.launcherActivities = [] - app.services = [] - app.receivers = [] - app.providers = [] - app.usesLibraries = [] - app.metaData = [] + app.activities = []; + app.activityAliases = []; + app.launcherActivities = []; + app.services = []; + app.receivers = []; + app.providers = []; + app.usesLibraries = []; + app.metaData = []; - element.childNodes.forEach(element => { + element.childNodes.forEach((element) => { switch (element.nodeName) { case 'activity': { - const activity = this.collapseAttributes(element) - this.parseIntents(element, activity) - app.activities.push(activity) + const activity = this.collapseAttributes(element); + this.parseIntents(element, activity); + app.activities.push(activity); if (this.isLauncherActivity(activity)) { - app.launcherActivities.push(activity) + app.launcherActivities.push(activity); } - break + break; } case 'activity-alias': { - const activityAlias = this.collapseAttributes(element) - this.parseIntents(element, activityAlias) - app.activityAliases.push(activityAlias) + const activityAlias = this.collapseAttributes(element); + this.parseIntents(element, activityAlias); + app.activityAliases.push(activityAlias); if (this.isLauncherActivity(activityAlias)) { - app.launcherActivities.push(activityAlias) + app.launcherActivities.push(activityAlias); } - break + break; } case 'service': { - const service = this.collapseAttributes(element) - this.parseIntents(element, service) - app.services.push(service) - break + const service = this.collapseAttributes(element); + this.parseIntents(element, service); + app.services.push(service); + break; } case 'receiver': { - const receiver = this.collapseAttributes(element) - this.parseIntents(element, receiver) - app.receivers.push(receiver) - break + const receiver = this.collapseAttributes(element); + this.parseIntents(element, receiver); + app.receivers.push(receiver); + break; } case 'provider': { - const provider = this.collapseAttributes(element) + const provider = this.collapseAttributes(element); - provider.grantUriPermissions = [] - provider.metaData = [] - provider.pathPermissions = [] + provider.grantUriPermissions = []; + provider.metaData = []; + provider.pathPermissions = []; - element.childNodes.forEach(element => { + element.childNodes.forEach((element) => { switch (element.nodeName) { case 'grant-uri-permission': - provider.grantUriPermissions.push(this.collapseAttributes(element)) - break + provider.grantUriPermissions.push( + this.collapseAttributes(element), + ); + break; case 'meta-data': - provider.metaData.push(this.collapseAttributes(element)) - break + provider.metaData.push(this.collapseAttributes(element)); + break; case 'path-permission': - provider.pathPermissions.push(this.collapseAttributes(element)) - break + provider.pathPermissions.push(this.collapseAttributes(element)); + break; } - }) + }); - app.providers.push(provider) - break + app.providers.push(provider); + break; } case 'uses-library': - app.usesLibraries.push(this.collapseAttributes(element)) - break + app.usesLibraries.push(this.collapseAttributes(element)); + break; case 'meta-data': - app.metaData.push(this.collapseAttributes(element)) - break + app.metaData.push(this.collapseAttributes(element)); + break; } - }) + }); - return app + return app; } - isLauncherActivity (activity) { - return activity.intentFilters.some(function (filter) { - const hasMain = filter.actions.some(action => action.name === INTENT_MAIN) + isLauncherActivity(activity) { + return activity.intentFilters.some((filter) => { + const hasMain = filter.actions.some( + (action) => action.name === INTENT_MAIN, + ); if (!hasMain) { - return false + return false; } - return filter.categories.some(category => category.name === CATEGORY_LAUNCHER) - }) + return filter.categories.some( + (category) => category.name === CATEGORY_LAUNCHER, + ); + }); } - parse () { - const document = this.xmlParser.parse() - const manifest = this.collapseAttributes(document) - - manifest.usesPermissions = [] - manifest.usesPermissionsSDK23 = [] - manifest.permissions = [] - manifest.permissionTrees = [] - manifest.permissionGroups = [] - manifest.instrumentation = null - manifest.usesSdk = null - manifest.usesConfiguration = null - manifest.usesFeatures = [] - manifest.supportsScreens = null - manifest.compatibleScreens = [] - manifest.supportsGlTextures = [] - manifest.application = Object.create(null) - - document.childNodes.forEach(element => { + parse() { + const document = this.xmlParser.parse(); + const manifest = this.collapseAttributes(document); + + manifest.usesPermissions = []; + manifest.usesPermissionsSDK23 = []; + manifest.permissions = []; + manifest.permissionTrees = []; + manifest.permissionGroups = []; + manifest.instrumentation = null; + manifest.usesSdk = null; + manifest.usesConfiguration = null; + manifest.usesFeatures = []; + manifest.supportsScreens = null; + manifest.compatibleScreens = []; + manifest.supportsGlTextures = []; + manifest.application = Object.create(null); + + document.childNodes.forEach((element) => { switch (element.nodeName) { case 'uses-permission': - manifest.usesPermissions.push(this.collapseAttributes(element)) - break + manifest.usesPermissions.push(this.collapseAttributes(element)); + break; case 'uses-permission-sdk-23': - manifest.usesPermissionsSDK23.push(this.collapseAttributes(element)) - break + manifest.usesPermissionsSDK23.push(this.collapseAttributes(element)); + break; case 'permission': - manifest.permissions.push(this.collapseAttributes(element)) - break + manifest.permissions.push(this.collapseAttributes(element)); + break; case 'permission-tree': - manifest.permissionTrees.push(this.collapseAttributes(element)) - break + manifest.permissionTrees.push(this.collapseAttributes(element)); + break; case 'permission-group': - manifest.permissionGroups.push(this.collapseAttributes(element)) - break + manifest.permissionGroups.push(this.collapseAttributes(element)); + break; case 'instrumentation': - manifest.instrumentation = this.collapseAttributes(element) - break + manifest.instrumentation = this.collapseAttributes(element); + break; case 'uses-sdk': - manifest.usesSdk = this.collapseAttributes(element) - break + manifest.usesSdk = this.collapseAttributes(element); + break; case 'uses-configuration': - manifest.usesConfiguration = this.collapseAttributes(element) - break + manifest.usesConfiguration = this.collapseAttributes(element); + break; case 'uses-feature': - manifest.usesFeatures.push(this.collapseAttributes(element)) - break + manifest.usesFeatures.push(this.collapseAttributes(element)); + break; case 'supports-screens': - manifest.supportsScreens = this.collapseAttributes(element) - break + manifest.supportsScreens = this.collapseAttributes(element); + break; case 'compatible-screens': - element.childNodes.forEach(screen => { - return manifest.compatibleScreens.push(this.collapseAttributes(screen)) - }) - break + element.childNodes.forEach((screen) => { + return manifest.compatibleScreens.push( + this.collapseAttributes(screen), + ); + }); + break; case 'supports-gl-texture': - manifest.supportsGlTextures.push(this.collapseAttributes(element)) - break + manifest.supportsGlTextures.push(this.collapseAttributes(element)); + break; case 'application': - manifest.application = this.parseApplication(element) - break + manifest.application = this.parseApplication(element); + break; } - }) + }); - return manifest + return manifest; } } -module.exports = ManifestParser +module.exports = ManifestParser; diff --git a/src/utils/app-info-parser/zip.js b/src/utils/app-info-parser/zip.js index 60a3734..d356b28 100644 --- a/src/utils/app-info-parser/zip.js +++ b/src/utils/app-info-parser/zip.js @@ -1,6 +1,6 @@ const Unzip = require('isomorphic-unzip'); const { isBrowser, decodeNullUnicode } = require('./utils'); -import { enumZipEntries, readEntry } from '../../bundle'; +const { enumZipEntries, readEntry } = require('../../bundle'); class Zip { constructor(file) { diff --git a/src/utils/check-plugin.ts b/src/utils/check-plugin.ts index 840fe9c..e4a81a9 100644 --- a/src/utils/check-plugin.ts +++ b/src/utils/check-plugin.ts @@ -1,5 +1,5 @@ -import { plugins } from './plugin-config'; import { t } from './i18n'; +import { plugins } from './plugin-config'; interface BundleParams { sentry: boolean; @@ -21,7 +21,9 @@ export async function checkPlugins(): Promise { console.log(t('pluginDetected', { name: plugin.name })); } } catch (err) { - console.warn(t('pluginDetectionError', { name: plugin.name, error: err })); + console.warn( + t('pluginDetectionError', { name: plugin.name, error: err }), + ); } } diff --git a/src/utils/dep-versions.ts b/src/utils/dep-versions.ts index 3f06a54..e950454 100644 --- a/src/utils/dep-versions.ts +++ b/src/utils/dep-versions.ts @@ -3,8 +3,12 @@ const currentPackage = require(`${process.cwd()}/package.json`); const _depVersions: Record = {}; if (currentPackage) { - const depKeys = currentPackage.dependencies ? Object.keys(currentPackage.dependencies) : []; - const devDepKeys = currentPackage.devDependencies ? Object.keys(currentPackage.devDependencies) : []; + const depKeys = currentPackage.dependencies + ? Object.keys(currentPackage.dependencies) + : []; + const devDepKeys = currentPackage.devDependencies + ? Object.keys(currentPackage.devDependencies) + : []; const dedupedDeps = [...new Set([...depKeys, ...devDepKeys])]; for (const dep of dedupedDeps) { @@ -20,9 +24,12 @@ if (currentPackage) { export const depVersions = Object.keys(_depVersions) .sort() // Sort the keys alphabetically - .reduce((obj, key) => { - obj[key] = _depVersions[key]; // Rebuild the object with sorted keys - return obj; - }, {} as Record); + .reduce( + (obj, key) => { + obj[key] = _depVersions[key]; // Rebuild the object with sorted keys + return obj; + }, + {} as Record, + ); // console.log({ depVersions }); diff --git a/src/utils/git.ts b/src/utils/git.ts index a708e0a..541c6be 100644 --- a/src/utils/git.ts +++ b/src/utils/git.ts @@ -1,6 +1,6 @@ -import git from 'isomorphic-git'; import fs from 'fs'; import path from 'path'; +import git from 'isomorphic-git'; export interface CommitInfo { hash: string; diff --git a/src/utils/i18n.ts b/src/utils/i18n.ts index 79c3a69..1473df5 100644 --- a/src/utils/i18n.ts +++ b/src/utils/i18n.ts @@ -34,4 +34,6 @@ declare module 'i18next' { } } -export const t = i18next.t; +export function t(key: string, options?: any): string { + return i18next.t(key as any, options); +} diff --git a/src/utils/index.ts b/src/utils/index.ts index 51da77b..f325afd 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,11 +1,11 @@ -import fs from 'fs-extra'; import os from 'os'; import path from 'path'; -import pkg from '../../package.json'; -import AppInfoParser from './app-info-parser'; -import { satisfies } from 'compare-versions'; import chalk from 'chalk'; +import { satisfies } from 'compare-versions'; +import fs from 'fs-extra'; +import pkg from '../../package.json'; import latestVersion from '../utils/latest-version'; +import AppInfoParser from './app-info-parser'; import { checkPlugins } from './check-plugin'; import { read } from 'read'; @@ -88,16 +88,14 @@ export async function getAppInfo(fn: string) { }), ); } - const updateJsonFile = await appInfoParser.parser.getEntryFromHarmonyApp( - /rawfile\/update.json/, - ); + const updateJsonFile = + await appInfoParser.parser.getEntryFromHarmonyApp(/rawfile\/update.json/); let appCredential = {}; if (updateJsonFile) { appCredential = JSON.parse(updateJsonFile.toString()).harmony; } - const metaJsonFile = await appInfoParser.parser.getEntryFromHarmonyApp( - /rawfile\/meta.json/, - ); + const metaJsonFile = + await appInfoParser.parser.getEntryFromHarmonyApp(/rawfile\/meta.json/); let metaData: Record = {}; if (metaJsonFile) { metaData = JSON.parse(metaJsonFile.toString()); diff --git a/src/utils/latest-version/cli.ts b/src/utils/latest-version/cli.ts index 4b0d037..dba3dca 100644 --- a/src/utils/latest-version/cli.ts +++ b/src/utils/latest-version/cli.ts @@ -1,3 +1,5 @@ +import { existsSync, readFileSync } from 'fs'; +import { dirname } from 'path'; import { blue, bold, @@ -12,16 +14,14 @@ import { underline, yellow, } from '@colors/colors/safe'; -import { existsSync, readFileSync } from 'fs'; -import { dirname } from 'path'; +import semverDiff from 'semver/functions/diff'; +import semverMajor from 'semver/functions/major'; import latestVersion, { type Package, type PackageJson, type LatestVersionPackage, type LatestVersionOptions, } from '.'; -import semverMajor from 'semver/functions/major'; -import semverDiff from 'semver/functions/diff'; interface TableColumn { label: string; diff --git a/src/utils/latest-version/index.ts b/src/utils/latest-version/index.ts index 332d0cb..d8adb44 100644 --- a/src/utils/latest-version/index.ts +++ b/src/utils/latest-version/index.ts @@ -1,19 +1,19 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs'; import type { - RequestOptions as HttpRequestOptions, Agent, + RequestOptions as HttpRequestOptions, IncomingMessage, } from 'http'; import type { RequestOptions as HttpsRequestOptions } from 'https'; -import { join, dirname, resolve as pathResolve, parse } from 'path'; -import { npm, yarn } from 'global-dirs'; import { homedir } from 'os'; +import { dirname, join, parse, resolve as pathResolve } from 'path'; import { URL } from 'url'; +import { npm, yarn } from 'global-dirs'; -import getRegistryUrl from 'registry-auth-token/registry-url'; import registryAuthToken from 'registry-auth-token'; -import maxSatisfying from 'semver/ranges/max-satisfying'; +import getRegistryUrl from 'registry-auth-token/registry-url'; import gt from 'semver/functions/gt'; +import maxSatisfying from 'semver/ranges/max-satisfying'; interface RegistryVersions { /** @@ -132,9 +132,10 @@ interface LatestVersion { * If `registryUrl` is not supplied, the default from `.npmrc` is used or a fallback to the `npm registry url` instead. * @returns {Promise} */ - (item: PackageJson, options?: LatestVersionOptions): Promise< - LatestVersionPackage[] - >; + ( + item: PackageJson, + options?: LatestVersionOptions, + ): Promise; /** * Get latest version of a single package. @@ -161,9 +162,10 @@ interface LatestVersion { * If `registryUrl` is not supplied, the default from `.npmrc` is used or a fallback to the npm registry url instead. * @returns {Promise} */ - (items: Package[], options?: LatestVersionOptions): Promise< - LatestVersionPackage[] - >; // eslint-disable-line @typescript-eslint/unified-signatures + ( + items: Package[], + options?: LatestVersionOptions, + ): Promise; // eslint-disable-line @typescript-eslint/unified-signatures } type PackageRange = `${'@' | ''}${string}@${string}`; type Package = PackageRange | string; // eslint-disable-line @typescript-eslint/no-redundant-type-constituents @@ -225,7 +227,7 @@ const downloadMetadata = ( }; const authInfo = registryAuthToken(pkgUrl.toString(), { recursive: true }); if (authInfo && requestOptions.headers) { - requestOptions.headers.authorization = `${authInfo.type} ${authInfo.token}`; + (requestOptions.headers as any).authorization = `${authInfo.type} ${authInfo.token}`; } if (options?.requestOptions) { requestOptions = { ...requestOptions, ...options.requestOptions }; @@ -362,11 +364,9 @@ const getInstalledVersion = ( ?.version as string; } else if (location === 'globalYarn') { // Make sure package is globally installed by Yarn - const yarnGlobalPkg = require(pathResolve( - yarn.packages, - '..', - 'package.json', - )); + const yarnGlobalPkg = require( + pathResolve(yarn.packages, '..', 'package.json'), + ); if (!yarnGlobalPkg?.dependencies?.[pkgName]) { return undefined; } diff --git a/src/utils/plugin-config.ts b/src/utils/plugin-config.ts index 06cbac3..469fb10 100644 --- a/src/utils/plugin-config.ts +++ b/src/utils/plugin-config.ts @@ -27,6 +27,6 @@ export const plugins: PluginConfig[] = [ return false; } } - } - } -]; \ No newline at end of file + }, + }, +]; diff --git a/src/versions.ts b/src/versions.ts index d04fb34..b40c5ef 100644 --- a/src/versions.ts +++ b/src/versions.ts @@ -2,13 +2,13 @@ import { get, getAllPackages, post, put, uploadFile } from './api'; import { question, saveToLocal } from './utils'; import { t } from './utils/i18n'; +import chalk from 'chalk'; +import { satisfies } from 'compare-versions'; +import type { Package, Platform, Version } from './types'; import { getPlatform, getSelectedApp } from './app'; import { choosePackage } from './package'; import { depVersions } from './utils/dep-versions'; import { getCommitInfo } from './utils/git'; -import type { Package, Platform, Version } from 'types'; -import { satisfies } from 'compare-versions'; -import chalk from 'chalk'; interface VersionCommandOptions { appId?: string; diff --git a/test-modules.js b/test-modules.js new file mode 100644 index 0000000..d24c15c --- /dev/null +++ b/test-modules.js @@ -0,0 +1,79 @@ +#!/usr/bin/env node + +// Simple test script to verify module loading and workflows +console.log('🔍 Testing module workflows...\n'); + +try { + // Test app module + console.log('=== App Module ==='); + const { appModule } = require('./lib/modules/app-module'); + console.log(`✅ Commands: ${appModule.commands.length}`); + console.log(`✅ Workflows: ${appModule.workflows.length}`); + appModule.workflows.forEach((w) => { + console.log(` - ${w.name}: ${w.description}`); + console.log(` Steps: ${w.steps.length}`); + }); + console.log(); + + // Test bundle module + console.log('=== Bundle Module ==='); + const { bundleModule } = require('./lib/modules/bundle-module'); + console.log(`✅ Commands: ${bundleModule.commands.length}`); + console.log(`✅ Workflows: ${bundleModule.workflows.length}`); + bundleModule.workflows.forEach((w) => { + console.log(` - ${w.name}: ${w.description}`); + console.log(` Steps: ${w.steps.length}`); + }); + console.log(); + + // Test package module + console.log('=== Package Module ==='); + const { packageModule } = require('./lib/modules/package-module'); + console.log(`✅ Commands: ${packageModule.commands.length}`); + console.log(`✅ Workflows: ${packageModule.workflows.length}`); + packageModule.workflows.forEach((w) => { + console.log(` - ${w.name}: ${w.description}`); + console.log(` Steps: ${w.steps.length}`); + }); + console.log(); + + // Test version module + console.log('=== Version Module ==='); + const { versionModule } = require('./lib/modules/version-module'); + console.log(`✅ Commands: ${versionModule.commands.length}`); + console.log(`✅ Workflows: ${versionModule.workflows.length}`); + versionModule.workflows.forEach((w) => { + console.log(` - ${w.name}: ${w.description}`); + console.log(` Steps: ${w.steps.length}`); + }); + console.log(); + + // Test user module + console.log('=== User Module ==='); + const { userModule } = require('./lib/modules/user-module'); + console.log(`✅ Commands: ${userModule.commands.length}`); + console.log(`✅ Workflows: ${userModule.workflows.length}`); + userModule.workflows.forEach((w) => { + console.log(` - ${w.name}: ${w.description}`); + console.log(` Steps: ${w.steps.length}`); + }); + console.log(); + + console.log('🎉 All modules loaded successfully with enhanced workflows!'); + + // Summary + const totalWorkflows = [ + appModule, + bundleModule, + packageModule, + versionModule, + userModule, + ].reduce((sum, module) => sum + module.workflows.length, 0); + + console.log(`\n📊 Summary:`); + console.log(` Total workflows: ${totalWorkflows}`); + console.log(` Enhanced modules: 5/5`); +} catch (error) { + console.error('❌ Error testing modules:', error.message); + process.exit(1); +} From adff23ba6b8e0eb2b672cc07c4346aa0ec89464d Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 21 Jul 2025 09:43:08 +0800 Subject: [PATCH 19/21] update readme file --- README.md | 300 ++++++++++----------- README.zh-CN.md | 575 ++++++++++++++++++++++++++++++++++++++++ example/README.md | 242 ++++++++--------- example/README.zh-CN.md | 374 ++++++++++++++++++++++++++ 4 files changed, 1222 insertions(+), 269 deletions(-) create mode 100644 README.zh-CN.md create mode 100644 example/README.zh-CN.md diff --git a/README.md b/README.md index cc9c9b2..e0af85b 100644 --- a/README.md +++ b/README.md @@ -1,55 +1,57 @@ -# React Native Update CLI - 模块化版本 +# React Native Update CLI - Modular Version -这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 +[中文文档](./README.zh-CN.md) | [Chinese Documentation](./README.zh-CN.md) -## 🚀 新特性 +This is a refactored React Native Update CLI that supports modular architecture and custom publishing workflows. -- **模块化架构**: 将CLI功能拆分为独立的模块 -- **自定义工作流**: 支持创建自定义的发布流程 -- **可扩展性**: 用户可以导入和注册自定义模块 -- **类型安全**: 完整的TypeScript类型支持 -- **向后兼容**: 保持与现有CLI的兼容性 +## 🚀 New Features -## 📦 安装 +- **Modular Architecture**: Split CLI functionality into independent modules +- **Custom Workflows**: Support for creating custom publishing workflows +- **Extensibility**: Users can import and register custom modules +- **Type Safety**: Complete TypeScript type support +- **Backward Compatibility**: Maintains compatibility with existing CLI + +## 📦 Installation ```bash npm install react-native-update-cli ``` -## 🎯 快速开始 +## 🎯 Quick Start -### 基本使用 +### Basic Usage ```bash -# 使用模块化CLI +# Use modular CLI npx pushy-modular help -# 列出所有可用命令和工作流 +# List all available commands and workflows npx pushy-modular list -# 执行内置的工作流 +# Execute built-in workflow npx pushy-modular workflow setup-app -# 执行自定义工作流 +# Execute custom workflow npx pushy-modular workflow custom-publish ``` -### 编程方式使用 +### Programmatic Usage ```typescript import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; -// 获取CLI提供者 +// Get CLI provider const provider = moduleManager.getProvider(); -// 执行打包 +// Execute bundling const bundleResult = await provider.bundle({ platform: 'ios', dev: false, sourcemap: true }); -// 发布版本 +// Publish version const publishResult = await provider.publish({ name: 'v1.2.3', description: 'Bug fixes and improvements', @@ -57,9 +59,9 @@ const publishResult = await provider.publish({ }); ``` -## 🔧 创建自定义模块 +## 🔧 Creating Custom Modules -### 1. 定义模块 +### 1. Define Module ```typescript import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; @@ -120,47 +122,47 @@ export const myCustomModule: CLIModule = { }; ``` -### 2. 注册模块 +### 2. Register Module ```typescript import { moduleManager } from 'react-native-update-cli'; import { myCustomModule } from './my-custom-module'; -// 注册自定义模块 +// Register custom module moduleManager.registerModule(myCustomModule); -// 执行自定义命令 +// Execute custom command const result = await moduleManager.executeCommand('custom-command', { args: [], options: { param: 'value' } }); -// 执行自定义工作流 +// Execute custom workflow const workflowResult = await moduleManager.executeWorkflow('my-workflow', { args: [], options: {} }); ``` -## 🔄 工作流系统 +## 🔄 Workflow System -### 工作流步骤 +### Workflow Steps -每个工作流步骤包含： +Each workflow step contains: -- `name`: 步骤名称 -- `description`: 步骤描述 -- `execute`: 执行函数 -- `condition`: 可选的条件函数 +- `name`: Step name +- `description`: Step description +- `execute`: Execution function +- `condition`: Optional condition function -### 条件执行 +### Conditional Execution ```typescript { name: 'conditional-step', description: 'Only execute in production', execute: async (context, previousResult) => { - // 执行逻辑 + // Execution logic }, condition: (context) => { return context.options.environment === 'production'; @@ -168,7 +170,7 @@ const workflowResult = await moduleManager.executeWorkflow('my-workflow', { } ``` -### 工作流验证 +### Workflow Validation ```typescript { @@ -185,89 +187,89 @@ const workflowResult = await moduleManager.executeWorkflow('my-workflow', { } ``` -## 📋 内置模块 - -### Bundle模块 (`bundle`) -- `bundle`: 打包JavaScript代码并可选发布 -- `diff`: 生成两个PPK文件之间的差异 -- `hdiff`: 生成两个PPK文件之间的hdiff -- `diffFromApk`: 从APK文件生成差异 -- `hdiffFromApk`: 从APK文件生成hdiff -- `hdiffFromApp`: 从APP文件生成hdiff -- `diffFromIpa`: 从IPA文件生成差异 -- `hdiffFromIpa`: 从IPA文件生成hdiff - -### Version模块 (`version`) -- `publish`: 发布新版本 -- `versions`: 列出所有版本 -- `update`: 更新版本信息 -- `updateVersionInfo`: 更新版本元数据 - -### App模块 (`app`) -- `createApp`: 创建新应用 -- `apps`: 列出所有应用 -- `selectApp`: 选择应用 -- `deleteApp`: 删除应用 - -### Package模块 (`package`) -- `uploadIpa`: 上传IPA文件 -- `uploadApk`: 上传APK文件 -- `uploadApp`: 上传APP文件 -- `parseApp`: 解析APP文件信息 -- `parseIpa`: 解析IPA文件信息 -- `parseApk`: 解析APK文件信息 -- `packages`: 列出包 - -### User模块 (`user`) -- `login`: 登录 -- `logout`: 登出 -- `me`: 显示用户信息 - -## 🛠️ CLI提供者API - -### 核心功能 +## 📋 Built-in Modules + +### Bundle Module (`bundle`) +- `bundle`: Bundle JavaScript code and optionally publish +- `diff`: Generate differences between two PPK files +- `hdiff`: Generate hdiff between two PPK files +- `diffFromApk`: Generate differences from APK files +- `hdiffFromApk`: Generate hdiff from APK files +- `hdiffFromApp`: Generate hdiff from APP files +- `diffFromIpa`: Generate differences from IPA files +- `hdiffFromIpa`: Generate hdiff from IPA files + +### Version Module (`version`) +- `publish`: Publish new version +- `versions`: List all versions +- `update`: Update version information +- `updateVersionInfo`: Update version metadata + +### App Module (`app`) +- `createApp`: Create new application +- `apps`: List all applications +- `selectApp`: Select application +- `deleteApp`: Delete application + +### Package Module (`package`) +- `uploadIpa`: Upload IPA files +- `uploadApk`: Upload APK files +- `uploadApp`: Upload APP files +- `parseApp`: Parse APP file information +- `parseIpa`: Parse IPA file information +- `parseApk`: Parse APK file information +- `packages`: List packages + +### User Module (`user`) +- `login`: Login +- `logout`: Logout +- `me`: Show user information + +## 🛠️ CLI Provider API + +### Core Functionality ```typescript interface CLIProvider { - // 打包 + // Bundle bundle(options: BundleOptions): Promise; - // 发布 + // Publish publish(options: PublishOptions): Promise; - // 上传 + // Upload upload(options: UploadOptions): Promise; - // 应用管理 + // Application management getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; listApps(platform?: Platform): Promise; createApp(name: string, platform: Platform): Promise; - // 版本管理 + // Version management listVersions(appId: string): Promise; getVersion(appId: string, versionId: string): Promise; updateVersion(appId: string, versionId: string, updates: Partial): Promise; - // 包管理 + // Package management listPackages(appId: string, platform?: Platform): Promise; getPackage(appId: string, packageId: string): Promise; - // 工具函数 + // Utility functions getPlatform(platform?: Platform): Promise; loadSession(): Promise; saveToLocal(key: string, value: string): void; question(prompt: string): Promise; - // 工作流 + // Workflows registerWorkflow(workflow: CustomWorkflow): void; executeWorkflow(workflowName: string, context: CommandContext): Promise; } ``` -### 自定义命令 +### Custom Commands ```typescript -// 执行自定义打包命令 +// Execute custom bundle command const bundleResult = await moduleManager.executeCommand('custom-bundle', { args: [], options: { @@ -277,7 +279,7 @@ const bundleResult = await moduleManager.executeCommand('custom-bundle', { } }); -// 生成差异文件 +// Generate diff file const diffResult = await moduleManager.executeCommand('diff', { args: [], options: { @@ -287,7 +289,7 @@ const diffResult = await moduleManager.executeCommand('diff', { } }); -// 从APK文件生成差异 +// Generate diff from APK files const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { args: [], options: { @@ -298,21 +300,21 @@ const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { }); ``` -## 🔧 配置 +## 🔧 Configuration -### 环境变量 +### Environment Variables ```bash -# 设置API端点 +# Set API endpoint export PUSHY_REGISTRY=https://your-api-endpoint.com -# 设置非交互模式 +# Set non-interactive mode export NO_INTERACTIVE=true ``` -### 配置文件 +### Configuration File -创建 `update.json` 文件： +Create `update.json` file: ```json { @@ -327,90 +329,90 @@ export NO_INTERACTIVE=true } ``` -## 🚨 注意事项 +## 🚨 Important Notes -1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 -2. **类型安全**: 所有API都有完整的TypeScript类型定义 -3. **错误处理**: 所有操作都返回标准化的结果格式 -4. **资源清理**: 模块支持清理函数来释放资源 -5. **模块分离**: 功能按逻辑分离到不同模块中，便于维护和扩展 +1. **Backward Compatibility**: The new modular CLI maintains compatibility with existing CLI +2. **Type Safety**: All APIs have complete TypeScript type definitions +3. **Error Handling**: All operations return standardized result formats +4. **Resource Cleanup**: Modules support cleanup functions to release resources +5. **Module Separation**: Functionality is logically separated into different modules for easy maintenance and extension -## 🤝 贡献 +## 🤝 Contributing -欢迎提交Issue和Pull Request来改进这个项目！ +Welcome to submit Issues and Pull Requests to improve this project! -## 🚀 Provider API 使用指南 +## 🚀 Provider API Usage Guide -Provider提供了简洁的编程接口，适合在应用程序中集成React Native Update CLI功能。 +Provider provides a concise programming interface suitable for integrating React Native Update CLI functionality in applications. -### 📋 核心API方法 +### 📋 Core API Methods -#### 核心业务功能 +#### Core Business Functions ```typescript -// 打包应用 +// Bundle application await provider.bundle({ platform: 'ios', dev: false, sourcemap: true }); -// 发布版本 +// Publish version await provider.publish({ name: 'v1.0.0', description: 'Bug fixes', rollout: 100 }); -// 上传文件 +// Upload file await provider.upload({ filePath: 'app.ipa', platform: 'ios' }); ``` -#### 应用管理 +#### Application Management ```typescript -// 创建应用 +// Create application await provider.createApp('MyApp', 'ios'); -// 列出应用 +// List applications await provider.listApps('ios'); -// 获取当前应用 +// Get current application const { appId, platform } = await provider.getSelectedApp('ios'); ``` -#### 版本管理 +#### Version Management ```typescript -// 列出版本 +// List versions await provider.listVersions('app123'); -// 更新版本 +// Update version await provider.updateVersion('app123', 'version456', { name: 'v1.1.0', description: 'New features' }); ``` -#### 工具函数 +#### Utility Functions ```typescript -// 获取平台 +// Get platform const platform = await provider.getPlatform('ios'); -// 加载会话 +// Load session const session = await provider.loadSession(); ``` -### 🎯 使用场景 +### 🎯 Use Cases -#### 1. 自动化构建脚本 +#### 1. Automated Build Scripts ```typescript import { moduleManager } from 'react-native-update-cli'; async function buildAndPublish() { const provider = moduleManager.getProvider(); - // 1. 打包 + // 1. Bundle const bundleResult = await provider.bundle({ platform: 'ios', dev: false, @@ -418,10 +420,10 @@ async function buildAndPublish() { }); if (!bundleResult.success) { - throw new Error(`打包失败: ${bundleResult.error}`); + throw new Error(`Bundle failed: ${bundleResult.error}`); } - // 2. 发布 + // 2. Publish const publishResult = await provider.publish({ name: 'v1.2.3', description: 'Bug fixes and performance improvements', @@ -429,14 +431,14 @@ async function buildAndPublish() { }); if (!publishResult.success) { - throw new Error(`发布失败: ${publishResult.error}`); + throw new Error(`Publish failed: ${publishResult.error}`); } - console.log('构建和发布完成！'); + console.log('Build and publish completed!'); } ``` -#### 2. CI/CD集成 +#### 2. CI/CD Integration ```typescript async function ciBuild() { const provider = moduleManager.getProvider(); @@ -451,20 +453,20 @@ async function ciBuild() { } ``` -#### 3. 应用管理服务 +#### 3. Application Management Service ```typescript class AppManagementService { private provider = moduleManager.getProvider(); async setupNewApp(name: string, platform: Platform) { - // 创建应用 + // Create application const createResult = await this.provider.createApp(name, platform); if (createResult.success) { - // 获取应用信息 + // Get application information const { appId } = await this.provider.getSelectedApp(platform); - // 列出版本 + // List versions await this.provider.listVersions(appId); return { appId, success: true }; @@ -475,21 +477,21 @@ class AppManagementService { } ``` -### ⚠️ 注意事项 +### ⚠️ Important Notes -1. **错误处理**: 所有Provider方法都返回`CommandResult`，需要检查`success`字段 -2. **类型安全**: Provider提供完整的TypeScript类型支持 -3. **会话管理**: 使用前确保已登录，可通过`loadSession()`检查 -4. **平台支持**: 支持`'ios' | 'android' | 'harmony'`三个平台 +1. **Error Handling**: All Provider methods return `CommandResult`, need to check the `success` field +2. **Type Safety**: Provider provides complete TypeScript type support +3. **Session Management**: Ensure login before use, can check via `loadSession()` +4. **Platform Support**: Supports `'ios' | 'android' | 'harmony'` three platforms -### 🔧 高级功能 +### 🔧 Advanced Features -#### 自定义工作流 +#### Custom Workflows ```typescript -// 注册自定义工作流 +// Register custom workflow provider.registerWorkflow({ name: 'quick-release', - description: '快速发布流程', + description: 'Quick release process', steps: [ { name: 'bundle', @@ -501,7 +503,7 @@ provider.registerWorkflow({ name: 'publish', execute: async (context, bundleResult) => { if (!bundleResult.success) { - throw new Error('打包失败，无法发布'); + throw new Error('Bundle failed, cannot publish'); } return await provider.publish({ name: 'auto-release', rollout: 50 }); } @@ -509,11 +511,11 @@ provider.registerWorkflow({ ] }); -// 执行工作流 +// Execute workflow await provider.executeWorkflow('quick-release', { args: [], options: {} }); ``` -### 📚 完整示例 +### 📚 Complete Example ```typescript import { moduleManager } from 'react-native-update-cli'; @@ -522,13 +524,13 @@ class ReactNativeUpdateService { private provider = moduleManager.getProvider(); async initialize() { - // 加载会话 + // Load session await this.provider.loadSession(); } async buildAndDeploy(platform: Platform, version: string) { try { - // 1. 打包 + // 1. Bundle const bundleResult = await this.provider.bundle({ platform, dev: false, @@ -536,10 +538,10 @@ class ReactNativeUpdateService { }); if (!bundleResult.success) { - throw new Error(`打包失败: ${bundleResult.error}`); + throw new Error(`Bundle failed: ${bundleResult.error}`); } - // 2. 发布 + // 2. Publish const publishResult = await this.provider.publish({ name: version, description: `Release ${version}`, @@ -547,7 +549,7 @@ class ReactNativeUpdateService { }); if (!publishResult.success) { - throw new Error(`发布失败: ${publishResult.error}`); + throw new Error(`Publish failed: ${publishResult.error}`); } return { success: true, data: publishResult.data }; @@ -568,7 +570,7 @@ class ReactNativeUpdateService { } } -// 使用示例 +// Usage example const service = new ReactNativeUpdateService(); await service.initialize(); await service.buildAndDeploy('ios', 'v1.0.0'); diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..cc9c9b2 --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,575 @@ +# React Native Update CLI - 模块化版本 + +这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 + +## 🚀 新特性 + +- **模块化架构**: 将CLI功能拆分为独立的模块 +- **自定义工作流**: 支持创建自定义的发布流程 +- **可扩展性**: 用户可以导入和注册自定义模块 +- **类型安全**: 完整的TypeScript类型支持 +- **向后兼容**: 保持与现有CLI的兼容性 + +## 📦 安装 + +```bash +npm install react-native-update-cli +``` + +## 🎯 快速开始 + +### 基本使用 + +```bash +# 使用模块化CLI +npx pushy-modular help + +# 列出所有可用命令和工作流 +npx pushy-modular list + +# 执行内置的工作流 +npx pushy-modular workflow setup-app + +# 执行自定义工作流 +npx pushy-modular workflow custom-publish +``` + +### 编程方式使用 + +```typescript +import { moduleManager, CLIProviderImpl } from 'react-native-update-cli'; + +// 获取CLI提供者 +const provider = moduleManager.getProvider(); + +// 执行打包 +const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +const publishResult = await provider.publish({ + name: 'v1.2.3', + description: 'Bug fixes and improvements', + rollout: 100 +}); +``` + +## 🔧 创建自定义模块 + +### 1. 定义模块 + +```typescript +import type { CLIModule, CommandDefinition, CustomWorkflow } from 'react-native-update-cli'; + +export const myCustomModule: CLIModule = { + name: 'my-custom', + version: '1.0.0', + + commands: [ + { + name: 'custom-command', + description: 'My custom command', + handler: async (context) => { + console.log('Executing custom command...'); + return { + success: true, + data: { message: 'Custom command executed' } + }; + }, + options: { + param: { hasValue: true, description: 'Custom parameter' } + } + } + ], + + workflows: [ + { + name: 'my-workflow', + description: 'My custom workflow', + steps: [ + { + name: 'step1', + description: 'First step', + execute: async (context, previousResult) => { + console.log('Executing step 1...'); + return { step1Completed: true }; + } + }, + { + name: 'step2', + description: 'Second step', + execute: async (context, previousResult) => { + console.log('Executing step 2...'); + return { ...previousResult, step2Completed: true }; + } + } + ] + } + ], + + init: (provider) => { + console.log('Custom module initialized'); + }, + + cleanup: () => { + console.log('Custom module cleanup'); + } +}; +``` + +### 2. 注册模块 + +```typescript +import { moduleManager } from 'react-native-update-cli'; +import { myCustomModule } from './my-custom-module'; + +// 注册自定义模块 +moduleManager.registerModule(myCustomModule); + +// 执行自定义命令 +const result = await moduleManager.executeCommand('custom-command', { + args: [], + options: { param: 'value' } +}); + +// 执行自定义工作流 +const workflowResult = await moduleManager.executeWorkflow('my-workflow', { + args: [], + options: {} +}); +``` + +## 🔄 工作流系统 + +### 工作流步骤 + +每个工作流步骤包含： + +- `name`: 步骤名称 +- `description`: 步骤描述 +- `execute`: 执行函数 +- `condition`: 可选的条件函数 + +### 条件执行 + +```typescript +{ + name: 'conditional-step', + description: 'Only execute in production', + execute: async (context, previousResult) => { + // 执行逻辑 + }, + condition: (context) => { + return context.options.environment === 'production'; + } +} +``` + +### 工作流验证 + +```typescript +{ + name: 'validated-workflow', + description: 'Workflow with validation', + steps: [...], + validate: (context) => { + if (!context.options.requiredParam) { + console.error('Required parameter missing'); + return false; + } + return true; + } +} +``` + +## 📋 内置模块 + +### Bundle模块 (`bundle`) +- `bundle`: 打包JavaScript代码并可选发布 +- `diff`: 生成两个PPK文件之间的差异 +- `hdiff`: 生成两个PPK文件之间的hdiff +- `diffFromApk`: 从APK文件生成差异 +- `hdiffFromApk`: 从APK文件生成hdiff +- `hdiffFromApp`: 从APP文件生成hdiff +- `diffFromIpa`: 从IPA文件生成差异 +- `hdiffFromIpa`: 从IPA文件生成hdiff + +### Version模块 (`version`) +- `publish`: 发布新版本 +- `versions`: 列出所有版本 +- `update`: 更新版本信息 +- `updateVersionInfo`: 更新版本元数据 + +### App模块 (`app`) +- `createApp`: 创建新应用 +- `apps`: 列出所有应用 +- `selectApp`: 选择应用 +- `deleteApp`: 删除应用 + +### Package模块 (`package`) +- `uploadIpa`: 上传IPA文件 +- `uploadApk`: 上传APK文件 +- `uploadApp`: 上传APP文件 +- `parseApp`: 解析APP文件信息 +- `parseIpa`: 解析IPA文件信息 +- `parseApk`: 解析APK文件信息 +- `packages`: 列出包 + +### User模块 (`user`) +- `login`: 登录 +- `logout`: 登出 +- `me`: 显示用户信息 + +## 🛠️ CLI提供者API + +### 核心功能 + +```typescript +interface CLIProvider { + // 打包 + bundle(options: BundleOptions): Promise; + + // 发布 + publish(options: PublishOptions): Promise; + + // 上传 + upload(options: UploadOptions): Promise; + + // 应用管理 + getSelectedApp(platform?: Platform): Promise<{ appId: string; platform: Platform }>; + listApps(platform?: Platform): Promise; + createApp(name: string, platform: Platform): Promise; + + // 版本管理 + listVersions(appId: string): Promise; + getVersion(appId: string, versionId: string): Promise; + updateVersion(appId: string, versionId: string, updates: Partial): Promise; + + // 包管理 + listPackages(appId: string, platform?: Platform): Promise; + getPackage(appId: string, packageId: string): Promise; + + // 工具函数 + getPlatform(platform?: Platform): Promise; + loadSession(): Promise; + saveToLocal(key: string, value: string): void; + question(prompt: string): Promise; + + // 工作流 + registerWorkflow(workflow: CustomWorkflow): void; + executeWorkflow(workflowName: string, context: CommandContext): Promise; +} +``` + +### 自定义命令 + +```typescript +// 执行自定义打包命令 +const bundleResult = await moduleManager.executeCommand('custom-bundle', { + args: [], + options: { + platform: 'android', + validate: true, + optimize: true + } +}); + +// 生成差异文件 +const diffResult = await moduleManager.executeCommand('diff', { + args: [], + options: { + origin: './build/v1.0.0.ppk', + next: './build/v1.1.0.ppk', + output: './build/diff.patch' + } +}); + +// 从APK文件生成差异 +const apkDiffResult = await moduleManager.executeCommand('diffFromApk', { + args: [], + options: { + origin: './build/app-v1.0.0.apk', + next: './build/app-v1.1.0.apk', + output: './build/apk-diff.patch' + } +}); +``` + +## 🔧 配置 + +### 环境变量 + +```bash +# 设置API端点 +export PUSHY_REGISTRY=https://your-api-endpoint.com + +# 设置非交互模式 +export NO_INTERACTIVE=true +``` + +### 配置文件 + +创建 `update.json` 文件： + +```json +{ + "ios": { + "appId": "your-ios-app-id", + "appKey": "your-ios-app-key" + }, + "android": { + "appId": "your-android-app-id", + "appKey": "your-android-app-key" + } +} +``` + +## 🚨 注意事项 + +1. **向后兼容**: 新的模块化CLI保持与现有CLI的兼容性 +2. **类型安全**: 所有API都有完整的TypeScript类型定义 +3. **错误处理**: 所有操作都返回标准化的结果格式 +4. **资源清理**: 模块支持清理函数来释放资源 +5. **模块分离**: 功能按逻辑分离到不同模块中，便于维护和扩展 + +## 🤝 贡献 + +欢迎提交Issue和Pull Request来改进这个项目！ + +## 🚀 Provider API 使用指南 + +Provider提供了简洁的编程接口，适合在应用程序中集成React Native Update CLI功能。 + +### 📋 核心API方法 + +#### 核心业务功能 +```typescript +// 打包应用 +await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +await provider.publish({ + name: 'v1.0.0', + description: 'Bug fixes', + rollout: 100 +}); + +// 上传文件 +await provider.upload({ + filePath: 'app.ipa', + platform: 'ios' +}); +``` + +#### 应用管理 +```typescript +// 创建应用 +await provider.createApp('MyApp', 'ios'); + +// 列出应用 +await provider.listApps('ios'); + +// 获取当前应用 +const { appId, platform } = await provider.getSelectedApp('ios'); +``` + +#### 版本管理 +```typescript +// 列出版本 +await provider.listVersions('app123'); + +// 更新版本 +await provider.updateVersion('app123', 'version456', { + name: 'v1.1.0', + description: 'New features' +}); +``` + +#### 工具函数 +```typescript +// 获取平台 +const platform = await provider.getPlatform('ios'); + +// 加载会话 +const session = await provider.loadSession(); +``` + +### 🎯 使用场景 + +#### 1. 自动化构建脚本 +```typescript +import { moduleManager } from 'react-native-update-cli'; + +async function buildAndPublish() { + const provider = moduleManager.getProvider(); + + // 1. 打包 + const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true + }); + + if (!bundleResult.success) { + throw new Error(`打包失败: ${bundleResult.error}`); + } + + // 2. 发布 + const publishResult = await provider.publish({ + name: 'v1.2.3', + description: 'Bug fixes and performance improvements', + rollout: 100 + }); + + if (!publishResult.success) { + throw new Error(`发布失败: ${publishResult.error}`); + } + + console.log('构建和发布完成！'); +} +``` + +#### 2. CI/CD集成 +```typescript +async function ciBuild() { + const provider = moduleManager.getProvider(); + + const result = await provider.bundle({ + platform: process.env.PLATFORM as 'ios' | 'android', + dev: process.env.NODE_ENV !== 'production', + sourcemap: process.env.NODE_ENV === 'production' + }); + + return result; +} +``` + +#### 3. 应用管理服务 +```typescript +class AppManagementService { + private provider = moduleManager.getProvider(); + + async setupNewApp(name: string, platform: Platform) { + // 创建应用 + const createResult = await this.provider.createApp(name, platform); + + if (createResult.success) { + // 获取应用信息 + const { appId } = await this.provider.getSelectedApp(platform); + + // 列出版本 + await this.provider.listVersions(appId); + + return { appId, success: true }; + } + + return { success: false, error: createResult.error }; + } +} +``` + +### ⚠️ 注意事项 + +1. **错误处理**: 所有Provider方法都返回`CommandResult`，需要检查`success`字段 +2. **类型安全**: Provider提供完整的TypeScript类型支持 +3. **会话管理**: 使用前确保已登录，可通过`loadSession()`检查 +4. **平台支持**: 支持`'ios' | 'android' | 'harmony'`三个平台 + +### 🔧 高级功能 + +#### 自定义工作流 +```typescript +// 注册自定义工作流 +provider.registerWorkflow({ + name: 'quick-release', + description: '快速发布流程', + steps: [ + { + name: 'bundle', + execute: async () => { + return await provider.bundle({ platform: 'ios', dev: false }); + } + }, + { + name: 'publish', + execute: async (context, bundleResult) => { + if (!bundleResult.success) { + throw new Error('打包失败，无法发布'); + } + return await provider.publish({ name: 'auto-release', rollout: 50 }); + } + } + ] +}); + +// 执行工作流 +await provider.executeWorkflow('quick-release', { args: [], options: {} }); +``` + +### 📚 完整示例 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +class ReactNativeUpdateService { + private provider = moduleManager.getProvider(); + + async initialize() { + // 加载会话 + await this.provider.loadSession(); + } + + async buildAndDeploy(platform: Platform, version: string) { + try { + // 1. 打包 + const bundleResult = await this.provider.bundle({ + platform, + dev: false, + sourcemap: true + }); + + if (!bundleResult.success) { + throw new Error(`打包失败: ${bundleResult.error}`); + } + + // 2. 发布 + const publishResult = await this.provider.publish({ + name: version, + description: `Release ${version}`, + rollout: 100 + }); + + if (!publishResult.success) { + throw new Error(`发布失败: ${publishResult.error}`); + } + + return { success: true, data: publishResult.data }; + + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : 'Unknown error' + }; + } + } + + async getAppInfo(platform: Platform) { + const { appId } = await this.provider.getSelectedApp(platform); + const versions = await this.provider.listVersions(appId); + + return { appId, versions }; + } +} + +// 使用示例 +const service = new ReactNativeUpdateService(); +await service.initialize(); +await service.buildAndDeploy('ios', 'v1.0.0'); +``` \ No newline at end of file diff --git a/example/README.md b/example/README.md index 4c7788b..26c4ca0 100644 --- a/example/README.md +++ b/example/README.md @@ -1,115 +1,117 @@ -# 自定义模块和工作流示例 +# Custom Modules and Workflows Examples -这个目录包含了 React Native Update CLI 自定义模块和工作流的完整示例，演示如何扩展 CLI 的功能。 +[中文文档](./README.zh-CN.md) | [Chinese Documentation](./README.zh-CN.md) -## 📁 目录结构 +This directory contains complete examples of React Native Update CLI custom modules and workflows, demonstrating how to extend the CLI functionality. + +## 📁 Directory Structure ``` example/ -├── modules/ # 自定义模块示例 -│ ├── custom-deploy-module.ts # 自定义部署模块 -│ └── analytics-module.ts # 分析统计模块 -├── workflows/ # 自定义工作流示例 -│ └── custom-workflows.ts # 复杂工作流集合 -├── scripts/ # 执行脚本示例 -│ ├── register-modules.ts # 模块注册和执行 -│ ├── provider-api-example.ts # Provider API 使用示例 -│ └── workflow-demo.ts # 工作流演示脚本 -└── README.md # 本文档 +├── modules/ # Custom module examples +│ ├── custom-deploy-module.ts # Custom deployment module +│ └── analytics-module.ts # Analytics module +├── workflows/ # Custom workflow examples +│ └── custom-workflows.ts # Complex workflow collection +├── scripts/ # Execution script examples +│ ├── register-modules.ts # Module registration and execution +│ ├── provider-api-example.ts # Provider API usage examples +│ └── workflow-demo.ts # Workflow demonstration script +└── README.md # This documentation ``` -## 🚀 快速开始 +## 🚀 Quick Start -### 1. 运行模块注册和执行示例 +### 1. Run Module Registration and Execution Examples ```bash -# 编译TypeScript (如果需要) +# Compile TypeScript (if needed) npm run build -# 运行模块示例 +# Run module examples npx ts-node example/scripts/register-modules.ts ``` -### 2. 运行Provider API示例 +### 2. Run Provider API Examples ```bash npx ts-node example/scripts/provider-api-example.ts ``` -### 3. 运行工作流演示 +### 3. Run Workflow Demonstrations ```bash -# 运行所有工作流演示 +# Run all workflow demonstrations npx ts-node example/scripts/workflow-demo.ts -# 交互式执行特定工作流 +# Interactive execution of specific workflows npx ts-node example/scripts/workflow-demo.ts interactive canary-deployment --version 1.0.0 --initialRollout 5 -# 多环境部署工作流 +# Multi-environment deployment workflow npx ts-node example/scripts/workflow-demo.ts interactive multi-env-deploy --version 1.0.0 -# 回滚工作流 +# Rollback workflow npx ts-node example/scripts/workflow-demo.ts interactive rollback-workflow --targetVersion 0.9.5 ``` -## 📦 自定义模块示例 +## 📦 Custom Module Examples -### 1. 自定义部署模块 (`custom-deploy-module.ts`) +### 1. Custom Deployment Module (`custom-deploy-module.ts`) -这个模块演示了如何创建一个完整的部署管理模块，包含： +This module demonstrates how to create a complete deployment management module, including: -#### 命令： -- `deploy-dev`: 部署到开发环境 -- `deploy-prod`: 部署到生产环境 -- `rollback`: 回滚到指定版本 +#### Commands: +- `deploy-dev`: Deploy to development environment +- `deploy-prod`: Deploy to production environment +- `rollback`: Rollback to specified version -#### 工作流： -- `full-deploy`: 完整部署流程（开发 → 测试 → 生产） -- `hotfix-deploy`: 热修复快速部署流程 +#### Workflows: +- `full-deploy`: Complete deployment process (development → testing → production) +- `hotfix-deploy`: Quick hotfix deployment process -#### 使用示例： +#### Usage Example: ```typescript import { moduleManager } from 'react-native-update-cli'; import { customDeployModule } from './modules/custom-deploy-module'; -// 注册模块 +// Register module moduleManager.registerModule(customDeployModule); -// 执行开发部署 +// Execute development deployment await moduleManager.executeCommand('deploy-dev', { args: [], options: { platform: 'ios', force: true } }); -// 执行完整部署工作流 +// Execute complete deployment workflow await moduleManager.executeWorkflow('full-deploy', { args: [], options: { version: '1.2.3' } }); ``` -### 2. 分析统计模块 (`analytics-module.ts`) +### 2. Analytics Module (`analytics-module.ts`) -演示如何创建分析和统计功能： +Demonstrates how to create analytics and statistics functionality: -#### 命令： -- `track-deployment`: 记录部署统计信息 -- `deployment-report`: 生成部署报告 +#### Commands: +- `track-deployment`: Record deployment statistics +- `deployment-report`: Generate deployment reports -#### 工作流： -- `deploy-with-analytics`: 带统计的部署流程 +#### Workflows: +- `deploy-with-analytics`: Deployment process with analytics -## 🔄 自定义工作流示例 +## 🔄 Custom Workflow Examples -### 1. 灰度发布工作流 (`canary-deployment`) +### 1. Canary Deployment Workflow (`canary-deployment`) -实现完整的灰度发布流程： +Implements a complete canary deployment process: -- ✅ 准备灰度发布环境 -- ✅ 初始小范围部署 -- ✅ 监控关键指标 -- ✅ 基于指标自动扩大发布范围 -- ✅ 最终验证 +- ✅ Prepare canary deployment environment +- ✅ Initial small-scale deployment +- ✅ Monitor key metrics +- ✅ Automatically expand deployment based on metrics +- ✅ Final validation ```typescript await moduleManager.executeWorkflow('canary-deployment', { @@ -122,16 +124,16 @@ await moduleManager.executeWorkflow('canary-deployment', { }); ``` -### 2. 多环境发布工作流 (`multi-env-deploy`) +### 2. Multi-Environment Deployment Workflow (`multi-env-deploy`) -实现标准的多环境发布流程： +Implements a standard multi-environment deployment process: -- ✅ 部署到开发环境 -- ✅ 运行集成测试 -- ✅ 部署到预发布环境 -- ✅ 运行端到端测试 -- ✅ 部署到生产环境 -- ✅ 部署后验证 +- ✅ Deploy to development environment +- ✅ Run integration tests +- ✅ Deploy to staging environment +- ✅ Run end-to-end tests +- ✅ Deploy to production environment +- ✅ Post-deployment validation ```typescript await moduleManager.executeWorkflow('multi-env-deploy', { @@ -144,15 +146,15 @@ await moduleManager.executeWorkflow('multi-env-deploy', { }); ``` -### 3. 回滚工作流 (`rollback-workflow`) +### 3. Rollback Workflow (`rollback-workflow`) -安全的应用回滚流程： +Safe application rollback process: -- ✅ 验证目标版本 -- ✅ 备份当前状态 -- ✅ 执行回滚操作 -- ✅ 验证回滚结果 -- ✅ 通知相关人员 +- ✅ Validate target version +- ✅ Backup current state +- ✅ Execute rollback operation +- ✅ Verify rollback results +- ✅ Notify relevant personnel ```typescript await moduleManager.executeWorkflow('rollback-workflow', { @@ -164,70 +166,70 @@ await moduleManager.executeWorkflow('rollback-workflow', { }); ``` -## 🛠️ Provider API 使用示例 +## 🛠️ Provider API Usage Examples -Provider API 提供了编程式接口，适合在应用程序中集成： +Provider API provides programmatic interfaces suitable for integration in applications: -### 基本使用 +### Basic Usage ```typescript import { moduleManager } from 'react-native-update-cli'; const provider = moduleManager.getProvider(); -// 打包应用 +// Bundle application const bundleResult = await provider.bundle({ platform: 'ios', dev: false, sourcemap: true }); -// 发布版本 +// Publish version const publishResult = await provider.publish({ name: 'v1.0.0', description: 'Bug fixes', rollout: 100 }); -// 上传文件 +// Upload file const uploadResult = await provider.upload({ filePath: 'app.ipa', platform: 'ios' }); ``` -### 应用管理 +### Application Management ```typescript -// 创建应用 +// Create application await provider.createApp('MyApp', 'ios'); -// 获取当前应用 +// Get current application const { appId, platform } = await provider.getSelectedApp('ios'); -// 列出版本 +// List versions const versions = await provider.listVersions(appId); -// 更新版本 +// Update version await provider.updateVersion(appId, versionId, { name: 'v1.1.0', description: 'New features' }); ``` -### 自动化服务类 +### Automation Service Class ```typescript class DeploymentService { private provider = moduleManager.getProvider(); async buildAndPublish(platform: Platform, version: string) { - // 1. 打包 + // 1. Bundle const bundleResult = await this.provider.bundle({ platform, dev: false, sourcemap: true }); - // 2. 发布 + // 2. Publish const publishResult = await this.provider.publish({ name: version, rollout: 100 }); @@ -237,9 +239,9 @@ class DeploymentService { } ``` -## 🎯 高级特性 +## 🎯 Advanced Features -### 1. 工作流验证 +### 1. Workflow Validation ```typescript const workflow: CustomWorkflow = { @@ -247,7 +249,7 @@ const workflow: CustomWorkflow = { steps: [...], validate: (context) => { if (!context.options.version) { - console.error('必须指定版本号'); + console.error('Version number must be specified'); return false; } return true; @@ -255,7 +257,7 @@ const workflow: CustomWorkflow = { }; ``` -### 2. 条件执行 +### 2. Conditional Execution ```typescript const step: WorkflowStep = { @@ -267,67 +269,67 @@ const step: WorkflowStep = { }; ``` -### 3. 错误处理 +### 3. Error Handling ```typescript try { const result = await moduleManager.executeCommand('deploy-prod', { args: [], - options: {} // 缺少必需参数 + options: {} // Missing required parameters }); } catch (error) { - console.error('执行失败:', error.message); + console.error('Execution failed:', error.message); } ``` -### 4. 自定义工作流注册 +### 4. Custom Workflow Registration ```typescript const provider = moduleManager.getProvider(); provider.registerWorkflow({ name: 'custom-workflow', - description: '自定义工作流', + description: 'Custom workflow', steps: [ { name: 'step1', execute: async (context, previousResult) => { - // 执行逻辑 + // Execution logic return { step1: 'completed' }; } } ] }); -// 执行工作流 +// Execute workflow await provider.executeWorkflow('custom-workflow', { args: [], options: {} }); ``` -## 📝 最佳实践 +## 📝 Best Practices -### 1. 模块设计 +### 1. Module Design -- **单一职责**: 每个模块专注于特定功能领域 -- **清晰命名**: 使用描述性的命令和选项名称 -- **完整文档**: 为所有命令和选项提供描述 -- **错误处理**: 提供清晰的错误信息和恢复建议 +- **Single Responsibility**: Each module focuses on specific functional domains +- **Clear Naming**: Use descriptive command and option names +- **Complete Documentation**: Provide descriptions for all commands and options +- **Error Handling**: Provide clear error messages and recovery suggestions -### 2. 工作流设计 +### 2. Workflow Design -- **原子操作**: 每个步骤应该是原子的，可独立执行 -- **状态传递**: 合理使用 previousResult 传递状态 -- **错误恢复**: 考虑失败时的清理和恢复机制 -- **进度反馈**: 提供清晰的进度信息给用户 +- **Atomic Operations**: Each step should be atomic and independently executable +- **State Passing**: Properly use previousResult to pass state +- **Error Recovery**: Consider cleanup and recovery mechanisms for failures +- **Progress Feedback**: Provide clear progress information to users -### 3. 开发建议 +### 3. Development Recommendations -- **类型安全**: 充分利用 TypeScript 类型系统 -- **测试覆盖**: 为自定义模块编写测试 -- **文档维护**: 保持示例和文档的同步更新 -- **版本管理**: 为模块设置合适的版本号 +- **Type Safety**: Make full use of the TypeScript type system +- **Test Coverage**: Write tests for custom modules +- **Documentation Maintenance**: Keep examples and documentation synchronized +- **Version Management**: Set appropriate version numbers for modules ## 🐛 故障排除 @@ -344,31 +346,31 @@ await provider.executeWorkflow('custom-workflow', { }; ``` -2. **命令执行失败** +2. **Command Execution Failed** ```typescript - // 检查命令名称和参数 + // Check command name and parameters await moduleManager.executeCommand('correct-command-name', { args: [], options: { requiredParam: 'value' } }); ``` -3. **工作流验证失败** +3. **Workflow Validation Failed** ```typescript - // 确保提供所有必需的选项 + // Ensure all required options are provided await moduleManager.executeWorkflow('workflow-name', { args: [], - options: { version: '1.0.0' } // 必需参数 + options: { version: '1.0.0' } // Required parameter }); ``` -## 📖 相关文档 +## 📖 Related Documentation -- [主项目 README](../README.md) -- [模块化架构文档](../docs/architecture.md) -- [API 参考文档](../docs/api-reference.md) -- [贡献指南](../CONTRIBUTING.md) +- [Main Project README](../README.md) +- [Modular Architecture Documentation](../docs/architecture.md) +- [API Reference Documentation](../docs/api-reference.md) +- [Contributing Guide](../CONTRIBUTING.md) -## 🤝 贡献 +## 🤝 Contributing -欢迎提交更多示例和改进建议！请查看主项目的贡献指南。 \ No newline at end of file +Welcome to submit more examples and improvement suggestions! Please check the main project's contributing guide. \ No newline at end of file diff --git a/example/README.zh-CN.md b/example/README.zh-CN.md new file mode 100644 index 0000000..4c7788b --- /dev/null +++ b/example/README.zh-CN.md @@ -0,0 +1,374 @@ +# 自定义模块和工作流示例 + +这个目录包含了 React Native Update CLI 自定义模块和工作流的完整示例，演示如何扩展 CLI 的功能。 + +## 📁 目录结构 + +``` +example/ +├── modules/ # 自定义模块示例 +│ ├── custom-deploy-module.ts # 自定义部署模块 +│ └── analytics-module.ts # 分析统计模块 +├── workflows/ # 自定义工作流示例 +│ └── custom-workflows.ts # 复杂工作流集合 +├── scripts/ # 执行脚本示例 +│ ├── register-modules.ts # 模块注册和执行 +│ ├── provider-api-example.ts # Provider API 使用示例 +│ └── workflow-demo.ts # 工作流演示脚本 +└── README.md # 本文档 +``` + +## 🚀 快速开始 + +### 1. 运行模块注册和执行示例 + +```bash +# 编译TypeScript (如果需要) +npm run build + +# 运行模块示例 +npx ts-node example/scripts/register-modules.ts +``` + +### 2. 运行Provider API示例 + +```bash +npx ts-node example/scripts/provider-api-example.ts +``` + +### 3. 运行工作流演示 + +```bash +# 运行所有工作流演示 +npx ts-node example/scripts/workflow-demo.ts + +# 交互式执行特定工作流 +npx ts-node example/scripts/workflow-demo.ts interactive canary-deployment --version 1.0.0 --initialRollout 5 + +# 多环境部署工作流 +npx ts-node example/scripts/workflow-demo.ts interactive multi-env-deploy --version 1.0.0 + +# 回滚工作流 +npx ts-node example/scripts/workflow-demo.ts interactive rollback-workflow --targetVersion 0.9.5 +``` + +## 📦 自定义模块示例 + +### 1. 自定义部署模块 (`custom-deploy-module.ts`) + +这个模块演示了如何创建一个完整的部署管理模块，包含： + +#### 命令： +- `deploy-dev`: 部署到开发环境 +- `deploy-prod`: 部署到生产环境 +- `rollback`: 回滚到指定版本 + +#### 工作流： +- `full-deploy`: 完整部署流程（开发 → 测试 → 生产） +- `hotfix-deploy`: 热修复快速部署流程 + +#### 使用示例： +```typescript +import { moduleManager } from 'react-native-update-cli'; +import { customDeployModule } from './modules/custom-deploy-module'; + +// 注册模块 +moduleManager.registerModule(customDeployModule); + +// 执行开发部署 +await moduleManager.executeCommand('deploy-dev', { + args: [], + options: { platform: 'ios', force: true } +}); + +// 执行完整部署工作流 +await moduleManager.executeWorkflow('full-deploy', { + args: [], + options: { version: '1.2.3' } +}); +``` + +### 2. 分析统计模块 (`analytics-module.ts`) + +演示如何创建分析和统计功能： + +#### 命令： +- `track-deployment`: 记录部署统计信息 +- `deployment-report`: 生成部署报告 + +#### 工作流： +- `deploy-with-analytics`: 带统计的部署流程 + +## 🔄 自定义工作流示例 + +### 1. 灰度发布工作流 (`canary-deployment`) + +实现完整的灰度发布流程： + +- ✅ 准备灰度发布环境 +- ✅ 初始小范围部署 +- ✅ 监控关键指标 +- ✅ 基于指标自动扩大发布范围 +- ✅ 最终验证 + +```typescript +await moduleManager.executeWorkflow('canary-deployment', { + args: [], + options: { + version: '2.1.0', + initialRollout: 10, // 初始10%用户 + autoExpand: true // 自动扩大范围 + } +}); +``` + +### 2. 多环境发布工作流 (`multi-env-deploy`) + +实现标准的多环境发布流程： + +- ✅ 部署到开发环境 +- ✅ 运行集成测试 +- ✅ 部署到预发布环境 +- ✅ 运行端到端测试 +- ✅ 部署到生产环境 +- ✅ 部署后验证 + +```typescript +await moduleManager.executeWorkflow('multi-env-deploy', { + args: [], + options: { + version: '2.1.0', + skipProduction: false, // 不跳过生产部署 + forceProduction: false // 测试失败时不强制部署 + } +}); +``` + +### 3. 回滚工作流 (`rollback-workflow`) + +安全的应用回滚流程： + +- ✅ 验证目标版本 +- ✅ 备份当前状态 +- ✅ 执行回滚操作 +- ✅ 验证回滚结果 +- ✅ 通知相关人员 + +```typescript +await moduleManager.executeWorkflow('rollback-workflow', { + args: [], + options: { + targetVersion: '2.0.5', + skipVerification: false + } +}); +``` + +## 🛠️ Provider API 使用示例 + +Provider API 提供了编程式接口，适合在应用程序中集成： + +### 基本使用 + +```typescript +import { moduleManager } from 'react-native-update-cli'; + +const provider = moduleManager.getProvider(); + +// 打包应用 +const bundleResult = await provider.bundle({ + platform: 'ios', + dev: false, + sourcemap: true +}); + +// 发布版本 +const publishResult = await provider.publish({ + name: 'v1.0.0', + description: 'Bug fixes', + rollout: 100 +}); + +// 上传文件 +const uploadResult = await provider.upload({ + filePath: 'app.ipa', + platform: 'ios' +}); +``` + +### 应用管理 + +```typescript +// 创建应用 +await provider.createApp('MyApp', 'ios'); + +// 获取当前应用 +const { appId, platform } = await provider.getSelectedApp('ios'); + +// 列出版本 +const versions = await provider.listVersions(appId); + +// 更新版本 +await provider.updateVersion(appId, versionId, { + name: 'v1.1.0', + description: 'New features' +}); +``` + +### 自动化服务类 + +```typescript +class DeploymentService { + private provider = moduleManager.getProvider(); + + async buildAndPublish(platform: Platform, version: string) { + // 1. 打包 + const bundleResult = await this.provider.bundle({ + platform, dev: false, sourcemap: true + }); + + // 2. 发布 + const publishResult = await this.provider.publish({ + name: version, rollout: 100 + }); + + return { bundleResult, publishResult }; + } +} +``` + +## 🎯 高级特性 + +### 1. 工作流验证 + +```typescript +const workflow: CustomWorkflow = { + name: 'my-workflow', + steps: [...], + validate: (context) => { + if (!context.options.version) { + console.error('必须指定版本号'); + return false; + } + return true; + } +}; +``` + +### 2. 条件执行 + +```typescript +const step: WorkflowStep = { + name: 'conditional-step', + execute: async (context) => { /* ... */ }, + condition: (context) => { + return context.options.environment === 'production'; + } +}; +``` + +### 3. 错误处理 + +```typescript +try { + const result = await moduleManager.executeCommand('deploy-prod', { + args: [], + options: {} // 缺少必需参数 + }); +} catch (error) { + console.error('执行失败:', error.message); +} +``` + +### 4. 自定义工作流注册 + +```typescript +const provider = moduleManager.getProvider(); + +provider.registerWorkflow({ + name: 'custom-workflow', + description: '自定义工作流', + steps: [ + { + name: 'step1', + execute: async (context, previousResult) => { + // 执行逻辑 + return { step1: 'completed' }; + } + } + ] +}); + +// 执行工作流 +await provider.executeWorkflow('custom-workflow', { + args: [], + options: {} +}); +``` + +## 📝 最佳实践 + +### 1. 模块设计 + +- **单一职责**: 每个模块专注于特定功能领域 +- **清晰命名**: 使用描述性的命令和选项名称 +- **完整文档**: 为所有命令和选项提供描述 +- **错误处理**: 提供清晰的错误信息和恢复建议 + +### 2. 工作流设计 + +- **原子操作**: 每个步骤应该是原子的，可独立执行 +- **状态传递**: 合理使用 previousResult 传递状态 +- **错误恢复**: 考虑失败时的清理和恢复机制 +- **进度反馈**: 提供清晰的进度信息给用户 + +### 3. 开发建议 + +- **类型安全**: 充分利用 TypeScript 类型系统 +- **测试覆盖**: 为自定义模块编写测试 +- **文档维护**: 保持示例和文档的同步更新 +- **版本管理**: 为模块设置合适的版本号 + +## 🐛 故障排除 + +### 常见问题 + +1. **模块注册失败** + ```typescript + // 确保模块符合 CLIModule 接口 + const module: CLIModule = { + name: 'my-module', + version: '1.0.0', + commands: [...], + workflows: [...] + }; + ``` + +2. **命令执行失败** + ```typescript + // 检查命令名称和参数 + await moduleManager.executeCommand('correct-command-name', { + args: [], + options: { requiredParam: 'value' } + }); + ``` + +3. **工作流验证失败** + ```typescript + // 确保提供所有必需的选项 + await moduleManager.executeWorkflow('workflow-name', { + args: [], + options: { version: '1.0.0' } // 必需参数 + }); + ``` + +## 📖 相关文档 + +- [主项目 README](../README.md) +- [模块化架构文档](../docs/architecture.md) +- [API 参考文档](../docs/api-reference.md) +- [贡献指南](../CONTRIBUTING.md) + +## 🤝 贡献 + +欢迎提交更多示例和改进建议！请查看主项目的贡献指南。 \ No newline at end of file From 0439620d296c2478d7cce965343fad2fec345e43 Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Mon, 21 Jul 2025 09:58:40 +0800 Subject: [PATCH 20/21] udpate version --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 6e1d5bd..aa846b3 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "react-native-update-cli", - "version": "1.46.4", + "version": "1.46.2", "description": "command line tool for react-native-update (remote updates for react native)", "main": "index.js", "bin": { From 626df043fcdf5b405d016fd584f902c82e47460a Mon Sep 17 00:00:00 2001 From: HeYanbo Date: Thu, 24 Jul 2025 08:10:33 +0800 Subject: [PATCH 21/21] change logic to use pushy command uniformly --- README.md | 19 ++-- README.zh-CN.md | 19 ++-- package.json | 3 +- src/index.ts | 125 ++++++++++++++++++++++-- src/modular-index.ts | 114 ---------------------- src/modules/app-module.ts | 120 +---------------------- src/modules/bundle-module.ts | 177 +--------------------------------- src/modules/package-module.ts | 150 +--------------------------- src/modules/user-module.ts | 63 +----------- src/modules/version-module.ts | 134 +------------------------ 10 files changed, 146 insertions(+), 778 deletions(-) delete mode 100644 src/modular-index.ts diff --git a/README.md b/README.md index e0af85b..0fe2325 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,17 @@ -# React Native Update CLI - Modular Version +# React Native Update CLI [中文文档](./README.zh-CN.md) | [Chinese Documentation](./README.zh-CN.md) -This is a refactored React Native Update CLI that supports modular architecture and custom publishing workflows. +A unified React Native Update CLI that supports both traditional commands and modular architecture with custom publishing workflows. -## 🚀 New Features +## 🚀 Features +- **Unified CLI**: Single `pushy` command for all functionality +- **Backward Compatibility**: All existing commands work as before - **Modular Architecture**: Split CLI functionality into independent modules - **Custom Workflows**: Support for creating custom publishing workflows - **Extensibility**: Users can import and register custom modules - **Type Safety**: Complete TypeScript type support -- **Backward Compatibility**: Maintains compatibility with existing CLI ## 📦 Installation @@ -23,17 +24,17 @@ npm install react-native-update-cli ### Basic Usage ```bash -# Use modular CLI -npx pushy-modular help +# Use unified CLI +npx pushy help # List all available commands and workflows -npx pushy-modular list +npx pushy list # Execute built-in workflow -npx pushy-modular workflow setup-app +npx pushy workflow setup-app # Execute custom workflow -npx pushy-modular workflow custom-publish +npx pushy workflow custom-publish ``` ### Programmatic Usage diff --git a/README.zh-CN.md b/README.zh-CN.md index cc9c9b2..6b3b141 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,14 +1,15 @@ -# React Native Update CLI - 模块化版本 +# React Native Update CLI -这是一个重构后的React Native Update CLI，支持模块化架构和自定义发布流程。 +这是一个统一的React Native Update CLI，同时支持传统命令和模块化架构以及自定义发布流程。 -## 🚀 新特性 +## 🚀 特性 +- **统一CLI**: 使用单个`pushy`命令提供所有功能 +- **向后兼容**: 所有现有命令都能正常工作 - **模块化架构**: 将CLI功能拆分为独立的模块 - **自定义工作流**: 支持创建自定义的发布流程 - **可扩展性**: 用户可以导入和注册自定义模块 - **类型安全**: 完整的TypeScript类型支持 -- **向后兼容**: 保持与现有CLI的兼容性 ## 📦 安装 @@ -21,17 +22,17 @@ npm install react-native-update-cli ### 基本使用 ```bash -# 使用模块化CLI -npx pushy-modular help +# 使用统一CLI +npx pushy help # 列出所有可用命令和工作流 -npx pushy-modular list +npx pushy list # 执行内置的工作流 -npx pushy-modular workflow setup-app +npx pushy workflow setup-app # 执行自定义工作流 -npx pushy-modular workflow custom-publish +npx pushy workflow custom-publish ``` ### 编程方式使用 diff --git a/package.json b/package.json index aa846b3..20b4482 100644 --- a/package.json +++ b/package.json @@ -5,8 +5,7 @@ "main": "index.js", "bin": { "pushy": "lib/index.js", - "cresc": "lib/index.js", - "pushy-modular": "lib/modular-index.js" + "cresc": "lib/index.js" }, "files": ["lib", "src", "cli.json"], "scripts": { diff --git a/src/index.ts b/src/index.ts index 4028f2f..cdc60c0 100644 --- a/src/index.ts +++ b/src/index.ts @@ -3,20 +3,74 @@ import { loadSession } from './api'; import { appCommands } from './app'; import { bundleCommands } from './bundle'; +import { moduleManager } from './module-manager'; +import { builtinModules } from './modules'; import { packageCommands } from './package'; +import type { CommandContext } from './types'; import { userCommands } from './user'; import { printVersionCommand } from './utils'; import { t } from './utils/i18n'; import { versionCommands } from './versions'; +function registerBuiltinModules() { + for (const module of builtinModules) { + try { + moduleManager.registerModule(module); + } catch (error) { + console.error(`Failed to register module ${module.name}:`, error); + } + } +} + function printUsage() { + console.log('React Native Update CLI'); + console.log(''); + console.log('Traditional commands:'); + + const legacyCommands = { + ...userCommands, + ...bundleCommands, + ...appCommands, + ...packageCommands, + ...versionCommands, + }; + + for (const [name, handler] of Object.entries(legacyCommands)) { + console.log(` ${name}: Legacy command`); + } + + console.log(''); + console.log('Modular commands:'); + const commands = moduleManager.getRegisteredCommands(); + for (const command of commands) { + console.log( + ` ${command.name}: ${command.description || 'No description'}`, + ); + } + + console.log(''); + console.log('Available workflows:'); + const workflows = moduleManager.getRegisteredWorkflows(); + for (const workflow of workflows) { + console.log( + ` ${workflow.name}: ${workflow.description || 'No description'}`, + ); + } + + console.log(''); + console.log('Special commands:'); + console.log(' list: List all available commands and workflows'); + console.log(' workflow : Execute a specific workflow'); + console.log(' help: Show this help message'); + + console.log(''); console.log( 'Visit `https://github.com/reactnativecn/react-native-update` for document.', ); process.exit(1); } -const commands = { +const legacyCommands = { ...userCommands, ...bundleCommands, ...appCommands, @@ -31,20 +85,71 @@ async function run() { process.exit(); } + // Register builtin modules for modular functionality + registerBuiltinModules(); + const argv = require('cli-arguments').parse(require('../cli.json')); global.NO_INTERACTIVE = argv.options['no-interactive']; global.USE_ACC_OSS = argv.options.acc; - loadSession() - .then(() => commands[argv.command](argv)) - .catch((err) => { - if (err.status === 401) { - console.log(t('loginFirst')); - return; + const context: CommandContext = { + args: argv.args || [], + options: argv.options || {}, + }; + + try { + await loadSession(); + context.session = require('./api').getSession(); + + // Handle special modular commands first + if (argv.command === 'help') { + printUsage(); + } else if (argv.command === 'list') { + moduleManager.listAll(); + } else if (argv.command === 'workflow') { + const workflowName = argv.args[0]; + if (!workflowName) { + console.error('Workflow name is required'); + process.exit(1); } - console.error(err.stack); - process.exit(-1); - }); + const result = await moduleManager.executeWorkflow(workflowName, context); + if (!result.success) { + console.error('Workflow execution failed:', result.error); + process.exit(1); + } + console.log('Workflow completed successfully:', result.data); + } + // Try legacy commands first for backward compatibility + else if (legacyCommands[argv.command]) { + await legacyCommands[argv.command](argv); + } + // Fall back to modular commands + else { + const result = await moduleManager.executeCommand(argv.command, context); + if (!result.success) { + console.error('Command execution failed:', result.error); + process.exit(1); + } + console.log('Command completed successfully:', result.data); + } + } catch (err: any) { + if (err.status === 401) { + console.log(t('loginFirst')); + return; + } + console.error(err.stack); + process.exit(-1); + } } +export { moduleManager }; +export { CLIProviderImpl } from './provider'; +export type { + CLIProvider, + CLIModule, + CommandDefinition, + CustomWorkflow, + WorkflowStep, +} from './types'; + run(); diff --git a/src/modular-index.ts b/src/modular-index.ts deleted file mode 100644 index edd6626..0000000 --- a/src/modular-index.ts +++ /dev/null @@ -1,114 +0,0 @@ -#!/usr/bin/env node - -import { loadSession } from './api'; -import { moduleManager } from './module-manager'; -import { builtinModules } from './modules'; -import type { CommandContext } from './types'; -import { printVersionCommand } from './utils'; -import { t } from './utils/i18n'; - -function registerBuiltinModules() { - for (const module of builtinModules) { - try { - moduleManager.registerModule(module); - } catch (error) { - console.error(`Failed to register module ${module.name}:`, error); - } - } -} - -function printUsage() { - console.log('React Native Update CLI - Modular Version'); - console.log(''); - console.log('Available commands:'); - - const commands = moduleManager.getRegisteredCommands(); - for (const command of commands) { - console.log( - ` ${command.name}: ${command.description || 'No description'}`, - ); - } - - console.log(''); - console.log('Available workflows:'); - const workflows = moduleManager.getRegisteredWorkflows(); - for (const workflow of workflows) { - console.log( - ` ${workflow.name}: ${workflow.description || 'No description'}`, - ); - } - - console.log(''); - console.log( - 'Visit `https://github.com/reactnativecn/react-native-update` for document.', - ); - process.exit(1); -} - -async function run() { - await printVersionCommand(); - - if (process.argv.indexOf('-v') >= 0 || process.argv[2] === 'version') { - process.exit(); - } - registerBuiltinModules(); - - const argv = require('cli-arguments').parse(require('../cli.json')); - global.NO_INTERACTIVE = argv.options['no-interactive']; - global.USE_ACC_OSS = argv.options.acc; - - const context: CommandContext = { - args: argv.args || [], - options: argv.options || {}, - }; - - try { - await loadSession(); - context.session = require('./api').getSession(); - if (argv.command === 'help') { - printUsage(); - } else if (argv.command === 'list') { - moduleManager.listAll(); - } else if (argv.command === 'workflow') { - const workflowName = argv.args[0]; - if (!workflowName) { - console.error('Workflow name is required'); - process.exit(1); - } - const result = await moduleManager.executeWorkflow(workflowName, context); - if (!result.success) { - console.error('Workflow execution failed:', result.error); - process.exit(1); - } - console.log('Workflow completed successfully:', result.data); - } else { - const result = await moduleManager.executeCommand(argv.command, context); - if (!result.success) { - console.error('Command execution failed:', result.error); - process.exit(1); - } - console.log('Command completed successfully:', result.data); - } - } catch (err: any) { - if (err.status === 401) { - console.log(t('loginFirst')); - return; - } - console.error(err.stack); - process.exit(-1); - } -} - -export { moduleManager }; -export { CLIProviderImpl } from './provider'; -export type { - CLIProvider, - CLIModule, - CommandDefinition, - CustomWorkflow, - WorkflowStep, -} from './types'; - -if (require.main === module) { - run(); -} diff --git a/src/modules/app-module.ts b/src/modules/app-module.ts index f6f166c..c0bb20a 100644 --- a/src/modules/app-module.ts +++ b/src/modules/app-module.ts @@ -1,127 +1,11 @@ import { appCommands } from '../app'; -import type { CLIModule, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext } from '../types'; export const appModule: CLIModule = { name: 'app', version: '1.0.0', - commands: [ - { - name: 'createApp', - description: 'Create a new app', - handler: async (context: CommandContext): Promise => { - try { - const { name, downloadUrl, platform } = context.options; - console.log('Creating app with options:', { - name, - downloadUrl, - platform, - }); - await appCommands.createApp({ - options: { name, downloadUrl, platform }, - }); - return { - success: true, - data: { message: 'App created successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Create app failed', - }; - } - }, - options: { - name: { hasValue: true, description: 'App name' }, - platform: { hasValue: true, description: 'Target platform' }, - downloadUrl: { hasValue: true, description: 'Download URL' }, - }, - }, - { - name: 'apps', - description: 'List all apps', - handler: async (context: CommandContext): Promise => { - try { - console.log('Listing apps for platform:', context.options.platform); - await appCommands.apps({ - options: { platform: context.options.platform }, - }); - return { - success: true, - data: { message: 'Apps listed successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'List apps failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - }, - }, - { - name: 'selectApp', - description: 'Select an app', - handler: async (context: CommandContext): Promise => { - try { - console.log( - 'Selecting app with args:', - context.args, - 'options:', - context.options, - ); - await appCommands.selectApp({ - args: context.args, - options: { platform: context.options.platform }, - }); - return { - success: true, - data: { message: 'App selected successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Select app failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - }, - }, - { - name: 'deleteApp', - description: 'Delete an app', - handler: async (context: CommandContext): Promise => { - try { - console.log( - 'Deleting app with args:', - context.args, - 'options:', - context.options, - ); - await appCommands.deleteApp({ - args: context.args, - options: { platform: context.options.platform }, - }); - return { - success: true, - data: { message: 'App deleted successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Delete app failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - }, - }, - ], + commands: [], workflows: [ { diff --git a/src/modules/bundle-module.ts b/src/modules/bundle-module.ts index 9cd5f21..930f9dd 100644 --- a/src/modules/bundle-module.ts +++ b/src/modules/bundle-module.ts @@ -1,184 +1,11 @@ import { bundleCommands } from '../bundle'; -import type { CLIModule, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext } from '../types'; export const bundleModule: CLIModule = { name: 'bundle', version: '1.0.0', - commands: [ - { - name: 'bundle', - description: 'Bundle javascript code and optionally publish', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.bundle(context); - return { - success: true, - data: { message: 'Bundle created successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Bundle failed', - }; - } - }, - options: { - dev: { - hasValue: true, - default: 'false', - description: 'Development mode', - }, - platform: { hasValue: true, description: 'Target platform' }, - bundleName: { - hasValue: true, - default: 'index.bundlejs', - description: 'Bundle file name', - }, - entryFile: { - hasValue: true, - default: 'index.js', - description: 'Entry file', - }, - intermediaDir: { - hasValue: true, - default: '${tempDir}/intermedia/${platform}', - description: 'Intermediate directory', - }, - output: { - hasValue: true, - default: '${tempDir}/output/${platform}.${time}.ppk', - description: 'Output file path', - }, - sourcemap: { default: false, description: 'Generate sourcemap' }, - taro: { default: false, description: 'Use Taro CLI' }, - expo: { default: false, description: 'Use Expo CLI' }, - rncli: { default: false, description: 'Use React Native CLI' }, - disableHermes: { default: false, description: 'Disable Hermes' }, - name: { hasValue: true, description: 'Version name for publishing' }, - description: { - hasValue: true, - description: 'Version description for publishing', - }, - metaInfo: { - hasValue: true, - description: 'Meta information for publishing', - }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { - hasValue: true, - description: 'Minimum package version', - }, - maxPackageVersion: { - hasValue: true, - description: 'Maximum package version', - }, - packageVersionRange: { - hasValue: true, - description: 'Package version range', - }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' }, - }, - }, - { - name: 'diff', - description: 'Generate diff between two PPK files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.diff(context); - return { - success: true, - data: { message: 'Diff generated successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'Diff generation failed', - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original PPK file path' }, - next: { hasValue: true, description: 'New PPK file path' }, - output: { hasValue: true, description: 'Output diff file path' }, - }, - }, - { - name: 'diffFromApk', - description: 'Generate diff from APK files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.diffFromApk(context); - return { - success: true, - data: { message: 'Diff from APK generated successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'Diff from APK failed', - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original APK file path' }, - next: { hasValue: true, description: 'New APK file path' }, - output: { hasValue: true, description: 'Output diff file path' }, - }, - }, - { - name: 'diffFromApp', - description: 'Generate hdiff from APP files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.diffFromApp(context); - return { - success: true, - data: { message: 'HDiff from APP generated successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'HDiff from APP failed', - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original APP file path' }, - next: { hasValue: true, description: 'New APP file path' }, - output: { hasValue: true, description: 'Output hdiff file path' }, - }, - }, - { - name: 'diffFromIpa', - description: 'Generate diff from IPA files', - handler: async (context: CommandContext): Promise => { - try { - await bundleCommands.diffFromIpa(context); - return { - success: true, - data: { message: 'Diff from IPA generated successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'Diff from IPA failed', - }; - } - }, - options: { - origin: { hasValue: true, description: 'Original IPA file path' }, - next: { hasValue: true, description: 'New IPA file path' }, - output: { hasValue: true, description: 'Output diff file path' }, - }, - }, - ], + commands: [], workflows: [ { diff --git a/src/modules/package-module.ts b/src/modules/package-module.ts index d46a1c9..9201caa 100644 --- a/src/modules/package-module.ts +++ b/src/modules/package-module.ts @@ -1,157 +1,11 @@ import { packageCommands } from '../package'; -import type { CLIModule, CommandContext, CommandResult } from '../types'; +import type { CLIModule } from '../types'; export const packageModule: CLIModule = { name: 'package', version: '1.0.0', - commands: [ - { - name: 'uploadIpa', - description: 'Upload IPA file', - handler: async (context: CommandContext): Promise => { - try { - console.log('Uploading IPA file:', context.args[0]); - await packageCommands.uploadIpa(context); - return { - success: true, - data: { message: 'IPA uploaded successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Upload IPA failed', - }; - } - }, - }, - { - name: 'uploadApk', - description: 'Upload APK file', - handler: async (context: CommandContext): Promise => { - try { - console.log('Uploading APK file:', context.args[0]); - await packageCommands.uploadApk(context); - return { - success: true, - data: { message: 'APK uploaded successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Upload APK failed', - }; - } - }, - }, - { - name: 'uploadApp', - description: 'Upload APP file', - handler: async (context: CommandContext): Promise => { - try { - console.log('Uploading APP file:', context.args[0]); - await packageCommands.uploadApp(context); - return { - success: true, - data: { message: 'APP uploaded successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Upload APP failed', - }; - } - }, - }, - { - name: 'parseApp', - description: 'Parse APP file information', - handler: async (context: CommandContext): Promise => { - try { - console.log('Parsing APP file:', context.args[0]); - await packageCommands.parseApp(context); - return { - success: true, - data: { message: 'APP file parsed successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Parse APP failed', - }; - } - }, - }, - { - name: 'parseIpa', - description: 'Parse IPA file information', - handler: async (context: CommandContext): Promise => { - try { - console.log('Parsing IPA file:', context.args[0]); - await packageCommands.parseIpa(context); - return { - success: true, - data: { message: 'IPA file parsed successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Parse IPA failed', - }; - } - }, - }, - { - name: 'parseApk', - description: 'Parse APK file information', - handler: async (context: CommandContext): Promise => { - try { - console.log('Parsing APK file:', context.args[0]); - await packageCommands.parseApk(context); - return { - success: true, - data: { message: 'APK file parsed successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Parse APK failed', - }; - } - }, - }, - { - name: 'packages', - description: 'List packages', - handler: async (context: CommandContext): Promise => { - try { - if (!context.options.platform) { - throw new Error('Platform option is required'); - } - console.log( - 'Listing packages for platform:', - context.options.platform, - ); - await packageCommands.packages({ - options: { platform: context.options.platform }, - }); - return { - success: true, - data: { message: 'Packages listed successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'List packages failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - }, - }, - ], + commands: [], workflows: [], }; diff --git a/src/modules/user-module.ts b/src/modules/user-module.ts index 709283b..4fe394c 100644 --- a/src/modules/user-module.ts +++ b/src/modules/user-module.ts @@ -1,71 +1,12 @@ import { getSession, loadSession } from '../api'; -import type { CLIModule, CommandContext, CommandResult } from '../types'; +import type { CLIModule, CommandContext } from '../types'; import { userCommands } from '../user'; export const userModule: CLIModule = { name: 'user', version: '1.0.0', - commands: [ - { - name: 'login', - description: 'Login to the service', - handler: async (context: CommandContext): Promise => { - try { - console.log('Logging in user'); - await userCommands.login(context); - return { - success: true, - data: { message: 'Login successful' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Login failed', - }; - } - }, - }, - { - name: 'logout', - description: 'Logout from the service', - handler: async (context: CommandContext): Promise => { - try { - console.log('Logging out user'); - await userCommands.logout(context); - return { - success: true, - data: { message: 'Logout successful' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Logout failed', - }; - } - }, - }, - { - name: 'me', - description: 'Show current user information', - handler: async (context: CommandContext): Promise => { - try { - console.log('Getting user information'); - await userCommands.me(); - return { - success: true, - data: { message: 'User information retrieved successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'Get user info failed', - }; - } - }, - }, - ], + commands: [], workflows: [ { diff --git a/src/modules/version-module.ts b/src/modules/version-module.ts index ce0a3a9..1352ba2 100644 --- a/src/modules/version-module.ts +++ b/src/modules/version-module.ts @@ -1,138 +1,8 @@ -import type { CLIModule, CommandContext, CommandResult } from '../types'; -import { versionCommands } from '../versions'; +import type { CLIModule} from '../types'; export const versionModule: CLIModule = { name: 'version', version: '1.0.0', - commands: [ - { - name: 'publish', - description: 'Publish a new version', - handler: async (context: CommandContext): Promise => { - try { - await versionCommands.publish(context); - return { - success: true, - data: { message: 'Version published successfully' }, - }; - } catch (error) { - return { - success: false, - error: error instanceof Error ? error.message : 'Publish failed', - }; - } - }, - options: { - name: { hasValue: true, description: 'Version name' }, - description: { hasValue: true, description: 'Version description' }, - metaInfo: { hasValue: true, description: 'Meta information' }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { - hasValue: true, - description: 'Minimum package version', - }, - maxPackageVersion: { - hasValue: true, - description: 'Maximum package version', - }, - packageVersionRange: { - hasValue: true, - description: 'Package version range', - }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' }, - }, - }, - { - name: 'versions', - description: 'List all versions', - handler: async (context: CommandContext): Promise => { - try { - await versionCommands.versions(context); - return { - success: true, - data: { message: 'Versions listed successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'List versions failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - }, - }, - { - name: 'update', - description: 'Update version information', - handler: async (context: CommandContext): Promise => { - try { - await versionCommands.update(context); - return { - success: true, - data: { message: 'Version updated successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error ? error.message : 'Update version failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - versionId: { hasValue: true, description: 'Version ID' }, - packageId: { hasValue: true, description: 'Package ID' }, - packageVersion: { hasValue: true, description: 'Package version' }, - minPackageVersion: { - hasValue: true, - description: 'Minimum package version', - }, - maxPackageVersion: { - hasValue: true, - description: 'Maximum package version', - }, - packageVersionRange: { - hasValue: true, - description: 'Package version range', - }, - rollout: { hasValue: true, description: 'Rollout percentage' }, - dryRun: { default: false, description: 'Dry run mode' }, - }, - }, - { - name: 'updateVersionInfo', - description: 'Update version metadata', - handler: async (context: CommandContext): Promise => { - try { - await versionCommands.updateVersionInfo(context); - return { - success: true, - data: { message: 'Version info updated successfully' }, - }; - } catch (error) { - return { - success: false, - error: - error instanceof Error - ? error.message - : 'Update version info failed', - }; - } - }, - options: { - platform: { hasValue: true, description: 'Target platform' }, - versionId: { hasValue: true, description: 'Version ID' }, - name: { hasValue: true, description: 'Version name' }, - description: { hasValue: true, description: 'Version description' }, - metaInfo: { hasValue: true, description: 'Meta information' }, - }, - }, - ], + commands: [], workflows: [], };