@retion-miniapp/sdk 0.1.0 → 0.3.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/invoke.ts","../src/version.ts","../src/apis/app.ts","../src/apis/user.ts","../src/apis/page.ts","../src/apis/chat.ts","../src/apis/dev.ts","../src/index.ts"],"names":["call","MiniAppError","ErrorCode","isInHost","notify","getState"],"mappings":";;;;;AASO,IAAM,MAAA,GAAS,CAAI,MAAA,EAAgB,MAAA,EAAkB,OAAA,KAA6C;AACvG,EAAA,MAAM,OAAA,GAAUA,sBAAA,CAAQ,MAAA,EAAQ,MAAM,CAAA;AACtC,EAAA,IAAA,CAAI,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,OAAA,MAAW,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,IAAA,CAAA,EAAM;AACrC,IAAA,OAAA,CAAQ,IAAA,CAAK,OAAA,CAAQ,OAAA,EAAS,CAAC,KAAA,KAAgB;AAZnD,MAAA,IAAA,EAAA;AAYsD,MAAA,OAAA,CAAA,EAAA,GAAA,OAAA,CAAQ,IAAA,KAAR,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,OAAA,EAAeC,8BAAA,CAAa,IAAA,CAAK,OAAO,MAAM,CAAA,CAAA;AAAA,IAAA,CAAE,CAAA;AAAA,EACpG;AACA,EAAA,OAAO,OAAA;AACT,CAAA;AAGO,IAAM,YAAA,GAAe,CAC1B,OAAA,KAC4D;AAC5D,EAAA,MAAM,EAAE,OAAA,EAAS,IAAA,EAAM,GAAG,QAAO,GAAI,OAAA;AACrC,EAAA,OAAO,CAAC,MAAA,EAAQ,EAAE,OAAA,EAAS,MAAM,CAAA;AACnC,CAAA;;;ACpBO,IAAM,WAAA,GAA4D,OAAA;;;ACIlE,IAAM,WAAW,CAAC,OAAA,KAAmD,MAAA,CAAO,UAAA,EAAY,QAAW,OAAO;AAG1G,IAAM,WAAA,GAAc,CAAC,OAAA,KAAoE;AAVhG,EAAA,IAAA,EAAA,EAAA,EAAA;AAWE,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,aAAa,OAAO,CAAA;AAChD,EAAA,IAAI,CAAC,eAAA,CAAgB,IAAA,CAAA,CAAK,YAAO,GAAA,KAAP,IAAA,GAAA,EAAA,GAAc,EAAE,CAAA,EAAG;AAC3C,IAAA,MAAM,QAAQ,IAAIA,8BAAA,CAAaC,2BAAA,CAAU,cAAA,EAAgB,6EAA+C,aAAa,CAAA;AACrH,IAAA,CAAA,EAAA,GAAA,SAAA,CAAU,SAAV,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,SAAA,EAAiB,KAAA,CAAA;AACjB,IAAA,OAAO,OAAA,CAAQ,OAAO,KAAK,CAAA;AAAA,EAC7B;AACA,EAAA,OAAO,MAAA,CAAO,aAAA,EAAe,MAAA,EAAQ,SAAS,CAAA;AAChD;AAGO,IAAM,SAAA,GAAY,CAAC,OAAA,KAAwE;AAChG,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,aAAa,OAAO,CAAA;AAChD,EAAA,OAAO,MAAA,CAAO,WAAA,EAAa,MAAA,EAAQ,SAAS,CAAA;AAC9C;AAGO,IAAM,aAAA,GAAgB,OAAO,OAAA,KAA+D;AA3BnG,EAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AA4BE,EAAA,MAAM,IAAA,GAAmB,EAAE,QAAA,EAAU,KAAA,EAAO,YAAY,WAAA,EAAa,MAAA,EAAQC,4BAAS,EAAE;AACxF,EAAA,IAAI,CAACA,4BAAS,EAAG;AACf,IAAA,CAAA,EAAA,GAAA,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,YAAT,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,OAAA,EAAmB,IAAA,CAAA;AACnB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAA4B,eAAe,CAAA;AAC9D,IAAA,MAAM,MAAA,GAAqB,EAAE,GAAG,IAAA,EAAM,GAAG,IAAA,EAAM,UAAA,EAAY,WAAA,EAAa,MAAA,EAAQ,IAAA,EAAK;AACrF,IAAA,CAAA,EAAA,GAAA,OAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAS,YAAT,IAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,IAAA,CAAA,OAAA,EAAmB,MAAA,CAAA;AACnB,IAAA,OAAO,MAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,UAAA,GAAaF,8BAAA,CAAa,IAAA,CAAK,KAAA,EAAO,eAAe,CAAA;AAC3D,IAAA,CAAA,EAAA,GAAA,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,SAAT,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,OAAA,EAAgB,UAAA,CAAA;AAChB,IAAA,MAAM,UAAA;AAAA,EACR;AACF;AAGO,IAAM,cAAc,MAAYG,wBAAA,CAAO,SAAS,EAAE,UAAA,EAAY,aAAa,CAAA;;;ACvC3E,IAAM,iBAAiB,CAAC,OAAA,KAC7B,MAAA,CAAO,gBAAA,EAAkB,QAAW,OAAO;AAGtC,IAAM,cAAc,CAAC,OAAA,KAC1B,MAAA,CAAO,aAAA,EAAe,QAAW,OAAO;;;ACLnC,IAAM,cAAc,CAAC,OAAA,KAC1B,MAAA,CAAO,aAAA,EAAe,QAAW,OAAO;;;ACF1C,IAAM,QAAA,GAAW,CAAC,MAAA,EAAgB,OAAA,KAAwC;AAN1E,EAAA,IAAA,EAAA;AAOE,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,aAAa,OAAO,CAAA;AAChD,EAAA,IAAI,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,CAAC,MAAA,CAAO,IAAA,CAAK,MAAK,EAAG;AAC1D,IAAA,MAAM,QAAQ,IAAIH,8BAAA,CAAaC,2BAAA,CAAU,cAAA,EAAgB,+CAAwB,MAAM,CAAA;AACvF,IAAA,CAAA,EAAA,GAAA,SAAA,CAAU,SAAV,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,SAAA,EAAiB,KAAA,CAAA;AACjB,IAAA,OAAO,OAAA,CAAQ,OAAO,KAAK,CAAA;AAAA,EAC7B;AACA,EAAA,OAAO,MAAA,CAAO,MAAA,EAAQ,MAAA,EAAQ,SAAS,CAAA;AACzC,CAAA;AAGO,IAAM,WAAA,GAAc,CAAC,OAAA,KAAwC,QAAA,CAAS,eAAe,OAAO;AAG5F,IAAM,UAAA,GAAa,CAAC,OAAA,KAAwC,QAAA,CAAS,cAAc,OAAO;;;ACV1F,IAAM,cAAA,GAAiB,CAAC,OAAA,KAAsC;AACnE,EAAAG,0BAAA,GAAW,IAAA,GAAO,OAAA;AACpB;;;ACKA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,EAAAA,0BAAA,EAAS;AACT,EAAA,IAAI,QAAA,CAAS,eAAe,SAAA,EAAW;AACrC,IAAA,QAAA,CAAS,iBAAiB,kBAAA,EAAoB,WAAA,EAAa,EAAE,IAAA,EAAM,MAAM,CAAA;AAAA,EAC3E,CAAA,MAAO;AACL,IAAA,cAAA,CAAe,WAAW,CAAA;AAAA,EAC5B;AACF","file":"index.cjs","sourcesContent":["import { call } from './bridge';\nimport { MiniAppError } from './errors';\nimport type { CallbackOptions } from './types';\n\n/**\n * Gọi API host, hỗ trợ cả 2 kiểu: `await api()` và `api({ success, fail })`.\n * Có callback `fail` → promise vẫn reject (người dùng await vẫn bắt được), nhưng không gây\n * \"unhandled rejection\" khi họ chỉ dùng callback.\n */\nexport const invoke = <T>(method: string, params?: unknown, options?: CallbackOptions<T>): Promise<T> => {\n  const promise = call<T>(method, params);\n  if (options?.success || options?.fail) {\n    promise.then(options.success, (error: unknown) => options.fail?.(MiniAppError.from(error, method)));\n  }\n  return promise;\n};\n\n/** Tách callback ra khỏi object tham số: `{ url, success, fail }` → `[{ url }, { success, fail }]`. */\nexport const splitOptions = <P extends object, T>(\n  options: P & CallbackOptions<T>,\n): [Omit<P, keyof CallbackOptions<T>>, CallbackOptions<T>] => {\n  const { success, fail, ...params } = options;\n  return [params, { success, fail }];\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 { isInHost, notify } from '../bridge';\nimport { ErrorCode, MiniAppError } from '../errors';\nimport { invoke, splitOptions } from '../invoke';\nimport type { CallbackOptions, SystemInfo } from '../types';\nimport { SDK_VERSION } from '../version';\n\n/** Đóng mini app. */\nexport const closeApp = (options?: CallbackOptions<void>): Promise<void> => invoke('closeApp', undefined, options);\n\n/** Mở link ngoài bằng trình duyệt trong app. Chỉ chấp nhận http(s). */\nexport const openWebview = (options: { url: string } & CallbackOptions<void>): Promise<void> => {\n  const [params, callbacks] = splitOptions(options);\n  if (!/^https?:\\/\\//i.test(params.url ?? '')) {\n    const error = new MiniAppError(ErrorCode.INVALID_PARAMS, 'url phải bắt đầu bằng http:// hoặc https://', 'openWebview');\n    callbacks.fail?.(error);\n    return Promise.reject(error);\n  }\n  return invoke('openWebview', params, callbacks);\n};\n\n/** Hiện toast native. */\nexport const showToast = (options: { message: string } & CallbackOptions<void>): Promise<void> => {\n  const [params, callbacks] = splitOptions(options);\n  return invoke('showToast', params, callbacks);\n};\n\n/** Thông tin thiết bị / host. Ngoài app trả giá trị mặc định thay vì lỗi. */\nexport const getSystemInfo = async (options?: CallbackOptions<SystemInfo>): Promise<SystemInfo> => {\n  const base: SystemInfo = { platform: 'web', sdkVersion: SDK_VERSION, inHost: isInHost() };\n  if (!isInHost()) {\n    options?.success?.(base);\n    return base;\n  }\n  try {\n    const host = await invoke<Partial<SystemInfo>>('getSystemInfo');\n    const result: SystemInfo = { ...base, ...host, sdkVersion: SDK_VERSION, inHost: true };\n    options?.success?.(result);\n    return result;\n  } catch (error) {\n    const normalized = MiniAppError.from(error, 'getSystemInfo');\n    options?.fail?.(normalized);\n    throw normalized;\n  }\n};\n\n/** @internal SDK tự gọi khi trang sẵn sàng — host đẩy context mới nhất nếu đổi trong lúc load. */\nexport const notifyReady = (): void => notify('ready', { sdkVersion: SDK_VERSION });\n","import { invoke } from '../invoke';\nimport type { CallbackOptions, UserInfo } from '../types';\n\n/**\n * Access token của mini app cho PAGE hiện tại (mỗi page 1 token). Host tự refresh →\n * gọi lại mỗi khi cần thay vì lưu lâu phía web.\n */\nexport const getAccessToken = (options?: CallbackOptions<string>): Promise<string> =>\n  invoke('getAccessToken', undefined, options);\n\n/** Nhân viên đang đăng nhập app. */\nexport const getUserInfo = (options?: CallbackOptions<UserInfo>): Promise<UserInfo> =>\n  invoke('getUserInfo', undefined, options);\n","import { invoke } from '../invoke';\nimport type { CallbackOptions, PageInfo } from '../types';\n\n/**\n * Page (kênh) đang mở mini app. Mini app được cài theo page — mỗi page có token, quyền,\n * dữ liệu riêng; host chạy 1 instance mini app cho mỗi page (đổi page = instance khác).\n */\nexport const getPageInfo = (options?: CallbackOptions<PageInfo>): Promise<PageInfo> =>\n  invoke('getPageInfo', undefined, options);\n","import { ErrorCode, MiniAppError } from '../errors';\nimport { invoke, splitOptions } from '../invoke';\nimport type { CallbackOptions } from '../types';\n\ntype TextOptions = { text: string } & CallbackOptions<void>;\n\nconst withText = (method: string, options: TextOptions): Promise<void> => {\n  const [params, callbacks] = splitOptions(options);\n  if (typeof params.text !== 'string' || !params.text.trim()) {\n    const error = new MiniAppError(ErrorCode.INVALID_PARAMS, 'text không được rỗng', method);\n    callbacks.fail?.(error);\n    return Promise.reject(error);\n  }\n  return invoke(method, params, callbacks);\n};\n\n/** Gửi tin nhắn vào conversation đang mở mini app. */\nexport const sendMessage = (options: TextOptions): Promise<void> => withText('sendMessage', options);\n\n/** Chèn text vào ô nhập chat (không gửi) — nhân viên tự sửa/gửi. */\nexport const insertText = (options: TextOptions): Promise<void> => withText('insertText', options);\n","import { getState } from '../bridge';\nimport type { MockHandler } from '../types';\n\n/**\n * Giả lập host khi dev trên trình duyệt. Không có tác dụng khi chạy trong app.\n * @example\n * if (import.meta.env.DEV) {\n *   setMockHandler((method) => (method === 'getAccessToken' ? 'dev-token' : undefined));\n * }\n */\nexport const setMockHandler = (handler: MockHandler | null): void => {\n  getState().mock = handler;\n};\n","import { getState } from './bridge';\nimport { notifyReady } from './apis/app';\n\nexport { getRouteParams, onContextChange } from './apis/route';\nexport { closeApp, openWebview, showToast, getSystemInfo } from './apis/app';\nexport { getAccessToken, getUserInfo } from './apis/user';\nexport { getPageInfo } from './apis/page';\nexport { sendMessage, insertText } from './apis/chat';\nexport { setMockHandler } from './apis/dev';\nexport { isInHost, PROTOCOL_VERSION } from './bridge';\nexport { MiniAppError, ErrorCode } from './errors';\nexport { SDK_VERSION } from './version';\nexport type { RouteParams, CallbackOptions, UserInfo, SystemInfo, PageInfo, MockHandler } from './types';\nexport type { HostInfo } from './bridge';\n\n// Khởi tạo bridge ngay khi import (host có thể đẩy event trước khi app gọi API 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          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\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 } from './apis/route';\nexport { getAccessToken, getToken, type TokenType } 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"]}

package/dist/index.d.cts

@@ -1,63 +1,73 @@
-import { R as RouteParams, C as CallbackOptions, S as SystemInfo, U as UserInfo, P as PageInfo, M as MockHandler, a as MiniAppError } from './types-8g8OpZsj.cjs';
-export { E as ErrorCode } from './types-8g8OpZsj.cjs';
+/**
+ * Thông tin conversation lúc mở mini app.
+ * Trong app: host truyền vào. Ngoài app (trình duyệt / iframe cũ): đọc từ query URL.
+ */
+interface RouteParams {
+    /** Page (kênh) đang mở mini app. */
+    page_id?: string;
+    /** Khách hàng của conversation. */
+    client_id?: string;
+    org_id?: string;
+    /** Tin nhắn / bình luận mở mini app (nếu mở từ 1 tin cụ thể). */
+    message_id?: string;
+    comment_id?: string;
+    /** Ngôn ngữ app: vi, en, ... */
+    locale?: string;
+    /** 1 nếu người dùng là admin của page. */
+    is_page_admin?: string | number;
+    [key: string]: unknown;
+}
 
-type ContextListener = (next: RouteParams, prev: RouteParams) => void;
 /**
- * Param lúc mở mini app: query URL + context host inject (host ưu tiên).
+ * Thông tin conversation lúc mở mini app (đồng bộ, gọi bất cứ lúc nào).
  * @example
- * const { client_id, org_id } = getRouteParams();
+ * const { page_id, client_id } = getRouteParams();
  */
 declare const getRouteParams: () => RouteParams;
-/**
- * Host đổi conversation mà KHÔNG reload mini app — chỉ xảy ra khi `miniapp.config.json`
- * có `context_update: true`. Nếu không, host reload với query mới và getRouteParams() vẫn đúng.
- * @returns hàm huỷ đăng ký
- */
-declare const onContextChange: (listener: ContextListener) => (() => void);
-
-/** Đóng mini app. */
-declare const closeApp: (options?: CallbackOptions<void>) => Promise<void>;
-/** Mở link ngoài bằng trình duyệt trong app. Chỉ chấp nhận http(s). */
-declare const openWebview: (options: {
-    url: string;
-} & CallbackOptions<void>) => Promise<void>;
-/** Hiện toast native. */
-declare const showToast: (options: {
-    message: string;
-} & CallbackOptions<void>) => Promise<void>;
-/** Thông tin thiết bị / host. Ngoài app trả giá trị mặc định thay vì lỗi. */
-declare const getSystemInfo: (options?: CallbackOptions<SystemInfo>) => Promise<SystemInfo>;
 
 /**
- * Access token của mini app cho PAGE hiện tại (mỗi page 1 token). Host tự refresh →
- * gọi lại mỗi khi cần thay vì lưu lâu phía web.
+ * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).
+ * - Trong app: lấy từ host, luôn là token của page hiện tại, host tự refresh.
+ * - Ngoài app: đọc `?access_token=` trên URL (như iframe hiện tại).
+ * Gọi lại mỗi khi cần — không lưu token lâu phía web.
  */
-declare const getAccessToken: (options?: CallbackOptions<string>) => Promise<string>;
-/** Nhân viên đang đăng nhập app. */
-declare const getUserInfo: (options?: CallbackOptions<UserInfo>) => Promise<UserInfo>;
-
+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';
 /**
- * Page (kênh) đang mở mini app. Mini app được cài theo page — mỗi page có token, quyền,
- * dữ liệu riêng; host chạy 1 instance mini app cho mỗi page (đổi page = instance khác).
+ * 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 getPageInfo: (options?: CallbackOptions<PageInfo>) => Promise<PageInfo>;
-
-type TextOptions = {
-    text: string;
-} & CallbackOptions<void>;
-/** Gửi tin nhắn vào conversation đang mở mini app. */
-declare const sendMessage: (options: TextOptions) => Promise<void>;
-/** Chèn text vào ô nhập chat (không gửi) — nhân viên tự sửa/gửi. */
-declare const insertText: (options: TextOptions) => Promise<void>;
+declare const getToken: (type: TokenType) => Promise<string>;
 
 /**
- * Giả lập host khi dev trên trình duyệt. Không có tác dụng khi chạy trong app.
- * @example
- * if (import.meta.env.DEV) {
- *   setMockHandler((method) => (method === 'getAccessToken' ? 'dev-token' : undefined));
- * }
+ * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).
  */
-declare const setMockHandler: (handler: MockHandler | null) => void;
+declare const closeApp: () => Promise<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. */
+    readonly HOST_ERROR: "HOST_ERROR";
+};
+type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode] | (string & {});
+declare class MiniAppError extends Error {
+    readonly code: ErrorCode;
+    readonly method?: string;
+    constructor(code: ErrorCode, message: string, method?: string);
+    /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */
+    static from(error: unknown, method?: string): MiniAppError;
+}
 
 /**
  * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.
@@ -76,7 +86,6 @@ declare const setMockHandler: (handler: MockHandler | null) => void;
  * node_modules) vẫn dùng chung 1 bridge thay vì ghi đè hàm receive của nhau.
  */
 
-declare const PROTOCOL_VERSION = 1;
 type ResponseMessage = {
     id: string;
     result?: unknown;
@@ -108,7 +117,6 @@ interface BridgeState {
     seq: number;
     pending: Map<string, Pending>;
     listeners: Map<string, Set<Listener>>;
-    mock: MockHandler | null;
     context: RouteParams;
     receive: (message: ResponseMessage | EventMessage) => void;
 }
@@ -128,4 +136,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 { CallbackOptions, type HostInfo, MiniAppError, MockHandler, PROTOCOL_VERSION, PageInfo, RouteParams, SDK_VERSION, SystemInfo, UserInfo, closeApp, getAccessToken, getPageInfo, getRouteParams, getSystemInfo, getUserInfo, insertText, isInHost, onContextChange, openWebview, sendMessage, setMockHandler, showToast };
+export { ErrorCode, MiniAppError, type RouteParams, SDK_VERSION, type TokenType, closeApp, getAccessToken, getRouteParams, getToken, isInHost };

package/dist/index.d.ts

@@ -1,63 +1,73 @@
-import { R as RouteParams, C as CallbackOptions, S as SystemInfo, U as UserInfo, P as PageInfo, M as MockHandler, a as MiniAppError } from './types-8g8OpZsj.js';
-export { E as ErrorCode } from './types-8g8OpZsj.js';
+/**
+ * Thông tin conversation lúc mở mini app.
+ * Trong app: host truyền vào. Ngoài app (trình duyệt / iframe cũ): đọc từ query URL.
+ */
+interface RouteParams {
+    /** Page (kênh) đang mở mini app. */
+    page_id?: string;
+    /** Khách hàng của conversation. */
+    client_id?: string;
+    org_id?: string;
+    /** Tin nhắn / bình luận mở mini app (nếu mở từ 1 tin cụ thể). */
+    message_id?: string;
+    comment_id?: string;
+    /** Ngôn ngữ app: vi, en, ... */
+    locale?: string;
+    /** 1 nếu người dùng là admin của page. */
+    is_page_admin?: string | number;
+    [key: string]: unknown;
+}
 
-type ContextListener = (next: RouteParams, prev: RouteParams) => void;
 /**
- * Param lúc mở mini app: query URL + context host inject (host ưu tiên).
+ * Thông tin conversation lúc mở mini app (đồng bộ, gọi bất cứ lúc nào).
  * @example
- * const { client_id, org_id } = getRouteParams();
+ * const { page_id, client_id } = getRouteParams();
  */
 declare const getRouteParams: () => RouteParams;
-/**
- * Host đổi conversation mà KHÔNG reload mini app — chỉ xảy ra khi `miniapp.config.json`
- * có `context_update: true`. Nếu không, host reload với query mới và getRouteParams() vẫn đúng.
- * @returns hàm huỷ đăng ký
- */
-declare const onContextChange: (listener: ContextListener) => (() => void);
-
-/** Đóng mini app. */
-declare const closeApp: (options?: CallbackOptions<void>) => Promise<void>;
-/** Mở link ngoài bằng trình duyệt trong app. Chỉ chấp nhận http(s). */
-declare const openWebview: (options: {
-    url: string;
-} & CallbackOptions<void>) => Promise<void>;
-/** Hiện toast native. */
-declare const showToast: (options: {
-    message: string;
-} & CallbackOptions<void>) => Promise<void>;
-/** Thông tin thiết bị / host. Ngoài app trả giá trị mặc định thay vì lỗi. */
-declare const getSystemInfo: (options?: CallbackOptions<SystemInfo>) => Promise<SystemInfo>;
 
 /**
- * Access token của mini app cho PAGE hiện tại (mỗi page 1 token). Host tự refresh →
- * gọi lại mỗi khi cần thay vì lưu lâu phía web.
+ * Token để mini app gọi API backend của chính mình (Authorization: Bearer ...).
+ * - Trong app: lấy từ host, luôn là token của page hiện tại, host tự refresh.
+ * - Ngoài app: đọc `?access_token=` trên URL (như iframe hiện tại).
+ * Gọi lại mỗi khi cần — không lưu token lâu phía web.
  */
-declare const getAccessToken: (options?: CallbackOptions<string>) => Promise<string>;
-/** Nhân viên đang đăng nhập app. */
-declare const getUserInfo: (options?: CallbackOptions<UserInfo>) => Promise<UserInfo>;
-
+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';
 /**
- * Page (kênh) đang mở mini app. Mini app được cài theo page — mỗi page có token, quyền,
- * dữ liệu riêng; host chạy 1 instance mini app cho mỗi page (đổi page = instance khác).
+ * 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 getPageInfo: (options?: CallbackOptions<PageInfo>) => Promise<PageInfo>;
-
-type TextOptions = {
-    text: string;
-} & CallbackOptions<void>;
-/** Gửi tin nhắn vào conversation đang mở mini app. */
-declare const sendMessage: (options: TextOptions) => Promise<void>;
-/** Chèn text vào ô nhập chat (không gửi) — nhân viên tự sửa/gửi. */
-declare const insertText: (options: TextOptions) => Promise<void>;
+declare const getToken: (type: TokenType) => Promise<string>;
 
 /**
- * Giả lập host khi dev trên trình duyệt. Không có tác dụng khi chạy trong app.
- * @example
- * if (import.meta.env.DEV) {
- *   setMockHandler((method) => (method === 'getAccessToken' ? 'dev-token' : undefined));
- * }
+ * Đóng mini app, quay về màn chat. Ngoài app → reject NOT_IN_HOST (web tự xử lý, vd router.back()).
  */
-declare const setMockHandler: (handler: MockHandler | null) => void;
+declare const closeApp: () => Promise<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. */
+    readonly HOST_ERROR: "HOST_ERROR";
+};
+type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode] | (string & {});
+declare class MiniAppError extends Error {
+    readonly code: ErrorCode;
+    readonly method?: string;
+    constructor(code: ErrorCode, message: string, method?: string);
+    /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */
+    static from(error: unknown, method?: string): MiniAppError;
+}
 
 /**
  * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.
@@ -76,7 +86,6 @@ declare const setMockHandler: (handler: MockHandler | null) => void;
  * node_modules) vẫn dùng chung 1 bridge thay vì ghi đè hàm receive của nhau.
  */
 
