rn-update-cli 1.0.0

package/lib/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * [INPUT]: 依赖 CLI 命令参数与服务端原生构建/发布字段
+ * [OUTPUT]: 对外提供平台、含 channelId/bundleHash 的原生包体、发布与 Provider 共享契约
+ * [POS]: CLI 公共模型层，兼容旧数字 ID 与独立服务 UUID，并为上传前版本组检查保留内容身份
+ */
+declare global {
+    var NO_INTERACTIVE: boolean | undefined;
+    var USE_ACC_OSS: boolean | undefined;
+}
+export interface Session {
+    token: string;
+}
+export type Platform = 'ios' | 'android' | 'harmony';
+export interface Package {
+    id: string | number;
+    name: string;
+    version?: string;
+    status?: string;
+    appId?: string;
+    appKey?: string;
+    versionName?: string | number | null;
+    channelId?: string;
+    bundleHash?: string;
+    hash?: string;
+    /** Opaque UUID generated by the native build; never parsed as a number. */
+    buildTime?: string | null;
+    channel?: string;
+    deps?: Record<string, string> | string | null;
+}
+export interface Version {
+    id: string | number;
+    hash: string;
+    name: string;
+    packages?: Package[];
+    deps?: Record<string, string> | string | null;
+    /** storage key of the archived source map (absent when published without one) */
+    sourceMapKey?: string;
+}
+export interface CommandContext<TOptions extends Record<string, unknown> = Record<string, unknown>> {
+    args: string[];
+    options: TOptions;
+    platform?: Platform;
+    appId?: string;
+    session?: Session;
+}
+export interface CommandResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export interface BundleOptions {
+    dev?: boolean;
+    platform?: Platform;
+    bundleName?: string;
+    entryFile?: string;
+    output?: string;
+    sourcemap?: boolean;
+    taro?: boolean;
+    expo?: boolean;
+    rncli?: boolean;
+    hermes?: boolean;
+    /** 'auto' (default) | 'none' | path to a .hbc/.ppk/.apk/.ipa used as hermesc -base-bytecode */
+    hermesBase?: string;
+    /** run the disassembly equivalence check after a base compile (default true) */
+    verifyHermesBase?: boolean;
+    /** pass --reset-cache to Metro (default true); false reuses its transform cache */
+    resetCache?: boolean;
+    sentryRelease?: string;
+    sentryDist?: string;
+    /** publish to this app instead of the one selected in the config file */
+    appId?: string;
+    /** selected-app config file (default: update.json) */
+    config?: string;
+}
+export interface PublishOptions {
+    filePath?: string;
+    /** path of the final source map to archive with the version */
+    sourcemap?: string;
+    platform?: Platform;
+    name?: string;
+    description?: string;
+    metaInfo?: string;
+    diffFromHash?: string;
+    packageId?: string;
+    packageVersion?: string;
+    /** Default channel code; targets.json can override it for each deployment target. */
+    channel?: string;
+    /** JSON file containing independent channel × native-version targets. */
+    targets?: string;
+    /** Exact deployment ids returned by standalone publish for a safe retry. */
+    deploymentIds?: string;
+    /** Legacy alias for deploymentIds. */
+    releaseIds?: string;
+    minPackageVersion?: string;
+    maxPackageVersion?: string;
+    packageVersionRange?: string;
+    /** Global rollout fallback; target.rollout wins, then this value, then 100%. */
+    rollout?: number | string;
+    dryRun?: boolean;
+    appId?: string;
+    config?: string;
+}
+export interface UploadOptions {
+    platform?: Platform;
+    filePath: string;
+    appId?: string;
+    appKey?: string;
+    version?: string;
+    /** Assertion only; never overrides the channel embedded in the native package. */
+    channel?: string;
+    config?: string;
+}
+export interface UpdateVersionOptions {
+    platform?: Platform;
+    packageId?: string;
+    packageVersion?: string;
+    channel?: string;
+    minPackageVersion?: string;
+    maxPackageVersion?: string;
+    packageVersionRange?: string;
+    rollout?: number | string;
+    dryRun?: boolean;
+}
+export interface SymbolicateOptions {
+    /** stack trace file ('-' for stdin) */
+    stackFile?: string;
+    /** update hash of the running version (from getUpdateMetadata().currentVersion) */
+    hash?: string;
+    versionId?: string;
+    platform?: Platform;
+    appId?: string;
+    config?: string;
+    /** write the symbolicated stack here instead of stdout */
+    output?: string;
+}
+export interface CLIProvider {
+    bundle: (options: BundleOptions) => Promise<CommandResult>;
+    publish: (options: PublishOptions) => Promise<CommandResult>;
+    symbolicate: (options: SymbolicateOptions) => Promise<CommandResult>;
+    upload: (options: UploadOptions) => Promise<CommandResult>;
+    createApp: (name: string, platform: Platform) => Promise<CommandResult>;
+    listApps: (platform?: Platform) => Promise<CommandResult>;
+    getSelectedApp: (platform?: Platform, config?: string) => Promise<{
+        appId: string;
+        platform: Platform;
+    }>;
+    listVersions: (appId: string) => Promise<CommandResult>;
+    updateVersion: (appId: string, versionId: string, updates: UpdateVersionOptions) => Promise<CommandResult>;
+    listPackages: (appId: string) => Promise<CommandResult>;
+    getPlatform: (platform?: Platform) => Promise<Platform>;
+    loadSession: () => Promise<Session>;
+}

