sessionsnap 0.0.1 → 0.0.3

package/README.md

@@ -1,7 +1,5 @@
 # sessionsnap
 
-> **KISS — Keep It Simple, Stupid.**
->
 > Authenticated browser sessions shouldn't require complex auth flows, token management, cookie injection hacks, or custom login scripts per site. Just open a browser, log in like a human, and let the tool save & reuse that session. That's it.
 
 Capture and reuse authenticated browser sessions using **manual login**. Supports both Puppeteer and Playwright.

package/bin/sessionsnap.js

@@ -19,16 +19,17 @@ program
   .requiredOption('--profile <name>', 'Profile name to save the session under')
   .option('--out <file>', 'Custom output path for the snapshot JSON')
   .option('--wait <minutes>', 'Max minutes to wait for login', parseFloat)
+  .option('--target <pattern>', 'Regex pattern to wait for in URL (e.g., "/dashboard" or "^https://.*/app")')
   .option('--record', 'Record user actions (clicks, inputs, navigations)')
   .action(async (url, opts) => {
     validateRunner(opts.runner);
     try {
       if (opts.runner === 'puppeteer') {
         const { capture } = await import('../src/puppeteer/capture.js');
-        await capture(url, { profile: opts.profile, out: opts.out, waitMinutes: opts.wait, record: opts.record });
+        await capture(url, { profile: opts.profile, out: opts.out, waitMinutes: opts.wait, targetPattern: opts.target, record: opts.record });
       } else {
         const { capture } = await import('../src/playwright/capture.js');
-        await capture(url, { profile: opts.profile, out: opts.out, waitMinutes: opts.wait, record: opts.record });
+        await capture(url, { profile: opts.profile, out: opts.out, waitMinutes: opts.wait, targetPattern: opts.target, record: opts.record });
       }
     } catch (err) {
       console.error(`[sessionsnap] Error: ${err.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessionsnap",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Capture and reuse authenticated browser sessions (Puppeteer + Playwright)",
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
   "dependencies": {
     "commander": "^12.1.0",
     "css-selector-generator": "^3.8.0",
-    "puppeteer": "^24.2.1"
+    "puppeteer-core": "^24.2.1"
   },
   "peerDependencies": {
     "playwright": ">=1.40.0"

package/src/core/heuristics.js

@@ -18,10 +18,22 @@ export async function getCookieCount(page, runner) {
   return cookies.length;
 }
 
-export async function waitForLoginComplete(page, { runner, waitMinutes } = {}) {
+export async function waitForLoginComplete(page, { runner, waitMinutes, targetPattern } = {}) {
   const timeout = (waitMinutes ?? DEFAULT_TIMEOUT_MIN) * 60 * 1000;
   const start = Date.now();
   const initialCookieCount = await getCookieCount(page, runner);
+  
+  // Compile target pattern if provided
+  let targetRegex = null;
+  if (targetPattern) {
+    try {
+      targetRegex = new RegExp(targetPattern);
+      console.log(`[sessionsnap] Waiting for URL matching pattern: ${targetPattern}`);
+    } catch (err) {
+      console.error(`[sessionsnap] Invalid regex pattern: ${targetPattern}. Error: ${err.message}`);
+      throw new Error(`Invalid target pattern: ${targetPattern}`);
+    }
+  }
 
   return new Promise((resolve) => {
     const timer = setInterval(async () => {
@@ -36,6 +48,20 @@ export async function waitForLoginComplete(page, { runner, waitMinutes } = {}) {
       }
 
       const currentUrl = page.url();
+      
+      // If target pattern is provided, check if URL matches
+      if (targetRegex) {
+        if (targetRegex.test(currentUrl)) {
+          clearInterval(timer);
+          console.log(`[sessionsnap] Target URL pattern matched: ${currentUrl}`);
+          resolve(true);
+          return;
+        }
+        // Continue waiting if pattern doesn't match yet
+        return;
+      }
+
+      // Default behavior: check URL and cookie heuristics
       const urlClear = !isLoginUrl(currentUrl);
 
       let cookieIncreased = false;

package/src/playwright/capture.js

@@ -3,7 +3,7 @@ import { waitForLoginComplete } from '../core/heuristics.js';
 import { createSnapshot, normalizePlaywrightState } from '../core/snapshot.js';
 import { setupRecorder } from '../core/recorder.js';
 
-export async function capture(url, { profile, out, waitMinutes, record }) {
+export async function capture(url, { profile, out, waitMinutes, targetPattern, record }) {
   const { chromium } = await import('playwright');
   const userDataDir = await ensureProfileDir(profile);
 
@@ -24,12 +24,16 @@ export async function capture(url, { profile, out, waitMinutes, record }) {
   console.log(`[sessionsnap] Navigating to: ${url}`);
   await page.goto(url, { waitUntil: 'domcontentloaded' });
 
-  console.log('[sessionsnap] Please log in manually. Login completion will be detected automatically.');
+  if (targetPattern) {
+    console.log(`[sessionsnap] Please log in manually. Waiting for URL matching pattern: ${targetPattern}`);
+  } else {
+    console.log('[sessionsnap] Please log in manually. Login completion will be detected automatically.');
+  }
   if (record) {
     console.log('[sessionsnap] Recording actions... (press Ctrl+C to stop early)');
   }
 
-  const detected = await waitForLoginComplete(page, { runner: 'playwright', waitMinutes });
+  const detected = await waitForLoginComplete(page, { runner: 'playwright', waitMinutes, targetPattern });
 
   if (detected) {
     console.log('[sessionsnap] Login detected! Capturing session...');

package/src/puppeteer/browser.js

@@ -0,0 +1,108 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+
+/**
+ * Find Chrome/Chromium executable path on the system.
+ * Returns the path or null if not found.
+ */
+export function findChromeExecutable() {
+  const platform = process.platform;
+  
+  // Common Chrome/Chromium paths
+  const possiblePaths = [];
+  
+  if (platform === 'darwin') {
+    // macOS
+    possiblePaths.push(
+      '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+      '/Applications/Chromium.app/Contents/MacOS/Chromium',
+      '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+      process.env.CHROME_PATH
+    );
+  } else if (platform === 'linux') {
+    // Linux
+    possiblePaths.push(
+      '/usr/bin/google-chrome',
+      '/usr/bin/google-chrome-stable',
+      '/usr/bin/chromium',
+      '/usr/bin/chromium-browser',
+      '/snap/bin/chromium',
+      process.env.CHROME_PATH
+    );
+  } else if (platform === 'win32') {
+    // Windows
+    const programFiles = [
+      process.env.PROGRAMFILES,
+      process.env['PROGRAMFILES(X86)'],
+      process.env.LOCALAPPDATA,
+    ].filter(Boolean);
+    
+    for (const pf of programFiles) {
+      possiblePaths.push(
+        `${pf}\\Google\\Chrome\\Application\\chrome.exe`,
+        `${pf}\\Chromium\\Application\\chrome.exe`
+      );
+    }
+    
+    // Also check common user install location
+    if (process.env.LOCALAPPDATA) {
+      possiblePaths.push(
+        `${process.env.LOCALAPPDATA}\\Google\\Chrome\\Application\\chrome.exe`,
+        `${process.env.LOCALAPPDATA}\\Chromium\\Application\\chrome.exe`
+      );
+    }
+    
+    possiblePaths.push(process.env.CHROME_PATH);
+  }
+  
+  // Filter out undefined/null values and check if file exists
+  for (const path of possiblePaths) {
+    if (path && existsSync(path)) {
+      return path;
+    }
+  }
+  
+  // Try to find via command line (works on macOS and Linux)
+  if (platform === 'darwin' || platform === 'linux') {
+    try {
+      const commands = platform === 'darwin' 
+        ? ['mdfind "kMDItemCFBundleIdentifier == \'com.google.Chrome\'" | head -1']
+        : ['which google-chrome', 'which chromium', 'which chromium-browser'];
+      
+      for (const cmd of commands) {
+        try {
+          const result = execSync(cmd, { encoding: 'utf8', stdio: 'pipe' }).trim();
+          if (result && existsSync(result)) {
+            // On macOS, mdfind returns the .app path, need to append the executable
+            if (platform === 'darwin' && result.endsWith('.app')) {
+              return `${result}/Contents/MacOS/Google Chrome`;
+            }
+            return result;
+          }
+        } catch {
+          // Command failed, try next
+        }
+      }
+    } catch {
+      // Fallback failed
+    }
+  }
+  
+  return null;
+}
+
+/**
+ * Get Chrome executable path, throwing an error if not found.
+ */
+export function getChromeExecutable() {
+  const path = findChromeExecutable();
+  if (!path) {
+    throw new Error(
+      'Chrome/Chromium not found. Please install Chrome or set CHROME_PATH environment variable.\n' +
+      '  macOS: brew install --cask google-chrome\n' +
+      '  Linux: sudo apt-get install google-chrome-stable\n' +
+      '  Or set CHROME_PATH=/path/to/chrome'
+    );
+  }
+  return path;
+}

package/src/puppeteer/capture.js

@@ -2,14 +2,17 @@ import { ensureProfileDir, saveSnapshot, saveScreenshot, DEFAULT_VIEWPORT } from
 import { waitForLoginComplete } from '../core/heuristics.js';
 import { createSnapshot, normalizePuppeteerCookies } from '../core/snapshot.js';
 import { setupRecorder } from '../core/recorder.js';
+import { getChromeExecutable } from './browser.js';
 
-export async function capture(url, { profile, out, waitMinutes, record }) {
-  const puppeteer = await import('puppeteer');
+export async function capture(url, { profile, out, waitMinutes, targetPattern, record }) {
+  const puppeteer = await import('puppeteer-core');
   const userDataDir = await ensureProfileDir(profile);
+  const executablePath = getChromeExecutable();
 
   console.log('[sessionsnap] Launching browser (Puppeteer)...');
   const browser = await puppeteer.default.launch({
     headless: false,
+    executablePath,
     userDataDir,
     defaultViewport: DEFAULT_VIEWPORT,
     args: [`--window-size=${DEFAULT_VIEWPORT.width},${DEFAULT_VIEWPORT.height}`],
@@ -25,12 +28,16 @@ export async function capture(url, { profile, out, waitMinutes, record }) {
   console.log(`[sessionsnap] Navigating to: ${url}`);
   await page.goto(url, { waitUntil: 'domcontentloaded' });
 
-  console.log('[sessionsnap] Please log in manually. Login completion will be detected automatically.');
+  if (targetPattern) {
+    console.log(`[sessionsnap] Please log in manually. Waiting for URL matching pattern: ${targetPattern}`);
+  } else {
+    console.log('[sessionsnap] Please log in manually. Login completion will be detected automatically.');
+  }
   if (record) {
     console.log('[sessionsnap] Recording actions... (press Ctrl+C to stop early)');
   }
 
-  const detected = await waitForLoginComplete(page, { runner: 'puppeteer', waitMinutes });
+  const detected = await waitForLoginComplete(page, { runner: 'puppeteer', waitMinutes, targetPattern });
 
   if (detected) {
     console.log('[sessionsnap] Login detected! Capturing session...');

package/src/puppeteer/open.js

@@ -1,10 +1,12 @@
 import { ensureProfileDir, loadSnapshot, saveSnapshot, saveScreenshot, DEFAULT_VIEWPORT } from '../store.js';
 import { normalizePuppeteerCookies, updateSnapshot } from '../core/snapshot.js';
 import { setupRecorder } from '../core/recorder.js';
+import { getChromeExecutable } from './browser.js';
 
 export async function open(url, { profile, record }) {
-  const puppeteer = await import('puppeteer');
+  const puppeteer = await import('puppeteer-core');
   const userDataDir = await ensureProfileDir(profile);
+  const executablePath = getChromeExecutable();
 
   // Verify snapshot exists
   await loadSnapshot(profile);
@@ -12,6 +14,7 @@ export async function open(url, { profile, record }) {
   console.log('[sessionsnap] Launching browser (Puppeteer)...');
   const browser = await puppeteer.default.launch({
     headless: false,
+    executablePath,
     userDataDir,
     defaultViewport: DEFAULT_VIEWPORT,
     args: [`--window-size=${DEFAULT_VIEWPORT.width},${DEFAULT_VIEWPORT.height}`],

package/src/puppeteer/replay.js

@@ -1,9 +1,11 @@
 import { ensureProfileDir, loadSnapshot, saveScreenshot, DEFAULT_VIEWPORT } from '../store.js';
 import { replayActions } from '../core/replayer.js';
+import { getChromeExecutable } from './browser.js';
 
 export async function replay(actionsData, { profile, speed, headed, bail, visual }) {
-  const puppeteer = await import('puppeteer');
+  const puppeteer = await import('puppeteer-core');
   const userDataDir = await ensureProfileDir(profile);
+  const executablePath = getChromeExecutable();
 
   // Verify snapshot exists
   await loadSnapshot(profile);
@@ -13,6 +15,7 @@ export async function replay(actionsData, { profile, speed, headed, bail, visual
   console.log('[sessionsnap] Launching browser for replay (Puppeteer)...');
   const browser = await puppeteer.default.launch({
     headless,
+    executablePath,
     userDataDir,
     defaultViewport: DEFAULT_VIEWPORT,
     args: [`--window-size=${DEFAULT_VIEWPORT.width},${DEFAULT_VIEWPORT.height}`],