-declare const PROTOCOL_VERSION = 1;
 type ResponseMessage = {
     id: string;
     result?: unknown;
@@ -108,7 +117,6 @@ interface BridgeState {
     seq: number;
     pending: Map<string, Pending>;
     listeners: Map<string, Set<Listener>>;
-    mock: MockHandler | null;
     context: RouteParams;
     receive: (message: ResponseMessage | EventMessage) => void;
 }
@@ -128,4 +136,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 { CallbackOptions, type HostInfo, MiniAppError, MockHandler, PROTOCOL_VERSION, PageInfo, RouteParams, SDK_VERSION, SystemInfo, UserInfo, closeApp, getAccessToken, getPageInfo, getRouteParams, getSystemInfo, getUserInfo, insertText, isInHost, onContextChange, openWebview, sendMessage, setMockHandler, showToast };
+export { ErrorCode, MiniAppError, type RouteParams, SDK_VERSION, type TokenType, closeApp, getAccessToken, getRouteParams, getToken, isInHost };

package/dist/index.js

@@ -1,85 +1,180 @@
-import { getState, notify, MiniAppError, ErrorCode, isInHost, call } from './chunk-PVXYU6XK.js';
-export { ErrorCode, MiniAppError, PROTOCOL_VERSION, getRouteParams, isInHost, onContextChange } from './chunk-PVXYU6XK.js';
+// src/errors.ts
+var ErrorCode = {
+  /** Không chạy trong app Retion (trình duyệt / iframe cũ). */
+  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. */
+  HOST_ERROR: "HOST_ERROR"
+};
+var MiniAppError = class _MiniAppError extends Error {
+  constructor(code, message, method) {
+    super(message);
+    this.name = "MiniAppError";
+    this.code = code;
+    this.method = method;
+  }
+  /** Chuẩn hoá lỗi từ host (object thuần, Error, string) về MiniAppError. */
+  static from(error, method) {
+    if (error instanceof _MiniAppError) {
+      return error;
+    }
+    if (error && typeof error === "object") {
+      const { code, message } = error;
+      return new _MiniAppError(
+        typeof code === "string" ? code : ErrorCode.HOST_ERROR,
+        typeof message === "string" ? message : "Unknown error",
+        method
+      );
+    }
+    return new _MiniAppError(ErrorCode.HOST_ERROR, String(error), method);
+  }
+};
 
-// src/invoke.ts
-var invoke = (method, params, options) => {
-  const promise = call(method, params);
-  if ((options == null ? void 0 : options.success) || (options == null ? void 0 : options.fail)) {
-    promise.then(options.success, (error) => {
-      var _a;
-      return (_a = options.fail) == null ? void 0 : _a.call(options, MiniAppError.from(error, method));
-    });
+// src/bridge.ts
+var PROTOCOL_VERSION = 1;
+var DEFAULT_TIMEOUT_MS = 15e3;
+var CONTEXT_EVENT = "context";
+var hasWindow = typeof window !== "undefined";
+var readInitialContext = () => {
+  var _a;
+  if (!hasWindow) {
+    return {};
   }
-  return promise;
+  const query = Object.fromEntries(new URLSearchParams(window.location.search));
+  return { ...query, ...(_a = window.__RETION_MINIAPP_CONTEXT__) != null ? _a : {} };
 };
-var splitOptions = (options) => {
-  const { success, fail, ...params } = options;
-  return [params, { success, fail }];
+var createState = () => {
+  const state = {
+    protocol: PROTOCOL_VERSION,
+    seq: 0,
+    pending: /* @__PURE__ */ new Map(),
+    listeners: /* @__PURE__ */ new Map(),
+    context: readInitialContext(),
+    receive: (message) => {
+      if (!message || typeof message !== "object") {
+        return;
+      }
+      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 });
+          return;
+        }
+        emit(state, message.event, message.data);
+        return;
+      }
+      const pending = state.pending.get(message.id);
+      if (!pending) {
+        return;
+      }
+      state.pending.delete(message.id);
+      clearTimeout(pending.timer);
+      if (message.error) {
+        pending.reject(MiniAppError.from(message.error, pending.method));
+      } else {
+        pending.resolve(message.result);
+      }
+    }
+  };
+  return state;
 };
