fastbrowser_cli 1.0.22 → 1.0.28

package/examples/welcometothejungle/wttj-job.ts

@@ -1,180 +1,159 @@
 #!/usr/bin/env npx tsx
 // Usage: npx tsx extract-wttj-job.ts <job-url>
 
-import { execSync } from 'node:child_process';
+import { FastBrowserHelper } from "./fastbrowser_helper.js";
 
 ///////////////////////////////////////////////////////////////////////////////
 
 const ALL_STOPS = [
-        'Descriptif du poste',
-        'Missions clés',
-        'What you will do',
-        'Vos missions',
-        'Vos principales missions',
-        'Responsabilités',
-        'Profil recherché',
-        'About you',
-        'Votre profil',
-        'Le profil idéal',
-        'Qui êtes-vous ?',
-        'Location & Remote',
-        'What we offer',
+	'Descriptif du poste',
+	'Missions clés',
+	'What you will do',
+	'Vos missions',
+	'Vos principales missions',
+	'Responsabilités',
+	'Profil recherché',
+	'About you',
+	'Votre profil',
+	'Le profil idéal',
+	'Qui êtes-vous ?',
+	'Location & Remote',
+	'What we offer',
 ];
 
 ///////////////////////////////////////////////////////////////////////////////
 
 class SnapshotParser {
-        private lines: string[];
-
-        constructor(snapshot: string) {
-                this.lines = snapshot.split('\n');
-        }
-
-        private extractQuotedValue(line: string, token: string): string | null {
-                const idx = line.indexOf(`${token} "`);
-                if (idx === -1) return null;
-                const start = idx + token.length + 2;
-                const end = line.indexOf('"', start);
-                if (end === -1) return null;
-                return line.slice(start, end);
-        }
-
-        extractStaticTexts(): string[] {
-                return this.lines
-                        .map(l => this.extractQuotedValue(l, 'StaticText'))
-                        .filter((v): v is string => v !== null && v.trim() !== '');
-        }
-
-        extractAfterHeading(headingText: string): string[] {
-                const results: string[] = [];
-                let found = false;
-                for (const line of this.lines) {
-                        if (line.includes('heading "')) {
-                                const val = this.extractQuotedValue(line, 'heading');
-                                if (found) break;
-                                if (val === headingText) found = true;
-                                continue;
-                        }
-                        if (!found) continue;
-                        if (line.includes('StaticText "')) {
-                                const val = this.extractQuotedValue(line, 'StaticText');
-                                if (val === null || val.trim() === '') continue;
-                                if (ALL_STOPS.includes(val)) break;
-                                results.push(val);
-                        }
-                }
-                return results;
-        }
-
-        extractAfterStaticText(startLabel: string): string[] {
-                const results: string[] = [];
-                let found = false;
-                for (const line of this.lines) {
-                        if (line.includes('heading "') && found) break;
-                        if (!line.includes('StaticText "')) continue;
-                        const val = this.extractQuotedValue(line, 'StaticText');
-                        if (val === null || val.trim() === '') continue;
-                        if (found) {
-                                if (ALL_STOPS.includes(val)) break;
-                                results.push(val);
-                        }
-                        if (val === startLabel) found = true;
-                }
-                return results;
-        }
-
-        findFirstSection(labels: string[]): string[] {
-                for (const label of labels) {
-                        const result = this.extractAfterStaticText(label);
-                        if (result.length > 0) return result;
-                }
-                return [];
-        }
-}
-
-///////////////////////////////////////////////////////////////////////////////
-
-class FastBrowser {
-        static run(command: string): string {
-                return execSync(`npx fastbrowser_cli ${command}`, { encoding: 'utf8' });
-        }
-
-        static navigatePage(url: string): void {
-                FastBrowser.run(`navigate_page --url '${url}'`);
-        }
-
-        static takeSnapshot(): string {
-                return FastBrowser.run('take_snapshot');
-        }
-
-        static querySelectors(selector: string, withAncestors = true): string {
-                const flag = withAncestors === false ? ' --no-with-ancestors' : '';
-                return FastBrowser.run(`query_selectors --selector '${selector}'${flag}`);
-        }
+	private lines: string[];
+
+	constructor(snapshot: string) {
+		this.lines = snapshot.split('\n');
+	}
+
+	private extractQuotedValue(line: string, token: string): string | null {
+		const idx = line.indexOf(`${token} "`);
+		if (idx === -1) return null;
+		const start = idx + token.length + 2;
+		const end = line.indexOf('"', start);
+		if (end === -1) return null;
+		return line.slice(start, end);
+	}
+
+	extractStaticTexts(): string[] {
+		return this.lines
+			.map(l => this.extractQuotedValue(l, 'StaticText'))
+			.filter((v): v is string => v !== null && v.trim() !== '');
+	}
+
+	extractAfterHeading(headingText: string): string[] {
+		const results: string[] = [];
+		let found = false;
+		for (const line of this.lines) {
+			if (line.includes('heading "')) {
+				const val = this.extractQuotedValue(line, 'heading');
+				if (found) break;
+				if (val === headingText) found = true;
+				continue;
+			}
+			if (!found) continue;
+			if (line.includes('StaticText "')) {
+				const val = this.extractQuotedValue(line, 'StaticText');
+				if (val === null || val.trim() === '') continue;
+				if (ALL_STOPS.includes(val)) break;
+				results.push(val);
+			}
+		}
+		return results;
+	}
+
+	extractAfterStaticText(startLabel: string): string[] {
+		const results: string[] = [];
+		let found = false;
+		for (const line of this.lines) {
+			if (line.includes('heading "') && found) break;
+			if (!line.includes('StaticText "')) continue;
+			const val = this.extractQuotedValue(line, 'StaticText');
+			if (val === null || val.trim() === '') continue;
+			if (found) {
+				if (ALL_STOPS.includes(val)) break;
+				results.push(val);
+			}
+			if (val === startLabel) found = true;
+		}
+		return results;
+	}
+
+	findFirstSection(labels: string[]): string[] {
+		for (const label of labels) {
+			const result = this.extractAfterStaticText(label);
+			if (result.length > 0) return result;
+		}
+		return [];
+	}
 }
 
 ///////////////////////////////////////////////////////////////////////////////
 
 class WttjExtractor {
-        static extractTitle(output: string): string {
-                const match = output.match(/heading "(.+?)" level/);
-                return match !== null ? match[1] : '(non trouvé)';
-        }
-
-        static printSection(title: string, lines: string[]): void {
-                console.log(`\n=== ${title} ===`);
-                if (lines.length === 0) {
-                        console.log('(non trouvé)');
-                        return;
-                }
-                console.log(lines.join('\n'));
-        }
-
-        static async run(jobUrl: string): Promise<void> {
-                FastBrowser.navigatePage(jobUrl);
-
-                console.log('=== TITRE ===');
-                const selectorOutput = FastBrowser.querySelectors('heading[level="2"]', false);
-                console.log(WttjExtractor.extractTitle(selectorOutput));
-
-                const snapshot = FastBrowser.takeSnapshot();
-                const parser = new SnapshotParser(snapshot);
-
-                let descriptif = parser.extractAfterHeading('Descriptif du poste');
-                if (descriptif.length === 0) {
-                        descriptif = parser.extractAfterStaticText('Descriptif du poste');
-                }
-                WttjExtractor.printSection('DESCRIPTIF DU POSTE', descriptif);
-
-                const missions = parser.findFirstSection([
-                        'Missions clés',
-                        'What you will do',
-                        'Vos missions',
-                        'Vos principales missions',
-                        'Responsabilités',
-                ]);
-                WttjExtractor.printSection('MISSIONS CLÉS', missions);
-
-                const profil = parser.findFirstSection([
-                        'Profil recherché',
-                        'About you',
-                        'Votre profil',
-                        'Le profil idéal',
-                        'Qui êtes-vous ?',
-                ]);
-                WttjExtractor.printSection('PROFIL RECHERCHÉ', profil);
-        }
+	static extractTitle(output: string): string {
+		const match = output.match(/heading "(.+?)" level/);
+		return match !== null ? match[1] : '(non trouvé)';
+	}
+
+	static printSection(title: string, lines: string[]): void {
+		console.log(`\n=== ${title} ===`);
+		if (lines.length === 0) {
+			console.log('(non trouvé)');
+			return;
+		}
+		console.log(lines.join('\n'));
+	}
+
+	static async run(jobUrl: string): Promise<void> {
+		FastBrowserHelper.navigatePage(jobUrl);
+
+		console.log('=== TITRE ===');
+		const selectorOutput = FastBrowserHelper.querySelectors('heading[level="2"]', false);
+		console.log(WttjExtractor.extractTitle(selectorOutput));
+
+		const snapshot = FastBrowserHelper.takeSnapshot();
+		const parser = new SnapshotParser(snapshot);
+
+		let descriptif = parser.extractAfterHeading('Descriptif du poste');
+		if (descriptif.length === 0) {
+			descriptif = parser.extractAfterStaticText('Descriptif du poste');
+		}
+		WttjExtractor.printSection('DESCRIPTIF DU POSTE', descriptif);
+
+		const missions = parser.findFirstSection([
+			'Missions clés',
+			'What you will do',
+			'Vos missions',
+			'Vos principales missions',
+			'Responsabilités',
+		]);
+		WttjExtractor.printSection('MISSIONS CLÉS', missions);
+
+		const profil = parser.findFirstSection([
+			'Profil recherché',
+			'About you',
+			'Votre profil',
+			'Le profil idéal',
+			'Qui êtes-vous ?',
+		]);
+		WttjExtractor.printSection('PROFIL RECHERCHÉ', profil);
+	}
 }
 
 ///////////////////////////////////////////////////////////////////////////////
 
 const jobUrl = process.argv[2];
 if (jobUrl === undefined || jobUrl === '') {
-        console.error('Usage: npx tsx extract-wttj-job.ts <job-url>');
-        process.exit(1);
+	console.error('Usage: npx tsx extract-wttj-job.ts <job-url>');
+	process.exit(1);
 }
 
 WttjExtractor.run(jobUrl).catch((err: unknown) => {
-        console.error('Error:', err);
-        process.exit(1);
+	console.error('Error:', err);
+	process.exit(1);
 });

