@warriorteam/redai-zalo-sdk 1.6.0 → 1.6.2

package/examples/article-status-update.ts

@@ -0,0 +1,178 @@
+/**
+ * Example: Update Article Status
+ * 
+ * Demonstrates how to update article status using the RedAI Zalo SDK
+ */
+
+import { ZaloSDK, ArticleStatus, CommentStatus } from '../src';
+
+async function updateArticleStatusExample() {
+  // Initialize SDK
+  const sdk = new ZaloSDK();
+  
+  // Your access token
+  const accessToken = 'YOUR_ACCESS_TOKEN';
+  
+  // Article ID to update
+  const articleId = 'YOUR_ARTICLE_ID';
+
+  try {
+    console.log('🔄 Updating article status...');
+
+    // Example 1: Update status to 'show' (publish)
+    const publishResult = await sdk.article.updateArticleStatus(
+      accessToken,
+      articleId,
+      ArticleStatus.SHOW
+    );
+    
+    console.log('✅ Article published successfully!');
+    console.log('Update token:', publishResult.token);
+
+    // Wait a moment before next update
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
+    // Example 2: Update status to 'hide' (unpublish) and disable comments
+    const hideResult = await sdk.article.updateArticleStatus(
+      accessToken,
+      articleId,
+      ArticleStatus.HIDE,
+      CommentStatus.HIDE
+    );
+    
+    console.log('✅ Article hidden successfully!');
+    console.log('Update token:', hideResult.token);
+
+    // Example 3: Check update progress
+    console.log('🔍 Checking update progress...');
+    const progress = await sdk.article.checkArticleProcess(
+      accessToken,
+      hideResult.token
+    );
+    
+    console.log('Update progress:', progress);
+
+    // Example 4: Get updated article details to verify changes
+    console.log('📄 Getting updated article details...');
+    const updatedArticle = await sdk.article.getArticleDetail(
+      accessToken,
+      articleId
+    );
+    
+    console.log('Updated article status:', updatedArticle.status);
+    console.log('Updated comment status:', updatedArticle.comment);
+
+  } catch (error) {
+    console.error('❌ Error updating article status:', error);
+    
+    if (error instanceof Error) {
+      console.error('Error message:', error.message);
+    }
+  }
+}
+
+// Advanced example: Batch status update
+async function batchUpdateArticleStatus() {
+  const sdk = new ZaloSDK();
+  const accessToken = 'YOUR_ACCESS_TOKEN';
+  
+  // List of article IDs to update
+  const articleIds = ['ARTICLE_ID_1', 'ARTICLE_ID_2', 'ARTICLE_ID_3'];
+  
+  console.log('🔄 Batch updating article statuses...');
+  
+  const results = [];
+  
+  for (const articleId of articleIds) {
+    try {
+      console.log(`Updating article ${articleId}...`);
+      
+      const result = await sdk.article.updateArticleStatus(
+        accessToken,
+        articleId,
+        ArticleStatus.SHOW,
+        CommentStatus.SHOW
+      );
+      
+      results.push({
+        articleId,
+        success: true,
+        token: result.token
+      });
+      
+      console.log(`✅ Article ${articleId} updated successfully`);
+      
+      // Add delay to avoid rate limiting
+      await new Promise(resolve => setTimeout(resolve, 1000));
+      
+    } catch (error) {
+      console.error(`❌ Failed to update article ${articleId}:`, error);
+      
+      results.push({
+        articleId,
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown error'
+      });
+    }
+  }
+  
+  console.log('📊 Batch update results:', results);
+  return results;
+}
+
+// Example with error handling and retry logic
+async function updateArticleStatusWithRetry() {
+  const sdk = new ZaloSDK();
+  const accessToken = 'YOUR_ACCESS_TOKEN';
+  const articleId = 'YOUR_ARTICLE_ID';
+  const maxRetries = 3;
+  
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      console.log(`🔄 Attempt ${attempt}/${maxRetries}: Updating article status...`);
+      
+      const result = await sdk.article.updateArticleStatus(
+        accessToken,
+        articleId,
+        ArticleStatus.SHOW
+      );
+      
+      console.log('✅ Article status updated successfully!');
+      console.log('Update token:', result.token);
+      
+      return result;
+      
+    } catch (error) {
+      console.error(`❌ Attempt ${attempt} failed:`, error);
+      
+      if (attempt === maxRetries) {
+        console.error('🚫 All retry attempts failed');
+        throw error;
+      }
+      
+      // Wait before retry (exponential backoff)
+      const delay = Math.pow(2, attempt) * 1000;
+      console.log(`⏳ Waiting ${delay}ms before retry...`);
+      await new Promise(resolve => setTimeout(resolve, delay));
+    }
+  }
+}
+
+// Run examples
+if (require.main === module) {
+  console.log('🚀 Running Article Status Update Examples...\n');
+  
+  // Uncomment the example you want to run:
+  
+  // updateArticleStatusExample();
+  // batchUpdateArticleStatus();
+  // updateArticleStatusWithRetry();
+  
+  console.log('\n💡 Remember to replace YOUR_ACCESS_TOKEN and YOUR_ARTICLE_ID with actual values!');
+}
+
+export {
+  updateArticleStatusExample,
+  batchUpdateArticleStatus,
+  updateArticleStatusWithRetry
+};

