expo-gaode-map 2.2.32 → 2.2.33

package/build/module/location.js

@@ -0,0 +1,257 @@
+import { Platform } from 'react-native';
+import { ErrorHandler, ErrorLogger } from '../utils/ErrorHandler';
+import { normalizeLatLng } from '../utils/GeoUtils';
+import { getNativeModule } from './nativeModule';
+import { normalizeCoordinateType, normalizeGeoLanguage, normalizeHeadingEvent, normalizeLocationResult, normalizePermissionStatus, } from './normalizers';
+import { assertPrivacyReady } from './privacy';
+export const locationMethods = {
+    start() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return;
+        try {
+            nativeModule.start();
+        }
+        catch (error) {
+            ErrorLogger.warn('start 失败', { error });
+        }
+    },
+    stop() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return;
+        try {
+            nativeModule.stop();
+        }
+        catch (error) {
+            ErrorLogger.warn('stop 失败', { error });
+        }
+    },
+    isStarted() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return Promise.resolve(false);
+        try {
+            return nativeModule.isStarted();
+        }
+        catch (error) {
+            ErrorLogger.warn('isStarted 失败', { error });
+            return Promise.resolve(false);
+        }
+    },
+    async getCurrentLocation() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            const location = await nativeModule.getCurrentLocation();
+            return normalizeLocationResult(location);
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '获取当前位置');
+        }
+    },
+    async coordinateConvert(coordinate, type) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            const normalizedCoordinate = normalizeLatLng(coordinate);
+            const normalizedType = normalizeCoordinateType(type);
+            if (normalizedType === null) {
+                return normalizedCoordinate;
+            }
+            return await nativeModule.coordinateConvert(normalizedCoordinate, normalizedType);
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '坐标转换');
+        }
+    },
+    setGeoLanguage(language) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return;
+        try {
+            nativeModule.setGeoLanguage(normalizeGeoLanguage(language));
+        }
+        catch (error) {
+            ErrorLogger.warn('setGeoLanguage 失败', { language, error });
+        }
+    },
+    setLocatingWithReGeocode(isReGeocode) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return;
+        try {
+            nativeModule.setLocatingWithReGeocode(isReGeocode);
+        }
+        catch (error) {
+            ErrorLogger.warn('setLocatingWithReGeocode 失败', { isReGeocode, error });
+        }
+    },
+    get isBackgroundLocationEnabled() {
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return false;
+        return nativeModule.isBackgroundLocationEnabled === true;
+    },
+    /**
+     * 检查位置权限状态
+     */
+    async checkLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            return normalizePermissionStatus(await nativeModule.checkLocationPermission());
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '检查权限');
+        }
+    },
+    /**
+     * 请求前台位置权限（增强版）
+     */
+    async requestLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            const result = normalizePermissionStatus(await nativeModule.requestLocationPermission());
+            if (!result.granted) {
+                ErrorLogger.warn('前台位置权限未授予', result);
+            }
+            return result;
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '请求前台权限');
+        }
+    },
+    /**
+     * 请求后台位置权限
+     * 注意：必须在前台权限已授予后才能请求
+     */
+    async requestBackgroundLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            const result = normalizePermissionStatus(await nativeModule.requestBackgroundLocationPermission());
+            if (!result.granted) {
+                ErrorLogger.warn('后台位置权限未授予', result);
+            }
+            return result;
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '请求后台权限');
+        }
+    },
+    /**
+     * 打开应用设置页面
+     * 引导用户手动授予权限
+     */
+    openAppSettings() {
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            nativeModule.openAppSettings();
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '打开设置');
+        }
+    },
+    setAllowsBackgroundLocationUpdates(allows) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        if (Platform.OS === 'ios' &&
+            allows &&
+            nativeModule &&
+            nativeModule.isBackgroundLocationEnabled === false) {
+            ErrorLogger.warn('⚠️ [ExpoGaodeMap] iOS 后台定位未正确配置，setAllowsBackgroundLocationUpdates(true) 可能不会生效，请检查 Info.plist 是否包含 UIBackgroundModes: location，或者在 app.json 中配置 enableBackgroundLocation: true，然后重新执行 npx expo prebuild');
+        }
+        if (Platform.OS === 'android' &&
+            allows &&
+            nativeModule &&
+            nativeModule.checkLocationPermission) {
+            nativeModule
+                .checkLocationPermission()
+                .then((status) => {
+                if (!status.backgroundLocation) {
+                    ErrorLogger.warn('⚠️ [ExpoGaodeMap] Android 后台位置权限未授予，setAllowsBackgroundLocationUpdates(true) 可能不会生效，请先通过 requestBackgroundLocationPermission 或系统设置授予后台定位权限,或者检查是否在 app.json 中配置了 enableBackgroundLocation: true，然后重新执行 npx expo prebuild');
+                }
+            })
+                .catch(() => {
+                // 忽略检查失败，只影响日志，不影响功能
+            });
+        }
+        nativeModule.setAllowsBackgroundLocationUpdates(allows);
+    },
+    /**
+     * 添加定位监听器（便捷方法）
+     * 自动订阅 onLocationUpdate 事件，提供容错处理
+     * @param listener 定位回调函数
+     * @returns 订阅对象，调用 remove() 取消监听
+     * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
+     */
+    addLocationListener(listener) {
+        assertPrivacyReady('sdk');
+        const module = getNativeModule();
+        if (!module) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        if (!module.addListener) {
+            ErrorLogger.warn('Native module does not support events');
+            return {
+                remove: () => { },
+            };
+        }
+        return module.addListener('onLocationUpdate', (location) => {
+            listener(normalizeLocationResult(location));
+        }) || {
+            remove: () => { },
+        };
+    },
+    /**
+     * 添加方向监听器（iOS）
+     * 自动归一化 heading 事件字段，兼容旧版原生返回结构
+     */
+    addHeadingListener(listener) {
+        assertPrivacyReady('sdk');
+        const module = getNativeModule();
+        if (!module) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        if (!module.addListener) {
+            ErrorLogger.warn('Native module does not support events');
+            return {
+                remove: () => { },
+            };
+        }
+        return module.addListener('onHeadingUpdate', (heading) => {
+            listener(normalizeHeadingEvent(heading));
+        }) || {
+            remove: () => { },
+        };
+    },
+};
+//# sourceMappingURL=location.js.map

