@heybox/hb-sdk 0.8.0-alpha.9 → 0.8.0

package/types/miniapp-manifest/permissions.d.ts

@@ -0,0 +1,37 @@
+import { type MiniProgramPermissionKey, type MiniProgramRuntimePermissionsSnapshot } from '@heybox/hb-sdk-protocol';
+export declare const MINIAPP_PERMISSION_KEYS: readonly ["userInfo", "steamLibrary", "share", "storage", "filesystem", "clipboard", "leaderboard", "network"];
+export type MiniappPermissionKey = MiniProgramPermissionKey;
+export interface SimpleMiniappPermissionDeclaration {
+    enabled: true;
+}
+export interface NetworkMiniappPermissionDeclaration extends SimpleMiniappPermissionDeclaration {
+    useOfficialDomain: boolean;
+}
+export type MiniappPermissionDeclarations = Partial<Record<Exclude<MiniappPermissionKey, 'network'>, SimpleMiniappPermissionDeclaration> & {
+    network: NetworkMiniappPermissionDeclaration;
+}>;
+export interface ParsedMiniappPermissions {
+    declared: boolean;
+    permissions?: MiniappPermissionDeclarations;
+}
+export interface MiniappPermissionView {
+    key: MiniappPermissionKey;
+    access: 'declaration' | 'platform-approval';
+    declared: boolean;
+    approved: boolean | null;
+    requestedConfig?: Record<string, boolean>;
+    approvedConfig?: Record<string, boolean>;
+    effective: boolean;
+    effectiveConfig?: Record<string, boolean>;
+}
+export declare function parseMiniappPermissions(value: unknown, options: {
+    present: boolean;
+    sdkVersion: string;
+    sourceLabel?: string;
+}): ParsedMiniappPermissions;
+export declare function requiresExplicitPermissions(sdkVersion: string): boolean;
+export declare function getMissingPermissionsWarning(sourceLabel?: string): string;
+export declare function composeMiniappRuntimePermissions(local: ParsedMiniappPermissions, approvals: unknown): {
+    runtimePermissions: MiniProgramRuntimePermissionsSnapshot;
+    views: MiniappPermissionView[];
+};

package/types/miniapp-manifest/schema.d.ts

@@ -1,3 +1,4 @@
+import { type MiniappPermissionDeclarations } from './permissions';
 export declare const MINIAPP_TEMPLATE_VERSION = "0.0.0";
 export declare const MINIAPP_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos", "linux"];
 export type MiniappPlatform = (typeof MINIAPP_PLATFORM_VALUES)[number];
@@ -6,6 +7,7 @@ export interface MiniappManifest {
     sdkVersion: string;
     version: string;
     platforms: readonly MiniappPlatform[];
+    permissions?: MiniappPermissionDeclarations;
 }
 export interface ParseMiniappManifestResult {
     manifest: MiniappManifest;
@@ -17,6 +19,9 @@ export declare function validateMiniappManifestVersion(version: unknown, sourceL
 export declare function renderMiniappManifest(manifest: MiniappManifest): string;
 export declare function parseMiniappManifestJson(raw: string, sourceLabel?: string): ParseMiniappManifestResult;
 export declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): {
+    permissions?: Partial<Record<"userInfo" | "steamLibrary" | "share" | "storage" | "filesystem" | "clipboard" | "leaderboard", import("./permissions").SimpleMiniappPermissionDeclaration> & {
+        network: import("./permissions").NetworkMiniappPermissionDeclaration;
+    }> | undefined;
     version: string;
     sdkVersion: string;
     platforms: readonly ("android" | "ios" | "ohos" | "windows" | "macos" | "linux")[];

package/types/vite/index.d.ts

@@ -1,7 +1,9 @@
 import { MINIAPP_PLATFORM_VALUES, type MiniappPlatform } from '../miniapp-manifest/schema';
 export interface MiniappManifestPlugin {
     name: string;
-    config: (config: MiniappManifestUserConfig) => MiniappManifestUserConfig | void;
+    config: (config: MiniappManifestUserConfig, env?: {
+        command: 'build' | 'serve';
+    }) => MiniappManifestUserConfig | void;
     configResolved: (resolved: MiniappManifestResolvedConfig) => void;
     /** Rollup 在构建失败后仍会跑 closeBundle；用 buildEnd 记录真实错误，避免二次校验掩盖原因。 */
     buildEnd: (error?: Error) => void;