@retion-miniapp/sdk 0.8.2 → 0.8.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.8.4 — 2026-10-28
+
+### Docs
+- Chuẩn hoá Face ID / Touch ID và nhận dạng giọng nói thành các mục chính, có phân cách rõ ràng và nằm trước xử lý lỗi.
+
+
+## 0.8.3 — 2026-10-28
+
+### Docs
+- Gom hướng dẫn API native, Face ID và speech trước phần xử lý lỗi trong README. Không thay đổi API.
+
+
 ## 0.8.2 — 2026-10-28
 
 ### Docs

package/README.md

@@ -261,54 +261,10 @@ haptic(HapticType.notificationSuccess); // thanh toán xong
 | `rigid` / `soft` | Va chạm cứng / mềm |
 | `notificationSuccess` / `notificationWarning` / `notificationError` | Kết quả thao tác |
 
----
-
-## Lỗi
-
-Mọi lỗi là `MiniAppError`, có `code` (loại lỗi) và `method` (hàm gây lỗi).
-
-```ts
-import { getToken, MiniAppError, ErrorCode } from '@retion-miniapp/sdk';
-
-try {
-  await getToken('chatbox');
-} catch (e) {
-  if (e instanceof MiniAppError && e.code === ErrorCode.PERMISSION_DENIED) {
-    // chưa được cấp quyền chatbox_token
-  }
-}
-```
-
-| `code` | Khi nào |
-|---|---|
-| `NOT_IN_HOST` | Chạy ngoài app mà gọi hàm cần app |
-| `PERMISSION_DENIED` | Chưa được cấp quyền lấy token đó |
-| `TIMEOUT` | App không phản hồi sau 15s (thanh toán / in: 10 phút) |
-| `NOT_SUPPORTED` | Phiên bản app hiện tại chưa hỗ trợ hàm này |
-| `CANCELLED` | Người dùng huỷ (thanh toán, chọn máy in…) |
-| `BUSY` | Đang thanh toán / in mà gọi lần nữa |
-| `HOST_ERROR` | Lỗi khác phía app (vd page chưa có token) |
 
 ---
 
-## TypeScript
-
-Kèm sẵn type. `RouteParams`, `TokenType`, `PaymentRequest`, `PaymentResult`, `PrintImageRequest`, `OpenScreenRequest`,
-`MiniAppError`, `ErrorCode` export từ package.
-
-```ts
-import type { RouteParams, TokenType } from '@retion-miniapp/sdk';
-```
-
----
-
-Build + deploy lên app: [`@retion-miniapp/cli`](https://www.npmjs.com/package/@retion-miniapp/cli).
-
-## License
-
-MIT
-
-### Face ID / Touch ID / Android biometrics
+## Face ID / Touch ID / Android biometrics
 
 Kiểm tra thiết bị hỗ trợ rồi yêu cầu xác thực:
 
@@ -344,7 +300,9 @@ async function authenticate() {
 
 Kiểm tra `result.success` trước khi tiếp tục. Người dùng huỷ có thể trả `{ success: false, error: 'User cancellation' }`; lỗi khác có thể đi vào `catch`. Loại xác thực do thiết bị quyết định: `FaceID`, `TouchID` hoặc `Biometrics` trên Android.
 
-### Nhận dạng giọng nói
+---
+
+## Nhận dạng giọng nói
 
 Đăng ký nhận văn bản trước khi bắt đầu nghe:
 
@@ -391,3 +349,50 @@ Các tuỳ chọn khác: `continuous` (mặc định `true`), `interimResults` (
 Giữ listener sau khi gọi dừng để nhận câu cuối nếu có, và chờ `speech.end`. Nếu cần lưu câu cuối khi rời màn hình, đợi event kết thúc trước khi dọn listener. Huỷ listener không tự dừng nghe.
 
 Lỗi bắt đầu/dừng đi vào `catch`; lỗi trong phiên đến qua `speech.error`. `BUSY` nghĩa là đang có phiên khác, `PERMISSION_DENIED` là chưa được cấp quyền, `NOT_SUPPORTED` là tính năng chưa được hỗ trợ. Xem thêm [xử lý lỗi](#lỗi).
+
+---
+
+## Lỗi
+
+Mọi lỗi là `MiniAppError`, có `code` (loại lỗi) và `method` (hàm gây lỗi).
+
+```ts
+import { getToken, MiniAppError, ErrorCode } from '@retion-miniapp/sdk';
+
+try {
+  await getToken('chatbox');
+} catch (e) {
+  if (e instanceof MiniAppError && e.code === ErrorCode.PERMISSION_DENIED) {
+    // chưa được cấp quyền chatbox_token
+  }
+}
+```
+
+| `code` | Khi nào |
+|---|---|
+| `NOT_IN_HOST` | Chạy ngoài app mà gọi hàm cần app |
+| `PERMISSION_DENIED` | Chưa được cấp quyền lấy token đó |
+| `TIMEOUT` | App không phản hồi sau 15s (thanh toán / in: 10 phút) |
+| `NOT_SUPPORTED` | Phiên bản app hiện tại chưa hỗ trợ hàm này |
+| `CANCELLED` | Người dùng huỷ (thanh toán, chọn máy in…) |
+| `BUSY` | Đang thanh toán / in mà gọi lần nữa |
+| `HOST_ERROR` | Lỗi khác phía app (vd page chưa có token) |
+
+---
+
+## TypeScript
+
+Kèm sẵn type. `RouteParams`, `TokenType`, `PaymentRequest`, `PaymentResult`, `PrintImageRequest`, `OpenScreenRequest`,
+`MiniAppError`, `ErrorCode` export từ package.
+
+```ts
+import type { RouteParams, TokenType } from '@retion-miniapp/sdk';
+```
+
+---
+
+Build + deploy lên app: [`@retion-miniapp/cli`](https://www.npmjs.com/package/@retion-miniapp/cli).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -157,7 +157,7 @@ var on = (event, listener) => {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.8.2" ;
+var SDK_VERSION = "0.8.4" ;
 
 // src/apis/app.ts
 var closeApp = () => call("closeApp");

package/dist/index.js

@@ -155,7 +155,7 @@ var on = (event, listener) => {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.8.2" ;
+var SDK_VERSION = "0.8.4" ;
 
 // src/apis/app.ts
 var closeApp = () => call("closeApp");

package/package.json

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