@warriorteam/redai-zalo-sdk 1.1.0

package/dist/types/zns.d.ts

@@ -0,0 +1,277 @@
+/**
+ * ZNS (Zalo Notification Service) Type Definitions
+ */
+export interface ZNSMessage {
+    phone: string;
+    template_id: string;
+    template_data: Record<string, any>;
+    tracking_id?: string;
+}
+export interface ZNSHashPhoneMessage {
+    phone_hash: string;
+    template_id: string;
+    template_data: Record<string, any>;
+    tracking_id?: string;
+}
+export interface ZNSDevModeMessage {
+    phone: string;
+    template_id: string;
+    template_data: Record<string, any>;
+    tracking_id?: string;
+    mode: 'development';
+}
+export interface ZNSRsaMessage {
+    phone_rsa: string;
+    template_id: string;
+    template_data: Record<string, any>;
+    tracking_id?: string;
+}
+export interface ZNSJourneyMessage {
+    phone: string;
+    template_id: string;
+    template_data: Record<string, any>;
+    tracking_id?: string;
+    journey_id: string;
+}
+export interface ZNSSendResult {
+    error: number;
+    message: string;
+    data?: {
+        msg_id: string;
+        sent_time: string;
+        quota?: {
+            remainingQuota: number;
+            dailyQuota: number;
+        };
+    };
+}
+export interface ZNSTemplate {
+    templateId: string;
+    templateName: string;
+    status: 'PENDING_REVIEW' | 'ENABLE' | 'REJECT' | 'DISABLE';
+    listParams: Array<{
+        name: string;
+        require: boolean;
+        type: 'STRING' | 'NUMBER' | 'DATE';
+        maxLength?: number;
+        minLength?: number;
+    }>;
+    timeout?: number;
+    previewUrl?: string;
+    templateQuality?: 'HIGH' | 'MEDIUM' | 'LOW';
+    templateTag?: string;
+    price?: number;
+    applyTemplateQuota?: boolean;
+    templateDailyQuota?: number;
+    templateRemainingQuota?: number;
+}
+export interface ZNSTemplateList {
+    error: number;
+    message: string;
+    data: ZNSTemplate[];
+}
+export interface ZNSCreateTemplateRequest {
+    templateName: string;
+    templateContent: string;
+    templateType: number;
+    timeout?: number;
+    previewUrl?: string;
+    templateTag?: string;
+    listParams?: Array<{
+        name: string;
+        require: boolean;
+        type: 'STRING' | 'NUMBER' | 'DATE';
+        maxLength?: number;
+        minLength?: number;
+    }>;
+}
+export interface ZNSUpdateTemplateRequest {
+    templateId: string;
+    templateName?: string;
+    templateContent?: string;
+    timeout?: number;
+    previewUrl?: string;
+    templateTag?: string;
+    listParams?: Array<{
+        name: string;
+        require: boolean;
+        type: 'STRING' | 'NUMBER' | 'DATE';
+        maxLength?: number;
+        minLength?: number;
+    }>;
+}
+export interface ZNSUploadImageResult {
+    error: number;
+    message: string;
+    data?: {
+        attachment_id: string;
+        url: string;
+    };
+}
+export interface ZNSStatusInfo {
+    error: number;
+    message: string;
+    data?: {
+        status: 'PENDING' | 'SENT' | 'RECEIVED' | 'FAILED';
+        sent_time?: string;
+        received_time?: string;
+        fail_reason?: string;
+    };
+}
+export interface ZNSMessageStatusInfo {
+    error: number;
+    message: string;
+    data?: {
+        msg_id: string;
+        phone: string;
+        status: 'PENDING' | 'SENT' | 'RECEIVED' | 'FAILED';
+        sent_time?: string;
+        received_time?: string;
+        fail_reason?: string;
+        template_id: string;
+        tracking_id?: string;
+    };
+}
+export interface ZNSQuotaInfo {
+    error: number;
+    message: string;
+    data?: {
+        dailyQuota: number;
+        remainingQuota: number;
+        type: 'TRIAL' | 'PAID';
+    };
+}
+export interface ZNSAllowedContent {
+    error: number;
+    message: string;
+    data?: {
+        allowed_content: string[];
+        prohibited_content: string[];
+    };
+}
+export interface ZNSTemplateSampleData {
+    templateId: string;
+    sampleData: Record<string, any>;
+}
+export interface ZNSCustomerRating {
+    templateId: string;
+    rating: number;
+    feedback?: string;
+    ratingTime: string;
+}
+export interface ZNSCustomerRatingList {
+    error: number;
+    message: string;
+    data?: {
+        ratings: ZNSCustomerRating[];
+        averageRating: number;
+        totalRatings: number;
+    };
+}
+export interface ZNSQualityInfo {
+    templateId: string;
+    quality: 'HIGH' | 'MEDIUM' | 'LOW';
+    qualityScore: number;
+    factors: {
+        deliveryRate: number;
+        readRate: number;
+        responseRate: number;
+        complaintRate: number;
+    };
+    lastUpdated: string;
+}
+export interface ZNSQualityHistoryList {
+    error: number;
+    message: string;
+    data?: {
+        history: Array<{
+            date: string;
+            quality: 'HIGH' | 'MEDIUM' | 'LOW';
+            qualityScore: number;
+            metrics: {
+                sent: number;
+                delivered: number;
+                read: number;
+                responded: number;
+                complained: number;
+            };
+        }>;
+    };
+}
+export interface ZNSTemplateStatus {
+    templateId: string;
+    status: 'PENDING_REVIEW' | 'ENABLE' | 'REJECT' | 'DISABLE';
+    rejectReason?: string;
+    enabledTime?: string;
+    disabledTime?: string;
+}
+export interface ZNSComponent {
+    type: 'HEADER' | 'BODY' | 'FOOTER';
+    format?: 'TEXT' | 'IMAGE' | 'VIDEO';
+    text?: string;
+    url?: string;
+    example?: {
+        header_text?: string[];
+        body_text?: string[][];
+        header_handle?: string[];
+    };
+}
+export interface ZNSTemplateComponent {
+    type: 'TITLE' | 'PARAGRAPH' | 'TABLE' | 'LOGO' | 'IMAGE' | 'BUTTONS';
+    content?: string;
+    url?: string;
+    buttons?: Array<{
+        title: string;
+        type: 'PHONE_NUMBER' | 'URL';
+        payload: string;
+    }>;
+    table?: {
+        headers: string[];
+        rows: string[][];
+    };
+}
+export interface ZNSError {
+    error: number;
+    message: string;
+    details?: {
+        field?: string;
+        code?: string;
+        description?: string;
+    };
+}
+export interface ZNSAnalytics {
+    templateId: string;
+    period: {
+        from: string;
+        to: string;
+    };
+    metrics: {
+        sent: number;
+        delivered: number;
+        read: number;
+        clicked: number;
+        failed: number;
+        deliveryRate: number;
+        readRate: number;
+        clickRate: number;
+    };
+    breakdown?: {
+        daily?: Array<{
+            date: string;
+            sent: number;
+            delivered: number;
+            read: number;
+            clicked: number;
+            failed: number;
+        }>;
+        hourly?: Array<{
+            hour: number;
+            sent: number;
+            delivered: number;
+            read: number;
+            clicked: number;
+            failed: number;
+        }>;
+    };
+}
+//# sourceMappingURL=zns.d.ts.map

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

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

