@seayoo-web/app-info 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seayoo-web/app-info",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "app info parser",
   "type": "module",
   "source": "./src/index.ts",
@@ -20,18 +20,21 @@
   },
   "devDependencies": {
     "@types/bytebuffer": "^5.0.49",
+    "@types/pako": "^2.0.4",
     "@types/plist": "^3.0.5",
     "jszip": "^3.10.1",
     "tsx": "^4.21.0",
     "@seayoo-web/scripts": "^3.1.6",
-    "@seayoo-web/tsconfig": "^1.0.5",
-    "@seayoo-web/utils": "^4.1.3"
+    "@seayoo-web/utils": "^4.1.3",
+    "@seayoo-web/tsconfig": "^1.0.5"
   },
   "peerDependencies": {
     "jszip": "^3.10.1"
   },
   "dependencies": {
-    "bytebuffer": "^5.0.1"
+    "bytebuffer": "^5.0.1",
+    "cgbi-to-png": "^1.0.7",
+    "pako": "^2.0.4"
   },
   "scripts": {
     "prebuild": "pnpm -F utils build",

package/types/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./src/file.app";
 export * from "./src/file.apk";
 export * from "./src/file.ipa";
-export type { AppCommonInfo, ParserOptions, FileInput } from "./src/utils/base";
+export type { AppCommonInfo, ParserOptions, FileInput, OutputType } from "./src/utils/base";

package/types/src/file.apk.d.ts

@@ -1,4 +1,4 @@
-import type { AppCommonInfo, FileInput, ParserOptions } from "./utils/base";
+import type { AppCommonInfo, FileInput, OutputByType, OutputType, ParserOptions } from "./utils/base";
 import type { Manifest } from "./utils/manifest";
 export type { Manifest, CollapsedAttributes, Application } from "./utils/manifest";
 /**
@@ -15,5 +15,8 @@ export declare class AndroidAppParser {
     /**
      * 读取指定文件的内容
      */
-    readFile(filePath: string | RegExp): Promise<ArrayBuffer | Error>;
+    readFile<T extends OutputType>(filePath: string, output: T): Promise<{
+        name: string;
+        content: OutputByType[T];
+    } | Error>;
 }

package/types/src/file.app.d.ts

@@ -1,4 +1,4 @@
-import type { FileInput, AppCommonInfo, ParserOptions } from "./utils/base";
+import type { FileInput, AppCommonInfo, ParserOptions, OutputType, OutputByType } from "./utils/base";
 import type { HosAppPackInfo } from "./utils/pack.info";
 export type { HosAppPackInfo, Summary, PackageInfo, DeviceType } from "./utils/pack.info";
 export interface HosAppInfo extends AppCommonInfo {
@@ -12,5 +12,8 @@ export declare class HosAppParser {
     /**
      * 读取指定文件的内容
      */
-    readFile(filePath: string | RegExp): Promise<ArrayBuffer | Error>;
+    readFile<T extends OutputType>(filePath: string, output: T): Promise<{
+        name: string;
+        content: OutputByType[T];
+    } | Error>;
 }

package/types/src/file.ipa.d.ts

@@ -1,4 +1,4 @@
-import type { AppCommonInfo, FileInput, ParserOptions } from "./utils/base";
+import type { AppCommonInfo, FileInput, OutputByType, OutputType, ParserOptions } from "./utils/base";
 import type { PlistInfo } from "./utils/plist";
 export type { PlistInfo } from "./utils/plist";
 /**
@@ -22,5 +22,8 @@ export declare class IosAppParser {
     /**
      * 读取指定文件的内容
      */
-    readFile(filePath: string | RegExp): Promise<ArrayBuffer | Error>;
+    readFile<T extends OutputType>(filePath: string, output: T): Promise<{
+        name: string;
+        content: OutputByType[T];
+    } | Error>;
 }

package/types/src/utils/base.d.ts

@@ -6,6 +6,17 @@ export type ParserOptions = {
     ignoreIcon?: boolean;
 };
 export type JSZip = PromiseValue<ReturnType<typeof loadAsync>>;
+export interface OutputByType {
+    base64: string;
+    string: string;
+    text: string;
+    binarystring: string;
+    array: number[];
+    uint8array: Uint8Array;
+    arraybuffer: ArrayBuffer;
+    blob: Blob;
+}
+export type OutputType = keyof OutputByType;
 export interface AppCommonInfo {
     /** 包名 */
     package: string;
@@ -15,8 +26,17 @@ export interface AppCommonInfo {
     versionName: string;
     /** dataURI 格式的图标 */
     icon?: string;
+    iconPath?: string;
 }
 export declare function toString(d: unknown): string;
 export declare function toNumber(d: unknown): number;
 export declare function formatError(e: unknown): Error;
 export declare function base64Icon(data: string): string;
+export declare function readFile<T extends keyof OutputByType>(zip: JSZip, filePath: string, output: T): Promise<{
+    name: string;
+    content: OutputByType[T];
+} | Error>;
+/**
+ * 将 ArrayBuffer 转换为 Base64 字符串
+ */
+export declare function bufferToBase64(buffer: Uint8Array): string;

package/types/src/utils/cgbi.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 同步将 CgBI PNG Uint8Array 转换为标准 PNG Uint8Array。使用 pako 库进行 Zlib (Deflate/Inflate) 操作。
+ * 如果输入不是 CgBI PNG，则直接返回原始数据。
+ *
+ * @param data - CgBI PNG 文件的 Uint8Array 数据。
+ * @returns 还原后的标准 PNG 文件的 Uint8Array Promise。
+ * @throws {Error} 如果文件头不正确、数据截断或内存不足。
+ */
+export declare function revertCgBIBuffer(data: Uint8Array): Promise<Uint8Array>;