package/examples/welcometothejungle/wttj-search.ts

@@ -1,101 +1,78 @@
 #!/usr/bin/env npx tsx
 
-import { execSync } from 'node:child_process';
+// npm imports
 import { Command, Option } from 'commander';
+import { FastBrowserHelper } from './fastbrowser_helper.js';
 
 ///////////////////////////////////////////////////////////////////////////////
-
-class FastBrowser {
-        static run(command: string): string {
-                return execSync(`npx fastbrowser_cli ${command}`, { encoding: 'utf8' });
-        }
-
-        static navigatePage(url: string): void {
-                FastBrowser.run(`navigate_page --url '${url}'`);
-        }
-
-        static fillForm(selector: string, value: string): void {
-                FastBrowser.run(`fill_form --selector '${selector}' --value '${value}'`);
-        }
-
-        static pressKeys(keys: string): void {
-                FastBrowser.run(`press_keys --keys '${keys}'`);
-        }
-
-        static click(selector: string): void {
-                FastBrowser.run(`click -s '${selector}'`);
-        }
-
-        static querySelectorsAll(selector: string, limit: number): string {
-                return FastBrowser.run(`query_selectors_all --selector '${selector}' --limit ${limit}`);
-        }
-}
-
+///////////////////////////////////////////////////////////////////////////////
+//	
+///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
 
 class WttjSearch {
-        static parseJobTitles(output: string): Array<{ title: string; url: string; }> {
-                const results: Array<{ title: string; url: string; }> = [];
-                const headingRe = /heading "(.+?)" level/g;
-                const urlRe = /url="([^"]+)"/;
-                for (const line of output.split('\n')) {
-                        const headingMatch = headingRe.exec(line);
-                        if (headingMatch === null) continue;
-                        const urlMatch = urlRe.exec(line);
-                        results.push({
-                                title: headingMatch[1],
-                                url: urlMatch !== null ? urlMatch[1] : '',
-                        });
-                        headingRe.lastIndex = 0;
-                }
-                return results;
-        }
-
-        static outputJson(jobs: Array<{ title: string; url: string; }>): void {
-                console.log(JSON.stringify(jobs, null, 2));
-        }
-
-        static outputMarkdown(jobs: Array<{ title: string; url: string; }>): void {
-                console.log('| # | Title | URL |');
-                console.log('|---|-------|-----|');
-                for (const [i, job] of jobs.entries()) {
-                        const url = job.url !== '' ? `[link](${job.url})` : '';
-                        console.log(`| ${i + 1} | ${job.title} | ${url} |`);
-                }
-        }
-
-        static run(query: string, limit: number = 1, offset: number = 1, format: 'json' | 'markdown' = 'markdown'): void {
-                FastBrowser.navigatePage('https://www.welcometothejungle.com/fr');
-                FastBrowser.fillForm('combobox[name*="intitulé de poste"]', query);
-                FastBrowser.pressKeys('Enter');
-
-                let allJobs: Array<{ title: string; url: string; }> = [];
-
-                for (let page = offset; page < offset + limit; page++) {
-                        if (page > 1) {
-                                FastBrowser.click(`link[name="${page}"]`);
-                        }
-                        const output = FastBrowser.querySelectorsAll('heading[level="2"]', 30);
-                        allJobs = allJobs.concat(WttjSearch.parseJobTitles(output));
-                }
-
-                if (format === 'json') {
-                        WttjSearch.outputJson(allJobs);
-                } else {
-                        WttjSearch.outputMarkdown(allJobs);
-                }
-        }
+	static parseJobTitles(output: string): Array<{ title: string; url: string; }> {
+		const results: Array<{ title: string; url: string; }> = [];
+		const headingRe = /heading "(.+?)" level/g;
+		const urlRe = /url="([^"]+)"/;
+		for (const line of output.split('\n')) {
+			const headingMatch = headingRe.exec(line);
+			if (headingMatch === null) continue;
+			const urlMatch = urlRe.exec(line);
+			results.push({
+				title: headingMatch[1],
+				url: urlMatch !== null ? urlMatch[1] : '',
+			});
+			headingRe.lastIndex = 0;
+		}
+		return results;
+	}
+
+	static outputJson(jobs: Array<{ title: string; url: string; }>): void {
+		console.log(JSON.stringify(jobs, null, 2));
+	}
+
+	static outputMarkdown(jobs: Array<{ title: string; url: string; }>): void {
+		console.log('| # | Title | URL |');
+		console.log('|---|-------|-----|');
+		for (const [i, job] of jobs.entries()) {
+			const url = job.url !== '' ? `[link](${job.url})` : '';
+			console.log(`| ${i + 1} | ${job.title} | ${url} |`);
+		}
+	}
+
+	static run(query: string, limit: number = 1, offset: number = 1, format: 'json' | 'markdown' = 'markdown'): void {
+		FastBrowserHelper.navigatePage('https://www.welcometothejungle.com/fr');
+		FastBrowserHelper.fillForm('combobox[name*="intitulé de poste"]', query);
+		FastBrowserHelper.pressKeys('Enter');
+
+		let allJobs: Array<{ title: string; url: string; }> = [];
+
+		for (let page = offset; page < offset + limit; page++) {
+			if (page > 1) {
+				FastBrowserHelper.click(`link[name="${page}"]`);
+			}
+			const output = FastBrowserHelper.querySelectorsAll('heading[level="2"]', 30);
+			allJobs = allJobs.concat(WttjSearch.parseJobTitles(output));
+		}
+
+		if (format === 'json') {
+			WttjSearch.outputJson(allJobs);
+		} else {
+			WttjSearch.outputMarkdown(allJobs);
+		}
+	}
 }
 
 ///////////////////////////////////////////////////////////////////////////////
 
 const program = new Command();
 program
