@retion-miniapp/sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+Định dạng theo [Keep a Changelog](https://keepachangelog.com/vi/1.1.0/), version theo [SemVer](https://semver.org/).
+
+## Unreleased
+
+### Added
+- Bridge giao thức v1 với host React Native (request/response theo id, timeout, event).
+- API: `getRouteParams`, `onContextChange`, `getPageInfo`, `getAccessToken`, `getUserInfo`, `sendMessage`, `insertText`, `closeApp`, `openWebview`, `showToast`, `getSystemInfo`, `isInHost`, `setMockHandler`.
+- `MiniAppError` + `ErrorCode`.
+- Vue composable `useRouteParams` (`@retion-miniapp/sdk/vue`).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Retion
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# @retion-miniapp/sdk
+
+SDK cho web mini app chạy trong app Retion. Bridge với app được ẩn hoàn toàn — chỉ cần import hàm.
+
+- Chạy được ở **cả web lẫn app**: ngoài app, SDK không lỗi, `getRouteParams()` đọc query URL, API cần app reject `NOT_IN_HOST`.
+- Mọi API trả `Promise`, hoặc dùng callback `{ success, fail }`.
+- TypeScript, ESM + CJS, tree-shake theo từng hàm, có composable Vue.
+
+## Cài đặt
+
+```bash
+npm i @retion-miniapp/sdk
+npm i -D @retion-miniapp/cli   # build + deploy
+```
+
+## Dùng nhanh
+
+```js
+import { getRouteParams, getAccessToken, insertText, closeApp, isInHost } from '@retion-miniapp/sdk';
+
+const { page_id, client_id } = getRouteParams();
+
+const token = await getAccessToken();
+const order = await fetch(`https://api.your-app.com/orders?client=${client_id}`, {
+  headers: { Authorization: `Bearer ${token}` },
+}).then((r) => r.json());
+
+if (isInHost()) {
+  await insertText({ text: `Đơn #${order.id}: ${order.total}đ` });
+  await closeApp();
+} else {
+  router.back(); // chạy trên web: giữ hành vi cũ
+}
+```
+
+## Mini app theo page
+
+Mini app được cài theo **page** (kênh). Mỗi page có token, quyền, dữ liệu riêng — app chạy **1 instance mini app cho mỗi page**:
+
+- Đổi conversation **trong cùng page** → `onContextChange` (nếu `context_update: true`), hoặc reload với query mới.
+- Đổi **page** → instance khác, mini app khởi động lại với `page_id` mới. Không cần tự xử lý.
+- `getAccessToken()` luôn trả token của page hiện tại — gọi lại mỗi khi cần, không lưu lâu.
+
+## API
+
+| API | Trả về | Mô tả |
+|---|---|---|
+| `getRouteParams()` | `RouteParams` | `page_id, client_id, org_id, message_id, locale, is_page_admin, ...` (đồng bộ) |
+| `onContextChange(cb)` | `() => void` | Đổi conversation trong cùng page mà không reload |
+| `getPageInfo()` | `PageInfo` | `{ page_id, name, avatar, platform }` |
+| `getAccessToken()` | `string` | Token của page hiện tại |
+| `getUserInfo()` | `UserInfo` | Nhân viên đang đăng nhập |
+| `sendMessage({ text })` | `void` | Gửi tin vào conversation |
+| `insertText({ text })` | `void` | Chèn text vào ô nhập chat |
+| `closeApp()` | `void` | Đóng mini app |
+| `openWebview({ url })` | `void` | Mở link http(s) |
+| `showToast({ message })` | `void` | Toast native |
+| `getSystemInfo()` | `SystemInfo` | `platform, appVersion, sdkVersion, inHost, theme` — ngoài app không lỗi |
+| `isInHost()` | `boolean` | Đang chạy trong app Retion có hỗ trợ SDK |
+
+### Lỗi
+
+Mọi lỗi là `MiniAppError` với `code`:
+
+| code | Khi nào |
+|---|---|
+| `NOT_IN_HOST` | Chạy ngoài app (web / màn iframe cũ của app) và không có mock |
+| `TIMEOUT` | Host không phản hồi (15s) |
+| `NOT_SUPPORTED` | App version hiện tại chưa hỗ trợ API |
+| `INVALID_PARAMS` | Tham số sai (url không phải http(s), text rỗng, ...) |
+| `USER_CANCELLED` | User huỷ thao tác |
+| `HOST_ERROR` | Lỗi khác phía app |
+
+```js
+import { closeApp, MiniAppError, ErrorCode } from '@retion-miniapp/sdk';
+
+try {
+  await closeApp();
+} catch (e) {
+  if (e instanceof MiniAppError && e.code === ErrorCode.NOT_IN_HOST) { /* đang chạy trên web */ }
+}
+```
+
+## Vue
+
+```js
+import { useRouteParams } from '@retion-miniapp/sdk/vue';
+
+const params = useRouteParams(); // ShallowRef<RouteParams>, tự cập nhật khi đổi conversation
+watch(() => params.value.client_id, fetchData, { immediate: true });
+```
+
+## Dev trên trình duyệt
+
+```js
+import { setMockHandler } from '@retion-miniapp/sdk';
+
+if (import.meta.env.DEV) {
+  setMockHandler((method, params) => {
+    if (method === 'getAccessToken') return 'dev-token';
+    if (method === 'getPageInfo') return { page_id: 'p1', name: 'Page test', platform: 'facebook' };
+  });
+}
+```
+
+## Build cho app
+
+`vite.config`: `base: './'` (chạy offline từ file local). Sau đó dùng [`@retion-miniapp/cli`](https://www.npmjs.com/package/@retion-miniapp/cli):
+
+```bash
+npx retion-miniapp init
+npx retion-miniapp deploy
+```
+
+## Giao thức (cho team app)
+
+Xem chú thích đầu [`src/bridge.ts`](./src/bridge.ts). Host phải inject `window.__RETION_MINIAPP_HOST__ = { protocol: 1 }` trước khi trang chạy — thiếu marker, SDK coi như chạy ngoài app.
+
+## Phát triển
+
+```bash
+npm i
+npm run check        # typecheck + lint + test + build + publint
+npm run release:patch   # (hoặc minor/major) — xem mục Release
+```
+
+### Release
+
+1. Ghi thay đổi vào `CHANGELOG.md` dưới `## Unreleased`.
+2. `npm run release:patch` → chạy `check` → tăng version → cập nhật CHANGELOG → commit + tag `vX.Y.Z` → push.
+3. GitHub Actions (`release.yml`) thấy tag → publish lên npm (cần secret `NPM_TOKEN`).
+
+## License
+
+MIT

