@retion-miniapp/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,132 @@
+'use strict';
+
+var chunkC2AZ33LI_cjs = require('./chunk-C2AZ33LI.cjs');
+
+// src/invoke.ts
+var invoke = (method, params, options) => {
+  const promise = chunkC2AZ33LI_cjs.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, chunkC2AZ33LI_cjs.MiniAppError.from(error, method));
+    });
+  }
+  return promise;
+};
+var splitOptions = (options) => {
+  const { success, fail, ...params } = options;
+  return [params, { success, fail }];
+};
+
+// 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 chunkC2AZ33LI_cjs.MiniAppError(chunkC2AZ33LI_cjs.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);
+  }
+  return invoke("openWebview", params, callbacks);
+};
+var showToast = (options) => {
+  const [params, callbacks] = splitOptions(options);
+  return invoke("showToast", params, callbacks);
+};
+var getSystemInfo = async (options) => {
+  var _a, _b, _c;
+  const base = { platform: "web", sdkVersion: SDK_VERSION, inHost: chunkC2AZ33LI_cjs.isInHost() };
+  if (!chunkC2AZ33LI_cjs.isInHost()) {
+    (_a = options == null ? void 0 : options.success) == null ? void 0 : _a.call(options, base);
+    return base;
+  }
+  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 = chunkC2AZ33LI_cjs.MiniAppError.from(error, "getSystemInfo");
+    (_c = options == null ? void 0 : options.fail) == null ? void 0 : _c.call(options, normalized);
+    throw normalized;
+  }
+};
+var notifyReady = () => chunkC2AZ33LI_cjs.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/apis/page.ts
+var getPageInfo = (options) => invoke("getPageInfo", void 0, options);
+
+// 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 chunkC2AZ33LI_cjs.MiniAppError(chunkC2AZ33LI_cjs.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);
+  }
+  return invoke(method, params, callbacks);
+};
+var sendMessage = (options) => withText("sendMessage", options);
+var insertText = (options) => withText("insertText", options);
+
+// src/apis/dev.ts
+var setMockHandler = (handler) => {
+  chunkC2AZ33LI_cjs.getState().mock = handler;
+};
+
+// src/index.ts
+if (typeof window !== "undefined") {
+  chunkC2AZ33LI_cjs.getState();
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", notifyReady, { once: true });
+  } else {
+    queueMicrotask(notifyReady);
+  }
+}
+
+Object.defineProperty(exports, "ErrorCode", {
+  enumerable: true,
+  get: function () { return chunkC2AZ33LI_cjs.ErrorCode; }
+});
+Object.defineProperty(exports, "MiniAppError", {
+  enumerable: true,
+  get: function () { return chunkC2AZ33LI_cjs.MiniAppError; }
+});
+Object.defineProperty(exports, "PROTOCOL_VERSION", {
+  enumerable: true,
+  get: function () { return chunkC2AZ33LI_cjs.PROTOCOL_VERSION; }
+});
+Object.defineProperty(exports, "getRouteParams", {
+  enumerable: true,
+  get: function () { return chunkC2AZ33LI_cjs.getRouteParams; }
+});
+Object.defineProperty(exports, "isInHost", {
+  enumerable: true,
+  get: function () { return chunkC2AZ33LI_cjs.isInHost; }
+});
+Object.defineProperty(exports, "onContextChange", {
+  enumerable: true,
+  get: function () { return chunkC2AZ33LI_cjs.onContextChange; }
+});
+exports.SDK_VERSION = SDK_VERSION;
+exports.closeApp = closeApp;
+exports.getAccessToken = getAccessToken;
+exports.getPageInfo = getPageInfo;
+exports.getSystemInfo = getSystemInfo;
+exports.getUserInfo = getUserInfo;
+exports.insertText = insertText;
+exports.openWebview = openWebview;
+exports.sendMessage = sendMessage;
+exports.setMockHandler = setMockHandler;
+exports.showToast = showToast;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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":"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","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"]}

package/dist/index.d.cts

