@heybox/hb-sdk 0.8.1-alpha.2 → 0.8.1-alpha.6

package/dist/index.esm.js

@@ -560,6 +560,18 @@ function restoreMethod(history, name, patchedValue, original) {
     }
 }
 
+const MINI_PROGRAM_MESSAGE_NAMESPACE = 'heybox:miniprogram';
+const MINI_PROGRAM_MESSAGE_VERSION = 2;
+const MINI_PROGRAM_BRIDGE_NONCE_PARAM = 'hb_mini_bridge_nonce';
+const SDK_HANDSHAKE_METHOD = 'sdk.handshake';
+const RUNTIME_LOCATION_PROBE_METHOD = 'runtime.location.probe';
+const SDK_LOCATION_REPORT_METHOD = 'sdk.location.report';
+const SDK_CSP_VIOLATION_METHOD = 'sdk.csp.violation';
+const MINI_PROGRAM_OPERATION_PROGRESS_METHOD = 'operation.progress';
+const COMPANION_SESSION_OUTPUT_EVENT = 'companion.session.output';
+const COMPANION_SESSION_EXIT_EVENT = 'companion.session.exit';
+const COMPANION_SESSION_OWNERSHIP_LOST_EVENT = 'companion.session.ownershipLost';
+
 const AUTH_LOGIN_METHOD = 'auth.login';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
@@ -601,15 +613,18 @@ const CLOUD_LEADERBOARD_GET_LIST_METHOD = 'cloud.leaderboard.getList';
 const CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.getCurrentUserEntry';
 const CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = 'cloud.leaderboard.deleteCurrentUserEntry';
 const CLOUD_LEADERBOARD_GET_INFO_METHOD = 'cloud.leaderboard.getInfo';
