channel-worker 2.5.113 → 2.5.118

package/lib/api-client.js

@@ -75,7 +75,7 @@ class ApiClient {
     // nào — xảy ra 14/09 với verify_facebook_reels_pw (cổng thứ nhất là enum
     // của app/models/WorkerCommand.js, cũng đã quên một lần cùng ngày).
     // api/tests/publish-verify-wiring.test.js canh cả hai cổng.
-    const workerTypes = 'launch_profile,close_profile,launch_veo3_profile,set_profile_proxy,save_file,set_thumbnail,set_tags,set_file_input,click_and_upload,type_text,verify_logins,update_extension,sync_youtube_stats,restart_worker,upload_youtube_pw,upload_tiktok_pw,upload_facebook_pw,upload_facebook_photo_pw,warmup_youtube_pw,warmup_facebook_pw,warmup_tiktok_pw,nurture_facebook_pw,fetch_facebook_reel_stats_pw,verify_facebook_reels_pw,comment_facebook_pw,scrape_affiliate_products,ingest_shopee_product,get_affiliate_link';
+    const workerTypes = 'launch_profile,close_profile,launch_veo3_profile,set_profile_proxy,save_file,set_thumbnail,set_tags,set_file_input,click_and_upload,type_text,verify_logins,update_extension,sync_youtube_stats,restart_worker,upload_youtube_pw,upload_tiktok_pw,upload_facebook_pw,upload_facebook_photo_pw,upload_facebook_post_pw,warmup_youtube_pw,warmup_facebook_pw,warmup_tiktok_pw,nurture_facebook_pw,fetch_facebook_reel_stats_pw,verify_facebook_reels_pw,comment_facebook_pw,scrape_affiliate_products,ingest_shopee_product,get_affiliate_link,fetch_affiliate_report';
     return this.request('GET', `/workers/commands?worker_id=${workerId}&types=${encodeURIComponent(workerTypes)}`);
   }
 
@@ -107,6 +107,10 @@ class ApiClient {
     return this.request('POST', '/products/worker-link', { links, user_id, sub_ids, idea_id });
   }
 
+  async affiliateReportResult(rows, meta = {}) {
+    return this.request('POST', '/affiliate-report/worker-ingest', { rows, ...meta });
+  }
+
   // Return the calling daemon's own Worker doc — primarily for reading
   // parallel_limit (the per-daemon scene-generation concurrency cap that
   // replaced the legacy global flowkit_max_concurrent setting).

package/lib/command-poller.js

@@ -1,4 +1,5 @@
 const { NstManager } = require('./nst-manager');
+const { refreshPinnedAgentAddress } = require('./nst-agent-locator');
 const { checkAndUpdateExtension } = require('./extension-updater');
 const { StatsSyncer } = require('./stats-syncer');
 
@@ -7,6 +8,12 @@ const { StatsSyncer } = require('./stats-syncer');
 // tới và dùng lại browser, nhưng không được để mở qua đêm.
 const PW_IDLE_CLOSE_MS = Number(process.env.PW_IDLE_CLOSE_MS || 5 * 60 * 1000);
 
