hrvclan 1.0.0

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "hrvclan",
+  "version": "1.0.0",
+  "description": "Generate leaderboard card images using hrv-web.netlify.app API",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "keywords": [
+    "leaderboard",
+    "card",
+    "image-generator",
+    "hrv-web",
+    "api"
+  ],
+  "author": "Nguyễn Thành Tài",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.13.5",
+    "node-fetch": "^3.3.2",
+    "puppeteer": "^24.37.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.2",
+    "typescript": "^5.5.4"
+  },
+  "files": [
+    "src/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nthanhtai08/hrvclan.git"
+  }
+}

package/readme.md

@@ -0,0 +1,46 @@
+# 📊 Leaderboard HTML → PNG Renderer (CommonJS)
+
+Module Node.js sử dụng **Puppeteer** để:
+
+- Encode dữ liệu leaderboard
+- Gửi lên API HTML
+- Render trang HTML
+- Chụp màn hình thành ảnh PNG
+- Lưu file về máy
+
+Hoạt động với **CommonJS (`require`)**, không dùng ESModule.
+
+---
+
+# 🚀 1. Yêu cầu
+
+- Node.js >= 18
+- Không dùng `"type": "module"` trong `package.json`
+- Windows / Linux / VPS đều chạy được
+
+Kiểm tra Node:
+
+```bash
+node -v
+```
+# 2. How to use
+```
+## Bước 1: Cài Module
+```npm install @nthanhtai08/hrvclan```
+## Bước 2: Import Package
+```
+const {
+  getLeaderboardCardUrl,
+  fetchLeaderboardCardImage,
+  saveLeaderboardImage
+} = require('hrvclan');
+```
+## Bước 3: Done
+```
+async function run() {
+  await saveLeaderboardImage(entries, "./leaderboard.png");
+  console.log("✅ Done");
+}
+
+run();
+```

package/src/index.js

@@ -0,0 +1,104 @@
+const puppeteer = require('puppeteer');
+const fs = require('fs');
+
+/**
+ * Encode base64url
+ */
+function toBase64Url(input) {
+  return Buffer
+    .from(input, 'utf8')
+    .toString('base64')
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=+$/, '');
+}
+
+/**
+ * Validate entries
+ */
+function validateEntries(entries) {
+  if (!Array.isArray(entries) || entries.length === 0) {
+    throw new Error('Entries phải là mảng và có ít nhất 1 phần tử');
+  }
+
+  entries.forEach((entry, index) => {
+    if (!entry.name || typeof entry.name !== 'string') {
+      throw new Error(`Entry ${index + 1}: name không hợp lệ`);
+    }
+
+    if (typeof entry.score !== 'number' || !Number.isFinite(entry.score)) {
+      throw new Error(`Entry ${index + 1}: score không hợp lệ`);
+    }
+
+    if (typeof entry.avatar !== 'string') {
+      throw new Error(`Entry ${index + 1}: avatar phải là string`);
+    }
+  });
+}
+
+/**
+ * Tạo URL
+ */
+function getLeaderboardCardUrl(entries) {
+  validateEntries(entries);
+
+  const encoded = toBase64Url(JSON.stringify(entries));
+
+  return `https://hrv-web.netlify.app/apis/leaderboard-card?data=${encoded}`;
+}
+
+async function fetchLeaderboardCardImage(entries) {
+  const url = getLeaderboardCardUrl(entries);
+
+  const browser = await puppeteer.launch({
+    headless: true,
+    args: ['--no-sandbox', '--disable-setuid-sandbox']
+  });
+
+  try {
+    const page = await browser.newPage();
+
+    // Viewport dọc 9:16
+    await page.setViewport({
+      width: 1080,
+      height: 1920,
+      deviceScaleFactor: 2
+    });
+
+    await page.goto(url, {
+      waitUntil: 'networkidle0',
+      timeout: 30000
+    });
+
+    // Đợi container render xong
+    await page.waitForSelector('.container');
+
+    const element = await page.$('.container');
+
+    if (!element) throw new Error('Không tìm thấy .container');
+
+    const screenshot = await element.screenshot({
+      type: 'png'
+    });
+
+    return screenshot;
+
+  } finally {
+    await browser.close();
+  }
+}
+
+
+async function saveLeaderboardImage(entries, filePath) {
+  const buffer = await fetchLeaderboardCardImage(entries);
+  fs.writeFileSync(filePath, buffer);
+}
+
+/**
+ * Export CommonJS
+ */
+module.exports = {
+  getLeaderboardCardUrl,
+  fetchLeaderboardCardImage,
+  saveLeaderboardImage
+};