@supersdk/supercli 0.1.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/dist/api/consoleClient.js +132 -0
  2. package/dist/api/consoleClient.js.map +1 -0
  3. package/dist/auth/browserAuth.js +163 -0
  4. package/dist/auth/browserAuth.js.map +1 -0
  5. package/dist/auth/refresh.js +32 -0
  6. package/dist/auth/refresh.js.map +1 -0
  7. package/dist/cli.js +46 -0
  8. package/dist/cli.js.map +1 -0
  9. package/dist/commands/accounts.js +46 -0
  10. package/dist/commands/accounts.js.map +1 -0
  11. package/dist/commands/createApp.js +225 -0
  12. package/dist/commands/createApp.js.map +1 -0
  13. package/dist/commands/login.js +54 -0
  14. package/dist/commands/login.js.map +1 -0
  15. package/dist/commands/logout.js +99 -0
  16. package/dist/commands/logout.js.map +1 -0
  17. package/dist/commands/publishSite.js +361 -0
  18. package/dist/commands/publishSite.js.map +1 -0
  19. package/dist/commands/switchaccount.js +35 -0
  20. package/dist/commands/switchaccount.js.map +1 -0
  21. package/dist/commands/update.js +95 -0
  22. package/dist/commands/update.js.map +1 -0
  23. package/dist/config/environments.js +53 -0
  24. package/dist/config/environments.js.map +1 -0
  25. package/dist/createApp/copyTemplate.js +237 -0
  26. package/dist/createApp/copyTemplate.js.map +1 -0
  27. package/dist/publish/orgResolve.js +30 -0
  28. package/dist/publish/orgResolve.js.map +1 -0
  29. package/dist/publish/responseClassifier.js +111 -0
  30. package/dist/publish/responseClassifier.js.map +1 -0
  31. package/dist/publish/siteClient.js +113 -0
  32. package/dist/publish/siteClient.js.map +1 -0
  33. package/dist/publish/siteConfig.js +190 -0
  34. package/dist/publish/siteConfig.js.map +1 -0
  35. package/dist/publish/siteZip.js +172 -0
  36. package/dist/publish/siteZip.js.map +1 -0
  37. package/dist/store/accountStore.js +236 -0
  38. package/dist/store/accountStore.js.map +1 -0
  39. package/dist/store/backends/encryptedFile.js +162 -0
  40. package/dist/store/backends/encryptedFile.js.map +1 -0
  41. package/dist/store/backends/osKeyring.js +283 -0
  42. package/dist/store/backends/osKeyring.js.map +1 -0
  43. package/dist/store/credentialStore.js +65 -0
  44. package/dist/store/credentialStore.js.map +1 -0
  45. package/dist/template/README.md +144 -0
  46. package/dist/template/android/.gitkeep +1 -0
  47. package/dist/template/android/app/build.gradle.kts +122 -0
  48. package/dist/template/android/app/src/main/AndroidManifest.xml +19 -0
  49. package/dist/template/android/app/src/main/java/com/supersdk/simple/MainActivity.java +17 -0
  50. package/dist/template/android/app/src/main/java/com/supersdk/simple/SimpleApplication.java +22 -0
  51. package/dist/template/android/app/src/test/java/com/supersdk/simple/AppNameResourceTest.java +19 -0
  52. package/dist/template/android/build.gradle.kts +3 -0
  53. package/dist/template/android/gradle/supersdk-config-reader.gradle +61 -0
  54. package/dist/template/android/gradle/wrapper/gradle-wrapper.jar +0 -0
  55. package/dist/template/android/gradle/wrapper/gradle-wrapper.properties +8 -0
  56. package/dist/template/android/gradle.properties +3 -0
  57. package/dist/template/android/gradlew +251 -0
  58. package/dist/template/android/settings.gradle.kts +25 -0
  59. package/dist/template/android/supersdk-default.config.json +17 -0
  60. package/dist/template/ios/MockSuperSDKPackage/Package.swift +15 -0
  61. package/dist/template/ios/MockSuperSDKPackage/Sources/SuperSDK/SuperSDK.swift +25 -0
  62. package/dist/template/ios/Resources/Info.plist +43 -0
  63. package/dist/template/ios/Sources/App/AppDelegate.swift +20 -0
  64. package/dist/template/ios/Sources/App/SceneDelegate.swift +14 -0
  65. package/dist/template/ios/Sources/App/SimpleSDKBootstrap.swift +7 -0
  66. package/dist/template/ios/Sources/App/SimpleSDKProbe.swift +26 -0
  67. package/dist/template/ios/Sources/App/SimpleSDKProvider.swift +4 -0
  68. package/dist/template/ios/Sources/App/SimpleViewController.swift +20 -0
  69. package/dist/template/ios/Tests/SimpleAppTests/SimpleSDKInitializationTests.swift +17 -0
  70. package/dist/template/ios/project.yml +67 -0
  71. package/dist/template/scripts/android_snapshot_canary.py +136 -0
  72. package/dist/template/scripts/build_android.sh +240 -0
  73. package/dist/template/scripts/build_ios.sh +261 -0
  74. package/dist/template/scripts/build_web.sh +12 -0
  75. package/dist/template/scripts/serve_web.py +51 -0
  76. package/dist/template/scripts/super_build_orchestrator.py +400 -0
  77. package/dist/template/scripts/supersdk_template.py +611 -0
  78. package/dist/template/scripts/web_host_validator.py +103 -0
  79. package/dist/template/scripts/web_package.py +202 -0
  80. package/dist/template/scripts/ws03_shared_schema_merge_guard.py +73 -0
  81. package/dist/template/super_build.sh +116 -0
  82. package/dist/template/supersdk.yaml +15 -0
  83. package/dist/template/web/src/css/style.css +83 -0
  84. package/dist/template/web/src/index.html +37 -0
  85. package/dist/template/web/src/js/app.js +99 -0
  86. package/dist/template/web/src/js/supersdk.js +1848 -0
  87. package/dist/template/web/src/js/supersdk.provenance.json +6 -0
  88. package/dist/update/channelResolver.js +183 -0
  89. package/dist/update/channelResolver.js.map +1 -0
  90. package/dist/update/installSafety.js +135 -0
  91. package/dist/update/installSafety.js.map +1 -0
  92. package/dist/util/fsAtomic.js +294 -0
  93. package/dist/util/fsAtomic.js.map +1 -0
  94. package/dist/util/log.js +55 -0
  95. package/dist/util/log.js.map +1 -0
  96. package/dist/util/origin.js +66 -0
  97. package/dist/util/origin.js.map +1 -0
  98. package/dist/util/prompt.js +113 -0
  99. package/dist/util/prompt.js.map +1 -0
  100. package/package.json +43 -0
