recker 1.0.27 → 1.0.28-next.9eb3868

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

@@ -0,0 +1,322 @@
+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;
+    hasManifest?: boolean;
+    manifestUrl?: string;
+    themeColor?: string;
+    hasAppleTouchIcon?: boolean;
+    hasAppleMobileWebAppCapable?: boolean;
+    appleStatusBarStyle?: string;
+    hasMaskableIcon?: boolean;
+    manifestStartUrl?: string;
+    manifestDisplay?: string;
+    manifestScope?: string;
+    manifestIconSizes?: number[];
+    manifestShortName?: string;
+    manifestName?: string;
+    manifestBackgroundColor?: string;
+    ogImageDimensions?: {
+        width: number;
+        height: number;
+    };
+    ogLocaleAlternate?: string[];
+    ogArticleTags?: string[];
+    ogArticlePublishedTime?: string;
+    ogArticleAuthor?: string;
+    twitterCreator?: string;
+    twitterImageAlt?: string;
+    linkedinAuthor?: string;
+    pinterestRichPinSupport?: boolean;
+    hasPinterestNopin?: boolean;
+    fbAppId?: string;
+    navLinkCount?: number;
+    footerLinkCount?: number;
+    contextualLinkCount?: number;
+    incomingInternalLinks?: number;
+    selfReferencingLinks?: number;
+    brokenInternalLinks?: number;
+    redirectChainLinks?: number;
+    pageClickDepth?: 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,
+    };
+}

package/dist/seo/types.d.ts

@@ -0,0 +1,160 @@
+export type SeoStatus = 'pass' | 'warn' | 'fail' | 'info';
+export interface SeoCheckEvidence {
+    found?: string | number | string[];
+    expected?: string | number | string[];
+    location?: string;
+    issue?: string;
+    impact?: string;
+    example?: string;
+    learnMore?: string;
+}
+export interface SeoCheckResult {
+    name: string;
+    status: SeoStatus;
+    message: string;
+    value?: string | number;
+    recommendation?: string;
+    evidence?: SeoCheckEvidence;
+}
+export interface HeadingInfo {
+    level: number;
+    text: string;
+    count: number;
+}
+export interface HeadingAnalysis {
+    structure: HeadingInfo[];
+    h1Count: number;
+    hasProperHierarchy: boolean;
+    issues: string[];
+}
+export interface ContentMetrics {
+    wordCount: number;
+    characterCount: number;
+    sentenceCount: number;
+    paragraphCount: number;
+    readingTimeMinutes: number;
+    avgWordsPerSentence: number;
+    avgParagraphLength: number;
+    listCount: number;
+    strongTagCount: number;
+    emTagCount: number;
+}
+export interface LinkAnalysis {
+    total: number;
+    internal: number;
+    external: number;
+    nofollow: number;
+    broken: number;
+    withoutText: number;
+}
+export interface ImageAnalysis {
+    total: number;
+    withAlt: number;
+    withoutAlt: number;
+    lazy: number;
+    missingDimensions: number;
+    modernFormats: number;
+    altTextLengths: number[];
+    imageFilenames: string[];
+    imagesWithAsyncDecoding: number;
+}
+export interface SocialMetaAnalysis {
+    openGraph: {
+        present: boolean;
+        hasTitle: boolean;
+        hasDescription: boolean;
+        hasImage: boolean;
+        hasUrl: boolean;
+        issues: string[];
+    };
+    twitterCard: {
+        present: boolean;
+        hasCard: boolean;
+        hasTitle: boolean;
+        hasDescription: boolean;
+        hasImage: boolean;
+        issues: string[];
+    };
+}
+export interface TechnicalSeo {
+    hasCanonical: boolean;
+    canonicalUrl?: string;
+    hasRobotsMeta: boolean;
+    robotsContent?: string[];
+    hasViewport: boolean;
+    hasCharset: boolean;
+    hasLang: boolean;
+    langValue?: string;
+}
+export interface SeoReport {
+    url: string;
+    timestamp: Date;
+    grade: string;
+    score: number;
+    checks: SeoCheckResult[];
+    title?: {
+        text: string;
+        length: number;
+    };
+    metaDescription?: {
+        text: string;
+        length: number;
+    };
+    headings: HeadingAnalysis;
+    content: ContentMetrics;
+    links: LinkAnalysis;
+    images: ImageAnalysis;
+    social: SocialMetaAnalysis;
+    technical: TechnicalSeo;
+    jsonLd: {
+        count: number;
+        types: string[];
+    };
+}
+export interface SeoAnalyzerOptions {
+    baseUrl?: string;
+    analyzeContent?: boolean;
+    checkBrokenLinks?: boolean;
+    responseHeaders?: Record<string, string | string[]>;
+}
+export interface ExtractedLink {
+    href: string;
+    text: string;
+    rel?: string;
+    target?: string;
+    title?: string;
+    type?: 'internal' | 'external' | 'anchor' | 'mailto' | 'tel';
+}
+export interface ExtractedImage {
+    src: string;
+    alt?: string;
+    title?: string;
+    width?: number;
+    height?: number;
+    srcset?: string;
+    loading?: 'lazy' | 'eager';
+}
+export interface LinkAnalysis {
+    total: number;
+    internal: number;
+    external: number;
+    nofollow: number;
+    broken: number;
+    withoutText: number;
+    sponsoredLinks: number;
+    ugcLinks: number;
+}
+export interface ContentMetrics {
+    wordCount: number;
+    characterCount: number;
+    sentenceCount: number;
+    paragraphCount: number;
+    readingTimeMinutes: number;
+    avgWordsPerSentence: number;
+    avgParagraphLength: number;
+    listCount: number;
+    strongTagCount: number;
+    emTagCount: number;
+    fleschReadingEase?: number;
+    hasQuestionHeadings?: boolean;
+}

