zmp-sdk 2.52.1-beta.2 → 2.52.1-beta.3

package/apis/apis/addVoucher.js

@@ -1 +1 @@
-import o from'./../external/@swc/helpers/src/_async_to_generator.mjs.js';import n,{object as e,string as r,number as i}from'./../external/zod/lib/index.mjs.js';import t from"../appEnv/index.js";import a from"../common/notFound.js";import{functionHandler as m}from"../utils/decorator.js";import s from"../common/apis/general/addVoucher.js";import{__generator as c}from'./../external/tslib/tslib.es6.js';var p=e({type:n.enum(["url","phone"]),value:r().min(1),cta:r().min(1)}),u=[e({name:r().min(1).max(200),condition:r().min(1).max(500),conditionDetail:r().min(1).max(2e3).optional(),validAt:i().int().nonnegative().optional(),expiredAt:i().int().positive(),code:r().min(1).max(140).optional(),display:n.enum(["qr_code","bar_code"]).default("qr_code").optional(),remindBefore:i().int().positive(),ownerName:r().min(1).max(100).optional(),merchantOaId:r().min(1).max(50),merchantName:r().min(1).max(100),merchantLogoUrl:r().url().max(500),actions:n.array(p).max(2).optional()})];function d(o){return l.apply(this,arguments)}function l(){return l=o((function(n){return c(this,(function(e){return[2,m("addVoucher",u,[n],(r=o((function(o,n){var e;return c(this,(function(r){switch(r.label){case 0:return e=n||o,t.isMp?[4,s(e)]:[3,2];case 1:return[2,r.sent()];case 2:return t.isMpWeb?[2,Promise.resolve()]:[2,Promise.reject(a("addVoucher",{}))]}}))})),function(o,n){return r.apply(this,arguments)}))];var r}))})),l.apply(this,arguments)}export{d as addVoucher};
+import o from'./../external/@swc/helpers/src/_async_to_generator.mjs.js';import n,{object as e,string as t,number as r}from'./../external/zod/lib/index.mjs.js';import i from"../appEnv/index.js";import a from"../common/notFound.js";import{functionHandler as m}from"../utils/decorator.js";import s from"../common/apis/general/addVoucher.js";import{__generator as c}from'./../external/tslib/tslib.es6.js';var p=e({type:n.enum(["url","phone"]),value:t().min(1),cta:t().min(1)}),u=[e({name:t().min(1).max(200),condition:t().min(1).max(500),conditionDetail:t().min(1).max(2e3).optional(),validAt:r().int().nonnegative().optional(),expiredAt:r().int().positive(),code:t().min(1).max(140).optional(),display:n.enum(["qr_code","bar_code"]).default("qr_code").optional(),interactToken:t().min(1).optional(),ownerName:t().min(1).max(100).optional(),merchantOaId:t().min(1).max(50),merchantName:t().min(1).max(100),merchantLogoUrl:t().url().max(500),actions:n.array(p).max(2).optional()})];function l(o){return d.apply(this,arguments)}function d(){return d=o((function(n){return c(this,(function(e){return[2,m("addVoucher",u,[n],(t=o((function(o,n){var e;return c(this,(function(t){switch(t.label){case 0:return e=n||o,i.isMp?[4,s(e)]:[3,2];case 1:return[2,t.sent()];case 2:return i.isMpWeb?[2,Promise.resolve({oa_message_token:""})]:[2,Promise.reject(a("addVoucher",{}))]}}))})),function(o,n){return t.apply(this,arguments)}))];var t}))})),d.apply(this,arguments)}export{l as addVoucher};

package/apis/common/apis/general/addVoucher.js