package/build/module/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/module/location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAaxC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK;QACH,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI;QACF,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,IAAI,CAAC;YACH,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,SAAS;QACP,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,kBAAkB,EAAE,CAAC;YACzD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,UAAuB,EAAE,IAAoB;QACnE,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,oBAAoB,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;YAErD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,OAAO,oBAAoB,CAAC;YAC9B,CAAC;YAED,OAAO,MAAM,YAAY,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,cAAc,CAAC,QAA8B;QAC3C,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,IAAI,CAAC;YACH,YAAY,CAAC,cAAc,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,wBAAwB,CAAC,WAAoB;QAC3C,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,IAAI,CAAC;YACH,YAAY,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,2BAA2B;QAC7B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAChC,OAAO,YAAY,CAAC,2BAA2B,KAAK,IAAI,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB;QAC3B,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,OAAO,yBAAyB,CAAC,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,yBAAyB;QAC7B,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,yBAAyB,CAAC,MAAM,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;YACzF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mCAAmC;QACvC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,yBAAyB,CAAC,MAAM,YAAY,CAAC,mCAAmC,EAAE,CAAC,CAAC;YACnG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC;YACH,YAAY,CAAC,eAAe,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,kCAAkC,CAAC,MAAe;QAChD,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QAED,IACE,QAAQ,CAAC,EAAE,KAAK,KAAK;YACrB,MAAM;YACN,YAAY;YACZ,YAAY,CAAC,2BAA2B,KAAK,KAAK,EAClD,CAAC;YACD,WAAW,CAAC,IAAI,CACd,0MAA0M,CAC3M,CAAC;QACJ,CAAC;QAED,IACE,QAAQ,CAAC,EAAE,KAAK,SAAS;YACzB,MAAM;YACN,YAAY;YACZ,YAAY,CAAC,uBAAuB,EACpC,CAAC;YACD,YAAY;iBACT,uBAAuB,EAAE;iBACzB,IAAI,CAAC,CAAC,MAAwB,EAAE,EAAE;gBACjC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;oBAC/B,WAAW,CAAC,IAAI,CACd,0NAA0N,CAC3N,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,qBAAqB;YACvB,CAAC,CAAC,CAAC;QACP,CAAC;QAED,YAAY,CAAC,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,QAA0B;QAC5C,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YAC1D,OAAO;gBACL,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;aAClB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE;YACzD,QAAQ,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,IAAI;YACJ,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;SAClB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,QAAyB;QAC1C,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YAC1D,OAAO;gBACL,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;aAClB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE;YACvD,QAAQ,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,IAAI;YACJ,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;SAClB,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["import { Platform } from 'react-native';\n\nimport type {\n  Coordinates,\n  CoordinateType,\n  GeoLanguage,\n  HeadingListener,\n  LatLng,\n  LatLngPoint,\n  LocationListener,\n  ReGeocode,\n} from '../types';\nimport type { PermissionStatus } from '../types/common.types';\nimport { ErrorHandler, ErrorLogger } from '../utils/ErrorHandler';\nimport { normalizeLatLng } from '../utils/GeoUtils';\nimport { getNativeModule } from './nativeModule';\nimport {\n  normalizeCoordinateType,\n  normalizeGeoLanguage,\n  normalizeHeadingEvent,\n  normalizeLocationResult,\n  normalizePermissionStatus,\n} from './normalizers';\nimport { assertPrivacyReady } from './privacy';\n\nexport const locationMethods = {\n  start(): void {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule(true);\n    if (!nativeModule) return;\n    try {\n      nativeModule.start();\n    } catch (error) {\n      ErrorLogger.warn('start 失败', { error });\n    }\n  },\n\n  stop(): void {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule(true);\n    if (!nativeModule) return;\n    try {\n      nativeModule.stop();\n    } catch (error) {\n      ErrorLogger.warn('stop 失败', { error });\n    }\n  },\n\n  isStarted(): Promise<boolean> {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule(true);\n    if (!nativeModule) return Promise.resolve(false);\n    try {\n      return nativeModule.isStarted();\n    } catch (error) {\n      ErrorLogger.warn('isStarted 失败', { error });\n      return Promise.resolve(false);\n    }\n  },\n\n  async getCurrentLocation(): Promise<Coordinates | ReGeocode> {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    try {\n      const location = await nativeModule.getCurrentLocation();\n      return normalizeLocationResult(location);\n    } catch (error) {\n      throw ErrorHandler.wrapNativeError(error, '获取当前位置');\n    }\n  },\n\n  async coordinateConvert(coordinate: LatLngPoint, type: CoordinateType): Promise<LatLng> {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    try {\n      const normalizedCoordinate = normalizeLatLng(coordinate);\n      const normalizedType = normalizeCoordinateType(type);\n\n      if (normalizedType === null) {\n        return normalizedCoordinate;\n      }\n\n      return await nativeModule.coordinateConvert(normalizedCoordinate, normalizedType);\n    } catch (error) {\n      throw ErrorHandler.wrapNativeError(error, '坐标转换');\n    }\n  },\n\n  setGeoLanguage(language: GeoLanguage | string): void {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule(true);\n    if (!nativeModule) return;\n    try {\n      nativeModule.setGeoLanguage(normalizeGeoLanguage(language));\n    } catch (error) {\n      ErrorLogger.warn('setGeoLanguage 失败', { language, error });\n    }\n  },\n\n  setLocatingWithReGeocode(isReGeocode: boolean): void {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule(true);\n    if (!nativeModule) return;\n    try {\n      nativeModule.setLocatingWithReGeocode(isReGeocode);\n    } catch (error) {\n      ErrorLogger.warn('setLocatingWithReGeocode 失败', { isReGeocode, error });\n    }\n  },\n\n  get isBackgroundLocationEnabled(): boolean {\n    const nativeModule = getNativeModule(true);\n    if (!nativeModule) return false;\n    return nativeModule.isBackgroundLocationEnabled === true;\n  },\n\n  /**\n   * 检查位置权限状态\n   */\n  async checkLocationPermission(): Promise<PermissionStatus> {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    try {\n      return normalizePermissionStatus(await nativeModule.checkLocationPermission());\n    } catch (error) {\n      throw ErrorHandler.wrapNativeError(error, '检查权限');\n    }\n  },\n\n  /**\n   * 请求前台位置权限（增强版）\n   */\n  async requestLocationPermission(): Promise<PermissionStatus> {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    try {\n      const result = normalizePermissionStatus(await nativeModule.requestLocationPermission());\n      if (!result.granted) {\n        ErrorLogger.warn('前台位置权限未授予', result);\n      }\n      return result;\n    } catch (error) {\n      throw ErrorHandler.wrapNativeError(error, '请求前台权限');\n    }\n  },\n\n  /**\n   * 请求后台位置权限\n   * 注意：必须在前台权限已授予后才能请求\n   */\n  async requestBackgroundLocationPermission(): Promise<PermissionStatus> {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    try {\n      const result = normalizePermissionStatus(await nativeModule.requestBackgroundLocationPermission());\n      if (!result.granted) {\n        ErrorLogger.warn('后台位置权限未授予', result);\n      }\n      return result;\n    } catch (error) {\n      throw ErrorHandler.wrapNativeError(error, '请求后台权限');\n    }\n  },\n\n  /**\n   * 打开应用设置页面\n   * 引导用户手动授予权限\n   */\n  openAppSettings(): void {\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    try {\n      nativeModule.openAppSettings();\n    } catch (error) {\n      throw ErrorHandler.wrapNativeError(error, '打开设置');\n    }\n  },\n\n  setAllowsBackgroundLocationUpdates(allows: boolean): void {\n    assertPrivacyReady('sdk');\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n\n    if (\n      Platform.OS === 'ios' &&\n      allows &&\n      nativeModule &&\n      nativeModule.isBackgroundLocationEnabled === false\n    ) {\n      ErrorLogger.warn(\n        '⚠️ [ExpoGaodeMap] iOS 后台定位未正确配置，setAllowsBackgroundLocationUpdates(true) 可能不会生效，请检查 Info.plist 是否包含 UIBackgroundModes: location，或者在 app.json 中配置 enableBackgroundLocation: true，然后重新执行 npx expo prebuild',\n      );\n    }\n\n    if (\n      Platform.OS === 'android' &&\n      allows &&\n      nativeModule &&\n      nativeModule.checkLocationPermission\n    ) {\n      nativeModule\n        .checkLocationPermission()\n        .then((status: PermissionStatus) => {\n          if (!status.backgroundLocation) {\n            ErrorLogger.warn(\n              '⚠️ [ExpoGaodeMap] Android 后台位置权限未授予，setAllowsBackgroundLocationUpdates(true) 可能不会生效，请先通过 requestBackgroundLocationPermission 或系统设置授予后台定位权限,或者检查是否在 app.json 中配置了 enableBackgroundLocation: true，然后重新执行 npx expo prebuild',\n            );\n          }\n        })\n        .catch(() => {\n          // 忽略检查失败，只影响日志，不影响功能\n        });\n    }\n\n    nativeModule.setAllowsBackgroundLocationUpdates(allows);\n  },\n\n  /**\n   * 添加定位监听器（便捷方法）\n   * 自动订阅 onLocationUpdate 事件，提供容错处理\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void } {\n    assertPrivacyReady('sdk');\n    const module = getNativeModule();\n    if (!module) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    if (!module.addListener) {\n      ErrorLogger.warn('Native module does not support events');\n      return {\n        remove: () => { },\n      };\n    }\n\n    return module.addListener('onLocationUpdate', (location) => {\n      listener(normalizeLocationResult(location));\n    }) || {\n      remove: () => { },\n    };\n  },\n\n  /**\n   * 添加方向监听器（iOS）\n   * 自动归一化 heading 事件字段，兼容旧版原生返回结构\n   */\n  addHeadingListener(listener: HeadingListener): { remove: () => void } {\n    assertPrivacyReady('sdk');\n    const module = getNativeModule();\n    if (!module) {\n      throw ErrorHandler.nativeModuleUnavailable();\n    }\n    if (!module.addListener) {\n      ErrorLogger.warn('Native module does not support events');\n      return {\n        remove: () => { },\n      };\n    }\n\n    return module.addListener('onHeadingUpdate', (heading) => {\n      listener(normalizeHeadingEvent(heading));\n    }) || {\n      remove: () => { },\n    };\n  },\n};\n"]}