@@ -0,0 +1,131 @@
+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';
+
+type ContextListener = (next: RouteParams, prev: RouteParams) => void;
+/**
+ * Param lúc mở mini app: query URL + context host inject (host ưu tiên).
+ * @example
+ * const { client_id, org_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.
+ */
+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>;
+
+/**
+ * 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).
+ */
+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>;
+
+/**
+ * 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));
+ * }
+ */
+declare const setMockHandler: (handler: MockHandler | null) => void;
+
+/**
+ * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.
+ *
+ * Giao thức v1
+ *  web → host : ReactNativeWebView.postMessage(JSON.stringify(RequestMessage))
+ *  host → web : window.__RETION_MINIAPP__.receive(ResponseMessage | EventMessage)
+ *  host inject trước khi trang chạy:
+ *    window.__RETION_MINIAPP_HOST__    = { protocol }  ← đánh dấu host hỗ trợ SDK
+ *    window.__RETION_MINIAPP_CONTEXT__ = RouteParams    ← context ban đầu
+ *
+ * Chỉ có ReactNativeWebView KHÔNG đủ để coi là host: màn iframe cũ của app cũng là RN WebView
+ * 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.
+ *
+ * State đặt trên window (singleton): nhiều bản SDK trong cùng trang (trùng version trong
+ * 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;
+    error?: undefined;
+} | {
+    id: string;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+interface EventMessage {
+    event: string;
+    data?: unknown;
+}
+interface HostInfo {
+    /** Phiên bản giao thức host hỗ trợ. */
+    protocol: number;
+}
+type Listener = (data: unknown) => void;
+interface Pending {
+    method: string;
+    resolve: (value: unknown) => void;
+    reject: (error: MiniAppError) => void;
+    timer: ReturnType<typeof setTimeout>;
+}
+interface BridgeState {
+    protocol: number;
+    seq: number;
+    pending: Map<string, Pending>;
+    listeners: Map<string, Set<Listener>>;
+    mock: MockHandler | null;
+    context: RouteParams;
+    receive: (message: ResponseMessage | EventMessage) => void;
+}
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage: (message: string) => void;
+        };
+        __RETION_MINIAPP__?: BridgeState;
+        __RETION_MINIAPP_CONTEXT__?: RouteParams;
+        __RETION_MINIAPP_HOST__?: HostInfo;
+    }
+}
+/** Đang chạy trong app Retion có hỗ trợ SDK (host đã inject marker + kênh postMessage). */
+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 };

package/dist/index.d.ts

@@ -0,0 +1,131 @@
+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';
+
+type ContextListener = (next: RouteParams, prev: RouteParams) => void;
+/**
+ * Param lúc mở mini app: query URL + context host inject (host ưu tiên).
+ * @example
+ * const { client_id, org_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.
+ */
+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>;
+
+/**
+ * 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).
+ */
+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>;
+
+/**
+ * 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));
+ * }
+ */
+declare const setMockHandler: (handler: MockHandler | null) => void;
+
+/**
+ * Bridge web mini app ↔ host (app Retion). Nội bộ SDK — dev mini app không import trực tiếp.
+ *
+ * Giao thức v1
+ *  web → host : ReactNativeWebView.postMessage(JSON.stringify(RequestMessage))
+ *  host → web : window.__RETION_MINIAPP__.receive(ResponseMessage | EventMessage)
+ *  host inject trước khi trang chạy:
+ *    window.__RETION_MINIAPP_HOST__    = { protocol }  ← đánh dấu host hỗ trợ SDK
+ *    window.__RETION_MINIAPP_CONTEXT__ = RouteParams    ← context ban đầu
+ *
+ * Chỉ có ReactNativeWebView KHÔNG đủ để coi là host: màn iframe cũ của app cũng là RN WebView
+ * 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.
+ *
+ * State đặt trên window (singleton): nhiều bản SDK trong cùng trang (trùng version trong
+ * 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;
+    error?: undefined;
+} | {
+    id: string;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+interface EventMessage {
+    event: string;
+    data?: unknown;
+}
+interface HostInfo {
+    /** Phiên bản giao thức host hỗ trợ. */
+    protocol: number;
+}
+type Listener = (data: unknown) => void;
+interface Pending {
+    method: string;
+    resolve: (value: unknown) => void;
+    reject: (error: MiniAppError) => void;
+    timer: ReturnType<typeof setTimeout>;
+}
+interface BridgeState {
+    protocol: number;
+    seq: number;
+    pending: Map<string, Pending>;
+    listeners: Map<string, Set<Listener>>;
+    mock: MockHandler | null;
+    context: RouteParams;
+    receive: (message: ResponseMessage | EventMessage) => void;
+}
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage: (message: string) => void;
+        };
+        __RETION_MINIAPP__?: BridgeState;
+        __RETION_MINIAPP_CONTEXT__?: RouteParams;
+        __RETION_MINIAPP_HOST__?: HostInfo;
+    }
+}
+/** Đang chạy trong app Retion có hỗ trợ SDK (host đã inject marker + kênh postMessage). */
+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 };