@@ -1 +1 @@
-import e from'./../../../external/@swc/helpers/src/_async_to_generator.mjs.js';import r from"../../token.js";import{RESPONSE_CODE as n,MESSAGES as t,QRCARD_APIS as o}from"../../../constants.js";import{AppError as i}from"../../../utils/errorHandler.js";import a from"./openWebview.js";import{__generator as s}from'./../../../external/tslib/tslib.es6.js';var d,c=(d=e((function(e){var d,c,m,l,u,E,p;return s(this,(function(s){switch(s.label){case 0:return[4,r.jumpAndGetToken()];case 1:if(s.sent(),!(m=null===(d=r.miniProgramConfig)||void 0===d?void 0:d.jwt))throw new i(n.UNAUTHORIZED,t.LOGIN_REQUIRED);return(l=new URLSearchParams).append("data",JSON.stringify(function(e){return{name:e.name,condition:e.condition,conditionDetail:e.conditionDetail,validAt:e.validAt,expiredAt:e.expiredAt,code:e.code,display:e.display||"qr_code",remindBefore:e.remindBefore,ownerName:e.ownerName,merchantOaId:e.merchantOaId,merchantName:e.merchantName,merchantLogoUrl:e.merchantLogoUrl,actions:e.actions}}(e))),[4,fetch(o.ADD_VOUCHER,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",authorization:"Bearer ".concat(m)},body:l})];case 2:u=s.sent(),s.label=3;case 3:return s.trys.push([3,5,,6]),[4,u.json()];case 4:return E=s.sent(),[3,6];case 5:throw s.sent(),new i(n.VOUCHER_CREATE_FAILED,t.VOUCHER_CREATE_FAILED);case 6:if(0!==(null==E?void 0:E.err))throw new i("number"==typeof(null==E?void 0:E.err)?E.err:n.VOUCHER_CREATE_FAILED,function(e){var r="string"==typeof(null==e?void 0:e.msg)?e.msg.trim():"";return r||(-1===(null==e?void 0:e.err)?"Unknown exception":t.VOUCHER_CREATE_FAILED)}(E));if(!(p=null===(c=E.data)||void 0===c?void 0:c.deeplink))throw new i(n.VOUCHER_CREATE_FAILED,t.VOUCHER_CREATE_FAILED);return[4,a(p)];case 7:return s.sent(),[2]}}))})),function(e){return d.apply(this,arguments)});export{c as default};
+import e from'./../../../external/@swc/helpers/src/_async_to_generator.mjs.js';import n from"../../token.js";import{RESPONSE_CODE as t,MESSAGES as r,QRCARD_APIS as o}from"../../../constants.js";import{AppError as a}from"../../../utils/errorHandler.js";import i from"./openWebview.js";import{__generator as s}from'./../../../external/tslib/tslib.es6.js';var c,d=(c=e((function(e){var c,d,l,m,u,p,E,_,f;return s(this,(function(s){switch(s.label){case 0:return[4,n.jumpAndGetToken()];case 1:if(s.sent(),!(m=null===(c=n.miniProgramConfig)||void 0===c?void 0:c.jwt))throw new a(t.UNAUTHORIZED,r.LOGIN_REQUIRED);return(u=new URLSearchParams).append("data",JSON.stringify(function(e){return{name:e.name,condition:e.condition,conditionDetail:e.conditionDetail,validAt:e.validAt,expiredAt:e.expiredAt,code:e.code,display:e.display||"qr_code",ownerName:e.ownerName,merchantOaId:e.merchantOaId,merchantName:e.merchantName,merchantLogoUrl:e.merchantLogoUrl,actions:e.actions}}(e))),e.interactToken&&u.append("interactToken",e.interactToken),[4,fetch(o.ADD_VOUCHER,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",authorization:"Bearer ".concat(m)},body:u})];case 2:p=s.sent(),s.label=3;case 3:return s.trys.push([3,5,,6]),[4,p.json()];case 4:return E=s.sent(),[3,6];case 5:throw s.sent(),new a(t.VOUCHER_CREATE_FAILED,r.VOUCHER_CREATE_FAILED);case 6:if(0!==(null==E?void 0:E.err))throw new a("number"==typeof(null==E?void 0:E.err)?E.err:t.VOUCHER_CREATE_FAILED,function(e){var n="string"==typeof(null==e?void 0:e.msg)?e.msg.trim():"";return n||(-1===(null==e?void 0:e.err)?"Unknown exception":r.VOUCHER_CREATE_FAILED)}(E));if(_=null===(d=E.data)||void 0===d?void 0:d.deeplink,f=(null===(l=E.data)||void 0===l?void 0:l.oaMessageToken)||"",!_)throw new a(t.VOUCHER_CREATE_FAILED,r.VOUCHER_CREATE_FAILED);return[4,i(_)];case 7:return s.sent(),[2,{oa_message_token:f}]}}))})),function(e){return c.apply(this,arguments)});export{d as default};

package/apis/index.d.ts

@@ -1334,9 +1334,10 @@ type AddVoucherData = {
      */
     display?: VoucherDisplayType;
     /**
-     * Khoảng thời gian trước hạn để gửi nhắc, tính bằng milliseconds.
+     * Token để merchant gửi tin nhắn không tốn phí. Lấy từ callback
+     * `onDataReceived` của `showFunctionButtonWidget`.
      */
-    remindBefore: number;
+    interactToken?: string;
     /**
      * Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
      */
@@ -1358,6 +1359,13 @@ type AddVoucherData = {
      */
     actions?: VoucherAction[];
 };
+type AddVoucherReturns = {
+    /**
+     * Token để merchant gửi tin nhắn OA cho người dùng; chuỗi rỗng nếu server
+     * không trả về.
+     */
+    oa_message_token: string;
+};
 type TempFile = {
     /**
      * Đường dẫn các temp file đã chọn.
@@ -4939,14 +4947,14 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  * API này gửi dữ liệu voucher từ Mini App về server trung gian. Server trung gian
  * chịu trách nhiệm đăng nhập Ví QR, mã hoá dữ liệu bằng `secureKey`, sau đó trả về
  * deeplink thêm thẻ vào Ví QR. SDK sẽ tự mở deeplink này bằng `openWebview` để đưa
- * người dùng tới màn hình thêm thẻ; deeplink không được trả về cho bên gọi.
+ * người dùng tới màn hình thêm thẻ; deeplink không được trả về cho bên gọi, chỉ
+ * trả về `oa_message_token`.
  *
  * @zaloOnly Chỉ hoạt động khi chạy bên trong ứng dụng Zalo mobile.
  *
  * @param {string} name Tên voucher / ưu đãi.
  * @param {string} condition Điều kiện áp dụng (chính), hiển thị trên chi tiết vé.
  * @param {number} expiredAt Hạn sử dụng, epoch milliseconds.
- * @param {number} remindBefore Khoảng thời gian trước hạn để gửi nhắc, tính bằng milliseconds.
  * @param {string} merchantOaId OA ID của merchant trên Zalo.
  * @param {string} merchantName Tên OA / thương hiệu phát hành voucher.
  * @param {string} merchantLogoUrl Logo OA, dùng làm logo hiển thị trên voucher.
@@ -4955,10 +4963,14 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  * @param {string} [code] Mã voucher; không truyền thì tự sinh QR OA của merchant.
  * @param {"qr_code" | "bar_code"} [display="qr_code"] Loại mã hiển thị.
  * @param {string} [ownerName] Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
+ * @param {string} [interactToken] Token để merchant gửi tin nhắn không tốn phí.
+ * Lấy từ callback `onDataReceived` của {@link showFunctionButtonWidget} khi
+ * người dùng nhấn vào Function Button Widget.
  * @param {VoucherAction[]} [actions] Danh sách CTA hiển thị trên thẻ (tối đa 2).
  *
- * @returns {Promise<void>} Promise resolve khi tạo thẻ thành công và deeplink đã
- * được mở; reject kèm mã lỗi từ server nếu thất bại.
+ * @returns {Promise<AddVoucherReturns>} Promise resolve khi tạo thẻ thành công và
+ * deeplink đã được mở, trả về `oa_message_token` (chuỗi rỗng nếu server không
+ * trả về); reject kèm mã lỗi từ server nếu thất bại.
  *
  * @example Thêm voucher vào Ví QR:
  * ```ts
@@ -4966,14 +4978,33 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  *   name: "Giảm 50% giá trị đơn hàng",
  *   condition: "Áp dụng cho hóa đơn trên 200.000đ",
  *   expiredAt: 1743440399000,
- *   remindBefore: 3600000,
  *   merchantOaId: "2646373759294038927",
  *   merchantName: "The Face Shop",
  *   merchantLogoUrl: "https://static.example.com/logo.png",
  * });
  * ```
+ *
+ * @example Gửi kèm `interactToken` lấy từ Function Button Widget:
+ * ```ts
+ * showFunctionButtonWidget({
+ *   id: "orderButton",
+ *   type: "ORDER",
+ *   text: "Tạo đơn hàng",
+ *   onDataReceived: async (interactToken) => {
+ *     await addVoucher({
+ *       name: "Giảm 50% giá trị đơn hàng",
+ *       condition: "Áp dụng cho hóa đơn trên 200.000đ",
+ *       expiredAt: 1743440399000,
+ *       merchantOaId: "2646373759294038927",
+ *       merchantName: "The Face Shop",
+ *       merchantLogoUrl: "https://static.example.com/logo.png",
+ *       interactToken,
+ *     });
+ *   },
+ * });
+ * ```
  */
-declare function addVoucher(args: AsyncCallback<void> & AddVoucherData): Promise<void>;
+declare function addVoucher(args: AsyncCallback<AddVoucherReturns> & AddVoucherData): Promise<AddVoucherReturns>;
 
 declare const interactOAArgs$1: ZodObject<{
     oaId: ZodString;

package/apis/package.json.js

@@ -1 +1 @@
-var a="2.52.1-beta.2";export{a as version};
+var a="2.52.1-beta.3";export{a as version};