package/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/user.d.ts

@@ -0,0 +1,8 @@
+import type { CommandContext } from './types';
+export declare const userCommands: {
+    login: ({ args }: {
+        args: string[];
+    }) => Promise<void>;
+    logout: (_context: CommandContext) => Promise<void>;
+    me: () => Promise<void>;
+};

package/lib/user.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userCommands = void 0;
+/**
+ * [INPUT]: 依赖 CLI API 会话存储、凭据隔离和登录提示
+ * [OUTPUT]: 对外提供 login/logout/me 用户命令
+ * [POS]: CLI 身份层，所有服务地址统一走邮箱账号管理 API，并复用现有会话与令牌传输协议
+ */
+const api_1 = require("./api");
+const utils_1 = require("./utils");
+const add_gitignore_1 = require("./utils/add-gitignore");
+const constants_1 = require("./utils/constants");
+const i18n_1 = require("./utils/i18n");
+exports.userCommands = {
+    login: async ({ args }) => {
+        const email = args[0] || (await (0, utils_1.question)('email:'));
+        const pwd = args[1] || (await (0, utils_1.question)('password:', true));
+        if (!email || !pwd) {
+            // without a terminal `question` answers '': fail here instead of
+            // sending empty credentials to the server
+            throw new Error((0, i18n_1.t)('loginCredentialsRequired', { scriptName: constants_1.scriptName }));
+        }
+        const response = await (0, api_1.post)((0, api_1.servicePath)('/auth/login'), { email, password: pwd });
+        const data = response?.data ?? response;
+        const token = data?.accessToken ?? data?.token;
+        if (typeof token !== 'string' || token.length === 0) {
+            throw new Error('登录响应缺少 accessToken');
+        }
+        (0, api_1.replaceSession)({ token });
+        await (0, api_1.saveSession)();
+        // make sure the token file is ignored before the user's next commit,
+        // not only when they first run `bundle`
+        (0, add_gitignore_1.addGitIgnore)();
+        console.log((0, i18n_1.t)('welcomeMessage', { name: data?.user?.displayName || data?.user?.email || data?.info?.name || email }));
+    },
+    logout: async (_context) => {
+        await (0, api_1.post)((0, api_1.servicePath)('/auth/logout')).catch(() => undefined);
+        await (0, api_1.closeSession)();
+        console.log((0, i18n_1.t)('loggedOut'));
+    },
+    me: async () => {
+        const me = await (0, api_1.get)((0, api_1.servicePath)('/auth/me'));
+        const value = me?.data ?? me;
+        for (const k in value) {
+            if (k !== 'ok') {
+                console.log(`${k}: ${value[k]}`);
+            }
+        }
+    },
+};

