@web-auto/camo 0.2.0 → 0.2.1

package/src/container/runtime-core/checkpoint.mjs

@@ -1,209 +1,209 @@
-import { callAPI, getDomSnapshotByProfile } from '../../utils/browser-service.mjs';
-import {
-  asErrorPayload,
-  buildSelectorCheck,
-  ensureActiveSession,
-  getCurrentUrl,
-  isCheckpointRiskUrl,
-  maybeSelector,
-  normalizeArray,
-} from './utils.mjs';
-
-export const XHS_CHECKPOINTS = {
-  search_ready: [
-    '#search-input',
-    'input.search-input',
-    '.search-result-list',
-  ],
-  home_ready: [
-    '.feeds-page',
-    '.note-item',
-  ],
-  detail_ready: [
-    '.note-scroller',
-    '.note-content',
-    '.interaction-container',
-  ],
-  comments_ready: [
-    '.comments-container',
-    '.comment-item',
-  ],
-  login_guard: [
-    '.login-container',
-    '.login-dialog',
-    '#login-container',
-  ],
-  risk_control: [
-    '.qrcode-box',
-    '.captcha-container',
-    '[class*="captcha"]',
-  ],
-};
-
-export async function detectCheckpoint({ profileId, platform = 'generic' }) {
-  try {
-    const session = await ensureActiveSession(profileId);
-    const resolvedProfile = session.profileId || profileId;
-
-    if (platform !== 'xiaohongshu') {
-      const url = await getCurrentUrl(resolvedProfile);
-      return {
-        ok: true,
-        code: 'CHECKPOINT_DETECTED',
-        message: 'Checkpoint detected',
-        data: {
-          profileId: resolvedProfile,
-          platform,
-          checkpoint: 'unknown',
-          url,
-          signals: [],
-          selectorHits: {},
-        },
-      };
-    }
-
-    const [url, snapshot] = await Promise.all([
-      getCurrentUrl(resolvedProfile),
-      getDomSnapshotByProfile(resolvedProfile),
-    ]);
-
-    const signals = [];
-    const counter = {};
-    const addCount = (label, selectors) => {
-      for (const css of selectors) {
-        const count = buildSelectorCheck(snapshot, css).length;
-        if (count > 0) {
-          counter[css] = count;
-          signals.push(`${label}:${css}`);
-        }
-      }
-    };
-
-    addCount('search_ready', XHS_CHECKPOINTS.search_ready);
-    addCount('home_ready', XHS_CHECKPOINTS.home_ready);
-    addCount('detail_ready', XHS_CHECKPOINTS.detail_ready);
-    addCount('comments_ready', XHS_CHECKPOINTS.comments_ready);
-    addCount('login_guard', XHS_CHECKPOINTS.login_guard);
-    addCount('risk_control', XHS_CHECKPOINTS.risk_control);
-
-    let checkpoint = 'unknown';
-    if (!url || !url.includes('xiaohongshu.com')) checkpoint = 'offsite';
-    else if (isCheckpointRiskUrl(url)) checkpoint = 'risk_control';
-    else if (signals.some((item) => item.startsWith('login_guard:'))) checkpoint = 'login_guard';
-    else if (signals.some((item) => item.startsWith('comments_ready:'))) checkpoint = 'comments_ready';
-    else if (signals.some((item) => item.startsWith('detail_ready:'))) checkpoint = 'detail_ready';
-    else if (signals.some((item) => item.startsWith('search_ready:'))) checkpoint = 'search_ready';
-    else if (signals.some((item) => item.startsWith('home_ready:'))) checkpoint = 'home_ready';
-
-    return {
-      ok: true,
-      code: 'CHECKPOINT_DETECTED',
-      message: 'Checkpoint detected',
-      data: {
-        profileId: resolvedProfile,
-        platform,
-        checkpoint,
-        url,
-        signals,
-        selectorHits: counter,
-      },
-    };
-  } catch (err) {
-    return asErrorPayload('CHECKPOINT_DETECT_FAILED', err?.message || String(err));
-  }
-}
-
-export async function captureCheckpoint({
-  profileId,
-  containerId = null,
-  selector = null,
-  platform = 'generic',
-}) {
-  try {
-    const session = await ensureActiveSession(profileId);
-    const resolvedProfile = session.profileId || profileId;
-    const checkpointRes = await detectCheckpoint({ profileId: resolvedProfile, platform });
-    const effectiveSelector = maybeSelector({ profileId: resolvedProfile, containerId, selector });
-    const snapshot = await getDomSnapshotByProfile(resolvedProfile);
-    const matched = effectiveSelector ? buildSelectorCheck(snapshot, effectiveSelector) : [];
-
-    return {
-      ok: true,
-      code: 'CHECKPOINT_CAPTURED',
-      message: 'Checkpoint captured',
-      data: {
-        profileId: resolvedProfile,
-        checkpoint: checkpointRes?.data?.checkpoint || 'unknown',
-        checkpointUrl: checkpointRes?.data?.url || '',
-        containerId,
-        selector: effectiveSelector,
-        selectorCount: matched.length,
-        capturedAt: new Date().toISOString(),
-      },
-    };
-  } catch (err) {
-    return asErrorPayload('CHECKPOINT_CAPTURE_FAILED', err?.message || String(err));
-  }
-}
-
-export async function restoreCheckpoint({
-  profileId,
-  checkpoint = null,
-  action,
-  containerId = null,
-  selector = null,
-  targetCheckpoint = null,
-  platform = 'generic',
-}) {
-  try {
-    const session = await ensureActiveSession(profileId);
-    const resolvedProfile = session.profileId || profileId;
-    const effectiveSelector = maybeSelector({ profileId: resolvedProfile, containerId, selector });
-    let actionResult = null;
-
-    if (action === 'requery_container') {
-      if (!effectiveSelector) return asErrorPayload('CONTAINER_NOT_FOUND', 'Selector is required for requery_container');
-      const snapshot = await getDomSnapshotByProfile(resolvedProfile);
-      const matches = buildSelectorCheck(snapshot, effectiveSelector);
-      if (matches.length === 0) return asErrorPayload('CONTAINER_NOT_FOUND', `Container selector not found: ${effectiveSelector}`);
-      actionResult = { selector: effectiveSelector, count: matches.length };
-    } else if (action === 'scroll_into_view') {
-      if (!effectiveSelector) return asErrorPayload('CONTAINER_NOT_FOUND', 'Selector is required for scroll_into_view');
-      actionResult = await callAPI('evaluate', {
-        profileId: resolvedProfile,
-        script: `(async () => {
-          const el = document.querySelector(${JSON.stringify(effectiveSelector)});
-          if (!el) throw new Error('Element not found');
-          el.scrollIntoView({ behavior: 'auto', block: 'center', inline: 'nearest' });
-          return { ok: true, selector: ${JSON.stringify(effectiveSelector)} };
-        })()`,
-      });
-    } else if (action === 'page_back') {
-      actionResult = await callAPI('page:back', { profileId: resolvedProfile });
-    } else if (action === 'goto_checkpoint_url') {
-      const url = checkpoint?.checkpointUrl || checkpoint?.url || '';
-      if (!url) return asErrorPayload('CHECKPOINT_RESTORE_FAILED', 'checkpointUrl is required for goto_checkpoint_url');
-      actionResult = await callAPI('goto', { profileId: resolvedProfile, url });
-    } else {
-      return asErrorPayload('UNSUPPORTED_RECOVERY_ACTION', `Unsupported recovery action: ${action}`);
-    }
-
-    const checkpointAfter = await detectCheckpoint({ profileId: resolvedProfile, platform });
-    const reached = checkpointAfter?.data?.checkpoint || 'unknown';
-    const targetMatched = targetCheckpoint ? reached === targetCheckpoint : true;
-    return {
-      ok: true,
-      code: targetMatched ? 'CHECKPOINT_RESTORED' : 'CHECKPOINT_RESTORE_PARTIAL',
-      message: targetMatched ? 'Checkpoint restored' : 'Recovery action completed but target checkpoint not reached',
-      data: {
-        profileId: resolvedProfile,
-        action,
-        actionResult,
-        reachedCheckpoint: reached,
-        targetCheckpoint,
-      },
-    };
-  } catch (err) {
-    return asErrorPayload('CHECKPOINT_RESTORE_FAILED', err?.message || String(err));
-  }
-}
+import { callAPI, getDomSnapshotByProfile } from '../../utils/browser-service.mjs';
+import {
+  asErrorPayload,
+  buildSelectorCheck,
+  ensureActiveSession,
+  getCurrentUrl,
+  isCheckpointRiskUrl,
+  maybeSelector,
+  normalizeArray,
+} from './utils.mjs';
+
+export const XHS_CHECKPOINTS = {
+  search_ready: [
+    '#search-input',
+    'input.search-input',
+    '.search-result-list',
+  ],
+  home_ready: [
+    '.feeds-page',
+    '.note-item',
+  ],
+  detail_ready: [
+    '.note-scroller',
+    '.note-content',
+    '.interaction-container',
+  ],
+  comments_ready: [
+    '.comments-container',
+    '.comment-item',
+  ],
+  login_guard: [
+    '.login-container',
+    '.login-dialog',
+    '#login-container',
+  ],
+  risk_control: [
+    '.qrcode-box',
+    '.captcha-container',
+    '[class*="captcha"]',
+  ],
+};
+
+export async function detectCheckpoint({ profileId, platform = 'generic' }) {
+  try {
+    const session = await ensureActiveSession(profileId);
+    const resolvedProfile = session.profileId || profileId;
+
+    if (platform !== 'xiaohongshu') {
+      const url = await getCurrentUrl(resolvedProfile);
+      return {
+        ok: true,
+        code: 'CHECKPOINT_DETECTED',
+        message: 'Checkpoint detected',
+        data: {
+          profileId: resolvedProfile,
+          platform,
+          checkpoint: 'unknown',
+          url,
+          signals: [],
+          selectorHits: {},
+        },
+      };
+    }
+
+    const [url, snapshot] = await Promise.all([
+      getCurrentUrl(resolvedProfile),
+      getDomSnapshotByProfile(resolvedProfile),
+    ]);
+
+    const signals = [];
+    const counter = {};
+    const addCount = (label, selectors) => {
+      for (const css of selectors) {
+        const count = buildSelectorCheck(snapshot, css).length;
+        if (count > 0) {
+          counter[css] = count;
+          signals.push(`${label}:${css}`);
+        }
+      }
+    };
+
+    addCount('search_ready', XHS_CHECKPOINTS.search_ready);
+    addCount('home_ready', XHS_CHECKPOINTS.home_ready);
+    addCount('detail_ready', XHS_CHECKPOINTS.detail_ready);
+    addCount('comments_ready', XHS_CHECKPOINTS.comments_ready);
+    addCount('login_guard', XHS_CHECKPOINTS.login_guard);
+    addCount('risk_control', XHS_CHECKPOINTS.risk_control);
+
+    let checkpoint = 'unknown';
+    if (!url || !url.includes('xiaohongshu.com')) checkpoint = 'offsite';
+    else if (isCheckpointRiskUrl(url)) checkpoint = 'risk_control';
+    else if (signals.some((item) => item.startsWith('login_guard:'))) checkpoint = 'login_guard';
+    else if (signals.some((item) => item.startsWith('comments_ready:'))) checkpoint = 'comments_ready';
+    else if (signals.some((item) => item.startsWith('detail_ready:'))) checkpoint = 'detail_ready';
+    else if (signals.some((item) => item.startsWith('search_ready:'))) checkpoint = 'search_ready';
+    else if (signals.some((item) => item.startsWith('home_ready:'))) checkpoint = 'home_ready';
+
+    return {
+      ok: true,
+      code: 'CHECKPOINT_DETECTED',
+      message: 'Checkpoint detected',
+      data: {
+        profileId: resolvedProfile,
+        platform,
+        checkpoint,
+        url,
+        signals,
+        selectorHits: counter,
+      },
+    };
+  } catch (err) {
+    return asErrorPayload('CHECKPOINT_DETECT_FAILED', err?.message || String(err));
+  }
+}
+
+export async function captureCheckpoint({
+  profileId,
+  containerId = null,
+  selector = null,
+  platform = 'generic',
+}) {
+  try {
+    const session = await ensureActiveSession(profileId);
+    const resolvedProfile = session.profileId || profileId;
+    const checkpointRes = await detectCheckpoint({ profileId: resolvedProfile, platform });
+    const effectiveSelector = maybeSelector({ profileId: resolvedProfile, containerId, selector });
+    const snapshot = await getDomSnapshotByProfile(resolvedProfile);
+    const matched = effectiveSelector ? buildSelectorCheck(snapshot, effectiveSelector) : [];
+
+    return {
+      ok: true,
+      code: 'CHECKPOINT_CAPTURED',
+      message: 'Checkpoint captured',
+      data: {
+        profileId: resolvedProfile,
+        checkpoint: checkpointRes?.data?.checkpoint || 'unknown',
+        checkpointUrl: checkpointRes?.data?.url || '',
+        containerId,
+        selector: effectiveSelector,
+        selectorCount: matched.length,
+        capturedAt: new Date().toISOString(),
+      },
+    };
+  } catch (err) {
+    return asErrorPayload('CHECKPOINT_CAPTURE_FAILED', err?.message || String(err));
+  }
+}
+
+export async function restoreCheckpoint({
+  profileId,
+  checkpoint = null,
+  action,
+  containerId = null,
+  selector = null,
+  targetCheckpoint = null,
+  platform = 'generic',
+}) {
+  try {
+    const session = await ensureActiveSession(profileId);
+    const resolvedProfile = session.profileId || profileId;
+    const effectiveSelector = maybeSelector({ profileId: resolvedProfile, containerId, selector });
+    let actionResult = null;
+
+    if (action === 'requery_container') {
+      if (!effectiveSelector) return asErrorPayload('CONTAINER_NOT_FOUND', 'Selector is required for requery_container');
+      const snapshot = await getDomSnapshotByProfile(resolvedProfile);
+      const matches = buildSelectorCheck(snapshot, effectiveSelector);
+      if (matches.length === 0) return asErrorPayload('CONTAINER_NOT_FOUND', `Container selector not found: ${effectiveSelector}`);
+      actionResult = { selector: effectiveSelector, count: matches.length };
+    } else if (action === 'scroll_into_view') {
+      if (!effectiveSelector) return asErrorPayload('CONTAINER_NOT_FOUND', 'Selector is required for scroll_into_view');
+      actionResult = await callAPI('evaluate', {
+        profileId: resolvedProfile,
+        script: `(async () => {
+          const el = document.querySelector(${JSON.stringify(effectiveSelector)});
+          if (!el) throw new Error('Element not found');
+          el.scrollIntoView({ behavior: 'auto', block: 'center', inline: 'nearest' });
+          return { ok: true, selector: ${JSON.stringify(effectiveSelector)} };
+        })()`,
+      });
+    } else if (action === 'page_back') {
+      actionResult = await callAPI('page:back', { profileId: resolvedProfile });
+    } else if (action === 'goto_checkpoint_url') {
+      const url = checkpoint?.checkpointUrl || checkpoint?.url || '';
+      if (!url) return asErrorPayload('CHECKPOINT_RESTORE_FAILED', 'checkpointUrl is required for goto_checkpoint_url');
+      actionResult = await callAPI('goto', { profileId: resolvedProfile, url });
+    } else {
+      return asErrorPayload('UNSUPPORTED_RECOVERY_ACTION', `Unsupported recovery action: ${action}`);
+    }
+
+    const checkpointAfter = await detectCheckpoint({ profileId: resolvedProfile, platform });
+    const reached = checkpointAfter?.data?.checkpoint || 'unknown';
+    const targetMatched = targetCheckpoint ? reached === targetCheckpoint : true;
+    return {
+      ok: true,
+      code: targetMatched ? 'CHECKPOINT_RESTORED' : 'CHECKPOINT_RESTORE_PARTIAL',
+      message: targetMatched ? 'Checkpoint restored' : 'Recovery action completed but target checkpoint not reached',
+      data: {
+        profileId: resolvedProfile,
+        action,
+        actionResult,
+        reachedCheckpoint: reached,
+        targetCheckpoint,
+      },
+    };
+  } catch (err) {
+    return asErrorPayload('CHECKPOINT_RESTORE_FAILED', err?.message || String(err));
+  }
+}

