vektor-slipstream 1.4.4 → 2.0.0

package/cloak-recorder-auto.js

@@ -1,297 +0,0 @@
-'use strict';
-
-/**
- * cloak-recorder-auto.js — Silent automatic session recorder
- * ─────────────────────────────────────────────────────────────────────────────
- * Injects a silent recorder into every Playwright session via addInitScript().
- * Captures mouse/scroll events during the real task, then exports them back
- * to Node.js via Playwright's exposeFunction() bridge.
- *
- * Outcome detection checks for:
- *   - reCAPTCHA block signals (HTTP 403, challenge page DOM markers)
- *   - Cloudflare challenge (cf-mitigated header, title "Just a moment")
- *   - DataDome block (ddg-blocked, dd-cookie absent)
- *   - Generic block signals (HTTP 429, 503)
- *   - Successful pass (200 + no block markers)
- *
- * Usage (inside any cloak session):
- *   const recorder = require('./cloak-recorder-auto');
- *   await recorder.attach(page, context, { site: 'example.com', category: 'login' });
- *   // ... do real work ...
- *   const result = await recorder.detach(page);
- *   // result: { events, outcome, patternId }
- * ─────────────────────────────────────────────────────────────────────────────
- */
-
-let _store = null;
-function getStore() { if (!_store) _store = require('./cloak-pattern-store'); return _store; }
-
-// In-page recorder script — injected via addInitScript
-// Runs in the browser context, not Node.js
-const RECORDER_SCRIPT = `
-(function() {
-  if (window.__cloakAutoRecorder) return;
-
-  const T0     = Date.now();
-  const events = [];
-  let   lastMoveT = 0;
-
-  function onMove(e) {
-    const now = Date.now();
-    if (now - lastMoveT < 50) return; // 20fps throttle
-    lastMoveT = now;
-    events.push({ t: now - T0, type: 'move', x: e.clientX, y: e.clientY });
-  }
-
-  function onWheel(e) {
-    events.push({ t: Date.now() - T0, type: 'scroll',
-                  x: e.clientX, y: e.clientY, dy: Math.round(e.deltaY) });
-  }
-
-  function onClick(e) {
-    events.push({ t: Date.now() - T0, type: 'click', x: e.clientX, y: e.clientY });
-  }
-
-  document.addEventListener('mousemove', onMove,  { passive: true, capture: true });
-  document.addEventListener('wheel',     onWheel, { passive: true, capture: true });
-  document.addEventListener('click',     onClick, { passive: true, capture: true });
-
-  window.__cloakAutoRecorder = {
-    getEvents: () => JSON.stringify({
-      events,
-      viewport: { w: window.innerWidth, h: window.innerHeight },
-      duration: Date.now() - T0,
-      url:      window.location.href,
-    }),
-    stop: () => {
-      document.removeEventListener('mousemove', onMove,  true);
-      document.removeEventListener('wheel',     onWheel, true);
-      document.removeEventListener('click',     onClick, true);
-    },
-  };
-})();
-`;
-
-// Block signal DOM markers
-const BLOCK_MARKERS = [
-  '#challenge-form',           // Cloudflare challenge
-  '.cf-error-code',            // Cloudflare error
-  '#ddg-block-page',           // DataDome block
-  '.recaptcha-checkbox-border',// reCAPTCHA v2 visible
-  '#captcha-box',              // generic captcha
-  '[class*="blocked"]',        // generic block page
-];
-
-// Block signal title strings
-const BLOCK_TITLES = [
-  'just a moment',
-  'access denied',
-  'blocked',
-  'forbidden',
-  'robot',
-  'captcha',
-  'security check',
-];
-
-// ── Outcome detection ─────────────────────────────────────────────────────────
-
-async function detectOutcome(page, response = null) {
-  // Check HTTP status
-  if (response) {
-    const status = response.status();
-    if (status === 403 || status === 429 || status === 503) {
-      return { outcome: 'block', signal: `HTTP ${status}` };
-    }
-    // Cloudflare mitigation header
-    const cfMitigated = response.headers()['cf-mitigated'];
-    if (cfMitigated === 'challenge') {
-      return { outcome: 'block', signal: 'cf-mitigated: challenge' };
-    }
-  }
-
-  // Check DOM for block markers
-  try {
-    for (const sel of BLOCK_MARKERS) {
-      const el = await page.$(sel).catch(() => null);
-      if (el) return { outcome: 'captcha', signal: `DOM: ${sel}` };
-    }
-
-    // Check page title
-    const title = await page.title().catch(() => '');
-    const titleLower = title.toLowerCase();
-    for (const marker of BLOCK_TITLES) {
-      if (titleLower.includes(marker)) {
-        return { outcome: 'block', signal: `title: "${title}"` };
-      }
-    }
-
-    // Check for reCAPTCHA v3 score in page source
-    const content = await page.content().catch(() => '');
-    if (content.includes('grecaptcha') && content.includes('score')) {
-      // v3 present — can't read score directly, but presence is neutral
-      return { outcome: 'pass', signal: 'recaptcha-v3-present-no-block' };
-    }
-  } catch { /* page may have navigated */ }
-
-  return { outcome: 'pass', signal: 'no-block-signals' };
-}
-
-// ── Session attachment ────────────────────────────────────────────────────────
-
-const _sessions = new Map(); // page → session data
-
-/**
- * Attach recorder to a Playwright page.
- * Call after page.goto() — records all input from this point.
- *
- * @param {import('playwright').Page} page
- * @param {object} opts
- * @param {string} opts.site      — target hostname (for logging)
- * @param {string} opts.category  — behaviour category hint
- * @param {string} opts.patternId — if replaying a known pattern, pass its ID for scoring
- */
-async function attach(page, opts = {}) {
-  // Inject recorder script
-  await page.addInitScript(RECORDER_SCRIPT).catch(() => {});
-
-  // Also evaluate immediately (for pages already loaded)
-  await page.evaluate(RECORDER_SCRIPT).catch(() => {});
-
-  _sessions.set(page, {
-    site:       opts.site || '',
-    category:   opts.category || 'custom',
-    patternId:  opts.patternId || null,
-    attachedAt: Date.now(),
-  });
-}
-
-/**
- * Detach recorder, capture events, detect outcome, save to pattern store.
- *
- * @param {import('playwright').Page} page
- * @param {object} opts
- * @param {import('playwright').Response} opts.lastResponse — last navigation response for HTTP status check
- * @param {boolean} opts.save  — save to pattern store (default true)
- * @returns {{ events, outcome, signal, patternId, saved }}
- */
-async function detach(page, opts = {}) {
-  const session = _sessions.get(page) || {};
-  _sessions.delete(page);
-
-  // Stop recorder and grab events from page
-  let recorded = null;
-  try {
-    const raw = await page.evaluate(() => {
-      if (!window.__cloakAutoRecorder) return null;
-      window.__cloakAutoRecorder.stop();
-      return window.__cloakAutoRecorder.getEvents();
-    });
-    if (raw) recorded = JSON.parse(raw);
-  } catch { /* page may have closed */ }
-
-  // Detect outcome
-  const { outcome, signal } = await detectOutcome(page, opts.lastResponse);
-
-  // Score existing pattern if we were replaying one
-  if (session.patternId) {
-    getStore().recordOutcome(session.patternId, outcome, session.site);
-  }
-
-  // Save new pattern from recording (only on pass + enough events)
-  let savedId = null;
-  if (opts.save !== false && outcome === 'pass' && recorded?.events?.length >= 10) {
-    // Normalise pixel coords to 0-1
-    const vp     = recorded.viewport || { w: 1440, h: 900 };
-    const events = recorded.events.map(e => ({
-      dt:   e.t,
-      type: e.type,
-      x:    e.x !== undefined ? +(e.x / vp.w).toFixed(4) : undefined,
-      y:    e.y !== undefined ? +(e.y / vp.h).toFixed(4) : undefined,
-      dy:   e.dy,
-    }));
-
-    // Convert absolute timestamps to dt deltas
-    let lastT = 0;
-    const normalised = events.map(e => {
-      const dt  = e.dt - lastT;
-      lastT     = e.dt;
-      return { ...e, dt };
-    });
-
-    const result = getStore().addPattern({
-      name:        `auto-${session.site}-${Date.now()}`,
-      category:    session.category,
-      description: `Auto-recorded on ${session.site} — ${new Date().toISOString()}`,
-      events:      normalised,
-      viewport:    vp,
-    });
-
-    if (result && !result.duplicate) {
-      savedId = result.id;
-      // Give it an immediate win since it just passed
-      getStore().recordOutcome(result.id, 'pass', session.site);
-    }
-  }
-
-  return {
-    outcome,
-    signal,
-    events:    recorded?.events?.length || 0,
-    patternId: session.patternId,
-    savedId,
-    site:      session.site,
-  };
-}
-
-// ── Integration helpers ───────────────────────────────────────────────────────
-
-/**
- * Full auto-session: pick pattern from store, attach recorder, run callback,
- * detach and score. The callback receives (page, pattern) and does the real work.
- *
- * @param {import('playwright').Page}    page
- * @param {import('playwright').Context} context
- * @param {Function} taskFn  — async (page) => void
- * @param {object}   opts    — { site, category }
- */
-async function autoSession(page, context, taskFn, opts = {}) {
-  const { injectBehaviour, replayPattern, syntheticBrowse } = require('./cloak-behaviour');
-
-  // Ensure builtins are seeded
-  getStore().seedBuiltins();
-
-  // Pick a pattern weighted by tier
-  const pattern = getStore().pickPattern(opts.category);
-
-  // Attach recorder
-  await attach(page, {
-    site:      opts.site || '',
-    category:  opts.category || 'reading',
-    patternId: pattern?.id || null,
-  });
-
-  // Replay the picked pattern (or synthetic if store empty)
-  let behaviourResult;
-  if (pattern) {
-    behaviourResult = await replayPattern(page, pattern.name, { skipClicks: true })
-      .catch(() => syntheticBrowse(page, { durationMs: 4000 }));
-  } else {
-    behaviourResult = await syntheticBrowse(page, { durationMs: 4000 });
-  }
-
-  // Run the actual task
-  let lastResponse = null;
-  page.on('response', r => { lastResponse = r; });
-  await taskFn(page);
-
-  // Detach, score, save
-  const result = await detach(page, { lastResponse, save: true });
-
-  return {
-    ...result,
-    pattern:   pattern ? { id: pattern.id, name: pattern.name, tier: pattern.tier } : null,
-    behaviour: behaviourResult,
-  };
-}
-
-module.exports = { attach, detach, autoSession, detectOutcome };

