@leonxin/meetgames 0.1.7 → 0.1.11

package/dist/remote/topsdkDownloadSdkConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"topsdkDownloadSdkConfig.js","sourceRoot":"","sources":["../../src/remote/topsdkDownloadSdkConfig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"topsdkDownloadSdkConfig.js","sourceRoot":"","sources":["../../src/remote/topsdkDownloadSdkConfig.ts"],"names":[],"mappings":"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"}

package/dist/shared/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class UserFacingError extends Error {
+    readonly code: string;
+    readonly details?: string;
+    constructor(code: string, message: string, details?: string);
+}
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAM5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD"}

package/dist/shared/errors.js

@@ -0,0 +1,16 @@
+export class UserFacingError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "UserFacingError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,OAAO,CAAU;IAE1B,YAAY,IAAY,EAAE,OAAe,EAAE,OAAgB;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/shared/fileUtils.d.ts

@@ -0,0 +1,5 @@
+export declare function assertFileExists(filePath: string, code: string, label: string): void;
+export declare function ensureDirectory(dirPath: string): void;
+export declare function assertWritableDirectory(dirPath: string): void;
+export declare function assertCanWriteFile(filePath: string, overwrite: boolean, label: string): void;
+//# sourceMappingURL=fileUtils.d.ts.map

package/dist/shared/fileUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.d.ts","sourceRoot":"","sources":["../../src/shared/fileUtils.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOpF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAa7D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK5F"}

package/dist/shared/fileUtils.js

@@ -0,0 +1,35 @@
+import fs from "node:fs";
+import path from "node:path";
+import { UserFacingError } from "./errors.js";
+export function assertFileExists(filePath, code, label) {
+    if (!fs.existsSync(filePath)) {
+        throw new UserFacingError(code, `${label} does not exist: ${filePath}`);
+    }
+    if (!fs.statSync(filePath).isFile()) {
+        throw new UserFacingError(code, `${label} is not a file: ${filePath}`);
+    }
+}
+export function ensureDirectory(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+    if (!fs.statSync(dirPath).isDirectory()) {
+        throw new UserFacingError("OUTPUT_DIR_INVALID", `Output path is not a directory: ${dirPath}`);
+    }
+}
+export function assertWritableDirectory(dirPath) {
+    ensureDirectory(dirPath);
+    try {
+        const probe = path.join(dirPath, `.write-test-${Date.now()}-${Math.random().toString(16).slice(2)}`);
+        fs.writeFileSync(probe, "");
+        fs.unlinkSync(probe);
+    }
+    catch (e) {
+        throw new UserFacingError("OUTPUT_DIR_NOT_WRITABLE", `Output directory is not writable: ${dirPath}`, e instanceof Error ? e.message : String(e));
+    }
+}
+export function assertCanWriteFile(filePath, overwrite, label) {
+    if (!overwrite && fs.existsSync(filePath)) {
+        throw new UserFacingError("OUTPUT_EXISTS", `${label} already exists: ${filePath}`);
+    }
+    ensureDirectory(path.dirname(filePath));
+}
+//# sourceMappingURL=fileUtils.js.map

package/dist/shared/fileUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.js","sourceRoot":"","sources":["../../src/shared/fileUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAAY,EAAE,KAAa;IAC5E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,KAAK,oBAAoB,QAAQ,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,KAAK,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrG,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,yBAAyB,EACzB,qCAAqC,OAAO,EAAE,EAC9C,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,SAAkB,EAAE,KAAa;IACpF,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,GAAG,KAAK,oBAAoB,QAAQ,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/shared/logger.d.ts

@@ -0,0 +1,10 @@
+export interface Logger {
+    readonly logPath?: string;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    close(): void;
+}
+export declare function createFileLogger(logDir: string): Logger;
+export declare function createConsoleLogger(verbose: boolean): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;CACf;AAcD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAS5D"}

package/dist/shared/logger.js

@@ -0,0 +1,37 @@
+import fs from "node:fs";
+import path from "node:path";
+function timestamp() {
+    return new Date().toISOString();
+}
+function logFileName() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `convert-${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}.log`;
+}
+export function createFileLogger(logDir) {
+    fs.mkdirSync(logDir, { recursive: true });
+    const logPath = path.join(logDir, logFileName());
+    const stream = fs.createWriteStream(logPath, { flags: "a", encoding: "utf8" });
+    const write = (level, message) => {
+        stream.write(`[${timestamp()}] [${level}] ${message}\n`);
+    };
+    return {
+        logPath,
+        info: (message) => write("INFO", message),
+        warn: (message) => write("WARN", message),
+        error: (message) => write("ERROR", message),
+        close: () => stream.end(),
+    };
+}
+export function createConsoleLogger(verbose) {
+    return {
+        info: (message) => {
+            if (verbose)
+                console.log(message);
+        },
+        warn: (message) => console.warn(message),
+        error: (message) => console.error(message),
+        close: () => undefined,
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/shared/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,WAAW,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CACrG,CAAC,CAAC,UAAU,EAAE,CACf,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE;QAC/C,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,MAAM,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,OAAO;QACL,OAAO;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;QACzC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;QACzC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC3C,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YAChB,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACxC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1C,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC"}

package/dist/shared/pathUtils.d.ts

@@ -0,0 +1,4 @@
+export declare function toAbsolutePath(value: string, baseDir?: string): string;
+export declare function baseNameWithoutExt(filePath: string, expectedExt: string): string;
+export declare function validateOutputFileName(fileName: string): string;
+//# sourceMappingURL=pathUtils.d.ts.map

package/dist/shared/pathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../src/shared/pathUtils.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAgB,GAAG,MAAM,CAE7E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ/D"}

package/dist/shared/pathUtils.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+import { UserFacingError } from "./errors.js";
+export function toAbsolutePath(value, baseDir = process.cwd()) {
+    return path.resolve(baseDir, value);
+}
+export function baseNameWithoutExt(filePath, expectedExt) {
+    const parsed = path.parse(filePath);
+    if (parsed.ext.toLowerCase() !== expectedExt.toLowerCase()) {
+        throw new UserFacingError("INVALID_EXTENSION", `Expected ${expectedExt} file: ${filePath}`);
+    }
+    return parsed.name;
+}
+export function validateOutputFileName(fileName) {
+    if (!fileName.trim()) {
+        throw new UserFacingError("INVALID_APK_NAME", "--apk-name cannot be empty");
+    }
+    if (fileName.includes("/") || fileName.includes("\\") || path.basename(fileName) !== fileName) {
+        throw new UserFacingError("INVALID_APK_NAME", "--apk-name must be a file name, not a path");
+    }
+    return fileName.toLowerCase().endsWith(".apk") ? fileName : `${fileName}.apk`;
+}
+//# sourceMappingURL=pathUtils.js.map

package/dist/shared/pathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../src/shared/pathUtils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;IACnE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,WAAmB;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,YAAY,WAAW,UAAU,QAAQ,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC9F,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,4CAA4C,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,MAAM,CAAC;AAChF,CAAC"}

package/dist/shared/processRunner.d.ts

@@ -0,0 +1,12 @@
+export interface RunProcessOptions {
+    cwd?: string;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+}
+export interface RunProcessResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function runProcess(file: string, args: string[], options?: RunProcessOptions): Promise<RunProcessResult>;
+//# sourceMappingURL=processRunner.d.ts.map

package/dist/shared/processRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRunner.d.ts","sourceRoot":"","sources":["../../src/shared/processRunner.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BnH"}

package/dist/shared/processRunner.js

@@ -0,0 +1,31 @@
+import { spawn } from "node:child_process";
+export function runProcess(file, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(file, args, {
+            cwd: options.cwd,
+            windowsHide: true,
+            shell: false,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (buf) => {
+            const text = buf.toString("utf8");
+            stdout += text;
+            options.onStdout?.(text);
+        });
+        child.stderr?.on("data", (buf) => {
+            const text = buf.toString("utf8");
+            stderr += text;
+            options.onStderr?.(text);
+        });
+        child.on("error", reject);
+        child.on("close", (exitCode) => {
+            resolve({
+                exitCode: exitCode ?? 1,
+                stdout,
+                stderr,
+            });
+        });
+    });
+}
+//# sourceMappingURL=processRunner.js.map

package/dist/shared/processRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRunner.js","sourceRoot":"","sources":["../../src/shared/processRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAc3C,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAc,EAAE,UAA6B,EAAE;IACtF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,IAAI,IAAI,CAAC;YACf,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,IAAI,IAAI,CAAC;YACf,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC7B,OAAO,CAAC;gBACN,QAAQ,EAAE,QAAQ,IAAI,CAAC;gBACvB,MAAM;gBACN,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/docs/AAB_CONVERTER_CLI_PLAN.md

@@ -0,0 +1,392 @@
+# AAB 转 APK 命令行工具方案
+
+本文记录 `meet-sdk-tool` 工具集新增 AAB 转 APK 工具的第一版方案。当前结论以本文为准：先做纯命令行绿色版 zip，不做桌面 UI，不做安装包，不内置 ADB。
+
+## 目标
+
+面向运营人员提供一个 Windows 可直接解压使用的命令行工具，把 Android App Bundle (`.aab`) 转换为可以安装到手机的通用 APK (`universal.apk`)。
+
+第一版只覆盖最小闭环：
+
+- 输入 `.aab`
+- 输入签名文件路径和签名参数
+- 调用 Google 官方 `bundletool`
+- 生成 `.apks`
+- 从 `.apks` 中提取 `universal.apk`
+- 输出最终 `.apk`
+
+## 非目标
+
+第一版暂不实现：
+
+- Electron 桌面 UI
+- Windows 安装包 `.exe installer`
+- ADB 检测或一键安装手机
+- 自动更新
+- 远程签名服务
+- Android / iOS SDK 接入流程复用
+- 接入现有 `recipe / pipeline / integrate` 机制
+
+## 技术选型
+
+采用当前仓库已有的 TypeScript / Node 技术栈：
+
+| 能力 | 选型 | 说明 |
+|---|---|---|
+| CLI 逻辑 | TypeScript + Node.js | 与现有 `meet-sdk-tool` 技术栈一致 |
+| AAB 转 APK | `bundletool.jar` | Google 官方工具 |
+| Java 运行环境 | Windows x64 JRE | 绿色版内置，运营无需安装 Java |
+| Windows 运行环境 | Windows x64 `node.exe` | 绿色版内置，运营无需安装 Node |
+| 打包方式 | macOS 组装 zip | zip 内放 Windows 运行时和资源 |
+| 验收方式 | Windows 实机验收 | macOS 只负责生成 zip，不替代 Windows 验证 |
+
+已确认的资源策略：
+
+- `bundletool.jar` 使用官方 GitHub Releases 最新稳定版；实现时从 `https://github.com/google/bundletool/releases/latest` 确认并固定版本。
+- 截至 2026-06-22，官方 latest release 为 `1.18.3`。
+- Windows Node 运行时当前固定为 Node.js `v24.17.0`。
+- Windows JRE 当前固定为 Eclipse Temurin JRE `21.0.11+10`。
+- 允许在仓库或 release 资源目录中保存 Windows x64 `node.exe`、Windows x64 JRE、`bundletool.jar`。
+- 第一版强制传入正式签名参数，不支持 debug / default 签名模式。
+
+## 交付形态
+
+最终产物：
+
+```text
+release/MeetSDKTool-AABConverter-win-x64.zip
+```
+
+解压后目录建议：
+
+```text
+MeetSDKTool-AABConverter-win-x64/
+  aab2apk.cmd
+  app/
+    aab-converter/
+      aab-entry.js
+    shared/
+  runtime/
+    node/
+      node.exe
+    jre/
+      bin/
+        java.exe
+  tools/
+    bundletool.jar
+  logs/
+  output/
+```
+
+`bundletool.jar` 是跨平台 jar；`node.exe` 和 `java.exe` 必须是 Windows x64 版本，不能放 macOS 版本。
+
+## 使用方式
+
+推荐通过环境变量传密码，避免密码出现在命令历史和进程参数中：
+
+```bat
+set KS_PASS=your_keystore_password
+set KEY_PASS=your_key_password
+
+aab2apk.cmd convert ^
+  --aab "D:\packages\game.aab" ^
+  --out-dir "D:\output" ^
+  --ks "D:\keys\release.jks" ^
+  --ks-key-alias "release" ^
+  --ks-pass-env KS_PASS ^
+  --key-pass-env KEY_PASS
+```
+
+也可以支持直接传密码，但仅用于临时测试：
+
+```bat
+aab2apk.cmd convert ^
+  --aab "D:\packages\game.aab" ^
+  --out-dir "D:\output" ^
+  --ks "D:\keys\release.jks" ^
+  --ks-key-alias "release" ^
+  --ks-pass "your_keystore_password" ^
+  --key-pass "your_key_password"
+```
+
+## CLI 参数
+
+命令：
+
+```text
+aab2apk.cmd convert --aab <file.aab> --out-dir <dir> [options]
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|---|---:|---|
+| `--aab` | 是 | AAB 文件路径 |
+| `--out-dir` | 是 | APK 输出目录 |
+| `--ks` | 是 | keystore / jks 文件路径 |
+| `--ks-key-alias` | 是 | keystore 中的 key alias |
+| `--ks-pass-env` | 否 | 从指定环境变量读取 keystore 密码，推荐 |
+| `--key-pass-env` | 否 | 从指定环境变量读取 key 密码，推荐 |
+| `--ks-pass` | 否 | 直接传 keystore 密码，不推荐 |
+| `--key-pass` | 否 | 直接传 key 密码，不推荐 |
+| `--apk-name` | 否 | 自定义输出 APK 文件名 |
+| `--keep-apks` | 否 | 保留中间产物 `.apks` |
+| `--no-overwrite` | 否 | 不覆盖已存在的输出 APK |
+| `--verbose` | 否 | 输出详细日志 |
+
+密码解析规则：
+
+1. 优先读取 `--ks-pass-env` / `--key-pass-env` 指定的环境变量。
+2. 如果未传 env 参数，再读取 `--ks-pass` / `--key-pass`。
+3. 如果签名参数不完整，直接报错，不进入 bundletool 执行阶段。
+4. 不支持缺省签名、debug 签名或无签名转换。
+
+输出覆盖规则：
+
+- 默认覆盖已存在的同名 APK 和中间 `.apks` 文件。
+- 如需防止覆盖，显式传 `--no-overwrite`。
+
+## 核心转换流程
+
+内部调用 `bundletool`：
+
+```bat
+java.exe -jar bundletool.jar build-apks ^
+  --bundle="D:\packages\game.aab" ^
+  --output="D:\output\game.apks" ^
+  --mode=universal ^
+  --ks="D:\keys\release.jks" ^
+  --ks-key-alias="release" ^
+  --ks-pass=pass:xxx ^
+  --key-pass=pass:xxx ^
+  --overwrite
+```
+
+然后把 `.apks` 当 zip 解压，提取：
+
+```text
+universal.apk
+```
+
+默认输出命名：
+
+```text
+原AAB文件名_universal.apk
+```
+
+示例：
+
+```text
+game.aab -> game_universal.apk
+```
+
+## 模块设计
+
+新增独立模块，不耦合现有接入工具：
+
+```text
+src/
+  aab-converter/
+    aab-entry.ts
+    cliArgs.ts
+    convertAabToApk.ts
+    bundletoolRunner.ts
+    apksExtractor.ts
+    signingOptions.ts
+    types.ts
+
+  shared/
+    processRunner.ts
+    fileUtils.ts
+    pathUtils.ts
+    logger.ts
+    errors.ts
+```
+
+允许的依赖方向：
+
+```text
+aab-converter -> shared
+原接入工具 -> shared
+```
+
+禁止的依赖方向：
+
+```text
+aab-converter -> recipe / pipeline / integrate
+recipe / pipeline / integrate -> aab-converter
+```
+
+原因：AAB 转 APK 是独立文件转换，原接入工具是宿主工程改造。两者业务模型不同，只能共用基础库，不能共用集成 pipeline。
+
+## 与现有工具的关系
+
+`meet-sdk-tool` 作为工具集存在，包含多个独立工具：
+
+```text
+SDK 接入工具:
+  meetgames setup / integrate / doctor
+  使用 recipe / pipeline / op handlers
+
+AAB 转 APK 工具:
+  aab2apk.cmd convert
+  使用 aab-converter 独立流程
+```
+
+现有 `meetgames` CLI、MCP、SDK 接入逻辑不应因 AAB 转换工具发生行为变化。
+
+## 打包方案
+
+macOS 负责生成 Windows 绿色版 zip，但只是组装文件，不编译 Windows 原生代码。
+
+打包前置条件：
+
+- 已完成 TypeScript 编译
+- 已准备 Windows x64 `node.exe`
+- 已准备 Windows x64 JRE
+- 已准备 `bundletool.jar`
+- 运行时依赖不包含 macOS 原生二进制
+
+建议脚本：
+
+```text
+npm run build:aab
+npm run package:aab-win-zip
+```
+
+打包脚本职责：
+
+1. 清理临时 release 目录。
+2. 拷贝编译后的 `dist/aab-converter` 和必要的 `dist/shared`。
+3. 拷贝 `runtime/win-x64/node/node.exe`。
+4. 拷贝 `runtime/win-x64/jre`。
+5. 拷贝 `tools/bundletool.jar`。
+6. 生成 `aab2apk.cmd`。
+7. 创建空 `logs/` 和 `output/`。
+8. 压缩为 `MeetSDKTool-AABConverter-win-x64.zip`。
+9. 排除 `.DS_Store`、`__MACOSX/` 等 macOS 文件。
+
+## Windows 验收
+
+macOS 生成 zip 后，必须在 Windows 机器验收。
+
+最小验收命令：
+
+```bat
+aab2apk.cmd --help
+```
+
+完整验收命令：
+
+```bat
+set KS_PASS=your_keystore_password
+set KEY_PASS=your_key_password
+
+aab2apk.cmd convert ^
+  --aab "D:\test\game.aab" ^
+  --out-dir "D:\test\out" ^
+  --ks "D:\test\release.jks" ^
+  --ks-key-alias "release" ^
+  --ks-pass-env KS_PASS ^
+  --key-pass-env KEY_PASS ^
+  --verbose
+```
+
+验收项：
+
+- Windows 上解压 zip 后能直接运行。
+- 机器未安装 Node 时也能运行。
+- 机器未安装 Java 时也能运行。
+- 中文路径可用。
+- 带空格路径可用。
+- 输出目录不存在时可创建。
+- 默认覆盖同名输出。
+- 传 `--no-overwrite` 时，同名输出存在则失败并提示。
+- keystore 密码错误时提示清晰。
+- alias 错误时提示清晰。
+- bundletool 失败时保留日志。
+- 成功生成 `*_universal.apk`。
+
+## 错误提示
+
+需要对常见错误做中文化映射：
+
+| 场景 | 提示方向 |
+|---|---|
+| AAB 文件不存在 | 检查 `--aab` 路径 |
+| AAB 后缀不正确 | 只支持 `.aab` 文件 |
+| keystore 文件不存在 | 检查 `--ks` 路径 |
+| 签名参数不完整 | 检查 `--ks-key-alias` 和密码参数 |
+| 环境变量不存在 | 检查 `--ks-pass-env` / `--key-pass-env` |
+| Java 缺失 | 绿色版包损坏或 JRE 未打入 |
+| bundletool 缺失 | 绿色版包损坏或 `bundletool.jar` 未打入 |
+| 密码或 alias 错误 | 检查 keystore 密码、key 密码和 alias |
+| 未找到 `universal.apk` | 检查 bundletool 输出和 `.apks` 内容 |
+| 输出目录不可写 | 更换输出目录或检查权限 |
+
+## 测试策略
+
+核心单元测试：
+
+- CLI 参数解析
+- 签名参数解析
+- bundletool 参数构造
+- 输出文件命名
+- `.apks` 解压与 `universal.apk` 查找
+
+集成测试：
+
+- 使用测试 AAB 跑通转换
+- 验证输出 APK 存在
+- 验证 `--keep-apks`
+- 验证默认覆盖
+- 验证 `--no-overwrite`
+
+测试文件放置目录：
+
+```text
+test-assets/aab-converter/
+  sample.aab
+  sample-release.jks
+  README.md 或其他本地 .md
+```
+
+注意：
+
+- 只放测试包和测试签名文件，不能放生产 keystore。
+- `.aab`、`.apk`、`.apks`、`.jks`、`.keystore`、该目录下的 `.md` 默认不提交到 git。
+- 测试密码和 alias 可以写在同目录的本地 `.md` 中或通过环境变量传入，不要提交真实生产密码。
+
+回归测试：
+
+- 现有 `npm test` 必须通过
+- 现有 `meetgames setup / integrate / doctor` 行为不变
+
+## 实施顺序
+
+1. 新增 `src/aab-converter` 核心模块。
+2. 新增必要的 `src/shared` 基础能力。
+3. 新增 `aab-entry.ts` CLI 入口。
+4. 新增测试。
+5. 准备 `bundletool.jar`、Windows Node、Windows JRE。
+6. 新增绿色版 zip 打包脚本。
+7. 在 macOS 生成 zip。
+8. 在 Windows 实机验收。
+9. 补充用户使用说明和常见问题。
+
+## 实现注意事项
+
+- `.apks` 必须按 ZIP 结构流式读取，不能一次性读入内存。实际测试样本超过 2GB，一次性 `readFile` 会触发 Node 单 Buffer 限制。
+- bundletool 命令日志必须脱敏 `--ks-pass` 和 `--key-pass`。
+- macOS 本地验证时不能自动使用 `runtime/win-x64/jre/bin/java.exe`，应使用系统 `java` 或显式 `AAB2APK_JAVA_PATH`；Windows 绿色版运行时使用包内 `runtime/jre/bin/java.exe`。
+- `test-assets/aab-converter/` 下的 AAB、JKS 和本地密钥说明 `.md` 只能用于本地验证，不能提交。
+
+## 最终结论
+
+第一版采用纯命令行绿色版：
+
+```text
+TypeScript CLI + Windows node.exe + Windows JRE + bundletool.jar
+```
+
+macOS 负责生成 zip，Windows 负责验收。AAB 转 APK 工具作为 `meet-sdk-tool` 工具集中的独立工具存在，不复用现有 `recipe / pipeline / integrate` 机制，只在必要时共用基础工具库。