@retion-miniapp/sdk 0.8.2 → 0.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.8.3 — 2026-10-28
4
+
5
+ ### Docs
6
+ - 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.
7
+
8
+
3
9
  ## 0.8.2 — 2026-10-28
4
10
 
5
11
  ### Docs
package/README.md CHANGED
@@ -261,52 +261,6 @@ haptic(HapticType.notificationSuccess); // thanh toán xong
261
261
  | `rigid` / `soft` | Va chạm cứng / mềm |
262
262
  | `notificationSuccess` / `notificationWarning` / `notificationError` | Kết quả thao tác |
263
263
 
264
- ---
265
-
266
- ## Lỗi
267
-
268
- Mọi lỗi là `MiniAppError`, có `code` (loại lỗi) và `method` (hàm gây lỗi).
269
-
270
- ```ts
271
- import { getToken, MiniAppError, ErrorCode } from '@retion-miniapp/sdk';
272
-
273
- try {
274
- await getToken('chatbox');
275
- } catch (e) {
276
- if (e instanceof MiniAppError && e.code === ErrorCode.PERMISSION_DENIED) {
277
- // chưa được cấp quyền chatbox_token
278
- }
279
- }
280
- ```
281
-
282
- | `code` | Khi nào |
283
- |---|---|
284
- | `NOT_IN_HOST` | Chạy ngoài app mà gọi hàm cần app |
285
- | `PERMISSION_DENIED` | Chưa được cấp quyền lấy token đó |
286
- | `TIMEOUT` | App không phản hồi sau 15s (thanh toán / in: 10 phút) |
287
- | `NOT_SUPPORTED` | Phiên bản app hiện tại chưa hỗ trợ hàm này |
288
- | `CANCELLED` | Người dùng huỷ (thanh toán, chọn máy in…) |
289
- | `BUSY` | Đang thanh toán / in mà gọi lần nữa |
290
- | `HOST_ERROR` | Lỗi khác phía app (vd page chưa có token) |
291
-
292
- ---
293
-
294
- ## TypeScript
295
-
296
- Kèm sẵn type. `RouteParams`, `TokenType`, `PaymentRequest`, `PaymentResult`, `PrintImageRequest`, `OpenScreenRequest`,
297
- `MiniAppError`, `ErrorCode` export từ package.
298
-
299
- ```ts
300
- import type { RouteParams, TokenType } from '@retion-miniapp/sdk';
301
- ```
302
-
303
- ---
304
-
305
- Build + deploy lên app: [`@retion-miniapp/cli`](https://www.npmjs.com/package/@retion-miniapp/cli).
306
-
307
- ## License
308
-
309
- MIT
310
264
 
311
265
  ### Face ID / Touch ID / Android biometrics
312
266
 
@@ -391,3 +345,50 @@ Các tuỳ chọn khác: `continuous` (mặc định `true`), `interimResults` (
391
345
  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.
392
346
 
393
347
  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).
348
+
349
+ ---
350
+
351
+ ## Lỗi
352
+
353
+ Mọi lỗi là `MiniAppError`, có `code` (loại lỗi) và `method` (hàm gây lỗi).
354
+
355
+ ```ts
356
+ import { getToken, MiniAppError, ErrorCode } from '@retion-miniapp/sdk';
357
+
358
+ try {
359
+ await getToken('chatbox');
360
+ } catch (e) {
361
+ if (e instanceof MiniAppError && e.code === ErrorCode.PERMISSION_DENIED) {
362
+ // chưa được cấp quyền chatbox_token
363
+ }
364
+ }
365
+ ```
366
+
367
+ | `code` | Khi nào |
368
+ |---|---|
369
+ | `NOT_IN_HOST` | Chạy ngoài app mà gọi hàm cần app |
370
+ | `PERMISSION_DENIED` | Chưa được cấp quyền lấy token đó |
371
+ | `TIMEOUT` | App không phản hồi sau 15s (thanh toán / in: 10 phút) |
372
+ | `NOT_SUPPORTED` | Phiên bản app hiện tại chưa hỗ trợ hàm này |
373
+ | `CANCELLED` | Người dùng huỷ (thanh toán, chọn máy in…) |
374
+ | `BUSY` | Đang thanh toán / in mà gọi lần nữa |
375
+ | `HOST_ERROR` | Lỗi khác phía app (vd page chưa có token) |
376
+
377
+ ---
378
+
379
+ ## TypeScript
380
+
381
+ Kèm sẵn type. `RouteParams`, `TokenType`, `PaymentRequest`, `PaymentResult`, `PrintImageRequest`, `OpenScreenRequest`,
382
+ `MiniAppError`, `ErrorCode` export từ package.
383
+
384
+ ```ts
385
+ import type { RouteParams, TokenType } from '@retion-miniapp/sdk';
386
+ ```
387
+
388
+ ---
389
+
390
+ Build + deploy lên app: [`@retion-miniapp/cli`](https://www.npmjs.com/package/@retion-miniapp/cli).
391
+
392
+ ## License
393
+
394
+ MIT
package/dist/index.cjs CHANGED
@@ -157,7 +157,7 @@ var on = (event, listener) => {
157
157
  };
158
158
 
159
159
  // src/version.ts
160
- var SDK_VERSION = "0.8.2" ;
160
+ var SDK_VERSION = "0.8.3" ;
161
161
 
162
162
  // src/apis/app.ts
163
163
  var closeApp = () => call("closeApp");
package/dist/index.js CHANGED
@@ -155,7 +155,7 @@ var on = (event, listener) => {
155
155
  };
156
156
 
157
157
  // src/version.ts
158
- var SDK_VERSION = "0.8.2" ;
158
+ var SDK_VERSION = "0.8.3" ;
159
159
 
160
160
  // src/apis/app.ts
161
161
  var closeApp = () => call("closeApp");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@retion-miniapp/sdk",
3
- "version": "0.8.2",
3
+ "version": "0.8.3",
4
4
  "description": "Retion Mini App SDK — kết nối web mini app với app Retion",
5
5
  "keywords": [
6
6
  "retion",