package/src/container/runtime-core/index.mjs

@@ -1,21 +1,21 @@
-export {
-  ensureActiveSession,
-  asErrorPayload,
-  normalizeArray,
-  extractPageList,
-  getCurrentUrl,
-  maybeSelector,
-  buildSelectorCheck,
-  isCheckpointRiskUrl,
-} from './utils.mjs';
-
-export {
-  XHS_CHECKPOINTS,
-  detectCheckpoint,
-  captureCheckpoint,
-  restoreCheckpoint,
-} from './checkpoint.mjs';
-
-export { validateOperation } from './validation.mjs';
-export { executeOperation } from './operations/index.mjs';
-export { watchSubscriptions } from './subscription.mjs';
+export {
+  ensureActiveSession,
+  asErrorPayload,
+  normalizeArray,
+  extractPageList,
+  getCurrentUrl,
+  maybeSelector,
+  buildSelectorCheck,
+  isCheckpointRiskUrl,
+} from './utils.mjs';
+
+export {
+  XHS_CHECKPOINTS,
+  detectCheckpoint,
+  captureCheckpoint,
+  restoreCheckpoint,
+} from './checkpoint.mjs';
+
+export { validateOperation } from './validation.mjs';
+export { executeOperation } from './operations/index.mjs';
+export { watchSubscriptions } from './subscription.mjs';