package/dist/chunk-C2AZ33LI.cjs

@@ -0,0 +1,175 @@
+'use strict';
+
+// src/errors.ts
+var ErrorCode = {
+  /** Không chạy trong app Retion (vd mở trên trình duyệt) và không có mock handler. */
+  NOT_IN_HOST: "NOT_IN_HOST",
+  /** Host không phản hồi trong thời gian chờ. */
+  TIMEOUT: "TIMEOUT",
+  /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
+  NOT_SUPPORTED: "NOT_SUPPORTED",
+  /** Tham số truyền vào không hợp lệ. */
+  INVALID_PARAMS: "INVALID_PARAMS",
+  /** User từ chối / huỷ thao tác. */
+  USER_CANCELLED: "USER_CANCELLED",
+  /** 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 / mock (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/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 {};
+  }
+  const query = Object.fromEntries(new URLSearchParams(window.location.search));
+  return { ...query, ...(_a = window.__RETION_MINIAPP_CONTEXT__) != null ? _a : {} };
+};
+var createState = () => {
+  const state = {
+    protocol: PROTOCOL_VERSION,
+    seq: 0,
+    pending: /* @__PURE__ */ new Map(),
+    listeners: /* @__PURE__ */ new Map(),
+    mock: null,
+    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;
+};
+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 (_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 post = (message) => {
+  window.ReactNativeWebView.postMessage(JSON.stringify(message));
+};
+var call = (method, params, timeout_ms = DEFAULT_TIMEOUT_MS) => {
+  const state = getState();
+  if (!isInHost()) {
+    if (!state.mock) {
+      return Promise.reject(
+        new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} ch\u1EC9 ch\u1EA1y trong app Retion`, method)
+      );
+    }
+    const mock = state.mock;
+    return new Promise((resolve) => resolve(mock(method, params))).catch((error) => {
+      throw MiniAppError.from(error, method);
+    });
+  }
+  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 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/apis/route.ts
+var getRouteParams = () => ({ ...getState().context });
+var onContextChange = (listener) => on(CONTEXT_EVENT, (data) => {
+  const { next, prev } = data;
+  listener(next, prev);
+});
+
+exports.ErrorCode = ErrorCode;
+exports.MiniAppError = MiniAppError;
+exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
+exports.call = call;
+exports.getRouteParams = getRouteParams;
+exports.getState = getState;
+exports.isInHost = isInHost;
+exports.notify = notify;
+exports.onContextChange = onContextChange;
+//# sourceMappingURL=chunk-C2AZ33LI.cjs.map
+//# sourceMappingURL=chunk-C2AZ33LI.cjs.map

package/dist/chunk-C2AZ33LI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/bridge.ts","../src/apis/route.ts"],"names":[],"mappings":"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","file":"chunk-C2AZ33LI.cjs","sourcesContent":["export const ErrorCode = {\n  /** Không chạy trong app Retion (vd mở trên trình duyệt) và không có mock handler. */\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  /** Tham số truyền vào không hợp lệ. */\n  INVALID_PARAMS: 'INVALID_PARAMS',\n  /** User từ chối / huỷ thao tác. */\n  USER_CANCELLED: 'USER_CANCELLED',\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 / mock (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 { MockHandler, 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  mock: MockHandler | null;\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    mock: null,\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 → mock handler (nếu có) hoặc 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    if (!state.mock) {\n      return Promise.reject(\n        new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} chỉ chạy trong app Retion`, method),\n      );\n    }\n    const mock = state.mock;\n    return new Promise<T>((resolve) => resolve(mock(method, params) as T)).catch((error: unknown) => {\n      throw MiniAppError.from(error, method);\n    });\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","import { CONTEXT_EVENT, getState, on } from '../bridge';\nimport type { RouteParams } from '../types';\n\ntype ContextListener = (next: RouteParams, prev: RouteParams) => void;\n\n/**\n * Param lúc mở mini app: query URL + context host inject (host ưu tiên).\n * @example\n * const { client_id, org_id } = getRouteParams();\n */\nexport const getRouteParams = (): RouteParams => ({ ...getState().context });\n\n/**\n * Host đổi conversation mà KHÔNG reload mini app — chỉ xảy ra khi `miniapp.config.json`\n * có `context_update: true`. Nếu không, host reload với query mới và getRouteParams() vẫn đúng.\n * @returns hàm huỷ đăng ký\n */\nexport const onContextChange = (listener: ContextListener): (() => void) =>\n  on(CONTEXT_EVENT, (data) => {\n    const { next, prev } = data as { next: RouteParams; prev: RouteParams };\n    listener(next, prev);\n  });\n"]}

package/dist/chunk-PVXYU6XK.js

@@ -0,0 +1,165 @@
+// src/errors.ts
+var ErrorCode = {
+  /** Không chạy trong app Retion (vd mở trên trình duyệt) và không có mock handler. */
+  NOT_IN_HOST: "NOT_IN_HOST",
+  /** Host không phản hồi trong thời gian chờ. */
+  TIMEOUT: "TIMEOUT",
+  /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
+  NOT_SUPPORTED: "NOT_SUPPORTED",
+  /** Tham số truyền vào không hợp lệ. */
+  INVALID_PARAMS: "INVALID_PARAMS",
+  /** User từ chối / huỷ thao tác. */
+  USER_CANCELLED: "USER_CANCELLED",
+  /** 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 / mock (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/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 {};
+  }
+  const query = Object.fromEntries(new URLSearchParams(window.location.search));
+  return { ...query, ...(_a = window.__RETION_MINIAPP_CONTEXT__) != null ? _a : {} };
+};
+var createState = () => {
+  const state = {
+    protocol: PROTOCOL_VERSION,
+    seq: 0,
+    pending: /* @__PURE__ */ new Map(),
+    listeners: /* @__PURE__ */ new Map(),
+    mock: null,
+    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;
+};
+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 (_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 post = (message) => {
+  window.ReactNativeWebView.postMessage(JSON.stringify(message));
+};
+var call = (method, params, timeout_ms = DEFAULT_TIMEOUT_MS) => {
+  const state = getState();
+  if (!isInHost()) {
+    if (!state.mock) {
+      return Promise.reject(
+        new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} ch\u1EC9 ch\u1EA1y trong app Retion`, method)
+      );
+    }
+    const mock = state.mock;
+    return new Promise((resolve) => resolve(mock(method, params))).catch((error) => {
+      throw MiniAppError.from(error, method);
+    });
+  }
+  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 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/apis/route.ts
+var getRouteParams = () => ({ ...getState().context });
+var onContextChange = (listener) => on(CONTEXT_EVENT, (data) => {
+  const { next, prev } = data;
+  listener(next, prev);
+});
+
+export { ErrorCode, MiniAppError, PROTOCOL_VERSION, call, getRouteParams, getState, isInHost, notify, onContextChange };
+//# sourceMappingURL=chunk-PVXYU6XK.js.map
+//# sourceMappingURL=chunk-PVXYU6XK.js.map

package/dist/chunk-PVXYU6XK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/bridge.ts","../src/apis/route.ts"],"names":[],"mappings":"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","file":"chunk-PVXYU6XK.js","sourcesContent":["export const ErrorCode = {\n  /** Không chạy trong app Retion (vd mở trên trình duyệt) và không có mock handler. */\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  /** Tham số truyền vào không hợp lệ. */\n  INVALID_PARAMS: 'INVALID_PARAMS',\n  /** User từ chối / huỷ thao tác. */\n  USER_CANCELLED: 'USER_CANCELLED',\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 / mock (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 { MockHandler, 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  mock: MockHandler | null;\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    mock: null,\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 → mock handler (nếu có) hoặc 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    if (!state.mock) {\n      return Promise.reject(\n        new MiniAppError(ErrorCode.NOT_IN_HOST, `${method} chỉ chạy trong app Retion`, method),\n      );\n    }\n    const mock = state.mock;\n    return new Promise<T>((resolve) => resolve(mock(method, params) as T)).catch((error: unknown) => {\n      throw MiniAppError.from(error, method);\n    });\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","import { CONTEXT_EVENT, getState, on } from '../bridge';\nimport type { RouteParams } from '../types';\n\ntype ContextListener = (next: RouteParams, prev: RouteParams) => void;\n\n/**\n * Param lúc mở mini app: query URL + context host inject (host ưu tiên).\n * @example\n * const { client_id, org_id } = getRouteParams();\n */\nexport const getRouteParams = (): RouteParams => ({ ...getState().context });\n\n/**\n * Host đổi conversation mà KHÔNG reload mini app — chỉ xảy ra khi `miniapp.config.json`\n * có `context_update: true`. Nếu không, host reload với query mới và getRouteParams() vẫn đúng.\n * @returns hàm huỷ đăng ký\n */\nexport const onContextChange = (listener: ContextListener): (() => void) =>\n  on(CONTEXT_EVENT, (data) => {\n    const { next, prev } = data as { next: RouteParams; prev: RouteParams };\n    listener(next, prev);\n  });\n"]}