package/dist/types/zns.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * ZNS (Zalo Notification Service) Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=zns.js.map

package/dist/types/zns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zns.js","sourceRoot":"","sources":["../../src/types/zns.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/zalo-sdk.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Main Zalo SDK class
+ */
+import { AuthService } from "./services/auth.service";
+import { OAService } from "./services/oa.service";
+import { UserService } from "./services/user.service";
+import { ZNSService } from "./services/zns.service";
+import { GroupMessageService } from "./services/group-message.service";
+import { GroupManagementService } from "./services/group-management.service";
+import { UserManagementService } from "./services/user-management.service";
+import { TagService } from "./services/tag.service";
+import { ArticleService } from "./services/article.service";
+import { VideoUploadService } from "./services/video-upload.service";
+import { ConsultationService } from "./services/consultation.service";
+import { TransactionService } from "./services/transaction.service";
+import { PromotionService } from "./services/promotion.service";
+import { GeneralMessageService } from "./services/general-message.service";
+import { MessageManagementService } from "./services/message-management.service";
+import { ZaloSDKConfig } from "./types/common";
+import { AccessToken, SocialUserInfo } from "./types/auth";
+import { OAInfo, MessageQuota } from "./types/oa";
+import { SendMessageResponse } from "./types/message";
+import { UserInfo, UserListRequest } from "./types/user";
+/**
+ * Main Zalo SDK class providing access to all Zalo APIs
+ */
+export declare class ZaloSDK {
+    private readonly client;
+    private readonly logger;
+    readonly auth: AuthService;
+    readonly oa: OAService;
+    readonly user: UserService;
+    readonly zns: ZNSService;
+    readonly groupMessage: GroupMessageService;
+    readonly groupManagement: GroupManagementService;
+    readonly userManagement: UserManagementService;
+    readonly tag: TagService;
+    readonly article: ArticleService;
+    readonly videoUpload: VideoUploadService;
+    readonly consultation: ConsultationService;
+    readonly transaction: TransactionService;
+    readonly promotion: PromotionService;
+    readonly generalMessage: GeneralMessageService;
+    readonly messageManagement: MessageManagementService;
+    readonly config: Required<ZaloSDKConfig>;
+    constructor(config: ZaloSDKConfig);
+    /**
+     * Quick method to get OA access token from authorization code
+     */
+    getOAAccessToken(code: string, redirectUri: string): Promise<AccessToken>;
+    /**
+     * Quick method to get Social access token from authorization code
+     */
+    getSocialAccessToken(code: string, redirectUri: string, codeVerifier?: string): Promise<AccessToken>;
+    /**
+     * Quick method to refresh OA access token
+     */
+    refreshOAAccessToken(refreshToken: string): Promise<AccessToken>;
+    /**
+     * Quick method to refresh Social access token
+     */
+    refreshSocialAccessToken(refreshToken: string): Promise<AccessToken>;
+    /**
+     * Quick method to get OA information
+     */
+    getOAInfo(accessToken: string): Promise<OAInfo>;
+    /**
+     * Quick method to get message quota
+     */
+    getMessageQuota(accessToken: string): Promise<MessageQuota>;
+    /**
+     * Quick method to get Social user information
+     */
+    getSocialUserInfo(accessToken: string, fields?: string): Promise<SocialUserInfo>;
+    /**
+     * Quick method to send consultation text message
+     */
+    sendConsultationText(accessToken: string, userId: string, text: string): Promise<SendMessageResponse>;
+    /**
+     * Quick method to send consultation image message
+     */
+    sendConsultationImage(accessToken: string, userId: string, imageUrl: string): Promise<SendMessageResponse>;
+    /**
+     * Quick method to get user information
+     */
+    getUserInfo(accessToken: string, userId: string): Promise<UserInfo>;
+    /**
+     * Quick method to get user list
+     */
+    getUserList(accessToken: string, request: UserListRequest): Promise<any>;
+    /**
+     * Quick method to get all followers
+     */
+    getFollowers(accessToken: string): Promise<any>;
+    /**
+     * Quick method to register webhook handlers
+     */
+    /**
+     * Quick method to process webhook
+     */
+    /**
+     * Create OA authorization URL
+     */
+    createOAAuthUrl(redirectUri: string, state?: string): string;
+    /**
+     * Create Social authorization URL
+     */
+    createSocialAuthUrl(redirectUri: string, state?: string): string;
+    /**
+     * Generate PKCE for Social API
+     */
+    generatePKCE(): import("./types/auth").PKCEConfig;
+    /**
+     * Validate access token
+     */
+    validateAccessToken(accessToken: string, scope?: "oa" | "social"): Promise<boolean>;
+    /**
+     * Get SDK version
+     */
+    getVersion(): string;
+    /**
+     * Get SDK configuration (without sensitive data)
+     */
+    getConfig(): Omit<Required<ZaloSDKConfig>, "appSecret">;
+    /**
+     * Enable or disable debug logging
+     */
+    setDebug(enabled: boolean): void;
+    /**
+     * Test SDK connectivity
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get available API endpoints
+     */
+    getEndpoints(): {
+        auth: {
+            oaAuth: string;
+            socialAuth: string;
+            oaToken: string;
+            socialToken: string;
+            refreshOaToken: string;
+            refreshSocialToken: string;
+        };
+        oa: {
+            info: string;
+            quota: string;
+            quotaMessage: string;
+        };
+        user: {
+            info: string;
+            list: string;
+            update: string;
+            tags: string;
+            addTag: string;
+            removeTag: string;
+        };
+        message: {
+            send: string;
+            sendTransaction: string;
+            sendPromotion: string;
+            sendAnonymous: string;
+        };
+        upload: {
+            image: string;
+            file: string;
+        };
+        article: {
+            create: string;
+            update: string;
+            remove: string;
+            verify: string;
+            detail: string;
+            list: string;
+            uploadVideo: string;
+            checkVideoStatus: string;
+            videoInfo: string;
+        };
+        group: {
+            create: string;
+            list: string;
+            detail: string;
+            update: string;
+            updateAvatar: string;
+            delete: string;
+            members: string;
+            invite: string;
+            pendingMembers: string;
+            acceptPending: string;
+            rejectPending: string;
+            removeMembers: string;
+            addAdmins: string;
+            removeAdmins: string;
+            sendMessage: string;
+            conversation: string;
+            recentChats: string;
+            quota: string;
+        };
+        zns: {
+            templates: string;
+            templateDetail: string;
+            createTemplate: string;
+            updateTemplate: string;
+            deleteTemplate: string;
+            sendMessage: string;
+            sendHashPhone: string;
+            sendJourney: string;
+            uploadImage: string;
+            quality: string;
+        };
+        social: {
+            userInfo: string;
+        };
+    };
+    /**
+     * Make a custom API request (advanced usage)
+     */
+    customRequest<T = any>(method: "GET" | "POST" | "PUT" | "DELETE", endpoint: string, accessToken: string, data?: any, params?: Record<string, any>): Promise<T>;
+    /**
+     * Upload file to Zalo API
+     */
+    uploadFile<T = any>(endpoint: string, accessToken: string, file: Buffer | NodeJS.ReadableStream, filename: string, additionalFields?: Record<string, any>): Promise<T>;
+    /**
+     * Dispose SDK resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=zalo-sdk.d.ts.map

package/dist/zalo-sdk.d.ts.map

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