package/build/module/nativeModule.d.ts

@@ -0,0 +1,5 @@
+import type { NativeExpoGaodeMapModule } from '../types/native-module.types';
+export declare function getNativeModule(optional?: boolean): NativeExpoGaodeMapModule | null;
+export declare function getBoundNativeValue(module: NativeExpoGaodeMapModule, prop: PropertyKey): unknown;
+export declare const nativeModule: NativeExpoGaodeMapModule;
+//# sourceMappingURL=nativeModule.d.ts.map

package/build/module/nativeModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeModule.d.ts","sourceRoot":"","sources":["../../src/module/nativeModule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAK7E,wBAAgB,eAAe,CAAC,QAAQ,UAAQ,GAAG,wBAAwB,GAAG,IAAI,CAgBjF;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,wBAAwB,EAChC,IAAI,EAAE,WAAW,GAChB,OAAO,CAOT;AAED,eAAO,MAAM,YAAY,0BAKvB,CAAC"}

package/build/module/nativeModule.js

@@ -0,0 +1,34 @@
+import { requireNativeModule } from 'expo';
+import { ErrorHandler, ErrorLogger } from '../utils/ErrorHandler';
+let nativeModuleCache = null;
+export function getNativeModule(optional = false) {
+    if (nativeModuleCache) {
+        return nativeModuleCache;
+    }
+    try {
+        nativeModuleCache = requireNativeModule('ExpoGaodeMap');
+        return nativeModuleCache;
+    }
+    catch (error) {
+        if (optional) {
+            return null;
+        }
+        const moduleError = ErrorHandler.nativeModuleUnavailable();
+        ErrorLogger.log(moduleError);
+        throw moduleError;
+    }
+}
+export function getBoundNativeValue(module, prop) {
+    const value = Reflect.get(module, prop, module);
+    if (typeof value === 'function') {
+        return (...args) => value.apply(module, args);
+    }
+    return value;
+}
+export const nativeModule = new Proxy({}, {
+    get(_target, prop) {
+        const module = getNativeModule(true);
+        return module ? getBoundNativeValue(module, prop) : undefined;
+    },
+});
+//# sourceMappingURL=nativeModule.js.map