@@ -0,0 +1,1848 @@
1
+ /**
2
+ * JSBridge SDK
3
+ * 提供与原生 App 交互的能力
4
+ */
5
+ (function(global) {
6
+ 'use strict';
7
+
8
+ // 回调管理
9
+ const callbackMap = {};
10
+ const broadcastListeners = {};
11
+ const systemListeners = {};
12
+
13
+ // 返回键拦截回调
14
+ let _backPressedCallback = null;
15
+
16
+ // 降级配置(initFallback 写入)
17
+ let _fallbackConfig = null;
18
+ let _deviceId = null;
19
+
20
+ // JS 层支付 Provider 注册表(Web 收银台等非 Native IAP · F036 起 inline 用 '_inline' key 临时挂载)
21
+ const _payProviders = {};
22
+
23
+ // Web inline 并发守门(SDK-F036 AC-8)· Native IAP 走 PayBridge purchaseInProgress
24
+ let _webInlineInProgress = false;
25
+
26
+ // SDK-F036 · 统一 INVALID_PARAMS reject helper(应对 external CR-2 · err.detail 字段保证)
27
+ function _invalidParams(detail) {
28
+ var err = new Error('INVALID_PARAMS');
29
+ err.detail = detail;
30
+ return Promise.reject(err);
31
+ }
32
+
33
+ // SDK-F036 · 统一 Error 构造 helper(message + detail 一体)
34
+ function _makeError(code, detail) {
35
+ var err = new Error(code);
36
+ err.detail = detail || '';
37
+ return err;
38
+ }
39
+
40
+ // 生成 UUID v4
41
+ function _generateUUID() {
42
+ return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
43
+ var r = Math.random() * 16 | 0;
44
+ var v = c === 'x' ? r : (r & 0x3 | 0x8);
45
+ return v.toString(16);
46
+ });
47
+ }
48
+
49
+ // 获取或创建 deviceId(优先 localStorage 持久化)
50
+ function _getOrCreateDeviceId() {
51
+ if (_deviceId) return _deviceId;
52
+
53
+ try {
54
+ var stored = localStorage.getItem('supersdk_device_id');
55
+ if (stored) {
56
+ _deviceId = stored;
57
+ return _deviceId;
58
+ }
59
+ } catch (e) {
60
+ // 无痕模式或 localStorage 不可用
61
+ }
62
+
63
+ _deviceId = _generateUUID();
64
+
65
+ try {
66
+ localStorage.setItem('supersdk_device_id', _deviceId);
67
+ } catch (e) {
68
+ // 退化为内存存储
69
+ }
70
+
71
+ return _deviceId;
72
+ }
73
+
74
+ // 通过 fetch 直接上报事件到服务端
75
+ function _reportEventViaFetch(eventName, params) {
76
+ var fc = _fallbackConfig || {};
77
+ if (!fc.baseUrl || !fc.aid) {
78
+ return Promise.reject(new Error('reportEvent requires SuperSDK.initFallback() with baseUrl and aid'));
79
+ }
80
+
81
+ var payload = {
82
+ basic_data: {
83
+ device_id: fc.deviceId || _getOrCreateDeviceId(),
84
+ app_id: fc.aid || '',
85
+ os_type: 'web',
86
+ host_aid: fc.aid || '',
87
+ source: 'web_fallback'
88
+ },
89
+ events: [{
90
+ event_name: eventName,
91
+ event_param: params ? JSON.stringify(params) : '',
92
+ client_ts_ms: Date.now()
93
+ }]
94
+ };
95
+
96
+ var baseUrl = fc.baseUrl.replace(/\/+$/, '');
97
+ var apiBase = /\/superapi$/.test(baseUrl) ? baseUrl : baseUrl + '/superapi';
98
+ var url = apiBase + '/rptEvent';
99
+
100
+ return fetch(url, {
101
+ method: 'POST',
102
+ headers: { 'Content-Type': 'application/json' },
103
+ body: JSON.stringify(payload)
104
+ }).then(function(resp) {
105
+ if (!resp.ok) {
106
+ console.warn('[SuperSDK] reportEvent fallback HTTP error:', resp.status);
107
+ }
108
+ }).catch(function(e) {
109
+ console.warn('[SuperSDK] reportEvent fallback failed:', e.message);
110
+ });
111
+ }
112
+
113
+ // 生成唯一回调 ID
114
+ function generateCallbackId() {
115
+ return 'cb_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
116
+ }
117
+
118
+ // 注册回调
119
+ function registerCallback(callbackId, callback, timeout) {
120
+ callbackMap[callbackId] = callback;
121
+
122
+ // 超时处理
123
+ if (timeout > 0) {
124
+ setTimeout(() => {
125
+ if (callbackMap[callbackId]) {
126
+ callbackMap[callbackId]({
127
+ code: 'TIMEOUT',
128
+ message: '请求超时'
129
+ });
130
+ delete callbackMap[callbackId];
131
+ }
132
+ }, timeout);
133
+ }
134
+ }
135
+
136
+ // 订阅处理器 - 供原生调用
137
+ global.JSBridge = {
138
+ subscribeHandler: function(eventType, eventKey, data) {
139
+ if (eventType === 'ASYNC_CALLBACK') {
140
+ const callback = callbackMap[eventKey];
141
+ if (callback) {
142
+ // 调用回调,由回调处理函数决定是否删除(如下载进度需要多次回调)
143
+ callback(data);
144
+ // 对于非持续性回调,在这里删除;持续性回调(如下载)由回调内部处理删除
145
+ }
146
+ } else if (eventType === 'BROADCAST') {
147
+ const listeners = broadcastListeners[eventKey] || [];
148
+ listeners.forEach(fn => {
149
+ try {
150
+ fn(data);
151
+ } catch (e) {
152
+ console.error('Broadcast listener error:', e);
153
+ }
154
+ });
155
+ } else if (eventType === 'SYSTEM') {
156
+ const listeners = systemListeners[eventKey] || [];
157
+ listeners.forEach(fn => {
158
+ try {
159
+ fn(data);
160
+ } catch (e) {
161
+ console.error('System listener error:', e);
162
+ }
163
+ });
164
+ }
165
+ },
166
+
167
+ /**
168
+ * 返回键拦截处理,由 Native 调用
169
+ * @returns {boolean} true 表示前端已处理(拦截),false 表示未处理
170
+ */
171
+ onBackPressed: function() {
172
+ if (_backPressedCallback) {
173
+ try {
174
+ return _backPressedCallback() === true;
175
+ } catch (e) {
176
+ console.error('onBackPressed callback error:', e);
177
+ return false;
178
+ }
179
+ }
180
+ return false;
181
+ }
182
+ };
183
+
184
+ // 通知 Native 端 JSBridge 已就绪,可以 flush 缓冲的消息
185
+ // 注意:onJSBridgeReady 是【内部接口】,由 SDK 在加载时自动调用,业务代码无需也不应主动调用。
186
+ if (global.appbridge && global.appbridge.onJSBridgeReady) {
187
+ global.appbridge.onJSBridgeReady();
188
+ }
189
+
190
+ // SDK 对象
191
+ const SDK = {
192
+ /**
193
+ * 初始化非端环境降级配置
194
+ * 端内(有 appbridge)时调用被忽略
195
+ * 多次调用采用 merge 语义,只更新本次传入的字段
196
+ * @param {Object} config
197
+ * @param {string} [config.baseUrl] - 服务端地址
198
+ * @param {string} [config.aid] - 应用标识
199
+ * @param {string} [config.appName] - 应用名称
200
+ * @param {string} [config.appIcon] - 应用图标 Base64
201
+ * @param {string} [config.deviceId] - 设备标识,不传则自动生成
202
+ */
203
+ initFallback: function(config) {
204
+ if (global.appbridge) {
205
+ return;
206
+ }
207
+
208
+ if (!_fallbackConfig) {
209
+ _fallbackConfig = {
210
+ baseUrl: 'https://api.supersdk.com/superapi',
211
+ aid: '',
212
+ appName: '',
213
+ appIcon: '',
214
+ deviceId: ''
215
+ };
216
+ }
217
+
218
+ if (config) {
219
+ Object.assign(_fallbackConfig, config);
220
+ }
221
+
222
+ if (_fallbackConfig.deviceId) {
223
+ _deviceId = _fallbackConfig.deviceId;
224
+ }
225
+ },
226
+
227
+ /**
228
+ * 是否处于降级模式
229
+ * @returns {boolean} 非端环境且已调用 initFallback 时返回 true
230
+ */
231
+ isFallbackMode: function() {
232
+ return !global.appbridge && _fallbackConfig !== null;
233
+ },
234
+
235
+ /**
236
+ * 获取环境信息
237
+ * @returns {Promise<Object>}
238
+ */
239
+ getEnv: function() {
240
+ return new Promise((resolve, reject) => {
241
+ if (!global.appbridge) {
242
+ if (_fallbackConfig) {
243
+ resolve({
244
+ aid: _fallbackConfig.aid,
245
+ appName: _fallbackConfig.appName,
246
+ deviceId: _fallbackConfig.deviceId || _getOrCreateDeviceId(),
247
+ os: 'web',
248
+ appVersion: '',
249
+ sdkVersion: '',
250
+ statusBarHeight: 0,
251
+ navigationBarHeight: 0
252
+ });
253
+ } else {
254
+ resolve({
255
+ os: 'web',
256
+ appVersion: '',
257
+ sdkVersion: '',
258
+ statusBarHeight: 0,
259
+ navigationBarHeight: 0
260
+ });
261
+ }
262
+ return;
263
+ }
264
+ const callbackId = generateCallbackId();
265
+ registerCallback(callbackId, (result) => {
266
+ delete callbackMap[callbackId];
267
+ if (result.code === 'SUCCESS') {
268
+ resolve(result.data);
269
+ } else {
270
+ reject(new Error(result.message || result.code));
271
+ }
272
+ }, 5000);
273
+ global.appbridge.getEnvAsync(callbackId);
274
+ });
275
+ },
276
+
277
+ /**
278
+ * 获取宿主 App 名称
279
+ * @returns {Promise<string>}
280
+ */
281
+ getAppName: function() {
282
+ return new Promise((resolve, reject) => {
283
+ if (!global.appbridge) {
284
+ resolve(_fallbackConfig ? _fallbackConfig.appName : '');
285
+ return;
286
+ }
287
+ const callbackId = generateCallbackId();
288
+ registerCallback(callbackId, (result) => {
289
+ delete callbackMap[callbackId];
290
+ if (result.code === 'SUCCESS') {
291
+ resolve(result.data.appName);
292
+ } else {
293
+ reject(new Error(result.message || result.code));
294
+ }
295
+ }, 5000);
296
+ global.appbridge.getAppNameAsync(callbackId);
297
+ });
298
+ },
299
+
300
+ /**
301
+ * 获取宿主 App 图标(Base64 格式)
302
+ * @returns {Promise<string>} data:image/png;base64,... 格式
303
+ */
304
+ getAppIcon: function() {
305
+ return new Promise((resolve, reject) => {
306
+ if (!global.appbridge) {
307
+ resolve(_fallbackConfig ? _fallbackConfig.appIcon : '');
308
+ return;
309
+ }
310
+ const callbackId = generateCallbackId();
311
+ registerCallback(callbackId, (result) => {
312
+ delete callbackMap[callbackId];
313
+ if (result.code === 'SUCCESS') {
314
+ resolve(result.data.base64);
315
+ } else {
316
+ reject(new Error(result.message || result.code));
317
+ }
318
+ }, 5000);
319
+ global.appbridge.getAppIconBase64Async(callbackId);
320
+ });
321
+ },
322
+
323
+ /**
324
+ * 获取 SDK 配置(namespace=supersdk)
325
+ * @returns {Promise<Object>}
326
+ */
327
+ getSDKSettings: function() {
328
+ return new Promise((resolve, reject) => {
329
+ if (!global.appbridge) {
330
+ resolve({});
331
+ return;
332
+ }
333
+ const callbackId = generateCallbackId();
334
+ registerCallback(callbackId, (result) => {
335
+ delete callbackMap[callbackId];
336
+ if (result.code === 'SUCCESS') {
337
+ resolve(result.data);
338
+ } else {
339
+ reject(new Error(result.message || result.code));
340
+ }
341
+ }, 5000);
342
+ global.appbridge.getSDKSettingsAsync(callbackId);
343
+ });
344
+ },
345
+
346
+ /**
347
+ * 根据 key 获取 SDK 配置
348
+ * @param {string} key
349
+ * @returns {Promise<Object>}
350
+ */
351
+ getSDKSettingsByKey: function(key) {
352
+ return new Promise((resolve, reject) => {
353
+ if (!global.appbridge) {
354
+ resolve(null);
355
+ return;
356
+ }
357
+ const callbackId = generateCallbackId();
358
+ registerCallback(callbackId, (result) => {
359
+ delete callbackMap[callbackId];
360
+ if (result.code === 'SUCCESS') {
361
+ resolve(result.data);
362
+ } else {
363
+ reject(new Error(result.message || result.code));
364
+ }
365
+ }, 5000);
366
+ global.appbridge.getSDKSettingsByKeyAsync(key, callbackId);
367
+ });
368
+ },
369
+
370
+ /**
371
+ * 获取宿主配置(namespace=aid)
372
+ * @returns {Promise<Object>}
373
+ */
374
+ getHostSettings: function() {
375
+ return new Promise((resolve, reject) => {
376
+ if (!global.appbridge) {
377
+ resolve({});
378
+ return;
379
+ }
380
+ const callbackId = generateCallbackId();
381
+ registerCallback(callbackId, (result) => {
382
+ delete callbackMap[callbackId];
383
+ if (result.code === 'SUCCESS') {
384
+ resolve(result.data);
385
+ } else {
386
+ reject(new Error(result.message || result.code));
387
+ }
388
+ }, 5000);
389
+ global.appbridge.getHostSettingsAsync(callbackId);
390
+ });
391
+ },
392
+
393
+ /**
394
+ * 根据 key 获取宿主配置
395
+ * @param {string} key
396
+ * @returns {Promise<Object>}
397
+ */
398
+ getHostSettingsByKey: function(key) {
399
+ return new Promise((resolve, reject) => {
400
+ if (!global.appbridge) {
401
+ resolve(null);
402
+ return;
403
+ }
404
+ const callbackId = generateCallbackId();
405
+ registerCallback(callbackId, (result) => {
406
+ delete callbackMap[callbackId];
407
+ if (result.code === 'SUCCESS') {
408
+ resolve(result.data);
409
+ } else {
410
+ reject(new Error(result.message || result.code));
411
+ }
412
+ }, 5000);
413
+ global.appbridge.getHostSettingsByKeyAsync(key, callbackId);
414
+ });
415
+ },
416
+
417
+ /**
418
+ * 分享内容
419
+ * @param {string} content
420
+ */
421
+ share: function(content) {
422
+ if (!global.appbridge) {
423
+ console.log('[SuperSDK Share]:', content);
424
+ return;
425
+ }
426
+ global.appbridge.share(content);
427
+ },
428
+
429
+ /**
430
+ * 生成短链
431
+ * @param {string} url - 原始长链接
432
+ * @param {string} [baseUrl] - 自定义短链前缀,如 "https://s.a.com/",不传使用默认值
433
+ * @returns {Promise<string>} 短链字符串,如 "https://s.supersdk.com/AbCd12"
434
+ */
435
+ requestShortUrl: function(url, baseUrl) {
436
+ return new Promise((resolve, reject) => {
437
+ if (!global.appbridge) {
438
+ reject(new Error('Not in app environment. This API requires native app support.'));
439
+ return;
440
+ }
441
+ if (!url) {
442
+ reject(new Error('URL is required'));
443
+ return;
444
+ }
445
+ const callbackId = generateCallbackId();
446
+ registerCallback(callbackId, (result) => {
447
+ delete callbackMap[callbackId];
448
+ if (result.code === 'SUCCESS') {
449
+ resolve(result.data.shortUrl);
450
+ } else {
451
+ reject(new Error(result.message || result.code));
452
+ }
453
+ }, 10000);
454
+ var params = { url: url, callbackId: callbackId };
455
+ if (baseUrl) { params.baseUrl = baseUrl; }
456
+ global.appbridge.requestShortUrl(JSON.stringify(params));
457
+ });
458
+ },
459
+
460
+ /**
461
+ * 通过 HTML 内容生成短链
462
+ * 访问生成的短链时直接渲染 HTML 内容,不做 302 跳转
463
+ * @param {string} html - HTML 内容
464
+ * @param {string} [baseUrl] - 自定义短链前缀,如 "https://s.a.com/",不传使用默认值
465
+ * @returns {Promise<string>} 短链字符串,如 "https://s.supersdk.com/AbCd12"
466
+ */
467
+ requestShortUrlWithHtml: function(html, baseUrl) {
468
+ return new Promise((resolve, reject) => {
469
+ if (!global.appbridge) {
470
+ reject(new Error('Not in app environment. This API requires native app support.'));
471
+ return;
472
+ }
473
+ if (!html) {
474
+ reject(new Error('HTML content is required'));
475
+ return;
476
+ }
477
+ const callbackId = generateCallbackId();
478
+ registerCallback(callbackId, (result) => {
479
+ delete callbackMap[callbackId];
480
+ if (result.code === 'SUCCESS') {
481
+ resolve(result.data.shortUrl);
482
+ } else {
483
+ reject(new Error(result.message || result.code));
484
+ }
485
+ }, 10000);
486
+ var params = { html: html, callbackId: callbackId };
487
+ if (baseUrl) { params.baseUrl = baseUrl; }
488
+ global.appbridge.requestShortUrlWithHtml(JSON.stringify(params));
489
+ });
490
+ },
491
+
492
+ /**
493
+ * 在新页面打开 URL
494
+ * @param {string} url
495
+ * @param {Object} options
496
+ * @param {boolean} [options.showTitleBar=true]
497
+ */
498
+ openPage: function(url, options) {
499
+ if (!global.appbridge) {
500
+ global.open(url, '_blank');
501
+ return;
502
+ }
503
+ const config = JSON.stringify(options || { showTitleBar: true });
504
+ global.appbridge.openPage(url, config);
505
+ },
506
+
507
+ /**
508
+ * 使用系统方式打开 URL
509
+ * @param {string} url
510
+ */
511
+ openExternal: function(url) {
512
+ if (!global.appbridge) {
513
+ global.open(url, '_blank');
514
+ return;
515
+ }
516
+ global.appbridge.openExternal(url);
517
+ },
518
+
519
+ /**
520
+ * 使用浏览器打开 URL
521
+ * @param {string} url
522
+ */
523
+ openWithBrowser: function(url) {
524
+ if (!global.appbridge) {
525
+ global.open(url, '_blank');
526
+ return;
527
+ }
528
+ global.appbridge.openWithBrowser(url);
529
+ },
530
+
531
+
532
+ /**
533
+ * 关闭当前页面
534
+ * 由上层容器实现,TAB 页面调用无效果
535
+ */
536
+ closePage: function() {
537
+ if (!global.appbridge) {
538
+ try { global.close(); } catch(e) {}
539
+ if (!global.closed) { history.back(); }
540
+ return;
541
+ }
542
+ global.appbridge.closePage();
543
+ },
544
+
545
+ /**
546
+ * 广播消息到其他 WebView
547
+ * @param {string} eventKey - 事件标识
548
+ * @param {Object} data - 消息数据
549
+ * @param {string} [targetWebviewId='*'] - 目标 WebView ID,'*' 表示广播到所有
550
+ */
551
+ publish: function(eventKey, data, targetWebviewId) {
552
+ if (!global.appbridge) {
553
+ console.warn('appbridge not available');
554
+ return;
555
+ }
556
+ const target = targetWebviewId || '*';
557
+ const content = JSON.stringify(data || {});
558
+ global.appbridge.publishToWebView(target, eventKey, content);
559
+ },
560
+
561
+ /**
562
+ * 监听广播消息
563
+ * @param {string} eventKey - 事件标识
564
+ * @param {Function} callback - 回调函数
565
+ * @returns {Function} 取消监听的函数
566
+ */
567
+ subscribe: function(eventKey, callback) {
568
+ if (!broadcastListeners[eventKey]) {
569
+ broadcastListeners[eventKey] = [];
570
+ }
571
+ broadcastListeners[eventKey].push(callback);
572
+
573
+ // 返回取消监听函数
574
+ return function unsubscribe() {
575
+ const index = broadcastListeners[eventKey].indexOf(callback);
576
+ if (index > -1) {
577
+ broadcastListeners[eventKey].splice(index, 1);
578
+ }
579
+ };
580
+ },
581
+
582
+ /**
583
+ * 检查是否在 App 环境中
584
+ * @returns {boolean}
585
+ */
586
+ isInApp: function() {
587
+ return !!global.appbridge;
588
+ },
589
+
590
+ /**
591
+ * 获取安全区域信息(从 UserAgent 解析)
592
+ * @returns {{top: number, bottom: number}} 安全区域高度(像素)
593
+ */
594
+ getSafeArea: function() {
595
+ var ua = navigator.userAgent;
596
+ var top = 0;
597
+ var bottom = 0;
598
+
599
+ var topMatch = ua.match(/SafeAreaTop\/(\d+)/);
600
+ if (topMatch) {
601
+ top = parseInt(topMatch[1], 10);
602
+ }
603
+
604
+ var bottomMatch = ua.match(/SafeAreaBottom\/(\d+)/);
605
+ if (bottomMatch) {
606
+ bottom = parseInt(bottomMatch[1], 10);
607
+ }
608
+
609
+ return { top: top, bottom: bottom };
610
+ },
611
+
612
+ /**
613
+ * 监听页面进入前台事件
614
+ * @param {Function} callback - 回调函数,参数为 { triggerFrom: 'window'|'view'|'activity' }
615
+ * @returns {Function} 取消监听的函数
616
+ */
617
+ onForeground: function(callback) {
618
+ if (!systemListeners['onEnterForeground']) {
619
+ systemListeners['onEnterForeground'] = [];
620
+ }
621
+ systemListeners['onEnterForeground'].push(callback);
622
+
623
+ return function unsubscribe() {
624
+ const index = systemListeners['onEnterForeground'].indexOf(callback);
625
+ if (index > -1) {
626
+ systemListeners['onEnterForeground'].splice(index, 1);
627
+ }
628
+ };
629
+ },
630
+
631
+ /**
632
+ * 监听页面进入后台事件
633
+ * @param {Function} callback - 回调函数,参数为 { triggerFrom: 'window'|'view'|'activity' }
634
+ * @returns {Function} 取消监听的函数
635
+ */
636
+ onBackground: function(callback) {
637
+ if (!systemListeners['onEnterBackground']) {
638
+ systemListeners['onEnterBackground'] = [];
639
+ }
640
+ systemListeners['onEnterBackground'].push(callback);
641
+
642
+ return function unsubscribe() {
643
+ const index = systemListeners['onEnterBackground'].indexOf(callback);
644
+ if (index > -1) {
645
+ systemListeners['onEnterBackground'].splice(index, 1);
646
+ }
647
+ };
648
+ },
649
+
650
+ /**
651
+ * 监听返回键事件
652
+ * 同一时间只有一个监听器生效,后注册的覆盖前面的
653
+ * @param {Function} callback - 返回 true 拦截返回,返回 false 或无返回值不拦截
654
+ */
655
+ onBackPressed: function(callback) {
656
+ _backPressedCallback = (callback && typeof callback === 'function') ? callback : null;
657
+ },
658
+
659
+ /**
660
+ * 取消返回键监听,恢复默认返回行为
661
+ */
662
+ offBackPressed: function() {
663
+ _backPressedCallback = null;
664
+ },
665
+
666
+ /**
667
+ * 下载文件
668
+ * @param {Object} options - 下载配置
669
+ * @param {string} options.url - 文件下载地址
670
+ * @param {string} options.savePath - 保存路径(相对于 SDK 文件存储目录)
671
+ * @param {Object} [options.headers] - 请求头
672
+ * @param {Function} [options.onStart] - 开始下载回调
673
+ * @param {Function} [options.onProgress] - 进度回调,参数为 { progress, downloadedBytes, totalBytes }
674
+ * @param {Function} [options.onSuccess] - 成功回调,参数为 { filePath, downloadedBytes, totalBytes }
675
+ * @param {Function} [options.onFail] - 失败回调,参数为 { error }
676
+ * @returns {Function} 取消下载的函数
677
+ */
678
+ downloadFile: function(options) {
679
+ if (!global.appbridge) {
680
+ if (options.onFail) {
681
+ options.onFail({ error: 'Not in app environment. This API requires native app support.' });
682
+ }
683
+ return function() {};
684
+ }
685
+
686
+ const callbackId = generateCallbackId();
687
+ const headersStr = options.headers ? JSON.stringify(options.headers) : '';
688
+
689
+ // 注册回调处理
690
+ registerCallback(callbackId, (result) => {
691
+ if (result.code === 'SUCCESS' && result.data) {
692
+ const data = result.data;
693
+ switch (data.status) {
694
+ case 'START':
695
+ if (options.onStart) options.onStart();
696
+ break;
697
+ case 'PROGRESS':
698
+ if (options.onProgress) {
699
+ options.onProgress({
700
+ progress: data.progress,
701
+ downloadedBytes: data.downloadedBytes,
702
+ totalBytes: data.totalBytes
703
+ });
704
+ }
705
+ break;
706
+ case 'SUCCESS':
707
+ if (options.onSuccess) {
708
+ options.onSuccess({
709
+ filePath: data.filePath,
710
+ downloadedBytes: data.downloadedBytes,
711
+ totalBytes: data.totalBytes
712
+ });
713
+ }
714
+ delete callbackMap[callbackId];
715
+ break;
716
+ case 'FAIL':
717
+ if (options.onFail) {
718
+ options.onFail({ error: data.error });
719
+ }
720
+ delete callbackMap[callbackId];
721
+ break;
722
+ }
723
+ }
724
+ }, 0); // 不设置超时,下载可能持续较长时间
725
+
726
+ global.appbridge.downloadFile(callbackId, options.url, headersStr, options.savePath);
727
+
728
+ // 返回取消函数
729
+ return function cancel() {
730
+ global.appbridge.cancelDownload(callbackId);
731
+ };
732
+ },
733
+
734
+ /**
735
+ * 下载文件并按缓存策略复用本地文件
736
+ * @param {string} fileUrl - 文件下载地址
737
+ * @param {string} [fileMd5] - 文件 MD5,传空时跳过校验
738
+ * @param {number} [cacheTts] - 缓存有效期(秒),<= 0 时强制重新下载
739
+ * @param {string} [fileCacheKey] - 自定义缓存 key,传空时使用去掉 query 的 fileUrl
740
+ * @returns {Promise<{filePath: string, cacheHit: boolean, cacheKey: string}>}
741
+ */
742
+ downloadWithCache: function(fileUrl, fileMd5, cacheTts, fileCacheKey) {
743
+ return new Promise((resolve, reject) => {
744
+ if (!global.appbridge) {
745
+ reject(new Error('Not in app environment. This API requires native app support.'));
746
+ return;
747
+ }
748
+
749
+ const callbackId = generateCallbackId();
750
+ registerCallback(callbackId, (result) => {
751
+ delete callbackMap[callbackId];
752
+ if (result.code === 'SUCCESS') {
753
+ resolve(result.data);
754
+ } else {
755
+ reject(new Error(result.message || result.code));
756
+ }
757
+ }, 0);
758
+
759
+ global.appbridge.downloadWithCache(
760
+ callbackId,
761
+ fileUrl,
762
+ fileMd5 || '',
763
+ cacheTts || 0,
764
+ fileCacheKey || ''
765
+ );
766
+ });
767
+ },
768
+
769
+ // ==================== 文件操作 ====================
770
+
771
+ /**
772
+ * 检查文件是否存在
773
+ * @param {string} path - 相对路径
774
+ * @returns {Promise<{exists: boolean, isFile: boolean, isDirectory: boolean}>}
775
+ */
776
+ fileExists: function(path) {
777
+ return new Promise((resolve, reject) => {
778
+ if (!global.appbridge) {
779
+ reject(new Error('Not in app environment. This API requires native app support.'));
780
+ return;
781
+ }
782
+ const callbackId = generateCallbackId();
783
+ registerCallback(callbackId, (result) => {
784
+ delete callbackMap[callbackId];
785
+ if (result.code === 'SUCCESS') {
786
+ resolve(result.data);
787
+ } else {
788
+ reject(new Error(result.message || result.code));
789
+ }
790
+ }, 5000);
791
+ global.appbridge.fileExists(path, callbackId);
792
+ });
793
+ },
794
+
795
+ /**
796
+ * 获取文件 MD5
797
+ * @param {string} path - 相对路径
798
+ * @returns {Promise<{md5: string}>}
799
+ */
800
+ getFileMd5: function(path) {
801
+ return new Promise((resolve, reject) => {
802
+ if (!global.appbridge) {
803
+ reject(new Error('Not in app environment. This API requires native app support.'));
804
+ return;
805
+ }
806
+ const callbackId = generateCallbackId();
807
+ registerCallback(callbackId, (result) => {
808
+ delete callbackMap[callbackId];
809
+ if (result.code === 'SUCCESS') {
810
+ resolve(result.data);
811
+ } else {
812
+ reject(new Error(result.message || result.code));
813
+ }
814
+ }, 30000); // 大文件可能需要更长时间
815
+ global.appbridge.getFileMd5(path, callbackId);
816
+ });
817
+ },
818
+
819
+ /**
820
+ * 删除文件或目录
821
+ * @param {string} path - 相对路径
822
+ * @returns {Promise<void>}
823
+ */
824
+ deleteFile: function(path) {
825
+ return new Promise((resolve, reject) => {
826
+ if (!global.appbridge) {
827
+ reject(new Error('Not in app environment. This API requires native app support.'));
828
+ return;
829
+ }
830
+ const callbackId = generateCallbackId();
831
+ registerCallback(callbackId, (result) => {
832
+ delete callbackMap[callbackId];
833
+ if (result.code === 'SUCCESS') {
834
+ resolve();
835
+ } else {
836
+ reject(new Error(result.message || result.code));
837
+ }
838
+ }, 10000);
839
+ global.appbridge.deleteFile(path, callbackId);
840
+ });
841
+ },
842
+
843
+ /**
844
+ * 移动文件
845
+ * @param {string} srcPath - 源路径
846
+ * @param {string} destPath - 目标路径
847
+ * @returns {Promise<void>}
848
+ */
849
+ moveFile: function(srcPath, destPath) {
850
+ return new Promise((resolve, reject) => {
851
+ if (!global.appbridge) {
852
+ reject(new Error('Not in app environment. This API requires native app support.'));
853
+ return;
854
+ }
855
+ const callbackId = generateCallbackId();
856
+ registerCallback(callbackId, (result) => {
857
+ delete callbackMap[callbackId];
858
+ if (result.code === 'SUCCESS') {
859
+ resolve();
860
+ } else {
861
+ reject(new Error(result.message || result.code));
862
+ }
863
+ }, 10000);
864
+ global.appbridge.moveFile(srcPath, destPath, callbackId);
865
+ });
866
+ },
867
+
868
+ /**
869
+ * 创建目录
870
+ * @param {string} path - 相对路径
871
+ * @returns {Promise<void>}
872
+ */
873
+ createDir: function(path) {
874
+ return new Promise((resolve, reject) => {
875
+ if (!global.appbridge) {
876
+ reject(new Error('Not in app environment. This API requires native app support.'));
877
+ return;
878
+ }
879
+ const callbackId = generateCallbackId();
880
+ registerCallback(callbackId, (result) => {
881
+ delete callbackMap[callbackId];
882
+ if (result.code === 'SUCCESS') {
883
+ resolve();
884
+ } else {
885
+ reject(new Error(result.message || result.code));
886
+ }
887
+ }, 5000);
888
+ global.appbridge.createDir(path, callbackId);
889
+ });
890
+ },
891
+
892
+ /**
893
+ * 列出目录内容
894
+ * @param {string} path - 相对路径
895
+ * @returns {Promise<{files: Array<{name: string, isFile: boolean, isDirectory: boolean, size: number, lastModified: number}>}>}
896
+ */
897
+ listDir: function(path) {
898
+ return new Promise((resolve, reject) => {
899
+ if (!global.appbridge) {
900
+ reject(new Error('Not in app environment. This API requires native app support.'));
901
+ return;
902
+ }
903
+ const callbackId = generateCallbackId();
904
+ registerCallback(callbackId, (result) => {
905
+ delete callbackMap[callbackId];
906
+ if (result.code === 'SUCCESS') {
907
+ resolve(result.data);
908
+ } else {
909
+ reject(new Error(result.message || result.code));
910
+ }
911
+ }, 10000);
912
+ global.appbridge.listDir(path, callbackId);
913
+ });
914
+ },
915
+
916
+ /**
917
+ * 读取文件内容(文本)
918
+ * @param {string} path - 相对路径
919
+ * @returns {Promise<{content: string}>}
920
+ */
921
+ readFile: function(path) {
922
+ return new Promise((resolve, reject) => {
923
+ if (!global.appbridge) {
924
+ reject(new Error('Not in app environment. This API requires native app support.'));
925
+ return;
926
+ }
927
+ const callbackId = generateCallbackId();
928
+ registerCallback(callbackId, (result) => {
929
+ delete callbackMap[callbackId];
930
+ if (result.code === 'SUCCESS') {
931
+ resolve(result.data);
932
+ } else {
933
+ reject(new Error(result.message || result.code));
934
+ }
935
+ }, 30000);
936
+ global.appbridge.readFile(path, callbackId);
937
+ });
938
+ },
939
+
940
+ /**
941
+ * 写入文件内容(文本)
942
+ * @param {string} path - 相对路径
943
+ * @param {string} content - 文件内容
944
+ * @returns {Promise<void>}
945
+ */
946
+ writeFile: function(path, content) {
947
+ return new Promise((resolve, reject) => {
948
+ if (!global.appbridge) {
949
+ reject(new Error('Not in app environment. This API requires native app support.'));
950
+ return;
951
+ }
952
+ const callbackId = generateCallbackId();
953
+ registerCallback(callbackId, (result) => {
954
+ delete callbackMap[callbackId];
955
+ if (result.code === 'SUCCESS') {
956
+ resolve();
957
+ } else {
958
+ reject(new Error(result.message || result.code));
959
+ }
960
+ }, 30000);
961
+ global.appbridge.writeFile(path, content, callbackId);
962
+ });
963
+ },
964
+
965
+ // ==================== ZIP 压缩与解压 ====================
966
+
967
+ /**
968
+ * 解压 ZIP 文件
969
+ * @param {string} zipPath - ZIP 文件路径
970
+ * @param {string} destPath - 解压目标目录
971
+ * @returns {Promise<void>}
972
+ */
973
+ unzipFile: function(zipPath, destPath) {
974
+ return new Promise((resolve, reject) => {
975
+ if (!global.appbridge) {
976
+ reject(new Error('Not in app environment. This API requires native app support.'));
977
+ return;
978
+ }
979
+ const callbackId = generateCallbackId();
980
+ registerCallback(callbackId, (result) => {
981
+ delete callbackMap[callbackId];
982
+ if (result.code === 'SUCCESS') {
983
+ resolve();
984
+ } else {
985
+ reject(new Error(result.message || result.code));
986
+ }
987
+ }, 60000); // 解压可能需要较长时间
988
+ global.appbridge.unzipFile(zipPath, destPath, callbackId);
989
+ });
990
+ },
991
+
992
+ /**
993
+ * 压缩目录为 ZIP 文件
994
+ * @param {string} sourcePath - 源目录路径
995
+ * @param {string} zipPath - 生成的 ZIP 文件路径
996
+ * @returns {Promise<void>}
997
+ */
998
+ zipDir: function(sourcePath, zipPath) {
999
+ return new Promise((resolve, reject) => {
1000
+ if (!global.appbridge) {
1001
+ reject(new Error('Not in app environment. This API requires native app support.'));
1002
+ return;
1003
+ }
1004
+ const callbackId = generateCallbackId();
1005
+ registerCallback(callbackId, (result) => {
1006
+ delete callbackMap[callbackId];
1007
+ if (result.code === 'SUCCESS') {
1008
+ resolve();
1009
+ } else {
1010
+ reject(new Error(result.message || result.code));
1011
+ }
1012
+ }, 60000); // 压缩可能需要较长时间
1013
+ global.appbridge.zipDir(sourcePath, zipPath, callbackId);
1014
+ });
1015
+ },
1016
+
1017
+ /**
1018
+ * 打开浏览器页面
1019
+ * @param {string} url - URL
1020
+ * @param {string} title - 标题
1021
+ */
1022
+ openBrowser: function(url, title) {
1023
+ if (!global.appbridge) {
1024
+ global.open(url, '_blank');
1025
+ return;
1026
+ }
1027
+ global.appbridge.openBrowser(url, title || '');
1028
+ },
1029
+
1030
+ /**
1031
+ * 显示 Toast 提示
1032
+ * @param {string} message - 消息内容
1033
+ */
1034
+ showToast: function(message) {
1035
+ if (!global.appbridge) {
1036
+ console.log('[SuperSDK Toast]:', message);
1037
+ return;
1038
+ }
1039
+ global.appbridge.showToast(message);
1040
+ },
1041
+
1042
+ /**
1043
+ * 设置状态栏深色/浅色模式(同步 · 无返回)
1044
+ * 非端环境(无 appbridge)下为 no-op,不抛错。
1045
+ * @param {boolean} isDark - true = 深色背景(状态栏图标显示为白色);false = 浅色背景(图标黑色)
1046
+ */
1047
+ setStatusBarDarkMode: function(isDark) {
1048
+ if (!global.appbridge || !global.appbridge.setStatusBarDarkMode) {
1049
+ return;
1050
+ }
1051
+ global.appbridge.setStatusBarDarkMode(!!isDark);
1052
+ },
1053
+
1054
+ /**
1055
+ * 唤起软键盘(同步 · 无返回)
1056
+ * Android 为空实现(WebView 中 JS focus() 即可触发键盘);iOS 转发到 Native 处理。
1057
+ * 非端环境(无 appbridge)下为 no-op,不抛错。
1058
+ * @param {string} [selector] - 目标输入框的 CSS 选择器(可选,iOS 使用)
1059
+ */
1060
+ showKeyboard: function(selector) {
1061
+ if (!global.appbridge || !global.appbridge.showKeyboard) {
1062
+ return;
1063
+ }
1064
+ global.appbridge.showKeyboard(selector || '');
1065
+ },
1066
+
1067
+ /**
1068
+ * 上报事件
1069
+ * @param {string} eventName - 事件名称
1070
+ * @param {Object} [params] - 事件参数
1071
+ * @returns {Promise<void>}
1072
+ */
1073
+ reportEvent: function(eventName, params) {
1074
+ return new Promise((resolve, reject) => {
1075
+ if (!global.appbridge) {
1076
+ _reportEventViaFetch(eventName, params).then(resolve).catch(reject);
1077
+ return;
1078
+ }
1079
+ const callbackId = generateCallbackId();
1080
+ const paramsStr = params ? JSON.stringify(params) : '';
1081
+ registerCallback(callbackId, (result) => {
1082
+ delete callbackMap[callbackId];
1083
+ if (result.code === 'SUCCESS') {
1084
+ resolve(result.data);
1085
+ } else {
1086
+ reject(new Error(result.message || result.code));
1087
+ }
1088
+ }, 5000);
1089
+ global.appbridge.reportEvent(callbackId, eventName, paramsStr);
1090
+ });
1091
+ },
1092
+
1093
+ /**
1094
+ * 设置埋点公共参数(同步 · 无返回)
1095
+ * 设置后,本 WebView 后续所有 reportEvent 上报都会自动带上该公共参数。
1096
+ * 非端环境(无 appbridge)下为 no-op,不抛错。
1097
+ * @param {string} key - 公共参数键
1098
+ * @param {string} value - 公共参数值(非字符串会被转为字符串,null/undefined 转为空串)
1099
+ */
1100
+ addEventCommonParam: function(key, value) {
1101
+ if (!global.appbridge || !global.appbridge.addEventCommonParam) {
1102
+ return;
1103
+ }
1104
+ global.appbridge.addEventCommonParam(key, value == null ? '' : String(value));
1105
+ },
1106
+
1107
+ // ==================== Host Method ====================
1108
+
1109
+ /**
1110
+ * 调用宿主方法(通用接口)
1111
+ * @param {string} methodName - 方法名
1112
+ * @param {Object} params - 参数
1113
+ * @returns {Promise<Object>}
1114
+ */
1115
+ callHostMethod: function(methodName, params) {
1116
+ return new Promise((resolve, reject) => {
1117
+ if (!global.appbridge) {
1118
+ reject(new Error('Not in app environment. This API requires native app support.'));
1119
+ return;
1120
+ }
1121
+ const callbackId = generateCallbackId();
1122
+ const paramsStr = params ? JSON.stringify(params) : '';
1123
+ registerCallback(callbackId, (result) => {
1124
+ delete callbackMap[callbackId];
1125
+ if (result.code === 'SUCCESS') {
1126
+ resolve(result.data);
1127
+ } else {
1128
+ reject(new Error(result.message || result.code));
1129
+ }
1130
+ });
1131
+ global.appbridge.callHostMethod(methodName, paramsStr, callbackId);
1132
+ });
1133
+ },
1134
+
1135
+ // ==================== 登录 ====================
1136
+
1137
+ /**
1138
+ * 获取支持的三方登录方式
1139
+ * @returns {Promise<string[]>} Provider 名称列表,如 ['google', 'apple']
1140
+ */
1141
+ getAuthProviders: function() {
1142
+ return new Promise((resolve, reject) => {
1143
+ if (!global.appbridge) {
1144
+ reject(new Error('Not in app environment. This API requires native app support.'));
1145
+ return;
1146
+ }
1147
+ const callbackId = generateCallbackId();
1148
+ registerCallback(callbackId, (result) => {
1149
+ delete callbackMap[callbackId];
1150
+ if (result.code === 'SUCCESS') {
1151
+ resolve(result.data.providers || []);
1152
+ } else {
1153
+ reject(new Error(result.message || result.code));
1154
+ }
1155
+ }, 5000);
1156
+ global.appbridge.getAuthProviders(callbackId);
1157
+ });
1158
+ },
1159
+
1160
+ /**
1161
+ * 触发三方登录
1162
+ * @param {Object} options
1163
+ * @param {string} options.provider - 登录方式(如 'google', 'apple')
1164
+ * @returns {Promise<Object>} 三方凭证 {provider, token, authorizationCode, email, displayName, ...}
1165
+ * @throws {Error} 用户取消时 message 为 'CANCELLED'
1166
+ */
1167
+ requestLogin: function(options) {
1168
+ return new Promise((resolve, reject) => {
1169
+ if (!global.appbridge) {
1170
+ reject(new Error('Not in app environment. This API requires native app support.'));
1171
+ return;
1172
+ }
1173
+ if (!options || !options.provider) {
1174
+ reject(new Error('options.provider is required'));
1175
+ return;
1176
+ }
1177
+ const callbackId = generateCallbackId();
1178
+ registerCallback(callbackId, (result) => {
1179
+ delete callbackMap[callbackId];
1180
+ if (result.code === 'SUCCESS') {
1181
+ resolve(result.data);
1182
+ } else {
1183
+ var err = new Error(result.code || 'ERROR');
1184
+ err.detail = result.message;
1185
+ reject(err);
1186
+ }
1187
+ }, 60000);
1188
+ global.appbridge.requestLogin(options.provider, callbackId);
1189
+ });
1190
+ },
1191
+
1192
+ // ==================== 支付 (pay namespace · SDK-F036 重构) ====================
1193
+ //
1194
+ // F036 破坏式重构 · 顶层老 7 API 全部删除:
1195
+ // purchase / queryProducts / acknowledgePurchase / consumePurchase /
1196
+ // restorePurchases / getPayProviders / registerPayProvider
1197
+ // 新挂载 SuperSDK.pay namespace · 含 4 个 API:
1198
+ // pay.purchase(payConfig) — 唯一支付入口(新 payConfig 形态)
1199
+ // pay.getProviders() — 探测宿主能力
1200
+ // pay.registerProvider(name, provider) — 注册 Web 收银台(checkout 入参变为 payParams)
1201
+ // pay.restorePurchases(options) — 客户端 restore · provider 可选实现
1202
+ //
1203
+ // payParams reserved keys:productId / accountId(SDK 读它们路由 Native IAP)
1204
+ // 其他 payParams 字段:Web 路径 checkout(payParams) 全透传 · Native 不传(无 JSON payload 通道)
1205
+ //
1206
+ // 下沉业务后端:queryProducts / acknowledgePurchase / consumePurchase
1207
+ // 业务方走 Google Play Server API / App Store Server API 自行处理
1208
+ pay: {
1209
+ /**
1210
+ * 注册 JS 层支付 Provider(Web 收银台等非 Native IAP)
1211
+ *
1212
+ * @param {string} name - Provider 名称(如 'alipay', 'wechat', 'stripe')
1213
+ * @param {Object} provider
1214
+ * @param {Function} provider.checkout - 创建订单 · 接收 payParams 完整对象 · 返回 { payUrl, orderToken }
1215
+ * @param {Function} provider.queryStatus - 查询订单状态 · 接收 orderToken · 返回含 status 字段对象
1216
+ * @param {number} [provider.pollInterval=5000] - 轮询间隔 ms
1217
+ * @param {number} [provider.maxPolls=6] - 最大轮询次数
1218
+ *
1219
+ * @example
1220
+ * SuperSDK.pay.registerProvider('alipay', {
1221
+ * checkout: async (payParams) => {
1222
+ * // payParams.productId / payParams.tradeType / payParams.extras 等业务字段都在
1223
+ * const res = await myApi.checkout(payParams.productId, { trade_type: payParams.tradeType });
1224
+ * return { payUrl: res.pay_url, orderToken: res.order_token };
1225
+ * },
1226
+ * queryStatus: async (orderToken) => {
1227
+ * const res = await myApi.getOrder(orderToken);
1228
+ * return res;
1229
+ * }
1230
+ * });
1231
+ */
1232
+ registerProvider: function(name, provider) {
1233
+ if (!name || typeof name !== 'string') {
1234
+ throw new Error('Provider name is required');
1235
+ }
1236
+ // F038 v0.3 哑管道:provider = 两个方法 { createOrder?, pay? }。
1237
+ // - 三方(Web 收银台):业务实现 pay(自行 checkout+轮询·返三态)· 可附 createOrder
1238
+ // - 内置 IAP override(如 'google_play'):仅 createOrder(无 pay · pay 走 SDK 内置原生)
1239
+ if (!provider || typeof provider !== 'object') {
1240
+ throw new Error('Provider must be an object');
1241
+ }
1242
+ if (typeof provider.pay !== 'function' && typeof provider.createOrder !== 'function') {
1243
+ throw new Error('Provider must have a pay or createOrder function');
1244
+ }
1245
+ _payProviders[name] = provider;
1246
+ },
1247
+
1248
+ /**
1249
+ * 探测宿主支持的支付方式列表(合并 JS 注册的 + Native 注册的)
1250
+ * @returns {Promise<string[]>}
1251
+ */
1252
+ getProviders: function() {
1253
+ var jsProviders = Object.keys(_payProviders).filter(function(n) { return n !== '_inline'; });
1254
+
1255
+ if (!global.appbridge) {
1256
+ return Promise.resolve(jsProviders);
1257
+ }
1258
+
1259
+ return new Promise(function(resolve, reject) {
1260
+ var callbackId = generateCallbackId();
1261
+ registerCallback(callbackId, function(result) {
1262
+ delete callbackMap[callbackId];
1263
+ var nativeProviders = (result.code === 'SUCCESS' && result.data && result.data.providers) || [];
1264
+ var all = jsProviders.concat(nativeProviders.filter(function(p) {
1265
+ return jsProviders.indexOf(p) === -1;
1266
+ }));
1267
+ resolve(all);
1268
+ }, 5000);
1269
+ global.appbridge.getPayProviders(callbackId);
1270
+ });
1271
+ },
1272
+
1273
+ /**
1274
+ * 发起购买(F038 v0.3 哑管道 · 单入口聚合 createOrder→pay)
1275
+ *
1276
+ * 🔴 SDK 是哑管道:仅按 provider 名路由 + 把 createOrder 产出的**不透明 JSON** 透传给 pay ·
1277
+ * **不解析 json 任何字段**(productId/accountId/profileId 等由 provider 实现方自洽)。
1278
+ *
1279
+ * - provider = 两个方法 { createOrder(payParams)→json, pay(json)→PayResult3State }
1280
+ * - 内部:json = createOrder(payParams) → pay(json);公共面仅此入口(不新增 createAndPay)
1281
+ * - 返回 **PayResult3State** { status:'finished'|'cancelled'|'error', orderToken?, phase?, code?, message? }
1282
+ * finished = 流程结束·去查单(≠成功)· 不含凭证
1283
+ * - reject 仅"无法开始":INVALID_PARAMS / NOT_IN_APP / SDK_TOO_OLD / PURCHASE_IN_PROGRESS
1284
+ * - 已开始流程的终态(create/pay 失败、取消、结束)一律 resolve 三态
1285
+ *
1286
+ * @param {Object} payConfig
1287
+ * @param {string} [payConfig.provider] - 单 Provider 可省 · 多 Provider 必填
1288
+ * @param {Object} payConfig.payParams - createOrder 入参 · 必填(对象)
1289
+ * @param {Function} [payConfig.createOrder] - inline 模式 · (payParams)=>Promise<json>
1290
+ * @param {Function} [payConfig.pay] - inline 模式 · (json)=>Promise<PayResult3State>(有此则走 inline JS provider)
1291
+ * @returns {Promise<Object>} PayResult3State
1292
+ *
1293
+ * 路由:① payConfig.pay 函数 → inline JS provider;② provider 注册且含 pay → 三方 JS;
1294
+ * ③ 其余(未注册 / 仅 createOrder override) → 内置 Native IAP pay;④ 不传 provider → 自动选
1295
+ */
1296
+ purchase: function(payConfig) {
1297
+ // ① 输入校验:SDK 仅校验 payConfig/payParams 是对象(不碰 productId 等业务字段 · 哑管道)
1298
+ if (!payConfig || typeof payConfig !== 'object' || Array.isArray(payConfig)) {
1299
+ return _invalidParams('payConfig must be object');
1300
+ }
1301
+ if (!payConfig.payParams || typeof payConfig.payParams !== 'object' || Array.isArray(payConfig.payParams)) {
1302
+ return _invalidParams('payParams must be object');
1303
+ }
1304
+
1305
+ var self = SDK;
1306
+ var providerName = payConfig.provider || '';
1307
+ var payParams = payConfig.payParams;
1308
+
1309
+ // inline 模式(外层 pay 函数)
1310
+ if (typeof payConfig.pay === 'function') {
1311
+ if (_webInlineInProgress) {
1312
+ return Promise.reject(_makeError('PURCHASE_IN_PROGRESS', 'Another inline purchase in progress'));
1313
+ }
1314
+ _webInlineInProgress = true;
1315
+ _payProviders['_inline'] = { createOrder: payConfig.createOrder, pay: payConfig.pay };
1316
+ return self._runProvider('_inline', _payProviders['_inline'], payParams).finally(function() {
1317
+ _webInlineInProgress = false;
1318
+ delete _payProviders['_inline'];
1319
+ });
1320
+ }
1321
+
1322
+ // 明确 provider
1323
+ if (providerName) {
1324
+ return self._runProvider(providerName, _payProviders[providerName] || null, payParams);
1325
+ }
1326
+
1327
+ // 未指定 provider → 自动选择
1328
+ return SDK.pay.getProviders().then(function(allProviders) {
1329
+ if (allProviders.length === 0) {
1330
+ throw _makeError('NO_PROVIDER', 'No payment provider available');
1331
+ }
1332
+ if (allProviders.length > 1) {
1333
+ throw _makeError('PROVIDER_REQUIRED', 'Multiple providers available: ' + allProviders.join(', '));
1334
+ }
1335
+ var auto = allProviders[0];
1336
+ return self._runProvider(auto, _payProviders[auto] || null, payParams);
1337
+ });
1338
+ },
1339
+
1340
+ /**
1341
+ * 恢复购买(客户端 · 仅 Native IAP · provider 可选实现)
1342
+ *
1343
+ * provider 未实现 restorePurchases 时 reject Error('NOT_SUPPORTED')·
1344
+ * 业务方按需 fallback 到业务后端 /api/pay/my-purchases。
1345
+ *
1346
+ * @param {Object} [options]
1347
+ * @param {string} [options.provider] - 单 Provider 时可省 · 多 Provider 必填
1348
+ * @returns {Promise<Object[]>}
1349
+ */
1350
+ restorePurchases: function(options) {
1351
+ return new Promise(function(resolve, reject) {
1352
+ if (!global.appbridge) {
1353
+ reject(_makeError('NOT_IN_APP', 'Not in app environment. This API requires native app support.'));
1354
+ return;
1355
+ }
1356
+ var provider = (options && options.provider) || '';
1357
+ var callbackId = generateCallbackId();
1358
+ registerCallback(callbackId, function(result) {
1359
+ delete callbackMap[callbackId];
1360
+ if (result.code === 'SUCCESS') {
1361
+ resolve((result.data && result.data.purchases) || []);
1362
+ } else {
1363
+ reject(_makeError(result.code || 'ERROR', result.message));
1364
+ }
1365
+ }, 30000);
1366
+ global.appbridge.restorePurchases(provider, callbackId);
1367
+ });
1368
+ }
1369
+ },
1370
+
1371
+ /**
1372
+ * 归一化 pay 返回值为 PayResult3State(防御:业务 pay 返回缺 status)
1373
+ * @private
1374
+ */
1375
+ _normalize3State: function(r) {
1376
+ if (r && typeof r === 'object' && typeof r.status === 'string') return r;
1377
+ return { status: 'finished' }; // 业务 pay 未返标准三态 · 兜底当 finished(去查单)
1378
+ },
1379
+
1380
+ /**
1381
+ * 统一执行 provider:createOrder(payParams)→json → pay(json)→三态(哑管道核心)
1382
+ * - createOrder 缺省 = identity(payParams 原样作 json · 内置 IAP 纯参数场景)
1383
+ * - reg.pay 为函数 → 三方 JS pay;否则 → 内置 Native IAP pay(_nativePay)
1384
+ * - createOrder reject/throw(发生在 JSSDK 内)→ resolve {status:error,phase:create}(不 reject 给调用方)
1385
+ * - SDK **不读 json 任何字段** · 原样透传
1386
+ * @private
1387
+ */
1388
+ _runProvider: function(name, reg, payParams) {
1389
+ var self = SDK;
1390
+ var createOrder = (reg && typeof reg.createOrder === 'function')
1391
+ ? reg.createOrder
1392
+ : function(p) { return p; }; // identity
1393
+
1394
+ return new Promise(function(resolve, reject) {
1395
+ Promise.resolve()
1396
+ .then(function() { return createOrder(payParams); })
1397
+ .then(
1398
+ function(json) {
1399
+ // createOrder 成功 → pay 步骤
1400
+ var payStep;
1401
+ if (reg && typeof reg.pay === 'function') {
1402
+ // 三方 JS provider:业务 pay 自行 checkout+轮询 · 返三态;
1403
+ // 业务 pay throw/reject → 归一化为 pay error 三态(已开始的终态用 resolve)
1404
+ payStep = Promise.resolve()
1405
+ .then(function() { return reg.pay(json); })
1406
+ .then(self._normalize3State)
1407
+ .catch(function(e) {
1408
+ return { status: 'error', phase: 'pay', code: (e && e.code) || 'PAY_FAILED', message: (e && e.message) || 'pay failed' };
1409
+ });
1410
+ } else {
1411
+ // 内置 Native IAP pay:终态 resolve 三态;NOT_IN_APP/SDK_TOO_OLD(无法开始)reject 穿透
1412
+ payStep = self._nativePay(name, json);
1413
+ }
1414
+ payStep.then(resolve, reject); // 🔴 pay 的 reject(仅"无法开始")穿透 · 不降级 create
1415
+ },
1416
+ function(createErr) {
1417
+ // createOrder 失败 → create error 三态(CR-3:在 JSSDK 内捕获 · 不 reject 给调用方)
1418
+ resolve({ status: 'error', phase: 'create', code: (createErr && createErr.code) || 'CREATE_FAILED', message: (createErr && createErr.message) || 'createOrder failed' });
1419
+ }
1420
+ );
1421
+ });
1422
+ },
1423
+
1424
+ /**
1425
+ * 内置 Native IAP pay(私有 · 通用管道)
1426
+ * appbridge.nativePay(provider, JSON.stringify(json), callbackId) → 三态
1427
+ * SDK **不解析 json** · 原样 JSON.stringify 透传;字段由原生 provider.pay 自读
1428
+ * reject 仅 NOT_IN_APP / SDK_TOO_OLD(无法开始);终态 resolve 三态
1429
+ * @private
1430
+ */
1431
+ _nativePay: function(provider, json) {
1432
+ if (!global.appbridge) {
1433
+ return Promise.reject(_makeError('NOT_IN_APP', 'Not in app environment. This API requires native app support.'));
1434
+ }
1435
+ // 破坏式(Q2=A):老 SDK 无 nativePay → 明确 SDK_TOO_OLD · 不静默 fallback
1436
+ if (typeof global.appbridge.nativePay !== 'function') {
1437
+ return Promise.reject(_makeError('SDK_TOO_OLD',
1438
+ 'SuperSDK native too old for unified pay (F038) · requires appbridge.nativePay · please upgrade SDK'));
1439
+ }
1440
+ return new Promise(function(resolve) {
1441
+ var callbackId = generateCallbackId();
1442
+ var jsonString;
1443
+ try {
1444
+ jsonString = JSON.stringify(json || {});
1445
+ } catch (e) {
1446
+ resolve({ status: 'error', phase: 'create', code: 'INVALID_JSON', message: 'createOrder produced non-serializable json' });
1447
+ return;
1448
+ }
1449
+ registerCallback(callbackId, function(result) {
1450
+ delete callbackMap[callbackId];
1451
+ // Native(PayBridge 守门)经 SUCCESS data 通道投递白名单三态;凭证不出 Native
1452
+ if (result.code === 'SUCCESS' && result.data && result.data.status) {
1453
+ resolve(result.data);
1454
+ } else {
1455
+ resolve({ status: 'error', phase: 'pay', code: result.code || 'ERROR', message: result.message });
1456
+ }
1457
+ }, 190000);
1458
+ global.appbridge.nativePay(provider, jsonString, callbackId);
1459
+ });
1460
+ },
1461
+
1462
+ // ==================== 广告 ====================
1463
+
1464
+ /**
1465
+ * 展示激励视频广告
1466
+ * @param {Object} options
1467
+ * @param {string} options.adUnitId - 广告单元 ID
1468
+ * @param {string} [options.adSource='ADMOB'] - 广告来源 ('ADMOB' | 'APPLOVIN')
1469
+ * @returns {Promise<{dismissed: boolean, rewarded: boolean}>}
1470
+ */
1471
+ showRewardAd: function(options) {
1472
+ return new Promise((resolve, reject) => {
1473
+ if (!global.appbridge) {
1474
+ reject(new Error('Not in app environment. This API requires native app support.'));
1475
+ return;
1476
+ }
1477
+ if (!options || !options.adUnitId) {
1478
+ reject(new Error('options.adUnitId is required'));
1479
+ return;
1480
+ }
1481
+ const callbackId = generateCallbackId();
1482
+ registerCallback(callbackId, (result) => {
1483
+ delete callbackMap[callbackId];
1484
+ if (result.code === 'SUCCESS') {
1485
+ resolve(result.data);
1486
+ } else {
1487
+ var err = new Error(result.code || 'ERROR');
1488
+ err.detail = result.message;
1489
+ reject(err);
1490
+ }
1491
+ }, 120000);
1492
+ global.appbridge.showRewardAd(JSON.stringify(options), callbackId);
1493
+ });
1494
+ },
1495
+
1496
+ /**
1497
+ * 展示插屏广告
1498
+ * @param {Object} options
1499
+ * @param {string} options.adUnitId - 广告单元 ID
1500
+ * @param {string} [options.adSource='ADMOB'] - 广告来源 ('ADMOB' | 'APPLOVIN')
1501
+ * @returns {Promise<{dismissed: boolean, rewarded: boolean}>}
1502
+ */
1503
+ showInterstitialAd: function(options) {
1504
+ return new Promise((resolve, reject) => {
1505
+ if (!global.appbridge) {
1506
+ reject(new Error('Not in app environment. This API requires native app support.'));
1507
+ return;
1508
+ }
1509
+ if (!options || !options.adUnitId) {
1510
+ reject(new Error('options.adUnitId is required'));
1511
+ return;
1512
+ }
1513
+ const callbackId = generateCallbackId();
1514
+ registerCallback(callbackId, (result) => {
1515
+ delete callbackMap[callbackId];
1516
+ if (result.code === 'SUCCESS') {
1517
+ resolve(result.data);
1518
+ } else {
1519
+ var err = new Error(result.code || 'ERROR');
1520
+ err.detail = result.message;
1521
+ reject(err);
1522
+ }
1523
+ }, 60000);
1524
+ global.appbridge.showInterstitialAd(JSON.stringify(options), callbackId);
1525
+ });
1526
+ },
1527
+
1528
+ /**
1529
+ * 展示 Banner 广告
1530
+ * @param {Object} options
1531
+ * @param {string} options.adUnitId - 广告单元 ID
1532
+ * @param {string} [options.adSource='ADMOB'] - 广告来源 ('ADMOB' | 'APPLOVIN')
1533
+ * @param {string} [options.position='bottom'] - 位置 ('top' | 'bottom')
1534
+ * @returns {Promise<{adId: string}>} 返回 adId 用于后续 hideBannerAd
1535
+ */
1536
+ showBannerAd: function(options) {
1537
+ return new Promise((resolve, reject) => {
1538
+ if (!global.appbridge) {
1539
+ reject(new Error('Not in app environment. This API requires native app support.'));
1540
+ return;
1541
+ }
1542
+ if (!options || !options.adUnitId) {
1543
+ reject(new Error('options.adUnitId is required'));
1544
+ return;
1545
+ }
1546
+ const callbackId = generateCallbackId();
1547
+ registerCallback(callbackId, (result) => {
1548
+ delete callbackMap[callbackId];
1549
+ if (result.code === 'SUCCESS') {
1550
+ resolve(result.data);
1551
+ } else {
1552
+ var err = new Error(result.code || 'ERROR');
1553
+ err.detail = result.message;
1554
+ reject(err);
1555
+ }
1556
+ }, 30000);
1557
+ global.appbridge.showBannerAd(JSON.stringify(options), callbackId);
1558
+ });
1559
+ },
1560
+
1561
+ /**
1562
+ * 隐藏 Banner 广告
1563
+ * @param {string} adId - showBannerAd 返回的 adId
1564
+ * @returns {Promise<void>}
1565
+ */
1566
+ hideBannerAd: function(adId) {
1567
+ return new Promise((resolve, reject) => {
1568
+ if (!global.appbridge) {
1569
+ reject(new Error('Not in app environment. This API requires native app support.'));
1570
+ return;
1571
+ }
1572
+ if (!adId) {
1573
+ reject(new Error('adId is required'));
1574
+ return;
1575
+ }
1576
+ const callbackId = generateCallbackId();
1577
+ registerCallback(callbackId, (result) => {
1578
+ delete callbackMap[callbackId];
1579
+ if (result.code === 'SUCCESS') {
1580
+ resolve();
1581
+ } else {
1582
+ var err = new Error(result.code || 'ERROR');
1583
+ err.detail = result.message;
1584
+ reject(err);
1585
+ }
1586
+ }, 5000);
1587
+ global.appbridge.hideBannerAd(adId, callbackId);
1588
+ });
1589
+ },
1590
+
1591
+ // ==================== 归因 ====================
1592
+
1593
+ /**
1594
+ * 获取归因数据
1595
+ * @param {boolean} [onlyFirst=false] - 是否只获取首次归因(跳过网络请求)
1596
+ * @returns {Promise<{first: Object|null, current: Object|null}>} 归因数据
1597
+ * - first: 首次归因(从缓存读取),无则为 null
1598
+ * - current: 当前归因(网络请求),onlyFirst=true 时为 undefined
1599
+ */
1600
+ getAttribution: function(onlyFirst) {
1601
+ return new Promise((resolve, reject) => {
1602
+ if (!global.appbridge) {
1603
+ reject(new Error('Not in app environment. This API requires native app support.'));
1604
+ return;
1605
+ }
1606
+ const callbackId = generateCallbackId();
1607
+ registerCallback(callbackId, (result) => {
1608
+ delete callbackMap[callbackId];
1609
+ if (result.code === 'SUCCESS') {
1610
+ resolve(result.data);
1611
+ } else {
1612
+ reject(new Error(result.message || result.code));
1613
+ }
1614
+ }, 30000); // 归因请求可能需要较长时间
1615
+ global.appbridge.getAttribution(callbackId, onlyFirst ? true : false);
1616
+ });
1617
+ },
1618
+
1619
+ // ==================== Native Block ====================
1620
+
1621
+ /**
1622
+ * Native Block 模块
1623
+ * 提供 H5 与 Native View 的"伪同层渲染"能力
1624
+ */
1625
+ nativeBlock: {
1626
+ _blocks: {}, // blockId -> { element, config }
1627
+ _scrollListenerBound: false,
1628
+
1629
+ /**
1630
+ * 初始化 - 扫描静态 native-block 并注册
1631
+ * 建议在 DOMContentLoaded 后调用
1632
+ */
1633
+ init: function() {
1634
+ var self = this;
1635
+ document.querySelectorAll('native-block').forEach(function(el) {
1636
+ self._initElement(el);
1637
+ });
1638
+ this._bindScrollListener();
1639
+ window.addEventListener('beforeunload', function() {
1640
+ self.destroyAll();
1641
+ });
1642
+ },
1643
+
1644
+ /**
1645
+ * 动态创建 native-block
1646
+ * @param {Object} options 配置选项
1647
+ * @param {string} options.blockId 唯一标识(必填)
1648
+ * @param {string} options.blockType 组件类型(必填,如 "ad-banner")
1649
+ * @param {Object} [options.config] 传递给宿主的配置
1650
+ * @param {HTMLElement} [options.container] 插入到哪个容器,默认 document.body
1651
+ * @param {Object} [options.style] CSS 样式对象
1652
+ * @returns {Promise<{blockId: string, element: HTMLElement, destroy: Function}>}
1653
+ */
1654
+ create: function(options) {
1655
+ var self = this;
1656
+ return new Promise(function(resolve, reject) {
1657
+ if (!options || !options.blockId || !options.blockType) {
1658
+ reject(new Error('blockId and blockType are required'));
1659
+ return;
1660
+ }
1661
+
1662
+ // 1. 创建占位 element
1663
+ var el = document.createElement('native-block');
1664
+ el.setAttribute('block-id', options.blockId);
1665
+ el.setAttribute('block-type', options.blockType);
1666
+ if (options.style) {
1667
+ Object.keys(options.style).forEach(function(key) {
1668
+ el.style[key] = options.style[key];
1669
+ });
1670
+ }
1671
+
1672
+ // 2. 插入 DOM
1673
+ var container = options.container || document.body;
1674
+ container.appendChild(el);
1675
+
1676
+ // 3. 注册到 Native
1677
+ self._createBlock(options.blockId, options.blockType, options.config || {})
1678
+ .then(function() {
1679
+ self._blocks[options.blockId] = { element: el, config: options };
1680
+ self._updatePosition(options.blockId);
1681
+ resolve({
1682
+ blockId: options.blockId,
1683
+ element: el,
1684
+ destroy: function() {
1685
+ self.destroy(options.blockId);
1686
+ }
1687
+ });
1688
+ })
1689
+ .catch(reject);
1690
+ });
1691
+ },
1692
+
1693
+ /**
1694
+ * 调用 Native 创建 Block
1695
+ * @private
1696
+ */
1697
+ _createBlock: function(blockId, blockType, config) {
1698
+ return new Promise(function(resolve, reject) {
1699
+ if (!global.appbridge) {
1700
+ reject(new Error('Not in app environment. This API requires native app support.'));
1701
+ return;
1702
+ }
1703
+ var callbackId = generateCallbackId();
1704
+ registerCallback(callbackId, function(result) {
1705
+ delete callbackMap[callbackId];
1706
+ if (result.code === 'SUCCESS') {
1707
+ resolve(result.data);
1708
+ } else {
1709
+ reject(new Error(result.message || result.code));
1710
+ }
1711
+ }, 10000);
1712
+ global.appbridge.createNativeBlock(blockId, blockType, JSON.stringify(config), callbackId);
1713
+ });
1714
+ },
1715
+
1716
+ /**
1717
+ * 初始化静态 element
1718
+ * @private
1719
+ */
1720
+ _initElement: function(el) {
1721
+ var self = this;
1722
+ var blockId = el.getAttribute('block-id');
1723
+ var blockType = el.getAttribute('block-type');
1724
+ var configAttr = el.getAttribute('block-config');
1725
+ var config = {};
1726
+ if (configAttr) {
1727
+ try {
1728
+ config = JSON.parse(configAttr);
1729
+ } catch (e) {
1730
+ console.error('Native block config parse error:', e);
1731
+ }
1732
+ }
1733
+
1734
+ if (!blockId || !blockType) {
1735
+ console.error('Native block missing block-id or block-type');
1736
+ return;
1737
+ }
1738
+
1739
+ this._createBlock(blockId, blockType, config).then(function() {
1740
+ self._blocks[blockId] = { element: el, config: { blockId: blockId, blockType: blockType, config: config } };
1741
+ self._updatePosition(blockId);
1742
+ }).catch(function(e) {
1743
+ console.error('Native block create failed:', e);
1744
+ });
1745
+ },
1746
+
1747
+ /**
1748
+ * 绑定滚动监听
1749
+ * @private
1750
+ */
1751
+ _bindScrollListener: function() {
1752
+ if (this._scrollListenerBound) return;
1753
+ this._scrollListenerBound = true;
1754
+
1755
+ var self = this;
1756
+ var ticking = false;
1757
+ window.addEventListener('scroll', function() {
1758
+ if (!ticking) {
1759
+ requestAnimationFrame(function() {
1760
+ self.updatePositions();
1761
+ ticking = false;
1762
+ });
1763
+ ticking = true;
1764
+ }
1765
+ }, { passive: true });
1766
+
1767
+ // 也监听 resize 事件
1768
+ window.addEventListener('resize', function() {
1769
+ if (!ticking) {
1770
+ requestAnimationFrame(function() {
1771
+ self.updatePositions();
1772
+ ticking = false;
1773
+ });
1774
+ ticking = true;
1775
+ }
1776
+ }, { passive: true });
1777
+ },
1778
+
1779
+ /**
1780
+ * 更新所有 Block 的位置
1781
+ */
1782
+ updatePositions: function() {
1783
+ var self = this;
1784
+ Object.keys(this._blocks).forEach(function(id) {
1785
+ self._updatePosition(id);
1786
+ });
1787
+ },
1788
+
1789
+ /**
1790
+ * 更新单个 Block 的位置
1791
+ * @private
1792
+ */
1793
+ _updatePosition: function(blockId) {
1794
+ var block = this._blocks[blockId];
1795
+ if (!block || !block.element) return;
1796
+ if (!global.appbridge) return;
1797
+
1798
+ var rect = block.element.getBoundingClientRect();
1799
+ var pos = {
1800
+ x: rect.left,
1801
+ y: rect.top,
1802
+ width: rect.width,
1803
+ height: rect.height,
1804
+ visible: rect.bottom > 0 && rect.top < window.innerHeight && rect.right > 0 && rect.left < window.innerWidth
1805
+ };
1806
+ global.appbridge.updateNativeBlockPosition(blockId, JSON.stringify(pos));
1807
+ },
1808
+
1809
+ /**
1810
+ * 销毁单个 Block
1811
+ * @param {string} blockId 唯一标识
1812
+ */
1813
+ destroy: function(blockId) {
1814
+ var block = this._blocks[blockId];
1815
+ if (block) {
1816
+ if (global.appbridge) {
1817
+ global.appbridge.destroyNativeBlock(blockId);
1818
+ }
1819
+ if (block.element && block.element.parentNode) {
1820
+ block.element.parentNode.removeChild(block.element);
1821
+ }
1822
+ delete this._blocks[blockId];
1823
+ }
1824
+ },
1825
+
1826
+ /**
1827
+ * 销毁所有 Block
1828
+ */
1829
+ destroyAll: function() {
1830
+ var self = this;
1831
+ Object.keys(this._blocks).forEach(function(id) {
1832
+ self.destroy(id);
1833
+ });
1834
+ if (global.appbridge) {
1835
+ global.appbridge.destroyAllNativeBlocks();
1836
+ }
1837
+ }
1838
+ }
1839
+ };
1840
+
1841
+ // 导出
1842
+ if (typeof module !== 'undefined' && module.exports) {
1843
+ module.exports = SDK;
1844
+ } else {
1845
+ global.SuperSDK = SDK;
1846
+ }
1847
+
1848
+ })(typeof window !== 'undefined' ? window : this);