-        .argument('[query]', 'job search query', 'machine learning')
-        .option('-l, --limit <number>', 'number of pages to fetch', '1')
-        .option('-o, --offset <number>', 'first page to scrape', '1')
-        .addOption(new Option('-f, --format <format>', 'output format: json or markdown').choices(['json', 'markdown']).default('markdown'))
-        .parse();
+	.argument('[query]', 'job search query', 'machine learning')
+	.option('-l, --limit <number>', 'number of pages to fetch', '1')
+	.option('-o, --offset <number>', 'first page to scrape', '1')
+	.addOption(new Option('-f, --format <format>', 'output format: json or markdown').choices(['json', 'markdown']).default('markdown'))
+	.parse();
 
 const opts = program.opts();
 const query = program.args[0] ?? 'machine learning';

package/package.json

@@ -1,48 +1,49 @@
 {
-    "name": "fastbrowser_cli",
-    "version": "1.0.22",
-    "description": "",
-    "main": "dist/fastbrowser_cli/fastbrowser_cli.js",
-    "bin": {
-        "fastbrowser_cli": "./dist/fastbrowser_cli/fastbrowser_cli.js",
-        "fastbrowser_mcp": "./dist/fastbrowser_mcp/fastbrowser_mcp.js"
-    },
-    "scripts": {
-        "dev:fastbrowser_mcp": "npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts",
-        "dev:httpd": "npx tsx ./src/fastbrowser_httpd/fastbrowser_httpd.ts",
-        "dev:cli": "npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts",
-        "inspect:fastbrowser_mcp:chrome_devtools": "npx @modelcontextprotocol/inspector npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts mcp_server --mcp_target chrome_devtools",
-        "inspect:fastbrowser_mcp:playwright": "npx @modelcontextprotocol/inspector npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts mcp_server -v --mcp_target playwright",
-        "inspect:chrome_devtools": "npx @modelcontextprotocol/inspector npx chrome-devtools-mcp@latest --autoconnect",
-        "inspect:playwright:chrome": "npx @modelcontextprotocol/inspector npx @playwright/mcp@latest --cdp-endpoint=chrome",
-        "inspect:playwright:cdp_endpoint": "npx @modelcontextprotocol/inspector npx @playwright/mcp@latest --cdp-endpoint=http://localhost:9222",
-        "inspect:playwright:extension": "npx @modelcontextprotocol/inspector npx @playwright/mcp@latest --extension",
-        "build": "tsc -p tsconfig.build.json",
-        "publish:all": "npm run build && npm version patch && npm publish --access public",
-        "typecheck": "tsc -p tsconfig.json --noEmit"
-    },
-    "keywords": [],
-    "author": "",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/jeromeetienne/skillmd_collecetion.git"
-    },
-    "homepage": "https://github.com/jeromeetienne/skillmd_collection/packages/fastbrowser_cli#readme",
-    "type": "module",
-    "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.29.0",
-        "a11y_parse": "^1.0.2",
-        "commander": "^12.1.0",
-        "express": "^4.21.2",
-        "string-argv": "^0.3.2",
-        "typescript": "^6.0.3",
-        "zod": "^4.3.6",
-        "zod-from-json-schema": "^0.5.2"
-    },
-    "devDependencies": {
-        "@types/express": "^4.17.21",
-        "@types/node": "^25.6.0",
-        "tsx": "^4.19.2"
-    }
-}
+  "name": "fastbrowser_cli",
+  "version": "1.0.28",
+  "description": "A CLI tool for FastBrowser, providing commands to interact with the FastBrowser MCP (Model Context Protocol) server and perform various browser automation tasks.",
+  "main": "dist/fastbrowser_cli/fastbrowser_cli.js",
+  "bin": {
+    "fastbrowser_cli": "./dist/fastbrowser_cli/fastbrowser_cli.js",
+    "fastbrowser_mcp": "./dist/fastbrowser_mcp/fastbrowser_mcp.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeromeetienne/skillmd_collecetion.git"
+  },
+  "homepage": "https://github.com/jeromeetienne/skillmd_collection/packages/fastbrowser_cli#readme",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^12.1.0",
+    "express": "^4.21.2",
+    "string-argv": "^0.3.2",
+    "typescript": "^6.0.3",
+    "zod": "^4.3.6",
+    "zod-from-json-schema": "^0.5.2",
+    "a11y_parse": "^1.0.5"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^25.6.0",
+    "tsx": "^4.19.2"
+  },
+  "scripts": {
+    "dev:mcp": "npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts",
+    "dev:httpd": "npx tsx ./src/fastbrowser_httpd/fastbrowser_httpd.ts",
+    "dev:cli": "npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts",
+    "inspect:fastbrowser_mcp:chrome_devtools": "npx @modelcontextprotocol/inspector npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts mcp_server --mcp_target chrome_devtools",
+    "inspect:fastbrowser_mcp:playwright": "npx @modelcontextprotocol/inspector npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts mcp_server -v --mcp_target playwright",
+    "inspect:chrome_devtools": "npx @modelcontextprotocol/inspector npx chrome-devtools-mcp@latest --autoconnect",
+    "inspect:playwright:chrome": "npx @modelcontextprotocol/inspector npx @playwright/mcp@latest --cdp-endpoint=chrome",
+    "inspect:playwright:cdp_endpoint": "npx @modelcontextprotocol/inspector npx @playwright/mcp@latest --cdp-endpoint=http://localhost:9222",
+    "inspect:playwright:extension": "npx @modelcontextprotocol/inspector npx @playwright/mcp@latest --extension",
+    "build": "tsc -p tsconfig.build.json",
+    "publish:all": "pnpm run build && npm version patch && pnpm publish --access public",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npx tsx --test 'tests/**/*.test.ts'"
+  }
+}