@warriorteam/redai-zalo-sdk 1.8.1 → 1.9.1

package/CHANGELOG.md

@@ -5,6 +5,106 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.1] - 2025-01-11
+
+### 🔧 FIXED
+
+#### Group Management API Response Structure
+- **FIXED**: `GroupCreateResult` interface to match Zalo API response 100%
+- **CHANGED**: Response structure from flat object to proper wrapper with `data`, `error`, `message`
+- **ADDED**: `GroupCreateData` interface for the actual group data
+- **ADDED**: `extractGroupData()` helper method to extract data from response
+
+#### Response Structure Corrections
+- **FIXED**: Field names to match Zalo API exactly:
+  - `group_name` → `name`
+  - `member_count` → `total_member`
+  - Added missing fields: `group_link`, `group_description`, `status`
+  - Removed non-existent field: `created_time`
+
+### 📋 Migration Guide
+
+**Before (v1.9.0) - BROKEN:**
+```typescript
+const result = await groupService.createGroup(token, groupData);
+// result.group_name ❌ Field doesn't exist
+// result.member_count ❌ Field doesn't exist
+```
+
+**After (v1.9.1) - CORRECT:**
+```typescript
+const result = await groupService.createGroup(token, groupData);
+// Full response: result.data, result.error, result.message
+const groupData = result.data; // or use extractGroupData(result)
+// groupData.name ✅ Correct field name
+// groupData.total_member ✅ Correct field name
+// groupData.group_link ✅ Available
+// groupData.status ✅ Available
+```
+
+## [1.9.0] - 2025-01-11
+
+### 🚨 BREAKING CHANGES
+
+#### ZNS Template API Complete Restructure
+- **FIXED**: `ZNSUpdateTemplateRequest` interface to match Zalo API docs 100%
+- **FIXED**: `ZNSCreateTemplateRequest` interface to match Zalo API docs 100%
+- **CHANGED**: Field names from camelCase to snake_case (e.g., `templateId` → `template_id`)
+- **ADDED**: Required fields: `template_type`, `tag`, `layout`, `tracking_id`
+- **REMOVED**: Non-existent fields: `templateContent`, `timeout`, `previewUrl`
+- **FIXED**: `params` structure to match Zalo API specification
+
+#### New ZNS Template Structure
+- **ADDED**: `ZNSTemplateLayout` interface with proper header/body/footer components
+- **ADDED**: `ZNSLayoutComponent` interface supporting all Zalo component types
+- **ADDED**: `ZNSTemplateParam` interface with correct param type structure
+- **ADDED**: `ZNSTemplateCreateEditResponse` interface for API responses
+
+#### New Enums and Constants
+- **ADDED**: `ZNSTemplateType` enum (1-5 for different template types)
+- **ADDED**: `ZNSTemplateTag` enum ("1"-"3" for Transaction/Customer Care/Promotion)
+- **ADDED**: `ZNSButtonType` enum (1-8 for different button types)
+- **ADDED**: `ZNSParamType` enum ("1"-"15" for different parameter types)
+- **ADDED**: `ZNS_TEMPLATE_TYPES`, `ZNS_TEMPLATE_TAGS`, `ZNS_BUTTON_TYPES`, `ZNS_PARAM_TYPES` constants
+- **ADDED**: `ZNSValidation` helper functions for validation
+
+### 📋 Migration Guide
+
+**Before (v1.8.1) - BROKEN:**
+```typescript
+const templateData: ZNSUpdateTemplateRequest = {
+  templateId: "123",
+  templateName: "Test",
+  templateContent: "Hello", // ❌ Field doesn't exist in Zalo API
+  templateTag: "1" // ❌ Wrong field name
+};
+```
+
+**After (v1.9.0) - CORRECT:**
+```typescript
+const templateData: ZNSUpdateTemplateRequest = {
+  template_id: "123",
+  template_name: "Test Template",
+  template_type: ZNSTemplateType.CUSTOM,
+  tag: ZNSTemplateTag.TRANSACTION,
+  layout: {
+    body: {
+      components: [
+        { TITLE: { value: "Hello World" } }
+      ]
+    }
+  },
+  tracking_id: "track_001"
+};
+```
+
+### 🔧 Technical Details
+
+- **API Compliance**: Now 100% matches official Zalo API documentation
+- **Validation**: Added comprehensive validation functions
+- **Type Safety**: Improved TypeScript types with proper enums
+- **Constants**: Added helper constants for easier development
+
 ## [1.8.1] - 2025-01-10
 
 ### 🔧 FIXED

