@jackwener/opencli 1.7.22 → 1.8.0

package/clis/xiaohongshu/creator-stats.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it, vi } from 'vitest';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './creator-stats.js';
+
+describe('xiaohongshu creator-stats', () => {
+    it('throws EmptyResultError when the requested stats period has no data', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-stats');
+        const page = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({
+                data: {
+                    seven: null,
+                    thirty: {
+                        view_count: 1,
+                        view_list: [{ count: 1 }],
+                    },
+                },
+            }),
+        };
+
+        await expect(cmd.func(page, { period: 'seven' })).rejects.toBeInstanceOf(EmptyResultError);
+    });
+});

package/clis/xiaohongshu/delete-note.js

@@ -0,0 +1,260 @@
+/**
+ * Xiaohongshu delete-note: remove a published note via creator center UI.
+ *
+ * Flow:
+ *   1. Navigate to creator note-manager
+ *   2. Switch to "已发布" tab (delete is only available on published notes;
+ *      "审核中" and "未通过" rows do not expose a web delete entry, only mobile)
+ *   3. Locate the row whose `data-impression` JSON contains the target noteId
+ *   4. Click the inline `<span class="control data-del">` action
+ *   5. Click "确定" in the `.d-modal-footer` confirmation modal
+ *   6. Poll for the row disappearing from the list
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, AuthRequiredError, CliError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+const NOTE_MANAGER_URL = 'https://creator.xiaohongshu.com/new/note-manager';
+const ROW_SETTLE_MS = 3000;
+const MODAL_SETTLE_MS = 2000;
+const VERIFY_TIMEOUT_MS = 10_000;
+const VERIFY_POLL_MS = 1000;
+const NOTE_ID_RE = /^[0-9a-f]{24}$/i;
+function unwrapEvaluateResult(payload) {
+    if (payload && typeof payload === 'object' && 'session' in payload && 'data' in payload) {
+        return payload.data;
+    }
+    return payload;
+}
+function requireEvaluateString(payload, context) {
+    if (typeof payload !== 'string') {
+        throw new CommandExecutionError(`xiaohongshu/delete-note: malformed ${context} payload`);
+    }
+    return payload;
+}
+function requireEvaluateBoolean(payload, context) {
+    if (typeof payload !== 'boolean') {
+        throw new CommandExecutionError(`xiaohongshu/delete-note: malformed ${context} payload`);
+    }
+    return payload;
+}
+function requireEvaluateObject(payload, context) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+        throw new CommandExecutionError(`xiaohongshu/delete-note: malformed ${context} payload`);
+    }
+    return payload;
+}
+function requireActionResult(payload, context) {
+    const result = requireEvaluateObject(payload, context);
+    if (typeof result.ok !== 'boolean') {
+        throw new CommandExecutionError(`xiaohongshu/delete-note: malformed ${context} payload`);
+    }
+    return result;
+}
+function isXiaohongshuHost(hostname) {
+    const host = String(hostname || '').toLowerCase();
+    return host === 'xiaohongshu.com' || host.endsWith('.xiaohongshu.com');
+}
+function isSupportedQueryNoteUrl(url) {
+    return url.hostname.toLowerCase() === 'creator.xiaohongshu.com'
+        && url.pathname.replace(/\/+$/, '') === '/statistics/note-detail';
+}
+function normalizeNoteId(input) {
+    const raw = String(input ?? '').trim();
+    if (!raw) {
+        throw new ArgumentError('xiaohongshu/delete-note: note-id cannot be empty');
+    }
+    if (NOTE_ID_RE.test(raw))
+        return raw.toLowerCase();
+    if (!/^https:\/\//i.test(raw)) {
+        throw new ArgumentError('xiaohongshu/delete-note: note-id must be a 24-character Xiaohongshu note ID or an exact Xiaohongshu note URL');
+    }
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new ArgumentError('xiaohongshu/delete-note: invalid note URL');
+    }
+    if (url.protocol !== 'https:' || url.username || url.password || url.port || !isXiaohongshuHost(url.hostname)) {
+        throw new ArgumentError('xiaohongshu/delete-note: note URL must be an exact https://*.xiaohongshu.com URL');
+    }
+    const queryId = url.searchParams.get('noteId') || url.searchParams.get('note_id');
+    if (queryId && NOTE_ID_RE.test(queryId) && isSupportedQueryNoteUrl(url))
+        return queryId.toLowerCase();
+    const pathMatch = url.pathname.match(/^\/(?:explore|note|search_result|discovery\/item)\/([0-9a-f]{24})\/?$/i)
+        || url.pathname.match(/^\/user\/profile\/[^/?#]+\/([0-9a-f]{24})\/?$/i);
+    if (pathMatch)
+        return pathMatch[1].toLowerCase();
+    throw new ArgumentError('xiaohongshu/delete-note: note URL must contain a 24-character note ID');
+}
+function buildLocateAndMaybeDeleteScript(noteId, shouldClick) {
+    return `
+      (cfg => {
+        const { targetId, shouldClick } = cfg;
+        const isVisible = (el) => !!el && el.offsetParent !== null;
+        const matchesNoteId = (impressionRaw) => {
+          if (!impressionRaw) return false;
+          try {
+            const parsed = JSON.parse(impressionRaw);
+            const id = parsed && parsed.noteTarget && parsed.noteTarget.value && parsed.noteTarget.value.noteId;
+            return typeof id === 'string' && id === targetId;
+          } catch {
+            return false;
+          }
+        };
+        const notes = Array.from(document.querySelectorAll('.note')).filter(isVisible);
+        for (const note of notes) {
+          if (matchesNoteId(note.getAttribute('data-impression'))) {
+            const del = note.querySelector('span.control.data-del');
+            if (!del || !isVisible(del)) {
+              return { ok: false, kind: 'no_delete_action', visibleRows: notes.length };
+            }
+            if (!shouldClick) {
+              return { ok: true, clicked: false };
+            }
+            del.click();
+            return { ok: true, clicked: true };
+          }
+        }
+        return { ok: false, kind: 'not_found', visibleRows: notes.length };
+      })(${JSON.stringify({ targetId: noteId, shouldClick })})
+    `;
+}
+function buildVerifyGoneScript(noteId) {
+    return `
+        (targetId => {
+          const matchesNoteId = (impressionRaw) => {
+            if (!impressionRaw) return false;
+            try {
+              const parsed = JSON.parse(impressionRaw);
+              const id = parsed && parsed.noteTarget && parsed.noteTarget.value && parsed.noteTarget.value.noteId;
+              return typeof id === 'string' && id === targetId;
+            } catch {
+              return false;
+            }
+          };
+          const notes = Array.from(document.querySelectorAll('.note'));
+          return notes.some((n) => matchesNoteId(n.getAttribute('data-impression')));
+        })(${JSON.stringify(noteId)})
+      `;
+}
+cli({
+    site: 'xiaohongshu',
+    name: 'delete-note',
+    access: 'write',
+    description: '删除小红书已发布笔记 (creator center UI automation)',
+    domain: 'creator.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    browser: true,
+    args: [
+        {
+            name: 'note-id',
+            required: true,
+            positional: true,
+            help: 'Note ID (e.g. 6a08ba0b000000000702a893 from xiaohongshu creator-notes / URL)',
+        },
+        {
+            name: 'execute',
+            type: 'boolean',
+            default: false,
+            help: 'Actually click delete + confirm. Default is dry-run target verification only.',
+        },
+    ],
+    columns: ['status', 'note_id', 'message'],
+    func: async (page, kwargs) => {
+        try {
+            const noteId = normalizeNoteId(kwargs['note-id']);
+            const execute = kwargs.execute === true;
+            await page.goto(NOTE_MANAGER_URL);
+            await page.wait({ time: ROW_SETTLE_MS / 1000 });
+            // Detect login redirect (creator.xiaohongshu.com bounces to /login on auth failure)
+            const currentUrl = requireEvaluateString(unwrapEvaluateResult(await page.evaluate('() => location.href')), 'current-url');
+            if (typeof currentUrl === 'string' && /\/login(?:[/?#]|$)/i.test(new URL(currentUrl).pathname + new URL(currentUrl).search)) {
+                throw new AuthRequiredError('creator.xiaohongshu.com');
+            }
+            // Step 1: ensure 已发布 tab is active (delete only exposed there).
+            const tabClicked = requireEvaluateBoolean(unwrapEvaluateResult(await page.evaluate(`
+      () => {
+        const isVisible = (el) => !!el && el.offsetParent !== null;
+        for (const el of document.querySelectorAll('a, button, [role="tab"], div')) {
+          const text = (el.innerText || el.textContent || '').trim();
+          if (text === '已发布' && isVisible(el)) {
+            el.click();
+            return true;
+          }
+        }
+        return false;
+      }
+    `)), 'published-tab');
+            if (!tabClicked) {
+                throw new CommandExecutionError('xiaohongshu/delete-note: 已发布 tab not found on note-manager; xhs creator UI may have changed.');
+            }
+            await page.wait({ time: ROW_SETTLE_MS / 1000 });
+            // Step 2: locate the .note row whose data-impression JSON carries the
+            // exact `noteId` field. Dry-run stops here; execute clicks delete.
+            // Substring matching on the raw attribute would risk matching unrelated
+            // fields whose values happen to share the noteId prefix, so parse the JSON
+            // and compare `noteTarget.value.noteId` explicitly.
+            const initResult = requireActionResult(unwrapEvaluateResult(await page.evaluate(buildLocateAndMaybeDeleteScript(noteId, execute))), 'locate-note');
+            if (!initResult?.ok) {
+                if (initResult?.kind === 'not_found') {
+                    throw new EmptyResultError('xiaohongshu/delete-note', `Note ${noteId} not visible in the 已发布 tab. Verify the note belongs to the logged-in account and has cleared review (审核中 / 未通过 rows have no web delete entry).`);
+                }
+                if (initResult?.kind === 'no_delete_action') {
+                    throw new CommandExecutionError(`xiaohongshu/delete-note: note ${noteId} row found but no delete action visible; xhs creator UI may have changed.`);
+                }
+                throw new CommandExecutionError('xiaohongshu/delete-note: failed to locate note row');
+            }
+            if (!execute) {
+                return [{ status: 'dry-run', note_id: noteId, message: 'Target note row and delete action verified. Re-run with --execute to delete.' }];
+            }
+            await page.wait({ time: MODAL_SETTLE_MS / 1000 });
+            // Step 3: click "确定" in the `.d-modal-footer` confirmation modal.
+            const confirmResult = requireActionResult(unwrapEvaluateResult(await page.evaluate(`
+      () => {
+        const isVisible = (el) => !!el && el.offsetParent !== null;
+        const footer = Array.from(document.querySelectorAll('.d-modal-footer')).find(isVisible);
+        if (!footer) return { ok: false, kind: 'no_modal' };
+        const buttons = Array.from(footer.querySelectorAll('button, [role="button"]')).filter(isVisible);
+        const confirmBtn = buttons.find((b) => (b.innerText || b.textContent || '').trim() === '确定');
+        if (!confirmBtn) return { ok: false, kind: 'no_confirm', labels: buttons.map(b => (b.innerText || '').trim()) };
+        confirmBtn.click();
+        return { ok: true };
+      }
+    `)), 'confirm-modal');
+            if (!confirmResult?.ok) {
+                throw new CommandExecutionError(`xiaohongshu/delete-note: confirmation modal step failed (${confirmResult?.kind ?? 'unknown'})`);
+            }
+            // Step 4: poll for row removal (proves the delete actually committed,
+            // not just the modal was clicked). Iteration-bounded rather than
+            // wall-clock so tests with a mocked `page.wait` exhaust the loop
+            // quickly instead of stalling on real time.
+            const VERIFY_ITERATIONS = Math.ceil(VERIFY_TIMEOUT_MS / VERIFY_POLL_MS);
+            let stillPresent = true;
+            for (let i = 0; i < VERIFY_ITERATIONS; i++) {
+                await page.wait({ time: VERIFY_POLL_MS / 1000 });
+                const probe = requireEvaluateBoolean(unwrapEvaluateResult(await page.evaluate(buildVerifyGoneScript(noteId))), 'verify-gone');
+                if (probe === false) {
+                    stillPresent = false;
+                    break;
+                }
+            }
+            if (stillPresent) {
+                throw new CommandExecutionError(`xiaohongshu/delete-note: note ${noteId} still visible after confirm click; deletion may not have committed.`);
+            }
+            return [{ status: 'deleted', note_id: noteId, message: 'Delete confirmed and note row disappeared.' }];
+        }
+        catch (err) {
+            if (err instanceof CliError)
+                throw err;
+            throw new CommandExecutionError(`xiaohongshu/delete-note failed: ${err?.message ?? String(err)}`);
+        }
+    },
+});
+export const __test__ = {
+    normalizeNoteId,
+    buildLocateAndMaybeDeleteScript,
+    buildVerifyGoneScript,
+};

package/clis/xiaohongshu/delete-note.test.js

@@ -0,0 +1,172 @@
+import { describe, expect, it, vi } from 'vitest';
+import { JSDOM } from 'jsdom';
+import { getRegistry } from '@jackwener/opencli/registry';
+import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+
+import { __test__ } from './delete-note.js';
+
+function makePage(evaluateResults = []) {
+  const evaluate = vi.fn();
+  for (const r of evaluateResults) evaluate.mockResolvedValueOnce(r);
+  evaluate.mockResolvedValue(undefined);
+  return {
+    goto: vi.fn().mockResolvedValue(undefined),
+    wait: vi.fn().mockResolvedValue(undefined),
+    evaluate,
+  };
+}
+
+describe('xiaohongshu delete-note command', () => {
+  const getCommand = () => getRegistry().get('xiaohongshu/delete-note');
+  const validId = '6a08ba0b000000000702a893';
+
+  it('returns deleted status when delete + confirm + verify all succeed', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',  // currentUrl
+      true,                                                 // 已发布 tab click
+      { ok: true, clicked: true },                          // initResult: row found + delete clicked
+      { ok: true },                                         // confirmResult
+      false,                                                // verify probe: row gone
+    ]);
+    const result = await getCommand().func(page, { 'note-id': validId, execute: true });
+    expect(result).toEqual([
+      { status: 'deleted', note_id: validId, message: 'Delete confirmed and note row disappeared.' },
+    ]);
+    expect(page.goto).toHaveBeenCalledWith('https://creator.xiaohongshu.com/new/note-manager');
+  });
+
+  it('dry-runs by default after verifying the exact target and delete affordance', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      true,
+      { ok: true, clicked: false },
+    ]);
+    const result = await getCommand().func(page, { 'note-id': validId });
+    expect(result).toEqual([
+      { status: 'dry-run', note_id: validId, message: 'Target note row and delete action verified. Re-run with --execute to delete.' },
+    ]);
+    expect(page.evaluate).toHaveBeenCalledTimes(3);
+  });
+
+  it('unwraps browser bridge envelopes at every evaluate boundary', async () => {
+    const page = makePage([
+      { session: 's', data: 'https://creator.xiaohongshu.com/new/note-manager' },
+      { session: 's', data: true },
+      { session: 's', data: { ok: true, clicked: true } },
+      { session: 's', data: { ok: true } },
+      { session: 's', data: false },
+    ]);
+    const result = await getCommand().func(page, { 'note-id': validId, execute: true });
+    expect(result[0]).toMatchObject({ status: 'deleted', note_id: validId });
+  });
+
+  it('normalizes exact Xiaohongshu note IDs from supported URL forms', () => {
+    expect(__test__.normalizeNoteId(validId.toUpperCase())).toBe(validId);
+    expect(__test__.normalizeNoteId(`https://www.xiaohongshu.com/explore/${validId}?xsec_token=t`)).toBe(validId);
+    expect(__test__.normalizeNoteId(`https://creator.xiaohongshu.com/statistics/note-detail?noteId=${validId}`)).toBe(validId);
+  });
+
+  it('throws ArgumentError for missing or ambiguous note identity before navigation', async () => {
+    const page = makePage();
+    await expect(getCommand().func(page, { 'note-id': '' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(getCommand().func(page, { 'note-id': '   ' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(getCommand().func(page, { 'note-id': 'x' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(getCommand().func(page, { 'note-id': 'https://evil.com/explore/6a08ba0b000000000702a893' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(getCommand().func(page, { 'note-id': 'https://xhslink.com/abc' })).rejects.toBeInstanceOf(ArgumentError);
+    await expect(getCommand().func(page, { 'note-id': `https://www.xiaohongshu.com/anything?noteId=${validId}` })).rejects.toBeInstanceOf(ArgumentError);
+    expect(page.goto).not.toHaveBeenCalled();
+  });
+
+  it('throws CommandExecutionError for malformed evaluate payloads instead of trusting truthy objects', async () => {
+    await expect(getCommand().func(makePage([
+      { session: 's', data: { href: 'https://creator.xiaohongshu.com/new/note-manager' } },
+    ]), { 'note-id': validId })).rejects.toThrowError(/malformed current-url payload/);
+
+    await expect(getCommand().func(makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      { session: 's', data: { ok: true } },
+    ]), { 'note-id': validId })).rejects.toThrowError(/malformed published-tab payload/);
+
+    await expect(getCommand().func(makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      true,
+      { session: 's', data: { ok: 'yes', clicked: false } },
+    ]), { 'note-id': validId })).rejects.toThrowError(/malformed locate-note payload/);
+  });
+
+  it('throws AuthRequiredError when redirected to login', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/login?redirectReason=401',
+    ]);
+    await expect(getCommand().func(page, { 'note-id': validId })).rejects.toBeInstanceOf(AuthRequiredError);
+  });
+
+  it('throws CommandExecutionError when 已发布 tab cannot be clicked (UI drift)', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      false, // tab click returns false
+    ]);
+    await expect(getCommand().func(page, { 'note-id': validId })).rejects.toThrowError(/已发布 tab not found/);
+  });
+
+  it('throws EmptyResultError when the note row is not in the 已发布 tab', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      true,
+      { ok: false, kind: 'not_found', visibleRows: 0 },
+    ]);
+    await expect(getCommand().func(page, { 'note-id': validId })).rejects.toBeInstanceOf(EmptyResultError);
+  });
+
+  it('throws CommandExecutionError when the row has no visible delete action', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      true,
+      { ok: false, kind: 'no_delete_action', visibleRows: 1 },
+    ]);
+    await expect(getCommand().func(page, { 'note-id': validId })).rejects.toThrowError(/no delete action/i);
+  });
+
+  it('throws CommandExecutionError when the confirmation modal does not appear', async () => {
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      true,
+      { ok: true },
+      { ok: false, kind: 'no_modal' },
+    ]);
+    await expect(getCommand().func(page, { 'note-id': validId, execute: true })).rejects.toThrowError(/no_modal/);
+  });
+
+  it('throws CommandExecutionError when row stays visible after confirm (delete did not commit)', async () => {
+    // verify probes return true (note still present) for the entire poll window.
+    const probes = Array(15).fill(true);
+    const page = makePage([
+      'https://creator.xiaohongshu.com/new/note-manager',
+      true,
+      { ok: true },
+      { ok: true },
+      ...probes,
+    ]);
+    await expect(getCommand().func(page, { 'note-id': validId, execute: true })).rejects.toThrowError(/still visible after confirm/i);
+  });
+
+  it('executes the generated row locator without substring-matching other impression fields', () => {
+    const otherId = '6a08ba0b000000000702a894';
+    const dom = new JSDOM(`
+      <div class="note" data-impression='{"noteTarget":{"value":{"noteId":"${otherId}"}},"title":"${validId}"}'>
+        <span class="control data-del">删除</span>
+      </div>
+      <div class="note" data-impression='{"noteTarget":{"value":{"noteId":"${validId}"}}}'>
+        <span class="control data-del">删除</span>
+      </div>
+    `, { runScripts: 'outside-only' });
+    Object.defineProperty(dom.window.HTMLElement.prototype, 'offsetParent', {
+      configurable: true,
+      get() {
+        return this.ownerDocument.body;
+      },
+    });
+    const result = dom.window.eval(__test__.buildLocateAndMaybeDeleteScript(validId, false));
+    expect(result).toEqual({ ok: true, clicked: false });
+  });
+});

package/clis/xiaohongshu/publish.js

@@ -22,6 +22,14 @@ const PUBLISH_URL = 'https://creator.xiaohongshu.com/publish/publish?from=menu_l
 const MAX_IMAGES = 9;
 const MAX_TITLE_LEN = 20;
 const UPLOAD_SETTLE_MS = 3000;
+/**
+ * XHS creator center wraps the publish/save button in an `<xhs-publish-btn>`
+ * web component backed by a CLOSED shadow root. Host-level `.click()` does
+ * not dispatch into the internal handler. Invoke these instance methods on
+ * the host element to trigger publish / save-draft directly (#1606).
+ */
+const PUBLISH_METHOD_NAMES = ['_onPublish', 'onPublish', '_onSubmit', '_handlePublish'];
+const DRAFT_METHOD_NAMES = ['_onSave', '_onSaveDraft', '_onDraft'];
 /** Selectors for the title field, ordered by priority across current UI variants. */
 const TITLE_SELECTORS = [
     // Some creator-center variants expose the title as contenteditable,
@@ -610,26 +618,58 @@ cli({
         }
         // ── Step 7: Publish or save draft ─────────────────────────────────────────
         const actionLabels = isDraft ? ['暂存离开', '存草稿'] : ['发布', '发布笔记'];
-        const btnClicked = await page.evaluate(`
-      (labels => {
+        const invokeResult = await page.evaluate(`
+      (cfg => {
+        const { isDraftMode, publishNames, draftNames, labels } = cfg;
+        const isVisible = (el) => {
+          if (!el || el.offsetParent === null) return false;
+          const rect = el.getBoundingClientRect();
+          return rect.width > 0 && rect.height > 0;
+        };
+        // Path 1: web component method invoke on <xhs-publish-btn>.
+        const hosts = Array.from(document.querySelectorAll('xhs-publish-btn')).filter(isVisible);
+        const wanted = isDraftMode ? draftNames : publishNames;
+        // Try every host + every candidate; do NOT bail on the first throw
+        // (multiple hosts can exist, and a later name may succeed).
+        let lastMethodError = null;
+        for (const host of hosts) {
+          for (const name of wanted) {
+            if (typeof host[name] !== 'function') continue;
+            try {
+              host[name]();
+              return { ok: true, via: 'method', name };
+            } catch (err) {
+              lastMethodError = String(err && err.message || err);
+            }
+          }
+        }
+        // Path 2: legacy <button>/[role=button] text-match click fallback.
         const buttons = document.querySelectorAll('button, [role="button"]');
         for (const btn of buttons) {
           const text = (btn.innerText || btn.textContent || '').trim();
           if (
             labels.some(l => text === l || text.includes(l)) &&
-            btn.offsetParent !== null &&
+            isVisible(btn) &&
             !btn.disabled
           ) {
             btn.click();
-            return true;
+            return { ok: true, via: 'click', text };
           }
         }
-        return false;
-      })(${JSON.stringify(actionLabels)})
+        return { ok: false, via: 'none', hosts: hosts.length, lastMethodError };
+      })(${JSON.stringify({
+            isDraftMode: isDraft,
+            publishNames: PUBLISH_METHOD_NAMES,
+            draftNames: DRAFT_METHOD_NAMES,
+            labels: actionLabels,
+        })})
     `);
-        if (!btnClicked) {
+        if (!invokeResult?.ok) {
             await page.screenshot({ path: '/tmp/xhs_publish_submit_debug.png' });
-            throw new Error(`Could not find "${actionLabels[0]}" button. ` +
+            const viaClause = invokeResult?.via ? ` (via=${invokeResult.via})` : '';
+            const errorClause = invokeResult?.error ? `, error=${invokeResult.error}` : '';
+            const lastMethodClause = invokeResult?.lastMethodError ? `, lastMethodError=${invokeResult.lastMethodError}` : '';
+            throw new Error(`Could not trigger "${actionLabels[0]}" action${viaClause}${errorClause}${lastMethodClause}. ` +
                 'Debug screenshot: /tmp/xhs_publish_submit_debug.png');
         }
         // ── Step 8: Verify success ─────────────────────────────────────────────────