@heybox/hb-sdk-protocol 0.9.1-alpha.1 → 0.9.1-alpha.11

package/types/local-dev-grant.d.ts

@@ -1,63 +0,0 @@
-import { type MiniProgramPermissionKey } from './permission-catalog';
-import { type MiniProgramRuntimePermissionsSnapshot } from './permissions';
-/** 仅供开发工具和 Host 使用；新增权限必须单独评估，不能从平台审批目录自动推导。 */
-export declare const LOCAL_DEV_GRANT_PERMISSION_KEYS: readonly ["network", "companion"];
-export type MiniProgramLocalDevPermissionKey = (typeof LOCAL_DEV_GRANT_PERMISSION_KEYS)[number];
-export type MiniProgramLocalDevGrantEntry = {
-    key: 'network';
-    status: 'enabled';
-    config: {
-        useOfficialDomain: false;
-    };
-} | {
-    key: 'companion';
-    status: 'enabled';
-    config: Record<string, never>;
-};
-/** CLI-owned Dev Context 合同，不属于小程序业务 API 或线上批准快照。 */
-export interface MiniProgramLocalDevGrant {
-    schema_version: 1;
-    revision: number;
-    entries: MiniProgramLocalDevGrantEntry[];
-}
-/** 调用方已校验的本地声明；不存在的权限不会从 grant 获得授权。 */
-export type MiniProgramLocalDevPermissionDeclarations = Partial<Record<MiniProgramPermissionKey, {
-    enabled: boolean;
-    useOfficialDomain?: boolean;
-}>>;
-export type ParsedMiniProgramLocalDevGrant = {
-    valid: true;
-    grant: MiniProgramLocalDevGrant;
-} | {
-    valid: false;
-    grant?: undefined;
-};
-/**
- * 严格解析本地 grant。任何未知字段、重复权限或非法配置都拒绝整份输入。
- * 只校验数据合同；票据、身份、摘要、过期时间和 CLI lease 必须由 Host 另行验证。
- */
-export declare function parseMiniProgramLocalDevGrant(value: unknown): ParsedMiniProgramLocalDevGrant;
-/**
- * 从已校验声明生成批准缺口。Companion 默认不符合资格，由 CLI 确认平台、产物与摘要后显式加入。
- * 空 entries 可保留 revision，不能作为存在临时权限的判断依据。
- */
-export declare function createMiniProgramLocalDevGrant(options: {
-    declaredPermissions: MiniProgramLocalDevPermissionDeclarations;
-    runtimePermissions: unknown;
-    revision: number;
-    eligiblePermissionKeys?: readonly MiniProgramLocalDevPermissionKey[];
-}): MiniProgramLocalDevGrant;
-/**
- * 线上基线先与本地声明求交，再补齐临时权限，返回与输入脱离的普通 Runtime 快照。
- * 调用方只可在当前 Dev Session 已验证且用户接受后传入 grant；本函数不证明其可信来源。
- * 非法 grant 整体降权到基线，已批准配置不会被临时配置覆盖。
- */
-export declare function composeLocalDevRuntimePermissions(options: {
-    declaredPermissions: MiniProgramLocalDevPermissionDeclarations;
-    runtimePermissions: unknown;
-    localDevGrant?: unknown;
-}): {
-    runtimePermissions: MiniProgramRuntimePermissionsSnapshot;
-    temporaryPermissionKeys: MiniProgramLocalDevPermissionKey[];
-    grantValid: boolean;
-};

package/types/native-host-contract.generated.d.ts

@@ -1,18 +0,0 @@
-/** 由 scripts/generate-native-host-contract.mjs 生成，请勿手改。 */
-export declare const MINI_PROGRAM_NATIVE_HOST_PROTOCOL_VERSION: 1;
-export declare const MINI_PROGRAM_NATIVE_HOST_CONTRACT_REVISION: 1;
-export declare const MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES: 65536;
-export declare const MINI_PROGRAM_NATIVE_OPERATIONS: {
-    readonly system: readonly ["describe"];
-    readonly network: readonly ["open", "read", "release", "transfer"];
-    readonly files: readonly ["create", "remove", "exists", "openRead", "openWrite", "read", "release", "write", "stat", "list", "pickFiles", "pickDirectory", "saveFile"];
-};
-export declare const MINI_PROGRAM_NATIVE_HOST_DESCRIPTION: {
-    readonly protocolVersion: 1;
-    readonly contractRevision: 1;
-    readonly operations: {
-        readonly system: readonly ["describe"];
-        readonly network: readonly ["open", "read", "release", "transfer"];
-        readonly files: readonly ["create", "remove", "exists", "openRead", "openWrite", "read", "release", "write", "stat", "list", "pickFiles", "pickDirectory", "saveFile"];
-    };
-};

package/types/native-host.d.ts