package/lib/utils/add-gitignore.d.ts

@@ -0,0 +1,6 @@
+/**
+ * [INPUT]: 依赖文件系统、CLI 凭据/临时目录常量与本地化文案
+ * [OUTPUT]: 对外提供 addGitIgnore，幂等写入 Pakta CLI 工作目录的忽略项
+ * [POS]: CLI 项目卫生辅助层，只修改当前项目 .gitignore，不参与命令业务流程
+ */
+export declare function addGitIgnore(): void;

package/lib/utils/add-gitignore.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * [INPUT]: 依赖文件系统、CLI 凭据/临时目录常量与本地化文案
+ * [OUTPUT]: 对外提供 addGitIgnore，幂等写入 Pakta CLI 工作目录的忽略项
+ * [POS]: CLI 项目卫生辅助层，只修改当前项目 .gitignore，不参与命令业务流程
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGitIgnore = addGitIgnore;
+const fs_1 = __importDefault(require("fs"));
+// import path from 'path';
+const constants_1 = require("./constants");
+const i18n_1 = require("./i18n");
+function addGitIgnore() {
+    const shouldIgnore = [constants_1.credentialFile, constants_1.tempDir];
+    const gitignorePath = '.gitignore';
+    if (!fs_1.default.existsSync(gitignorePath)) {
+        return;
+    }
+    const gitignoreContent = fs_1.default.readFileSync(gitignorePath, 'utf-8');
+    const gitignoreLines = gitignoreContent.split('\n');
+    // `.pakta`, `/.pakta` and `.pakta/` all ignore the same directory; a
+    // trailing slash only matches directories, so it counts for tempDir alone
+    const covers = (entry, line) => {
+        const pattern = line.trim().replace(/^\//, '');
+        return pattern === entry || (entry === constants_1.tempDir && pattern === `${entry}/`);
+    };
+    for (const line of gitignoreLines) {
+        const index = shouldIgnore.findIndex((entry) => covers(entry, line));
+        if (index !== -1) {
+            shouldIgnore.splice(index, 1);
+        }
+    }
+    if (shouldIgnore.length > 0) {
+        gitignoreLines.push('# rn-update');
+        for (const line of shouldIgnore) {
+            gitignoreLines.push(line);
+            console.log((0, i18n_1.t)('addedToGitignore', { line }));
+        }
+        fs_1.default.writeFileSync(gitignorePath, gitignoreLines.join('\n'));
+    }
+}

package/lib/utils/app-info-parser/aab.d.ts

@@ -0,0 +1,27 @@
+/**
+ * [INPUT]: 依赖 AAB ZIP 读取、Android manifest/resource 解析、文件系统与外部包工具
+ * [OUTPUT]: 对外提供 AabParser，提取 Android App Bundle 的版本和资源元数据
+ * [POS]: 应用包解析子域的 AAB 实现，与 ApkParser 共享基础 ZIP/资源解析协议
+ */
+import { Zip } from './zip';
+export declare class AabParser extends Zip {
+    extractApk(outputPath: string, { includeAllSplits, splits, }: {
+        includeAllSplits?: boolean;
+        splits?: string[] | null;
+    }): Promise<void>;
+    /**
+     * 解析 AAB 文件信息（类似 APK parser 的 parse 方法）
+     * 注意：AAB 中的 AndroidManifest.xml 在 base/manifest/AndroidManifest.xml
+     */
+    parse(): Promise<Record<string, any>>;
+    /**
+     * Parse manifest
+     * @param {Buffer} buffer // manifest file's buffer
+     */
+    private _parseManifest;
+    /**
+     * Parse resourceMap
+     * @param {Buffer} buffer // resourceMap file's buffer
+     */
+    private _parseResourceMap;
+}

package/lib/utils/app-info-parser/aab.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * [INPUT]: 依赖 AAB ZIP 读取、Android manifest/resource 解析、文件系统与外部包工具
+ * [OUTPUT]: 对外提供 AabParser，提取 Android App Bundle 的版本和资源元数据
+ * [POS]: 应用包解析子域的 AAB 实现，与 ApkParser 共享基础 ZIP/资源解析协议
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AabParser = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs-extra"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const yauzl_1 = require("yauzl");
+const i18n_1 = require("../i18n");
+const resource_finder_1 = require("./resource-finder");
+const utils_1 = require("./utils");
+const manifest_1 = require("./xml-parser/manifest");
+const zip_1 = require("./zip");
+class AabParser extends zip_1.Zip {
+    async extractApk(outputPath, { includeAllSplits, splits, }) {
+        const normalizedSplits = Array.isArray(splits)
+            ? splits.map((item) => item.trim()).filter(Boolean)
+            : [];
+        const modules = includeAllSplits
+            ? null
+            : Array.from(new Set(['base', ...normalizedSplits]));
+        const modulesArgs = modules ? [`--modules=${modules.join(',')}`] : [];
+        const runCommand = (command, args, options = {}) => new Promise((resolve, reject) => {
+            const inheritStdio = options.stdio === 'inherit';
+            const child = (0, child_process_1.spawn)(command, args, {
+                stdio: inheritStdio ? 'inherit' : ['ignore', 'pipe', 'pipe'],
+                env: options.env,
+            });
+            let stderr = '';
+            if (!inheritStdio) {
+                child.stderr?.on('data', (chunk) => {
+                    stderr += chunk.toString();
+                });
+            }
+            child.on('error', reject);
+            child.on('close', (code) => {
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                reject(new Error(stderr.trim() || `Command failed: ${command} (code ${code})`));
+            });
+        });
+        // Create a temp file for the .apks output
+        const tempDir = await fs.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'bundletool-'));
+        const tempApksPath = path_1.default.join(tempDir, 'output.apks');
+        const needsNpxDownload = async () => {
+            try {
+                await runCommand('npx', [
+                    '--no-install',
+                    'node-bundletool',
+                    '--version',
+                ]);
+                return false;
+            }
+            catch {
+                return true;
+            }
+        };
+        try {
+            // 1. Build APKS (universal mode)
+            // We assume bundletool is in the path.
+            // User might need keystore to sign it properly but for simple extraction we stick to default debug key if possible or unsigned?
+            // actually bundletool build-apks signs with debug key by default if no keystore provided.
+            try {
+                await runCommand('bundletool', [
+                    'build-apks',
+                    '--mode=universal',
+                    `--bundle=${this.file}`,
+                    `--output=${tempApksPath}`,
+                    '--overwrite',
+                    ...modulesArgs,
+                ]);
+            }
+            catch (e) {
+                // Only fall back when bundletool itself is missing from PATH (spawn
+                // ENOENT). Any other failure (corrupt AAB, Java issues, bad args,
+                // non-zero exit) must surface as-is instead of being masked by an
+                // online npx install.
+                if (e?.code !== 'ENOENT') {
+                    throw e;
+                }
+                // Fallback to npx node-bundletool if bundletool is not in PATH
+                // We use -y to avoid interactive prompt for installation
+                if (await needsNpxDownload()) {
+                    console.log((0, i18n_1.t)('aabBundletoolDownloadHint'));
+                }
+                await runCommand('npx', [
+                    '-y',
+                    'node-bundletool',
+                    'build-apks',
+                    '--mode=universal',
+                    `--bundle=${this.file}`,
+                    `--output=${tempApksPath}`,
+                    '--overwrite',
+                    ...modulesArgs,
+                ], {
+                    stdio: 'inherit',
+                    env: {
+                        ...process.env,
+                        npm_config_progress: 'true',
+                    },
+                });
+            }
+            // 2. Extract universal.apk from the .apks (zip) file
+            await new Promise((resolve, reject) => {
+                (0, yauzl_1.open)(tempApksPath, { lazyEntries: true }, (err, zipfile) => {
+                    if (err || !zipfile) {
+                        reject(err || new Error((0, i18n_1.t)('aabOpenApksFailed')));
+                        return;
+                    }
+                    let found = false;
+                    zipfile.readEntry();
+                    zipfile.on('entry', (entry) => {
+                        if (entry.fileName === 'universal.apk') {
+                            found = true;
+                            zipfile.openReadStream(entry, (err, readStream) => {
+                                if (err || !readStream) {
+                                    reject(err || new Error((0, i18n_1.t)('aabReadUniversalApkFailed')));
+                                    return;
+                                }
+                                const writeStream = fs.createWriteStream(outputPath);
+                                readStream.pipe(writeStream);
+                                writeStream.on('close', () => {
+                                    zipfile.close();
+                                    resolve();
+                                });
+                                readStream.on('error', reject);
+                                writeStream.on('error', reject);
+                            });
+                        }
+                        else {
+                            zipfile.readEntry();
+                        }
+                    });
+                    zipfile.on('end', () => {
+                        if (!found)
+                            reject(new Error((0, i18n_1.t)('aabUniversalApkNotFound')));
+                    });
+                    zipfile.on('error', reject);
+                });
+            });
+        }
+        finally {
+            // Cleanup
+            if (await fs.pathExists(tempDir)) {
+                await fs.remove(tempDir);
+            }
+        }
+    }
+    /**
+     * 解析 AAB 文件信息（类似 APK parser 的 parse 方法）
+     * 注意：AAB 中的 AndroidManifest.xml 在 base/manifest/AndroidManifest.xml
+     */
+    async parse() {
+        const manifestPath = 'base/manifest/AndroidManifest.xml';
+        const ResourceName = /^base\/resources\.arsc$/;
+        try {
+            const manifestBuffer = await this.getEntry(new RegExp(`^${escapeRegExp(manifestPath)}$`));
+            if (!manifestBuffer) {
+                throw new Error((0, i18n_1.t)('aabManifestNotFound'));
+            }
+            let apkInfo = this._parseManifest(manifestBuffer);
+            try {
+                const resourceBuffer = await this.getEntry(ResourceName);
+                if (resourceBuffer) {
+                    const resourceMap = this._parseResourceMap(resourceBuffer);
+                    apkInfo = (0, utils_1.mapInfoResource)(apkInfo, resourceMap);
+                }
+            }
+            catch (e) {
+                console.warn((0, i18n_1.t)('aabParseResourcesWarning', { error: e?.message ?? e }));
+            }
+            return apkInfo;
+        }
+        catch (error) {
+            throw new Error((0, i18n_1.t)('aabParseFailed', { error: error.message ?? error }));
+        }
+    }
+    /**
+     * Parse manifest
+     * @param {Buffer} buffer // manifest file's buffer
+     */
+    _parseManifest(buffer) {
+        try {
+            const parser = new manifest_1.ManifestParser(buffer, {
+                ignore: [
+                    'application.activity',
+                    'application.service',
+                    'application.receiver',
+                    'application.provider',
+                    'permission-group',
+                ],
+            });
+            return parser.parse();
+        }
+        catch (e) {
+            throw new Error((0, i18n_1.t)('aabParseManifestError', { error: e?.message ?? e }));
+        }
+    }
+    /**
+     * Parse resourceMap
+     * @param {Buffer} buffer // resourceMap file's buffer
+     */
+    _parseResourceMap(buffer) {
+        try {
+            return new resource_finder_1.ResourceFinder().processResourceTable(buffer);
+        }
+        catch (e) {
+            throw new Error((0, i18n_1.t)('aabParseResourcesError', { error: e?.message ?? e }));
+        }
+    }
+}
+exports.AabParser = AabParser;
+const escapeRegExp = (value) => value.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');

