PRIMEIRO ENVIO

This commit is contained in:
2025-12-25 12:02:07 -03:00
parent ca49575224
commit c4d3bd9a86
92 changed files with 26976 additions and 1 deletions
+37
View File
@@ -0,0 +1,37 @@
FROM node:18-alpine
# Install Chromium and dependencies for Puppeteer
RUN apk add --no-cache \
chromium \
nss \
freetype \
freetype-dev \
harfbuzz \
ca-certificates \
ttf-freefont
# Tell Puppeteer to skip installing Chromium. We'll be using the installed package.
ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true \
PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser
WORKDIR /app
# Copy package files
COPY services/crawler/package*.json ./
COPY packages/database/package*.json ./packages/database/
COPY packages/shared/package*.json ./packages/shared/
COPY packages/types/package*.json ./packages/types/
# Install dependencies
RUN npm ci --only=production
# Copy source code
COPY services/crawler/src ./src
COPY packages ./packages
# Build the application
RUN npm run build
EXPOSE 3001
CMD ["npm", "start"]
+24
View File
@@ -0,0 +1,24 @@
module.exports = {
preset: 'ts-jest',
testEnvironment: 'node',
roots: ['<rootDir>/src'],
testMatch: ['**/__tests__/**/*.test.ts'],
transform: {
'^.+\\.ts$': 'ts-jest',
},
collectCoverageFrom: [
'src/**/*.ts',
'!src/**/*.d.ts',
'!src/**/__tests__/**',
],
coverageDirectory: 'coverage',
coverageReporters: ['text', 'lcov', 'html'],
setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
testTimeout: 60000, // Increase timeout for property-based tests
maxWorkers: 1, // Run tests sequentially to avoid resource conflicts
moduleNameMapper: {
'^@cloneweb/shared$': '<rootDir>/../../packages/shared/dist/index.js',
'^@cloneweb/types$': '<rootDir>/../../packages/types/dist/index.js',
'^@cloneweb/database$': '<rootDir>/../../packages/database/dist/index.js'
}
};
+23
View File
@@ -0,0 +1,23 @@
// Jest setup for crawler service
// Global test timeout
jest.setTimeout(60000);
// Mock Puppeteer for tests
jest.mock('puppeteer', () => ({
launch: jest.fn().mockResolvedValue({
newPage: jest.fn().mockResolvedValue({
setViewport: jest.fn(),
setUserAgent: jest.fn(),
goto: jest.fn().mockResolvedValue({
ok: () => true,
status: () => 200
}),
content: jest.fn().mockResolvedValue('<html><head><title>Test</title></head><body>Test content</body></html>'),
waitForSelector: jest.fn(),
waitForTimeout: jest.fn(),
close: jest.fn()
}),
close: jest.fn()
})
}));
+37
View File
@@ -0,0 +1,37 @@
{
"name": "@cloneweb/crawler-service",
"version": "1.0.0",
"description": "Intelligent web crawler service for CloneWeb platform",
"main": "dist/index.js",
"scripts": {
"build": "tsc",
"start": "node dist/index.js",
"dev": "ts-node-dev --respawn --transpile-only src/index.ts",
"test": "jest",
"test:watch": "jest --watch"
},
"dependencies": {
"@cloneweb/database": "file:../../packages/database",
"@cloneweb/shared": "file:../../packages/shared",
"@cloneweb/types": "file:../../packages/types",
"express": "^4.18.2",
"puppeteer": "^21.5.2",
"bull": "^4.12.2",
"@bull-board/api": "^5.10.2",
"@bull-board/express": "^5.10.2",
"ioredis": "^5.3.2",
"robots-parser": "^3.0.1",
"url-parse": "^1.5.10",
"cheerio": "^1.0.0-rc.12",
"fast-check": "^3.15.0"
},
"devDependencies": {
"@types/express": "^4.17.21",
"@types/node": "^20.10.4",
"@types/url-parse": "^1.4.11",
"typescript": "^5.3.3",
"ts-node-dev": "^2.0.0",
"jest": "^29.7.0",
"@types/jest": "^29.5.8"
}
}
@@ -0,0 +1,379 @@
import * as fc from 'fast-check';
import { IntelligentCrawler } from '../core/IntelligentCrawler';
import { CrawlerConfig } from '../types/crawler';
// Mock the shared logger
jest.mock('@cloneweb/shared', () => ({
logger: {
info: jest.fn(),
error: jest.fn(),
warn: jest.fn(),
debug: jest.fn(),
level: 'error'
}
}));
// Feature: website-cloning-platform, Property 1: BFS Page Discovery
describe('Crawler Property Tests', () => {
let crawler: IntelligentCrawler;
beforeEach(() => {
crawler = new IntelligentCrawler();
});
afterEach(async () => {
await crawler.close();
});
// Property 1: BFS Page Discovery
test('Property 1: BFS Page Discovery - should discover all reachable pages in breadth-first order', async () => {
// Custom generator for website structure
const websiteStructureGenerator = () => fc.record({
rootUrl: fc.webUrl(),
pages: fc.array(fc.record({
url: fc.webUrl(),
depth: fc.integer({ min: 1, max: 3 }), // Start from depth 1 (children of root)
links: fc.array(fc.webUrl(), { maxLength: 3 })
}), { minLength: 1, maxLength: 8 })
});
const defaultConfig: CrawlerConfig = {
maxDepth: 3,
maxPages: 50,
respectRobots: false, // Disable for testing
rateLimit: 10,
userAgent: 'Test-Bot/1.0',
timeout: 5000,
viewport: { width: 1280, height: 720 }
};
await fc.assert(fc.asyncProperty(
websiteStructureGenerator(),
async (websiteStructure) => {
// Mock the crawler for testing
const mockCrawler = new MockIntelligentCrawler();
mockCrawler.setMockWebsite(websiteStructure);
const result = await mockCrawler.crawlWebsite(websiteStructure.rootUrl, defaultConfig);
// Verify BFS order: pages at depth n should be discovered before pages at depth n+1
const pagesByDepth = new Map<number, string[]>();
result.pages.forEach((page: any) => {
if (!pagesByDepth.has(page.depth)) {
pagesByDepth.set(page.depth, []);
}
pagesByDepth.get(page.depth)!.push(page.url);
});
// Check that depths are reasonable (should start from 0 for root)
const depths = Array.from(pagesByDepth.keys()).sort((a, b) => a - b);
// Should have at least the root page at depth 0
expect(depths[0]).toBe(0);
// Check that there are no unreasonable gaps in depths
// (allow some gaps since not all depths may be represented in small test cases)
for (let i = 1; i < depths.length; i++) {
const gap = depths[i] - depths[i - 1];
expect(gap).toBeLessThanOrEqual(3); // Allow reasonable gaps
}
// Verify all discovered pages are within max depth
result.pages.forEach((page: any) => {
expect(page.depth).toBeLessThanOrEqual(defaultConfig.maxDepth);
});
// Verify we found at least the root page
expect(result.pages.length).toBeGreaterThanOrEqual(1);
expect(result.pages.some((p: any) => p.url === websiteStructure.rootUrl)).toBe(true);
return true;
}
), { numRuns: 20, timeout: 30000 });
});
// Property 2: Rate Limiting Compliance
test('Property 2: Rate Limiting Compliance - should respect configured rate limits', async () => {
const rateLimitGenerator = () => fc.record({
rateLimit: fc.integer({ min: 1, max: 5 }), // requests per second
urls: fc.array(fc.webUrl(), { minLength: 3, maxLength: 6 }).map(urls => {
// Ensure unique URLs to avoid deduplication
return Array.from(new Set(urls)).slice(0, 4);
})
});
await fc.assert(fc.asyncProperty(
rateLimitGenerator(),
async ({ rateLimit, urls }) => {
// Skip if we don't have enough unique URLs
if (urls.length < 2) return true;
const config: CrawlerConfig = {
maxDepth: 2,
maxPages: urls.length,
respectRobots: false,
rateLimit,
userAgent: 'Test-Bot/1.0',
timeout: 5000,
viewport: { width: 1280, height: 720 }
};
const mockCrawler = new MockIntelligentCrawler();
mockCrawler.setMockWebsite({
rootUrl: urls[0],
pages: urls.slice(1).map((url, index) => ({
url,
depth: 1,
links: []
}))
});
const startTime = Date.now();
await mockCrawler.crawlWebsite(urls[0], config);
const endTime = Date.now();
const actualDuration = endTime - startTime;
// Calculate minimum expected duration for the number of requests after the first
const requestCount = Math.min(urls.length, config.maxPages);
const minExpectedDuration = (requestCount - 1) * (1000 / rateLimit);
// Allow some tolerance for test execution overhead (50% tolerance)
expect(actualDuration).toBeGreaterThanOrEqual(minExpectedDuration * 0.5);
return true;
}
), { numRuns: 10, timeout: 60000 });
});
// Property 3: JavaScript Content Capture
test('Property 3: JavaScript Content Capture - should capture JavaScript-generated content', async () => {
const jsContentGenerator = () => fc.record({
url: fc.webUrl(),
hasJavaScript: fc.boolean(),
dynamicElements: fc.array(fc.string(), { minLength: 0, maxLength: 5 })
});
const defaultConfig: CrawlerConfig = {
maxDepth: 1,
maxPages: 1,
respectRobots: false,
rateLimit: 5,
userAgent: 'Test-Bot/1.0',
timeout: 10000,
viewport: { width: 1280, height: 720 },
waitForTimeout: 1000
};
await fc.assert(fc.asyncProperty(
jsContentGenerator(),
async ({ url, hasJavaScript, dynamicElements }) => {
const mockCrawler = new MockIntelligentCrawler();
// Set up mock website with JavaScript content
mockCrawler.setMockWebsite({
rootUrl: url,
pages: [],
hasJavaScript,
dynamicElements
});
const result = await mockCrawler.crawlWebsite(url, defaultConfig);
// Verify that the page was captured
expect(result.pages.length).toBeGreaterThanOrEqual(1);
const rootPage = result.pages.find((p: any) => p.url === url);
expect(rootPage).toBeDefined();
// Verify content was captured
expect(rootPage.content).toBeDefined();
expect(rootPage.content.length).toBeGreaterThan(0);
// If JavaScript is present, verify dynamic content handling
if (hasJavaScript && dynamicElements.length > 0) {
// Mock should simulate that dynamic content was captured
expect(rootPage.content).toContain('dynamic-content-loaded');
}
return true;
}
), { numRuns: 15, timeout: 30000 });
});
// Property 4: Complete Sitemap Generation
test('Property 4: Complete Sitemap Generation - should generate complete sitemap with hierarchical relationships', async () => {
const sitemapGenerator = () => fc.record({
rootUrl: fc.webUrl(),
pages: fc.array(fc.record({
url: fc.webUrl(),
depth: fc.integer({ min: 1, max: 3 }),
links: fc.array(fc.webUrl(), { maxLength: 3 })
}), { minLength: 1, maxLength: 8 })
});
const defaultConfig: CrawlerConfig = {
maxDepth: 3,
maxPages: 20,
respectRobots: false,
rateLimit: 10,
userAgent: 'Test-Bot/1.0',
timeout: 5000,
viewport: { width: 1280, height: 720 }
};
await fc.assert(fc.asyncProperty(
sitemapGenerator(),
async (websiteStructure) => {
const mockCrawler = new MockIntelligentCrawler();
mockCrawler.setMockWebsite(websiteStructure);
const result = await mockCrawler.crawlWebsite(websiteStructure.rootUrl, defaultConfig);
// Verify sitemap completeness
expect(result.pages.length).toBeGreaterThanOrEqual(1);
expect(result.structure).toBeDefined();
expect(result.metadata).toBeDefined();
// Verify hierarchical relationships
expect(result.structure.hierarchy).toBeDefined();
expect(result.structure.orphanPages).toBeDefined();
expect(result.structure.externalLinks).toBeDefined();
// Generate XML sitemap
const xmlSitemap = mockCrawler.generateSitemap(result);
expect(xmlSitemap).toContain('<?xml version="1.0" encoding="UTF-8"?>');
expect(xmlSitemap).toContain('<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">');
expect(xmlSitemap).toContain(websiteStructure.rootUrl);
// Generate hierarchical sitemap
const hierarchicalSitemap = mockCrawler.generateSiteHierarchy(result);
expect(hierarchicalSitemap.hierarchy).toBeDefined();
expect(hierarchicalSitemap.hierarchy.url).toBe(websiteStructure.rootUrl);
expect(hierarchicalSitemap.statistics).toBeDefined();
expect(hierarchicalSitemap.statistics.totalPages).toBe(result.pages.length);
// Verify all discovered pages are included in sitemap
result.pages.forEach((page: any) => {
expect(xmlSitemap).toContain(page.url);
});
return true;
}
), { numRuns: 15, timeout: 30000 });
});
});
// Mock implementation for testing
class MockIntelligentCrawler extends IntelligentCrawler {
private mockWebsite: any;
private requestTimes: number[] = [];
setMockWebsite(website: any) {
this.mockWebsite = website;
}
async initialize(): Promise<void> {
// Mock initialization - no real browser needed
}
async crawlWebsite(startUrl: string, config: CrawlerConfig): Promise<any> {
const startTime = Date.now();
const pages: any[] = [];
const visitedUrls = new Set<string>();
const urlQueue: Array<{ url: string; depth: number }> = [{ url: startUrl, depth: 0 }];
// Add all mock pages to the queue
if (this.mockWebsite.pages) {
this.mockWebsite.pages.forEach((page: any) => {
if (!urlQueue.some(item => item.url === page.url)) {
urlQueue.push({ url: page.url, depth: page.depth });
}
});
}
while (urlQueue.length > 0 && pages.length < config.maxPages) {
const { url, depth } = urlQueue.shift()!;
if (visitedUrls.has(url) || depth > config.maxDepth) {
continue;
}
// Apply rate limiting
await this.respectRateLimit(config.rateLimit);
const pageInfo = await this.extractPageInfo(url, depth, config);
if (pageInfo) {
pages.push(pageInfo);
visitedUrls.add(url);
}
}
const crawlTime = Date.now() - startTime;
return {
rootUrl: startUrl,
pages,
totalPages: pages.length,
crawlDepth: Math.max(...pages.map((p: any) => p.depth)),
crawlTime,
structure: { hierarchy: new Map(), orphanPages: [], externalLinks: [] },
metadata: { domain: 'test.com' }
};
}
private async respectRateLimit(rateLimit: number): Promise<void> {
const now = Date.now();
this.requestTimes.push(now);
if (this.requestTimes.length > 1) {
const timeSinceLastRequest = now - this.requestTimes[this.requestTimes.length - 2];
const minInterval = 1000 / rateLimit;
if (timeSinceLastRequest < minInterval) {
const delay = minInterval - timeSinceLastRequest;
await new Promise(resolve => setTimeout(resolve, delay));
// Update the recorded time after the delay
this.requestTimes[this.requestTimes.length - 1] = Date.now();
}
}
}
async extractPageInfo(url: string, depth: number, config: CrawlerConfig): Promise<any> {
// Find the mock page
const mockPage = this.mockWebsite.pages?.find((p: any) => p.url === url) || {
url,
depth,
links: []
};
// Simulate JavaScript content capture
let content = `<html><head><title>Page ${url}</title></head><body>Content`;
// Add dynamic content if JavaScript is enabled
if (this.mockWebsite.hasJavaScript && this.mockWebsite.dynamicElements?.length > 0) {
content += '<div class="dynamic-content-loaded">';
this.mockWebsite.dynamicElements.forEach((element: string) => {
content += `<span class="dynamic">${element}</span>`;
});
content += '</div>';
}
content += '</body></html>';
return {
url,
title: `Page ${url}`,
depth,
links: mockPage.links || [],
assets: [],
metadata: {},
content,
statusCode: 200,
loadTime: 100
};
}
async close(): Promise<void> {
// Mock close - nothing to clean up
}
}
@@ -0,0 +1,501 @@
import puppeteer, { Browser, Page } from 'puppeteer';
import { URL } from 'url';
import * as cheerio from 'cheerio';
import robotsParser from 'robots-parser';
import { logger } from '@cloneweb/shared';
import { CrawlerConfig, PageInfo, SiteMap, AssetInfo, PageMetadata, SiteStructure } from '../types/crawler';
export class IntelligentCrawler {
private browser: Browser | null = null;
private visitedUrls = new Set<string>();
private urlQueue: Array<{ url: string; depth: number }> = [];
private robotsCache = new Map<string, any>();
private lastRequestTime = 0;
async initialize(): Promise<void> {
this.browser = await puppeteer.launch({
headless: 'new',
args: [
'--no-sandbox',
'--disable-setuid-sandbox',
'--disable-dev-shm-usage',
'--disable-accelerated-2d-canvas',
'--no-first-run',
'--no-zygote',
'--single-process',
'--disable-gpu'
]
});
logger.info('Puppeteer browser initialized');
}
async crawlWebsite(startUrl: string, config: CrawlerConfig): Promise<SiteMap> {
const startTime = Date.now();
if (!this.browser) {
await this.initialize();
}
// Initialize crawl state
this.visitedUrls.clear();
this.urlQueue = [{ url: startUrl, depth: 0 }];
const pages: PageInfo[] = [];
const baseUrl = new URL(startUrl);
// Check robots.txt if required
if (config.respectRobots) {
await this.loadRobotsTxt(baseUrl.origin, config.userAgent);
}
// BFS crawling algorithm
while (this.urlQueue.length > 0 && pages.length < config.maxPages) {
const { url, depth } = this.urlQueue.shift()!;
if (this.visitedUrls.has(url) || depth > config.maxDepth) {
continue;
}
// Rate limiting
await this.respectRateLimit(config.rateLimit);
try {
const pageInfo = await this.extractPageInfo(url, depth, config);
if (pageInfo) {
pages.push(pageInfo);
this.visitedUrls.add(url);
// Add discovered links to queue
this.addLinksToQueue(pageInfo.links, depth + 1, baseUrl.origin);
logger.info(`Crawled page ${pages.length}/${config.maxPages}: ${url}`);
}
} catch (error) {
logger.error(`Failed to crawl ${url}:`, error);
}
}
const crawlTime = Date.now() - startTime;
return {
rootUrl: startUrl,
pages,
totalPages: pages.length,
crawlDepth: Math.max(...pages.map(p => p.depth)),
crawlTime,
structure: this.buildSiteStructure(pages, startUrl),
metadata: await this.extractSiteMetadata(baseUrl.origin)
};
}
async extractPageInfo(url: string, depth: number, config: CrawlerConfig): Promise<PageInfo | null> {
const page = await this.browser!.newPage();
try {
// Set viewport and user agent
await page.setViewport(config.viewport);
await page.setUserAgent(config.userAgent);
const startTime = Date.now();
// Navigate to page
const response = await page.goto(url, {
waitUntil: 'networkidle2',
timeout: config.timeout
});
if (!response) {
throw new Error('No response received');
}
const loadTime = Date.now() - startTime;
// Wait for additional content if specified
if (config.waitForSelector) {
await page.waitForSelector(config.waitForSelector, { timeout: 5000 }).catch(() => {});
}
if (config.waitForTimeout) {
await page.waitForTimeout(config.waitForTimeout);
}
// Execute JavaScript and wait for dynamic content
await this.executeJavaScriptAndWaitForContent(page);
// Extract page content after JavaScript execution
const content = await page.content();
const $ = cheerio.load(content);
// Extract metadata
const metadata = this.extractMetadata($);
// Extract links
const links = this.extractLinks($, url);
// Extract assets
const assets = this.extractAssets($, url);
// Get page title
const title = $('title').text().trim() || new URL(url).pathname;
// Capture screenshot if needed
let screenshot: string | undefined;
if (config.captureScreenshot) {
const screenshotBuffer = await page.screenshot({
fullPage: true,
type: 'png'
});
screenshot = screenshotBuffer.toString('base64');
}
return {
url,
title,
depth,
links,
assets,
metadata,
content,
statusCode: response.status(),
loadTime,
screenshot
};
} finally {
await page.close();
}
}
private async executeJavaScriptAndWaitForContent(page: Page): Promise<void> {
try {
// Wait for common dynamic content indicators
await Promise.race([
// Wait for React/Vue apps to mount
page.waitForFunction(() => {
return document.querySelector('[data-reactroot], #app, .vue-app, [ng-app]') !== null;
}, { timeout: 3000 }).catch(() => {}),
// Wait for AJAX requests to complete
page.waitForFunction(() => {
return (window as any).jQuery ? (window as any).jQuery.active === 0 : true;
}, { timeout: 3000 }).catch(() => {}),
// Wait for loading indicators to disappear
page.waitForFunction(() => {
const loaders = document.querySelectorAll('.loading, .spinner, .loader, [class*="loading"]');
return Array.from(loaders).every(loader =>
getComputedStyle(loader).display === 'none' ||
getComputedStyle(loader).visibility === 'hidden'
);
}, { timeout: 3000 }).catch(() => {}),
// Fallback timeout
page.waitForTimeout(2000)
]);
// Scroll to trigger lazy loading
await page.evaluate(() => {
return new Promise<void>((resolve) => {
let totalHeight = 0;
const distance = 100;
const timer = setInterval(() => {
const scrollHeight = document.body.scrollHeight;
window.scrollBy(0, distance);
totalHeight += distance;
if (totalHeight >= scrollHeight) {
clearInterval(timer);
window.scrollTo(0, 0); // Scroll back to top
setTimeout(resolve, 500); // Wait a bit more for content to load
}
}, 100);
});
});
} catch (error) {
logger.warn(`JavaScript execution failed for page: ${page.url()}`, error);
}
}
private async loadRobotsTxt(origin: string, userAgent: string): Promise<void> {
if (this.robotsCache.has(origin)) {
return;
}
try {
const robotsUrl = `${origin}/robots.txt`;
const page = await this.browser!.newPage();
const response = await page.goto(robotsUrl, { timeout: 10000 });
if (response && response.ok()) {
const robotsTxt = await page.content();
const robots = robotsParser(robotsUrl, robotsTxt);
this.robotsCache.set(origin, robots);
logger.info(`Loaded robots.txt for ${origin}`);
}
await page.close();
} catch (error) {
logger.warn(`Failed to load robots.txt for ${origin}:`, error);
this.robotsCache.set(origin, null);
}
}
private canCrawlUrl(url: string, userAgent: string): boolean {
const urlObj = new URL(url);
const robots = this.robotsCache.get(urlObj.origin);
if (!robots) {
return true; // No robots.txt or failed to load
}
return robots.isAllowed(url, userAgent);
}
private async respectRateLimit(rateLimit: number): Promise<void> {
const now = Date.now();
const timeSinceLastRequest = now - this.lastRequestTime;
const minInterval = 1000 / rateLimit; // Convert requests per second to milliseconds
if (timeSinceLastRequest < minInterval) {
const delay = minInterval - timeSinceLastRequest;
await new Promise(resolve => setTimeout(resolve, delay));
}
this.lastRequestTime = Date.now();
}
private extractMetadata($: cheerio.CheerioAPI): PageMetadata {
return {
description: $('meta[name="description"]').attr('content'),
keywords: $('meta[name="keywords"]').attr('content')?.split(',').map(k => k.trim()),
author: $('meta[name="author"]').attr('content'),
canonical: $('link[rel="canonical"]').attr('href'),
ogTitle: $('meta[property="og:title"]').attr('content'),
ogDescription: $('meta[property="og:description"]').attr('content'),
ogImage: $('meta[property="og:image"]').attr('content'),
twitterCard: $('meta[name="twitter:card"]').attr('content'),
robots: $('meta[name="robots"]').attr('content'),
viewport: $('meta[name="viewport"]').attr('content')
};
}
private extractLinks($: cheerio.CheerioAPI, baseUrl: string): string[] {
const links: string[] = [];
const base = new URL(baseUrl);
$('a[href]').each((_, element) => {
const href = $(element).attr('href');
if (href) {
try {
const absoluteUrl = new URL(href, baseUrl).href;
const urlObj = new URL(absoluteUrl);
// Only include same-origin links
if (urlObj.origin === base.origin) {
links.push(absoluteUrl);
}
} catch (error) {
// Invalid URL, skip
}
}
});
return [...new Set(links)]; // Remove duplicates
}
private extractAssets($: cheerio.CheerioAPI, baseUrl: string): AssetInfo[] {
const assets: AssetInfo[] = [];
// Images
$('img[src]').each((_, element) => {
const src = $(element).attr('src');
if (src) {
assets.push({
url: new URL(src, baseUrl).href,
type: 'image',
dependencies: []
});
}
});
// CSS files
$('link[rel="stylesheet"][href]').each((_, element) => {
const href = $(element).attr('href');
if (href) {
assets.push({
url: new URL(href, baseUrl).href,
type: 'css',
dependencies: []
});
}
});
// JavaScript files
$('script[src]').each((_, element) => {
const src = $(element).attr('src');
if (src) {
assets.push({
url: new URL(src, baseUrl).href,
type: 'js',
dependencies: []
});
}
});
// Fonts
$('link[rel="preload"][as="font"], link[rel="font"]').each((_, element) => {
const href = $(element).attr('href');
if (href) {
assets.push({
url: new URL(href, baseUrl).href,
type: 'font',
dependencies: []
});
}
});
return assets;
}
private addLinksToQueue(links: string[], depth: number, origin: string): void {
for (const link of links) {
if (!this.visitedUrls.has(link) && !this.urlQueue.some(item => item.url === link)) {
// Check robots.txt if available
if (this.robotsCache.has(origin)) {
const robots = this.robotsCache.get(origin);
if (robots && !robots.isAllowed(link, 'CloneWeb-Bot')) {
continue;
}
}
this.urlQueue.push({ url: link, depth });
}
}
}
private buildSiteStructure(pages: PageInfo[], rootUrl: string): SiteStructure {
const hierarchy = new Map<string, string[]>();
const allUrls = new Set(pages.map(p => p.url));
const externalLinks: string[] = [];
for (const page of pages) {
const internalLinks = page.links.filter(link => allUrls.has(link));
const external = page.links.filter(link => !allUrls.has(link));
hierarchy.set(page.url, internalLinks);
externalLinks.push(...external);
}
// Find orphan pages (pages with no incoming links except root)
const linkedPages = new Set<string>();
for (const links of hierarchy.values()) {
links.forEach(link => linkedPages.add(link));
}
const orphanPages = pages
.filter(p => p.url !== rootUrl && !linkedPages.has(p.url))
.map(p => p.url);
return {
hierarchy,
orphanPages,
externalLinks: [...new Set(externalLinks)]
};
}
generateSitemap(siteMap: SiteMap): string {
const { pages, rootUrl } = siteMap;
// Generate XML sitemap
let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
xml += '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n';
for (const page of pages) {
xml += ' <url>\n';
xml += ` <loc>${page.url}</loc>\n`;
xml += ` <lastmod>${new Date().toISOString().split('T')[0]}</lastmod>\n`;
// Set priority based on depth (root = 1.0, deeper pages = lower priority)
const priority = Math.max(0.1, 1.0 - (page.depth * 0.2));
xml += ` <priority>${priority.toFixed(1)}</priority>\n`;
// Set change frequency based on depth
const changefreq = page.depth === 0 ? 'daily' :
page.depth === 1 ? 'weekly' : 'monthly';
xml += ` <changefreq>${changefreq}</changefreq>\n`;
xml += ' </url>\n';
}
xml += '</urlset>';
return xml;
}
generateSiteHierarchy(siteMap: SiteMap): any {
const { pages, structure } = siteMap;
// Build hierarchical representation
const hierarchy: any = {
url: siteMap.rootUrl,
title: pages.find(p => p.url === siteMap.rootUrl)?.title || 'Root',
depth: 0,
children: []
};
const buildTree = (parentUrl: string, currentDepth: number): any[] => {
const children = structure.hierarchy.get(parentUrl) || [];
return children.map(childUrl => {
const childPage = pages.find(p => p.url === childUrl);
if (!childPage) return null;
return {
url: childUrl,
title: childPage.title,
depth: childPage.depth,
children: buildTree(childUrl, childPage.depth)
};
}).filter(Boolean);
};
hierarchy.children = buildTree(siteMap.rootUrl, 0);
return {
hierarchy,
orphanPages: structure.orphanPages.map(url => {
const page = pages.find(p => p.url === url);
return {
url,
title: page?.title || 'Unknown',
depth: page?.depth || 0
};
}),
externalLinks: structure.externalLinks,
statistics: {
totalPages: pages.length,
maxDepth: Math.max(...pages.map(p => p.depth)),
avgLinksPerPage: pages.reduce((sum, p) => sum + p.links.length, 0) / pages.length,
totalAssets: pages.reduce((sum, p) => sum + p.assets.length, 0)
}
};
}
private async extractSiteMetadata(origin: string): Promise<any> {
// This would extract site-level metadata like robots.txt, sitemap.xml, etc.
return {
domain: new URL(origin).hostname,
robotsTxt: this.robotsCache.get(origin)?.toString(),
language: 'en', // Could be detected from pages
charset: 'utf-8'
};
}
async close(): Promise<void> {
if (this.browser) {
await this.browser.close();
this.browser = null;
}
}
}
+38
View File
@@ -0,0 +1,38 @@
import express from 'express';
import { createBullBoard } from '@bull-board/api';
import { BullAdapter } from '@bull-board/api/bullAdapter';
import { ExpressAdapter } from '@bull-board/express';
import { crawlerQueue } from './queues/crawlerQueue';
import { crawlerRoutes } from './routes/crawlerRoutes';
import { logger } from '@cloneweb/shared';
const app = express();
const PORT = process.env.PORT || 3001;
// Middleware
app.use(express.json());
// Bull Board for queue monitoring
const serverAdapter = new ExpressAdapter();
serverAdapter.setBasePath('/admin/queues');
const { addQueue } = createBullBoard({
queues: [new BullAdapter(crawlerQueue)],
serverAdapter: serverAdapter,
});
app.use('/admin/queues', serverAdapter.getRouter());
// Routes
app.use('/api/crawler', crawlerRoutes);
// Health check
app.get('/health', (req, res) => {
res.json({ status: 'ok', service: 'crawler-service' });
});
app.listen(PORT, () => {
logger.info(`Crawler service running on port ${PORT}`);
});
export default app;
@@ -0,0 +1,92 @@
import Bull from 'bull';
import Redis from 'ioredis';
import { IntelligentCrawler } from '../core/IntelligentCrawler';
import { CrawlJob, CrawlerConfig } from '../types/crawler';
import { logger } from '@cloneweb/shared';
const redis = new Redis(process.env.REDIS_URL || 'redis://localhost:6379');
export const crawlerQueue = new Bull('crawler', {
redis: {
port: 6379,
host: process.env.REDIS_HOST || 'localhost',
},
defaultJobOptions: {
removeOnComplete: 10,
removeOnFail: 5,
attempts: 3,
backoff: {
type: 'exponential',
delay: 2000,
},
},
});
// Job processor
crawlerQueue.process('crawl-website', async (job) => {
const { projectId, startUrl, config }: { projectId: string; startUrl: string; config: CrawlerConfig } = job.data;
logger.info(`Starting crawl job for project ${projectId}: ${startUrl}`);
const crawler = new IntelligentCrawler();
try {
// Update job progress
await job.progress(10);
// Initialize crawler
await crawler.initialize();
await job.progress(20);
// Start crawling with progress updates
const result = await crawler.crawlWebsite(startUrl, {
...config,
// Add progress callback if needed
});
await job.progress(90);
// Store result in database
// TODO: Implement database storage
await job.progress(100);
logger.info(`Completed crawl job for project ${projectId}: ${result.totalPages} pages crawled`);
return {
projectId,
siteMap: result,
status: 'completed'
};
} catch (error) {
logger.error(`Crawl job failed for project ${projectId}:`, error);
throw error;
} finally {
await crawler.close();
}
});
// Job event handlers
crawlerQueue.on('completed', (job, result) => {
logger.info(`Job ${job.id} completed successfully`);
});
crawlerQueue.on('failed', (job, err) => {
logger.error(`Job ${job.id} failed:`, err);
});
crawlerQueue.on('stalled', (job) => {
logger.warn(`Job ${job.id} stalled`);
});
export const addCrawlJob = async (projectId: string, startUrl: string, config: CrawlerConfig): Promise<Bull.Job> => {
return crawlerQueue.add('crawl-website', {
projectId,
startUrl,
config
}, {
priority: 1,
delay: 0,
});
};
@@ -0,0 +1,211 @@
import { Router } from 'express';
import { addCrawlJob, crawlerQueue } from '../queues/crawlerQueue';
import { CrawlerConfig } from '../types/crawler';
import { logger } from '@cloneweb/shared';
export const crawlerRoutes = Router();
// Start a new crawl job
crawlerRoutes.post('/crawl', async (req, res) => {
try {
const { projectId, startUrl, config } = req.body;
// Validate required fields
if (!projectId || !startUrl) {
return res.status(400).json({
error: 'Missing required fields: projectId, startUrl'
});
}
// Default crawler configuration
const defaultConfig: CrawlerConfig = {
maxDepth: 3,
maxPages: 100,
respectRobots: true,
rateLimit: 2, // requests per second
userAgent: 'CloneWeb-Bot/1.0',
timeout: 30000,
viewport: {
width: 1920,
height: 1080
},
waitForTimeout: 2000
};
const crawlerConfig: CrawlerConfig = {
...defaultConfig,
...config
};
// Add job to queue
const job = await addCrawlJob(projectId, startUrl, crawlerConfig);
logger.info(`Created crawl job ${job.id} for project ${projectId}`);
res.json({
jobId: job.id,
projectId,
startUrl,
config: crawlerConfig,
status: 'queued'
});
} catch (error) {
logger.error('Failed to create crawl job:', error);
res.status(500).json({
error: 'Failed to create crawl job',
message: error instanceof Error ? error.message : 'Unknown error'
});
}
});
// Get job status
crawlerRoutes.get('/job/:jobId', async (req, res) => {
try {
const { jobId } = req.params;
const job = await crawlerQueue.getJob(jobId);
if (!job) {
return res.status(404).json({
error: 'Job not found'
});
}
const state = await job.getState();
const progress = job.progress();
res.json({
jobId: job.id,
state,
progress,
data: job.data,
result: job.returnvalue,
failedReason: job.failedReason,
createdAt: new Date(job.timestamp),
processedAt: job.processedOn ? new Date(job.processedOn) : null,
finishedAt: job.finishedOn ? new Date(job.finishedOn) : null
});
} catch (error) {
logger.error('Failed to get job status:', error);
res.status(500).json({
error: 'Failed to get job status',
message: error instanceof Error ? error.message : 'Unknown error'
});
}
});
// Get all jobs for a project
crawlerRoutes.get('/project/:projectId/jobs', async (req, res) => {
try {
const { projectId } = req.params;
const { status, limit = 10, offset = 0 } = req.query;
// Get jobs from queue
let jobs;
if (status === 'waiting') {
jobs = await crawlerQueue.getWaiting(Number(offset), Number(offset) + Number(limit) - 1);
} else if (status === 'active') {
jobs = await crawlerQueue.getActive(Number(offset), Number(offset) + Number(limit) - 1);
} else if (status === 'completed') {
jobs = await crawlerQueue.getCompleted(Number(offset), Number(offset) + Number(limit) - 1);
} else if (status === 'failed') {
jobs = await crawlerQueue.getFailed(Number(offset), Number(offset) + Number(limit) - 1);
} else {
// Get all jobs
const [waiting, active, completed, failed] = await Promise.all([
crawlerQueue.getWaiting(0, Number(limit) - 1),
crawlerQueue.getActive(0, Number(limit) - 1),
crawlerQueue.getCompleted(0, Number(limit) - 1),
crawlerQueue.getFailed(0, Number(limit) - 1)
]);
jobs = [...waiting, ...active, ...completed, ...failed];
}
// Filter by project ID
const projectJobs = jobs.filter(job => job.data.projectId === projectId);
const jobsWithStatus = await Promise.all(
projectJobs.map(async (job) => ({
jobId: job.id,
state: await job.getState(),
progress: job.progress(),
data: job.data,
createdAt: new Date(job.timestamp),
processedAt: job.processedOn ? new Date(job.processedOn) : null,
finishedAt: job.finishedOn ? new Date(job.finishedOn) : null
}))
);
res.json({
jobs: jobsWithStatus,
total: projectJobs.length,
limit: Number(limit),
offset: Number(offset)
});
} catch (error) {
logger.error('Failed to get project jobs:', error);
res.status(500).json({
error: 'Failed to get project jobs',
message: error instanceof Error ? error.message : 'Unknown error'
});
}
});
// Cancel a job
crawlerRoutes.delete('/job/:jobId', async (req, res) => {
try {
const { jobId } = req.params;
const job = await crawlerQueue.getJob(jobId);
if (!job) {
return res.status(404).json({
error: 'Job not found'
});
}
await job.remove();
logger.info(`Cancelled crawl job ${jobId}`);
res.json({
message: 'Job cancelled successfully',
jobId
});
} catch (error) {
logger.error('Failed to cancel job:', error);
res.status(500).json({
error: 'Failed to cancel job',
message: error instanceof Error ? error.message : 'Unknown error'
});
}
});
// Get queue statistics
crawlerRoutes.get('/stats', async (req, res) => {
try {
const [waiting, active, completed, failed] = await Promise.all([
crawlerQueue.getWaiting(),
crawlerQueue.getActive(),
crawlerQueue.getCompleted(),
crawlerQueue.getFailed()
]);
res.json({
waiting: waiting.length,
active: active.length,
completed: completed.length,
failed: failed.length,
total: waiting.length + active.length + completed.length + failed.length
});
} catch (error) {
logger.error('Failed to get queue stats:', error);
res.status(500).json({
error: 'Failed to get queue stats',
message: error instanceof Error ? error.message : 'Unknown error'
});
}
});
+87
View File
@@ -0,0 +1,87 @@
export interface CrawlerConfig {
maxDepth: number;
maxPages: number;
respectRobots: boolean;
rateLimit: number;
userAgent: string;
timeout: number;
viewport: {
width: number;
height: number;
};
waitForSelector?: string;
waitForTimeout?: number;
captureScreenshot?: boolean;
}
export interface PageInfo {
url: string;
title: string;
depth: number;
links: string[];
assets: AssetInfo[];
metadata: PageMetadata;
content: string;
statusCode: number;
loadTime: number;
screenshot?: string;
}
export interface AssetInfo {
url: string;
type: 'image' | 'css' | 'js' | 'font' | 'media' | 'other';
size?: number;
hash?: string;
dependencies: string[];
}
export interface PageMetadata {
description?: string;
keywords?: string[];
author?: string;
canonical?: string;
ogTitle?: string;
ogDescription?: string;
ogImage?: string;
twitterCard?: string;
robots?: string;
viewport?: string;
}
export interface SiteMap {
rootUrl: string;
pages: PageInfo[];
totalPages: number;
crawlDepth: number;
crawlTime: number;
structure: SiteStructure;
metadata: SiteMetadata;
}
export interface SiteStructure {
hierarchy: Map<string, string[]>;
orphanPages: string[];
externalLinks: string[];
}
export interface SiteMetadata {
domain: string;
robotsTxt?: string;
sitemapXml?: string;
favicon?: string;
language?: string;
charset?: string;
}
export interface CrawlJob {
id: string;
projectId: string;
startUrl: string;
config: CrawlerConfig;
status: 'pending' | 'running' | 'completed' | 'failed';
progress: number;
createdAt: Date;
updatedAt: Date;
result?: SiteMap;
error?: string;
}
+9
View File
@@ -0,0 +1,9 @@
{
"extends": "../../tsconfig.json",
"compilerOptions": {
"outDir": "./dist",
"rootDir": "./src"
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist", "**/*.test.ts"]
}