@maoyugames/phaser-framework 1.0.12 → 1.0.18

package/dist/{BasePlatform-CwVOo3_q.d.ts → BasePlatform-Bod6yNYx.d.ts}

@@ -1,4 +1,4 @@
-import { d as IPlatform, r as PlatformName, S as SafeArea, v as SystemInfo, L as LaunchOptions, k as IPlatformNet, o as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, m as IPlatformShortcut, j as IPlatformMission, P as PlatformInfo } from './types-WJYVtDfo.js';
+import { d as IPlatform, r as PlatformName, S as SafeArea, v as SystemInfo, L as LaunchOptions, k as IPlatformNet, o as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, m as IPlatformShortcut, j as IPlatformMission, P as PlatformInfo } from './types-BceYZWGr.js';
 
 /**
  * 平台抽象基类:封装"有 DOM/BOM 的环境"通用实现,供

package/dist/cli/index.js

@@ -318,7 +318,7 @@ function escapeAttr(s) {
 }
 
 // src/cli/shells/facebook.ts
-var DEFAULT_FB_SDK_VERSION = "7.1";
+var DEFAULT_FB_SDK_VERSION = "8.0";
 function renderFacebookHtml(cfg, scriptSrc) {
   const title = escapeHtml(cfg?.appName ?? "Facebook Instant Game");
   const sdkVersion = (cfg?.fbSdkVersion ?? DEFAULT_FB_SDK_VERSION).trim();

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { b as HttpRequestOptions, U as Unsubscribe, H as Handler, p as LogLevel, A as AdResult, t as PurchaseResult, q as LoginResult, d as IPlatform, i as IPlatformLifecycle, S as SafeArea } from './types-WJYVtDfo.js';
-export { a as HttpMethod, c as HttpResponse, I as IDisposable, e as IPlatformAds, f as IPlatformAnalytics, g as IPlatformAuth, h as IPlatformDevice, j as IPlatformMission, k as IPlatformNet, l as IPlatformPayment, m as IPlatformShortcut, n as IPlatformSocket, o as IPlatformStorage, L as LaunchOptions, P as PlatformInfo, r as PlatformName, s as PlatformUnsupportedError, R as Result, u as SocketOptions, v as SystemInfo, V as Vec2, w as err, x as ok } from './types-WJYVtDfo.js';
+import { b as HttpRequestOptions, U as Unsubscribe, H as Handler, p as LogLevel, A as AdResult, t as PurchaseResult, q as LoginResult, d as IPlatform, i as IPlatformLifecycle, S as SafeArea } from './types-BceYZWGr.js';
+export { a as HttpMethod, c as HttpResponse, I as IDisposable, e as IPlatformAds, f as IPlatformAnalytics, g as IPlatformAuth, h as IPlatformDevice, j as IPlatformMission, k as IPlatformNet, l as IPlatformPayment, m as IPlatformShortcut, n as IPlatformSocket, o as IPlatformStorage, L as LaunchOptions, P as PlatformInfo, r as PlatformName, s as PlatformUnsupportedError, R as Result, u as SocketOptions, v as SystemInfo, V as Vec2, w as err, x as ok } from './types-BceYZWGr.js';
 import Phaser from 'phaser';
 
 /**

package/dist/platform/capacitor.d.ts

@@ -1,5 +1,5 @@
-import { r as PlatformName, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-WJYVtDfo.js';
-import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
+import { r as PlatformName, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-BceYZWGr.js';
+import { B as BasePlatform } from '../BasePlatform-Bod6yNYx.js';
 
 /**
  * Capacitor(原生 WebView 容器)平台适配器。

package/dist/platform/facebook.d.ts

@@ -1,5 +1,5 @@
-import { r as PlatformName, o as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-WJYVtDfo.js';
-import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
+import { r as PlatformName, o as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, m as IPlatformShortcut, i as IPlatformLifecycle } from '../types-BceYZWGr.js';
+import { B as BasePlatform } from '../BasePlatform-Bod6yNYx.js';
 
 /**
  * Facebook Instant Games 平台适配器。
@@ -26,6 +26,7 @@ declare class FacebookPlatform extends BasePlatform {
     readonly ads: IPlatformAds;
     readonly payment: IPlatformPayment;
     readonly device: IPlatformDevice;
+    readonly shortcut: IPlatformShortcut;
     readonly lifecycle: IPlatformLifecycle;
     init(): Promise<void>;
 }

package/dist/platform/facebook.js

@@ -93,6 +93,11 @@ var FacebookAuth = class {
     if (!name && !photo) return null;
     return { nickname: name ?? "", avatarUrl: photo ?? "" };
   }
+  // FB 的 player 信息(getName/getPhoto)无需额外授权弹窗即可读(与 TikTok 需 explicit authorize
+  // 拿 user.info.basic 不同)。authorize 直接复用 login() 的结果返回,业务层「按需引导授权」逻辑通用。
+  authorize(_scope) {
+    return this.login();
+  }
 };
 var FacebookAds = class {
   constructor() {
@@ -144,6 +149,37 @@ var FacebookAds = class {
     }
   }
 };
+var FacebookShortcut = class {
+  check() {
+    if (!hasFB() || typeof FBInstant.canCreateShortcutAsync !== "function") {
+      return Promise.resolve(false);
+    }
+    try {
+      return FBInstant.canCreateShortcutAsync().then(
+        (ok) => !!ok,
+        () => false
+      );
+    } catch {
+      return Promise.resolve(false);
+    }
+  }
+  add() {
+    if (!hasFB() || typeof FBInstant.createShortcutAsync !== "function") {
+      return Promise.resolve(false);
+    }
+    try {
+      return FBInstant.createShortcutAsync().then(
+        () => true,
+        () => false
+      );
+    } catch {
+      return Promise.resolve(false);
+    }
+  }
+  getMissionReward() {
+    return Promise.resolve({ canReceive: false });
+  }
+};
 var FacebookPayment = class {
   async purchase(productId, extra) {
     requireFB("payment.purchase");
@@ -224,6 +260,9 @@ var FacebookPlatform = class extends BasePlatform {
     __publicField(this, "ads", new FacebookAds());
     __publicField(this, "payment", new FacebookPayment());
     __publicField(this, "device", new FacebookDevice());
+    __publicField(this, "shortcut", new FacebookShortcut());
+    // mission 不实现(FB 无"侧边栏入口任务"概念,TikTok 特有);保持 undefined,
+    // 业务层 App.platform.mission?.startEntrance() 会安全跳过。
     __publicField(this, "lifecycle", new FacebookLifecycle(
       () => this.getLaunchOptions()
     ));

package/dist/platform/tiktok.d.ts

@@ -1,5 +1,5 @@
-import { r as PlatformName, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, m as IPlatformShortcut, j as IPlatformMission, i as IPlatformLifecycle } from '../types-WJYVtDfo.js';
-import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
+import { r as PlatformName, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, m as IPlatformShortcut, j as IPlatformMission, i as IPlatformLifecycle } from '../types-BceYZWGr.js';
+import { B as BasePlatform } from '../BasePlatform-Bod6yNYx.js';
 
 /**
  * TikTok Mini Games(Minis)平台适配器。

package/dist/platform/tiktok.js

@@ -10,27 +10,84 @@ function requireTT(capability) {
   if (!hasTT()) throw new PlatformUnsupportedError("tiktok", capability);
 }
 var TikTokAuth = class {
-  // TikTok H5 SDK 实测(2026-05-28 反编译 connect.tiktok-minis.com/game/sdk.js)
-  // **没有 game.login 也没有 game.getUserInfo**——这两个 API 是抖音(国内)小游戏的协议,
-  // TikTok 海外走 OAuth code 流程:authorizeOpenContext({get_status_only:false}) 弹授权页拿 code,
-  // 后端用 code + client_secret 调 open.tiktokapis.com/v2/oauth/token/ + /v2/user/info/ 拿 user info。
-  async login() {
+  // 登录用 game.login(静默登录,2026-05-29 核对 SDK + 官方接入指南 §2 确认):它是 SDK 的
+  // class method,返回 authResponse.code,后端用此 code 调 /v2/oauth/token/ 换 access_token+open_id。
+  // 早先误用 authorizeOpenContext 的 code(非标准 OAuth code),后端换 token 报 invalid_request:
+  // malformed,导致登录全废 → 一切需鉴权功能(购买/排行榜/同步)401。已纠正为 game.login。
+  // game.login 是 callback 式({success,fail,complete}),这里包成 Promise。
+  login() {
     requireTT("auth.login");
-    let res = await TTMinis.game.authorizeOpenContext({ get_status_only: true });
-    if (!res?.is_success || !res?.code) {
-      res = await TTMinis.game.authorizeOpenContext({ get_status_only: false });
-    }
-    if (!res?.is_success || !res?.code) {
-      const e = res?.error;
-      throw new Error(`TikTok authorize failed: ${e?.error_msg ?? "unknown"} (code=${e?.error_code ?? "NA"})`);
-    }
-    return { code: res.code, raw: res };
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const timer = setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        reject(new Error("TikTok login timeout (no callback in 10s)"));
+      }, 1e4);
+      const finish = (fn) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        fn();
+      };
+      const onResult = (res) => {
+        const code = res?.code ?? res?.authResponse?.code ?? "";
+        finish(
+          () => code ? resolve({ code, raw: res }) : reject(new Error(`TikTok login failed: ${JSON.stringify(res?.error ?? res ?? "no code")}`))
+        );
+      };
+      try {
+        TTMinis.game.login({
+          success: onResult,
+          fail: (err) => finish(() => reject(new Error(`TikTok login fail: ${err?.errMsg ?? JSON.stringify(err)}`)))
+        });
+      } catch (e) {
+        try {
+          TTMinis.game.login(
+            (r) => onResult(r)
+          );
+        } catch {
+          finish(() => reject(e));
+        }
+      }
+    });
   }
-  // TikTok H5 SDK 没有客户端 user info API。nickname/avatar 必须由后端用 access_token 调
-  // /v2/user/info/ 取(scope=user.info.basic),客户端拿到的 user 已含这些字段。
+  // TikTok H5 SDK 没有客户端 user info API。nickname/avatar 由后端用 access_token 调
+  // /v2/user/info/ 取(需 explicit authorize 的 user.info.basic scope),客户端拿到的 user 已含。
   async getProfile() {
     return null;
   }
+  // 显式授权(game.authorize):弹 TikTok 授权页拿带 scope 的 code,后端换 token 后调 /v2/user/info/
+  // 取 nickname/avatar。callback 式,包成 Promise + 10s 超时(同 login,防永久 pending)。
+  authorize(scope = "user.info.basic") {
+    requireTT("auth.authorize");
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const timer = setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        reject(new Error("TikTok authorize timeout"));
+      }, 1e4);
+      const finish = (fn) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        fn();
+      };
+      try {
+        TTMinis.game.authorize({
+          scope,
+          success: (res) => {
+            const code = res?.code ?? res?.authResponse?.code ?? "";
+            finish(() => code ? resolve({ code, raw: res }) : reject(new Error("authorize: no code")));
+          },
+          fail: (err) => finish(() => reject(new Error(`TikTok authorize fail: ${err?.errMsg ?? JSON.stringify(err)}`)))
+        });
+      } catch (e) {
+        finish(() => reject(e));
+      }
+    });
+  }
 };
 var TikTokAds = class {
   // TikTok H5 SDK 只有 createRewardedVideoAd(没有 preload/show/Interstitial 单独 API,
@@ -100,8 +157,48 @@ var TikTokAds = class {
       onError(e?.message ?? "show rejected");
     });
   }
-  async showInterstitial(_adUnitId) {
-    return "failed";
+  // 插页广告:官方文档 createInterstitialAd 自 SDK 0.3.0;当前反编译版 sdk.js 未见此 API,
+  // 真机 SDK 版本可能更高。typeof 检测:SDK 有就用(create → onClose/onError → show),没有降级 failed。
+  showInterstitial(adUnitId) {
+    requireTT("ads.showInterstitial");
+    const create = TTMinis.game.createInterstitialAd;
+    if (typeof create !== "function") return Promise.resolve("failed");
+    return new Promise((resolve) => {
+      let settled = false;
+      const done = (r) => {
+        if (!settled) {
+          settled = true;
+          resolve(r);
+        }
+      };
+      try {
+        const ad = create.call(TTMinis.game, { adUnitId });
+        if (!ad || typeof ad.show !== "function") {
+          done("failed");
+          return;
+        }
+        try {
+          ad.onClose(() => done("closed"));
+        } catch {
+        }
+        if (typeof ad.onError === "function") {
+          try {
+            ad.onError((res) => {
+              console.warn("[ads.showInterstitial] error:", res?.error?.error_msg);
+              done("failed");
+            });
+          } catch {
+          }
+        }
+        void ad.show().catch((e) => {
+          console.warn("[ads.showInterstitial] show rejected:", e?.message);
+          done("failed");
+        });
+      } catch (e) {
+        console.warn("[ads.showInterstitial] create threw:", e?.message);
+        done("failed");
+      }
+    });
   }
 };
 var TikTokShortcut = class {
@@ -190,27 +287,40 @@ var TikTokMission = class {
   }
 };
 var TikTokPayment = class {
-  async purchase(productId, extra) {
+  // TikTok IAP(2026-05-29 飞书接入指南):后端预下单拿 trade_order_id,前端 game.pay 拉起收银台。
+  // purchase 的 productId 参数在 TikTok 下被用作 trade_order_id(业务后端已下单);也兼容从
+  // extra.orderId / extra.tradeOrderId 取(ShopModule 传的是 {orderId: trade_order_id})。
+  // resolve 仅表示「客户端支付面板流程结束」,真正发货由 webhook + 业务层轮询后端订单状态确认。
+  purchase(productId, extra) {
     requireTT("payment.purchase");
-    const res = await TTMinis.game.requestPayment({ productId, ...extra ?? {} });
-    return {
-      productId: res.productId ?? productId,
-      transactionId: res.transactionId ?? "",
-      receipt: res.receipt ?? "",
-      raw: res
-    };
+    const tradeOrderId = extra?.orderId ?? extra?.tradeOrderId ?? productId;
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      try {
+        TTMinis.game.pay({
+          trade_order_id: tradeOrderId,
+          success: () => {
+            if (settled) return;
+            settled = true;
+            resolve({ productId, transactionId: tradeOrderId, receipt: tradeOrderId, raw: { trade_order_id: tradeOrderId } });
+          },
+          fail: (err) => {
+            if (settled) return;
+            settled = true;
+            reject(new Error(`TikTok pay failed: ${err?.errMsg ?? "unknown"}`));
+          }
+        });
+      } catch (e) {
+        if (!settled) {
+          settled = true;
+          reject(e);
+        }
+      }
+    });
   }
+  // TikTok H5 SDK 未确认 getUnfinishedPurchases;掉单恢复靠后端订单状态查询 + webhook,这里返空。
   async restore() {
-    requireTT("payment.restore");
-    const fn = TTMinis.game.getUnfinishedPurchases;
-    if (!fn) return [];
-    const list = await fn.call(TTMinis.game) ?? [];
-    return list.map((res) => ({
-      productId: res.productId,
-      transactionId: res.transactionId ?? "",
-      receipt: res.receipt ?? "",
-      raw: res
-    }));
+    return [];
   }
 };
 var TikTokDevice = class {
@@ -241,12 +351,35 @@ var TikTokDevice = class {
     const res = await TTMinis.game.getClipboardData();
     return res?.data ?? "";
   }
-  async share(payload) {
+  // shareAppMessage 是 callback 式(2026-05-30 反编译核对),不是 Promise;这里包成 Promise。
+  share(payload) {
     requireTT("device.share");
-    await TTMinis.game.shareAppMessage({
-      title: payload.title,
-      imageUrl: payload.imageUrl,
-      query: payload.query
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      try {
+        TTMinis.game.shareAppMessage({
+          title: payload.title,
+          imageUrl: payload.imageUrl,
+          query: payload.query,
+          success: () => {
+            if (!settled) {
+              settled = true;
+              resolve();
+            }
+          },
+          fail: (err) => {
+            if (!settled) {
+              settled = true;
+              reject(new Error(`share failed: ${err?.errMsg ?? "unknown"}`));
+            }
+          }
+        });
+      } catch (e) {
+        if (!settled) {
+          settled = true;
+          reject(e);
+        }
+      }
     });
   }
 };

package/dist/platform/web.d.ts

@@ -1,5 +1,5 @@
-import { r as PlatformName, h as IPlatformDevice } from '../types-WJYVtDfo.js';
-import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
+import { r as PlatformName, h as IPlatformDevice } from '../types-BceYZWGr.js';
+import { B as BasePlatform } from '../BasePlatform-Bod6yNYx.js';
 
 /**
  * Web(普通浏览器 / H5)平台适配器。

package/dist/platform/wechat.d.ts

@@ -1,4 +1,4 @@
-import { d as IPlatform, k as IPlatformNet, o as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, P as PlatformInfo, L as LaunchOptions } from '../types-WJYVtDfo.js';
+import { d as IPlatform, k as IPlatformNet, o as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, P as PlatformInfo, L as LaunchOptions } from '../types-BceYZWGr.js';
 
 /**
  * 微信小游戏平台适配器。

package/dist/{types-WJYVtDfo.d.ts → types-BceYZWGr.d.ts}

@@ -169,6 +169,11 @@ interface IPlatformAuth {
         nickname: string;
         avatarUrl: string;
     } | null>;
+    /**
+     * 显式授权(弹授权页),返回带额外 scope 的 code,后端换 token 后可拿 nickname/avatar。
+     * 平台不支持时为 undefined。用于「按需引导用户授权显示昵称」(如首次进排行榜)。
+     */
+    authorize?(scope?: string): Promise<LoginResult>;
 }
 /** 广告 */
 type AdResult = 'completed' | 'skipped' | 'failed' | 'closed';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maoyugames/phaser-framework",
-  "version": "1.0.12",
+  "version": "1.0.18",
   "description": "多平台 Phaser 游戏框架:业务/底层分离,HTTP/WebSocket/KCP,Web/TikTok/微信/Facebook/App 隔离打包",
   "type": "module",
   "license": "MIT",