package/build/module/nativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeModule.js","sourceRoot":"","sources":["../../src/module/nativeModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAElE,IAAI,iBAAiB,GAAoC,IAAI,CAAC;AAE9D,MAAM,UAAU,eAAe,CAAC,QAAQ,GAAG,KAAK;IAC9C,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC;QACH,iBAAiB,GAAG,mBAAmB,CAA2B,cAAc,CAAC,CAAC;QAClF,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,WAAW,GAAG,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAC3D,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7B,MAAM,WAAW,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAgC,EAChC,IAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,EAAE,MAAgB,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAC3B,KAA2C,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,EAA8B,EAAE;IACpE,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from 'expo';\n\nimport type { NativeExpoGaodeMapModule } from '../types/native-module.types';\nimport { ErrorHandler, ErrorLogger } from '../utils/ErrorHandler';\n\nlet nativeModuleCache: NativeExpoGaodeMapModule | null = null;\n\nexport function getNativeModule(optional = false): NativeExpoGaodeMapModule | null {\n  if (nativeModuleCache) {\n    return nativeModuleCache;\n  }\n\n  try {\n    nativeModuleCache = requireNativeModule<NativeExpoGaodeMapModule>('ExpoGaodeMap');\n    return nativeModuleCache;\n  } catch (error) {\n    if (optional) {\n      return null;\n    }\n    const moduleError = ErrorHandler.nativeModuleUnavailable();\n    ErrorLogger.log(moduleError);\n    throw moduleError;\n  }\n}\n\nexport function getBoundNativeValue(\n  module: NativeExpoGaodeMapModule,\n  prop: PropertyKey\n): unknown {\n  const value = Reflect.get(module as object, prop, module as object);\n  if (typeof value === 'function') {\n    return (...args: unknown[]) =>\n      (value as (...fnArgs: unknown[]) => unknown).apply(module, args);\n  }\n  return value;\n}\n\nexport const nativeModule = new Proxy({} as NativeExpoGaodeMapModule, {\n  get(_target, prop) {\n    const module = getNativeModule(true);\n    return module ? getBoundNativeValue(module, prop) : undefined;\n  },\n});\n"]}