package/dist/index.js

@@ -0,0 +1,97 @@
+import { getState, notify, MiniAppError, ErrorCode, isInHost, call } from './chunk-PVXYU6XK.js';
+export { ErrorCode, MiniAppError, PROTOCOL_VERSION, getRouteParams, isInHost, onContextChange } from './chunk-PVXYU6XK.js';
+
+// 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));
+    });
+  }
+  return promise;
+};
+var splitOptions = (options) => {
+  const { success, fail, ...params } = options;
+  return [params, { success, fail }];
+};
+
+// 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);
+  }
+  return invoke("openWebview", params, callbacks);
+};
+var showToast = (options) => {
+  const [params, callbacks] = splitOptions(options);
+  return invoke("showToast", params, callbacks);
+};
+var getSystemInfo = async (options) => {
+  var _a, _b, _c;
+  const base = { platform: "web", sdkVersion: SDK_VERSION, inHost: isInHost() };
+  if (!isInHost()) {
+    (_a = options == null ? void 0 : options.success) == null ? void 0 : _a.call(options, base);
+    return base;
+  }
+  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;
+  }
+};
+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/apis/page.ts
+var getPageInfo = (options) => invoke("getPageInfo", void 0, options);
+
+// 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);
+  }
+  return invoke(method, params, callbacks);
+};
+var sendMessage = (options) => withText("sendMessage", options);
+var insertText = (options) => withText("insertText", options);
+
+// src/apis/dev.ts
+var setMockHandler = (handler) => {
+  getState().mock = handler;
+};
+
+// src/index.ts
+if (typeof window !== "undefined") {
+  getState();
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", notifyReady, { once: true });
+  } else {
+    queueMicrotask(notifyReady);
+  }
+}
+
+export { SDK_VERSION, closeApp, getAccessToken, getPageInfo, getSystemInfo, getUserInfo, insertText, openWebview, sendMessage, setMockHandler, showToast };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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":[],"mappings":"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","file":"index.js","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"]}

package/dist/types-8g8OpZsj.d.cts

@@ -0,0 +1,65 @@
+declare const ErrorCode: {
+    /** Không chạy trong app Retion (vd mở trên trình duyệt) và không có mock handler. */
+    readonly NOT_IN_HOST: "NOT_IN_HOST";
+    /** Host không phản hồi trong thời gian chờ. */
+    readonly TIMEOUT: "TIMEOUT";
+    /** Host (phiên bản app hiện tại) chưa hỗ trợ API này. */
+    readonly NOT_SUPPORTED: "NOT_SUPPORTED";
+    /** Tham số truyền vào không hợp lệ. */
+    readonly INVALID_PARAMS: "INVALID_PARAMS";
+    /** User từ chối / huỷ thao tác. */
+    readonly USER_CANCELLED: "USER_CANCELLED";
+    /** 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 / mock (object thuần, Error, string) về MiniAppError. */
+    static from(error: unknown, method?: string): MiniAppError;
+}
+
+/** Param theo conversation mà host truyền khi mở mini app. */
+interface RouteParams {
+    /** Page (kênh) đang mở mini app. Mỗi page là 1 instance mini app riêng. */
+    page_id?: string;
+    /** Khách hàng của conversation. Đổi trong cùng page → onContextChange (nếu context_update). */
+    client_id?: string;
+    org_id?: string;
+    message_id?: string;
+    comment_id?: string;
+    locale?: string;
+    is_page_admin?: string | number;
+    [key: string]: unknown;
+}
+/** Callback thay cho await (tuỳ chọn). */
+interface CallbackOptions<T> {
+    success?: (result: T) => void;
+    fail?: (error: MiniAppError) => void;
+}
+type MockHandler = (method: string, params: unknown) => unknown;
+interface UserInfo {
+    id: string;
+    name: string;
+    avatar?: string;
+    role?: string;
+}
+interface SystemInfo {
+    platform: 'ios' | 'android' | 'web';
+    /** Version app host (undefined khi chạy ngoài app). */
+    appVersion?: string;
+    sdkVersion: string;
+    inHost: boolean;
+    theme?: 'light' | 'dark';
+}
+interface PageInfo {
+    page_id: string;
+    name: string;
+    avatar?: string;
+    /** Kênh của page: facebook, zalo, instagram, chatwork, ... */
+    platform: string;
+}
+
+export { type CallbackOptions as C, ErrorCode as E, type MockHandler as M, type PageInfo as P, type RouteParams as R, type SystemInfo as S, type UserInfo as U, MiniAppError as a };