rn-update-cli 1.0.0

package/lib/exports.d.ts

@@ -0,0 +1,11 @@
+/**
+ * [INPUT]: 依赖 CLI 会话、应用、差分、发布 Provider、公共类型与交互工具模块
+ * [OUTPUT]: 对外提供包级公共 API，维持命令扩展和宿主集成所需的稳定导出面
+ * [POS]: CLI 公共出口，只聚合已定义的能力，不承载业务逻辑或状态
+ */
+export { getSession, loadSession } from './api';
+export { getPlatform, getSelectedApp } from './app';
+export { diffCommands } from './diff';
+export { CLIProviderImpl } from './provider';
+export type { BundleOptions, CLIProvider, CommandContext, CommandResult, Package, Platform, PublishOptions, Session, UploadOptions, Version, } from './types';
+export { question } from './utils';

package/lib/exports.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * [INPUT]: 依赖 CLI 会话、应用、差分、发布 Provider、公共类型与交互工具模块
+ * [OUTPUT]: 对外提供包级公共 API，维持命令扩展和宿主集成所需的稳定导出面
+ * [POS]: CLI 公共出口，只聚合已定义的能力，不承载业务逻辑或状态
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.question = exports.CLIProviderImpl = exports.diffCommands = exports.getSelectedApp = exports.getPlatform = exports.loadSession = exports.getSession = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "getSession", { enumerable: true, get: function () { return api_1.getSession; } });
+Object.defineProperty(exports, "loadSession", { enumerable: true, get: function () { return api_1.loadSession; } });
+var app_1 = require("./app");
+Object.defineProperty(exports, "getPlatform", { enumerable: true, get: function () { return app_1.getPlatform; } });
+Object.defineProperty(exports, "getSelectedApp", { enumerable: true, get: function () { return app_1.getSelectedApp; } });
+var diff_1 = require("./diff");
+Object.defineProperty(exports, "diffCommands", { enumerable: true, get: function () { return diff_1.diffCommands; } });
+var provider_1 = require("./provider");
+Object.defineProperty(exports, "CLIProviderImpl", { enumerable: true, get: function () { return provider_1.CLIProviderImpl; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "question", { enumerable: true, get: function () { return utils_1.question; } });

package/lib/install.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [INPUT]: 依赖子进程、命令上下文、Pakta CLI 常量、本地化文案与包管理器运行时探测
+ * [OUTPUT]: 对外提供 installCommands，生成并执行依赖安装命令
+ * [POS]: CLI 依赖安装命令边界，校验包参数并委托当前包管理器，不直接修改发布模型
+ */
+import type { CommandContext } from './types';
+export declare const installCommands: {
+    install: ({ args }: CommandContext) => Promise<void>;
+};

package/lib/install.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * [INPUT]: 依赖子进程、命令上下文、Pakta CLI 常量、本地化文案与包管理器运行时探测
+ * [OUTPUT]: 对外提供 installCommands，生成并执行依赖安装命令
+ * [POS]: CLI 依赖安装命令边界，校验包参数并委托当前包管理器，不直接修改发布模型
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installCommands = void 0;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("./utils/constants");
+const i18n_1 = require("./utils/i18n");
+const runtime_1 = require("./utils/runtime");
+// package names / version specs only — rejects shell metacharacters since
+// Windows needs shell: true to run package manager .cmd shims
+const SAFE_PACKAGE_ARG = /^[@a-z0-9^~._/-]+$/i;
+exports.installCommands = {
+    install: async ({ args }) => {
+        if (args.length === 0) {
+            throw new Error((0, i18n_1.t)('installPackageRequired', { scriptName: constants_1.scriptName }));
+        }
+        for (const arg of args) {
+            if (!SAFE_PACKAGE_ARG.test(arg)) {
+                throw new Error((0, i18n_1.t)('installPackageRequired', { scriptName: constants_1.scriptName }));
+            }
+        }
+        const cliDir = path_1.default.resolve(__dirname, '..');
+        const installCommand = (0, runtime_1.getInstallCommand)(args, cliDir);
+        const result = (0, child_process_1.spawnSync)(installCommand.command, installCommand.args, {
+            cwd: cliDir,
+            stdio: 'inherit',
+            // package manager executables are .cmd shims on Windows
+            shell: process.platform === 'win32',
+        });
+        if (result.error) {
+            throw new Error((0, i18n_1.t)('installFailed', {
+                packages: args.join(' '),
+                error: result.error.message,
+            }));
+        }
+        if (result.status !== 0) {
+            throw new Error((0, i18n_1.t)('installFailed', {
+                packages: args.join(' '),
+                error: `${installCommand.command} exited with code ${result.status}`,
+            }));
+        }
+    },
+};

package/lib/locales/en.d.ts

@@ -0,0 +1,187 @@
+/**
+ * [INPUT]: 依赖 CLI i18n 键与英文产品术语
+ * [OUTPUT]: 对外提供 pakta 默认英文文案，含渠道自动创建、原生版本组重复与 JS 冲突提示
+ * [POS]: locales 英文资源事实源，与 zh.ts 保持键集合对称，不参与上传裁决
+ */
+declare const _default: {
+    addedToGitignore: string;
+    androidCrunchPngsWarning: string;
+    aabOpenApksFailed: string;
+    aabReadUniversalApkFailed: string;
+    aabUniversalApkNotFound: string;
+    aabBundletoolDownloadHint: string;
+    aabManifestNotFound: string;
+    aabParseResourcesWarning: string;
+    aabParseFailed: string;
+    aabParseManifestError: string;
+    aabParseResourcesError: string;
+    appId: string;
+    appIdMismatchApk: string;
+    appIdMismatchApp: string;
+    appIdMismatchIpa: string;
+    appKeyMismatchApk: string;
+    appKeyMismatchApp: string;
+    appKeyMismatchIpa: string;
+    appName: string;
+    appNameQuestion: string;
+    appPlatformMismatch: string;
+    appNotSelected: string;
+    appUploadSuccess: string;
+    autoUpdatePermission: string;
+    autoUpdateSuccess: string;
+    apkUploadSuccess: string;
+    boundTo: string;
+    buildTimeNotFound: string;
+    bundleCommandError: string;
+    bundleNotFound: string;
+    bundlingWithRN: string;
+    cancelled: string;
+    composingSourceMap: string;
+    copyingDebugId: string;
+    createAppSuccess: string;
+    channelAutoCreated: string;
+    deleteFile: string;
+    enterAppIdQuestion: string;
+    enterNativePackageId: string;
+    expiredStatus: string;
+    failedToParseUpdateJson: string;
+    fileGenerated: string;
+    fileSizeExceeded: string;
+    forceHermes: string;
+    hermesEnabledCompiling: string;
+    ipaUploadSuccess: string;
+    latestVersionTag: string;
+    lockBestPractice: string;
+    lockNotFound: string;
+    loggedOut: string;
+    loginExpired: string;
+    loginFirst: string;
+    multipleLocksFound: string;
+    nativePackageId: string;
+    nativeVersion: string;
+    nativeVersionNotFoundGte: string;
+    nativeVersionNotFoundLte: string;
+    nativeVersionNotFoundBetween: string;
+    conflictingPackageSelectors: string;
+    nativeVersionNotFoundMatch: string;
+    nativeVersionAlreadyRegistered: string;
+    nativeVersionBundleConflict: string;
+    nativePackageIdNotFound: string;
+    noPackagesFound: string;
+    offset: string;
+    operationComplete: string;
+    operationSuccess: string;
+    packageIdRequired: string;
+    standaloneTargetRequired: string;
+    packageUploadSuccess: string;
+    depsChangeWarningTitle: string;
+    depsChangeSummary: string;
+    depsChangeTargetPackage: string;
+    depsChangeDependencyHeader: string;
+    depsChangeVersionHeader: string;
+    depsChangeAddedLabel: string;
+    depsChangeRemovedLabel: string;
+    depsChangeChangedLabel: string;
+    depsChangeArrow: string;
+    depsChangeRiskWarning: string;
+    depsChangeFetchFailed: string;
+    depsChangeNonBlockingHint: string;
+    packing: string;
+    pausedStatus: string;
+    platform: string;
+    platformQuestion: string;
+    pluginDetectionError: string;
+    pluginDetected: string;
+    publishUsage: string;
+    sourceMapNotFound: string;
+    sourceMapMissingWarning: string;
+    sourceMapArchived: string;
+    sourceMapAlreadyArchivedWarning: string;
+    sourceMapUploadFailedWarning: string;
+    symbolicateUsage: string;
+    symbolicateVersionNotFound: string;
+    symbolicateNoSourceMap: string;
+    symbolicateDone: string;
+    rnuVersionNotFound: string;
+    rolloutConfigSet: string;
+    rolloutRangeError: string;
+    runningHermesc: string;
+    hermesSourcemapKept: string;
+    sentryReactNativeNotFound: string;
+    sentryCliNotFound: string;
+    sentryReleaseCreated: string;
+    totalApps: string;
+    totalPackages: string;
+    unsupportedPlatform: string;
+    uploadBundlePrompt: string;
+    uploadingSourcemap: string;
+    usageDiff: string;
+    usageParseApk: string;
+    usageParseAab: string;
+    usageExtractApk: string;
+    usageParseApp: string;
+    usageParseIpa: string;
+    usageUploadApk: string;
+    usageUploadAab: string;
+    usageUploadApp: string;
+    usageUploadIpa: string;
+    versionBind: string;
+    versionIdRequired: string;
+    welcomeMessage: string;
+    versionNameQuestion: string;
+    versionDescriptionQuestion: string;
+    versionMetaInfoQuestion: string;
+    updateNativePackageQuestion: string;
+    unnamed: string;
+    dryRun: string;
+    usingCustomVersion: string;
+    confirmDeletePackage: string;
+    deletePackageSuccess: string;
+    deletePackagesSuccess: string;
+    deletePackageError: string;
+    usageDeletePackage: string;
+    deleteVersionSuccess: string;
+    deleteVersionsSuccess: string;
+    deleteVersionError: string;
+    bundleFileNotFound: string;
+    diffPackageGenerated: string;
+    nodeHdiffpatchRequired: string;
+    hbcTransformRoundTripFailed: string;
+    hbcTransformNeedsPatch: string;
+    bundleStreamNeedsHdiffpatch: string;
+    apkExtracted: string;
+    composeSourceMapsNotFound: string;
+    installPackageRequired: string;
+    installFailed: string;
+    proxyNetworkError: string;
+    proxyNetworkErrorTips: string;
+    invalidId: string;
+    outputPathRequired: string;
+    unsupportedFileType: string;
+    failedToLoadSession: string;
+    appIdRequired: string;
+    unknownCommand: string;
+    unsupportedPlatformForHermes: string;
+    invalidManifest: string;
+    failedToResolveResource: string;
+    hermesBaseNone: string;
+    hermesBaseUsing: string;
+    hermesBaseDownloading: string;
+    hermesBaseRangeFetched: string;
+    hermesBaseRangeFallback: string;
+    hermesBaseCompileFailed: string;
+    hermesBaseCompileFailedLog: string;
+    hermesBasePlainCompileFailed: string;
+    hermesBaseVerified: string;
+    hermesBaseVerifyFailed: string;
+    hermesBaseVerifyDumpFailed: string;
+    hermesBaseVerifyDumpsWritten: string;
+    cacheCleaned: string;
+    cacheStats: string;
+    loginCredentialsRequired: string;
+    bundleUnexpectedArgs: string;
+    unsafeIntermediateDir: string;
+    appKeyMissing: string;
+    errorStackHint: string;
+};
+export default _default;

package/lib/locales/en.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * [INPUT]: 依赖 CLI i18n 键与英文产品术语
+ * [OUTPUT]: 对外提供 pakta 默认英文文案，含渠道自动创建、原生版本组重复与 JS 冲突提示
+ * [POS]: locales 英文资源事实源，与 zh.ts 保持键集合对称，不参与上传裁决
+ */
+exports.default = {
+    addedToGitignore: 'Added {{line}} to .gitignore',
+    androidCrunchPngsWarning: 'The crunchPngs option of android seems not disabled (Please ignore this warning if already disabled), which may cause abnormal consumption of mobile network traffic. Please refer to https://pakta.dev/docs/getting-started#disable-crunchpngs-on-android \n',
+    aabOpenApksFailed: 'Failed to open generated .apks file',
+    aabReadUniversalApkFailed: 'Failed to read universal.apk',
+    aabUniversalApkNotFound: 'universal.apk not found in generated .apks',
+    aabBundletoolDownloadHint: 'bundletool not found. Downloading node-bundletool via npx (first run may take a while).',
+    aabManifestNotFound: "AndroidManifest.xml can't be found in AAB base/manifest/",
+    aabParseResourcesWarning: '[Warning] Failed to parse resources.arsc: {{error}}',
+    aabParseFailed: 'Failed to parse AAB: {{error}}',
+    aabParseManifestError: 'Parse AndroidManifest.xml error: {{error}}',
+    aabParseResourcesError: 'Parser resources.arsc error: {{error}}',
+    appId: 'App ID',
+    appIdMismatchApk: 'App ID mismatch! Current APK: {{appIdInPkg}}, current {{- source}}: {{appId}}',
+    appIdMismatchApp: 'App ID mismatch! Current APP: {{appIdInPkg}}, current {{- source}}: {{appId}}',
+    appIdMismatchIpa: 'App ID mismatch! Current IPA: {{appIdInPkg}}, current {{- source}}: {{appId}}',
+    appKeyMismatchApk: 'App Key mismatch! Current APK: {{appKeyInPkg}}, current {{- source}}: {{appKey}}',
+    appKeyMismatchApp: 'App Key mismatch! Current APP: {{appKeyInPkg}}, current {{- source}}: {{appKey}}',
+    appKeyMismatchIpa: 'App Key mismatch! Current IPA: {{appKeyInPkg}}, current {{- source}}: {{appKey}}',
+    appName: 'App Name',
+    appNameQuestion: 'App Name:',
+    appPlatformMismatch: 'App {{appId}} is a {{appPlatform}} app, but this command targets {{platform}}',
+    appNotSelected: 'App not selected. run `pakta selectApp --platform {{platform}}` first!',
+    appUploadSuccess: 'Successfully uploaded APP native package (id: {{id}}, version: {{version}}, buildTime: {{buildTime}})',
+    autoUpdatePermission: 'CLI auto-update was skipped because the global package directory is not writable. Fix the package-manager prefix permissions, then run: {{- command}}',
+    autoUpdateSuccess: 'CLI was automatically updated in the background: {{from}} -> {{to}}',
+    apkUploadSuccess: 'Successfully uploaded APK native package (id: {{id}}, version: {{version}}, buildTime: {{buildTime}})',
+    boundTo: ', bound to: {{name}} ({{id}})',
+    buildTimeNotFound: 'Cannot get the build timestamp of this package. Please update `rn-update` to the latest version and re-package and upload.',
+    bundleCommandError: '"react-native bundle" command exited with code {{code}}.',
+    bundleNotFound: 'Bundle file not found. Please ensure that this {{packageType}} is a release version and the bundle file name is the default `{{entryFile}}`',
+    bundlingWithRN: 'Bundling with react-native: {{version}}',
+    cancelled: 'Cancelled',
+    composingSourceMap: 'Composing source map',
+    copyingDebugId: 'Copying debugid',
+    createAppSuccess: 'App created successfully (id: {{id}})',
+    channelAutoCreated: 'Channel {{channel}} was missing and has been created',
+    deleteFile: 'Delete {{- file}}',
+    enterAppIdQuestion: 'Enter AppId:',
+    enterNativePackageId: 'Enter native package ID:',
+    expiredStatus: '(Expired)',
+    failedToParseUpdateJson: 'Failed to parse file `{{- configPath}}`. Try to remove it manually.',
+    fileGenerated: '{{- file}} generated.',
+    fileSizeExceeded: 'This file size is {{fileSize}} , exceeding the current quota {{maxSize}} . You may consider upgrading to a higher plan to increase this quota. Details can be found at: {{- pricingPageUrl}}',
+    forceHermes: 'Forcing Hermes enabled for this build',
+    hermesEnabledCompiling: 'Hermes enabled, now compiling to hermes bytecode:\n',
+    ipaUploadSuccess: 'Successfully uploaded IPA native package (id: {{id}}, version: {{version}}, buildTime: {{buildTime}})',
+    latestVersionTag: '(latest: {{version}})',
+    lockBestPractice: `
+Best practices for lock files:
+1. All members of the development team should use the same package manager to maintain a single lock file.
+2. Add the lock file to version control (but do not commit multiple lock files of different formats).
+3. Pay attention to changes in the lock file during code review.
+This can reduce the risk of inconsistent dependencies and supply chain attacks.
+`,
+    lockNotFound: 'No lock file detected, which may cause inconsistent dependencies and hot-updating issues.',
+    loggedOut: 'Logged out',
+    loginExpired: 'Login information has expired. Please use `pakta login` command to re-login',
+    loginFirst: 'Not logged in.\nPlease run `pakta login` in the project directory to login.',
+    multipleLocksFound: 'Multiple lock files detected ({{- lockFiles}}), which may cause inconsistent dependencies and hot-updating issues.',
+    nativePackageId: 'Native Package ID',
+    nativeVersion: 'Native Version',
+    nativeVersionNotFoundGte: 'No native version found >= {{version}}',
+    nativeVersionNotFoundLte: 'No native version found <= {{version}}',
+    nativeVersionNotFoundBetween: 'No native version found between {{min}} and {{max}}',
+    conflictingPackageSelectors: 'Only one of packageId / packageVersion / packageVersionRange / minPackageVersion+maxPackageVersion can be used at a time',
+    nativeVersionNotFoundMatch: 'No matching native version found: {{version}}',
+    nativeVersionAlreadyRegistered: 'Native package {{version}} is already registered with identical embedded JS; skipping duplicate upload (id: {{id}})',
+    nativeVersionBundleConflict: 'Native package {{version}} is already registered with different embedded JS. Increment the native version before uploading, or incremental update matching will become unreliable',
+    nativePackageIdNotFound: 'No native package id found: {{id}}',
+    noPackagesFound: 'No packages found. (appId: {{appId}})',
+    offset: 'Offset {{offset}}',
+    operationComplete: 'Operation complete, bound to {{count}} native versions',
+    operationSuccess: 'Operation successful',
+    packageIdRequired: 'Please provide packageId or packageVersion parameter',
+    standaloneTargetRequired: 'Standalone non-interactive publishing requires --targets, --packageId, or --packageVersion.',
+    packageUploadSuccess: 'Successfully uploaded new hot update package (id: {{id}})',
+    depsChangeWarningTitle: 'Dependency changes detected',
+    depsChangeSummary: 'Dependency changes: added {{added}}, removed {{removed}}, changed {{changed}}.',
+    depsChangeTargetPackage: 'Target native package: {{packageName}} (id: {{packageId}})',
+    depsChangeDependencyHeader: 'Dependency',
+    depsChangeVersionHeader: 'Version change',
+    depsChangeAddedLabel: 'Added',
+    depsChangeRemovedLabel: 'Removed',
+    depsChangeChangedLabel: 'Changed',
+    depsChangeArrow: '->',
+    depsChangeRiskWarning: 'Warning: if changed dependencies are pure JS modules, impact is usually low; if native code is newly introduced or changed, OTA update may cause abnormal behavior or even crashes. Test thoroughly before production release.',
+    depsChangeFetchFailed: 'Failed to fetch OTA dependency info: {{error}}',
+    depsChangeNonBlockingHint: 'This is only a dependency change warning and will not block publishing.',
+    packing: 'Packing',
+    pausedStatus: '(Paused)',
+    platform: 'Platform',
+    platformQuestion: 'Platform(ios/android/harmony):',
+    pluginDetectionError: 'error while detecting {{name}} plugin: {{error}}',
+    pluginDetected: 'detected {{name}} plugin',
+    publishUsage: 'Usage: pakta publish <ppk file> --platform ios|android|harmony',
+    sourceMapNotFound: 'Source map not found: {{path}}',
+    sourceMapMissingWarning: 'No source map was archived with this version: crashes cannot be symbolicated later. Bundle with the default --sourcemap, or pass --sourcemap <file> to publish.',
+    sourceMapArchived: 'Source map archived with version {{id}}',
+    sourceMapAlreadyArchivedWarning: 'This update hash is already registered; the new source map was not attached.',
+    sourceMapUploadFailedWarning: 'Source map upload failed ({{error}}); publishing without an archived map. Upgrade the update server to archive source maps.',
+    symbolicateUsage: 'Usage: pakta symbolicate <stack file | -> --hash <updateHash> [--platform ios|android|harmony] [--output <file>]',
+    symbolicateVersionNotFound: 'No published version with hash {{hash}} found for this app',
+    symbolicateNoSourceMap: 'Version {{id}} was published without a source map; nothing to symbolicate against',
+    symbolicateDone: 'Symbolicated {{count}} frame(s) against version {{id}} ({{hash}})',
+    rnuVersionNotFound: 'rn-update: Cannot get the version number. Please run the command in the project directory',
+    rolloutConfigSet: 'Set {{rollout}}% rollout for OTA update {{version}} on native version(s) {{versions}}',
+    rolloutRangeError: 'rollout must be an integer between 1-100',
+    runningHermesc: 'Running hermesc: {{- command}} {{- args}}',
+    hermesSourcemapKept: 'Debug info is stripped from the bytecode (like RN release builds); the Hermes sourcemap is kept at {{- file}} for symbolicating crash stacks later.',
+    sentryReactNativeNotFound: 'Cannot find @sentry/react-native, please make sure it is properly installed',
+    sentryCliNotFound: 'Cannot find Sentry CLI tool, please make sure @sentry/cli is properly installed',
+    sentryReleaseCreated: 'Sentry release created for version: {{version}}',
+    totalApps: 'Total {{count}} {{platform}} apps',
+    totalPackages: 'Total {{count}} packages',
+    unsupportedPlatform: 'Unsupported platform `{{platform}}`',
+    uploadBundlePrompt: 'Upload this bundle now?(Y/N)',
+    uploadingSourcemap: 'Uploading sourcemap',
+    usageDiff: 'Usage: pakta {{command}} <origin> <next>',
+    usageParseApk: 'Usage: pakta parseApk <apk file>',
+    usageParseAab: 'Usage: pakta parseAab <aab file>',
+    usageExtractApk: 'Usage: pakta extractApk <aab file> [--output <apk file>] [--includeAllSplits] [--splits <split names>]',
+    usageParseApp: 'Usage: pakta parseApp <app file>',
+    usageParseIpa: 'Usage: pakta parseIpa <ipa file>',
+    usageUploadApk: 'Usage: pakta uploadApk <apk file>',
+    usageUploadAab: 'Usage: pakta uploadAab <aab file> [--includeAllSplits] [--splits <split names>]',
+    usageUploadApp: 'Usage: pakta uploadApp <app file>',
+    usageUploadIpa: 'Usage: pakta uploadIpa <ipa file>',
+    versionBind: 'Bound hot update {{version}} to native version {{nativeVersion}} (id: {{id}})',
+    versionIdRequired: 'Please provide versionId in non-interactive mode.',
+    welcomeMessage: 'Welcome to Pakta hot update service, {{name}}.',
+    versionNameQuestion: 'Enter OTA update name:',
+    versionDescriptionQuestion: 'Enter OTA update description:',
+    versionMetaInfoQuestion: 'Enter custom meta info:',
+    updateNativePackageQuestion: 'Bind to native package now?(Y/N)',
+    unnamed: '(Unnamed)',
+    dryRun: 'Below is the dry-run result, no actual operation will be performed:',
+    usingCustomVersion: 'Using custom version: {{version}}',
+    confirmDeletePackage: 'Confirm delete native package {{packageId}}? This operation cannot be undone (Y/N):',
+    deletePackageSuccess: 'Native package {{packageId}} deleted successfully',
+    deletePackagesSuccess: 'Deleted {{count}} native packages: {{packageIds}}',
+    deletePackageError: 'Failed to delete native package {{packageId}}: {{error}}',
+    usageDeletePackage: 'Usage: pakta deletePackage [packageId] --packageIds [packageIds] --appId [appId]',
+    deleteVersionSuccess: 'Version {{versionId}} deleted successfully',
+    deleteVersionsSuccess: 'Deleted {{count}} OTA versions: {{versionIds}}',
+    deleteVersionError: 'Failed to delete version {{versionId}}: {{error}}',
+    bundleFileNotFound: 'Bundle file not found! Please use default bundle file name and path.',
+    diffPackageGenerated: '{{- output}} generated.',
+    nodeHdiffpatchRequired: 'This function needs "node-hdiffpatch". Please run "{{scriptName}} install node-hdiffpatch" to install',
+    hbcTransformRoundTripFailed: 'HBC transform round-trip verification failed; falling back to plain diff.',
+    hbcTransformNeedsPatch: 'hbcTransform requires patch support from node-hdiffpatch; option ignored.',
+    bundleStreamNeedsHdiffpatch: 'bundleStreamThreshold requires diffStream/patchStream from node-hdiffpatch; option ignored.',
+    apkExtracted: 'APK extracted to {{output}}',
+    composeSourceMapsNotFound: 'Cannot find react-native/scripts/compose-source-maps.js, skipping hermes sourcemap composing. The uploaded sourcemap may not match the compiled bundle.',
+    installPackageRequired: 'Please specify the package to install, e.g. "{{scriptName}} install node-hdiffpatch"',
+    installFailed: 'Failed to install {{packages}}: {{error}}',
+    proxyNetworkError: 'Network error — likely caused by a proxy/VPN. Please try disabling your proxy and retry.',
+    proxyNetworkErrorTips: 'Common fixes:\n1. Disable system proxy or VPN\n2. Check HTTP_PROXY / HTTPS_PROXY environment variables\n3. Check proxy settings in .npmrc',
+    invalidId: 'Invalid id: {{id}}',
+    outputPathRequired: 'Output path is required.',
+    unsupportedFileType: 'Unsupported file type: {{fileType}}',
+    failedToLoadSession: 'Failed to load session',
+    appIdRequired: 'appId is required',
+    unknownCommand: 'Unknown command: {{command}}',
+    unsupportedPlatformForHermes: 'Unsupported platform for Hermes: {{platform}}',
+    invalidManifest: 'Invalid manifest',
+    failedToResolveResource: 'Failed to resolve resource: {{error}}',
+    hermesBaseNone: 'Hermes base: none ({{- reason}}); compiling without -base-bytecode',
+    hermesBaseUsing: 'Hermes base: {{- source}} (HBC v{{version}})',
+    hermesBaseDownloading: 'Hermes base: downloading {{- url}}',
+    hermesBaseRangeFetched: 'Hermes base: fetched only the bundle via HTTP Range ({{fetchedKb}} KB of {{totalKb}} KB)',
+    hermesBaseRangeFallback: 'Hermes base: partial download unavailable ({{- reason}}); downloading the whole package',
+    hermesBaseCompileFailed: 'Hermes base compile failed ({{- reason}}); retrying without -base-bytecode',
+    hermesBaseCompileFailedLog: 'Hermes base: full compiler output written to {{- file}}',
+    hermesBasePlainCompileFailed: 'Hermes base: the plain compile used for verification failed ({{- reason}}); dropping the base and compiling again without it',
+    hermesBaseVerified: 'Hermes base: bytecode verified equivalent to a plain compile ({{functions}} functions)',
+    hermesBaseVerifyFailed: 'Hermes base: bytecode differs from a plain compile ({{- detail}}); dropping the base',
+    hermesBaseVerifyDumpFailed: 'Hermes base: could not compare the bytecode ({{- detail}}); dropping the base',
+    hermesBaseVerifyDumpsWritten: 'Hermes base: disassemblies written to {{- withBase}} and {{- plain}}',
+    cacheCleaned: 'Removed {{count}} cached bundle(s)',
+    cacheStats: 'Bundle cache: {{- dir}} — {{files}} file(s), {{mb}} MB',
+    loginCredentialsRequired: 'Email and password are required. Usage: {{scriptName}} login <email> <password>',
+    bundleUnexpectedArgs: 'bundle takes no positional arguments, got: {{- args}}. Boolean flags take no value; switch one off with --no-<flag> (e.g. --no-sourcemap).',
+    unsafeIntermediateDir: 'Refusing to empty {{- dir}} as the intermediate directory: it resolves to a protected or symbolic-link location. Point --intermediaDir at a dedicated build directory.',
+    appKeyMissing: 'App {{appId}} did not return a valid app key.',
+    errorStackHint: '(set RNU_DEBUG=1 to print the stack trace)',
+};

package/lib/locales/zh.d.ts

@@ -0,0 +1,187 @@
+/**
+ * [INPUT]: 依赖 CLI i18n 键与中文产品术语
+ * [OUTPUT]: 对外提供 pakta 默认中文文案，含渠道自动创建、原生版本组重复与 JS 冲突提示
+ * [POS]: locales 中文资源事实源，只表达交互语义，不参与上传裁决
+ */
+declare const _default: {
+    addedToGitignore: string;
+    androidCrunchPngsWarning: string;
+    aabOpenApksFailed: string;
+    aabReadUniversalApkFailed: string;
+    aabUniversalApkNotFound: string;
+    aabBundletoolDownloadHint: string;
+    aabManifestNotFound: string;
+    aabParseResourcesWarning: string;
+    aabParseFailed: string;
+    aabParseManifestError: string;
+    aabParseResourcesError: string;
+    appId: string;
+    appIdMismatchApk: string;
+    appIdMismatchApp: string;
+    appIdMismatchIpa: string;
+    appKeyMismatchApk: string;
+    appKeyMismatchApp: string;
+    appKeyMismatchIpa: string;
+    appName: string;
+    appNameQuestion: string;
+    appPlatformMismatch: string;
+    appNotSelected: string;
+    appUploadSuccess: string;
+    autoUpdatePermission: string;
+    autoUpdateSuccess: string;
+    apkUploadSuccess: string;
+    boundTo: string;
+    buildTimeNotFound: string;
+    bundleCommandError: string;
+    bundleNotFound: string;
+    bundlingWithRN: string;
+    cancelled: string;
+    composingSourceMap: string;
+    copyingDebugId: string;
+    createAppSuccess: string;
+    channelAutoCreated: string;
+    deleteFile: string;
+    enterAppIdQuestion: string;
+    enterNativePackageId: string;
+    expiredStatus: string;
+    failedToParseUpdateJson: string;
+    fileGenerated: string;
+    fileSizeExceeded: string;
+    forceHermes: string;
+    hermesEnabledCompiling: string;
+    ipaUploadSuccess: string;
+    latestVersionTag: string;
+    lockBestPractice: string;
+    lockNotFound: string;
+    loggedOut: string;
+    loginExpired: string;
+    loginFirst: string;
+    multipleLocksFound: string;
+    nativePackageId: string;
+    nativeVersion: string;
+    nativeVersionNotFoundGte: string;
+    nativeVersionNotFoundLte: string;
+    nativeVersionNotFoundBetween: string;
+    conflictingPackageSelectors: string;
+    nativeVersionNotFoundMatch: string;
+    nativeVersionAlreadyRegistered: string;
+    nativeVersionBundleConflict: string;
+    nativePackageIdNotFound: string;
+    noPackagesFound: string;
+    offset: string;
+    operationComplete: string;
+    operationSuccess: string;
+    packageIdRequired: string;
+    standaloneTargetRequired: string;
+    packageUploadSuccess: string;
+    depsChangeWarningTitle: string;
+    depsChangeSummary: string;
+    depsChangeTargetPackage: string;
+    depsChangeDependencyHeader: string;
+    depsChangeVersionHeader: string;
+    depsChangeAddedLabel: string;
+    depsChangeRemovedLabel: string;
+    depsChangeChangedLabel: string;
+    depsChangeArrow: string;
+    depsChangeRiskWarning: string;
+    depsChangeFetchFailed: string;
+    depsChangeNonBlockingHint: string;
+    packing: string;
+    pausedStatus: string;
+    platform: string;
+    platformQuestion: string;
+    pluginDetectionError: string;
+    pluginDetected: string;
+    sourceMapNotFound: string;
+    sourceMapMissingWarning: string;
+    sourceMapArchived: string;
+    sourceMapAlreadyArchivedWarning: string;
+    sourceMapUploadFailedWarning: string;
+    symbolicateUsage: string;
+    symbolicateVersionNotFound: string;
+    symbolicateNoSourceMap: string;
+    symbolicateDone: string;
+    publishUsage: string;
+    rnuVersionNotFound: string;
+    rolloutConfigSet: string;
+    rolloutRangeError: string;
+    runningHermesc: string;
+    hermesSourcemapKept: string;
+    sentryReactNativeNotFound: string;
+    sentryCliNotFound: string;
+    sentryReleaseCreated: string;
+    totalApps: string;
+    totalPackages: string;
+    unsupportedPlatform: string;
+    uploadBundlePrompt: string;
+    uploadingSourcemap: string;
+    usageDiff: string;
+    usageParseApk: string;
+    usageParseAab: string;
+    usageExtractApk: string;
+    usageParseApp: string;
+    usageParseIpa: string;
+    usageUploadApk: string;
+    usageUploadAab: string;
+    usageUploadApp: string;
+    usageUploadIpa: string;
+    versionBind: string;
+    versionIdRequired: string;
+    welcomeMessage: string;
+    versionNameQuestion: string;
+    versionDescriptionQuestion: string;
+    versionMetaInfoQuestion: string;
+    updateNativePackageQuestion: string;
+    unnamed: string;
+    dryRun: string;
+    usingCustomVersion: string;
+    confirmDeletePackage: string;
+    deletePackageSuccess: string;
+    deletePackagesSuccess: string;
+    deletePackageError: string;
+    usageDeletePackage: string;
+    deleteVersionSuccess: string;
+    deleteVersionsSuccess: string;
+    deleteVersionError: string;
+    bundleFileNotFound: string;
+    diffPackageGenerated: string;
+    nodeHdiffpatchRequired: string;
+    hbcTransformRoundTripFailed: string;
+    hbcTransformNeedsPatch: string;
+    bundleStreamNeedsHdiffpatch: string;
+    apkExtracted: string;
+    composeSourceMapsNotFound: string;
+    installPackageRequired: string;
+    installFailed: string;
+    proxyNetworkError: string;
+    proxyNetworkErrorTips: string;
+    invalidId: string;
+    outputPathRequired: string;
+    unsupportedFileType: string;
+    failedToLoadSession: string;
+    appIdRequired: string;
+    unknownCommand: string;
+    unsupportedPlatformForHermes: string;
+    invalidManifest: string;
+    failedToResolveResource: string;
+    hermesBaseNone: string;
+    hermesBaseUsing: string;
+    hermesBaseDownloading: string;
+    hermesBaseRangeFetched: string;
+    hermesBaseRangeFallback: string;
+    hermesBaseCompileFailed: string;
+    hermesBaseCompileFailedLog: string;
+    hermesBasePlainCompileFailed: string;
+    hermesBaseVerified: string;
+    hermesBaseVerifyFailed: string;
+    hermesBaseVerifyDumpFailed: string;
+    hermesBaseVerifyDumpsWritten: string;
+    cacheCleaned: string;
+    cacheStats: string;
+    loginCredentialsRequired: string;
+    bundleUnexpectedArgs: string;
+    unsafeIntermediateDir: string;
+    appKeyMissing: string;
+    errorStackHint: string;
+};
+export default _default;