package/build/module/normalizers.d.ts

@@ -0,0 +1,9 @@
+import type { Coordinates, CoordinateType, GeoLanguage, HeadingUpdate, LatLngPoint, ReGeocode } from '../types';
+import type { PermissionStatus } from '../types/common.types';
+export declare function normalizeCoordinateType(type: CoordinateType): number | null;
+export declare function normalizeGeoLanguage(language: GeoLanguage | string): GeoLanguage;
+export declare function normalizeLocationResult<T extends Coordinates | ReGeocode>(location: T): T;
+export declare function normalizeHeadingEvent(payload: HeadingUpdate | Record<string, unknown>): HeadingUpdate;
+export declare function normalizePermissionStatus(permission: PermissionStatus | Record<string, unknown>): PermissionStatus;
+export type { LatLngPoint };
+//# sourceMappingURL=normalizers.d.ts.map

package/build/module/normalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../src/module/normalizers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAqB3E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,CAyBhF;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAQzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAcrG;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAqDlH;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/build/module/normalizers.js

@@ -0,0 +1,109 @@
+import { ErrorHandler } from '../utils/ErrorHandler';
+import { CoordinateType as CoordinateTypeValue } from '../types';
+export function normalizeCoordinateType(type) {
+    switch (type) {
+        case CoordinateTypeValue.AMap:
+            return null;
+        case CoordinateTypeValue.MapBar:
+            return 1;
+        case CoordinateTypeValue.Baidu:
+            return 2;
+        case CoordinateTypeValue.MapABC:
+        case CoordinateTypeValue.SoSoMap:
+            return 3;
+        case CoordinateTypeValue.Google:
+        case CoordinateTypeValue.GPS:
+            return 0;
+        default:
+            throw ErrorHandler.invalidParameter('type', 'CoordinateType.AMap | MapBar | Baidu | MapABC | SoSoMap | Google | GPS', type);
+    }
+}
+export function normalizeGeoLanguage(language) {
+    const normalized = String(language).trim().toUpperCase();
+    switch (normalized) {
+        case 'DEFAULT':
+            return 'DEFAULT';
+        case 'EN':
+        case 'EN-US':
+        case 'EN_US':
+        case 'EN-GB':
+        case 'EN_GB':
+            return 'EN';
+        case 'ZH':
+        case 'ZH-CN':
+        case 'ZH_CN':
+        case 'ZH-HANS':
+        case 'ZH_HANS':
+            return 'ZH';
+        default:
+            throw ErrorHandler.invalidParameter('language', "'DEFAULT' | 'EN' | 'ZH' | 常见别名（如 'en', 'zh-CN'）", language);
+    }
+}
+export function normalizeLocationResult(location) {
+    const rawLocation = location;
+    const heading = rawLocation.heading ?? rawLocation.bearing ?? 0;
+    return {
+        ...rawLocation,
+        heading,
+    };
+}
+export function normalizeHeadingEvent(payload) {
+    const raw = payload;
+    const fallbackHeading = Number(raw.heading ?? raw.trueHeading ?? raw.magneticHeading ?? 0);
+    const fallbackAccuracy = Number(raw.accuracy ?? raw.headingAccuracy ?? 0);
+    return {
+        magneticHeading: Number(raw.magneticHeading ?? fallbackHeading),
+        trueHeading: Number(raw.trueHeading ?? fallbackHeading),
+        headingAccuracy: fallbackAccuracy,
+        x: Number(raw.x ?? 0),
+        y: Number(raw.y ?? 0),
+        z: Number(raw.z ?? 0),
+        timestamp: Number(raw.timestamp ?? Date.now()),
+    };
+}
+export function normalizePermissionStatus(permission) {
+    const raw = permission;
+    const rawStatus = String(raw.status ?? '');
+    let status;
+    switch (rawStatus) {
+        case 'granted':
+        case 'authorizedAlways':
+        case 'authorizedWhenInUse':
+            status = 'granted';
+            break;
+        case 'denied':
+        case 'restricted':
+            status = 'denied';
+            break;
+        case 'notDetermined':
+        case 'undetermined':
+        case 'unknown':
+        case '':
+        default:
+            status = 'undetermined';
+            break;
+    }
+    const granted = Boolean(raw.granted ?? (status === 'granted'));
+    const shouldShowRationale = typeof raw.shouldShowRationale === 'boolean' ? raw.shouldShowRationale : undefined;
+    const explicitPermanent = typeof raw.isPermanentlyDenied === 'boolean' ? raw.isPermanentlyDenied : undefined;
+    const canAskAgain = typeof raw.canAskAgain === 'boolean'
+        ? raw.canAskAgain
+        : granted
+            ? true
+            : typeof shouldShowRationale === 'boolean'
+                ? shouldShowRationale
+                : explicitPermanent === true
+                    ? false
+                    : status === 'undetermined';
+    const isPermanentlyDenied = explicitPermanent ??
+        (!granted && status === 'denied' && canAskAgain === false);
+    return {
+        ...raw,
+        expires: raw.expires ?? 'never',
+        granted,
+        status: status,
+        canAskAgain,
+        isPermanentlyDenied,
+    };
+}
+//# sourceMappingURL=normalizers.js.map

