@retion-miniapp/sdk 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@
 
 ## Unreleased
 
+## 0.4.0 — 2026-09-30
+
+### Added
+- `onAppPaused(cb)` / `onAppResumed(cb)` — mini app bị đóng (chạy ngầm) / mở lại.
+- `onContextChange(cb)` — mini app giữ nguyên khi chuyển page / conversation; web gọi lại API theo page mới (cần `context_update: true`).
+
+## 0.3.0 — 2026-09-30
+
+### Added
+- `getToken('access' | 'partner' | 'chatbox')` — lấy `partner_token` / `chatbox_token` khi admin đã bật quyền cho mini app trên Console.
+- `ErrorCode.PERMISSION_DENIED`.
+
 ## 0.2.0 — 2026-09-30
 
 ### Breaking

package/README.md

@@ -2,7 +2,7 @@
 
 Kết nối web mini app (Vue, React, ...) với app Retion.
 
-Mini app là web của bạn, được app tải về máy và mở full màn hình trong 1 conversation. SDK chỉ làm 3 việc:
+Mini app là web của bạn, được app tải về máy và mở full màn hình trong 1 conversation. SDK làm 3 việc:
 
 1. Cho biết mini app đang mở ở **page nào, khách nào** → `getRouteParams()`
 2. Đưa **token** để gọi API backend của bạn → `getAccessToken()`
@@ -127,7 +127,10 @@ Lên Console → version vừa deploy → **→ production**. Người dùng nh
 |---|---|---|---|
 | `getRouteParams()` | `RouteParams` | Thông tin app truyền vào | Đọc query URL |
 | `getAccessToken()` | `Promise<string>` | Token của page hiện tại (app tự refresh) | Đọc `?access_token=` — không có thì lỗi `NOT_IN_HOST` |
+| `getToken(type)` | `Promise<string>` | `'access'` \| `'partner'` \| `'chatbox'` — `partner` / `chatbox` cần quyền (xem dưới) | Đọc `?access_token=` / `?partner_token=` / `?chatbox_token=` |
+| `onContextChange(cb)` | `() => void` | Gọi `cb` khi chuyển page / conversation (không nạp lại trang) | Không bao giờ gọi |
 | `closeApp()` | `Promise<void>` | Đóng mini app | Lỗi `NOT_IN_HOST` |
+| `onAppPaused(cb)` / `onAppResumed(cb)` | `() => void` | Mini app bị đóng (chạy ngầm) / mở lại | Không bao giờ gọi |
 | `isInHost()` | `boolean` | `true` | `false` |
 
 `RouteParams`: `page_id`, `client_id`, `org_id`, `message_id`, `comment_id`, `locale`, `is_page_admin`.
@@ -139,6 +142,7 @@ Mọi lỗi là `MiniAppError` có `code`:
 | `code` | Khi nào |
 |---|---|
 | `NOT_IN_HOST` | Chạy ngoài app mà gọi hàm cần app |
+| `PERMISSION_DENIED` | Mini app chưa được cấp quyền lấy token đó |
 | `TIMEOUT` | App không phản hồi sau 15s |
 | `NOT_SUPPORTED` | Phiên bản app hiện tại chưa hỗ trợ |
 | `HOST_ERROR` | Lỗi khác phía app (vd page chưa có token) |