package/README.md

@@ -29,6 +29,45 @@ A comprehensive TypeScript/JavaScript SDK for Zalo APIs, providing easy-to-use i
 npm install @warriorteam/redai-zalo-sdk
 ```
 
+## 🚨 Version 1.9.0 - Breaking Changes
+
+**ZNS Template API has been completely restructured to match Zalo API 100%**
+
+### What Changed:
+- ✅ **Fixed**: All ZNS template interfaces now match official Zalo API docs
+- ✅ **Added**: Proper `layout` structure with header/body/footer components
+- ✅ **Added**: Complete enum support for template types, tags, buttons, and params
+- ✅ **Added**: Validation helpers and constants
+- ❌ **Removed**: Non-existent fields like `templateContent`, `timeout`, `previewUrl`
+- 🔄 **Changed**: Field names from camelCase to snake_case (e.g., `templateId` → `template_id`)
+
+### Migration Required:
+```typescript
+// ❌ Before v1.9.0 (BROKEN)
+const templateData = {
+  templateId: "123",
+  templateContent: "Hello" // Field doesn't exist in Zalo API
+};
+
+// ✅ After v1.9.0 (CORRECT)
+import { ZNSTemplateType, ZNSTemplateTag } from '@warriorteam/redai-zalo-sdk';
+
+const templateData = {
+  template_id: "123",
+  template_name: "My Template",
+  template_type: ZNSTemplateType.CUSTOM,
+  tag: ZNSTemplateTag.TRANSACTION,
+  layout: {
+    body: {
+      components: [{ TITLE: { value: "Hello" } }]
+    }
+  },
+  tracking_id: "track_001"
+};
+```
+
+See [CHANGELOG.md](./CHANGELOG.md) for complete migration guide.
+
 ## 📚 Documentation
 
 ### 🚀 Getting Started

package/dist/constants/zns.constants.d.ts

@@ -0,0 +1,205 @@
+/**
+ * ZNS Constants - Các hằng số theo chuẩn Zalo API
+ */
+import { ZNSTemplateType, ZNSTemplateTag, ZNSButtonType, ZNSParamType } from '../types/zns';
+/**
+ * Template Type mapping với description
+ */
+export declare const ZNS_TEMPLATE_TYPES: {
+    readonly 1: {
+        readonly value: ZNSTemplateType.CUSTOM;
+        readonly name: "ZNS tùy chỉnh";
+        readonly description: "Template tùy chỉnh cho các mục đích khác nhau";
+    };
+    readonly 2: {
+        readonly value: ZNSTemplateType.AUTHENTICATION;
+        readonly name: "ZNS xác thực";
+        readonly description: "Template cho việc xác thực OTP, mã PIN";
+    };
+    readonly 3: {
+        readonly value: ZNSTemplateType.PAYMENT_REQUEST;
+        readonly name: "ZNS yêu cầu thanh toán";
+        readonly description: "Template yêu cầu thanh toán";
+    };
+    readonly 4: {
+        readonly value: ZNSTemplateType.VOUCHER;
+        readonly name: "ZNS voucher";
+        readonly description: "Template gửi voucher, khuyến mãi";
+    };
+    readonly 5: {
+        readonly value: ZNSTemplateType.SERVICE_RATING;
+        readonly name: "ZNS đánh giá dịch vụ";
+        readonly description: "Template yêu cầu đánh giá dịch vụ";
+    };
+};
+/**
+ * Template Tag mapping với description
+ */
+export declare const ZNS_TEMPLATE_TAGS: {
+    readonly "1": {
+        readonly value: ZNSTemplateTag.TRANSACTION;
+        readonly name: "Transaction";
+        readonly description: "Giao dịch, thanh toán";
+    };
+    readonly "2": {
+        readonly value: ZNSTemplateTag.CUSTOMER_CARE;
+        readonly name: "Customer Care";
+        readonly description: "Chăm sóc khách hàng";
+    };
+    readonly "3": {
+        readonly value: ZNSTemplateTag.PROMOTION;
+        readonly name: "Promotion";
+        readonly description: "Khuyến mãi, quảng cáo";
+    };
+};
+/**
+ * Button Type mapping với description
+ */
+export declare const ZNS_BUTTON_TYPES: {
+    readonly 1: {
+        readonly value: ZNSButtonType.URL;
+        readonly name: "URL";
+        readonly description: "Mở đường link";
+    };
+    readonly 2: {
+        readonly value: ZNSButtonType.PHONE;
+        readonly name: "Phone";
+        readonly description: "Gọi điện thoại";
+    };
+    readonly 3: {
+        readonly value: ZNSButtonType.SMS;
+        readonly name: "SMS";
+        readonly description: "Gửi tin nhắn SMS";
+    };
+    readonly 4: {
+        readonly value: ZNSButtonType.APP;
+        readonly name: "App";
+        readonly description: "Mở ứng dụng";
+    };
+    readonly 5: {
+        readonly value: ZNSButtonType.DEEPLINK;
+        readonly name: "Deeplink";
+        readonly description: "Mở deeplink";
+    };
+    readonly 6: {
+        readonly value: ZNSButtonType.MAP;
+        readonly name: "Map";
+        readonly description: "Mở bản đồ";
+    };
+    readonly 7: {
+        readonly value: ZNSButtonType.CALENDAR;
+        readonly name: "Calendar";
+        readonly description: "Thêm vào lịch";
+    };
+    readonly 8: {
+        readonly value: ZNSButtonType.COPY;
+        readonly name: "Copy";
+        readonly description: "Sao chép nội dung";
+    };
+};
+/**
+ * Parameter Type mapping với description và max length
+ */
+export declare const ZNS_PARAM_TYPES: {
+    readonly "1": {
+        readonly value: ZNSParamType.CUSTOMER_NAME;
+        readonly name: "Tên khách hàng";
+        readonly maxLength: 30;
+    };
+    readonly "2": {
+        readonly value: ZNSParamType.PHONE_NUMBER;
+        readonly name: "Số điện thoại";
+        readonly maxLength: 15;
+    };
+    readonly "3": {
+        readonly value: ZNSParamType.ADDRESS;
+        readonly name: "Địa chỉ";
+        readonly maxLength: 200;
+    };
+    readonly "4": {
+        readonly value: ZNSParamType.CODE;
+        readonly name: "Mã số";
+        readonly maxLength: 30;
+    };
+    readonly "5": {
+        readonly value: ZNSParamType.CUSTOM_LABEL;
+        readonly name: "Nhãn tùy chỉnh";
+        readonly maxLength: 30;
+    };
+    readonly "6": {
+        readonly value: ZNSParamType.TRANSACTION_STATUS;
+        readonly name: "Trạng thái giao dịch";
+        readonly maxLength: 30;
+    };
+    readonly "7": {
+        readonly value: ZNSParamType.CONTACT_INFO;
+        readonly name: "Thông tin liên hệ";
+        readonly maxLength: 50;
+    };
+    readonly "8": {
+        readonly value: ZNSParamType.GENDER_TITLE;
+        readonly name: "Giới tính / Danh xưng";
+        readonly maxLength: 5;
+    };
+    readonly "9": {
+        readonly value: ZNSParamType.PRODUCT_BRAND;
+        readonly name: "Tên sản phẩm / Thương hiệu";
+        readonly maxLength: 200;
+    };
+    readonly "10": {
+        readonly value: ZNSParamType.QUANTITY_AMOUNT;
+        readonly name: "Số lượng / Số tiền";
+        readonly maxLength: 20;
+    };
+    readonly "11": {
+        readonly value: ZNSParamType.TIME;
+        readonly name: "Thời gian";
+        readonly maxLength: 20;
+    };
+    readonly "12": {
+        readonly value: ZNSParamType.OTP;
+        readonly name: "OTP";
+        readonly maxLength: 10;
+    };
+    readonly "13": {
+        readonly value: ZNSParamType.URL;
+        readonly name: "URL";
+        readonly maxLength: 200;
+    };
+    readonly "14": {
+        readonly value: ZNSParamType.CURRENCY;
+        readonly name: "Tiền tệ (VNĐ)";
+        readonly maxLength: 12;
+    };
+    readonly "15": {
+        readonly value: ZNSParamType.BANK_TRANSFER_NOTE;
+        readonly name: "Bank transfer note";
+        readonly maxLength: 90;
+    };
+};
+/**
+ * Template Type và Tag compatibility matrix
+ */
+export declare const ZNS_TEMPLATE_TAG_COMPATIBILITY: Record<ZNSTemplateType, ZNSTemplateTag[]>;
+/**
+ * Validation functions
+ */
+export declare const ZNSValidation: {
+    /**
+     * Kiểm tra template name hợp lệ
+     */
+    readonly isValidTemplateName: (name: string) => boolean;
+    /**
+     * Kiểm tra note hợp lệ
+     */
+    readonly isValidNote: (note: string) => boolean;
+    /**
+     * Kiểm tra tag có tương thích với template type không
+     */
+    readonly isTagCompatibleWithType: (templateType: ZNSTemplateType, tag: ZNSTemplateTag) => boolean;
+    /**
+     * Kiểm tra param value có hợp lệ với type không
+     */
+    readonly isValidParamValue: (paramType: ZNSParamType, value: string) => boolean;
+};
+//# sourceMappingURL=zns.constants.d.ts.map

package/dist/constants/zns.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zns.constants.d.ts","sourceRoot":"","sources":["../../src/constants/zns.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAgBpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ElB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,CAoBpF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;yCACyB,MAAM,KAAG,OAAO;IAI5C;;OAEG;iCACiB,MAAM,KAAG,OAAO;IAIpC;;OAEG;qDACqC,eAAe,OAAO,cAAc,KAAG,OAAO;IAKtF;;OAEG;4CAC4B,YAAY,SAAS,MAAM,KAAG,OAAO;CAI5D,CAAC"}

package/dist/constants/zns.constants.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * ZNS Constants - Các hằng số theo chuẩn Zalo API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZNSValidation = exports.ZNS_TEMPLATE_TAG_COMPATIBILITY = exports.ZNS_PARAM_TYPES = exports.ZNS_BUTTON_TYPES = exports.ZNS_TEMPLATE_TAGS = exports.ZNS_TEMPLATE_TYPES = void 0;
+const zns_1 = require("../types/zns");
+/**
+ * Template Type mapping với description
+ */
+exports.ZNS_TEMPLATE_TYPES = {
+    [zns_1.ZNSTemplateType.CUSTOM]: {
+        value: zns_1.ZNSTemplateType.CUSTOM,
+        name: 'ZNS tùy chỉnh',
+        description: 'Template tùy chỉnh cho các mục đích khác nhau'
+    },
+    [zns_1.ZNSTemplateType.AUTHENTICATION]: {
+        value: zns_1.ZNSTemplateType.AUTHENTICATION,
+        name: 'ZNS xác thực',
+        description: 'Template cho việc xác thực OTP, mã PIN'
+    },
+    [zns_1.ZNSTemplateType.PAYMENT_REQUEST]: {
+        value: zns_1.ZNSTemplateType.PAYMENT_REQUEST,
+        name: 'ZNS yêu cầu thanh toán',
+        description: 'Template yêu cầu thanh toán'
+    },
+    [zns_1.ZNSTemplateType.VOUCHER]: {
+        value: zns_1.ZNSTemplateType.VOUCHER,
+        name: 'ZNS voucher',
+        description: 'Template gửi voucher, khuyến mãi'
+    },
+    [zns_1.ZNSTemplateType.SERVICE_RATING]: {
+        value: zns_1.ZNSTemplateType.SERVICE_RATING,
+        name: 'ZNS đánh giá dịch vụ',
+        description: 'Template yêu cầu đánh giá dịch vụ'
+    }
+};
+/**
+ * Template Tag mapping với description
+ */
+exports.ZNS_TEMPLATE_TAGS = {
+    [zns_1.ZNSTemplateTag.TRANSACTION]: {
+        value: zns_1.ZNSTemplateTag.TRANSACTION,
+        name: 'Transaction',
+        description: 'Giao dịch, thanh toán'
+    },
+    [zns_1.ZNSTemplateTag.CUSTOMER_CARE]: {
+        value: zns_1.ZNSTemplateTag.CUSTOMER_CARE,
+        name: 'Customer Care',
+        description: 'Chăm sóc khách hàng'
+    },
+    [zns_1.ZNSTemplateTag.PROMOTION]: {
+        value: zns_1.ZNSTemplateTag.PROMOTION,
+        name: 'Promotion',
+        description: 'Khuyến mãi, quảng cáo'
+    }
+};
+/**
+ * Button Type mapping với description
+ */
+exports.ZNS_BUTTON_TYPES = {
+    [zns_1.ZNSButtonType.URL]: {
+        value: zns_1.ZNSButtonType.URL,
+        name: 'URL',
+        description: 'Mở đường link'
+    },
+    [zns_1.ZNSButtonType.PHONE]: {
+        value: zns_1.ZNSButtonType.PHONE,
+        name: 'Phone',
+        description: 'Gọi điện thoại'
+    },
+    [zns_1.ZNSButtonType.SMS]: {
+        value: zns_1.ZNSButtonType.SMS,
+        name: 'SMS',
+        description: 'Gửi tin nhắn SMS'
+    },
+    [zns_1.ZNSButtonType.APP]: {
+        value: zns_1.ZNSButtonType.APP,
+        name: 'App',
+        description: 'Mở ứng dụng'
+    },
+    [zns_1.ZNSButtonType.DEEPLINK]: {
+        value: zns_1.ZNSButtonType.DEEPLINK,
+        name: 'Deeplink',
+        description: 'Mở deeplink'
+    },
+    [zns_1.ZNSButtonType.MAP]: {
+        value: zns_1.ZNSButtonType.MAP,
+        name: 'Map',
+        description: 'Mở bản đồ'
+    },
+    [zns_1.ZNSButtonType.CALENDAR]: {
+        value: zns_1.ZNSButtonType.CALENDAR,
+        name: 'Calendar',
+        description: 'Thêm vào lịch'
+    },
+    [zns_1.ZNSButtonType.COPY]: {
+        value: zns_1.ZNSButtonType.COPY,
+        name: 'Copy',
+        description: 'Sao chép nội dung'
+    }
+};
+/**
+ * Parameter Type mapping với description và max length
+ */
+exports.ZNS_PARAM_TYPES = {
+    [zns_1.ZNSParamType.CUSTOMER_NAME]: {
+        value: zns_1.ZNSParamType.CUSTOMER_NAME,
+        name: 'Tên khách hàng',
+        maxLength: 30
+    },
+    [zns_1.ZNSParamType.PHONE_NUMBER]: {
+        value: zns_1.ZNSParamType.PHONE_NUMBER,
+        name: 'Số điện thoại',
+        maxLength: 15
+    },
+    [zns_1.ZNSParamType.ADDRESS]: {
+        value: zns_1.ZNSParamType.ADDRESS,
+        name: 'Địa chỉ',
+        maxLength: 200
+    },
+    [zns_1.ZNSParamType.CODE]: {
+        value: zns_1.ZNSParamType.CODE,
+        name: 'Mã số',
+        maxLength: 30
+    },
+    [zns_1.ZNSParamType.CUSTOM_LABEL]: {
+        value: zns_1.ZNSParamType.CUSTOM_LABEL,
+        name: 'Nhãn tùy chỉnh',
+        maxLength: 30
+    },
+    [zns_1.ZNSParamType.TRANSACTION_STATUS]: {
+        value: zns_1.ZNSParamType.TRANSACTION_STATUS,
+        name: 'Trạng thái giao dịch',
+        maxLength: 30
+    },
+    [zns_1.ZNSParamType.CONTACT_INFO]: {
+        value: zns_1.ZNSParamType.CONTACT_INFO,
+        name: 'Thông tin liên hệ',
+        maxLength: 50
+    },
+    [zns_1.ZNSParamType.GENDER_TITLE]: {
+        value: zns_1.ZNSParamType.GENDER_TITLE,
+        name: 'Giới tính / Danh xưng',
+        maxLength: 5
+    },
+    [zns_1.ZNSParamType.PRODUCT_BRAND]: {
+        value: zns_1.ZNSParamType.PRODUCT_BRAND,
+        name: 'Tên sản phẩm / Thương hiệu',
+        maxLength: 200
+    },
+    [zns_1.ZNSParamType.QUANTITY_AMOUNT]: {
+        value: zns_1.ZNSParamType.QUANTITY_AMOUNT,
+        name: 'Số lượng / Số tiền',
+        maxLength: 20
+    },
+    [zns_1.ZNSParamType.TIME]: {
+        value: zns_1.ZNSParamType.TIME,
+        name: 'Thời gian',
+        maxLength: 20
+    },
+    [zns_1.ZNSParamType.OTP]: {
+        value: zns_1.ZNSParamType.OTP,
+        name: 'OTP',
+        maxLength: 10
+    },
+    [zns_1.ZNSParamType.URL]: {
+        value: zns_1.ZNSParamType.URL,
+        name: 'URL',
+        maxLength: 200
+    },
+    [zns_1.ZNSParamType.CURRENCY]: {
+        value: zns_1.ZNSParamType.CURRENCY,
+        name: 'Tiền tệ (VNĐ)',
+        maxLength: 12
+    },
+    [zns_1.ZNSParamType.BANK_TRANSFER_NOTE]: {
+        value: zns_1.ZNSParamType.BANK_TRANSFER_NOTE,
+        name: 'Bank transfer note',
+        maxLength: 90
+    }
+};
+/**
+ * Template Type và Tag compatibility matrix
+ */
+exports.ZNS_TEMPLATE_TAG_COMPATIBILITY = {
+    [zns_1.ZNSTemplateType.CUSTOM]: [
+        zns_1.ZNSTemplateTag.TRANSACTION,
+        zns_1.ZNSTemplateTag.CUSTOMER_CARE,
+        zns_1.ZNSTemplateTag.PROMOTION
+    ],
+    [zns_1.ZNSTemplateType.AUTHENTICATION]: [
+        zns_1.ZNSTemplateTag.TRANSACTION
+    ],
+    [zns_1.ZNSTemplateType.PAYMENT_REQUEST]: [
+        zns_1.ZNSTemplateTag.TRANSACTION
+    ],
+    [zns_1.ZNSTemplateType.VOUCHER]: [
+        zns_1.ZNSTemplateTag.TRANSACTION,
+        zns_1.ZNSTemplateTag.CUSTOMER_CARE,
+        zns_1.ZNSTemplateTag.PROMOTION
+    ],
+    [zns_1.ZNSTemplateType.SERVICE_RATING]: [
+        zns_1.ZNSTemplateTag.CUSTOMER_CARE
+    ]
+};
+/**
+ * Validation functions
+ */
+exports.ZNSValidation = {
+    /**
+     * Kiểm tra template name hợp lệ
+     */
+    isValidTemplateName: (name) => {
+        return name.length >= 10 && name.length <= 60;
+    },
+    /**
+     * Kiểm tra note hợp lệ
+     */
+    isValidNote: (note) => {
+        return note.length >= 1 && note.length <= 400;
+    },
+    /**
+     * Kiểm tra tag có tương thích với template type không
+     */
+    isTagCompatibleWithType: (templateType, tag) => {
+        const compatibleTags = exports.ZNS_TEMPLATE_TAG_COMPATIBILITY[templateType];
+        return compatibleTags ? compatibleTags.includes(tag) : false;
+    },
+    /**
+     * Kiểm tra param value có hợp lệ với type không
+     */
+    isValidParamValue: (paramType, value) => {
+        const typeInfo = exports.ZNS_PARAM_TYPES[paramType];
+        return typeInfo ? value.length <= typeInfo.maxLength : false;
+    }
+};
+//# sourceMappingURL=zns.constants.js.map

package/dist/constants/zns.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zns.constants.js","sourceRoot":"","sources":["../../src/constants/zns.constants.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from "./types/oa";
 export * from "./types/user";
 export * from "./types/zns";
 export * from "./types/article";
+export * from "./constants/zns.constants";
 export type { BaseMessage, TextMessage, ImageMessage, FileMessage, StickerMessage, TemplateMessage as MessageTemplateMessage, ReactionMessage as MessageReactionMessage, Message, MessageRecipient, SendMessageRequest, SendMessageResponse, UploadFileResponse, MessageStatus, MessageEvent, ConsultationTextMessage, ConsultationImageMessage, ConsultationFileMessage, ConsultationStickerMessage, ConsultationQuoteMessage, ConsultationRequestInfoMessage, TransactionMessage, PromotionMessage, AnonymousTextMessage, AnonymousImageMessage, AnonymousFileMessage, AnonymousStickerMessage, MiniAppMessage, ExtendedMessage, } from "./types/message";
 export * from "./types/webhook";
 export type { GroupMessage, GroupTextMessage, GroupImageMessage, GroupFileMessage, GroupStickerMessage, GroupMentionMessage, GroupMessageResult, GroupInfo as GroupManagementInfo, GroupMember, GroupMemberList, GroupSettings, GroupJoinRequest, GroupJoinRequestList, GroupInvitation, GroupActivity, GroupActivityList, GroupStatistics, GroupMessageTemplate, GroupMessageSchedule, GroupBroadcast, GroupPermission, GroupWebhookEvent as GroupManagementWebhookEvent, GroupApiResponse, GroupCreateResponse, GroupUpdateResponse, GroupDeleteResponse, GroupMemberActionResponse, GroupCreateRequest, GroupCreateResult, GroupUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupMemberActionRequest, GroupAdminActionRequest, GroupDeleteRequest, GroupPendingMember, GroupQuota, GroupQuotaAsset, GroupRecentChat, GroupConversationMessage, GroupsOfOAResponse, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersRequest, GroupAcceptPendingMembersResponse, GroupRemoveMembersRequest, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageRequest, GroupQuotaMessageResponse, } from "./types/group";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -32,6 +32,8 @@ __exportStar(require("./types/oa"), exports);
 __exportStar(require("./types/user"), exports);
 __exportStar(require("./types/zns"), exports);
 __exportStar(require("./types/article"), exports);
+// Export ZNS constants and helpers
+__exportStar(require("./constants/zns.constants"), exports);
 // Export webhook types (avoiding conflicts with message and group types)
 __exportStar(require("./types/webhook"), exports);
 // Export clients

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,iDAA+B;AAC/B,+CAA6B;AAC7B,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAkChC,yEAAyE;AACzE,kDAAgC;AA8EhC,iBAAiB;AACjB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AAEnB,kBAAkB;AAClB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,oDAAkD;AAAzC,uGAAA,SAAS,OAAA;AAClB,2GAA2G;AAC3G,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,+DAA+D;AAC/D,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AACnB,0EAAuE;AAA9D,4HAAA,mBAAmB,OAAA;AAC5B,gFAA6E;AAApE,kIAAA,sBAAsB,OAAA;AAC/B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAE3B,iDAAiD;AACjD,wEAAsE;AAA7D,2HAAA,mBAAmB,OAAA;AAC5B,sEAAoE;AAA3D,yHAAA,kBAAkB,OAAA;AAC3B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAC9B,oFAQ+C;AAP7C,sIAAA,wBAAwB,OAAA;AAS1B,wBAAwB;AACxB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAEhB,iBAAiB;AACjB,uCAAgD;AAAvC,mGAAA,OAAO,OAAW"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,iDAA+B;AAC/B,+CAA6B;AAC7B,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAEhC,mCAAmC;AACnC,4DAA0C;AAkC1C,yEAAyE;AACzE,kDAAgC;AA8EhC,iBAAiB;AACjB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AAEnB,kBAAkB;AAClB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,oDAAkD;AAAzC,uGAAA,SAAS,OAAA;AAClB,2GAA2G;AAC3G,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,+DAA+D;AAC/D,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AACnB,0EAAuE;AAA9D,4HAAA,mBAAmB,OAAA;AAC5B,gFAA6E;AAApE,kIAAA,sBAAsB,OAAA;AAC/B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAE3B,iDAAiD;AACjD,wEAAsE;AAA7D,2HAAA,mBAAmB,OAAA;AAC5B,sEAAoE;AAA3D,yHAAA,kBAAkB,OAAA;AAC3B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAC9B,oFAQ+C;AAP7C,sIAAA,wBAAwB,OAAA;AAS1B,wBAAwB;AACxB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAEhB,iBAAiB;AACjB,uCAAgD;AAAvC,mGAAA,OAAO,OAAW"}

package/dist/services/group-management.service.d.ts

@@ -1,5 +1,5 @@
 import { ZaloClient } from "../clients/zalo-client";
-import { GroupCreateRequest, GroupCreateResult, GroupUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupAdminActionRequest, GroupQuota, GroupRecentChat, GroupConversationMessage, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersResponse, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageResponse } from "../types/group";
+import { GroupCreateRequest, GroupCreateResult, GroupCreateData, GroupUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupAdminActionRequest, GroupQuota, GroupRecentChat, GroupConversationMessage, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersResponse, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageResponse } from "../types/group";
 import { GMFProductType, QuotaType } from "../types/oa";
 /**
  * Service for handling Zalo Official Account Group Management Framework (GMF) APIs
@@ -45,8 +45,16 @@ export declare class GroupManagementService {
      * @param accessToken OA access token
      * @param groupData Group information to create
      * @returns Created group information
+     *
+     * API: POST https://openapi.zalo.me/v3.0/oa/group/creategroupwithoa
      */
     createGroup(accessToken: string, groupData: GroupCreateRequest): Promise<GroupCreateResult>;
+    /**
+     * Helper method to extract group data from create response
+     * @param response Full API response
+     * @returns Group data only
+     */
+    extractGroupData(response: GroupCreateResult): GroupCreateData;
     /**
      * Get detailed group information
      * @param accessToken OA access token