@@ -1,147 +0,0 @@
-export { MINI_PROGRAM_NATIVE_CHUNK_MAX_BYTES, MINI_PROGRAM_NATIVE_HOST_CONTRACT_REVISION, MINI_PROGRAM_NATIVE_HOST_DESCRIPTION, MINI_PROGRAM_NATIVE_HOST_PROTOCOL_VERSION, MINI_PROGRAM_NATIVE_OPERATIONS, } from './native-host-contract.generated';
-/** Android WebMessageListener object 与 iOS WKScriptMessageHandler 共用名称。 */
-export declare const MINI_PROGRAM_NATIVE_HOST_OBJECT: "hbMiniProgramHost";
-/** Native 通过主文档 CustomEvent 回送 progress/result/error。 */
-export declare const MINI_PROGRAM_NATIVE_HOST_MESSAGE_EVENT: "heybox:miniprogram-native-host-message";
-export type MiniProgramNativeHostDomain = 'system' | 'network' | 'files';
-/** H5 主文档发给 Native Host 的 operation 请求。 */
-export interface MiniProgramNativeHostRequest {
-    requestId: string;
-    domain: MiniProgramNativeHostDomain;
-    operation: string;
-    payload?: unknown;
-}
-/** 取消独立引用原请求，重复取消必须是幂等操作。 */
-export interface MiniProgramNativeHostCancel {
-    type: 'cancel';
-    requestId: string;
-}
-export interface MiniProgramNativeHostError {
-    code: string;
-    message: string;
-}
-export interface MiniProgramNativeHostDescription {
-    protocolVersion: number;
-    contractRevision: number;
-    operations: Readonly<Record<MiniProgramNativeHostDomain, readonly string[]>>;
-}
-export type MiniProgramNativeHostMessage = {
-    requestId: string;
-    type: 'progress';
-    payload: unknown;
-} | {
-    requestId: string;
-    type: 'result';
-    payload?: unknown;
-} | {
-    requestId: string;
-    type: 'error';
-    error: MiniProgramNativeHostError;
-};
-export interface MiniProgramNativeBinaryChunk {
-    resourceId: string;
-    data: string;
-    byteLength: number;
-    eof: boolean;
-}
-export type MiniProgramNativeFileRef = {
-    scope: 'sandbox';
-    kind: 'file' | 'directory';
-    relativePath: string;
-} | {
-    scope: 'grant';
-    id: string;
-    kind: 'file' | 'directory';
-    relativePath: string;
-};
-export interface MiniProgramNativeFileDescriptor {
-    kind: 'file' | 'directory';
-    mode: 'read' | 'readwrite';
-    name: string;
-    ref: MiniProgramNativeFileRef;
-}
-export interface MiniProgramNativeNetworkOpenPayload {
-    purpose: 'request' | 'download';
-    url: string;
-    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
-    params?: Record<string, unknown>;
-    data?: unknown;
-    headers?: Record<string, string>;
-    bodyEncoding?: 'json' | 'form';
-    timeoutMs: number;
-}
-export interface MiniProgramNativeNetworkOpenResult {
-    status: number;
-    statusText?: string;
-    headers: Record<string, string[]>;
-    resourceId: string;
-}
-export interface MiniProgramNativeNetworkReadPayload {
-    resourceId: string;
-    maxBytes: number;
-}
-export interface MiniProgramNativeNetworkReleasePayload {
-    resourceId: string;
-}
-export interface MiniProgramNativeNetworkTransferPayload {
-    resourceId: string;
-    target: MiniProgramNativeFileRef;
-    mode: 'replace-existing' | 'create-exclusive' | 'upsert';
-    maxBytes?: number;
-    expectedBytes?: number;
-}
-export interface MiniProgramNativeNetworkTransferResult {
-    committedBytes: number;
-}
-export interface MiniProgramNativeFilesCreatePayload {
-    ref: MiniProgramNativeFileRef;
-    recursive: boolean;
-    exclusive: boolean;
-}
-export interface MiniProgramNativeFilesRemovePayload {
-    ref: MiniProgramNativeFileRef;
-    recursive?: boolean;
-}
-export interface MiniProgramNativeFilesRefPayload {
-    ref: MiniProgramNativeFileRef;
-}
-export interface MiniProgramNativeFilesOpenPayload extends MiniProgramNativeFilesRefPayload {
-    maxBytes: number;
-}
-export interface MiniProgramNativeFilesOpenResult {
-    resourceId: string;
-}
-/** openWrite 后按序发送；eof=true 的最后一块触发 atomic commit。 */
-export interface MiniProgramNativeFilesWritePayload extends MiniProgramNativeBinaryChunk {
-}
-export type MiniProgramNativeFilesStatResult = {
-    kind: 'file';
-    size: number;
-    modifiedAt?: number;
-    createdAt?: number;
-} | {
-    kind: 'directory';
-    modifiedAt?: number;
-    createdAt?: number;
-};
-export interface MiniProgramNativeFilesListPayload extends MiniProgramNativeFilesRefPayload {
-    limit: number;
-}
-export interface MiniProgramNativeFilesPickFilesPayload {
-    mode: 'read' | 'readwrite';
-    accept?: string[];
-    multiple: boolean;
-}
-export interface MiniProgramNativeFilesPickDirectoryPayload {
-    mode: 'read' | 'readwrite';
-}
-export interface MiniProgramNativeFilesSaveFilePayload {
-    suggestedName: string;
-}
-export interface MiniProgramNativeTransferProgress {
-    resourceId: string;
-    loaded: number;
-}
-export declare function isMiniProgramNativeHostMessage(value: unknown): value is MiniProgramNativeHostMessage;
-export declare function isMiniProgramNativeHostDescription(value: unknown): value is MiniProgramNativeHostDescription;
-export declare function isMiniProgramNativeBinaryChunk(value: unknown): value is MiniProgramNativeBinaryChunk;