package/cloak-recorder-snippet.js

@@ -1,119 +0,0 @@
-/**
- * cloak-recorder-snippet.js
- * ─────────────────────────────────────────────────────────────────────────────
- * Paste this into Chrome DevTools console on any page to record a real human
- * browsing session. When done, call stopRecording() to get the JSON output.
- *
- * Recorded JSON can be loaded into cloak-behaviour.js with:
- *   const { loadCustomPattern } = require('./cloak-behaviour');
- *   loadCustomPattern('my-pattern', recordedJSON);
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * HOW TO USE:
- *   1. Open Chrome DevTools (F12)
- *   2. Paste this entire file into the Console tab
- *   3. Press Enter — recording starts immediately
- *   4. Browse naturally for 10–30 seconds
- *   5. Type: stopRecording()
- *   6. The JSON is copied to clipboard AND printed to console
- *   7. Save to a .json file and load with loadCustomPattern()
- * ─────────────────────────────────────────────────────────────────────────────
- */
-
-(function() {
-  if (window.__cloakRecorder) {
-    console.warn('[cloak-recorder] Already running. Call stopRecording() first.');
-    return;
-  }
-
-  const SESSION_START = Date.now();
-  const VIEWPORT      = { w: window.innerWidth, h: window.innerHeight };
-  const events        = [];
-
-  // Throttle mousemove — record at most every 50ms (20fps) to keep size manageable
-  let lastMoveTime = 0;
-
-  function onMouseMove(e) {
-    const now = Date.now();
-    if (now - lastMoveTime < 50) return;
-    lastMoveTime = now;
-    events.push({
-      t:    now - SESSION_START,
-      type: 'move',
-      x:    e.clientX,
-      y:    e.clientY,
-    });
-  }
-
-  function onWheel(e) {
-    events.push({
-      t:    Date.now() - SESSION_START,
-      type: 'scroll',
-      x:    e.clientX,
-      y:    e.clientY,
-      dy:   Math.round(e.deltaY),
-    });
-  }
-
-  function onClick(e) {
-    events.push({
-      t:    Date.now() - SESSION_START,
-      type: 'click',
-      x:    e.clientX,
-      y:    e.clientY,
-    });
-  }
-
-  // Register listeners
-  document.addEventListener('mousemove', onMouseMove, { passive: true });
-  document.addEventListener('wheel',     onWheel,     { passive: true });
-  document.addEventListener('click',     onClick,     { passive: true });
-
-  window.__cloakRecorder = { onMouseMove, onWheel, onClick, events, start: SESSION_START };
-
-  console.log('%c[cloak-recorder] Recording started', 'color: #4ade80; font-weight: bold');
-  console.log('%cBrowse naturally, then call: stopRecording()', 'color: #94a3b8');
-
-  window.stopRecording = function(name, category) {
-    // Remove listeners
-    document.removeEventListener('mousemove', window.__cloakRecorder.onMouseMove);
-    document.removeEventListener('wheel',     window.__cloakRecorder.onWheel);
-    document.removeEventListener('click',     window.__cloakRecorder.onClick);
-
-    const totalMs = Date.now() - SESSION_START;
-    const output  = {
-      name:        name || 'recorded-' + Date.now(),
-      category:    category || 'custom',
-      description: 'Recorded on ' + window.location.hostname + ' — ' + new Date().toISOString(),
-      viewport:    VIEWPORT,
-      durationMs:  totalMs,
-      events:      window.__cloakRecorder.events,
-    };
-
-    const json = JSON.stringify(output, null, 2);
-
-    // Copy to clipboard
-    try {
-      navigator.clipboard.writeText(json).then(() => {
-        console.log('%c[cloak-recorder] JSON copied to clipboard!', 'color: #4ade80; font-weight: bold');
-      }).catch(() => {
-        console.log('%c[cloak-recorder] Clipboard failed — see console output below', 'color: #f97316');
-      });
-    } catch (_) {}
-
-    console.log('%c[cloak-recorder] Recording complete', 'color: #4ade80; font-weight: bold');
-    console.log(`  Events: ${output.events.length}  |  Duration: ${(totalMs/1000).toFixed(1)}s  |  Viewport: ${VIEWPORT.w}×${VIEWPORT.h}`);
-    console.log('');
-    console.log('%cTo load in Node.js:', 'color: #94a3b8');
-    console.log("%c  const { loadCustomPattern } = require('./cloak-behaviour');", 'color: #64748b');
-    console.log("%c  loadCustomPattern('" + (name || 'my-pattern') + "', recordedJSON);", 'color: #64748b');
-    console.log('');
-    console.log('JSON output:');
-    console.log(json);
-
-    delete window.__cloakRecorder;
-    delete window.stopRecording;
-
-    return output;
-  };
-})();