npm - recker - Versions diffs - 1.0.27 → 1.0.28-next.3bf98c7 - Mend

recker 1.0.27 → 1.0.28-next.3bf98c7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (72) hide show

package/dist/browser/scrape/extractors.js +2 -1
package/dist/browser/scrape/types.d.ts +2 -1
package/dist/cli/index.js +142 -3
package/dist/cli/tui/shell.d.ts +2 -0
package/dist/cli/tui/shell.js +492 -1
package/dist/index.d.ts +1 -0
package/dist/index.js +1 -0
package/dist/scrape/extractors.js +2 -1
package/dist/scrape/index.d.ts +2 -0
package/dist/scrape/index.js +1 -0
package/dist/scrape/spider.d.ts +61 -0
package/dist/scrape/spider.js +250 -0
package/dist/scrape/types.d.ts +2 -1
package/dist/seo/analyzer.d.ts +42 -0
package/dist/seo/analyzer.js +742 -0
package/dist/seo/index.d.ts +7 -0
package/dist/seo/index.js +3 -0
package/dist/seo/rules/accessibility.d.ts +2 -0
package/dist/seo/rules/accessibility.js +694 -0
package/dist/seo/rules/best-practices.d.ts +2 -0
package/dist/seo/rules/best-practices.js +188 -0
package/dist/seo/rules/content.d.ts +2 -0
package/dist/seo/rules/content.js +236 -0
package/dist/seo/rules/crawl.d.ts +2 -0
package/dist/seo/rules/crawl.js +307 -0
package/dist/seo/rules/cwv.d.ts +2 -0
package/dist/seo/rules/cwv.js +337 -0
package/dist/seo/rules/ecommerce.d.ts +2 -0
package/dist/seo/rules/ecommerce.js +252 -0
package/dist/seo/rules/i18n.d.ts +2 -0
package/dist/seo/rules/i18n.js +222 -0
package/dist/seo/rules/images.d.ts +2 -0
package/dist/seo/rules/images.js +180 -0
package/dist/seo/rules/index.d.ts +52 -0
package/dist/seo/rules/index.js +143 -0
package/dist/seo/rules/internal-linking.d.ts +2 -0
package/dist/seo/rules/internal-linking.js +375 -0
package/dist/seo/rules/links.d.ts +2 -0
package/dist/seo/rules/links.js +150 -0
package/dist/seo/rules/local.d.ts +2 -0
package/dist/seo/rules/local.js +265 -0
package/dist/seo/rules/meta.d.ts +2 -0
package/dist/seo/rules/meta.js +523 -0
package/dist/seo/rules/mobile.d.ts +2 -0
package/dist/seo/rules/mobile.js +71 -0
package/dist/seo/rules/performance.d.ts +2 -0
package/dist/seo/rules/performance.js +246 -0
package/dist/seo/rules/pwa.d.ts +2 -0
package/dist/seo/rules/pwa.js +302 -0
package/dist/seo/rules/readability.d.ts +2 -0
package/dist/seo/rules/readability.js +255 -0
package/dist/seo/rules/schema.d.ts +2 -0
package/dist/seo/rules/schema.js +54 -0
package/dist/seo/rules/security.d.ts +2 -0
package/dist/seo/rules/security.js +525 -0
package/dist/seo/rules/social.d.ts +2 -0
package/dist/seo/rules/social.js +373 -0
package/dist/seo/rules/structural.d.ts +2 -0
package/dist/seo/rules/structural.js +155 -0
package/dist/seo/rules/technical.d.ts +2 -0
package/dist/seo/rules/technical.js +223 -0
package/dist/seo/rules/thresholds.d.ts +196 -0
package/dist/seo/rules/thresholds.js +118 -0
package/dist/seo/rules/types.d.ts +346 -0
package/dist/seo/rules/types.js +11 -0
package/dist/seo/seo-spider.d.ts +47 -0
package/dist/seo/seo-spider.js +362 -0
package/dist/seo/types.d.ts +184 -0
package/dist/seo/types.js +1 -0
package/dist/utils/columns.d.ts +14 -0
package/dist/utils/columns.js +69 -0
package/package.json +1 -1