package/build/module/normalizers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.js","sourceRoot":"","sources":["../../src/module/normalizers.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Coordinates,\n  CoordinateType,\n  GeoLanguage,\n  HeadingUpdate,\n  LatLngPoint,\n  ReGeocode,\n} from '../types';\nimport type { PermissionStatus } from '../types/common.types';\nimport { ErrorHandler } from '../utils/ErrorHandler';\nimport { CoordinateType as CoordinateTypeValue } from '../types';\n\nexport function normalizeCoordinateType(type: CoordinateType): number | null {\n  switch (type) {\n    case CoordinateTypeValue.AMap:\n      return null;\n    case CoordinateTypeValue.MapBar:\n      return 1;\n    case CoordinateTypeValue.Baidu:\n      return 2;\n    case CoordinateTypeValue.MapABC:\n    case CoordinateTypeValue.SoSoMap:\n      return 3;\n    case CoordinateTypeValue.Google:\n    case CoordinateTypeValue.GPS:\n      return 0;\n    default:\n      throw ErrorHandler.invalidParameter(\n        'type',\n        'CoordinateType.AMap | MapBar | Baidu | MapABC | SoSoMap | Google | GPS',\n        type\n      );\n  }\n}\n\nexport function normalizeGeoLanguage(language: GeoLanguage | string): GeoLanguage {\n  const normalized = String(language).trim().toUpperCase();\n\n  switch (normalized) {\n    case 'DEFAULT':\n      return 'DEFAULT';\n    case 'EN':\n    case 'EN-US':\n    case 'EN_US':\n    case 'EN-GB':\n    case 'EN_GB':\n      return 'EN';\n    case 'ZH':\n    case 'ZH-CN':\n    case 'ZH_CN':\n    case 'ZH-HANS':\n    case 'ZH_HANS':\n      return 'ZH';\n    default:\n      throw ErrorHandler.invalidParameter(\n        'language',\n        \"'DEFAULT' | 'EN' | 'ZH' | 常见别名（如 'en', 'zh-CN'）\",\n        language\n      );\n  }\n}\n\nexport function normalizeLocationResult<T extends Coordinates | ReGeocode>(location: T): T {\n  const rawLocation = location as T & { bearing?: number; heading?: number };\n  const heading = rawLocation.heading ?? rawLocation.bearing ?? 0;\n\n  return {\n    ...rawLocation,\n    heading,\n  };\n}\n\nexport function normalizeHeadingEvent(payload: HeadingUpdate | Record<string, unknown>): HeadingUpdate {\n  const raw = payload as Record<string, unknown>;\n  const fallbackHeading = Number(raw.heading ?? raw.trueHeading ?? raw.magneticHeading ?? 0);\n  const fallbackAccuracy = Number(raw.accuracy ?? raw.headingAccuracy ?? 0);\n\n  return {\n    magneticHeading: Number(raw.magneticHeading ?? fallbackHeading),\n    trueHeading: Number(raw.trueHeading ?? fallbackHeading),\n    headingAccuracy: fallbackAccuracy,\n    x: Number(raw.x ?? 0),\n    y: Number(raw.y ?? 0),\n    z: Number(raw.z ?? 0),\n    timestamp: Number(raw.timestamp ?? Date.now()),\n  };\n}\n\nexport function normalizePermissionStatus(permission: PermissionStatus | Record<string, unknown>): PermissionStatus {\n  const raw = permission as Partial<PermissionStatus> & Record<string, unknown>;\n  const rawStatus = String(raw.status ?? '');\n\n  let status: 'granted' | 'denied' | 'undetermined';\n  switch (rawStatus) {\n    case 'granted':\n    case 'authorizedAlways':\n    case 'authorizedWhenInUse':\n      status = 'granted';\n      break;\n    case 'denied':\n    case 'restricted':\n      status = 'denied';\n      break;\n    case 'notDetermined':\n    case 'undetermined':\n    case 'unknown':\n    case '':\n    default:\n      status = 'undetermined';\n      break;\n  }\n\n  const granted = Boolean(raw.granted ?? (status === 'granted'));\n  const shouldShowRationale =\n    typeof raw.shouldShowRationale === 'boolean' ? raw.shouldShowRationale : undefined;\n  const explicitPermanent =\n    typeof raw.isPermanentlyDenied === 'boolean' ? raw.isPermanentlyDenied : undefined;\n\n  const canAskAgain =\n    typeof raw.canAskAgain === 'boolean'\n      ? raw.canAskAgain\n      : granted\n        ? true\n        : typeof shouldShowRationale === 'boolean'\n          ? shouldShowRationale\n          : explicitPermanent === true\n            ? false\n            : status === 'undetermined';\n\n  const isPermanentlyDenied =\n    explicitPermanent ??\n    (!granted && status === 'denied' && canAskAgain === false);\n\n  return {\n    ...raw,\n    expires: raw.expires ?? 'never',\n    granted,\n    status: status as unknown as PermissionStatus['status'],\n    canAskAgain,\n    isPermanentlyDenied,\n  };\n}\n\nexport type { LatLngPoint };\n"]}

package/build/module/privacy.d.ts

@@ -0,0 +1,20 @@
+import type { PrivacyConfig, PrivacyStatus } from '../types/common.types';
+export declare function assertPrivacyReady(scene?: 'map' | 'sdk'): void;
+export declare const privacyMethods: {
+    /**
+     * 设置当前隐私协议版本
+     * 当版本号变化时，之前的同意状态会失效
+     */
+    setPrivacyVersion(version: string): void;
+    /**
+     * 清空已持久化的隐私同意状态
+     */
+    resetPrivacyConsent(): void;
+    /**
+     * 一次性同步完整的隐私状态
+     * 推荐业务层只调用这个方法
+     */
+    setPrivacyConfig(config: PrivacyConfig): void;
+    getPrivacyStatus(): PrivacyStatus;
+};
+//# sourceMappingURL=privacy.d.ts.map

package/build/module/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../src/module/privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI1E,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,KAAK,GAAG,KAAa,GAAG,IAAI,CASrE;AAED,eAAO,MAAM,cAAc;IACzB;;;OAGG;+BACwB,MAAM,GAAG,IAAI;IAMxC;;OAEG;2BACoB,IAAI;IAM3B;;;OAGG;6BACsB,aAAa,GAAG,IAAI;wBAMzB,aAAa;CAelC,CAAC"}

package/build/module/privacy.js

@@ -0,0 +1,59 @@
+import { ErrorHandler } from '../utils/ErrorHandler';
+import { getNativeModule } from './nativeModule';
+export function assertPrivacyReady(scene = 'sdk') {
+    const nativeModule = getNativeModule();
+    if (!nativeModule) {
+        throw ErrorHandler.nativeModuleUnavailable();
+    }
+    const status = nativeModule.getPrivacyStatus();
+    if (!status.isReady) {
+        throw ErrorHandler.privacyNotAgreed(scene);
+    }
+}
+export const privacyMethods = {
+    /**
+     * 设置当前隐私协议版本
+     * 当版本号变化时，之前的同意状态会失效
+     */
+    setPrivacyVersion(version) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.setPrivacyVersion(version);
+    },
+    /**
+     * 清空已持久化的隐私同意状态
+     */
+    resetPrivacyConsent() {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.resetPrivacyConsent();
+    },
+    /**
+     * 一次性同步完整的隐私状态
+     * 推荐业务层只调用这个方法
+     */
+    setPrivacyConfig(config) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.setPrivacyConfig(config);
+    },
+    getPrivacyStatus() {
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            return {
+                hasShow: false,
+                hasContainsPrivacy: false,
+                hasAgree: false,
+                isReady: false,
+                privacyVersion: null,
+                agreedPrivacyVersion: null,
+                restoredFromStorage: false,
+            };
+        }
+        return nativeModule.getPrivacyStatus();
+    },
+};
+//# sourceMappingURL=privacy.js.map

