npm - recker - Versions diffs - 1.0.26 → 1.0.27-next.1cb21f8 - Mend

recker 1.0.26 → 1.0.27-next.1cb21f8

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 (213) hide show

package/dist/browser/browser/cache.d.ts +40 -0
package/dist/browser/browser/cache.js +199 -0
package/dist/browser/browser/crypto.d.ts +24 -0
package/dist/browser/browser/crypto.js +80 -0
package/dist/browser/browser/index.d.ts +31 -0
package/dist/browser/browser/index.js +31 -0
package/dist/browser/browser/recker.d.ts +26 -0
package/dist/browser/browser/recker.js +61 -0
package/dist/browser/cache/basic-file-storage.d.ts +12 -0
package/dist/browser/cache/basic-file-storage.js +50 -0
package/dist/browser/cache/memory-limits.d.ts +20 -0
package/dist/browser/cache/memory-limits.js +96 -0
package/dist/browser/cache/memory-storage.d.ts +132 -0
package/dist/browser/cache/memory-storage.js +454 -0
package/dist/browser/cache.d.ts +40 -0
package/dist/browser/cache.js +199 -0
package/dist/browser/constants/http-status.d.ts +73 -0
package/dist/browser/constants/http-status.js +156 -0
package/dist/browser/cookies/memory-cookie-jar.d.ts +30 -0
package/dist/browser/cookies/memory-cookie-jar.js +210 -0
package/dist/browser/core/client.d.ts +118 -0
package/dist/browser/core/client.js +667 -0
package/dist/browser/core/errors.d.ts +142 -0
package/dist/browser/core/errors.js +308 -0
package/dist/browser/core/index.d.ts +5 -0
package/dist/browser/core/index.js +5 -0
package/dist/browser/core/request-promise.d.ts +23 -0
package/dist/browser/core/request-promise.js +82 -0
package/dist/browser/core/request.d.ts +20 -0
package/dist/browser/core/request.js +76 -0
package/dist/browser/core/response.d.ts +34 -0
package/dist/browser/core/response.js +178 -0
package/dist/browser/crypto.d.ts +24 -0
package/dist/browser/crypto.js +80 -0
package/dist/browser/index.d.ts +31 -0
package/dist/browser/index.js +31 -0
package/dist/browser/plugins/auth/api-key.d.ts +8 -0
package/dist/browser/plugins/auth/api-key.js +27 -0
package/dist/browser/plugins/auth/auth0.d.ts +33 -0
package/dist/browser/plugins/auth/auth0.js +94 -0
package/dist/browser/plugins/auth/aws-sigv4.d.ts +10 -0
package/dist/browser/plugins/auth/aws-sigv4.js +88 -0
package/dist/browser/plugins/auth/azure-ad.d.ts +48 -0
package/dist/browser/plugins/auth/azure-ad.js +152 -0
package/dist/browser/plugins/auth/basic.d.ts +7 -0
package/dist/browser/plugins/auth/basic.js +13 -0
package/dist/browser/plugins/auth/bearer.d.ts +8 -0
package/dist/browser/plugins/auth/bearer.js +17 -0
package/dist/browser/plugins/auth/cognito.d.ts +45 -0
package/dist/browser/plugins/auth/cognito.js +208 -0
package/dist/browser/plugins/auth/digest.d.ts +8 -0
package/dist/browser/plugins/auth/digest.js +100 -0
package/dist/browser/plugins/auth/firebase.d.ts +32 -0
package/dist/browser/plugins/auth/firebase.js +195 -0
package/dist/browser/plugins/auth/github-app.d.ts +36 -0
package/dist/browser/plugins/auth/github-app.js +170 -0
package/dist/browser/plugins/auth/google-service-account.d.ts +49 -0
package/dist/browser/plugins/auth/google-service-account.js +172 -0
package/dist/browser/plugins/auth/index.d.ts +15 -0
package/dist/browser/plugins/auth/index.js +15 -0
package/dist/browser/plugins/auth/mtls.d.ts +37 -0
package/dist/browser/plugins/auth/mtls.js +140 -0
package/dist/browser/plugins/auth/oauth2.d.ts +8 -0
package/dist/browser/plugins/auth/oauth2.js +26 -0
package/dist/browser/plugins/auth/oidc.d.ts +55 -0
package/dist/browser/plugins/auth/oidc.js +222 -0
package/dist/browser/plugins/auth/okta.d.ts +47 -0
package/dist/browser/plugins/auth/okta.js +157 -0
package/dist/browser/plugins/auth.d.ts +1 -0
package/dist/browser/plugins/auth.js +1 -0
package/dist/browser/plugins/cache.d.ts +15 -0
package/dist/browser/plugins/cache.js +486 -0
package/dist/browser/plugins/circuit-breaker.d.ts +13 -0
package/dist/browser/plugins/circuit-breaker.js +100 -0
package/dist/browser/plugins/compression.d.ts +4 -0
package/dist/browser/plugins/compression.js +130 -0
package/dist/browser/plugins/cookie-jar.d.ts +5 -0
package/dist/browser/plugins/cookie-jar.js +72 -0
package/dist/browser/plugins/dedup.d.ts +5 -0
package/dist/browser/plugins/dedup.js +35 -0
package/dist/browser/plugins/graphql.d.ts +13 -0
package/dist/browser/plugins/graphql.js +58 -0
package/dist/browser/plugins/grpc-web.d.ts +79 -0
package/dist/browser/plugins/grpc-web.js +261 -0
package/dist/browser/plugins/hls.d.ts +105 -0
package/dist/browser/plugins/hls.js +395 -0
package/dist/browser/plugins/jsonrpc.d.ts +75 -0
package/dist/browser/plugins/jsonrpc.js +143 -0
package/dist/browser/plugins/logger.d.ts +13 -0
package/dist/browser/plugins/logger.js +108 -0
package/dist/browser/plugins/odata.d.ts +181 -0
package/dist/browser/plugins/odata.js +564 -0
package/dist/browser/plugins/pagination.d.ts +16 -0
package/dist/browser/plugins/pagination.js +105 -0
package/dist/browser/plugins/rate-limit.d.ts +15 -0
package/dist/browser/plugins/rate-limit.js +162 -0
package/dist/browser/plugins/retry.d.ts +14 -0
package/dist/browser/plugins/retry.js +116 -0
package/dist/browser/plugins/scrape.d.ts +21 -0
package/dist/browser/plugins/scrape.js +82 -0
package/dist/browser/plugins/server-timing.d.ts +7 -0
package/dist/browser/plugins/server-timing.js +24 -0
package/dist/browser/plugins/soap.d.ts +72 -0
package/dist/browser/plugins/soap.js +347 -0
package/dist/browser/plugins/xml.d.ts +9 -0
package/dist/browser/plugins/xml.js +194 -0
package/dist/browser/plugins/xsrf.d.ts +9 -0
package/dist/browser/plugins/xsrf.js +48 -0
package/dist/browser/recker.d.ts +26 -0
package/dist/browser/recker.js +61 -0
package/dist/browser/runner/request-runner.d.ts +46 -0
package/dist/browser/runner/request-runner.js +89 -0
package/dist/browser/scrape/document.d.ts +44 -0
package/dist/browser/scrape/document.js +210 -0
package/dist/browser/scrape/element.d.ts +49 -0
package/dist/browser/scrape/element.js +176 -0
package/dist/browser/scrape/extractors.d.ts +16 -0
package/dist/browser/scrape/extractors.js +357 -0
package/dist/browser/scrape/types.d.ts +108 -0
package/dist/browser/scrape/types.js +1 -0
package/dist/browser/transport/fetch.d.ts +11 -0
package/dist/browser/transport/fetch.js +143 -0
package/dist/browser/transport/undici.d.ts +38 -0
package/dist/browser/transport/undici.js +897 -0
package/dist/browser/types/ai.d.ts +267 -0
package/dist/browser/types/ai.js +1 -0
package/dist/browser/types/index.d.ts +351 -0
package/dist/browser/types/index.js +1 -0
package/dist/browser/types/logger.d.ts +16 -0
package/dist/browser/types/logger.js +66 -0
package/dist/browser/types/udp.d.ts +138 -0
package/dist/browser/types/udp.js +1 -0
package/dist/browser/utils/agent-manager.d.ts +29 -0
package/dist/browser/utils/agent-manager.js +160 -0
package/dist/browser/utils/body.d.ts +10 -0
package/dist/browser/utils/body.js +148 -0
package/dist/browser/utils/charset.d.ts +15 -0
package/dist/browser/utils/charset.js +169 -0
package/dist/browser/utils/concurrency.d.ts +20 -0
package/dist/browser/utils/concurrency.js +120 -0
package/dist/browser/utils/dns.d.ts +6 -0
package/dist/browser/utils/dns.js +26 -0
package/dist/browser/utils/header-parser.d.ts +94 -0
package/dist/browser/utils/header-parser.js +617 -0
package/dist/browser/utils/html-cleaner.d.ts +1 -0
package/dist/browser/utils/html-cleaner.js +21 -0
package/dist/browser/utils/link-header.d.ts +69 -0
package/dist/browser/utils/link-header.js +190 -0
package/dist/browser/utils/optional-require.d.ts +19 -0
package/dist/browser/utils/optional-require.js +105 -0
package/dist/browser/utils/progress.d.ts +8 -0
package/dist/browser/utils/progress.js +82 -0
package/dist/browser/utils/request-pool.d.ts +22 -0
package/dist/browser/utils/request-pool.js +101 -0
package/dist/browser/utils/sse.d.ts +7 -0
package/dist/browser/utils/sse.js +67 -0
package/dist/browser/utils/streaming.d.ts +17 -0
package/dist/browser/utils/streaming.js +84 -0
package/dist/browser/utils/try-fn.d.ts +3 -0
package/dist/browser/utils/try-fn.js +59 -0
package/dist/browser/utils/user-agent.d.ts +44 -0
package/dist/browser/utils/user-agent.js +100 -0
package/dist/browser/utils/whois.d.ts +32 -0
package/dist/browser/utils/whois.js +246 -0
package/dist/browser/websocket/client.d.ts +65 -0
package/dist/browser/websocket/client.js +313 -0
package/dist/cli/index.d.ts +1 -0
package/dist/cli/index.js +143 -3
package/dist/cli/tui/shell.d.ts +1 -0
package/dist/cli/tui/shell.js +157 -0
package/dist/index.d.ts +1 -0
package/dist/index.js +1 -0
package/dist/scrape/extractors.js +2 -1
package/dist/scrape/types.d.ts +2 -1
package/dist/seo/analyzer.d.ts +42 -0
package/dist/seo/analyzer.js +715 -0
package/dist/seo/index.d.ts +5 -0
package/dist/seo/index.js +2 -0
package/dist/seo/rules/accessibility.d.ts +2 -0
package/dist/seo/rules/accessibility.js +128 -0
package/dist/seo/rules/content.d.ts +2 -0
package/dist/seo/rules/content.js +236 -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 +20 -0
package/dist/seo/rules/index.js +72 -0
package/dist/seo/rules/links.d.ts +2 -0
package/dist/seo/rules/links.js +150 -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/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 +147 -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 +191 -0
package/dist/seo/rules/types.js +11 -0
package/dist/seo/types.d.ts +160 -0
package/dist/seo/types.js +1 -0
package/dist/transport/fetch.d.ts +7 -1
package/dist/transport/fetch.js +58 -76
package/dist/utils/columns.d.ts +14 -0
package/dist/utils/columns.js +69 -0
package/package.json +34 -2

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