package/lib/utils/app-info-parser/apk.d.ts

@@ -0,0 +1,19 @@
+/**
+ * [INPUT]: 依赖 APK ZIP、Android manifest 二进制 XML、资源表与图标资源解析器
+ * [OUTPUT]: 对外提供 ApkParser，提取 Android APK 的应用元数据
+ * [POS]: 应用包解析子域的 APK 实现，复用 Zip、ManifestParser 与 ResourceFinder
+ */
+import { Zip } from './zip';
+export declare class ApkParser extends Zip {
+    parse(): Promise<any>;
+    /**
+     * Parse manifest
+     * @param {Buffer} buffer // manifest file's buffer
+     */
+    private _parseManifest;
+    /**
+     * Parse resourceMap
+     * @param {Buffer} buffer // resourceMap file's buffer
+     */
+    private _parseResourceMap;
+}

package/lib/utils/app-info-parser/apk.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * [INPUT]: 依赖 APK ZIP、Android manifest 二进制 XML、资源表与图标资源解析器
+ * [OUTPUT]: 对外提供 ApkParser，提取 Android APK 的应用元数据
+ * [POS]: 应用包解析子域的 APK 实现，复用 Zip、ManifestParser 与 ResourceFinder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApkParser = void 0;
+const resource_finder_1 = require("./resource-finder");
+const utils_1 = require("./utils");
+const manifest_1 = require("./xml-parser/manifest");
+const zip_1 = require("./zip");
+const ManifestName = /^androidmanifest\.xml$/;
+const ResourceName = /^resources\.arsc$/;
+class ApkParser extends zip_1.Zip {
+    parse() {
+        const manifestKey = ManifestName.toString();
+        const resourceKey = ResourceName.toString();
+        return new Promise((resolve, reject) => {
+            this.getEntries([ManifestName, ResourceName])
+                .then((buffers) => {
+                const manifestBuffer = buffers[manifestKey];
+                if (!manifestBuffer) {
+                    throw new Error("AndroidManifest.xml can't be found.");
+                }
+                let apkInfo;
+                let resourceMap;
+                apkInfo = this._parseManifest(manifestBuffer);
+                if (!buffers[resourceKey]) {
+                    resolve(apkInfo);
+                }
+                else {
+                    resourceMap = this._parseResourceMap(buffers[resourceKey]);
+                    apkInfo = (0, utils_1.mapInfoResource)(apkInfo, resourceMap);
+                    const iconPath = (0, utils_1.findApkIconPath)(apkInfo);
+                    if (iconPath) {
+                        this.getEntry(iconPath)
+                            .then((iconBuffer) => {
+                            apkInfo.icon = Buffer.isBuffer(iconBuffer)
+                                ? (0, utils_1.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);
+            });
+        });
+    }
+    /**
+     * Parse manifest
+     * @param {Buffer} buffer // manifest file's buffer
+     */
+    _parseManifest(buffer) {
+        try {
+            const parser = new manifest_1.ManifestParser(buffer, {
+                ignore: [
+                    'application.activity',
+                    'application.service',
+                    'application.receiver',
+                    'application.provider',
+                    'permission-group',
+                ],
+            });
+            return parser.parse();
+        }
+        catch (e) {
+            throw new Error(`Parse AndroidManifest.xml error: ${e.message || e}`);
+        }
+    }
+    /**
+     * Parse resourceMap
+     * @param {Buffer} buffer // resourceMap file's buffer
+     */
+    _parseResourceMap(buffer) {
+        try {
+            return new resource_finder_1.ResourceFinder().processResourceTable(buffer);
+        }
+        catch (e) {
+            throw new Error(`Parser resources.arsc error: ${e}`);
+        }
+    }
+}
+exports.ApkParser = ApkParser;

package/lib/utils/app-info-parser/app.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [INPUT]: 依赖通用 Zip 容器读取能力
+ * [OUTPUT]: 对外提供 AppParser，处理 macOS .app 包的通用归档边界
+ * [POS]: 应用包解析子域的轻量 fallback，实现与平台特定解析器一致的 parse 接口
+ */
+import { Zip } from './zip';
+export declare class AppParser extends Zip {
+    parse(): Promise<Record<string, never>>;
+}