@warriorteam/redai-zalo-sdk 1.1.0

package/dist/services/zns.service.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZNSService = void 0;
+/**
+ * Service for Zalo Notification Service (ZNS)
+ *
+ * Requirements for using ZNS API:
+ * - Official Account must be approved and have ZNS sending permission
+ * - Valid Official Account access token
+ * - ZNS template must be approved before use
+ * - Recipient phone number must be in correct format and valid
+ * - Template data must match defined parameters
+ * - Comply with message quantity limits according to service package
+ *
+ * Reference: https://developers.zalo.me/docs/zalo-notification-service/
+ */
+class ZNSService {
+    constructor(client) {
+        this.client = client;
+        this.znsApiUrl = "https://business.openapi.zalo.me/message";
+        this.templateApiUrl = "https://business.openapi.zalo.me/template";
+    }
+    /**
+     * Send ZNS message
+     * @param accessToken OA access token
+     * @param message ZNS message data
+     * @returns Send result
+     */
+    async sendMessage(accessToken, message) {
+        try {
+            const response = await this.client.apiPost(`${this.znsApiUrl}/template`, accessToken, message);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to send ZNS message");
+        }
+    }
+    /**
+     * Send ZNS message with phone hash
+     * @param accessToken OA access token
+     * @param message ZNS message with hashed phone
+     * @returns Send result
+     */
+    async sendHashPhoneMessage(accessToken, message) {
+        try {
+            const response = await this.client.apiPost(`${this.znsApiUrl}/template/hashphone`, accessToken, message);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to send ZNS hash phone message");
+        }
+    }
+    /**
+     * Send ZNS message in development mode
+     * @param accessToken OA access token
+     * @param message ZNS dev mode message
+     * @returns Send result
+     */
+    async sendDevModeMessage(accessToken, message) {
+        try {
+            const response = await this.client.apiPost(`${this.znsApiUrl}/template/dev`, accessToken, message);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to send ZNS dev mode message");
+        }
+    }
+    /**
+     * Send ZNS message with RSA encryption
+     * @param accessToken OA access token
+     * @param message ZNS RSA message
+     * @returns Send result
+     */
+    async sendRsaMessage(accessToken, message) {
+        try {
+            const response = await this.client.apiPost(`${this.znsApiUrl}/template/rsa`, accessToken, message);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to send ZNS RSA message");
+        }
+    }
+    /**
+     * Send ZNS journey message
+     * @param accessToken OA access token
+     * @param message ZNS journey message
+     * @returns Send result
+     */
+    async sendJourneyMessage(accessToken, message) {
+        try {
+            const response = await this.client.apiPost(`${this.znsApiUrl}/template/journey`, accessToken, message);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to send ZNS journey message");
+        }
+    }
+    /**
+     * Get ZNS message status
+     * @param accessToken OA access token
+     * @param messageId Message ID
+     * @returns Message status info
+     */
+    async getMessageStatus(accessToken, messageId) {
+        try {
+            const response = await this.client.apiGet(`${this.znsApiUrl}/status`, accessToken, {
+                message_id: messageId,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to get ZNS message status");
+        }
+    }
+    /**
+     * Get ZNS quota information
+     * @param accessToken OA access token
+     * @returns Quota information
+     */
+    async getQuotaInfo(accessToken) {
+        try {
+            const response = await this.client.apiGet(`${this.znsApiUrl}/quota`, accessToken);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to get ZNS quota info");
+        }
+    }
+    /**
+     * Get ZNS template list
+     * @param accessToken OA access token
+     * @param offset Offset for pagination
+     * @param limit Limit for pagination
+     * @returns Template list
+     */
+    async getTemplateList(accessToken, offset = 0, limit = 10) {
+        try {
+            const response = await this.client.apiGet(`${this.templateApiUrl}/all`, accessToken, {
+                offset,
+                limit,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to get ZNS template list");
+        }
+    }
+    /**
+     * Get ZNS template details
+     * @param accessToken OA access token
+     * @param templateId Template ID
+     * @returns Template details
+     */
+    async getTemplateDetails(accessToken, templateId) {
+        try {
+            const response = await this.client.apiGet(`${this.templateApiUrl}/info`, accessToken, {
+                template_id: templateId,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to get ZNS template details");
+        }
+    }
+    /**
+     * Create ZNS template
+     * @param accessToken OA access token
+     * @param templateData Template creation data
+     * @returns Created template
+     */
+    async createTemplate(accessToken, templateData) {
+        try {
+            const response = await this.client.apiPost(`${this.templateApiUrl}/create`, accessToken, templateData);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to create ZNS template");
+        }
+    }
+    /**
+     * Update ZNS template
+     * @param accessToken OA access token
+     * @param templateData Template update data
+     * @returns Updated template
+     */
+    async updateTemplate(accessToken, templateData) {
+        try {
+            const response = await this.client.apiPost(`${this.templateApiUrl}/update`, accessToken, templateData);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to update ZNS template");
+        }
+    }
+    /**
+     * Delete ZNS template
+     * @param accessToken OA access token
+     * @param templateId Template ID
+     * @returns Deletion result
+     */
+    async deleteTemplate(accessToken, templateId) {
+        try {
+            const response = await this.client.apiPost(`${this.templateApiUrl}/delete`, accessToken, { template_id: templateId });
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to delete ZNS template");
+        }
+    }
+    /**
+     * Upload image for ZNS template
+     * @param accessToken OA access token
+     * @param imageFile Image file
+     * @returns Upload result
+     */
+    async uploadImage(accessToken, imageFile, filename = "image.jpg") {
+        try {
+            const response = await this.client.apiUploadFile(`${this.templateApiUrl}/upload_image`, accessToken, imageFile, filename);
+            return response;
+        }
+        catch (error) {
+            throw this.handleZNSError(error, "Failed to upload ZNS image");
+        }
+    }
+    handleZNSError(error, defaultMessage) {
+        if (error.response?.data) {
+            const errorData = error.response.data;
+            return new Error(`${defaultMessage}: ${errorData.message || errorData.error || "Unknown error"}`);
+        }
+        return new Error(`${defaultMessage}: ${error.message || "Unknown error"}`);
+    }
+}
+exports.ZNSService = ZNSService;
+//# sourceMappingURL=zns.service.js.map

package/dist/services/zns.service.js.map

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

package/dist/types/article.d.ts

@@ -0,0 +1,352 @@
+/**
+ * Types for Zalo Official Account Article Management
+ * Based on Zalo Article API v2.0
+ */
+import { ZaloApiResponse } from "./common";
+/**
+ * Article cover configuration
+ */
+export interface ArticleCover {
+    /** Cover type: photo or video */
+    cover_type: 'photo' | 'video';
+    /** Photo URL (required when cover_type is 'photo') */
+    photo_url?: string;
+    /** Video ID (required when cover_type is 'video') */
+    video_id?: string;
+    /** Cover view orientation for video */
+    cover_view?: 'horizontal' | 'vertical' | 'square';
+    /** Cover status */
+    status: 'show' | 'hide';
+}
+/**
+ * Article body content item
+ */
+export interface ArticleBodyItem {
+    /** Content type */
+    type: 'text' | 'image' | 'video' | 'product';
+    /** Text content (for type: text) */
+    content?: string;
+    /** Image URL (for type: image) */
+    url?: string;
+    /** Video ID (for type: video) */
+    video_id?: string;
+    /** Product ID (for type: product) */
+    id?: string;
+    /** Additional properties for video */
+    width?: number;
+    height?: number;
+    thumbnail?: string;
+}
+/**
+ * Normal article creation request
+ */
+export interface ArticleNormalRequest {
+    type: 'normal';
+    title: string;
+    author: string;
+    cover: ArticleCover;
+    description: string;
+    body: ArticleBodyItem[];
+    related_medias?: string[];
+    tracking_link?: string;
+    status?: 'show' | 'hide';
+    comment?: 'show' | 'hide';
+}
+/**
+ * Video article creation request
+ */
+export interface ArticleVideoRequest {
+    type: 'video';
+    title: string;
+    description: string;
+    video_id: string;
+    avatar: string;
+    status?: 'show' | 'hide';
+    comment?: 'show' | 'hide';
+}
+/**
+ * Article creation request (union type)
+ */
+export type ArticleRequest = ArticleNormalRequest | ArticleVideoRequest;
+/**
+ * Article creation response
+ */
+export interface ArticleResponse {
+    /** Token for tracking article creation progress */
+    token: string;
+}
+/**
+ * Article process check response
+ */
+export interface ArticleProcessResponse {
+    /** Article ID if creation is successful */
+    article_id?: string;
+    /** Process status */
+    status: 'processing' | 'success' | 'failed';
+    /** Error message if failed */
+    error_message?: string;
+    /** Creation timestamp */
+    created_time: number;
+    /** Last update timestamp */
+    updated_time: number;
+}
+/**
+ * Article verification response
+ */
+export interface ArticleVerifyResponse {
+    /** Article ID */
+    id: string;
+}
+/**
+ * Article cite information
+ */
+export interface ArticleCite {
+    url: string;
+    description: string;
+}
+/**
+ * Article detail (normal type)
+ */
+export interface ArticleDetailNormal {
+    id: string;
+    type: 'normal';
+    title: string;
+    author: string;
+    cover: ArticleCover;
+    description: string;
+    body: ArticleBodyItem[];
+    related_medias: string[];
+    tracking_link: string;
+    status: 'show' | 'hide';
+    comment: 'show' | 'hide';
+    cite?: ArticleCite;
+    link_view: string;
+    total_view: number;
+    total_share: number;
+    total_like: number;
+    total_comment: number;
+}
+/**
+ * Article detail (video type)
+ */
+export interface ArticleDetailVideo {
+    id: string;
+    type: 'video';
+    title: string;
+    description: string;
+    video_id: string;
+    avatar: string;
+    status: 'show' | 'hide';
+    comment: 'show' | 'hide';
+    link_view: string;
+    total_view: number;
+    total_share: number;
+    total_like: number;
+    total_comment: number;
+}
+/**
+ * Article detail (union type)
+ */
+export type ArticleDetail = ArticleDetailNormal | ArticleDetailVideo;
+/**
+ * Article list request
+ */
+export interface ArticleListRequest {
+    /** Starting position */
+    offset: number;
+    /** Number of articles to return (max 100) */
+    limit: number;
+    /** Article type filter */
+    type: 'normal' | 'video';
+}
+/**
+ * Article list item
+ */
+export interface ArticleListItem {
+    id: string;
+    type: 'normal' | 'video';
+    title: string;
+    description: string;
+    status: 'show' | 'hide';
+    comment: 'show' | 'hide';
+    link_view: string;
+    total_view: number;
+    total_share: number;
+    total_like: number;
+    total_comment: number;
+    create_time: number;
+    update_time: number;
+    author?: string;
+    cover?: ArticleCover;
+    body?: ArticleBodyItem[];
+    related_medias?: string[];
+    tracking_link?: string;
+    cite?: ArticleCite;
+    video_id?: string;
+    avatar?: string;
+}
+/**
+ * Article list response data
+ */
+export interface ArticleListData {
+    offset: number;
+    count: number;
+    total: number;
+    articles: ArticleListItem[];
+}
+/**
+ * Article list response
+ */
+export type ArticleListResponse = ZaloApiResponse<ArticleListData>;
+/**
+ * Normal article update request
+ */
+export interface ArticleUpdateNormalRequest {
+    id: string;
+    type: 'normal';
+    title: string;
+    author: string;
+    cover: ArticleCover;
+    description: string;
+    body: ArticleBodyItem[];
+    related_medias?: string[];
+    tracking_link?: string;
+    status?: 'show' | 'hide';
+    comment?: 'show' | 'hide';
+}
+/**
+ * Video article update request
+ */
+export interface ArticleUpdateVideoRequest {
+    id: string;
+    type: 'video';
+    title: string;
+    description: string;
+    video_id: string;
+    avatar: string;
+    status?: 'show' | 'hide';
+    comment?: 'show' | 'hide';
+}
+/**
+ * Article update request (union type)
+ */
+export type ArticleUpdateRequest = ArticleUpdateNormalRequest | ArticleUpdateVideoRequest;
+/**
+ * Article update response
+ */
+export interface ArticleUpdateResponse {
+    /** Token for tracking article update progress */
+    token: string;
+}
+/**
+ * Article removal request
+ */
+export interface ArticleRemoveRequest {
+    /** Article ID to remove */
+    id: string;
+}
+/**
+ * Article removal response
+ */
+export interface ArticleRemoveResponse {
+    /** Success message */
+    message: string;
+}
+/**
+ * Video upload response
+ */
+export interface VideoUploadResponse {
+    /** Token for tracking video upload progress */
+    token: string;
+}
+/**
+ * Video status response
+ */
+export interface VideoStatusResponse {
+    /** Video ID (available when processing is complete) */
+    video_id?: string;
+    /** Video name */
+    video_name?: string;
+    /** Video size in bytes */
+    video_size?: number;
+    /** Processing status */
+    status: number;
+    /** Status message */
+    status_message: string;
+    /** Conversion progress percentage */
+    convert_percent: number;
+    /** Conversion error code */
+    convert_error_code: number;
+}
+/**
+ * Article validation error
+ */
+export interface ArticleValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Video file validation constraints
+ */
+export interface VideoFileConstraints {
+    /** Maximum file size in bytes (50MB) */
+    maxSize: number;
+    /** Allowed file extensions */
+    allowedExtensions: string[];
+    /** Allowed MIME types */
+    allowedMimeTypes: string[];
+}
+/**
+ * Article validation constants
+ */
+export declare const ARTICLE_CONSTRAINTS: {
+    readonly TITLE_MAX_LENGTH: 150;
+    readonly AUTHOR_MAX_LENGTH: 50;
+    readonly DESCRIPTION_MAX_LENGTH: 300;
+    readonly IMAGE_MAX_SIZE: number;
+    readonly VIDEO_MAX_SIZE: number;
+    readonly LIST_MAX_LIMIT: 100;
+};
+/**
+ * Video upload constraints
+ */
+export declare const VIDEO_CONSTRAINTS: VideoFileConstraints;
+/**
+ * Article status enum
+ */
+export declare enum ArticleStatus {
+    SHOW = "show",
+    HIDE = "hide"
+}
+/**
+ * Comment status enum
+ */
+export declare enum CommentStatus {
+    SHOW = "show",
+    HIDE = "hide"
+}
+/**
+ * Article type enum
+ */
+export declare enum ArticleType {
+    NORMAL = "normal",
+    VIDEO = "video"
+}
+/**
+ * Cover type enum
+ */
+export declare enum CoverType {
+    PHOTO = "photo",
+    VIDEO = "video"
+}
+/**
+ * Body item type enum
+ */
+export declare enum BodyItemType {
+    TEXT = "text",
+    IMAGE = "image",
+    VIDEO = "video",
+    PRODUCT = "product"
+}
+//# sourceMappingURL=article.d.ts.map

package/dist/types/article.d.ts.map

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

package/dist/types/article.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Types for Zalo Official Account Article Management
+ * Based on Zalo Article API v2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BodyItemType = exports.CoverType = exports.ArticleType = exports.CommentStatus = exports.ArticleStatus = exports.VIDEO_CONSTRAINTS = exports.ARTICLE_CONSTRAINTS = void 0;
+// ==================== CONSTANTS ====================
+/**
+ * Article validation constants
+ */
+exports.ARTICLE_CONSTRAINTS = {
+    TITLE_MAX_LENGTH: 150,
+    AUTHOR_MAX_LENGTH: 50,
+    DESCRIPTION_MAX_LENGTH: 300,
+    IMAGE_MAX_SIZE: 1024 * 1024, // 1MB
+    VIDEO_MAX_SIZE: 50 * 1024 * 1024, // 50MB
+    LIST_MAX_LIMIT: 100,
+};
+/**
+ * Video upload constraints
+ */
+exports.VIDEO_CONSTRAINTS = {
+    maxSize: 50 * 1024 * 1024, // 50MB
+    allowedExtensions: ['.mp4', '.avi'],
+    allowedMimeTypes: ['video/mp4', 'video/avi', 'video/x-msvideo'],
+};
+/**
+ * Article status enum
+ */
+var ArticleStatus;
+(function (ArticleStatus) {
+    ArticleStatus["SHOW"] = "show";
+    ArticleStatus["HIDE"] = "hide";
+})(ArticleStatus || (exports.ArticleStatus = ArticleStatus = {}));
+/**
+ * Comment status enum
+ */
+var CommentStatus;
+(function (CommentStatus) {
+    CommentStatus["SHOW"] = "show";
+    CommentStatus["HIDE"] = "hide";
+})(CommentStatus || (exports.CommentStatus = CommentStatus = {}));
+/**
+ * Article type enum
+ */
+var ArticleType;
+(function (ArticleType) {
+    ArticleType["NORMAL"] = "normal";
+    ArticleType["VIDEO"] = "video";
+})(ArticleType || (exports.ArticleType = ArticleType = {}));
+/**
+ * Cover type enum
+ */
+var CoverType;
+(function (CoverType) {
+    CoverType["PHOTO"] = "photo";
+    CoverType["VIDEO"] = "video";
+})(CoverType || (exports.CoverType = CoverType = {}));
+/**
+ * Body item type enum
+ */
+var BodyItemType;
+(function (BodyItemType) {
+    BodyItemType["TEXT"] = "text";
+    BodyItemType["IMAGE"] = "image";
+    BodyItemType["VIDEO"] = "video";
+    BodyItemType["PRODUCT"] = "product";
+})(BodyItemType || (exports.BodyItemType = BodyItemType = {}));
+//# sourceMappingURL=article.js.map

package/dist/types/article.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.js","sourceRoot":"","sources":["../../src/types/article.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA4VH,sDAAsD;AAEtD;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,EAAE;IACrB,sBAAsB,EAAE,GAAG;IAC3B,cAAc,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;IACnC,cAAc,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;IACzC,cAAc,EAAE,GAAG;CACX,CAAC;AAEX;;GAEG;AACU,QAAA,iBAAiB,GAAyB;IACrD,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;IAClC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACnC,gBAAgB,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC;CACvD,CAAC;AAEX;;GAEG;AACH,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,8BAAa,CAAA;AACf,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED;;GAEG;AACH,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,8BAAa,CAAA;AACf,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED;;GAEG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB;AAED;;GAEG;AACH,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,4BAAe,CAAA;AACjB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED;;GAEG;AACH,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,+BAAe,CAAA;IACf,+BAAe,CAAA;IACf,mCAAmB,CAAA;AACrB,CAAC,EALW,YAAY,4BAAZ,YAAY,QAKvB"}