+// Người bấm "Mở trình duyệt" trên web → profile đó là của NGƯỜI trong quãng
+// này, automation không được đóng ngang. Trước 16/09/2026 không có hàng rào
+// nào: hẹn đóng 300s của lượt đăng bài trước đó vẫn chạy và đóng profile ngay
+// trước mũi chủ tịch (đo thật: kenh-21, mở 11:42 → bị đóng vài phút sau).
+const HUMAN_HOLD_MS = Number(process.env.HUMAN_HOLD_MS || 15 * 60 * 1000);
+
 class CommandPoller {
   constructor(api, config) {
     this.api = api;
@@ -118,6 +125,9 @@ class CommandPoller {
         case 'get_affiliate_link':
           await this.handleGetAffiliateLink(command);
           break;
+        case 'fetch_affiliate_report':
+          await this.handleFetchAffiliateReport(command);
+          break;
         default:
           // Playwright-based pipeline: any command whose type ends in '_pw'
           // is routed to scripts/<base>.js (BrowserClaw-style automation
@@ -332,6 +342,59 @@ class CommandPoller {
     }
   }
 
+  async handleFetchAffiliateReport(command) {
+    const payload = command.payload || {};
+    if (!(await this._ensureNst(command))) return;
+    const report = require('./shopee-report');
+    const profileName = payload.profile_name
+      || (await this.api.getSetting('shopee_affiliate_profile').catch(() => null))
+      || 'Shopee1';
+    let conn;
+    try {
+      conn = await this._connectNstProfileByName(profileName);
+      const result = await report.fetchConversionReport(conn.context, {
+        days: payload.days || 90,
+        log: (message) => console.log(message),
+      });
+      if (result.status === 'needs_verify') {
+        await this.api.updateCommand(command._id, {
+          status: 'done',
+          result: { needs_verify: true, reason: result.reason, count: result.rows?.length || 0 },
+        });
+        return;
+      }
+      if (result.status !== 'ok') {
+        await this.api.updateCommand(command._id, {
+          status: 'failed', error: String(result.reason || 'Không đọc được báo cáo Shopee').slice(0, 500),
+        });
+        return;
+      }
+
+      const saved = await this.api.affiliateReportResult(result.rows, {
+        last_report_date: result.last_report_date,
+        last_update_time: result.last_update_time,
+        from: result.from,
+        to: result.to,
+      });
+      await this.api.updateCommand(command._id, {
+        status: 'done',
+        result: {
+          count: result.rows.length,
+          saved: saved?.saved || 0,
+          matched: saved?.matched || 0,
+          unmatched: saved?.unmatched || 0,
+          last_report_date: result.last_report_date,
+        },
+      });
+      console.log(`[shopee-report] đã lưu ${saved?.saved || 0}/${result.rows.length} dòng; khớp kênh ${saved?.matched || 0}`);
+    } catch (err) {
+      console.error(`[shopee-report] đồng bộ thất bại: ${err.message}`);
+      await this.api.updateCommand(command._id, { status: 'failed', error: String(err.message || err).slice(0, 500) });
+    } finally {
+      if (conn) conn.disconnect();
+    }
+  }
+
   async handlePlaywrightCommand(command) {
     const { runPlaywrightScript } = require('./playwright-runner');
     const payload = command.payload || {};
@@ -538,6 +601,8 @@ class CommandPoller {
     if (!this._keptOpenProfiles || this._keptOpenProfiles.size <= max) return;
     const candidates = [...this._keptOpenProfiles.entries()]
       .filter(([id]) => !(this._pwInFlight && this._pwInFlight.has(id)))
+      // Profile người vừa mở tay không phải ứng viên để nhường suất.
+      .filter(([id]) => this._humanHoldLeft(id) <= 0)
       .sort((a, b) => a[1] - b[1]);
     let over = this._keptOpenProfiles.size - max;
     for (const [id] of candidates) {
@@ -558,7 +623,7 @@ class CommandPoller {
   // Hẹn đóng profile sau một quãng RẢNH. Lượt _pw kế tiếp của cùng profile huỷ
   // hẹn (xem đầu handlePlaywrightCommand), nên chuỗi upload nhiều nền tảng liên
   // tiếp vẫn dùng chung một browser như thiết kế cũ.
-  _schedulePwClose(profileId, scriptName) {
+  _schedulePwClose(profileId, scriptName, delayMs = PW_IDLE_CLOSE_MS) {
     if (!this._pwCloseTimers) this._pwCloseTimers = new Map();
     const prev = this._pwCloseTimers.get(profileId);
     if (prev) clearTimeout(prev);
@@ -566,13 +631,22 @@ class CommandPoller {
       this._pwCloseTimers.delete(profileId);
       // Có lệnh khác vừa chiếm profile này → để yên, lượt đó sẽ tự hẹn lại.
       if (this._pwInFlight && this._pwInFlight.has(profileId)) return;
+      // Người vừa mở profile này bằng tay → hoãn tới khi hết giữ chỗ. Đóng ở
+      // đây là đóng ngay trước mũi người đang ngồi trong browser.
+      const hold = this._humanHoldLeft(profileId);
+      if (hold > 0) {
+        console.log(`[commands/pw] hoãn đóng ${profileId} — người đang dùng, `
+          + `còn ${Math.ceil(hold / 1000)}s`);
+        this._schedulePwClose(profileId, scriptName, hold + 1000);
+        return;
+      }
       try {
         await this.nst.stopProfile(profileId);
-        console.log(`[commands/pw] đóng profile ${profileId} sau ${PW_IDLE_CLOSE_MS / 1000}s rảnh (${scriptName})`);
+        console.log(`[commands/pw] đóng profile ${profileId} sau ${delayMs / 1000}s rảnh (${scriptName})`);
       } catch (e) {
         console.warn(`[commands/pw] đóng trễ ${profileId} lỗi: ${e.message}`);
       }
-    }, PW_IDLE_CLOSE_MS);
+    }, delayMs);
     // Đừng giữ tiến trình sống chỉ vì một cái hẹn đóng browser.
     if (typeof t.unref === 'function') t.unref();
     this._pwCloseTimers.set(profileId, t);
@@ -640,12 +714,43 @@ class CommandPoller {
         }
       }
 
-      const result = await this.nst.launchProfile(profile_id, { proxy, extensionPath });
+      const result = await this._launchWithAgentRetry(profile_id, { proxy, extensionPath });
+
+      // Đang mở sẵn: KHÔNG có cửa sổ mới nào bật lên. Trên máy đang có hơn chục
+      // browser thì với người bấm, cú bấm coi như rơi vào hư không. Đẩy cửa sổ
+      // sẵn có lên trước và giữ nó lại cho người dùng.
+      if (result.alreadyRunning) {
+        this._cancelPwClose(profile_id);
+        this._holdProfileForHuman(profile_id);
+        const fronted = await this.nst.bringProfileToFront(profile_id);
+        console.log(`[commands] Profile ${profile_id} đang mở sẵn — `
+          + `${fronted ? 'đã đưa cửa sổ lên trước' : 'KHÔNG đưa được cửa sổ lên trước'}, `
+          + `giữ cho người dùng ${Math.round(HUMAN_HOLD_MS / 60000)} phút`);
+        await this.api.updateCommand(command._id, {
+          status: 'done',
+          result: {
+            profile_id: result.profileId,
+            already_running: true,
+            brought_to_front: fronted,
+            launched_at: new Date().toISOString(),
+            message: fronted
+              ? 'Profile đã mở sẵn — đã đưa cửa sổ lên trước trên máy chạy.'
+              : 'Profile đã mở sẵn trên máy chạy, nhưng không đưa được cửa sổ lên trước — tìm trong đám cửa sổ đang mở.',
+          },
+        });
+        return;
+      }
+
       console.log(`[commands] Profile ${profile_id} launched${extensionPath ? ' (ext)' : ''}`);
+      this._holdProfileForHuman(profile_id);
 
       await this.api.updateCommand(command._id, {
         status: 'done',
-        result: { profile_id: result.profileId, launched_at: new Date().toISOString() },
+        result: {
+          profile_id: result.profileId,
+          launched_at: new Date().toISOString(),
+          message: 'Đã mở trình duyệt trên máy chạy.',
+        },
       });
     } catch (err) {
       console.error(`[commands] Failed to launch profile: ${err.message}`);
@@ -656,6 +761,60 @@ class CommandPoller {
     }
   }
 
+  /**
+   * Mở profile, thử lại khi agent NST chưa dò ra.
+   *
+   * Agent đổi cổng mỗi lần Nstbrowser khởi động lại (chủ tịch tắt hết profile =
+   * app restart), và nó cần vài giây để nghe cổng mới. Không có vòng thử lại
+   * này thì cú bấm rơi đúng khoảng đó chết hẳn, người bấm phải tự đoán mà bấm
+   * lại — đúng cảnh 16/09/2026: lệnh 11:50:48 chết, lệnh 11:51:34 chạy ngon.
+   * Các lỗi khác (hết slot NST, profile mở ở phiên khác) KHÔNG thử lại: thử lại
+   * cũng vậy, mà còn giấu mất lỗi thật.
+   */
+  async _launchWithAgentRetry(profileId, options, { attempts = 3, waitMs = 3000 } = {}) {
+    let lastErr = null;
+    for (let i = 1; i <= attempts; i++) {
+      try {
+        return await this.nst.launchProfile(profileId, options);
+      } catch (err) {
+        lastErr = err;
+        if (!/NST_AGENT_UNRESOLVED/.test(err.message || '')) throw err;
+        if (i === attempts) break;
+        console.warn(`[commands] agent NST chưa sẵn sàng (lần ${i}/${attempts}) — `
+          + `dò lại sau ${waitMs / 1000}s`);
+        await new Promise(r => setTimeout(r, waitMs));
+        await refreshPinnedAgentAddress({ minIntervalMs: 0 });
+      }
+    }
+    throw lastErr;
+  }
+
+  // ─── Giữ chỗ cho NGƯỜI ────────────────────────────────────────────────────
+  // Profile do người mở bằng tay không được để automation đóng ngang: lượt đăng
+  // bài trước đó đã hẹn đóng sau PW_IDLE_CLOSE_MS và cái hẹn đó không biết có
+  // người đang ngồi trong browser.
+  _cancelPwClose(profileId) {
+    if (this._pwCloseTimers && this._pwCloseTimers.has(profileId)) {
+      clearTimeout(this._pwCloseTimers.get(profileId));
+      this._pwCloseTimers.delete(profileId);
+      return true;
+    }
+    return false;
+  }
+
+  _holdProfileForHuman(profileId, ms = HUMAN_HOLD_MS) {
+    if (!this._humanHold) this._humanHold = new Map();
+    this._humanHold.set(profileId, Date.now() + ms);
+  }
+
+  /** Còn bao nhiêu ms giữ chỗ cho người (0 = hết/không có). */
+  _humanHoldLeft(profileId) {
+    if (!this._humanHold || !profileId) return 0;
+    const left = (this._humanHold.get(profileId) || 0) - Date.now();
+    if (left <= 0) { this._humanHold.delete(profileId); return 0; }
+    return left;
+  }
+
   async handleLaunchVeo3Profile(command) {
     const { nst_profile_id, name, veo3_worker_id, os, proxy } = command.payload || {};
     console.log(`[commands] Launching Veo3 profile: ${nst_profile_id} (${name}) os=${os || 'windows'}`);
@@ -2173,6 +2332,8 @@ class CommandPoller {
         // Queue holds work pinned to THIS profile → it's about to be claimed,
         // leave the browser open.
         if (pinnedForId(profileId) > 0 || pinnedForId(name) > 0) continue;
+        // Người vừa mở profile này từ web → để yên cho tới hết giữ chỗ.
+        if (this._humanHoldLeft(profileId) > 0 || this._humanHoldLeft(browser.name) > 0) continue;
         // Match by UUID or name (renderers use name as nst_profile_id)
         const lastActivity = this._profileLastActivity[profileId]
           || (name && this._profileLastActivity[name])

package/lib/nst-agent-locator.js

@@ -159,7 +159,58 @@ function listAgentsCached(ttlMs = 60000, now = Date.now()) {
   return agents;
 }
 
+// Quên bản cache đi, lần dò sau đọc lại tiến trình thật. Gọi khi vừa biết
+// địa chỉ cũ đã sai — cache 60s đang giữ đúng cái bản đồ lỗi thời đó.
+function invalidateAgentCache() {
+  _agentCache = { at: 0, agents: [] };
+}
+
+/**
+ * Dò LẠI NGAY agent của user đang ghim, ghi thẳng vào NST_API_ADDRESS.
+ *
+ * Agent đổi cổng mỗi lần Nstbrowser khởi động lại (8848 ↔ 8849 theo thứ tự
+ * login). Watcher của daemon chỉ dò mỗi 60s, nên lệnh rơi vào khoảng trống đó
+ * chết oan bằng NST_AGENT_UNRESOLVED dù agent vẫn sống, chỉ nằm ở cổng khác.
+ * Đo thật trên win-worker 16/09/2026: chủ tịch tắt hết profile → agent nhảy
+ * 8849 → 8848; cú bấm "Mở trình duyệt" lúc 11:50:48 chết, cú 11:51:34 (sau khi
+ * watcher kịp chạy) mở được. Hàm này xoá hẳn khoảng trống đó.
+ *
+ * Fail-closed vẫn nguyên: dò không ra thì trả null và KHÔNG đặt địa chỉ nào —
+ * người gọi tiếp tục gặp NST_AGENT_UNRESOLVED thay vì rơi về :8848 của phiên
+ * Windows khác.
+ */
+let _pinnedRefresh = null;
+let _pinnedRefreshAt = 0;
+async function refreshPinnedAgentAddress({ minIntervalMs = 2000, now = Date.now() } = {}) {
+  const user = process.env.NST_AGENT_PINNED_USER;
+  if (!user) return process.env.NST_API_ADDRESS || null;
+  // Nhiều lệnh cùng vấp một lúc (đăng bài + nút bấm) — chỉ dò một lần, cả đám
+  // chờ chung kết quả; tasklist + netstat là lệnh nặng, đừng nhân lên.
+  if (_pinnedRefresh) return _pinnedRefresh;
+  if (now - _pinnedRefreshAt < minIntervalMs) return process.env.NST_API_ADDRESS || null;
+  _pinnedRefresh = (async () => {
+    try {
+      invalidateAgentCache();
+      const found = await agentAddressForUser(user);
+      if (!found) return null;
+      if (process.env.NST_API_ADDRESS !== found.address) {
+        console.log(`[nst] agent của "${user}" dò lại tại chỗ: ${found.address} `
+          + `(pid ${found.pid}, session ${found.sessionId}/${found.sessionName})`);
+      }
+      process.env.NST_API_ADDRESS = found.address;
+      return found.address;
+    } catch {
+      return null;
+    } finally {
+      _pinnedRefreshAt = Date.now();
+      _pinnedRefresh = null;
+    }
+  })();
+  return _pinnedRefresh;
+}
+
 module.exports = {
-  listAgents, listAgentsCached, resolveAgentForUser, agentAddressForUser, probeIsNstAgent, lanAddress,
+  listAgents, listAgentsCached, invalidateAgentCache, resolveAgentForUser, agentAddressForUser,
+  refreshPinnedAgentAddress, probeIsNstAgent, lanAddress,
   parseTasklistCsv, parseListening,
 };

package/lib/nst-manager.js

@@ -1,4 +1,4 @@
-const { listAgentsCached, lanAddress } = require('./nst-agent-locator');
+const { listAgentsCached, lanAddress, refreshPinnedAgentAddress } = require('./nst-agent-locator');
 
 function nstLaunchError(response, { profileId = '', runningCount = 0 } = {}) {
   const raw = String(response?.msg || 'Failed to connect browser').trim();
@@ -51,7 +51,21 @@ class NstManager {
     return 'http://localhost:8848/api/v2';
   }
 
+  /**
+   * Có địa chỉ agent chưa? Chưa thì dò lại NGAY thay vì chờ watcher 60s.
+   *
+   * Không đặt bừa địa chỉ nào khi dò không ra: `baseUrl` vẫn ném
+   * NST_AGENT_UNRESOLVED như cũ (fail-closed — mở nhầm agent của phiên Windows
+   * khác = profile trắng = báo logout oan cả loạt kênh).
+   */
+  async ensureAgent() {
+    if (this._apiAddress || process.env.NST_API_ADDRESS) return true;
+    if (!process.env.NST_AGENT_PINNED_USER) return true;
+    return Boolean(await refreshPinnedAgentAddress());
+  }
+
   async api(path, options = {}) {
+    await this.ensureAgent();
     const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
     const res = await fetch(url, {
       ...options,
@@ -92,6 +106,7 @@ class NstManager {
   // Get all running browsers
   async getRunningBrowsers() {
     try {
+      await this.ensureAgent();
       const rawRes = await fetch(`${this.baseUrl}/browsers`, {
         headers: { 'x-api-key': this.apiKey },
       });
@@ -139,6 +154,34 @@ class NstManager {
     return { profileId, httpEndpoint, wsEndpoint, port };
   }
 
+  /**
+   * Đưa cửa sổ của một profile ĐANG MỞ lên trước mặt người dùng.
+   *
+   * Người bấm "Mở trình duyệt" mà profile đã mở sẵn (lượt đăng bài tự động mở
+   * trước đó) thì `launchProfile` bỏ qua, không có cửa sổ nào bật lên — trên máy
+   * đang có hơn chục browser thì coi như không có gì xảy ra (chủ tịch gặp
+   * 16/09/2026 lúc 11:42).
+   *
+   * Đi qua cổng debug của chính Chrome (`/json/activate/<targetId>` → CDP
+   * Target.activateTarget): KHÔNG tốn lượt mở NST và không cần thư viện CDP.
+   * → true nếu đã đẩy được cửa sổ lên trước.
+   */
+  async bringProfileToFront(profileIdOrName) {
+    const ep = await this.resolveRunningEndpoint(profileIdOrName);
+    if (!ep) return false;
+    try {
+      const res = await fetch(`${ep.httpEndpoint}/json/list`);
+      const targets = await res.json();
+      const page = (Array.isArray(targets) ? targets : []).find(t => t.type === 'page');
+      if (!page || !page.id) return false;
+      const act = await fetch(`${ep.httpEndpoint}/json/activate/${page.id}`);
+      return act.ok;
+    } catch (e) {
+      console.warn(`[nst] bringProfileToFront ${profileIdOrName}: ${e.message}`);
+      return false;
+    }
+  }
+
   // Check if profile is already running
   async isProfileRunning(profileId) {
     const running = await this.getRunningBrowsers();
@@ -232,6 +275,7 @@ class NstManager {
     if (!proxyUrl) return;
     console.log(`[nst] Setting proxy for ${profileId}: ${proxyUrl}`);
     try {
+      await this.ensureAgent();
       const res = await fetch(`${this.baseUrl}/profiles/${profileId}/proxy`, {
         method: 'PUT',
         headers: { 'Content-Type': 'application/json', 'x-api-key': this.apiKey },
@@ -293,6 +337,7 @@ class NstManager {
 
   // Launch browser — skip if already running, set proxy if provided
   async launchProfile(profileIdOrName, options = {}) {
+    await this.ensureAgent();
     let profileId = profileIdOrName;
     if (!this.isUUID(profileIdOrName)) {
       profileId = await this.ensureProfile(profileIdOrName);

package/lib/shopee-report.js

@@ -0,0 +1,107 @@
+const { findAffiliatePage, isBlockedState } = require('./shopee-scraper');
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+function reportWindow(days = 90, nowMs = Date.now()) {
+  const safeDays = Math.min(180, Math.max(1, Number(days || 90)));
+  const vnNow = new Date(nowMs + 7 * 3600e3);
+  const vnDayStartAsUtc = Date.parse(`${vnNow.toISOString().slice(0, 10)}T00:00:00.000Z`);
+  const end = Math.floor(nowMs / 1000);
+  const start = Math.floor((vnDayStartAsUtc - 7 * 3600e3 - (safeDays - 1) * 86400e3) / 1000);
+  return { start, end, days: safeDays };
+}
+
+async function fetchConversionReport(ctx, {
+  days = 90,
+  pageSize = 100,
+  maxPages = 200,
+  delayMs = 750,
+  timeoutMs = 60000,
+  log = null,
+} = {}) {
+  let page = findAffiliatePage(ctx.pages());
+  let opened = false;
+  if (!page) {
+    page = await ctx.newPage();
+    opened = true;
+  }
+
+  try {
+    if (!page.url().includes('/report/conversion_report')) {
+      await page.goto('https://affiliate.shopee.vn/report/conversion_report', {
+        waitUntil: 'domcontentloaded', timeout: timeoutMs,
+      }).catch(() => {});
+      await sleep(1500);
+    }
+    if (isBlockedState(page.url(), null)) {
+      return { status: 'needs_verify', rows: [], reason: 'session at captcha/login — re-verify via VNC' };
+    }
+
+    const window = reportWindow(days);
+    const rows = [];
+    let total = null;
+    let lastReportDate = null;
+    let lastUpdateTime = null;
+
+    const updated = await page.evaluate(async () => {
+      try {
+        const r = await fetch('/api/v3/gql?q=conversionReportUpdateTime', {
+          method: 'POST', credentials: 'include',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            operationName: 'conversionReportUpdateTime',
+            query: 'query conversionReportUpdateTime { conversionReportUpdateTime { lastReportDate lastUpdateTime } }',
+            variables: {},
+          }),
+        });
+        return await r.json().catch(() => null);
+      } catch { return null; }
+    });
+    lastReportDate = updated?.data?.conversionReportUpdateTime?.lastReportDate || null;
+    lastUpdateTime = updated?.data?.conversionReportUpdateTime?.lastUpdateTime || null;
+
+    for (let pageNum = 1; pageNum <= maxPages; pageNum++) {
+      const result = await page.evaluate(async (q) => {
+        const url = `/api/v3/report/list?page_size=${q.pageSize}&page_num=${q.pageNum}`
+          + `&purchase_time_s=${q.start}&purchase_time_e=${q.end}&version=1`;
+        try {
+          const r = await fetch(url, { credentials: 'include' });
+          return { status: r.status, json: await r.json().catch(() => null) };
+        } catch (e) {
+          return { status: 0, error: String(e?.message || e) };
+        }
+      }, { pageSize, pageNum, start: window.start, end: window.end });
+
+      if (isBlockedState(page.url(), result) || result.json?.code === 90309999) {
+        return { status: 'needs_verify', rows, reason: `blocked while reading report (http ${result.status}, code ${result.json?.code})` };
+      }
+      if (result.status !== 200 || result.json?.code !== 0) {
+        return { status: 'failed', rows, reason: result.json?.msg || result.error || `report HTTP ${result.status}` };
+      }
+
+      const data = result.json?.data || {};
+      const batch = Array.isArray(data.list) ? data.list : [];
+      total = Number(data.total_count || 0);
+      rows.push(...batch);
+      if (log) log(`[shopee-report] trang ${pageNum}: ${batch.length} dòng (${rows.length}/${total})`);
+      if (!batch.length || rows.length >= total || batch.length < pageSize) break;
+      await sleep(delayMs);
+    }
+
+    if (total != null && rows.length < total) {
+      return { status: 'failed', rows, reason: `report pagination stopped at ${rows.length}/${total} rows` };
+    }
+
+    return {
+      status: 'ok', rows, total: total ?? rows.length,
+      from: new Date(window.start * 1000).toISOString(),
+      to: new Date(window.end * 1000).toISOString(),
+      last_report_date: lastReportDate,
+      last_update_time: lastUpdateTime,
+    };
+  } finally {
+    if (opened) await page.close().catch(() => {});
+  }
+}
+
+module.exports = { fetchConversionReport, reportWindow };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "channel-worker",
-  "version": "2.5.113",
+  "version": "2.5.118",
   "description": "Channel Manager worker daemon — runs on remote machines to execute video pipeline jobs",
   "main": "lib/daemon.js",
   "bin": {

package/scripts/lib/fb-guard.js

@@ -21,6 +21,8 @@ const CODES = {
   banned: 'FB_ACCOUNT_BANNED',
 };
 
+const PAGE_NOT_CONFIGURED_CODE = 'FB_PAGE_NOT_CONFIGURED';
+
 const PUBLISH_BLOCK_PHRASES = [
   'giới hạn tần suất',
   'để bảo vệ cộng đồng khỏi spam',
@@ -108,6 +110,81 @@ async function assertAccountUsable(page, log) {
   throw err;
 }
 
+// Is this NST session browsing Facebook as the person or as a Page?
+//
+// This is shared by nurture and publish. Publishing through a personal profile
+// is a configuration error for this product: every channel is expected to own
+// a Facebook Page. Without this guard, the personal "Tạo bài viết" widget
+// (Video trực tiếp / Ảnh-video / Cảm xúc-hoạt động) falls through to
+// /reels/create/. Facebook can still open a PERSONAL Reel composer there, so
+// the upload fails later with a completely misleading "composer closed" error.
+function classifyProfileModeSignals(signals = {}) {
+  // Personal-composer evidence wins over the navigation shortcuts. Facebook's
+  // Professional mode gives a PERSON `professional_dashboard` too; that exact
+  // combination made "thời trang 03" persist `profile_mode: page` even though
+  // its composer still showed "Cảm xúc/hoạt động" and no Reel control.
+  if (signals.hasFriends || (signals.hasFeelingActivity && !signals.hasReelControl)) return 'personal';
+  const clearPage = (signals.proLink || signals.proText) && !signals.hasFriends;
+  if (clearPage) return 'page';
+  return 'unknown';
+}
+
+async function readProfileMode(page) {
+  const signals = await page.evaluate(() => {
+    const navs = [...document.querySelectorAll("[role='navigation']")];
+    const navText = navs.map((n) => n.innerText || '').join(' | ');
+    const hrefs = navs.flatMap((n) => [...n.querySelectorAll('a[href]')].map((a) => a.getAttribute('href') || ''));
+    const proLink = hrefs.some((h) => /professional_dashboard|adsmanager|ad_center|ads\/manage|business\.facebook/i.test(h));
+    const proText = /Công cụ chuyên nghiệp|Professional dashboard|Trung tâm quảng cáo|Ad Center|Trình quản lý quảng cáo|Ads Manager/i.test(navText);
+    const hasFriends = /\bBạn bè\b|\bFriends\b/i.test(navText);
+
+    let hasFeelingActivity = false;
+    let hasReelControl = false;
+    for (const region of document.querySelectorAll("[role='region'], [aria-label='Tạo bài viết'], [aria-label='Create post'], [aria-label='Create a post']")) {
+      const aria = (region.getAttribute('aria-label') || '').trim();
+      if (!/tạo bài viết|create (?:a )?post/i.test(aria)) continue;
+      for (const el of region.querySelectorAll("[role='button'], button, a")) {
+        const label = `${el.innerText || el.textContent || ''}\n${el.getAttribute('aria-label') || ''}`.trim();
+        if (/Cảm xúc\s*\/\s*hoạt động|Feeling\s*\/\s*activity|Feeling or activity/i.test(label)) hasFeelingActivity = true;
+        if (/^\s*(?:Thước phim|Reels?|Create (?:a )?reel|Tạo thước phim)\s*$/im.test(label)) hasReelControl = true;
+      }
+    }
+
+    let timelineLabel = '';
+    for (const el of document.querySelectorAll("a[aria-label]")) {
+      const label = (el.getAttribute('aria-label') || '').trim();
+      if (/^Dòng thời gian của\s+|(?:'s|’s) Timeline$/i.test(label)) {
+        timelineLabel = label.slice(0, 120);
+        break;
+      }
+    }
+    return {
+      proLink, proText, hasFriends, hasFeelingActivity, hasReelControl, timelineLabel,
+      navSample: navText.replace(/\s+/g, ' ').slice(0, 140),
+    };
+  }).catch(() => null);
+
+  if (!signals) return { mode: 'unknown', isPage: false, why: 'detect failed', navSample: '', timelineLabel: '' };
+  const mode = classifyProfileModeSignals(signals);
+  return {
+    mode,
+    isPage: mode === 'page',
+    why: `mode=${mode} proLink=${signals.proLink} proText=${signals.proText} friends=${signals.hasFriends} feeling=${signals.hasFeelingActivity} reel=${signals.hasReelControl}`,
+    navSample: signals.navSample || '',
+    timelineLabel: signals.timelineLabel || '',
+  };
+}
+
+function pageNotConfiguredError(profileMode = {}) {
+  const who = profileMode.timelineLabel ? ` (${profileMode.timelineLabel})` : '';
+  const err = new Error(
+    `${PAGE_NOT_CONFIGURED_CODE}: Kênh chưa cấu hình Facebook Page — NST profile đang dùng Facebook dưới dạng trang cá nhân${who}. `
+    + 'Hãy tạo Page, chuyển profile sang Page đó rồi đăng lại.',
+  );
+  err.code = PAGE_NOT_CONFIGURED_CODE;
+  return err;
+}
+
 async function readPublishBlock(page) {
   return page.evaluate((phrases) => {
     const text = (document.body?.innerText || '').toLowerCase();
@@ -120,5 +197,13 @@ function publishRateLimitError(blockHit) {
 }
 
 module.exports = {
-  readAccountState, assertAccountUsable, readPublishBlock, publishRateLimitError, CODES,
+  readAccountState,
+  assertAccountUsable,
+  readProfileMode,
+  classifyProfileModeSignals,
+  pageNotConfiguredError,
+  readPublishBlock,
+  publishRateLimitError,
+  CODES,
+  PAGE_NOT_CONFIGURED_CODE,
 };

package/scripts/nurture_facebook.js

@@ -19,7 +19,7 @@
 // A dead session (logged out / checkpoint / disabled) throws a CODED error via
 // lib/fb-guard so the API can stop the schedule and raise a notification.
 
-const { assertAccountUsable } = require('./lib/fb-guard');
+const { assertAccountUsable, readProfileMode } = require('./lib/fb-guard');
 const { pick, clickHandle } = require('./lib/dom-pick');
 const { humanMove, humanWheel, humanClick } = require('./lib/human');
 
@@ -435,32 +435,6 @@ async function sideTrip(page, log) {
   return true;
 }
 
-// Is this profile browsing AS A PAGE rather than as the person?
-//
-// Why it matters: a Page's feed contains only the Page's own posts, so there is
-// nothing to nurture — measured live: 1 post, feed bottoms out after ~1500px.
-// And a profile already switched into a Page has, by definition, got its Page —
-// which is the whole goal of nurturing. So this ends the session immediately and
-// takes the channel off the schedule.
-//
-// Signal: the left nav carries Page-only entries (Công cụ chuyên nghiệp / Trung
-// tâm quảng cáo / Ads Manager) and lacks the personal "Bạn bè" entry.
-async function detectProfileMode(page) {
-  return page.evaluate(() => {
-    const navs = [...document.querySelectorAll("[role='navigation']")];
-    const navText = navs.map((n) => n.innerText || '').join(' | ');
-    const hrefs = navs.flatMap((n) => [...n.querySelectorAll('a[href]')].map((a) => a.getAttribute('href') || ''));
-    const proLink = hrefs.some((h) => /professional_dashboard|adsmanager|ad_center|ads\/manage|business\.facebook/i.test(h));
-    const proText = /Công cụ chuyên nghiệp|Professional dashboard|Trung tâm quảng cáo|Ad Center|Trình quản lý quảng cáo|Ads Manager/i.test(navText);
-    const hasFriends = /\bBạn bè\b|\bFriends\b/i.test(navText);
-    return {
-      isPage: (proLink || proText) && !hasFriends,
-      why: `proLink=${proLink} proText=${proText} friends=${hasFriends}`,
-      navSample: navText.replace(/\s+/g, ' ').slice(0, 140),
-    };
-  }).catch(() => ({ isPage: false, why: 'detect failed', navSample: '' }));
-}
-
 // ONE tab, always.
 //
 // Two things pile tabs up behind a session, and neither is ours: NSTBrowser
@@ -568,7 +542,7 @@ async function run({ page, context, payload, log }) {
   await dismissDialogs(page, log);
 
   // Already a Page? Then the goal is met — stop here, don't fake a session.
-  const mode = await detectProfileMode(page);
+  const mode = await readProfileMode(page);
   if (payload.debug) log('info', `[nurture-fb][dbg] mode ${mode.why} nav="${mode.navSample}"`);
   if (mode.isPage) {
     log('info', '[nurture-fb] profile đang dùng dưới dạng TRANG (đã có Page) — bỏ qua, không cần nuôi nữa');

package/scripts/upload_facebook.js

@@ -17,7 +17,13 @@
 
 const fs = require('fs');
 const { humanMove, humanClick, humanType, humanWheel, pause, randInt: hRandInt, chance: hChance } = require('./lib/human');
-const { assertAccountUsable, readPublishBlock, publishRateLimitError } = require('./lib/fb-guard');
+const {
+  assertAccountUsable,
+  readProfileMode,
+  pageNotConfiguredError,
+  readPublishBlock,
+  publishRateLimitError,
+} = require('./lib/fb-guard');
 const path = require('path');
 const { downloadToTemp, safeUnlink } = require('./lib/download');
 
@@ -997,6 +1003,43 @@ async function hasVisibleReelComposer(page) {
   }).catch(() => false);
 }
 
+// Dựng câu báo lỗi cho ca "đi thẳng /reels/create/ rồi bị Facebook đá về feed".
+//
+// Trước 17/09/2026 chỗ này là MỘT chuỗi cứng luôn khẳng định `widget "Tạo bài
+// viết" không có mục Thước phim … tài khoản có thể chưa đủ điều kiện đăng
+// Reels`. Câu đó ĐỔ OAN trong ít nhất hai ca thật cùng ngày:
+//   • "Làm Giàu Từ Chăn Nuôi": log ngay trên nó ghi `page.goto: Timeout
+//     45000ms` rồi `KHÔNG thấy widget … các region đang có: []` — trang chưa
+//     tải xong chứ tài khoản không sao (chủ tịch xác nhận vẫn đăng nhập bình
+//     thường). Chạy lại là được.
+//   • profile "Aly L": widget CÓ, nhưng là tường CÁ NHÂN chứ không phải Page.
+// Người vận hành chỉ đọc câu này trên web, không mở log worker — nên câu lỗi
+// phải tự nói đúng tên bệnh và đúng việc cần làm.
+function describeReelCreateBounce(wallDiag, afterUrl) {
+  const tail = `/reels/create/ bị Facebook đá về feed (${afterUrl}). Đây KHÔNG phải lỗi selector.`;
+
+  // Không dò được tường (page.evaluate ném) → đừng đoán bừa bệnh nào.
+  if (!wallDiag) {
+    return `FB không mở được trình tạo Thước phim: không đọc được tường trang, và ${tail} Cần xem log worker dòng "[fb-pw]" ngay trước lỗi này để biết nguyên nhân.`;
+  }
+
+  // (1) Không có region nào = trang chưa render. Gần như luôn là trang tải
+  //     hỏng/timeout, KHÔNG phải chuyện quyền Reels hay đăng nhập.
+  if (!wallDiag.regionSeen) {
+    return `FB không mở được trình tạo Thước phim: TRANG CHƯA TẢI XONG — không có một vùng nội dung nào trên trang chủ (regions=${JSON.stringify(wallDiag.allRegions)}), và ${tail} Thường do mạng/proxy chậm hoặc page.goto timeout; KHÔNG phải tài khoản thiếu quyền đăng Reels. Cách xử: chạy lại lượt đăng; nếu lặp lại nhiều lần thì kiểm proxy của profile này.`;
+  }
+
+  // (2) Tường CÁ NHÂN: composer cá nhân vốn không có mục Thước phim. Chạy lại
+  //     bao nhiêu lần cũng vô ích.
+  if (wallDiag.personalWall) {
+    return `FB không mở được trình tạo Thước phim: profile này đang đăng nhập TÀI KHOẢN CÁ NHÂN chứ không phải Page (nút đang có: ${JSON.stringify(wallDiag.inventory)}), và ${tail} Composer cá nhân không có mục Thước phim — chạy lại vô ích. Cách xử: đăng nhập lại profile và chuyển sang đúng Page.`;
+  }
+
+  // (3) Tường Page thật mà vẫn thiếu mục Thước phim → mới đúng là nghi vấn
+  //     quyền đăng Reels của Page.
+  return `FB không mở được trình tạo Thước phim: widget "Tạo bài viết" CÓ nhưng thiếu mục Thước phim (nút đang có: ${JSON.stringify(wallDiag.inventory)}), và ${tail} Cách xử: cần người đăng nhập profile này và thử tạo Thước phim bằng tay — Page có thể chưa đủ điều kiện đăng Reels.`;
+}
+
 async function runOnce({ page, payload, log }) {
   const {
     video_url, title, description = '', tags = [],
@@ -1086,6 +1129,16 @@ async function runOnce({ page, payload, log }) {
     // code and opens the Facebook auto-publish circuit breaker.
     await assertAccountUsable(page, log);
 
+    // This uploader publishes to a Facebook PAGE. A personal account can also
+    // open /reels/create/, which used to let an unconfigured channel get deep
+    // into the wizard and finally surface as the unrelated "composer closed"
+    // retry error. Stop before touching the video and tell the operator what is
+    // actually missing. Unknown layouts continue to the existing DOM probes so
+    // a Facebook A/B change does not falsely block a valid Page.
+    const profileMode = await readProfileMode(page);
+    log('info', `[fb-pw] Facebook identity check: ${profileMode.why}${profileMode.timelineLabel ? ` timeline="${profileMode.timelineLabel}"` : ''}`);
+    if (profileMode.mode === 'personal') throw pageNotConfiguredError(profileMode);
+
     // Look around before posting. The old flow was goto → 4s → straight into
     // "Thước phim", every single run: a session whose only actions are
     // open→post→leave. A person glances at the wall first. 2-5 wheel bursts
@@ -1152,6 +1205,13 @@ async function runOnce({ page, payload, log }) {
         break;
       } catch {}
     }
+    // Chẩn đoán của lượt dò tường, giữ lại để câu BÁO LỖI cuối cùng nói đúng
+    // bệnh. Trước 17/09 câu lỗi là một chuỗi CỨNG luôn khẳng định "có widget
+    // mà thiếu mục Thước phim", kể cả khi log ngay trên nó vừa ghi "KHÔNG thấy
+    // widget nào" — người đọc bị đẩy đi kiểm quyền đăng Reels trong khi bệnh
+    // thật là trang chưa tải xong (ca "Làm Giàu Từ Chăn Nuôi" 17/09:
+    // `page.goto: Timeout 45000ms` ngay trước đó, regions = []).
+    let wallDiag = null;
     // Fallback — walk the "Tạo bài viết" region in JS, find a button whose
     // text/aria starts with "Thước phim"/"Reel" but is NOT in the sidebar.
     if (!reelOpened) {
@@ -1194,6 +1254,17 @@ async function runOnce({ page, payload, log }) {
         } else {
           log('warn', `[fb-pw] có widget "Tạo bài viết" nhưng KHÔNG có mục Thước phim — nút đang có: ${JSON.stringify(probed.inventory)}`);
         }
+        wallDiag = {
+          regionSeen: probed.regionSeen,
+          inventory: probed.inventory || [],
+          allRegions: probed.allRegions || [],
+          // Composer của TRANG CÁ NHÂN không bao giờ có mục Thước phim — nhận
+          // ra bằng hai nhãn đặc trưng, không phải bằng việc thiếu nút Reel.
+          // Ca thật 17/09: profile "Aly L" đăng nhập tài khoản cá nhân thay vì
+          // Page → al="Dòng thời gian của Aly L", t="Aly ơi, bạn đang nghĩ gì".
+          personalWall: (probed.inventory || []).some(s =>
+            /Dòng thời gian của |ơi, bạn đang nghĩ gì|'s timeline|What's on your mind/i.test(s)),
+        };
       }
       if (probed && probed.selector) {
         try {
@@ -1236,7 +1307,12 @@ async function runOnce({ page, payload, log }) {
       //      Thước phim. Sửa selector bao nhiêu cũng vô ích.
       await dumpFailure(page, 'reel-create-bounced', log).catch(() => {});
       if (usedCreateRoute) {
-        throw new Error(`FB không mở được trình tạo Thước phim cho tài khoản này: widget "Tạo bài viết" không có mục Thước phim, và /reels/create/ bị Facebook đá về feed (${afterUrl}). Đây KHÔNG phải lỗi selector — cần người đăng nhập profile này và thử tạo Thước phim bằng tay (tài khoản có thể chưa đủ điều kiện đăng Reels, hoặc đang đăng nhập sai trang).`);
+        // BA bệnh khác hẳn nhau, trước 17/09 gộp chung MỘT câu cứng luôn phán
+        // "widget có mà thiếu mục Thước phim" → đổ oan tài khoản, người đọc đi
+        // kiểm quyền đăng Reels trong khi bệnh thật nằm chỗ khác. Nói đúng tên
+        // bệnh ngay trong câu lỗi, vì người vận hành chỉ nhìn thấy câu này trên
+        // web chứ không mở log worker ra đọc.
+        throw new Error(describeReelCreateBounce(wallDiag, afterUrl));
       }
       throw new Error(`FB Thước phim click navigated to Reels feed (${afterUrl}) — wrong button matched, should be composer modal. Check "Tạo bài viết" widget layout on this Page.`);
     }
@@ -3405,7 +3481,7 @@ async function run(args) {
     } catch (e) {
       // A checkpoint/logout can appear mid-composer. Prefer the coded account
       // error over the selector symptom so the server stops unattended retries.
-      if (!/^FB_(?:ACCOUNT|PUBLISH)_/.test(String(e?.message || ''))) {
+      if (!/^FB_(?:ACCOUNT|PUBLISH|PAGE)_/.test(String(e?.message || ''))) {
         try { await assertAccountUsable(page, log); } catch (accountErr) { throw accountErr; }
       }
       const safeRetry = e?.code === SAFE_RETRY_COMPOSER_CLOSED;
@@ -3448,6 +3524,7 @@ module.exports.__testables = {
   waitForPublishEnabled,
   isThumbnailEditorVisible,
   hasVisibleReelComposer,
+  describeReelCreateBounce,
   SAFE_RETRY_COMPOSER_CLOSED,
   navigateFacebookHome,
   navigateFacebookReelCreate,

package/scripts/upload_facebook_photo.js

@@ -1,7 +1,7 @@
-// upload_facebook_photo — publish an IMAGE (photo) post to a Facebook Page via
+// upload_facebook_photo / upload_facebook_post — publish an IMAGE or TEXT post to a Facebook Page via
 // the "Tạo bài viết" composer (NOT the Reels composer). Driven by the worker
 // daemon's Playwright pipeline; command type upload_facebook_photo_pw →
-// scripts/upload_facebook_photo.js. Payload: { image_url, caption, tags[] }.
+// scripts/upload_facebook_photo.js. Payload: { image_url?, caption, tags[] }.
 //
 // Strict-input contract (same as upload_facebook.js): every step throws on
 // failure so the cmd is marked failed — no silent false-success. In particular
@@ -111,8 +111,8 @@ function composerStillOpen(page, verbs) {
 
 async function run({ page, payload, log }) {
   const { image_url, caption = '', tags = [] } = payload || {};
-  if (!image_url) throw new Error('No image_url provided');
   if (!caption || !caption.trim()) throw new Error('No caption provided');
+  const hasImage = !!String(image_url || '').trim();
 
   log('info', '[fbphoto] selectors version=2026.07.01a');
   page.on('dialog', (d) => { d.accept().catch(() => {}); });
@@ -137,13 +137,15 @@ async function run({ page, payload, log }) {
     .map((t) => `#${t}`).join(' ');
   const fullCaption = hashtagLine ? `${caption.trim()}\n\n${hashtagLine}` : caption.trim();
 
-  log('info', '[fbphoto] downloading image to local…');
-  const imagePath = await downloadToTemp(image_url, { prefix: 'fbphoto', ext: '.png' });
-  log('info', `[fbphoto] image at ${imagePath}`);
-
+  let imagePath = '';
   const publishVerbs = ['Đăng', 'Đăng bài', 'Post', 'Publish'];
 
   try {
+    if (hasImage) {
+      log('info', '[fbphoto] downloading image to local…');
+      imagePath = await downloadToTemp(image_url, { prefix: 'fbphoto', ext: '.png' });
+      log('info', `[fbphoto] image at ${imagePath}`);
+    }
     // 1) Open the Page wall.
     log('info', '[fbphoto] navigating to facebook.com…');
     await page.goto('https://www.facebook.com/', { waitUntil: 'domcontentloaded', timeout: 60_000 });
@@ -154,8 +156,8 @@ async function run({ page, payload, log }) {
     // 2) Open the "Tạo bài viết" composer via the "Ảnh/video" entry (this opens
     //    the post composer directly in photo-attach mode). Fall back to the
     //    status box ("Bạn đang nghĩ gì") if the photo entry isn't found.
-    const openPhotoComposer = async () => {
-      const photoBtn = await page.evaluate(() => {
+    const openComposer = async () => {
+      const photoBtn = hasImage ? await page.evaluate(() => {
         const els = document.querySelectorAll("div[role='button'], span, a[role='button']");
         for (const el of els) {
           const t = (el.innerText || '').trim();
@@ -167,7 +169,7 @@ async function run({ page, payload, log }) {
           }
         }
         return false;
-      }).catch(() => false);
+      }).catch(() => false) : false;
       if (photoBtn) {
         await page.locator("[__fbphoto_open__='1']").click({ timeout: 4000 }).catch(() => {});
         await page.evaluate(() => document.querySelectorAll('[__fbphoto_open__]').forEach((e) => e.removeAttribute('__fbphoto_open__'))).catch(() => {});
@@ -178,16 +180,16 @@ async function run({ page, payload, log }) {
       if (box) { await box.click({ timeout: 4000 }).catch(() => {}); await pause(page, 1500); return true; }
       return false;
     };
-    if (!(await openPhotoComposer())) {
+    if (!(await openComposer())) {
       await dumpFailure(page, 'no-composer-entry', log);
-      throw new Error('FB: không tìm thấy nút "Ảnh/video" / ô "Tạo bài viết" trên trang. Kiểm tra layout Page.');
+      throw new Error('FB: không tìm thấy ô "Tạo bài viết" trên trang. Kiểm tra layout Page.');
     }
     await pause(page, 2500);
 
     // 3) Ensure the composer modal is open; click its "Ảnh/video" if the file
     //    input isn't ready yet.
-    let fileInput = await page.$("input[type='file'][accept*='image']");
-    if (!fileInput) {
+    let fileInput = hasImage ? await page.$("input[type='file'][accept*='image']") : null;
+    if (hasImage && !fileInput) {
       const inModalPhoto = await page.evaluate(() => {
         const dlg = document.querySelector("[role='dialog']");
         if (!dlg) return false;
@@ -208,16 +210,18 @@ async function run({ page, payload, log }) {
         if (!fileInput) await pause(page, 1000);
       }
     }
-    if (!fileInput) {
+    if (hasImage && !fileInput) {
       await dumpFailure(page, 'no-file-input', log);
       throw new Error('FB: không tìm thấy ô upload ảnh trong composer.');
     }
 
     // 4) Attach the image.
-    log('info', '[fbphoto] attaching image…');
-    await setImageFile(page, fileInput, imagePath, log);
-    // Wait for the image preview to render inside the composer.
-    await pause(page, 4000);
+    if (hasImage) {
+      log('info', '[fbphoto] attaching image…');
+      await setImageFile(page, fileInput, imagePath, log);
+      // Wait for the image preview to render inside the composer.
+      await pause(page, 4000);
+    }
 
     // 5) Fill caption into the composer's contenteditable textbox.
     log('info', '[fbphoto] filling caption…');
@@ -323,7 +327,7 @@ async function run({ page, payload, log }) {
     }
     if (await composerStillOpen(page, publishVerbs)) {
       await dumpFailure(page, 'composer-stuck-open', log);
-      throw new Error('FB đăng ảnh KHÔNG commit — composer vẫn mở sau 3 lần thử (bài CHƯA được đăng).');
+      throw new Error('FB đăng bài KHÔNG commit — composer vẫn mở sau 3 lần thử (bài CHƯA được đăng).');
     }
 
     // 8) Best-effort post URL.

package/scripts/upload_facebook_post.js

@@ -0,0 +1,4 @@
+// Standalone Page posts share the proven Facebook composer implementation with
+// idea-derived photo posts. The shared runner treats image_url as optional, so
+// an empty image_url publishes a text-only post.
+module.exports = require('./upload_facebook_photo');