package/examples/user-list-post-example.ts

@@ -1,186 +1,186 @@
-/**
- * Example: Using POST method to get user list
- * Demonstrates the new postUserList method in UserService
- */
-
-import { ZaloSDK, UserListRequest } from "../src/index";
-
-async function demonstratePostUserList() {
-  // Initialize SDK
-  const zalo = new ZaloSDK({
-    appId: "your-app-id",
-    appSecret: "your-app-secret"
-  });
-
-  const accessToken = "your-access-token";
-
-  try {
-    console.log("=== POST User List Example ===\n");
-
-    // Example 1: Basic user list with POST method
-    console.log("1. Getting user list with POST method:");
-    const basicRequest: UserListRequest = {
-      offset: 0,
-      count: 10
-    };
-
-    const basicResult = await zalo.user.postUserList(accessToken, basicRequest);
-    console.log("Basic POST result:", {
-      total: basicResult.total,
-      userCount: basicResult.users.length,
-      users: basicResult.users.map(user => ({
-        user_id: user.user_id,
-        display_name: user.display_name,
-        user_is_follower: user.user_is_follower
-      }))
-    });
-
-    // Example 2: Filtered user list with tag
-    console.log("\n2. Getting users with specific tag (POST method):");
-    const taggedRequest: UserListRequest = {
-      offset: 0,
-      count: 20,
-      tag_name: "VIP_CUSTOMER"
-    };
-
-    const taggedResult = await zalo.user.postUserList(accessToken, taggedRequest);
-    console.log("Tagged users POST result:", {
-      total: taggedResult.total,
-      userCount: taggedResult.users.length,
-      tag_filter: "VIP_CUSTOMER"
-    });
-
-    // Example 3: Followers only with POST method
-    console.log("\n3. Getting followers only (POST method):");
-    const followersRequest: UserListRequest = {
-      offset: 0,
-      count: 15,
-      is_follower: true
-    };
-
-    const followersResult = await zalo.user.postUserList(accessToken, followersRequest);
-    console.log("Followers POST result:", {
-      total: followersResult.total,
-      userCount: followersResult.users.length,
-      followers_only: true
-    });
-
-    // Example 4: Users with recent interaction (POST method)
-    console.log("\n4. Getting users with recent interaction (POST method):");
-    const recentRequest: UserListRequest = {
-      offset: 0,
-      count: 25,
-      last_interaction_period: "7d" // Last 7 days
-    };
-
-    const recentResult = await zalo.user.postUserList(accessToken, recentRequest);
-    console.log("Recent interaction POST result:", {
-      total: recentResult.total,
-      userCount: recentResult.users.length,
-      interaction_period: "7d"
-    });
-
-    // Example 5: Compare GET vs POST methods
-    console.log("\n5. Comparing GET vs POST methods:");
-    
-    const compareRequest: UserListRequest = {
-      offset: 0,
-      count: 5
-    };
-
-    // GET method
-    const getResult = await zalo.user.getUserList(accessToken, compareRequest);
-    console.log("GET method result:", {
-      total: getResult.total,
-      userCount: getResult.users.length,
-      method: "GET"
-    });
-
-    // POST method
-    const postResult = await zalo.user.postUserList(accessToken, compareRequest);
-    console.log("POST method result:", {
-      total: postResult.total,
-      userCount: postResult.users.length,
-      method: "POST"
-    });
-
-    console.log("Results should be identical:", {
-      totals_match: getResult.total === postResult.total,
-      counts_match: getResult.users.length === postResult.users.length
-    });
-
-  } catch (error) {
-    console.error("Error in POST user list example:", error);
-    
-    if (error instanceof Error) {
-      console.error("Error details:", {
-        name: error.name,
-        message: error.message,
-        stack: error.stack
-      });
-    }
-  }
-}
-
-// Example usage with pagination using POST method
-async function demonstratePaginationWithPost() {
-  const zalo = new ZaloSDK({
-    appId: "your-app-id",
-    appSecret: "your-app-secret"
-  });
-
-  const accessToken = "your-access-token";
-
-  try {
-    console.log("\n=== POST Method Pagination Example ===\n");
-
-    let offset = 0;
-    const count = 10;
-    let allUsers: any[] = [];
-    let totalUsers = 0;
-
-    do {
-      const request: UserListRequest = {
-        offset,
-        count
-      };
-
-      const result = await zalo.user.postUserList(accessToken, request);
-      
-      console.log(`Page ${Math.floor(offset / count) + 1}:`, {
-        offset,
-        returned: result.users.length,
-        total: result.total
-      });
-
-      allUsers.push(...result.users);
-      totalUsers = result.total;
-      offset += count;
-
-      // Break if we've got all users or no more users returned
-      if (result.users.length < count || allUsers.length >= totalUsers) {
-        break;
-      }
-
-    } while (true);
-
-    console.log("\nPagination complete:", {
-      total_users: totalUsers,
-      fetched_users: allUsers.length,
-      method: "POST"
-    });
-
-  } catch (error) {
-    console.error("Error in POST pagination example:", error);
-  }
-}
-
-// Run examples
-if (require.main === module) {
-  demonstratePostUserList()
-    .then(() => demonstratePaginationWithPost())
-    .then(() => console.log("\n✅ POST User List examples completed!"))
-    .catch(error => console.error("❌ Example failed:", error));
-}
-
-export { demonstratePostUserList, demonstratePaginationWithPost };
+/**
+ * Example: Using POST method to get user list
+ * Demonstrates the new postUserList method in UserService
+ */
+
+import { ZaloSDK, UserListRequest } from "../src/index";
+
+async function demonstratePostUserList() {
+  // Initialize SDK
+  const zalo = new ZaloSDK({
+    appId: "your-app-id",
+    appSecret: "your-app-secret"
+  });
+
+  const accessToken = "your-access-token";
+
+  try {
+    console.log("=== POST User List Example ===\n");
+
+    // Example 1: Basic user list with POST method
+    console.log("1. Getting user list with POST method:");
+    const basicRequest: UserListRequest = {
+      offset: 0,
+      count: 10
+    };
+
+    const basicResult = await zalo.user.postUserList(accessToken, basicRequest);
+    console.log("Basic POST result:", {
+      total: basicResult.total,
+      userCount: basicResult.users.length,
+      users: basicResult.users.map(user => ({
+        user_id: user.user_id,
+        display_name: user.display_name,
+        user_is_follower: user.user_is_follower
+      }))
+    });
+
+    // Example 2: Filtered user list with tag
+    console.log("\n2. Getting users with specific tag (POST method):");
+    const taggedRequest: UserListRequest = {
+      offset: 0,
+      count: 20,
+      tag_name: "VIP_CUSTOMER"
+    };
+
+    const taggedResult = await zalo.user.postUserList(accessToken, taggedRequest);
+    console.log("Tagged users POST result:", {
+      total: taggedResult.total,
+      userCount: taggedResult.users.length,
+      tag_filter: "VIP_CUSTOMER"
+    });
+
+    // Example 3: Followers only with POST method
+    console.log("\n3. Getting followers only (POST method):");
+    const followersRequest: UserListRequest = {
+      offset: 0,
+      count: 15,
+      is_follower: true
+    };
+
+    const followersResult = await zalo.user.postUserList(accessToken, followersRequest);
+    console.log("Followers POST result:", {
+      total: followersResult.total,
+      userCount: followersResult.users.length,
+      followers_only: true
+    });
+
+    // Example 4: Users with recent interaction (POST method)
+    console.log("\n4. Getting users with recent interaction (POST method):");
+    const recentRequest: UserListRequest = {
+      offset: 0,
+      count: 25,
+      last_interaction_period: "7d" // Last 7 days
+    };
+
+    const recentResult = await zalo.user.postUserList(accessToken, recentRequest);
+    console.log("Recent interaction POST result:", {
+      total: recentResult.total,
+      userCount: recentResult.users.length,
+      interaction_period: "7d"
+    });
+
+    // Example 5: Compare GET vs POST methods
+    console.log("\n5. Comparing GET vs POST methods:");
+    
+    const compareRequest: UserListRequest = {
+      offset: 0,
+      count: 5
+    };
+
+    // GET method
+    const getResult = await zalo.user.getUserList(accessToken, compareRequest);
+    console.log("GET method result:", {
+      total: getResult.total,
+      userCount: getResult.users.length,
+      method: "GET"
+    });
+
+    // POST method
+    const postResult = await zalo.user.postUserList(accessToken, compareRequest);
+    console.log("POST method result:", {
+      total: postResult.total,
+      userCount: postResult.users.length,
+      method: "POST"
+    });
+
+    console.log("Results should be identical:", {
+      totals_match: getResult.total === postResult.total,
+      counts_match: getResult.users.length === postResult.users.length
+    });
+
+  } catch (error) {
+    console.error("Error in POST user list example:", error);
+    
+    if (error instanceof Error) {
+      console.error("Error details:", {
+        name: error.name,
+        message: error.message,
+        stack: error.stack
+      });
+    }
+  }
+}
+
+// Example usage with pagination using POST method
+async function demonstratePaginationWithPost() {
+  const zalo = new ZaloSDK({
+    appId: "your-app-id",
+    appSecret: "your-app-secret"
+  });
+
+  const accessToken = "your-access-token";
+
+  try {
+    console.log("\n=== POST Method Pagination Example ===\n");
+
+    let offset = 0;
+    const count = 10;
+    let allUsers: any[] = [];
+    let totalUsers = 0;
+
+    do {
+      const request: UserListRequest = {
+        offset,
+        count
+      };
+
+      const result = await zalo.user.postUserList(accessToken, request);
+      
+      console.log(`Page ${Math.floor(offset / count) + 1}:`, {
+        offset,
+        returned: result.users.length,
+        total: result.total
+      });
+
+      allUsers.push(...result.users);
+      totalUsers = result.total;
+      offset += count;
+
+      // Break if we've got all users or no more users returned
+      if (result.users.length < count || allUsers.length >= totalUsers) {
+        break;
+      }
+
+    } while (true);
+
+    console.log("\nPagination complete:", {
+      total_users: totalUsers,
+      fetched_users: allUsers.length,
+      method: "POST"
+    });
+
+  } catch (error) {
+    console.error("Error in POST pagination example:", error);
+  }
+}
+
+// Run examples
+if (require.main === module) {
+  demonstratePostUserList()
+    .then(() => demonstratePaginationWithPost())
+    .then(() => console.log("\n✅ POST User List examples completed!"))
+    .catch(error => console.error("❌ Example failed:", error));
+}
+
+export { demonstratePostUserList, demonstratePaginationWithPost };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warriorteam/redai-zalo-sdk",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account, ZNS, Consultation Service, Group Messaging, and Social APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -64,7 +64,8 @@
     "examples/**/*",
     "ARCHITECTURE.md",
     "SERVICES_ADDED.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "UPDATE_ARTICLE_STATUS.md"
   ],
   "engines": {
     "node": ">=16.0.0"