package/build/module/privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.js","sourceRoot":"","sources":["../../src/module/privacy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,UAAU,kBAAkB,CAAC,QAAuB,KAAK;IAC7D,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;OAGG;IACH,iBAAiB,CAAC,OAAe;QAC/B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY;YAAE,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAChE,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY;YAAE,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAChE,YAAY,CAAC,mBAAmB,EAAE,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,MAAqB;QACpC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY;YAAE,MAAM,YAAY,CAAC,uBAAuB,EAAE,CAAC;QAChE,YAAY,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB;QACd,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,kBAAkB,EAAE,KAAK;gBACzB,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,KAAK;gBACd,cAAc,EAAE,IAAI;gBACpB,oBAAoB,EAAE,IAAI;gBAC1B,mBAAmB,EAAE,KAAK;aAC3B,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;CACF,CAAC","sourcesContent":["import type { PrivacyConfig, PrivacyStatus } from '../types/common.types';\nimport { ErrorHandler } from '../utils/ErrorHandler';\nimport { getNativeModule } from './nativeModule';\n\nexport function assertPrivacyReady(scene: 'map' | 'sdk' = 'sdk'): void {\n  const nativeModule = getNativeModule();\n  if (!nativeModule) {\n    throw ErrorHandler.nativeModuleUnavailable();\n  }\n  const status = nativeModule.getPrivacyStatus();\n  if (!status.isReady) {\n    throw ErrorHandler.privacyNotAgreed(scene);\n  }\n}\n\nexport const privacyMethods = {\n  /**\n   * 设置当前隐私协议版本\n   * 当版本号变化时，之前的同意状态会失效\n   */\n  setPrivacyVersion(version: string): void {\n    const nativeModule = getNativeModule();\n    if (!nativeModule) throw ErrorHandler.nativeModuleUnavailable();\n    nativeModule.setPrivacyVersion(version);\n  },\n\n  /**\n   * 清空已持久化的隐私同意状态\n   */\n  resetPrivacyConsent(): void {\n    const nativeModule = getNativeModule();\n    if (!nativeModule) throw ErrorHandler.nativeModuleUnavailable();\n    nativeModule.resetPrivacyConsent();\n  },\n\n  /**\n   * 一次性同步完整的隐私状态\n   * 推荐业务层只调用这个方法\n   */\n  setPrivacyConfig(config: PrivacyConfig): void {\n    const nativeModule = getNativeModule();\n    if (!nativeModule) throw ErrorHandler.nativeModuleUnavailable();\n    nativeModule.setPrivacyConfig(config);\n  },\n\n  getPrivacyStatus(): PrivacyStatus {\n    const nativeModule = getNativeModule();\n    if (!nativeModule) {\n      return {\n        hasShow: false,\n        hasContainsPrivacy: false,\n        hasAgree: false,\n        isReady: false,\n        privacyVersion: null,\n        agreedPrivacyVersion: null,\n        restoredFromStorage: false,\n      };\n    }\n    return nativeModule.getPrivacyStatus();\n  },\n};\n"]}

package/build/module/sdk.d.ts

@@ -0,0 +1,20 @@
+import type { SDKConfig } from '../types/common.types';
+export declare const sdkMethods: {
+    /**
+     * 初始化 SDK，并缓存配置（包含 webKey）
+     * 注意：允许不提供任何 API Key，因为原生端可能已通过 Config Plugin 配置
+     */
+    initSDK(config: SDKConfig): void;
+    isSDKInitialized(): boolean;
+    setLoadWorldVectorMap(enabled: boolean): void;
+    getVersion(): string;
+};
+/**
+* 获取最近一次 initSDK 的配置
+*/
+export declare function getSDKConfig(): SDKConfig | null;
+/**
+* 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）
+*/
+export declare function getWebKey(): string | undefined;
+//# sourceMappingURL=sdk.d.ts.map

package/build/module/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/module/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,eAAO,MAAM,UAAU;IACrB;;;OAGG;oBACa,SAAS,GAAG,IAAI;wBAuCZ,OAAO;mCAII,OAAO,GAAG,IAAI;kBAU/B,MAAM;CAUrB,CAAC;AAEF;;EAEE;AACF,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAE/C;AAED;;EAEE;AACF,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C"}