@@ -153,6 +157,59 @@ try {
 }
 ```
 
+### Token khác ngoài `access_token`
+
+| Token | Là gì | Cần quyền |
+|---|---|---|
+| `access` | Token của mini app cho page hiện tại | Không — luôn được |
+| `partner` | Token đối tác của page | `partner_token` |
+| `chatbox` | Token đăng nhập của người dùng app (**toàn quyền** như người dùng) | `chatbox_token` |
+
+Quyền do **admin bật trên Console** (app → *Quyền lấy token*) — không khai trong code được. Chưa bật → `getToken()` lỗi `PERMISSION_DENIED`, và token đó cũng **không có trên URL**.
+
+```ts
+const partnerToken = await getToken('partner');
+```
+
+## Chuyển page / conversation
+
+1 mini app = 1 phiên duy nhất (theo `app_id`), load 1 lần. Khi người dùng mở mini app ở page / conversation khác:
+
+**Mặc định — không cần làm gì.** App nạp lại trang (cùng WebView, không tạo mới) với thông tin mới; code đọc param lúc mở như bình thường.
+
+**Muốn nhanh hơn — không nạp lại trang:** đặt `"context_update": true` trong `miniapp.config.json` và thêm 1 dòng:
+
+```ts
+onMounted(load);          // đã có
+onContextChange(load);    // đổi page / conversation → chạy lại load()
+```
+
+Trong `load()` vẫn gọi `getRouteParams()` / `getToken()` — luôn trả thông tin + token của page mới. Bỏ kết quả của request cũ nếu người dùng đổi page khi nó chưa về:
+
+```ts
+let controller: AbortController | undefined;
+
+const load = async () => {
+  controller?.abort();                  // huỷ request của page trước
+  controller = new AbortController();
+  const { page_id } = getRouteParams();
+  const res = await fetch(`${API}/pages/${page_id}`, {
+    headers: { Authorization: await getToken('access') },
+    signal: controller.signal,
+  });
+  // ...
+};
+```
+
+> Đổi **tổ chức (org)** luôn nạp lại trang — kể cả khi `context_update: true` — để dữ liệu org cũ không còn trong bộ nhớ.
+
+**Đóng / mở lại:** mini app đóng lại vẫn chạy ngầm để mở lại tức thì. Dừng việc chạy nền khi bị đóng:
+
+```ts
+onAppPaused(() => clearInterval(pollTimer));
+onAppResumed(() => load());
+```
+
 ## Hỏi đáp
 
 **Web đang chạy (iframe / trình duyệt) có bị ảnh hưởng khi cài SDK?**
@@ -161,9 +218,6 @@ Không. Ngoài app SDK không gọi mạng, không đụng DOM; `getRouteParams`
 **Token hết hạn?**
 Gọi `getAccessToken()` mỗi lần cần (interceptor ở mục 3 đã làm vậy) — app tự trả token còn hạn. Không lưu token vào localStorage.
 
-**Mở mini app ở page khác?**
-Mỗi page là 1 phiên mini app riêng (token, dữ liệu riêng). Code không cần xử lý gì.
-
 **Có phải tải lại mỗi lần mở?**
 Code mini app nằm sẵn trên máy, chỉ tải khi có version mới. Đóng rồi mở lại trong lúc app còn chạy → hiện ngay.
 

package/dist/index.cjs

@@ -6,6 +6,8 @@ var ErrorCode = {
   NOT_IN_HOST: "NOT_IN_HOST",
   /** Host không phản hồi trong thời gian chờ. */
   TIMEOUT: "TIMEOUT",
+  /** Mini app chưa được admin cấp quyền (vd lấy partner_token / chatbox_token). */
+  PERMISSION_DENIED: "PERMISSION_DENIED",
   /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
   NOT_SUPPORTED: "NOT_SUPPORTED",
   /** Lỗi khác phía host. */
@@ -62,8 +64,12 @@ var createState = () => {
       if ("event" in message) {
         if (message.event === CONTEXT_EVENT) {
           const prev = state.context;
-          state.context = { ...prev, ...message.data };
-          emit(state, CONTEXT_EVENT, { next: { ...state.context }, prev });
+          const next = { ...prev, ...message.data };
+          if (JSON.stringify(next) === JSON.stringify(prev)) {
+            return;
+          }
+          state.context = next;
+          emit(state, CONTEXT_EVENT, { next: { ...next }, prev });
           return;
         }
         emit(state, message.event, message.data);
@@ -129,16 +135,34 @@ var notify = (method, params) => {
     post({ __retion: PROTOCOL_VERSION, method, params });
   }
 };
+var on = (event, listener) => {
+  const { listeners } = getState();
+  let set = listeners.get(event);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(event, set);
+  }
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+};
 
 // src/version.ts
-var SDK_VERSION = "0.2.0" ;
+var SDK_VERSION = "0.4.0" ;
 
 // src/apis/app.ts
 var closeApp = () => call("closeApp");
 var notifyReady = () => notify("ready", { sdkVersion: SDK_VERSION });
+var onAppPaused = (listener) => on("paused", () => listener());
+var onAppResumed = (listener) => on("resumed", () => listener());
 
 // src/apis/route.ts
 var getRouteParams = () => ({ ...getState().context });
+var onContextChange = (listener) => on(CONTEXT_EVENT, (data) => {
+  const { next, prev } = data;
+  listener(next, prev);
+});
 
 // src/apis/user.ts
 var TOKEN_QUERY_PARAM = "access_token";
@@ -158,6 +182,24 @@ var getAccessToken = async () => {
   }
   return token;
 };
+var QUERY_PARAM = {
+  access: "access_token",
+  partner: "partner_token",
+  chatbox: "chatbox_token"
+};
+var getToken = async (type) => {
+  if (!(type in QUERY_PARAM)) {
+    throw new MiniAppError(ErrorCode.HOST_ERROR, `Lo\u1EA1i token kh\xF4ng h\u1EE3p l\u1EC7: ${String(type)}`, "getToken");
+  }
+  if (isInHost()) {
+    return call("getToken", { type });
+  }
+  const token = typeof window === "undefined" ? null : new URLSearchParams(window.location.search).get(QUERY_PARAM[type]);
+  if (!token) {
+    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngo\xE0i app: thi\u1EBFu ?${QUERY_PARAM[type]}= tr\xEAn URL`, "getToken");
+  }
+  return token;
+};
 
 // src/index.ts
 if (typeof window !== "undefined") {
@@ -175,6 +217,10 @@ exports.SDK_VERSION = SDK_VERSION;
 exports.closeApp = closeApp;
 exports.getAccessToken = getAccessToken;
 exports.getRouteParams = getRouteParams;
+exports.getToken = getToken;
 exports.isInHost = isInHost;
+exports.onAppPaused = onAppPaused;
+exports.onAppResumed = onAppResumed;
+exports.onContextChange = onContextChange;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/bridge.ts","../src/version.ts","../src/apis/app.ts","../src/apis/route.ts","../src/apis/user.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const ErrorCode = {\n  /** Không chạy trong app Retion (trình duyệt / iframe cũ). */\n  NOT_IN_HOST: 'NOT_IN_HOST',\n  /** Host không phản hồi trong thời gian chờ. */\n  TIMEOUT: 'TIMEOUT',\n  /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */\n  NOT_SUPPORTED: 'NOT_SUPPORTED',\n  /** Lỗi khác phía host. */\n  HOST_ERROR: 'HOST_ERROR',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode] | (string & {});\n\nexport class MiniAppError extends Error {\n  readonly code: ErrorCode;\n  readonly method?: string;\n\n  constructor(code: ErrorCode, message: string, method?: string) {\n    super(message);\n    this.name = 'MiniAppError';\n    this.code = code;\n    this.method = method;\n  }\n\n  /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */\n  static from(error: unknown, method?: string): MiniAppError {\n    if (error instanceof MiniAppError) {\n      return error;\n    }\n    if (error && typeof error === 'object') {\n      const { code, message } = error as { code?: unknown; message?: unknown };\n      return new MiniAppError(\n        typeof code === 'string' ? code : ErrorCode.HOST_ERROR,\n        typeof message === 'string' ? message : 'Unknown error',\n        method,\n      );\n    }\n    return new MiniAppError(ErrorCode.HOST_ERROR, String(error), method);\n  }\n}\n","/**\n * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.\n *\n * Giao thức v1\n *  web → host : ReactNativeWebView.postMessage(JSON.stringify(RequestMessage))\n *  host → web : window.__RETION_MINIAPP__.receive(ResponseMessage | EventMessage)\n *  host inject trước khi trang chạy:\n *    window.__RETION_MINIAPP_HOST__    = { protocol }  ← đánh dấu host hỗ trợ SDK\n *    window.__RETION_MINIAPP_CONTEXT__ = RouteParams    ← context ban đầu\n *\n * Chỉ có ReactNativeWebView KHÔNG đủ để coi là host: màn iframe cũ của app cũng là RN WebView\n * nhưng không hiểu giao thức này (gọi API sẽ treo tới timeout). Thiếu marker → NOT_IN_HOST ngay.\n *\n * State đặt trên window (singleton): nhiều bản SDK trong cùng trang (trùng version trong\n * node_modules) vẫn dùng chung 1 bridge thay vì ghi đè hàm receive của nhau.\n */\nimport { ErrorCode, MiniAppError } from './errors';\nimport type { RouteParams } from './types';\n\nexport const PROTOCOL_VERSION = 1;\nexport const DEFAULT_TIMEOUT_MS = 15_000;\nexport const CONTEXT_EVENT = 'context';\n\nexport interface RequestMessage {\n  __retion: typeof PROTOCOL_VERSION;\n  /** Có id → host phải trả ResponseMessage. Không có → lệnh 1 chiều. */\n  id?: string;\n  method: string;\n  params?: unknown;\n}\n\nexport type ResponseMessage =\n  | { id: string; result?: unknown; error?: undefined }\n  | { id: string; error: { code: string; message: string } };\n\nexport interface EventMessage {\n  event: string;\n  data?: unknown;\n}\n\nexport interface HostInfo {\n  /** Phiên bản giao thức host hỗ trợ. */\n  protocol: number;\n}\n\ntype Listener = (data: unknown) => void;\n\ninterface Pending {\n  method: string;\n  resolve: (value: unknown) => void;\n  reject: (error: MiniAppError) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\ninterface BridgeState {\n  protocol: number;\n  seq: number;\n  pending: Map<string, Pending>;\n  listeners: Map<string, Set<Listener>>;\n  context: RouteParams;\n  receive: (message: ResponseMessage | EventMessage) => void;\n}\n\ndeclare global {\n  interface Window {\n    ReactNativeWebView?: { postMessage: (message: string) => void };\n    __RETION_MINIAPP__?: BridgeState;\n    __RETION_MINIAPP_CONTEXT__?: RouteParams;\n    __RETION_MINIAPP_HOST__?: HostInfo;\n  }\n}\n\nconst hasWindow = typeof window !== 'undefined';\n\nconst readInitialContext = (): RouteParams => {\n  if (!hasWindow) {\n    return {};\n  }\n  const query = Object.fromEntries(new URLSearchParams(window.location.search));\n  return { ...query, ...(window.__RETION_MINIAPP_CONTEXT__ ?? {}) };\n};\n\nconst createState = (): BridgeState => {\n  const state: BridgeState = {\n    protocol: PROTOCOL_VERSION,\n    seq: 0,\n    pending: new Map(),\n    listeners: new Map(),\n    context: readInitialContext(),\n    receive: (message) => {\n      if (!message || typeof message !== 'object') {\n        return;\n      }\n      if ('event' in message) {\n        if (message.event === CONTEXT_EVENT) {\n          // Cập nhật context TRƯỚC khi emit → getRouteParams() luôn đúng, kể cả không ai lắng nghe.\n          const prev = state.context;\n          state.context = { ...prev, ...(message.data as RouteParams) };\n          emit(state, CONTEXT_EVENT, { next: { ...state.context }, prev });\n          return;\n        }\n        emit(state, message.event, message.data);\n        return;\n      }\n      const pending = state.pending.get(message.id);\n      if (!pending) {\n        return;\n      }\n      state.pending.delete(message.id);\n      clearTimeout(pending.timer);\n      if (message.error) {\n        pending.reject(MiniAppError.from(message.error, pending.method));\n      } else {\n        pending.resolve(message.result);\n      }\n    },\n  };\n  return state;\n};\n\nconst emit = (state: BridgeState, event: string, data: unknown) => {\n  state.listeners.get(event)?.forEach((listener) => {\n    try {\n      listener(data);\n    } catch (error) {\n      console.error(`[retion-miniapp] listener \"${event}\" lỗi`, error);\n    }\n  });\n};\n\nlet fallback_state: BridgeState | null = null;\n\n/** @internal */\nexport const getState = (): BridgeState => {\n  if (!hasWindow) {\n    return (fallback_state ??= createState());\n  }\n  return (window.__RETION_MINIAPP__ ??= createState());\n};\n\n/** Đang chạy trong app Retion có hỗ trợ SDK (host đã inject marker + kênh postMessage). */\nexport const isInHost = (): boolean =>\n  hasWindow &&\n  typeof window.__RETION_MINIAPP_HOST__?.protocol === 'number' &&\n  typeof window.ReactNativeWebView?.postMessage === 'function';\n\nconst post = (message: RequestMessage) => {\n  window.ReactNativeWebView!.postMessage(JSON.stringify(message));\n};\n\n/** Gửi lệnh lên host và chờ kết quả. Ngoài app → reject NOT_IN_HOST. */\nexport const call = <T>(method: string, params?: unknown, timeout_ms = DEFAULT_TIMEOUT_MS): Promise<T> => {\n  const state = getState();\n\n  if (!isInHost()) {\n    return Promise.reject(new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} chỉ chạy trong app Retion`, method));\n  }\n\n  const id = `${Date.now().toString(36)}-${++state.seq}`;\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      state.pending.delete(id);\n      reject(new MiniAppError(ErrorCode.TIMEOUT, `${method}: host không phản hồi sau ${timeout_ms}ms`, method));\n    }, timeout_ms);\n    state.pending.set(id, { method, resolve: resolve as (v: unknown) => void, reject, timer });\n    post({ __retion: PROTOCOL_VERSION, id, method, params });\n  });\n};\n\n/** Lệnh 1 chiều (không chờ kết quả). Ngoài app: bỏ qua. */\nexport const notify = (method: string, params?: unknown): void => {\n  if (isInHost()) {\n    post({ __retion: PROTOCOL_VERSION, method, params });\n  }\n};\n\n/** Lắng nghe event host đẩy xuống. Trả về hàm huỷ. */\nexport const on = (event: string, listener: Listener): (() => void) => {\n  const { listeners } = getState();\n  let set = listeners.get(event);\n  if (!set) {\n    set = new Set();\n    listeners.set(event, set);\n  }\n  set.add(listener);\n  return () => {\n    set.delete(listener);\n  };\n};\n","declare const __SDK_VERSION__: string;\n\n/** Thay lúc build (tsup define) / test (vitest define) bằng version trong package.json. */\nexport const SDK_VERSION: string = typeof __SDK_VERSION__ === 'string' ? __SDK_VERSION__ : '0.0.0-dev';\n","import { call, notify } from '../bridge';\nimport { SDK_VERSION } from '../version';\n\n/**\n * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).\n */\nexport const closeApp = (): Promise<void> => call<void>('closeApp');\n\n/** @internal SDK tự gọi khi trang sẵn sàng — host ẩn splash + đẩy context mới nhất. */\nexport const notifyReady = (): void => notify('ready', { sdkVersion: SDK_VERSION });\n","import { getState } from '../bridge';\nimport type { RouteParams } from '../types';\n\n/**\n * Thông tin conversation lúc mở mini app (đồng bộ, gọi bất cứ lúc nào).\n * @example\n * const { page_id, client_id } = getRouteParams();\n */\nexport const getRouteParams = (): RouteParams => ({ ...getState().context });\n","import { call, isInHost } from '../bridge';\nimport { ErrorCode, MiniAppError } from '../errors';\n\n/** Tên query param chứa token khi chạy ngoài app (giống URL iframe hiện tại). */\nconst TOKEN_QUERY_PARAM = 'access_token';\n\nconst readTokenFromUrl = (): string | null => {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  return new URLSearchParams(window.location.search).get(TOKEN_QUERY_PARAM);\n};\n\n/**\n * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).\n * - Trong app: lấy từ host, luôn là token của page hiện tại, host tự refresh.\n * - Ngoài app: đọc `?access_token=` trên URL (như iframe hiện tại).\n * Gọi lại mỗi khi cần — không lưu token lâu phía web.\n */\nexport const getAccessToken = async (): Promise<string> => {\n  if (isInHost()) {\n    return call<string>('getAccessToken');\n  }\n  const token = readTokenFromUrl();\n  if (!token) {\n    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngoài app: thiếu ?${TOKEN_QUERY_PARAM}= trên URL`, 'getAccessToken');\n  }\n  return token;\n};\n","import { getState } from './bridge';\nimport { notifyReady } from './apis/app';\n\nexport { getRouteParams } from './apis/route';\nexport { getAccessToken } from './apis/user';\nexport { closeApp } from './apis/app';\nexport { isInHost } from './bridge';\nexport { MiniAppError, ErrorCode } from './errors';\nexport { SDK_VERSION } from './version';\nexport type { RouteParams } from './types';\n\n// Khởi tạo bridge ngay khi import (host có thể đẩy context trước khi app gọi hàm nào),\n// rồi báo \"ready\" khi DOM sẵn sàng.\nif (typeof window !== 'undefined') {\n  getState();\n  if (document.readyState === 'loading') {\n    document.addEventListener('DOMContentLoaded', notifyReady, { once: true });\n  } else {\n    queueMicrotask(notifyReady);\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/bridge.ts","../src/version.ts","../src/apis/app.ts","../src/apis/route.ts","../src/apis/user.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const ErrorCode = {\n  /** Không chạy trong app Retion (trình duyệt / iframe cũ). */\n  NOT_IN_HOST: 'NOT_IN_HOST',\n  /** Host không phản hồi trong thời gian chờ. */\n  TIMEOUT: 'TIMEOUT',\n  /** Mini app chưa được admin cấp quyền (vd lấy partner_token / chatbox_token). */\n  PERMISSION_DENIED: 'PERMISSION_DENIED',\n  /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */\n  NOT_SUPPORTED: 'NOT_SUPPORTED',\n  /** Lỗi khác phía host. */\n  HOST_ERROR: 'HOST_ERROR',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode] | (string & {});\n\nexport class MiniAppError extends Error {\n  readonly code: ErrorCode;\n  readonly method?: string;\n\n  constructor(code: ErrorCode, message: string, method?: string) {\n    super(message);\n    this.name = 'MiniAppError';\n    this.code = code;\n    this.method = method;\n  }\n\n  /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */\n  static from(error: unknown, method?: string): MiniAppError {\n    if (error instanceof MiniAppError) {\n      return error;\n    }\n    if (error && typeof error === 'object') {\n      const { code, message } = error as { code?: unknown; message?: unknown };\n      return new MiniAppError(\n        typeof code === 'string' ? code : ErrorCode.HOST_ERROR,\n        typeof message === 'string' ? message : 'Unknown error',\n        method,\n      );\n    }\n    return new MiniAppError(ErrorCode.HOST_ERROR, String(error), method);\n  }\n}\n","/**\n * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.\n *\n * Giao thức v1\n *  web → host : ReactNativeWebView.postMessage(JSON.stringify(RequestMessage))\n *  host → web : window.__RETION_MINIAPP__.receive(ResponseMessage | EventMessage)\n *  host inject trước khi trang chạy:\n *    window.__RETION_MINIAPP_HOST__    = { protocol }  ← đánh dấu host hỗ trợ SDK\n *    window.__RETION_MINIAPP_CONTEXT__ = RouteParams    ← context ban đầu\n *\n * Chỉ có ReactNativeWebView KHÔNG đủ để coi là host: màn iframe cũ của app cũng là RN WebView\n * nhưng không hiểu giao thức này (gọi API sẽ treo tới timeout). Thiếu marker → NOT_IN_HOST ngay.\n *\n * State đặt trên window (singleton): nhiều bản SDK trong cùng trang (trùng version trong\n * node_modules) vẫn dùng chung 1 bridge thay vì ghi đè hàm receive của nhau.\n */\nimport { ErrorCode, MiniAppError } from './errors';\nimport type { RouteParams } from './types';\n\nexport const PROTOCOL_VERSION = 1;\nexport const DEFAULT_TIMEOUT_MS = 15_000;\nexport const CONTEXT_EVENT = 'context';\n\nexport interface RequestMessage {\n  __retion: typeof PROTOCOL_VERSION;\n  /** Có id → host phải trả ResponseMessage. Không có → lệnh 1 chiều. */\n  id?: string;\n  method: string;\n  params?: unknown;\n}\n\nexport type ResponseMessage =\n  | { id: string; result?: unknown; error?: undefined }\n  | { id: string; error: { code: string; message: string } };\n\nexport interface EventMessage {\n  event: string;\n  data?: unknown;\n}\n\nexport interface HostInfo {\n  /** Phiên bản giao thức host hỗ trợ. */\n  protocol: number;\n}\n\ntype Listener = (data: unknown) => void;\n\ninterface Pending {\n  method: string;\n  resolve: (value: unknown) => void;\n  reject: (error: MiniAppError) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\ninterface BridgeState {\n  protocol: number;\n  seq: number;\n  pending: Map<string, Pending>;\n  listeners: Map<string, Set<Listener>>;\n  context: RouteParams;\n  receive: (message: ResponseMessage | EventMessage) => void;\n}\n\ndeclare global {\n  interface Window {\n    ReactNativeWebView?: { postMessage: (message: string) => void };\n    __RETION_MINIAPP__?: BridgeState;\n    __RETION_MINIAPP_CONTEXT__?: RouteParams;\n    __RETION_MINIAPP_HOST__?: HostInfo;\n  }\n}\n\nconst hasWindow = typeof window !== 'undefined';\n\nconst readInitialContext = (): RouteParams => {\n  if (!hasWindow) {\n    return {};\n  }\n  const query = Object.fromEntries(new URLSearchParams(window.location.search));\n  return { ...query, ...(window.__RETION_MINIAPP_CONTEXT__ ?? {}) };\n};\n\nconst createState = (): BridgeState => {\n  const state: BridgeState = {\n    protocol: PROTOCOL_VERSION,\n    seq: 0,\n    pending: new Map(),\n    listeners: new Map(),\n    context: readInitialContext(),\n    receive: (message) => {\n      if (!message || typeof message !== 'object') {\n        return;\n      }\n      if ('event' in message) {\n        if (message.event === CONTEXT_EVENT) {\n          // Cập nhật context TRƯỚC khi emit → getRouteParams() luôn đúng, kể cả không ai lắng nghe.\n          const prev = state.context;\n          const next = { ...prev, ...(message.data as RouteParams) };\n          // Host đẩy lại context lúc \"ready\" dù không đổi → không báo onContextChange thừa.\n          if (JSON.stringify(next) === JSON.stringify(prev)) {\n            return;\n          }\n          state.context = next;\n          emit(state, CONTEXT_EVENT, { next: { ...next }, prev });\n          return;\n        }\n        emit(state, message.event, message.data);\n        return;\n      }\n      const pending = state.pending.get(message.id);\n      if (!pending) {\n        return;\n      }\n      state.pending.delete(message.id);\n      clearTimeout(pending.timer);\n      if (message.error) {\n        pending.reject(MiniAppError.from(message.error, pending.method));\n      } else {\n        pending.resolve(message.result);\n      }\n    },\n  };\n  return state;\n};\n\nconst emit = (state: BridgeState, event: string, data: unknown) => {\n  state.listeners.get(event)?.forEach((listener) => {\n    try {\n      listener(data);\n    } catch (error) {\n      console.error(`[retion-miniapp] listener \"${event}\" lỗi`, error);\n    }\n  });\n};\n\nlet fallback_state: BridgeState | null = null;\n\n/** @internal */\nexport const getState = (): BridgeState => {\n  if (!hasWindow) {\n    return (fallback_state ??= createState());\n  }\n  return (window.__RETION_MINIAPP__ ??= createState());\n};\n\n/** Đang chạy trong app Retion có hỗ trợ SDK (host đã inject marker + kênh postMessage). */\nexport const isInHost = (): boolean =>\n  hasWindow &&\n  typeof window.__RETION_MINIAPP_HOST__?.protocol === 'number' &&\n  typeof window.ReactNativeWebView?.postMessage === 'function';\n\nconst post = (message: RequestMessage) => {\n  window.ReactNativeWebView!.postMessage(JSON.stringify(message));\n};\n\n/** Gửi lệnh lên host và chờ kết quả. Ngoài app → reject NOT_IN_HOST. */\nexport const call = <T>(method: string, params?: unknown, timeout_ms = DEFAULT_TIMEOUT_MS): Promise<T> => {\n  const state = getState();\n\n  if (!isInHost()) {\n    return Promise.reject(new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} chỉ chạy trong app Retion`, method));\n  }\n\n  const id = `${Date.now().toString(36)}-${++state.seq}`;\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      state.pending.delete(id);\n      reject(new MiniAppError(ErrorCode.TIMEOUT, `${method}: host không phản hồi sau ${timeout_ms}ms`, method));\n    }, timeout_ms);\n    state.pending.set(id, { method, resolve: resolve as (v: unknown) => void, reject, timer });\n    post({ __retion: PROTOCOL_VERSION, id, method, params });\n  });\n};\n\n/** Lệnh 1 chiều (không chờ kết quả). Ngoài app: bỏ qua. */\nexport const notify = (method: string, params?: unknown): void => {\n  if (isInHost()) {\n    post({ __retion: PROTOCOL_VERSION, method, params });\n  }\n};\n\n/** Lắng nghe event host đẩy xuống. Trả về hàm huỷ. */\nexport const on = (event: string, listener: Listener): (() => void) => {\n  const { listeners } = getState();\n  let set = listeners.get(event);\n  if (!set) {\n    set = new Set();\n    listeners.set(event, set);\n  }\n  set.add(listener);\n  return () => {\n    set.delete(listener);\n  };\n};\n","declare const __SDK_VERSION__: string;\n\n/** Thay lúc build (tsup define) / test (vitest define) bằng version trong package.json. */\nexport const SDK_VERSION: string = typeof __SDK_VERSION__ === 'string' ? __SDK_VERSION__ : '0.0.0-dev';\n","import { call, notify, on } from '../bridge';\nimport { SDK_VERSION } from '../version';\n\n/**\n * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).\n */\nexport const closeApp = (): Promise<void> => call<void>('closeApp');\n\n/** @internal SDK tự gọi khi trang sẵn sàng — host ẩn splash + đẩy context mới nhất. */\nexport const notifyReady = (): void => notify('ready', { sdkVersion: SDK_VERSION });\n\n/**\n * Mini app bị đóng (ẩn, vẫn chạy ngầm) — dừng polling / timer / video ở đây cho đỡ tốn pin.\n * @returns hàm huỷ lắng nghe\n */\nexport const onAppPaused = (listener: () => void): (() => void) => on('paused', () => listener());\n\n/**\n * Mini app được mở lại (trang vẫn giữ nguyên) — làm mới dữ liệu nếu cần.\n * @returns hàm huỷ lắng nghe\n */\nexport const onAppResumed = (listener: () => void): (() => void) => on('resumed', () => listener());\n","import { CONTEXT_EVENT, getState, on } from '../bridge';\nimport type { RouteParams } from '../types';\n\n/**\n * Thông tin conversation lúc mở mini app (đồng bộ, gọi bất cứ lúc nào).\n * @example\n * const { page_id, client_id } = getRouteParams();\n */\nexport const getRouteParams = (): RouteParams => ({ ...getState().context });\n\n/**\n * Mini app đang mở được chuyển sang page / conversation khác (không nạp lại trang).\n * Gọi lại API theo thông tin mới ở đây. Chỉ xảy ra khi `miniapp.config.json` có `context_update: true`.\n * @returns hàm huỷ lắng nghe\n * @example\n * onContextChange(({ page_id, client_id }) => loadData(page_id, client_id));\n */\nexport const onContextChange = (listener: (next: RouteParams, prev: RouteParams) => void): (() => void) =>\n  on(CONTEXT_EVENT, (data) => {\n    const { next, prev } = data as { next: RouteParams; prev: RouteParams };\n    listener(next, prev);\n  });\n","import { call, isInHost } from '../bridge';\nimport { ErrorCode, MiniAppError } from '../errors';\n\n/** Tên query param chứa token khi chạy ngoài app (giống URL iframe hiện tại). */\nconst TOKEN_QUERY_PARAM = 'access_token';\n\nconst readTokenFromUrl = (): string | null => {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  return new URLSearchParams(window.location.search).get(TOKEN_QUERY_PARAM);\n};\n\n/**\n * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).\n * - Trong app: lấy từ host, luôn là token của page hiện tại, host tự refresh.\n * - Ngoài app: đọc `?access_token=` trên URL (như iframe hiện tại).\n * Gọi lại mỗi khi cần — không lưu token lâu phía web.\n */\nexport const getAccessToken = async (): Promise<string> => {\n  if (isInHost()) {\n    return call<string>('getAccessToken');\n  }\n  const token = readTokenFromUrl();\n  if (!token) {\n    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngoài app: thiếu ?${TOKEN_QUERY_PARAM}= trên URL`, 'getAccessToken');\n  }\n  return token;\n};\n\n/** Loại token: `access` luôn được phép; `partner` / `chatbox` cần admin bật quyền trên Console. */\nexport type TokenType = 'access' | 'partner' | 'chatbox';\n\n/** Tên query param tương ứng khi chạy ngoài app (giống URL iframe hiện tại). */\nconst QUERY_PARAM: Record<TokenType, string> = {\n  access: 'access_token',\n  partner: 'partner_token',\n  chatbox: 'chatbox_token',\n};\n\n/**\n * Lấy token theo loại.\n * - `access`: token của mini app cho page hiện tại (= getAccessToken()).\n * - `partner`: token đối tác của page — cần quyền `partner_token`.\n * - `chatbox`: token đăng nhập của người dùng app (toàn quyền) — cần quyền `chatbox_token`.\n * Trong app, chưa được cấp quyền → MiniAppError PERMISSION_DENIED. Ngoài app: đọc query URL.\n */\nexport const getToken = async (type: TokenType): Promise<string> => {\n  if (!(type in QUERY_PARAM)) {\n    throw new MiniAppError(ErrorCode.HOST_ERROR, `Loại token không hợp lệ: ${String(type)}`, 'getToken');\n  }\n  if (isInHost()) {\n    return call<string>('getToken', { type });\n  }\n  const token = typeof window === 'undefined' ? null : new URLSearchParams(window.location.search).get(QUERY_PARAM[type]);\n  if (!token) {\n    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngoài app: thiếu ?${QUERY_PARAM[type]}= trên URL`, 'getToken');\n  }\n  return token;\n};\n","import { getState } from './bridge';\nimport { notifyReady } from './apis/app';\n\nexport { getRouteParams, onContextChange } from './apis/route';\nexport { getAccessToken, getToken, type TokenType } from './apis/user';\nexport { closeApp, onAppPaused, onAppResumed } from './apis/app';\nexport { isInHost } from './bridge';\nexport { MiniAppError, ErrorCode } from './errors';\nexport { SDK_VERSION } from './version';\nexport type { RouteParams } from './types';\n\n// Khởi tạo bridge ngay khi import (host có thể đẩy context trước khi app gọi hàm nào),\n// rồi báo \"ready\" khi DOM sẵn sàng.\nif (typeof window !== 'undefined') {\n  getState();\n  if (document.readyState === 'loading') {\n    document.addEventListener('DOMContentLoaded', notifyReady, { once: true });\n  } else {\n    queueMicrotask(notifyReady);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -24,6 +24,14 @@ interface RouteParams {
  * const { page_id, client_id } = getRouteParams();
  */
 declare const getRouteParams: () => RouteParams;
+/**
+ * Mini app đang mở được chuyển sang page / conversation khác (không nạp lại trang).
+ * Gọi lại API theo thông tin mới ở đây. Chỉ xảy ra khi `miniapp.config.json` có `context_update: true`.
+ * @returns hàm huỷ lắng nghe
+ * @example
+ * onContextChange(({ page_id, client_id }) => loadData(page_id, client_id));
+ */
+declare const onContextChange: (listener: (next: RouteParams, prev: RouteParams) => void) => (() => void);
 
 /**
  * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).
@@ -32,17 +40,39 @@ declare const getRouteParams: () => RouteParams;
  * Gọi lại mỗi khi cần — không lưu token lâu phía web.
  */
 declare const getAccessToken: () => Promise<string>;
+/** Loại token: `access` luôn được phép; `partner` / `chatbox` cần admin bật quyền trên Console. */
+type TokenType = 'access' | 'partner' | 'chatbox';
+/**
+ * Lấy token theo loại.
+ * - `access`: token của mini app cho page hiện tại (= getAccessToken()).
+ * - `partner`: token đối tác của page — cần quyền `partner_token`.
+ * - `chatbox`: token đăng nhập của người dùng app (toàn quyền) — cần quyền `chatbox_token`.
+ * Trong app, chưa được cấp quyền → MiniAppError PERMISSION_DENIED. Ngoài app: đọc query URL.
+ */
+declare const getToken: (type: TokenType) => Promise<string>;
 
 /**
  * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).
  */
 declare const closeApp: () => Promise<void>;
+/**
+ * Mini app bị đóng (ẩn, vẫn chạy ngầm) — dừng polling / timer / video ở đây cho đỡ tốn pin.
+ * @returns hàm huỷ lắng nghe
+ */
+declare const onAppPaused: (listener: () => void) => (() => void);
+/**
+ * Mini app được mở lại (trang vẫn giữ nguyên) — làm mới dữ liệu nếu cần.
+ * @returns hàm huỷ lắng nghe
+ */
+declare const onAppResumed: (listener: () => void) => (() => void);
 
 declare const ErrorCode: {
     /** Không chạy trong app Retion (trình duyệt / iframe cũ). */
     readonly NOT_IN_HOST: "NOT_IN_HOST";
     /** Host không phản hồi trong thời gian chờ. */
     readonly TIMEOUT: "TIMEOUT";
+    /** Mini app chưa được admin cấp quyền (vd lấy partner_token / chatbox_token). */
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
     /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
     readonly NOT_SUPPORTED: "NOT_SUPPORTED";
     /** Lỗi khác phía host. */
@@ -124,4 +154,4 @@ declare const isInHost: () => boolean;
 /** Thay lúc build (tsup define) / test (vitest define) bằng version trong package.json. */
 declare const SDK_VERSION: string;
 
-export { ErrorCode, MiniAppError, type RouteParams, SDK_VERSION, closeApp, getAccessToken, getRouteParams, isInHost };
+export { ErrorCode, MiniAppError, type RouteParams, SDK_VERSION, type TokenType, closeApp, getAccessToken, getRouteParams, getToken, isInHost, onAppPaused, onAppResumed, onContextChange };

package/dist/index.d.ts

@@ -24,6 +24,14 @@ interface RouteParams {
  * const { page_id, client_id } = getRouteParams();
  */
 declare const getRouteParams: () => RouteParams;
+/**
+ * Mini app đang mở được chuyển sang page / conversation khác (không nạp lại trang).
+ * Gọi lại API theo thông tin mới ở đây. Chỉ xảy ra khi `miniapp.config.json` có `context_update: true`.
+ * @returns hàm huỷ lắng nghe
+ * @example
+ * onContextChange(({ page_id, client_id }) => loadData(page_id, client_id));
+ */
+declare const onContextChange: (listener: (next: RouteParams, prev: RouteParams) => void) => (() => void);
 
 /**
  * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).
@@ -32,17 +40,39 @@ declare const getRouteParams: () => RouteParams;
  * Gọi lại mỗi khi cần — không lưu token lâu phía web.
  */
 declare const getAccessToken: () => Promise<string>;
+/** Loại token: `access` luôn được phép; `partner` / `chatbox` cần admin bật quyền trên Console. */
+type TokenType = 'access' | 'partner' | 'chatbox';
+/**
+ * Lấy token theo loại.
+ * - `access`: token của mini app cho page hiện tại (= getAccessToken()).
+ * - `partner`: token đối tác của page — cần quyền `partner_token`.
+ * - `chatbox`: token đăng nhập của người dùng app (toàn quyền) — cần quyền `chatbox_token`.
+ * Trong app, chưa được cấp quyền → MiniAppError PERMISSION_DENIED. Ngoài app: đọc query URL.
+ */
+declare const getToken: (type: TokenType) => Promise<string>;
 
 /**
  * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).
  */
 declare const closeApp: () => Promise<void>;
+/**
+ * Mini app bị đóng (ẩn, vẫn chạy ngầm) — dừng polling / timer / video ở đây cho đỡ tốn pin.
+ * @returns hàm huỷ lắng nghe
+ */
+declare const onAppPaused: (listener: () => void) => (() => void);
+/**
+ * Mini app được mở lại (trang vẫn giữ nguyên) — làm mới dữ liệu nếu cần.
+ * @returns hàm huỷ lắng nghe
+ */
+declare const onAppResumed: (listener: () => void) => (() => void);
 
 declare const ErrorCode: {
     /** Không chạy trong app Retion (trình duyệt / iframe cũ). */
     readonly NOT_IN_HOST: "NOT_IN_HOST";
     /** Host không phản hồi trong thời gian chờ. */
     readonly TIMEOUT: "TIMEOUT";
+    /** Mini app chưa được admin cấp quyền (vd lấy partner_token / chatbox_token). */
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
     /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
     readonly NOT_SUPPORTED: "NOT_SUPPORTED";
     /** Lỗi khác phía host. */
@@ -124,4 +154,4 @@ declare const isInHost: () => boolean;
 /** Thay lúc build (tsup define) / test (vitest define) bằng version trong package.json. */
 declare const SDK_VERSION: string;
 
-export { ErrorCode, MiniAppError, type RouteParams, SDK_VERSION, closeApp, getAccessToken, getRouteParams, isInHost };
+export { ErrorCode, MiniAppError, type RouteParams, SDK_VERSION, type TokenType, closeApp, getAccessToken, getRouteParams, getToken, isInHost, onAppPaused, onAppResumed, onContextChange };

package/dist/index.js

@@ -4,6 +4,8 @@ var ErrorCode = {
   NOT_IN_HOST: "NOT_IN_HOST",
   /** Host không phản hồi trong thời gian chờ. */
   TIMEOUT: "TIMEOUT",
+  /** Mini app chưa được admin cấp quyền (vd lấy partner_token / chatbox_token). */
+  PERMISSION_DENIED: "PERMISSION_DENIED",
   /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
   NOT_SUPPORTED: "NOT_SUPPORTED",
   /** Lỗi khác phía host. */
@@ -60,8 +62,12 @@ var createState = () => {
       if ("event" in message) {
         if (message.event === CONTEXT_EVENT) {
           const prev = state.context;
-          state.context = { ...prev, ...message.data };
-          emit(state, CONTEXT_EVENT, { next: { ...state.context }, prev });
+          const next = { ...prev, ...message.data };
+          if (JSON.stringify(next) === JSON.stringify(prev)) {
+            return;
+          }
+          state.context = next;
+          emit(state, CONTEXT_EVENT, { next: { ...next }, prev });
           return;
         }
         emit(state, message.event, message.data);
@@ -127,16 +133,34 @@ var notify = (method, params) => {
     post({ __retion: PROTOCOL_VERSION, method, params });
   }
 };
+var on = (event, listener) => {
+  const { listeners } = getState();
+  let set = listeners.get(event);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(event, set);
+  }
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+};
 
 // src/version.ts
-var SDK_VERSION = "0.2.0" ;
+var SDK_VERSION = "0.4.0" ;
 
 // src/apis/app.ts
 var closeApp = () => call("closeApp");
 var notifyReady = () => notify("ready", { sdkVersion: SDK_VERSION });
+var onAppPaused = (listener) => on("paused", () => listener());
+var onAppResumed = (listener) => on("resumed", () => listener());
 
 // src/apis/route.ts
 var getRouteParams = () => ({ ...getState().context });
+var onContextChange = (listener) => on(CONTEXT_EVENT, (data) => {
+  const { next, prev } = data;
+  listener(next, prev);
+});
 
 // src/apis/user.ts
 var TOKEN_QUERY_PARAM = "access_token";
@@ -156,6 +180,24 @@ var getAccessToken = async () => {
   }
   return token;
 };
+var QUERY_PARAM = {
+  access: "access_token",
+  partner: "partner_token",
+  chatbox: "chatbox_token"
+};
+var getToken = async (type) => {
+  if (!(type in QUERY_PARAM)) {
+    throw new MiniAppError(ErrorCode.HOST_ERROR, `Lo\u1EA1i token kh\xF4ng h\u1EE3p l\u1EC7: ${String(type)}`, "getToken");
+  }
+  if (isInHost()) {
+    return call("getToken", { type });
+  }
+  const token = typeof window === "undefined" ? null : new URLSearchParams(window.location.search).get(QUERY_PARAM[type]);
+  if (!token) {
+    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngo\xE0i app: thi\u1EBFu ?${QUERY_PARAM[type]}= tr\xEAn URL`, "getToken");
+  }
+  return token;
+};
 
 // src/index.ts
 if (typeof window !== "undefined") {
@@ -167,6 +209,6 @@ if (typeof window !== "undefined") {
   }
 }
 
-export { ErrorCode, MiniAppError, SDK_VERSION, closeApp, getAccessToken, getRouteParams, isInHost };
+export { ErrorCode, MiniAppError, SDK_VERSION, closeApp, getAccessToken, getRouteParams, getToken, isInHost, onAppPaused, onAppResumed, onContextChange };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/bridge.ts","../src/version.ts","../src/apis/app.ts","../src/apis/route.ts","../src/apis/user.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const ErrorCode = {\n  /** Không chạy trong app Retion (trình duyệt / iframe cũ). */\n  NOT_IN_HOST: 'NOT_IN_HOST',\n  /** Host không phản hồi trong thời gian chờ. */\n  TIMEOUT: 'TIMEOUT',\n  /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */\n  NOT_SUPPORTED: 'NOT_SUPPORTED',\n  /** Lỗi khác phía host. */\n  HOST_ERROR: 'HOST_ERROR',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode] | (string & {});\n\nexport class MiniAppError extends Error {\n  readonly code: ErrorCode;\n  readonly method?: string;\n\n  constructor(code: ErrorCode, message: string, method?: string) {\n    super(message);\n    this.name = 'MiniAppError';\n    this.code = code;\n    this.method = method;\n  }\n\n  /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */\n  static from(error: unknown, method?: string): MiniAppError {\n    if (error instanceof MiniAppError) {\n      return error;\n    }\n    if (error && typeof error === 'object') {\n      const { code, message } = error as { code?: unknown; message?: unknown };\n      return new MiniAppError(\n        typeof code === 'string' ? code : ErrorCode.HOST_ERROR,\n        typeof message === 'string' ? message : 'Unknown error',\n        method,\n      );\n    }\n    return new MiniAppError(ErrorCode.HOST_ERROR, String(error), method);\n  }\n}\n","/**\n * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.\n *\n * Giao thức v1\n *  web → host : ReactNativeWebView.postMessage(JSON.stringify(RequestMessage))\n *  host → web : window.__RETION_MINIAPP__.receive(ResponseMessage | EventMessage)\n *  host inject trước khi trang chạy:\n *    window.__RETION_MINIAPP_HOST__    = { protocol }  ← đánh dấu host hỗ trợ SDK\n *    window.__RETION_MINIAPP_CONTEXT__ = RouteParams    ← context ban đầu\n *\n * Chỉ có ReactNativeWebView KHÔNG đủ để coi là host: màn iframe cũ của app cũng là RN WebView\n * nhưng không hiểu giao thức này (gọi API sẽ treo tới timeout). Thiếu marker → NOT_IN_HOST ngay.\n *\n * State đặt trên window (singleton): nhiều bản SDK trong cùng trang (trùng version trong\n * node_modules) vẫn dùng chung 1 bridge thay vì ghi đè hàm receive của nhau.\n */\nimport { ErrorCode, MiniAppError } from './errors';\nimport type { RouteParams } from './types';\n\nexport const PROTOCOL_VERSION = 1;\nexport const DEFAULT_TIMEOUT_MS = 15_000;\nexport const CONTEXT_EVENT = 'context';\n\nexport interface RequestMessage {\n  __retion: typeof PROTOCOL_VERSION;\n  /** Có id → host phải trả ResponseMessage. Không có → lệnh 1 chiều. */\n  id?: string;\n  method: string;\n  params?: unknown;\n}\n\nexport type ResponseMessage =\n  | { id: string; result?: unknown; error?: undefined }\n  | { id: string; error: { code: string; message: string } };\n\nexport interface EventMessage {\n  event: string;\n  data?: unknown;\n}\n\nexport interface HostInfo {\n  /** Phiên bản giao thức host hỗ trợ. */\n  protocol: number;\n}\n\ntype Listener = (data: unknown) => void;\n\ninterface Pending {\n  method: string;\n  resolve: (value: unknown) => void;\n  reject: (error: MiniAppError) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\ninterface BridgeState {\n  protocol: number;\n  seq: number;\n  pending: Map<string, Pending>;\n  listeners: Map<string, Set<Listener>>;\n  context: RouteParams;\n  receive: (message: ResponseMessage | EventMessage) => void;\n}\n\ndeclare global {\n  interface Window {\n    ReactNativeWebView?: { postMessage: (message: string) => void };\n    __RETION_MINIAPP__?: BridgeState;\n    __RETION_MINIAPP_CONTEXT__?: RouteParams;\n    __RETION_MINIAPP_HOST__?: HostInfo;\n  }\n}\n\nconst hasWindow = typeof window !== 'undefined';\n\nconst readInitialContext = (): RouteParams => {\n  if (!hasWindow) {\n    return {};\n  }\n  const query = Object.fromEntries(new URLSearchParams(window.location.search));\n  return { ...query, ...(window.__RETION_MINIAPP_CONTEXT__ ?? {}) };\n};\n\nconst createState = (): BridgeState => {\n  const state: BridgeState = {\n    protocol: PROTOCOL_VERSION,\n    seq: 0,\n    pending: new Map(),\n    listeners: new Map(),\n    context: readInitialContext(),\n    receive: (message) => {\n      if (!message || typeof message !== 'object') {\n        return;\n      }\n      if ('event' in message) {\n        if (message.event === CONTEXT_EVENT) {\n          // Cập nhật context TRƯỚC khi emit → getRouteParams() luôn đúng, kể cả không ai lắng nghe.\n          const prev = state.context;\n          state.context = { ...prev, ...(message.data as RouteParams) };\n          emit(state, CONTEXT_EVENT, { next: { ...state.context }, prev });\n          return;\n        }\n        emit(state, message.event, message.data);\n        return;\n      }\n      const pending = state.pending.get(message.id);\n      if (!pending) {\n        return;\n      }\n      state.pending.delete(message.id);\n      clearTimeout(pending.timer);\n      if (message.error) {\n        pending.reject(MiniAppError.from(message.error, pending.method));\n      } else {\n        pending.resolve(message.result);\n      }\n    },\n  };\n  return state;\n};\n\nconst emit = (state: BridgeState, event: string, data: unknown) => {\n  state.listeners.get(event)?.forEach((listener) => {\n    try {\n      listener(data);\n    } catch (error) {\n      console.error(`[retion-miniapp] listener \"${event}\" lỗi`, error);\n    }\n  });\n};\n\nlet fallback_state: BridgeState | null = null;\n\n/** @internal */\nexport const getState = (): BridgeState => {\n  if (!hasWindow) {\n    return (fallback_state ??= createState());\n  }\n  return (window.__RETION_MINIAPP__ ??= createState());\n};\n\n/** Đang chạy trong app Retion có hỗ trợ SDK (host đã inject marker + kênh postMessage). */\nexport const isInHost = (): boolean =>\n  hasWindow &&\n  typeof window.__RETION_MINIAPP_HOST__?.protocol === 'number' &&\n  typeof window.ReactNativeWebView?.postMessage === 'function';\n\nconst post = (message: RequestMessage) => {\n  window.ReactNativeWebView!.postMessage(JSON.stringify(message));\n};\n\n/** Gửi lệnh lên host và chờ kết quả. Ngoài app → reject NOT_IN_HOST. */\nexport const call = <T>(method: string, params?: unknown, timeout_ms = DEFAULT_TIMEOUT_MS): Promise<T> => {\n  const state = getState();\n\n  if (!isInHost()) {\n    return Promise.reject(new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} chỉ chạy trong app Retion`, method));\n  }\n\n  const id = `${Date.now().toString(36)}-${++state.seq}`;\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      state.pending.delete(id);\n      reject(new MiniAppError(ErrorCode.TIMEOUT, `${method}: host không phản hồi sau ${timeout_ms}ms`, method));\n    }, timeout_ms);\n    state.pending.set(id, { method, resolve: resolve as (v: unknown) => void, reject, timer });\n    post({ __retion: PROTOCOL_VERSION, id, method, params });\n  });\n};\n\n/** Lệnh 1 chiều (không chờ kết quả). Ngoài app: bỏ qua. */\nexport const notify = (method: string, params?: unknown): void => {\n  if (isInHost()) {\n    post({ __retion: PROTOCOL_VERSION, method, params });\n  }\n};\n\n/** Lắng nghe event host đẩy xuống. Trả về hàm huỷ. */\nexport const on = (event: string, listener: Listener): (() => void) => {\n  const { listeners } = getState();\n  let set = listeners.get(event);\n  if (!set) {\n    set = new Set();\n    listeners.set(event, set);\n  }\n  set.add(listener);\n  return () => {\n    set.delete(listener);\n  };\n};\n","declare const __SDK_VERSION__: string;\n\n/** Thay lúc build (tsup define) / test (vitest define) bằng version trong package.json. */\nexport const SDK_VERSION: string = typeof __SDK_VERSION__ === 'string' ? __SDK_VERSION__ : '0.0.0-dev';\n","import { call, notify } from '../bridge';\nimport { SDK_VERSION } from '../version';\n\n/**\n * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).\n */\nexport const closeApp = (): Promise<void> => call<void>('closeApp');\n\n/** @internal SDK tự gọi khi trang sẵn sàng — host ẩn splash + đẩy context mới nhất. */\nexport const notifyReady = (): void => notify('ready', { sdkVersion: SDK_VERSION });\n","import { getState } from '../bridge';\nimport type { RouteParams } from '../types';\n\n/**\n * Thông tin conversation lúc mở mini app (đồng bộ, gọi bất cứ lúc nào).\n * @example\n * const { page_id, client_id } = getRouteParams();\n */\nexport const getRouteParams = (): RouteParams => ({ ...getState().context });\n","import { call, isInHost } from '../bridge';\nimport { ErrorCode, MiniAppError } from '../errors';\n\n/** Tên query param chứa token khi chạy ngoài app (giống URL iframe hiện tại). */\nconst TOKEN_QUERY_PARAM = 'access_token';\n\nconst readTokenFromUrl = (): string | null => {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  return new URLSearchParams(window.location.search).get(TOKEN_QUERY_PARAM);\n};\n\n/**\n * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).\n * - Trong app: lấy từ host, luôn là token của page hiện tại, host tự refresh.\n * - Ngoài app: đọc `?access_token=` trên URL (như iframe hiện tại).\n * Gọi lại mỗi khi cần — không lưu token lâu phía web.\n */\nexport const getAccessToken = async (): Promise<string> => {\n  if (isInHost()) {\n    return call<string>('getAccessToken');\n  }\n  const token = readTokenFromUrl();\n  if (!token) {\n    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngoài app: thiếu ?${TOKEN_QUERY_PARAM}= trên URL`, 'getAccessToken');\n  }\n  return token;\n};\n","import { getState } from './bridge';\nimport { notifyReady } from './apis/app';\n\nexport { getRouteParams } from './apis/route';\nexport { getAccessToken } from './apis/user';\nexport { closeApp } from './apis/app';\nexport { isInHost } from './bridge';\nexport { MiniAppError, ErrorCode } from './errors';\nexport { SDK_VERSION } from './version';\nexport type { RouteParams } from './types';\n\n// Khởi tạo bridge ngay khi import (host có thể đẩy context trước khi app gọi hàm nào),\n// rồi báo \"ready\" khi DOM sẵn sàng.\nif (typeof window !== 'undefined') {\n  getState();\n  if (document.readyState === 'loading') {\n    document.addEventListener('DOMContentLoaded', notifyReady, { once: true });\n  } else {\n    queueMicrotask(notifyReady);\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/bridge.ts","../src/version.ts","../src/apis/app.ts","../src/apis/route.ts","../src/apis/user.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const ErrorCode = {\n  /** Không chạy trong app Retion (trình duyệt / iframe cũ). */\n  NOT_IN_HOST: 'NOT_IN_HOST',\n  /** Host không phản hồi trong thời gian chờ. */\n  TIMEOUT: 'TIMEOUT',\n  /** Mini app chưa được admin cấp quyền (vd lấy partner_token / chatbox_token). */\n  PERMISSION_DENIED: 'PERMISSION_DENIED',\n  /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */\n  NOT_SUPPORTED: 'NOT_SUPPORTED',\n  /** Lỗi khác phía host. */\n  HOST_ERROR: 'HOST_ERROR',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode] | (string & {});\n\nexport class MiniAppError extends Error {\n  readonly code: ErrorCode;\n  readonly method?: string;\n\n  constructor(code: ErrorCode, message: string, method?: string) {\n    super(message);\n    this.name = 'MiniAppError';\n    this.code = code;\n    this.method = method;\n  }\n\n  /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */\n  static from(error: unknown, method?: string): MiniAppError {\n    if (error instanceof MiniAppError) {\n      return error;\n    }\n    if (error && typeof error === 'object') {\n      const { code, message } = error as { code?: unknown; message?: unknown };\n      return new MiniAppError(\n        typeof code === 'string' ? code : ErrorCode.HOST_ERROR,\n        typeof message === 'string' ? message : 'Unknown error',\n        method,\n      );\n    }\n    return new MiniAppError(ErrorCode.HOST_ERROR, String(error), method);\n  }\n}\n","/**\n * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.\n *\n * Giao thức v1\n *  web → host : ReactNativeWebView.postMessage(JSON.stringify(RequestMessage))\n *  host → web : window.__RETION_MINIAPP__.receive(ResponseMessage | EventMessage)\n *  host inject trước khi trang chạy:\n *    window.__RETION_MINIAPP_HOST__    = { protocol }  ← đánh dấu host hỗ trợ SDK\n *    window.__RETION_MINIAPP_CONTEXT__ = RouteParams    ← context ban đầu\n *\n * Chỉ có ReactNativeWebView KHÔNG đủ để coi là host: màn iframe cũ của app cũng là RN WebView\n * nhưng không hiểu giao thức này (gọi API sẽ treo tới timeout). Thiếu marker → NOT_IN_HOST ngay.\n *\n * State đặt trên window (singleton): nhiều bản SDK trong cùng trang (trùng version trong\n * node_modules) vẫn dùng chung 1 bridge thay vì ghi đè hàm receive của nhau.\n */\nimport { ErrorCode, MiniAppError } from './errors';\nimport type { RouteParams } from './types';\n\nexport const PROTOCOL_VERSION = 1;\nexport const DEFAULT_TIMEOUT_MS = 15_000;\nexport const CONTEXT_EVENT = 'context';\n\nexport interface RequestMessage {\n  __retion: typeof PROTOCOL_VERSION;\n  /** Có id → host phải trả ResponseMessage. Không có → lệnh 1 chiều. */\n  id?: string;\n  method: string;\n  params?: unknown;\n}\n\nexport type ResponseMessage =\n  | { id: string; result?: unknown; error?: undefined }\n  | { id: string; error: { code: string; message: string } };\n\nexport interface EventMessage {\n  event: string;\n  data?: unknown;\n}\n\nexport interface HostInfo {\n  /** Phiên bản giao thức host hỗ trợ. */\n  protocol: number;\n}\n\ntype Listener = (data: unknown) => void;\n\ninterface Pending {\n  method: string;\n  resolve: (value: unknown) => void;\n  reject: (error: MiniAppError) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\ninterface BridgeState {\n  protocol: number;\n  seq: number;\n  pending: Map<string, Pending>;\n  listeners: Map<string, Set<Listener>>;\n  context: RouteParams;\n  receive: (message: ResponseMessage | EventMessage) => void;\n}\n\ndeclare global {\n  interface Window {\n    ReactNativeWebView?: { postMessage: (message: string) => void };\n    __RETION_MINIAPP__?: BridgeState;\n    __RETION_MINIAPP_CONTEXT__?: RouteParams;\n    __RETION_MINIAPP_HOST__?: HostInfo;\n  }\n}\n\nconst hasWindow = typeof window !== 'undefined';\n\nconst readInitialContext = (): RouteParams => {\n  if (!hasWindow) {\n    return {};\n  }\n  const query = Object.fromEntries(new URLSearchParams(window.location.search));\n  return { ...query, ...(window.__RETION_MINIAPP_CONTEXT__ ?? {}) };\n};\n\nconst createState = (): BridgeState => {\n  const state: BridgeState = {\n    protocol: PROTOCOL_VERSION,\n    seq: 0,\n    pending: new Map(),\n    listeners: new Map(),\n    context: readInitialContext(),\n    receive: (message) => {\n      if (!message || typeof message !== 'object') {\n        return;\n      }\n      if ('event' in message) {\n        if (message.event === CONTEXT_EVENT) {\n          // Cập nhật context TRƯỚC khi emit → getRouteParams() luôn đúng, kể cả không ai lắng nghe.\n          const prev = state.context;\n          const next = { ...prev, ...(message.data as RouteParams) };\n          // Host đẩy lại context lúc \"ready\" dù không đổi → không báo onContextChange thừa.\n          if (JSON.stringify(next) === JSON.stringify(prev)) {\n            return;\n          }\n          state.context = next;\n          emit(state, CONTEXT_EVENT, { next: { ...next }, prev });\n          return;\n        }\n        emit(state, message.event, message.data);\n        return;\n      }\n      const pending = state.pending.get(message.id);\n      if (!pending) {\n        return;\n      }\n      state.pending.delete(message.id);\n      clearTimeout(pending.timer);\n      if (message.error) {\n        pending.reject(MiniAppError.from(message.error, pending.method));\n      } else {\n        pending.resolve(message.result);\n      }\n    },\n  };\n  return state;\n};\n\nconst emit = (state: BridgeState, event: string, data: unknown) => {\n  state.listeners.get(event)?.forEach((listener) => {\n    try {\n      listener(data);\n    } catch (error) {\n      console.error(`[retion-miniapp] listener \"${event}\" lỗi`, error);\n    }\n  });\n};\n\nlet fallback_state: BridgeState | null = null;\n\n/** @internal */\nexport const getState = (): BridgeState => {\n  if (!hasWindow) {\n    return (fallback_state ??= createState());\n  }\n  return (window.__RETION_MINIAPP__ ??= createState());\n};\n\n/** Đang chạy trong app Retion có hỗ trợ SDK (host đã inject marker + kênh postMessage). */\nexport const isInHost = (): boolean =>\n  hasWindow &&\n  typeof window.__RETION_MINIAPP_HOST__?.protocol === 'number' &&\n  typeof window.ReactNativeWebView?.postMessage === 'function';\n\nconst post = (message: RequestMessage) => {\n  window.ReactNativeWebView!.postMessage(JSON.stringify(message));\n};\n\n/** Gửi lệnh lên host và chờ kết quả. Ngoài app → reject NOT_IN_HOST. */\nexport const call = <T>(method: string, params?: unknown, timeout_ms = DEFAULT_TIMEOUT_MS): Promise<T> => {\n  const state = getState();\n\n  if (!isInHost()) {\n    return Promise.reject(new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} chỉ chạy trong app Retion`, method));\n  }\n\n  const id = `${Date.now().toString(36)}-${++state.seq}`;\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      state.pending.delete(id);\n      reject(new MiniAppError(ErrorCode.TIMEOUT, `${method}: host không phản hồi sau ${timeout_ms}ms`, method));\n    }, timeout_ms);\n    state.pending.set(id, { method, resolve: resolve as (v: unknown) => void, reject, timer });\n    post({ __retion: PROTOCOL_VERSION, id, method, params });\n  });\n};\n\n/** Lệnh 1 chiều (không chờ kết quả). Ngoài app: bỏ qua. */\nexport const notify = (method: string, params?: unknown): void => {\n  if (isInHost()) {\n    post({ __retion: PROTOCOL_VERSION, method, params });\n  }\n};\n\n/** Lắng nghe event host đẩy xuống. Trả về hàm huỷ. */\nexport const on = (event: string, listener: Listener): (() => void) => {\n  const { listeners } = getState();\n  let set = listeners.get(event);\n  if (!set) {\n    set = new Set();\n    listeners.set(event, set);\n  }\n  set.add(listener);\n  return () => {\n    set.delete(listener);\n  };\n};\n","declare const __SDK_VERSION__: string;\n\n/** Thay lúc build (tsup define) / test (vitest define) bằng version trong package.json. */\nexport const SDK_VERSION: string = typeof __SDK_VERSION__ === 'string' ? __SDK_VERSION__ : '0.0.0-dev';\n","import { call, notify, on } from '../bridge';\nimport { SDK_VERSION } from '../version';\n\n/**\n * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).\n */\nexport const closeApp = (): Promise<void> => call<void>('closeApp');\n\n/** @internal SDK tự gọi khi trang sẵn sàng — host ẩn splash + đẩy context mới nhất. */\nexport const notifyReady = (): void => notify('ready', { sdkVersion: SDK_VERSION });\n\n/**\n * Mini app bị đóng (ẩn, vẫn chạy ngầm) — dừng polling / timer / video ở đây cho đỡ tốn pin.\n * @returns hàm huỷ lắng nghe\n */\nexport const onAppPaused = (listener: () => void): (() => void) => on('paused', () => listener());\n\n/**\n * Mini app được mở lại (trang vẫn giữ nguyên) — làm mới dữ liệu nếu cần.\n * @returns hàm huỷ lắng nghe\n */\nexport const onAppResumed = (listener: () => void): (() => void) => on('resumed', () => listener());\n","import { CONTEXT_EVENT, getState, on } from '../bridge';\nimport type { RouteParams } from '../types';\n\n/**\n * Thông tin conversation lúc mở mini app (đồng bộ, gọi bất cứ lúc nào).\n * @example\n * const { page_id, client_id } = getRouteParams();\n */\nexport const getRouteParams = (): RouteParams => ({ ...getState().context });\n\n/**\n * Mini app đang mở được chuyển sang page / conversation khác (không nạp lại trang).\n * Gọi lại API theo thông tin mới ở đây. Chỉ xảy ra khi `miniapp.config.json` có `context_update: true`.\n * @returns hàm huỷ lắng nghe\n * @example\n * onContextChange(({ page_id, client_id }) => loadData(page_id, client_id));\n */\nexport const onContextChange = (listener: (next: RouteParams, prev: RouteParams) => void): (() => void) =>\n  on(CONTEXT_EVENT, (data) => {\n    const { next, prev } = data as { next: RouteParams; prev: RouteParams };\n    listener(next, prev);\n  });\n","import { call, isInHost } from '../bridge';\nimport { ErrorCode, MiniAppError } from '../errors';\n\n/** Tên query param chứa token khi chạy ngoài app (giống URL iframe hiện tại). */\nconst TOKEN_QUERY_PARAM = 'access_token';\n\nconst readTokenFromUrl = (): string | null => {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  return new URLSearchParams(window.location.search).get(TOKEN_QUERY_PARAM);\n};\n\n/**\n * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).\n * - Trong app: lấy từ host, luôn là token của page hiện tại, host tự refresh.\n * - Ngoài app: đọc `?access_token=` trên URL (như iframe hiện tại).\n * Gọi lại mỗi khi cần — không lưu token lâu phía web.\n */\nexport const getAccessToken = async (): Promise<string> => {\n  if (isInHost()) {\n    return call<string>('getAccessToken');\n  }\n  const token = readTokenFromUrl();\n  if (!token) {\n    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngoài app: thiếu ?${TOKEN_QUERY_PARAM}= trên URL`, 'getAccessToken');\n  }\n  return token;\n};\n\n/** Loại token: `access` luôn được phép; `partner` / `chatbox` cần admin bật quyền trên Console. */\nexport type TokenType = 'access' | 'partner' | 'chatbox';\n\n/** Tên query param tương ứng khi chạy ngoài app (giống URL iframe hiện tại). */\nconst QUERY_PARAM: Record<TokenType, string> = {\n  access: 'access_token',\n  partner: 'partner_token',\n  chatbox: 'chatbox_token',\n};\n\n/**\n * Lấy token theo loại.\n * - `access`: token của mini app cho page hiện tại (= getAccessToken()).\n * - `partner`: token đối tác của page — cần quyền `partner_token`.\n * - `chatbox`: token đăng nhập của người dùng app (toàn quyền) — cần quyền `chatbox_token`.\n * Trong app, chưa được cấp quyền → MiniAppError PERMISSION_DENIED. Ngoài app: đọc query URL.\n */\nexport const getToken = async (type: TokenType): Promise<string> => {\n  if (!(type in QUERY_PARAM)) {\n    throw new MiniAppError(ErrorCode.HOST_ERROR, `Loại token không hợp lệ: ${String(type)}`, 'getToken');\n  }\n  if (isInHost()) {\n    return call<string>('getToken', { type });\n  }\n  const token = typeof window === 'undefined' ? null : new URLSearchParams(window.location.search).get(QUERY_PARAM[type]);\n  if (!token) {\n    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngoài app: thiếu ?${QUERY_PARAM[type]}= trên URL`, 'getToken');\n  }\n  return token;\n};\n","import { getState } from './bridge';\nimport { notifyReady } from './apis/app';\n\nexport { getRouteParams, onContextChange } from './apis/route';\nexport { getAccessToken, getToken, type TokenType } from './apis/user';\nexport { closeApp, onAppPaused, onAppResumed } from './apis/app';\nexport { isInHost } from './bridge';\nexport { MiniAppError, ErrorCode } from './errors';\nexport { SDK_VERSION } from './version';\nexport type { RouteParams } from './types';\n\n// Khởi tạo bridge ngay khi import (host có thể đẩy context trước khi app gọi hàm nào),\n// rồi báo \"ready\" khi DOM sẵn sàng.\nif (typeof window !== 'undefined') {\n  getState();\n  if (document.readyState === 'loading') {\n    document.addEventListener('DOMContentLoaded', notifyReady, { once: true });\n  } else {\n    queueMicrotask(notifyReady);\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retion-miniapp/sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Retion Mini App SDK — kết nối web mini app với app Retion",
   "keywords": [
     "retion",