@seayoo-web/app-info 0.1.0

package/types/src/utils/pack.info.d.ts

@@ -0,0 +1,154 @@
+export interface HosAppPackInfo {
+    /**
+     * 概要信息，包含应用基本信息和模块列表。
+     */
+    summary: Summary;
+    /**
+     * 包信息列表，描述各个模块的安装和交付配置。
+     */
+    packages: PackageInfo[];
+}
+/**
+ * 概要信息结构
+ */
+export interface Summary {
+    /**
+     * 应用信息。
+     */
+    app: AppInfo;
+    /**
+     * 模块（Module）列表。
+     */
+    modules: ModuleInfo[];
+}
+/**
+ * 应用信息
+ */
+export interface AppInfo {
+    /**
+     * 应用的包名 (Bundle Name)，例如 "com.seayoo.zero.hmos.huawei"。
+     */
+    bundleName: string;
+    /**
+     * 应用类型，例如 "app"。
+     */
+    bundleType: string;
+    /**
+     * 应用版本信息。
+     */
+    version: VersionInfo;
+}
+/**
+ * 版本信息
+ */
+export interface VersionInfo {
+    /**
+     * 版本代码 (Code)，例如 79326。
+     */
+    code: number;
+    /**
+     * 版本名称 (Name)，例如 "1.0.7"。
+     */
+    name: string;
+}
+/**
+ * 模块信息
+ */
+export interface ModuleInfo {
+    /**
+     * 模块的主 Ability 名称，例如 "ComboSDKAbility"。
+     */
+    mainAbility: string;
+    /**
+     * 支持的设备类型列表，例如 ["phone", "tablet", "2in1"]。
+     */
+    deviceType: DeviceType[];
+    /**
+     * 模块包含的 Ability 列表。
+     */
+    abilities: AbilityInfo[];
+    /**
+     * 模块的分发/部署信息。
+     */
+    distro: DistroInfo;
+    /**
+     * API 版本信息。
+     */
+    apiVersion: ApiVersionInfo;
+}
+/**
+ * Ability 信息
+ */
+export interface AbilityInfo {
+    /**
+     * Ability 名称，例如 "ComboSDKAbility"。
+     */
+    name: string;
+    /**
+     * Ability 标签，通常是资源字符串引用，例如 "$string:EntryAbility_label"。
+     */
+    label: string;
+}
+/**
+ * 分发信息
+ */
+export interface DistroInfo {
+    /**
+     * 模块类型，例如 "entry"（入口模块）或 "feature"。
+     */
+    moduleType: "entry" | "feature" | string;
+    /**
+     * 是否支持免安装 (Installation Free)。
+     */
+    installationFree: boolean;
+    /**
+     * 是否随应用安装包交付 (Delivery With Install)。
+     */
+    deliveryWithInstall: boolean;
+    /**
+     * 模块名称，例如 "entry"。
+     */
+    moduleName: string;
+}
+/**
+ * API 版本信息
+ */
+export interface ApiVersionInfo {
+    /**
+     * 兼容的最低 API 版本，例如 16。
+     */
+    compatible: number;
+    /**
+     * 版本发布类型，例如 "Release"。
+     */
+    releaseType: "Release" | "Beta" | string;
+    /**
+     * 目标 API 版本，例如 19。
+     */
+    target: number;
+}
+/**
+ * 包信息（用于描述包文件本身的安装信息）
+ */
+export interface PackageInfo {
+    /**
+     * 支持的设备类型列表。
+     */
+    deviceType: DeviceType[];
+    /**
+     * 模块类型，例如 "entry"。
+     */
+    moduleType: "entry" | "feature" | string;
+    /**
+     * 是否随应用安装包交付。
+     */
+    deliveryWithInstall: boolean;
+    /**
+     * 包的名称，例如 "entry-default"。
+     */
+    name: string;
+}
+/**
+ * 支持的设备类型
+ */
+export type DeviceType = "phone" | "tablet" | "2in1" | "wearable" | "tv" | "car" | string;

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

@@ -0,0 +1,27 @@
+/**
+ * Custom object for representing UIDs (Unique Identifiers) in the plist.
+ */
+export declare class UID {
+    UID: number;
+    constructor(UID: number);
+}
+/** 所有非递归的基本值类型。 */
+export type PlistPrimitive = null | boolean | number | bigint | Date | string | Uint8Array | UID;
+/**
+ * Plist 数组容器类型，其元素是任意 PlistValue。
+ * 使用 interface 而不是 type 可以避免循环引用错误。
+ */
+export interface PlistArray extends Array<PlistValue> {
+}
+/**
+ * Plist 字典容器类型，其键为字符串，值为任意 PlistValue。
+ * 使用 interface 而不是 type 可以避免循环引用错误。
+ */
+export interface PlistDict extends Record<string, PlistValue> {
+}
+/** 所有可能的 Plist 值类型：基本类型、数组或字典。 */
+export type PlistValue = PlistPrimitive | PlistArray | PlistDict;
+/** 最终输出结构：包含顶层对象（通常是 PlistDict 或 PlistArray）的数组。 */
+export interface PlistInfo extends Record<string, PlistValue> {
+}
+export declare function parsePlist(plist: ArrayBuffer): PlistInfo | Error;

package/types/src/utils.d.ts

@@ -0,0 +1,2 @@
+export type FileInput = string | number[] | Uint8Array | ArrayBuffer | Blob | NodeJS.ReadableStream;
+export declare function formatError(e: unknown): Error;