recker 1.0.27 → 1.0.28-next.c61382b

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

@@ -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

@@ -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,
+        },
+    },
+};

package/dist/seo/rules/types.d.ts

@@ -0,0 +1,286 @@
+import type { SeoStatus } from '../types.js';
+import type { ExtractedLink } from '../../scrape/types.js';
+export type RuleSeverity = 'error' | 'warning' | 'info';
+export type RuleCategory = 'title' | 'meta' | 'og' | 'twitter' | 'headings' | 'images' | 'links' | 'content' | 'technical' | 'security' | 'mobile' | 'structured-data' | 'performance' | 'accessibility';
+export interface RuleContext {
+    title?: string;
+    titleLength?: number;
+    metaDescription?: string;
+    metaDescriptionLength?: number;
+    metaKeywords?: string[];
+    metaRobots?: string[];
+    ogTitle?: string;
+    ogDescription?: string;
+    ogImage?: string;
+    ogUrl?: string;
+    ogType?: string;
+    ogSiteName?: string;
+    twitterCard?: string;
+    twitterTitle?: string;
+    twitterDescription?: string;
+    twitterImage?: string;
+    twitterSite?: string;
+    h1Count?: number;
+    h1Text?: string;
+    h1Length?: number;
+    h2Count?: number;
+    headingHierarchyValid?: boolean;
+    headingSkippedLevels?: string[];
+    sectionWordCounts?: number[];
+    totalImages?: number;
+    imagesWithAlt?: number;
+    imagesWithoutAlt?: number;
+    imagesWithLazyLoad?: number;
+    imagesWithDimensions?: number;
+    imagesMissingDimensions?: number;
+    imagesWithEmptyAlt?: number;
+    imagesDecorativeCount?: number;
+    imagesUsingModernFormats?: number;
+    altTextLengths?: number[];
+    imageFilenames?: string[];
+    imagesWithAsyncDecoding?: number;
+    buttonsWithoutAriaLabel?: number;
+    linksWithoutAriaLabel?: number;
+    inputsWithoutLabel?: number;
+    formsWithoutAction?: number;
+    tablesWithoutCaption?: number;
+    iframesWithoutTitle?: number;
+    svgsWithoutTitle?: number;
+    interactiveElementsCount?: number;
+    ariaLabelledByMissing?: number;
+    allLinks?: ExtractedLink[];
+    totalLinks?: number;
+    internalLinks?: number;
+    externalLinks?: number;
+    linksWithoutText?: number;
+    nofollowLinks?: number;
+    sponsoredLinks?: number;
+    ugcLinks?: number;
+    brokenLinks?: number;
+    linksWithGenericText?: number;
+    externalLinksWithoutNoopener?: number;
+    externalLinksWithoutNoreferrer?: number;
+    problematicLinks?: {
+        withoutText?: ExtractedLink[];
+        genericText?: ExtractedLink[];
+        missingNoopener?: ExtractedLink[];
+        missingNoreferrer?: ExtractedLink[];
+    };
+    wordCount?: number;
+    characterCount?: number;
+    sentenceCount?: number;
+    paragraphCount?: number;
+    avgWordsPerSentence?: number;
+    avgParagraphLength?: number;
+    listCount?: number;
+    strongTagCount?: number;
+    emTagCount?: number;
+    subheadingFrequency?: number;
+    paragraphWordCounts?: number[];
+    avgSentenceLength?: number;
+    faqCount?: number;
+    imagePerWordRatio?: number;
+    mainKeyword?: string;
+    keywordDensity?: number;
+    fleschReadingEase?: number;
+    hasQuestionHeadings?: boolean;
+    hasHeader?: boolean;
+    hasNav?: boolean;
+    hasMain?: boolean;
+    hasArticle?: boolean;
+    hasSection?: boolean;
+    hasFooter?: boolean;
+    hasAboutPageLink?: boolean;
+    hasContactPageLink?: boolean;
+    hasPrivacyPolicyLink?: boolean;
+    hasTermsOfServiceLink?: boolean;
+    hasBreadcrumbsHtml?: boolean;
+    hasBreadcrumbsSchema?: boolean;
+    videoCount?: number;
+    audioCount?: number;
+    hasCanonical?: boolean;
+    canonicalUrl?: string;
+    hasViewport?: boolean;
+    viewportContent?: string;
+    hasCharset?: boolean;
+    charset?: string;
+    hasLang?: boolean;
+    langValue?: string;
+    isHttps?: boolean;
+    hasMixedContent?: boolean;
+    responseHeaders?: Record<string, string | string[]>;
+    textHtmlRatio?: number;
+    hasFavicon?: boolean;
+    faviconUrl?: string;
+    hasPreconnect?: boolean;
+    preconnectCount?: number;
+    hasDnsPrefetch?: boolean;
+    dnsPrefetchCount?: number;
+    hasPreload?: boolean;
+    preloadCount?: number;
+    renderBlockingResources?: number;
+    inlineScriptsCount?: number;
+    inlineStylesCount?: number;
+    lcpHints?: {
+        hasLargeImages?: boolean;
+        hasLazyLcp?: boolean;
+        hasPriorityHints?: boolean;
+    };
+    clsHints?: {
+        imagesWithoutDimensions?: number;
+        dynamicContent?: number;
+    };
+    jsonLdCount?: number;
+    jsonLdTypes?: string[];
+    url?: string;
+    urlLength?: number;
+    hreflangTags?: Array<{
+        lang: string;
+        href: string;
+    }>;
+    ogLocale?: string;
+    alternateLanguages?: string[];
+    titleMatchesH1?: boolean;
+    urlHasUppercase?: boolean;
+    urlHasSpecialChars?: boolean;
+    urlHasAccents?: boolean;
+    bodyTextLength?: number;
+    scriptCount?: number;
+    hasNoscriptContent?: boolean;
+    timings?: {
+        ttfb?: number;
+        dnsLookup?: number;
+        tcpConnect?: number;
+        tlsHandshake?: number;
+        download?: number;
+        total?: number;
+    };
+    responseSize?: number;
+    htmlSize?: number;
+    compressedSize?: number;
+    isCompressed?: boolean;
+    isProductPage?: boolean;
+    productSchema?: {
+        name?: string;
+        image?: string | string[];
+        offers?: {
+            price?: number | string;
+            lowPrice?: number | string;
+            priceCurrency?: string;
+            availability?: string;
+            priceValidUntil?: string;
+            validFrom?: string;
+            validThrough?: string;
+        };
+        aggregateRating?: {
+            ratingValue?: number | string;
+            reviewCount?: number;
+            ratingCount?: number;
+        };
+        review?: unknown;
+        brand?: string | {
+            name?: string;
+        };
+        sku?: string;
+        gtin?: string;
+        gtin13?: string;
+        gtin14?: string;
+        gtin8?: string;
+        mpn?: string;
+    };
+    hasLocalBusinessSignals?: boolean;
+    localBusinessSchema?: {
+        '@type'?: string;
+        name?: string;
+        address?: {
+            streetAddress?: string;
+            addressLocality?: string;
+            addressRegion?: string;
+            postalCode?: string;
+            addressCountry?: string;
+        };
+        telephone?: string;
+        openingHoursSpecification?: unknown;
+        openingHours?: string | string[];
+        geo?: {
+            latitude?: number | string;
+            longitude?: number | string;
+        };
+        areaServed?: unknown;
+        priceRange?: string;
+    };
+    hasPhoneOnPage?: boolean;
+    hasAddressOnPage?: boolean;
+    lcpCandidate?: {
+        element?: string;
+        src?: string;
+        loading?: string;
+        fetchpriority?: string;
+    };
+    hasLcpPreload?: boolean;
+    webFonts?: Array<{
+        family?: string;
+        hasSwap?: boolean;
+        hasOptional?: boolean;
+        hasSizeAdjust?: boolean;
+        hasAscentOverride?: boolean;
+    }>;
+    renderBlockingStylesheets?: number;
+    renderBlockingScripts?: number;
+    hasAspectRatioCss?: boolean;
+    hasResponsiveImages?: boolean;
+    hasAdsWithoutReservedSpace?: boolean;
+    hasBannersWithoutMinHeight?: boolean;
+    hasInfiniteScroll?: boolean;
+    largeInlineScripts?: number;
+    inlineEventHandlers?: number;
+    hasHeavyAnimations?: boolean;
+    externalOrigins?: number;
+    hasCriticalResources?: boolean;
+    hasInlineCriticalCss?: boolean;
+    hasSitemapLink?: boolean;
+    sitemapUrl?: string;
+    robotsHasSitemap?: boolean;
+    isPaginatedPage?: boolean;
+    hasRelPrev?: boolean;
+    hasRelNext?: boolean;
+    passiveVoicePercentage?: number;
+    transitionWordPercentage?: number;
+    consecutiveSentenceStarts?: number;
+    complexWordPercentage?: number;
+}
+export interface RuleEvidence {
+    found?: string | number | string[];
+    expected?: string | number | string[];
+    location?: string;
+    issue?: string;
+    impact?: string;
+    example?: string;
+    learnMore?: string;
+}
+export interface RuleResult {
+    id: string;
+    name: string;
+    category: RuleCategory;
+    severity: RuleSeverity;
+    status: SeoStatus;
+    message: string;
+    value?: string | number;
+    recommendation?: string;
+    evidence?: RuleEvidence;
+    details?: Record<string, unknown>;
+}
+export interface SeoRule {
+    id: string;
+    name: string;
+    category: RuleCategory;
+    severity: RuleSeverity;
+    description: string;
+    check: (ctx: RuleContext) => RuleResult | null;
+}
+export declare function createResult(rule: Pick<SeoRule, 'id' | 'name' | 'category' | 'severity'>, status: SeoStatus, message: string, options?: {
+    value?: string | number;
+    recommendation?: string;
+    evidence?: RuleEvidence;
+    details?: Record<string, unknown>;
+}): RuleResult;

package/dist/seo/rules/types.js

@@ -0,0 +1,11 @@
+export function createResult(rule, status, message, options) {
+    return {
+        id: rule.id,
+        name: rule.name,
+        category: rule.category,
+        severity: rule.severity,
+        status,
+        message,
+        ...options,
+    };
+}