package/dist/seo/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/columns.d.ts

@@ -0,0 +1,14 @@
+export interface ColumnOptions {
+    minWidth?: number;
+    maxColumns?: number;
+    padding?: number;
+    prefix?: string;
+    indent?: number;
+    transform?: (item: string) => string;
+}
+export declare function getTerminalWidth(): number;
+export declare function formatColumns(items: string[], options?: ColumnOptions): string;
+export declare function formatColumnsRowMajor(items: string[], options?: ColumnOptions): string;
+export declare function formatGroupedColumns(groups: Record<string, string[]>, options?: ColumnOptions & {
+    groupPrefix?: string;
+}): string;

package/dist/utils/columns.js

@@ -0,0 +1,69 @@
+export function getTerminalWidth() {
+    return process.stdout.columns || 80;
+}
+export function formatColumns(items, options = {}) {
+    const { minWidth = 15, maxColumns = Infinity, padding = 2, prefix = '', indent = 2, transform, } = options;
+    if (items.length === 0)
+        return '';
+    const prefixedItems = items.map(item => prefix + item);
+    const maxItemWidth = Math.max(...prefixedItems.map(item => item.length));
+    const columnWidth = Math.max(minWidth, maxItemWidth + padding);
+    const terminalWidth = getTerminalWidth();
+    const availableWidth = terminalWidth - indent;
+    const calculatedColumns = Math.floor(availableWidth / columnWidth);
+    const numColumns = Math.min(Math.max(1, calculatedColumns), maxColumns, items.length);
+    const actualColumnWidth = Math.floor(availableWidth / numColumns);
+    const numRows = Math.ceil(prefixedItems.length / numColumns);
+    const lines = [];
+    const indentStr = ' '.repeat(indent);
+    for (let row = 0; row < numRows; row++) {
+        let line = indentStr;
+        for (let col = 0; col < numColumns; col++) {
+            const index = col * numRows + row;
+            if (index < prefixedItems.length) {
+                const rawItem = prefixedItems[index];
+                const displayItem = transform ? transform(rawItem) : rawItem;
+                const paddingNeeded = actualColumnWidth - rawItem.length;
+                line += displayItem + ' '.repeat(Math.max(0, paddingNeeded));
+            }
+        }
+        lines.push(line.trimEnd());
+    }
+    return lines.join('\n');
+}
+export function formatColumnsRowMajor(items, options = {}) {
+    const { minWidth = 15, maxColumns = Infinity, padding = 2, prefix = '', indent = 2, } = options;
+    if (items.length === 0)
+        return '';
+    const prefixedItems = items.map(item => prefix + item);
+    const maxItemWidth = Math.max(...prefixedItems.map(item => item.length));
+    const columnWidth = Math.max(minWidth, maxItemWidth + padding);
+    const terminalWidth = getTerminalWidth();
+    const availableWidth = terminalWidth - indent;
+    const calculatedColumns = Math.floor(availableWidth / columnWidth);
+    const numColumns = Math.min(Math.max(1, calculatedColumns), maxColumns, items.length);
+    const actualColumnWidth = Math.floor(availableWidth / numColumns);
+    const lines = [];
+    const indentStr = ' '.repeat(indent);
+    for (let i = 0; i < prefixedItems.length; i += numColumns) {
+        let line = indentStr;
+        for (let col = 0; col < numColumns && i + col < prefixedItems.length; col++) {
+            const item = prefixedItems[i + col];
+            line += item.padEnd(actualColumnWidth);
+        }
+        lines.push(line.trimEnd());
+    }
+    return lines.join('\n');
+}
+export function formatGroupedColumns(groups, options = {}) {
+    const lines = [];
+    const { groupPrefix = '', ...columnOptions } = options;
+    for (const [groupName, items] of Object.entries(groups)) {
+        if (items.length === 0)
+            continue;
+        lines.push(groupPrefix + groupName + ':');
+        lines.push(formatColumns(items, columnOptions));
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.27",
+  "version": "1.0.28-next.9eb3868",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",