@seayoo-web/app-info 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seayoo-web/app-info",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "app info parser",
   "type": "module",
   "source": "./src/index.ts",
@@ -24,8 +24,8 @@
     "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"

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,13 @@ 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>;

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

@@ -0,0 +1,18 @@
+/** CgBI PNG 处理工具*/
+/**
+ * 将 iOS CgBI PNG 转换为标准 PNG
+ * CgBI 是 iOS 特有的 PNG 优化格式，在 PNG 签名后插入了 CgBI 坊块
+ * 标准 PNG 解码器无法正确处理这种格式
+ *
+ * @param arrayBuffer - PNG 文件的 ArrayBuffer 数据
+ * @returns 修复后的 ArrayBuffer
+ */
+export declare function fixCgbiPng(arrayBuffer: ArrayBuffer): ArrayBuffer;
+/**
+ * 检查 ArrayBuffer 是否为 CgBI PNG
+ */
+export declare function isCgbiPng(arrayBuffer: ArrayBuffer): boolean;
+/**
+ * 将 ArrayBuffer 转换为 Base64 字符串
+ */
+export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;