-
-// src/version.ts
-var SDK_VERSION = "0.1.0" ;
-
-// src/apis/app.ts
-var closeApp = (options) => invoke("closeApp", void 0, options);
-var openWebview = (options) => {
-  var _a, _b;
-  const [params, callbacks] = splitOptions(options);
-  if (!/^https?:\/\//i.test((_a = params.url) != null ? _a : "")) {
-    const error = new MiniAppError(ErrorCode.INVALID_PARAMS, "url ph\u1EA3i b\u1EAFt \u0111\u1EA7u b\u1EB1ng http:// ho\u1EB7c https://", "openWebview");
-    (_b = callbacks.fail) == null ? void 0 : _b.call(callbacks, error);
-    return Promise.reject(error);
+var emit = (state, event, data) => {
+  var _a;
+  (_a = state.listeners.get(event)) == null ? void 0 : _a.forEach((listener) => {
+    try {
+      listener(data);
+    } catch (error) {
+      console.error(`[retion-miniapp] listener "${event}" l\u1ED7i`, error);
+    }
+  });
+};
+var fallback_state = null;
+var getState = () => {
+  var _a;
+  if (!hasWindow) {
+    return fallback_state != null ? fallback_state : fallback_state = createState();
   }
-  return invoke("openWebview", params, callbacks);
+  return (_a = window.__RETION_MINIAPP__) != null ? _a : window.__RETION_MINIAPP__ = createState();
+};
+var isInHost = () => {
+  var _a, _b;
+  return hasWindow && typeof ((_a = window.__RETION_MINIAPP_HOST__) == null ? void 0 : _a.protocol) === "number" && typeof ((_b = window.ReactNativeWebView) == null ? void 0 : _b.postMessage) === "function";
 };
-var showToast = (options) => {
-  const [params, callbacks] = splitOptions(options);
-  return invoke("showToast", params, callbacks);
+var post = (message) => {
+  window.ReactNativeWebView.postMessage(JSON.stringify(message));
 };
-var getSystemInfo = async (options) => {
-  var _a, _b, _c;
-  const base = { platform: "web", sdkVersion: SDK_VERSION, inHost: isInHost() };
+var call = (method, params, timeout_ms = DEFAULT_TIMEOUT_MS) => {
+  const state = getState();
   if (!isInHost()) {
-    (_a = options == null ? void 0 : options.success) == null ? void 0 : _a.call(options, base);
-    return base;
+    return Promise.reject(new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} ch\u1EC9 ch\u1EA1y trong app Retion`, method));
   }
-  try {
-    const host = await invoke("getSystemInfo");
-    const result = { ...base, ...host, sdkVersion: SDK_VERSION, inHost: true };
-    (_b = options == null ? void 0 : options.success) == null ? void 0 : _b.call(options, result);
-    return result;
-  } catch (error) {
-    const normalized = MiniAppError.from(error, "getSystemInfo");
-    (_c = options == null ? void 0 : options.fail) == null ? void 0 : _c.call(options, normalized);
-    throw normalized;
+  const id = `${Date.now().toString(36)}-${++state.seq}`;
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      state.pending.delete(id);
+      reject(new MiniAppError(ErrorCode.TIMEOUT, `${method}: host kh\xF4ng ph\u1EA3n h\u1ED3i sau ${timeout_ms}ms`, method));
+    }, timeout_ms);
+    state.pending.set(id, { method, resolve, reject, timer });
+    post({ __retion: PROTOCOL_VERSION, id, method, params });
+  });
+};
+var notify = (method, params) => {
+  if (isInHost()) {
+    post({ __retion: PROTOCOL_VERSION, method, params });
   }
 };
-var notifyReady = () => notify("ready", { sdkVersion: SDK_VERSION });
 
-// src/apis/user.ts
-var getAccessToken = (options) => invoke("getAccessToken", void 0, options);
-var getUserInfo = (options) => invoke("getUserInfo", void 0, options);
+// src/version.ts
+var SDK_VERSION = "0.3.0" ;
+
+// src/apis/app.ts
+var closeApp = () => call("closeApp");
+var notifyReady = () => notify("ready", { sdkVersion: SDK_VERSION });
 
-// src/apis/page.ts
-var getPageInfo = (options) => invoke("getPageInfo", void 0, options);
+// src/apis/route.ts
+var getRouteParams = () => ({ ...getState().context });
 
-// src/apis/chat.ts
-var withText = (method, options) => {
-  var _a;
-  const [params, callbacks] = splitOptions(options);
-  if (typeof params.text !== "string" || !params.text.trim()) {
-    const error = new MiniAppError(ErrorCode.INVALID_PARAMS, "text kh\xF4ng \u0111\u01B0\u1EE3c r\u1ED7ng", method);
-    (_a = callbacks.fail) == null ? void 0 : _a.call(callbacks, error);
-    return Promise.reject(error);
+// src/apis/user.ts
+var TOKEN_QUERY_PARAM = "access_token";
+var readTokenFromUrl = () => {
+  if (typeof window === "undefined") {
+    return null;
   }
-  return invoke(method, params, callbacks);
+  return new URLSearchParams(window.location.search).get(TOKEN_QUERY_PARAM);
 };
-var sendMessage = (options) => withText("sendMessage", options);
-var insertText = (options) => withText("insertText", options);
-
-// src/apis/dev.ts
-var setMockHandler = (handler) => {
-  getState().mock = handler;
+var getAccessToken = async () => {
+  if (isInHost()) {
+    return call("getAccessToken");
+  }
+  const token = readTokenFromUrl();
+  if (!token) {
+    throw new MiniAppError(ErrorCode.NOT_IN_HOST, `Ngo\xE0i app: thi\u1EBFu ?${TOKEN_QUERY_PARAM}= tr\xEAn URL`, "getAccessToken");
+  }
+  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
@@ -92,6 +187,6 @@ if (typeof window !== "undefined") {
   }
 }
 
-export { SDK_VERSION, closeApp, getAccessToken, getPageInfo, getSystemInfo, getUserInfo, insertText, openWebview, sendMessage, setMockHandler, showToast };
+export { ErrorCode, MiniAppError, SDK_VERSION, closeApp, getAccessToken, getRouteParams, getToken, isInHost };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map