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

package/apis/apis/addVoucher.js

@@ -1 +1 @@
-import n from'./../external/@swc/helpers/src/_async_to_generator.mjs.js';import o,{object as e,string as t,number as i}from'./../external/zod/lib/index.mjs.js';import r 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 l}from'./../external/tslib/tslib.es6.js';var p=e({type:o.enum(["url","phone"]),value:t().min(1),cta:t().min(1)}),c=[e({title:t().min(1).max(200),code:t().min(1).max(140),display:o.enum(["qr_code","bar_code"]).default("qr_code").optional(),name:t().min(1).max(200),desc:t().min(1).max(500).optional(),avatarUrl:t().url().max(500).optional(),partner:t().min(1).optional(),merchantName:t().min(1).max(100),merchantOaId:t().min(1).max(50),merchantLogoUrl:t().url().max(500).optional(),ownerName:t().min(1).max(100),condition:t().min(1).max(500),conditionDetail:t().min(1).max(2e3).optional(),validAt:i().int().nonnegative().optional(),expiredAt:i().int().positive(),remindAt:i().int().nonnegative().optional(),actions:o.array(p).max(3).optional()})];function u(n){return d.apply(this,arguments)}function d(){return d=n((function(o){return l(this,(function(e){return[2,m("addVoucher",c,[o],(t=n((function(n,o){var e;return l(this,(function(t){switch(t.label){case 0:return e=o||n,r.isMp?[4,s(e)]:[3,2];case 1:return[2,t.sent()];case 2:return r.isMpWeb?[2,Promise.resolve()]:[2,Promise.reject(a("addVoucher",{}))]}}))})),function(n,o){return t.apply(this,arguments)}))];var t}))})),d.apply(this,arguments)}export{u 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 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;return s(this,(function(s){switch(s.label){case 0:return[4,r.jumpAndGetToken()];case 1:if(s.sent(),!(l=null===(c=r.miniProgramConfig)||void 0===c?void 0:c.jwt))throw new a(n.UNAUTHORIZED,t.LOGIN_REQUIRED);return(m=new URLSearchParams).append("data",JSON.stringify(function(e){return{title:e.title,code:e.code,display:e.display||"qr_code",name:e.name,desc:e.desc||e.ownerName,avatarUrl:e.avatarUrl||e.merchantLogoUrl,partner:e.partner,merchantName:e.merchantName,merchantOaId:e.merchantOaId,merchantLogoUrl:e.merchantLogoUrl,ownerName:e.ownerName,condition:e.condition,conditionDetail:e.conditionDetail,validAt:e.validAt,expiredAt:e.expiredAt,remindAt:e.remindAt,actions:e.actions}}(e))),[4,fetch(o.ADD_VOUCHER,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",authorization:"Bearer ".concat(l)},body:m})];case 2:u=s.sent(),s.label=3;case 3:return s.trys.push([3,5,,6]),[4,u.json()];case 4:return p=s.sent(),[3,6];case 5:throw s.sent(),new a(n.VOUCHER_CREATE_FAILED,t.VOUCHER_CREATE_FAILED);case 6:if(0!==(null==p?void 0:p.err))throw new a("number"==typeof(null==p?void 0:p.err)?p.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)}(p));if(!(E=null===(d=p.data)||void 0===d?void 0:d.deeplink))throw new a(n.VOUCHER_CREATE_FAILED,t.VOUCHER_CREATE_FAILED);return[4,i(E)];case 7:return s.sent(),[2]}}))})),function(e){return c.apply(this,arguments)});export{d 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

@@ -1305,74 +1305,66 @@ type VoucherAction = {
     cta: string;
 };
 type AddVoucherData = {
-    /**
-     * Tiêu đề hiển thị trên card.
-     */
-    title: string;
-    /**
-     * Nội dung encode vào QR hoặc barcode.
-     */
-    code: string;
-    /**
-     * Loại mã hiển thị. Mặc định là `qr_code`.
-     */
-    display?: VoucherDisplayType;
     /**
      * Tên voucher / ưu đãi.
      */
     name: string;
     /**
-     * Tên chủ thẻ hiển thị phụ dưới tên voucher. Mặc định dùng `ownerName`.
+     * Điều kiện áp dụng (chính), hiển thị trên chi tiết vé.
      */
-    desc?: string;
+    condition: string;
     /**
-     * Logo hiển thị trên card. Mặc định dùng `merchantLogoUrl`.
+     * Điều kiện áp dụng chi tiết (phụ).
      */
-    avatarUrl?: string;
+    conditionDetail?: string;
     /**
-     * Nguồn phát hành voucher.
+     * Thời gian bắt đầu hiệu lực, epoch milliseconds.
      */
-    partner?: string;
+    validAt?: number;
     /**
-     * Tên thương hiệu / cửa hàng phát hành voucher.
+     * Hạn sử dụng, epoch milliseconds.
      */
-    merchantName: string;
+    expiredAt: number;
     /**
-     * OA ID của merchant trên Zalo.
+     * Mã voucher; không truyền thì tự sinh QR OA của merchant.
      */
-    merchantOaId: string;
+    code?: string;
     /**
-     * Logo merchant.
+     * Loại mã hiển thị. Mặc định là `qr_code`.
      */
-    merchantLogoUrl?: string;
+    display?: VoucherDisplayType;
     /**
-     * Tên người nhận voucher.
+     * Token để merchant gửi tin nhắn không tốn phí. Lấy từ callback
+     * `onDataReceived` của `showFunctionButtonWidget`.
      */
-    ownerName: string;
+    interactToken?: string;
     /**
-     * Điều kiện sử dụng tóm tắt.
+     * Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
      */
-    condition: string;
+    ownerName?: string;
     /**
-     * Điều kiện sử dụng đầy đủ.
+     * OA ID của merchant trên Zalo.
      */
-    conditionDetail?: string;
+    merchantOaId: string;
     /**
-     * Thời điểm bắt đầu hiệu lực, epoch milliseconds.
+     * Tên OA / thương hiệu phát hành voucher.
      */
-    validAt?: number;
+    merchantName: string;
     /**
-     * Thời điểm hết hạn, epoch milliseconds.
+     * Logo OA, dùng làm logo hiển thị trên voucher.
      */
-    expiredAt: number;
+    merchantLogoUrl: string;
     /**
-     * Thời điểm gửi nhắc hạn, epoch milliseconds.
+     * Danh sách CTA hiển thị trên thẻ (tối đa 2).
      */
-    remindAt?: number;
+    actions?: VoucherAction[];
+};
+type AddVoucherReturns = {
     /**
-     * Danh sách CTA hiển thị trên thẻ.
+     * Token để merchant gửi tin nhắn OA cho người dùng; chuỗi rỗng nếu server
+     * không trả về.
      */
-    actions?: VoucherAction[];
+    oa_message_token: string;
 };
 type TempFile = {
     /**
@@ -4955,39 +4947,64 @@ 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} code Nội dung encode vào QR hoặc barcode.
- * @param {"qr_code" | "bar_code"} [display="qr_code"] Loại mã hiển thị.
- * @param {string} merchantName Tên thương hiệu / cửa hàng phát hành voucher.
+ * @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 {string} merchantOaId OA ID của merchant trên Zalo.
- * @param {string} ownerName Tên người nhận voucher.
- * @param {string} condition Điều kiện sử dụng tóm tắt.
- * @param {number} expiredAt Thời điểm hết hạn, epoch milliseconds.
- * @param {number} [remindAt] Thời điểm gửi nhắc hạn, epoch milliseconds.
- * @param {VoucherAction[]} [actions] Danh sách CTA hiển thị trên thẻ.
+ * @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.
+ * @param {string} [conditionDetail] Điều kiện áp dụng chi tiết (phụ).
+ * @param {number} [validAt] Thời gian bắt đầu hiệu lực, epoch milliseconds.
+ * @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
  * await addVoucher({
- *   name: "Giảm 50k cho đơn từ 150k",
- *   code: "SPFOOD50K",
- *   merchantName: "Shopee Food",
- *   merchantOaId: "2712772826697148176",
- *   ownerName: "Nguyễn Văn A",
- *   condition: "Áp dụng cho đơn từ 150.000đ.",
- *   expiredAt: 1751299200000,
- *   remindAt: 1751212800000,
+ *   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",
+ * });
+ * ```
+ *
+ * @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.1";export{a as version};
+var a="2.52.1-beta.3";export{a as version};