@@ -0,0 +1,246 @@
+import { createResult } from './types.js';
+import { SEO_THRESHOLDS } from './thresholds.js';
+export const performanceRules = [
+    {
+        id: 'perf-preconnect',
+        name: 'Preconnect Hints',
+        category: 'performance',
+        severity: 'info',
+        description: 'Use preconnect for important third-party origins',
+        check: (ctx) => {
+            if (!ctx.hasPreconnect && ctx.externalLinks && ctx.externalLinks > 5) {
+                return createResult({ id: 'perf-preconnect', name: 'Preconnect Hints', category: 'performance', severity: 'info' }, 'info', 'No preconnect hints found', { recommendation: 'Add <link rel="preconnect" href="..."> for important third-party domains' });
+            }
+            if (ctx.preconnectCount && ctx.preconnectCount > 0) {
+                return createResult({ id: 'perf-preconnect', name: 'Preconnect Hints', category: 'performance', severity: 'info' }, 'pass', `${ctx.preconnectCount} preconnect hint(s) found`, { value: ctx.preconnectCount });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'perf-dns-prefetch',
+        name: 'DNS Prefetch',
+        category: 'performance',
+        severity: 'info',
+        description: 'Use dns-prefetch for external domains',
+        check: (ctx) => {
+            if (ctx.dnsPrefetchCount && ctx.dnsPrefetchCount > 0) {
+                return createResult({ id: 'perf-dns-prefetch', name: 'DNS Prefetch', category: 'performance', severity: 'info' }, 'pass', `${ctx.dnsPrefetchCount} dns-prefetch hint(s) found`, { value: ctx.dnsPrefetchCount });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'perf-preload',
+        name: 'Preload Hints',
+        category: 'performance',
+        severity: 'info',
+        description: 'Use preload for critical resources',
+        check: (ctx) => {
+            if (ctx.preloadCount && ctx.preloadCount > 0) {
+                return createResult({ id: 'perf-preload', name: 'Preload Hints', category: 'performance', severity: 'info' }, 'pass', `${ctx.preloadCount} preload hint(s) found`, { value: ctx.preloadCount });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'perf-render-blocking',
+        name: 'Render Blocking',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Minimize render-blocking resources',
+        check: (ctx) => {
+            const blocking = ctx.renderBlockingResources ?? 0;
+            if (blocking > 5) {
+                return createResult({ id: 'perf-render-blocking', name: 'Render Blocking', category: 'performance', severity: 'warning' }, 'warn', `${blocking} render-blocking resources in <head>`, { value: blocking, recommendation: 'Use async/defer for scripts, preload for critical CSS' });
+            }
+            if (blocking > 0) {
+                return createResult({ id: 'perf-render-blocking', name: 'Render Blocking', category: 'performance', severity: 'warning' }, 'info', `${blocking} render-blocking resource(s) in <head>`, { value: blocking });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'perf-inline-styles',
+        name: 'Inline Styles',
+        category: 'performance',
+        severity: 'info',
+        description: 'Excessive inline styles can increase page size',
+        check: (ctx) => {
+            const inline = ctx.inlineStylesCount ?? 0;
+            if (inline > 10) {
+                return createResult({ id: 'perf-inline-styles', name: 'Inline Styles', category: 'performance', severity: 'info' }, 'info', `${inline} inline style blocks found`, { value: inline, recommendation: 'Consider consolidating inline styles into external CSS' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'cwv-lcp-lazy',
+        name: 'LCP Image Lazy',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Above-the-fold images should not use lazy loading',
+        check: (ctx) => {
+            if (ctx.lcpHints?.hasLazyLcp) {
+                return createResult({ id: 'cwv-lcp-lazy', name: 'LCP Image Lazy', category: 'performance', severity: 'warning' }, 'warn', 'First large image uses lazy loading (may hurt LCP)', { recommendation: 'Remove loading="lazy" from above-the-fold images' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'cwv-lcp-priority',
+        name: 'LCP Priority Hints',
+        category: 'performance',
+        severity: 'info',
+        description: 'Use fetchpriority="high" for LCP images',
+        check: (ctx) => {
+            if (ctx.lcpHints?.hasLargeImages && !ctx.lcpHints?.hasPriorityHints) {
+                return createResult({ id: 'cwv-lcp-priority', name: 'LCP Priority Hints', category: 'performance', severity: 'info' }, 'info', 'No fetchpriority="high" found on large images', { recommendation: 'Add fetchpriority="high" to LCP candidate images' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'cwv-cls-images',
+        name: 'CLS Image Dimensions',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Images without dimensions cause layout shifts',
+        check: (ctx) => {
+            const missing = ctx.clsHints?.imagesWithoutDimensions ?? ctx.imagesMissingDimensions ?? 0;
+            if (missing > 0) {
+                return createResult({ id: 'cwv-cls-images', name: 'CLS Image Dimensions', category: 'performance', severity: 'warning' }, 'warn', `${missing} image(s) without width/height (causes CLS)`, { value: missing, recommendation: 'Add width and height attributes to all images' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'timing-ttfb',
+        name: 'Time to First Byte',
+        category: 'performance',
+        severity: 'error',
+        description: 'TTFB should be under 600ms (ideally under 200ms)',
+        check: (ctx) => {
+            const ttfb = ctx.timings?.ttfb;
+            if (ttfb === undefined)
+                return null;
+            const { good, needsImprovement, poor } = SEO_THRESHOLDS.timing.ttfb;
+            if (ttfb <= good) {
+                return createResult({ id: 'timing-ttfb', name: 'TTFB', category: 'performance', severity: 'error' }, 'pass', `Excellent TTFB (${ttfb}ms)`, { value: ttfb });
+            }
+            if (ttfb <= needsImprovement) {
+                return createResult({ id: 'timing-ttfb', name: 'TTFB', category: 'performance', severity: 'error' }, 'info', `TTFB needs improvement (${ttfb}ms)`, { value: ttfb, recommendation: `Optimize server response time to under ${good}ms` });
+            }
+            if (ttfb <= poor) {
+                return createResult({ id: 'timing-ttfb', name: 'TTFB', category: 'performance', severity: 'error' }, 'warn', `Slow TTFB (${ttfb}ms)`, { value: ttfb, recommendation: 'Optimize server, use CDN, enable caching' });
+            }
+            return createResult({ id: 'timing-ttfb', name: 'TTFB', category: 'performance', severity: 'error' }, 'fail', `Very slow TTFB (${ttfb}ms)`, { value: ttfb, recommendation: 'Critical: Server is too slow. Check server, database, and network' });
+        },
+    },
+    {
+        id: 'timing-total',
+        name: 'Total Load Time',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Total page load should be under 2.5s',
+        check: (ctx) => {
+            const total = ctx.timings?.total;
+            if (total === undefined)
+                return null;
+            const { good, needsImprovement, poor } = SEO_THRESHOLDS.timing.total;
+            if (total <= good) {
+                return createResult({ id: 'timing-total', name: 'Load Time', category: 'performance', severity: 'warning' }, 'pass', `Fast page load (${total}ms)`, { value: total });
+            }
+            if (total <= needsImprovement) {
+                return createResult({ id: 'timing-total', name: 'Load Time', category: 'performance', severity: 'warning' }, 'info', `Page load time acceptable (${total}ms)`, { value: total, recommendation: `Aim for under ${good}ms for better user experience` });
+            }
+            if (total <= poor) {
+                return createResult({ id: 'timing-total', name: 'Load Time', category: 'performance', severity: 'warning' }, 'warn', `Slow page load (${total}ms)`, { value: total, recommendation: 'Optimize assets, enable compression, use CDN' });
+            }
+            return createResult({ id: 'timing-total', name: 'Load Time', category: 'performance', severity: 'warning' }, 'fail', `Very slow page load (${total}ms)`, { value: total, recommendation: 'Critical performance issue. Full optimization needed.' });
+        },
+    },
+    {
+        id: 'timing-dns',
+        name: 'DNS Lookup',
+        category: 'performance',
+        severity: 'info',
+        description: 'DNS lookup should be under 50ms',
+        check: (ctx) => {
+            const dns = ctx.timings?.dnsLookup;
+            if (dns === undefined)
+                return null;
+            const { good, poor } = SEO_THRESHOLDS.timing.dnsLookup;
+            if (dns <= good) {
+                return createResult({ id: 'timing-dns', name: 'DNS Lookup', category: 'performance', severity: 'info' }, 'pass', `Fast DNS lookup (${dns}ms)`, { value: dns });
+            }
+            if (dns <= poor) {
+                return createResult({ id: 'timing-dns', name: 'DNS Lookup', category: 'performance', severity: 'info' }, 'info', `DNS lookup could be faster (${dns}ms)`, { value: dns, recommendation: 'Consider using faster DNS provider or dns-prefetch' });
+            }
+            return createResult({ id: 'timing-dns', name: 'DNS Lookup', category: 'performance', severity: 'info' }, 'warn', `Slow DNS lookup (${dns}ms)`, { value: dns, recommendation: 'DNS is slow. Consider Cloudflare, Google DNS, or dns-prefetch' });
+        },
+    },
+    {
+        id: 'timing-tls',
+        name: 'TLS Handshake',
+        category: 'performance',
+        severity: 'info',
+        description: 'TLS handshake should be under 100ms',
+        check: (ctx) => {
+            const tls = ctx.timings?.tlsHandshake;
+            if (tls === undefined)
+                return null;
+            const { good, poor } = SEO_THRESHOLDS.timing.tlsHandshake;
+            if (tls <= good) {
+                return createResult({ id: 'timing-tls', name: 'TLS Handshake', category: 'performance', severity: 'info' }, 'pass', `Fast TLS handshake (${tls}ms)`, { value: tls });
+            }
+            if (tls <= poor) {
+                return createResult({ id: 'timing-tls', name: 'TLS Handshake', category: 'performance', severity: 'info' }, 'info', `TLS handshake could be faster (${tls}ms)`, { value: tls, recommendation: 'Consider TLS 1.3, HTTP/2, or preconnect hints' });
+            }
+            return createResult({ id: 'timing-tls', name: 'TLS Handshake', category: 'performance', severity: 'info' }, 'warn', `Slow TLS handshake (${tls}ms)`, { value: tls, recommendation: 'TLS is slow. Check server configuration and certificate chain' });
+        },
+    },
+    {
+        id: 'response-html-size',
+        name: 'HTML Size',
+        category: 'performance',
+        severity: 'warning',
+        description: 'HTML should be under 500KB (ideally under 100KB)',
+        check: (ctx) => {
+            const size = ctx.htmlSize;
+            if (size === undefined)
+                return null;
+            const { good, warning, poor } = SEO_THRESHOLDS.responseSize.html;
+            const sizeKb = Math.round(size / 1024);
+            if (size <= good) {
+                return createResult({ id: 'response-html-size', name: 'HTML Size', category: 'performance', severity: 'warning' }, 'pass', `HTML size is good (${sizeKb}KB)`, { value: sizeKb });
+            }
+            if (size <= warning) {
+                return createResult({ id: 'response-html-size', name: 'HTML Size', category: 'performance', severity: 'warning' }, 'info', `HTML size is acceptable (${sizeKb}KB)`, { value: sizeKb, recommendation: 'Consider reducing HTML size for faster parsing' });
+            }
+            if (size <= poor) {
+                return createResult({ id: 'response-html-size', name: 'HTML Size', category: 'performance', severity: 'warning' }, 'warn', `HTML is large (${sizeKb}KB)`, { value: sizeKb, recommendation: 'Reduce HTML size. Check for inline data, remove unused code' });
+            }
+            return createResult({ id: 'response-html-size', name: 'HTML Size', category: 'performance', severity: 'warning' }, 'fail', `HTML is very large (${sizeKb}KB)`, { value: sizeKb, recommendation: 'Critical: HTML too large. Use pagination, lazy loading, or split content' });
+        },
+    },
+    {
+        id: 'response-compression',
+        name: 'Compression',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Response should be compressed (gzip/brotli)',
+        check: (ctx) => {
+            if (ctx.htmlSize === undefined)
+                return null;
+            if (ctx.isCompressed === false && ctx.htmlSize > 1024) {
+                return createResult({ id: 'response-compression', name: 'Compression', category: 'performance', severity: 'warning' }, 'warn', 'Response is not compressed', { recommendation: 'Enable gzip or brotli compression on server' });
+            }
+            if (ctx.isCompressed === true) {
+                const ratio = ctx.compressedSize && ctx.htmlSize ? Math.round((ctx.compressedSize / ctx.htmlSize) * 100) : undefined;
+                return createResult({ id: 'response-compression', name: 'Compression', category: 'performance', severity: 'warning' }, 'pass', ratio ? `Response compressed (${ratio}% of original)` : 'Response is compressed');
+            }
+            return null;
+        },
+    },
+];

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

	@@ -0,0 +1,2 @@
1	+ import { SeoRule } from './types.js';
2	+ export declare const schemaRules: SeoRule[];

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

@@ -0,0 +1,54 @@
+import { createResult } from './types.js';
+export const schemaRules = [
+    {
+        id: 'json-ld-exists',
+        name: 'Structured Data',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Page should have JSON-LD structured data',
+        check: (ctx) => {
+            if (ctx.jsonLdCount === undefined)
+                return null;
+            if (ctx.jsonLdCount === 0) {
+                return createResult({ id: 'json-ld-exists', name: 'Structured Data', category: 'structured-data', severity: 'info' }, 'info', 'No JSON-LD structured data found', { recommendation: 'Add Schema.org structured data for rich snippets' });
+            }
+            const types = ctx.jsonLdTypes?.join(', ') || 'unknown';
+            return createResult({ id: 'json-ld-exists', name: 'Structured Data', category: 'structured-data', severity: 'info' }, 'pass', `${ctx.jsonLdCount} JSON-LD block(s) found`, { value: types });
+        },
+    },
+    {
+        id: 'schema-standard-types',
+        name: 'Schema Types',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Use standard Schema.org types',
+        check: (ctx) => {
+            if (!ctx.jsonLdTypes || ctx.jsonLdTypes.length === 0)
+                return null;
+            const recommended = [
+                'WebSite', 'WebPage', 'Article', 'Product', 'BreadcrumbList',
+                'Organization', 'Person', 'LocalBusiness', 'Recipe', 'Event',
+                'JobPosting', 'FAQPage', 'HowTo', 'VideoObject',
+                'SoftwareApplication', 'Review'
+            ];
+            const hasStandard = ctx.jsonLdTypes.some(t => recommended.includes(t));
+            if (!hasStandard) {
+                return createResult({ id: 'schema-standard-types', name: 'Schema Types', category: 'structured-data', severity: 'info' }, 'info', 'Using uncommon Schema.org types', { value: ctx.jsonLdTypes.join(', '), recommendation: `Consider using standard types like ${recommended.slice(0, 3).join(', ')}` });
+            }
+            return createResult({ id: 'schema-standard-types', name: 'Schema Types', category: 'structured-data', severity: 'info' }, 'pass', 'Using standard Schema.org types', { value: ctx.jsonLdTypes.join(', ') });
+        },
+    },
+    {
+        id: 'breadcrumbs-presence',
+        name: 'Breadcrumbs Presence',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Breadcrumbs improve navigation and SEO structure',
+        check: (ctx) => {
+            if (!ctx.hasBreadcrumbsHtml && !ctx.hasBreadcrumbsSchema) {
+                return createResult({ id: 'breadcrumbs-presence', name: 'Breadcrumbs Presence', category: 'structured-data', severity: 'info' }, 'info', 'No breadcrumbs found (HTML or Schema.org)', { recommendation: 'Add breadcrumbs using HTML and/or Schema.org BreadcrumbList' });
+            }
+            return null;
+        },
+    },
+];

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

	@@ -0,0 +1,2 @@
1	+ import { SeoRule } from './types.js';
2	+ export declare const securityRules: SeoRule[];

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

@@ -0,0 +1,147 @@
+import { createResult } from './types.js';
+export const securityRules = [
+    {
+        id: 'https-required',
+        name: 'HTTPS',
+        category: 'security',
+        severity: 'error',
+        description: 'Page must be served over HTTPS',
+        check: (ctx) => {
+            if (ctx.isHttps === false) {
+                return createResult({ id: 'https-required', name: 'HTTPS', category: 'security', severity: 'error' }, 'fail', 'Page is not served over HTTPS', { recommendation: 'Enable HTTPS for all pages' });
+            }
+            if (ctx.isHttps === true) {
+                return createResult({ id: 'https-required', name: 'HTTPS', category: 'security', severity: 'error' }, 'pass', 'Page is served over HTTPS');
+            }
+            return null;
+        },
+    },
+    {
+        id: 'mixed-content',
+        name: 'Mixed Content',
+        category: 'security',
+        severity: 'error',
+        description: 'HTTPS pages should not load HTTP resources',
+        check: (ctx) => {
+            if (ctx.hasMixedContent) {
+                return createResult({ id: 'mixed-content', name: 'Mixed Content', category: 'security', severity: 'error' }, 'fail', 'Page has mixed content (HTTP resources on HTTPS page)', { recommendation: 'Update all resources to use HTTPS' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'security-csp-exists',
+        name: 'Content Security Policy (CSP)',
+        category: 'security',
+        severity: 'warning',
+        description: 'Content Security Policy header should be present to mitigate XSS attacks.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const cspHeader = ctx.responseHeaders['content-security-policy'] || ctx.responseHeaders['Content-Security-Policy'];
+            if (!cspHeader) {
+                return createResult({ id: 'security-csp-exists', name: 'Content Security Policy', category: 'security', severity: 'warning' }, 'warn', 'Content-Security-Policy header is missing', { recommendation: 'Implement a strong Content-Security-Policy to prevent XSS attacks.' });
+            }
+            return createResult({ id: 'security-csp-exists', name: 'Content Security Policy', category: 'security', severity: 'warning' }, 'pass', 'Content-Security-Policy header is present');
+        },
+    },
+    {
+        id: 'security-xfo-exists',
+        name: 'X-Frame-Options',
+        category: 'security',
+        severity: 'warning',
+        description: 'X-Frame-Options header should be present to prevent clickjacking.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const xfoHeader = ctx.responseHeaders['x-frame-options'] || ctx.responseHeaders['X-Frame-Options'];
+            if (!xfoHeader) {
+                return createResult({ id: 'security-xfo-exists', name: 'X-Frame-Options', category: 'security', severity: 'warning' }, 'warn', 'X-Frame-Options header is missing', { recommendation: 'Implement X-Frame-Options to prevent clickjacking attacks.' });
+            }
+            return createResult({ id: 'security-xfo-exists', name: 'X-Frame-Options', category: 'security', severity: 'warning' }, 'pass', `X-Frame-Options header is present: ${xfoHeader}`);
+        },
+    },
+    {
+        id: 'security-cors-config',
+        name: 'CORS Configuration',
+        category: 'security',
+        severity: 'warning',
+        description: 'Review Access-Control-Allow-Origin header for proper CORS configuration.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const acaoHeader = ctx.responseHeaders['access-control-allow-origin'] || ctx.responseHeaders['Access-Control-Allow-Origin'];
+            if (acaoHeader === '*') {
+                return createResult({ id: 'security-cors-config', name: 'CORS Configuration', category: 'security', severity: 'warning' }, 'warn', 'Access-Control-Allow-Origin is set to "*"', { recommendation: 'Avoid wildcard (*) in Access-Control-Allow-Origin for sensitive content. Specify allowed origins.' });
+            }
+            if (!acaoHeader) {
+                return createResult({ id: 'security-cors-config', name: 'CORS Configuration', category: 'security', severity: 'warning' }, 'info', 'Access-Control-Allow-Origin header is missing', { recommendation: 'Consider explicit CORS configuration if resources are consumed cross-origin.' });
+            }
+            return createResult({ id: 'security-cors-config', name: 'CORS Configuration', category: 'security', severity: 'warning' }, 'pass', `Access-Control-Allow-Origin: ${acaoHeader}`);
+        },
+    },
+    {
+        id: 'security-hsts-exists',
+        name: 'Strict-Transport-Security (HSTS)',
+        category: 'security',
+        severity: 'warning',
+        description: 'HSTS header forces secure connections and improves SEO indirectly.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const hstsHeader = ctx.responseHeaders['strict-transport-security'] || ctx.responseHeaders['Strict-Transport-Security'];
+            if (!hstsHeader) {
+                return createResult({ id: 'security-hsts-exists', name: 'HSTS Header', category: 'security', severity: 'warning' }, 'warn', 'Strict-Transport-Security header is missing', { recommendation: 'Implement HSTS to force secure connections and benefit SEO.' });
+            }
+            return createResult({ id: 'security-hsts-exists', name: 'HSTS Header', category: 'security', severity: 'warning' }, 'pass', `Strict-Transport-Security header is present: ${hstsHeader}`);
+        },
+    },
+    {
+        id: 'security-xcto-exists',
+        name: 'X-Content-Type-Options',
+        category: 'security',
+        severity: 'warning',
+        description: 'X-Content-Type-Options header prevents MIME sniffing attacks.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const xctoHeader = ctx.responseHeaders['x-content-type-options'] || ctx.responseHeaders['X-Content-Type-Options'];
+            if (!xctoHeader) {
+                return createResult({ id: 'security-xcto-exists', name: 'X-Content-Type-Options', category: 'security', severity: 'warning' }, 'warn', 'X-Content-Type-Options header is missing', { recommendation: 'Implement X-Content-Type-Options: nosniff to prevent MIME sniffing.' });
+            }
+            return createResult({ id: 'security-xcto-exists', name: 'X-Content-Type-Options', category: 'security', severity: 'warning' }, 'pass', `X-Content-Type-Options header is present: ${xctoHeader}`);
+        },
+    },
+    {
+        id: 'security-rp-exists',
+        name: 'Referrer-Policy',
+        category: 'security',
+        severity: 'info',
+        description: 'Referrer-Policy controls how much referrer information is sent with requests.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const rpHeader = ctx.responseHeaders['referrer-policy'] || ctx.responseHeaders['Referrer-Policy'];
+            if (!rpHeader) {
+                return createResult({ id: 'security-rp-exists', name: 'Referrer-Policy', category: 'security', severity: 'info' }, 'info', 'Referrer-Policy header is missing', { recommendation: 'Consider implementing a Referrer-Policy for better privacy and control (e.g., strict-origin-when-cross-origin).' });
+            }
+            return createResult({ id: 'security-rp-exists', name: 'Referrer-Policy', category: 'security', severity: 'info' }, 'pass', `Referrer-Policy header is present: ${rpHeader}`);
+        },
+    },
+    {
+        id: 'security-pp-exists',
+        name: 'Permissions-Policy',
+        category: 'security',
+        severity: 'info',
+        description: 'Permissions-Policy controls browser features available to the page and iframes.',
+        check: (ctx) => {
+            if (!ctx.responseHeaders)
+                return null;
+            const ppHeader = ctx.responseHeaders['permissions-policy'] || ctx.responseHeaders['Permissions-Policy'];
+            if (!ppHeader) {
+                return createResult({ id: 'security-pp-exists', name: 'Permissions-Policy', category: 'security', severity: 'info' }, 'info', 'Permissions-Policy header is missing', { recommendation: 'Consider implementing a Permissions-Policy to disable unused browser features and enhance security (e.g., camera=(), microphone=()).' });
+            }
+            return createResult({ id: 'security-pp-exists', name: 'Permissions-Policy', category: 'security', severity: 'info' }, 'pass', `Permissions-Policy header is present: ${ppHeader}`);
+        },
+    },
+];

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

	@@ -0,0 +1,2 @@
1	+ import { SeoRule } from './types.js';
2	+ export declare const structuralRules: SeoRule[];

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

@@ -0,0 +1,155 @@
+import { createResult } from './types.js';
+import { SEO_THRESHOLDS } from './thresholds.js';
+export const structuralRules = [
+    {
+        id: 'h1-exists',
+        name: 'H1 Exists',
+        category: 'headings',
+        severity: 'error',
+        description: 'Page must have exactly one H1 heading',
+        check: (ctx) => {
+            if (ctx.h1Count === undefined)
+                return null;
+            if (ctx.h1Count === 0) {
+                return createResult({ id: 'h1-exists', name: 'H1 Tag', category: 'headings', severity: 'error' }, 'fail', 'Missing H1 heading', { recommendation: 'Add a single H1 heading that describes the page content' });
+            }
+            if (ctx.h1Count > 1) {
+                return createResult({ id: 'h1-exists', name: 'H1 Tag', category: 'headings', severity: 'error' }, 'warn', `Multiple H1 tags (${ctx.h1Count} found)`, { value: ctx.h1Count, recommendation: 'Use only one H1 per page' });
+            }
+            return createResult({ id: 'h1-exists', name: 'H1 Tag', category: 'headings', severity: 'error' }, 'pass', 'Single H1 tag present');
+        },
+    },
+    {
+        id: 'h1-length',
+        name: 'H1 Length',
+        category: 'headings',
+        severity: 'warning',
+        description: 'H1 should be 20-70 characters',
+        check: (ctx) => {
+            if (!ctx.h1Text)
+                return null;
+            const len = ctx.h1Length ?? ctx.h1Text.length;
+            const { minLength, maxLength } = SEO_THRESHOLDS.headings.h1;
+            if (len < minLength) {
+                return createResult({ id: 'h1-length', name: 'H1 Length', category: 'headings', severity: 'warning' }, 'warn', `H1 too short (${len} chars, min: ${minLength})`, { value: len, recommendation: `Expand H1 to at least ${minLength} characters` });
+            }
+            if (len > maxLength) {
+                return createResult({ id: 'h1-length', name: 'H1 Length', category: 'headings', severity: 'warning' }, 'warn', `H1 too long (${len} chars, max: ${maxLength})`, { value: len, recommendation: `Shorten H1 to under ${maxLength} characters` });
+            }
+            return createResult({ id: 'h1-length', name: 'H1 Length', category: 'headings', severity: 'warning' }, 'pass', `H1 length OK (${len} chars)`, { value: len });
+        },
+    },
+    {
+        id: 'heading-hierarchy',
+        name: 'Heading Hierarchy',
+        category: 'headings',
+        severity: 'warning',
+        description: 'Headings should follow sequential order (H1 → H2 → H3)',
+        check: (ctx) => {
+            if (ctx.headingHierarchyValid === undefined)
+                return null;
+            if (!ctx.headingHierarchyValid) {
+                const skipped = ctx.headingSkippedLevels?.join(', ') || 'unknown';
+                return createResult({ id: 'heading-hierarchy', name: 'Heading Hierarchy', category: 'headings', severity: 'warning' }, 'warn', `Heading levels are skipped (${skipped})`, { recommendation: 'Use sequential heading levels (H1 → H2 → H3)' });
+            }
+            return createResult({ id: 'heading-hierarchy', name: 'Heading Hierarchy', category: 'headings', severity: 'warning' }, 'pass', 'Heading structure is correct');
+        },
+    },
+    {
+        id: 'h2-count',
+        name: 'H2 Count',
+        category: 'headings',
+        severity: 'info',
+        description: 'Page should have 2-8 H2 headings for good structure',
+        check: (ctx) => {
+            if (ctx.h2Count === undefined)
+                return null;
+            const { min, max } = SEO_THRESHOLDS.headings.h2;
+            if (ctx.h2Count < min) {
+                return createResult({ id: 'h2-count', name: 'H2 Count', category: 'headings', severity: 'info' }, 'info', `Few H2 headings (${ctx.h2Count})`, { value: ctx.h2Count, recommendation: `Consider adding more H2 headings for better structure (${min}-${max} ideal)` });
+            }
+            if (ctx.h2Count > max) {
+                return createResult({ id: 'h2-count', name: 'H2 Count', category: 'headings', severity: 'info' }, 'info', `Many H2 headings (${ctx.h2Count})`, { value: ctx.h2Count, recommendation: 'Consider consolidating sections' });
+            }
+            return createResult({ id: 'h2-count', name: 'H2 Count', category: 'headings', severity: 'info' }, 'pass', `Good H2 count (${ctx.h2Count})`, { value: ctx.h2Count });
+        },
+    },
+    {
+        id: 'html5-header-exists',
+        name: 'HTML5 Header',
+        category: 'technical',
+        severity: 'info',
+        description: 'Page should use a <header> element',
+        check: (ctx) => {
+            if (!ctx.hasHeader) {
+                return createResult({ id: 'html5-header-exists', name: 'HTML5 Header', category: 'technical', severity: 'info' }, 'info', 'Missing <header> element', { recommendation: 'Use <header> for site-wide or page-specific introductory content' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'html5-nav-exists',
+        name: 'HTML5 Navigation',
+        category: 'technical',
+        severity: 'info',
+        description: 'Page should use a <nav> element for navigation links',
+        check: (ctx) => {
+            if (!ctx.hasNav) {
+                return createResult({ id: 'html5-nav-exists', name: 'HTML5 Navigation', category: 'technical', severity: 'info' }, 'info', 'Missing <nav> element', { recommendation: 'Use <nav> to define a block of navigation links' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'html5-main-exists',
+        name: 'HTML5 Main Content',
+        category: 'technical',
+        severity: 'info',
+        description: 'Page should use a <main> element for the dominant content',
+        check: (ctx) => {
+            if (!ctx.hasMain) {
+                return createResult({ id: 'html5-main-exists', name: 'HTML5 Main Content', category: 'technical', severity: 'info' }, 'info', 'Missing <main> element', { recommendation: 'Use <main> to enclose the dominant content of the <body>' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'html5-article-exists',
+        name: 'HTML5 Article',
+        category: 'technical',
+        severity: 'info',
+        description: 'Consider using <article> for independent, self-contained content',
+        check: (ctx) => {
+            if (!ctx.hasArticle && ctx.wordCount && ctx.wordCount > 500) {
+                return createResult({ id: 'html5-article-exists', name: 'HTML5 Article', category: 'technical', severity: 'info' }, 'info', 'Missing <article> element for substantial content', { recommendation: 'Consider using <article> for blog posts, news articles, etc.' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'html5-section-exists',
+        name: 'HTML5 Section',
+        category: 'technical',
+        severity: 'info',
+        description: 'Consider using <section> for thematic grouping of content',
+        check: (ctx) => {
+            if (!ctx.hasSection && (ctx.h2Count && ctx.h2Count > 1)) {
+                return createResult({ id: 'html5-section-exists', name: 'HTML5 Section', category: 'technical', severity: 'info' }, 'info', 'Missing <section> element for content grouping', { recommendation: 'Consider using <section> to group related content, usually with a heading' });
+            }
+            return null;
+        },
+    },
+    {
+        id: 'html5-footer-exists',
+        name: 'HTML5 Footer',
+        category: 'technical',
+        severity: 'info',
+        description: 'Page should use a <footer> element',
+        check: (ctx) => {
+            if (!ctx.hasFooter) {
+                return createResult({ id: 'html5-footer-exists', name: 'HTML5 Footer', category: 'technical', severity: 'info' }, 'info', 'Missing <footer> element', { recommendation: 'Use <footer> for site-wide or page-specific footer content' });
+            }
+            return null;
+        },
+    },
+];

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

	@@ -0,0 +1,2 @@
1	+ import { SeoRule } from './types.js';
2	+ export declare const technicalRules: SeoRule[];