-
-const MINI_PROGRAM_MESSAGE_NAMESPACE = 'heybox:miniprogram';
-const MINI_PROGRAM_MESSAGE_VERSION = 2;
-const MINI_PROGRAM_BRIDGE_NONCE_PARAM = 'hb_mini_bridge_nonce';
-const SDK_HANDSHAKE_METHOD = 'sdk.handshake';
-const RUNTIME_LOCATION_PROBE_METHOD = 'runtime.location.probe';
-const SDK_LOCATION_REPORT_METHOD = 'sdk.location.report';
-const SDK_CSP_VIOLATION_METHOD = 'sdk.csp.violation';
-const MINI_PROGRAM_OPERATION_PROGRESS_METHOD = 'operation.progress';
+const COMPANION_GET_INFO_METHOD = 'companion.getInfo';
+const COMPANION_GET_PREPARATION_STATUS_METHOD = 'companion.getPreparationStatus';
+const COMPANION_PREPARE_METHOD = 'companion.prepare';
+const COMPANION_CANCEL_PREPARATION_METHOD = 'companion.cancelPreparation';
+const COMPANION_GET_ACTIVE_SESSION_METHOD = 'companion.getActiveSession';
+const COMPANION_LAUNCH_METHOD = 'companion.launch';
+const COMPANION_SESSION_WRITE_METHOD = 'companion.session.write';
+const COMPANION_SESSION_CLOSE_STDIN_METHOD = 'companion.session.closeStdin';
+const COMPANION_SESSION_TERMINATE_METHOD = 'companion.session.terminate';
+const COMPANION_SESSION_ACK_OUTPUT_METHOD = 'companion.session.ackOutput';
+const COMPANION_OPEN_ATTACHMENT_METHOD = 'companion.openAttachment';
+const COMPANION_SHOW_NOTIFICATION_METHOD = 'companion.showNotification';
 
 function isMiniProgramBridgeMessage(value) {
     if (!isRecord$1(value))
@@ -632,7 +647,7 @@ function isMiniProgramBridgeMessage(value) {
         if (!isNonEmptyString(value.method) || value.error !== undefined)
             return false;
         if (value.method === MINI_PROGRAM_OPERATION_PROGRESS_METHOD) {
-            return value.version === 2 && isNonEmptyString(value.id) && isMiniProgramDownloadProgressPayload(value.payload);
+            return value.version === 2 && isNonEmptyString(value.id) && isMiniProgramOperationProgressPayload(value.payload);
         }
         return value.id === undefined || isNonEmptyString(value.id);
     }
@@ -670,7 +685,7 @@ function isMiniProgramDirectoryRef(value) {
     if (isNonEmptyString(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
     }
-    return (isMiniProgramPathRootRef(value.root) && isMiniProgramRelativePath(value.relativePath) && hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
+    return (isMiniProgramPathRootRef(value.root) && (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) && hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
 }
 function isMiniProgramByteArray(value) {
     return value instanceof Uint8Array && value.buffer instanceof ArrayBuffer;
@@ -694,6 +709,24 @@ function isMiniProgramDownloadProgressPayload(value) {
         return value.total === undefined;
     return isNonNegativeSafeInteger(value.total) && value.loaded <= value.total;
 }
+function isMiniProgramCompanionPrepareProgress(value) {
+    if (!isRecord$1(value))
+        return false;
+    if (value.phase === 'downloading') {
+        return (isNonNegativeSafeInteger(value.loaded) &&
+            (value.total === undefined || (isNonNegativeSafeInteger(value.total) && value.loaded <= value.total)) &&
+            hasOnlyKeys(value, ['phase', 'loaded', 'total']));
+    }
+    if (value.phase !== 'verifying' && value.phase !== 'extracting')
+        return false;
+    return (isNonNegativeSafeInteger(value.processed) &&
+        isNonNegativeSafeInteger(value.total) &&
+        value.processed <= value.total &&
+        hasOnlyKeys(value, ['phase', 'processed', 'total']));
+}
+function isMiniProgramOperationProgressPayload(value) {
+    return isMiniProgramDownloadProgressPayload(value) || isMiniProgramCompanionPrepareProgress(value);
+}
 function isSDKHandshakePayload(value) {
     return isRecord$1(value) && isNonEmptyString(value.href) && typeof value.userAgent === 'string' && isNonEmptyString(value.sdkVersion);
 }
@@ -719,6 +752,8 @@ function isRecord$1(value) {
 
 /** 当前用户信息与登录能力支持的完整 scope 目录。 */
 const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile'];
+/** Companion alias 的跨构建、Runtime 与 Host 规范。 */
+const COMPANION_ALIAS_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
 
 const MINI_PROGRAM_PERMISSION_KEYS = [
     'userInfo',
@@ -729,6 +764,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'clipboard',
     'leaderboard',
     'network',
+    'companion',
 ];
 new Set(MINI_PROGRAM_PERMISSION_KEYS);
 
@@ -795,7 +831,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.1-alpha.2';
+    : '0.8.1-alpha.6';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -968,11 +1004,23 @@ class MiniProgramBridgeClient {
             method,
             payload,
         };
+        const startedAt = Date.now();
+        const report = (outcome, error) => {
+            if (typeof false === 'undefined' || !false)
+                return;
+            try {
+                const target = this.selfWindow;
+                const errorCode = error instanceof HbMiniProgramSDKError ? error.code : undefined;
+                target?.__hbSdkDeviceLog?.({ method, callId: id, outcome, durationMs: Date.now() - startedAt, errorCode });
+            }
+            catch { /* 调试输出不能改变 SDK 调用结果。 */ }
+        };
         return new Promise((resolve, reject) => {
             const pending = {
                 resolve: resolve,
                 reject,
                 isOperation: !useTimeout,
+                cancelOnAbort: options.cancelOnAbort !== false,
                 ...(options.onProgress ? { onProgress: options.onProgress } : {}),
                 ...(options.signal ? { signal: options.signal } : {}),
             };
@@ -998,17 +1046,23 @@ class MiniProgramBridgeClient {
                 return;
             }
             if (options.signal) {
-                pending.abortHandler = () => this.sendCancel(id);
+                pending.abortHandler = () => {
+                    if (pending.cancelOnAbort)
+                        this.sendCancel(id);
+                };
                 options.signal.addEventListener('abort', pending.abortHandler, { once: true });
                 if (options.signal.aborted) {
                     pending.abortHandler();
                 }
             }
-        });
+        }).then(value => { report('success'); return value; }, error => { report('error', error); throw error; });
     }
     /** 销毁 SDK 实例，并拒绝尚未完成的请求。 */
     destroy() {
-        this.pendingRequests.forEach((_pending, id) => this.sendCancel(id));
+        this.pendingRequests.forEach((pending, id) => {
+            if (pending.cancelOnAbort)
+                this.sendCancel(id);
+        });
         this.destroyed = true;
         this.selfWindow?.removeEventListener('message', this.handleMessage);
         this.selfWindow?.removeEventListener('popstate', this.handlePopState);
@@ -1350,1648 +1404,1908 @@ function createCloudModule(requester) {
     };
 }
 
-/**
- * 复制当前小程序的通用分享链接。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 分享扩展数据；不传时复制默认首页链接。
- * @returns 已写入系统剪贴板的完整分享链接。
- * @throws {@link HbMiniProgramSDKError} 当参数、bridge、父容器或剪贴板能力调用失败时抛出。
- */
-function copyLink(requester, options) {
-    return requester.request(SHARE_COPY_LINK_METHOD, options);
+const registries = new WeakMap();
+const brandedFileSystemValues = new WeakSet();
+const CONTROL_CHARACTER_PATTERN = /[\u0000-\u001f\u007f]/;
+function invalidParams$1(message, data) {
+    return createSDKError('INVALID_PARAMS', message, data);
 }
-
-// Integer Utility
-var UINT32_MAX = 4294967295;
-function setInt64(view, offset, value) {
-    var high = Math.floor(value / 4294967296);
-    var low = value; // high bits are truncated by DataView
-    view.setUint32(offset, high);
-    view.setUint32(offset + 4, low);
+function clonePathRootRef(ref) {
+    return ref.kind === 'sandbox' ? Object.freeze({ kind: 'sandbox' }) : Object.freeze({ kind: 'directory', handleId: ref.handleId });
 }
-function getInt64(view, offset) {
-    var high = view.getInt32(offset);
-    var low = view.getUint32(offset + 4);
-    return high * 4294967296 + low;
+function cloneFileRef(ref) {
+    return 'handleId' in ref
+        ? Object.freeze({ kind: 'file', handleId: ref.handleId })
+        : Object.freeze({
+            kind: 'file',
+            root: clonePathRootRef(ref.root),
+            relativePath: ref.relativePath,
+        });
 }
-function getUint64(view, offset) {
-    var high = view.getUint32(offset);
-    var low = view.getUint32(offset + 4);
-    return high * 4294967296 + low;
+function cloneDirectoryRef(ref) {
+    return 'handleId' in ref
+        ? Object.freeze({ kind: 'directory', handleId: ref.handleId })
+        : Object.freeze({
+            kind: 'directory',
+            root: clonePathRootRef(ref.root),
+            relativePath: ref.relativePath,
+        });
 }
-
-var _a, _b, _c;
-var TEXT_ENCODING_AVAILABLE = (typeof process === "undefined" || ((_a = process === null || process === void 0 ? void 0 : process.env) === null || _a === void 0 ? void 0 : _a["TEXT_ENCODING"]) !== "never") &&
-    typeof TextEncoder !== "undefined" &&
-    typeof TextDecoder !== "undefined";
-var sharedTextEncoder = TEXT_ENCODING_AVAILABLE ? new TextEncoder() : undefined;
-!TEXT_ENCODING_AVAILABLE
-    ? UINT32_MAX
-    : typeof process !== "undefined" && ((_b = process === null || process === void 0 ? void 0 : process.env) === null || _b === void 0 ? void 0 : _b["TEXT_ENCODING"]) !== "force"
-        ? 200
-        : 0;
-function utf8EncodeTEencode(str, output, outputOffset) {
-    output.set(sharedTextEncoder.encode(str), outputOffset);
+function assertMode(mode) {
+    if (mode !== 'read' && mode !== 'readwrite') {
+        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文件访问模式');
+    }
 }
-function utf8EncodeTEencodeInto(str, output, outputOffset) {
-    sharedTextEncoder.encodeInto(str, output.subarray(outputOffset));
+function assertName(name) {
+    if (typeof name !== 'string' || name.length === 0 || name.includes('/') || name.includes('\\') || CONTROL_CHARACTER_PATTERN.test(name)) {
+        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文件名');
+    }
 }
-(sharedTextEncoder === null || sharedTextEncoder === void 0 ? void 0 : sharedTextEncoder.encodeInto) ? utf8EncodeTEencodeInto : utf8EncodeTEencode;
-var CHUNK_SIZE = 4096;
-function utf8DecodeJs(bytes, inputOffset, byteLength) {
-    var offset = inputOffset;
-    var end = offset + byteLength;
-    var units = [];
-    var result = "";
-    while (offset < end) {
-        var byte1 = bytes[offset++];
-        if ((byte1 & 0x80) === 0) {
-            // 1 byte
-            units.push(byte1);
-        }
-        else if ((byte1 & 0xe0) === 0xc0) {
-            // 2 bytes
-            var byte2 = bytes[offset++] & 0x3f;
-            units.push(((byte1 & 0x1f) << 6) | byte2);
-        }
-        else if ((byte1 & 0xf0) === 0xe0) {
-            // 3 bytes
-            var byte2 = bytes[offset++] & 0x3f;
-            var byte3 = bytes[offset++] & 0x3f;
-            units.push(((byte1 & 0x1f) << 12) | (byte2 << 6) | byte3);
-        }
-        else if ((byte1 & 0xf8) === 0xf0) {
-            // 4 bytes
-            var byte2 = bytes[offset++] & 0x3f;
-            var byte3 = bytes[offset++] & 0x3f;
-            var byte4 = bytes[offset++] & 0x3f;
-            var unit = ((byte1 & 0x07) << 0x12) | (byte2 << 0x0c) | (byte3 << 0x06) | byte4;
-            if (unit > 0xffff) {
-                unit -= 0x10000;
-                units.push(((unit >>> 10) & 0x3ff) | 0xd800);
-                unit = 0xdc00 | (unit & 0x3ff);
-            }
-            units.push(unit);
-        }
-        else {
-            units.push(byte1);
-        }
-        if (units.length >= CHUNK_SIZE) {
-            result += String.fromCharCode.apply(String, units);
-            units.length = 0;
-        }
+function assertFileRef(ref) {
+    if (!isMiniProgramFileRef(ref)) {
+        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 File handle');
     }
-    if (units.length > 0) {
-        result += String.fromCharCode.apply(String, units);
+}
+function assertDirectoryRef(ref) {
+    if (!isMiniProgramDirectoryRef(ref)) {
+        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 Directory handle');
     }
-    return result;
 }
-var sharedTextDecoder = TEXT_ENCODING_AVAILABLE ? new TextDecoder() : null;
-var TEXT_DECODER_THRESHOLD = !TEXT_ENCODING_AVAILABLE
-    ? UINT32_MAX
-    : typeof process !== "undefined" && ((_c = process === null || process === void 0 ? void 0 : process.env) === null || _c === void 0 ? void 0 : _c["TEXT_DECODER"]) !== "force"
-        ? 200
-        : 0;
-function utf8DecodeTD(bytes, inputOffset, byteLength) {
-    var stringBytes = bytes.subarray(inputOffset, inputOffset + byteLength);
-    return sharedTextDecoder.decode(stringBytes);
+function defineReadonlyValue(target, key, value, enumerable = true) {
+    Object.defineProperty(target, key, {
+        value,
+        enumerable,
+        configurable: false,
+        writable: false,
+    });
 }
-
-/**
- * ExtData is used to handle Extension Types that are not registered to ExtensionCodec.
- */
-var ExtData = /** @class */ (function () {
-    function ExtData(type, data) {
-        this.type = type;
-        this.data = data;
+function joinRelativePath(prefix, relativePath) {
+    if (relativePath === '.')
+        return prefix || '.';
+    if (prefix === '.')
+        return relativePath;
+    return prefix ? `${prefix}/${relativePath}` : relativePath;
+}
+function basename(relativePath) {
+    const segments = relativePath.split('/');
+    return segments[segments.length - 1];
+}
+function assertWritable(mode) {
+    if (mode !== 'readwrite') {
+        throw createSDKError('FILE_ACCESS_DENIED', '当前文件句柄不允许写入');
     }
-    return ExtData;
-}());
-
-var __extends = (undefined && undefined.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+}
+function assertSandboxRef(ref) {
+    if ('handleId' in ref || ref.root.kind !== 'sandbox') {
+        throw createSDKError('FILE_ACCESS_DENIED', '外部文件授权不允许删除');
+    }
+}
+function normalizeCreateOptions(options) {
+    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
+        throw invalidParams$1('create options 必须是对象');
+    }
+    if (options?.recursive !== undefined && typeof options.recursive !== 'boolean') {
+        throw invalidParams$1('recursive 必须是 boolean');
+    }
+    if (options?.exclusive !== undefined && typeof options.exclusive !== 'boolean') {
+        throw invalidParams$1('exclusive 必须是 boolean');
+    }
+    return {
+        recursive: options?.recursive ?? false,
+        exclusive: options?.exclusive ?? false,
     };
-})();
-var DecodeError = /** @class */ (function (_super) {
-    __extends(DecodeError, _super);
-    function DecodeError(message) {
-        var _this = _super.call(this, message) || this;
-        // fix the prototype chain in a cross-platform way
-        var proto = Object.create(DecodeError.prototype);
-        Object.setPrototypeOf(_this, proto);
-        Object.defineProperty(_this, "name", {
-            configurable: true,
-            enumerable: false,
-            value: DecodeError.name,
-        });
-        return _this;
+}
+function normalizeListOptions(options) {
+    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
+        throw invalidParams$1('list options 必须是对象');
     }
-    return DecodeError;
-}(Error));
-
-// https://github.com/msgpack/msgpack/blob/master/spec.md#timestamp-extension-type
-var EXT_TIMESTAMP = -1;
-var TIMESTAMP32_MAX_SEC = 0x100000000 - 1; // 32-bit unsigned int
-var TIMESTAMP64_MAX_SEC = 0x400000000 - 1; // 34-bit unsigned int
-function encodeTimeSpecToTimestamp(_a) {
-    var sec = _a.sec, nsec = _a.nsec;
-    if (sec >= 0 && nsec >= 0 && sec <= TIMESTAMP64_MAX_SEC) {
-        // Here sec >= 0 && nsec >= 0
-        if (nsec === 0 && sec <= TIMESTAMP32_MAX_SEC) {
-            // timestamp 32 = { sec32 (unsigned) }
-            var rv = new Uint8Array(4);
-            var view = new DataView(rv.buffer);
-            view.setUint32(0, sec);
-            return rv;
-        }
-        else {
-            // timestamp 64 = { nsec30 (unsigned), sec34 (unsigned) }
-            var secHigh = sec / 0x100000000;
-            var secLow = sec & 0xffffffff;
-            var rv = new Uint8Array(8);
-            var view = new DataView(rv.buffer);
-            // nsec30 | secHigh2
-            view.setUint32(0, (nsec << 2) | (secHigh & 0x3));
-            // secLow32
-            view.setUint32(4, secLow);
-            return rv;
-        }
-    }
-    else {
-        // timestamp 96 = { nsec32 (unsigned), sec64 (signed) }
-        var rv = new Uint8Array(12);
-        var view = new DataView(rv.buffer);
-        view.setUint32(0, nsec);
-        setInt64(view, 4, sec);
-        return rv;
+    if (options?.limit !== undefined && (!Number.isSafeInteger(options.limit) || options.limit <= 0)) {
+        throw invalidParams$1('limit 必须是正的 safe integer');
     }
+    return options?.limit;
 }
-function encodeDateToTimeSpec(date) {
-    var msec = date.getTime();
-    var sec = Math.floor(msec / 1e3);
-    var nsec = (msec - sec * 1e3) * 1e6;
-    // Normalizes { sec, nsec } to ensure nsec is unsigned.
-    var nsecInSec = Math.floor(nsec / 1e9);
-    return {
-        sec: sec + nsecInSec,
-        nsec: nsec - nsecInSec * 1e9,
-    };
-}
-function encodeTimestampExtension(object) {
-    if (object instanceof Date) {
-        var timeSpec = encodeDateToTimeSpec(object);
-        return encodeTimeSpecToTimestamp(timeSpec);
+function normalizeRemoveOptions(options) {
+    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
+        throw invalidParams$1('remove options 必须是对象');
     }
-    else {
-        return null;
+    if (options?.recursive !== undefined && typeof options.recursive !== 'boolean') {
+        throw invalidParams$1('recursive 必须是 boolean');
     }
+    return { recursive: options?.recursive ?? false };
 }
-function decodeTimestampToTimeSpec(data) {
-    var view = new DataView(data.buffer, data.byteOffset, data.byteLength);
-    // data may be 32, 64, or 96 bits
-    switch (data.byteLength) {
-        case 4: {
-            // timestamp 32 = { sec32 }
-            var sec = view.getUint32(0);
-            var nsec = 0;
-            return { sec: sec, nsec: nsec };
-        }
-        case 8: {
-            // timestamp 64 = { nsec30, sec34 }
-            var nsec30AndSecHigh2 = view.getUint32(0);
-            var secLow32 = view.getUint32(4);
-            var sec = (nsec30AndSecHigh2 & 0x3) * 0x100000000 + secLow32;
-            var nsec = nsec30AndSecHigh2 >>> 2;
-            return { sec: sec, nsec: nsec };
-        }
-        case 12: {
-            // timestamp 96 = { nsec32 (unsigned), sec64 (signed) }
-            var sec = getInt64(view, 4);
-            var nsec = view.getUint32(0);
-            return { sec: sec, nsec: nsec };
-        }
-        default:
-            throw new DecodeError("Unrecognized data size for timestamp (expected 4, 8, or 12): ".concat(data.length));
+function cloneBytes$1(content) {
+    if (!(content instanceof Uint8Array)) {
+        throw invalidParams$1('content 必须是 Uint8Array');
     }
+    if (typeof SharedArrayBuffer !== 'undefined' && content.buffer instanceof SharedArrayBuffer) {
+        throw invalidParams$1('content 不能由 SharedArrayBuffer 承载');
+    }
+    return new Uint8Array(content);
 }
-function decodeTimestampExtension(data) {
-    var timeSpec = decodeTimestampToTimeSpec(data);
-    return new Date(timeSpec.sec * 1e3 + timeSpec.nsec / 1e6);
-}
-var timestampExtension = {
-    type: EXT_TIMESTAMP,
-    encode: encodeTimestampExtension,
-    decode: decodeTimestampExtension,
-};
-
-// ExtensionCodec to handle MessagePack extensions
-var ExtensionCodec = /** @class */ (function () {
-    function ExtensionCodec() {
-        // built-in extensions
-        this.builtInEncoders = [];
-        this.builtInDecoders = [];
-        // custom extensions
-        this.encoders = [];
-        this.decoders = [];
-        this.register(timestampExtension);
+function normalizeStat(stat) {
+    if (!isMiniProgramFileStat(stat)) {
+        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 FileStat');
     }
-    ExtensionCodec.prototype.register = function (_a) {
-        var type = _a.type, encode = _a.encode, decode = _a.decode;
-        if (type >= 0) {
-            // custom extensions
-            this.encoders[type] = encode;
-            this.decoders[type] = decode;
-        }
-        else {
-            // built-in extensions
-            var index = 1 + type;
-            this.builtInEncoders[index] = encode;
-            this.builtInDecoders[index] = decode;
-        }
-    };
-    ExtensionCodec.prototype.tryToEncode = function (object, context) {
-        // built-in extensions
-        for (var i = 0; i < this.builtInEncoders.length; i++) {
-            var encodeExt = this.builtInEncoders[i];
-            if (encodeExt != null) {
-                var data = encodeExt(object, context);
-                if (data != null) {
-                    var type = -1 - i;
-                    return new ExtData(type, data);
-                }
-            }
-        }
-        // custom extensions
-        for (var i = 0; i < this.encoders.length; i++) {
-            var encodeExt = this.encoders[i];
-            if (encodeExt != null) {
-                var data = encodeExt(object, context);
-                if (data != null) {
-                    var type = i;
-                    return new ExtData(type, data);
-                }
-            }
-        }
-        if (object instanceof ExtData) {
-            // to keep ExtData as is
-            return object;
-        }
-        return null;
-    };
-    ExtensionCodec.prototype.decode = function (data, type, context) {
-        var decodeExt = type < 0 ? this.builtInDecoders[-1 - type] : this.decoders[type];
-        if (decodeExt) {
-            return decodeExt(data, type, context);
-        }
-        else {
-            // decode() does not fail, returns ExtData instead.
-            return new ExtData(type, data);
-        }
+    return {
+        kind: 'file',
+        size: stat.size,
+        ...(stat.modifiedAt === undefined ? {} : { modifiedAt: stat.modifiedAt }),
+        ...(stat.createdAt === undefined ? {} : { createdAt: stat.createdAt }),
     };
-    ExtensionCodec.defaultCodec = new ExtensionCodec();
-    return ExtensionCodec;
-}());
-
-function ensureUint8Array(buffer) {
-    if (buffer instanceof Uint8Array) {
-        return buffer;
-    }
-    else if (ArrayBuffer.isView(buffer)) {
-        return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
-    }
-    else if (buffer instanceof ArrayBuffer) {
-        return new Uint8Array(buffer);
-    }
-    else {
-        // ArrayLike<number>
-        return Uint8Array.from(buffer);
-    }
 }
-function createDataView(buffer) {
-    if (buffer instanceof ArrayBuffer) {
-        return new DataView(buffer);
+/** 校验并返回平台无关的 `/` 分隔逻辑相对路径。 */
+function normalizeRelativePath(value) {
+    if (!isMiniProgramRelativePath(value)) {
+        throw invalidParams$1('relativePath 必须是规范的 `/` 分隔逻辑相对路径');
     }
-    var bufferView = ensureUint8Array(buffer);
-    return new DataView(bufferView.buffer, bufferView.byteOffset, bufferView.byteLength);
-}
-
-function prettyByte(byte) {
-    return "".concat(byte < 0 ? "-" : "", "0x").concat(Math.abs(byte).toString(16).padStart(2, "0"));
+    return value;
 }
-
-var DEFAULT_MAX_KEY_LENGTH = 16;
-var DEFAULT_MAX_LENGTH_PER_KEY = 16;
-var CachedKeyDecoder = /** @class */ (function () {
-    function CachedKeyDecoder(maxKeyLength, maxLengthPerKey) {
-        if (maxKeyLength === void 0) { maxKeyLength = DEFAULT_MAX_KEY_LENGTH; }
-        if (maxLengthPerKey === void 0) { maxLengthPerKey = DEFAULT_MAX_LENGTH_PER_KEY; }
-        this.maxKeyLength = maxKeyLength;
-        this.maxLengthPerKey = maxLengthPerKey;
-        this.hit = 0;
-        this.miss = 0;
-        // avoid `new Array(N)`, which makes a sparse array,
-        // because a sparse array is typically slower than a non-sparse array.
-        this.caches = [];
-        for (var i = 0; i < this.maxKeyLength; i++) {
-            this.caches.push([]);
-        }
+class MiniProgramFileHandleRegistry {
+    requester;
+    fileStates = new WeakMap();
+    directoryStates = new WeakMap();
+    pathRootStates = new WeakMap();
+    sandboxRoot;
+    constructor(requester) {
+        this.requester = requester;
     }
-    CachedKeyDecoder.prototype.canBeCached = function (byteLength) {
-        return byteLength > 0 && byteLength <= this.maxKeyLength;
-    };
-    CachedKeyDecoder.prototype.find = function (bytes, inputOffset, byteLength) {
-        var records = this.caches[byteLength - 1];
-        FIND_CHUNK: for (var _i = 0, records_1 = records; _i < records_1.length; _i++) {
-            var record = records_1[_i];
-            var recordBytes = record.bytes;
-            for (var j = 0; j < byteLength; j++) {
-                if (recordBytes[j] !== bytes[inputOffset + j]) {
-                    continue FIND_CHUNK;
-                }
-            }
-            return record.str;
-        }
-        return null;
-    };
-    CachedKeyDecoder.prototype.store = function (bytes, value) {
-        var records = this.caches[bytes.length - 1];
-        var record = { bytes: bytes, str: value };
-        if (records.length >= this.maxLengthPerKey) {
-            // `records` are full!
-            // Set `record` to an arbitrary position.
-            records[(Math.random() * records.length) | 0] = record;
-        }
-        else {
-            records.push(record);
+    getSandbox() {
+        if (this.sandboxRoot) {
+            return this.sandboxRoot;
         }
-    };
-    CachedKeyDecoder.prototype.decode = function (bytes, inputOffset, byteLength) {
-        var cachedValue = this.find(bytes, inputOffset, byteLength);
-        if (cachedValue != null) {
-            this.hit++;
-            return cachedValue;
-        }
-        this.miss++;
-        var str = utf8DecodeJs(bytes, inputOffset, byteLength);
-        // Ensure to copy a slice of bytes because the byte may be NodeJS Buffer and Buffer#slice() returns a reference to its internal ArrayBuffer.
-        var slicedCopyOfBytes = Uint8Array.prototype.slice.call(bytes, inputOffset, inputOffset + byteLength);
-        this.store(slicedCopyOfBytes, str);
-        return str;
-    };
-    return CachedKeyDecoder;
-}());
-
-var __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (undefined && undefined.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+        const sandbox = {};
+        const state = {
+            root: Object.freeze({ kind: 'sandbox' }),
+            prefix: '',
+            mode: 'readwrite',
+        };
+        this.definePathRootMethods(sandbox, state);
+        this.pathRootStates.set(sandbox, state);
+        brandedFileSystemValues.add(sandbox);
+        this.sandboxRoot = Object.freeze(sandbox);
+        return this.sandboxRoot;
     }
-};
-var __asyncValues = (undefined && undefined.__asyncValues) || function (o) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
-    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
-    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
-};
-var __await = (undefined && undefined.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); };
-var __asyncGenerator = (undefined && undefined.__asyncGenerator) || function (thisArg, _arguments, generator) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var g = generator.apply(thisArg, _arguments || []), i, q = [];
-    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
-    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
-    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
-    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
-    function fulfill(value) { resume("next", value); }
-    function reject(value) { resume("throw", value); }
-    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
-};
-var isValidMapKeyType = function (key) {
-    var keyType = typeof key;
-    return keyType === "string" || keyType === "number";
-};
-var HEAD_BYTE_REQUIRED = -1;
-var EMPTY_VIEW = new DataView(new ArrayBuffer(0));
-var EMPTY_BYTES = new Uint8Array(EMPTY_VIEW.buffer);
-// IE11: Hack to support IE11.
-// IE11: Drop this hack and just use RangeError when IE11 is obsolete.
-var DataViewIndexOutOfBoundsError = (function () {
-    try {
-        // IE11: The spec says it should throw RangeError,
-        // IE11: but in IE11 it throws TypeError.
-        EMPTY_VIEW.getInt8(0);
+    createFile(descriptor) {
+        this.assertFileDescriptor(descriptor);
+        const ref = cloneFileRef(descriptor.ref);
+        const state = { ref, mode: descriptor.mode };
+        const handle = {};
+        defineReadonlyValue(handle, 'kind', 'file');
+        defineReadonlyValue(handle, 'name', descriptor.name);
+        defineReadonlyValue(handle, 'mode', descriptor.mode);
+        defineReadonlyValue(handle, 'create', async (options) => {
+            assertWritable(state.mode);
+            await this.requester.request(FILE_CREATE_METHOD, {
+                target: state.ref,
+                ...normalizeCreateOptions(options),
+            });
+            return handle;
+        }, false);
+        defineReadonlyValue(handle, 'remove', async () => {
+            assertWritable(state.mode);
+            assertSandboxRef(state.ref);
+            await this.requester.request(FILE_REMOVE_METHOD, { target: state.ref });
+        }, false);
+        defineReadonlyValue(handle, 'exists', async () => {
+            const result = await this.requester.request(FILE_EXISTS_METHOD, { target: state.ref });
+            if (typeof result !== 'boolean') {
+                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 exists 结果');
+            }
+            return result;
+        }, false);
+        defineReadonlyValue(handle, 'readText', async () => {
+            const result = await this.requester.request(FILE_READ_TEXT_METHOD, { target: state.ref });
+            if (typeof result !== 'string') {
+                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文本内容');
+            }
+            return result;
+        }, false);
+        defineReadonlyValue(handle, 'writeText', async (content) => {
+            assertWritable(state.mode);
+            if (typeof content !== 'string') {
+                throw invalidParams$1('content 必须是 string');
+            }
+            await this.requester.request(FILE_WRITE_TEXT_METHOD, { target: state.ref, content });
+        }, false);
+        defineReadonlyValue(handle, 'readBytes', async () => {
+            const result = await this.requester.request(FILE_READ_BYTES_METHOD, { target: state.ref });
+            if (!isMiniProgramByteArray(result)) {
+                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的二进制内容');
+            }
+            return new Uint8Array(result);
+        }, false);
+        defineReadonlyValue(handle, 'writeBytes', async (content) => {
+            assertWritable(state.mode);
+            const snapshot = cloneBytes$1(content);
+            await this.requester.request(FILE_WRITE_BYTES_METHOD, { target: state.ref, content: snapshot });
+        }, false);
+        defineReadonlyValue(handle, 'stat', async () => {
+            const result = await this.requester.request(FILE_STAT_METHOD, { target: state.ref });
+            return normalizeStat(result);
+        }, false);
+        this.fileStates.set(handle, state);
+        brandedFileSystemValues.add(handle);
+        return Object.freeze(handle);
     }
-    catch (e) {
-        return e.constructor;
+    createDirectFile(descriptor) {
+        this.assertFileDescriptor(descriptor);
+        if (!('handleId' in descriptor.ref)) {
+            throw createSDKError('FILE_IO_FAILED', 'Host 返回的 File 不是精确文件授权');
+        }
+        return this.createFile(descriptor);
     }
-    throw new Error("never reached");
-})();
-var MORE_DATA = new DataViewIndexOutOfBoundsError("Insufficient data");
-var sharedCachedKeyDecoder = new CachedKeyDecoder();
-var Decoder = /** @class */ (function () {
-    function Decoder(extensionCodec, context, maxStrLength, maxBinLength, maxArrayLength, maxMapLength, maxExtLength, keyDecoder) {
-        if (extensionCodec === void 0) { extensionCodec = ExtensionCodec.defaultCodec; }
-        if (context === void 0) { context = undefined; }
-        if (maxStrLength === void 0) { maxStrLength = UINT32_MAX; }
-        if (maxBinLength === void 0) { maxBinLength = UINT32_MAX; }
-        if (maxArrayLength === void 0) { maxArrayLength = UINT32_MAX; }
-        if (maxMapLength === void 0) { maxMapLength = UINT32_MAX; }
-        if (maxExtLength === void 0) { maxExtLength = UINT32_MAX; }
-        if (keyDecoder === void 0) { keyDecoder = sharedCachedKeyDecoder; }
-        this.extensionCodec = extensionCodec;
-        this.context = context;
-        this.maxStrLength = maxStrLength;
-        this.maxBinLength = maxBinLength;
-        this.maxArrayLength = maxArrayLength;
-        this.maxMapLength = maxMapLength;
-        this.maxExtLength = maxExtLength;
-        this.keyDecoder = keyDecoder;
-        this.totalPos = 0;
-        this.pos = 0;
-        this.view = EMPTY_VIEW;
-        this.bytes = EMPTY_BYTES;
-        this.headByte = HEAD_BYTE_REQUIRED;
-        this.stack = [];
+    createDirectory(descriptor) {
+        this.assertDirectoryDescriptor(descriptor);
+        const ref = cloneDirectoryRef(descriptor.ref);
+        const state = { ref, mode: descriptor.mode };
+        const pathRootState = 'handleId' in ref ? { root: ref, prefix: '', mode: descriptor.mode } : { root: ref.root, prefix: ref.relativePath, mode: descriptor.mode };
+        const handle = {};
+        defineReadonlyValue(handle, 'kind', 'directory');
+        defineReadonlyValue(handle, 'name', descriptor.name);
+        defineReadonlyValue(handle, 'mode', descriptor.mode);
+        this.definePathRootMethods(handle, pathRootState);
+        defineReadonlyValue(handle, 'create', async (options) => {
+            assertWritable(state.mode);
+            await this.requester.request(DIRECTORY_CREATE_METHOD, {
+                target: state.ref,
+                ...normalizeCreateOptions(options),
+            });
+            return handle;
+        }, false);
+        defineReadonlyValue(handle, 'remove', async (options) => {
+            assertWritable(state.mode);
+            assertSandboxRef(state.ref);
+            await this.requester.request(DIRECTORY_REMOVE_METHOD, {
+                target: state.ref,
+                ...normalizeRemoveOptions(options),
+            });
+        }, false);
+        defineReadonlyValue(handle, 'exists', async () => {
+            const result = await this.requester.request(DIRECTORY_EXISTS_METHOD, { target: state.ref });
+            if (typeof result !== 'boolean') {
+                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 exists 结果');
+            }
+            return result;
+        }, false);
+        defineReadonlyValue(handle, 'list', async (options) => {
+            const limit = normalizeListOptions(options);
+            const result = await this.requester.request(DIRECTORY_LIST_METHOD, {
+                target: state.ref,
+                ...(limit === undefined ? {} : { limit }),
+            });
+            if (!Array.isArray(result)) {
+                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的目录列表');
+            }
+            if (result.some((entry) => entry?.mode !== state.mode)) {
+                throw createSDKError('FILE_IO_FAILED', 'Host 返回的目录项未继承父目录 mode');
+            }
+            return result.map((entry) => this.createEntity(entry));
+        }, false);
+        this.directoryStates.set(handle, state);
+        this.pathRootStates.set(handle, pathRootState);
+        brandedFileSystemValues.add(handle);
+        return Object.freeze(handle);
     }
-    Decoder.prototype.reinitializeState = function () {
-        this.totalPos = 0;
-        this.headByte = HEAD_BYTE_REQUIRED;
-        this.stack.length = 0;
-        // view, bytes, and pos will be re-initialized in setBuffer()
-    };
-    Decoder.prototype.setBuffer = function (buffer) {
-        this.bytes = ensureUint8Array(buffer);
-        this.view = createDataView(this.bytes);
-        this.pos = 0;
-    };
-    Decoder.prototype.appendBuffer = function (buffer) {
-        if (this.headByte === HEAD_BYTE_REQUIRED && !this.hasRemaining(1)) {
-            this.setBuffer(buffer);
+    createDirectDirectory(descriptor) {
+        this.assertDirectoryDescriptor(descriptor);
+        if (!('handleId' in descriptor.ref)) {
+            throw createSDKError('FILE_IO_FAILED', 'Host 返回的 Directory 不是精确目录授权');
         }
-        else {
-            var remainingData = this.bytes.subarray(this.pos);
-            var newData = ensureUint8Array(buffer);
-            // concat remainingData + newData
-            var newBuffer = new Uint8Array(remainingData.length + newData.length);
-            newBuffer.set(remainingData);
-            newBuffer.set(newData, remainingData.length);
-            this.setBuffer(newBuffer);
+        return this.createDirectory(descriptor);
+    }
+    createEntity(descriptor) {
+        if (descriptor?.kind === 'file') {
+            return this.createFile(descriptor);
         }
-    };
-    Decoder.prototype.hasRemaining = function (size) {
-        return this.view.byteLength - this.pos >= size;
-    };
-    Decoder.prototype.createExtraByteError = function (posToShow) {
-        var _a = this, view = _a.view, pos = _a.pos;
-        return new RangeError("Extra ".concat(view.byteLength - pos, " of ").concat(view.byteLength, " byte(s) found at buffer[").concat(posToShow, "]"));
-    };
-    /**
-     * @throws {@link DecodeError}
-     * @throws {@link RangeError}
-     */
-    Decoder.prototype.decode = function (buffer) {
-        this.reinitializeState();
-        this.setBuffer(buffer);
-        var object = this.doDecodeSync();
-        if (this.hasRemaining(1)) {
-            throw this.createExtraByteError(this.pos);
+        if (descriptor?.kind === 'directory') {
+            return this.createDirectory(descriptor);
         }
-        return object;
-    };
-    Decoder.prototype.decodeMulti = function (buffer) {
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    this.reinitializeState();
-                    this.setBuffer(buffer);
-                    _a.label = 1;
-                case 1:
-                    if (!this.hasRemaining(1)) return [3 /*break*/, 3];
-                    return [4 /*yield*/, this.doDecodeSync()];
-                case 2:
-                    _a.sent();
-                    return [3 /*break*/, 1];
-                case 3: return [2 /*return*/];
-            }
+        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文件实体');
+    }
+    requireFile(handle) {
+        const state = handle && typeof handle === 'object' ? this.fileStates.get(handle) : undefined;
+        if (!state) {
+            throw invalidParams$1('to 必须是当前 SDK session 创建的 FileHandle');
+        }
+        return state;
+    }
+    requireDirectory(handle) {
+        const state = handle && typeof handle === 'object' ? this.directoryStates.get(handle) : undefined;
+        if (!state) {
+            throw invalidParams$1('to 必须是当前 SDK session 创建的 DirectoryHandle');
+        }
+        return state;
+    }
+    definePathRootMethods(target, state) {
+        defineReadonlyValue(target, 'file', (relativePath) => {
+            const normalized = normalizeRelativePath(relativePath);
+            const fullPath = joinRelativePath(state.prefix, normalized);
+            return this.createFile({
+                kind: 'file',
+                name: basename(normalized),
+                mode: state.mode,
+                ref: {
+                    kind: 'file',
+                    root: state.root,
+                    relativePath: fullPath,
+                },
+            });
+        }, false);
+        defineReadonlyValue(target, 'directory', (relativePath) => {
+            const normalized = relativePath === '.' ? '.' : normalizeRelativePath(relativePath);
+            const fullPath = joinRelativePath(state.prefix, normalized);
+            return this.createDirectory({
+                kind: 'directory',
+                name: basename(normalized),
+                mode: state.mode,
+                ref: {
+                    kind: 'directory',
+                    root: state.root,
+                    relativePath: fullPath,
+                },
+            });
+        }, false);
+    }
+    assertFileDescriptor(descriptor) {
+        if (!descriptor || descriptor.kind !== 'file') {
+            throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 File descriptor');
+        }
+        assertName(descriptor.name);
+        assertMode(descriptor.mode);
+        assertFileRef(descriptor.ref);
+    }
+    assertDirectoryDescriptor(descriptor) {
+        if (!descriptor || descriptor.kind !== 'directory') {
+            throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 Directory descriptor');
+        }
+        assertName(descriptor.name);
+        assertMode(descriptor.mode);
+        assertDirectoryRef(descriptor.ref);
+    }
+}
+function getFileHandleRegistry(requester) {
+    let registry = registries.get(requester);
+    if (!registry) {
+        registry = new MiniProgramFileHandleRegistry(requester);
+        registries.set(requester, registry);
+    }
+    return registry;
+}
+function isMiniProgramFileSystemValue(value) {
+    return !!value && typeof value === 'object' && brandedFileSystemValues.has(value);
+}
+
+function normalizeAlias(alias) {
+    if (typeof alias !== 'string' || !COMPANION_ALIAS_PATTERN.test(alias)) {
+        throw createSDKError('INVALID_PARAMS', 'alias 必须是规范的 Companion alias');
+    }
+    return alias;
+}
+function cloneBytes(data) {
+    if (!isMiniProgramByteArray(data)) {
+        throw createSDKError('INVALID_PARAMS', 'data 必须是 Uint8Array');
+    }
+    return new Uint8Array(data);
+}
+function assertPrepareOptions(options) {
+    if (options === undefined)
+        return;
+    if (!options || typeof options !== 'object' || Array.isArray(options)) {
+        throw createSDKError('INVALID_PARAMS', 'prepare options 必须是对象');
+    }
+    if (options.onProgress !== undefined && typeof options.onProgress !== 'function') {
+        throw createSDKError('INVALID_PARAMS', 'onProgress 必须是函数');
+    }
+    if (options.signal !== undefined &&
+        (typeof options.signal !== 'object' ||
+            typeof options.signal.aborted !== 'boolean' ||
+            typeof options.signal.addEventListener !== 'function' ||
+            typeof options.signal.removeEventListener !== 'function')) {
+        throw createSDKError('INVALID_PARAMS', 'signal 必须是 AbortSignal');
+    }
+}
+class CompanionSessionProxy {
+    requester;
+    snapshot;
+    id;
+    alias;
+    target;
+    capabilities;
+    stdio;
+    attachments;
+    notifications;
+    stdoutHandlers = new Set();
+    stderrHandlers = new Set();
+    stateHandlers = new Set();
+    exitHandlers = new Set();
+    ownershipLostHandlers = new Set();
+    exitPromise;
+    resolveExit;
+    exit;
+    ownsController = true;
+    lastOutputSequence = { stdout: -1, stderr: -1 };
+    constructor(requester, snapshot) {
+        this.requester = requester;
+        this.snapshot = snapshot;
+        this.id = snapshot.id;
+        this.alias = snapshot.alias;
+        this.target = snapshot.target;
+        this.capabilities = Object.freeze([...snapshot.capabilities]);
+        this.exitPromise = new Promise((resolve) => {
+            this.resolveExit = resolve;
         });
-    };
-    Decoder.prototype.decodeAsync = function (stream) {
-        var stream_1, stream_1_1;
-        var e_1, _a;
-        return __awaiter(this, void 0, void 0, function () {
-            var decoded, object, buffer, e_1_1, _b, headByte, pos, totalPos;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
-                    case 0:
-                        decoded = false;
-                        _c.label = 1;
-                    case 1:
-                        _c.trys.push([1, 6, 7, 12]);
-                        stream_1 = __asyncValues(stream);
-                        _c.label = 2;
-                    case 2: return [4 /*yield*/, stream_1.next()];
-                    case 3:
-                        if (!(stream_1_1 = _c.sent(), !stream_1_1.done)) return [3 /*break*/, 5];
-                        buffer = stream_1_1.value;
-                        if (decoded) {
-                            throw this.createExtraByteError(this.totalPos);
-                        }
-                        this.appendBuffer(buffer);
-                        try {
-                            object = this.doDecodeSync();
-                            decoded = true;
-                        }
-                        catch (e) {
-                            if (!(e instanceof DataViewIndexOutOfBoundsError)) {
-                                throw e; // rethrow
-                            }
-                            // fallthrough
-                        }
-                        this.totalPos += this.pos;
-                        _c.label = 4;
-                    case 4: return [3 /*break*/, 2];
-                    case 5: return [3 /*break*/, 12];
-                    case 6:
-                        e_1_1 = _c.sent();
-                        e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 12];
-                    case 7:
-                        _c.trys.push([7, , 10, 11]);
-                        if (!(stream_1_1 && !stream_1_1.done && (_a = stream_1.return))) return [3 /*break*/, 9];
-                        return [4 /*yield*/, _a.call(stream_1)];
-                    case 8:
-                        _c.sent();
-                        _c.label = 9;
-                    case 9: return [3 /*break*/, 11];
-                    case 10:
-                        if (e_1) throw e_1.error;
-                        return [7 /*endfinally*/];
-                    case 11: return [7 /*endfinally*/];
-                    case 12:
-                        if (decoded) {
-                            if (this.hasRemaining(1)) {
-                                throw this.createExtraByteError(this.totalPos);
-                            }
-                            return [2 /*return*/, object];
-                        }
-                        _b = this, headByte = _b.headByte, pos = _b.pos, totalPos = _b.totalPos;
-                        throw new RangeError("Insufficient data in parsing ".concat(prettyByte(headByte), " at ").concat(totalPos, " (").concat(pos, " in the current buffer)"));
+        if (snapshot.capabilities.includes('stdio')) {
+            const stdio = {
+                write: (data) => this.write(data),
+                closeStdin: () => this.closeStdin(),
+                onStdout: (handler) => this.onOutput('stdout', handler),
+                onStderr: (handler) => this.onOutput('stderr', handler),
+            };
+            this.stdio = Object.freeze(stdio);
+        }
+        if (snapshot.capabilities.includes('attachments')) {
+            const attachments = { open: (id) => this.openAttachment(id) };
+            this.attachments = Object.freeze(attachments);
+        }
+        if (snapshot.capabilities.includes('notifications')) {
+            const notifications = {
+                show: (input) => this.showNotification(input),
+            };
+            this.notifications = Object.freeze(notifications);
+        }
+    }
+    get state() {
+        return this.exit ? 'exited' : 'running';
+    }
+    updateController(snapshot) {
+        if (snapshot.controllerGeneration < this.snapshot.controllerGeneration)
+            return;
+        if (snapshot.alias !== this.alias || snapshot.target !== this.target ||
+            snapshot.capabilities.length !== this.capabilities.length ||
+            [...snapshot.capabilities].sort().some((capability, index) => capability !== [...this.capabilities].sort()[index])) {
+            throw createSDKError('COMPANION_SESSION_VERSION_MISMATCH', 'Companion Session 版本不匹配');
+        }
+        if (snapshot.controllerGeneration === this.snapshot.controllerGeneration)
+            return;
+        this.snapshot = snapshot;
+        this.ownsController = true;
+        this.lastOutputSequence.stdout = -1;
+        this.lastOutputSequence.stderr = -1;
+    }
+    async terminate() {
+        await this.requestController(COMPANION_SESSION_TERMINATE_METHOD);
+    }
+    waitForExit() {
+        return this.exitPromise;
+    }
+    onStateChange(handler) {
+        if (typeof handler !== 'function')
+            throw createSDKError('INVALID_PARAMS', 'state handler 必须是函数');
+        this.stateHandlers.add(handler);
+        return () => this.stateHandlers.delete(handler);
+    }
+    onExit(handler) {
+        if (typeof handler !== 'function')
+            throw createSDKError('INVALID_PARAMS', 'exit handler 必须是函数');
+        if (this.exit) {
+            handler(this.exit);
+            return () => undefined;
+        }
+        this.exitHandlers.add(handler);
+        return () => this.exitHandlers.delete(handler);
+    }
+    onOwnershipLost(handler) {
+        if (typeof handler !== 'function')
+            throw createSDKError('INVALID_PARAMS', 'ownership handler 必须是函数');
+        this.ownershipLostHandlers.add(handler);
+        return () => this.ownershipLostHandlers.delete(handler);
+    }
+    handleOutput(payload) {
+        if (this.exit || !this.ownsController || payload.controllerGeneration !== this.snapshot.controllerGeneration ||
+            !isMiniProgramByteArray(payload.data) || !Number.isSafeInteger(payload.sequence) || payload.sequence < 0)
+            return;
+        const duplicate = payload.sequence <= this.lastOutputSequence[payload.stream];
+        if (!duplicate)
+            this.lastOutputSequence[payload.stream] = payload.sequence;
+        const handlers = payload.stream === 'stdout' ? this.stdoutHandlers : this.stderrHandlers;
+        if (!duplicate) {
+            handlers.forEach((handler) => {
+                try {
+                    handler(new Uint8Array(payload.data));
+                }
+                catch {
+                    // 单个业务 handler 失败不能阻止其他 handler 或 Host ack。
                 }
             });
-        });
-    };
-    Decoder.prototype.decodeArrayStream = function (stream) {
-        return this.decodeMultiAsync(stream, true);
+        }
+        void this.requester
+            .request(COMPANION_SESSION_ACK_OUTPUT_METHOD, {
+            ...this.controllerPayload(),
+            stream: payload.stream,
+            sequence: payload.sequence,
+        })
+            .catch(() => undefined);
+    }
+    handleExit(exit) {
+        if (this.exit)
+            return;
+        this.exit = Object.freeze({ ...exit });
+        this.ownsController = false;
+        this.resolveExit(this.exit);
+        this.stateHandlers.forEach((handler) => handler('exited'));
+        this.exitHandlers.forEach((handler) => handler(this.exit));
+        this.exitHandlers.clear();
+        this.stateHandlers.clear();
+        this.stdoutHandlers.clear();
+        this.stderrHandlers.clear();
+    }
+    handleOwnershipLost(controllerGeneration) {
+        if (controllerGeneration !== this.snapshot.controllerGeneration || !this.ownsController)
+            return;
+        this.ownsController = false;
+        this.ownershipLostHandlers.forEach((handler) => handler());
+    }
+    onOutput(stream, handler) {
+        if (typeof handler !== 'function')
+            throw createSDKError('INVALID_PARAMS', 'output handler 必须是函数');
+        const handlers = stream === 'stdout' ? this.stdoutHandlers : this.stderrHandlers;
+        handlers.add(handler);
+        return () => handlers.delete(handler);
+    }
+    async write(data) {
+        this.assertController();
+        await this.requester.request(COMPANION_SESSION_WRITE_METHOD, { ...this.controllerPayload(), data: cloneBytes(data) });
+    }
+    async closeStdin() {
+        await this.requestController(COMPANION_SESSION_CLOSE_STDIN_METHOD);
+    }
+    async openAttachment(id) {
+        this.assertController();
+        if (typeof id !== 'string' || id.length === 0)
+            throw createSDKError('INVALID_PARAMS', 'attachment id 必须是非空字符串');
+        const descriptor = await this.requester.request(COMPANION_OPEN_ATTACHMENT_METHOD, { ...this.controllerPayload(), id });
+        return getFileHandleRegistry(this.requester).createDirectFile(descriptor);
+    }
+    async showNotification(input) {
+        this.assertController();
+        if (!input || typeof input !== 'object' || Array.isArray(input) || !['completed', 'failed', 'stopped', 'attention'].includes(input.category)) {
+            throw createSDKError('INVALID_PARAMS', 'notification category 不合法');
+        }
+        await this.requester.request(COMPANION_SHOW_NOTIFICATION_METHOD, { ...this.controllerPayload(), category: input.category });
+    }
+    async requestController(method) {
+        this.assertController();
+        await this.requester.request(method, this.controllerPayload());
+    }
+    controllerPayload() {
+        return { sessionId: this.snapshot.id, controllerGeneration: this.snapshot.controllerGeneration };
+    }
+    assertController() {
+        if (this.exit)
+            throw createSDKError('COMPANION_SESSION_EXITED', 'Companion Session 已退出');
+        if (!this.ownsController)
+            throw createSDKError('COMPANION_SESSION_OWNERSHIP_LOST', 'Companion Session 控制权已转移');
+    }
+}
+/** 创建当前 SDK session 的 companion 模块。 */
+function createCompanionModule(requester) {
+    const sessions = new Map();
+    const getSession = (snapshot) => {
+        const current = sessions.get(snapshot.id);
+        if (current) {
+            current.updateController(snapshot);
+            return current;
+        }
+        const session = new CompanionSessionProxy(requester, snapshot);
+        sessions.set(snapshot.id, session);
+        return session;
     };
-    Decoder.prototype.decodeStream = function (stream) {
-        return this.decodeMultiAsync(stream, false);
+    requester.on(COMPANION_SESSION_OUTPUT_EVENT, (payload) => sessions.get(payload.sessionId)?.handleOutput(payload));
+    requester.on(COMPANION_SESSION_EXIT_EVENT, (payload) => sessions.get(payload.sessionId)?.handleExit(payload.exit));
+    requester.on(COMPANION_SESSION_OWNERSHIP_LOST_EVENT, (payload) => sessions.get(payload.sessionId)?.handleOwnershipLost(payload.controllerGeneration));
+    const module = {
+        getInfo: (alias) => requester.request(COMPANION_GET_INFO_METHOD, { alias: normalizeAlias(alias) }),
+        getPreparationStatus: (alias) => requester.request(COMPANION_GET_PREPARATION_STATUS_METHOD, { alias: normalizeAlias(alias) }),
+        prepare(alias, options) {
+            assertPrepareOptions(options);
+            const normalizedAlias = normalizeAlias(alias);
+            const cancel = () => {
+                void requester.request(COMPANION_CANCEL_PREPARATION_METHOD, { alias: normalizedAlias }).catch(() => undefined);
+            };
+            options?.signal?.addEventListener('abort', cancel, { once: true });
+            return requester.requestOperation(COMPANION_PREPARE_METHOD, { alias: normalizedAlias }, {
+                ...options,
+                cancelOnAbort: false,
+                createAbortError: () => createSDKError('COMPANION_PREPARATION_CANCELLED', 'Companion 准备已取消'),
+            }).finally(() => options?.signal?.removeEventListener('abort', cancel));
+        },
+        cancelPreparation: (alias) => requester.request(COMPANION_CANCEL_PREPARATION_METHOD, { alias: normalizeAlias(alias) }),
+        async launch(alias) {
+            return getSession(await requester.requestOperation(COMPANION_LAUNCH_METHOD, { alias: normalizeAlias(alias) }));
+        },
+        async getActiveSession(alias) {
+            const snapshot = await requester.request(COMPANION_GET_ACTIVE_SESSION_METHOD, { alias: normalizeAlias(alias) });
+            return snapshot ? getSession(snapshot) : undefined;
+        },
     };
-    Decoder.prototype.decodeMultiAsync = function (stream, isArray) {
-        return __asyncGenerator(this, arguments, function decodeMultiAsync_1() {
-            var isArrayHeaderRequired, arrayItemsLeft, stream_2, stream_2_1, buffer, e_2, e_3_1;
-            var e_3, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        isArrayHeaderRequired = isArray;
-                        arrayItemsLeft = -1;
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 13, 14, 19]);
-                        stream_2 = __asyncValues(stream);
-                        _b.label = 2;
-                    case 2: return [4 /*yield*/, __await(stream_2.next())];
-                    case 3:
-                        if (!(stream_2_1 = _b.sent(), !stream_2_1.done)) return [3 /*break*/, 12];
-                        buffer = stream_2_1.value;
-                        if (isArray && arrayItemsLeft === 0) {
-                            throw this.createExtraByteError(this.totalPos);
-                        }
-                        this.appendBuffer(buffer);
-                        if (isArrayHeaderRequired) {
-                            arrayItemsLeft = this.readArraySize();
-                            isArrayHeaderRequired = false;
-                            this.complete();
-                        }
-                        _b.label = 4;
-                    case 4:
-                        _b.trys.push([4, 9, , 10]);
-                        _b.label = 5;
-                    case 5:
-                        return [4 /*yield*/, __await(this.doDecodeSync())];
-                    case 6: return [4 /*yield*/, _b.sent()];
-                    case 7:
-                        _b.sent();
-                        if (--arrayItemsLeft === 0) {
-                            return [3 /*break*/, 8];
-                        }
-                        return [3 /*break*/, 5];
-                    case 8: return [3 /*break*/, 10];
-                    case 9:
-                        e_2 = _b.sent();
-                        if (!(e_2 instanceof DataViewIndexOutOfBoundsError)) {
-                            throw e_2; // rethrow
-                        }
-                        return [3 /*break*/, 10];
-                    case 10:
-                        this.totalPos += this.pos;
-                        _b.label = 11;
-                    case 11: return [3 /*break*/, 2];
-                    case 12: return [3 /*break*/, 19];
-                    case 13:
-                        e_3_1 = _b.sent();
-                        e_3 = { error: e_3_1 };
-                        return [3 /*break*/, 19];
-                    case 14:
-                        _b.trys.push([14, , 17, 18]);
-                        if (!(stream_2_1 && !stream_2_1.done && (_a = stream_2.return))) return [3 /*break*/, 16];
-                        return [4 /*yield*/, __await(_a.call(stream_2))];
-                    case 15:
-                        _b.sent();
-                        _b.label = 16;
-                    case 16: return [3 /*break*/, 18];
-                    case 17:
-                        if (e_3) throw e_3.error;
-                        return [7 /*endfinally*/];
-                    case 18: return [7 /*endfinally*/];
-                    case 19: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    Decoder.prototype.doDecodeSync = function () {
-        DECODE: while (true) {
-            var headByte = this.readHeadByte();
-            var object = void 0;
-            if (headByte >= 0xe0) {
-                // negative fixint (111x xxxx) 0xe0 - 0xff
-                object = headByte - 0x100;
-            }
-            else if (headByte < 0xc0) {
-                if (headByte < 0x80) {
-                    // positive fixint (0xxx xxxx) 0x00 - 0x7f
-                    object = headByte;
-                }
-                else if (headByte < 0x90) {
-                    // fixmap (1000 xxxx) 0x80 - 0x8f
-                    var size = headByte - 0x80;
-                    if (size !== 0) {
-                        this.pushMapState(size);
-                        this.complete();
-                        continue DECODE;
-                    }
-                    else {
-                        object = {};
-                    }
-                }
-                else if (headByte < 0xa0) {
-                    // fixarray (1001 xxxx) 0x90 - 0x9f
-                    var size = headByte - 0x90;
-                    if (size !== 0) {
-                        this.pushArrayState(size);
-                        this.complete();
-                        continue DECODE;
-                    }
-                    else {
-                        object = [];
-                    }
-                }
-                else {
-                    // fixstr (101x xxxx) 0xa0 - 0xbf
-                    var byteLength = headByte - 0xa0;
-                    object = this.decodeUtf8String(byteLength, 0);
-                }
-            }
-            else if (headByte === 0xc0) {
-                // nil
-                object = null;
-            }
-            else if (headByte === 0xc2) {
-                // false
-                object = false;
-            }
-            else if (headByte === 0xc3) {
-                // true
-                object = true;
-            }
-            else if (headByte === 0xca) {
-                // float 32
-                object = this.readF32();
-            }
-            else if (headByte === 0xcb) {
-                // float 64
-                object = this.readF64();
-            }
-            else if (headByte === 0xcc) {
-                // uint 8
-                object = this.readU8();
-            }
-            else if (headByte === 0xcd) {
-                // uint 16
-                object = this.readU16();
-            }
-            else if (headByte === 0xce) {
-                // uint 32
-                object = this.readU32();
-            }
-            else if (headByte === 0xcf) {
-                // uint 64
-                object = this.readU64();
-            }
-            else if (headByte === 0xd0) {
-                // int 8
-                object = this.readI8();
-            }
-            else if (headByte === 0xd1) {
-                // int 16
-                object = this.readI16();
-            }
-            else if (headByte === 0xd2) {
-                // int 32
-                object = this.readI32();
-            }
-            else if (headByte === 0xd3) {
-                // int 64
-                object = this.readI64();
-            }
-            else if (headByte === 0xd9) {
-                // str 8
-                var byteLength = this.lookU8();
-                object = this.decodeUtf8String(byteLength, 1);
-            }
-            else if (headByte === 0xda) {
-                // str 16
-                var byteLength = this.lookU16();
-                object = this.decodeUtf8String(byteLength, 2);
-            }
-            else if (headByte === 0xdb) {
-                // str 32
-                var byteLength = this.lookU32();
-                object = this.decodeUtf8String(byteLength, 4);
-            }
-            else if (headByte === 0xdc) {
-                // array 16
-                var size = this.readU16();
-                if (size !== 0) {
-                    this.pushArrayState(size);
-                    this.complete();
-                    continue DECODE;
-                }
-                else {
-                    object = [];
-                }
-            }
-            else if (headByte === 0xdd) {
-                // array 32
-                var size = this.readU32();
-                if (size !== 0) {
-                    this.pushArrayState(size);
-                    this.complete();
-                    continue DECODE;
-                }
-                else {
-                    object = [];
-                }
-            }
-            else if (headByte === 0xde) {
-                // map 16
-                var size = this.readU16();
-                if (size !== 0) {
-                    this.pushMapState(size);
-                    this.complete();
-                    continue DECODE;
-                }
-                else {
-                    object = {};
-                }
-            }
-            else if (headByte === 0xdf) {
-                // map 32
-                var size = this.readU32();
-                if (size !== 0) {
-                    this.pushMapState(size);
-                    this.complete();
-                    continue DECODE;
-                }
-                else {
-                    object = {};
-                }
-            }
-            else if (headByte === 0xc4) {
-                // bin 8
-                var size = this.lookU8();
-                object = this.decodeBinary(size, 1);
-            }
-            else if (headByte === 0xc5) {
-                // bin 16
-                var size = this.lookU16();
-                object = this.decodeBinary(size, 2);
-            }
-            else if (headByte === 0xc6) {
-                // bin 32
-                var size = this.lookU32();
-                object = this.decodeBinary(size, 4);
-            }
-            else if (headByte === 0xd4) {
-                // fixext 1
-                object = this.decodeExtension(1, 0);
-            }
-            else if (headByte === 0xd5) {
-                // fixext 2
-                object = this.decodeExtension(2, 0);
-            }
-            else if (headByte === 0xd6) {
-                // fixext 4
-                object = this.decodeExtension(4, 0);
-            }
-            else if (headByte === 0xd7) {
-                // fixext 8
-                object = this.decodeExtension(8, 0);
-            }
-            else if (headByte === 0xd8) {
-                // fixext 16
-                object = this.decodeExtension(16, 0);
-            }
-            else if (headByte === 0xc7) {
-                // ext 8
-                var size = this.lookU8();
-                object = this.decodeExtension(size, 1);
-            }
-            else if (headByte === 0xc8) {
-                // ext 16
-                var size = this.lookU16();
-                object = this.decodeExtension(size, 2);
-            }
-            else if (headByte === 0xc9) {
-                // ext 32
-                var size = this.lookU32();
-                object = this.decodeExtension(size, 4);
-            }
-            else {
-                throw new DecodeError("Unrecognized type byte: ".concat(prettyByte(headByte)));
-            }
-            this.complete();
-            var stack = this.stack;
-            while (stack.length > 0) {
-                // arrays and maps
-                var state = stack[stack.length - 1];
-                if (state.type === 0 /* State.ARRAY */) {
-                    state.array[state.position] = object;
-                    state.position++;
-                    if (state.position === state.size) {
-                        stack.pop();
-                        object = state.array;
-                    }
-                    else {
-                        continue DECODE;
-                    }
-                }
-                else if (state.type === 1 /* State.MAP_KEY */) {
-                    if (!isValidMapKeyType(object)) {
-                        throw new DecodeError("The type of key must be string or number but " + typeof object);
-                    }
-                    if (object === "__proto__") {
-                        throw new DecodeError("The key __proto__ is not allowed");
-                    }
-                    state.key = object;
-                    state.type = 2 /* State.MAP_VALUE */;
-                    continue DECODE;
-                }
-                else {
-                    // it must be `state.type === State.MAP_VALUE` here
-                    state.map[state.key] = object;
-                    state.readCount++;
-                    if (state.readCount === state.size) {
-                        stack.pop();
-                        object = state.map;
-                    }
-                    else {
-                        state.key = null;
-                        state.type = 1 /* State.MAP_KEY */;
-                        continue DECODE;
-                    }
-                }
-            }
-            return object;
-        }
-    };
-    Decoder.prototype.readHeadByte = function () {
-        if (this.headByte === HEAD_BYTE_REQUIRED) {
-            this.headByte = this.readU8();
-            // console.log("headByte", prettyByte(this.headByte));
-        }
-        return this.headByte;
-    };
-    Decoder.prototype.complete = function () {
-        this.headByte = HEAD_BYTE_REQUIRED;
-    };
-    Decoder.prototype.readArraySize = function () {
-        var headByte = this.readHeadByte();
-        switch (headByte) {
-            case 0xdc:
-                return this.readU16();
-            case 0xdd:
-                return this.readU32();
-            default: {
-                if (headByte < 0xa0) {
-                    return headByte - 0x90;
-                }
-                else {
-                    throw new DecodeError("Unrecognized array type byte: ".concat(prettyByte(headByte)));
-                }
-            }
-        }
-    };
-    Decoder.prototype.pushMapState = function (size) {
-        if (size > this.maxMapLength) {
-            throw new DecodeError("Max length exceeded: map length (".concat(size, ") > maxMapLengthLength (").concat(this.maxMapLength, ")"));
-        }
-        this.stack.push({
-            type: 1 /* State.MAP_KEY */,
-            size: size,
-            key: null,
-            readCount: 0,
-            map: {},
-        });
-    };
-    Decoder.prototype.pushArrayState = function (size) {
-        if (size > this.maxArrayLength) {
-            throw new DecodeError("Max length exceeded: array length (".concat(size, ") > maxArrayLength (").concat(this.maxArrayLength, ")"));
-        }
-        this.stack.push({
-            type: 0 /* State.ARRAY */,
-            size: size,
-            array: new Array(size),
-            position: 0,
-        });
-    };
-    Decoder.prototype.decodeUtf8String = function (byteLength, headerOffset) {
-        var _a;
-        if (byteLength > this.maxStrLength) {
-            throw new DecodeError("Max length exceeded: UTF-8 byte length (".concat(byteLength, ") > maxStrLength (").concat(this.maxStrLength, ")"));
-        }
-        if (this.bytes.byteLength < this.pos + headerOffset + byteLength) {
-            throw MORE_DATA;
-        }
-        var offset = this.pos + headerOffset;
-        var object;
-        if (this.stateIsMapKey() && ((_a = this.keyDecoder) === null || _a === void 0 ? void 0 : _a.canBeCached(byteLength))) {
-            object = this.keyDecoder.decode(this.bytes, offset, byteLength);
-        }
-        else if (byteLength > TEXT_DECODER_THRESHOLD) {
-            object = utf8DecodeTD(this.bytes, offset, byteLength);
-        }
-        else {
-            object = utf8DecodeJs(this.bytes, offset, byteLength);
-        }
-        this.pos += headerOffset + byteLength;
-        return object;
-    };
-    Decoder.prototype.stateIsMapKey = function () {
-        if (this.stack.length > 0) {
-            var state = this.stack[this.stack.length - 1];
-            return state.type === 1 /* State.MAP_KEY */;
-        }
-        return false;
-    };
-    Decoder.prototype.decodeBinary = function (byteLength, headOffset) {
-        if (byteLength > this.maxBinLength) {
-            throw new DecodeError("Max length exceeded: bin length (".concat(byteLength, ") > maxBinLength (").concat(this.maxBinLength, ")"));
-        }
-        if (!this.hasRemaining(byteLength + headOffset)) {
-            throw MORE_DATA;
-        }
-        var offset = this.pos + headOffset;
-        var object = this.bytes.subarray(offset, offset + byteLength);
-        this.pos += headOffset + byteLength;
-        return object;
-    };
-    Decoder.prototype.decodeExtension = function (size, headOffset) {
-        if (size > this.maxExtLength) {
-            throw new DecodeError("Max length exceeded: ext length (".concat(size, ") > maxExtLength (").concat(this.maxExtLength, ")"));
-        }
-        var extType = this.view.getInt8(this.pos + headOffset);
-        var data = this.decodeBinary(size, headOffset + 1 /* extType */);
-        return this.extensionCodec.decode(data, extType, this.context);
-    };
-    Decoder.prototype.lookU8 = function () {
-        return this.view.getUint8(this.pos);
-    };
-    Decoder.prototype.lookU16 = function () {
-        return this.view.getUint16(this.pos);
-    };
-    Decoder.prototype.lookU32 = function () {
-        return this.view.getUint32(this.pos);
-    };
-    Decoder.prototype.readU8 = function () {
-        var value = this.view.getUint8(this.pos);
-        this.pos++;
-        return value;
-    };
-    Decoder.prototype.readI8 = function () {
-        var value = this.view.getInt8(this.pos);
-        this.pos++;
-        return value;
-    };
-    Decoder.prototype.readU16 = function () {
-        var value = this.view.getUint16(this.pos);
-        this.pos += 2;
-        return value;
-    };
-    Decoder.prototype.readI16 = function () {
-        var value = this.view.getInt16(this.pos);
-        this.pos += 2;
-        return value;
-    };
-    Decoder.prototype.readU32 = function () {
-        var value = this.view.getUint32(this.pos);
-        this.pos += 4;
-        return value;
-    };
-    Decoder.prototype.readI32 = function () {
-        var value = this.view.getInt32(this.pos);
-        this.pos += 4;
-        return value;
-    };
-    Decoder.prototype.readU64 = function () {
-        var value = getUint64(this.view, this.pos);
-        this.pos += 8;
-        return value;
-    };
-    Decoder.prototype.readI64 = function () {
-        var value = getInt64(this.view, this.pos);
-        this.pos += 8;
-        return value;
-    };
-    Decoder.prototype.readF32 = function () {
-        var value = this.view.getFloat32(this.pos);
-        this.pos += 4;
-        return value;
-    };
-    Decoder.prototype.readF64 = function () {
-        var value = this.view.getFloat64(this.pos);
-        this.pos += 8;
-        return value;
-    };
-    return Decoder;
-}());
+    return Object.freeze(module);
+}
 
-var defaultDecodeOptions = {};
 /**
- * It decodes a single MessagePack object in a buffer.
- *
- * This is a synchronous decoding function.
- * See other variants for asynchronous decoding: {@link decodeAsync()}, {@link decodeStream()}, or {@link decodeArrayStream()}.
+ * 复制当前小程序的通用分享链接。
  *
- * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
- * @throws {@link DecodeError} if the buffer contains invalid data.
+ * @param requester - 底层 bridge 请求能力。
+ * @param options - 分享扩展数据；不传时复制默认首页链接。
+ * @returns 已写入系统剪贴板的完整分享链接。
+ * @throws {@link HbMiniProgramSDKError} 当参数、bridge、父容器或剪贴板能力调用失败时抛出。
  */
-function decode(buffer, options) {
-    if (options === void 0) { options = defaultDecodeOptions; }
-    var decoder = new Decoder(options.extensionCodec, options.context, options.maxStrLength, options.maxBinLength, options.maxArrayLength, options.maxMapLength, options.maxExtLength);
-    return decoder.decode(buffer);
+function copyLink(requester, options) {
+    return requester.request(SHARE_COPY_LINK_METHOD, options);
 }
 
-/** 读取小程序启动时携带的分享数据。 */
-function readMiniProgramShareExtra(launchHref) {
-    if (!launchHref)
-        return undefined;
-    try {
-        const value = new URL(launchHref).searchParams.get('extra');
-        if (!value || value.length > 256 || value.length % 4 === 1 || !/^[A-Za-z0-9_-]+$/.test(value)) {
-            return undefined;
-        }
-        const bytes = decodeBase64Url(value);
-        if (bytes.byteLength > 128)
-            return undefined;
-        const decoded = decode(bytes);
-        assertExtraValue(decoded);
-        return decoded;
-    }
-    catch {
-        return undefined;
-    }
+// Integer Utility
+var UINT32_MAX = 4294967295;
+function setInt64(view, offset, value) {
+    var high = Math.floor(value / 4294967296);
+    var low = value; // high bits are truncated by DataView
+    view.setUint32(offset, high);
+    view.setUint32(offset + 4, low);
 }
-function assertExtraValue(value, depth = 0, seen = new WeakSet()) {
-    if (depth > 8)
-        throw new Error('extra nesting depth exceeded');
-    if (value === null || typeof value === 'string' || typeof value === 'boolean')
-        return;
-    if (typeof value === 'number') {
-        if (Number.isFinite(value))
-            return;
-        throw new Error('extra number must be finite');
-    }
-    if (typeof value !== 'object')
-        throw new Error('extra value must be JSON-compatible');
-    if (seen.has(value))
-        throw new Error('extra value must not contain cycles');
-    seen.add(value);
-    if (Array.isArray(value)) {
-        if (value.length > 64)
-            throw new Error('extra array is too large');
-        for (const item of value)
-            assertExtraValue(item, depth + 1, seen);
-        seen.delete(value);
-        return;
-    }
-    const prototype = Object.getPrototypeOf(value);
-    if (prototype !== Object.prototype && prototype !== null)
-        throw new Error('extra object must be a plain object');
-    const values = Object.values(value);
-    if (values.length > 64)
-        throw new Error('extra object has too many fields');
-    for (const item of values)
-        assertExtraValue(item, depth + 1, seen);
-    seen.delete(value);
+function getInt64(view, offset) {
+    var high = view.getInt32(offset);
+    var low = view.getUint32(offset + 4);
+    return high * 4294967296 + low;
+}
+function getUint64(view, offset) {
+    var high = view.getUint32(offset);
+    var low = view.getUint32(offset + 4);
+    return high * 4294967296 + low;
+}
+
+var _a, _b, _c;
+var TEXT_ENCODING_AVAILABLE = (typeof process === "undefined" || ((_a = process === null || process === void 0 ? void 0 : process.env) === null || _a === void 0 ? void 0 : _a["TEXT_ENCODING"]) !== "never") &&
+    typeof TextEncoder !== "undefined" &&
+    typeof TextDecoder !== "undefined";
+var sharedTextEncoder = TEXT_ENCODING_AVAILABLE ? new TextEncoder() : undefined;
+!TEXT_ENCODING_AVAILABLE
+    ? UINT32_MAX
+    : typeof process !== "undefined" && ((_b = process === null || process === void 0 ? void 0 : process.env) === null || _b === void 0 ? void 0 : _b["TEXT_ENCODING"]) !== "force"
+        ? 200
+        : 0;
+function utf8EncodeTEencode(str, output, outputOffset) {
+    output.set(sharedTextEncoder.encode(str), outputOffset);
+}
+function utf8EncodeTEencodeInto(str, output, outputOffset) {
+    sharedTextEncoder.encodeInto(str, output.subarray(outputOffset));
+}
+(sharedTextEncoder === null || sharedTextEncoder === void 0 ? void 0 : sharedTextEncoder.encodeInto) ? utf8EncodeTEencodeInto : utf8EncodeTEencode;
+var CHUNK_SIZE = 4096;
+function utf8DecodeJs(bytes, inputOffset, byteLength) {
+    var offset = inputOffset;
+    var end = offset + byteLength;
+    var units = [];
+    var result = "";
+    while (offset < end) {
+        var byte1 = bytes[offset++];
+        if ((byte1 & 0x80) === 0) {
+            // 1 byte
+            units.push(byte1);
+        }
+        else if ((byte1 & 0xe0) === 0xc0) {
+            // 2 bytes
+            var byte2 = bytes[offset++] & 0x3f;
+            units.push(((byte1 & 0x1f) << 6) | byte2);
+        }
+        else if ((byte1 & 0xf0) === 0xe0) {
+            // 3 bytes
+            var byte2 = bytes[offset++] & 0x3f;
+            var byte3 = bytes[offset++] & 0x3f;
+            units.push(((byte1 & 0x1f) << 12) | (byte2 << 6) | byte3);
+        }
+        else if ((byte1 & 0xf8) === 0xf0) {
+            // 4 bytes
+            var byte2 = bytes[offset++] & 0x3f;
+            var byte3 = bytes[offset++] & 0x3f;
+            var byte4 = bytes[offset++] & 0x3f;
+            var unit = ((byte1 & 0x07) << 0x12) | (byte2 << 0x0c) | (byte3 << 0x06) | byte4;
+            if (unit > 0xffff) {
+                unit -= 0x10000;
+                units.push(((unit >>> 10) & 0x3ff) | 0xd800);
+                unit = 0xdc00 | (unit & 0x3ff);
+            }
+            units.push(unit);
+        }
+        else {
+            units.push(byte1);
+        }
+        if (units.length >= CHUNK_SIZE) {
+            result += String.fromCharCode.apply(String, units);
+            units.length = 0;
+        }
+    }
+    if (units.length > 0) {
+        result += String.fromCharCode.apply(String, units);
+    }
+    return result;
 }
-function decodeBase64Url(value) {
-    const normalized = value.replaceAll('-', '+').replaceAll('_', '/');
-    const padded = normalized.padEnd(normalized.length + ((4 - (normalized.length % 4)) % 4), '=');
-    return Uint8Array.from(atob(padded), (character) => character.charCodeAt(0));
+var sharedTextDecoder = TEXT_ENCODING_AVAILABLE ? new TextDecoder() : null;
+var TEXT_DECODER_THRESHOLD = !TEXT_ENCODING_AVAILABLE
+    ? UINT32_MAX
+    : typeof process !== "undefined" && ((_c = process === null || process === void 0 ? void 0 : process.env) === null || _c === void 0 ? void 0 : _c["TEXT_DECODER"]) !== "force"
+        ? 200
+        : 0;
+function utf8DecodeTD(bytes, inputOffset, byteLength) {
+    var stringBytes = bytes.subarray(inputOffset, inputOffset + byteLength);
+    return sharedTextDecoder.decode(stringBytes);
 }
 
 /**
- * 截图并唤起分享。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 截图区域、延迟与保存相册等配置。
- * @returns 由宿主客户端协议决定的结果。
- * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
+ * ExtData is used to handle Extension Types that are not registered to ExtensionCodec.
  */
-function screenshot(requester, options) {
-    return requester.request(SHARE_SCREENSHOT_METHOD, options);
-}
+var ExtData = /** @class */ (function () {
+    function ExtData(type, data) {
+        this.type = type;
+        this.data = data;
+    }
+    return ExtData;
+}());
 
-/**
- * 展示以当前小程序通用分享页为落地页的基础分享面板。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 基础分享参数。
- * @returns 由宿主客户端协议决定的结果。
- * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
- */
-function showShareMenu(requester, options) {
-    return requester.request(SHARE_SHOW_SHARE_MENU_METHOD, options);
-}
+var __extends = (undefined && undefined.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var DecodeError = /** @class */ (function (_super) {
+    __extends(DecodeError, _super);
+    function DecodeError(message) {
+        var _this = _super.call(this, message) || this;
+        // fix the prototype chain in a cross-platform way
+        var proto = Object.create(DecodeError.prototype);
+        Object.setPrototypeOf(_this, proto);
+        Object.defineProperty(_this, "name", {
+            configurable: true,
+            enumerable: false,
+            value: DecodeError.name,
+        });
+        return _this;
+    }
+    return DecodeError;
+}(Error));
 
-/**
- * 创建分享模块。
- *
- * @param requester - 底层 bridge 请求能力。
- * @returns 面向业务层的分享模块对象。
- */
-function createShareModule(requester, launchHref) {
+// https://github.com/msgpack/msgpack/blob/master/spec.md#timestamp-extension-type
+var EXT_TIMESTAMP = -1;
+var TIMESTAMP32_MAX_SEC = 0x100000000 - 1; // 32-bit unsigned int
+var TIMESTAMP64_MAX_SEC = 0x400000000 - 1; // 34-bit unsigned int
+function encodeTimeSpecToTimestamp(_a) {
+    var sec = _a.sec, nsec = _a.nsec;
+    if (sec >= 0 && nsec >= 0 && sec <= TIMESTAMP64_MAX_SEC) {
+        // Here sec >= 0 && nsec >= 0
+        if (nsec === 0 && sec <= TIMESTAMP32_MAX_SEC) {
+            // timestamp 32 = { sec32 (unsigned) }
+            var rv = new Uint8Array(4);
+            var view = new DataView(rv.buffer);
+            view.setUint32(0, sec);
+            return rv;
+        }
+        else {
+            // timestamp 64 = { nsec30 (unsigned), sec34 (unsigned) }
+            var secHigh = sec / 0x100000000;
+            var secLow = sec & 0xffffffff;
+            var rv = new Uint8Array(8);
+            var view = new DataView(rv.buffer);
+            // nsec30 | secHigh2
+            view.setUint32(0, (nsec << 2) | (secHigh & 0x3));
+            // secLow32
+            view.setUint32(4, secLow);
+            return rv;
+        }
+    }
+    else {
+        // timestamp 96 = { nsec32 (unsigned), sec64 (signed) }
+        var rv = new Uint8Array(12);
+        var view = new DataView(rv.buffer);
+        view.setUint32(0, nsec);
+        setInt64(view, 4, sec);
+        return rv;
+    }
+}
+function encodeDateToTimeSpec(date) {
+    var msec = date.getTime();
+    var sec = Math.floor(msec / 1e3);
+    var nsec = (msec - sec * 1e3) * 1e6;
+    // Normalizes { sec, nsec } to ensure nsec is unsigned.
+    var nsecInSec = Math.floor(nsec / 1e9);
     return {
-        copyLink: (options) => copyLink(requester, options),
-        getExtra: () => readMiniProgramShareExtra(launchHref),
-        showShareMenu: (options) => showShareMenu(requester, options),
-        screenshot: (options) => screenshot(requester, options),
+        sec: sec + nsecInSec,
+        nsec: nsec - nsecInSec * 1e9,
     };
 }
-
-/**
- * 获取小程序隔离 storage。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 读取的 storage key。
- * @returns 对应 key 的标准化读取结果。
- * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
- */
-function getStorage(requester, options) {
-    return requester.request(STORAGE_GET_STORAGE_METHOD, options);
+function encodeTimestampExtension(object) {
+    if (object instanceof Date) {
+        var timeSpec = encodeDateToTimeSpec(object);
+        return encodeTimeSpecToTimestamp(timeSpec);
+    }
+    else {
+        return null;
+    }
 }
-/**
- * 写入小程序隔离 storage。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 要写入的 storage key 与数据。
- * @returns 当写入完成后 resolve。
- * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
- */
-function setStorage(requester, options) {
-    return requester.request(STORAGE_SET_STORAGE_METHOD, options);
+function decodeTimestampToTimeSpec(data) {
+    var view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    // data may be 32, 64, or 96 bits
+    switch (data.byteLength) {
+        case 4: {
+            // timestamp 32 = { sec32 }
+            var sec = view.getUint32(0);
+            var nsec = 0;
+            return { sec: sec, nsec: nsec };
+        }
+        case 8: {
+            // timestamp 64 = { nsec30, sec34 }
+            var nsec30AndSecHigh2 = view.getUint32(0);
+            var secLow32 = view.getUint32(4);
+            var sec = (nsec30AndSecHigh2 & 0x3) * 0x100000000 + secLow32;
+            var nsec = nsec30AndSecHigh2 >>> 2;
+            return { sec: sec, nsec: nsec };
+        }
+        case 12: {
+            // timestamp 96 = { nsec32 (unsigned), sec64 (signed) }
+            var sec = getInt64(view, 4);
+            var nsec = view.getUint32(0);
+            return { sec: sec, nsec: nsec };
+        }
+        default:
+            throw new DecodeError("Unrecognized data size for timestamp (expected 4, 8, or 12): ".concat(data.length));
+    }
 }
-/**
- * 创建 storage 模块。
- *
- * @param requester - 底层 bridge 请求能力。
- * @returns 面向业务层的 storage 模块对象。
- */
-function createStorageModule(requester) {
-    return {
-        getStorage: (options) => getStorage(requester, options),
-        setStorage: (options) => setStorage(requester, options),
+function decodeTimestampExtension(data) {
+    var timeSpec = decodeTimestampToTimeSpec(data);
+    return new Date(timeSpec.sec * 1e3 + timeSpec.nsec / 1e6);
+}
+var timestampExtension = {
+    type: EXT_TIMESTAMP,
+    encode: encodeTimestampExtension,
+    decode: decodeTimestampExtension,
+};
+
+// ExtensionCodec to handle MessagePack extensions
+var ExtensionCodec = /** @class */ (function () {
+    function ExtensionCodec() {
+        // built-in extensions
+        this.builtInEncoders = [];
+        this.builtInDecoders = [];
+        // custom extensions
+        this.encoders = [];
+        this.decoders = [];
+        this.register(timestampExtension);
+    }
+    ExtensionCodec.prototype.register = function (_a) {
+        var type = _a.type, encode = _a.encode, decode = _a.decode;
+        if (type >= 0) {
+            // custom extensions
+            this.encoders[type] = encode;
+            this.decoders[type] = decode;
+        }
+        else {
+            // built-in extensions
+            var index = 1 + type;
+            this.builtInEncoders[index] = encode;
+            this.builtInDecoders[index] = decode;
+        }
+    };
+    ExtensionCodec.prototype.tryToEncode = function (object, context) {
+        // built-in extensions
+        for (var i = 0; i < this.builtInEncoders.length; i++) {
+            var encodeExt = this.builtInEncoders[i];
+            if (encodeExt != null) {
+                var data = encodeExt(object, context);
+                if (data != null) {
+                    var type = -1 - i;
+                    return new ExtData(type, data);
+                }
+            }
+        }
+        // custom extensions
+        for (var i = 0; i < this.encoders.length; i++) {
+            var encodeExt = this.encoders[i];
+            if (encodeExt != null) {
+                var data = encodeExt(object, context);
+                if (data != null) {
+                    var type = i;
+                    return new ExtData(type, data);
+                }
+            }
+        }
+        if (object instanceof ExtData) {
+            // to keep ExtData as is
+            return object;
+        }
+        return null;
     };
-}
+    ExtensionCodec.prototype.decode = function (data, type, context) {
+        var decodeExt = type < 0 ? this.builtInDecoders[-1 - type] : this.decoders[type];
+        if (decodeExt) {
+            return decodeExt(data, type, context);
+        }
+        else {
+            // decode() does not fail, returns ExtData instead.
+            return new ExtData(type, data);
+        }
+    };
+    ExtensionCodec.defaultCodec = new ExtensionCodec();
+    return ExtensionCodec;
+}());
 
-const registries = new WeakMap();
-const brandedFileSystemValues = new WeakSet();
-const CONTROL_CHARACTER_PATTERN = /[\u0000-\u001f\u007f]/;
-function invalidParams$1(message, data) {
-    return createSDKError('INVALID_PARAMS', message, data);
-}
-function clonePathRootRef(ref) {
-    return ref.kind === 'sandbox' ? Object.freeze({ kind: 'sandbox' }) : Object.freeze({ kind: 'directory', handleId: ref.handleId });
-}
-function cloneFileRef(ref) {
-    return 'handleId' in ref
-        ? Object.freeze({ kind: 'file', handleId: ref.handleId })
-        : Object.freeze({
-            kind: 'file',
-            root: clonePathRootRef(ref.root),
-            relativePath: ref.relativePath,
-        });
-}
-function cloneDirectoryRef(ref) {
-    return 'handleId' in ref
-        ? Object.freeze({ kind: 'directory', handleId: ref.handleId })
-        : Object.freeze({
-            kind: 'directory',
-            root: clonePathRootRef(ref.root),
-            relativePath: ref.relativePath,
-        });
-}
-function assertMode(mode) {
-    if (mode !== 'read' && mode !== 'readwrite') {
-        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文件访问模式');
+function ensureUint8Array(buffer) {
+    if (buffer instanceof Uint8Array) {
+        return buffer;
     }
-}
-function assertName(name) {
-    if (typeof name !== 'string' || name.length === 0 || name.includes('/') || name.includes('\\') || CONTROL_CHARACTER_PATTERN.test(name)) {
-        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文件名');
+    else if (ArrayBuffer.isView(buffer)) {
+        return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
     }
-}
-function assertFileRef(ref) {
-    if (!isMiniProgramFileRef(ref)) {
-        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 File handle');
+    else if (buffer instanceof ArrayBuffer) {
+        return new Uint8Array(buffer);
     }
-}
-function assertDirectoryRef(ref) {
-    if (!isMiniProgramDirectoryRef(ref)) {
-        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 Directory handle');
+    else {
+        // ArrayLike<number>
+        return Uint8Array.from(buffer);
     }
 }
-function defineReadonlyValue(target, key, value, enumerable = true) {
-    Object.defineProperty(target, key, {
-        value,
-        enumerable,
-        configurable: false,
-        writable: false,
-    });
-}
-function joinRelativePath(prefix, relativePath) {
-    return prefix ? `${prefix}/${relativePath}` : relativePath;
-}
-function basename(relativePath) {
-    const segments = relativePath.split('/');
-    return segments[segments.length - 1];
-}
-function assertWritable(mode) {
-    if (mode !== 'readwrite') {
-        throw createSDKError('FILE_ACCESS_DENIED', '当前文件句柄不允许写入');
+function createDataView(buffer) {
+    if (buffer instanceof ArrayBuffer) {
+        return new DataView(buffer);
     }
+    var bufferView = ensureUint8Array(buffer);
+    return new DataView(bufferView.buffer, bufferView.byteOffset, bufferView.byteLength);
 }
-function assertSandboxRef(ref) {
-    if ('handleId' in ref || ref.root.kind !== 'sandbox') {
-        throw createSDKError('FILE_ACCESS_DENIED', '外部文件授权不允许删除');
-    }
+
+function prettyByte(byte) {
+    return "".concat(byte < 0 ? "-" : "", "0x").concat(Math.abs(byte).toString(16).padStart(2, "0"));
 }
-function normalizeCreateOptions(options) {
-    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
-        throw invalidParams$1('create options 必须是对象');
-    }
-    if (options?.recursive !== undefined && typeof options.recursive !== 'boolean') {
-        throw invalidParams$1('recursive 必须是 boolean');
-    }
-    if (options?.exclusive !== undefined && typeof options.exclusive !== 'boolean') {
-        throw invalidParams$1('exclusive 必须是 boolean');
+
+var DEFAULT_MAX_KEY_LENGTH = 16;
+var DEFAULT_MAX_LENGTH_PER_KEY = 16;
+var CachedKeyDecoder = /** @class */ (function () {
+    function CachedKeyDecoder(maxKeyLength, maxLengthPerKey) {
+        if (maxKeyLength === void 0) { maxKeyLength = DEFAULT_MAX_KEY_LENGTH; }
+        if (maxLengthPerKey === void 0) { maxLengthPerKey = DEFAULT_MAX_LENGTH_PER_KEY; }
+        this.maxKeyLength = maxKeyLength;
+        this.maxLengthPerKey = maxLengthPerKey;
+        this.hit = 0;
+        this.miss = 0;
+        // avoid `new Array(N)`, which makes a sparse array,
+        // because a sparse array is typically slower than a non-sparse array.
+        this.caches = [];
+        for (var i = 0; i < this.maxKeyLength; i++) {
+            this.caches.push([]);
+        }
     }
-    return {
-        recursive: options?.recursive ?? false,
-        exclusive: options?.exclusive ?? false,
+    CachedKeyDecoder.prototype.canBeCached = function (byteLength) {
+        return byteLength > 0 && byteLength <= this.maxKeyLength;
     };
-}
-function normalizeListOptions(options) {
-    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
-        throw invalidParams$1('list options 必须是对象');
-    }
-    if (options?.limit !== undefined && (!Number.isSafeInteger(options.limit) || options.limit <= 0)) {
-        throw invalidParams$1('limit 必须是正的 safe integer');
-    }
-    return options?.limit;
-}
-function normalizeRemoveOptions(options) {
-    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
-        throw invalidParams$1('remove options 必须是对象');
-    }
-    if (options?.recursive !== undefined && typeof options.recursive !== 'boolean') {
-        throw invalidParams$1('recursive 必须是 boolean');
+    CachedKeyDecoder.prototype.find = function (bytes, inputOffset, byteLength) {
+        var records = this.caches[byteLength - 1];
+        FIND_CHUNK: for (var _i = 0, records_1 = records; _i < records_1.length; _i++) {
+            var record = records_1[_i];
+            var recordBytes = record.bytes;
+            for (var j = 0; j < byteLength; j++) {
+                if (recordBytes[j] !== bytes[inputOffset + j]) {
+                    continue FIND_CHUNK;
+                }
+            }
+            return record.str;
+        }
+        return null;
+    };
+    CachedKeyDecoder.prototype.store = function (bytes, value) {
+        var records = this.caches[bytes.length - 1];
+        var record = { bytes: bytes, str: value };
+        if (records.length >= this.maxLengthPerKey) {
+            // `records` are full!
+            // Set `record` to an arbitrary position.
+            records[(Math.random() * records.length) | 0] = record;
+        }
+        else {
+            records.push(record);
+        }
+    };
+    CachedKeyDecoder.prototype.decode = function (bytes, inputOffset, byteLength) {
+        var cachedValue = this.find(bytes, inputOffset, byteLength);
+        if (cachedValue != null) {
+            this.hit++;
+            return cachedValue;
+        }
+        this.miss++;
+        var str = utf8DecodeJs(bytes, inputOffset, byteLength);
+        // Ensure to copy a slice of bytes because the byte may be NodeJS Buffer and Buffer#slice() returns a reference to its internal ArrayBuffer.
+        var slicedCopyOfBytes = Uint8Array.prototype.slice.call(bytes, inputOffset, inputOffset + byteLength);
+        this.store(slicedCopyOfBytes, str);
+        return str;
+    };
+    return CachedKeyDecoder;
+}());
+
+var __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (undefined && undefined.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
-    return { recursive: options?.recursive ?? false };
-}
-function cloneBytes(content) {
-    if (!(content instanceof Uint8Array)) {
-        throw invalidParams$1('content 必须是 Uint8Array');
+};
+var __asyncValues = (undefined && undefined.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (undefined && undefined.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); };
+var __asyncGenerator = (undefined && undefined.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var isValidMapKeyType = function (key) {
+    var keyType = typeof key;
+    return keyType === "string" || keyType === "number";
+};
+var HEAD_BYTE_REQUIRED = -1;
+var EMPTY_VIEW = new DataView(new ArrayBuffer(0));
+var EMPTY_BYTES = new Uint8Array(EMPTY_VIEW.buffer);
+// IE11: Hack to support IE11.
+// IE11: Drop this hack and just use RangeError when IE11 is obsolete.
+var DataViewIndexOutOfBoundsError = (function () {
+    try {
+        // IE11: The spec says it should throw RangeError,
+        // IE11: but in IE11 it throws TypeError.
+        EMPTY_VIEW.getInt8(0);
     }
-    if (typeof SharedArrayBuffer !== 'undefined' && content.buffer instanceof SharedArrayBuffer) {
-        throw invalidParams$1('content 不能由 SharedArrayBuffer 承载');
+    catch (e) {
+        return e.constructor;
     }
-    return new Uint8Array(content);
-}
-function normalizeStat(stat) {
-    if (!isMiniProgramFileStat(stat)) {
-        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 FileStat');
+    throw new Error("never reached");
+})();
+var MORE_DATA = new DataViewIndexOutOfBoundsError("Insufficient data");
+var sharedCachedKeyDecoder = new CachedKeyDecoder();
+var Decoder = /** @class */ (function () {
+    function Decoder(extensionCodec, context, maxStrLength, maxBinLength, maxArrayLength, maxMapLength, maxExtLength, keyDecoder) {
+        if (extensionCodec === void 0) { extensionCodec = ExtensionCodec.defaultCodec; }
+        if (context === void 0) { context = undefined; }
+        if (maxStrLength === void 0) { maxStrLength = UINT32_MAX; }
+        if (maxBinLength === void 0) { maxBinLength = UINT32_MAX; }
+        if (maxArrayLength === void 0) { maxArrayLength = UINT32_MAX; }
+        if (maxMapLength === void 0) { maxMapLength = UINT32_MAX; }
+        if (maxExtLength === void 0) { maxExtLength = UINT32_MAX; }
+        if (keyDecoder === void 0) { keyDecoder = sharedCachedKeyDecoder; }
+        this.extensionCodec = extensionCodec;
+        this.context = context;
+        this.maxStrLength = maxStrLength;
+        this.maxBinLength = maxBinLength;
+        this.maxArrayLength = maxArrayLength;
+        this.maxMapLength = maxMapLength;
+        this.maxExtLength = maxExtLength;
+        this.keyDecoder = keyDecoder;
+        this.totalPos = 0;
+        this.pos = 0;
+        this.view = EMPTY_VIEW;
+        this.bytes = EMPTY_BYTES;
+        this.headByte = HEAD_BYTE_REQUIRED;
+        this.stack = [];
     }
-    return {
-        kind: 'file',
-        size: stat.size,
-        ...(stat.modifiedAt === undefined ? {} : { modifiedAt: stat.modifiedAt }),
-        ...(stat.createdAt === undefined ? {} : { createdAt: stat.createdAt }),
+    Decoder.prototype.reinitializeState = function () {
+        this.totalPos = 0;
+        this.headByte = HEAD_BYTE_REQUIRED;
+        this.stack.length = 0;
+        // view, bytes, and pos will be re-initialized in setBuffer()
     };
-}
-/** 校验并返回平台无关的 `/` 分隔逻辑相对路径。 */
-function normalizeRelativePath(value) {
-    if (!isMiniProgramRelativePath(value)) {
-        throw invalidParams$1('relativePath 必须是规范的 `/` 分隔逻辑相对路径');
-    }
-    return value;
-}
-class MiniProgramFileHandleRegistry {
-    requester;
-    fileStates = new WeakMap();
-    directoryStates = new WeakMap();
-    pathRootStates = new WeakMap();
-    sandboxRoot;
-    constructor(requester) {
-        this.requester = requester;
-    }
-    getSandbox() {
-        if (this.sandboxRoot) {
-            return this.sandboxRoot;
+    Decoder.prototype.setBuffer = function (buffer) {
+        this.bytes = ensureUint8Array(buffer);
+        this.view = createDataView(this.bytes);
+        this.pos = 0;
+    };
+    Decoder.prototype.appendBuffer = function (buffer) {
+        if (this.headByte === HEAD_BYTE_REQUIRED && !this.hasRemaining(1)) {
+            this.setBuffer(buffer);
         }
-        const sandbox = {};
-        const state = {
-            root: Object.freeze({ kind: 'sandbox' }),
-            prefix: '',
-            mode: 'readwrite',
-        };
-        this.definePathRootMethods(sandbox, state);
-        this.pathRootStates.set(sandbox, state);
-        brandedFileSystemValues.add(sandbox);
-        this.sandboxRoot = Object.freeze(sandbox);
-        return this.sandboxRoot;
-    }
-    createFile(descriptor) {
-        this.assertFileDescriptor(descriptor);
-        const ref = cloneFileRef(descriptor.ref);
-        const state = { ref, mode: descriptor.mode };
-        const handle = {};
-        defineReadonlyValue(handle, 'kind', 'file');
-        defineReadonlyValue(handle, 'name', descriptor.name);
-        defineReadonlyValue(handle, 'mode', descriptor.mode);
-        defineReadonlyValue(handle, 'create', async (options) => {
-            assertWritable(state.mode);
-            await this.requester.request(FILE_CREATE_METHOD, {
-                target: state.ref,
-                ...normalizeCreateOptions(options),
+        else {
+            var remainingData = this.bytes.subarray(this.pos);
+            var newData = ensureUint8Array(buffer);
+            // concat remainingData + newData
+            var newBuffer = new Uint8Array(remainingData.length + newData.length);
+            newBuffer.set(remainingData);
+            newBuffer.set(newData, remainingData.length);
+            this.setBuffer(newBuffer);
+        }
+    };
+    Decoder.prototype.hasRemaining = function (size) {
+        return this.view.byteLength - this.pos >= size;
+    };
+    Decoder.prototype.createExtraByteError = function (posToShow) {
+        var _a = this, view = _a.view, pos = _a.pos;
+        return new RangeError("Extra ".concat(view.byteLength - pos, " of ").concat(view.byteLength, " byte(s) found at buffer[").concat(posToShow, "]"));
+    };
+    /**
+     * @throws {@link DecodeError}
+     * @throws {@link RangeError}
+     */
+    Decoder.prototype.decode = function (buffer) {
+        this.reinitializeState();
+        this.setBuffer(buffer);
+        var object = this.doDecodeSync();
+        if (this.hasRemaining(1)) {
+            throw this.createExtraByteError(this.pos);
+        }
+        return object;
+    };
+    Decoder.prototype.decodeMulti = function (buffer) {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    this.reinitializeState();
+                    this.setBuffer(buffer);
+                    _a.label = 1;
+                case 1:
+                    if (!this.hasRemaining(1)) return [3 /*break*/, 3];
+                    return [4 /*yield*/, this.doDecodeSync()];
+                case 2:
+                    _a.sent();
+                    return [3 /*break*/, 1];
+                case 3: return [2 /*return*/];
+            }
+        });
+    };
+    Decoder.prototype.decodeAsync = function (stream) {
+        var stream_1, stream_1_1;
+        var e_1, _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var decoded, object, buffer, e_1_1, _b, headByte, pos, totalPos;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        decoded = false;
+                        _c.label = 1;
+                    case 1:
+                        _c.trys.push([1, 6, 7, 12]);
+                        stream_1 = __asyncValues(stream);
+                        _c.label = 2;
+                    case 2: return [4 /*yield*/, stream_1.next()];
+                    case 3:
+                        if (!(stream_1_1 = _c.sent(), !stream_1_1.done)) return [3 /*break*/, 5];
+                        buffer = stream_1_1.value;
+                        if (decoded) {
+                            throw this.createExtraByteError(this.totalPos);
+                        }
+                        this.appendBuffer(buffer);
+                        try {
+                            object = this.doDecodeSync();
+                            decoded = true;
+                        }
+                        catch (e) {
+                            if (!(e instanceof DataViewIndexOutOfBoundsError)) {
+                                throw e; // rethrow
+                            }
+                            // fallthrough
+                        }
+                        this.totalPos += this.pos;
+                        _c.label = 4;
+                    case 4: return [3 /*break*/, 2];
+                    case 5: return [3 /*break*/, 12];
+                    case 6:
+                        e_1_1 = _c.sent();
+                        e_1 = { error: e_1_1 };
+                        return [3 /*break*/, 12];
+                    case 7:
+                        _c.trys.push([7, , 10, 11]);
+                        if (!(stream_1_1 && !stream_1_1.done && (_a = stream_1.return))) return [3 /*break*/, 9];
+                        return [4 /*yield*/, _a.call(stream_1)];
+                    case 8:
+                        _c.sent();
+                        _c.label = 9;
+                    case 9: return [3 /*break*/, 11];
+                    case 10:
+                        if (e_1) throw e_1.error;
+                        return [7 /*endfinally*/];
+                    case 11: return [7 /*endfinally*/];
+                    case 12:
+                        if (decoded) {
+                            if (this.hasRemaining(1)) {
+                                throw this.createExtraByteError(this.totalPos);
+                            }
+                            return [2 /*return*/, object];
+                        }
+                        _b = this, headByte = _b.headByte, pos = _b.pos, totalPos = _b.totalPos;
+                        throw new RangeError("Insufficient data in parsing ".concat(prettyByte(headByte), " at ").concat(totalPos, " (").concat(pos, " in the current buffer)"));
+                }
+            });
+        });
+    };
+    Decoder.prototype.decodeArrayStream = function (stream) {
+        return this.decodeMultiAsync(stream, true);
+    };
+    Decoder.prototype.decodeStream = function (stream) {
+        return this.decodeMultiAsync(stream, false);
+    };
+    Decoder.prototype.decodeMultiAsync = function (stream, isArray) {
+        return __asyncGenerator(this, arguments, function decodeMultiAsync_1() {
+            var isArrayHeaderRequired, arrayItemsLeft, stream_2, stream_2_1, buffer, e_2, e_3_1;
+            var e_3, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        isArrayHeaderRequired = isArray;
+                        arrayItemsLeft = -1;
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 13, 14, 19]);
+                        stream_2 = __asyncValues(stream);
+                        _b.label = 2;
+                    case 2: return [4 /*yield*/, __await(stream_2.next())];
+                    case 3:
+                        if (!(stream_2_1 = _b.sent(), !stream_2_1.done)) return [3 /*break*/, 12];
+                        buffer = stream_2_1.value;
+                        if (isArray && arrayItemsLeft === 0) {
+                            throw this.createExtraByteError(this.totalPos);
+                        }
+                        this.appendBuffer(buffer);
+                        if (isArrayHeaderRequired) {
+                            arrayItemsLeft = this.readArraySize();
+                            isArrayHeaderRequired = false;
+                            this.complete();
+                        }
+                        _b.label = 4;
+                    case 4:
+                        _b.trys.push([4, 9, , 10]);
+                        _b.label = 5;
+                    case 5:
+                        return [4 /*yield*/, __await(this.doDecodeSync())];
+                    case 6: return [4 /*yield*/, _b.sent()];
+                    case 7:
+                        _b.sent();
+                        if (--arrayItemsLeft === 0) {
+                            return [3 /*break*/, 8];
+                        }
+                        return [3 /*break*/, 5];
+                    case 8: return [3 /*break*/, 10];
+                    case 9:
+                        e_2 = _b.sent();
+                        if (!(e_2 instanceof DataViewIndexOutOfBoundsError)) {
+                            throw e_2; // rethrow
+                        }
+                        return [3 /*break*/, 10];
+                    case 10:
+                        this.totalPos += this.pos;
+                        _b.label = 11;
+                    case 11: return [3 /*break*/, 2];
+                    case 12: return [3 /*break*/, 19];
+                    case 13:
+                        e_3_1 = _b.sent();
+                        e_3 = { error: e_3_1 };
+                        return [3 /*break*/, 19];
+                    case 14:
+                        _b.trys.push([14, , 17, 18]);
+                        if (!(stream_2_1 && !stream_2_1.done && (_a = stream_2.return))) return [3 /*break*/, 16];
+                        return [4 /*yield*/, __await(_a.call(stream_2))];
+                    case 15:
+                        _b.sent();
+                        _b.label = 16;
+                    case 16: return [3 /*break*/, 18];
+                    case 17:
+                        if (e_3) throw e_3.error;
+                        return [7 /*endfinally*/];
+                    case 18: return [7 /*endfinally*/];
+                    case 19: return [2 /*return*/];
+                }
             });
-            return handle;
-        }, false);
-        defineReadonlyValue(handle, 'remove', async () => {
-            assertWritable(state.mode);
-            assertSandboxRef(state.ref);
-            await this.requester.request(FILE_REMOVE_METHOD, { target: state.ref });
-        }, false);
-        defineReadonlyValue(handle, 'exists', async () => {
-            const result = await this.requester.request(FILE_EXISTS_METHOD, { target: state.ref });
-            if (typeof result !== 'boolean') {
-                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 exists 结果');
+        });
+    };
+    Decoder.prototype.doDecodeSync = function () {
+        DECODE: while (true) {
+            var headByte = this.readHeadByte();
+            var object = void 0;
+            if (headByte >= 0xe0) {
+                // negative fixint (111x xxxx) 0xe0 - 0xff
+                object = headByte - 0x100;
             }
-            return result;
-        }, false);
-        defineReadonlyValue(handle, 'readText', async () => {
-            const result = await this.requester.request(FILE_READ_TEXT_METHOD, { target: state.ref });
-            if (typeof result !== 'string') {
-                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文本内容');
+            else if (headByte < 0xc0) {
+                if (headByte < 0x80) {
+                    // positive fixint (0xxx xxxx) 0x00 - 0x7f
+                    object = headByte;
+                }
+                else if (headByte < 0x90) {
+                    // fixmap (1000 xxxx) 0x80 - 0x8f
+                    var size = headByte - 0x80;
+                    if (size !== 0) {
+                        this.pushMapState(size);
+                        this.complete();
+                        continue DECODE;
+                    }
+                    else {
+                        object = {};
+                    }
+                }
+                else if (headByte < 0xa0) {
+                    // fixarray (1001 xxxx) 0x90 - 0x9f
+                    var size = headByte - 0x90;
+                    if (size !== 0) {
+                        this.pushArrayState(size);
+                        this.complete();
+                        continue DECODE;
+                    }
+                    else {
+                        object = [];
+                    }
+                }
+                else {
+                    // fixstr (101x xxxx) 0xa0 - 0xbf
+                    var byteLength = headByte - 0xa0;
+                    object = this.decodeUtf8String(byteLength, 0);
+                }
+            }
+            else if (headByte === 0xc0) {
+                // nil
+                object = null;
+            }
+            else if (headByte === 0xc2) {
+                // false
+                object = false;
+            }
+            else if (headByte === 0xc3) {
+                // true
+                object = true;
+            }
+            else if (headByte === 0xca) {
+                // float 32
+                object = this.readF32();
+            }
+            else if (headByte === 0xcb) {
+                // float 64
+                object = this.readF64();
+            }
+            else if (headByte === 0xcc) {
+                // uint 8
+                object = this.readU8();
+            }
+            else if (headByte === 0xcd) {
+                // uint 16
+                object = this.readU16();
+            }
+            else if (headByte === 0xce) {
+                // uint 32
+                object = this.readU32();
+            }
+            else if (headByte === 0xcf) {
+                // uint 64
+                object = this.readU64();
+            }
+            else if (headByte === 0xd0) {
+                // int 8
+                object = this.readI8();
+            }
+            else if (headByte === 0xd1) {
+                // int 16
+                object = this.readI16();
+            }
+            else if (headByte === 0xd2) {
+                // int 32
+                object = this.readI32();
+            }
+            else if (headByte === 0xd3) {
+                // int 64
+                object = this.readI64();
+            }
+            else if (headByte === 0xd9) {
+                // str 8
+                var byteLength = this.lookU8();
+                object = this.decodeUtf8String(byteLength, 1);
+            }
+            else if (headByte === 0xda) {
+                // str 16
+                var byteLength = this.lookU16();
+                object = this.decodeUtf8String(byteLength, 2);
+            }
+            else if (headByte === 0xdb) {
+                // str 32
+                var byteLength = this.lookU32();
+                object = this.decodeUtf8String(byteLength, 4);
+            }
+            else if (headByte === 0xdc) {
+                // array 16
+                var size = this.readU16();
+                if (size !== 0) {
+                    this.pushArrayState(size);
+                    this.complete();
+                    continue DECODE;
+                }
+                else {
+                    object = [];
+                }
+            }
+            else if (headByte === 0xdd) {
+                // array 32
+                var size = this.readU32();
+                if (size !== 0) {
+                    this.pushArrayState(size);
+                    this.complete();
+                    continue DECODE;
+                }
+                else {
+                    object = [];
+                }
+            }
+            else if (headByte === 0xde) {
+                // map 16
+                var size = this.readU16();
+                if (size !== 0) {
+                    this.pushMapState(size);
+                    this.complete();
+                    continue DECODE;
+                }
+                else {
+                    object = {};
+                }
+            }
+            else if (headByte === 0xdf) {
+                // map 32
+                var size = this.readU32();
+                if (size !== 0) {
+                    this.pushMapState(size);
+                    this.complete();
+                    continue DECODE;
+                }
+                else {
+                    object = {};
+                }
+            }
+            else if (headByte === 0xc4) {
+                // bin 8
+                var size = this.lookU8();
+                object = this.decodeBinary(size, 1);
+            }
+            else if (headByte === 0xc5) {
+                // bin 16
+                var size = this.lookU16();
+                object = this.decodeBinary(size, 2);
+            }
+            else if (headByte === 0xc6) {
+                // bin 32
+                var size = this.lookU32();
+                object = this.decodeBinary(size, 4);
+            }
+            else if (headByte === 0xd4) {
+                // fixext 1
+                object = this.decodeExtension(1, 0);
+            }
+            else if (headByte === 0xd5) {
+                // fixext 2
+                object = this.decodeExtension(2, 0);
+            }
+            else if (headByte === 0xd6) {
+                // fixext 4
+                object = this.decodeExtension(4, 0);
+            }
+            else if (headByte === 0xd7) {
+                // fixext 8
+                object = this.decodeExtension(8, 0);
+            }
+            else if (headByte === 0xd8) {
+                // fixext 16
+                object = this.decodeExtension(16, 0);
+            }
+            else if (headByte === 0xc7) {
+                // ext 8
+                var size = this.lookU8();
+                object = this.decodeExtension(size, 1);
             }
-            return result;
-        }, false);
-        defineReadonlyValue(handle, 'writeText', async (content) => {
-            assertWritable(state.mode);
-            if (typeof content !== 'string') {
-                throw invalidParams$1('content 必须是 string');
+            else if (headByte === 0xc8) {
+                // ext 16
+                var size = this.lookU16();
+                object = this.decodeExtension(size, 2);
             }
-            await this.requester.request(FILE_WRITE_TEXT_METHOD, { target: state.ref, content });
-        }, false);
-        defineReadonlyValue(handle, 'readBytes', async () => {
-            const result = await this.requester.request(FILE_READ_BYTES_METHOD, { target: state.ref });
-            if (!isMiniProgramByteArray(result)) {
-                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的二进制内容');
+            else if (headByte === 0xc9) {
+                // ext 32
+                var size = this.lookU32();
+                object = this.decodeExtension(size, 4);
             }
-            return new Uint8Array(result);
-        }, false);
-        defineReadonlyValue(handle, 'writeBytes', async (content) => {
-            assertWritable(state.mode);
-            const snapshot = cloneBytes(content);
-            await this.requester.request(FILE_WRITE_BYTES_METHOD, { target: state.ref, content: snapshot });
-        }, false);
-        defineReadonlyValue(handle, 'stat', async () => {
-            const result = await this.requester.request(FILE_STAT_METHOD, { target: state.ref });
-            return normalizeStat(result);
-        }, false);
-        this.fileStates.set(handle, state);
-        brandedFileSystemValues.add(handle);
-        return Object.freeze(handle);
-    }
-    createDirectFile(descriptor) {
-        this.assertFileDescriptor(descriptor);
-        if (!('handleId' in descriptor.ref)) {
-            throw createSDKError('FILE_IO_FAILED', 'Host 返回的 File 不是精确文件授权');
-        }
-        return this.createFile(descriptor);
-    }
-    createDirectory(descriptor) {
-        this.assertDirectoryDescriptor(descriptor);
-        const ref = cloneDirectoryRef(descriptor.ref);
-        const state = { ref, mode: descriptor.mode };
-        const pathRootState = 'handleId' in ref ? { root: ref, prefix: '', mode: descriptor.mode } : { root: ref.root, prefix: ref.relativePath, mode: descriptor.mode };
-        const handle = {};
-        defineReadonlyValue(handle, 'kind', 'directory');
-        defineReadonlyValue(handle, 'name', descriptor.name);
-        defineReadonlyValue(handle, 'mode', descriptor.mode);
-        this.definePathRootMethods(handle, pathRootState);
-        defineReadonlyValue(handle, 'create', async (options) => {
-            assertWritable(state.mode);
-            await this.requester.request(DIRECTORY_CREATE_METHOD, {
-                target: state.ref,
-                ...normalizeCreateOptions(options),
-            });
-            return handle;
-        }, false);
-        defineReadonlyValue(handle, 'remove', async (options) => {
-            assertWritable(state.mode);
-            assertSandboxRef(state.ref);
-            await this.requester.request(DIRECTORY_REMOVE_METHOD, {
-                target: state.ref,
-                ...normalizeRemoveOptions(options),
-            });
-        }, false);
-        defineReadonlyValue(handle, 'exists', async () => {
-            const result = await this.requester.request(DIRECTORY_EXISTS_METHOD, { target: state.ref });
-            if (typeof result !== 'boolean') {
-                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 exists 结果');
+            else {
+                throw new DecodeError("Unrecognized type byte: ".concat(prettyByte(headByte)));
             }
-            return result;
-        }, false);
-        defineReadonlyValue(handle, 'list', async (options) => {
-            const limit = normalizeListOptions(options);
-            const result = await this.requester.request(DIRECTORY_LIST_METHOD, {
-                target: state.ref,
-                ...(limit === undefined ? {} : { limit }),
-            });
-            if (!Array.isArray(result)) {
-                throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的目录列表');
+            this.complete();
+            var stack = this.stack;
+            while (stack.length > 0) {
+                // arrays and maps
+                var state = stack[stack.length - 1];
+                if (state.type === 0 /* State.ARRAY */) {
+                    state.array[state.position] = object;
+                    state.position++;
+                    if (state.position === state.size) {
+                        stack.pop();
+                        object = state.array;
+                    }
+                    else {
+                        continue DECODE;
+                    }
+                }
+                else if (state.type === 1 /* State.MAP_KEY */) {
+                    if (!isValidMapKeyType(object)) {
+                        throw new DecodeError("The type of key must be string or number but " + typeof object);
+                    }
+                    if (object === "__proto__") {
+                        throw new DecodeError("The key __proto__ is not allowed");
+                    }
+                    state.key = object;
+                    state.type = 2 /* State.MAP_VALUE */;
+                    continue DECODE;
+                }
+                else {
+                    // it must be `state.type === State.MAP_VALUE` here
+                    state.map[state.key] = object;
+                    state.readCount++;
+                    if (state.readCount === state.size) {
+                        stack.pop();
+                        object = state.map;
+                    }
+                    else {
+                        state.key = null;
+                        state.type = 1 /* State.MAP_KEY */;
+                        continue DECODE;
+                    }
+                }
             }
-            if (result.some((entry) => entry?.mode !== state.mode)) {
-                throw createSDKError('FILE_IO_FAILED', 'Host 返回的目录项未继承父目录 mode');
+            return object;
+        }
+    };
+    Decoder.prototype.readHeadByte = function () {
+        if (this.headByte === HEAD_BYTE_REQUIRED) {
+            this.headByte = this.readU8();
+            // console.log("headByte", prettyByte(this.headByte));
+        }
+        return this.headByte;
+    };
+    Decoder.prototype.complete = function () {
+        this.headByte = HEAD_BYTE_REQUIRED;
+    };
+    Decoder.prototype.readArraySize = function () {
+        var headByte = this.readHeadByte();
+        switch (headByte) {
+            case 0xdc:
+                return this.readU16();
+            case 0xdd:
+                return this.readU32();
+            default: {
+                if (headByte < 0xa0) {
+                    return headByte - 0x90;
+                }
+                else {
+                    throw new DecodeError("Unrecognized array type byte: ".concat(prettyByte(headByte)));
+                }
             }
-            return result.map((entry) => this.createEntity(entry));
-        }, false);
-        this.directoryStates.set(handle, state);
-        this.pathRootStates.set(handle, pathRootState);
-        brandedFileSystemValues.add(handle);
-        return Object.freeze(handle);
-    }
-    createDirectDirectory(descriptor) {
-        this.assertDirectoryDescriptor(descriptor);
-        if (!('handleId' in descriptor.ref)) {
-            throw createSDKError('FILE_IO_FAILED', 'Host 返回的 Directory 不是精确目录授权');
         }
-        return this.createDirectory(descriptor);
-    }
-    createEntity(descriptor) {
-        if (descriptor?.kind === 'file') {
-            return this.createFile(descriptor);
+    };
+    Decoder.prototype.pushMapState = function (size) {
+        if (size > this.maxMapLength) {
+            throw new DecodeError("Max length exceeded: map length (".concat(size, ") > maxMapLengthLength (").concat(this.maxMapLength, ")"));
         }
-        if (descriptor?.kind === 'directory') {
-            return this.createDirectory(descriptor);
+        this.stack.push({
+            type: 1 /* State.MAP_KEY */,
+            size: size,
+            key: null,
+            readCount: 0,
+            map: {},
+        });
+    };
+    Decoder.prototype.pushArrayState = function (size) {
+        if (size > this.maxArrayLength) {
+            throw new DecodeError("Max length exceeded: array length (".concat(size, ") > maxArrayLength (").concat(this.maxArrayLength, ")"));
         }
-        throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的文件实体');
-    }
-    requireFile(handle) {
-        const state = handle && typeof handle === 'object' ? this.fileStates.get(handle) : undefined;
-        if (!state) {
-            throw invalidParams$1('to 必须是当前 SDK session 创建的 FileHandle');
+        this.stack.push({
+            type: 0 /* State.ARRAY */,
+            size: size,
+            array: new Array(size),
+            position: 0,
+        });
+    };
+    Decoder.prototype.decodeUtf8String = function (byteLength, headerOffset) {
+        var _a;
+        if (byteLength > this.maxStrLength) {
+            throw new DecodeError("Max length exceeded: UTF-8 byte length (".concat(byteLength, ") > maxStrLength (").concat(this.maxStrLength, ")"));
         }
-        return state;
-    }
-    requireDirectory(handle) {
-        const state = handle && typeof handle === 'object' ? this.directoryStates.get(handle) : undefined;
-        if (!state) {
-            throw invalidParams$1('to 必须是当前 SDK session 创建的 DirectoryHandle');
+        if (this.bytes.byteLength < this.pos + headerOffset + byteLength) {
+            throw MORE_DATA;
+        }
+        var offset = this.pos + headerOffset;
+        var object;
+        if (this.stateIsMapKey() && ((_a = this.keyDecoder) === null || _a === void 0 ? void 0 : _a.canBeCached(byteLength))) {
+            object = this.keyDecoder.decode(this.bytes, offset, byteLength);
+        }
+        else if (byteLength > TEXT_DECODER_THRESHOLD) {
+            object = utf8DecodeTD(this.bytes, offset, byteLength);
+        }
+        else {
+            object = utf8DecodeJs(this.bytes, offset, byteLength);
+        }
+        this.pos += headerOffset + byteLength;
+        return object;
+    };
+    Decoder.prototype.stateIsMapKey = function () {
+        if (this.stack.length > 0) {
+            var state = this.stack[this.stack.length - 1];
+            return state.type === 1 /* State.MAP_KEY */;
+        }
+        return false;
+    };
+    Decoder.prototype.decodeBinary = function (byteLength, headOffset) {
+        if (byteLength > this.maxBinLength) {
+            throw new DecodeError("Max length exceeded: bin length (".concat(byteLength, ") > maxBinLength (").concat(this.maxBinLength, ")"));
+        }
+        if (!this.hasRemaining(byteLength + headOffset)) {
+            throw MORE_DATA;
+        }
+        var offset = this.pos + headOffset;
+        var object = this.bytes.subarray(offset, offset + byteLength);
+        this.pos += headOffset + byteLength;
+        return object;
+    };
+    Decoder.prototype.decodeExtension = function (size, headOffset) {
+        if (size > this.maxExtLength) {
+            throw new DecodeError("Max length exceeded: ext length (".concat(size, ") > maxExtLength (").concat(this.maxExtLength, ")"));
+        }
+        var extType = this.view.getInt8(this.pos + headOffset);
+        var data = this.decodeBinary(size, headOffset + 1 /* extType */);
+        return this.extensionCodec.decode(data, extType, this.context);
+    };
+    Decoder.prototype.lookU8 = function () {
+        return this.view.getUint8(this.pos);
+    };
+    Decoder.prototype.lookU16 = function () {
+        return this.view.getUint16(this.pos);
+    };
+    Decoder.prototype.lookU32 = function () {
+        return this.view.getUint32(this.pos);
+    };
+    Decoder.prototype.readU8 = function () {
+        var value = this.view.getUint8(this.pos);
+        this.pos++;
+        return value;
+    };
+    Decoder.prototype.readI8 = function () {
+        var value = this.view.getInt8(this.pos);
+        this.pos++;
+        return value;
+    };
+    Decoder.prototype.readU16 = function () {
+        var value = this.view.getUint16(this.pos);
+        this.pos += 2;
+        return value;
+    };
+    Decoder.prototype.readI16 = function () {
+        var value = this.view.getInt16(this.pos);
+        this.pos += 2;
+        return value;
+    };
+    Decoder.prototype.readU32 = function () {
+        var value = this.view.getUint32(this.pos);
+        this.pos += 4;
+        return value;
+    };
+    Decoder.prototype.readI32 = function () {
+        var value = this.view.getInt32(this.pos);
+        this.pos += 4;
+        return value;
+    };
+    Decoder.prototype.readU64 = function () {
+        var value = getUint64(this.view, this.pos);
+        this.pos += 8;
+        return value;
+    };
+    Decoder.prototype.readI64 = function () {
+        var value = getInt64(this.view, this.pos);
+        this.pos += 8;
+        return value;
+    };
+    Decoder.prototype.readF32 = function () {
+        var value = this.view.getFloat32(this.pos);
+        this.pos += 4;
+        return value;
+    };
+    Decoder.prototype.readF64 = function () {
+        var value = this.view.getFloat64(this.pos);
+        this.pos += 8;
+        return value;
+    };
+    return Decoder;
+}());
+
+var defaultDecodeOptions = {};
+/**
+ * It decodes a single MessagePack object in a buffer.
+ *
+ * This is a synchronous decoding function.
+ * See other variants for asynchronous decoding: {@link decodeAsync()}, {@link decodeStream()}, or {@link decodeArrayStream()}.
+ *
+ * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
+ * @throws {@link DecodeError} if the buffer contains invalid data.
+ */
+function decode(buffer, options) {
+    if (options === void 0) { options = defaultDecodeOptions; }
+    var decoder = new Decoder(options.extensionCodec, options.context, options.maxStrLength, options.maxBinLength, options.maxArrayLength, options.maxMapLength, options.maxExtLength);
+    return decoder.decode(buffer);
+}
+
+/** 读取小程序启动时携带的分享数据。 */
+function readMiniProgramShareExtra(launchHref) {
+    if (!launchHref)
+        return undefined;
+    try {
+        const value = new URL(launchHref).searchParams.get('extra');
+        if (!value || value.length > 256 || value.length % 4 === 1 || !/^[A-Za-z0-9_-]+$/.test(value)) {
+            return undefined;
         }
-        return state;
+        const bytes = decodeBase64Url(value);
+        if (bytes.byteLength > 128)
+            return undefined;
+        const decoded = decode(bytes);
+        assertExtraValue(decoded);
+        return decoded;
     }
-    definePathRootMethods(target, state) {
-        defineReadonlyValue(target, 'file', (relativePath) => {
-            const normalized = normalizeRelativePath(relativePath);
-            const fullPath = joinRelativePath(state.prefix, normalized);
-            return this.createFile({
-                kind: 'file',
-                name: basename(normalized),
-                mode: state.mode,
-                ref: {
-                    kind: 'file',
-                    root: state.root,
-                    relativePath: fullPath,
-                },
-            });
-        }, false);
-        defineReadonlyValue(target, 'directory', (relativePath) => {
-            const normalized = normalizeRelativePath(relativePath);
-            const fullPath = joinRelativePath(state.prefix, normalized);
-            return this.createDirectory({
-                kind: 'directory',
-                name: basename(normalized),
-                mode: state.mode,
-                ref: {
-                    kind: 'directory',
-                    root: state.root,
-                    relativePath: fullPath,
-                },
-            });
-        }, false);
+    catch {
+        return undefined;
     }
-    assertFileDescriptor(descriptor) {
-        if (!descriptor || descriptor.kind !== 'file') {
-            throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 File descriptor');
-        }
-        assertName(descriptor.name);
-        assertMode(descriptor.mode);
-        assertFileRef(descriptor.ref);
+}
+function assertExtraValue(value, depth = 0, seen = new WeakSet()) {
+    if (depth > 8)
+        throw new Error('extra nesting depth exceeded');
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return;
+    if (typeof value === 'number') {
+        if (Number.isFinite(value))
+            return;
+        throw new Error('extra number must be finite');
     }
-    assertDirectoryDescriptor(descriptor) {
-        if (!descriptor || descriptor.kind !== 'directory') {
-            throw createSDKError('FILE_IO_FAILED', 'Host 返回了无效的 Directory descriptor');
-        }
-        assertName(descriptor.name);
-        assertMode(descriptor.mode);
-        assertDirectoryRef(descriptor.ref);
+    if (typeof value !== 'object')
+        throw new Error('extra value must be JSON-compatible');
+    if (seen.has(value))
+        throw new Error('extra value must not contain cycles');
+    seen.add(value);
+    if (Array.isArray(value)) {
+        if (value.length > 64)
+            throw new Error('extra array is too large');
+        for (const item of value)
+            assertExtraValue(item, depth + 1, seen);
+        seen.delete(value);
+        return;
     }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        throw new Error('extra object must be a plain object');
+    const values = Object.values(value);
+    if (values.length > 64)
+        throw new Error('extra object has too many fields');
+    for (const item of values)
+        assertExtraValue(item, depth + 1, seen);
+    seen.delete(value);
 }
-function getFileHandleRegistry(requester) {
-    let registry = registries.get(requester);
-    if (!registry) {
-        registry = new MiniProgramFileHandleRegistry(requester);
-        registries.set(requester, registry);
-    }
-    return registry;
+function decodeBase64Url(value) {
+    const normalized = value.replaceAll('-', '+').replaceAll('_', '/');
+    const padded = normalized.padEnd(normalized.length + ((4 - (normalized.length % 4)) % 4), '=');
+    return Uint8Array.from(atob(padded), (character) => character.charCodeAt(0));
 }
-function isMiniProgramFileSystemValue(value) {
-    return !!value && typeof value === 'object' && brandedFileSystemValues.has(value);
+
+/**
+ * 截图并唤起分享。
+ *
+ * @param requester - 底层 bridge 请求能力。
+ * @param options - 截图区域、延迟与保存相册等配置。
+ * @returns 由宿主客户端协议决定的结果。
+ * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
+ */
+function screenshot(requester, options) {
+    return requester.request(SHARE_SCREENSHOT_METHOD, options);
+}
+
+/**
+ * 展示以当前小程序通用分享页为落地页的基础分享面板。
+ *
+ * @param requester - 底层 bridge 请求能力。
+ * @param options - 基础分享参数。
+ * @returns 由宿主客户端协议决定的结果。
+ * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
+ */
+function showShareMenu(requester, options) {
+    return requester.request(SHARE_SHOW_SHARE_MENU_METHOD, options);
+}
+
+/**
+ * 创建分享模块。
+ *
+ * @param requester - 底层 bridge 请求能力。
+ * @returns 面向业务层的分享模块对象。
+ */
+function createShareModule(requester, launchHref) {
+    return {
+        copyLink: (options) => copyLink(requester, options),
+        getExtra: () => readMiniProgramShareExtra(launchHref),
+        showShareMenu: (options) => showShareMenu(requester, options),
+        screenshot: (options) => screenshot(requester, options),
+    };
+}
+
+/**
+ * 获取小程序隔离 storage。
+ *
+ * @param requester - 底层 bridge 请求能力。
+ * @param options - 读取的 storage key。
+ * @returns 对应 key 的标准化读取结果。
+ * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
+ */
+function getStorage(requester, options) {
+    return requester.request(STORAGE_GET_STORAGE_METHOD, options);
+}
+/**
+ * 写入小程序隔离 storage。
+ *
+ * @param requester - 底层 bridge 请求能力。
+ * @param options - 要写入的 storage key 与数据。
+ * @returns 当写入完成后 resolve。
+ * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
+ */
+function setStorage(requester, options) {
+    return requester.request(STORAGE_SET_STORAGE_METHOD, options);
+}
+/**
+ * 创建 storage 模块。
+ *
+ * @param requester - 底层 bridge 请求能力。
+ * @returns 面向业务层的 storage 模块对象。
+ */
+function createStorageModule(requester) {
+    return {
+        getStorage: (options) => getStorage(requester, options),
+        setStorage: (options) => setStorage(requester, options),
+    };
 }
 
 const LOG_PREFIX = '[hb-sdk][network.request]';
@@ -3758,6 +4072,8 @@ class MiniProgramSDK {
     navigation;
     /** 云端数据相关开放能力。 */
     cloud;
+    /** 受管桌面程序能力。 */
+    companion;
     /** 当前实例的环境信息。 */
     environment;
     constructor(options) {
@@ -3774,6 +4090,7 @@ class MiniProgramSDK {
         this.device = createDeviceModule(this.client);
         this.navigation = createNavigationModule(this.client);
         this.cloud = createCloudModule(this.client);
+        this.companion = createCompanionModule(this.client);
         this.environment = createEnvironmentModule(this.client);
     }
     /** 获取当前握手状态。 */
@@ -3913,6 +4230,9 @@ function installMiniDevConsoleForwarding(consoleRef = console) {
 }
 
 let defaultSDK = createMiniProgramSDK();
+if (typeof false !== 'undefined' && false && typeof window !== 'undefined') {
+    window.__hbSdkSandboxList = async (path) => (await getDefaultSDK().files.sandbox.directory(path).list({ limit: 200 })).map(entry => ({ name: entry.name, kind: entry.kind }));
+}
 // 开发期调试台 console 捕获：双条件门控（vite serve 注入 define + 调试 iframe 标记），
 // 生产构建被死代码消除，正式环境无副作用。失败静默，绝不影响 SDK 初始化。
 try {
@@ -4073,6 +4393,15 @@ const cloud = {
         getInfo: (options) => getDefaultSDK().cloud.leaderboard.getInfo(options),
     },
 };
+/** 默认 SDK 实例的受管桌面程序模块。 */
+const companion = {
+    getInfo: (alias) => getDefaultSDK().companion.getInfo(alias),
+    getPreparationStatus: (alias) => getDefaultSDK().companion.getPreparationStatus(alias),
+    prepare: (alias, options) => getDefaultSDK().companion.prepare(alias, options),
+    cancelPreparation: (alias) => getDefaultSDK().companion.cancelPreparation(alias),
+    launch: (alias) => getDefaultSDK().companion.launch(alias),
+    getActiveSession: (alias) => getDefaultSDK().companion.getActiveSession(alias),
+};
 /** 默认 SDK 实例的 environment 模块。 */
 const environment = {
     getInfo: () => getDefaultSDK().environment.getInfo(),
@@ -4096,6 +4425,7 @@ const hbSDK = {
     environment,
     navigation,
     cloud,
+    companion,
 };
 
-export { HbMiniProgramNetworkError, HbMiniProgramSDKError, USER_INFO_AUTHORIZATION_SCOPES, auth, cloud, hbSDK as default, device, environment, files, getHandshakeState, navigation, network, off, on, onHandshakeStateChange, share, storage, ui, user, viewport };
+export { HbMiniProgramNetworkError, HbMiniProgramSDKError, USER_INFO_AUTHORIZATION_SCOPES, auth, cloud, companion, hbSDK as default, device, environment, files, getHandshakeState, navigation, network, off, on, onHandshakeStateChange, share, storage, ui, user, viewport };