package/dist/seo/rules/technical.js ADDED Viewed

@@ -0,0 +1,223 @@
+import { createResult } from './types.js';
+import { SEO_THRESHOLDS } from './thresholds.js';
+export const technicalRules = [
+    {
+        id: 'canonical-exists',
+        name: 'Canonical URL',
+        category: 'technical',
+        severity: 'warning',
+        description: 'Page should have a canonical URL',
+        check: (ctx) => {
+            if (!ctx.hasCanonical) {
+                return createResult({ id: 'canonical-exists', name: 'Canonical URL', category: 'technical', severity: 'warning' }, 'warn', 'No canonical URL defined', { recommendation: 'Add <link rel="canonical" href="..."> to prevent duplicate content' });
+            }
+            return createResult({ id: 'canonical-exists', name: 'Canonical URL', category: 'technical', severity: 'warning' }, 'pass', 'Canonical URL is defined', { value: ctx.canonicalUrl });
+        },
+    },
+    {
+        id: 'lang-exists',
+        name: 'Language',
+        category: 'technical',
+        severity: 'warning',
+        description: 'HTML should have lang attribute',
+        check: (ctx) => {
+            if (!ctx.hasLang) {
+                return createResult({ id: 'lang-exists', name: 'Language', category: 'technical', severity: 'warning' }, 'warn', 'Missing lang attribute on <html>', { recommendation: 'Add lang attribute: <html lang="en">' });
+            }
+            return createResult({ id: 'lang-exists', name: 'Language', category: 'technical', severity: 'warning' }, 'pass', `Language attribute set (${ctx.langValue})`);
+        },
+    },
+    {
+        id: 'charset-exists',
+        name: 'Charset',
+        category: 'technical',
+        severity: 'warning',
+        description: 'Page should declare character encoding',
+        check: (ctx) => {
+            if (!ctx.hasCharset) {
+                return createResult({ id: 'charset-exists', name: 'Charset', category: 'technical', severity: 'warning' }, 'warn', 'Missing charset declaration', { recommendation: 'Add <meta charset="UTF-8"> in <head>' });
+            }
+            if (ctx.charset && ctx.charset.toLowerCase() !== 'utf-8') {
+                return createResult({ id: 'charset-exists', name: 'Charset', category: 'technical', severity: 'warning' }, 'warn', `Non-UTF-8 charset: ${ctx.charset}`, { recommendation: 'Use UTF-8 charset for best compatibility' });
+            }
+            return createResult({ id: 'charset-exists', name: 'Charset', category: 'technical', severity: 'warning' }, 'pass', 'UTF-8 charset declared');
+        },
+    },
+    {
+        id: 'robots-noindex',
+        name: 'Robots Noindex',
+        category: 'technical',
+        severity: 'warning',
+        description: 'Check if page is set to noindex',
+        check: (ctx) => {
+            if (!ctx.metaRobots || ctx.metaRobots.length === 0)
+                return null;
+            if (ctx.metaRobots.includes('noindex')) {
+                return createResult({ id: 'robots-noindex', name: 'Robots', category: 'technical', severity: 'warning' }, 'warn', 'Page is set to noindex', { value: ctx.metaRobots.join(', '), recommendation: 'Remove noindex if you want the page to be indexed' });
+            }
+            return createResult({ id: 'robots-noindex', name: 'Robots', category: 'technical', severity: 'info' }, 'info', `Robots meta: ${ctx.metaRobots.join(', ')}`);
+        },
+    },
+    {
+        id: 'favicon-exists',
+        name: 'Favicon',
+        category: 'technical',
+        severity: 'warning',
+        description: 'Page should have a favicon defined',
+        check: (ctx) => {
+            if (!ctx.hasFavicon) {
+                return createResult({ id: 'favicon-exists', name: 'Favicon', category: 'technical', severity: 'warning' }, 'warn', 'No favicon defined', { recommendation: 'Add <link rel="icon" href="/favicon.ico"> for browser tab icon' });
+            }
+            return createResult({ id: 'favicon-exists', name: 'Favicon', category: 'technical', severity: 'warning' }, 'pass', 'Favicon is defined', { value: ctx.faviconUrl });
+        },
+    },
+    {
+        id: 'url-length',
+        name: 'URL Length',
+        category: 'technical',
+        severity: 'info',
+        description: 'URL should be under 75 characters',
+        check: (ctx) => {
+            if (!ctx.url)
+                return null;
+            const len = ctx.urlLength ?? ctx.url.length;
+            const max = SEO_THRESHOLDS.url.maxLength;
+            if (len > max) {
+                return createResult({ id: 'url-length', name: 'URL Length', category: 'technical', severity: 'info' }, 'info', `URL is long (${len} chars)`, { value: len, recommendation: `Keep URLs under ${max} characters when possible` });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'url-lowercase',
+        name: 'URL Lowercase',
+        category: 'technical',
+        severity: 'warning',
+        description: 'URLs should be lowercase for consistency',
+        check: (ctx) => {
+            if (ctx.urlHasUppercase) {
+                return createResult({ id: 'url-lowercase', name: 'URL Lowercase', category: 'technical', severity: 'warning' }, 'warn', 'URL contains uppercase characters', { recommendation: 'Use lowercase URLs for better SEO consistency' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'url-clean',
+        name: 'URL Clean',
+        category: 'technical',
+        severity: 'warning',
+        description: 'URLs should not contain special characters or accents',
+        check: (ctx) => {
+            if (ctx.urlHasAccents || ctx.urlHasSpecialChars) {
+                const issues = [];
+                if (ctx.urlHasAccents)
+                    issues.push('accents');
+                if (ctx.urlHasSpecialChars)
+                    issues.push('special characters');
+                return createResult({ id: 'url-clean', name: 'URL Clean', category: 'technical', severity: 'warning' }, 'warn', `URL contains ${issues.join(' and ')}`, { recommendation: 'Use clean URLs without accents or special characters' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'url-no-params',
+        name: 'URL Parameters',
+        category: 'technical',
+        severity: 'warning',
+        description: 'URLs should not contain query parameters',
+        check: (ctx) => {
+            if (!ctx.url)
+                return null;
+            try {
+                const urlObj = new URL(ctx.url);
+                if (urlObj.search && urlObj.search.length > 1) {
+                    return createResult({ id: 'url-no-params', name: 'URL Parameters', category: 'technical', severity: 'warning' }, 'warn', 'URL contains query parameters', { value: urlObj.search, recommendation: 'Use clean URLs (rewritten paths) without query parameters' });
+                }
+            }
+            catch {
+            }
+            return null;
+        },
+    },
+    {
+        id: 'technical-meta-robots-directives',
+        name: 'Meta Robots Directives',
+        category: 'technical',
+        severity: 'warning',
+        description: 'Check for restrictive meta robots directives like noindex, nofollow, noarchive etc.',
+        check: (ctx) => {
+            if (!ctx.metaRobots || ctx.metaRobots.length === 0)
+                return null;
+            const restrictiveDirectives = ['noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex'];
+            const foundRestrictive = ctx.metaRobots.filter(directive => restrictiveDirectives.includes(directive));
+            if (foundRestrictive.length > 0) {
+                return createResult({ id: 'technical-meta-robots-directives', name: 'Meta Robots Directives', category: 'technical', severity: 'warning' }, 'warn', `Restrictive meta robots directives found: ${foundRestrictive.join(', ')}`, { recommendation: 'Ensure these directives are intentional to prevent unintended blocking of indexing or crawling.' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'technical-x-robots-tag',
+        name: 'X-Robots-Tag Header',
+        category: 'technical',
+        severity: 'info',
+        description: 'X-Robots-Tag header can be used to control indexing, especially for non-HTML content.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const xRobotsTag = ctx.responseHeaders['x-robots-tag'] || ctx.responseHeaders['X-Robots-Tag'];
+            if (xRobotsTag) {
+                return createResult({ id: 'technical-x-robots-tag', name: 'X-Robots-Tag Header', category: 'technical', severity: 'info' }, 'info', `X-Robots-Tag header found: ${xRobotsTag}`, { recommendation: 'Ensure X-Robots-Tag directives (e.g., noindex) are intentional.' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'technical-trust-signals',
+        name: 'Trust Signals (Links)',
+        category: 'technical',
+        severity: 'info',
+        description: 'Presence of links to "About", "Contact", "Privacy Policy", "Terms of Service" pages builds trust.',
+        check: (ctx) => {
+            const missingSignals = [];
+            if (!ctx.hasAboutPageLink)
+                missingSignals.push('About Page');
+            if (!ctx.hasContactPageLink)
+                missingSignals.push('Contact Page');
+            if (!ctx.hasPrivacyPolicyLink)
+                missingSignals.push('Privacy Policy');
+            if (!ctx.hasTermsOfServiceLink)
+                missingSignals.push('Terms of Service');
+            if (missingSignals.length > 0) {
+                return createResult({ id: 'technical-trust-signals', name: 'Trust Signals (Links)', category: 'technical', severity: 'info' }, 'info', `Missing links to key trust pages: ${missingSignals.join(', ')}`, { recommendation: 'Add clear links to "About Us", "Contact", "Privacy Policy", and "Terms of Service" pages to build user and search engine trust.' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'technical-text-html-ratio',
+        name: 'Text/HTML Ratio',
+        category: 'technical',
+        severity: 'info',
+        description: 'A higher text to HTML ratio indicates more content relative to code, which is good for SEO.',
+        check: (ctx) => {
+            if (ctx.textHtmlRatio === undefined)
+                return null;
+            const threshold = 15;
+            if (ctx.textHtmlRatio < threshold) {
+                return createResult({ id: 'technical-text-html-ratio', name: 'Text/HTML Ratio', category: 'technical', severity: 'info' }, 'warn', `Low Text/HTML ratio: ${ctx.textHtmlRatio.toFixed(2)}% (target > ${threshold}%)`, { recommendation: 'Increase text content relative to HTML code. Reduce unnecessary markup, or add more textual content.' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'technical-robots-txt-hint',
+        name: 'Robots.txt Hint',
+        category: 'technical',
+        severity: 'info',
+        description: 'Ensure a robots.txt file exists at the root of the domain to guide crawlers.',
+        check: (ctx) => {
+            return createResult({ id: 'technical-robots-txt-hint', name: 'Robots.txt Hint', category: 'technical', severity: 'info' }, 'info', 'Robots.txt existence cannot be verified from HTML alone.', { recommendation: 'Ensure a valid `robots.txt` file is present at your domain root (e.g., `https://example.com/robots.txt`) to guide search engine crawlers and define your sitemap location.' });
+        },
+    },
+];

package/dist/seo/rules/thresholds.d.ts ADDED Viewed

@@ -0,0 +1,196 @@
+export declare const SEO_THRESHOLDS: {
+    readonly title: {
+        readonly min: 30;
+        readonly ideal: {
+            readonly min: 50;
+            readonly max: 60;
+        };
+        readonly max: 70;
+    };
+    readonly metaDescription: {
+        readonly min: 70;
+        readonly ideal: {
+            readonly min: 120;
+            readonly max: 155;
+        };
+        readonly max: 160;
+    };
+    readonly og: {
+        readonly title: {
+            readonly min: 30;
+            readonly ideal: {
+                readonly min: 40;
+                readonly max: 60;
+            };
+            readonly max: 90;
+        };
+        readonly description: {
+            readonly min: 55;
+            readonly ideal: {
+                readonly min: 110;
+                readonly max: 155;
+            };
+            readonly max: 200;
+        };
+        readonly image: {
+            readonly dimensions: {
+                readonly width: 1200;
+                readonly height: 630;
+            };
+            readonly minDimensions: {
+                readonly width: 600;
+                readonly height: 315;
+            };
+            readonly ratio: 1.91;
+            readonly maxSizeKb: 300;
+            readonly maxSizeKbAbsolute: 1000;
+            readonly formats: readonly ["jpg", "jpeg", "png", "webp"];
+        };
+        readonly meta: {
+            readonly maxUrlLength: 2000;
+            readonly maxDescriptionEmojis: 2;
+            readonly maxCapsPercentage: 30;
+        };
+        readonly fallbacks: {
+            readonly requireMetaTitle: true;
+            readonly requireMetaDescription: true;
+        };
+    };
+    readonly twitter: {
+        readonly title: {
+            readonly min: 30;
+            readonly ideal: {
+                readonly min: 40;
+                readonly max: 55;
+            };
+            readonly max: 70;
+        };
+        readonly description: {
+            readonly min: 70;
+            readonly ideal: {
+                readonly min: 125;
+                readonly max: 200;
+            };
+            readonly max: 200;
+        };
+        readonly image: {
+            readonly summary: {
+                readonly min: {
+                    readonly width: 144;
+                    readonly height: 144;
+                };
+                readonly max: {
+                    readonly width: 4096;
+                    readonly height: 4096;
+                };
+            };
+            readonly summaryLarge: {
+                readonly min: {
+                    readonly width: 300;
+                    readonly height: 157;
+                };
+                readonly max: {
+                    readonly width: 4096;
+                    readonly height: 4096;
+                };
+            };
+            readonly maxSizeMb: 5;
+        };
+    };
+    readonly headings: {
+        readonly h1: {
+            readonly count: 1;
+            readonly minLength: 20;
+            readonly maxLength: 70;
+        };
+        readonly h2: {
+            readonly min: 2;
+            readonly max: 8;
+        };
+    };
+    readonly images: {
+        readonly alt: {
+            readonly minLength: 10;
+            readonly idealLength: {
+                readonly min: 80;
+                readonly max: 120;
+            };
+            readonly maxLength: 150;
+        };
+        readonly maxSizeKb: 100;
+        readonly maxSizeKbAcceptable: 500;
+    };
+    readonly links: {
+        readonly minInternal: 3;
+        readonly maxExternal: 100;
+        readonly genericTexts: readonly ["clique aqui", "click here", "saiba mais", "learn more", "read more", "leia mais", "here", "aqui"];
+    };
+    readonly content: {
+        readonly minWordsSimple: 150;
+        readonly minWordsRanking: 300;
+        readonly minWordsAuthority: 800;
+        readonly idealWordsAuthority: 2500;
+        readonly maxWordsPerSentence: 25;
+        readonly maxWordsPerParagraph: 90;
+        readonly minWordsPerParagraph: 40;
+        readonly minWordsPerH2Section: 150;
+        readonly minWordsPerH3Section: 50;
+        readonly imageWordRatio: {
+            readonly min: 200;
+            readonly max: 300;
+        };
+        readonly keywordDensity: {
+            readonly min: 0.8;
+            readonly max: 2;
+        };
+        readonly redundancyTolerance: 3;
+    };
+    readonly url: {
+        readonly maxLength: 75;
+        readonly maxLengthAbsolute: 2048;
+    };
+    readonly mobile: {
+        readonly minFontSize: 16;
+        readonly minTouchTarget: 48;
+    };
+    readonly thinContent: {
+        readonly minWords: 150;
+        readonly veryThinWords: 100;
+    };
+    readonly timing: {
+        readonly ttfb: {
+            readonly good: 200;
+            readonly needsImprovement: 500;
+            readonly poor: 600;
+        };
+        readonly total: {
+            readonly good: 1000;
+            readonly needsImprovement: 2500;
+            readonly poor: 4000;
+        };
+        readonly dnsLookup: {
+            readonly good: 50;
+            readonly poor: 200;
+        };
+        readonly tcpConnect: {
+            readonly good: 100;
+            readonly poor: 300;
+        };
+        readonly tlsHandshake: {
+            readonly good: 100;
+            readonly poor: 300;
+        };
+    };
+    readonly responseSize: {
+        readonly html: {
+            readonly good: number;
+            readonly warning: number;
+            readonly poor: number;
+        };
+        readonly total: {
+            readonly good: number;
+            readonly warning: number;
+            readonly poor: number;
+        };
+    };
+};

package/dist/seo/rules/thresholds.js ADDED Viewed

@@ -0,0 +1,118 @@
+export const SEO_THRESHOLDS = {
+    title: {
+        min: 30,
+        ideal: { min: 50, max: 60 },
+        max: 70,
+    },
+    metaDescription: {
+        min: 70,
+        ideal: { min: 120, max: 155 },
+        max: 160,
+    },
+    og: {
+        title: { min: 30, ideal: { min: 40, max: 60 }, max: 90 },
+        description: { min: 55, ideal: { min: 110, max: 155 }, max: 200 },
+        image: {
+            dimensions: { width: 1200, height: 630 },
+            minDimensions: { width: 600, height: 315 },
+            ratio: 1.91,
+            maxSizeKb: 300,
+            maxSizeKbAbsolute: 1000,
+            formats: ['jpg', 'jpeg', 'png', 'webp'],
+        },
+        meta: {
+            maxUrlLength: 2000,
+            maxDescriptionEmojis: 2,
+            maxCapsPercentage: 30,
+        },
+        fallbacks: {
+            requireMetaTitle: true,
+            requireMetaDescription: true,
+        },
+    },
+    twitter: {
+        title: { min: 30, ideal: { min: 40, max: 55 }, max: 70 },
+        description: { min: 70, ideal: { min: 125, max: 200 }, max: 200 },
+        image: {
+            summary: { min: { width: 144, height: 144 }, max: { width: 4096, height: 4096 } },
+            summaryLarge: { min: { width: 300, height: 157 }, max: { width: 4096, height: 4096 } },
+            maxSizeMb: 5,
+        },
+    },
+    headings: {
+        h1: { count: 1, minLength: 20, maxLength: 70 },
+        h2: { min: 2, max: 8 },
+    },
+    images: {
+        alt: { minLength: 10, idealLength: { min: 80, max: 120 }, maxLength: 150 },
+        maxSizeKb: 100,
+        maxSizeKbAcceptable: 500,
+    },
+    links: {
+        minInternal: 3,
+        maxExternal: 100,
+        genericTexts: ['clique aqui', 'click here', 'saiba mais', 'learn more', 'read more', 'leia mais', 'here', 'aqui'],
+    },
+    content: {
+        minWordsSimple: 150,
+        minWordsRanking: 300,
+        minWordsAuthority: 800,
+        idealWordsAuthority: 2500,
+        maxWordsPerSentence: 25,
+        maxWordsPerParagraph: 90,
+        minWordsPerParagraph: 40,
+        minWordsPerH2Section: 150,
+        minWordsPerH3Section: 50,
+        imageWordRatio: { min: 200, max: 300 },
+        keywordDensity: { min: 0.8, max: 2.0 },
+        redundancyTolerance: 3,
+    },
+    url: {
+        maxLength: 75,
+        maxLengthAbsolute: 2048,
+    },
+    mobile: {
+        minFontSize: 16,
+        minTouchTarget: 48,
+    },
+    thinContent: {
+        minWords: 150,
+        veryThinWords: 100,
+    },
+    timing: {
+        ttfb: {
+            good: 200,
+            needsImprovement: 500,
+            poor: 600,
+        },
+        total: {
+            good: 1000,
+            needsImprovement: 2500,
+            poor: 4000,
+        },
+        dnsLookup: {
+            good: 50,
+            poor: 200,
+        },
+        tcpConnect: {
+            good: 100,
+            poor: 300,
+        },
+        tlsHandshake: {
+            good: 100,
+            poor: 300,
+        },
+    },
+    responseSize: {
+        html: {
+            good: 100 * 1024,
+            warning: 500 * 1024,
+            poor: 1024 * 1024,
+        },
+        total: {
+            good: 1024 * 1024,
+            warning: 3 * 1024 * 1024,
+            poor: 5 * 1024 * 1024,
+        },
+    },
+};